blob: e334ee902b521d31cbe3f8795cfb1370c333ad7d [file] [log] [blame]
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +00001/*
2 * Copyright (C) 2022 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#pragma once
18
Shunkai Yao812d5b42022-11-16 18:08:50 +000019#include <algorithm>
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000020#include <memory>
Shunkai Yao61f9dd22024-05-08 22:34:36 +000021#include <optional>
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000022#include <string>
Shunkai Yao0a0c45e2023-02-13 17:41:11 +000023#include <type_traits>
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000024#include <unordered_map>
Shunkai Yaof60fc372023-12-12 17:48:18 +000025#include <utility>
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000026#include <vector>
27
Mikhail Naganov872d4a62023-03-09 18:19:01 -080028#include <Utils.h>
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000029#include <aidl/android/hardware/audio/effect/IEffect.h>
30#include <aidl/android/hardware/audio/effect/IFactory.h>
31#include <aidl/android/media/audio/common/AudioChannelLayout.h>
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000032#include <android/binder_auto_utils.h>
33#include <fmq/AidlMessageQueue.h>
Krzysztof KosiƄskia3a78a62023-03-04 00:58:52 +000034#include <gtest/gtest.h>
Shunkai Yao9e60e632023-06-23 04:34:50 +000035#include <system/audio_aidl_utils.h>
Shunkai Yao0a0c45e2023-02-13 17:41:11 +000036#include <system/audio_effects/aidl_effects_utils.h>
Shunkai Yaof8be1ac2023-03-06 18:41:27 +000037#include <system/audio_effects/effect_uuid.h>
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000038
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000039#include "EffectFactoryHelper.h"
40#include "TestUtils.h"
Sneha Patil93e4eb52024-02-13 14:09:48 +053041#include "pffft.hpp"
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000042
43using namespace android;
44using aidl::android::hardware::audio::effect::CommandId;
45using aidl::android::hardware::audio::effect::Descriptor;
Shunkai Yao61f9dd22024-05-08 22:34:36 +000046using aidl::android::hardware::audio::effect::getEffectTypeUuidSpatializer;
47using aidl::android::hardware::audio::effect::getRange;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000048using aidl::android::hardware::audio::effect::IEffect;
Shunkai Yao61f9dd22024-05-08 22:34:36 +000049using aidl::android::hardware::audio::effect::isRangeValid;
Shunkai Yaoeeda2b22025-01-07 21:44:51 +000050using aidl::android::hardware::audio::effect::kDrainSupportedVersion;
Shunkai Yao61f9dd22024-05-08 22:34:36 +000051using aidl::android::hardware::audio::effect::kEffectTypeUuidSpatializer;
Shunkai Yaoef683a92024-04-18 04:38:17 +000052using aidl::android::hardware::audio::effect::kEventFlagDataMqNotEmpty;
Shunkai Yao65c7c702024-01-09 20:50:53 +000053using aidl::android::hardware::audio::effect::kEventFlagDataMqUpdate;
Shunkai Yao41888a22023-04-10 17:13:30 +000054using aidl::android::hardware::audio::effect::kEventFlagNotEmpty;
Shunkai Yaoef683a92024-04-18 04:38:17 +000055using aidl::android::hardware::audio::effect::kReopenSupportedVersion;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000056using aidl::android::hardware::audio::effect::Parameter;
Shunkai Yao0a0c45e2023-02-13 17:41:11 +000057using aidl::android::hardware::audio::effect::Range;
Shunkai Yao61f9dd22024-05-08 22:34:36 +000058using aidl::android::hardware::audio::effect::Spatializer;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000059using aidl::android::hardware::audio::effect::State;
60using aidl::android::hardware::common::fmq::SynchronizedReadWrite;
61using aidl::android::media::audio::common::AudioChannelLayout;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000062using aidl::android::media::audio::common::AudioFormatDescription;
63using aidl::android::media::audio::common::AudioFormatType;
64using aidl::android::media::audio::common::AudioUuid;
65using aidl::android::media::audio::common::PcmType;
Shunkai Yao9e60e632023-06-23 04:34:50 +000066using ::android::audio::utils::toString;
Shunkai Yao41888a22023-04-10 17:13:30 +000067using ::android::hardware::EventFlag;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000068
Shunkai Yao812d5b42022-11-16 18:08:50 +000069const AudioFormatDescription kDefaultFormatDescription = {
Shunkai Yao6afc8552022-10-26 22:47:20 +000070 .type = AudioFormatType::PCM, .pcm = PcmType::FLOAT_32_BIT, .encoding = ""};
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000071
Shunkai Yao812d5b42022-11-16 18:08:50 +000072typedef ::android::AidlMessageQueue<IEffect::Status,
73 ::aidl::android::hardware::common::fmq::SynchronizedReadWrite>
74 StatusMQ;
75typedef ::android::AidlMessageQueue<float,
76 ::aidl::android::hardware::common::fmq::SynchronizedReadWrite>
77 DataMQ;
78
Shunkai Yao9e60e632023-06-23 04:34:50 +000079static inline std::string getPrefix(Descriptor& descriptor) {
Jaideep Sharmae4c7a962023-06-14 19:14:44 +053080 std::string prefix = "Implementor_" + descriptor.common.implementor + "_name_" +
Shunkai Yao9e60e632023-06-23 04:34:50 +000081 descriptor.common.name + "_UUID_" + toString(descriptor.common.id.uuid);
Sneha Patil94abce02024-04-03 12:15:03 +053082 std::replace_if(
83 prefix.begin(), prefix.end(), [](const char c) { return !std::isalnum(c); }, '_');
Jaideep Sharmae4c7a962023-06-14 19:14:44 +053084 return prefix;
85}
86
Aayush Sonibb001fb2024-09-11 13:51:14 +000087static constexpr float kMaxAudioSampleValue = 1;
Aayush Sonifbb5cd32024-11-21 10:51:46 +000088static constexpr int kNPointFFT = 16384;
Aayush Soni03460112024-11-04 07:14:44 +000089static constexpr int kSamplingFrequency = 44100;
Aayush Sonifbb5cd32024-11-21 10:51:46 +000090static constexpr int kDefaultChannelLayout = AudioChannelLayout::LAYOUT_STEREO;
Sneha Patil903c6202025-01-30 06:37:10 +000091static constexpr float kLn10Div20 = -0.11512925f; // -ln(10)/20
Aayush Sonibb001fb2024-09-11 13:51:14 +000092
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000093class EffectHelper {
94 public:
Shunkai Yao61f9dd22024-05-08 22:34:36 +000095 void create(std::shared_ptr<IFactory> factory, std::shared_ptr<IEffect>& effect,
96 Descriptor& desc, binder_status_t status = EX_NONE) {
Shunkai Yao812d5b42022-11-16 18:08:50 +000097 ASSERT_NE(factory, nullptr);
Shunkai Yaocb0fc412022-12-15 20:34:32 +000098 auto& id = desc.common.id;
99 ASSERT_STATUS(status, factory->createEffect(id.uuid, &effect));
Shunkai Yao812d5b42022-11-16 18:08:50 +0000100 if (status == EX_NONE) {
Jaideep Sharmae4c7a962023-06-14 19:14:44 +0530101 ASSERT_NE(effect, nullptr) << toString(id.uuid);
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000102 ASSERT_NO_FATAL_FAILURE(expectState(effect, State::INIT));
Shunkai Yao812d5b42022-11-16 18:08:50 +0000103 }
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000104 mIsSpatializer = id.type == getEffectTypeUuidSpatializer();
105 mDescriptor = desc;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000106 }
107
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000108 static void destroyIgnoreRet(std::shared_ptr<IFactory> factory,
109 std::shared_ptr<IEffect> effect) {
110 if (factory && effect) {
111 factory->destroyEffect(effect);
112 }
113 }
114
Shunkai Yao812d5b42022-11-16 18:08:50 +0000115 static void destroy(std::shared_ptr<IFactory> factory, std::shared_ptr<IEffect> effect,
116 binder_status_t status = EX_NONE) {
117 ASSERT_NE(factory, nullptr);
118 ASSERT_NE(effect, nullptr);
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000119 ASSERT_STATUS(status, factory->destroyEffect(effect));
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000120 }
121
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000122 void open(std::shared_ptr<IEffect> effect, const Parameter::Common& common,
123 const std::optional<Parameter::Specific>& specific, IEffect::OpenEffectReturn* ret,
124 binder_status_t status = EX_NONE) {
Shunkai Yao812d5b42022-11-16 18:08:50 +0000125 ASSERT_NE(effect, nullptr);
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000126 ASSERT_STATUS(status, effect->open(common, specific, ret));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000127 if (status != EX_NONE) {
128 return;
129 }
130
Shunkai Yao240c1d42024-11-24 18:40:58 +0000131 ASSERT_TRUE(expectState(effect, State::IDLE));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000132 updateFrameSize(common);
Shunkai Yao812d5b42022-11-16 18:08:50 +0000133 }
134
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000135 void open(std::shared_ptr<IEffect> effect, int session = 0, binder_status_t status = EX_NONE) {
Shunkai Yao812d5b42022-11-16 18:08:50 +0000136 ASSERT_NE(effect, nullptr);
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000137 Parameter::Common common = createParamCommon(session);
Shunkai Yao812d5b42022-11-16 18:08:50 +0000138 IEffect::OpenEffectReturn ret;
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000139 ASSERT_NO_FATAL_FAILURE(open(effect, common, std::nullopt /* specific */, &ret, status));
Shunkai Yao812d5b42022-11-16 18:08:50 +0000140 }
141
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000142 void reopen(std::shared_ptr<IEffect> effect, const Parameter::Common& common,
143 IEffect::OpenEffectReturn* ret, binder_status_t status = EX_NONE) {
144 ASSERT_NE(effect, nullptr);
145 ASSERT_STATUS(status, effect->reopen(ret));
146 if (status != EX_NONE) {
147 return;
148 }
149 updateFrameSize(common);
150 }
151
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000152 static void closeIgnoreRet(std::shared_ptr<IEffect> effect) {
153 if (effect) {
154 effect->close();
155 }
156 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000157
Shunkai Yao812d5b42022-11-16 18:08:50 +0000158 static void close(std::shared_ptr<IEffect> effect, binder_status_t status = EX_NONE) {
159 if (effect) {
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000160 ASSERT_STATUS(status, effect->close());
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000161 if (status == EX_NONE) {
Shunkai Yao240c1d42024-11-24 18:40:58 +0000162 ASSERT_TRUE(expectState(effect, State::INIT));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000163 }
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000164 }
165 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000166
Shunkai Yao812d5b42022-11-16 18:08:50 +0000167 static void getDescriptor(std::shared_ptr<IEffect> effect, Descriptor& desc,
168 binder_status_t status = EX_NONE) {
169 ASSERT_NE(effect, nullptr);
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000170 ASSERT_STATUS(status, effect->getDescriptor(&desc));
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000171 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000172
Shunkai Yao240c1d42024-11-24 18:40:58 +0000173 static bool expectState(std::shared_ptr<IEffect> effect, State expectState) {
174 if (effect == nullptr) return false;
175
176 if (State state; EX_NONE != effect->getState(&state).getStatus() || expectState != state) {
177 return false;
178 }
179
180 return true;
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000181 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000182
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000183 static void commandIgnoreRet(std::shared_ptr<IEffect> effect, CommandId command) {
184 if (effect) {
185 effect->command(command);
186 }
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000187 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000188
Shunkai Yao812d5b42022-11-16 18:08:50 +0000189 static void command(std::shared_ptr<IEffect> effect, CommandId command,
190 binder_status_t status = EX_NONE) {
191 ASSERT_NE(effect, nullptr);
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000192 ASSERT_STATUS(status, effect->command(command));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000193 if (status != EX_NONE) {
194 return;
195 }
196
197 switch (command) {
198 case CommandId::START:
Shunkai Yao240c1d42024-11-24 18:40:58 +0000199 ASSERT_TRUE(expectState(effect, State::PROCESSING));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000200 break;
201 case CommandId::STOP:
Shunkai Yaoeeda2b22025-01-07 21:44:51 +0000202 // Enforce the state checking after kDrainSupportedVersion
203 if (getHalVersion(effect) >= kDrainSupportedVersion) {
204 ASSERT_TRUE(expectState(effect, State::IDLE) ||
205 expectState(effect, State::DRAINING));
206 }
Shunkai Yao240c1d42024-11-24 18:40:58 +0000207 break;
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000208 case CommandId::RESET:
Shunkai Yao240c1d42024-11-24 18:40:58 +0000209 ASSERT_TRUE(expectState(effect, State::IDLE));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000210 break;
211 default:
212 return;
213 }
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000214 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000215
Shunkai Yao41888a22023-04-10 17:13:30 +0000216 static void writeToFmq(std::unique_ptr<StatusMQ>& statusMq, std::unique_ptr<DataMQ>& dataMq,
Shunkai Yaoef683a92024-04-18 04:38:17 +0000217 const std::vector<float>& buffer, int version) {
Shunkai Yao41888a22023-04-10 17:13:30 +0000218 const size_t available = dataMq->availableToWrite();
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000219 ASSERT_NE(0Ul, available);
Shunkai Yao812d5b42022-11-16 18:08:50 +0000220 auto bufferFloats = buffer.size();
221 auto floatsToWrite = std::min(available, bufferFloats);
Shunkai Yao41888a22023-04-10 17:13:30 +0000222 ASSERT_TRUE(dataMq->write(buffer.data(), floatsToWrite));
223
224 EventFlag* efGroup;
225 ASSERT_EQ(::android::OK,
226 EventFlag::createEventFlag(statusMq->getEventFlagWord(), &efGroup));
227 ASSERT_NE(nullptr, efGroup);
Shunkai Yaoef683a92024-04-18 04:38:17 +0000228 efGroup->wake(version >= kReopenSupportedVersion ? kEventFlagDataMqNotEmpty
229 : kEventFlagNotEmpty);
Shunkai Yao41888a22023-04-10 17:13:30 +0000230 ASSERT_EQ(::android::OK, EventFlag::deleteEventFlag(&efGroup));
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000231 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000232
Shunkai Yao812d5b42022-11-16 18:08:50 +0000233 static void readFromFmq(std::unique_ptr<StatusMQ>& statusMq, size_t statusNum,
234 std::unique_ptr<DataMQ>& dataMq, size_t expectFloats,
Shunkai Yaob49631f2023-02-03 01:44:32 +0000235 std::vector<float>& buffer,
236 std::optional<int> expectStatus = STATUS_OK) {
237 if (0 == statusNum) {
238 ASSERT_EQ(0ul, statusMq->availableToRead());
239 return;
240 }
Shunkai Yao812d5b42022-11-16 18:08:50 +0000241 IEffect::Status status{};
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000242 ASSERT_TRUE(statusMq->readBlocking(&status, statusNum));
Shunkai Yaob49631f2023-02-03 01:44:32 +0000243 if (expectStatus.has_value()) {
244 ASSERT_EQ(expectStatus.value(), status.status);
245 }
246
247 ASSERT_EQ(expectFloats, (unsigned)status.fmqProduced);
248 ASSERT_EQ(expectFloats, dataMq->availableToRead());
249 if (expectFloats != 0) {
250 ASSERT_TRUE(dataMq->read(buffer.data(), expectFloats));
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000251 }
252 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000253
Shunkai Yao65c7c702024-01-09 20:50:53 +0000254 static void expectDataMqUpdateEventFlag(std::unique_ptr<StatusMQ>& statusMq) {
255 EventFlag* efGroup;
256 ASSERT_EQ(::android::OK,
257 EventFlag::createEventFlag(statusMq->getEventFlagWord(), &efGroup));
258 ASSERT_NE(nullptr, efGroup);
259 uint32_t efState = 0;
260 EXPECT_EQ(::android::OK, efGroup->wait(kEventFlagDataMqUpdate, &efState, 1'000'000 /*1ms*/,
261 true /* retry */));
262 EXPECT_TRUE(efState & kEventFlagDataMqUpdate);
263 }
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000264
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000265 Parameter::Common createParamCommon(
266 int session = 0, int ioHandle = -1, int iSampleRate = 48000, int oSampleRate = 48000,
267 long iFrameCount = 0x100, long oFrameCount = 0x100,
268 AudioChannelLayout inputChannelLayout =
269 AudioChannelLayout::make<AudioChannelLayout::layoutMask>(kDefaultChannelLayout),
270 AudioChannelLayout outputChannelLayout =
271 AudioChannelLayout::make<AudioChannelLayout::layoutMask>(
272 kDefaultChannelLayout)) {
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000273 // query supported input layout and use it as the default parameter in common
274 if (mIsSpatializer && isRangeValid<Range::spatializer>(Spatializer::supportedChannelLayout,
275 mDescriptor.capability)) {
276 const auto layoutRange = getRange<Range::spatializer, Range::SpatializerRange>(
277 mDescriptor.capability, Spatializer::supportedChannelLayout);
278 if (std::vector<AudioChannelLayout> layouts;
279 layoutRange &&
280 0 != (layouts = layoutRange->min.get<Spatializer::supportedChannelLayout>())
281 .size()) {
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000282 inputChannelLayout = layouts[0];
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000283 }
284 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000285
Shunkai Yao812d5b42022-11-16 18:08:50 +0000286 Parameter::Common common;
287 common.session = session;
288 common.ioHandle = ioHandle;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000289
Shunkai Yao812d5b42022-11-16 18:08:50 +0000290 auto& input = common.input;
291 auto& output = common.output;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000292 input.base.sampleRate = iSampleRate;
Shunkai Yao812d5b42022-11-16 18:08:50 +0000293 input.base.channelMask = inputChannelLayout;
294 input.base.format = kDefaultFormatDescription;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000295 input.frameCount = iFrameCount;
296 output.base.sampleRate = oSampleRate;
Shunkai Yao812d5b42022-11-16 18:08:50 +0000297 output.base.channelMask = outputChannelLayout;
298 output.base.format = kDefaultFormatDescription;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000299 output.frameCount = oFrameCount;
Shunkai Yao812d5b42022-11-16 18:08:50 +0000300 return common;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000301 }
302
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000303 typedef ::android::AidlMessageQueue<
304 IEffect::Status, ::aidl::android::hardware::common::fmq::SynchronizedReadWrite>
305 StatusMQ;
306 typedef ::android::AidlMessageQueue<
Shunkai Yao6afc8552022-10-26 22:47:20 +0000307 float, ::aidl::android::hardware::common::fmq::SynchronizedReadWrite>
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000308 DataMQ;
309
310 class EffectParam {
311 public:
312 std::unique_ptr<StatusMQ> statusMQ;
313 std::unique_ptr<DataMQ> inputMQ;
314 std::unique_ptr<DataMQ> outputMQ;
315 };
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000316
317 template <typename T, Range::Tag tag>
318 static bool isParameterValid(const T& target, const Descriptor& desc) {
319 if (desc.capability.range.getTag() != tag) {
320 return true;
321 }
322 const auto& ranges = desc.capability.range.get<tag>();
323 return inRange(target, ranges);
324 }
325
326 /**
327 * Add to test value set: (min+max)/2, minimum/maximum numeric limits, and min-1/max+1 if
328 * result still in numeric limits after -1/+1.
329 * Only use this when the type of test value is basic type (std::is_arithmetic return true).
330 */
331 template <typename S, typename = std::enable_if_t<std::is_arithmetic_v<S>>>
332 static std::set<S> expandTestValueBasic(std::set<S>& s) {
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000333 const auto minLimit = std::numeric_limits<S>::min(),
334 maxLimit = std::numeric_limits<S>::max();
335 if (s.size()) {
Shraddha Basantwanib76f5ab2023-03-27 16:00:03 +0530336 const auto min = *s.begin(), max = *s.rbegin();
Shunkai Yao5ed80c52023-09-07 17:42:39 +0000337 s.insert((min & max) + ((min ^ max) >> 1));
338 if (min > minLimit + 1) {
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000339 s.insert(min - 1);
340 }
Shunkai Yao5ed80c52023-09-07 17:42:39 +0000341 if (max < maxLimit - 1) {
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000342 s.insert(max + 1);
343 }
344 }
345 s.insert(minLimit);
346 s.insert(maxLimit);
347 return s;
348 }
349
Shunkai Yaof60fc372023-12-12 17:48:18 +0000350 template <typename T, typename S, Range::Tag R, typename T::Tag tag>
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000351 static std::set<S> getTestValueSet(
Shunkai Yaof60fc372023-12-12 17:48:18 +0000352 std::vector<std::pair<std::shared_ptr<IFactory>, Descriptor>> descList) {
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000353 std::set<S> result;
Shunkai Yaof60fc372023-12-12 17:48:18 +0000354 for (const auto& [_, desc] : descList) {
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000355 if (desc.capability.range.getTag() == R) {
356 const auto& ranges = desc.capability.range.get<R>();
357 for (const auto& range : ranges) {
358 if (range.min.getTag() == tag) {
359 result.insert(range.min.template get<tag>());
360 }
361 if (range.max.getTag() == tag) {
362 result.insert(range.max.template get<tag>());
363 }
364 }
365 }
366 }
Shunkai Yaof60fc372023-12-12 17:48:18 +0000367 return result;
368 }
369
370 template <typename T, typename S, Range::Tag R, typename T::Tag tag, typename Functor>
371 static std::set<S> getTestValueSet(
372 std::vector<std::pair<std::shared_ptr<IFactory>, Descriptor>> descList,
373 Functor functor) {
374 auto result = getTestValueSet<T, S, R, tag>(descList);
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000375 return functor(result);
376 }
Sneha Patilf533b502023-10-25 12:39:55 +0530377
Shunkai Yao240c1d42024-11-24 18:40:58 +0000378 // keep writing data to the FMQ until effect transit from DRAINING to IDLE
379 static void waitForDrain(std::vector<float>& inputBuffer, std::vector<float>& outputBuffer,
380 const std::shared_ptr<IEffect>& effect,
381 std::unique_ptr<EffectHelper::StatusMQ>& statusMQ,
382 std::unique_ptr<EffectHelper::DataMQ>& inputMQ,
383 std::unique_ptr<EffectHelper::DataMQ>& outputMQ, int version) {
384 State state;
385 while (effect->getState(&state).getStatus() == EX_NONE && state == State::DRAINING) {
386 EXPECT_NO_FATAL_FAILURE(
387 EffectHelper::writeToFmq(statusMQ, inputMQ, inputBuffer, version));
388 EXPECT_NO_FATAL_FAILURE(EffectHelper::readFromFmq(
389 statusMQ, 1, outputMQ, outputBuffer.size(), outputBuffer, std::nullopt));
390 }
391 ASSERT_TRUE(State::IDLE == state);
392 EXPECT_NO_FATAL_FAILURE(EffectHelper::readFromFmq(statusMQ, 0, outputMQ, 0, outputBuffer));
393 return;
394 }
395
Sneha Patilf533b502023-10-25 12:39:55 +0530396 static void processAndWriteToOutput(std::vector<float>& inputBuffer,
397 std::vector<float>& outputBuffer,
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000398 const std::shared_ptr<IEffect>& effect,
399 IEffect::OpenEffectReturn* openEffectReturn,
Aayush Soni9eb548c2024-10-22 13:07:47 +0000400 int version = -1, int times = 1,
401 bool callStopReset = true) {
Sneha Patilf533b502023-10-25 12:39:55 +0530402 // Initialize AidlMessagequeues
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000403 auto statusMQ = std::make_unique<EffectHelper::StatusMQ>(openEffectReturn->statusMQ);
Sneha Patilf533b502023-10-25 12:39:55 +0530404 ASSERT_TRUE(statusMQ->isValid());
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000405 auto inputMQ = std::make_unique<EffectHelper::DataMQ>(openEffectReturn->inputDataMQ);
Sneha Patilf533b502023-10-25 12:39:55 +0530406 ASSERT_TRUE(inputMQ->isValid());
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000407 auto outputMQ = std::make_unique<EffectHelper::DataMQ>(openEffectReturn->outputDataMQ);
Sneha Patilf533b502023-10-25 12:39:55 +0530408 ASSERT_TRUE(outputMQ->isValid());
409
410 // Enabling the process
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000411 ASSERT_NO_FATAL_FAILURE(command(effect, CommandId::START));
Sneha Patilf533b502023-10-25 12:39:55 +0530412
413 // Write from buffer to message queues and calling process
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000414 if (version == -1) {
415 ASSERT_IS_OK(effect->getInterfaceVersion(&version));
416 }
Sneha Patilf533b502023-10-25 12:39:55 +0530417
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000418 for (int i = 0; i < times; i++) {
419 EXPECT_NO_FATAL_FAILURE(
420 EffectHelper::writeToFmq(statusMQ, inputMQ, inputBuffer, version));
421 // Read the updated message queues into buffer
422 EXPECT_NO_FATAL_FAILURE(EffectHelper::readFromFmq(statusMQ, 1, outputMQ,
423 outputBuffer.size(), outputBuffer));
424 }
425
Shraddha Basantwani0a981d32024-07-24 08:42:50 +0000426 // Disable the process
Aayush Soni9eb548c2024-10-22 13:07:47 +0000427 if (callStopReset) {
428 ASSERT_NO_FATAL_FAILURE(command(effect, CommandId::STOP));
Shunkai Yao240c1d42024-11-24 18:40:58 +0000429 EXPECT_NO_FATAL_FAILURE(waitForDrain(inputBuffer, outputBuffer, effect, statusMQ,
430 inputMQ, outputMQ, version));
Aayush Soni9eb548c2024-10-22 13:07:47 +0000431 }
Sneha Patilf533b502023-10-25 12:39:55 +0530432
Aayush Soni9eb548c2024-10-22 13:07:47 +0000433 if (callStopReset) {
434 ASSERT_NO_FATAL_FAILURE(command(effect, CommandId::RESET));
435 }
Sneha Patilf533b502023-10-25 12:39:55 +0530436 }
Sneha Patil93e4eb52024-02-13 14:09:48 +0530437
438 // Find FFT bin indices for testFrequencies and get bin center frequencies
439 void roundToFreqCenteredToFftBin(std::vector<int>& testFrequencies,
440 std::vector<int>& binOffsets, const float kBinWidth) {
441 for (size_t i = 0; i < testFrequencies.size(); i++) {
442 binOffsets[i] = std::round(testFrequencies[i] / kBinWidth);
443 testFrequencies[i] = std::round(binOffsets[i] * kBinWidth);
444 }
445 }
446
Aayush Sonibb001fb2024-09-11 13:51:14 +0000447 // Fill inputBuffer with random values between -maxAudioSampleValue to maxAudioSampleValue
448 void generateInputBuffer(std::vector<float>& inputBuffer, size_t startPosition, bool isStrip,
449 size_t channelCount,
450 float maxAudioSampleValue = kMaxAudioSampleValue) {
451 size_t increment = isStrip ? 1 /*Fill input at all the channels*/
452 : channelCount /*Fill input at only one channel*/;
453
454 for (size_t i = startPosition; i < inputBuffer.size(); i += increment) {
455 inputBuffer[i] =
456 ((static_cast<float>(std::rand()) / RAND_MAX) * 2 - 1) * maxAudioSampleValue;
457 }
458 }
459
Sneha Patiled98f7b2024-10-22 13:07:47 +0000460 // Generate multitone input between -amplitude to +amplitude using testFrequencies
461 // All test frequencies are considered having the same amplitude
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000462 // The function supports only mono and stereo channel layout
Sneha Patiled98f7b2024-10-22 13:07:47 +0000463 void generateSineWave(const std::vector<int>& testFrequencies, std::vector<float>& input,
464 const float amplitude = 1.0,
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000465 const int samplingFrequency = kSamplingFrequency,
466 int channelLayout = AudioChannelLayout::LAYOUT_STEREO) {
467 bool isStereo = (channelLayout == AudioChannelLayout::LAYOUT_STEREO);
468 if (isStereo) {
469 ASSERT_EQ(input.size() % 2, 0u)
470 << "In case of stereo input, the input size value must be even";
471 }
472 for (size_t i = 0; i < input.size(); i += (isStereo ? 2 : 1)) {
Sneha Patil93e4eb52024-02-13 14:09:48 +0530473 input[i] = 0;
474
475 for (size_t j = 0; j < testFrequencies.size(); j++) {
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000476 input[i] += sin(2 * M_PI * testFrequencies[j] * (i / (isStereo ? 2 : 1)) /
477 samplingFrequency);
Sneha Patil93e4eb52024-02-13 14:09:48 +0530478 }
Sneha Patiled98f7b2024-10-22 13:07:47 +0000479 input[i] *= amplitude / testFrequencies.size();
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000480
481 if (isStereo) {
482 input[i + 1] = input[i];
483 }
Sneha Patil93e4eb52024-02-13 14:09:48 +0530484 }
485 }
486
Sneha Patiled98f7b2024-10-22 13:07:47 +0000487 // Generate single tone input between -amplitude to +amplitude using testFrequency
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000488 // The function supports only mono and stereo channel layout
Sneha Patiled98f7b2024-10-22 13:07:47 +0000489 void generateSineWave(const int testFrequency, std::vector<float>& input,
490 const float amplitude = 1.0,
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000491 const int samplingFrequency = kSamplingFrequency,
492 int channelLayout = AudioChannelLayout::LAYOUT_STEREO) {
493 ASSERT_NO_FATAL_FAILURE(generateSineWave(std::vector<int>{testFrequency}, input, amplitude,
494 samplingFrequency, channelLayout));
495 }
496
497 // PFFFT only supports transforms for inputs of length N of the form N = (2^a)*(3^b)*(5^c) where
498 // a >= 5, b >=0, c >= 0.
499 constexpr bool isFftInputSizeValid(size_t n) {
500 if (n == 0 || n & 0b11111) {
501 return false;
502 }
503 for (const int factor : {2, 3, 5}) {
504 while (n % factor == 0) {
505 n /= factor;
506 }
507 }
508 return n == 1;
Sneha Patiled98f7b2024-10-22 13:07:47 +0000509 }
510
Sneha Patil93e4eb52024-02-13 14:09:48 +0530511 // Use FFT transform to convert the buffer to frequency domain
512 // Compute its magnitude at binOffsets
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000513 void calculateMagnitudeMono(std::vector<float>& bufferMag, // Output parameter
514 const std::vector<float>& buffer, // Input parameter
515 const std::vector<int>& binOffsets, // Input parameter
516 const int nPointFFT = kNPointFFT) { // Input parameter
517 ASSERT_TRUE(isFftInputSizeValid(nPointFFT))
518 << "PFFFT only supports transforms for inputs of length N of the form N = (2 ^ a) "
519 "* (3 ^ b) * (5 ^ c) where a >= 5, b >= 0, c >= 0. ";
520 ASSERT_GE((int)buffer.size(), nPointFFT)
521 << "The input(buffer) size must be greater than or equal to nPointFFT";
522 bufferMag.resize(binOffsets.size());
Sneha Patil93e4eb52024-02-13 14:09:48 +0530523 std::vector<float> fftInput(nPointFFT);
Sadaf Ebrahimi57b0bac2025-01-27 17:56:00 +0000524 pffft::detail::PFFFT_Setup* inputHandle =
525 pffft_new_setup(nPointFFT, pffft::detail::PFFFT_REAL);
Sneha Patil93e4eb52024-02-13 14:09:48 +0530526 pffft_transform_ordered(inputHandle, buffer.data(), fftInput.data(), nullptr,
Sadaf Ebrahimi57b0bac2025-01-27 17:56:00 +0000527 pffft::detail::PFFFT_FORWARD);
Sneha Patil93e4eb52024-02-13 14:09:48 +0530528 pffft_destroy_setup(inputHandle);
Sneha Patil93e4eb52024-02-13 14:09:48 +0530529 for (size_t i = 0; i < binOffsets.size(); i++) {
530 size_t k = binOffsets[i];
531 bufferMag[i] = sqrt((fftInput[k * 2] * fftInput[k * 2]) +
532 (fftInput[k * 2 + 1] * fftInput[k * 2 + 1]));
533 }
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000534 }
Sneha Patil93e4eb52024-02-13 14:09:48 +0530535
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000536 // Use FFT transform to convert the buffer to frequency domain
537 // Compute its magnitude at binOffsets
538 void calculateMagnitudeStereo(
539 std::pair<std::vector<float>, std::vector<float>>& bufferMag, // Output parameter
540 const std::vector<float>& buffer, // Input parameter
541 const std::vector<int>& binOffsets, // Input parameter
542 const int nPointFFT = kNPointFFT) { // Input parameter
543 std::vector<float> leftChannelBuffer(buffer.size() / 2),
544 rightChannelBuffer(buffer.size() / 2);
545 for (size_t i = 0; i < buffer.size(); i += 2) {
546 leftChannelBuffer[i / 2] = buffer[i];
547 rightChannelBuffer[i / 2] = buffer[i + 1];
548 }
549 std::vector<float> leftMagnitude(binOffsets.size());
550 std::vector<float> rightMagnitude(binOffsets.size());
551
552 ASSERT_NO_FATAL_FAILURE(
553 calculateMagnitudeMono(leftMagnitude, leftChannelBuffer, binOffsets, nPointFFT));
554 ASSERT_NO_FATAL_FAILURE(
555 calculateMagnitudeMono(rightMagnitude, rightChannelBuffer, binOffsets, nPointFFT));
556
557 bufferMag = {leftMagnitude, rightMagnitude};
558 }
559
560 // Computes magnitude for mono and stereo inputs and verifies equal magnitude for left and right
561 // channel in case of stereo inputs
562 void calculateAndVerifyMagnitude(std::vector<float>& mag, // Output parameter
563 const int channelLayout, // Input parameter
564 const std::vector<float>& buffer, // Input parameter
565 const std::vector<int>& binOffsets, // Input parameter
566 const int nPointFFT = kNPointFFT) { // Input parameter
567 if (channelLayout == AudioChannelLayout::LAYOUT_STEREO) {
568 std::pair<std::vector<float>, std::vector<float>> magStereo;
569 ASSERT_NO_FATAL_FAILURE(
570 calculateMagnitudeStereo(magStereo, buffer, binOffsets, nPointFFT));
571 ASSERT_EQ(magStereo.first, magStereo.second);
572
573 mag = magStereo.first;
574 } else {
575 ASSERT_NO_FATAL_FAILURE(calculateMagnitudeMono(mag, buffer, binOffsets, nPointFFT));
576 }
Sneha Patil93e4eb52024-02-13 14:09:48 +0530577 }
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000578
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000579 void updateFrameSize(const Parameter::Common& common) {
580 mInputFrameSize = ::aidl::android::hardware::audio::common::getFrameSizeInBytes(
581 common.input.base.format, common.input.base.channelMask);
582 mInputSamples = common.input.frameCount * mInputFrameSize / sizeof(float);
583 mOutputFrameSize = ::aidl::android::hardware::audio::common::getFrameSizeInBytes(
584 common.output.base.format, common.output.base.channelMask);
585 mOutputSamples = common.output.frameCount * mOutputFrameSize / sizeof(float);
586 }
587
Sneha Patil393369b2024-07-16 13:50:05 +0000588 void generateInput(std::vector<float>& input, float inputFrequency, float samplingFrequency,
589 size_t inputSize = 0) {
590 if (inputSize == 0 || inputSize > input.size()) {
591 inputSize = input.size();
592 }
593
594 for (size_t i = 0; i < inputSize; i++) {
595 input[i] = sin(2 * M_PI * inputFrequency * i / samplingFrequency);
596 }
597 }
598
Sneha Patil903c6202025-01-30 06:37:10 +0000599 constexpr float dBToAmplitude(float dB) { return std::exp(dB * kLn10Div20); }
600
Shunkai Yaoeeda2b22025-01-07 21:44:51 +0000601 static int getHalVersion(const std::shared_ptr<IEffect>& effect) {
602 int version = 0;
603 return (effect && effect->getInterfaceVersion(&version).isOk()) ? version : 0;
604 }
605
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000606 bool mIsSpatializer;
607 Descriptor mDescriptor;
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000608 size_t mInputFrameSize, mOutputFrameSize;
609 size_t mInputSamples, mOutputSamples;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000610};