Home | History | Annotate | Download | only in hardware
      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