blob: 754a08f5036a10f0996c56541acc58a5323cfef2 [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;
Aayush Sonibb001fb2024-09-11 13:51:14 +000091
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +000092class EffectHelper {
93 public:
Shunkai Yao61f9dd22024-05-08 22:34:36 +000094 void create(std::shared_ptr<IFactory> factory, std::shared_ptr<IEffect>& effect,
95 Descriptor& desc, binder_status_t status = EX_NONE) {
Shunkai Yao812d5b42022-11-16 18:08:50 +000096 ASSERT_NE(factory, nullptr);
Shunkai Yaocb0fc412022-12-15 20:34:32 +000097 auto& id = desc.common.id;
98 ASSERT_STATUS(status, factory->createEffect(id.uuid, &effect));
Shunkai Yao812d5b42022-11-16 18:08:50 +000099 if (status == EX_NONE) {
Jaideep Sharmae4c7a962023-06-14 19:14:44 +0530100 ASSERT_NE(effect, nullptr) << toString(id.uuid);
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000101 ASSERT_NO_FATAL_FAILURE(expectState(effect, State::INIT));
Shunkai Yao812d5b42022-11-16 18:08:50 +0000102 }
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000103 mIsSpatializer = id.type == getEffectTypeUuidSpatializer();
104 mDescriptor = desc;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000105 }
106
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000107 static void destroyIgnoreRet(std::shared_ptr<IFactory> factory,
108 std::shared_ptr<IEffect> effect) {
109 if (factory && effect) {
110 factory->destroyEffect(effect);
111 }
112 }
113
Shunkai Yao812d5b42022-11-16 18:08:50 +0000114 static void destroy(std::shared_ptr<IFactory> factory, std::shared_ptr<IEffect> effect,
115 binder_status_t status = EX_NONE) {
116 ASSERT_NE(factory, nullptr);
117 ASSERT_NE(effect, nullptr);
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000118 ASSERT_STATUS(status, factory->destroyEffect(effect));
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000119 }
120
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000121 void open(std::shared_ptr<IEffect> effect, const Parameter::Common& common,
122 const std::optional<Parameter::Specific>& specific, IEffect::OpenEffectReturn* ret,
123 binder_status_t status = EX_NONE) {
Shunkai Yao812d5b42022-11-16 18:08:50 +0000124 ASSERT_NE(effect, nullptr);
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000125 ASSERT_STATUS(status, effect->open(common, specific, ret));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000126 if (status != EX_NONE) {
127 return;
128 }
129
Shunkai Yao240c1d42024-11-24 18:40:58 +0000130 ASSERT_TRUE(expectState(effect, State::IDLE));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000131 updateFrameSize(common);
Shunkai Yao812d5b42022-11-16 18:08:50 +0000132 }
133
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000134 void open(std::shared_ptr<IEffect> effect, int session = 0, binder_status_t status = EX_NONE) {
Shunkai Yao812d5b42022-11-16 18:08:50 +0000135 ASSERT_NE(effect, nullptr);
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000136 Parameter::Common common = createParamCommon(session);
Shunkai Yao812d5b42022-11-16 18:08:50 +0000137 IEffect::OpenEffectReturn ret;
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000138 ASSERT_NO_FATAL_FAILURE(open(effect, common, std::nullopt /* specific */, &ret, status));
Shunkai Yao812d5b42022-11-16 18:08:50 +0000139 }
140
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000141 void reopen(std::shared_ptr<IEffect> effect, const Parameter::Common& common,
142 IEffect::OpenEffectReturn* ret, binder_status_t status = EX_NONE) {
143 ASSERT_NE(effect, nullptr);
144 ASSERT_STATUS(status, effect->reopen(ret));
145 if (status != EX_NONE) {
146 return;
147 }
148 updateFrameSize(common);
149 }
150
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000151 static void closeIgnoreRet(std::shared_ptr<IEffect> effect) {
152 if (effect) {
153 effect->close();
154 }
155 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000156
Shunkai Yao812d5b42022-11-16 18:08:50 +0000157 static void close(std::shared_ptr<IEffect> effect, binder_status_t status = EX_NONE) {
158 if (effect) {
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000159 ASSERT_STATUS(status, effect->close());
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000160 if (status == EX_NONE) {
Shunkai Yao240c1d42024-11-24 18:40:58 +0000161 ASSERT_TRUE(expectState(effect, State::INIT));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000162 }
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000163 }
164 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000165
Shunkai Yao812d5b42022-11-16 18:08:50 +0000166 static void getDescriptor(std::shared_ptr<IEffect> effect, Descriptor& desc,
167 binder_status_t status = EX_NONE) {
168 ASSERT_NE(effect, nullptr);
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000169 ASSERT_STATUS(status, effect->getDescriptor(&desc));
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000170 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000171
Shunkai Yao240c1d42024-11-24 18:40:58 +0000172 static bool expectState(std::shared_ptr<IEffect> effect, State expectState) {
173 if (effect == nullptr) return false;
174
175 if (State state; EX_NONE != effect->getState(&state).getStatus() || expectState != state) {
176 return false;
177 }
178
179 return true;
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000180 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000181
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000182 static void commandIgnoreRet(std::shared_ptr<IEffect> effect, CommandId command) {
183 if (effect) {
184 effect->command(command);
185 }
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000186 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000187
Shunkai Yao812d5b42022-11-16 18:08:50 +0000188 static void command(std::shared_ptr<IEffect> effect, CommandId command,
189 binder_status_t status = EX_NONE) {
190 ASSERT_NE(effect, nullptr);
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000191 ASSERT_STATUS(status, effect->command(command));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000192 if (status != EX_NONE) {
193 return;
194 }
195
196 switch (command) {
197 case CommandId::START:
Shunkai Yao240c1d42024-11-24 18:40:58 +0000198 ASSERT_TRUE(expectState(effect, State::PROCESSING));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000199 break;
200 case CommandId::STOP:
Shunkai Yaoeeda2b22025-01-07 21:44:51 +0000201 // Enforce the state checking after kDrainSupportedVersion
202 if (getHalVersion(effect) >= kDrainSupportedVersion) {
203 ASSERT_TRUE(expectState(effect, State::IDLE) ||
204 expectState(effect, State::DRAINING));
205 }
Shunkai Yao240c1d42024-11-24 18:40:58 +0000206 break;
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000207 case CommandId::RESET:
Shunkai Yao240c1d42024-11-24 18:40:58 +0000208 ASSERT_TRUE(expectState(effect, State::IDLE));
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000209 break;
210 default:
211 return;
212 }
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000213 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000214
Shunkai Yao41888a22023-04-10 17:13:30 +0000215 static void writeToFmq(std::unique_ptr<StatusMQ>& statusMq, std::unique_ptr<DataMQ>& dataMq,
Shunkai Yaoef683a92024-04-18 04:38:17 +0000216 const std::vector<float>& buffer, int version) {
Shunkai Yao41888a22023-04-10 17:13:30 +0000217 const size_t available = dataMq->availableToWrite();
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000218 ASSERT_NE(0Ul, available);
Shunkai Yao812d5b42022-11-16 18:08:50 +0000219 auto bufferFloats = buffer.size();
220 auto floatsToWrite = std::min(available, bufferFloats);
Shunkai Yao41888a22023-04-10 17:13:30 +0000221 ASSERT_TRUE(dataMq->write(buffer.data(), floatsToWrite));
222
223 EventFlag* efGroup;
224 ASSERT_EQ(::android::OK,
225 EventFlag::createEventFlag(statusMq->getEventFlagWord(), &efGroup));
226 ASSERT_NE(nullptr, efGroup);
Shunkai Yaoef683a92024-04-18 04:38:17 +0000227 efGroup->wake(version >= kReopenSupportedVersion ? kEventFlagDataMqNotEmpty
228 : kEventFlagNotEmpty);
Shunkai Yao41888a22023-04-10 17:13:30 +0000229 ASSERT_EQ(::android::OK, EventFlag::deleteEventFlag(&efGroup));
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000230 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000231
Shunkai Yao812d5b42022-11-16 18:08:50 +0000232 static void readFromFmq(std::unique_ptr<StatusMQ>& statusMq, size_t statusNum,
233 std::unique_ptr<DataMQ>& dataMq, size_t expectFloats,
Shunkai Yaob49631f2023-02-03 01:44:32 +0000234 std::vector<float>& buffer,
235 std::optional<int> expectStatus = STATUS_OK) {
236 if (0 == statusNum) {
237 ASSERT_EQ(0ul, statusMq->availableToRead());
238 return;
239 }
Shunkai Yao812d5b42022-11-16 18:08:50 +0000240 IEffect::Status status{};
Shunkai Yaocb0fc412022-12-15 20:34:32 +0000241 ASSERT_TRUE(statusMq->readBlocking(&status, statusNum));
Shunkai Yaob49631f2023-02-03 01:44:32 +0000242 if (expectStatus.has_value()) {
243 ASSERT_EQ(expectStatus.value(), status.status);
244 }
245
246 ASSERT_EQ(expectFloats, (unsigned)status.fmqProduced);
247 ASSERT_EQ(expectFloats, dataMq->availableToRead());
248 if (expectFloats != 0) {
249 ASSERT_TRUE(dataMq->read(buffer.data(), expectFloats));
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000250 }
251 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000252
Shunkai Yao65c7c702024-01-09 20:50:53 +0000253 static void expectDataMqUpdateEventFlag(std::unique_ptr<StatusMQ>& statusMq) {
254 EventFlag* efGroup;
255 ASSERT_EQ(::android::OK,
256 EventFlag::createEventFlag(statusMq->getEventFlagWord(), &efGroup));
257 ASSERT_NE(nullptr, efGroup);
258 uint32_t efState = 0;
259 EXPECT_EQ(::android::OK, efGroup->wait(kEventFlagDataMqUpdate, &efState, 1'000'000 /*1ms*/,
260 true /* retry */));
261 EXPECT_TRUE(efState & kEventFlagDataMqUpdate);
262 }
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000263
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000264 Parameter::Common createParamCommon(
265 int session = 0, int ioHandle = -1, int iSampleRate = 48000, int oSampleRate = 48000,
266 long iFrameCount = 0x100, long oFrameCount = 0x100,
267 AudioChannelLayout inputChannelLayout =
268 AudioChannelLayout::make<AudioChannelLayout::layoutMask>(kDefaultChannelLayout),
269 AudioChannelLayout outputChannelLayout =
270 AudioChannelLayout::make<AudioChannelLayout::layoutMask>(
271 kDefaultChannelLayout)) {
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000272 // query supported input layout and use it as the default parameter in common
273 if (mIsSpatializer && isRangeValid<Range::spatializer>(Spatializer::supportedChannelLayout,
274 mDescriptor.capability)) {
275 const auto layoutRange = getRange<Range::spatializer, Range::SpatializerRange>(
276 mDescriptor.capability, Spatializer::supportedChannelLayout);
277 if (std::vector<AudioChannelLayout> layouts;
278 layoutRange &&
279 0 != (layouts = layoutRange->min.get<Spatializer::supportedChannelLayout>())
280 .size()) {
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000281 inputChannelLayout = layouts[0];
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000282 }
283 }
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000284
Shunkai Yao812d5b42022-11-16 18:08:50 +0000285 Parameter::Common common;
286 common.session = session;
287 common.ioHandle = ioHandle;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000288
Shunkai Yao812d5b42022-11-16 18:08:50 +0000289 auto& input = common.input;
290 auto& output = common.output;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000291 input.base.sampleRate = iSampleRate;
Shunkai Yao812d5b42022-11-16 18:08:50 +0000292 input.base.channelMask = inputChannelLayout;
293 input.base.format = kDefaultFormatDescription;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000294 input.frameCount = iFrameCount;
295 output.base.sampleRate = oSampleRate;
Shunkai Yao812d5b42022-11-16 18:08:50 +0000296 output.base.channelMask = outputChannelLayout;
297 output.base.format = kDefaultFormatDescription;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000298 output.frameCount = oFrameCount;
Shunkai Yao812d5b42022-11-16 18:08:50 +0000299 return common;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000300 }
301
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000302 typedef ::android::AidlMessageQueue<
303 IEffect::Status, ::aidl::android::hardware::common::fmq::SynchronizedReadWrite>
304 StatusMQ;
305 typedef ::android::AidlMessageQueue<
Shunkai Yao6afc8552022-10-26 22:47:20 +0000306 float, ::aidl::android::hardware::common::fmq::SynchronizedReadWrite>
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000307 DataMQ;
308
309 class EffectParam {
310 public:
311 std::unique_ptr<StatusMQ> statusMQ;
312 std::unique_ptr<DataMQ> inputMQ;
313 std::unique_ptr<DataMQ> outputMQ;
314 };
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000315
316 template <typename T, Range::Tag tag>
317 static bool isParameterValid(const T& target, const Descriptor& desc) {
318 if (desc.capability.range.getTag() != tag) {
319 return true;
320 }
321 const auto& ranges = desc.capability.range.get<tag>();
322 return inRange(target, ranges);
323 }
324
325 /**
326 * Add to test value set: (min+max)/2, minimum/maximum numeric limits, and min-1/max+1 if
327 * result still in numeric limits after -1/+1.
328 * Only use this when the type of test value is basic type (std::is_arithmetic return true).
329 */
330 template <typename S, typename = std::enable_if_t<std::is_arithmetic_v<S>>>
331 static std::set<S> expandTestValueBasic(std::set<S>& s) {
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000332 const auto minLimit = std::numeric_limits<S>::min(),
333 maxLimit = std::numeric_limits<S>::max();
334 if (s.size()) {
Shraddha Basantwanib76f5ab2023-03-27 16:00:03 +0530335 const auto min = *s.begin(), max = *s.rbegin();
Shunkai Yao5ed80c52023-09-07 17:42:39 +0000336 s.insert((min & max) + ((min ^ max) >> 1));
337 if (min > minLimit + 1) {
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000338 s.insert(min - 1);
339 }
Shunkai Yao5ed80c52023-09-07 17:42:39 +0000340 if (max < maxLimit - 1) {
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000341 s.insert(max + 1);
342 }
343 }
344 s.insert(minLimit);
345 s.insert(maxLimit);
346 return s;
347 }
348
Shunkai Yaof60fc372023-12-12 17:48:18 +0000349 template <typename T, typename S, Range::Tag R, typename T::Tag tag>
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000350 static std::set<S> getTestValueSet(
Shunkai Yaof60fc372023-12-12 17:48:18 +0000351 std::vector<std::pair<std::shared_ptr<IFactory>, Descriptor>> descList) {
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000352 std::set<S> result;
Shunkai Yaof60fc372023-12-12 17:48:18 +0000353 for (const auto& [_, desc] : descList) {
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000354 if (desc.capability.range.getTag() == R) {
355 const auto& ranges = desc.capability.range.get<R>();
356 for (const auto& range : ranges) {
357 if (range.min.getTag() == tag) {
358 result.insert(range.min.template get<tag>());
359 }
360 if (range.max.getTag() == tag) {
361 result.insert(range.max.template get<tag>());
362 }
363 }
364 }
365 }
Shunkai Yaof60fc372023-12-12 17:48:18 +0000366 return result;
367 }
368
369 template <typename T, typename S, Range::Tag R, typename T::Tag tag, typename Functor>
370 static std::set<S> getTestValueSet(
371 std::vector<std::pair<std::shared_ptr<IFactory>, Descriptor>> descList,
372 Functor functor) {
373 auto result = getTestValueSet<T, S, R, tag>(descList);
Shunkai Yao0a0c45e2023-02-13 17:41:11 +0000374 return functor(result);
375 }
Sneha Patilf533b502023-10-25 12:39:55 +0530376
Shunkai Yao240c1d42024-11-24 18:40:58 +0000377 // keep writing data to the FMQ until effect transit from DRAINING to IDLE
378 static void waitForDrain(std::vector<float>& inputBuffer, std::vector<float>& outputBuffer,
379 const std::shared_ptr<IEffect>& effect,
380 std::unique_ptr<EffectHelper::StatusMQ>& statusMQ,
381 std::unique_ptr<EffectHelper::DataMQ>& inputMQ,
382 std::unique_ptr<EffectHelper::DataMQ>& outputMQ, int version) {
383 State state;
384 while (effect->getState(&state).getStatus() == EX_NONE && state == State::DRAINING) {
385 EXPECT_NO_FATAL_FAILURE(
386 EffectHelper::writeToFmq(statusMQ, inputMQ, inputBuffer, version));
387 EXPECT_NO_FATAL_FAILURE(EffectHelper::readFromFmq(
388 statusMQ, 1, outputMQ, outputBuffer.size(), outputBuffer, std::nullopt));
389 }
390 ASSERT_TRUE(State::IDLE == state);
391 EXPECT_NO_FATAL_FAILURE(EffectHelper::readFromFmq(statusMQ, 0, outputMQ, 0, outputBuffer));
392 return;
393 }
394
Sneha Patilf533b502023-10-25 12:39:55 +0530395 static void processAndWriteToOutput(std::vector<float>& inputBuffer,
396 std::vector<float>& outputBuffer,
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000397 const std::shared_ptr<IEffect>& effect,
398 IEffect::OpenEffectReturn* openEffectReturn,
Aayush Soni9eb548c2024-10-22 13:07:47 +0000399 int version = -1, int times = 1,
400 bool callStopReset = true) {
Sneha Patilf533b502023-10-25 12:39:55 +0530401 // Initialize AidlMessagequeues
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000402 auto statusMQ = std::make_unique<EffectHelper::StatusMQ>(openEffectReturn->statusMQ);
Sneha Patilf533b502023-10-25 12:39:55 +0530403 ASSERT_TRUE(statusMQ->isValid());
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000404 auto inputMQ = std::make_unique<EffectHelper::DataMQ>(openEffectReturn->inputDataMQ);
Sneha Patilf533b502023-10-25 12:39:55 +0530405 ASSERT_TRUE(inputMQ->isValid());
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000406 auto outputMQ = std::make_unique<EffectHelper::DataMQ>(openEffectReturn->outputDataMQ);
Sneha Patilf533b502023-10-25 12:39:55 +0530407 ASSERT_TRUE(outputMQ->isValid());
408
409 // Enabling the process
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000410 ASSERT_NO_FATAL_FAILURE(command(effect, CommandId::START));
Sneha Patilf533b502023-10-25 12:39:55 +0530411
412 // Write from buffer to message queues and calling process
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000413 if (version == -1) {
414 ASSERT_IS_OK(effect->getInterfaceVersion(&version));
415 }
Sneha Patilf533b502023-10-25 12:39:55 +0530416
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000417 for (int i = 0; i < times; i++) {
418 EXPECT_NO_FATAL_FAILURE(
419 EffectHelper::writeToFmq(statusMQ, inputMQ, inputBuffer, version));
420 // Read the updated message queues into buffer
421 EXPECT_NO_FATAL_FAILURE(EffectHelper::readFromFmq(statusMQ, 1, outputMQ,
422 outputBuffer.size(), outputBuffer));
423 }
424
Shraddha Basantwani0a981d32024-07-24 08:42:50 +0000425 // Disable the process
Aayush Soni9eb548c2024-10-22 13:07:47 +0000426 if (callStopReset) {
427 ASSERT_NO_FATAL_FAILURE(command(effect, CommandId::STOP));
Shunkai Yao240c1d42024-11-24 18:40:58 +0000428 EXPECT_NO_FATAL_FAILURE(waitForDrain(inputBuffer, outputBuffer, effect, statusMQ,
429 inputMQ, outputMQ, version));
Aayush Soni9eb548c2024-10-22 13:07:47 +0000430 }
Sneha Patilf533b502023-10-25 12:39:55 +0530431
Aayush Soni9eb548c2024-10-22 13:07:47 +0000432 if (callStopReset) {
433 ASSERT_NO_FATAL_FAILURE(command(effect, CommandId::RESET));
434 }
Sneha Patilf533b502023-10-25 12:39:55 +0530435 }
Sneha Patil93e4eb52024-02-13 14:09:48 +0530436
437 // Find FFT bin indices for testFrequencies and get bin center frequencies
438 void roundToFreqCenteredToFftBin(std::vector<int>& testFrequencies,
439 std::vector<int>& binOffsets, const float kBinWidth) {
440 for (size_t i = 0; i < testFrequencies.size(); i++) {
441 binOffsets[i] = std::round(testFrequencies[i] / kBinWidth);
442 testFrequencies[i] = std::round(binOffsets[i] * kBinWidth);
443 }
444 }
445
Aayush Sonibb001fb2024-09-11 13:51:14 +0000446 // Fill inputBuffer with random values between -maxAudioSampleValue to maxAudioSampleValue
447 void generateInputBuffer(std::vector<float>& inputBuffer, size_t startPosition, bool isStrip,
448 size_t channelCount,
449 float maxAudioSampleValue = kMaxAudioSampleValue) {
450 size_t increment = isStrip ? 1 /*Fill input at all the channels*/
451 : channelCount /*Fill input at only one channel*/;
452
453 for (size_t i = startPosition; i < inputBuffer.size(); i += increment) {
454 inputBuffer[i] =
455 ((static_cast<float>(std::rand()) / RAND_MAX) * 2 - 1) * maxAudioSampleValue;
456 }
457 }
458
Sneha Patiled98f7b2024-10-22 13:07:47 +0000459 // Generate multitone input between -amplitude to +amplitude using testFrequencies
460 // All test frequencies are considered having the same amplitude
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000461 // The function supports only mono and stereo channel layout
Sneha Patiled98f7b2024-10-22 13:07:47 +0000462 void generateSineWave(const std::vector<int>& testFrequencies, std::vector<float>& input,
463 const float amplitude = 1.0,
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000464 const int samplingFrequency = kSamplingFrequency,
465 int channelLayout = AudioChannelLayout::LAYOUT_STEREO) {
466 bool isStereo = (channelLayout == AudioChannelLayout::LAYOUT_STEREO);
467 if (isStereo) {
468 ASSERT_EQ(input.size() % 2, 0u)
469 << "In case of stereo input, the input size value must be even";
470 }
471 for (size_t i = 0; i < input.size(); i += (isStereo ? 2 : 1)) {
Sneha Patil93e4eb52024-02-13 14:09:48 +0530472 input[i] = 0;
473
474 for (size_t j = 0; j < testFrequencies.size(); j++) {
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000475 input[i] += sin(2 * M_PI * testFrequencies[j] * (i / (isStereo ? 2 : 1)) /
476 samplingFrequency);
Sneha Patil93e4eb52024-02-13 14:09:48 +0530477 }
Sneha Patiled98f7b2024-10-22 13:07:47 +0000478 input[i] *= amplitude / testFrequencies.size();
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000479
480 if (isStereo) {
481 input[i + 1] = input[i];
482 }
Sneha Patil93e4eb52024-02-13 14:09:48 +0530483 }
484 }
485
Sneha Patiled98f7b2024-10-22 13:07:47 +0000486 // Generate single tone input between -amplitude to +amplitude using testFrequency
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000487 // The function supports only mono and stereo channel layout
Sneha Patiled98f7b2024-10-22 13:07:47 +0000488 void generateSineWave(const int testFrequency, std::vector<float>& input,
489 const float amplitude = 1.0,
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000490 const int samplingFrequency = kSamplingFrequency,
491 int channelLayout = AudioChannelLayout::LAYOUT_STEREO) {
492 ASSERT_NO_FATAL_FAILURE(generateSineWave(std::vector<int>{testFrequency}, input, amplitude,
493 samplingFrequency, channelLayout));
494 }
495
496 // PFFFT only supports transforms for inputs of length N of the form N = (2^a)*(3^b)*(5^c) where
497 // a >= 5, b >=0, c >= 0.
498 constexpr bool isFftInputSizeValid(size_t n) {
499 if (n == 0 || n & 0b11111) {
500 return false;
501 }
502 for (const int factor : {2, 3, 5}) {
503 while (n % factor == 0) {
504 n /= factor;
505 }
506 }
507 return n == 1;
Sneha Patiled98f7b2024-10-22 13:07:47 +0000508 }
509
Sneha Patil93e4eb52024-02-13 14:09:48 +0530510 // Use FFT transform to convert the buffer to frequency domain
511 // Compute its magnitude at binOffsets
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000512 void calculateMagnitudeMono(std::vector<float>& bufferMag, // Output parameter
513 const std::vector<float>& buffer, // Input parameter
514 const std::vector<int>& binOffsets, // Input parameter
515 const int nPointFFT = kNPointFFT) { // Input parameter
516 ASSERT_TRUE(isFftInputSizeValid(nPointFFT))
517 << "PFFFT only supports transforms for inputs of length N of the form N = (2 ^ a) "
518 "* (3 ^ b) * (5 ^ c) where a >= 5, b >= 0, c >= 0. ";
519 ASSERT_GE((int)buffer.size(), nPointFFT)
520 << "The input(buffer) size must be greater than or equal to nPointFFT";
521 bufferMag.resize(binOffsets.size());
Sneha Patil93e4eb52024-02-13 14:09:48 +0530522 std::vector<float> fftInput(nPointFFT);
523 PFFFT_Setup* inputHandle = pffft_new_setup(nPointFFT, PFFFT_REAL);
524 pffft_transform_ordered(inputHandle, buffer.data(), fftInput.data(), nullptr,
525 PFFFT_FORWARD);
526 pffft_destroy_setup(inputHandle);
Sneha Patil93e4eb52024-02-13 14:09:48 +0530527 for (size_t i = 0; i < binOffsets.size(); i++) {
528 size_t k = binOffsets[i];
529 bufferMag[i] = sqrt((fftInput[k * 2] * fftInput[k * 2]) +
530 (fftInput[k * 2 + 1] * fftInput[k * 2 + 1]));
531 }
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000532 }
Sneha Patil93e4eb52024-02-13 14:09:48 +0530533
Aayush Sonifbb5cd32024-11-21 10:51:46 +0000534 // Use FFT transform to convert the buffer to frequency domain
535 // Compute its magnitude at binOffsets
536 void calculateMagnitudeStereo(
537 std::pair<std::vector<float>, std::vector<float>>& bufferMag, // Output parameter
538 const std::vector<float>& buffer, // Input parameter
539 const std::vector<int>& binOffsets, // Input parameter
540 const int nPointFFT = kNPointFFT) { // Input parameter
541 std::vector<float> leftChannelBuffer(buffer.size() / 2),
542 rightChannelBuffer(buffer.size() / 2);
543 for (size_t i = 0; i < buffer.size(); i += 2) {
544 leftChannelBuffer[i / 2] = buffer[i];
545 rightChannelBuffer[i / 2] = buffer[i + 1];
546 }
547 std::vector<float> leftMagnitude(binOffsets.size());
548 std::vector<float> rightMagnitude(binOffsets.size());
549
550 ASSERT_NO_FATAL_FAILURE(
551 calculateMagnitudeMono(leftMagnitude, leftChannelBuffer, binOffsets, nPointFFT));
552 ASSERT_NO_FATAL_FAILURE(
553 calculateMagnitudeMono(rightMagnitude, rightChannelBuffer, binOffsets, nPointFFT));
554
555 bufferMag = {leftMagnitude, rightMagnitude};
556 }
557
558 // Computes magnitude for mono and stereo inputs and verifies equal magnitude for left and right
559 // channel in case of stereo inputs
560 void calculateAndVerifyMagnitude(std::vector<float>& mag, // Output parameter
561 const int channelLayout, // Input parameter
562 const std::vector<float>& buffer, // Input parameter
563 const std::vector<int>& binOffsets, // Input parameter
564 const int nPointFFT = kNPointFFT) { // Input parameter
565 if (channelLayout == AudioChannelLayout::LAYOUT_STEREO) {
566 std::pair<std::vector<float>, std::vector<float>> magStereo;
567 ASSERT_NO_FATAL_FAILURE(
568 calculateMagnitudeStereo(magStereo, buffer, binOffsets, nPointFFT));
569 ASSERT_EQ(magStereo.first, magStereo.second);
570
571 mag = magStereo.first;
572 } else {
573 ASSERT_NO_FATAL_FAILURE(calculateMagnitudeMono(mag, buffer, binOffsets, nPointFFT));
574 }
Sneha Patil93e4eb52024-02-13 14:09:48 +0530575 }
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000576
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000577 void updateFrameSize(const Parameter::Common& common) {
578 mInputFrameSize = ::aidl::android::hardware::audio::common::getFrameSizeInBytes(
579 common.input.base.format, common.input.base.channelMask);
580 mInputSamples = common.input.frameCount * mInputFrameSize / sizeof(float);
581 mOutputFrameSize = ::aidl::android::hardware::audio::common::getFrameSizeInBytes(
582 common.output.base.format, common.output.base.channelMask);
583 mOutputSamples = common.output.frameCount * mOutputFrameSize / sizeof(float);
584 }
585
Sneha Patil393369b2024-07-16 13:50:05 +0000586 void generateInput(std::vector<float>& input, float inputFrequency, float samplingFrequency,
587 size_t inputSize = 0) {
588 if (inputSize == 0 || inputSize > input.size()) {
589 inputSize = input.size();
590 }
591
592 for (size_t i = 0; i < inputSize; i++) {
593 input[i] = sin(2 * M_PI * inputFrequency * i / samplingFrequency);
594 }
595 }
596
Shunkai Yaoeeda2b22025-01-07 21:44:51 +0000597 static int getHalVersion(const std::shared_ptr<IEffect>& effect) {
598 int version = 0;
599 return (effect && effect->getInterfaceVersion(&version).isOk()) ? version : 0;
600 }
601
Shunkai Yao61f9dd22024-05-08 22:34:36 +0000602 bool mIsSpatializer;
603 Descriptor mDescriptor;
Shunkai Yao28aff3d2024-06-15 03:16:06 +0000604 size_t mInputFrameSize, mOutputFrameSize;
605 size_t mInputSamples, mOutputSamples;
Shunkai Yaoa4ab38c2022-10-14 01:07:47 +0000606};