blob: b9df91567a6846881c96ba6c644312a92b95494f [file] [log] [blame]
/*
* Copyright (C) 2023 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.
*/
#define LOG_TAG "EffectPreProcessing"
#include <algorithm>
#include <unordered_set>
#include <Utils.h>
#include <android-base/logging.h>
#include <fmq/AidlMessageQueue.h>
#include "EffectPreProcessing.h"
using aidl::android::hardware::audio::effect::Descriptor;
using aidl::android::hardware::audio::effect::EffectPreProcessing;
using aidl::android::hardware::audio::effect::IEffect;
using aidl::android::hardware::audio::effect::kAcousticEchoCancelerSwImplUUID;
using aidl::android::hardware::audio::effect::kAutomaticGainControlV1SwImplUUID;
using aidl::android::hardware::audio::effect::kAutomaticGainControlV2SwImplUUID;
using aidl::android::hardware::audio::effect::kNoiseSuppressionSwImplUUID;
using aidl::android::hardware::audio::effect::State;
using aidl::android::media::audio::common::AudioUuid;
bool isPreProcessingUuidSupported(const AudioUuid& uuid) {
return (uuid == kAcousticEchoCancelerSwImplUUID || uuid == kAutomaticGainControlV1SwImplUUID ||
uuid == kAutomaticGainControlV2SwImplUUID || uuid == kNoiseSuppressionSwImplUUID);
}
extern "C" binder_exception_t createEffect(const AudioUuid* uuid,
std::shared_ptr<IEffect>* instanceSpp) {
if (!uuid || !isPreProcessingUuidSupported(*uuid)) {
LOG(ERROR) << __func__ << "uuid not supported";
return EX_ILLEGAL_ARGUMENT;
}
if (instanceSpp) {
*instanceSpp = ndk::SharedRefBase::make<EffectPreProcessing>(*uuid);
LOG(DEBUG) << __func__ << " instance " << instanceSpp->get() << " created";
return EX_NONE;
} else {
LOG(ERROR) << __func__ << " invalid input parameter!";
return EX_ILLEGAL_ARGUMENT;
}
}
extern "C" binder_exception_t queryEffect(const AudioUuid* in_impl_uuid, Descriptor* _aidl_return) {
if (!in_impl_uuid || !isPreProcessingUuidSupported(*in_impl_uuid)) {
LOG(ERROR) << __func__ << "uuid not supported";
return EX_ILLEGAL_ARGUMENT;
}
if (*in_impl_uuid == kAcousticEchoCancelerSwImplUUID) {
*_aidl_return = aidl::android::hardware::audio::effect::kAcousticEchoCancelerDesc;
} else if (*in_impl_uuid == kAutomaticGainControlV1SwImplUUID) {
*_aidl_return = aidl::android::hardware::audio::effect::kAutomaticGainControlV1Desc;
} else if (*in_impl_uuid == kAutomaticGainControlV2SwImplUUID) {
*_aidl_return = aidl::android::hardware::audio::effect::kAutomaticGainControlV2Desc;
} else if (*in_impl_uuid == kNoiseSuppressionSwImplUUID) {
*_aidl_return = aidl::android::hardware::audio::effect::kNoiseSuppressionDesc;
}
return EX_NONE;
}
namespace aidl::android::hardware::audio::effect {
EffectPreProcessing::EffectPreProcessing(const AudioUuid& uuid) {
LOG(DEBUG) << __func__ << uuid.toString();
if (uuid == kAcousticEchoCancelerSwImplUUID) {
mType = PreProcessingEffectType::ACOUSTIC_ECHO_CANCELLATION;
mDescriptor = &kAcousticEchoCancelerDesc;
mEffectName = &kAcousticEchoCancelerEffectName;
} else if (uuid == kAutomaticGainControlV1SwImplUUID) {
mType = PreProcessingEffectType::AUTOMATIC_GAIN_CONTROL_V1;
mDescriptor = &kAutomaticGainControlV1Desc;
mEffectName = &kAutomaticGainControlV1EffectName;
} else if (uuid == kAutomaticGainControlV2SwImplUUID) {
mType = PreProcessingEffectType::AUTOMATIC_GAIN_CONTROL_V2;
mDescriptor = &kAutomaticGainControlV2Desc;
mEffectName = &kAutomaticGainControlV2EffectName;
} else if (uuid == kNoiseSuppressionSwImplUUID) {
mType = PreProcessingEffectType::NOISE_SUPPRESSION;
mDescriptor = &kNoiseSuppressionDesc;
mEffectName = &kNoiseSuppressionEffectName;
} else {
LOG(ERROR) << __func__ << uuid.toString() << " not supported!";
}
}
EffectPreProcessing::~EffectPreProcessing() {
cleanUp();
LOG(DEBUG) << __func__;
}
ndk::ScopedAStatus EffectPreProcessing::getDescriptor(Descriptor* _aidl_return) {
RETURN_IF(!_aidl_return, EX_ILLEGAL_ARGUMENT, "Parameter:nullptr");
LOG(DEBUG) << _aidl_return->toString();
*_aidl_return = *mDescriptor;
return ndk::ScopedAStatus::ok();
}
ndk::ScopedAStatus EffectPreProcessing::setParameterSpecific(const Parameter::Specific& specific) {
LOG(DEBUG) << __func__ << " specific " << specific.toString();
RETURN_IF(!mContext, EX_NULL_POINTER, "nullContext");
auto tag = specific.getTag();
switch (tag) {
case Parameter::Specific::acousticEchoCanceler:
return setParameterAcousticEchoCanceler(specific);
case Parameter::Specific::automaticGainControlV1:
return setParameterAutomaticGainControlV1(specific);
case Parameter::Specific::automaticGainControlV2:
return setParameterAutomaticGainControlV2(specific);
case Parameter::Specific::noiseSuppression:
return setParameterNoiseSuppression(specific);
default:
LOG(ERROR) << __func__ << " unsupported tag " << toString(tag);
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(EX_ILLEGAL_ARGUMENT,
"specificParamNotSupported");
}
}
ndk::ScopedAStatus EffectPreProcessing::setParameterAcousticEchoCanceler(
const Parameter::Specific& specific) {
auto& param = specific.get<Parameter::Specific::acousticEchoCanceler>();
RETURN_IF(!inRange(param, kAcousticEchoCancelerRanges), EX_ILLEGAL_ARGUMENT, "outOfRange");
auto tag = param.getTag();
switch (tag) {
case AcousticEchoCanceler::echoDelayUs: {
RETURN_IF(mContext->setAcousticEchoCancelerEchoDelay(
param.get<AcousticEchoCanceler::echoDelayUs>()) != RetCode::SUCCESS,
EX_ILLEGAL_ARGUMENT, "echoDelayNotSupported");
return ndk::ScopedAStatus::ok();
}
case AcousticEchoCanceler::mobileMode: {
RETURN_IF(mContext->setAcousticEchoCancelerMobileMode(
param.get<AcousticEchoCanceler::mobileMode>()) != RetCode::SUCCESS,
EX_ILLEGAL_ARGUMENT, "SettingMobileModeNotSupported");
return ndk::ScopedAStatus::ok();
}
default: {
LOG(ERROR) << __func__ << " unsupported tag: " << toString(tag);
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(
EX_ILLEGAL_ARGUMENT, "AcousticEchoCancelerTagNotSupported");
}
}
}
ndk::ScopedAStatus EffectPreProcessing::setParameterAutomaticGainControlV1(
const Parameter::Specific& specific) {
auto& param = specific.get<Parameter::Specific::automaticGainControlV1>();
RETURN_IF(!inRange(param, kAutomaticGainControlV1Ranges), EX_ILLEGAL_ARGUMENT, "outOfRange");
auto tag = param.getTag();
switch (tag) {
case AutomaticGainControlV1::targetPeakLevelDbFs: {
RETURN_IF(mContext->setAutomaticGainControlV1TargetPeakLevel(
param.get<AutomaticGainControlV1::targetPeakLevelDbFs>()) !=
RetCode::SUCCESS,
EX_ILLEGAL_ARGUMENT, "targetPeakLevelNotSupported");
return ndk::ScopedAStatus::ok();
}
case AutomaticGainControlV1::maxCompressionGainDb: {
RETURN_IF(mContext->setAutomaticGainControlV1MaxCompressionGain(
param.get<AutomaticGainControlV1::maxCompressionGainDb>()) !=
RetCode::SUCCESS,
EX_ILLEGAL_ARGUMENT, "maxCompressionGainNotSupported");
return ndk::ScopedAStatus::ok();
}
case AutomaticGainControlV1::enableLimiter: {
RETURN_IF(
mContext->setAutomaticGainControlV1EnableLimiter(
param.get<AutomaticGainControlV1::enableLimiter>()) != RetCode::SUCCESS,
EX_ILLEGAL_ARGUMENT, "enableLimiterNotSupported");
return ndk::ScopedAStatus::ok();
}
default: {
LOG(ERROR) << __func__ << " unsupported tag: " << toString(tag);
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(
EX_ILLEGAL_ARGUMENT, "AutomaticGainControlV1TagNotSupported");
}
}
}
ndk::ScopedAStatus EffectPreProcessing::setParameterAutomaticGainControlV2(
const Parameter::Specific& specific) {
auto& param = specific.get<Parameter::Specific::automaticGainControlV2>();
RETURN_IF(!inRange(param, kAutomaticGainControlV2Ranges), EX_ILLEGAL_ARGUMENT, "outOfRange");
auto tag = param.getTag();
switch (tag) {
case AutomaticGainControlV2::fixedDigitalGainMb: {
RETURN_IF(mContext->setAutomaticGainControlV2DigitalGain(
param.get<AutomaticGainControlV2::fixedDigitalGainMb>()) !=
RetCode::SUCCESS,
EX_ILLEGAL_ARGUMENT, "digitalGainNotSupported");
return ndk::ScopedAStatus::ok();
}
case AutomaticGainControlV2::levelEstimator: {
RETURN_IF(mContext->setAutomaticGainControlV2LevelEstimator(
param.get<AutomaticGainControlV2::levelEstimator>()) !=
RetCode::SUCCESS,
EX_ILLEGAL_ARGUMENT, "levelEstimatorNotSupported");
return ndk::ScopedAStatus::ok();
}
case AutomaticGainControlV2::saturationMarginMb: {
RETURN_IF(mContext->setAutomaticGainControlV2SaturationMargin(
param.get<AutomaticGainControlV2::saturationMarginMb>()) !=
RetCode::SUCCESS,
EX_ILLEGAL_ARGUMENT, "saturationMarginNotSupported");
return ndk::ScopedAStatus::ok();
}
default: {
LOG(ERROR) << __func__ << " unsupported tag: " << toString(tag);
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(
EX_ILLEGAL_ARGUMENT, "AutomaticGainControlV2TagNotSupported");
}
}
}
ndk::ScopedAStatus EffectPreProcessing::setParameterNoiseSuppression(
const Parameter::Specific& specific) {
auto& param = specific.get<Parameter::Specific::noiseSuppression>();
auto tag = param.getTag();
switch (tag) {
case NoiseSuppression::level: {
RETURN_IF(mContext->setNoiseSuppressionLevel(param.get<NoiseSuppression::level>()) !=
RetCode::SUCCESS,
EX_ILLEGAL_ARGUMENT, "levelNotSupported");
return ndk::ScopedAStatus::ok();
}
default: {
LOG(ERROR) << __func__ << " unsupported tag: " << toString(tag);
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(
EX_ILLEGAL_ARGUMENT, "NoiseSuppressionTagNotSupported");
}
}
}
ndk::ScopedAStatus EffectPreProcessing::getParameterSpecific(const Parameter::Id& id,
Parameter::Specific* specific) {
RETURN_IF(!specific, EX_NULL_POINTER, "nullPtr");
auto tag = id.getTag();
switch (tag) {
case Parameter::Id::acousticEchoCancelerTag:
return getParameterAcousticEchoCanceler(
id.get<Parameter::Id::acousticEchoCancelerTag>(), specific);
case Parameter::Id::automaticGainControlV1Tag:
return getParameterAutomaticGainControlV1(
id.get<Parameter::Id::automaticGainControlV1Tag>(), specific);
case Parameter::Id::automaticGainControlV2Tag:
return getParameterAutomaticGainControlV2(
id.get<Parameter::Id::automaticGainControlV2Tag>(), specific);
case Parameter::Id::noiseSuppressionTag:
return getParameterNoiseSuppression(id.get<Parameter::Id::noiseSuppressionTag>(),
specific);
default:
LOG(ERROR) << __func__ << " unsupported tag: " << toString(tag);
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(EX_ILLEGAL_ARGUMENT,
"wrongIdTag");
}
}
ndk::ScopedAStatus EffectPreProcessing::getParameterAcousticEchoCanceler(
const AcousticEchoCanceler::Id& id, Parameter::Specific* specific) {
RETURN_IF(id.getTag() != AcousticEchoCanceler::Id::commonTag, EX_ILLEGAL_ARGUMENT,
"AcousticEchoCancelerTagNotSupported");
RETURN_IF(!mContext, EX_NULL_POINTER, "nullContext");
AcousticEchoCanceler param;
auto tag = id.get<AcousticEchoCanceler::Id::commonTag>();
switch (tag) {
case AcousticEchoCanceler::echoDelayUs: {
param.set<AcousticEchoCanceler::echoDelayUs>(
mContext->getAcousticEchoCancelerEchoDelay());
break;
}
case AcousticEchoCanceler::mobileMode: {
param.set<AcousticEchoCanceler::mobileMode>(
mContext->getAcousticEchoCancelerMobileMode());
break;
}
default: {
LOG(ERROR) << __func__ << " unsupported tag: " << toString(tag);
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(
EX_ILLEGAL_ARGUMENT, "AcousticEchoCancelerTagNotSupported");
}
}
specific->set<Parameter::Specific::acousticEchoCanceler>(param);
return ndk::ScopedAStatus::ok();
}
ndk::ScopedAStatus EffectPreProcessing::getParameterAutomaticGainControlV1(
const AutomaticGainControlV1::Id& id, Parameter::Specific* specific) {
RETURN_IF(id.getTag() != AutomaticGainControlV1::Id::commonTag, EX_ILLEGAL_ARGUMENT,
"AutomaticGainControlV1TagNotSupported");
RETURN_IF(!mContext, EX_NULL_POINTER, "nullContext");
AutomaticGainControlV1 param;
auto tag = id.get<AutomaticGainControlV1::Id::commonTag>();
switch (tag) {
case AutomaticGainControlV1::targetPeakLevelDbFs: {
param.set<AutomaticGainControlV1::targetPeakLevelDbFs>(
mContext->getAutomaticGainControlV1TargetPeakLevel());
break;
}
case AutomaticGainControlV1::maxCompressionGainDb: {
param.set<AutomaticGainControlV1::maxCompressionGainDb>(
mContext->getAutomaticGainControlV1MaxCompressionGain());
break;
}
case AutomaticGainControlV1::enableLimiter: {
param.set<AutomaticGainControlV1::enableLimiter>(
mContext->getAutomaticGainControlV1EnableLimiter());
break;
}
default: {
LOG(ERROR) << __func__ << " unsupported tag: " << toString(tag);
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(
EX_ILLEGAL_ARGUMENT, "AutomaticGainControlV1TagNotSupported");
}
}
specific->set<Parameter::Specific::automaticGainControlV1>(param);
return ndk::ScopedAStatus::ok();
}
ndk::ScopedAStatus EffectPreProcessing::getParameterAutomaticGainControlV2(
const AutomaticGainControlV2::Id& id, Parameter::Specific* specific) {
RETURN_IF(id.getTag() != AutomaticGainControlV2::Id::commonTag, EX_ILLEGAL_ARGUMENT,
"AutomaticGainControlV2TagNotSupported");
RETURN_IF(!mContext, EX_NULL_POINTER, "nullContext");
AutomaticGainControlV2 param;
auto tag = id.get<AutomaticGainControlV2::Id::commonTag>();
switch (tag) {
case AutomaticGainControlV2::fixedDigitalGainMb: {
param.set<AutomaticGainControlV2::fixedDigitalGainMb>(
mContext->getAutomaticGainControlV2DigitalGain());
break;
}
case AutomaticGainControlV2::levelEstimator: {
param.set<AutomaticGainControlV2::levelEstimator>(
mContext->getAutomaticGainControlV2LevelEstimator());
break;
}
case AutomaticGainControlV2::saturationMarginMb: {
param.set<AutomaticGainControlV2::saturationMarginMb>(
mContext->getAutomaticGainControlV2SaturationMargin());
break;
}
default: {
LOG(ERROR) << __func__ << " unsupported tag: " << toString(tag);
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(
EX_ILLEGAL_ARGUMENT, "AutomaticGainControlV2TagNotSupported");
}
}
specific->set<Parameter::Specific::automaticGainControlV2>(param);
return ndk::ScopedAStatus::ok();
}
ndk::ScopedAStatus EffectPreProcessing::getParameterNoiseSuppression(
const NoiseSuppression::Id& id, Parameter::Specific* specific) {
RETURN_IF(id.getTag() != NoiseSuppression::Id::commonTag, EX_ILLEGAL_ARGUMENT,
"NoiseSuppressionTagNotSupported");
RETURN_IF(!mContext, EX_NULL_POINTER, "nullContext");
NoiseSuppression param;
auto tag = id.get<NoiseSuppression::Id::commonTag>();
switch (tag) {
case NoiseSuppression::level: {
param.set<NoiseSuppression::level>(mContext->getNoiseSuppressionLevel());
break;
}
default: {
LOG(ERROR) << __func__ << " unsupported tag: " << toString(tag);
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(
EX_ILLEGAL_ARGUMENT, "NoiseSuppressionTagNotSupported");
}
}
specific->set<Parameter::Specific::noiseSuppression>(param);
return ndk::ScopedAStatus::ok();
}
std::shared_ptr<EffectContext> EffectPreProcessing::createContext(const Parameter::Common& common) {
if (mContext) {
LOG(DEBUG) << __func__ << " context already exist";
} else {
// PreProcessingSession is a singleton
mContext = PreProcessingSession::getPreProcessingSession().createSession(
mType, 1 /* statusFmqDepth */, common);
}
return mContext;
}
std::shared_ptr<EffectContext> EffectPreProcessing::getContext() {
return mContext;
}
RetCode EffectPreProcessing::releaseContext() {
if (mContext) {
PreProcessingSession::getPreProcessingSession().releaseSession(mType,
mContext->getSessionId());
mContext.reset();
}
return RetCode::SUCCESS;
}
ndk::ScopedAStatus EffectPreProcessing::commandImpl(CommandId command) {
RETURN_IF(!mContext, EX_NULL_POINTER, "nullContext");
switch (command) {
case CommandId::START:
mContext->enable();
break;
case CommandId::STOP:
mContext->disable();
break;
case CommandId::RESET:
mContext->disable();
mContext->resetBuffer();
break;
default:
LOG(ERROR) << __func__ << " commandId " << toString(command) << " not supported";
return ndk::ScopedAStatus::fromExceptionCodeWithMessage(EX_ILLEGAL_ARGUMENT,
"commandIdNotSupported");
}
return ndk::ScopedAStatus::ok();
}
// Processing method running in EffectWorker thread.
IEffect::Status EffectPreProcessing::effectProcessImpl(float* in, float* out, int sampleToProcess) {
IEffect::Status status = {EX_NULL_POINTER, 0, 0};
RETURN_VALUE_IF(!mContext, status, "nullContext");
return mContext->lvmProcess(in, out, sampleToProcess);
}
} // namespace aidl::android::hardware::audio::effect