1 /* 2 * Copyright (C) 2012 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef HDCP_API_H_ 18 19 #define HDCP_API_H_ 20 21 #include <utils/Errors.h> 22 #include <system/window.h> 23 24 namespace android { 25 26 // Two different kinds of modules are covered under the same HDCPModule 27 // structure below, a module either implements decryption or encryption. 28 struct HDCPModule { 29 typedef void (*ObserverFunc)(void *cookie, int msg, int ext1, int ext2); 30 31 // The msg argument in calls to the observer notification function. 32 enum { 33 // Sent in response to a call to "HDCPModule::initAsync" once 34 // initialization has either been successfully completed, 35 // i.e. the HDCP session is now fully setup (AKE, Locality Check, 36 // SKE and any authentication with repeaters completed) or failed. 37 // ext1 should be a suitable error code (status_t), ext2 is 38 // unused for ENCRYPTION and in the case of HDCP_INITIALIZATION_COMPLETE 39 // holds the local TCP port the module is listening on. 40 HDCP_INITIALIZATION_COMPLETE, 41 HDCP_INITIALIZATION_FAILED, 42 43 // Sent upon completion of a call to "HDCPModule::shutdownAsync". 44 // ext1 should be a suitable error code, ext2 is unused. 45 HDCP_SHUTDOWN_COMPLETE, 46 HDCP_SHUTDOWN_FAILED, 47 48 HDCP_UNAUTHENTICATED_CONNECTION, 49 HDCP_UNAUTHORIZED_CONNECTION, 50 HDCP_REVOKED_CONNECTION, 51 HDCP_TOPOLOGY_EXECEEDED, 52 HDCP_UNKNOWN_ERROR, 53 54 // DECRYPTION only: Indicates that a client has successfully connected, 55 // a secure session established and the module is ready to accept 56 // future calls to "decrypt". 57 HDCP_SESSION_ESTABLISHED, 58 }; 59 60 // HDCPModule capability bit masks 61 enum { 62 // HDCP_CAPS_ENCRYPT: mandatory, meaning the HDCP module can encrypt 63 // from an input byte-array buffer to an output byte-array buffer 64 HDCP_CAPS_ENCRYPT = (1 << 0), 65 // HDCP_CAPS_ENCRYPT_NATIVE: the HDCP module supports encryption from 66 // a native buffer to an output byte-array buffer. The format of the 67 // input native buffer is specific to vendor's encoder implementation. 68 // It is the same format as that used by the encoder when 69 // "storeMetaDataInBuffers" extension is enabled on its output port. 70 HDCP_CAPS_ENCRYPT_NATIVE = (1 << 1), 71 }; 72 73 // Module can call the notification function to signal completion/failure 74 // of asynchronous operations (such as initialization) or out of band 75 // events. 76 HDCPModule(void *cookie, ObserverFunc observerNotify) {}; 77 78 virtual ~HDCPModule() {}; 79 80 // ENCRYPTION: Request to setup an HDCP session with the host specified 81 // by addr and listening on the specified port. 82 // DECRYPTION: Request to setup an HDCP session, addr is the interface 83 // address the module should bind its socket to. port will be 0. 84 // The module will pick the port to listen on itself and report its choice 85 // in the "ext2" argument of the HDCP_INITIALIZATION_COMPLETE callback. 86 virtual status_t initAsync(const char *addr, unsigned port) = 0; 87 88 // Request to shutdown the active HDCP session. 89 virtual status_t shutdownAsync() = 0; 90 91 // ENCRYPTION only: 92 // Encrypt data according to the HDCP spec. "size" bytes of data are 93 // available at "inData" (virtual address), "size" may not be a multiple 94 // of 128 bits (16 bytes). An equal number of encrypted bytes should be 95 // written to the buffer at "outData" (virtual address). 96 // This operation is to be synchronous, i.e. this call does not return 97 // until outData contains size bytes of encrypted data. 98 // streamCTR will be assigned by the caller (to 0 for the first PES stream, 99 // 1 for the second and so on) 100 // inputCTR _will_be_maintained_by_the_callee_ for each PES stream. 101 virtual status_t encrypt( 102 const void *inData, size_t size, uint32_t streamCTR, 103 uint64_t *outInputCTR, void *outData) { 104 return INVALID_OPERATION; 105 } 106 107 // Encrypt data according to the HDCP spec. "size" bytes of data starting 108 // at location "offset" are available in "buffer" (buffer handle). "size" 109 // may not be a multiple of 128 bits (16 bytes). An equal number of 110 // encrypted bytes should be written to the buffer at "outData" (virtual 111 // address). This operation is to be synchronous, i.e. this call does not 112 // return until outData contains size bytes of encrypted data. 113 // streamCTR will be assigned by the caller (to 0 for the first PES stream, 114 // 1 for the second and so on) 115 // inputCTR _will_be_maintained_by_the_callee_ for each PES stream. 116 virtual status_t encryptNative( 117 buffer_handle_t buffer, size_t offset, size_t size, 118 uint32_t streamCTR, uint64_t *outInputCTR, void *outData) { 119 return INVALID_OPERATION; 120 } 121 // DECRYPTION only: 122 // Decrypt data according to the HDCP spec. 123 // "size" bytes of encrypted data are available at "inData" 124 // (virtual address), "size" may not be a multiple of 128 bits (16 bytes). 125 // An equal number of decrypted bytes should be written to the buffer 126 // at "outData" (virtual address). 127 // This operation is to be synchronous, i.e. this call does not return 128 // until outData contains size bytes of decrypted data. 129 // Both streamCTR and inputCTR will be provided by the caller. 130 virtual status_t decrypt( 131 const void *inData, size_t size, 132 uint32_t streamCTR, uint64_t inputCTR, 133 void *outData) { 134 return INVALID_OPERATION; 135 } 136 137 private: 138 HDCPModule(const HDCPModule &); 139 HDCPModule &operator=(const HDCPModule &); 140 }; 141 142 } // namespace android 143 144 // A shared library exporting the following methods should be included to 145 // support HDCP functionality. The shared library must be called 146 // "libstagefright_hdcp.so", it will be dynamically loaded into the 147 // mediaserver process. 148 extern "C" { 149 // Create a module for ENCRYPTION. 150 extern android::HDCPModule *createHDCPModule( 151 void *cookie, android::HDCPModule::ObserverFunc); 152 153 // Create a module for DECRYPTION. 154 extern android::HDCPModule *createHDCPModuleForDecryption( 155 void *cookie, android::HDCPModule::ObserverFunc); 156 } 157 158 #endif // HDCP_API_H_ 159 160
