Home | History | Annotate | Download | only in mediadrm
      1 /*
      2  * Copyright (C) 2017 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 DRM_HAL_H_
     18 
     19 #define DRM_HAL_H_
     20 
     21 #include <android/hardware/drm/1.0/IDrmFactory.h>
     22 #include <android/hardware/drm/1.0/IDrmPlugin.h>
     23 #include <android/hardware/drm/1.1/IDrmFactory.h>
     24 #include <android/hardware/drm/1.1/IDrmPlugin.h>
     25 #include <android/hardware/drm/1.2/IDrmFactory.h>
     26 #include <android/hardware/drm/1.2/IDrmPlugin.h>
     27 #include <android/hardware/drm/1.2/IDrmPluginListener.h>
     28 
     29 #include <media/MediaAnalyticsItem.h>
     30 #include <mediadrm/DrmMetrics.h>
     31 #include <mediadrm/IDrm.h>
     32 #include <mediadrm/IDrmClient.h>
     33 #include <utils/threads.h>
     34 
     35 namespace drm = ::android::hardware::drm;
     36 using drm::V1_0::EventType;
     37 using drm::V1_0::IDrmFactory;
     38 using drm::V1_0::IDrmPlugin;
     39 using drm::V1_0::IDrmPluginListener;
     40 using drm::V1_1::SecurityLevel;
     41 using drm::V1_2::KeyStatus;
     42 using drm::V1_2::OfflineLicenseState;
     43 using ::android::hardware::hidl_vec;
     44 using ::android::hardware::Return;
     45 using ::android::hardware::Void;
     46 
     47 typedef drm::V1_2::IDrmPluginListener IDrmPluginListener_V1_2;
     48 typedef drm::V1_0::KeyStatus KeyStatus_V1_0;
     49 
     50 namespace android {
     51 
     52 struct DrmSessionClientInterface;
     53 
     54 inline bool operator==(const Vector<uint8_t> &l, const Vector<uint8_t> &r) {
     55     if (l.size() != r.size()) return false;
     56     return memcmp(l.array(), r.array(), l.size()) == 0;
     57 }
     58 
     59 struct DrmHal : public BnDrm,
     60                 public IBinder::DeathRecipient,
     61                 public IDrmPluginListener_V1_2 {
     62     DrmHal();
     63     virtual ~DrmHal();
     64 
     65     virtual status_t initCheck() const;
     66 
     67     virtual status_t isCryptoSchemeSupported(const uint8_t uuid[16],
     68                                              const String8& mimeType,
     69                                              DrmPlugin::SecurityLevel level,
     70                                              bool *isSupported);
     71 
     72     virtual status_t createPlugin(const uint8_t uuid[16],
     73                                   const String8 &appPackageName);
     74 
     75     virtual status_t destroyPlugin();
     76 
     77     virtual status_t openSession(DrmPlugin::SecurityLevel level,
     78             Vector<uint8_t> &sessionId);
     79 
     80     virtual status_t closeSession(Vector<uint8_t> const &sessionId);
     81 
     82     virtual status_t
     83         getKeyRequest(Vector<uint8_t> const &sessionId,
     84                       Vector<uint8_t> const &initData,
     85                       String8 const &mimeType, DrmPlugin::KeyType keyType,
     86                       KeyedVector<String8, String8> const &optionalParameters,
     87                       Vector<uint8_t> &request, String8 &defaultUrl,
     88                       DrmPlugin::KeyRequestType *keyRequestType);
     89 
     90     virtual status_t provideKeyResponse(Vector<uint8_t> const &sessionId,
     91                                         Vector<uint8_t> const &response,
     92                                         Vector<uint8_t> &keySetId);
     93 
     94     virtual status_t removeKeys(Vector<uint8_t> const &keySetId);
     95 
     96     virtual status_t restoreKeys(Vector<uint8_t> const &sessionId,
     97                                  Vector<uint8_t> const &keySetId);
     98 
     99     virtual status_t queryKeyStatus(Vector<uint8_t> const &sessionId,
    100                                     KeyedVector<String8, String8> &infoMap) const;
    101 
    102     virtual status_t getProvisionRequest(String8 const &certType,
    103                                          String8 const &certAuthority,
    104                                          Vector<uint8_t> &request,
    105                                          String8 &defaulUrl);
    106 
    107     virtual status_t provideProvisionResponse(Vector<uint8_t> const &response,
    108                                               Vector<uint8_t> &certificate,
    109                                               Vector<uint8_t> &wrappedKey);
    110 
    111     virtual status_t getSecureStops(List<Vector<uint8_t>> &secureStops);
    112     virtual status_t getSecureStopIds(List<Vector<uint8_t>> &secureStopIds);
    113     virtual status_t getSecureStop(Vector<uint8_t> const &ssid, Vector<uint8_t> &secureStop);
    114 
    115     virtual status_t releaseSecureStops(Vector<uint8_t> const &ssRelease);
    116     virtual status_t removeSecureStop(Vector<uint8_t> const &ssid);
    117     virtual status_t removeAllSecureStops();
    118 
    119     virtual status_t getHdcpLevels(DrmPlugin::HdcpLevel *connectedLevel,
    120             DrmPlugin::HdcpLevel *maxLevel) const;
    121     virtual status_t getNumberOfSessions(uint32_t *currentSessions,
    122             uint32_t *maxSessions) const;
    123     virtual status_t getSecurityLevel(Vector<uint8_t> const &sessionId,
    124             DrmPlugin::SecurityLevel *level) const;
    125 
    126     virtual status_t getOfflineLicenseKeySetIds(List<Vector<uint8_t>> &keySetIds) const;
    127     virtual status_t removeOfflineLicense(Vector<uint8_t> const &keySetId);
    128     virtual status_t getOfflineLicenseState(Vector<uint8_t> const &keySetId,
    129             DrmPlugin::OfflineLicenseState *licenseState) const;
    130 
    131     virtual status_t getPropertyString(String8 const &name, String8 &value ) const;
    132     virtual status_t getPropertyByteArray(String8 const &name,
    133                                           Vector<uint8_t> &value ) const;
    134     virtual status_t setPropertyString(String8 const &name, String8 const &value ) const;
    135     virtual status_t setPropertyByteArray(String8 const &name,
    136                                           Vector<uint8_t> const &value ) const;
    137     virtual status_t getMetrics(os::PersistableBundle *metrics);
    138 
    139     virtual status_t setCipherAlgorithm(Vector<uint8_t> const &sessionId,
    140                                         String8 const &algorithm);
    141 
    142     virtual status_t setMacAlgorithm(Vector<uint8_t> const &sessionId,
    143                                      String8 const &algorithm);
    144 
    145     virtual status_t encrypt(Vector<uint8_t> const &sessionId,
    146                              Vector<uint8_t> const &keyId,
    147                              Vector<uint8_t> const &input,
    148                              Vector<uint8_t> const &iv,
    149                              Vector<uint8_t> &output);
    150 
    151     virtual status_t decrypt(Vector<uint8_t> const &sessionId,
    152                              Vector<uint8_t> const &keyId,
    153                              Vector<uint8_t> const &input,
    154                              Vector<uint8_t> const &iv,
    155                              Vector<uint8_t> &output);
    156 
    157     virtual status_t sign(Vector<uint8_t> const &sessionId,
    158                           Vector<uint8_t> const &keyId,
    159                           Vector<uint8_t> const &message,
    160                           Vector<uint8_t> &signature);
    161 
    162     virtual status_t verify(Vector<uint8_t> const &sessionId,
    163                             Vector<uint8_t> const &keyId,
    164                             Vector<uint8_t> const &message,
    165                             Vector<uint8_t> const &signature,
    166                             bool &match);
    167 
    168     virtual status_t signRSA(Vector<uint8_t> const &sessionId,
    169                              String8 const &algorithm,
    170                              Vector<uint8_t> const &message,
    171                              Vector<uint8_t> const &wrappedKey,
    172                              Vector<uint8_t> &signature);
    173 
    174     virtual status_t setListener(const sp<IDrmClient>& listener);
    175 
    176     // Methods of IDrmPluginListener
    177     Return<void> sendEvent(EventType eventType,
    178             const hidl_vec<uint8_t>& sessionId, const hidl_vec<uint8_t>& data);
    179 
    180     Return<void> sendExpirationUpdate(const hidl_vec<uint8_t>& sessionId,
    181             int64_t expiryTimeInMS);
    182 
    183     Return<void> sendKeysChange(const hidl_vec<uint8_t>& sessionId,
    184             const hidl_vec<KeyStatus_V1_0>& keyStatusList, bool hasNewUsableKey);
    185 
    186     Return<void> sendKeysChange_1_2(const hidl_vec<uint8_t>& sessionId,
    187             const hidl_vec<KeyStatus>& keyStatusList, bool hasNewUsableKey);
    188 
    189     Return<void> sendSessionLostState(const hidl_vec<uint8_t>& sessionId);
    190 
    191     virtual void binderDied(const wp<IBinder> &the_late_who);
    192 
    193 private:
    194     static Mutex mLock;
    195 
    196     sp<DrmSessionClientInterface> mDrmSessionClient;
    197 
    198     sp<IDrmClient> mListener;
    199     mutable Mutex mEventLock;
    200     mutable Mutex mNotifyLock;
    201 
    202     const Vector<sp<IDrmFactory>> mFactories;
    203     sp<IDrmPlugin> mPlugin;
    204     sp<drm::V1_1::IDrmPlugin> mPluginV1_1;
    205     sp<drm::V1_2::IDrmPlugin> mPluginV1_2;
    206     String8 mAppPackageName;
    207 
    208     // Mutable to allow modification within GetPropertyByteArray.
    209     mutable MediaDrmMetrics mMetrics;
    210 
    211     Vector<Vector<uint8_t>> mOpenSessions;
    212     void closeOpenSessions();
    213     void cleanup();
    214 
    215     /**
    216      * mInitCheck is:
    217      *   NO_INIT if a plugin hasn't been created yet
    218      *   ERROR_UNSUPPORTED if a plugin can't be created for the uuid
    219      *   OK after a plugin has been created and mPlugin is valid
    220      */
    221     status_t mInitCheck;
    222 
    223     Vector<sp<IDrmFactory>> makeDrmFactories();
    224     sp<IDrmPlugin> makeDrmPlugin(const sp<IDrmFactory>& factory,
    225             const uint8_t uuid[16], const String8& appPackageName);
    226 
    227     void writeByteArray(Parcel &obj, const hidl_vec<uint8_t>& array);
    228 
    229     void reportPluginMetrics() const;
    230     void reportFrameworkMetrics() const;
    231     status_t getPropertyStringInternal(String8 const &name, String8 &value) const;
    232     status_t getPropertyByteArrayInternal(String8 const &name,
    233                                           Vector<uint8_t> &value) const;
    234     status_t matchMimeTypeAndSecurityLevel(const sp<IDrmFactory> &factory,
    235                                            const uint8_t uuid[16],
    236                                            const String8 &mimeType,
    237                                            DrmPlugin::SecurityLevel level,
    238                                            bool *isSupported);
    239 
    240     DISALLOW_EVIL_CONSTRUCTORS(DrmHal);
    241 };
    242 
    243 }  // namespace android
    244 
    245 #endif  // DRM_HAL_H_
    246