/* * Copyright (C) 2022 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. */ #pragma once #include #include #include #include #include "EffectContext.h" #include "EffectThread.h" #include "EffectTypes.h" #include "effect-impl/EffectContext.h" #include "effect-impl/EffectThread.h" #include "effect-impl/EffectTypes.h" extern "C" binder_exception_t destroyEffect( const std::shared_ptr& instanceSp); namespace aidl::android::hardware::audio::effect { class EffectImpl : public BnEffect, public EffectThread { public: EffectImpl() = default; virtual ~EffectImpl() = default; virtual ndk::ScopedAStatus open(const Parameter::Common& common, const std::optional& specific, OpenEffectReturn* ret) override; virtual ndk::ScopedAStatus close() override; virtual ndk::ScopedAStatus command(CommandId id) override; virtual ndk::ScopedAStatus reopen(OpenEffectReturn* ret) override; virtual ndk::ScopedAStatus getState(State* state) override; virtual ndk::ScopedAStatus setParameter(const Parameter& param) override; virtual ndk::ScopedAStatus getParameter(const Parameter::Id& id, Parameter* param) override; virtual ndk::ScopedAStatus setParameterCommon(const Parameter& param) REQUIRES(mImplMutex); virtual ndk::ScopedAStatus getParameterCommon(const Parameter::Tag& tag, Parameter* param) REQUIRES(mImplMutex); /* Methods MUST be implemented by each effect instances */ virtual ndk::ScopedAStatus getDescriptor(Descriptor* desc) = 0; virtual ndk::ScopedAStatus setParameterSpecific(const Parameter::Specific& specific) REQUIRES(mImplMutex) = 0; virtual ndk::ScopedAStatus getParameterSpecific(const Parameter::Id& id, Parameter::Specific* specific) REQUIRES(mImplMutex) = 0; virtual std::string getEffectName() = 0; virtual std::shared_ptr createContext(const Parameter::Common& common) REQUIRES(mImplMutex); virtual RetCode releaseContext() REQUIRES(mImplMutex) = 0; /** * @brief effectProcessImpl is running in worker thread which created in EffectThread. * * EffectThread will make sure effectProcessImpl only be called after startThread() successful * and before stopThread() successful. * * effectProcessImpl implementation must not call any EffectThread interface, otherwise it will * cause deadlock. * * @param in address of input float buffer. * @param out address of output float buffer. * @param samples number of samples to process. * @return IEffect::Status */ virtual IEffect::Status effectProcessImpl(float* in, float* out, int samples) = 0; /** * process() get data from data MQs, and call effectProcessImpl() for effect data processing. * Its important for the implementation to use mImplMutex for context synchronization. */ void process() override; protected: // current Hal version int mVersion = 0; // Use kEventFlagNotEmpty for V1 HAL, kEventFlagDataMqNotEmpty for V2 and above int mDataMqNotEmptyEf = aidl::android::hardware::audio::effect::kEventFlagDataMqNotEmpty; State mState GUARDED_BY(mImplMutex) = State::INIT; IEffect::Status status(binder_status_t status, size_t consumed, size_t produced); void cleanUp(); std::mutex mImplMutex; std::shared_ptr mImplContext GUARDED_BY(mImplMutex); /** * Optional CommandId handling methods for effects to override. * For CommandId::START, EffectImpl call commandImpl before starting the EffectThread * processing. * For CommandId::STOP and CommandId::RESET, EffectImpl call commandImpl after stop the * EffectThread processing. */ virtual ndk::ScopedAStatus commandImpl(CommandId id) REQUIRES(mImplMutex); RetCode notifyEventFlag(uint32_t flag); std::string getEffectNameWithVersion() { return getEffectName() + "V" + std::to_string(mVersion); } ::android::hardware::EventFlag* mEventFlag; }; } // namespace aidl::android::hardware::audio::effect