blob: 16f098eee68a00f7691fc55f1d1cb352d1085089 [file] [log] [blame]
Eric Laurentca7cc822012-11-19 14:55:58 -08001/*
2**
3** Copyright 2012, The Android Open Source Project
4**
5** Licensed under the Apache License, Version 2.0 (the "License");
6** you may not use this file except in compliance with the License.
7** You may obtain a copy of the License at
8**
9** http://www.apache.org/licenses/LICENSE-2.0
10**
11** Unless required by applicable law or agreed to in writing, software
12** distributed under the License is distributed on an "AS IS" BASIS,
13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14** See the License for the specific language governing permissions and
15** limitations under the License.
16*/
17
18
19#define LOG_TAG "AudioFlinger"
20//#define LOG_NDEBUG 0
21
rago94a1ee82017-07-21 15:11:02 -070022#include <algorithm>
23
Glenn Kasten153b9fe2013-07-15 11:23:36 -070024#include "Configuration.h"
Eric Laurentca7cc822012-11-19 14:55:58 -080025#include <utils/Log.h>
Eric Laurentd8365c52017-07-16 15:27:05 -070026#include <system/audio_effects/effect_aec.h>
Eric Laurentb62d0362021-10-26 17:40:18 +020027#include <system/audio_effects/effect_downmix.h>
Ricardo Garciac2a3a822019-07-17 14:29:12 -070028#include <system/audio_effects/effect_dynamicsprocessing.h>
jiabineb3bda02020-06-30 14:07:03 -070029#include <system/audio_effects/effect_hapticgenerator.h>
Eric Laurentd8365c52017-07-16 15:27:05 -070030#include <system/audio_effects/effect_ns.h>
Eric Laurentb62d0362021-10-26 17:40:18 +020031#include <system/audio_effects/effect_spatializer.h>
Eric Laurentd8365c52017-07-16 15:27:05 -070032#include <system/audio_effects/effect_visualizer.h>
Andy Hung0a51b5c2023-07-18 20:54:44 -070033#include <afutils/DumpTryLock.h>
Andy Hung9aad48c2017-11-29 10:29:19 -080034#include <audio_utils/channels.h>
Eric Laurentca7cc822012-11-19 14:55:58 -080035#include <audio_utils/primitives.h>
Mikhail Naganovf698ff22020-03-31 10:07:29 -070036#include <media/AudioCommonTypes.h>
jiabin8f278ee2019-11-11 12:16:27 -080037#include <media/AudioContainers.h>
Mikhail Naganov424c4f52017-07-19 17:54:29 -070038#include <media/AudioEffect.h>
jiabin8f278ee2019-11-11 12:16:27 -080039#include <media/AudioDeviceTypeAddr.h>
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -070040#include <media/ShmemCompat.h>
Mikhail Naganova0c91332016-09-19 10:01:12 -070041#include <media/audiohal/EffectHalInterface.h>
42#include <media/audiohal/EffectsFactoryHalInterface.h>
Andy Hungc747c532022-03-07 21:41:14 -080043#include <mediautils/MethodStatistics.h>
Andy Hungab7ef302018-05-15 19:35:29 -070044#include <mediautils/ServiceUtilities.h>
Andy Hunga2a1ac32022-03-18 16:12:11 -070045#include <mediautils/TimeCheck.h>
Eric Laurentca7cc822012-11-19 14:55:58 -080046
47#include "AudioFlinger.h"
Andy Hungba8e52b2023-05-11 14:33:03 -070048#include "EffectConfiguration.h"
Andy Hung6ac17eb2023-06-20 18:56:17 -070049#include "Effects.h"
Eric Laurentca7cc822012-11-19 14:55:58 -080050
51// ----------------------------------------------------------------------------
52
53// Note: the following macro is used for extremely verbose logging message. In
54// order to run with ALOG_ASSERT turned on, we need to have LOG_NDEBUG set to
55// 0; but one side effect of this is to turn all LOGV's as well. Some messages
56// are so verbose that we want to suppress them even when we have ALOG_ASSERT
57// turned on. Do not uncomment the #def below unless you really know what you
58// are doing and want to see all of the extremely verbose messages.
59//#define VERY_VERY_VERBOSE_LOGGING
60#ifdef VERY_VERY_VERBOSE_LOGGING
61#define ALOGVV ALOGV
62#else
63#define ALOGVV(a...) do { } while(0)
64#endif
65
Yuuki Yokoyamae17f8312017-05-26 19:06:33 +090066#define DEFAULT_OUTPUT_SAMPLE_RATE 48000
67
Eric Laurentca7cc822012-11-19 14:55:58 -080068namespace android {
69
Andy Hung1131b6e2020-12-08 20:47:45 -080070using aidl_utils::statusTFromBinderStatus;
Andy Hungba8e52b2023-05-11 14:33:03 -070071using audioflinger::EffectConfiguration;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -070072using binder::Status;
73
74namespace {
75
76// Append a POD value into a vector of bytes.
77template<typename T>
78void appendToBuffer(const T& value, std::vector<uint8_t>* buffer) {
79 const uint8_t* ar(reinterpret_cast<const uint8_t*>(&value));
80 buffer->insert(buffer->end(), ar, ar + sizeof(T));
81}
82
83// Write a POD value into a vector of bytes (clears the previous buffer
84// content).
85template<typename T>
86void writeToBuffer(const T& value, std::vector<uint8_t>* buffer) {
87 buffer->clear();
88 appendToBuffer(value, buffer);
89}
90
91} // namespace
92
Eric Laurentca7cc822012-11-19 14:55:58 -080093// ----------------------------------------------------------------------------
Eric Laurent41709552019-12-16 19:34:05 -080094// EffectBase implementation
Eric Laurentca7cc822012-11-19 14:55:58 -080095// ----------------------------------------------------------------------------
96
97#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -070098#define LOG_TAG "EffectBase"
Eric Laurentca7cc822012-11-19 14:55:58 -080099
Andy Hung6ac17eb2023-06-20 18:56:17 -0700100EffectBase::EffectBase(const sp<EffectCallbackInterface>& callback,
Eric Laurentca7cc822012-11-19 14:55:58 -0800101 effect_descriptor_t *desc,
102 int id,
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800103 audio_session_t sessionId,
104 bool pinned)
105 : mPinned(pinned),
Eric Laurent6b446ce2019-12-13 10:56:31 -0800106 mCallback(callback), mId(id), mSessionId(sessionId),
Eric Laurent41709552019-12-16 19:34:05 -0800107 mDescriptor(*desc)
Eric Laurentca7cc822012-11-19 14:55:58 -0800108{
Eric Laurentca7cc822012-11-19 14:55:58 -0800109}
110
Eric Laurent41709552019-12-16 19:34:05 -0800111// must be called with EffectModule::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -0700112status_t EffectBase::setEnabled_l(bool enabled)
Eric Laurentca7cc822012-11-19 14:55:58 -0800113{
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800114
Eric Laurent41709552019-12-16 19:34:05 -0800115 ALOGV("setEnabled %p enabled %d", this, enabled);
116
117 if (enabled != isEnabled()) {
118 switch (mState) {
119 // going from disabled to enabled
120 case IDLE:
121 mState = STARTING;
122 break;
123 case STOPPED:
124 mState = RESTART;
125 break;
126 case STOPPING:
127 mState = ACTIVE;
128 break;
129
130 // going from enabled to disabled
131 case RESTART:
132 mState = STOPPED;
133 break;
134 case STARTING:
135 mState = IDLE;
136 break;
137 case ACTIVE:
138 mState = STOPPING;
139 break;
140 case DESTROYED:
141 return NO_ERROR; // simply ignore as we are being destroyed
142 }
143 for (size_t i = 1; i < mHandles.size(); i++) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700144 IAfEffectHandle *h = mHandles[i];
Eric Laurent41709552019-12-16 19:34:05 -0800145 if (h != NULL && !h->disconnected()) {
146 h->setEnabled(enabled);
147 }
148 }
149 }
150 return NO_ERROR;
Eric Laurentca7cc822012-11-19 14:55:58 -0800151}
152
Andy Hung6ac17eb2023-06-20 18:56:17 -0700153status_t EffectBase::setEnabled(bool enabled, bool fromHandle)
Eric Laurent41709552019-12-16 19:34:05 -0800154{
155 status_t status;
156 {
157 Mutex::Autolock _l(mLock);
158 status = setEnabled_l(enabled);
159 }
160 if (fromHandle) {
161 if (enabled) {
162 if (status != NO_ERROR) {
Andy Hungfda44002021-06-03 17:23:16 -0700163 getCallback()->checkSuspendOnEffectEnabled(this, false, false /*threadLocked*/);
Eric Laurent41709552019-12-16 19:34:05 -0800164 } else {
Andy Hungfda44002021-06-03 17:23:16 -0700165 getCallback()->onEffectEnable(this);
Eric Laurent41709552019-12-16 19:34:05 -0800166 }
167 } else {
Andy Hungfda44002021-06-03 17:23:16 -0700168 getCallback()->onEffectDisable(this);
Eric Laurent41709552019-12-16 19:34:05 -0800169 }
170 }
171 return status;
172}
173
Andy Hung6ac17eb2023-06-20 18:56:17 -0700174bool EffectBase::isEnabled() const
Eric Laurent41709552019-12-16 19:34:05 -0800175{
176 switch (mState) {
177 case RESTART:
178 case STARTING:
179 case ACTIVE:
180 return true;
181 case IDLE:
182 case STOPPING:
183 case STOPPED:
184 case DESTROYED:
185 default:
186 return false;
187 }
188}
189
Andy Hung6ac17eb2023-06-20 18:56:17 -0700190void EffectBase::setSuspended(bool suspended)
Eric Laurent41709552019-12-16 19:34:05 -0800191{
192 Mutex::Autolock _l(mLock);
193 mSuspended = suspended;
194}
195
Andy Hung6ac17eb2023-06-20 18:56:17 -0700196bool EffectBase::suspended() const
Eric Laurent41709552019-12-16 19:34:05 -0800197{
198 Mutex::Autolock _l(mLock);
199 return mSuspended;
200}
201
Andy Hung6ac17eb2023-06-20 18:56:17 -0700202status_t EffectBase::addHandle(IAfEffectHandle *handle)
Eric Laurentca7cc822012-11-19 14:55:58 -0800203{
204 status_t status;
205
206 Mutex::Autolock _l(mLock);
207 int priority = handle->priority();
208 size_t size = mHandles.size();
Andy Hung6ac17eb2023-06-20 18:56:17 -0700209 IAfEffectHandle *controlHandle = nullptr;
Eric Laurentca7cc822012-11-19 14:55:58 -0800210 size_t i;
211 for (i = 0; i < size; i++) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700212 IAfEffectHandle *h = mHandles[i];
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800213 if (h == NULL || h->disconnected()) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800214 continue;
215 }
216 // first non destroyed handle is considered in control
Glenn Kasten6e2ebe92013-08-13 09:14:51 -0700217 if (controlHandle == NULL) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800218 controlHandle = h;
Glenn Kasten6e2ebe92013-08-13 09:14:51 -0700219 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800220 if (h->priority() <= priority) {
221 break;
222 }
223 }
224 // if inserted in first place, move effect control from previous owner to this handle
225 if (i == 0) {
226 bool enabled = false;
227 if (controlHandle != NULL) {
228 enabled = controlHandle->enabled();
229 controlHandle->setControl(false/*hasControl*/, true /*signal*/, enabled /*enabled*/);
230 }
231 handle->setControl(true /*hasControl*/, false /*signal*/, enabled /*enabled*/);
232 status = NO_ERROR;
233 } else {
234 status = ALREADY_EXISTS;
235 }
Glenn Kastenc42e9b42016-03-21 11:35:03 -0700236 ALOGV("addHandle() %p added handle %p in position %zu", this, handle, i);
Eric Laurentca7cc822012-11-19 14:55:58 -0800237 mHandles.insertAt(handle, i);
238 return status;
239}
240
Andy Hung6ac17eb2023-06-20 18:56:17 -0700241status_t EffectBase::updatePolicyState()
Eric Laurent6c796322019-04-09 14:13:17 -0700242{
243 status_t status = NO_ERROR;
244 bool doRegister = false;
245 bool registered = false;
246 bool doEnable = false;
247 bool enabled = false;
Mikhail Naganov379d6872020-03-26 13:04:11 -0700248 audio_io_handle_t io = AUDIO_IO_HANDLE_NONE;
Ytai Ben-Tsvi0a4904a2021-01-06 12:57:05 -0800249 product_strategy_t strategy = PRODUCT_STRATEGY_NONE;
Eric Laurent6c796322019-04-09 14:13:17 -0700250
251 {
252 Mutex::Autolock _l(mLock);
Eric Laurentd66d7a12021-07-13 13:35:32 +0200253
254 if ((isInternal_l() && !mPolicyRegistered)
255 || !getCallback()->isAudioPolicyReady()) {
256 return NO_ERROR;
257 }
258
Eric Laurent6c796322019-04-09 14:13:17 -0700259 // register effect when first handle is attached and unregister when last handle is removed
260 if (mPolicyRegistered != mHandles.size() > 0) {
261 doRegister = true;
262 mPolicyRegistered = mHandles.size() > 0;
263 if (mPolicyRegistered) {
Andy Hungfda44002021-06-03 17:23:16 -0700264 const auto callback = getCallback();
265 io = callback->io();
266 strategy = callback->strategy();
Eric Laurent6c796322019-04-09 14:13:17 -0700267 }
268 }
269 // enable effect when registered according to enable state requested by controlling handle
270 if (mHandles.size() > 0) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700271 IAfEffectHandle *handle = controlHandle_l();
Eric Laurent6c796322019-04-09 14:13:17 -0700272 if (handle != nullptr && mPolicyEnabled != handle->enabled()) {
273 doEnable = true;
274 mPolicyEnabled = handle->enabled();
275 }
276 }
277 registered = mPolicyRegistered;
278 enabled = mPolicyEnabled;
Eric Laurentb9d06642021-03-18 15:52:11 +0100279 // The simultaneous release of two EffectHandles with the same EffectModule
280 // may cause us to call this method at the same time.
281 // This may deadlock under some circumstances (b/180941720). Avoid this.
282 if (!doRegister && !(registered && doEnable)) {
283 return NO_ERROR;
284 }
Eric Laurent6c796322019-04-09 14:13:17 -0700285 }
fengjnlan46407562022-09-07 16:20:01 +0800286 mPolicyLock.lock();
Eric Laurent6c796322019-04-09 14:13:17 -0700287 ALOGV("%s name %s id %d session %d doRegister %d registered %d doEnable %d enabled %d",
288 __func__, mDescriptor.name, mId, mSessionId, doRegister, registered, doEnable, enabled);
289 if (doRegister) {
290 if (registered) {
291 status = AudioSystem::registerEffect(
292 &mDescriptor,
293 io,
294 strategy,
295 mSessionId,
296 mId);
297 } else {
298 status = AudioSystem::unregisterEffect(mId);
299 }
300 }
301 if (registered && doEnable) {
302 status = AudioSystem::setEffectEnabled(mId, enabled);
303 }
304 mPolicyLock.unlock();
305
306 return status;
307}
308
309
Andy Hung6ac17eb2023-06-20 18:56:17 -0700310ssize_t EffectBase::removeHandle(IAfEffectHandle *handle)
Eric Laurentca7cc822012-11-19 14:55:58 -0800311{
312 Mutex::Autolock _l(mLock);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800313 return removeHandle_l(handle);
314}
315
Andy Hung6ac17eb2023-06-20 18:56:17 -0700316ssize_t EffectBase::removeHandle_l(IAfEffectHandle *handle)
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800317{
Eric Laurentca7cc822012-11-19 14:55:58 -0800318 size_t size = mHandles.size();
319 size_t i;
320 for (i = 0; i < size; i++) {
321 if (mHandles[i] == handle) {
322 break;
323 }
324 }
325 if (i == size) {
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800326 ALOGW("%s %p handle not found %p", __FUNCTION__, this, handle);
327 return BAD_VALUE;
Eric Laurentca7cc822012-11-19 14:55:58 -0800328 }
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800329 ALOGV("removeHandle_l() %p removed handle %p in position %zu", this, handle, i);
Eric Laurentca7cc822012-11-19 14:55:58 -0800330
331 mHandles.removeAt(i);
332 // if removed from first place, move effect control from this handle to next in line
333 if (i == 0) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700334 IAfEffectHandle *h = controlHandle_l();
Eric Laurentca7cc822012-11-19 14:55:58 -0800335 if (h != NULL) {
336 h->setControl(true /*hasControl*/, true /*signal*/ , handle->enabled() /*enabled*/);
337 }
338 }
339
Jaideep Sharmaed8688022020-08-07 14:09:16 +0530340 // Prevent calls to process() and other functions on effect interface from now on.
341 // The effect engine will be released by the destructor when the last strong reference on
342 // this object is released which can happen after next process is called.
Eric Laurentca7cc822012-11-19 14:55:58 -0800343 if (mHandles.size() == 0 && !mPinned) {
344 mState = DESTROYED;
345 }
346
347 return mHandles.size();
348}
349
350// must be called with EffectModule::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -0700351IAfEffectHandle *EffectBase::controlHandle_l()
Eric Laurentca7cc822012-11-19 14:55:58 -0800352{
353 // the first valid handle in the list has control over the module
354 for (size_t i = 0; i < mHandles.size(); i++) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700355 IAfEffectHandle *h = mHandles[i];
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800356 if (h != NULL && !h->disconnected()) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800357 return h;
358 }
359 }
360
361 return NULL;
362}
363
Eric Laurentf10c7092016-12-06 17:09:56 -0800364// unsafe method called when the effect parent thread has been destroyed
Andy Hung6ac17eb2023-06-20 18:56:17 -0700365ssize_t EffectBase::disconnectHandle(IAfEffectHandle *handle, bool unpinIfLast)
Eric Laurentf10c7092016-12-06 17:09:56 -0800366{
Andy Hungfda44002021-06-03 17:23:16 -0700367 const auto callback = getCallback();
Eric Laurentf10c7092016-12-06 17:09:56 -0800368 ALOGV("disconnect() %p handle %p", this, handle);
Andy Hungfda44002021-06-03 17:23:16 -0700369 if (callback->disconnectEffectHandle(handle, unpinIfLast)) {
Eric Laurent6b446ce2019-12-13 10:56:31 -0800370 return mHandles.size();
371 }
372
Eric Laurentf10c7092016-12-06 17:09:56 -0800373 Mutex::Autolock _l(mLock);
374 ssize_t numHandles = removeHandle_l(handle);
375 if ((numHandles == 0) && (!mPinned || unpinIfLast)) {
Eric Laurent6b446ce2019-12-13 10:56:31 -0800376 mLock.unlock();
Andy Hungfda44002021-06-03 17:23:16 -0700377 callback->updateOrphanEffectChains(this);
Eric Laurent6b446ce2019-12-13 10:56:31 -0800378 mLock.lock();
Eric Laurentf10c7092016-12-06 17:09:56 -0800379 }
380 return numHandles;
381}
382
Andy Hung6ac17eb2023-06-20 18:56:17 -0700383bool EffectBase::purgeHandles()
Eric Laurent41709552019-12-16 19:34:05 -0800384{
385 bool enabled = false;
386 Mutex::Autolock _l(mLock);
Andy Hung6ac17eb2023-06-20 18:56:17 -0700387 IAfEffectHandle *handle = controlHandle_l();
Eric Laurent41709552019-12-16 19:34:05 -0800388 if (handle != NULL) {
389 enabled = handle->enabled();
390 }
391 mHandles.clear();
392 return enabled;
393}
394
Andy Hung6ac17eb2023-06-20 18:56:17 -0700395void EffectBase::checkSuspendOnEffectEnabled(bool enabled, bool threadLocked) {
Andy Hungfda44002021-06-03 17:23:16 -0700396 getCallback()->checkSuspendOnEffectEnabled(this, enabled, threadLocked);
Eric Laurent41709552019-12-16 19:34:05 -0800397}
398
399static String8 effectFlagsToString(uint32_t flags) {
400 String8 s;
401
402 s.append("conn. mode: ");
403 switch (flags & EFFECT_FLAG_TYPE_MASK) {
404 case EFFECT_FLAG_TYPE_INSERT: s.append("insert"); break;
405 case EFFECT_FLAG_TYPE_AUXILIARY: s.append("auxiliary"); break;
406 case EFFECT_FLAG_TYPE_REPLACE: s.append("replace"); break;
407 case EFFECT_FLAG_TYPE_PRE_PROC: s.append("preproc"); break;
408 case EFFECT_FLAG_TYPE_POST_PROC: s.append("postproc"); break;
409 default: s.append("unknown/reserved"); break;
410 }
411 s.append(", ");
412
413 s.append("insert pref: ");
414 switch (flags & EFFECT_FLAG_INSERT_MASK) {
415 case EFFECT_FLAG_INSERT_ANY: s.append("any"); break;
416 case EFFECT_FLAG_INSERT_FIRST: s.append("first"); break;
417 case EFFECT_FLAG_INSERT_LAST: s.append("last"); break;
418 case EFFECT_FLAG_INSERT_EXCLUSIVE: s.append("exclusive"); break;
419 default: s.append("unknown/reserved"); break;
420 }
421 s.append(", ");
422
423 s.append("volume mgmt: ");
424 switch (flags & EFFECT_FLAG_VOLUME_MASK) {
425 case EFFECT_FLAG_VOLUME_NONE: s.append("none"); break;
426 case EFFECT_FLAG_VOLUME_CTRL: s.append("implements control"); break;
427 case EFFECT_FLAG_VOLUME_IND: s.append("requires indication"); break;
428 case EFFECT_FLAG_VOLUME_MONITOR: s.append("monitors volume"); break;
429 default: s.append("unknown/reserved"); break;
430 }
431 s.append(", ");
432
433 uint32_t devind = flags & EFFECT_FLAG_DEVICE_MASK;
434 if (devind) {
435 s.append("device indication: ");
436 switch (devind) {
437 case EFFECT_FLAG_DEVICE_IND: s.append("requires updates"); break;
438 default: s.append("unknown/reserved"); break;
439 }
440 s.append(", ");
441 }
442
443 s.append("input mode: ");
444 switch (flags & EFFECT_FLAG_INPUT_MASK) {
445 case EFFECT_FLAG_INPUT_DIRECT: s.append("direct"); break;
446 case EFFECT_FLAG_INPUT_PROVIDER: s.append("provider"); break;
447 case EFFECT_FLAG_INPUT_BOTH: s.append("direct+provider"); break;
448 default: s.append("not set"); break;
449 }
450 s.append(", ");
451
452 s.append("output mode: ");
453 switch (flags & EFFECT_FLAG_OUTPUT_MASK) {
454 case EFFECT_FLAG_OUTPUT_DIRECT: s.append("direct"); break;
455 case EFFECT_FLAG_OUTPUT_PROVIDER: s.append("provider"); break;
456 case EFFECT_FLAG_OUTPUT_BOTH: s.append("direct+provider"); break;
457 default: s.append("not set"); break;
458 }
459 s.append(", ");
460
461 uint32_t accel = flags & EFFECT_FLAG_HW_ACC_MASK;
462 if (accel) {
463 s.append("hardware acceleration: ");
464 switch (accel) {
465 case EFFECT_FLAG_HW_ACC_SIMPLE: s.append("non-tunneled"); break;
466 case EFFECT_FLAG_HW_ACC_TUNNEL: s.append("tunneled"); break;
467 default: s.append("unknown/reserved"); break;
468 }
469 s.append(", ");
470 }
471
472 uint32_t modeind = flags & EFFECT_FLAG_AUDIO_MODE_MASK;
473 if (modeind) {
474 s.append("mode indication: ");
475 switch (modeind) {
476 case EFFECT_FLAG_AUDIO_MODE_IND: s.append("required"); break;
477 default: s.append("unknown/reserved"); break;
478 }
479 s.append(", ");
480 }
481
482 uint32_t srcind = flags & EFFECT_FLAG_AUDIO_SOURCE_MASK;
483 if (srcind) {
484 s.append("source indication: ");
485 switch (srcind) {
486 case EFFECT_FLAG_AUDIO_SOURCE_IND: s.append("required"); break;
487 default: s.append("unknown/reserved"); break;
488 }
489 s.append(", ");
490 }
491
492 if (flags & EFFECT_FLAG_OFFLOAD_MASK) {
493 s.append("offloadable, ");
494 }
495
496 int len = s.length();
497 if (s.length() > 2) {
498 (void) s.lockBuffer(len);
499 s.unlockBuffer(len - 2);
500 }
501 return s;
502}
503
Andy Hung6ac17eb2023-06-20 18:56:17 -0700504void EffectBase::dump(int fd, const Vector<String16>& args __unused) const
Andy Hung920f6572022-10-06 12:09:49 -0700505NO_THREAD_SAFETY_ANALYSIS // conditional try lock
Eric Laurent41709552019-12-16 19:34:05 -0800506{
507 String8 result;
508
509 result.appendFormat("\tEffect ID %d:\n", mId);
510
Andy Hung0a51b5c2023-07-18 20:54:44 -0700511 const bool locked = afutils::dumpTryLock(mLock);
Eric Laurent41709552019-12-16 19:34:05 -0800512 // failed to lock - AudioFlinger is probably deadlocked
513 if (!locked) {
514 result.append("\t\tCould not lock Fx mutex:\n");
515 }
François Gaffie163ce832023-06-28 11:36:35 +0200516 bool isInternal = isInternal_l();
517 result.append("\t\tSession State Registered Internal Enabled Suspended:\n");
518 result.appendFormat("\t\t%05d %03d %s %s %s %s\n",
519 mSessionId, mState, mPolicyRegistered ? "y" : "n", isInternal ? "y" : "n",
520 ((isInternal && isEnabled()) || (!isInternal && mPolicyEnabled)) ? "y" : "n",
521 mSuspended ? "y" : "n");
Eric Laurent41709552019-12-16 19:34:05 -0800522
523 result.append("\t\tDescriptor:\n");
524 char uuidStr[64];
525 AudioEffect::guidToString(&mDescriptor.uuid, uuidStr, sizeof(uuidStr));
526 result.appendFormat("\t\t- UUID: %s\n", uuidStr);
527 AudioEffect::guidToString(&mDescriptor.type, uuidStr, sizeof(uuidStr));
528 result.appendFormat("\t\t- TYPE: %s\n", uuidStr);
529 result.appendFormat("\t\t- apiVersion: %08X\n\t\t- flags: %08X (%s)\n",
530 mDescriptor.apiVersion,
531 mDescriptor.flags,
532 effectFlagsToString(mDescriptor.flags).string());
533 result.appendFormat("\t\t- name: %s\n",
534 mDescriptor.name);
535
536 result.appendFormat("\t\t- implementor: %s\n",
537 mDescriptor.implementor);
538
539 result.appendFormat("\t\t%zu Clients:\n", mHandles.size());
540 result.append("\t\t\t Pid Priority Ctrl Locked client server\n");
541 char buffer[256];
542 for (size_t i = 0; i < mHandles.size(); ++i) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700543 IAfEffectHandle *handle = mHandles[i];
Eric Laurent41709552019-12-16 19:34:05 -0800544 if (handle != NULL && !handle->disconnected()) {
545 handle->dumpToBuffer(buffer, sizeof(buffer));
546 result.append(buffer);
547 }
548 }
549 if (locked) {
550 mLock.unlock();
551 }
552
553 write(fd, result.string(), result.length());
554}
555
556// ----------------------------------------------------------------------------
557// EffectModule implementation
558// ----------------------------------------------------------------------------
559
560#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -0700561#define LOG_TAG "EffectModule"
Eric Laurent41709552019-12-16 19:34:05 -0800562
Andy Hung6ac17eb2023-06-20 18:56:17 -0700563EffectModule::EffectModule(const sp<EffectCallbackInterface>& callback,
Eric Laurent41709552019-12-16 19:34:05 -0800564 effect_descriptor_t *desc,
565 int id,
566 audio_session_t sessionId,
Eric Laurentb82e6b72019-11-22 17:25:04 -0800567 bool pinned,
568 audio_port_handle_t deviceId)
Eric Laurent41709552019-12-16 19:34:05 -0800569 : EffectBase(callback, desc, id, sessionId, pinned),
570 // clear mConfig to ensure consistent initial value of buffer framecount
571 // in case buffers are associated by setInBuffer() or setOutBuffer()
572 // prior to configure().
573 mConfig{{}, {}},
574 mStatus(NO_INIT),
575 mMaxDisableWaitCnt(1), // set by configure(), should be >= 1
576 mDisableWaitCnt(0), // set by process() and updateState()
David Li6c8ac4b2021-06-22 22:17:52 +0800577 mOffloaded(false),
Mikhail Naganov8d7da002022-04-19 21:21:23 +0000578 mIsOutput(false)
Eric Laurent41709552019-12-16 19:34:05 -0800579 , mSupportsFloat(false)
Eric Laurent41709552019-12-16 19:34:05 -0800580{
581 ALOGV("Constructor %p pinned %d", this, pinned);
582 int lStatus;
583
584 // create effect engine from effect factory
585 mStatus = callback->createEffectHal(
Eric Laurentb82e6b72019-11-22 17:25:04 -0800586 &desc->uuid, sessionId, deviceId, &mEffectInterface);
Eric Laurent41709552019-12-16 19:34:05 -0800587 if (mStatus != NO_ERROR) {
588 return;
589 }
590 lStatus = init();
591 if (lStatus < 0) {
592 mStatus = lStatus;
593 goto Error;
594 }
595
596 setOffloaded(callback->isOffload(), callback->io());
597 ALOGV("Constructor success name %s, Interface %p", mDescriptor.name, mEffectInterface.get());
598
599 return;
600Error:
601 mEffectInterface.clear();
602 ALOGV("Constructor Error %d", mStatus);
603}
604
Andy Hung6ac17eb2023-06-20 18:56:17 -0700605EffectModule::~EffectModule()
Eric Laurent41709552019-12-16 19:34:05 -0800606{
607 ALOGV("Destructor %p", this);
608 if (mEffectInterface != 0) {
609 char uuidStr[64];
610 AudioEffect::guidToString(&mDescriptor.uuid, uuidStr, sizeof(uuidStr));
611 ALOGW("EffectModule %p destructor called with unreleased interface, effect %s",
612 this, uuidStr);
613 release_l();
614 }
615
616}
617
Andy Hung6ac17eb2023-06-20 18:56:17 -0700618bool EffectModule::updateState() {
Eric Laurentca7cc822012-11-19 14:55:58 -0800619 Mutex::Autolock _l(mLock);
620
Eric Laurentfa1e1232016-08-02 19:01:49 -0700621 bool started = false;
Eric Laurentca7cc822012-11-19 14:55:58 -0800622 switch (mState) {
623 case RESTART:
624 reset_l();
Chih-Hung Hsieh2b487032018-09-13 14:16:02 -0700625 FALLTHROUGH_INTENDED;
Eric Laurentca7cc822012-11-19 14:55:58 -0800626
627 case STARTING:
628 // clear auxiliary effect input buffer for next accumulation
629 if ((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY) {
630 memset(mConfig.inputCfg.buffer.raw,
631 0,
632 mConfig.inputCfg.buffer.frameCount*sizeof(int32_t));
633 }
Eric Laurentd0ebb532013-04-02 16:41:41 -0700634 if (start_l() == NO_ERROR) {
635 mState = ACTIVE;
Eric Laurentfa1e1232016-08-02 19:01:49 -0700636 started = true;
Eric Laurentd0ebb532013-04-02 16:41:41 -0700637 } else {
638 mState = IDLE;
639 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800640 break;
641 case STOPPING:
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +0900642 // volume control for offload and direct threads must take effect immediately.
643 if (stop_l() == NO_ERROR
644 && !(isVolumeControl() && isOffloadedOrDirect())) {
Eric Laurentd0ebb532013-04-02 16:41:41 -0700645 mDisableWaitCnt = mMaxDisableWaitCnt;
646 } else {
647 mDisableWaitCnt = 1; // will cause immediate transition to IDLE
648 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800649 mState = STOPPED;
650 break;
651 case STOPPED:
652 // mDisableWaitCnt is forced to 1 by process() when the engine indicates the end of the
653 // turn off sequence.
654 if (--mDisableWaitCnt == 0) {
655 reset_l();
656 mState = IDLE;
657 }
658 break;
Eric Laurentde8caf42021-08-11 17:19:25 +0200659 case ACTIVE:
660 for (size_t i = 0; i < mHandles.size(); i++) {
661 if (!mHandles[i]->disconnected()) {
662 mHandles[i]->framesProcessed(mConfig.inputCfg.buffer.frameCount);
663 }
664 }
665 break;
Eric Laurentca7cc822012-11-19 14:55:58 -0800666 default: //IDLE , ACTIVE, DESTROYED
667 break;
668 }
Eric Laurentfa1e1232016-08-02 19:01:49 -0700669
670 return started;
Eric Laurentca7cc822012-11-19 14:55:58 -0800671}
672
Andy Hung6ac17eb2023-06-20 18:56:17 -0700673void EffectModule::process()
Eric Laurentca7cc822012-11-19 14:55:58 -0800674{
675 Mutex::Autolock _l(mLock);
676
Mikhail Naganov022b9952017-01-04 16:36:51 -0800677 if (mState == DESTROYED || mEffectInterface == 0 || mInBuffer == 0 || mOutBuffer == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800678 return;
679 }
680
rago94a1ee82017-07-21 15:11:02 -0700681 const uint32_t inChannelCount =
682 audio_channel_count_from_out_mask(mConfig.inputCfg.channels);
683 const uint32_t outChannelCount =
684 audio_channel_count_from_out_mask(mConfig.outputCfg.channels);
685 const bool auxType =
686 (mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY;
687
Andy Hungfa69ca32017-11-30 10:07:53 -0800688 // safeInputOutputSampleCount is 0 if the channel count between input and output
689 // buffers do not match. This prevents automatic accumulation or copying between the
690 // input and output effect buffers without an intermediary effect process.
691 // TODO: consider implementing channel conversion.
692 const size_t safeInputOutputSampleCount =
Andy Hungdd2e7a82018-10-31 14:19:13 -0700693 mInChannelCountRequested != mOutChannelCountRequested ? 0
694 : mOutChannelCountRequested * std::min(
Andy Hungfa69ca32017-11-30 10:07:53 -0800695 mConfig.inputCfg.buffer.frameCount,
696 mConfig.outputCfg.buffer.frameCount);
697 const auto accumulateInputToOutput = [this, safeInputOutputSampleCount]() {
Andy Hungfa69ca32017-11-30 10:07:53 -0800698 accumulate_float(
699 mConfig.outputCfg.buffer.f32,
700 mConfig.inputCfg.buffer.f32,
701 safeInputOutputSampleCount);
Andy Hungfa69ca32017-11-30 10:07:53 -0800702 };
703 const auto copyInputToOutput = [this, safeInputOutputSampleCount]() {
Andy Hungfa69ca32017-11-30 10:07:53 -0800704 memcpy(
705 mConfig.outputCfg.buffer.f32,
706 mConfig.inputCfg.buffer.f32,
707 safeInputOutputSampleCount * sizeof(*mConfig.outputCfg.buffer.f32));
Andy Hungfa69ca32017-11-30 10:07:53 -0800708 };
709
Eric Laurentca7cc822012-11-19 14:55:58 -0800710 if (isProcessEnabled()) {
Eric Laurent6dd0fd92016-09-15 12:44:53 -0700711 int ret;
712 if (isProcessImplemented()) {
rago94a1ee82017-07-21 15:11:02 -0700713 if (auxType) {
714 // We overwrite the aux input buffer here and clear after processing.
Andy Hung9aad48c2017-11-29 10:29:19 -0800715 // aux input is always mono.
rago94a1ee82017-07-21 15:11:02 -0700716
Andy Hung26836922023-05-22 17:31:57 -0700717 if (!mSupportsFloat) {
Andy Hung116a4982017-11-30 10:15:08 -0800718 memcpy_to_i16_from_float(
719 mConfig.inputCfg.buffer.s16,
720 mConfig.inputCfg.buffer.f32,
721 mConfig.inputCfg.buffer.frameCount);
rago94a1ee82017-07-21 15:11:02 -0700722 }
rago94a1ee82017-07-21 15:11:02 -0700723 }
Andy Hung9aad48c2017-11-29 10:29:19 -0800724 sp<EffectBufferHalInterface> inBuffer = mInBuffer;
725 sp<EffectBufferHalInterface> outBuffer = mOutBuffer;
726
727 if (!auxType && mInChannelCountRequested != inChannelCount) {
728 adjust_channels(
729 inBuffer->audioBuffer()->f32, mInChannelCountRequested,
730 mInConversionBuffer->audioBuffer()->f32, inChannelCount,
731 sizeof(float),
732 sizeof(float)
733 * mInChannelCountRequested * mConfig.inputCfg.buffer.frameCount);
734 inBuffer = mInConversionBuffer;
735 }
736 if (mConfig.outputCfg.accessMode == EFFECT_BUFFER_ACCESS_ACCUMULATE
737 && mOutChannelCountRequested != outChannelCount) {
738 adjust_selected_channels(
739 outBuffer->audioBuffer()->f32, mOutChannelCountRequested,
740 mOutConversionBuffer->audioBuffer()->f32, outChannelCount,
741 sizeof(float),
742 sizeof(float)
743 * mOutChannelCountRequested * mConfig.outputCfg.buffer.frameCount);
744 outBuffer = mOutConversionBuffer;
745 }
Andy Hungfa69ca32017-11-30 10:07:53 -0800746 if (!mSupportsFloat) { // convert input to int16_t as effect doesn't support float.
747 if (!auxType) {
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -0800748 if (mInConversionBuffer == nullptr) {
Andy Hungfa69ca32017-11-30 10:07:53 -0800749 ALOGW("%s: mInConversionBuffer is null, bypassing", __func__);
750 goto data_bypass;
rago94a1ee82017-07-21 15:11:02 -0700751 }
Andy Hungfa69ca32017-11-30 10:07:53 -0800752 memcpy_to_i16_from_float(
753 mInConversionBuffer->audioBuffer()->s16,
Andy Hung9aad48c2017-11-29 10:29:19 -0800754 inBuffer->audioBuffer()->f32,
Andy Hungfa69ca32017-11-30 10:07:53 -0800755 inChannelCount * mConfig.inputCfg.buffer.frameCount);
Andy Hung9aad48c2017-11-29 10:29:19 -0800756 inBuffer = mInConversionBuffer;
rago94a1ee82017-07-21 15:11:02 -0700757 }
Andy Hungfa69ca32017-11-30 10:07:53 -0800758 if (mConfig.outputCfg.accessMode == EFFECT_BUFFER_ACCESS_ACCUMULATE) {
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -0800759 if (mOutConversionBuffer == nullptr) {
Andy Hungfa69ca32017-11-30 10:07:53 -0800760 ALOGW("%s: mOutConversionBuffer is null, bypassing", __func__);
761 goto data_bypass;
762 }
763 memcpy_to_i16_from_float(
764 mOutConversionBuffer->audioBuffer()->s16,
Andy Hung9aad48c2017-11-29 10:29:19 -0800765 outBuffer->audioBuffer()->f32,
Andy Hungfa69ca32017-11-30 10:07:53 -0800766 outChannelCount * mConfig.outputCfg.buffer.frameCount);
Andy Hung9aad48c2017-11-29 10:29:19 -0800767 outBuffer = mOutConversionBuffer;
rago94a1ee82017-07-21 15:11:02 -0700768 }
769 }
Mikhail Naganov022b9952017-01-04 16:36:51 -0800770 ret = mEffectInterface->process();
Andy Hungfa69ca32017-11-30 10:07:53 -0800771 if (!mSupportsFloat) { // convert output int16_t back to float.
Andy Hung9aad48c2017-11-29 10:29:19 -0800772 sp<EffectBufferHalInterface> target =
773 mOutChannelCountRequested != outChannelCount
774 ? mOutConversionBuffer : mOutBuffer;
775
Andy Hungfa69ca32017-11-30 10:07:53 -0800776 memcpy_to_float_from_i16(
Andy Hung9aad48c2017-11-29 10:29:19 -0800777 target->audioBuffer()->f32,
Andy Hungfa69ca32017-11-30 10:07:53 -0800778 mOutConversionBuffer->audioBuffer()->s16,
779 outChannelCount * mConfig.outputCfg.buffer.frameCount);
780 }
Andy Hung9aad48c2017-11-29 10:29:19 -0800781 if (mOutChannelCountRequested != outChannelCount) {
782 adjust_selected_channels(mOutConversionBuffer->audioBuffer()->f32, outChannelCount,
783 mOutBuffer->audioBuffer()->f32, mOutChannelCountRequested,
784 sizeof(float),
785 sizeof(float) * outChannelCount * mConfig.outputCfg.buffer.frameCount);
786 }
Eric Laurent6dd0fd92016-09-15 12:44:53 -0700787 } else {
rago94a1ee82017-07-21 15:11:02 -0700788 data_bypass:
rago94a1ee82017-07-21 15:11:02 -0700789 if (!auxType /* aux effects do not require data bypass */
Andy Hungfa69ca32017-11-30 10:07:53 -0800790 && mConfig.inputCfg.buffer.raw != mConfig.outputCfg.buffer.raw) {
Eric Laurent6dd0fd92016-09-15 12:44:53 -0700791 if (mConfig.outputCfg.accessMode == EFFECT_BUFFER_ACCESS_ACCUMULATE) {
Andy Hungfa69ca32017-11-30 10:07:53 -0800792 accumulateInputToOutput();
Eric Laurent6dd0fd92016-09-15 12:44:53 -0700793 } else {
Andy Hungfa69ca32017-11-30 10:07:53 -0800794 copyInputToOutput();
Eric Laurent6dd0fd92016-09-15 12:44:53 -0700795 }
796 }
797 ret = -ENODATA;
798 }
Andy Hungfa69ca32017-11-30 10:07:53 -0800799
Eric Laurentca7cc822012-11-19 14:55:58 -0800800 // force transition to IDLE state when engine is ready
801 if (mState == STOPPED && ret == -ENODATA) {
802 mDisableWaitCnt = 1;
803 }
804
805 // clear auxiliary effect input buffer for next accumulation
rago94a1ee82017-07-21 15:11:02 -0700806 if (auxType) {
Andy Hung116a4982017-11-30 10:15:08 -0800807 const size_t size =
808 mConfig.inputCfg.buffer.frameCount * inChannelCount * sizeof(float);
rago94a1ee82017-07-21 15:11:02 -0700809 memset(mConfig.inputCfg.buffer.raw, 0, size);
Eric Laurentca7cc822012-11-19 14:55:58 -0800810 }
811 } else if ((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_INSERT &&
rago94a1ee82017-07-21 15:11:02 -0700812 // mInBuffer->audioBuffer()->raw != mOutBuffer->audioBuffer()->raw
Eric Laurentca7cc822012-11-19 14:55:58 -0800813 mConfig.inputCfg.buffer.raw != mConfig.outputCfg.buffer.raw) {
814 // If an insert effect is idle and input buffer is different from output buffer,
815 // accumulate input onto output
Andy Hungfda44002021-06-03 17:23:16 -0700816 if (getCallback()->activeTrackCnt() != 0) {
Andy Hunge8ac1b22018-10-31 14:22:35 -0700817 // similar handling with data_bypass above.
818 if (mConfig.outputCfg.accessMode == EFFECT_BUFFER_ACCESS_ACCUMULATE) {
819 accumulateInputToOutput();
820 } else { // EFFECT_BUFFER_ACCESS_WRITE
821 copyInputToOutput();
822 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800823 }
824 }
825}
826
Andy Hung6ac17eb2023-06-20 18:56:17 -0700827void EffectModule::reset_l()
Eric Laurentca7cc822012-11-19 14:55:58 -0800828{
Mikhail Naganov1dc98672016-08-18 17:50:29 -0700829 if (mStatus != NO_ERROR || mEffectInterface == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800830 return;
831 }
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -0700832 mEffectInterface->command(EFFECT_CMD_RESET, 0, NULL, 0, NULL);
Eric Laurentca7cc822012-11-19 14:55:58 -0800833}
834
Andy Hung6ac17eb2023-06-20 18:56:17 -0700835status_t EffectModule::configure()
Eric Laurentca7cc822012-11-19 14:55:58 -0800836{
rago94a1ee82017-07-21 15:11:02 -0700837 ALOGVV("configure() started");
Eric Laurentd0ebb532013-04-02 16:41:41 -0700838 status_t status;
Eric Laurentd0ebb532013-04-02 16:41:41 -0700839 uint32_t size;
840 audio_channel_mask_t channelMask;
Andy Hungfda44002021-06-03 17:23:16 -0700841 sp<EffectCallbackInterface> callback;
Eric Laurentd0ebb532013-04-02 16:41:41 -0700842
Mikhail Naganov1dc98672016-08-18 17:50:29 -0700843 if (mEffectInterface == 0) {
Eric Laurentd0ebb532013-04-02 16:41:41 -0700844 status = NO_INIT;
845 goto exit;
Eric Laurentca7cc822012-11-19 14:55:58 -0800846 }
847
Eric Laurentca7cc822012-11-19 14:55:58 -0800848 // TODO: handle configuration of effects replacing track process
Andy Hung9aad48c2017-11-29 10:29:19 -0800849 // TODO: handle configuration of input (record) SW effects above the HAL,
850 // similar to output EFFECT_FLAG_TYPE_INSERT/REPLACE,
851 // in which case input channel masks should be used here.
Andy Hungfda44002021-06-03 17:23:16 -0700852 callback = getCallback();
Eric Laurentf1f22e72021-07-13 14:04:14 +0200853 channelMask = callback->inChannelMask(mId);
Andy Hung9aad48c2017-11-29 10:29:19 -0800854 mConfig.inputCfg.channels = channelMask;
Eric Laurentf1f22e72021-07-13 14:04:14 +0200855 mConfig.outputCfg.channels = callback->outChannelMask();
Eric Laurentca7cc822012-11-19 14:55:58 -0800856
857 if ((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY) {
Andy Hung9aad48c2017-11-29 10:29:19 -0800858 if (mConfig.inputCfg.channels != AUDIO_CHANNEL_OUT_MONO) {
859 mConfig.inputCfg.channels = AUDIO_CHANNEL_OUT_MONO;
860 ALOGV("Overriding auxiliary effect input channels %#x as MONO",
861 mConfig.inputCfg.channels);
862 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800863 }
jiabineb3bda02020-06-30 14:07:03 -0700864 if (isHapticGenerator()) {
Andy Hungfda44002021-06-03 17:23:16 -0700865 audio_channel_mask_t hapticChannelMask = callback->hapticChannelMask();
jiabineb3bda02020-06-30 14:07:03 -0700866 mConfig.inputCfg.channels |= hapticChannelMask;
867 mConfig.outputCfg.channels |= hapticChannelMask;
868 }
Andy Hung9aad48c2017-11-29 10:29:19 -0800869 mInChannelCountRequested =
870 audio_channel_count_from_out_mask(mConfig.inputCfg.channels);
871 mOutChannelCountRequested =
872 audio_channel_count_from_out_mask(mConfig.outputCfg.channels);
Ricardo Garciad11da702015-05-28 12:14:12 -0700873
Andy Hung319587b2023-05-23 14:01:03 -0700874 mConfig.inputCfg.format = AUDIO_FORMAT_PCM_FLOAT;
875 mConfig.outputCfg.format = AUDIO_FORMAT_PCM_FLOAT;
Yuuki Yokoyamae17f8312017-05-26 19:06:33 +0900876
877 // Don't use sample rate for thread if effect isn't offloadable.
Andy Hungfda44002021-06-03 17:23:16 -0700878 if (callback->isOffloadOrDirect() && !isOffloaded()) {
Yuuki Yokoyamae17f8312017-05-26 19:06:33 +0900879 mConfig.inputCfg.samplingRate = DEFAULT_OUTPUT_SAMPLE_RATE;
880 ALOGV("Overriding effect input as 48kHz");
881 } else {
Andy Hungfda44002021-06-03 17:23:16 -0700882 mConfig.inputCfg.samplingRate = callback->sampleRate();
Yuuki Yokoyamae17f8312017-05-26 19:06:33 +0900883 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800884 mConfig.outputCfg.samplingRate = mConfig.inputCfg.samplingRate;
885 mConfig.inputCfg.bufferProvider.cookie = NULL;
886 mConfig.inputCfg.bufferProvider.getBuffer = NULL;
887 mConfig.inputCfg.bufferProvider.releaseBuffer = NULL;
888 mConfig.outputCfg.bufferProvider.cookie = NULL;
889 mConfig.outputCfg.bufferProvider.getBuffer = NULL;
890 mConfig.outputCfg.bufferProvider.releaseBuffer = NULL;
891 mConfig.inputCfg.accessMode = EFFECT_BUFFER_ACCESS_READ;
892 // Insert effect:
Eric Laurent3f75a5b2019-11-12 15:55:51 -0800893 // - in global sessions (e.g AUDIO_SESSION_OUTPUT_MIX),
Eric Laurentca7cc822012-11-19 14:55:58 -0800894 // always overwrites output buffer: input buffer == output buffer
895 // - in other sessions:
896 // last effect in the chain accumulates in output buffer: input buffer != output buffer
897 // other effect: overwrites output buffer: input buffer == output buffer
898 // Auxiliary effect:
899 // accumulates in output buffer: input buffer != output buffer
900 // Therefore: accumulate <=> input buffer != output buffer
Andy Hung799c8d02021-10-28 17:05:40 -0700901 mConfig.outputCfg.accessMode = requiredEffectBufferAccessMode();
Eric Laurentca7cc822012-11-19 14:55:58 -0800902 mConfig.inputCfg.mask = EFFECT_CONFIG_ALL;
903 mConfig.outputCfg.mask = EFFECT_CONFIG_ALL;
Andy Hungfda44002021-06-03 17:23:16 -0700904 mConfig.inputCfg.buffer.frameCount = callback->frameCount();
Eric Laurentca7cc822012-11-19 14:55:58 -0800905 mConfig.outputCfg.buffer.frameCount = mConfig.inputCfg.buffer.frameCount;
Mikhail Naganov8d7da002022-04-19 21:21:23 +0000906 mIsOutput = callback->isOutput();
Eric Laurentca7cc822012-11-19 14:55:58 -0800907
Eric Laurent6b446ce2019-12-13 10:56:31 -0800908 ALOGV("configure() %p chain %p buffer %p framecount %zu",
Andy Hungfda44002021-06-03 17:23:16 -0700909 this, callback->chain().promote().get(),
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -0800910 mConfig.inputCfg.buffer.raw, mConfig.inputCfg.buffer.frameCount);
Eric Laurentca7cc822012-11-19 14:55:58 -0800911
912 status_t cmdStatus;
Eric Laurentd0ebb532013-04-02 16:41:41 -0700913 size = sizeof(int);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -0700914 status = mEffectInterface->command(EFFECT_CMD_SET_CONFIG,
Andy Hung9aad48c2017-11-29 10:29:19 -0800915 sizeof(mConfig),
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -0700916 &mConfig,
917 &size,
918 &cmdStatus);
rago94a1ee82017-07-21 15:11:02 -0700919 if (status == NO_ERROR) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800920 status = cmdStatus;
921 }
Andy Hung9aad48c2017-11-29 10:29:19 -0800922
Andy Hung9aad48c2017-11-29 10:29:19 -0800923 if (status != NO_ERROR &&
Andy Hungba8e52b2023-05-11 14:33:03 -0700924 EffectConfiguration::isHidl() && // only HIDL effects support channel conversion
Mikhail Naganov8d7da002022-04-19 21:21:23 +0000925 mIsOutput &&
Andy Hung9aad48c2017-11-29 10:29:19 -0800926 (mConfig.inputCfg.channels != AUDIO_CHANNEL_OUT_STEREO
927 || mConfig.outputCfg.channels != AUDIO_CHANNEL_OUT_STEREO)) {
928 // Older effects may require exact STEREO position mask.
Andy Hung01b32722018-05-18 13:52:02 -0700929 if (mConfig.inputCfg.channels != AUDIO_CHANNEL_OUT_STEREO
930 && (mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) != EFFECT_FLAG_TYPE_AUXILIARY) {
Andy Hung9aad48c2017-11-29 10:29:19 -0800931 ALOGV("Overriding effect input channels %#x as STEREO", mConfig.inputCfg.channels);
932 mConfig.inputCfg.channels = AUDIO_CHANNEL_OUT_STEREO;
933 }
934 if (mConfig.outputCfg.channels != AUDIO_CHANNEL_OUT_STEREO) {
935 ALOGV("Overriding effect output channels %#x as STEREO", mConfig.outputCfg.channels);
936 mConfig.outputCfg.channels = AUDIO_CHANNEL_OUT_STEREO;
937 }
938 size = sizeof(int);
rago94a1ee82017-07-21 15:11:02 -0700939 status = mEffectInterface->command(EFFECT_CMD_SET_CONFIG,
Andy Hung9aad48c2017-11-29 10:29:19 -0800940 sizeof(mConfig),
rago94a1ee82017-07-21 15:11:02 -0700941 &mConfig,
942 &size,
943 &cmdStatus);
944 if (status == NO_ERROR) {
945 status = cmdStatus;
Andy Hung9aad48c2017-11-29 10:29:19 -0800946 }
947 }
Andy Hung9aad48c2017-11-29 10:29:19 -0800948
Andy Hung9aad48c2017-11-29 10:29:19 -0800949 if (status == NO_ERROR) {
950 mSupportsFloat = true;
951 }
952
Andy Hungba8e52b2023-05-11 14:33:03 -0700953 // only HIDL effects support integer conversion.
954 if (status != NO_ERROR && EffectConfiguration::isHidl()) {
Andy Hung9aad48c2017-11-29 10:29:19 -0800955 ALOGV("EFFECT_CMD_SET_CONFIG failed with float format, retry with int16_t.");
956 mConfig.inputCfg.format = AUDIO_FORMAT_PCM_16_BIT;
957 mConfig.outputCfg.format = AUDIO_FORMAT_PCM_16_BIT;
958 size = sizeof(int);
959 status = mEffectInterface->command(EFFECT_CMD_SET_CONFIG,
960 sizeof(mConfig),
961 &mConfig,
962 &size,
963 &cmdStatus);
964 if (status == NO_ERROR) {
965 status = cmdStatus;
966 }
967 if (status == NO_ERROR) {
rago94a1ee82017-07-21 15:11:02 -0700968 mSupportsFloat = false;
969 ALOGVV("config worked with 16 bit");
970 } else {
971 ALOGE("%s failed %d with int16_t (as well as float)", __func__, status);
Eric Laurentca7cc822012-11-19 14:55:58 -0800972 }
rago94a1ee82017-07-21 15:11:02 -0700973 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800974
rago94a1ee82017-07-21 15:11:02 -0700975 if (status == NO_ERROR) {
976 // Establish Buffer strategy
977 setInBuffer(mInBuffer);
978 setOutBuffer(mOutBuffer);
979
980 // Update visualizer latency
981 if (memcmp(&mDescriptor.type, SL_IID_VISUALIZATION, sizeof(effect_uuid_t)) == 0) {
982 uint32_t buf32[sizeof(effect_param_t) / sizeof(uint32_t) + 2];
983 effect_param_t *p = (effect_param_t *)buf32;
984
985 p->psize = sizeof(uint32_t);
986 p->vsize = sizeof(uint32_t);
987 size = sizeof(int);
988 *(int32_t *)p->data = VISUALIZER_PARAM_LATENCY;
989
Andy Hungfda44002021-06-03 17:23:16 -0700990 uint32_t latency = callback->latency();
rago94a1ee82017-07-21 15:11:02 -0700991
992 *((int32_t *)p->data + 1)= latency;
993 mEffectInterface->command(EFFECT_CMD_SET_PARAM,
994 sizeof(effect_param_t) + 8,
995 &buf32,
996 &size,
997 &cmdStatus);
998 }
jiabin4e246532022-08-23 16:37:30 -0700999
1000 if (isVolumeControl()) {
1001 // Force initializing the volume as 0 for volume control effect for safer ramping
1002 uint32_t left = 0;
1003 uint32_t right = 0;
1004 setVolumeInternal(&left, &right, true /*controller*/);
1005 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001006 }
1007
Andy Hung05083ac2017-12-14 15:00:28 -08001008 // mConfig.outputCfg.buffer.frameCount cannot be zero.
1009 mMaxDisableWaitCnt = (uint32_t)std::max(
1010 (uint64_t)1, // mMaxDisableWaitCnt must be greater than zero.
François Gaffieb8551f62023-02-15 11:36:35 +01001011 (uint64_t)mConfig.outputCfg.buffer.frameCount == 0 ? 1
1012 : (MAX_DISABLE_TIME_MS * mConfig.outputCfg.samplingRate
1013 / ((uint64_t)1000 * mConfig.outputCfg.buffer.frameCount)));
Eric Laurentca7cc822012-11-19 14:55:58 -08001014
Eric Laurentd0ebb532013-04-02 16:41:41 -07001015exit:
Andy Hung6f88dc42017-12-13 16:19:39 -08001016 // TODO: consider clearing mConfig on error.
Eric Laurentd0ebb532013-04-02 16:41:41 -07001017 mStatus = status;
rago94a1ee82017-07-21 15:11:02 -07001018 ALOGVV("configure ended");
Eric Laurentca7cc822012-11-19 14:55:58 -08001019 return status;
1020}
1021
Andy Hung6ac17eb2023-06-20 18:56:17 -07001022status_t EffectModule::init()
Eric Laurentca7cc822012-11-19 14:55:58 -08001023{
1024 Mutex::Autolock _l(mLock);
Mikhail Naganov1dc98672016-08-18 17:50:29 -07001025 if (mEffectInterface == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001026 return NO_INIT;
1027 }
1028 status_t cmdStatus;
1029 uint32_t size = sizeof(status_t);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001030 status_t status = mEffectInterface->command(EFFECT_CMD_INIT,
1031 0,
1032 NULL,
1033 &size,
1034 &cmdStatus);
Eric Laurentca7cc822012-11-19 14:55:58 -08001035 if (status == 0) {
1036 status = cmdStatus;
1037 }
1038 return status;
1039}
1040
Andy Hung6ac17eb2023-06-20 18:56:17 -07001041void EffectModule::addEffectToHal_l()
Eric Laurent1b928682014-10-02 19:41:47 -07001042{
1043 if ((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_PRE_PROC ||
1044 (mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_POST_PROC) {
Eric Laurent9f57aa82023-03-17 19:28:37 +01001045 if (mCurrentHalStream == getCallback()->io()) {
David Li6c8ac4b2021-06-22 22:17:52 +08001046 return;
1047 }
1048
Andy Hungfda44002021-06-03 17:23:16 -07001049 (void)getCallback()->addEffectToHal(mEffectInterface);
Eric Laurent9f57aa82023-03-17 19:28:37 +01001050 mCurrentHalStream = getCallback()->io();
Eric Laurent1b928682014-10-02 19:41:47 -07001051 }
1052}
1053
Eric Laurentfa1e1232016-08-02 19:01:49 -07001054// start() must be called with PlaybackThread::mLock or EffectChain::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -07001055status_t EffectModule::start()
Eric Laurentca7cc822012-11-19 14:55:58 -08001056{
Eric Laurentfa1e1232016-08-02 19:01:49 -07001057 status_t status;
1058 {
1059 Mutex::Autolock _l(mLock);
1060 status = start_l();
Eric Laurentfa1e1232016-08-02 19:01:49 -07001061 }
Eric Laurent6b446ce2019-12-13 10:56:31 -08001062 if (status == NO_ERROR) {
Andy Hungfda44002021-06-03 17:23:16 -07001063 getCallback()->resetVolume();
Eric Laurentfa1e1232016-08-02 19:01:49 -07001064 }
1065 return status;
Eric Laurentca7cc822012-11-19 14:55:58 -08001066}
1067
Andy Hung6ac17eb2023-06-20 18:56:17 -07001068status_t EffectModule::start_l()
Eric Laurentca7cc822012-11-19 14:55:58 -08001069{
Mikhail Naganov1dc98672016-08-18 17:50:29 -07001070 if (mEffectInterface == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001071 return NO_INIT;
1072 }
Eric Laurentd0ebb532013-04-02 16:41:41 -07001073 if (mStatus != NO_ERROR) {
1074 return mStatus;
1075 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001076 status_t cmdStatus;
1077 uint32_t size = sizeof(status_t);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001078 status_t status = mEffectInterface->command(EFFECT_CMD_ENABLE,
1079 0,
1080 NULL,
1081 &size,
1082 &cmdStatus);
Eric Laurentca7cc822012-11-19 14:55:58 -08001083 if (status == 0) {
1084 status = cmdStatus;
1085 }
Eric Laurentcb4b6e92014-10-01 14:26:10 -07001086 if (status == 0) {
Eric Laurent1b928682014-10-02 19:41:47 -07001087 addEffectToHal_l();
Eric Laurentca7cc822012-11-19 14:55:58 -08001088 }
1089 return status;
1090}
1091
Andy Hung6ac17eb2023-06-20 18:56:17 -07001092status_t EffectModule::stop()
Eric Laurentca7cc822012-11-19 14:55:58 -08001093{
1094 Mutex::Autolock _l(mLock);
1095 return stop_l();
1096}
1097
Andy Hung6ac17eb2023-06-20 18:56:17 -07001098status_t EffectModule::stop_l()
Eric Laurentca7cc822012-11-19 14:55:58 -08001099{
Mikhail Naganov1dc98672016-08-18 17:50:29 -07001100 if (mEffectInterface == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001101 return NO_INIT;
1102 }
Eric Laurentd0ebb532013-04-02 16:41:41 -07001103 if (mStatus != NO_ERROR) {
1104 return mStatus;
1105 }
Eric Laurentbfb1b832013-01-07 09:53:42 -08001106 status_t cmdStatus = NO_ERROR;
Eric Laurentca7cc822012-11-19 14:55:58 -08001107 uint32_t size = sizeof(status_t);
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001108
1109 if (isVolumeControl() && isOffloadedOrDirect()) {
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001110 // We have the EffectChain and EffectModule lock, permit a reentrant call to setVolume:
1111 // resetVolume_l --> setVolume_l --> EffectModule::setVolume
1112 mSetVolumeReentrantTid = gettid();
Andy Hungfda44002021-06-03 17:23:16 -07001113 getCallback()->resetVolume();
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001114 mSetVolumeReentrantTid = INVALID_PID;
1115 }
1116
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001117 status_t status = mEffectInterface->command(EFFECT_CMD_DISABLE,
1118 0,
1119 NULL,
1120 &size,
1121 &cmdStatus);
Eric Laurentbfb1b832013-01-07 09:53:42 -08001122 if (status == NO_ERROR) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001123 status = cmdStatus;
1124 }
Eric Laurentbfb1b832013-01-07 09:53:42 -08001125 if (status == NO_ERROR) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08001126 status = removeEffectFromHal_l();
Eric Laurentbfb1b832013-01-07 09:53:42 -08001127 }
1128 return status;
1129}
1130
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001131// must be called with EffectChain::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -07001132void EffectModule::release_l()
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001133{
1134 if (mEffectInterface != 0) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08001135 removeEffectFromHal_l();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001136 // release effect engine
Mikhail Naganov022b9952017-01-04 16:36:51 -08001137 mEffectInterface->close();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001138 mEffectInterface.clear();
1139 }
1140}
1141
Andy Hung6ac17eb2023-06-20 18:56:17 -07001142status_t EffectModule::removeEffectFromHal_l()
Eric Laurentbfb1b832013-01-07 09:53:42 -08001143{
1144 if ((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_PRE_PROC ||
1145 (mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_POST_PROC) {
Eric Laurent9f57aa82023-03-17 19:28:37 +01001146 if (mCurrentHalStream != getCallback()->io()) {
1147 return (mCurrentHalStream == AUDIO_IO_HANDLE_NONE) ? NO_ERROR : INVALID_OPERATION;
David Li6c8ac4b2021-06-22 22:17:52 +08001148 }
Andy Hungfda44002021-06-03 17:23:16 -07001149 getCallback()->removeEffectFromHal(mEffectInterface);
Eric Laurent9f57aa82023-03-17 19:28:37 +01001150 mCurrentHalStream = AUDIO_IO_HANDLE_NONE;
Eric Laurentca7cc822012-11-19 14:55:58 -08001151 }
Eric Laurentbfb1b832013-01-07 09:53:42 -08001152 return NO_ERROR;
Eric Laurentca7cc822012-11-19 14:55:58 -08001153}
1154
Andy Hunge4a1d912016-08-17 14:11:13 -07001155// round up delta valid if value and divisor are positive.
1156template <typename T>
1157static T roundUpDelta(const T &value, const T &divisor) {
1158 T remainder = value % divisor;
1159 return remainder == 0 ? 0 : divisor - remainder;
1160}
1161
Andy Hung6ac17eb2023-06-20 18:56:17 -07001162status_t EffectModule::command(int32_t cmdCode,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001163 const std::vector<uint8_t>& cmdData,
1164 int32_t maxReplySize,
1165 std::vector<uint8_t>* reply)
Eric Laurentca7cc822012-11-19 14:55:58 -08001166{
1167 Mutex::Autolock _l(mLock);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001168 ALOGVV("command(), cmdCode: %d, mEffectInterface: %p", cmdCode, mEffectInterface.get());
Eric Laurentca7cc822012-11-19 14:55:58 -08001169
Mikhail Naganov1dc98672016-08-18 17:50:29 -07001170 if (mState == DESTROYED || mEffectInterface == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001171 return NO_INIT;
1172 }
Eric Laurentd0ebb532013-04-02 16:41:41 -07001173 if (mStatus != NO_ERROR) {
1174 return mStatus;
1175 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001176 if (maxReplySize < 0 || maxReplySize > EFFECT_PARAM_SIZE_MAX) {
1177 return -EINVAL;
1178 }
1179 size_t cmdSize = cmdData.size();
1180 const effect_param_t* param = cmdSize >= sizeof(effect_param_t)
1181 ? reinterpret_cast<const effect_param_t*>(cmdData.data())
1182 : nullptr;
Andy Hung110bc952016-06-20 15:22:52 -07001183 if (cmdCode == EFFECT_CMD_GET_PARAM &&
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001184 (param == nullptr || param->psize > cmdSize - sizeof(effect_param_t))) {
Andy Hung6660f122016-11-04 19:40:53 -07001185 android_errorWriteLog(0x534e4554, "32438594");
Andy Hungb3456642016-11-28 13:50:21 -08001186 android_errorWriteLog(0x534e4554, "33003822");
1187 return -EINVAL;
1188 }
1189 if (cmdCode == EFFECT_CMD_GET_PARAM &&
Andy Hung920f6572022-10-06 12:09:49 -07001190 (maxReplySize < static_cast<signed>(sizeof(effect_param_t)) ||
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001191 param->psize > maxReplySize - sizeof(effect_param_t))) {
Andy Hungb3456642016-11-28 13:50:21 -08001192 android_errorWriteLog(0x534e4554, "29251553");
Andy Hung6660f122016-11-04 19:40:53 -07001193 return -EINVAL;
1194 }
ragoe2759072016-11-22 18:02:48 -08001195 if (cmdCode == EFFECT_CMD_GET_PARAM &&
Andy Hung920f6572022-10-06 12:09:49 -07001196 (static_cast<signed>(sizeof(effect_param_t)) > maxReplySize
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001197 || param->psize > maxReplySize - sizeof(effect_param_t)
1198 || param->vsize > maxReplySize - sizeof(effect_param_t)
1199 - param->psize
1200 || roundUpDelta(param->psize, (uint32_t) sizeof(int)) >
1201 maxReplySize
1202 - sizeof(effect_param_t)
1203 - param->psize
1204 - param->vsize)) {
ragoe2759072016-11-22 18:02:48 -08001205 ALOGV("\tLVM_ERROR : EFFECT_CMD_GET_PARAM: reply size inconsistent");
1206 android_errorWriteLog(0x534e4554, "32705438");
1207 return -EINVAL;
1208 }
Andy Hunge4a1d912016-08-17 14:11:13 -07001209 if ((cmdCode == EFFECT_CMD_SET_PARAM
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001210 || cmdCode == EFFECT_CMD_SET_PARAM_DEFERRED)
1211 && // DEFERRED not generally used
1212 (param == nullptr
1213 || param->psize > cmdSize - sizeof(effect_param_t)
1214 || param->vsize > cmdSize - sizeof(effect_param_t)
1215 - param->psize
1216 || roundUpDelta(param->psize,
1217 (uint32_t) sizeof(int)) >
1218 cmdSize
1219 - sizeof(effect_param_t)
1220 - param->psize
1221 - param->vsize)) {
Andy Hunge4a1d912016-08-17 14:11:13 -07001222 android_errorWriteLog(0x534e4554, "30204301");
1223 return -EINVAL;
1224 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001225 uint32_t replySize = maxReplySize;
1226 reply->resize(replySize);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001227 status_t status = mEffectInterface->command(cmdCode,
1228 cmdSize,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001229 const_cast<uint8_t*>(cmdData.data()),
1230 &replySize,
1231 reply->data());
1232 reply->resize(status == NO_ERROR ? replySize : 0);
Eric Laurentca7cc822012-11-19 14:55:58 -08001233 if (cmdCode != EFFECT_CMD_GET_PARAM && status == NO_ERROR) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001234 for (size_t i = 1; i < mHandles.size(); i++) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07001235 IAfEffectHandle *h = mHandles[i];
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001236 if (h != NULL && !h->disconnected()) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001237 h->commandExecuted(cmdCode, cmdData, *reply);
Eric Laurentca7cc822012-11-19 14:55:58 -08001238 }
1239 }
1240 }
1241 return status;
1242}
1243
Andy Hung6ac17eb2023-06-20 18:56:17 -07001244bool EffectModule::isProcessEnabled() const
Eric Laurentca7cc822012-11-19 14:55:58 -08001245{
Eric Laurentd0ebb532013-04-02 16:41:41 -07001246 if (mStatus != NO_ERROR) {
1247 return false;
1248 }
1249
Eric Laurentca7cc822012-11-19 14:55:58 -08001250 switch (mState) {
1251 case RESTART:
1252 case ACTIVE:
1253 case STOPPING:
1254 case STOPPED:
1255 return true;
1256 case IDLE:
1257 case STARTING:
1258 case DESTROYED:
1259 default:
1260 return false;
1261 }
1262}
1263
Andy Hung6ac17eb2023-06-20 18:56:17 -07001264bool EffectModule::isOffloadedOrDirect() const
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001265{
Andy Hungfda44002021-06-03 17:23:16 -07001266 return getCallback()->isOffloadOrDirect();
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001267}
1268
Andy Hung6ac17eb2023-06-20 18:56:17 -07001269bool EffectModule::isVolumeControlEnabled() const
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001270{
1271 return (isVolumeControl() && (isOffloadedOrDirect() ? isEnabled() : isProcessEnabled()));
1272}
1273
Andy Hung6ac17eb2023-06-20 18:56:17 -07001274void EffectModule::setInBuffer(const sp<EffectBufferHalInterface>& buffer) {
rago94a1ee82017-07-21 15:11:02 -07001275 ALOGVV("setInBuffer %p",(&buffer));
Andy Hung6f88dc42017-12-13 16:19:39 -08001276
1277 // mConfig.inputCfg.buffer.frameCount may be zero if configure() is not called yet.
Mikhail Naganov022b9952017-01-04 16:36:51 -08001278 if (buffer != 0) {
1279 mConfig.inputCfg.buffer.raw = buffer->audioBuffer()->raw;
1280 buffer->setFrameCount(mConfig.inputCfg.buffer.frameCount);
1281 } else {
1282 mConfig.inputCfg.buffer.raw = NULL;
1283 }
1284 mInBuffer = buffer;
Andy Hungc15aaee2017-11-27 17:02:40 -08001285 mEffectInterface->setInBuffer(buffer);
rago94a1ee82017-07-21 15:11:02 -07001286
Andy Hungbded9c82017-11-30 18:47:35 -08001287 // aux effects do in place conversion to float - we don't allocate mInConversionBuffer.
rago94a1ee82017-07-21 15:11:02 -07001288 // Theoretically insert effects can also do in-place conversions (destroying
1289 // the original buffer) when the output buffer is identical to the input buffer,
1290 // but we don't optimize for it here.
1291 const bool auxType = (mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY;
Andy Hung9aad48c2017-11-29 10:29:19 -08001292 const uint32_t inChannelCount =
1293 audio_channel_count_from_out_mask(mConfig.inputCfg.channels);
1294 const bool formatMismatch = !mSupportsFloat || mInChannelCountRequested != inChannelCount;
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001295 if (!auxType && formatMismatch && mInBuffer != nullptr) {
rago94a1ee82017-07-21 15:11:02 -07001296 // we need to translate - create hidl shared buffer and intercept
1297 const size_t inFrameCount = mConfig.inputCfg.buffer.frameCount;
Andy Hung9aad48c2017-11-29 10:29:19 -08001298 // Use FCC_2 in case mInChannelCountRequested is mono and the effect is stereo.
1299 const uint32_t inChannels = std::max((uint32_t)FCC_2, mInChannelCountRequested);
1300 const size_t size = inChannels * inFrameCount * std::max(sizeof(int16_t), sizeof(float));
rago94a1ee82017-07-21 15:11:02 -07001301
1302 ALOGV("%s: setInBuffer updating for inChannels:%d inFrameCount:%zu total size:%zu",
1303 __func__, inChannels, inFrameCount, size);
1304
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001305 if (size > 0 && (mInConversionBuffer == nullptr
Andy Hungbded9c82017-11-30 18:47:35 -08001306 || size > mInConversionBuffer->getSize())) {
1307 mInConversionBuffer.clear();
1308 ALOGV("%s: allocating mInConversionBuffer %zu", __func__, size);
Andy Hungfda44002021-06-03 17:23:16 -07001309 (void)getCallback()->allocateHalBuffer(size, &mInConversionBuffer);
rago94a1ee82017-07-21 15:11:02 -07001310 }
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001311 if (mInConversionBuffer != nullptr) {
Andy Hungbded9c82017-11-30 18:47:35 -08001312 mInConversionBuffer->setFrameCount(inFrameCount);
1313 mEffectInterface->setInBuffer(mInConversionBuffer);
rago94a1ee82017-07-21 15:11:02 -07001314 } else if (size > 0) {
Andy Hungbded9c82017-11-30 18:47:35 -08001315 ALOGE("%s cannot create mInConversionBuffer", __func__);
rago94a1ee82017-07-21 15:11:02 -07001316 }
1317 }
Mikhail Naganov022b9952017-01-04 16:36:51 -08001318}
1319
Andy Hung6ac17eb2023-06-20 18:56:17 -07001320void EffectModule::setOutBuffer(const sp<EffectBufferHalInterface>& buffer) {
rago94a1ee82017-07-21 15:11:02 -07001321 ALOGVV("setOutBuffer %p",(&buffer));
Andy Hung6f88dc42017-12-13 16:19:39 -08001322
1323 // mConfig.outputCfg.buffer.frameCount may be zero if configure() is not called yet.
Mikhail Naganov022b9952017-01-04 16:36:51 -08001324 if (buffer != 0) {
1325 mConfig.outputCfg.buffer.raw = buffer->audioBuffer()->raw;
1326 buffer->setFrameCount(mConfig.outputCfg.buffer.frameCount);
1327 } else {
1328 mConfig.outputCfg.buffer.raw = NULL;
1329 }
1330 mOutBuffer = buffer;
Andy Hungc15aaee2017-11-27 17:02:40 -08001331 mEffectInterface->setOutBuffer(buffer);
rago94a1ee82017-07-21 15:11:02 -07001332
Andy Hungbded9c82017-11-30 18:47:35 -08001333 // Note: Any effect that does not accumulate does not need mOutConversionBuffer and
rago94a1ee82017-07-21 15:11:02 -07001334 // can do in-place conversion from int16_t to float. We don't optimize here.
Andy Hung9aad48c2017-11-29 10:29:19 -08001335 const uint32_t outChannelCount =
1336 audio_channel_count_from_out_mask(mConfig.outputCfg.channels);
1337 const bool formatMismatch = !mSupportsFloat || mOutChannelCountRequested != outChannelCount;
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001338 if (formatMismatch && mOutBuffer != nullptr) {
rago94a1ee82017-07-21 15:11:02 -07001339 const size_t outFrameCount = mConfig.outputCfg.buffer.frameCount;
Andy Hung9aad48c2017-11-29 10:29:19 -08001340 // Use FCC_2 in case mOutChannelCountRequested is mono and the effect is stereo.
1341 const uint32_t outChannels = std::max((uint32_t)FCC_2, mOutChannelCountRequested);
1342 const size_t size = outChannels * outFrameCount * std::max(sizeof(int16_t), sizeof(float));
rago94a1ee82017-07-21 15:11:02 -07001343
1344 ALOGV("%s: setOutBuffer updating for outChannels:%d outFrameCount:%zu total size:%zu",
1345 __func__, outChannels, outFrameCount, size);
1346
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001347 if (size > 0 && (mOutConversionBuffer == nullptr
Andy Hungbded9c82017-11-30 18:47:35 -08001348 || size > mOutConversionBuffer->getSize())) {
1349 mOutConversionBuffer.clear();
1350 ALOGV("%s: allocating mOutConversionBuffer %zu", __func__, size);
Andy Hungfda44002021-06-03 17:23:16 -07001351 (void)getCallback()->allocateHalBuffer(size, &mOutConversionBuffer);
rago94a1ee82017-07-21 15:11:02 -07001352 }
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001353 if (mOutConversionBuffer != nullptr) {
Andy Hungbded9c82017-11-30 18:47:35 -08001354 mOutConversionBuffer->setFrameCount(outFrameCount);
1355 mEffectInterface->setOutBuffer(mOutConversionBuffer);
rago94a1ee82017-07-21 15:11:02 -07001356 } else if (size > 0) {
Andy Hungbded9c82017-11-30 18:47:35 -08001357 ALOGE("%s cannot create mOutConversionBuffer", __func__);
rago94a1ee82017-07-21 15:11:02 -07001358 }
1359 }
Mikhail Naganov022b9952017-01-04 16:36:51 -08001360}
1361
Andy Hung6ac17eb2023-06-20 18:56:17 -07001362status_t EffectModule::setVolume(uint32_t *left, uint32_t *right, bool controller)
Eric Laurentca7cc822012-11-19 14:55:58 -08001363{
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001364 AutoLockReentrant _l(mLock, mSetVolumeReentrantTid);
Eric Laurentd0ebb532013-04-02 16:41:41 -07001365 if (mStatus != NO_ERROR) {
1366 return mStatus;
1367 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001368 status_t status = NO_ERROR;
Eric Laurentca7cc822012-11-19 14:55:58 -08001369 // Send volume indication if EFFECT_FLAG_VOLUME_IND is set and read back altered volume
1370 // if controller flag is set (Note that controller == TRUE => EFFECT_FLAG_VOLUME_CTRL set)
1371 if (isProcessEnabled() &&
1372 ((mDescriptor.flags & EFFECT_FLAG_VOLUME_MASK) == EFFECT_FLAG_VOLUME_CTRL ||
Jasmine Cha934ecfb2019-01-23 18:19:14 +08001373 (mDescriptor.flags & EFFECT_FLAG_VOLUME_MASK) == EFFECT_FLAG_VOLUME_IND ||
1374 (mDescriptor.flags & EFFECT_FLAG_VOLUME_MASK) == EFFECT_FLAG_VOLUME_MONITOR)) {
jiabin4e246532022-08-23 16:37:30 -07001375 status = setVolumeInternal(left, right, controller);
1376 }
1377 return status;
1378}
1379
Andy Hung6ac17eb2023-06-20 18:56:17 -07001380status_t EffectModule::setVolumeInternal(
jiabin4e246532022-08-23 16:37:30 -07001381 uint32_t *left, uint32_t *right, bool controller) {
1382 uint32_t volume[2] = {*left, *right};
1383 uint32_t *pVolume = controller ? volume : nullptr;
1384 uint32_t size = sizeof(volume);
1385 status_t status = mEffectInterface->command(EFFECT_CMD_SET_VOLUME,
1386 size,
1387 volume,
1388 &size,
1389 pVolume);
1390 if (controller && status == NO_ERROR && size == sizeof(volume)) {
1391 *left = volume[0];
1392 *right = volume[1];
Eric Laurentca7cc822012-11-19 14:55:58 -08001393 }
1394 return status;
1395}
1396
Andy Hung6ac17eb2023-06-20 18:56:17 -07001397void EffectChain::setVolumeForOutput_l(uint32_t left, uint32_t right)
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001398{
Zhou Songd505c642020-02-20 16:35:37 +08001399 // for offload or direct thread, if the effect chain has non-offloadable
1400 // effect and any effect module within the chain has volume control, then
1401 // volume control is delegated to effect, otherwise, set volume to hal.
1402 if (mEffectCallback->isOffloadOrDirect() &&
1403 !(isNonOffloadableEnabled_l() && hasVolumeControlEnabled_l())) {
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001404 float vol_l = (float)left / (1 << 24);
1405 float vol_r = (float)right / (1 << 24);
Eric Laurent6b446ce2019-12-13 10:56:31 -08001406 mEffectCallback->setVolumeForOutput(vol_l, vol_r);
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001407 }
1408}
1409
Andy Hung6ac17eb2023-06-20 18:56:17 -07001410status_t EffectModule::sendSetAudioDevicesCommand(
jiabin8f278ee2019-11-11 12:16:27 -08001411 const AudioDeviceTypeAddrVector &devices, uint32_t cmdCode)
Eric Laurentca7cc822012-11-19 14:55:58 -08001412{
jiabin8f278ee2019-11-11 12:16:27 -08001413 audio_devices_t deviceType = deviceTypesToBitMask(getAudioDeviceTypes(devices));
1414 if (deviceType == AUDIO_DEVICE_NONE) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001415 return NO_ERROR;
1416 }
1417
1418 Mutex::Autolock _l(mLock);
Eric Laurentd0ebb532013-04-02 16:41:41 -07001419 if (mStatus != NO_ERROR) {
1420 return mStatus;
1421 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001422 status_t status = NO_ERROR;
Eric Laurent7e1139c2013-06-06 18:29:01 -07001423 if ((mDescriptor.flags & EFFECT_FLAG_DEVICE_MASK) == EFFECT_FLAG_DEVICE_IND) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001424 status_t cmdStatus;
1425 uint32_t size = sizeof(status_t);
jiabin8f278ee2019-11-11 12:16:27 -08001426 // FIXME: use audio device types and addresses when the hal interface is ready.
1427 status = mEffectInterface->command(cmdCode,
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001428 sizeof(uint32_t),
jiabin8f278ee2019-11-11 12:16:27 -08001429 &deviceType,
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001430 &size,
1431 &cmdStatus);
Eric Laurentca7cc822012-11-19 14:55:58 -08001432 }
1433 return status;
1434}
1435
Andy Hung6ac17eb2023-06-20 18:56:17 -07001436status_t EffectModule::setDevices(const AudioDeviceTypeAddrVector &devices)
jiabin8f278ee2019-11-11 12:16:27 -08001437{
1438 return sendSetAudioDevicesCommand(devices, EFFECT_CMD_SET_DEVICE);
1439}
1440
Andy Hung6ac17eb2023-06-20 18:56:17 -07001441status_t EffectModule::setInputDevice(const AudioDeviceTypeAddr &device)
jiabin8f278ee2019-11-11 12:16:27 -08001442{
1443 return sendSetAudioDevicesCommand({device}, EFFECT_CMD_SET_INPUT_DEVICE);
1444}
1445
Andy Hung6ac17eb2023-06-20 18:56:17 -07001446status_t EffectModule::setMode(audio_mode_t mode)
Eric Laurentca7cc822012-11-19 14:55:58 -08001447{
1448 Mutex::Autolock _l(mLock);
Eric Laurentd0ebb532013-04-02 16:41:41 -07001449 if (mStatus != NO_ERROR) {
1450 return mStatus;
1451 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001452 status_t status = NO_ERROR;
1453 if ((mDescriptor.flags & EFFECT_FLAG_AUDIO_MODE_MASK) == EFFECT_FLAG_AUDIO_MODE_IND) {
1454 status_t cmdStatus;
1455 uint32_t size = sizeof(status_t);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001456 status = mEffectInterface->command(EFFECT_CMD_SET_AUDIO_MODE,
1457 sizeof(audio_mode_t),
1458 &mode,
1459 &size,
1460 &cmdStatus);
Eric Laurentca7cc822012-11-19 14:55:58 -08001461 if (status == NO_ERROR) {
1462 status = cmdStatus;
1463 }
1464 }
1465 return status;
1466}
1467
Andy Hung6ac17eb2023-06-20 18:56:17 -07001468status_t EffectModule::setAudioSource(audio_source_t source)
Eric Laurentca7cc822012-11-19 14:55:58 -08001469{
1470 Mutex::Autolock _l(mLock);
Eric Laurentd0ebb532013-04-02 16:41:41 -07001471 if (mStatus != NO_ERROR) {
1472 return mStatus;
1473 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001474 status_t status = NO_ERROR;
1475 if ((mDescriptor.flags & EFFECT_FLAG_AUDIO_SOURCE_MASK) == EFFECT_FLAG_AUDIO_SOURCE_IND) {
1476 uint32_t size = 0;
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001477 status = mEffectInterface->command(EFFECT_CMD_SET_AUDIO_SOURCE,
1478 sizeof(audio_source_t),
1479 &source,
1480 &size,
1481 NULL);
Eric Laurentca7cc822012-11-19 14:55:58 -08001482 }
1483 return status;
1484}
1485
Andy Hung6ac17eb2023-06-20 18:56:17 -07001486status_t EffectModule::setOffloaded(bool offloaded, audio_io_handle_t io)
Eric Laurent5baf2af2013-09-12 17:37:00 -07001487{
1488 Mutex::Autolock _l(mLock);
1489 if (mStatus != NO_ERROR) {
1490 return mStatus;
1491 }
1492 status_t status = NO_ERROR;
1493 if ((mDescriptor.flags & EFFECT_FLAG_OFFLOAD_SUPPORTED) != 0) {
1494 status_t cmdStatus;
1495 uint32_t size = sizeof(status_t);
1496 effect_offload_param_t cmd;
1497
1498 cmd.isOffload = offloaded;
1499 cmd.ioHandle = io;
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001500 status = mEffectInterface->command(EFFECT_CMD_OFFLOAD,
1501 sizeof(effect_offload_param_t),
1502 &cmd,
1503 &size,
1504 &cmdStatus);
Eric Laurent5baf2af2013-09-12 17:37:00 -07001505 if (status == NO_ERROR) {
1506 status = cmdStatus;
1507 }
1508 mOffloaded = (status == NO_ERROR) ? offloaded : false;
1509 } else {
1510 if (offloaded) {
1511 status = INVALID_OPERATION;
1512 }
1513 mOffloaded = false;
1514 }
1515 ALOGV("setOffloaded() offloaded %d io %d status %d", offloaded, io, status);
1516 return status;
1517}
1518
Andy Hung6ac17eb2023-06-20 18:56:17 -07001519bool EffectModule::isOffloaded() const
Eric Laurent5baf2af2013-09-12 17:37:00 -07001520{
1521 Mutex::Autolock _l(mLock);
1522 return mOffloaded;
1523}
1524
jiabineb3bda02020-06-30 14:07:03 -07001525/*static*/
Andy Hung6ac17eb2023-06-20 18:56:17 -07001526bool IAfEffectModule::isHapticGenerator(const effect_uuid_t *type) {
jiabineb3bda02020-06-30 14:07:03 -07001527 return memcmp(type, FX_IID_HAPTICGENERATOR, sizeof(effect_uuid_t)) == 0;
1528}
1529
Andy Hung6ac17eb2023-06-20 18:56:17 -07001530bool EffectModule::isHapticGenerator() const {
1531 return IAfEffectModule::isHapticGenerator(&mDescriptor.type);
jiabineb3bda02020-06-30 14:07:03 -07001532}
1533
Andy Hung6ac17eb2023-06-20 18:56:17 -07001534status_t EffectModule::setHapticIntensity(int id, os::HapticScale intensity)
jiabine70bc7f2020-06-30 22:07:55 -07001535{
1536 if (mStatus != NO_ERROR) {
1537 return mStatus;
1538 }
1539 if (!isHapticGenerator()) {
1540 ALOGW("Should not set haptic intensity for effects that are not HapticGenerator");
1541 return INVALID_OPERATION;
1542 }
1543
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001544 std::vector<uint8_t> request(sizeof(effect_param_t) + 3 * sizeof(uint32_t));
1545 effect_param_t *param = (effect_param_t*) request.data();
jiabine70bc7f2020-06-30 22:07:55 -07001546 param->psize = sizeof(int32_t);
1547 param->vsize = sizeof(int32_t) * 2;
1548 *(int32_t*)param->data = HG_PARAM_HAPTIC_INTENSITY;
1549 *((int32_t*)param->data + 1) = id;
Simon Bowden62823412022-10-17 14:52:26 +00001550 *((int32_t*)param->data + 2) = static_cast<int32_t>(intensity);
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001551 std::vector<uint8_t> response;
1552 status_t status = command(EFFECT_CMD_SET_PARAM, request, sizeof(int32_t), &response);
jiabine70bc7f2020-06-30 22:07:55 -07001553 if (status == NO_ERROR) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001554 LOG_ALWAYS_FATAL_IF(response.size() != 4);
1555 status = *reinterpret_cast<const status_t*>(response.data());
jiabine70bc7f2020-06-30 22:07:55 -07001556 }
1557 return status;
1558}
1559
Andy Hung6ac17eb2023-06-20 18:56:17 -07001560status_t EffectModule::setVibratorInfo(const media::AudioVibratorInfo& vibratorInfo)
jiabin1319f5a2021-03-30 22:21:24 +00001561{
1562 if (mStatus != NO_ERROR) {
1563 return mStatus;
1564 }
1565 if (!isHapticGenerator()) {
1566 ALOGW("Should not set vibrator info for effects that are not HapticGenerator");
1567 return INVALID_OPERATION;
1568 }
1569
Lais Andradebc3f37a2021-07-02 00:13:19 +01001570 const size_t paramCount = 3;
jiabin1319f5a2021-03-30 22:21:24 +00001571 std::vector<uint8_t> request(
Lais Andradebc3f37a2021-07-02 00:13:19 +01001572 sizeof(effect_param_t) + sizeof(int32_t) + paramCount * sizeof(float));
jiabin1319f5a2021-03-30 22:21:24 +00001573 effect_param_t *param = (effect_param_t*) request.data();
1574 param->psize = sizeof(int32_t);
Lais Andradebc3f37a2021-07-02 00:13:19 +01001575 param->vsize = paramCount * sizeof(float);
jiabin1319f5a2021-03-30 22:21:24 +00001576 *(int32_t*)param->data = HG_PARAM_VIBRATOR_INFO;
1577 float* vibratorInfoPtr = reinterpret_cast<float*>(param->data + sizeof(int32_t));
Lais Andradebc3f37a2021-07-02 00:13:19 +01001578 vibratorInfoPtr[0] = vibratorInfo.resonantFrequency;
1579 vibratorInfoPtr[1] = vibratorInfo.qFactor;
1580 vibratorInfoPtr[2] = vibratorInfo.maxAmplitude;
jiabin1319f5a2021-03-30 22:21:24 +00001581 std::vector<uint8_t> response;
1582 status_t status = command(EFFECT_CMD_SET_PARAM, request, sizeof(int32_t), &response);
1583 if (status == NO_ERROR) {
1584 LOG_ALWAYS_FATAL_IF(response.size() != sizeof(status_t));
1585 status = *reinterpret_cast<const status_t*>(response.data());
1586 }
1587 return status;
1588}
1589
Andy Hung6ac17eb2023-06-20 18:56:17 -07001590status_t EffectModule::getConfigs(
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001591 audio_config_base_t* inputCfg, audio_config_base_t* outputCfg, bool* isOutput) const {
1592 Mutex::Autolock _l(mLock);
1593 if (mConfig.inputCfg.mask == 0 || mConfig.outputCfg.mask == 0) {
1594 return NO_INIT;
1595 }
1596 inputCfg->sample_rate = mConfig.inputCfg.samplingRate;
1597 inputCfg->channel_mask = static_cast<audio_channel_mask_t>(mConfig.inputCfg.channels);
1598 inputCfg->format = static_cast<audio_format_t>(mConfig.inputCfg.format);
1599 outputCfg->sample_rate = mConfig.outputCfg.samplingRate;
1600 outputCfg->channel_mask = static_cast<audio_channel_mask_t>(mConfig.outputCfg.channels);
1601 outputCfg->format = static_cast<audio_format_t>(mConfig.outputCfg.format);
1602 *isOutput = mIsOutput;
1603 return NO_ERROR;
1604}
1605
Andy Hungbded9c82017-11-30 18:47:35 -08001606static std::string dumpInOutBuffer(bool isInput, const sp<EffectBufferHalInterface> &buffer) {
1607 std::stringstream ss;
1608
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001609 if (buffer == nullptr) {
Andy Hungbded9c82017-11-30 18:47:35 -08001610 return "nullptr"; // make different than below
1611 } else if (buffer->externalData() != nullptr) {
1612 ss << (isInput ? buffer->externalData() : buffer->audioBuffer()->raw)
1613 << " -> "
1614 << (isInput ? buffer->audioBuffer()->raw : buffer->externalData());
1615 } else {
1616 ss << buffer->audioBuffer()->raw;
1617 }
1618 return ss.str();
1619}
Marco Nelissenb2208842014-02-07 14:00:50 -08001620
Andy Hung6ac17eb2023-06-20 18:56:17 -07001621void EffectModule::dump(int fd, const Vector<String16>& args) const
Andy Hung920f6572022-10-06 12:09:49 -07001622NO_THREAD_SAFETY_ANALYSIS // conditional try lock
Eric Laurentca7cc822012-11-19 14:55:58 -08001623{
Eric Laurent41709552019-12-16 19:34:05 -08001624 EffectBase::dump(fd, args);
1625
Eric Laurentca7cc822012-11-19 14:55:58 -08001626 String8 result;
Andy Hung0a51b5c2023-07-18 20:54:44 -07001627 const bool locked = afutils::dumpTryLock(mLock);
Eric Laurentca7cc822012-11-19 14:55:58 -08001628
Eric Laurent41709552019-12-16 19:34:05 -08001629 result.append("\t\tStatus Engine:\n");
1630 result.appendFormat("\t\t%03d %p\n",
1631 mStatus, mEffectInterface.get());
Andy Hung9718d662017-12-22 17:57:39 -08001632
1633 result.appendFormat("\t\t- data: %s\n", mSupportsFloat ? "float" : "int16");
Eric Laurentca7cc822012-11-19 14:55:58 -08001634
1635 result.append("\t\t- Input configuration:\n");
Andy Hung9718d662017-12-22 17:57:39 -08001636 result.append("\t\t\tBuffer Frames Smp rate Channels Format\n");
1637 result.appendFormat("\t\t\t%p %05zu %05d %08x %6d (%s)\n",
1638 mConfig.inputCfg.buffer.raw,
Eric Laurentca7cc822012-11-19 14:55:58 -08001639 mConfig.inputCfg.buffer.frameCount,
1640 mConfig.inputCfg.samplingRate,
1641 mConfig.inputCfg.channels,
Marco Nelissenb2208842014-02-07 14:00:50 -08001642 mConfig.inputCfg.format,
Andy Hung9718d662017-12-22 17:57:39 -08001643 formatToString((audio_format_t)mConfig.inputCfg.format).c_str());
Eric Laurentca7cc822012-11-19 14:55:58 -08001644
1645 result.append("\t\t- Output configuration:\n");
1646 result.append("\t\t\tBuffer Frames Smp rate Channels Format\n");
Andy Hung9718d662017-12-22 17:57:39 -08001647 result.appendFormat("\t\t\t%p %05zu %05d %08x %6d (%s)\n",
Kévin PETIT377b2ec2014-02-03 12:35:36 +00001648 mConfig.outputCfg.buffer.raw,
Eric Laurentca7cc822012-11-19 14:55:58 -08001649 mConfig.outputCfg.buffer.frameCount,
1650 mConfig.outputCfg.samplingRate,
1651 mConfig.outputCfg.channels,
Marco Nelissenb2208842014-02-07 14:00:50 -08001652 mConfig.outputCfg.format,
Mikhail Naganov913d06c2016-11-01 12:49:22 -07001653 formatToString((audio_format_t)mConfig.outputCfg.format).c_str());
Eric Laurentca7cc822012-11-19 14:55:58 -08001654
Andy Hungbded9c82017-11-30 18:47:35 -08001655 result.appendFormat("\t\t- HAL buffers:\n"
1656 "\t\t\tIn(%s) InConversion(%s) Out(%s) OutConversion(%s)\n",
1657 dumpInOutBuffer(true /* isInput */, mInBuffer).c_str(),
1658 dumpInOutBuffer(true /* isInput */, mInConversionBuffer).c_str(),
1659 dumpInOutBuffer(false /* isInput */, mOutBuffer).c_str(),
1660 dumpInOutBuffer(false /* isInput */, mOutConversionBuffer).c_str());
rago94a1ee82017-07-21 15:11:02 -07001661
Eric Laurentca7cc822012-11-19 14:55:58 -08001662 write(fd, result.string(), result.length());
1663
Mikhail Naganov4d547672019-02-22 14:19:19 -08001664 if (mEffectInterface != 0) {
1665 dprintf(fd, "\tEffect ID %d HAL dump:\n", mId);
1666 (void)mEffectInterface->dump(fd);
1667 }
1668
Eric Laurentca7cc822012-11-19 14:55:58 -08001669 if (locked) {
1670 mLock.unlock();
1671 }
1672}
1673
1674// ----------------------------------------------------------------------------
1675// EffectHandle implementation
1676// ----------------------------------------------------------------------------
1677
1678#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -07001679#define LOG_TAG "EffectHandle"
Eric Laurentca7cc822012-11-19 14:55:58 -08001680
Andy Hung6ac17eb2023-06-20 18:56:17 -07001681/* static */
1682sp<IAfEffectHandle> IAfEffectHandle::create(
1683 const sp<IAfEffectBase>& effect,
Andy Hung59867e42023-06-27 17:05:02 -07001684 const sp<Client>& client,
Andy Hung6ac17eb2023-06-20 18:56:17 -07001685 const sp<media::IEffectClient>& effectClient,
1686 int32_t priority, bool notifyFramesProcessed)
1687{
1688 return sp<EffectHandle>::make(
Andy Hung59867e42023-06-27 17:05:02 -07001689 effect, client, effectClient, priority, notifyFramesProcessed);
Andy Hung6ac17eb2023-06-20 18:56:17 -07001690}
1691
1692EffectHandle::EffectHandle(const sp<IAfEffectBase>& effect,
Andy Hung59867e42023-06-27 17:05:02 -07001693 const sp<Client>& client,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001694 const sp<media::IEffectClient>& effectClient,
Eric Laurentde8caf42021-08-11 17:19:25 +02001695 int32_t priority, bool notifyFramesProcessed)
Eric Laurentca7cc822012-11-19 14:55:58 -08001696 : BnEffect(),
1697 mEffect(effect), mEffectClient(effectClient), mClient(client), mCblk(NULL),
Eric Laurentde8caf42021-08-11 17:19:25 +02001698 mPriority(priority), mHasControl(false), mEnabled(false), mDisconnected(false),
1699 mNotifyFramesProcessed(notifyFramesProcessed)
Eric Laurentca7cc822012-11-19 14:55:58 -08001700{
Eric Laurentb82e6b72019-11-22 17:25:04 -08001701 ALOGV("constructor %p client %p", this, client.get());
Andy Hung225aef62022-12-06 16:33:20 -08001702 setMinSchedulerPolicy(SCHED_NORMAL, ANDROID_PRIORITY_AUDIO);
Eric Laurentca7cc822012-11-19 14:55:58 -08001703
1704 if (client == 0) {
1705 return;
1706 }
1707 int bufOffset = ((sizeof(effect_param_cblk_t) - 1) / sizeof(int) + 1) * sizeof(int);
Atneya3c61d882021-09-20 14:52:15 -04001708 mCblkMemory = client->allocator().allocate(mediautils::NamedAllocRequest{
1709 {static_cast<size_t>(EFFECT_PARAM_BUFFER_SIZE + bufOffset)},
1710 std::string("Effect ID: ")
1711 .append(std::to_string(effect->id()))
1712 .append(" Session ID: ")
1713 .append(std::to_string(static_cast<int>(effect->sessionId())))
1714 .append(" \n")
1715 });
Glenn Kastene75da402013-11-20 13:54:52 -08001716 if (mCblkMemory == 0 ||
Ytai Ben-Tsvi7dd39722019-09-05 15:14:30 -07001717 (mCblk = static_cast<effect_param_cblk_t *>(mCblkMemory->unsecurePointer())) == NULL) {
Glenn Kastenc42e9b42016-03-21 11:35:03 -07001718 ALOGE("not enough memory for Effect size=%zu", EFFECT_PARAM_BUFFER_SIZE +
Eric Laurentca7cc822012-11-19 14:55:58 -08001719 sizeof(effect_param_cblk_t));
Glenn Kastene75da402013-11-20 13:54:52 -08001720 mCblkMemory.clear();
Eric Laurentca7cc822012-11-19 14:55:58 -08001721 return;
1722 }
Glenn Kastene75da402013-11-20 13:54:52 -08001723 new(mCblk) effect_param_cblk_t();
1724 mBuffer = (uint8_t *)mCblk + bufOffset;
Eric Laurentca7cc822012-11-19 14:55:58 -08001725}
1726
Andy Hung6ac17eb2023-06-20 18:56:17 -07001727EffectHandle::~EffectHandle()
Eric Laurentca7cc822012-11-19 14:55:58 -08001728{
1729 ALOGV("Destructor %p", this);
Eric Laurentca7cc822012-11-19 14:55:58 -08001730 disconnect(false);
1731}
1732
Andy Hungc747c532022-03-07 21:41:14 -08001733// Creates an association between Binder code to name for IEffect.
1734#define IEFFECT_BINDER_METHOD_MACRO_LIST \
1735BINDER_METHOD_ENTRY(enable) \
1736BINDER_METHOD_ENTRY(disable) \
1737BINDER_METHOD_ENTRY(command) \
1738BINDER_METHOD_ENTRY(disconnect) \
1739BINDER_METHOD_ENTRY(getCblk) \
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001740BINDER_METHOD_ENTRY(getConfig) \
Andy Hungc747c532022-03-07 21:41:14 -08001741
1742// singleton for Binder Method Statistics for IEffect
1743mediautils::MethodStatistics<int>& getIEffectStatistics() {
1744 using Code = int;
1745
1746#pragma push_macro("BINDER_METHOD_ENTRY")
1747#undef BINDER_METHOD_ENTRY
1748#define BINDER_METHOD_ENTRY(ENTRY) \
1749 {(Code)media::BnEffect::TRANSACTION_##ENTRY, #ENTRY},
1750
1751 static mediautils::MethodStatistics<Code> methodStatistics{
1752 IEFFECT_BINDER_METHOD_MACRO_LIST
1753 METHOD_STATISTICS_BINDER_CODE_NAMES(Code)
1754 };
1755#pragma pop_macro("BINDER_METHOD_ENTRY")
1756
1757 return methodStatistics;
1758}
1759
Andy Hung6ac17eb2023-06-20 18:56:17 -07001760status_t EffectHandle::onTransact(
Andy Hungc747c532022-03-07 21:41:14 -08001761 uint32_t code, const Parcel& data, Parcel* reply, uint32_t flags) {
Andy Hunga2a1ac32022-03-18 16:12:11 -07001762 const std::string methodName = getIEffectStatistics().getMethodForCode(code);
1763 mediautils::TimeCheck check(
1764 std::string("IEffect::").append(methodName),
1765 [code](bool timeout, float elapsedMs) {
1766 if (timeout) {
1767 ; // we don't timeout right now on the effect interface.
1768 } else {
1769 getIEffectStatistics().event(code, elapsedMs);
1770 }
Andy Hungf8ab0932022-06-13 19:49:43 -07001771 }, {} /* timeoutDuration */, {} /* secondChanceDuration */, false /* crashOnTimeout */);
Andy Hungc747c532022-03-07 21:41:14 -08001772 return BnEffect::onTransact(code, data, reply, flags);
1773}
1774
Andy Hung6ac17eb2023-06-20 18:56:17 -07001775status_t EffectHandle::initCheck() const
Glenn Kastene75da402013-11-20 13:54:52 -08001776{
1777 return mClient == 0 || mCblkMemory != 0 ? OK : NO_MEMORY;
1778}
1779
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001780#define RETURN(code) \
1781 *_aidl_return = (code); \
1782 return Status::ok();
1783
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001784#define VALUE_OR_RETURN_STATUS_AS_OUT(exp) \
1785 ({ \
1786 auto _tmp = (exp); \
1787 if (!_tmp.ok()) { RETURN(_tmp.error()); } \
1788 std::move(_tmp.value()); \
1789 })
1790
Andy Hung6ac17eb2023-06-20 18:56:17 -07001791Status EffectHandle::enable(int32_t* _aidl_return)
Eric Laurentca7cc822012-11-19 14:55:58 -08001792{
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001793 AutoMutex _l(mLock);
Eric Laurentca7cc822012-11-19 14:55:58 -08001794 ALOGV("enable %p", this);
Andy Hung6ac17eb2023-06-20 18:56:17 -07001795 sp<IAfEffectBase> effect = mEffect.promote();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001796 if (effect == 0 || mDisconnected) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001797 RETURN(DEAD_OBJECT);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001798 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001799 if (!mHasControl) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001800 RETURN(INVALID_OPERATION);
Eric Laurentca7cc822012-11-19 14:55:58 -08001801 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001802
1803 if (mEnabled) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001804 RETURN(NO_ERROR);
Eric Laurentca7cc822012-11-19 14:55:58 -08001805 }
1806
1807 mEnabled = true;
1808
Eric Laurent6c796322019-04-09 14:13:17 -07001809 status_t status = effect->updatePolicyState();
1810 if (status != NO_ERROR) {
1811 mEnabled = false;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001812 RETURN(status);
Eric Laurent6c796322019-04-09 14:13:17 -07001813 }
1814
Eric Laurent6b446ce2019-12-13 10:56:31 -08001815 effect->checkSuspendOnEffectEnabled(true, false /*threadLocked*/);
Eric Laurentca7cc822012-11-19 14:55:58 -08001816
1817 // checkSuspendOnEffectEnabled() can suspend this same effect when enabled
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001818 if (effect->suspended()) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001819 RETURN(NO_ERROR);
Eric Laurentca7cc822012-11-19 14:55:58 -08001820 }
1821
Eric Laurent6b446ce2019-12-13 10:56:31 -08001822 status = effect->setEnabled(true, true /*fromHandle*/);
Eric Laurentca7cc822012-11-19 14:55:58 -08001823 if (status != NO_ERROR) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001824 mEnabled = false;
1825 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001826 RETURN(status);
Eric Laurentca7cc822012-11-19 14:55:58 -08001827}
1828
Andy Hung6ac17eb2023-06-20 18:56:17 -07001829Status EffectHandle::disable(int32_t* _aidl_return)
Eric Laurentca7cc822012-11-19 14:55:58 -08001830{
1831 ALOGV("disable %p", this);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001832 AutoMutex _l(mLock);
Andy Hung6ac17eb2023-06-20 18:56:17 -07001833 sp<IAfEffectBase> effect = mEffect.promote();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001834 if (effect == 0 || mDisconnected) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001835 RETURN(DEAD_OBJECT);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001836 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001837 if (!mHasControl) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001838 RETURN(INVALID_OPERATION);
Eric Laurentca7cc822012-11-19 14:55:58 -08001839 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001840
1841 if (!mEnabled) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001842 RETURN(NO_ERROR);
Eric Laurentca7cc822012-11-19 14:55:58 -08001843 }
1844 mEnabled = false;
1845
Eric Laurent6c796322019-04-09 14:13:17 -07001846 effect->updatePolicyState();
1847
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001848 if (effect->suspended()) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001849 RETURN(NO_ERROR);
Eric Laurentca7cc822012-11-19 14:55:58 -08001850 }
1851
Eric Laurent6b446ce2019-12-13 10:56:31 -08001852 status_t status = effect->setEnabled(false, true /*fromHandle*/);
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001853 RETURN(status);
Eric Laurentca7cc822012-11-19 14:55:58 -08001854}
1855
Andy Hung6ac17eb2023-06-20 18:56:17 -07001856Status EffectHandle::disconnect()
Eric Laurentca7cc822012-11-19 14:55:58 -08001857{
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001858 ALOGV("%s %p", __FUNCTION__, this);
Eric Laurentca7cc822012-11-19 14:55:58 -08001859 disconnect(true);
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001860 return Status::ok();
Eric Laurentca7cc822012-11-19 14:55:58 -08001861}
1862
Andy Hung6ac17eb2023-06-20 18:56:17 -07001863void EffectHandle::disconnect(bool unpinIfLast)
Eric Laurentca7cc822012-11-19 14:55:58 -08001864{
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001865 AutoMutex _l(mLock);
1866 ALOGV("disconnect(%s) %p", unpinIfLast ? "true" : "false", this);
1867 if (mDisconnected) {
1868 if (unpinIfLast) {
1869 android_errorWriteLog(0x534e4554, "32707507");
1870 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001871 return;
1872 }
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001873 mDisconnected = true;
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001874 {
Andy Hung6ac17eb2023-06-20 18:56:17 -07001875 sp<IAfEffectBase> effect = mEffect.promote();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001876 if (effect != 0) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08001877 if (effect->disconnectHandle(this, unpinIfLast) > 0) {
Eric Laurent6c796322019-04-09 14:13:17 -07001878 ALOGW("%s Effect handle %p disconnected after thread destruction",
1879 __func__, this);
1880 }
1881 effect->updatePolicyState();
Eric Laurentf10c7092016-12-06 17:09:56 -08001882 }
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001883 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001884
Eric Laurentca7cc822012-11-19 14:55:58 -08001885 if (mClient != 0) {
1886 if (mCblk != NULL) {
1887 // unlike ~TrackBase(), mCblk is never a local new, so don't delete
1888 mCblk->~effect_param_cblk_t(); // destroy our shared-structure.
1889 }
1890 mCblkMemory.clear(); // free the shared memory before releasing the heap it belongs to
Eric Laurent021cf962014-05-13 10:18:14 -07001891 // Client destructor must run with AudioFlinger client mutex locked
Andy Hung47c01172023-07-17 12:40:43 -07001892 Mutex::Autolock _l2(mClient->afClientCallback()->clientMutex());
Eric Laurentca7cc822012-11-19 14:55:58 -08001893 mClient.clear();
1894 }
1895}
1896
Andy Hung6ac17eb2023-06-20 18:56:17 -07001897Status EffectHandle::getCblk(media::SharedFileRegion* _aidl_return) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001898 LOG_ALWAYS_FATAL_IF(!convertIMemoryToSharedFileRegion(mCblkMemory, _aidl_return));
1899 return Status::ok();
1900}
1901
Andy Hung6ac17eb2023-06-20 18:56:17 -07001902Status EffectHandle::getConfig(
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001903 media::EffectConfig* _config, int32_t* _aidl_return) {
1904 AutoMutex _l(mLock);
Andy Hung6ac17eb2023-06-20 18:56:17 -07001905 sp<IAfEffectBase> effect = mEffect.promote();
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001906 if (effect == nullptr || mDisconnected) {
1907 RETURN(DEAD_OBJECT);
1908 }
Andy Hung6ac17eb2023-06-20 18:56:17 -07001909 sp<IAfEffectModule> effectModule = effect->asEffectModule();
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001910 if (effectModule == nullptr) {
1911 RETURN(INVALID_OPERATION);
1912 }
1913 audio_config_base_t inputCfg = AUDIO_CONFIG_BASE_INITIALIZER;
1914 audio_config_base_t outputCfg = AUDIO_CONFIG_BASE_INITIALIZER;
1915 bool isOutput;
1916 status_t status = effectModule->getConfigs(&inputCfg, &outputCfg, &isOutput);
1917 if (status == NO_ERROR) {
1918 constexpr bool isInput = false; // effects always use 'OUT' channel masks.
1919 _config->inputCfg = VALUE_OR_RETURN_STATUS_AS_OUT(
1920 legacy2aidl_audio_config_base_t_AudioConfigBase(inputCfg, isInput));
1921 _config->outputCfg = VALUE_OR_RETURN_STATUS_AS_OUT(
1922 legacy2aidl_audio_config_base_t_AudioConfigBase(outputCfg, isInput));
1923 _config->isOnInputStream = !isOutput;
1924 }
1925 RETURN(status);
1926}
1927
Andy Hung6ac17eb2023-06-20 18:56:17 -07001928Status EffectHandle::command(int32_t cmdCode,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001929 const std::vector<uint8_t>& cmdData,
1930 int32_t maxResponseSize,
1931 std::vector<uint8_t>* response,
1932 int32_t* _aidl_return)
Eric Laurentca7cc822012-11-19 14:55:58 -08001933{
1934 ALOGVV("command(), cmdCode: %d, mHasControl: %d, mEffect: %p",
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001935 cmdCode, mHasControl, mEffect.unsafe_get());
Eric Laurentca7cc822012-11-19 14:55:58 -08001936
Eric Laurentc7ab3092017-06-15 18:43:46 -07001937 // reject commands reserved for internal use by audio framework if coming from outside
1938 // of audioserver
1939 switch(cmdCode) {
1940 case EFFECT_CMD_ENABLE:
1941 case EFFECT_CMD_DISABLE:
1942 case EFFECT_CMD_SET_PARAM:
1943 case EFFECT_CMD_SET_PARAM_DEFERRED:
1944 case EFFECT_CMD_SET_PARAM_COMMIT:
1945 case EFFECT_CMD_GET_PARAM:
1946 break;
1947 default:
1948 if (cmdCode >= EFFECT_CMD_FIRST_PROPRIETARY) {
1949 break;
1950 }
1951 android_errorWriteLog(0x534e4554, "62019992");
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001952 RETURN(BAD_VALUE);
Eric Laurentc7ab3092017-06-15 18:43:46 -07001953 }
1954
Eric Laurent1ffc5852016-12-15 14:46:09 -08001955 if (cmdCode == EFFECT_CMD_ENABLE) {
Andy Hung920f6572022-10-06 12:09:49 -07001956 if (maxResponseSize < static_cast<signed>(sizeof(int))) {
Eric Laurent1ffc5852016-12-15 14:46:09 -08001957 android_errorWriteLog(0x534e4554, "32095713");
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001958 RETURN(BAD_VALUE);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001959 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001960 writeToBuffer(NO_ERROR, response);
1961 return enable(_aidl_return);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001962 } else if (cmdCode == EFFECT_CMD_DISABLE) {
Andy Hung920f6572022-10-06 12:09:49 -07001963 if (maxResponseSize < static_cast<signed>(sizeof(int))) {
Eric Laurent1ffc5852016-12-15 14:46:09 -08001964 android_errorWriteLog(0x534e4554, "32095713");
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001965 RETURN(BAD_VALUE);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001966 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001967 writeToBuffer(NO_ERROR, response);
1968 return disable(_aidl_return);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001969 }
1970
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001971 AutoMutex _l(mLock);
Andy Hung6ac17eb2023-06-20 18:56:17 -07001972 sp<IAfEffectBase> effect = mEffect.promote();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001973 if (effect == 0 || mDisconnected) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001974 RETURN(DEAD_OBJECT);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001975 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001976 // only get parameter command is permitted for applications not controlling the effect
1977 if (!mHasControl && cmdCode != EFFECT_CMD_GET_PARAM) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001978 RETURN(INVALID_OPERATION);
Eric Laurentca7cc822012-11-19 14:55:58 -08001979 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001980
1981 // handle commands that are not forwarded transparently to effect engine
1982 if (cmdCode == EFFECT_CMD_SET_PARAM_COMMIT) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08001983 if (mClient == 0) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001984 RETURN(INVALID_OPERATION);
Eric Laurentb82e6b72019-11-22 17:25:04 -08001985 }
1986
Andy Hung920f6572022-10-06 12:09:49 -07001987 if (maxResponseSize < (signed)sizeof(int)) {
Eric Laurent1ffc5852016-12-15 14:46:09 -08001988 android_errorWriteLog(0x534e4554, "32095713");
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001989 RETURN(BAD_VALUE);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001990 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001991 writeToBuffer(NO_ERROR, response);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001992
Eric Laurentca7cc822012-11-19 14:55:58 -08001993 // No need to trylock() here as this function is executed in the binder thread serving a
1994 // particular client process: no risk to block the whole media server process or mixer
1995 // threads if we are stuck here
Andy Hung920f6572022-10-06 12:09:49 -07001996 Mutex::Autolock _l2(mCblk->lock);
Andy Hunga447a0f2016-11-15 17:19:58 -08001997 // keep local copy of index in case of client corruption b/32220769
1998 const uint32_t clientIndex = mCblk->clientIndex;
1999 const uint32_t serverIndex = mCblk->serverIndex;
2000 if (clientIndex > EFFECT_PARAM_BUFFER_SIZE ||
2001 serverIndex > EFFECT_PARAM_BUFFER_SIZE) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002002 mCblk->serverIndex = 0;
2003 mCblk->clientIndex = 0;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002004 RETURN(BAD_VALUE);
Eric Laurentca7cc822012-11-19 14:55:58 -08002005 }
2006 status_t status = NO_ERROR;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002007 std::vector<uint8_t> param;
Andy Hunga447a0f2016-11-15 17:19:58 -08002008 for (uint32_t index = serverIndex; index < clientIndex;) {
2009 int *p = (int *)(mBuffer + index);
2010 const int size = *p++;
2011 if (size < 0
2012 || size > EFFECT_PARAM_BUFFER_SIZE
2013 || ((uint8_t *)p + size) > mBuffer + clientIndex) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002014 ALOGW("command(): invalid parameter block size");
Andy Hunga447a0f2016-11-15 17:19:58 -08002015 status = BAD_VALUE;
Eric Laurentca7cc822012-11-19 14:55:58 -08002016 break;
2017 }
Andy Hunga447a0f2016-11-15 17:19:58 -08002018
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002019 std::copy(reinterpret_cast<const uint8_t*>(p),
2020 reinterpret_cast<const uint8_t*>(p) + size,
2021 std::back_inserter(param));
Andy Hunga447a0f2016-11-15 17:19:58 -08002022
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002023 std::vector<uint8_t> replyBuffer;
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002024 status_t ret = effect->command(EFFECT_CMD_SET_PARAM,
Andy Hunga447a0f2016-11-15 17:19:58 -08002025 param,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002026 sizeof(int),
2027 &replyBuffer);
2028 int reply = *reinterpret_cast<const int*>(replyBuffer.data());
Andy Hunga447a0f2016-11-15 17:19:58 -08002029
2030 // verify shared memory: server index shouldn't change; client index can't go back.
2031 if (serverIndex != mCblk->serverIndex
2032 || clientIndex > mCblk->clientIndex) {
2033 android_errorWriteLog(0x534e4554, "32220769");
2034 status = BAD_VALUE;
2035 break;
2036 }
2037
Eric Laurentca7cc822012-11-19 14:55:58 -08002038 // stop at first error encountered
2039 if (ret != NO_ERROR) {
2040 status = ret;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002041 writeToBuffer(reply, response);
Eric Laurentca7cc822012-11-19 14:55:58 -08002042 break;
2043 } else if (reply != NO_ERROR) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002044 writeToBuffer(reply, response);
Eric Laurentca7cc822012-11-19 14:55:58 -08002045 break;
2046 }
Andy Hunga447a0f2016-11-15 17:19:58 -08002047 index += size;
Eric Laurentca7cc822012-11-19 14:55:58 -08002048 }
2049 mCblk->serverIndex = 0;
2050 mCblk->clientIndex = 0;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002051 RETURN(status);
Eric Laurentca7cc822012-11-19 14:55:58 -08002052 }
2053
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002054 status_t status = effect->command(cmdCode,
2055 cmdData,
2056 maxResponseSize,
2057 response);
2058 RETURN(status);
Eric Laurentca7cc822012-11-19 14:55:58 -08002059}
2060
Andy Hung6ac17eb2023-06-20 18:56:17 -07002061void EffectHandle::setControl(bool hasControl, bool signal, bool enabled)
Eric Laurentca7cc822012-11-19 14:55:58 -08002062{
2063 ALOGV("setControl %p control %d", this, hasControl);
2064
2065 mHasControl = hasControl;
2066 mEnabled = enabled;
2067
2068 if (signal && mEffectClient != 0) {
2069 mEffectClient->controlStatusChanged(hasControl);
2070 }
2071}
2072
Andy Hung6ac17eb2023-06-20 18:56:17 -07002073void EffectHandle::commandExecuted(uint32_t cmdCode,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002074 const std::vector<uint8_t>& cmdData,
2075 const std::vector<uint8_t>& replyData)
Eric Laurentca7cc822012-11-19 14:55:58 -08002076{
2077 if (mEffectClient != 0) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002078 mEffectClient->commandExecuted(cmdCode, cmdData, replyData);
Eric Laurentca7cc822012-11-19 14:55:58 -08002079 }
2080}
2081
2082
2083
Andy Hung6ac17eb2023-06-20 18:56:17 -07002084void EffectHandle::setEnabled(bool enabled)
Eric Laurentca7cc822012-11-19 14:55:58 -08002085{
2086 if (mEffectClient != 0) {
2087 mEffectClient->enableStatusChanged(enabled);
2088 }
2089}
2090
Andy Hung6ac17eb2023-06-20 18:56:17 -07002091void EffectHandle::framesProcessed(int32_t frames) const
Eric Laurentde8caf42021-08-11 17:19:25 +02002092{
2093 if (mEffectClient != 0 && mNotifyFramesProcessed) {
2094 mEffectClient->framesProcessed(frames);
2095 }
2096}
2097
Andy Hung6ac17eb2023-06-20 18:56:17 -07002098void EffectHandle::dumpToBuffer(char* buffer, size_t size) const
Andy Hung920f6572022-10-06 12:09:49 -07002099NO_THREAD_SAFETY_ANALYSIS // conditional try lock
Eric Laurentca7cc822012-11-19 14:55:58 -08002100{
Andy Hung0a51b5c2023-07-18 20:54:44 -07002101 const bool locked = mCblk != nullptr && afutils::dumpTryLock(mCblk->lock);
Eric Laurentca7cc822012-11-19 14:55:58 -08002102
Marco Nelissenb2208842014-02-07 14:00:50 -08002103 snprintf(buffer, size, "\t\t\t%5d %5d %3s %3s %5u %5u\n",
Andy Hung4ef19fa2018-05-15 19:35:29 -07002104 (mClient == 0) ? getpid() : mClient->pid(),
Eric Laurentca7cc822012-11-19 14:55:58 -08002105 mPriority,
Marco Nelissenb2208842014-02-07 14:00:50 -08002106 mHasControl ? "yes" : "no",
2107 locked ? "yes" : "no",
Eric Laurentca7cc822012-11-19 14:55:58 -08002108 mCblk ? mCblk->clientIndex : 0,
2109 mCblk ? mCblk->serverIndex : 0
2110 );
2111
2112 if (locked) {
2113 mCblk->lock.unlock();
2114 }
2115}
2116
2117#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -07002118#define LOG_TAG "EffectChain"
Eric Laurentca7cc822012-11-19 14:55:58 -08002119
Andy Hung6ac17eb2023-06-20 18:56:17 -07002120/* static */
2121sp<IAfEffectChain> IAfEffectChain::create(
Andy Hung583043b2023-07-17 17:05:00 -07002122 const sp<IAfThreadBase>& thread,
Andy Hung6ac17eb2023-06-20 18:56:17 -07002123 audio_session_t sessionId)
2124{
Andy Hung583043b2023-07-17 17:05:00 -07002125 return sp<EffectChain>::make(thread, sessionId);
Andy Hung6ac17eb2023-06-20 18:56:17 -07002126}
2127
Andy Hung583043b2023-07-17 17:05:00 -07002128EffectChain::EffectChain(const sp<IAfThreadBase>& thread,
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08002129 audio_session_t sessionId)
Eric Laurent6b446ce2019-12-13 10:56:31 -08002130 : mSessionId(sessionId), mActiveTrackCnt(0), mTrackCnt(0), mTailBufferCount(0),
Mikhail Naganov022b9952017-01-04 16:36:51 -08002131 mVolumeCtrlIdx(-1), mLeftVolume(UINT_MAX), mRightVolume(UINT_MAX),
Eric Laurent6b446ce2019-12-13 10:56:31 -08002132 mNewLeftVolume(UINT_MAX), mNewRightVolume(UINT_MAX),
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08002133 mEffectCallback(new EffectCallback(wp<EffectChain>(this), thread))
Eric Laurentca7cc822012-11-19 14:55:58 -08002134{
Andy Hung583043b2023-07-17 17:05:00 -07002135 mStrategy = thread->getStrategyForStream(AUDIO_STREAM_MUSIC);
2136 mMaxTailBuffers = ((kProcessTailDurationMs * thread->sampleRate()) / 1000) /
2137 thread->frameCount();
Eric Laurentca7cc822012-11-19 14:55:58 -08002138}
2139
Andy Hung87c693c2023-07-06 20:56:16 -07002140// getEffectFromDesc_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002141sp<IAfEffectModule> EffectChain::getEffectFromDesc_l(
2142 effect_descriptor_t *descriptor) const
Eric Laurentca7cc822012-11-19 14:55:58 -08002143{
2144 size_t size = mEffects.size();
2145
2146 for (size_t i = 0; i < size; i++) {
2147 if (memcmp(&mEffects[i]->desc().uuid, &descriptor->uuid, sizeof(effect_uuid_t)) == 0) {
2148 return mEffects[i];
2149 }
2150 }
2151 return 0;
2152}
2153
Andy Hung87c693c2023-07-06 20:56:16 -07002154// getEffectFromId_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002155sp<IAfEffectModule> EffectChain::getEffectFromId_l(int id) const
Eric Laurentca7cc822012-11-19 14:55:58 -08002156{
2157 size_t size = mEffects.size();
2158
2159 for (size_t i = 0; i < size; i++) {
2160 // by convention, return first effect if id provided is 0 (0 is never a valid id)
2161 if (id == 0 || mEffects[i]->id() == id) {
2162 return mEffects[i];
2163 }
2164 }
2165 return 0;
2166}
2167
Andy Hung87c693c2023-07-06 20:56:16 -07002168// getEffectFromType_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002169sp<IAfEffectModule> EffectChain::getEffectFromType_l(
2170 const effect_uuid_t *type) const
Eric Laurentca7cc822012-11-19 14:55:58 -08002171{
2172 size_t size = mEffects.size();
2173
2174 for (size_t i = 0; i < size; i++) {
2175 if (memcmp(&mEffects[i]->desc().type, type, sizeof(effect_uuid_t)) == 0) {
2176 return mEffects[i];
2177 }
2178 }
2179 return 0;
2180}
2181
Andy Hung6ac17eb2023-06-20 18:56:17 -07002182std::vector<int> EffectChain::getEffectIds() const
Eric Laurent6c796322019-04-09 14:13:17 -07002183{
2184 std::vector<int> ids;
2185 Mutex::Autolock _l(mLock);
2186 for (size_t i = 0; i < mEffects.size(); i++) {
2187 ids.push_back(mEffects[i]->id());
2188 }
2189 return ids;
2190}
2191
Andy Hung6ac17eb2023-06-20 18:56:17 -07002192void EffectChain::clearInputBuffer()
Eric Laurentca7cc822012-11-19 14:55:58 -08002193{
2194 Mutex::Autolock _l(mLock);
Eric Laurent6b446ce2019-12-13 10:56:31 -08002195 clearInputBuffer_l();
Eric Laurentca7cc822012-11-19 14:55:58 -08002196}
2197
2198// Must be called with EffectChain::mLock locked
Andy Hung6ac17eb2023-06-20 18:56:17 -07002199void EffectChain::clearInputBuffer_l()
Eric Laurentca7cc822012-11-19 14:55:58 -08002200{
Eric Laurent6acd1d42017-01-04 14:23:29 -08002201 if (mInBuffer == NULL) {
2202 return;
2203 }
Andy Hung319587b2023-05-23 14:01:03 -07002204 const size_t frameSize = audio_bytes_per_sample(AUDIO_FORMAT_PCM_FLOAT)
Eric Laurentf1f22e72021-07-13 14:04:14 +02002205 * mEffectCallback->inChannelCount(mEffects[0]->id());
rago94a1ee82017-07-21 15:11:02 -07002206
Eric Laurent6b446ce2019-12-13 10:56:31 -08002207 memset(mInBuffer->audioBuffer()->raw, 0, mEffectCallback->frameCount() * frameSize);
Mikhail Naganov022b9952017-01-04 16:36:51 -08002208 mInBuffer->commit();
Eric Laurentca7cc822012-11-19 14:55:58 -08002209}
2210
2211// Must be called with EffectChain::mLock locked
Andy Hung6ac17eb2023-06-20 18:56:17 -07002212void EffectChain::process_l()
Eric Laurentca7cc822012-11-19 14:55:58 -08002213{
Jean-Michel Trivifed62922013-09-25 18:50:33 -07002214 // never process effects when:
2215 // - on an OFFLOAD thread
2216 // - no more tracks are on the session and the effect tail has been rendered
Eric Laurent6b446ce2019-12-13 10:56:31 -08002217 bool doProcess = !mEffectCallback->isOffloadOrMmap();
Eric Laurent3f75a5b2019-11-12 15:55:51 -08002218 if (!audio_is_global_session(mSessionId)) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002219 bool tracksOnSession = (trackCnt() != 0);
2220
2221 if (!tracksOnSession && mTailBufferCount == 0) {
2222 doProcess = false;
2223 }
2224
2225 if (activeTrackCnt() == 0) {
2226 // if no track is active and the effect tail has not been rendered,
2227 // the input buffer must be cleared here as the mixer process will not do it
2228 if (tracksOnSession || mTailBufferCount > 0) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08002229 clearInputBuffer_l();
Eric Laurentca7cc822012-11-19 14:55:58 -08002230 if (mTailBufferCount > 0) {
2231 mTailBufferCount--;
2232 }
2233 }
2234 }
2235 }
2236
2237 size_t size = mEffects.size();
2238 if (doProcess) {
Mikhail Naganov022b9952017-01-04 16:36:51 -08002239 // Only the input and output buffers of the chain can be external,
2240 // and 'update' / 'commit' do nothing for allocated buffers, thus
2241 // it's not needed to consider any other buffers here.
2242 mInBuffer->update();
Mikhail Naganov06888802017-01-19 12:47:55 -08002243 if (mInBuffer->audioBuffer()->raw != mOutBuffer->audioBuffer()->raw) {
2244 mOutBuffer->update();
2245 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002246 for (size_t i = 0; i < size; i++) {
2247 mEffects[i]->process();
2248 }
Mikhail Naganov06888802017-01-19 12:47:55 -08002249 mInBuffer->commit();
2250 if (mInBuffer->audioBuffer()->raw != mOutBuffer->audioBuffer()->raw) {
2251 mOutBuffer->commit();
2252 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002253 }
Eric Laurentfa1e1232016-08-02 19:01:49 -07002254 bool doResetVolume = false;
Eric Laurentca7cc822012-11-19 14:55:58 -08002255 for (size_t i = 0; i < size; i++) {
Eric Laurentfa1e1232016-08-02 19:01:49 -07002256 doResetVolume = mEffects[i]->updateState() || doResetVolume;
2257 }
2258 if (doResetVolume) {
2259 resetVolume_l();
Eric Laurentca7cc822012-11-19 14:55:58 -08002260 }
2261}
2262
Andy Hung87c693c2023-07-06 20:56:16 -07002263// createEffect_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002264status_t EffectChain::createEffect_l(sp<IAfEffectModule>& effect,
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002265 effect_descriptor_t *desc,
2266 int id,
2267 audio_session_t sessionId,
2268 bool pinned)
2269{
2270 Mutex::Autolock _l(mLock);
Eric Laurentb82e6b72019-11-22 17:25:04 -08002271 effect = new EffectModule(mEffectCallback, desc, id, sessionId, pinned, AUDIO_PORT_HANDLE_NONE);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002272 status_t lStatus = effect->status();
2273 if (lStatus == NO_ERROR) {
2274 lStatus = addEffect_ll(effect);
2275 }
2276 if (lStatus != NO_ERROR) {
2277 effect.clear();
2278 }
2279 return lStatus;
2280}
2281
Andy Hung87c693c2023-07-06 20:56:16 -07002282// addEffect_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002283status_t EffectChain::addEffect_l(const sp<IAfEffectModule>& effect)
Eric Laurentca7cc822012-11-19 14:55:58 -08002284{
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002285 Mutex::Autolock _l(mLock);
2286 return addEffect_ll(effect);
2287}
Andy Hung87c693c2023-07-06 20:56:16 -07002288// addEffect_l() must be called with IAfThreadBase::mLock and EffectChain::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002289status_t EffectChain::addEffect_ll(const sp<IAfEffectModule>& effect)
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002290{
Eric Laurent6b446ce2019-12-13 10:56:31 -08002291 effect->setCallback(mEffectCallback);
Eric Laurentca7cc822012-11-19 14:55:58 -08002292
Eric Laurentb62d0362021-10-26 17:40:18 +02002293 effect_descriptor_t desc = effect->desc();
Eric Laurentca7cc822012-11-19 14:55:58 -08002294 if ((desc.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY) {
2295 // Auxiliary effects are inserted at the beginning of mEffects vector as
2296 // they are processed first and accumulated in chain input buffer
2297 mEffects.insertAt(effect, 0);
2298
2299 // the input buffer for auxiliary effect contains mono samples in
2300 // 32 bit format. This is to avoid saturation in AudoMixer
2301 // accumulation stage. Saturation is done in EffectModule::process() before
2302 // calling the process in effect engine
Eric Laurent6b446ce2019-12-13 10:56:31 -08002303 size_t numSamples = mEffectCallback->frameCount();
Mikhail Naganov022b9952017-01-04 16:36:51 -08002304 sp<EffectBufferHalInterface> halBuffer;
Andy Hung26836922023-05-22 17:31:57 -07002305
Eric Laurent6b446ce2019-12-13 10:56:31 -08002306 status_t result = mEffectCallback->allocateHalBuffer(
rago94a1ee82017-07-21 15:11:02 -07002307 numSamples * sizeof(float), &halBuffer);
Mikhail Naganov022b9952017-01-04 16:36:51 -08002308 if (result != OK) return result;
Eric Laurentf1f22e72021-07-13 14:04:14 +02002309
2310 effect->configure();
2311
Mikhail Naganov022b9952017-01-04 16:36:51 -08002312 effect->setInBuffer(halBuffer);
Eric Laurentca7cc822012-11-19 14:55:58 -08002313 // auxiliary effects output samples to chain input buffer for further processing
2314 // by insert effects
2315 effect->setOutBuffer(mInBuffer);
2316 } else {
Eric Laurentb62d0362021-10-26 17:40:18 +02002317 ssize_t idx_insert = getInsertIndex(desc);
2318 if (idx_insert < 0) {
2319 return INVALID_OPERATION;
Eric Laurentca7cc822012-11-19 14:55:58 -08002320 }
2321
Eric Laurentb62d0362021-10-26 17:40:18 +02002322 size_t previousSize = mEffects.size();
Eric Laurentf1f22e72021-07-13 14:04:14 +02002323 mEffects.insertAt(effect, idx_insert);
2324
2325 effect->configure();
2326
Eric Laurentb62d0362021-10-26 17:40:18 +02002327 // - By default:
2328 // All effects read samples from chain input buffer.
2329 // The last effect in the chain, writes samples to chain output buffer,
2330 // otherwise to chain input buffer
2331 // - In the OUTPUT_STAGE chain of a spatializer mixer thread:
2332 // The spatializer effect (first effect) reads samples from the input buffer
2333 // and writes samples to the output buffer.
2334 // All other effects read and writes samples to the output buffer
2335 if (mEffectCallback->isSpatializer()
2336 && mSessionId == AUDIO_SESSION_OUTPUT_STAGE) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002337 effect->setOutBuffer(mOutBuffer);
Eric Laurentb62d0362021-10-26 17:40:18 +02002338 if (idx_insert == 0) {
2339 if (previousSize != 0) {
2340 mEffects[1]->configure();
2341 mEffects[1]->setInBuffer(mOutBuffer);
2342 mEffects[1]->updateAccessMode(); // reconfig if neeeded.
2343 }
2344 effect->setInBuffer(mInBuffer);
2345 } else {
2346 effect->setInBuffer(mOutBuffer);
2347 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002348 } else {
Eric Laurentb62d0362021-10-26 17:40:18 +02002349 effect->setInBuffer(mInBuffer);
Andy Hung920f6572022-10-06 12:09:49 -07002350 if (idx_insert == static_cast<ssize_t>(previousSize)) {
Eric Laurentb62d0362021-10-26 17:40:18 +02002351 if (idx_insert != 0) {
2352 mEffects[idx_insert-1]->configure();
2353 mEffects[idx_insert-1]->setOutBuffer(mInBuffer);
2354 mEffects[idx_insert - 1]->updateAccessMode(); // reconfig if neeeded.
2355 }
2356 effect->setOutBuffer(mOutBuffer);
2357 } else {
2358 effect->setOutBuffer(mInBuffer);
2359 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002360 }
Eric Laurentb62d0362021-10-26 17:40:18 +02002361 ALOGV("%s effect %p, added in chain %p at rank %zu",
2362 __func__, effect.get(), this, idx_insert);
Eric Laurentca7cc822012-11-19 14:55:58 -08002363 }
2364 effect->configure();
Eric Laurentd8365c52017-07-16 15:27:05 -07002365
Eric Laurentca7cc822012-11-19 14:55:58 -08002366 return NO_ERROR;
2367}
2368
Andy Hung6ac17eb2023-06-20 18:56:17 -07002369ssize_t EffectChain::getInsertIndex(const effect_descriptor_t& desc) {
Eric Laurentb62d0362021-10-26 17:40:18 +02002370 // Insert effects are inserted at the end of mEffects vector as they are processed
2371 // after track and auxiliary effects.
2372 // Insert effect order as a function of indicated preference:
2373 // if EFFECT_FLAG_INSERT_EXCLUSIVE, insert in first position or reject if
2374 // another effect is present
2375 // else if EFFECT_FLAG_INSERT_FIRST, insert in first position or after the
2376 // last effect claiming first position
2377 // else if EFFECT_FLAG_INSERT_LAST, insert in last position or before the
2378 // first effect claiming last position
2379 // else if EFFECT_FLAG_INSERT_ANY insert after first or before last
2380 // Reject insertion if an effect with EFFECT_FLAG_INSERT_EXCLUSIVE is
2381 // already present
2382 // Spatializer or Downmixer effects are inserted in first position because
2383 // they adapt the channel count for all other effects in the chain
2384 if ((memcmp(&desc.type, FX_IID_SPATIALIZER, sizeof(effect_uuid_t)) == 0)
2385 || (memcmp(&desc.type, EFFECT_UIID_DOWNMIX, sizeof(effect_uuid_t)) == 0)) {
2386 return 0;
2387 }
2388
2389 size_t size = mEffects.size();
2390 uint32_t insertPref = desc.flags & EFFECT_FLAG_INSERT_MASK;
2391 ssize_t idx_insert;
2392 ssize_t idx_insert_first = -1;
2393 ssize_t idx_insert_last = -1;
2394
2395 idx_insert = size;
2396 for (size_t i = 0; i < size; i++) {
2397 effect_descriptor_t d = mEffects[i]->desc();
2398 uint32_t iMode = d.flags & EFFECT_FLAG_TYPE_MASK;
2399 uint32_t iPref = d.flags & EFFECT_FLAG_INSERT_MASK;
2400 if (iMode == EFFECT_FLAG_TYPE_INSERT) {
2401 // check invalid effect chaining combinations
2402 if (insertPref == EFFECT_FLAG_INSERT_EXCLUSIVE ||
2403 iPref == EFFECT_FLAG_INSERT_EXCLUSIVE) {
2404 ALOGW("%s could not insert effect %s: exclusive conflict with %s",
2405 __func__, desc.name, d.name);
2406 return -1;
2407 }
2408 // remember position of first insert effect and by default
2409 // select this as insert position for new effect
Andy Hung920f6572022-10-06 12:09:49 -07002410 if (idx_insert == static_cast<ssize_t>(size)) {
Eric Laurentb62d0362021-10-26 17:40:18 +02002411 idx_insert = i;
2412 }
2413 // remember position of last insert effect claiming
2414 // first position
2415 if (iPref == EFFECT_FLAG_INSERT_FIRST) {
2416 idx_insert_first = i;
2417 }
2418 // remember position of first insert effect claiming
2419 // last position
2420 if (iPref == EFFECT_FLAG_INSERT_LAST &&
2421 idx_insert_last == -1) {
2422 idx_insert_last = i;
2423 }
2424 }
2425 }
2426
2427 // modify idx_insert from first position if needed
2428 if (insertPref == EFFECT_FLAG_INSERT_LAST) {
2429 if (idx_insert_last != -1) {
2430 idx_insert = idx_insert_last;
2431 } else {
2432 idx_insert = size;
2433 }
2434 } else {
2435 if (idx_insert_first != -1) {
2436 idx_insert = idx_insert_first + 1;
2437 }
2438 }
2439 return idx_insert;
2440}
2441
Andy Hung87c693c2023-07-06 20:56:16 -07002442// removeEffect_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002443size_t EffectChain::removeEffect_l(const sp<IAfEffectModule>& effect,
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002444 bool release)
Eric Laurentca7cc822012-11-19 14:55:58 -08002445{
2446 Mutex::Autolock _l(mLock);
2447 size_t size = mEffects.size();
2448 uint32_t type = effect->desc().flags & EFFECT_FLAG_TYPE_MASK;
2449
2450 for (size_t i = 0; i < size; i++) {
2451 if (effect == mEffects[i]) {
2452 // calling stop here will remove pre-processing effect from the audio HAL.
2453 // This is safe as we hold the EffectChain mutex which guarantees that we are not in
2454 // the middle of a read from audio HAL
2455 if (mEffects[i]->state() == EffectModule::ACTIVE ||
2456 mEffects[i]->state() == EffectModule::STOPPING) {
2457 mEffects[i]->stop();
2458 }
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002459 if (release) {
2460 mEffects[i]->release_l();
2461 }
2462
Mikhail Naganov022b9952017-01-04 16:36:51 -08002463 if (type != EFFECT_FLAG_TYPE_AUXILIARY) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002464 if (i == size - 1 && i != 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002465 mEffects[i - 1]->configure();
Eric Laurentf1f22e72021-07-13 14:04:14 +02002466 mEffects[i - 1]->setOutBuffer(mOutBuffer);
Eric Laurent6bb7dbe2021-12-23 15:39:36 +01002467 mEffects[i - 1]->updateAccessMode(); // reconfig if neeeded.
Eric Laurentca7cc822012-11-19 14:55:58 -08002468 }
2469 }
2470 mEffects.removeAt(i);
Eric Laurentf1f22e72021-07-13 14:04:14 +02002471
2472 // make sure the input buffer configuration for the new first effect in the chain
2473 // is updated if needed (can switch from HAL channel mask to mixer channel mask)
Nie Wei Feng4d2cb592023-05-26 15:18:04 -07002474 if (type != EFFECT_FLAG_TYPE_AUXILIARY // TODO(b/284522658) breaks for aux FX, why?
2475 && i == 0 && size > 1) {
Eric Laurentf1f22e72021-07-13 14:04:14 +02002476 mEffects[0]->configure();
2477 mEffects[0]->setInBuffer(mInBuffer);
Eric Laurent6bb7dbe2021-12-23 15:39:36 +01002478 mEffects[0]->updateAccessMode(); // reconfig if neeeded.
Eric Laurentf1f22e72021-07-13 14:04:14 +02002479 }
2480
Glenn Kastenc42e9b42016-03-21 11:35:03 -07002481 ALOGV("removeEffect_l() effect %p, removed from chain %p at rank %zu", effect.get(),
Eric Laurentca7cc822012-11-19 14:55:58 -08002482 this, i);
2483 break;
2484 }
2485 }
2486
2487 return mEffects.size();
2488}
2489
Andy Hung87c693c2023-07-06 20:56:16 -07002490// setDevices_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002491void EffectChain::setDevices_l(const AudioDeviceTypeAddrVector &devices)
Eric Laurentca7cc822012-11-19 14:55:58 -08002492{
2493 size_t size = mEffects.size();
2494 for (size_t i = 0; i < size; i++) {
jiabin8f278ee2019-11-11 12:16:27 -08002495 mEffects[i]->setDevices(devices);
2496 }
2497}
2498
Andy Hung87c693c2023-07-06 20:56:16 -07002499// setInputDevice_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002500void EffectChain::setInputDevice_l(const AudioDeviceTypeAddr &device)
jiabin8f278ee2019-11-11 12:16:27 -08002501{
2502 size_t size = mEffects.size();
2503 for (size_t i = 0; i < size; i++) {
2504 mEffects[i]->setInputDevice(device);
Eric Laurentca7cc822012-11-19 14:55:58 -08002505 }
2506}
2507
Andy Hung87c693c2023-07-06 20:56:16 -07002508// setMode_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002509void EffectChain::setMode_l(audio_mode_t mode)
Eric Laurentca7cc822012-11-19 14:55:58 -08002510{
2511 size_t size = mEffects.size();
2512 for (size_t i = 0; i < size; i++) {
2513 mEffects[i]->setMode(mode);
2514 }
2515}
2516
Andy Hung87c693c2023-07-06 20:56:16 -07002517// setAudioSource_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002518void EffectChain::setAudioSource_l(audio_source_t source)
Eric Laurentca7cc822012-11-19 14:55:58 -08002519{
2520 size_t size = mEffects.size();
2521 for (size_t i = 0; i < size; i++) {
2522 mEffects[i]->setAudioSource(source);
2523 }
2524}
2525
Andy Hung6ac17eb2023-06-20 18:56:17 -07002526bool EffectChain::hasVolumeControlEnabled_l() const {
Zhou Songd505c642020-02-20 16:35:37 +08002527 for (const auto &effect : mEffects) {
2528 if (effect->isVolumeControlEnabled()) return true;
2529 }
2530 return false;
2531}
2532
Andy Hung87c693c2023-07-06 20:56:16 -07002533// setVolume_l() must be called with IAfThreadBase::mLock or EffectChain::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002534bool EffectChain::setVolume_l(uint32_t *left, uint32_t *right, bool force)
Eric Laurentca7cc822012-11-19 14:55:58 -08002535{
2536 uint32_t newLeft = *left;
2537 uint32_t newRight = *right;
2538 bool hasControl = false;
2539 int ctrlIdx = -1;
2540 size_t size = mEffects.size();
2541
2542 // first update volume controller
2543 for (size_t i = size; i > 0; i--) {
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09002544 if (mEffects[i - 1]->isVolumeControlEnabled()) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002545 ctrlIdx = i - 1;
2546 hasControl = true;
2547 break;
2548 }
2549 }
2550
Eric Laurentfa1e1232016-08-02 19:01:49 -07002551 if (!force && ctrlIdx == mVolumeCtrlIdx &&
Eric Laurentcb4b6e92014-10-01 14:26:10 -07002552 *left == mLeftVolume && *right == mRightVolume) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002553 if (hasControl) {
2554 *left = mNewLeftVolume;
2555 *right = mNewRightVolume;
2556 }
2557 return hasControl;
2558 }
2559
2560 mVolumeCtrlIdx = ctrlIdx;
2561 mLeftVolume = newLeft;
2562 mRightVolume = newRight;
2563
2564 // second get volume update from volume controller
2565 if (ctrlIdx >= 0) {
2566 mEffects[ctrlIdx]->setVolume(&newLeft, &newRight, true);
2567 mNewLeftVolume = newLeft;
2568 mNewRightVolume = newRight;
2569 }
2570 // then indicate volume to all other effects in chain.
2571 // Pass altered volume to effects before volume controller
Jasmine Cha934ecfb2019-01-23 18:19:14 +08002572 // and requested volume to effects after controller or with volume monitor flag
Eric Laurentca7cc822012-11-19 14:55:58 -08002573 uint32_t lVol = newLeft;
2574 uint32_t rVol = newRight;
2575
2576 for (size_t i = 0; i < size; i++) {
2577 if ((int)i == ctrlIdx) {
2578 continue;
2579 }
2580 // this also works for ctrlIdx == -1 when there is no volume controller
2581 if ((int)i > ctrlIdx) {
2582 lVol = *left;
2583 rVol = *right;
2584 }
Jasmine Cha934ecfb2019-01-23 18:19:14 +08002585 // Pass requested volume directly if this is volume monitor module
2586 if (mEffects[i]->isVolumeMonitor()) {
2587 mEffects[i]->setVolume(left, right, false);
2588 } else {
2589 mEffects[i]->setVolume(&lVol, &rVol, false);
2590 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002591 }
2592 *left = newLeft;
2593 *right = newRight;
2594
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09002595 setVolumeForOutput_l(*left, *right);
2596
Eric Laurentca7cc822012-11-19 14:55:58 -08002597 return hasControl;
2598}
2599
Andy Hung87c693c2023-07-06 20:56:16 -07002600// resetVolume_l() must be called with IAfThreadBase::mutex() or EffectChain::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002601void EffectChain::resetVolume_l()
Eric Laurentfa1e1232016-08-02 19:01:49 -07002602{
Eric Laurente7449bf2016-08-03 18:44:07 -07002603 if ((mLeftVolume != UINT_MAX) && (mRightVolume != UINT_MAX)) {
2604 uint32_t left = mLeftVolume;
2605 uint32_t right = mRightVolume;
2606 (void)setVolume_l(&left, &right, true);
2607 }
Eric Laurentfa1e1232016-08-02 19:01:49 -07002608}
2609
Andy Hung6ac17eb2023-06-20 18:56:17 -07002610// containsHapticGeneratingEffect_l must be called with
Andy Hung87c693c2023-07-06 20:56:16 -07002611// IAfThreadBase::mutex() or EffectChain::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002612bool EffectChain::containsHapticGeneratingEffect_l()
jiabineb3bda02020-06-30 14:07:03 -07002613{
2614 for (size_t i = 0; i < mEffects.size(); ++i) {
2615 if (mEffects[i]->isHapticGenerator()) {
2616 return true;
2617 }
2618 }
2619 return false;
2620}
2621
Andy Hung6ac17eb2023-06-20 18:56:17 -07002622void EffectChain::setHapticIntensity_l(int id, os::HapticScale intensity)
jiabine70bc7f2020-06-30 22:07:55 -07002623{
2624 Mutex::Autolock _l(mLock);
2625 for (size_t i = 0; i < mEffects.size(); ++i) {
2626 mEffects[i]->setHapticIntensity(id, intensity);
2627 }
2628}
2629
Andy Hung6ac17eb2023-06-20 18:56:17 -07002630void EffectChain::syncHalEffectsState()
Eric Laurent1b928682014-10-02 19:41:47 -07002631{
2632 Mutex::Autolock _l(mLock);
2633 for (size_t i = 0; i < mEffects.size(); i++) {
2634 if (mEffects[i]->state() == EffectModule::ACTIVE ||
2635 mEffects[i]->state() == EffectModule::STOPPING) {
2636 mEffects[i]->addEffectToHal_l();
2637 }
2638 }
2639}
2640
Andy Hung6ac17eb2023-06-20 18:56:17 -07002641void EffectChain::dump(int fd, const Vector<String16>& args) const
Andy Hung920f6572022-10-06 12:09:49 -07002642NO_THREAD_SAFETY_ANALYSIS // conditional try lock
Eric Laurentca7cc822012-11-19 14:55:58 -08002643{
Eric Laurentca7cc822012-11-19 14:55:58 -08002644 String8 result;
2645
Mikhail Naganov19740ca2019-03-28 12:25:01 -07002646 const size_t numEffects = mEffects.size();
2647 result.appendFormat(" %zu effects for session %d\n", numEffects, mSessionId);
Eric Laurentca7cc822012-11-19 14:55:58 -08002648
Marco Nelissenb2208842014-02-07 14:00:50 -08002649 if (numEffects) {
Andy Hung0a51b5c2023-07-18 20:54:44 -07002650 const bool locked = afutils::dumpTryLock(mLock);
Marco Nelissenb2208842014-02-07 14:00:50 -08002651 // failed to lock - AudioFlinger is probably deadlocked
2652 if (!locked) {
2653 result.append("\tCould not lock mutex:\n");
Eric Laurentca7cc822012-11-19 14:55:58 -08002654 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002655
Andy Hungbded9c82017-11-30 18:47:35 -08002656 const std::string inBufferStr = dumpInOutBuffer(true /* isInput */, mInBuffer);
2657 const std::string outBufferStr = dumpInOutBuffer(false /* isInput */, mOutBuffer);
2658 result.appendFormat("\t%-*s%-*s Active tracks:\n",
2659 (int)inBufferStr.size(), "In buffer ",
2660 (int)outBufferStr.size(), "Out buffer ");
2661 result.appendFormat("\t%s %s %d\n",
2662 inBufferStr.c_str(), outBufferStr.c_str(), mActiveTrackCnt);
Marco Nelissenb2208842014-02-07 14:00:50 -08002663 write(fd, result.string(), result.size());
2664
2665 for (size_t i = 0; i < numEffects; ++i) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07002666 sp<IAfEffectModule> effect = mEffects[i];
Marco Nelissenb2208842014-02-07 14:00:50 -08002667 if (effect != 0) {
2668 effect->dump(fd, args);
2669 }
2670 }
2671
2672 if (locked) {
2673 mLock.unlock();
2674 }
Mikhail Naganov19740ca2019-03-28 12:25:01 -07002675 } else {
2676 write(fd, result.string(), result.size());
Eric Laurentca7cc822012-11-19 14:55:58 -08002677 }
2678}
2679
Andy Hung87c693c2023-07-06 20:56:16 -07002680// must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002681void EffectChain::setEffectSuspended_l(
Eric Laurentca7cc822012-11-19 14:55:58 -08002682 const effect_uuid_t *type, bool suspend)
2683{
2684 sp<SuspendedEffectDesc> desc;
2685 // use effect type UUID timelow as key as there is no real risk of identical
2686 // timeLow fields among effect type UUIDs.
2687 ssize_t index = mSuspendedEffects.indexOfKey(type->timeLow);
2688 if (suspend) {
2689 if (index >= 0) {
2690 desc = mSuspendedEffects.valueAt(index);
2691 } else {
2692 desc = new SuspendedEffectDesc();
2693 desc->mType = *type;
2694 mSuspendedEffects.add(type->timeLow, desc);
2695 ALOGV("setEffectSuspended_l() add entry for %08x", type->timeLow);
2696 }
Eric Laurentd8365c52017-07-16 15:27:05 -07002697
Eric Laurentca7cc822012-11-19 14:55:58 -08002698 if (desc->mRefCount++ == 0) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07002699 sp<IAfEffectModule> effect = getEffectIfEnabled(type);
Eric Laurentca7cc822012-11-19 14:55:58 -08002700 if (effect != 0) {
2701 desc->mEffect = effect;
2702 effect->setSuspended(true);
Eric Laurent6b446ce2019-12-13 10:56:31 -08002703 effect->setEnabled(false, false /*fromHandle*/);
Eric Laurentca7cc822012-11-19 14:55:58 -08002704 }
2705 }
2706 } else {
2707 if (index < 0) {
2708 return;
2709 }
2710 desc = mSuspendedEffects.valueAt(index);
2711 if (desc->mRefCount <= 0) {
2712 ALOGW("setEffectSuspended_l() restore refcount should not be 0 %d", desc->mRefCount);
Eric Laurentd8365c52017-07-16 15:27:05 -07002713 desc->mRefCount = 0;
2714 return;
Eric Laurentca7cc822012-11-19 14:55:58 -08002715 }
2716 if (--desc->mRefCount == 0) {
2717 ALOGV("setEffectSuspended_l() remove entry for %08x", mSuspendedEffects.keyAt(index));
2718 if (desc->mEffect != 0) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07002719 sp<IAfEffectModule> effect = desc->mEffect.promote();
Eric Laurentca7cc822012-11-19 14:55:58 -08002720 if (effect != 0) {
2721 effect->setSuspended(false);
2722 effect->lock();
Andy Hung6ac17eb2023-06-20 18:56:17 -07002723 IAfEffectHandle *handle = effect->controlHandle_l();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002724 if (handle != NULL && !handle->disconnected()) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002725 effect->setEnabled_l(handle->enabled());
2726 }
2727 effect->unlock();
2728 }
2729 desc->mEffect.clear();
2730 }
2731 mSuspendedEffects.removeItemsAt(index);
2732 }
2733 }
2734}
2735
Andy Hung87c693c2023-07-06 20:56:16 -07002736// must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002737void EffectChain::setEffectSuspendedAll_l(bool suspend)
Eric Laurentca7cc822012-11-19 14:55:58 -08002738{
2739 sp<SuspendedEffectDesc> desc;
2740
2741 ssize_t index = mSuspendedEffects.indexOfKey((int)kKeyForSuspendAll);
2742 if (suspend) {
2743 if (index >= 0) {
2744 desc = mSuspendedEffects.valueAt(index);
2745 } else {
2746 desc = new SuspendedEffectDesc();
2747 mSuspendedEffects.add((int)kKeyForSuspendAll, desc);
2748 ALOGV("setEffectSuspendedAll_l() add entry for 0");
2749 }
2750 if (desc->mRefCount++ == 0) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07002751 Vector< sp<IAfEffectModule> > effects;
Eric Laurentca7cc822012-11-19 14:55:58 -08002752 getSuspendEligibleEffects(effects);
2753 for (size_t i = 0; i < effects.size(); i++) {
2754 setEffectSuspended_l(&effects[i]->desc().type, true);
2755 }
2756 }
2757 } else {
2758 if (index < 0) {
2759 return;
2760 }
2761 desc = mSuspendedEffects.valueAt(index);
2762 if (desc->mRefCount <= 0) {
2763 ALOGW("setEffectSuspendedAll_l() restore refcount should not be 0 %d", desc->mRefCount);
2764 desc->mRefCount = 1;
2765 }
2766 if (--desc->mRefCount == 0) {
2767 Vector<const effect_uuid_t *> types;
2768 for (size_t i = 0; i < mSuspendedEffects.size(); i++) {
2769 if (mSuspendedEffects.keyAt(i) == (int)kKeyForSuspendAll) {
2770 continue;
2771 }
2772 types.add(&mSuspendedEffects.valueAt(i)->mType);
2773 }
2774 for (size_t i = 0; i < types.size(); i++) {
2775 setEffectSuspended_l(types[i], false);
2776 }
2777 ALOGV("setEffectSuspendedAll_l() remove entry for %08x",
2778 mSuspendedEffects.keyAt(index));
2779 mSuspendedEffects.removeItem((int)kKeyForSuspendAll);
2780 }
2781 }
2782}
2783
2784
2785// The volume effect is used for automated tests only
2786#ifndef OPENSL_ES_H_
2787static const effect_uuid_t SL_IID_VOLUME_ = { 0x09e8ede0, 0xddde, 0x11db, 0xb4f6,
2788 { 0x00, 0x02, 0xa5, 0xd5, 0xc5, 0x1b } };
2789const effect_uuid_t * const SL_IID_VOLUME = &SL_IID_VOLUME_;
2790#endif //OPENSL_ES_H_
2791
Eric Laurentd8365c52017-07-16 15:27:05 -07002792/* static */
Andy Hung6ac17eb2023-06-20 18:56:17 -07002793bool EffectChain::isEffectEligibleForBtNrecSuspend(const effect_uuid_t *type)
Eric Laurentd8365c52017-07-16 15:27:05 -07002794{
2795 // Only NS and AEC are suspended when BtNRec is off
2796 if ((memcmp(type, FX_IID_AEC, sizeof(effect_uuid_t)) == 0) ||
2797 (memcmp(type, FX_IID_NS, sizeof(effect_uuid_t)) == 0)) {
2798 return true;
2799 }
2800 return false;
2801}
2802
Andy Hung6ac17eb2023-06-20 18:56:17 -07002803bool EffectChain::isEffectEligibleForSuspend(const effect_descriptor_t& desc)
Eric Laurentca7cc822012-11-19 14:55:58 -08002804{
2805 // auxiliary effects and visualizer are never suspended on output mix
2806 if ((mSessionId == AUDIO_SESSION_OUTPUT_MIX) &&
2807 (((desc.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY) ||
2808 (memcmp(&desc.type, SL_IID_VISUALIZATION, sizeof(effect_uuid_t)) == 0) ||
Ricardo Garciac2a3a822019-07-17 14:29:12 -07002809 (memcmp(&desc.type, SL_IID_VOLUME, sizeof(effect_uuid_t)) == 0) ||
2810 (memcmp(&desc.type, SL_IID_DYNAMICSPROCESSING, sizeof(effect_uuid_t)) == 0))) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002811 return false;
2812 }
2813 return true;
2814}
2815
Andy Hung6ac17eb2023-06-20 18:56:17 -07002816void EffectChain::getSuspendEligibleEffects(
2817 Vector< sp<IAfEffectModule> > &effects)
Eric Laurentca7cc822012-11-19 14:55:58 -08002818{
2819 effects.clear();
2820 for (size_t i = 0; i < mEffects.size(); i++) {
2821 if (isEffectEligibleForSuspend(mEffects[i]->desc())) {
2822 effects.add(mEffects[i]);
2823 }
2824 }
2825}
2826
Andy Hung6ac17eb2023-06-20 18:56:17 -07002827sp<IAfEffectModule> EffectChain::getEffectIfEnabled(const effect_uuid_t *type)
Eric Laurentca7cc822012-11-19 14:55:58 -08002828{
Andy Hung6ac17eb2023-06-20 18:56:17 -07002829 sp<IAfEffectModule> effect = getEffectFromType_l(type);
Eric Laurentca7cc822012-11-19 14:55:58 -08002830 return effect != 0 && effect->isEnabled() ? effect : 0;
2831}
2832
Andy Hung6ac17eb2023-06-20 18:56:17 -07002833void EffectChain::checkSuspendOnEffectEnabled(const sp<IAfEffectModule>& effect,
Eric Laurentca7cc822012-11-19 14:55:58 -08002834 bool enabled)
2835{
2836 ssize_t index = mSuspendedEffects.indexOfKey(effect->desc().type.timeLow);
2837 if (enabled) {
2838 if (index < 0) {
2839 // if the effect is not suspend check if all effects are suspended
2840 index = mSuspendedEffects.indexOfKey((int)kKeyForSuspendAll);
2841 if (index < 0) {
2842 return;
2843 }
2844 if (!isEffectEligibleForSuspend(effect->desc())) {
2845 return;
2846 }
2847 setEffectSuspended_l(&effect->desc().type, enabled);
2848 index = mSuspendedEffects.indexOfKey(effect->desc().type.timeLow);
2849 if (index < 0) {
2850 ALOGW("checkSuspendOnEffectEnabled() Fx should be suspended here!");
2851 return;
2852 }
2853 }
2854 ALOGV("checkSuspendOnEffectEnabled() enable suspending fx %08x",
2855 effect->desc().type.timeLow);
2856 sp<SuspendedEffectDesc> desc = mSuspendedEffects.valueAt(index);
Eric Laurentd8365c52017-07-16 15:27:05 -07002857 // if effect is requested to suspended but was not yet enabled, suspend it now.
Eric Laurentca7cc822012-11-19 14:55:58 -08002858 if (desc->mEffect == 0) {
2859 desc->mEffect = effect;
Eric Laurent6b446ce2019-12-13 10:56:31 -08002860 effect->setEnabled(false, false /*fromHandle*/);
Eric Laurentca7cc822012-11-19 14:55:58 -08002861 effect->setSuspended(true);
2862 }
2863 } else {
2864 if (index < 0) {
2865 return;
2866 }
2867 ALOGV("checkSuspendOnEffectEnabled() disable restoring fx %08x",
2868 effect->desc().type.timeLow);
2869 sp<SuspendedEffectDesc> desc = mSuspendedEffects.valueAt(index);
2870 desc->mEffect.clear();
2871 effect->setSuspended(false);
2872 }
2873}
2874
Andy Hung6ac17eb2023-06-20 18:56:17 -07002875bool EffectChain::isNonOffloadableEnabled() const
Eric Laurent813e2a72013-08-31 12:59:48 -07002876{
2877 Mutex::Autolock _l(mLock);
Shingo Kitajima1f8df9a2018-05-29 11:35:06 +09002878 return isNonOffloadableEnabled_l();
2879}
2880
Andy Hung6ac17eb2023-06-20 18:56:17 -07002881bool EffectChain::isNonOffloadableEnabled_l() const
Shingo Kitajima1f8df9a2018-05-29 11:35:06 +09002882{
Eric Laurent813e2a72013-08-31 12:59:48 -07002883 size_t size = mEffects.size();
2884 for (size_t i = 0; i < size; i++) {
Eric Laurent5baf2af2013-09-12 17:37:00 -07002885 if (mEffects[i]->isEnabled() && !mEffects[i]->isOffloadable()) {
Eric Laurent813e2a72013-08-31 12:59:48 -07002886 return true;
2887 }
2888 }
2889 return false;
2890}
2891
Andy Hung87c693c2023-07-06 20:56:16 -07002892void EffectChain::setThread(const sp<IAfThreadBase>& thread)
Eric Laurentaaa44472014-09-12 17:41:50 -07002893{
2894 Mutex::Autolock _l(mLock);
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08002895 mEffectCallback->setThread(thread);
Eric Laurentaaa44472014-09-12 17:41:50 -07002896}
2897
Andy Hung6ac17eb2023-06-20 18:56:17 -07002898void EffectChain::checkOutputFlagCompatibility(audio_output_flags_t *flags) const
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002899{
2900 if ((*flags & AUDIO_OUTPUT_FLAG_RAW) != 0 && !isRawCompatible()) {
2901 *flags = (audio_output_flags_t)(*flags & ~AUDIO_OUTPUT_FLAG_RAW);
2902 }
2903 if ((*flags & AUDIO_OUTPUT_FLAG_FAST) != 0 && !isFastCompatible()) {
2904 *flags = (audio_output_flags_t)(*flags & ~AUDIO_OUTPUT_FLAG_FAST);
2905 }
jiabinc658e452022-10-21 20:52:21 +00002906 if ((*flags & AUDIO_OUTPUT_FLAG_BIT_PERFECT) != 0 && !isBitPerfectCompatible()) {
2907 *flags = (audio_output_flags_t)(*flags & ~AUDIO_OUTPUT_FLAG_BIT_PERFECT);
2908 }
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002909}
2910
Andy Hung6ac17eb2023-06-20 18:56:17 -07002911void EffectChain::checkInputFlagCompatibility(audio_input_flags_t *flags) const
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002912{
2913 if ((*flags & AUDIO_INPUT_FLAG_RAW) != 0 && !isRawCompatible()) {
2914 *flags = (audio_input_flags_t)(*flags & ~AUDIO_INPUT_FLAG_RAW);
2915 }
2916 if ((*flags & AUDIO_INPUT_FLAG_FAST) != 0 && !isFastCompatible()) {
2917 *flags = (audio_input_flags_t)(*flags & ~AUDIO_INPUT_FLAG_FAST);
2918 }
2919}
2920
Andy Hung6ac17eb2023-06-20 18:56:17 -07002921bool EffectChain::isRawCompatible() const
Eric Laurent4c415062016-06-17 16:14:16 -07002922{
2923 Mutex::Autolock _l(mLock);
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002924 for (const auto &effect : mEffects) {
2925 if (effect->isProcessImplemented()) {
2926 return false;
Eric Laurent4c415062016-06-17 16:14:16 -07002927 }
2928 }
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002929 // Allow effects without processing.
2930 return true;
2931}
2932
Andy Hung6ac17eb2023-06-20 18:56:17 -07002933bool EffectChain::isFastCompatible() const
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002934{
2935 Mutex::Autolock _l(mLock);
2936 for (const auto &effect : mEffects) {
2937 if (effect->isProcessImplemented()
2938 && effect->isImplementationSoftware()) {
2939 return false;
2940 }
2941 }
2942 // Allow effects without processing or hw accelerated effects.
2943 return true;
Eric Laurent4c415062016-06-17 16:14:16 -07002944}
2945
Andy Hung6ac17eb2023-06-20 18:56:17 -07002946bool EffectChain::isBitPerfectCompatible() const {
jiabinc658e452022-10-21 20:52:21 +00002947 Mutex::Autolock _l(mLock);
2948 for (const auto &effect : mEffects) {
2949 if (effect->isProcessImplemented()
2950 && effect->isImplementationSoftware()) {
2951 return false;
2952 }
2953 }
2954 // Allow effects without processing or hw accelerated effects.
2955 return true;
2956}
2957
Eric Laurent4c415062016-06-17 16:14:16 -07002958// isCompatibleWithThread_l() must be called with thread->mLock held
Andy Hung87c693c2023-07-06 20:56:16 -07002959bool EffectChain::isCompatibleWithThread_l(const sp<IAfThreadBase>& thread) const
Eric Laurent4c415062016-06-17 16:14:16 -07002960{
2961 Mutex::Autolock _l(mLock);
2962 for (size_t i = 0; i < mEffects.size(); i++) {
2963 if (thread->checkEffectCompatibility_l(&(mEffects[i]->desc()), mSessionId) != NO_ERROR) {
2964 return false;
2965 }
2966 }
2967 return true;
2968}
2969
Eric Laurent6b446ce2019-12-13 10:56:31 -08002970// EffectCallbackInterface implementation
Andy Hung6ac17eb2023-06-20 18:56:17 -07002971status_t EffectChain::EffectCallback::createEffectHal(
Eric Laurent6b446ce2019-12-13 10:56:31 -08002972 const effect_uuid_t *pEffectUuid, int32_t sessionId, int32_t deviceId,
2973 sp<EffectHalInterface> *effect) {
2974 status_t status = NO_INIT;
Andy Hungba8e52b2023-05-11 14:33:03 -07002975 const sp<EffectsFactoryHalInterface> effectsFactory =
2976 EffectConfiguration::getEffectsFactoryHal();
Eric Laurent6b446ce2019-12-13 10:56:31 -08002977 if (effectsFactory != 0) {
2978 status = effectsFactory->createEffect(pEffectUuid, sessionId, io(), deviceId, effect);
2979 }
2980 return status;
2981}
2982
Andy Hung6ac17eb2023-06-20 18:56:17 -07002983bool EffectChain::EffectCallback::updateOrphanEffectChains(
2984 const sp<IAfEffectBase>& effect) {
Eric Laurent41709552019-12-16 19:34:05 -08002985 // in EffectChain context, an EffectBase is always from an EffectModule so static cast is safe
Andy Hung583043b2023-07-17 17:05:00 -07002986 return mAfThreadCallback->updateOrphanEffectChains(effect->asEffectModule());
Eric Laurent6b446ce2019-12-13 10:56:31 -08002987}
2988
Andy Hung6ac17eb2023-06-20 18:56:17 -07002989status_t EffectChain::EffectCallback::allocateHalBuffer(
Eric Laurent6b446ce2019-12-13 10:56:31 -08002990 size_t size, sp<EffectBufferHalInterface>* buffer) {
Andy Hung583043b2023-07-17 17:05:00 -07002991 return mAfThreadCallback->getEffectsFactoryHal()->allocateBuffer(size, buffer);
Eric Laurent6b446ce2019-12-13 10:56:31 -08002992}
2993
Andy Hung6ac17eb2023-06-20 18:56:17 -07002994status_t EffectChain::EffectCallback::addEffectToHal(
Andy Hung920f6572022-10-06 12:09:49 -07002995 const sp<EffectHalInterface>& effect) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08002996 status_t result = NO_INIT;
Andy Hung87c693c2023-07-06 20:56:16 -07002997 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08002998 if (t == nullptr) {
2999 return result;
3000 }
3001 sp <StreamHalInterface> st = t->stream();
3002 if (st == nullptr) {
3003 return result;
3004 }
3005 result = st->addEffect(effect);
3006 ALOGE_IF(result != OK, "Error when adding effect: %d", result);
3007 return result;
3008}
3009
Andy Hung6ac17eb2023-06-20 18:56:17 -07003010status_t EffectChain::EffectCallback::removeEffectFromHal(
Andy Hung920f6572022-10-06 12:09:49 -07003011 const sp<EffectHalInterface>& effect) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08003012 status_t result = NO_INIT;
Andy Hung87c693c2023-07-06 20:56:16 -07003013 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003014 if (t == nullptr) {
3015 return result;
3016 }
3017 sp <StreamHalInterface> st = t->stream();
3018 if (st == nullptr) {
3019 return result;
3020 }
3021 result = st->removeEffect(effect);
3022 ALOGE_IF(result != OK, "Error when removing effect: %d", result);
3023 return result;
3024}
3025
Andy Hung6ac17eb2023-06-20 18:56:17 -07003026audio_io_handle_t EffectChain::EffectCallback::io() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003027 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003028 if (t == nullptr) {
3029 return AUDIO_IO_HANDLE_NONE;
3030 }
3031 return t->id();
3032}
3033
Andy Hung6ac17eb2023-06-20 18:56:17 -07003034bool EffectChain::EffectCallback::isOutput() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003035 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003036 if (t == nullptr) {
3037 return true;
3038 }
3039 return t->isOutput();
3040}
3041
Andy Hung6ac17eb2023-06-20 18:56:17 -07003042bool EffectChain::EffectCallback::isOffload() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003043 return mThreadType == IAfThreadBase::OFFLOAD;
Eric Laurent6b446ce2019-12-13 10:56:31 -08003044}
3045
Andy Hung6ac17eb2023-06-20 18:56:17 -07003046bool EffectChain::EffectCallback::isOffloadOrDirect() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003047 return mThreadType == IAfThreadBase::OFFLOAD
3048 || mThreadType == IAfThreadBase::DIRECT;
Eric Laurent6b446ce2019-12-13 10:56:31 -08003049}
3050
Andy Hung6ac17eb2023-06-20 18:56:17 -07003051bool EffectChain::EffectCallback::isOffloadOrMmap() const {
Eric Laurentb62d0362021-10-26 17:40:18 +02003052 switch (mThreadType) {
Andy Hung87c693c2023-07-06 20:56:16 -07003053 case IAfThreadBase::OFFLOAD:
3054 case IAfThreadBase::MMAP_PLAYBACK:
3055 case IAfThreadBase::MMAP_CAPTURE:
Eric Laurentb62d0362021-10-26 17:40:18 +02003056 return true;
3057 default:
Eric Laurent6b446ce2019-12-13 10:56:31 -08003058 return false;
3059 }
Eric Laurentb62d0362021-10-26 17:40:18 +02003060}
3061
Andy Hung6ac17eb2023-06-20 18:56:17 -07003062bool EffectChain::EffectCallback::isSpatializer() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003063 return mThreadType == IAfThreadBase::SPATIALIZER;
Eric Laurent6b446ce2019-12-13 10:56:31 -08003064}
3065
Andy Hung6ac17eb2023-06-20 18:56:17 -07003066uint32_t EffectChain::EffectCallback::sampleRate() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003067 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003068 if (t == nullptr) {
3069 return 0;
3070 }
3071 return t->sampleRate();
3072}
3073
Andy Hung6ac17eb2023-06-20 18:56:17 -07003074audio_channel_mask_t EffectChain::EffectCallback::inChannelMask(int id) const {
Andy Hung87c693c2023-07-06 20:56:16 -07003075 const sp<IAfThreadBase> t = thread().promote();
Eric Laurentf1f22e72021-07-13 14:04:14 +02003076 if (t == nullptr) {
3077 return AUDIO_CHANNEL_NONE;
3078 }
Andy Hung6ac17eb2023-06-20 18:56:17 -07003079 sp<IAfEffectChain> c = chain().promote();
Eric Laurentf1f22e72021-07-13 14:04:14 +02003080 if (c == nullptr) {
3081 return AUDIO_CHANNEL_NONE;
3082 }
3083
Andy Hung87c693c2023-07-06 20:56:16 -07003084 if (mThreadType == IAfThreadBase::SPATIALIZER) {
Eric Laurentb62d0362021-10-26 17:40:18 +02003085 if (c->sessionId() == AUDIO_SESSION_OUTPUT_STAGE) {
3086 if (c->isFirstEffect(id)) {
3087 return t->mixerChannelMask();
3088 } else {
3089 return t->channelMask();
3090 }
3091 } else if (!audio_is_global_session(c->sessionId())) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003092 if ((t->hasAudioSession_l(c->sessionId())
Andy Hung87c693c2023-07-06 20:56:16 -07003093 & IAfThreadBase::SPATIALIZED_SESSION) != 0) {
Eric Laurentb62d0362021-10-26 17:40:18 +02003094 return t->mixerChannelMask();
3095 } else {
3096 return t->channelMask();
3097 }
3098 } else {
3099 return t->channelMask();
3100 }
Eric Laurentf1f22e72021-07-13 14:04:14 +02003101 } else {
3102 return t->channelMask();
3103 }
3104}
3105
Andy Hung6ac17eb2023-06-20 18:56:17 -07003106uint32_t EffectChain::EffectCallback::inChannelCount(int id) const {
Eric Laurentb62d0362021-10-26 17:40:18 +02003107 return audio_channel_count_from_out_mask(inChannelMask(id));
Eric Laurentf1f22e72021-07-13 14:04:14 +02003108}
3109
Andy Hung6ac17eb2023-06-20 18:56:17 -07003110audio_channel_mask_t EffectChain::EffectCallback::outChannelMask() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003111 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003112 if (t == nullptr) {
3113 return AUDIO_CHANNEL_NONE;
3114 }
Andy Hung6ac17eb2023-06-20 18:56:17 -07003115 sp<IAfEffectChain> c = chain().promote();
Eric Laurentb62d0362021-10-26 17:40:18 +02003116 if (c == nullptr) {
3117 return AUDIO_CHANNEL_NONE;
3118 }
3119
Andy Hung87c693c2023-07-06 20:56:16 -07003120 if (mThreadType == IAfThreadBase::SPATIALIZER) {
Eric Laurentb62d0362021-10-26 17:40:18 +02003121 if (!audio_is_global_session(c->sessionId())) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003122 if ((t->hasAudioSession_l(c->sessionId())
Andy Hung87c693c2023-07-06 20:56:16 -07003123 & IAfThreadBase::SPATIALIZED_SESSION) != 0) {
Eric Laurentb62d0362021-10-26 17:40:18 +02003124 return t->mixerChannelMask();
3125 } else {
3126 return t->channelMask();
3127 }
3128 } else {
3129 return t->channelMask();
3130 }
3131 } else {
3132 return t->channelMask();
3133 }
Eric Laurent6b446ce2019-12-13 10:56:31 -08003134}
3135
Andy Hung6ac17eb2023-06-20 18:56:17 -07003136uint32_t EffectChain::EffectCallback::outChannelCount() const {
Eric Laurentb62d0362021-10-26 17:40:18 +02003137 return audio_channel_count_from_out_mask(outChannelMask());
Eric Laurent6b446ce2019-12-13 10:56:31 -08003138}
3139
Andy Hung6ac17eb2023-06-20 18:56:17 -07003140audio_channel_mask_t EffectChain::EffectCallback::hapticChannelMask() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003141 const sp<IAfThreadBase> t = thread().promote();
jiabineb3bda02020-06-30 14:07:03 -07003142 if (t == nullptr) {
3143 return AUDIO_CHANNEL_NONE;
3144 }
3145 return t->hapticChannelMask();
3146}
3147
Andy Hung6ac17eb2023-06-20 18:56:17 -07003148size_t EffectChain::EffectCallback::frameCount() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003149 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003150 if (t == nullptr) {
3151 return 0;
3152 }
3153 return t->frameCount();
3154}
3155
Andy Hung6ac17eb2023-06-20 18:56:17 -07003156uint32_t EffectChain::EffectCallback::latency() const
Andy Hung920f6572022-10-06 12:09:49 -07003157NO_THREAD_SAFETY_ANALYSIS // latency_l() access
3158{
Andy Hung87c693c2023-07-06 20:56:16 -07003159 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003160 if (t == nullptr) {
3161 return 0;
3162 }
Andy Hung920f6572022-10-06 12:09:49 -07003163 // TODO(b/275956781) - this requires the thread lock.
Eric Laurent6b446ce2019-12-13 10:56:31 -08003164 return t->latency_l();
3165}
3166
Andy Hung6ac17eb2023-06-20 18:56:17 -07003167void EffectChain::EffectCallback::setVolumeForOutput(float left, float right) const
Andy Hung920f6572022-10-06 12:09:49 -07003168NO_THREAD_SAFETY_ANALYSIS // setVolumeForOutput_l() access
3169{
Andy Hung87c693c2023-07-06 20:56:16 -07003170 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003171 if (t == nullptr) {
3172 return;
3173 }
3174 t->setVolumeForOutput_l(left, right);
3175}
3176
Andy Hung6ac17eb2023-06-20 18:56:17 -07003177void EffectChain::EffectCallback::checkSuspendOnEffectEnabled(
3178 const sp<IAfEffectBase>& effect, bool enabled, bool threadLocked) {
Andy Hung87c693c2023-07-06 20:56:16 -07003179 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003180 if (t == nullptr) {
3181 return;
3182 }
3183 t->checkSuspendOnEffectEnabled(enabled, effect->sessionId(), threadLocked);
3184
Andy Hung6ac17eb2023-06-20 18:56:17 -07003185 sp<IAfEffectChain> c = chain().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003186 if (c == nullptr) {
3187 return;
3188 }
Eric Laurent41709552019-12-16 19:34:05 -08003189 // in EffectChain context, an EffectBase is always from an EffectModule so static cast is safe
3190 c->checkSuspendOnEffectEnabled(effect->asEffectModule(), enabled);
Eric Laurent6b446ce2019-12-13 10:56:31 -08003191}
3192
Andy Hung6ac17eb2023-06-20 18:56:17 -07003193void EffectChain::EffectCallback::onEffectEnable(const sp<IAfEffectBase>& effect) {
Andy Hung87c693c2023-07-06 20:56:16 -07003194 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003195 if (t == nullptr) {
3196 return;
3197 }
Eric Laurent41709552019-12-16 19:34:05 -08003198 // in EffectChain context, an EffectBase is always from an EffectModule so static cast is safe
3199 t->onEffectEnable(effect->asEffectModule());
Eric Laurent6b446ce2019-12-13 10:56:31 -08003200}
3201
Andy Hung6ac17eb2023-06-20 18:56:17 -07003202void EffectChain::EffectCallback::onEffectDisable(const sp<IAfEffectBase>& effect) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08003203 checkSuspendOnEffectEnabled(effect, false, false /*threadLocked*/);
3204
Andy Hung87c693c2023-07-06 20:56:16 -07003205 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003206 if (t == nullptr) {
3207 return;
3208 }
3209 t->onEffectDisable();
3210}
3211
Andy Hung6ac17eb2023-06-20 18:56:17 -07003212bool EffectChain::EffectCallback::disconnectEffectHandle(IAfEffectHandle *handle,
Eric Laurent6b446ce2019-12-13 10:56:31 -08003213 bool unpinIfLast) {
Andy Hung87c693c2023-07-06 20:56:16 -07003214 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003215 if (t == nullptr) {
3216 return false;
3217 }
3218 t->disconnectEffectHandle(handle, unpinIfLast);
3219 return true;
3220}
3221
Andy Hung6ac17eb2023-06-20 18:56:17 -07003222void EffectChain::EffectCallback::resetVolume() {
3223 sp<IAfEffectChain> c = chain().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003224 if (c == nullptr) {
3225 return;
3226 }
3227 c->resetVolume_l();
3228
3229}
3230
Andy Hung6ac17eb2023-06-20 18:56:17 -07003231product_strategy_t EffectChain::EffectCallback::strategy() const {
3232 sp<IAfEffectChain> c = chain().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003233 if (c == nullptr) {
3234 return PRODUCT_STRATEGY_NONE;
3235 }
3236 return c->strategy();
3237}
3238
Andy Hung6ac17eb2023-06-20 18:56:17 -07003239int32_t EffectChain::EffectCallback::activeTrackCnt() const {
3240 sp<IAfEffectChain> c = chain().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003241 if (c == nullptr) {
3242 return 0;
3243 }
3244 return c->activeTrackCnt();
3245}
3246
Eric Laurentb82e6b72019-11-22 17:25:04 -08003247
3248#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -07003249#define LOG_TAG "DeviceEffectProxy"
Eric Laurentb82e6b72019-11-22 17:25:04 -08003250
Andy Hung6ac17eb2023-06-20 18:56:17 -07003251/* static */
3252sp<IAfDeviceEffectProxy> IAfDeviceEffectProxy::create(
3253 const AudioDeviceTypeAddr& device,
Andy Hung55a74fd2023-07-13 19:54:47 -07003254 const sp<DeviceEffectManagerCallback>& callback,
Andy Hung6ac17eb2023-06-20 18:56:17 -07003255 effect_descriptor_t *desc, int id, bool notifyFramesProcessed)
3256{
3257 return sp<DeviceEffectProxy>::make(device,
Andy Hung55a74fd2023-07-13 19:54:47 -07003258 callback,
Andy Hung6ac17eb2023-06-20 18:56:17 -07003259 desc, id, notifyFramesProcessed);
3260}
3261
3262status_t DeviceEffectProxy::setEnabled(bool enabled, bool fromHandle)
Eric Laurentb82e6b72019-11-22 17:25:04 -08003263{
3264 status_t status = EffectBase::setEnabled(enabled, fromHandle);
3265 Mutex::Autolock _l(mProxyLock);
3266 if (status == NO_ERROR) {
3267 for (auto& handle : mEffectHandles) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07003268 Status bs;
Eric Laurentb82e6b72019-11-22 17:25:04 -08003269 if (enabled) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003270 bs = handle.second->asIEffect()->enable(&status);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003271 } else {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003272 bs = handle.second->asIEffect()->disable(&status);
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07003273 }
3274 if (!bs.isOk()) {
Andy Hung1131b6e2020-12-08 20:47:45 -08003275 status = statusTFromBinderStatus(bs);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003276 }
3277 }
3278 }
3279 ALOGV("%s enable %d status %d", __func__, enabled, status);
3280 return status;
3281}
3282
Andy Hung6ac17eb2023-06-20 18:56:17 -07003283status_t DeviceEffectProxy::init(
Andy Hung8e6b62a2023-07-13 18:11:33 -07003284 const std::map <audio_patch_handle_t, IAfPatchPanel::Patch>& patches) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003285//For all audio patches
3286//If src or sink device match
3287//If the effect is HW accelerated
3288// if no corresponding effect module
3289// Create EffectModule: mHalEffect
3290//Create and attach EffectHandle
3291//If the effect is not HW accelerated and the patch sink or src is a mixer port
3292// Create Effect on patch input or output thread on session -1
3293//Add EffectHandle to EffectHandle map of Effect Proxy:
3294 ALOGV("%s device type %d address %s", __func__, mDevice.mType, mDevice.getAddress());
3295 status_t status = NO_ERROR;
3296 for (auto &patch : patches) {
3297 status = onCreatePatch(patch.first, patch.second);
3298 ALOGV("%s onCreatePatch status %d", __func__, status);
3299 if (status == BAD_VALUE) {
3300 return status;
3301 }
3302 }
3303 return status;
3304}
3305
François Gaffie58e73af2023-02-15 11:47:24 +01003306status_t DeviceEffectProxy::onUpdatePatch(audio_patch_handle_t oldPatchHandle,
3307 audio_patch_handle_t newPatchHandle,
Andy Hung8e6b62a2023-07-13 18:11:33 -07003308 const IAfPatchPanel::Patch& /* patch */) {
François Gaffie58e73af2023-02-15 11:47:24 +01003309 status_t status = NAME_NOT_FOUND;
3310 ALOGV("%s", __func__);
3311 Mutex::Autolock _l(mProxyLock);
3312 if (mEffectHandles.find(oldPatchHandle) != mEffectHandles.end()) {
3313 ALOGV("%s replacing effect from handle %d to handle %d", __func__, oldPatchHandle,
3314 newPatchHandle);
3315 sp<IAfEffectHandle> effect = mEffectHandles.at(oldPatchHandle);
3316 mEffectHandles.erase(oldPatchHandle);
3317 mEffectHandles.emplace(newPatchHandle, effect);
3318 status = NO_ERROR;
3319 }
3320 return status;
3321}
3322
Andy Hung6ac17eb2023-06-20 18:56:17 -07003323status_t DeviceEffectProxy::onCreatePatch(
Andy Hung8e6b62a2023-07-13 18:11:33 -07003324 audio_patch_handle_t patchHandle, const IAfPatchPanel::Patch& patch) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003325 status_t status = NAME_NOT_FOUND;
Andy Hung6ac17eb2023-06-20 18:56:17 -07003326 sp<IAfEffectHandle> handle;
Eric Laurentb82e6b72019-11-22 17:25:04 -08003327 // only consider source[0] as this is the only "true" source of a patch
3328 status = checkPort(patch, &patch.mAudioPatch.sources[0], &handle);
3329 ALOGV("%s source checkPort status %d", __func__, status);
3330 for (uint32_t i = 0; i < patch.mAudioPatch.num_sinks && status == NAME_NOT_FOUND; i++) {
3331 status = checkPort(patch, &patch.mAudioPatch.sinks[i], &handle);
3332 ALOGV("%s sink %d checkPort status %d", __func__, i, status);
3333 }
3334 if (status == NO_ERROR || status == ALREADY_EXISTS) {
3335 Mutex::Autolock _l(mProxyLock);
François Gaffie70c6c722023-06-22 12:23:32 +02003336 size_t erasedHandle = mEffectHandles.erase(patchHandle);
3337 ALOGV("%s %s effecthandle %p for patch %d",
3338 __func__, (erasedHandle == 0 ? "adding" : "replacing"), handle.get(), patchHandle);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003339 mEffectHandles.emplace(patchHandle, handle);
3340 }
3341 ALOGW_IF(status == BAD_VALUE,
3342 "%s cannot attach effect %s on patch %d", __func__, mDescriptor.name, patchHandle);
3343
3344 return status;
3345}
3346
Andy Hung8e6b62a2023-07-13 18:11:33 -07003347status_t DeviceEffectProxy::checkPort(const IAfPatchPanel::Patch& patch,
Andy Hung6ac17eb2023-06-20 18:56:17 -07003348 const struct audio_port_config *port, sp<IAfEffectHandle> *handle) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003349
3350 ALOGV("%s type %d device type %d address %s device ID %d patch.isSoftware() %d",
3351 __func__, port->type, port->ext.device.type,
3352 port->ext.device.address, port->id, patch.isSoftware());
Shunkai Yaob009ad52023-05-05 22:43:24 +00003353 if (port->type != AUDIO_PORT_TYPE_DEVICE || port->ext.device.type != mDevice.mType ||
3354 port->ext.device.address != mDevice.address()) {
3355 return NAME_NOT_FOUND;
3356 }
3357 if (((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_POST_PROC) &&
3358 (audio_port_config_has_input_direction(port))) {
3359 ALOGI("%s don't create postprocessing effect on record port", __func__);
3360 return NAME_NOT_FOUND;
3361 }
3362 if (((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_PRE_PROC) &&
3363 (!audio_port_config_has_input_direction(port))) {
3364 ALOGI("%s don't create preprocessing effect on playback port", __func__);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003365 return NAME_NOT_FOUND;
3366 }
3367 status_t status = NAME_NOT_FOUND;
3368
3369 if (mDescriptor.flags & EFFECT_FLAG_HW_ACC_TUNNEL) {
3370 Mutex::Autolock _l(mProxyLock);
François Gaffie70c6c722023-06-22 12:23:32 +02003371 if (mHalEffect != nullptr && mDevicePort.id == port->id) {
3372 ALOGV("%s reusing HAL effect", __func__);
3373 } else {
3374 mDevicePort = *port;
3375 mHalEffect = new EffectModule(mMyCallback,
Eric Laurentb82e6b72019-11-22 17:25:04 -08003376 const_cast<effect_descriptor_t *>(&mDescriptor),
3377 mMyCallback->newEffectId(), AUDIO_SESSION_DEVICE,
3378 false /* pinned */, port->id);
François Gaffie70c6c722023-06-22 12:23:32 +02003379 if (audio_is_input_device(mDevice.mType)) {
3380 mHalEffect->setInputDevice(mDevice);
3381 } else {
3382 mHalEffect->setDevices({mDevice});
3383 }
3384 mHalEffect->configure();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003385 }
Eric Laurentde8caf42021-08-11 17:19:25 +02003386 *handle = new EffectHandle(mHalEffect, nullptr, nullptr, 0 /*priority*/,
3387 mNotifyFramesProcessed);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003388 status = (*handle)->initCheck();
3389 if (status == OK) {
3390 status = mHalEffect->addHandle((*handle).get());
3391 } else {
3392 mHalEffect.clear();
3393 mDevicePort.id = AUDIO_PORT_HANDLE_NONE;
3394 }
3395 } else if (patch.isSoftware() || patch.thread().promote() != nullptr) {
Andy Hung87c693c2023-07-06 20:56:16 -07003396 sp<IAfThreadBase> thread;
Eric Laurentb82e6b72019-11-22 17:25:04 -08003397 if (audio_port_config_has_input_direction(port)) {
3398 if (patch.isSoftware()) {
3399 thread = patch.mRecord.thread();
3400 } else {
3401 thread = patch.thread().promote();
3402 }
3403 } else {
3404 if (patch.isSoftware()) {
3405 thread = patch.mPlayback.thread();
3406 } else {
3407 thread = patch.thread().promote();
3408 }
3409 }
3410 int enabled;
3411 *handle = thread->createEffect_l(nullptr, nullptr, 0, AUDIO_SESSION_DEVICE,
3412 const_cast<effect_descriptor_t *>(&mDescriptor),
Eric Laurentde8caf42021-08-11 17:19:25 +02003413 &enabled, &status, false, false /*probe*/,
3414 mNotifyFramesProcessed);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003415 ALOGV("%s thread->createEffect_l status %d", __func__, status);
3416 } else {
3417 status = BAD_VALUE;
3418 }
Shunkai Yaob009ad52023-05-05 22:43:24 +00003419
Eric Laurentb82e6b72019-11-22 17:25:04 -08003420 if (status == NO_ERROR || status == ALREADY_EXISTS) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07003421 Status bs;
Eric Laurentb82e6b72019-11-22 17:25:04 -08003422 if (isEnabled()) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003423 bs = (*handle)->asIEffect()->enable(&status);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003424 } else {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003425 bs = (*handle)->asIEffect()->disable(&status);
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07003426 }
3427 if (!bs.isOk()) {
Andy Hung1131b6e2020-12-08 20:47:45 -08003428 status = statusTFromBinderStatus(bs);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003429 }
3430 }
3431 return status;
3432}
3433
Andy Hung6ac17eb2023-06-20 18:56:17 -07003434void DeviceEffectProxy::onReleasePatch(audio_patch_handle_t patchHandle) {
3435 sp<IAfEffectHandle> effect;
Eric Laurent76c89f32021-12-03 17:13:23 +01003436 {
3437 Mutex::Autolock _l(mProxyLock);
3438 if (mEffectHandles.find(patchHandle) != mEffectHandles.end()) {
3439 effect = mEffectHandles.at(patchHandle);
3440 mEffectHandles.erase(patchHandle);
3441 }
3442 }
Eric Laurentb82e6b72019-11-22 17:25:04 -08003443}
3444
3445
Andy Hung6ac17eb2023-06-20 18:56:17 -07003446size_t DeviceEffectProxy::removeEffect(const sp<IAfEffectModule>& effect)
Eric Laurentb82e6b72019-11-22 17:25:04 -08003447{
3448 Mutex::Autolock _l(mProxyLock);
3449 if (effect == mHalEffect) {
Eric Laurent76c89f32021-12-03 17:13:23 +01003450 mHalEffect->release_l();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003451 mHalEffect.clear();
3452 mDevicePort.id = AUDIO_PORT_HANDLE_NONE;
3453 }
3454 return mHalEffect == nullptr ? 0 : 1;
3455}
3456
Andy Hung6ac17eb2023-06-20 18:56:17 -07003457status_t DeviceEffectProxy::addEffectToHal(
Andy Hung920f6572022-10-06 12:09:49 -07003458 const sp<EffectHalInterface>& effect) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003459 if (mHalEffect == nullptr) {
3460 return NO_INIT;
3461 }
Mikhail Naganovd2c7f852023-06-14 18:00:13 -07003462 return mManagerCallback->addEffectToHal(&mDevicePort, effect);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003463}
3464
Andy Hung6ac17eb2023-06-20 18:56:17 -07003465status_t DeviceEffectProxy::removeEffectFromHal(
Andy Hung920f6572022-10-06 12:09:49 -07003466 const sp<EffectHalInterface>& effect) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003467 if (mHalEffect == nullptr) {
3468 return NO_INIT;
3469 }
Mikhail Naganovd2c7f852023-06-14 18:00:13 -07003470 return mManagerCallback->removeEffectFromHal(&mDevicePort, effect);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003471}
3472
François Gaffiea2e985b2023-06-09 14:37:56 +02003473status_t DeviceEffectProxy::command(
3474 int32_t cmdCode, const std::vector<uint8_t>& cmdData, int32_t maxReplySize,
3475 std::vector<uint8_t>* reply) {
3476 Mutex::Autolock _l(mProxyLock);
3477 status_t status = EffectBase::command(cmdCode, cmdData, maxReplySize, reply);
3478 if (status == NO_ERROR) {
3479 for (auto& handle : mEffectHandles) {
3480 sp<IAfEffectBase> effect = handle.second->effect().promote();
3481 if (effect != nullptr) {
3482 status = effect->command(cmdCode, cmdData, maxReplySize, reply);
3483 }
3484 }
3485 }
3486 ALOGV("%s status %d", __func__, status);
3487 return status;
3488}
3489
Andy Hung6ac17eb2023-06-20 18:56:17 -07003490bool DeviceEffectProxy::isOutput() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003491 if (mDevicePort.id != AUDIO_PORT_HANDLE_NONE) {
3492 return mDevicePort.role == AUDIO_PORT_ROLE_SINK;
3493 }
3494 return true;
3495}
3496
Andy Hung6ac17eb2023-06-20 18:56:17 -07003497uint32_t DeviceEffectProxy::sampleRate() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003498 if (mDevicePort.id != AUDIO_PORT_HANDLE_NONE &&
3499 (mDevicePort.config_mask & AUDIO_PORT_CONFIG_SAMPLE_RATE) != 0) {
3500 return mDevicePort.sample_rate;
3501 }
3502 return DEFAULT_OUTPUT_SAMPLE_RATE;
3503}
3504
Andy Hung6ac17eb2023-06-20 18:56:17 -07003505audio_channel_mask_t DeviceEffectProxy::channelMask() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003506 if (mDevicePort.id != AUDIO_PORT_HANDLE_NONE &&
3507 (mDevicePort.config_mask & AUDIO_PORT_CONFIG_CHANNEL_MASK) != 0) {
3508 return mDevicePort.channel_mask;
3509 }
3510 return AUDIO_CHANNEL_OUT_STEREO;
3511}
3512
Andy Hung6ac17eb2023-06-20 18:56:17 -07003513uint32_t DeviceEffectProxy::channelCount() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003514 if (isOutput()) {
3515 return audio_channel_count_from_out_mask(channelMask());
3516 }
3517 return audio_channel_count_from_in_mask(channelMask());
3518}
3519
Andy Hung6ac17eb2023-06-20 18:56:17 -07003520void DeviceEffectProxy::dump2(int fd, int spaces) const
Andy Hung920f6572022-10-06 12:09:49 -07003521NO_THREAD_SAFETY_ANALYSIS // conditional try lock
3522{
Eric Laurentb82e6b72019-11-22 17:25:04 -08003523 const Vector<String16> args;
3524 EffectBase::dump(fd, args);
3525
Andy Hung0a51b5c2023-07-18 20:54:44 -07003526 const bool locked = afutils::dumpTryLock(mProxyLock);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003527 if (!locked) {
3528 String8 result("DeviceEffectProxy may be deadlocked\n");
3529 write(fd, result.string(), result.size());
3530 }
3531
3532 String8 outStr;
3533 if (mHalEffect != nullptr) {
3534 outStr.appendFormat("%*sHAL Effect Id: %d\n", spaces, "", mHalEffect->id());
3535 } else {
3536 outStr.appendFormat("%*sNO HAL Effect\n", spaces, "");
3537 }
3538 write(fd, outStr.string(), outStr.size());
3539 outStr.clear();
3540
3541 outStr.appendFormat("%*sSub Effects:\n", spaces, "");
3542 write(fd, outStr.string(), outStr.size());
3543 outStr.clear();
3544
3545 for (const auto& iter : mEffectHandles) {
3546 outStr.appendFormat("%*sEffect for patch handle %d:\n", spaces + 2, "", iter.first);
3547 write(fd, outStr.string(), outStr.size());
3548 outStr.clear();
Andy Hung6ac17eb2023-06-20 18:56:17 -07003549 sp<IAfEffectBase> effect = iter.second->effect().promote();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003550 if (effect != nullptr) {
3551 effect->dump(fd, args);
3552 }
3553 }
3554
3555 if (locked) {
François Gaffiefcf15bf2023-02-15 11:37:43 +01003556 mProxyLock.unlock();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003557 }
3558}
3559
3560#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -07003561#define LOG_TAG "DeviceEffectProxy::ProxyCallback"
Eric Laurentb82e6b72019-11-22 17:25:04 -08003562
Andy Hung6ac17eb2023-06-20 18:56:17 -07003563int DeviceEffectProxy::ProxyCallback::newEffectId() {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003564 return mManagerCallback->newEffectId();
3565}
3566
3567
Andy Hung6ac17eb2023-06-20 18:56:17 -07003568bool DeviceEffectProxy::ProxyCallback::disconnectEffectHandle(
3569 IAfEffectHandle *handle, bool unpinIfLast) {
3570 sp<IAfEffectBase> effectBase = handle->effect().promote();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003571 if (effectBase == nullptr) {
3572 return false;
3573 }
3574
Andy Hung6ac17eb2023-06-20 18:56:17 -07003575 sp<IAfEffectModule> effect = effectBase->asEffectModule();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003576 if (effect == nullptr) {
3577 return false;
3578 }
3579
3580 // restore suspended effects if the disconnected handle was enabled and the last one.
3581 bool remove = (effect->removeHandle(handle) == 0) && (!effect->isPinned() || unpinIfLast);
3582 if (remove) {
3583 sp<DeviceEffectProxy> proxy = mProxy.promote();
3584 if (proxy != nullptr) {
3585 proxy->removeEffect(effect);
3586 }
3587 if (handle->enabled()) {
3588 effectBase->checkSuspendOnEffectEnabled(false, false /*threadLocked*/);
3589 }
3590 }
3591 return true;
3592}
3593
Andy Hung6ac17eb2023-06-20 18:56:17 -07003594status_t DeviceEffectProxy::ProxyCallback::createEffectHal(
Eric Laurentb82e6b72019-11-22 17:25:04 -08003595 const effect_uuid_t *pEffectUuid, int32_t sessionId, int32_t deviceId,
3596 sp<EffectHalInterface> *effect) {
3597 return mManagerCallback->createEffectHal(pEffectUuid, sessionId, deviceId, effect);
3598}
3599
Andy Hung6ac17eb2023-06-20 18:56:17 -07003600status_t DeviceEffectProxy::ProxyCallback::addEffectToHal(
Andy Hung920f6572022-10-06 12:09:49 -07003601 const sp<EffectHalInterface>& effect) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003602 sp<DeviceEffectProxy> proxy = mProxy.promote();
3603 if (proxy == nullptr) {
3604 return NO_INIT;
3605 }
3606 return proxy->addEffectToHal(effect);
3607}
3608
Andy Hung6ac17eb2023-06-20 18:56:17 -07003609status_t DeviceEffectProxy::ProxyCallback::removeEffectFromHal(
Andy Hung920f6572022-10-06 12:09:49 -07003610 const sp<EffectHalInterface>& effect) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003611 sp<DeviceEffectProxy> proxy = mProxy.promote();
3612 if (proxy == nullptr) {
3613 return NO_INIT;
3614 }
Eric Laurent76c89f32021-12-03 17:13:23 +01003615 return proxy->removeEffectFromHal(effect);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003616}
3617
Andy Hung6ac17eb2023-06-20 18:56:17 -07003618bool DeviceEffectProxy::ProxyCallback::isOutput() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003619 sp<DeviceEffectProxy> proxy = mProxy.promote();
3620 if (proxy == nullptr) {
3621 return true;
3622 }
3623 return proxy->isOutput();
3624}
3625
Andy Hung6ac17eb2023-06-20 18:56:17 -07003626uint32_t DeviceEffectProxy::ProxyCallback::sampleRate() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003627 sp<DeviceEffectProxy> proxy = mProxy.promote();
3628 if (proxy == nullptr) {
3629 return DEFAULT_OUTPUT_SAMPLE_RATE;
3630 }
3631 return proxy->sampleRate();
3632}
3633
Andy Hung6ac17eb2023-06-20 18:56:17 -07003634audio_channel_mask_t DeviceEffectProxy::ProxyCallback::inChannelMask(
Eric Laurentf1f22e72021-07-13 14:04:14 +02003635 int id __unused) const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003636 sp<DeviceEffectProxy> proxy = mProxy.promote();
3637 if (proxy == nullptr) {
3638 return AUDIO_CHANNEL_OUT_STEREO;
3639 }
3640 return proxy->channelMask();
3641}
3642
Andy Hung6ac17eb2023-06-20 18:56:17 -07003643uint32_t DeviceEffectProxy::ProxyCallback::inChannelCount(int id __unused) const {
Eric Laurentf1f22e72021-07-13 14:04:14 +02003644 sp<DeviceEffectProxy> proxy = mProxy.promote();
3645 if (proxy == nullptr) {
3646 return 2;
3647 }
3648 return proxy->channelCount();
3649}
3650
Andy Hung6ac17eb2023-06-20 18:56:17 -07003651audio_channel_mask_t DeviceEffectProxy::ProxyCallback::outChannelMask() const {
Eric Laurentf1f22e72021-07-13 14:04:14 +02003652 sp<DeviceEffectProxy> proxy = mProxy.promote();
3653 if (proxy == nullptr) {
3654 return AUDIO_CHANNEL_OUT_STEREO;
3655 }
3656 return proxy->channelMask();
3657}
3658
Andy Hung6ac17eb2023-06-20 18:56:17 -07003659uint32_t DeviceEffectProxy::ProxyCallback::outChannelCount() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003660 sp<DeviceEffectProxy> proxy = mProxy.promote();
3661 if (proxy == nullptr) {
3662 return 2;
3663 }
3664 return proxy->channelCount();
3665}
3666
Andy Hung6ac17eb2023-06-20 18:56:17 -07003667void DeviceEffectProxy::ProxyCallback::onEffectEnable(
3668 const sp<IAfEffectBase>& effectBase) {
3669 sp<IAfEffectModule> effect = effectBase->asEffectModule();
Eric Laurent76c89f32021-12-03 17:13:23 +01003670 if (effect == nullptr) {
3671 return;
3672 }
3673 effect->start();
3674}
3675
Andy Hung6ac17eb2023-06-20 18:56:17 -07003676void DeviceEffectProxy::ProxyCallback::onEffectDisable(
3677 const sp<IAfEffectBase>& effectBase) {
3678 sp<IAfEffectModule> effect = effectBase->asEffectModule();
Eric Laurent76c89f32021-12-03 17:13:23 +01003679 if (effect == nullptr) {
3680 return;
3681 }
3682 effect->stop();
3683}
3684
Glenn Kasten63238ef2015-03-02 15:50:29 -08003685} // namespace android