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
24namespace android {
25
26// Two different kinds of modules are covered under the same HDCPModule
27// structure below, a module either implements decryption or encryption.
28struct 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
137private:
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.
148extern "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