/* * Copyright (C) 2016 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef ANDROID_HARDWARE_SOUNDTRIGGER_HAL_HIDL_H #define ANDROID_HARDWARE_SOUNDTRIGGER_HAL_HIDL_H #include #include #include #include #include #include #include "SoundTriggerHalInterface.h" #include #include #include #include #include namespace android { using ::android::hardware::audio::common::V2_0::Uuid; using ::android::hardware::hidl_vec; using ::android::hardware::soundtrigger::V2_0::ConfidenceLevel; using ::android::hardware::soundtrigger::V2_0::PhraseRecognitionExtra; using ::android::hardware::soundtrigger::V2_0::SoundModelType; using ::android::hardware::soundtrigger::V2_0::SoundModelHandle; using ::android::hardware::soundtrigger::V2_0::ISoundTriggerHw; using V2_0_ISoundTriggerHwCallback = ::android::hardware::soundtrigger::V2_0::ISoundTriggerHwCallback; using V2_1_ISoundTriggerHw = ::android::hardware::soundtrigger::V2_1::ISoundTriggerHw; using V2_1_ISoundTriggerHwCallback = ::android::hardware::soundtrigger::V2_1::ISoundTriggerHwCallback; using ::android::hidl::memory::V1_0::IMemory; using V2_2_ISoundTriggerHw = ::android::hardware::soundtrigger::V2_2::ISoundTriggerHw; class SoundTriggerHalHidl : public SoundTriggerHalInterface, public virtual V2_1_ISoundTriggerHwCallback { public: virtual int getProperties(struct sound_trigger_properties *properties); /* * Load a sound model. Once loaded, recognition of this model can be started and stopped. * Only one active recognition per model at a time. The SoundTrigger service will handle * concurrent recognition requests by different users/applications on the same model. * The implementation returns a unique handle used by other functions (unload_sound_model(), * start_recognition(), etc... */ virtual int loadSoundModel(struct sound_trigger_sound_model *sound_model, sound_model_callback_t callback, void *cookie, sound_model_handle_t *handle); /* * Unload a sound model. A sound model can be unloaded to make room for a new one to overcome * implementation limitations. */ virtual int unloadSoundModel(sound_model_handle_t handle); /* Start recognition on a given model. Only one recognition active at a time per model. * Once recognition succeeds of fails, the callback is called. * TODO: group recognition configuration parameters into one struct and add key phrase options. */ virtual int startRecognition(sound_model_handle_t handle, const struct sound_trigger_recognition_config *config, recognition_callback_t callback, void *cookie); /* Stop recognition on a given model. * The implementation does not have to call the callback when stopped via this method. */ virtual int stopRecognition(sound_model_handle_t handle); /* Stop recognition on all models. * Only supported for device api versions SOUND_TRIGGER_DEVICE_API_VERSION_1_1 or above. * If no implementation is provided, stop_recognition will be called for each running model. */ virtual int stopAllRecognitions(); /* Get the current state of a given model. * Returns 0 or an error code. If successful the state will be returned asynchronously * via a recognition event in the callback method that was registered in the * startRecognition() method. * Only supported for device api versions SOUND_TRIGGER_DEVICE_API_VERSION_1_2 or above. */ virtual int getModelState(sound_model_handle_t handle); // ISoundTriggerHwCallback virtual ::android::hardware::Return recognitionCallback( const V2_0_ISoundTriggerHwCallback::RecognitionEvent& event, CallbackCookie cookie); virtual ::android::hardware::Return phraseRecognitionCallback( const V2_0_ISoundTriggerHwCallback::PhraseRecognitionEvent& event, int32_t cookie); virtual ::android::hardware::Return soundModelCallback( const V2_0_ISoundTriggerHwCallback::ModelEvent& event, CallbackCookie cookie); virtual ::android::hardware::Return recognitionCallback_2_1( const RecognitionEvent& event, CallbackCookie cookie); virtual ::android::hardware::Return phraseRecognitionCallback_2_1( const PhraseRecognitionEvent& event, int32_t cookie); virtual ::android::hardware::Return soundModelCallback_2_1( const ModelEvent& event, CallbackCookie cookie); private: class SoundModel : public RefBase { public: SoundModel(sound_model_handle_t handle, sound_model_callback_t callback, void *cookie, android::hardware::soundtrigger::V2_0::SoundModelHandle halHandle) : mHandle(handle), mHalHandle(halHandle), mSoundModelCallback(callback), mSoundModelCookie(cookie), mRecognitionCallback(NULL), mRecognitionCookie(NULL) {} ~SoundModel() {} sound_model_handle_t mHandle; android::hardware::soundtrigger::V2_0::SoundModelHandle mHalHandle; sound_model_callback_t mSoundModelCallback; void * mSoundModelCookie; recognition_callback_t mRecognitionCallback; void * mRecognitionCookie; }; friend class SoundTriggerHalInterface; explicit SoundTriggerHalHidl(const char *moduleName = NULL); virtual ~SoundTriggerHalHidl(); void convertUuidToHal(Uuid *halUuid, const sound_trigger_uuid_t *uuid); void convertUuidFromHal(sound_trigger_uuid_t *uuid, const Uuid *halUuid); void convertPropertiesFromHal( struct sound_trigger_properties *properties, const ISoundTriggerHw::Properties *halProperties); void convertTriggerPhraseToHal( ISoundTriggerHw::Phrase *halTriggerPhrase, const struct sound_trigger_phrase *triggerPhrase); void convertTriggerPhrasesToHal( hidl_vec *halTriggerPhrases, struct sound_trigger_phrase_sound_model *keyPhraseModel); void convertSoundModelToHal(ISoundTriggerHw::SoundModel *halModel, const struct sound_trigger_sound_model *soundModel); std::pair> convertSoundModelToHal( V2_1_ISoundTriggerHw::SoundModel *halModel, const struct sound_trigger_sound_model *soundModel) __attribute__((warn_unused_result)); void convertPhraseSoundModelToHal(ISoundTriggerHw::PhraseSoundModel *halKeyPhraseModel, const struct sound_trigger_sound_model *soundModel); std::pair> convertPhraseSoundModelToHal( V2_1_ISoundTriggerHw::PhraseSoundModel *halKeyPhraseModel, const struct sound_trigger_sound_model *soundModel) __attribute__((warn_unused_result)); void convertPhraseRecognitionExtraToHal( PhraseRecognitionExtra *halExtra, const struct sound_trigger_phrase_recognition_extra *extra); void convertRecognitionConfigToHal(ISoundTriggerHw::RecognitionConfig *halConfig, const struct sound_trigger_recognition_config *config); std::pair> convertRecognitionConfigToHal( V2_1_ISoundTriggerHw::RecognitionConfig *halConfig, const struct sound_trigger_recognition_config *config) __attribute__((warn_unused_result)); struct sound_trigger_model_event *convertSoundModelEventFromHal( const V2_0_ISoundTriggerHwCallback::ModelEvent *halEvent); void convertPhraseRecognitionExtraFromHal( struct sound_trigger_phrase_recognition_extra *extra, const PhraseRecognitionExtra *halExtra); struct sound_trigger_phrase_recognition_event* convertPhraseRecognitionEventFromHal( const V2_0_ISoundTriggerHwCallback::PhraseRecognitionEvent *halPhraseEvent); struct sound_trigger_recognition_event *convertRecognitionEventFromHal( const V2_0_ISoundTriggerHwCallback::RecognitionEvent *halEvent); void fillRecognitionEventFromHal( struct sound_trigger_recognition_event *event, const V2_0_ISoundTriggerHwCallback::RecognitionEvent *halEvent); uint32_t nextUniqueId(); sp getService(); sp toService2_1(const sp& s); sp toService2_2(const sp& s); sp getModel(sound_model_handle_t handle); sp removeModel(sound_model_handle_t handle); static pthread_once_t sOnceControl; static void sOnceInit(); Mutex mLock; Mutex mHalLock; const char *mModuleName; volatile atomic_uint_fast32_t mNextUniqueId; // Effect chains without a valid thread DefaultKeyedVector< sound_model_handle_t , sp > mSoundModels; sp<::android::hardware::soundtrigger::V2_0::ISoundTriggerHw> mISoundTrigger; }; } // namespace android #endif // ANDROID_HARDWARE_SOUNDTRIGGER_HAL_HIDL_H