blob: c3e1fbaebd3a245ce85bcc7529b3bcdf75eeb62b [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
Andy Hung5fd10da2023-07-19 11:31:15 -070022#include "Effects.h"
rago94a1ee82017-07-21 15:11:02 -070023
Andy Hung5fd10da2023-07-19 11:31:15 -070024#include "Client.h"
25#include "EffectConfiguration.h"
26
27#include <afutils/DumpTryLock.h>
28#include <audio_utils/channels.h>
29#include <audio_utils/primitives.h>
30#include <media/AudioCommonTypes.h>
31#include <media/AudioContainers.h>
32#include <media/AudioDeviceTypeAddr.h>
33#include <media/AudioEffect.h>
34#include <media/ShmemCompat.h>
35#include <media/TypeConverter.h>
36#include <media/audiohal/EffectHalInterface.h>
37#include <media/audiohal/EffectsFactoryHalInterface.h>
38#include <mediautils/MethodStatistics.h>
39#include <mediautils/ServiceUtilities.h>
40#include <mediautils/TimeCheck.h>
Eric Laurentd8365c52017-07-16 15:27:05 -070041#include <system/audio_effects/effect_aec.h>
Eric Laurentb62d0362021-10-26 17:40:18 +020042#include <system/audio_effects/effect_downmix.h>
Ricardo Garciac2a3a822019-07-17 14:29:12 -070043#include <system/audio_effects/effect_dynamicsprocessing.h>
jiabineb3bda02020-06-30 14:07:03 -070044#include <system/audio_effects/effect_hapticgenerator.h>
Eric Laurentd8365c52017-07-16 15:27:05 -070045#include <system/audio_effects/effect_ns.h>
Eric Laurentb62d0362021-10-26 17:40:18 +020046#include <system/audio_effects/effect_spatializer.h>
Eric Laurentd8365c52017-07-16 15:27:05 -070047#include <system/audio_effects/effect_visualizer.h>
Andy Hung5fd10da2023-07-19 11:31:15 -070048#include <utils/Log.h>
Eric Laurentca7cc822012-11-19 14:55:58 -080049
Andy Hung5fd10da2023-07-19 11:31:15 -070050#include <algorithm>
Eric Laurentca7cc822012-11-19 14:55:58 -080051
52// ----------------------------------------------------------------------------
53
54// Note: the following macro is used for extremely verbose logging message. In
55// order to run with ALOG_ASSERT turned on, we need to have LOG_NDEBUG set to
56// 0; but one side effect of this is to turn all LOGV's as well. Some messages
57// are so verbose that we want to suppress them even when we have ALOG_ASSERT
58// turned on. Do not uncomment the #def below unless you really know what you
59// are doing and want to see all of the extremely verbose messages.
60//#define VERY_VERY_VERBOSE_LOGGING
61#ifdef VERY_VERY_VERBOSE_LOGGING
62#define ALOGVV ALOGV
63#else
64#define ALOGVV(a...) do { } while(0)
65#endif
66
Yuuki Yokoyamae17f8312017-05-26 19:06:33 +090067#define DEFAULT_OUTPUT_SAMPLE_RATE 48000
68
Eric Laurentca7cc822012-11-19 14:55:58 -080069namespace android {
70
Andy Hung1131b6e2020-12-08 20:47:45 -080071using aidl_utils::statusTFromBinderStatus;
Andy Hungba8e52b2023-05-11 14:33:03 -070072using audioflinger::EffectConfiguration;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -070073using binder::Status;
74
75namespace {
76
77// Append a POD value into a vector of bytes.
78template<typename T>
79void appendToBuffer(const T& value, std::vector<uint8_t>* buffer) {
80 const uint8_t* ar(reinterpret_cast<const uint8_t*>(&value));
81 buffer->insert(buffer->end(), ar, ar + sizeof(T));
82}
83
84// Write a POD value into a vector of bytes (clears the previous buffer
85// content).
86template<typename T>
87void writeToBuffer(const T& value, std::vector<uint8_t>* buffer) {
88 buffer->clear();
89 appendToBuffer(value, buffer);
90}
91
92} // namespace
93
Eric Laurentca7cc822012-11-19 14:55:58 -080094// ----------------------------------------------------------------------------
Eric Laurent41709552019-12-16 19:34:05 -080095// EffectBase implementation
Eric Laurentca7cc822012-11-19 14:55:58 -080096// ----------------------------------------------------------------------------
97
98#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -070099#define LOG_TAG "EffectBase"
Eric Laurentca7cc822012-11-19 14:55:58 -0800100
Andy Hung6ac17eb2023-06-20 18:56:17 -0700101EffectBase::EffectBase(const sp<EffectCallbackInterface>& callback,
Eric Laurentca7cc822012-11-19 14:55:58 -0800102 effect_descriptor_t *desc,
103 int id,
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800104 audio_session_t sessionId,
105 bool pinned)
106 : mPinned(pinned),
Eric Laurent6b446ce2019-12-13 10:56:31 -0800107 mCallback(callback), mId(id), mSessionId(sessionId),
Eric Laurent41709552019-12-16 19:34:05 -0800108 mDescriptor(*desc)
Eric Laurentca7cc822012-11-19 14:55:58 -0800109{
Eric Laurentca7cc822012-11-19 14:55:58 -0800110}
111
Eric Laurent41709552019-12-16 19:34:05 -0800112// must be called with EffectModule::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -0700113status_t EffectBase::setEnabled_l(bool enabled)
Eric Laurentca7cc822012-11-19 14:55:58 -0800114{
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800115
Eric Laurent41709552019-12-16 19:34:05 -0800116 ALOGV("setEnabled %p enabled %d", this, enabled);
117
118 if (enabled != isEnabled()) {
119 switch (mState) {
120 // going from disabled to enabled
121 case IDLE:
122 mState = STARTING;
123 break;
124 case STOPPED:
125 mState = RESTART;
126 break;
127 case STOPPING:
128 mState = ACTIVE;
129 break;
130
131 // going from enabled to disabled
132 case RESTART:
133 mState = STOPPED;
134 break;
135 case STARTING:
136 mState = IDLE;
137 break;
138 case ACTIVE:
139 mState = STOPPING;
140 break;
141 case DESTROYED:
142 return NO_ERROR; // simply ignore as we are being destroyed
143 }
144 for (size_t i = 1; i < mHandles.size(); i++) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700145 IAfEffectHandle *h = mHandles[i];
Eric Laurent41709552019-12-16 19:34:05 -0800146 if (h != NULL && !h->disconnected()) {
147 h->setEnabled(enabled);
148 }
149 }
150 }
151 return NO_ERROR;
Eric Laurentca7cc822012-11-19 14:55:58 -0800152}
153
Andy Hung6ac17eb2023-06-20 18:56:17 -0700154status_t EffectBase::setEnabled(bool enabled, bool fromHandle)
Eric Laurent41709552019-12-16 19:34:05 -0800155{
156 status_t status;
157 {
158 Mutex::Autolock _l(mLock);
159 status = setEnabled_l(enabled);
160 }
161 if (fromHandle) {
162 if (enabled) {
163 if (status != NO_ERROR) {
Andy Hungfda44002021-06-03 17:23:16 -0700164 getCallback()->checkSuspendOnEffectEnabled(this, false, false /*threadLocked*/);
Eric Laurent41709552019-12-16 19:34:05 -0800165 } else {
Andy Hungfda44002021-06-03 17:23:16 -0700166 getCallback()->onEffectEnable(this);
Eric Laurent41709552019-12-16 19:34:05 -0800167 }
168 } else {
Andy Hungfda44002021-06-03 17:23:16 -0700169 getCallback()->onEffectDisable(this);
Eric Laurent41709552019-12-16 19:34:05 -0800170 }
171 }
172 return status;
173}
174
Andy Hung6ac17eb2023-06-20 18:56:17 -0700175bool EffectBase::isEnabled() const
Eric Laurent41709552019-12-16 19:34:05 -0800176{
177 switch (mState) {
178 case RESTART:
179 case STARTING:
180 case ACTIVE:
181 return true;
182 case IDLE:
183 case STOPPING:
184 case STOPPED:
185 case DESTROYED:
186 default:
187 return false;
188 }
189}
190
Andy Hung6ac17eb2023-06-20 18:56:17 -0700191void EffectBase::setSuspended(bool suspended)
Eric Laurent41709552019-12-16 19:34:05 -0800192{
193 Mutex::Autolock _l(mLock);
194 mSuspended = suspended;
195}
196
Andy Hung6ac17eb2023-06-20 18:56:17 -0700197bool EffectBase::suspended() const
Eric Laurent41709552019-12-16 19:34:05 -0800198{
199 Mutex::Autolock _l(mLock);
200 return mSuspended;
201}
202
Andy Hung6ac17eb2023-06-20 18:56:17 -0700203status_t EffectBase::addHandle(IAfEffectHandle *handle)
Eric Laurentca7cc822012-11-19 14:55:58 -0800204{
205 status_t status;
206
207 Mutex::Autolock _l(mLock);
208 int priority = handle->priority();
209 size_t size = mHandles.size();
Andy Hung6ac17eb2023-06-20 18:56:17 -0700210 IAfEffectHandle *controlHandle = nullptr;
Eric Laurentca7cc822012-11-19 14:55:58 -0800211 size_t i;
212 for (i = 0; i < size; i++) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700213 IAfEffectHandle *h = mHandles[i];
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800214 if (h == NULL || h->disconnected()) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800215 continue;
216 }
217 // first non destroyed handle is considered in control
Glenn Kasten6e2ebe92013-08-13 09:14:51 -0700218 if (controlHandle == NULL) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800219 controlHandle = h;
Glenn Kasten6e2ebe92013-08-13 09:14:51 -0700220 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800221 if (h->priority() <= priority) {
222 break;
223 }
224 }
225 // if inserted in first place, move effect control from previous owner to this handle
226 if (i == 0) {
227 bool enabled = false;
228 if (controlHandle != NULL) {
229 enabled = controlHandle->enabled();
230 controlHandle->setControl(false/*hasControl*/, true /*signal*/, enabled /*enabled*/);
231 }
232 handle->setControl(true /*hasControl*/, false /*signal*/, enabled /*enabled*/);
233 status = NO_ERROR;
234 } else {
235 status = ALREADY_EXISTS;
236 }
Glenn Kastenc42e9b42016-03-21 11:35:03 -0700237 ALOGV("addHandle() %p added handle %p in position %zu", this, handle, i);
Eric Laurentca7cc822012-11-19 14:55:58 -0800238 mHandles.insertAt(handle, i);
239 return status;
240}
241
Andy Hung6ac17eb2023-06-20 18:56:17 -0700242status_t EffectBase::updatePolicyState()
Eric Laurent6c796322019-04-09 14:13:17 -0700243{
244 status_t status = NO_ERROR;
245 bool doRegister = false;
246 bool registered = false;
247 bool doEnable = false;
248 bool enabled = false;
Mikhail Naganov379d6872020-03-26 13:04:11 -0700249 audio_io_handle_t io = AUDIO_IO_HANDLE_NONE;
Ytai Ben-Tsvi0a4904a2021-01-06 12:57:05 -0800250 product_strategy_t strategy = PRODUCT_STRATEGY_NONE;
Eric Laurent6c796322019-04-09 14:13:17 -0700251
252 {
253 Mutex::Autolock _l(mLock);
Eric Laurentd66d7a12021-07-13 13:35:32 +0200254
255 if ((isInternal_l() && !mPolicyRegistered)
256 || !getCallback()->isAudioPolicyReady()) {
257 return NO_ERROR;
258 }
259
Eric Laurent6c796322019-04-09 14:13:17 -0700260 // register effect when first handle is attached and unregister when last handle is removed
261 if (mPolicyRegistered != mHandles.size() > 0) {
262 doRegister = true;
263 mPolicyRegistered = mHandles.size() > 0;
264 if (mPolicyRegistered) {
Andy Hungfda44002021-06-03 17:23:16 -0700265 const auto callback = getCallback();
266 io = callback->io();
267 strategy = callback->strategy();
Eric Laurent6c796322019-04-09 14:13:17 -0700268 }
269 }
270 // enable effect when registered according to enable state requested by controlling handle
271 if (mHandles.size() > 0) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700272 IAfEffectHandle *handle = controlHandle_l();
Eric Laurent6c796322019-04-09 14:13:17 -0700273 if (handle != nullptr && mPolicyEnabled != handle->enabled()) {
274 doEnable = true;
275 mPolicyEnabled = handle->enabled();
276 }
277 }
278 registered = mPolicyRegistered;
279 enabled = mPolicyEnabled;
Eric Laurentb9d06642021-03-18 15:52:11 +0100280 // The simultaneous release of two EffectHandles with the same EffectModule
281 // may cause us to call this method at the same time.
282 // This may deadlock under some circumstances (b/180941720). Avoid this.
283 if (!doRegister && !(registered && doEnable)) {
284 return NO_ERROR;
285 }
Eric Laurent6c796322019-04-09 14:13:17 -0700286 }
fengjnlan46407562022-09-07 16:20:01 +0800287 mPolicyLock.lock();
Eric Laurent6c796322019-04-09 14:13:17 -0700288 ALOGV("%s name %s id %d session %d doRegister %d registered %d doEnable %d enabled %d",
289 __func__, mDescriptor.name, mId, mSessionId, doRegister, registered, doEnable, enabled);
290 if (doRegister) {
291 if (registered) {
292 status = AudioSystem::registerEffect(
293 &mDescriptor,
294 io,
295 strategy,
296 mSessionId,
297 mId);
298 } else {
299 status = AudioSystem::unregisterEffect(mId);
300 }
301 }
302 if (registered && doEnable) {
303 status = AudioSystem::setEffectEnabled(mId, enabled);
304 }
305 mPolicyLock.unlock();
306
307 return status;
308}
309
310
Andy Hung6ac17eb2023-06-20 18:56:17 -0700311ssize_t EffectBase::removeHandle(IAfEffectHandle *handle)
Eric Laurentca7cc822012-11-19 14:55:58 -0800312{
313 Mutex::Autolock _l(mLock);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800314 return removeHandle_l(handle);
315}
316
Andy Hung6ac17eb2023-06-20 18:56:17 -0700317ssize_t EffectBase::removeHandle_l(IAfEffectHandle *handle)
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800318{
Eric Laurentca7cc822012-11-19 14:55:58 -0800319 size_t size = mHandles.size();
320 size_t i;
321 for (i = 0; i < size; i++) {
322 if (mHandles[i] == handle) {
323 break;
324 }
325 }
326 if (i == size) {
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800327 ALOGW("%s %p handle not found %p", __FUNCTION__, this, handle);
328 return BAD_VALUE;
Eric Laurentca7cc822012-11-19 14:55:58 -0800329 }
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800330 ALOGV("removeHandle_l() %p removed handle %p in position %zu", this, handle, i);
Eric Laurentca7cc822012-11-19 14:55:58 -0800331
332 mHandles.removeAt(i);
333 // if removed from first place, move effect control from this handle to next in line
334 if (i == 0) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700335 IAfEffectHandle *h = controlHandle_l();
Eric Laurentca7cc822012-11-19 14:55:58 -0800336 if (h != NULL) {
337 h->setControl(true /*hasControl*/, true /*signal*/ , handle->enabled() /*enabled*/);
338 }
339 }
340
Jaideep Sharmaed8688022020-08-07 14:09:16 +0530341 // Prevent calls to process() and other functions on effect interface from now on.
342 // The effect engine will be released by the destructor when the last strong reference on
343 // this object is released which can happen after next process is called.
Eric Laurentca7cc822012-11-19 14:55:58 -0800344 if (mHandles.size() == 0 && !mPinned) {
345 mState = DESTROYED;
346 }
347
348 return mHandles.size();
349}
350
351// must be called with EffectModule::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -0700352IAfEffectHandle *EffectBase::controlHandle_l()
Eric Laurentca7cc822012-11-19 14:55:58 -0800353{
354 // the first valid handle in the list has control over the module
355 for (size_t i = 0; i < mHandles.size(); i++) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700356 IAfEffectHandle *h = mHandles[i];
Eric Laurent0d5a2ed2016-12-01 15:28:29 -0800357 if (h != NULL && !h->disconnected()) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800358 return h;
359 }
360 }
361
362 return NULL;
363}
364
Eric Laurentf10c7092016-12-06 17:09:56 -0800365// unsafe method called when the effect parent thread has been destroyed
Andy Hung6ac17eb2023-06-20 18:56:17 -0700366ssize_t EffectBase::disconnectHandle(IAfEffectHandle *handle, bool unpinIfLast)
Eric Laurentf10c7092016-12-06 17:09:56 -0800367{
Andy Hungfda44002021-06-03 17:23:16 -0700368 const auto callback = getCallback();
Eric Laurentf10c7092016-12-06 17:09:56 -0800369 ALOGV("disconnect() %p handle %p", this, handle);
Andy Hungfda44002021-06-03 17:23:16 -0700370 if (callback->disconnectEffectHandle(handle, unpinIfLast)) {
Eric Laurent6b446ce2019-12-13 10:56:31 -0800371 return mHandles.size();
372 }
373
Eric Laurentf10c7092016-12-06 17:09:56 -0800374 Mutex::Autolock _l(mLock);
375 ssize_t numHandles = removeHandle_l(handle);
376 if ((numHandles == 0) && (!mPinned || unpinIfLast)) {
Eric Laurent6b446ce2019-12-13 10:56:31 -0800377 mLock.unlock();
Andy Hungfda44002021-06-03 17:23:16 -0700378 callback->updateOrphanEffectChains(this);
Eric Laurent6b446ce2019-12-13 10:56:31 -0800379 mLock.lock();
Eric Laurentf10c7092016-12-06 17:09:56 -0800380 }
381 return numHandles;
382}
383
Andy Hung6ac17eb2023-06-20 18:56:17 -0700384bool EffectBase::purgeHandles()
Eric Laurent41709552019-12-16 19:34:05 -0800385{
386 bool enabled = false;
387 Mutex::Autolock _l(mLock);
Andy Hung6ac17eb2023-06-20 18:56:17 -0700388 IAfEffectHandle *handle = controlHandle_l();
Eric Laurent41709552019-12-16 19:34:05 -0800389 if (handle != NULL) {
390 enabled = handle->enabled();
391 }
392 mHandles.clear();
393 return enabled;
394}
395
Andy Hung6ac17eb2023-06-20 18:56:17 -0700396void EffectBase::checkSuspendOnEffectEnabled(bool enabled, bool threadLocked) {
Andy Hungfda44002021-06-03 17:23:16 -0700397 getCallback()->checkSuspendOnEffectEnabled(this, enabled, threadLocked);
Eric Laurent41709552019-12-16 19:34:05 -0800398}
399
400static String8 effectFlagsToString(uint32_t flags) {
401 String8 s;
402
403 s.append("conn. mode: ");
404 switch (flags & EFFECT_FLAG_TYPE_MASK) {
405 case EFFECT_FLAG_TYPE_INSERT: s.append("insert"); break;
406 case EFFECT_FLAG_TYPE_AUXILIARY: s.append("auxiliary"); break;
407 case EFFECT_FLAG_TYPE_REPLACE: s.append("replace"); break;
408 case EFFECT_FLAG_TYPE_PRE_PROC: s.append("preproc"); break;
409 case EFFECT_FLAG_TYPE_POST_PROC: s.append("postproc"); break;
410 default: s.append("unknown/reserved"); break;
411 }
412 s.append(", ");
413
414 s.append("insert pref: ");
415 switch (flags & EFFECT_FLAG_INSERT_MASK) {
416 case EFFECT_FLAG_INSERT_ANY: s.append("any"); break;
417 case EFFECT_FLAG_INSERT_FIRST: s.append("first"); break;
418 case EFFECT_FLAG_INSERT_LAST: s.append("last"); break;
419 case EFFECT_FLAG_INSERT_EXCLUSIVE: s.append("exclusive"); break;
420 default: s.append("unknown/reserved"); break;
421 }
422 s.append(", ");
423
424 s.append("volume mgmt: ");
425 switch (flags & EFFECT_FLAG_VOLUME_MASK) {
426 case EFFECT_FLAG_VOLUME_NONE: s.append("none"); break;
427 case EFFECT_FLAG_VOLUME_CTRL: s.append("implements control"); break;
428 case EFFECT_FLAG_VOLUME_IND: s.append("requires indication"); break;
429 case EFFECT_FLAG_VOLUME_MONITOR: s.append("monitors volume"); break;
430 default: s.append("unknown/reserved"); break;
431 }
432 s.append(", ");
433
434 uint32_t devind = flags & EFFECT_FLAG_DEVICE_MASK;
435 if (devind) {
436 s.append("device indication: ");
437 switch (devind) {
438 case EFFECT_FLAG_DEVICE_IND: s.append("requires updates"); break;
439 default: s.append("unknown/reserved"); break;
440 }
441 s.append(", ");
442 }
443
444 s.append("input mode: ");
445 switch (flags & EFFECT_FLAG_INPUT_MASK) {
446 case EFFECT_FLAG_INPUT_DIRECT: s.append("direct"); break;
447 case EFFECT_FLAG_INPUT_PROVIDER: s.append("provider"); break;
448 case EFFECT_FLAG_INPUT_BOTH: s.append("direct+provider"); break;
449 default: s.append("not set"); break;
450 }
451 s.append(", ");
452
453 s.append("output mode: ");
454 switch (flags & EFFECT_FLAG_OUTPUT_MASK) {
455 case EFFECT_FLAG_OUTPUT_DIRECT: s.append("direct"); break;
456 case EFFECT_FLAG_OUTPUT_PROVIDER: s.append("provider"); break;
457 case EFFECT_FLAG_OUTPUT_BOTH: s.append("direct+provider"); break;
458 default: s.append("not set"); break;
459 }
460 s.append(", ");
461
462 uint32_t accel = flags & EFFECT_FLAG_HW_ACC_MASK;
463 if (accel) {
464 s.append("hardware acceleration: ");
465 switch (accel) {
466 case EFFECT_FLAG_HW_ACC_SIMPLE: s.append("non-tunneled"); break;
467 case EFFECT_FLAG_HW_ACC_TUNNEL: s.append("tunneled"); break;
468 default: s.append("unknown/reserved"); break;
469 }
470 s.append(", ");
471 }
472
473 uint32_t modeind = flags & EFFECT_FLAG_AUDIO_MODE_MASK;
474 if (modeind) {
475 s.append("mode indication: ");
476 switch (modeind) {
477 case EFFECT_FLAG_AUDIO_MODE_IND: s.append("required"); break;
478 default: s.append("unknown/reserved"); break;
479 }
480 s.append(", ");
481 }
482
483 uint32_t srcind = flags & EFFECT_FLAG_AUDIO_SOURCE_MASK;
484 if (srcind) {
485 s.append("source indication: ");
486 switch (srcind) {
487 case EFFECT_FLAG_AUDIO_SOURCE_IND: s.append("required"); break;
488 default: s.append("unknown/reserved"); break;
489 }
490 s.append(", ");
491 }
492
493 if (flags & EFFECT_FLAG_OFFLOAD_MASK) {
494 s.append("offloadable, ");
495 }
496
497 int len = s.length();
498 if (s.length() > 2) {
499 (void) s.lockBuffer(len);
500 s.unlockBuffer(len - 2);
501 }
502 return s;
503}
504
Andy Hung6ac17eb2023-06-20 18:56:17 -0700505void EffectBase::dump(int fd, const Vector<String16>& args __unused) const
Andy Hung920f6572022-10-06 12:09:49 -0700506NO_THREAD_SAFETY_ANALYSIS // conditional try lock
Eric Laurent41709552019-12-16 19:34:05 -0800507{
508 String8 result;
509
510 result.appendFormat("\tEffect ID %d:\n", mId);
511
Andy Hung0a51b5c2023-07-18 20:54:44 -0700512 const bool locked = afutils::dumpTryLock(mLock);
Eric Laurent41709552019-12-16 19:34:05 -0800513 // failed to lock - AudioFlinger is probably deadlocked
514 if (!locked) {
515 result.append("\t\tCould not lock Fx mutex:\n");
516 }
François Gaffie163ce832023-06-28 11:36:35 +0200517 bool isInternal = isInternal_l();
518 result.append("\t\tSession State Registered Internal Enabled Suspended:\n");
519 result.appendFormat("\t\t%05d %03d %s %s %s %s\n",
520 mSessionId, mState, mPolicyRegistered ? "y" : "n", isInternal ? "y" : "n",
521 ((isInternal && isEnabled()) || (!isInternal && mPolicyEnabled)) ? "y" : "n",
522 mSuspended ? "y" : "n");
Eric Laurent41709552019-12-16 19:34:05 -0800523
524 result.append("\t\tDescriptor:\n");
525 char uuidStr[64];
526 AudioEffect::guidToString(&mDescriptor.uuid, uuidStr, sizeof(uuidStr));
527 result.appendFormat("\t\t- UUID: %s\n", uuidStr);
528 AudioEffect::guidToString(&mDescriptor.type, uuidStr, sizeof(uuidStr));
529 result.appendFormat("\t\t- TYPE: %s\n", uuidStr);
530 result.appendFormat("\t\t- apiVersion: %08X\n\t\t- flags: %08X (%s)\n",
531 mDescriptor.apiVersion,
532 mDescriptor.flags,
533 effectFlagsToString(mDescriptor.flags).string());
534 result.appendFormat("\t\t- name: %s\n",
535 mDescriptor.name);
536
537 result.appendFormat("\t\t- implementor: %s\n",
538 mDescriptor.implementor);
539
540 result.appendFormat("\t\t%zu Clients:\n", mHandles.size());
541 result.append("\t\t\t Pid Priority Ctrl Locked client server\n");
542 char buffer[256];
543 for (size_t i = 0; i < mHandles.size(); ++i) {
Andy Hung6ac17eb2023-06-20 18:56:17 -0700544 IAfEffectHandle *handle = mHandles[i];
Eric Laurent41709552019-12-16 19:34:05 -0800545 if (handle != NULL && !handle->disconnected()) {
546 handle->dumpToBuffer(buffer, sizeof(buffer));
547 result.append(buffer);
548 }
549 }
550 if (locked) {
551 mLock.unlock();
552 }
553
554 write(fd, result.string(), result.length());
555}
556
557// ----------------------------------------------------------------------------
558// EffectModule implementation
559// ----------------------------------------------------------------------------
560
561#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -0700562#define LOG_TAG "EffectModule"
Eric Laurent41709552019-12-16 19:34:05 -0800563
Andy Hung6ac17eb2023-06-20 18:56:17 -0700564EffectModule::EffectModule(const sp<EffectCallbackInterface>& callback,
Eric Laurent41709552019-12-16 19:34:05 -0800565 effect_descriptor_t *desc,
566 int id,
567 audio_session_t sessionId,
Eric Laurentb82e6b72019-11-22 17:25:04 -0800568 bool pinned,
569 audio_port_handle_t deviceId)
Eric Laurent41709552019-12-16 19:34:05 -0800570 : EffectBase(callback, desc, id, sessionId, pinned),
571 // clear mConfig to ensure consistent initial value of buffer framecount
572 // in case buffers are associated by setInBuffer() or setOutBuffer()
573 // prior to configure().
574 mConfig{{}, {}},
575 mStatus(NO_INIT),
576 mMaxDisableWaitCnt(1), // set by configure(), should be >= 1
577 mDisableWaitCnt(0), // set by process() and updateState()
David Li6c8ac4b2021-06-22 22:17:52 +0800578 mOffloaded(false),
Mikhail Naganov8d7da002022-04-19 21:21:23 +0000579 mIsOutput(false)
Eric Laurent41709552019-12-16 19:34:05 -0800580 , mSupportsFloat(false)
Eric Laurent41709552019-12-16 19:34:05 -0800581{
582 ALOGV("Constructor %p pinned %d", this, pinned);
583 int lStatus;
584
585 // create effect engine from effect factory
586 mStatus = callback->createEffectHal(
Eric Laurentb82e6b72019-11-22 17:25:04 -0800587 &desc->uuid, sessionId, deviceId, &mEffectInterface);
Eric Laurent41709552019-12-16 19:34:05 -0800588 if (mStatus != NO_ERROR) {
589 return;
590 }
591 lStatus = init();
592 if (lStatus < 0) {
593 mStatus = lStatus;
594 goto Error;
595 }
596
597 setOffloaded(callback->isOffload(), callback->io());
598 ALOGV("Constructor success name %s, Interface %p", mDescriptor.name, mEffectInterface.get());
599
600 return;
601Error:
602 mEffectInterface.clear();
603 ALOGV("Constructor Error %d", mStatus);
604}
605
Andy Hung6ac17eb2023-06-20 18:56:17 -0700606EffectModule::~EffectModule()
Eric Laurent41709552019-12-16 19:34:05 -0800607{
608 ALOGV("Destructor %p", this);
609 if (mEffectInterface != 0) {
610 char uuidStr[64];
611 AudioEffect::guidToString(&mDescriptor.uuid, uuidStr, sizeof(uuidStr));
612 ALOGW("EffectModule %p destructor called with unreleased interface, effect %s",
613 this, uuidStr);
614 release_l();
615 }
616
617}
618
Andy Hung6ac17eb2023-06-20 18:56:17 -0700619bool EffectModule::updateState() {
Eric Laurentca7cc822012-11-19 14:55:58 -0800620 Mutex::Autolock _l(mLock);
621
Eric Laurentfa1e1232016-08-02 19:01:49 -0700622 bool started = false;
Eric Laurentca7cc822012-11-19 14:55:58 -0800623 switch (mState) {
624 case RESTART:
625 reset_l();
Chih-Hung Hsieh2b487032018-09-13 14:16:02 -0700626 FALLTHROUGH_INTENDED;
Eric Laurentca7cc822012-11-19 14:55:58 -0800627
628 case STARTING:
629 // clear auxiliary effect input buffer for next accumulation
630 if ((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY) {
631 memset(mConfig.inputCfg.buffer.raw,
632 0,
633 mConfig.inputCfg.buffer.frameCount*sizeof(int32_t));
634 }
Eric Laurentd0ebb532013-04-02 16:41:41 -0700635 if (start_l() == NO_ERROR) {
636 mState = ACTIVE;
Eric Laurentfa1e1232016-08-02 19:01:49 -0700637 started = true;
Eric Laurentd0ebb532013-04-02 16:41:41 -0700638 } else {
639 mState = IDLE;
640 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800641 break;
642 case STOPPING:
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +0900643 // volume control for offload and direct threads must take effect immediately.
644 if (stop_l() == NO_ERROR
645 && !(isVolumeControl() && isOffloadedOrDirect())) {
Eric Laurentd0ebb532013-04-02 16:41:41 -0700646 mDisableWaitCnt = mMaxDisableWaitCnt;
647 } else {
648 mDisableWaitCnt = 1; // will cause immediate transition to IDLE
649 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800650 mState = STOPPED;
651 break;
652 case STOPPED:
653 // mDisableWaitCnt is forced to 1 by process() when the engine indicates the end of the
654 // turn off sequence.
655 if (--mDisableWaitCnt == 0) {
656 reset_l();
657 mState = IDLE;
658 }
659 break;
Eric Laurentde8caf42021-08-11 17:19:25 +0200660 case ACTIVE:
661 for (size_t i = 0; i < mHandles.size(); i++) {
662 if (!mHandles[i]->disconnected()) {
663 mHandles[i]->framesProcessed(mConfig.inputCfg.buffer.frameCount);
664 }
665 }
666 break;
Eric Laurentca7cc822012-11-19 14:55:58 -0800667 default: //IDLE , ACTIVE, DESTROYED
668 break;
669 }
Eric Laurentfa1e1232016-08-02 19:01:49 -0700670
671 return started;
Eric Laurentca7cc822012-11-19 14:55:58 -0800672}
673
Andy Hung6ac17eb2023-06-20 18:56:17 -0700674void EffectModule::process()
Eric Laurentca7cc822012-11-19 14:55:58 -0800675{
676 Mutex::Autolock _l(mLock);
677
Mikhail Naganov022b9952017-01-04 16:36:51 -0800678 if (mState == DESTROYED || mEffectInterface == 0 || mInBuffer == 0 || mOutBuffer == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800679 return;
680 }
681
rago94a1ee82017-07-21 15:11:02 -0700682 const uint32_t inChannelCount =
683 audio_channel_count_from_out_mask(mConfig.inputCfg.channels);
684 const uint32_t outChannelCount =
685 audio_channel_count_from_out_mask(mConfig.outputCfg.channels);
686 const bool auxType =
687 (mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY;
688
Andy Hungfa69ca32017-11-30 10:07:53 -0800689 // safeInputOutputSampleCount is 0 if the channel count between input and output
690 // buffers do not match. This prevents automatic accumulation or copying between the
691 // input and output effect buffers without an intermediary effect process.
692 // TODO: consider implementing channel conversion.
693 const size_t safeInputOutputSampleCount =
Andy Hungdd2e7a82018-10-31 14:19:13 -0700694 mInChannelCountRequested != mOutChannelCountRequested ? 0
695 : mOutChannelCountRequested * std::min(
Andy Hungfa69ca32017-11-30 10:07:53 -0800696 mConfig.inputCfg.buffer.frameCount,
697 mConfig.outputCfg.buffer.frameCount);
698 const auto accumulateInputToOutput = [this, safeInputOutputSampleCount]() {
Andy Hungfa69ca32017-11-30 10:07:53 -0800699 accumulate_float(
700 mConfig.outputCfg.buffer.f32,
701 mConfig.inputCfg.buffer.f32,
702 safeInputOutputSampleCount);
Andy Hungfa69ca32017-11-30 10:07:53 -0800703 };
704 const auto copyInputToOutput = [this, safeInputOutputSampleCount]() {
Andy Hungfa69ca32017-11-30 10:07:53 -0800705 memcpy(
706 mConfig.outputCfg.buffer.f32,
707 mConfig.inputCfg.buffer.f32,
708 safeInputOutputSampleCount * sizeof(*mConfig.outputCfg.buffer.f32));
Andy Hungfa69ca32017-11-30 10:07:53 -0800709 };
710
Eric Laurentca7cc822012-11-19 14:55:58 -0800711 if (isProcessEnabled()) {
Eric Laurent6dd0fd92016-09-15 12:44:53 -0700712 int ret;
713 if (isProcessImplemented()) {
rago94a1ee82017-07-21 15:11:02 -0700714 if (auxType) {
715 // We overwrite the aux input buffer here and clear after processing.
Andy Hung9aad48c2017-11-29 10:29:19 -0800716 // aux input is always mono.
rago94a1ee82017-07-21 15:11:02 -0700717
Andy Hung26836922023-05-22 17:31:57 -0700718 if (!mSupportsFloat) {
Andy Hung116a4982017-11-30 10:15:08 -0800719 memcpy_to_i16_from_float(
720 mConfig.inputCfg.buffer.s16,
721 mConfig.inputCfg.buffer.f32,
722 mConfig.inputCfg.buffer.frameCount);
rago94a1ee82017-07-21 15:11:02 -0700723 }
rago94a1ee82017-07-21 15:11:02 -0700724 }
Andy Hung9aad48c2017-11-29 10:29:19 -0800725 sp<EffectBufferHalInterface> inBuffer = mInBuffer;
726 sp<EffectBufferHalInterface> outBuffer = mOutBuffer;
727
728 if (!auxType && mInChannelCountRequested != inChannelCount) {
729 adjust_channels(
730 inBuffer->audioBuffer()->f32, mInChannelCountRequested,
731 mInConversionBuffer->audioBuffer()->f32, inChannelCount,
732 sizeof(float),
733 sizeof(float)
734 * mInChannelCountRequested * mConfig.inputCfg.buffer.frameCount);
735 inBuffer = mInConversionBuffer;
736 }
737 if (mConfig.outputCfg.accessMode == EFFECT_BUFFER_ACCESS_ACCUMULATE
738 && mOutChannelCountRequested != outChannelCount) {
739 adjust_selected_channels(
740 outBuffer->audioBuffer()->f32, mOutChannelCountRequested,
741 mOutConversionBuffer->audioBuffer()->f32, outChannelCount,
742 sizeof(float),
743 sizeof(float)
744 * mOutChannelCountRequested * mConfig.outputCfg.buffer.frameCount);
745 outBuffer = mOutConversionBuffer;
746 }
Andy Hungfa69ca32017-11-30 10:07:53 -0800747 if (!mSupportsFloat) { // convert input to int16_t as effect doesn't support float.
748 if (!auxType) {
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -0800749 if (mInConversionBuffer == nullptr) {
Andy Hungfa69ca32017-11-30 10:07:53 -0800750 ALOGW("%s: mInConversionBuffer is null, bypassing", __func__);
751 goto data_bypass;
rago94a1ee82017-07-21 15:11:02 -0700752 }
Andy Hungfa69ca32017-11-30 10:07:53 -0800753 memcpy_to_i16_from_float(
754 mInConversionBuffer->audioBuffer()->s16,
Andy Hung9aad48c2017-11-29 10:29:19 -0800755 inBuffer->audioBuffer()->f32,
Andy Hungfa69ca32017-11-30 10:07:53 -0800756 inChannelCount * mConfig.inputCfg.buffer.frameCount);
Andy Hung9aad48c2017-11-29 10:29:19 -0800757 inBuffer = mInConversionBuffer;
rago94a1ee82017-07-21 15:11:02 -0700758 }
Andy Hungfa69ca32017-11-30 10:07:53 -0800759 if (mConfig.outputCfg.accessMode == EFFECT_BUFFER_ACCESS_ACCUMULATE) {
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -0800760 if (mOutConversionBuffer == nullptr) {
Andy Hungfa69ca32017-11-30 10:07:53 -0800761 ALOGW("%s: mOutConversionBuffer is null, bypassing", __func__);
762 goto data_bypass;
763 }
764 memcpy_to_i16_from_float(
765 mOutConversionBuffer->audioBuffer()->s16,
Andy Hung9aad48c2017-11-29 10:29:19 -0800766 outBuffer->audioBuffer()->f32,
Andy Hungfa69ca32017-11-30 10:07:53 -0800767 outChannelCount * mConfig.outputCfg.buffer.frameCount);
Andy Hung9aad48c2017-11-29 10:29:19 -0800768 outBuffer = mOutConversionBuffer;
rago94a1ee82017-07-21 15:11:02 -0700769 }
770 }
Mikhail Naganov022b9952017-01-04 16:36:51 -0800771 ret = mEffectInterface->process();
Andy Hungfa69ca32017-11-30 10:07:53 -0800772 if (!mSupportsFloat) { // convert output int16_t back to float.
Andy Hung9aad48c2017-11-29 10:29:19 -0800773 sp<EffectBufferHalInterface> target =
774 mOutChannelCountRequested != outChannelCount
775 ? mOutConversionBuffer : mOutBuffer;
776
Andy Hungfa69ca32017-11-30 10:07:53 -0800777 memcpy_to_float_from_i16(
Andy Hung9aad48c2017-11-29 10:29:19 -0800778 target->audioBuffer()->f32,
Andy Hungfa69ca32017-11-30 10:07:53 -0800779 mOutConversionBuffer->audioBuffer()->s16,
780 outChannelCount * mConfig.outputCfg.buffer.frameCount);
781 }
Andy Hung9aad48c2017-11-29 10:29:19 -0800782 if (mOutChannelCountRequested != outChannelCount) {
783 adjust_selected_channels(mOutConversionBuffer->audioBuffer()->f32, outChannelCount,
784 mOutBuffer->audioBuffer()->f32, mOutChannelCountRequested,
785 sizeof(float),
786 sizeof(float) * outChannelCount * mConfig.outputCfg.buffer.frameCount);
787 }
Eric Laurent6dd0fd92016-09-15 12:44:53 -0700788 } else {
rago94a1ee82017-07-21 15:11:02 -0700789 data_bypass:
rago94a1ee82017-07-21 15:11:02 -0700790 if (!auxType /* aux effects do not require data bypass */
Andy Hungfa69ca32017-11-30 10:07:53 -0800791 && mConfig.inputCfg.buffer.raw != mConfig.outputCfg.buffer.raw) {
Eric Laurent6dd0fd92016-09-15 12:44:53 -0700792 if (mConfig.outputCfg.accessMode == EFFECT_BUFFER_ACCESS_ACCUMULATE) {
Andy Hungfa69ca32017-11-30 10:07:53 -0800793 accumulateInputToOutput();
Eric Laurent6dd0fd92016-09-15 12:44:53 -0700794 } else {
Andy Hungfa69ca32017-11-30 10:07:53 -0800795 copyInputToOutput();
Eric Laurent6dd0fd92016-09-15 12:44:53 -0700796 }
797 }
798 ret = -ENODATA;
799 }
Andy Hungfa69ca32017-11-30 10:07:53 -0800800
Eric Laurentca7cc822012-11-19 14:55:58 -0800801 // force transition to IDLE state when engine is ready
802 if (mState == STOPPED && ret == -ENODATA) {
803 mDisableWaitCnt = 1;
804 }
805
806 // clear auxiliary effect input buffer for next accumulation
rago94a1ee82017-07-21 15:11:02 -0700807 if (auxType) {
Andy Hung116a4982017-11-30 10:15:08 -0800808 const size_t size =
809 mConfig.inputCfg.buffer.frameCount * inChannelCount * sizeof(float);
rago94a1ee82017-07-21 15:11:02 -0700810 memset(mConfig.inputCfg.buffer.raw, 0, size);
Eric Laurentca7cc822012-11-19 14:55:58 -0800811 }
812 } else if ((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_INSERT &&
rago94a1ee82017-07-21 15:11:02 -0700813 // mInBuffer->audioBuffer()->raw != mOutBuffer->audioBuffer()->raw
Eric Laurentca7cc822012-11-19 14:55:58 -0800814 mConfig.inputCfg.buffer.raw != mConfig.outputCfg.buffer.raw) {
815 // If an insert effect is idle and input buffer is different from output buffer,
816 // accumulate input onto output
Andy Hungfda44002021-06-03 17:23:16 -0700817 if (getCallback()->activeTrackCnt() != 0) {
Andy Hunge8ac1b22018-10-31 14:22:35 -0700818 // similar handling with data_bypass above.
819 if (mConfig.outputCfg.accessMode == EFFECT_BUFFER_ACCESS_ACCUMULATE) {
820 accumulateInputToOutput();
821 } else { // EFFECT_BUFFER_ACCESS_WRITE
822 copyInputToOutput();
823 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800824 }
825 }
826}
827
Andy Hung6ac17eb2023-06-20 18:56:17 -0700828void EffectModule::reset_l()
Eric Laurentca7cc822012-11-19 14:55:58 -0800829{
Mikhail Naganov1dc98672016-08-18 17:50:29 -0700830 if (mStatus != NO_ERROR || mEffectInterface == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800831 return;
832 }
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -0700833 mEffectInterface->command(EFFECT_CMD_RESET, 0, NULL, 0, NULL);
Eric Laurentca7cc822012-11-19 14:55:58 -0800834}
835
Andy Hung6ac17eb2023-06-20 18:56:17 -0700836status_t EffectModule::configure()
Eric Laurentca7cc822012-11-19 14:55:58 -0800837{
rago94a1ee82017-07-21 15:11:02 -0700838 ALOGVV("configure() started");
Eric Laurentd0ebb532013-04-02 16:41:41 -0700839 status_t status;
Eric Laurentd0ebb532013-04-02 16:41:41 -0700840 uint32_t size;
841 audio_channel_mask_t channelMask;
Andy Hungfda44002021-06-03 17:23:16 -0700842 sp<EffectCallbackInterface> callback;
Eric Laurentd0ebb532013-04-02 16:41:41 -0700843
Mikhail Naganov1dc98672016-08-18 17:50:29 -0700844 if (mEffectInterface == 0) {
Eric Laurentd0ebb532013-04-02 16:41:41 -0700845 status = NO_INIT;
846 goto exit;
Eric Laurentca7cc822012-11-19 14:55:58 -0800847 }
848
Eric Laurentca7cc822012-11-19 14:55:58 -0800849 // TODO: handle configuration of effects replacing track process
Andy Hung9aad48c2017-11-29 10:29:19 -0800850 // TODO: handle configuration of input (record) SW effects above the HAL,
851 // similar to output EFFECT_FLAG_TYPE_INSERT/REPLACE,
852 // in which case input channel masks should be used here.
Andy Hungfda44002021-06-03 17:23:16 -0700853 callback = getCallback();
Eric Laurentf1f22e72021-07-13 14:04:14 +0200854 channelMask = callback->inChannelMask(mId);
Andy Hung9aad48c2017-11-29 10:29:19 -0800855 mConfig.inputCfg.channels = channelMask;
Eric Laurentf1f22e72021-07-13 14:04:14 +0200856 mConfig.outputCfg.channels = callback->outChannelMask();
Eric Laurentca7cc822012-11-19 14:55:58 -0800857
858 if ((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY) {
Andy Hung9aad48c2017-11-29 10:29:19 -0800859 if (mConfig.inputCfg.channels != AUDIO_CHANNEL_OUT_MONO) {
860 mConfig.inputCfg.channels = AUDIO_CHANNEL_OUT_MONO;
861 ALOGV("Overriding auxiliary effect input channels %#x as MONO",
862 mConfig.inputCfg.channels);
863 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800864 }
jiabineb3bda02020-06-30 14:07:03 -0700865 if (isHapticGenerator()) {
Andy Hungfda44002021-06-03 17:23:16 -0700866 audio_channel_mask_t hapticChannelMask = callback->hapticChannelMask();
jiabineb3bda02020-06-30 14:07:03 -0700867 mConfig.inputCfg.channels |= hapticChannelMask;
868 mConfig.outputCfg.channels |= hapticChannelMask;
869 }
Andy Hung9aad48c2017-11-29 10:29:19 -0800870 mInChannelCountRequested =
871 audio_channel_count_from_out_mask(mConfig.inputCfg.channels);
872 mOutChannelCountRequested =
873 audio_channel_count_from_out_mask(mConfig.outputCfg.channels);
Ricardo Garciad11da702015-05-28 12:14:12 -0700874
Andy Hung319587b2023-05-23 14:01:03 -0700875 mConfig.inputCfg.format = AUDIO_FORMAT_PCM_FLOAT;
876 mConfig.outputCfg.format = AUDIO_FORMAT_PCM_FLOAT;
Yuuki Yokoyamae17f8312017-05-26 19:06:33 +0900877
878 // Don't use sample rate for thread if effect isn't offloadable.
Andy Hungfda44002021-06-03 17:23:16 -0700879 if (callback->isOffloadOrDirect() && !isOffloaded()) {
Yuuki Yokoyamae17f8312017-05-26 19:06:33 +0900880 mConfig.inputCfg.samplingRate = DEFAULT_OUTPUT_SAMPLE_RATE;
881 ALOGV("Overriding effect input as 48kHz");
882 } else {
Andy Hungfda44002021-06-03 17:23:16 -0700883 mConfig.inputCfg.samplingRate = callback->sampleRate();
Yuuki Yokoyamae17f8312017-05-26 19:06:33 +0900884 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800885 mConfig.outputCfg.samplingRate = mConfig.inputCfg.samplingRate;
886 mConfig.inputCfg.bufferProvider.cookie = NULL;
887 mConfig.inputCfg.bufferProvider.getBuffer = NULL;
888 mConfig.inputCfg.bufferProvider.releaseBuffer = NULL;
889 mConfig.outputCfg.bufferProvider.cookie = NULL;
890 mConfig.outputCfg.bufferProvider.getBuffer = NULL;
891 mConfig.outputCfg.bufferProvider.releaseBuffer = NULL;
892 mConfig.inputCfg.accessMode = EFFECT_BUFFER_ACCESS_READ;
893 // Insert effect:
Eric Laurent3f75a5b2019-11-12 15:55:51 -0800894 // - in global sessions (e.g AUDIO_SESSION_OUTPUT_MIX),
Eric Laurentca7cc822012-11-19 14:55:58 -0800895 // always overwrites output buffer: input buffer == output buffer
896 // - in other sessions:
897 // last effect in the chain accumulates in output buffer: input buffer != output buffer
898 // other effect: overwrites output buffer: input buffer == output buffer
899 // Auxiliary effect:
900 // accumulates in output buffer: input buffer != output buffer
901 // Therefore: accumulate <=> input buffer != output buffer
Andy Hung799c8d02021-10-28 17:05:40 -0700902 mConfig.outputCfg.accessMode = requiredEffectBufferAccessMode();
Eric Laurentca7cc822012-11-19 14:55:58 -0800903 mConfig.inputCfg.mask = EFFECT_CONFIG_ALL;
904 mConfig.outputCfg.mask = EFFECT_CONFIG_ALL;
Andy Hungfda44002021-06-03 17:23:16 -0700905 mConfig.inputCfg.buffer.frameCount = callback->frameCount();
Eric Laurentca7cc822012-11-19 14:55:58 -0800906 mConfig.outputCfg.buffer.frameCount = mConfig.inputCfg.buffer.frameCount;
Mikhail Naganov8d7da002022-04-19 21:21:23 +0000907 mIsOutput = callback->isOutput();
Eric Laurentca7cc822012-11-19 14:55:58 -0800908
Eric Laurent6b446ce2019-12-13 10:56:31 -0800909 ALOGV("configure() %p chain %p buffer %p framecount %zu",
Andy Hungfda44002021-06-03 17:23:16 -0700910 this, callback->chain().promote().get(),
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -0800911 mConfig.inputCfg.buffer.raw, mConfig.inputCfg.buffer.frameCount);
Eric Laurentca7cc822012-11-19 14:55:58 -0800912
913 status_t cmdStatus;
Eric Laurentd0ebb532013-04-02 16:41:41 -0700914 size = sizeof(int);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -0700915 status = mEffectInterface->command(EFFECT_CMD_SET_CONFIG,
Andy Hung9aad48c2017-11-29 10:29:19 -0800916 sizeof(mConfig),
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -0700917 &mConfig,
918 &size,
919 &cmdStatus);
rago94a1ee82017-07-21 15:11:02 -0700920 if (status == NO_ERROR) {
Eric Laurentca7cc822012-11-19 14:55:58 -0800921 status = cmdStatus;
922 }
Andy Hung9aad48c2017-11-29 10:29:19 -0800923
Andy Hung9aad48c2017-11-29 10:29:19 -0800924 if (status != NO_ERROR &&
Andy Hungba8e52b2023-05-11 14:33:03 -0700925 EffectConfiguration::isHidl() && // only HIDL effects support channel conversion
Mikhail Naganov8d7da002022-04-19 21:21:23 +0000926 mIsOutput &&
Andy Hung9aad48c2017-11-29 10:29:19 -0800927 (mConfig.inputCfg.channels != AUDIO_CHANNEL_OUT_STEREO
928 || mConfig.outputCfg.channels != AUDIO_CHANNEL_OUT_STEREO)) {
929 // Older effects may require exact STEREO position mask.
Andy Hung01b32722018-05-18 13:52:02 -0700930 if (mConfig.inputCfg.channels != AUDIO_CHANNEL_OUT_STEREO
931 && (mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) != EFFECT_FLAG_TYPE_AUXILIARY) {
Andy Hung9aad48c2017-11-29 10:29:19 -0800932 ALOGV("Overriding effect input channels %#x as STEREO", mConfig.inputCfg.channels);
933 mConfig.inputCfg.channels = AUDIO_CHANNEL_OUT_STEREO;
934 }
935 if (mConfig.outputCfg.channels != AUDIO_CHANNEL_OUT_STEREO) {
936 ALOGV("Overriding effect output channels %#x as STEREO", mConfig.outputCfg.channels);
937 mConfig.outputCfg.channels = AUDIO_CHANNEL_OUT_STEREO;
938 }
939 size = sizeof(int);
rago94a1ee82017-07-21 15:11:02 -0700940 status = mEffectInterface->command(EFFECT_CMD_SET_CONFIG,
Andy Hung9aad48c2017-11-29 10:29:19 -0800941 sizeof(mConfig),
rago94a1ee82017-07-21 15:11:02 -0700942 &mConfig,
943 &size,
944 &cmdStatus);
945 if (status == NO_ERROR) {
946 status = cmdStatus;
Andy Hung9aad48c2017-11-29 10:29:19 -0800947 }
948 }
Andy Hung9aad48c2017-11-29 10:29:19 -0800949
Andy Hung9aad48c2017-11-29 10:29:19 -0800950 if (status == NO_ERROR) {
951 mSupportsFloat = true;
952 }
953
Andy Hungba8e52b2023-05-11 14:33:03 -0700954 // only HIDL effects support integer conversion.
955 if (status != NO_ERROR && EffectConfiguration::isHidl()) {
Andy Hung9aad48c2017-11-29 10:29:19 -0800956 ALOGV("EFFECT_CMD_SET_CONFIG failed with float format, retry with int16_t.");
957 mConfig.inputCfg.format = AUDIO_FORMAT_PCM_16_BIT;
958 mConfig.outputCfg.format = AUDIO_FORMAT_PCM_16_BIT;
959 size = sizeof(int);
960 status = mEffectInterface->command(EFFECT_CMD_SET_CONFIG,
961 sizeof(mConfig),
962 &mConfig,
963 &size,
964 &cmdStatus);
965 if (status == NO_ERROR) {
966 status = cmdStatus;
967 }
968 if (status == NO_ERROR) {
rago94a1ee82017-07-21 15:11:02 -0700969 mSupportsFloat = false;
970 ALOGVV("config worked with 16 bit");
971 } else {
972 ALOGE("%s failed %d with int16_t (as well as float)", __func__, status);
Eric Laurentca7cc822012-11-19 14:55:58 -0800973 }
rago94a1ee82017-07-21 15:11:02 -0700974 }
Eric Laurentca7cc822012-11-19 14:55:58 -0800975
rago94a1ee82017-07-21 15:11:02 -0700976 if (status == NO_ERROR) {
977 // Establish Buffer strategy
978 setInBuffer(mInBuffer);
979 setOutBuffer(mOutBuffer);
980
981 // Update visualizer latency
982 if (memcmp(&mDescriptor.type, SL_IID_VISUALIZATION, sizeof(effect_uuid_t)) == 0) {
983 uint32_t buf32[sizeof(effect_param_t) / sizeof(uint32_t) + 2];
984 effect_param_t *p = (effect_param_t *)buf32;
985
986 p->psize = sizeof(uint32_t);
987 p->vsize = sizeof(uint32_t);
988 size = sizeof(int);
989 *(int32_t *)p->data = VISUALIZER_PARAM_LATENCY;
990
Andy Hungfda44002021-06-03 17:23:16 -0700991 uint32_t latency = callback->latency();
rago94a1ee82017-07-21 15:11:02 -0700992
993 *((int32_t *)p->data + 1)= latency;
994 mEffectInterface->command(EFFECT_CMD_SET_PARAM,
995 sizeof(effect_param_t) + 8,
996 &buf32,
997 &size,
998 &cmdStatus);
999 }
jiabin4e246532022-08-23 16:37:30 -07001000
1001 if (isVolumeControl()) {
1002 // Force initializing the volume as 0 for volume control effect for safer ramping
1003 uint32_t left = 0;
1004 uint32_t right = 0;
1005 setVolumeInternal(&left, &right, true /*controller*/);
1006 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001007 }
1008
Andy Hung05083ac2017-12-14 15:00:28 -08001009 // mConfig.outputCfg.buffer.frameCount cannot be zero.
1010 mMaxDisableWaitCnt = (uint32_t)std::max(
1011 (uint64_t)1, // mMaxDisableWaitCnt must be greater than zero.
François Gaffieb8551f62023-02-15 11:36:35 +01001012 (uint64_t)mConfig.outputCfg.buffer.frameCount == 0 ? 1
1013 : (MAX_DISABLE_TIME_MS * mConfig.outputCfg.samplingRate
1014 / ((uint64_t)1000 * mConfig.outputCfg.buffer.frameCount)));
Eric Laurentca7cc822012-11-19 14:55:58 -08001015
Eric Laurentd0ebb532013-04-02 16:41:41 -07001016exit:
Andy Hung6f88dc42017-12-13 16:19:39 -08001017 // TODO: consider clearing mConfig on error.
Eric Laurentd0ebb532013-04-02 16:41:41 -07001018 mStatus = status;
rago94a1ee82017-07-21 15:11:02 -07001019 ALOGVV("configure ended");
Eric Laurentca7cc822012-11-19 14:55:58 -08001020 return status;
1021}
1022
Andy Hung6ac17eb2023-06-20 18:56:17 -07001023status_t EffectModule::init()
Eric Laurentca7cc822012-11-19 14:55:58 -08001024{
1025 Mutex::Autolock _l(mLock);
Mikhail Naganov1dc98672016-08-18 17:50:29 -07001026 if (mEffectInterface == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001027 return NO_INIT;
1028 }
1029 status_t cmdStatus;
1030 uint32_t size = sizeof(status_t);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001031 status_t status = mEffectInterface->command(EFFECT_CMD_INIT,
1032 0,
1033 NULL,
1034 &size,
1035 &cmdStatus);
Eric Laurentca7cc822012-11-19 14:55:58 -08001036 if (status == 0) {
1037 status = cmdStatus;
1038 }
1039 return status;
1040}
1041
Andy Hung6ac17eb2023-06-20 18:56:17 -07001042void EffectModule::addEffectToHal_l()
Eric Laurent1b928682014-10-02 19:41:47 -07001043{
1044 if ((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_PRE_PROC ||
1045 (mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_POST_PROC) {
Eric Laurent9f57aa82023-03-17 19:28:37 +01001046 if (mCurrentHalStream == getCallback()->io()) {
David Li6c8ac4b2021-06-22 22:17:52 +08001047 return;
1048 }
1049
Andy Hungfda44002021-06-03 17:23:16 -07001050 (void)getCallback()->addEffectToHal(mEffectInterface);
Eric Laurent9f57aa82023-03-17 19:28:37 +01001051 mCurrentHalStream = getCallback()->io();
Eric Laurent1b928682014-10-02 19:41:47 -07001052 }
1053}
1054
Eric Laurentfa1e1232016-08-02 19:01:49 -07001055// start() must be called with PlaybackThread::mLock or EffectChain::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -07001056status_t EffectModule::start()
Eric Laurentca7cc822012-11-19 14:55:58 -08001057{
Eric Laurentfa1e1232016-08-02 19:01:49 -07001058 status_t status;
1059 {
1060 Mutex::Autolock _l(mLock);
1061 status = start_l();
Eric Laurentfa1e1232016-08-02 19:01:49 -07001062 }
Eric Laurent6b446ce2019-12-13 10:56:31 -08001063 if (status == NO_ERROR) {
Andy Hungfda44002021-06-03 17:23:16 -07001064 getCallback()->resetVolume();
Eric Laurentfa1e1232016-08-02 19:01:49 -07001065 }
1066 return status;
Eric Laurentca7cc822012-11-19 14:55:58 -08001067}
1068
Andy Hung6ac17eb2023-06-20 18:56:17 -07001069status_t EffectModule::start_l()
Eric Laurentca7cc822012-11-19 14:55:58 -08001070{
Mikhail Naganov1dc98672016-08-18 17:50:29 -07001071 if (mEffectInterface == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001072 return NO_INIT;
1073 }
Eric Laurentd0ebb532013-04-02 16:41:41 -07001074 if (mStatus != NO_ERROR) {
1075 return mStatus;
1076 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001077 status_t cmdStatus;
1078 uint32_t size = sizeof(status_t);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001079 status_t status = mEffectInterface->command(EFFECT_CMD_ENABLE,
1080 0,
1081 NULL,
1082 &size,
1083 &cmdStatus);
Eric Laurentca7cc822012-11-19 14:55:58 -08001084 if (status == 0) {
1085 status = cmdStatus;
1086 }
Eric Laurentcb4b6e92014-10-01 14:26:10 -07001087 if (status == 0) {
Eric Laurent1b928682014-10-02 19:41:47 -07001088 addEffectToHal_l();
Eric Laurentca7cc822012-11-19 14:55:58 -08001089 }
1090 return status;
1091}
1092
Andy Hung6ac17eb2023-06-20 18:56:17 -07001093status_t EffectModule::stop()
Eric Laurentca7cc822012-11-19 14:55:58 -08001094{
1095 Mutex::Autolock _l(mLock);
1096 return stop_l();
1097}
1098
Andy Hung6ac17eb2023-06-20 18:56:17 -07001099status_t EffectModule::stop_l()
Eric Laurentca7cc822012-11-19 14:55:58 -08001100{
Mikhail Naganov1dc98672016-08-18 17:50:29 -07001101 if (mEffectInterface == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001102 return NO_INIT;
1103 }
Eric Laurentd0ebb532013-04-02 16:41:41 -07001104 if (mStatus != NO_ERROR) {
1105 return mStatus;
1106 }
Eric Laurentbfb1b832013-01-07 09:53:42 -08001107 status_t cmdStatus = NO_ERROR;
Eric Laurentca7cc822012-11-19 14:55:58 -08001108 uint32_t size = sizeof(status_t);
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001109
1110 if (isVolumeControl() && isOffloadedOrDirect()) {
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001111 // We have the EffectChain and EffectModule lock, permit a reentrant call to setVolume:
1112 // resetVolume_l --> setVolume_l --> EffectModule::setVolume
1113 mSetVolumeReentrantTid = gettid();
Andy Hungfda44002021-06-03 17:23:16 -07001114 getCallback()->resetVolume();
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001115 mSetVolumeReentrantTid = INVALID_PID;
1116 }
1117
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001118 status_t status = mEffectInterface->command(EFFECT_CMD_DISABLE,
1119 0,
1120 NULL,
1121 &size,
1122 &cmdStatus);
Eric Laurentbfb1b832013-01-07 09:53:42 -08001123 if (status == NO_ERROR) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001124 status = cmdStatus;
1125 }
Eric Laurentbfb1b832013-01-07 09:53:42 -08001126 if (status == NO_ERROR) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08001127 status = removeEffectFromHal_l();
Eric Laurentbfb1b832013-01-07 09:53:42 -08001128 }
1129 return status;
1130}
1131
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001132// must be called with EffectChain::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -07001133void EffectModule::release_l()
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001134{
1135 if (mEffectInterface != 0) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08001136 removeEffectFromHal_l();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001137 // release effect engine
Mikhail Naganov022b9952017-01-04 16:36:51 -08001138 mEffectInterface->close();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001139 mEffectInterface.clear();
1140 }
1141}
1142
Andy Hung6ac17eb2023-06-20 18:56:17 -07001143status_t EffectModule::removeEffectFromHal_l()
Eric Laurentbfb1b832013-01-07 09:53:42 -08001144{
1145 if ((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_PRE_PROC ||
1146 (mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_POST_PROC) {
Eric Laurent9f57aa82023-03-17 19:28:37 +01001147 if (mCurrentHalStream != getCallback()->io()) {
1148 return (mCurrentHalStream == AUDIO_IO_HANDLE_NONE) ? NO_ERROR : INVALID_OPERATION;
David Li6c8ac4b2021-06-22 22:17:52 +08001149 }
Andy Hungfda44002021-06-03 17:23:16 -07001150 getCallback()->removeEffectFromHal(mEffectInterface);
Eric Laurent9f57aa82023-03-17 19:28:37 +01001151 mCurrentHalStream = AUDIO_IO_HANDLE_NONE;
Eric Laurentca7cc822012-11-19 14:55:58 -08001152 }
Eric Laurentbfb1b832013-01-07 09:53:42 -08001153 return NO_ERROR;
Eric Laurentca7cc822012-11-19 14:55:58 -08001154}
1155
Andy Hunge4a1d912016-08-17 14:11:13 -07001156// round up delta valid if value and divisor are positive.
1157template <typename T>
1158static T roundUpDelta(const T &value, const T &divisor) {
1159 T remainder = value % divisor;
1160 return remainder == 0 ? 0 : divisor - remainder;
1161}
1162
Andy Hung6ac17eb2023-06-20 18:56:17 -07001163status_t EffectModule::command(int32_t cmdCode,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001164 const std::vector<uint8_t>& cmdData,
1165 int32_t maxReplySize,
1166 std::vector<uint8_t>* reply)
Eric Laurentca7cc822012-11-19 14:55:58 -08001167{
1168 Mutex::Autolock _l(mLock);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001169 ALOGVV("command(), cmdCode: %d, mEffectInterface: %p", cmdCode, mEffectInterface.get());
Eric Laurentca7cc822012-11-19 14:55:58 -08001170
Mikhail Naganov1dc98672016-08-18 17:50:29 -07001171 if (mState == DESTROYED || mEffectInterface == 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001172 return NO_INIT;
1173 }
Eric Laurentd0ebb532013-04-02 16:41:41 -07001174 if (mStatus != NO_ERROR) {
1175 return mStatus;
1176 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001177 if (maxReplySize < 0 || maxReplySize > EFFECT_PARAM_SIZE_MAX) {
1178 return -EINVAL;
1179 }
1180 size_t cmdSize = cmdData.size();
1181 const effect_param_t* param = cmdSize >= sizeof(effect_param_t)
1182 ? reinterpret_cast<const effect_param_t*>(cmdData.data())
1183 : nullptr;
Andy Hung110bc952016-06-20 15:22:52 -07001184 if (cmdCode == EFFECT_CMD_GET_PARAM &&
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001185 (param == nullptr || param->psize > cmdSize - sizeof(effect_param_t))) {
Andy Hung6660f122016-11-04 19:40:53 -07001186 android_errorWriteLog(0x534e4554, "32438594");
Andy Hungb3456642016-11-28 13:50:21 -08001187 android_errorWriteLog(0x534e4554, "33003822");
1188 return -EINVAL;
1189 }
1190 if (cmdCode == EFFECT_CMD_GET_PARAM &&
Andy Hung920f6572022-10-06 12:09:49 -07001191 (maxReplySize < static_cast<signed>(sizeof(effect_param_t)) ||
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001192 param->psize > maxReplySize - sizeof(effect_param_t))) {
Andy Hungb3456642016-11-28 13:50:21 -08001193 android_errorWriteLog(0x534e4554, "29251553");
Andy Hung6660f122016-11-04 19:40:53 -07001194 return -EINVAL;
1195 }
ragoe2759072016-11-22 18:02:48 -08001196 if (cmdCode == EFFECT_CMD_GET_PARAM &&
Andy Hung920f6572022-10-06 12:09:49 -07001197 (static_cast<signed>(sizeof(effect_param_t)) > maxReplySize
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001198 || param->psize > maxReplySize - sizeof(effect_param_t)
1199 || param->vsize > maxReplySize - sizeof(effect_param_t)
1200 - param->psize
1201 || roundUpDelta(param->psize, (uint32_t) sizeof(int)) >
1202 maxReplySize
1203 - sizeof(effect_param_t)
1204 - param->psize
1205 - param->vsize)) {
ragoe2759072016-11-22 18:02:48 -08001206 ALOGV("\tLVM_ERROR : EFFECT_CMD_GET_PARAM: reply size inconsistent");
1207 android_errorWriteLog(0x534e4554, "32705438");
1208 return -EINVAL;
1209 }
Andy Hunge4a1d912016-08-17 14:11:13 -07001210 if ((cmdCode == EFFECT_CMD_SET_PARAM
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001211 || cmdCode == EFFECT_CMD_SET_PARAM_DEFERRED)
1212 && // DEFERRED not generally used
1213 (param == nullptr
1214 || param->psize > cmdSize - sizeof(effect_param_t)
1215 || param->vsize > cmdSize - sizeof(effect_param_t)
1216 - param->psize
1217 || roundUpDelta(param->psize,
1218 (uint32_t) sizeof(int)) >
1219 cmdSize
1220 - sizeof(effect_param_t)
1221 - param->psize
1222 - param->vsize)) {
Andy Hunge4a1d912016-08-17 14:11:13 -07001223 android_errorWriteLog(0x534e4554, "30204301");
1224 return -EINVAL;
1225 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001226 uint32_t replySize = maxReplySize;
1227 reply->resize(replySize);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001228 status_t status = mEffectInterface->command(cmdCode,
1229 cmdSize,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001230 const_cast<uint8_t*>(cmdData.data()),
1231 &replySize,
1232 reply->data());
1233 reply->resize(status == NO_ERROR ? replySize : 0);
Eric Laurentca7cc822012-11-19 14:55:58 -08001234 if (cmdCode != EFFECT_CMD_GET_PARAM && status == NO_ERROR) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001235 for (size_t i = 1; i < mHandles.size(); i++) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07001236 IAfEffectHandle *h = mHandles[i];
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001237 if (h != NULL && !h->disconnected()) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001238 h->commandExecuted(cmdCode, cmdData, *reply);
Eric Laurentca7cc822012-11-19 14:55:58 -08001239 }
1240 }
1241 }
1242 return status;
1243}
1244
Andy Hung6ac17eb2023-06-20 18:56:17 -07001245bool EffectModule::isProcessEnabled() const
Eric Laurentca7cc822012-11-19 14:55:58 -08001246{
Eric Laurentd0ebb532013-04-02 16:41:41 -07001247 if (mStatus != NO_ERROR) {
1248 return false;
1249 }
1250
Eric Laurentca7cc822012-11-19 14:55:58 -08001251 switch (mState) {
1252 case RESTART:
1253 case ACTIVE:
1254 case STOPPING:
1255 case STOPPED:
1256 return true;
1257 case IDLE:
1258 case STARTING:
1259 case DESTROYED:
1260 default:
1261 return false;
1262 }
1263}
1264
Andy Hung6ac17eb2023-06-20 18:56:17 -07001265bool EffectModule::isOffloadedOrDirect() const
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001266{
Andy Hungfda44002021-06-03 17:23:16 -07001267 return getCallback()->isOffloadOrDirect();
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001268}
1269
Andy Hung6ac17eb2023-06-20 18:56:17 -07001270bool EffectModule::isVolumeControlEnabled() const
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001271{
1272 return (isVolumeControl() && (isOffloadedOrDirect() ? isEnabled() : isProcessEnabled()));
1273}
1274
Andy Hung6ac17eb2023-06-20 18:56:17 -07001275void EffectModule::setInBuffer(const sp<EffectBufferHalInterface>& buffer) {
rago94a1ee82017-07-21 15:11:02 -07001276 ALOGVV("setInBuffer %p",(&buffer));
Andy Hung6f88dc42017-12-13 16:19:39 -08001277
1278 // mConfig.inputCfg.buffer.frameCount may be zero if configure() is not called yet.
Mikhail Naganov022b9952017-01-04 16:36:51 -08001279 if (buffer != 0) {
1280 mConfig.inputCfg.buffer.raw = buffer->audioBuffer()->raw;
1281 buffer->setFrameCount(mConfig.inputCfg.buffer.frameCount);
1282 } else {
1283 mConfig.inputCfg.buffer.raw = NULL;
1284 }
1285 mInBuffer = buffer;
Andy Hungc15aaee2017-11-27 17:02:40 -08001286 mEffectInterface->setInBuffer(buffer);
rago94a1ee82017-07-21 15:11:02 -07001287
Andy Hungbded9c82017-11-30 18:47:35 -08001288 // aux effects do in place conversion to float - we don't allocate mInConversionBuffer.
rago94a1ee82017-07-21 15:11:02 -07001289 // Theoretically insert effects can also do in-place conversions (destroying
1290 // the original buffer) when the output buffer is identical to the input buffer,
1291 // but we don't optimize for it here.
1292 const bool auxType = (mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY;
Andy Hung9aad48c2017-11-29 10:29:19 -08001293 const uint32_t inChannelCount =
1294 audio_channel_count_from_out_mask(mConfig.inputCfg.channels);
1295 const bool formatMismatch = !mSupportsFloat || mInChannelCountRequested != inChannelCount;
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001296 if (!auxType && formatMismatch && mInBuffer != nullptr) {
rago94a1ee82017-07-21 15:11:02 -07001297 // we need to translate - create hidl shared buffer and intercept
1298 const size_t inFrameCount = mConfig.inputCfg.buffer.frameCount;
Andy Hung9aad48c2017-11-29 10:29:19 -08001299 // Use FCC_2 in case mInChannelCountRequested is mono and the effect is stereo.
1300 const uint32_t inChannels = std::max((uint32_t)FCC_2, mInChannelCountRequested);
1301 const size_t size = inChannels * inFrameCount * std::max(sizeof(int16_t), sizeof(float));
rago94a1ee82017-07-21 15:11:02 -07001302
1303 ALOGV("%s: setInBuffer updating for inChannels:%d inFrameCount:%zu total size:%zu",
1304 __func__, inChannels, inFrameCount, size);
1305
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001306 if (size > 0 && (mInConversionBuffer == nullptr
Andy Hungbded9c82017-11-30 18:47:35 -08001307 || size > mInConversionBuffer->getSize())) {
1308 mInConversionBuffer.clear();
1309 ALOGV("%s: allocating mInConversionBuffer %zu", __func__, size);
Andy Hungfda44002021-06-03 17:23:16 -07001310 (void)getCallback()->allocateHalBuffer(size, &mInConversionBuffer);
rago94a1ee82017-07-21 15:11:02 -07001311 }
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001312 if (mInConversionBuffer != nullptr) {
Andy Hungbded9c82017-11-30 18:47:35 -08001313 mInConversionBuffer->setFrameCount(inFrameCount);
1314 mEffectInterface->setInBuffer(mInConversionBuffer);
rago94a1ee82017-07-21 15:11:02 -07001315 } else if (size > 0) {
Andy Hungbded9c82017-11-30 18:47:35 -08001316 ALOGE("%s cannot create mInConversionBuffer", __func__);
rago94a1ee82017-07-21 15:11:02 -07001317 }
1318 }
Mikhail Naganov022b9952017-01-04 16:36:51 -08001319}
1320
Andy Hung6ac17eb2023-06-20 18:56:17 -07001321void EffectModule::setOutBuffer(const sp<EffectBufferHalInterface>& buffer) {
rago94a1ee82017-07-21 15:11:02 -07001322 ALOGVV("setOutBuffer %p",(&buffer));
Andy Hung6f88dc42017-12-13 16:19:39 -08001323
1324 // mConfig.outputCfg.buffer.frameCount may be zero if configure() is not called yet.
Mikhail Naganov022b9952017-01-04 16:36:51 -08001325 if (buffer != 0) {
1326 mConfig.outputCfg.buffer.raw = buffer->audioBuffer()->raw;
1327 buffer->setFrameCount(mConfig.outputCfg.buffer.frameCount);
1328 } else {
1329 mConfig.outputCfg.buffer.raw = NULL;
1330 }
1331 mOutBuffer = buffer;
Andy Hungc15aaee2017-11-27 17:02:40 -08001332 mEffectInterface->setOutBuffer(buffer);
rago94a1ee82017-07-21 15:11:02 -07001333
Andy Hungbded9c82017-11-30 18:47:35 -08001334 // Note: Any effect that does not accumulate does not need mOutConversionBuffer and
rago94a1ee82017-07-21 15:11:02 -07001335 // can do in-place conversion from int16_t to float. We don't optimize here.
Andy Hung9aad48c2017-11-29 10:29:19 -08001336 const uint32_t outChannelCount =
1337 audio_channel_count_from_out_mask(mConfig.outputCfg.channels);
1338 const bool formatMismatch = !mSupportsFloat || mOutChannelCountRequested != outChannelCount;
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001339 if (formatMismatch && mOutBuffer != nullptr) {
rago94a1ee82017-07-21 15:11:02 -07001340 const size_t outFrameCount = mConfig.outputCfg.buffer.frameCount;
Andy Hung9aad48c2017-11-29 10:29:19 -08001341 // Use FCC_2 in case mOutChannelCountRequested is mono and the effect is stereo.
1342 const uint32_t outChannels = std::max((uint32_t)FCC_2, mOutChannelCountRequested);
1343 const size_t size = outChannels * outFrameCount * std::max(sizeof(int16_t), sizeof(float));
rago94a1ee82017-07-21 15:11:02 -07001344
1345 ALOGV("%s: setOutBuffer updating for outChannels:%d outFrameCount:%zu total size:%zu",
1346 __func__, outChannels, outFrameCount, size);
1347
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001348 if (size > 0 && (mOutConversionBuffer == nullptr
Andy Hungbded9c82017-11-30 18:47:35 -08001349 || size > mOutConversionBuffer->getSize())) {
1350 mOutConversionBuffer.clear();
1351 ALOGV("%s: allocating mOutConversionBuffer %zu", __func__, size);
Andy Hungfda44002021-06-03 17:23:16 -07001352 (void)getCallback()->allocateHalBuffer(size, &mOutConversionBuffer);
rago94a1ee82017-07-21 15:11:02 -07001353 }
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001354 if (mOutConversionBuffer != nullptr) {
Andy Hungbded9c82017-11-30 18:47:35 -08001355 mOutConversionBuffer->setFrameCount(outFrameCount);
1356 mEffectInterface->setOutBuffer(mOutConversionBuffer);
rago94a1ee82017-07-21 15:11:02 -07001357 } else if (size > 0) {
Andy Hungbded9c82017-11-30 18:47:35 -08001358 ALOGE("%s cannot create mOutConversionBuffer", __func__);
rago94a1ee82017-07-21 15:11:02 -07001359 }
1360 }
Mikhail Naganov022b9952017-01-04 16:36:51 -08001361}
1362
Andy Hung6ac17eb2023-06-20 18:56:17 -07001363status_t EffectModule::setVolume(uint32_t *left, uint32_t *right, bool controller)
Eric Laurentca7cc822012-11-19 14:55:58 -08001364{
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001365 AutoLockReentrant _l(mLock, mSetVolumeReentrantTid);
Eric Laurentd0ebb532013-04-02 16:41:41 -07001366 if (mStatus != NO_ERROR) {
1367 return mStatus;
1368 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001369 status_t status = NO_ERROR;
Eric Laurentca7cc822012-11-19 14:55:58 -08001370 // Send volume indication if EFFECT_FLAG_VOLUME_IND is set and read back altered volume
1371 // if controller flag is set (Note that controller == TRUE => EFFECT_FLAG_VOLUME_CTRL set)
1372 if (isProcessEnabled() &&
1373 ((mDescriptor.flags & EFFECT_FLAG_VOLUME_MASK) == EFFECT_FLAG_VOLUME_CTRL ||
Jasmine Cha934ecfb2019-01-23 18:19:14 +08001374 (mDescriptor.flags & EFFECT_FLAG_VOLUME_MASK) == EFFECT_FLAG_VOLUME_IND ||
1375 (mDescriptor.flags & EFFECT_FLAG_VOLUME_MASK) == EFFECT_FLAG_VOLUME_MONITOR)) {
jiabin4e246532022-08-23 16:37:30 -07001376 status = setVolumeInternal(left, right, controller);
1377 }
1378 return status;
1379}
1380
Andy Hung6ac17eb2023-06-20 18:56:17 -07001381status_t EffectModule::setVolumeInternal(
jiabin4e246532022-08-23 16:37:30 -07001382 uint32_t *left, uint32_t *right, bool controller) {
1383 uint32_t volume[2] = {*left, *right};
1384 uint32_t *pVolume = controller ? volume : nullptr;
1385 uint32_t size = sizeof(volume);
1386 status_t status = mEffectInterface->command(EFFECT_CMD_SET_VOLUME,
1387 size,
1388 volume,
1389 &size,
1390 pVolume);
1391 if (controller && status == NO_ERROR && size == sizeof(volume)) {
1392 *left = volume[0];
1393 *right = volume[1];
Eric Laurentca7cc822012-11-19 14:55:58 -08001394 }
1395 return status;
1396}
1397
Andy Hung6ac17eb2023-06-20 18:56:17 -07001398void EffectChain::setVolumeForOutput_l(uint32_t left, uint32_t right)
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001399{
Zhou Songd505c642020-02-20 16:35:37 +08001400 // for offload or direct thread, if the effect chain has non-offloadable
1401 // effect and any effect module within the chain has volume control, then
1402 // volume control is delegated to effect, otherwise, set volume to hal.
1403 if (mEffectCallback->isOffloadOrDirect() &&
1404 !(isNonOffloadableEnabled_l() && hasVolumeControlEnabled_l())) {
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001405 float vol_l = (float)left / (1 << 24);
1406 float vol_r = (float)right / (1 << 24);
Eric Laurent6b446ce2019-12-13 10:56:31 -08001407 mEffectCallback->setVolumeForOutput(vol_l, vol_r);
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09001408 }
1409}
1410
Andy Hung6ac17eb2023-06-20 18:56:17 -07001411status_t EffectModule::sendSetAudioDevicesCommand(
jiabin8f278ee2019-11-11 12:16:27 -08001412 const AudioDeviceTypeAddrVector &devices, uint32_t cmdCode)
Eric Laurentca7cc822012-11-19 14:55:58 -08001413{
jiabin8f278ee2019-11-11 12:16:27 -08001414 audio_devices_t deviceType = deviceTypesToBitMask(getAudioDeviceTypes(devices));
1415 if (deviceType == AUDIO_DEVICE_NONE) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001416 return NO_ERROR;
1417 }
1418
1419 Mutex::Autolock _l(mLock);
Eric Laurentd0ebb532013-04-02 16:41:41 -07001420 if (mStatus != NO_ERROR) {
1421 return mStatus;
1422 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001423 status_t status = NO_ERROR;
Eric Laurent7e1139c2013-06-06 18:29:01 -07001424 if ((mDescriptor.flags & EFFECT_FLAG_DEVICE_MASK) == EFFECT_FLAG_DEVICE_IND) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001425 status_t cmdStatus;
1426 uint32_t size = sizeof(status_t);
jiabin8f278ee2019-11-11 12:16:27 -08001427 // FIXME: use audio device types and addresses when the hal interface is ready.
1428 status = mEffectInterface->command(cmdCode,
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001429 sizeof(uint32_t),
jiabin8f278ee2019-11-11 12:16:27 -08001430 &deviceType,
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001431 &size,
1432 &cmdStatus);
Eric Laurentca7cc822012-11-19 14:55:58 -08001433 }
1434 return status;
1435}
1436
Andy Hung6ac17eb2023-06-20 18:56:17 -07001437status_t EffectModule::setDevices(const AudioDeviceTypeAddrVector &devices)
jiabin8f278ee2019-11-11 12:16:27 -08001438{
1439 return sendSetAudioDevicesCommand(devices, EFFECT_CMD_SET_DEVICE);
1440}
1441
Andy Hung6ac17eb2023-06-20 18:56:17 -07001442status_t EffectModule::setInputDevice(const AudioDeviceTypeAddr &device)
jiabin8f278ee2019-11-11 12:16:27 -08001443{
1444 return sendSetAudioDevicesCommand({device}, EFFECT_CMD_SET_INPUT_DEVICE);
1445}
1446
Andy Hung6ac17eb2023-06-20 18:56:17 -07001447status_t EffectModule::setMode(audio_mode_t mode)
Eric Laurentca7cc822012-11-19 14:55:58 -08001448{
1449 Mutex::Autolock _l(mLock);
Eric Laurentd0ebb532013-04-02 16:41:41 -07001450 if (mStatus != NO_ERROR) {
1451 return mStatus;
1452 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001453 status_t status = NO_ERROR;
1454 if ((mDescriptor.flags & EFFECT_FLAG_AUDIO_MODE_MASK) == EFFECT_FLAG_AUDIO_MODE_IND) {
1455 status_t cmdStatus;
1456 uint32_t size = sizeof(status_t);
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001457 status = mEffectInterface->command(EFFECT_CMD_SET_AUDIO_MODE,
1458 sizeof(audio_mode_t),
1459 &mode,
1460 &size,
1461 &cmdStatus);
Eric Laurentca7cc822012-11-19 14:55:58 -08001462 if (status == NO_ERROR) {
1463 status = cmdStatus;
1464 }
1465 }
1466 return status;
1467}
1468
Andy Hung6ac17eb2023-06-20 18:56:17 -07001469status_t EffectModule::setAudioSource(audio_source_t source)
Eric Laurentca7cc822012-11-19 14:55:58 -08001470{
1471 Mutex::Autolock _l(mLock);
Eric Laurentd0ebb532013-04-02 16:41:41 -07001472 if (mStatus != NO_ERROR) {
1473 return mStatus;
1474 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001475 status_t status = NO_ERROR;
1476 if ((mDescriptor.flags & EFFECT_FLAG_AUDIO_SOURCE_MASK) == EFFECT_FLAG_AUDIO_SOURCE_IND) {
1477 uint32_t size = 0;
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001478 status = mEffectInterface->command(EFFECT_CMD_SET_AUDIO_SOURCE,
1479 sizeof(audio_source_t),
1480 &source,
1481 &size,
1482 NULL);
Eric Laurentca7cc822012-11-19 14:55:58 -08001483 }
1484 return status;
1485}
1486
Andy Hung6ac17eb2023-06-20 18:56:17 -07001487status_t EffectModule::setOffloaded(bool offloaded, audio_io_handle_t io)
Eric Laurent5baf2af2013-09-12 17:37:00 -07001488{
1489 Mutex::Autolock _l(mLock);
1490 if (mStatus != NO_ERROR) {
1491 return mStatus;
1492 }
1493 status_t status = NO_ERROR;
1494 if ((mDescriptor.flags & EFFECT_FLAG_OFFLOAD_SUPPORTED) != 0) {
1495 status_t cmdStatus;
1496 uint32_t size = sizeof(status_t);
1497 effect_offload_param_t cmd;
1498
1499 cmd.isOffload = offloaded;
1500 cmd.ioHandle = io;
Mikhail Naganov4a3d5c22016-08-15 13:47:42 -07001501 status = mEffectInterface->command(EFFECT_CMD_OFFLOAD,
1502 sizeof(effect_offload_param_t),
1503 &cmd,
1504 &size,
1505 &cmdStatus);
Eric Laurent5baf2af2013-09-12 17:37:00 -07001506 if (status == NO_ERROR) {
1507 status = cmdStatus;
1508 }
1509 mOffloaded = (status == NO_ERROR) ? offloaded : false;
1510 } else {
1511 if (offloaded) {
1512 status = INVALID_OPERATION;
1513 }
1514 mOffloaded = false;
1515 }
1516 ALOGV("setOffloaded() offloaded %d io %d status %d", offloaded, io, status);
1517 return status;
1518}
1519
Andy Hung6ac17eb2023-06-20 18:56:17 -07001520bool EffectModule::isOffloaded() const
Eric Laurent5baf2af2013-09-12 17:37:00 -07001521{
1522 Mutex::Autolock _l(mLock);
1523 return mOffloaded;
1524}
1525
jiabineb3bda02020-06-30 14:07:03 -07001526/*static*/
Andy Hung6ac17eb2023-06-20 18:56:17 -07001527bool IAfEffectModule::isHapticGenerator(const effect_uuid_t *type) {
jiabineb3bda02020-06-30 14:07:03 -07001528 return memcmp(type, FX_IID_HAPTICGENERATOR, sizeof(effect_uuid_t)) == 0;
1529}
1530
Andy Hung6ac17eb2023-06-20 18:56:17 -07001531bool EffectModule::isHapticGenerator() const {
1532 return IAfEffectModule::isHapticGenerator(&mDescriptor.type);
jiabineb3bda02020-06-30 14:07:03 -07001533}
1534
Andy Hung6ac17eb2023-06-20 18:56:17 -07001535status_t EffectModule::setHapticIntensity(int id, os::HapticScale intensity)
jiabine70bc7f2020-06-30 22:07:55 -07001536{
1537 if (mStatus != NO_ERROR) {
1538 return mStatus;
1539 }
1540 if (!isHapticGenerator()) {
1541 ALOGW("Should not set haptic intensity for effects that are not HapticGenerator");
1542 return INVALID_OPERATION;
1543 }
1544
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001545 std::vector<uint8_t> request(sizeof(effect_param_t) + 3 * sizeof(uint32_t));
1546 effect_param_t *param = (effect_param_t*) request.data();
jiabine70bc7f2020-06-30 22:07:55 -07001547 param->psize = sizeof(int32_t);
1548 param->vsize = sizeof(int32_t) * 2;
1549 *(int32_t*)param->data = HG_PARAM_HAPTIC_INTENSITY;
1550 *((int32_t*)param->data + 1) = id;
Simon Bowden62823412022-10-17 14:52:26 +00001551 *((int32_t*)param->data + 2) = static_cast<int32_t>(intensity);
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001552 std::vector<uint8_t> response;
1553 status_t status = command(EFFECT_CMD_SET_PARAM, request, sizeof(int32_t), &response);
jiabine70bc7f2020-06-30 22:07:55 -07001554 if (status == NO_ERROR) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001555 LOG_ALWAYS_FATAL_IF(response.size() != 4);
1556 status = *reinterpret_cast<const status_t*>(response.data());
jiabine70bc7f2020-06-30 22:07:55 -07001557 }
1558 return status;
1559}
1560
Andy Hung6ac17eb2023-06-20 18:56:17 -07001561status_t EffectModule::setVibratorInfo(const media::AudioVibratorInfo& vibratorInfo)
jiabin1319f5a2021-03-30 22:21:24 +00001562{
1563 if (mStatus != NO_ERROR) {
1564 return mStatus;
1565 }
1566 if (!isHapticGenerator()) {
1567 ALOGW("Should not set vibrator info for effects that are not HapticGenerator");
1568 return INVALID_OPERATION;
1569 }
1570
Lais Andradebc3f37a2021-07-02 00:13:19 +01001571 const size_t paramCount = 3;
jiabin1319f5a2021-03-30 22:21:24 +00001572 std::vector<uint8_t> request(
Lais Andradebc3f37a2021-07-02 00:13:19 +01001573 sizeof(effect_param_t) + sizeof(int32_t) + paramCount * sizeof(float));
jiabin1319f5a2021-03-30 22:21:24 +00001574 effect_param_t *param = (effect_param_t*) request.data();
1575 param->psize = sizeof(int32_t);
Lais Andradebc3f37a2021-07-02 00:13:19 +01001576 param->vsize = paramCount * sizeof(float);
jiabin1319f5a2021-03-30 22:21:24 +00001577 *(int32_t*)param->data = HG_PARAM_VIBRATOR_INFO;
1578 float* vibratorInfoPtr = reinterpret_cast<float*>(param->data + sizeof(int32_t));
Lais Andradebc3f37a2021-07-02 00:13:19 +01001579 vibratorInfoPtr[0] = vibratorInfo.resonantFrequency;
1580 vibratorInfoPtr[1] = vibratorInfo.qFactor;
1581 vibratorInfoPtr[2] = vibratorInfo.maxAmplitude;
jiabin1319f5a2021-03-30 22:21:24 +00001582 std::vector<uint8_t> response;
1583 status_t status = command(EFFECT_CMD_SET_PARAM, request, sizeof(int32_t), &response);
1584 if (status == NO_ERROR) {
1585 LOG_ALWAYS_FATAL_IF(response.size() != sizeof(status_t));
1586 status = *reinterpret_cast<const status_t*>(response.data());
1587 }
1588 return status;
1589}
1590
Andy Hung6ac17eb2023-06-20 18:56:17 -07001591status_t EffectModule::getConfigs(
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001592 audio_config_base_t* inputCfg, audio_config_base_t* outputCfg, bool* isOutput) const {
1593 Mutex::Autolock _l(mLock);
1594 if (mConfig.inputCfg.mask == 0 || mConfig.outputCfg.mask == 0) {
1595 return NO_INIT;
1596 }
1597 inputCfg->sample_rate = mConfig.inputCfg.samplingRate;
1598 inputCfg->channel_mask = static_cast<audio_channel_mask_t>(mConfig.inputCfg.channels);
1599 inputCfg->format = static_cast<audio_format_t>(mConfig.inputCfg.format);
1600 outputCfg->sample_rate = mConfig.outputCfg.samplingRate;
1601 outputCfg->channel_mask = static_cast<audio_channel_mask_t>(mConfig.outputCfg.channels);
1602 outputCfg->format = static_cast<audio_format_t>(mConfig.outputCfg.format);
1603 *isOutput = mIsOutput;
1604 return NO_ERROR;
1605}
1606
Andy Hungbded9c82017-11-30 18:47:35 -08001607static std::string dumpInOutBuffer(bool isInput, const sp<EffectBufferHalInterface> &buffer) {
1608 std::stringstream ss;
1609
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08001610 if (buffer == nullptr) {
Andy Hungbded9c82017-11-30 18:47:35 -08001611 return "nullptr"; // make different than below
1612 } else if (buffer->externalData() != nullptr) {
1613 ss << (isInput ? buffer->externalData() : buffer->audioBuffer()->raw)
1614 << " -> "
1615 << (isInput ? buffer->audioBuffer()->raw : buffer->externalData());
1616 } else {
1617 ss << buffer->audioBuffer()->raw;
1618 }
1619 return ss.str();
1620}
Marco Nelissenb2208842014-02-07 14:00:50 -08001621
Andy Hung6ac17eb2023-06-20 18:56:17 -07001622void EffectModule::dump(int fd, const Vector<String16>& args) const
Andy Hung920f6572022-10-06 12:09:49 -07001623NO_THREAD_SAFETY_ANALYSIS // conditional try lock
Eric Laurentca7cc822012-11-19 14:55:58 -08001624{
Eric Laurent41709552019-12-16 19:34:05 -08001625 EffectBase::dump(fd, args);
1626
Eric Laurentca7cc822012-11-19 14:55:58 -08001627 String8 result;
Andy Hung0a51b5c2023-07-18 20:54:44 -07001628 const bool locked = afutils::dumpTryLock(mLock);
Eric Laurentca7cc822012-11-19 14:55:58 -08001629
Eric Laurent41709552019-12-16 19:34:05 -08001630 result.append("\t\tStatus Engine:\n");
1631 result.appendFormat("\t\t%03d %p\n",
1632 mStatus, mEffectInterface.get());
Andy Hung9718d662017-12-22 17:57:39 -08001633
1634 result.appendFormat("\t\t- data: %s\n", mSupportsFloat ? "float" : "int16");
Eric Laurentca7cc822012-11-19 14:55:58 -08001635
1636 result.append("\t\t- Input configuration:\n");
Andy Hung9718d662017-12-22 17:57:39 -08001637 result.append("\t\t\tBuffer Frames Smp rate Channels Format\n");
1638 result.appendFormat("\t\t\t%p %05zu %05d %08x %6d (%s)\n",
1639 mConfig.inputCfg.buffer.raw,
Eric Laurentca7cc822012-11-19 14:55:58 -08001640 mConfig.inputCfg.buffer.frameCount,
1641 mConfig.inputCfg.samplingRate,
1642 mConfig.inputCfg.channels,
Marco Nelissenb2208842014-02-07 14:00:50 -08001643 mConfig.inputCfg.format,
Andy Hung5fd10da2023-07-19 11:31:15 -07001644 toString(static_cast<audio_format_t>(mConfig.inputCfg.format)).c_str());
Eric Laurentca7cc822012-11-19 14:55:58 -08001645
1646 result.append("\t\t- Output configuration:\n");
1647 result.append("\t\t\tBuffer Frames Smp rate Channels Format\n");
Andy Hung9718d662017-12-22 17:57:39 -08001648 result.appendFormat("\t\t\t%p %05zu %05d %08x %6d (%s)\n",
Kévin PETIT377b2ec2014-02-03 12:35:36 +00001649 mConfig.outputCfg.buffer.raw,
Eric Laurentca7cc822012-11-19 14:55:58 -08001650 mConfig.outputCfg.buffer.frameCount,
1651 mConfig.outputCfg.samplingRate,
1652 mConfig.outputCfg.channels,
Marco Nelissenb2208842014-02-07 14:00:50 -08001653 mConfig.outputCfg.format,
Andy Hung5fd10da2023-07-19 11:31:15 -07001654 toString(static_cast<audio_format_t>(mConfig.outputCfg.format)).c_str());
Eric Laurentca7cc822012-11-19 14:55:58 -08001655
Andy Hungbded9c82017-11-30 18:47:35 -08001656 result.appendFormat("\t\t- HAL buffers:\n"
1657 "\t\t\tIn(%s) InConversion(%s) Out(%s) OutConversion(%s)\n",
1658 dumpInOutBuffer(true /* isInput */, mInBuffer).c_str(),
1659 dumpInOutBuffer(true /* isInput */, mInConversionBuffer).c_str(),
1660 dumpInOutBuffer(false /* isInput */, mOutBuffer).c_str(),
1661 dumpInOutBuffer(false /* isInput */, mOutConversionBuffer).c_str());
rago94a1ee82017-07-21 15:11:02 -07001662
Eric Laurentca7cc822012-11-19 14:55:58 -08001663 write(fd, result.string(), result.length());
1664
Mikhail Naganov4d547672019-02-22 14:19:19 -08001665 if (mEffectInterface != 0) {
1666 dprintf(fd, "\tEffect ID %d HAL dump:\n", mId);
1667 (void)mEffectInterface->dump(fd);
1668 }
1669
Eric Laurentca7cc822012-11-19 14:55:58 -08001670 if (locked) {
1671 mLock.unlock();
1672 }
1673}
1674
1675// ----------------------------------------------------------------------------
1676// EffectHandle implementation
1677// ----------------------------------------------------------------------------
1678
1679#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -07001680#define LOG_TAG "EffectHandle"
Eric Laurentca7cc822012-11-19 14:55:58 -08001681
Andy Hung6ac17eb2023-06-20 18:56:17 -07001682/* static */
1683sp<IAfEffectHandle> IAfEffectHandle::create(
1684 const sp<IAfEffectBase>& effect,
Andy Hung59867e42023-06-27 17:05:02 -07001685 const sp<Client>& client,
Andy Hung6ac17eb2023-06-20 18:56:17 -07001686 const sp<media::IEffectClient>& effectClient,
1687 int32_t priority, bool notifyFramesProcessed)
1688{
1689 return sp<EffectHandle>::make(
Andy Hung59867e42023-06-27 17:05:02 -07001690 effect, client, effectClient, priority, notifyFramesProcessed);
Andy Hung6ac17eb2023-06-20 18:56:17 -07001691}
1692
1693EffectHandle::EffectHandle(const sp<IAfEffectBase>& effect,
Andy Hung59867e42023-06-27 17:05:02 -07001694 const sp<Client>& client,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001695 const sp<media::IEffectClient>& effectClient,
Eric Laurentde8caf42021-08-11 17:19:25 +02001696 int32_t priority, bool notifyFramesProcessed)
Eric Laurentca7cc822012-11-19 14:55:58 -08001697 : BnEffect(),
1698 mEffect(effect), mEffectClient(effectClient), mClient(client), mCblk(NULL),
Eric Laurentde8caf42021-08-11 17:19:25 +02001699 mPriority(priority), mHasControl(false), mEnabled(false), mDisconnected(false),
1700 mNotifyFramesProcessed(notifyFramesProcessed)
Eric Laurentca7cc822012-11-19 14:55:58 -08001701{
Eric Laurentb82e6b72019-11-22 17:25:04 -08001702 ALOGV("constructor %p client %p", this, client.get());
Andy Hung225aef62022-12-06 16:33:20 -08001703 setMinSchedulerPolicy(SCHED_NORMAL, ANDROID_PRIORITY_AUDIO);
Eric Laurentca7cc822012-11-19 14:55:58 -08001704
1705 if (client == 0) {
1706 return;
1707 }
1708 int bufOffset = ((sizeof(effect_param_cblk_t) - 1) / sizeof(int) + 1) * sizeof(int);
Atneya3c61d882021-09-20 14:52:15 -04001709 mCblkMemory = client->allocator().allocate(mediautils::NamedAllocRequest{
1710 {static_cast<size_t>(EFFECT_PARAM_BUFFER_SIZE + bufOffset)},
1711 std::string("Effect ID: ")
1712 .append(std::to_string(effect->id()))
1713 .append(" Session ID: ")
1714 .append(std::to_string(static_cast<int>(effect->sessionId())))
1715 .append(" \n")
1716 });
Glenn Kastene75da402013-11-20 13:54:52 -08001717 if (mCblkMemory == 0 ||
Ytai Ben-Tsvi7dd39722019-09-05 15:14:30 -07001718 (mCblk = static_cast<effect_param_cblk_t *>(mCblkMemory->unsecurePointer())) == NULL) {
Glenn Kastenc42e9b42016-03-21 11:35:03 -07001719 ALOGE("not enough memory for Effect size=%zu", EFFECT_PARAM_BUFFER_SIZE +
Eric Laurentca7cc822012-11-19 14:55:58 -08001720 sizeof(effect_param_cblk_t));
Glenn Kastene75da402013-11-20 13:54:52 -08001721 mCblkMemory.clear();
Eric Laurentca7cc822012-11-19 14:55:58 -08001722 return;
1723 }
Glenn Kastene75da402013-11-20 13:54:52 -08001724 new(mCblk) effect_param_cblk_t();
1725 mBuffer = (uint8_t *)mCblk + bufOffset;
Eric Laurentca7cc822012-11-19 14:55:58 -08001726}
1727
Andy Hung6ac17eb2023-06-20 18:56:17 -07001728EffectHandle::~EffectHandle()
Eric Laurentca7cc822012-11-19 14:55:58 -08001729{
1730 ALOGV("Destructor %p", this);
Eric Laurentca7cc822012-11-19 14:55:58 -08001731 disconnect(false);
1732}
1733
Andy Hungc747c532022-03-07 21:41:14 -08001734// Creates an association between Binder code to name for IEffect.
1735#define IEFFECT_BINDER_METHOD_MACRO_LIST \
1736BINDER_METHOD_ENTRY(enable) \
1737BINDER_METHOD_ENTRY(disable) \
1738BINDER_METHOD_ENTRY(command) \
1739BINDER_METHOD_ENTRY(disconnect) \
1740BINDER_METHOD_ENTRY(getCblk) \
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001741BINDER_METHOD_ENTRY(getConfig) \
Andy Hungc747c532022-03-07 21:41:14 -08001742
1743// singleton for Binder Method Statistics for IEffect
1744mediautils::MethodStatistics<int>& getIEffectStatistics() {
1745 using Code = int;
1746
1747#pragma push_macro("BINDER_METHOD_ENTRY")
1748#undef BINDER_METHOD_ENTRY
1749#define BINDER_METHOD_ENTRY(ENTRY) \
1750 {(Code)media::BnEffect::TRANSACTION_##ENTRY, #ENTRY},
1751
1752 static mediautils::MethodStatistics<Code> methodStatistics{
1753 IEFFECT_BINDER_METHOD_MACRO_LIST
1754 METHOD_STATISTICS_BINDER_CODE_NAMES(Code)
1755 };
1756#pragma pop_macro("BINDER_METHOD_ENTRY")
1757
1758 return methodStatistics;
1759}
1760
Andy Hung6ac17eb2023-06-20 18:56:17 -07001761status_t EffectHandle::onTransact(
Andy Hungc747c532022-03-07 21:41:14 -08001762 uint32_t code, const Parcel& data, Parcel* reply, uint32_t flags) {
Andy Hunga2a1ac32022-03-18 16:12:11 -07001763 const std::string methodName = getIEffectStatistics().getMethodForCode(code);
1764 mediautils::TimeCheck check(
1765 std::string("IEffect::").append(methodName),
1766 [code](bool timeout, float elapsedMs) {
1767 if (timeout) {
1768 ; // we don't timeout right now on the effect interface.
1769 } else {
1770 getIEffectStatistics().event(code, elapsedMs);
1771 }
Andy Hungf8ab0932022-06-13 19:49:43 -07001772 }, {} /* timeoutDuration */, {} /* secondChanceDuration */, false /* crashOnTimeout */);
Andy Hungc747c532022-03-07 21:41:14 -08001773 return BnEffect::onTransact(code, data, reply, flags);
1774}
1775
Andy Hung6ac17eb2023-06-20 18:56:17 -07001776status_t EffectHandle::initCheck() const
Glenn Kastene75da402013-11-20 13:54:52 -08001777{
1778 return mClient == 0 || mCblkMemory != 0 ? OK : NO_MEMORY;
1779}
1780
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001781#define RETURN(code) \
1782 *_aidl_return = (code); \
1783 return Status::ok();
1784
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001785#define VALUE_OR_RETURN_STATUS_AS_OUT(exp) \
1786 ({ \
1787 auto _tmp = (exp); \
1788 if (!_tmp.ok()) { RETURN(_tmp.error()); } \
1789 std::move(_tmp.value()); \
1790 })
1791
Andy Hung6ac17eb2023-06-20 18:56:17 -07001792Status EffectHandle::enable(int32_t* _aidl_return)
Eric Laurentca7cc822012-11-19 14:55:58 -08001793{
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001794 AutoMutex _l(mLock);
Eric Laurentca7cc822012-11-19 14:55:58 -08001795 ALOGV("enable %p", this);
Andy Hung6ac17eb2023-06-20 18:56:17 -07001796 sp<IAfEffectBase> effect = mEffect.promote();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001797 if (effect == 0 || mDisconnected) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001798 RETURN(DEAD_OBJECT);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001799 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001800 if (!mHasControl) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001801 RETURN(INVALID_OPERATION);
Eric Laurentca7cc822012-11-19 14:55:58 -08001802 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001803
1804 if (mEnabled) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001805 RETURN(NO_ERROR);
Eric Laurentca7cc822012-11-19 14:55:58 -08001806 }
1807
1808 mEnabled = true;
1809
Eric Laurent6c796322019-04-09 14:13:17 -07001810 status_t status = effect->updatePolicyState();
1811 if (status != NO_ERROR) {
1812 mEnabled = false;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001813 RETURN(status);
Eric Laurent6c796322019-04-09 14:13:17 -07001814 }
1815
Eric Laurent6b446ce2019-12-13 10:56:31 -08001816 effect->checkSuspendOnEffectEnabled(true, false /*threadLocked*/);
Eric Laurentca7cc822012-11-19 14:55:58 -08001817
1818 // checkSuspendOnEffectEnabled() can suspend this same effect when enabled
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001819 if (effect->suspended()) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001820 RETURN(NO_ERROR);
Eric Laurentca7cc822012-11-19 14:55:58 -08001821 }
1822
Eric Laurent6b446ce2019-12-13 10:56:31 -08001823 status = effect->setEnabled(true, true /*fromHandle*/);
Eric Laurentca7cc822012-11-19 14:55:58 -08001824 if (status != NO_ERROR) {
Eric Laurentca7cc822012-11-19 14:55:58 -08001825 mEnabled = false;
1826 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001827 RETURN(status);
Eric Laurentca7cc822012-11-19 14:55:58 -08001828}
1829
Andy Hung6ac17eb2023-06-20 18:56:17 -07001830Status EffectHandle::disable(int32_t* _aidl_return)
Eric Laurentca7cc822012-11-19 14:55:58 -08001831{
1832 ALOGV("disable %p", this);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001833 AutoMutex _l(mLock);
Andy Hung6ac17eb2023-06-20 18:56:17 -07001834 sp<IAfEffectBase> effect = mEffect.promote();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001835 if (effect == 0 || mDisconnected) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001836 RETURN(DEAD_OBJECT);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001837 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001838 if (!mHasControl) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001839 RETURN(INVALID_OPERATION);
Eric Laurentca7cc822012-11-19 14:55:58 -08001840 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001841
1842 if (!mEnabled) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001843 RETURN(NO_ERROR);
Eric Laurentca7cc822012-11-19 14:55:58 -08001844 }
1845 mEnabled = false;
1846
Eric Laurent6c796322019-04-09 14:13:17 -07001847 effect->updatePolicyState();
1848
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001849 if (effect->suspended()) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001850 RETURN(NO_ERROR);
Eric Laurentca7cc822012-11-19 14:55:58 -08001851 }
1852
Eric Laurent6b446ce2019-12-13 10:56:31 -08001853 status_t status = effect->setEnabled(false, true /*fromHandle*/);
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001854 RETURN(status);
Eric Laurentca7cc822012-11-19 14:55:58 -08001855}
1856
Andy Hung6ac17eb2023-06-20 18:56:17 -07001857Status EffectHandle::disconnect()
Eric Laurentca7cc822012-11-19 14:55:58 -08001858{
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001859 ALOGV("%s %p", __FUNCTION__, this);
Eric Laurentca7cc822012-11-19 14:55:58 -08001860 disconnect(true);
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001861 return Status::ok();
Eric Laurentca7cc822012-11-19 14:55:58 -08001862}
1863
Andy Hung6ac17eb2023-06-20 18:56:17 -07001864void EffectHandle::disconnect(bool unpinIfLast)
Eric Laurentca7cc822012-11-19 14:55:58 -08001865{
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001866 AutoMutex _l(mLock);
1867 ALOGV("disconnect(%s) %p", unpinIfLast ? "true" : "false", this);
1868 if (mDisconnected) {
1869 if (unpinIfLast) {
1870 android_errorWriteLog(0x534e4554, "32707507");
1871 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001872 return;
1873 }
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001874 mDisconnected = true;
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001875 {
Andy Hung6ac17eb2023-06-20 18:56:17 -07001876 sp<IAfEffectBase> effect = mEffect.promote();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001877 if (effect != 0) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08001878 if (effect->disconnectHandle(this, unpinIfLast) > 0) {
Eric Laurent6c796322019-04-09 14:13:17 -07001879 ALOGW("%s Effect handle %p disconnected after thread destruction",
1880 __func__, this);
1881 }
1882 effect->updatePolicyState();
Eric Laurentf10c7092016-12-06 17:09:56 -08001883 }
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001884 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001885
Eric Laurentca7cc822012-11-19 14:55:58 -08001886 if (mClient != 0) {
1887 if (mCblk != NULL) {
1888 // unlike ~TrackBase(), mCblk is never a local new, so don't delete
1889 mCblk->~effect_param_cblk_t(); // destroy our shared-structure.
1890 }
1891 mCblkMemory.clear(); // free the shared memory before releasing the heap it belongs to
Eric Laurent021cf962014-05-13 10:18:14 -07001892 // Client destructor must run with AudioFlinger client mutex locked
Andy Hung47c01172023-07-17 12:40:43 -07001893 Mutex::Autolock _l2(mClient->afClientCallback()->clientMutex());
Eric Laurentca7cc822012-11-19 14:55:58 -08001894 mClient.clear();
1895 }
1896}
1897
Andy Hung6ac17eb2023-06-20 18:56:17 -07001898Status EffectHandle::getCblk(media::SharedFileRegion* _aidl_return) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001899 LOG_ALWAYS_FATAL_IF(!convertIMemoryToSharedFileRegion(mCblkMemory, _aidl_return));
1900 return Status::ok();
1901}
1902
Andy Hung6ac17eb2023-06-20 18:56:17 -07001903Status EffectHandle::getConfig(
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001904 media::EffectConfig* _config, int32_t* _aidl_return) {
1905 AutoMutex _l(mLock);
Andy Hung6ac17eb2023-06-20 18:56:17 -07001906 sp<IAfEffectBase> effect = mEffect.promote();
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001907 if (effect == nullptr || mDisconnected) {
1908 RETURN(DEAD_OBJECT);
1909 }
Andy Hung6ac17eb2023-06-20 18:56:17 -07001910 sp<IAfEffectModule> effectModule = effect->asEffectModule();
Mikhail Naganov8d7da002022-04-19 21:21:23 +00001911 if (effectModule == nullptr) {
1912 RETURN(INVALID_OPERATION);
1913 }
1914 audio_config_base_t inputCfg = AUDIO_CONFIG_BASE_INITIALIZER;
1915 audio_config_base_t outputCfg = AUDIO_CONFIG_BASE_INITIALIZER;
1916 bool isOutput;
1917 status_t status = effectModule->getConfigs(&inputCfg, &outputCfg, &isOutput);
1918 if (status == NO_ERROR) {
1919 constexpr bool isInput = false; // effects always use 'OUT' channel masks.
1920 _config->inputCfg = VALUE_OR_RETURN_STATUS_AS_OUT(
1921 legacy2aidl_audio_config_base_t_AudioConfigBase(inputCfg, isInput));
1922 _config->outputCfg = VALUE_OR_RETURN_STATUS_AS_OUT(
1923 legacy2aidl_audio_config_base_t_AudioConfigBase(outputCfg, isInput));
1924 _config->isOnInputStream = !isOutput;
1925 }
1926 RETURN(status);
1927}
1928
Andy Hung6ac17eb2023-06-20 18:56:17 -07001929Status EffectHandle::command(int32_t cmdCode,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001930 const std::vector<uint8_t>& cmdData,
1931 int32_t maxResponseSize,
1932 std::vector<uint8_t>* response,
1933 int32_t* _aidl_return)
Eric Laurentca7cc822012-11-19 14:55:58 -08001934{
1935 ALOGVV("command(), cmdCode: %d, mHasControl: %d, mEffect: %p",
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001936 cmdCode, mHasControl, mEffect.unsafe_get());
Eric Laurentca7cc822012-11-19 14:55:58 -08001937
Eric Laurentc7ab3092017-06-15 18:43:46 -07001938 // reject commands reserved for internal use by audio framework if coming from outside
1939 // of audioserver
1940 switch(cmdCode) {
1941 case EFFECT_CMD_ENABLE:
1942 case EFFECT_CMD_DISABLE:
1943 case EFFECT_CMD_SET_PARAM:
1944 case EFFECT_CMD_SET_PARAM_DEFERRED:
1945 case EFFECT_CMD_SET_PARAM_COMMIT:
1946 case EFFECT_CMD_GET_PARAM:
1947 break;
1948 default:
1949 if (cmdCode >= EFFECT_CMD_FIRST_PROPRIETARY) {
1950 break;
1951 }
1952 android_errorWriteLog(0x534e4554, "62019992");
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001953 RETURN(BAD_VALUE);
Eric Laurentc7ab3092017-06-15 18:43:46 -07001954 }
1955
Eric Laurent1ffc5852016-12-15 14:46:09 -08001956 if (cmdCode == EFFECT_CMD_ENABLE) {
Andy Hung920f6572022-10-06 12:09:49 -07001957 if (maxResponseSize < static_cast<signed>(sizeof(int))) {
Eric Laurent1ffc5852016-12-15 14:46:09 -08001958 android_errorWriteLog(0x534e4554, "32095713");
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001959 RETURN(BAD_VALUE);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001960 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001961 writeToBuffer(NO_ERROR, response);
1962 return enable(_aidl_return);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001963 } else if (cmdCode == EFFECT_CMD_DISABLE) {
Andy Hung920f6572022-10-06 12:09:49 -07001964 if (maxResponseSize < static_cast<signed>(sizeof(int))) {
Eric Laurent1ffc5852016-12-15 14:46:09 -08001965 android_errorWriteLog(0x534e4554, "32095713");
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001966 RETURN(BAD_VALUE);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001967 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001968 writeToBuffer(NO_ERROR, response);
1969 return disable(_aidl_return);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001970 }
1971
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001972 AutoMutex _l(mLock);
Andy Hung6ac17eb2023-06-20 18:56:17 -07001973 sp<IAfEffectBase> effect = mEffect.promote();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001974 if (effect == 0 || mDisconnected) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001975 RETURN(DEAD_OBJECT);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08001976 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001977 // only get parameter command is permitted for applications not controlling the effect
1978 if (!mHasControl && cmdCode != EFFECT_CMD_GET_PARAM) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001979 RETURN(INVALID_OPERATION);
Eric Laurentca7cc822012-11-19 14:55:58 -08001980 }
Eric Laurentca7cc822012-11-19 14:55:58 -08001981
1982 // handle commands that are not forwarded transparently to effect engine
1983 if (cmdCode == EFFECT_CMD_SET_PARAM_COMMIT) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08001984 if (mClient == 0) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001985 RETURN(INVALID_OPERATION);
Eric Laurentb82e6b72019-11-22 17:25:04 -08001986 }
1987
Andy Hung920f6572022-10-06 12:09:49 -07001988 if (maxResponseSize < (signed)sizeof(int)) {
Eric Laurent1ffc5852016-12-15 14:46:09 -08001989 android_errorWriteLog(0x534e4554, "32095713");
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001990 RETURN(BAD_VALUE);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001991 }
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07001992 writeToBuffer(NO_ERROR, response);
Eric Laurent1ffc5852016-12-15 14:46:09 -08001993
Eric Laurentca7cc822012-11-19 14:55:58 -08001994 // No need to trylock() here as this function is executed in the binder thread serving a
1995 // particular client process: no risk to block the whole media server process or mixer
1996 // threads if we are stuck here
Andy Hung920f6572022-10-06 12:09:49 -07001997 Mutex::Autolock _l2(mCblk->lock);
Andy Hunga447a0f2016-11-15 17:19:58 -08001998 // keep local copy of index in case of client corruption b/32220769
1999 const uint32_t clientIndex = mCblk->clientIndex;
2000 const uint32_t serverIndex = mCblk->serverIndex;
2001 if (clientIndex > EFFECT_PARAM_BUFFER_SIZE ||
2002 serverIndex > EFFECT_PARAM_BUFFER_SIZE) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002003 mCblk->serverIndex = 0;
2004 mCblk->clientIndex = 0;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002005 RETURN(BAD_VALUE);
Eric Laurentca7cc822012-11-19 14:55:58 -08002006 }
2007 status_t status = NO_ERROR;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002008 std::vector<uint8_t> param;
Andy Hunga447a0f2016-11-15 17:19:58 -08002009 for (uint32_t index = serverIndex; index < clientIndex;) {
2010 int *p = (int *)(mBuffer + index);
2011 const int size = *p++;
2012 if (size < 0
2013 || size > EFFECT_PARAM_BUFFER_SIZE
2014 || ((uint8_t *)p + size) > mBuffer + clientIndex) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002015 ALOGW("command(): invalid parameter block size");
Andy Hunga447a0f2016-11-15 17:19:58 -08002016 status = BAD_VALUE;
Eric Laurentca7cc822012-11-19 14:55:58 -08002017 break;
2018 }
Andy Hunga447a0f2016-11-15 17:19:58 -08002019
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002020 std::copy(reinterpret_cast<const uint8_t*>(p),
2021 reinterpret_cast<const uint8_t*>(p) + size,
2022 std::back_inserter(param));
Andy Hunga447a0f2016-11-15 17:19:58 -08002023
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002024 std::vector<uint8_t> replyBuffer;
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002025 status_t ret = effect->command(EFFECT_CMD_SET_PARAM,
Andy Hunga447a0f2016-11-15 17:19:58 -08002026 param,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002027 sizeof(int),
2028 &replyBuffer);
2029 int reply = *reinterpret_cast<const int*>(replyBuffer.data());
Andy Hunga447a0f2016-11-15 17:19:58 -08002030
2031 // verify shared memory: server index shouldn't change; client index can't go back.
2032 if (serverIndex != mCblk->serverIndex
2033 || clientIndex > mCblk->clientIndex) {
2034 android_errorWriteLog(0x534e4554, "32220769");
2035 status = BAD_VALUE;
2036 break;
2037 }
2038
Eric Laurentca7cc822012-11-19 14:55:58 -08002039 // stop at first error encountered
2040 if (ret != NO_ERROR) {
2041 status = ret;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002042 writeToBuffer(reply, response);
Eric Laurentca7cc822012-11-19 14:55:58 -08002043 break;
2044 } else if (reply != NO_ERROR) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002045 writeToBuffer(reply, response);
Eric Laurentca7cc822012-11-19 14:55:58 -08002046 break;
2047 }
Andy Hunga447a0f2016-11-15 17:19:58 -08002048 index += size;
Eric Laurentca7cc822012-11-19 14:55:58 -08002049 }
2050 mCblk->serverIndex = 0;
2051 mCblk->clientIndex = 0;
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002052 RETURN(status);
Eric Laurentca7cc822012-11-19 14:55:58 -08002053 }
2054
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002055 status_t status = effect->command(cmdCode,
2056 cmdData,
2057 maxResponseSize,
2058 response);
2059 RETURN(status);
Eric Laurentca7cc822012-11-19 14:55:58 -08002060}
2061
Andy Hung6ac17eb2023-06-20 18:56:17 -07002062void EffectHandle::setControl(bool hasControl, bool signal, bool enabled)
Eric Laurentca7cc822012-11-19 14:55:58 -08002063{
2064 ALOGV("setControl %p control %d", this, hasControl);
2065
2066 mHasControl = hasControl;
2067 mEnabled = enabled;
2068
2069 if (signal && mEffectClient != 0) {
2070 mEffectClient->controlStatusChanged(hasControl);
2071 }
2072}
2073
Andy Hung6ac17eb2023-06-20 18:56:17 -07002074void EffectHandle::commandExecuted(uint32_t cmdCode,
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002075 const std::vector<uint8_t>& cmdData,
2076 const std::vector<uint8_t>& replyData)
Eric Laurentca7cc822012-11-19 14:55:58 -08002077{
2078 if (mEffectClient != 0) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07002079 mEffectClient->commandExecuted(cmdCode, cmdData, replyData);
Eric Laurentca7cc822012-11-19 14:55:58 -08002080 }
2081}
2082
2083
2084
Andy Hung6ac17eb2023-06-20 18:56:17 -07002085void EffectHandle::setEnabled(bool enabled)
Eric Laurentca7cc822012-11-19 14:55:58 -08002086{
2087 if (mEffectClient != 0) {
2088 mEffectClient->enableStatusChanged(enabled);
2089 }
2090}
2091
Andy Hung6ac17eb2023-06-20 18:56:17 -07002092void EffectHandle::framesProcessed(int32_t frames) const
Eric Laurentde8caf42021-08-11 17:19:25 +02002093{
2094 if (mEffectClient != 0 && mNotifyFramesProcessed) {
2095 mEffectClient->framesProcessed(frames);
2096 }
2097}
2098
Andy Hung6ac17eb2023-06-20 18:56:17 -07002099void EffectHandle::dumpToBuffer(char* buffer, size_t size) const
Andy Hung920f6572022-10-06 12:09:49 -07002100NO_THREAD_SAFETY_ANALYSIS // conditional try lock
Eric Laurentca7cc822012-11-19 14:55:58 -08002101{
Andy Hung0a51b5c2023-07-18 20:54:44 -07002102 const bool locked = mCblk != nullptr && afutils::dumpTryLock(mCblk->lock);
Eric Laurentca7cc822012-11-19 14:55:58 -08002103
Marco Nelissenb2208842014-02-07 14:00:50 -08002104 snprintf(buffer, size, "\t\t\t%5d %5d %3s %3s %5u %5u\n",
Andy Hung4ef19fa2018-05-15 19:35:29 -07002105 (mClient == 0) ? getpid() : mClient->pid(),
Eric Laurentca7cc822012-11-19 14:55:58 -08002106 mPriority,
Marco Nelissenb2208842014-02-07 14:00:50 -08002107 mHasControl ? "yes" : "no",
2108 locked ? "yes" : "no",
Eric Laurentca7cc822012-11-19 14:55:58 -08002109 mCblk ? mCblk->clientIndex : 0,
2110 mCblk ? mCblk->serverIndex : 0
2111 );
2112
2113 if (locked) {
2114 mCblk->lock.unlock();
2115 }
2116}
2117
2118#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -07002119#define LOG_TAG "EffectChain"
Eric Laurentca7cc822012-11-19 14:55:58 -08002120
Andy Hung6ac17eb2023-06-20 18:56:17 -07002121/* static */
2122sp<IAfEffectChain> IAfEffectChain::create(
Andy Hung583043b2023-07-17 17:05:00 -07002123 const sp<IAfThreadBase>& thread,
Andy Hung6ac17eb2023-06-20 18:56:17 -07002124 audio_session_t sessionId)
2125{
Andy Hung583043b2023-07-17 17:05:00 -07002126 return sp<EffectChain>::make(thread, sessionId);
Andy Hung6ac17eb2023-06-20 18:56:17 -07002127}
2128
Andy Hung583043b2023-07-17 17:05:00 -07002129EffectChain::EffectChain(const sp<IAfThreadBase>& thread,
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08002130 audio_session_t sessionId)
Eric Laurent6b446ce2019-12-13 10:56:31 -08002131 : mSessionId(sessionId), mActiveTrackCnt(0), mTrackCnt(0), mTailBufferCount(0),
Mikhail Naganov022b9952017-01-04 16:36:51 -08002132 mVolumeCtrlIdx(-1), mLeftVolume(UINT_MAX), mRightVolume(UINT_MAX),
Eric Laurent6b446ce2019-12-13 10:56:31 -08002133 mNewLeftVolume(UINT_MAX), mNewRightVolume(UINT_MAX),
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08002134 mEffectCallback(new EffectCallback(wp<EffectChain>(this), thread))
Eric Laurentca7cc822012-11-19 14:55:58 -08002135{
Andy Hung583043b2023-07-17 17:05:00 -07002136 mStrategy = thread->getStrategyForStream(AUDIO_STREAM_MUSIC);
2137 mMaxTailBuffers = ((kProcessTailDurationMs * thread->sampleRate()) / 1000) /
2138 thread->frameCount();
Eric Laurentca7cc822012-11-19 14:55:58 -08002139}
2140
Andy Hung87c693c2023-07-06 20:56:16 -07002141// getEffectFromDesc_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002142sp<IAfEffectModule> EffectChain::getEffectFromDesc_l(
2143 effect_descriptor_t *descriptor) const
Eric Laurentca7cc822012-11-19 14:55:58 -08002144{
2145 size_t size = mEffects.size();
2146
2147 for (size_t i = 0; i < size; i++) {
2148 if (memcmp(&mEffects[i]->desc().uuid, &descriptor->uuid, sizeof(effect_uuid_t)) == 0) {
2149 return mEffects[i];
2150 }
2151 }
2152 return 0;
2153}
2154
Andy Hung87c693c2023-07-06 20:56:16 -07002155// getEffectFromId_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002156sp<IAfEffectModule> EffectChain::getEffectFromId_l(int id) const
Eric Laurentca7cc822012-11-19 14:55:58 -08002157{
2158 size_t size = mEffects.size();
2159
2160 for (size_t i = 0; i < size; i++) {
2161 // by convention, return first effect if id provided is 0 (0 is never a valid id)
2162 if (id == 0 || mEffects[i]->id() == id) {
2163 return mEffects[i];
2164 }
2165 }
2166 return 0;
2167}
2168
Andy Hung87c693c2023-07-06 20:56:16 -07002169// getEffectFromType_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002170sp<IAfEffectModule> EffectChain::getEffectFromType_l(
2171 const effect_uuid_t *type) const
Eric Laurentca7cc822012-11-19 14:55:58 -08002172{
2173 size_t size = mEffects.size();
2174
2175 for (size_t i = 0; i < size; i++) {
2176 if (memcmp(&mEffects[i]->desc().type, type, sizeof(effect_uuid_t)) == 0) {
2177 return mEffects[i];
2178 }
2179 }
2180 return 0;
2181}
2182
Andy Hung6ac17eb2023-06-20 18:56:17 -07002183std::vector<int> EffectChain::getEffectIds() const
Eric Laurent6c796322019-04-09 14:13:17 -07002184{
2185 std::vector<int> ids;
2186 Mutex::Autolock _l(mLock);
2187 for (size_t i = 0; i < mEffects.size(); i++) {
2188 ids.push_back(mEffects[i]->id());
2189 }
2190 return ids;
2191}
2192
Andy Hung6ac17eb2023-06-20 18:56:17 -07002193void EffectChain::clearInputBuffer()
Eric Laurentca7cc822012-11-19 14:55:58 -08002194{
2195 Mutex::Autolock _l(mLock);
Eric Laurent6b446ce2019-12-13 10:56:31 -08002196 clearInputBuffer_l();
Eric Laurentca7cc822012-11-19 14:55:58 -08002197}
2198
2199// Must be called with EffectChain::mLock locked
Andy Hung6ac17eb2023-06-20 18:56:17 -07002200void EffectChain::clearInputBuffer_l()
Eric Laurentca7cc822012-11-19 14:55:58 -08002201{
Eric Laurent6acd1d42017-01-04 14:23:29 -08002202 if (mInBuffer == NULL) {
2203 return;
2204 }
Andy Hung319587b2023-05-23 14:01:03 -07002205 const size_t frameSize = audio_bytes_per_sample(AUDIO_FORMAT_PCM_FLOAT)
Eric Laurentf1f22e72021-07-13 14:04:14 +02002206 * mEffectCallback->inChannelCount(mEffects[0]->id());
rago94a1ee82017-07-21 15:11:02 -07002207
Eric Laurent6b446ce2019-12-13 10:56:31 -08002208 memset(mInBuffer->audioBuffer()->raw, 0, mEffectCallback->frameCount() * frameSize);
Mikhail Naganov022b9952017-01-04 16:36:51 -08002209 mInBuffer->commit();
Eric Laurentca7cc822012-11-19 14:55:58 -08002210}
2211
2212// Must be called with EffectChain::mLock locked
Andy Hung6ac17eb2023-06-20 18:56:17 -07002213void EffectChain::process_l()
Eric Laurentca7cc822012-11-19 14:55:58 -08002214{
Jean-Michel Trivifed62922013-09-25 18:50:33 -07002215 // never process effects when:
2216 // - on an OFFLOAD thread
2217 // - no more tracks are on the session and the effect tail has been rendered
Eric Laurent6b446ce2019-12-13 10:56:31 -08002218 bool doProcess = !mEffectCallback->isOffloadOrMmap();
Eric Laurent3f75a5b2019-11-12 15:55:51 -08002219 if (!audio_is_global_session(mSessionId)) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002220 bool tracksOnSession = (trackCnt() != 0);
2221
2222 if (!tracksOnSession && mTailBufferCount == 0) {
2223 doProcess = false;
2224 }
2225
2226 if (activeTrackCnt() == 0) {
2227 // if no track is active and the effect tail has not been rendered,
2228 // the input buffer must be cleared here as the mixer process will not do it
2229 if (tracksOnSession || mTailBufferCount > 0) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08002230 clearInputBuffer_l();
Eric Laurentca7cc822012-11-19 14:55:58 -08002231 if (mTailBufferCount > 0) {
2232 mTailBufferCount--;
2233 }
2234 }
2235 }
2236 }
2237
2238 size_t size = mEffects.size();
2239 if (doProcess) {
Mikhail Naganov022b9952017-01-04 16:36:51 -08002240 // Only the input and output buffers of the chain can be external,
2241 // and 'update' / 'commit' do nothing for allocated buffers, thus
2242 // it's not needed to consider any other buffers here.
2243 mInBuffer->update();
Mikhail Naganov06888802017-01-19 12:47:55 -08002244 if (mInBuffer->audioBuffer()->raw != mOutBuffer->audioBuffer()->raw) {
2245 mOutBuffer->update();
2246 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002247 for (size_t i = 0; i < size; i++) {
2248 mEffects[i]->process();
2249 }
Mikhail Naganov06888802017-01-19 12:47:55 -08002250 mInBuffer->commit();
2251 if (mInBuffer->audioBuffer()->raw != mOutBuffer->audioBuffer()->raw) {
2252 mOutBuffer->commit();
2253 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002254 }
Eric Laurentfa1e1232016-08-02 19:01:49 -07002255 bool doResetVolume = false;
Eric Laurentca7cc822012-11-19 14:55:58 -08002256 for (size_t i = 0; i < size; i++) {
Eric Laurentfa1e1232016-08-02 19:01:49 -07002257 doResetVolume = mEffects[i]->updateState() || doResetVolume;
2258 }
2259 if (doResetVolume) {
2260 resetVolume_l();
Eric Laurentca7cc822012-11-19 14:55:58 -08002261 }
2262}
2263
Andy Hung87c693c2023-07-06 20:56:16 -07002264// createEffect_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002265status_t EffectChain::createEffect_l(sp<IAfEffectModule>& effect,
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002266 effect_descriptor_t *desc,
2267 int id,
2268 audio_session_t sessionId,
2269 bool pinned)
2270{
2271 Mutex::Autolock _l(mLock);
Eric Laurentb82e6b72019-11-22 17:25:04 -08002272 effect = new EffectModule(mEffectCallback, desc, id, sessionId, pinned, AUDIO_PORT_HANDLE_NONE);
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002273 status_t lStatus = effect->status();
2274 if (lStatus == NO_ERROR) {
2275 lStatus = addEffect_ll(effect);
2276 }
2277 if (lStatus != NO_ERROR) {
2278 effect.clear();
2279 }
2280 return lStatus;
2281}
2282
Andy Hung87c693c2023-07-06 20:56:16 -07002283// addEffect_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002284status_t EffectChain::addEffect_l(const sp<IAfEffectModule>& effect)
Eric Laurentca7cc822012-11-19 14:55:58 -08002285{
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002286 Mutex::Autolock _l(mLock);
2287 return addEffect_ll(effect);
2288}
Andy Hung87c693c2023-07-06 20:56:16 -07002289// addEffect_l() must be called with IAfThreadBase::mLock and EffectChain::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002290status_t EffectChain::addEffect_ll(const sp<IAfEffectModule>& effect)
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002291{
Eric Laurent6b446ce2019-12-13 10:56:31 -08002292 effect->setCallback(mEffectCallback);
Eric Laurentca7cc822012-11-19 14:55:58 -08002293
Eric Laurentb62d0362021-10-26 17:40:18 +02002294 effect_descriptor_t desc = effect->desc();
Eric Laurentca7cc822012-11-19 14:55:58 -08002295 if ((desc.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY) {
2296 // Auxiliary effects are inserted at the beginning of mEffects vector as
2297 // they are processed first and accumulated in chain input buffer
2298 mEffects.insertAt(effect, 0);
2299
2300 // the input buffer for auxiliary effect contains mono samples in
2301 // 32 bit format. This is to avoid saturation in AudoMixer
2302 // accumulation stage. Saturation is done in EffectModule::process() before
2303 // calling the process in effect engine
Eric Laurent6b446ce2019-12-13 10:56:31 -08002304 size_t numSamples = mEffectCallback->frameCount();
Mikhail Naganov022b9952017-01-04 16:36:51 -08002305 sp<EffectBufferHalInterface> halBuffer;
Andy Hung26836922023-05-22 17:31:57 -07002306
Eric Laurent6b446ce2019-12-13 10:56:31 -08002307 status_t result = mEffectCallback->allocateHalBuffer(
rago94a1ee82017-07-21 15:11:02 -07002308 numSamples * sizeof(float), &halBuffer);
Mikhail Naganov022b9952017-01-04 16:36:51 -08002309 if (result != OK) return result;
Eric Laurentf1f22e72021-07-13 14:04:14 +02002310
2311 effect->configure();
2312
Mikhail Naganov022b9952017-01-04 16:36:51 -08002313 effect->setInBuffer(halBuffer);
Eric Laurentca7cc822012-11-19 14:55:58 -08002314 // auxiliary effects output samples to chain input buffer for further processing
2315 // by insert effects
2316 effect->setOutBuffer(mInBuffer);
2317 } else {
Eric Laurentb62d0362021-10-26 17:40:18 +02002318 ssize_t idx_insert = getInsertIndex(desc);
2319 if (idx_insert < 0) {
2320 return INVALID_OPERATION;
Eric Laurentca7cc822012-11-19 14:55:58 -08002321 }
2322
Eric Laurentb62d0362021-10-26 17:40:18 +02002323 size_t previousSize = mEffects.size();
Eric Laurentf1f22e72021-07-13 14:04:14 +02002324 mEffects.insertAt(effect, idx_insert);
2325
2326 effect->configure();
2327
Eric Laurentb62d0362021-10-26 17:40:18 +02002328 // - By default:
2329 // All effects read samples from chain input buffer.
2330 // The last effect in the chain, writes samples to chain output buffer,
2331 // otherwise to chain input buffer
2332 // - In the OUTPUT_STAGE chain of a spatializer mixer thread:
2333 // The spatializer effect (first effect) reads samples from the input buffer
2334 // and writes samples to the output buffer.
2335 // All other effects read and writes samples to the output buffer
2336 if (mEffectCallback->isSpatializer()
2337 && mSessionId == AUDIO_SESSION_OUTPUT_STAGE) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002338 effect->setOutBuffer(mOutBuffer);
Eric Laurentb62d0362021-10-26 17:40:18 +02002339 if (idx_insert == 0) {
2340 if (previousSize != 0) {
2341 mEffects[1]->configure();
2342 mEffects[1]->setInBuffer(mOutBuffer);
2343 mEffects[1]->updateAccessMode(); // reconfig if neeeded.
2344 }
2345 effect->setInBuffer(mInBuffer);
2346 } else {
2347 effect->setInBuffer(mOutBuffer);
2348 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002349 } else {
Eric Laurentb62d0362021-10-26 17:40:18 +02002350 effect->setInBuffer(mInBuffer);
Andy Hung920f6572022-10-06 12:09:49 -07002351 if (idx_insert == static_cast<ssize_t>(previousSize)) {
Eric Laurentb62d0362021-10-26 17:40:18 +02002352 if (idx_insert != 0) {
2353 mEffects[idx_insert-1]->configure();
2354 mEffects[idx_insert-1]->setOutBuffer(mInBuffer);
2355 mEffects[idx_insert - 1]->updateAccessMode(); // reconfig if neeeded.
2356 }
2357 effect->setOutBuffer(mOutBuffer);
2358 } else {
2359 effect->setOutBuffer(mInBuffer);
2360 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002361 }
Eric Laurentb62d0362021-10-26 17:40:18 +02002362 ALOGV("%s effect %p, added in chain %p at rank %zu",
2363 __func__, effect.get(), this, idx_insert);
Eric Laurentca7cc822012-11-19 14:55:58 -08002364 }
2365 effect->configure();
Eric Laurentd8365c52017-07-16 15:27:05 -07002366
Eric Laurentca7cc822012-11-19 14:55:58 -08002367 return NO_ERROR;
2368}
2369
Andy Hung6ac17eb2023-06-20 18:56:17 -07002370ssize_t EffectChain::getInsertIndex(const effect_descriptor_t& desc) {
Eric Laurentb62d0362021-10-26 17:40:18 +02002371 // Insert effects are inserted at the end of mEffects vector as they are processed
2372 // after track and auxiliary effects.
2373 // Insert effect order as a function of indicated preference:
2374 // if EFFECT_FLAG_INSERT_EXCLUSIVE, insert in first position or reject if
2375 // another effect is present
2376 // else if EFFECT_FLAG_INSERT_FIRST, insert in first position or after the
2377 // last effect claiming first position
2378 // else if EFFECT_FLAG_INSERT_LAST, insert in last position or before the
2379 // first effect claiming last position
2380 // else if EFFECT_FLAG_INSERT_ANY insert after first or before last
2381 // Reject insertion if an effect with EFFECT_FLAG_INSERT_EXCLUSIVE is
2382 // already present
2383 // Spatializer or Downmixer effects are inserted in first position because
2384 // they adapt the channel count for all other effects in the chain
2385 if ((memcmp(&desc.type, FX_IID_SPATIALIZER, sizeof(effect_uuid_t)) == 0)
2386 || (memcmp(&desc.type, EFFECT_UIID_DOWNMIX, sizeof(effect_uuid_t)) == 0)) {
2387 return 0;
2388 }
2389
2390 size_t size = mEffects.size();
2391 uint32_t insertPref = desc.flags & EFFECT_FLAG_INSERT_MASK;
2392 ssize_t idx_insert;
2393 ssize_t idx_insert_first = -1;
2394 ssize_t idx_insert_last = -1;
2395
2396 idx_insert = size;
2397 for (size_t i = 0; i < size; i++) {
2398 effect_descriptor_t d = mEffects[i]->desc();
2399 uint32_t iMode = d.flags & EFFECT_FLAG_TYPE_MASK;
2400 uint32_t iPref = d.flags & EFFECT_FLAG_INSERT_MASK;
2401 if (iMode == EFFECT_FLAG_TYPE_INSERT) {
2402 // check invalid effect chaining combinations
2403 if (insertPref == EFFECT_FLAG_INSERT_EXCLUSIVE ||
2404 iPref == EFFECT_FLAG_INSERT_EXCLUSIVE) {
2405 ALOGW("%s could not insert effect %s: exclusive conflict with %s",
2406 __func__, desc.name, d.name);
2407 return -1;
2408 }
2409 // remember position of first insert effect and by default
2410 // select this as insert position for new effect
Andy Hung920f6572022-10-06 12:09:49 -07002411 if (idx_insert == static_cast<ssize_t>(size)) {
Eric Laurentb62d0362021-10-26 17:40:18 +02002412 idx_insert = i;
2413 }
2414 // remember position of last insert effect claiming
2415 // first position
2416 if (iPref == EFFECT_FLAG_INSERT_FIRST) {
2417 idx_insert_first = i;
2418 }
2419 // remember position of first insert effect claiming
2420 // last position
2421 if (iPref == EFFECT_FLAG_INSERT_LAST &&
2422 idx_insert_last == -1) {
2423 idx_insert_last = i;
2424 }
2425 }
2426 }
2427
2428 // modify idx_insert from first position if needed
2429 if (insertPref == EFFECT_FLAG_INSERT_LAST) {
2430 if (idx_insert_last != -1) {
2431 idx_insert = idx_insert_last;
2432 } else {
2433 idx_insert = size;
2434 }
2435 } else {
2436 if (idx_insert_first != -1) {
2437 idx_insert = idx_insert_first + 1;
2438 }
2439 }
2440 return idx_insert;
2441}
2442
Andy Hung87c693c2023-07-06 20:56:16 -07002443// removeEffect_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002444size_t EffectChain::removeEffect_l(const sp<IAfEffectModule>& effect,
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002445 bool release)
Eric Laurentca7cc822012-11-19 14:55:58 -08002446{
2447 Mutex::Autolock _l(mLock);
2448 size_t size = mEffects.size();
2449 uint32_t type = effect->desc().flags & EFFECT_FLAG_TYPE_MASK;
2450
2451 for (size_t i = 0; i < size; i++) {
2452 if (effect == mEffects[i]) {
2453 // calling stop here will remove pre-processing effect from the audio HAL.
2454 // This is safe as we hold the EffectChain mutex which guarantees that we are not in
2455 // the middle of a read from audio HAL
2456 if (mEffects[i]->state() == EffectModule::ACTIVE ||
2457 mEffects[i]->state() == EffectModule::STOPPING) {
2458 mEffects[i]->stop();
2459 }
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002460 if (release) {
2461 mEffects[i]->release_l();
2462 }
2463
Mikhail Naganov022b9952017-01-04 16:36:51 -08002464 if (type != EFFECT_FLAG_TYPE_AUXILIARY) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002465 if (i == size - 1 && i != 0) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002466 mEffects[i - 1]->configure();
Eric Laurentf1f22e72021-07-13 14:04:14 +02002467 mEffects[i - 1]->setOutBuffer(mOutBuffer);
Eric Laurent6bb7dbe2021-12-23 15:39:36 +01002468 mEffects[i - 1]->updateAccessMode(); // reconfig if neeeded.
Eric Laurentca7cc822012-11-19 14:55:58 -08002469 }
2470 }
2471 mEffects.removeAt(i);
Eric Laurentf1f22e72021-07-13 14:04:14 +02002472
2473 // make sure the input buffer configuration for the new first effect in the chain
2474 // is updated if needed (can switch from HAL channel mask to mixer channel mask)
Nie Wei Feng4d2cb592023-05-26 15:18:04 -07002475 if (type != EFFECT_FLAG_TYPE_AUXILIARY // TODO(b/284522658) breaks for aux FX, why?
2476 && i == 0 && size > 1) {
Eric Laurentf1f22e72021-07-13 14:04:14 +02002477 mEffects[0]->configure();
2478 mEffects[0]->setInBuffer(mInBuffer);
Eric Laurent6bb7dbe2021-12-23 15:39:36 +01002479 mEffects[0]->updateAccessMode(); // reconfig if neeeded.
Eric Laurentf1f22e72021-07-13 14:04:14 +02002480 }
2481
Glenn Kastenc42e9b42016-03-21 11:35:03 -07002482 ALOGV("removeEffect_l() effect %p, removed from chain %p at rank %zu", effect.get(),
Eric Laurentca7cc822012-11-19 14:55:58 -08002483 this, i);
2484 break;
2485 }
2486 }
2487
2488 return mEffects.size();
2489}
2490
Andy Hung87c693c2023-07-06 20:56:16 -07002491// setDevices_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002492void EffectChain::setDevices_l(const AudioDeviceTypeAddrVector &devices)
Eric Laurentca7cc822012-11-19 14:55:58 -08002493{
2494 size_t size = mEffects.size();
2495 for (size_t i = 0; i < size; i++) {
jiabin8f278ee2019-11-11 12:16:27 -08002496 mEffects[i]->setDevices(devices);
2497 }
2498}
2499
Andy Hung87c693c2023-07-06 20:56:16 -07002500// setInputDevice_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002501void EffectChain::setInputDevice_l(const AudioDeviceTypeAddr &device)
jiabin8f278ee2019-11-11 12:16:27 -08002502{
2503 size_t size = mEffects.size();
2504 for (size_t i = 0; i < size; i++) {
2505 mEffects[i]->setInputDevice(device);
Eric Laurentca7cc822012-11-19 14:55:58 -08002506 }
2507}
2508
Andy Hung87c693c2023-07-06 20:56:16 -07002509// setMode_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002510void EffectChain::setMode_l(audio_mode_t mode)
Eric Laurentca7cc822012-11-19 14:55:58 -08002511{
2512 size_t size = mEffects.size();
2513 for (size_t i = 0; i < size; i++) {
2514 mEffects[i]->setMode(mode);
2515 }
2516}
2517
Andy Hung87c693c2023-07-06 20:56:16 -07002518// setAudioSource_l() must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002519void EffectChain::setAudioSource_l(audio_source_t source)
Eric Laurentca7cc822012-11-19 14:55:58 -08002520{
2521 size_t size = mEffects.size();
2522 for (size_t i = 0; i < size; i++) {
2523 mEffects[i]->setAudioSource(source);
2524 }
2525}
2526
Andy Hung6ac17eb2023-06-20 18:56:17 -07002527bool EffectChain::hasVolumeControlEnabled_l() const {
Zhou Songd505c642020-02-20 16:35:37 +08002528 for (const auto &effect : mEffects) {
2529 if (effect->isVolumeControlEnabled()) return true;
2530 }
2531 return false;
2532}
2533
Andy Hung87c693c2023-07-06 20:56:16 -07002534// setVolume_l() must be called with IAfThreadBase::mLock or EffectChain::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002535bool EffectChain::setVolume_l(uint32_t *left, uint32_t *right, bool force)
Eric Laurentca7cc822012-11-19 14:55:58 -08002536{
2537 uint32_t newLeft = *left;
2538 uint32_t newRight = *right;
2539 bool hasControl = false;
2540 int ctrlIdx = -1;
2541 size_t size = mEffects.size();
2542
2543 // first update volume controller
2544 for (size_t i = size; i > 0; i--) {
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09002545 if (mEffects[i - 1]->isVolumeControlEnabled()) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002546 ctrlIdx = i - 1;
2547 hasControl = true;
2548 break;
2549 }
2550 }
2551
Eric Laurentfa1e1232016-08-02 19:01:49 -07002552 if (!force && ctrlIdx == mVolumeCtrlIdx &&
Eric Laurentcb4b6e92014-10-01 14:26:10 -07002553 *left == mLeftVolume && *right == mRightVolume) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002554 if (hasControl) {
2555 *left = mNewLeftVolume;
2556 *right = mNewRightVolume;
2557 }
2558 return hasControl;
2559 }
2560
2561 mVolumeCtrlIdx = ctrlIdx;
2562 mLeftVolume = newLeft;
2563 mRightVolume = newRight;
2564
2565 // second get volume update from volume controller
2566 if (ctrlIdx >= 0) {
2567 mEffects[ctrlIdx]->setVolume(&newLeft, &newRight, true);
2568 mNewLeftVolume = newLeft;
2569 mNewRightVolume = newRight;
2570 }
2571 // then indicate volume to all other effects in chain.
2572 // Pass altered volume to effects before volume controller
Jasmine Cha934ecfb2019-01-23 18:19:14 +08002573 // and requested volume to effects after controller or with volume monitor flag
Eric Laurentca7cc822012-11-19 14:55:58 -08002574 uint32_t lVol = newLeft;
2575 uint32_t rVol = newRight;
2576
2577 for (size_t i = 0; i < size; i++) {
2578 if ((int)i == ctrlIdx) {
2579 continue;
2580 }
2581 // this also works for ctrlIdx == -1 when there is no volume controller
2582 if ((int)i > ctrlIdx) {
2583 lVol = *left;
2584 rVol = *right;
2585 }
Jasmine Cha934ecfb2019-01-23 18:19:14 +08002586 // Pass requested volume directly if this is volume monitor module
2587 if (mEffects[i]->isVolumeMonitor()) {
2588 mEffects[i]->setVolume(left, right, false);
2589 } else {
2590 mEffects[i]->setVolume(&lVol, &rVol, false);
2591 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002592 }
2593 *left = newLeft;
2594 *right = newRight;
2595
Tomoharu Kasahara1990bd42014-12-12 14:04:11 +09002596 setVolumeForOutput_l(*left, *right);
2597
Eric Laurentca7cc822012-11-19 14:55:58 -08002598 return hasControl;
2599}
2600
Andy Hung87c693c2023-07-06 20:56:16 -07002601// resetVolume_l() must be called with IAfThreadBase::mutex() or EffectChain::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002602void EffectChain::resetVolume_l()
Eric Laurentfa1e1232016-08-02 19:01:49 -07002603{
Eric Laurente7449bf2016-08-03 18:44:07 -07002604 if ((mLeftVolume != UINT_MAX) && (mRightVolume != UINT_MAX)) {
2605 uint32_t left = mLeftVolume;
2606 uint32_t right = mRightVolume;
2607 (void)setVolume_l(&left, &right, true);
2608 }
Eric Laurentfa1e1232016-08-02 19:01:49 -07002609}
2610
Andy Hung6ac17eb2023-06-20 18:56:17 -07002611// containsHapticGeneratingEffect_l must be called with
Andy Hung87c693c2023-07-06 20:56:16 -07002612// IAfThreadBase::mutex() or EffectChain::mLock held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002613bool EffectChain::containsHapticGeneratingEffect_l()
jiabineb3bda02020-06-30 14:07:03 -07002614{
2615 for (size_t i = 0; i < mEffects.size(); ++i) {
2616 if (mEffects[i]->isHapticGenerator()) {
2617 return true;
2618 }
2619 }
2620 return false;
2621}
2622
Andy Hung6ac17eb2023-06-20 18:56:17 -07002623void EffectChain::setHapticIntensity_l(int id, os::HapticScale intensity)
jiabine70bc7f2020-06-30 22:07:55 -07002624{
2625 Mutex::Autolock _l(mLock);
2626 for (size_t i = 0; i < mEffects.size(); ++i) {
2627 mEffects[i]->setHapticIntensity(id, intensity);
2628 }
2629}
2630
Andy Hung6ac17eb2023-06-20 18:56:17 -07002631void EffectChain::syncHalEffectsState()
Eric Laurent1b928682014-10-02 19:41:47 -07002632{
2633 Mutex::Autolock _l(mLock);
2634 for (size_t i = 0; i < mEffects.size(); i++) {
2635 if (mEffects[i]->state() == EffectModule::ACTIVE ||
2636 mEffects[i]->state() == EffectModule::STOPPING) {
2637 mEffects[i]->addEffectToHal_l();
2638 }
2639 }
2640}
2641
Andy Hung6ac17eb2023-06-20 18:56:17 -07002642void EffectChain::dump(int fd, const Vector<String16>& args) const
Andy Hung920f6572022-10-06 12:09:49 -07002643NO_THREAD_SAFETY_ANALYSIS // conditional try lock
Eric Laurentca7cc822012-11-19 14:55:58 -08002644{
Eric Laurentca7cc822012-11-19 14:55:58 -08002645 String8 result;
2646
Mikhail Naganov19740ca2019-03-28 12:25:01 -07002647 const size_t numEffects = mEffects.size();
2648 result.appendFormat(" %zu effects for session %d\n", numEffects, mSessionId);
Eric Laurentca7cc822012-11-19 14:55:58 -08002649
Marco Nelissenb2208842014-02-07 14:00:50 -08002650 if (numEffects) {
Andy Hung0a51b5c2023-07-18 20:54:44 -07002651 const bool locked = afutils::dumpTryLock(mLock);
Marco Nelissenb2208842014-02-07 14:00:50 -08002652 // failed to lock - AudioFlinger is probably deadlocked
2653 if (!locked) {
2654 result.append("\tCould not lock mutex:\n");
Eric Laurentca7cc822012-11-19 14:55:58 -08002655 }
Eric Laurentca7cc822012-11-19 14:55:58 -08002656
Andy Hungbded9c82017-11-30 18:47:35 -08002657 const std::string inBufferStr = dumpInOutBuffer(true /* isInput */, mInBuffer);
2658 const std::string outBufferStr = dumpInOutBuffer(false /* isInput */, mOutBuffer);
2659 result.appendFormat("\t%-*s%-*s Active tracks:\n",
2660 (int)inBufferStr.size(), "In buffer ",
2661 (int)outBufferStr.size(), "Out buffer ");
2662 result.appendFormat("\t%s %s %d\n",
2663 inBufferStr.c_str(), outBufferStr.c_str(), mActiveTrackCnt);
Marco Nelissenb2208842014-02-07 14:00:50 -08002664 write(fd, result.string(), result.size());
2665
2666 for (size_t i = 0; i < numEffects; ++i) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07002667 sp<IAfEffectModule> effect = mEffects[i];
Marco Nelissenb2208842014-02-07 14:00:50 -08002668 if (effect != 0) {
2669 effect->dump(fd, args);
2670 }
2671 }
2672
2673 if (locked) {
2674 mLock.unlock();
2675 }
Mikhail Naganov19740ca2019-03-28 12:25:01 -07002676 } else {
2677 write(fd, result.string(), result.size());
Eric Laurentca7cc822012-11-19 14:55:58 -08002678 }
2679}
2680
Andy Hung87c693c2023-07-06 20:56:16 -07002681// must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002682void EffectChain::setEffectSuspended_l(
Eric Laurentca7cc822012-11-19 14:55:58 -08002683 const effect_uuid_t *type, bool suspend)
2684{
2685 sp<SuspendedEffectDesc> desc;
2686 // use effect type UUID timelow as key as there is no real risk of identical
2687 // timeLow fields among effect type UUIDs.
2688 ssize_t index = mSuspendedEffects.indexOfKey(type->timeLow);
2689 if (suspend) {
2690 if (index >= 0) {
2691 desc = mSuspendedEffects.valueAt(index);
2692 } else {
2693 desc = new SuspendedEffectDesc();
2694 desc->mType = *type;
2695 mSuspendedEffects.add(type->timeLow, desc);
2696 ALOGV("setEffectSuspended_l() add entry for %08x", type->timeLow);
2697 }
Eric Laurentd8365c52017-07-16 15:27:05 -07002698
Eric Laurentca7cc822012-11-19 14:55:58 -08002699 if (desc->mRefCount++ == 0) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07002700 sp<IAfEffectModule> effect = getEffectIfEnabled(type);
Eric Laurentca7cc822012-11-19 14:55:58 -08002701 if (effect != 0) {
2702 desc->mEffect = effect;
2703 effect->setSuspended(true);
Eric Laurent6b446ce2019-12-13 10:56:31 -08002704 effect->setEnabled(false, false /*fromHandle*/);
Eric Laurentca7cc822012-11-19 14:55:58 -08002705 }
2706 }
2707 } else {
2708 if (index < 0) {
2709 return;
2710 }
2711 desc = mSuspendedEffects.valueAt(index);
2712 if (desc->mRefCount <= 0) {
2713 ALOGW("setEffectSuspended_l() restore refcount should not be 0 %d", desc->mRefCount);
Eric Laurentd8365c52017-07-16 15:27:05 -07002714 desc->mRefCount = 0;
2715 return;
Eric Laurentca7cc822012-11-19 14:55:58 -08002716 }
2717 if (--desc->mRefCount == 0) {
2718 ALOGV("setEffectSuspended_l() remove entry for %08x", mSuspendedEffects.keyAt(index));
2719 if (desc->mEffect != 0) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07002720 sp<IAfEffectModule> effect = desc->mEffect.promote();
Eric Laurentca7cc822012-11-19 14:55:58 -08002721 if (effect != 0) {
2722 effect->setSuspended(false);
2723 effect->lock();
Andy Hung6ac17eb2023-06-20 18:56:17 -07002724 IAfEffectHandle *handle = effect->controlHandle_l();
Eric Laurent0d5a2ed2016-12-01 15:28:29 -08002725 if (handle != NULL && !handle->disconnected()) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002726 effect->setEnabled_l(handle->enabled());
2727 }
2728 effect->unlock();
2729 }
2730 desc->mEffect.clear();
2731 }
2732 mSuspendedEffects.removeItemsAt(index);
2733 }
2734 }
2735}
2736
Andy Hung87c693c2023-07-06 20:56:16 -07002737// must be called with IAfThreadBase::mutex() held
Andy Hung6ac17eb2023-06-20 18:56:17 -07002738void EffectChain::setEffectSuspendedAll_l(bool suspend)
Eric Laurentca7cc822012-11-19 14:55:58 -08002739{
2740 sp<SuspendedEffectDesc> desc;
2741
2742 ssize_t index = mSuspendedEffects.indexOfKey((int)kKeyForSuspendAll);
2743 if (suspend) {
2744 if (index >= 0) {
2745 desc = mSuspendedEffects.valueAt(index);
2746 } else {
2747 desc = new SuspendedEffectDesc();
2748 mSuspendedEffects.add((int)kKeyForSuspendAll, desc);
2749 ALOGV("setEffectSuspendedAll_l() add entry for 0");
2750 }
2751 if (desc->mRefCount++ == 0) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07002752 Vector< sp<IAfEffectModule> > effects;
Eric Laurentca7cc822012-11-19 14:55:58 -08002753 getSuspendEligibleEffects(effects);
2754 for (size_t i = 0; i < effects.size(); i++) {
2755 setEffectSuspended_l(&effects[i]->desc().type, true);
2756 }
2757 }
2758 } else {
2759 if (index < 0) {
2760 return;
2761 }
2762 desc = mSuspendedEffects.valueAt(index);
2763 if (desc->mRefCount <= 0) {
2764 ALOGW("setEffectSuspendedAll_l() restore refcount should not be 0 %d", desc->mRefCount);
2765 desc->mRefCount = 1;
2766 }
2767 if (--desc->mRefCount == 0) {
2768 Vector<const effect_uuid_t *> types;
2769 for (size_t i = 0; i < mSuspendedEffects.size(); i++) {
2770 if (mSuspendedEffects.keyAt(i) == (int)kKeyForSuspendAll) {
2771 continue;
2772 }
2773 types.add(&mSuspendedEffects.valueAt(i)->mType);
2774 }
2775 for (size_t i = 0; i < types.size(); i++) {
2776 setEffectSuspended_l(types[i], false);
2777 }
2778 ALOGV("setEffectSuspendedAll_l() remove entry for %08x",
2779 mSuspendedEffects.keyAt(index));
2780 mSuspendedEffects.removeItem((int)kKeyForSuspendAll);
2781 }
2782 }
2783}
2784
2785
2786// The volume effect is used for automated tests only
2787#ifndef OPENSL_ES_H_
2788static const effect_uuid_t SL_IID_VOLUME_ = { 0x09e8ede0, 0xddde, 0x11db, 0xb4f6,
2789 { 0x00, 0x02, 0xa5, 0xd5, 0xc5, 0x1b } };
2790const effect_uuid_t * const SL_IID_VOLUME = &SL_IID_VOLUME_;
2791#endif //OPENSL_ES_H_
2792
Eric Laurentd8365c52017-07-16 15:27:05 -07002793/* static */
Andy Hung6ac17eb2023-06-20 18:56:17 -07002794bool EffectChain::isEffectEligibleForBtNrecSuspend(const effect_uuid_t *type)
Eric Laurentd8365c52017-07-16 15:27:05 -07002795{
2796 // Only NS and AEC are suspended when BtNRec is off
2797 if ((memcmp(type, FX_IID_AEC, sizeof(effect_uuid_t)) == 0) ||
2798 (memcmp(type, FX_IID_NS, sizeof(effect_uuid_t)) == 0)) {
2799 return true;
2800 }
2801 return false;
2802}
2803
Andy Hung6ac17eb2023-06-20 18:56:17 -07002804bool EffectChain::isEffectEligibleForSuspend(const effect_descriptor_t& desc)
Eric Laurentca7cc822012-11-19 14:55:58 -08002805{
2806 // auxiliary effects and visualizer are never suspended on output mix
2807 if ((mSessionId == AUDIO_SESSION_OUTPUT_MIX) &&
2808 (((desc.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_AUXILIARY) ||
2809 (memcmp(&desc.type, SL_IID_VISUALIZATION, sizeof(effect_uuid_t)) == 0) ||
Ricardo Garciac2a3a822019-07-17 14:29:12 -07002810 (memcmp(&desc.type, SL_IID_VOLUME, sizeof(effect_uuid_t)) == 0) ||
2811 (memcmp(&desc.type, SL_IID_DYNAMICSPROCESSING, sizeof(effect_uuid_t)) == 0))) {
Eric Laurentca7cc822012-11-19 14:55:58 -08002812 return false;
2813 }
2814 return true;
2815}
2816
Andy Hung6ac17eb2023-06-20 18:56:17 -07002817void EffectChain::getSuspendEligibleEffects(
2818 Vector< sp<IAfEffectModule> > &effects)
Eric Laurentca7cc822012-11-19 14:55:58 -08002819{
2820 effects.clear();
2821 for (size_t i = 0; i < mEffects.size(); i++) {
2822 if (isEffectEligibleForSuspend(mEffects[i]->desc())) {
2823 effects.add(mEffects[i]);
2824 }
2825 }
2826}
2827
Andy Hung6ac17eb2023-06-20 18:56:17 -07002828sp<IAfEffectModule> EffectChain::getEffectIfEnabled(const effect_uuid_t *type)
Eric Laurentca7cc822012-11-19 14:55:58 -08002829{
Andy Hung6ac17eb2023-06-20 18:56:17 -07002830 sp<IAfEffectModule> effect = getEffectFromType_l(type);
Eric Laurentca7cc822012-11-19 14:55:58 -08002831 return effect != 0 && effect->isEnabled() ? effect : 0;
2832}
2833
Andy Hung6ac17eb2023-06-20 18:56:17 -07002834void EffectChain::checkSuspendOnEffectEnabled(const sp<IAfEffectModule>& effect,
Eric Laurentca7cc822012-11-19 14:55:58 -08002835 bool enabled)
2836{
2837 ssize_t index = mSuspendedEffects.indexOfKey(effect->desc().type.timeLow);
2838 if (enabled) {
2839 if (index < 0) {
2840 // if the effect is not suspend check if all effects are suspended
2841 index = mSuspendedEffects.indexOfKey((int)kKeyForSuspendAll);
2842 if (index < 0) {
2843 return;
2844 }
2845 if (!isEffectEligibleForSuspend(effect->desc())) {
2846 return;
2847 }
2848 setEffectSuspended_l(&effect->desc().type, enabled);
2849 index = mSuspendedEffects.indexOfKey(effect->desc().type.timeLow);
2850 if (index < 0) {
2851 ALOGW("checkSuspendOnEffectEnabled() Fx should be suspended here!");
2852 return;
2853 }
2854 }
2855 ALOGV("checkSuspendOnEffectEnabled() enable suspending fx %08x",
2856 effect->desc().type.timeLow);
2857 sp<SuspendedEffectDesc> desc = mSuspendedEffects.valueAt(index);
Eric Laurentd8365c52017-07-16 15:27:05 -07002858 // if effect is requested to suspended but was not yet enabled, suspend it now.
Eric Laurentca7cc822012-11-19 14:55:58 -08002859 if (desc->mEffect == 0) {
2860 desc->mEffect = effect;
Eric Laurent6b446ce2019-12-13 10:56:31 -08002861 effect->setEnabled(false, false /*fromHandle*/);
Eric Laurentca7cc822012-11-19 14:55:58 -08002862 effect->setSuspended(true);
2863 }
2864 } else {
2865 if (index < 0) {
2866 return;
2867 }
2868 ALOGV("checkSuspendOnEffectEnabled() disable restoring fx %08x",
2869 effect->desc().type.timeLow);
2870 sp<SuspendedEffectDesc> desc = mSuspendedEffects.valueAt(index);
2871 desc->mEffect.clear();
2872 effect->setSuspended(false);
2873 }
2874}
2875
Andy Hung6ac17eb2023-06-20 18:56:17 -07002876bool EffectChain::isNonOffloadableEnabled() const
Eric Laurent813e2a72013-08-31 12:59:48 -07002877{
2878 Mutex::Autolock _l(mLock);
Shingo Kitajima1f8df9a2018-05-29 11:35:06 +09002879 return isNonOffloadableEnabled_l();
2880}
2881
Andy Hung6ac17eb2023-06-20 18:56:17 -07002882bool EffectChain::isNonOffloadableEnabled_l() const
Shingo Kitajima1f8df9a2018-05-29 11:35:06 +09002883{
Eric Laurent813e2a72013-08-31 12:59:48 -07002884 size_t size = mEffects.size();
2885 for (size_t i = 0; i < size; i++) {
Eric Laurent5baf2af2013-09-12 17:37:00 -07002886 if (mEffects[i]->isEnabled() && !mEffects[i]->isOffloadable()) {
Eric Laurent813e2a72013-08-31 12:59:48 -07002887 return true;
2888 }
2889 }
2890 return false;
2891}
2892
Andy Hung87c693c2023-07-06 20:56:16 -07002893void EffectChain::setThread(const sp<IAfThreadBase>& thread)
Eric Laurentaaa44472014-09-12 17:41:50 -07002894{
2895 Mutex::Autolock _l(mLock);
Ytai Ben-Tsvi3de1bbf2020-01-21 16:41:17 -08002896 mEffectCallback->setThread(thread);
Eric Laurentaaa44472014-09-12 17:41:50 -07002897}
2898
Andy Hung6ac17eb2023-06-20 18:56:17 -07002899void EffectChain::checkOutputFlagCompatibility(audio_output_flags_t *flags) const
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002900{
2901 if ((*flags & AUDIO_OUTPUT_FLAG_RAW) != 0 && !isRawCompatible()) {
2902 *flags = (audio_output_flags_t)(*flags & ~AUDIO_OUTPUT_FLAG_RAW);
2903 }
2904 if ((*flags & AUDIO_OUTPUT_FLAG_FAST) != 0 && !isFastCompatible()) {
2905 *flags = (audio_output_flags_t)(*flags & ~AUDIO_OUTPUT_FLAG_FAST);
2906 }
jiabinc658e452022-10-21 20:52:21 +00002907 if ((*flags & AUDIO_OUTPUT_FLAG_BIT_PERFECT) != 0 && !isBitPerfectCompatible()) {
2908 *flags = (audio_output_flags_t)(*flags & ~AUDIO_OUTPUT_FLAG_BIT_PERFECT);
2909 }
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002910}
2911
Andy Hung6ac17eb2023-06-20 18:56:17 -07002912void EffectChain::checkInputFlagCompatibility(audio_input_flags_t *flags) const
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002913{
2914 if ((*flags & AUDIO_INPUT_FLAG_RAW) != 0 && !isRawCompatible()) {
2915 *flags = (audio_input_flags_t)(*flags & ~AUDIO_INPUT_FLAG_RAW);
2916 }
2917 if ((*flags & AUDIO_INPUT_FLAG_FAST) != 0 && !isFastCompatible()) {
2918 *flags = (audio_input_flags_t)(*flags & ~AUDIO_INPUT_FLAG_FAST);
2919 }
2920}
2921
Andy Hung6ac17eb2023-06-20 18:56:17 -07002922bool EffectChain::isRawCompatible() const
Eric Laurent4c415062016-06-17 16:14:16 -07002923{
2924 Mutex::Autolock _l(mLock);
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002925 for (const auto &effect : mEffects) {
2926 if (effect->isProcessImplemented()) {
2927 return false;
Eric Laurent4c415062016-06-17 16:14:16 -07002928 }
2929 }
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002930 // Allow effects without processing.
2931 return true;
2932}
2933
Andy Hung6ac17eb2023-06-20 18:56:17 -07002934bool EffectChain::isFastCompatible() const
Andy Hungd3bb0ad2016-10-11 17:16:43 -07002935{
2936 Mutex::Autolock _l(mLock);
2937 for (const auto &effect : mEffects) {
2938 if (effect->isProcessImplemented()
2939 && effect->isImplementationSoftware()) {
2940 return false;
2941 }
2942 }
2943 // Allow effects without processing or hw accelerated effects.
2944 return true;
Eric Laurent4c415062016-06-17 16:14:16 -07002945}
2946
Andy Hung6ac17eb2023-06-20 18:56:17 -07002947bool EffectChain::isBitPerfectCompatible() const {
jiabinc658e452022-10-21 20:52:21 +00002948 Mutex::Autolock _l(mLock);
2949 for (const auto &effect : mEffects) {
2950 if (effect->isProcessImplemented()
2951 && effect->isImplementationSoftware()) {
2952 return false;
2953 }
2954 }
2955 // Allow effects without processing or hw accelerated effects.
2956 return true;
2957}
2958
Eric Laurent4c415062016-06-17 16:14:16 -07002959// isCompatibleWithThread_l() must be called with thread->mLock held
Andy Hung87c693c2023-07-06 20:56:16 -07002960bool EffectChain::isCompatibleWithThread_l(const sp<IAfThreadBase>& thread) const
Eric Laurent4c415062016-06-17 16:14:16 -07002961{
2962 Mutex::Autolock _l(mLock);
2963 for (size_t i = 0; i < mEffects.size(); i++) {
2964 if (thread->checkEffectCompatibility_l(&(mEffects[i]->desc()), mSessionId) != NO_ERROR) {
2965 return false;
2966 }
2967 }
2968 return true;
2969}
2970
Eric Laurent6b446ce2019-12-13 10:56:31 -08002971// EffectCallbackInterface implementation
Andy Hung6ac17eb2023-06-20 18:56:17 -07002972status_t EffectChain::EffectCallback::createEffectHal(
Eric Laurent6b446ce2019-12-13 10:56:31 -08002973 const effect_uuid_t *pEffectUuid, int32_t sessionId, int32_t deviceId,
2974 sp<EffectHalInterface> *effect) {
2975 status_t status = NO_INIT;
Andy Hungba8e52b2023-05-11 14:33:03 -07002976 const sp<EffectsFactoryHalInterface> effectsFactory =
2977 EffectConfiguration::getEffectsFactoryHal();
Eric Laurent6b446ce2019-12-13 10:56:31 -08002978 if (effectsFactory != 0) {
2979 status = effectsFactory->createEffect(pEffectUuid, sessionId, io(), deviceId, effect);
2980 }
2981 return status;
2982}
2983
Andy Hung6ac17eb2023-06-20 18:56:17 -07002984bool EffectChain::EffectCallback::updateOrphanEffectChains(
2985 const sp<IAfEffectBase>& effect) {
Eric Laurent41709552019-12-16 19:34:05 -08002986 // in EffectChain context, an EffectBase is always from an EffectModule so static cast is safe
Andy Hung583043b2023-07-17 17:05:00 -07002987 return mAfThreadCallback->updateOrphanEffectChains(effect->asEffectModule());
Eric Laurent6b446ce2019-12-13 10:56:31 -08002988}
2989
Andy Hung6ac17eb2023-06-20 18:56:17 -07002990status_t EffectChain::EffectCallback::allocateHalBuffer(
Eric Laurent6b446ce2019-12-13 10:56:31 -08002991 size_t size, sp<EffectBufferHalInterface>* buffer) {
Andy Hung583043b2023-07-17 17:05:00 -07002992 return mAfThreadCallback->getEffectsFactoryHal()->allocateBuffer(size, buffer);
Eric Laurent6b446ce2019-12-13 10:56:31 -08002993}
2994
Andy Hung6ac17eb2023-06-20 18:56:17 -07002995status_t EffectChain::EffectCallback::addEffectToHal(
Andy Hung920f6572022-10-06 12:09:49 -07002996 const sp<EffectHalInterface>& effect) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08002997 status_t result = NO_INIT;
Andy Hung87c693c2023-07-06 20:56:16 -07002998 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08002999 if (t == nullptr) {
3000 return result;
3001 }
3002 sp <StreamHalInterface> st = t->stream();
3003 if (st == nullptr) {
3004 return result;
3005 }
3006 result = st->addEffect(effect);
3007 ALOGE_IF(result != OK, "Error when adding effect: %d", result);
3008 return result;
3009}
3010
Andy Hung6ac17eb2023-06-20 18:56:17 -07003011status_t EffectChain::EffectCallback::removeEffectFromHal(
Andy Hung920f6572022-10-06 12:09:49 -07003012 const sp<EffectHalInterface>& effect) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08003013 status_t result = NO_INIT;
Andy Hung87c693c2023-07-06 20:56:16 -07003014 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003015 if (t == nullptr) {
3016 return result;
3017 }
3018 sp <StreamHalInterface> st = t->stream();
3019 if (st == nullptr) {
3020 return result;
3021 }
3022 result = st->removeEffect(effect);
3023 ALOGE_IF(result != OK, "Error when removing effect: %d", result);
3024 return result;
3025}
3026
Andy Hung6ac17eb2023-06-20 18:56:17 -07003027audio_io_handle_t EffectChain::EffectCallback::io() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003028 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003029 if (t == nullptr) {
3030 return AUDIO_IO_HANDLE_NONE;
3031 }
3032 return t->id();
3033}
3034
Andy Hung6ac17eb2023-06-20 18:56:17 -07003035bool EffectChain::EffectCallback::isOutput() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003036 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003037 if (t == nullptr) {
3038 return true;
3039 }
3040 return t->isOutput();
3041}
3042
Andy Hung6ac17eb2023-06-20 18:56:17 -07003043bool EffectChain::EffectCallback::isOffload() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003044 return mThreadType == IAfThreadBase::OFFLOAD;
Eric Laurent6b446ce2019-12-13 10:56:31 -08003045}
3046
Andy Hung6ac17eb2023-06-20 18:56:17 -07003047bool EffectChain::EffectCallback::isOffloadOrDirect() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003048 return mThreadType == IAfThreadBase::OFFLOAD
3049 || mThreadType == IAfThreadBase::DIRECT;
Eric Laurent6b446ce2019-12-13 10:56:31 -08003050}
3051
Andy Hung6ac17eb2023-06-20 18:56:17 -07003052bool EffectChain::EffectCallback::isOffloadOrMmap() const {
Eric Laurentb62d0362021-10-26 17:40:18 +02003053 switch (mThreadType) {
Andy Hung87c693c2023-07-06 20:56:16 -07003054 case IAfThreadBase::OFFLOAD:
3055 case IAfThreadBase::MMAP_PLAYBACK:
3056 case IAfThreadBase::MMAP_CAPTURE:
Eric Laurentb62d0362021-10-26 17:40:18 +02003057 return true;
3058 default:
Eric Laurent6b446ce2019-12-13 10:56:31 -08003059 return false;
3060 }
Eric Laurentb62d0362021-10-26 17:40:18 +02003061}
3062
Andy Hung6ac17eb2023-06-20 18:56:17 -07003063bool EffectChain::EffectCallback::isSpatializer() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003064 return mThreadType == IAfThreadBase::SPATIALIZER;
Eric Laurent6b446ce2019-12-13 10:56:31 -08003065}
3066
Andy Hung6ac17eb2023-06-20 18:56:17 -07003067uint32_t EffectChain::EffectCallback::sampleRate() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003068 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003069 if (t == nullptr) {
3070 return 0;
3071 }
3072 return t->sampleRate();
3073}
3074
Andy Hung6ac17eb2023-06-20 18:56:17 -07003075audio_channel_mask_t EffectChain::EffectCallback::inChannelMask(int id) const {
Andy Hung87c693c2023-07-06 20:56:16 -07003076 const sp<IAfThreadBase> t = thread().promote();
Eric Laurentf1f22e72021-07-13 14:04:14 +02003077 if (t == nullptr) {
3078 return AUDIO_CHANNEL_NONE;
3079 }
Andy Hung6ac17eb2023-06-20 18:56:17 -07003080 sp<IAfEffectChain> c = chain().promote();
Eric Laurentf1f22e72021-07-13 14:04:14 +02003081 if (c == nullptr) {
3082 return AUDIO_CHANNEL_NONE;
3083 }
3084
Andy Hung87c693c2023-07-06 20:56:16 -07003085 if (mThreadType == IAfThreadBase::SPATIALIZER) {
Eric Laurentb62d0362021-10-26 17:40:18 +02003086 if (c->sessionId() == AUDIO_SESSION_OUTPUT_STAGE) {
3087 if (c->isFirstEffect(id)) {
3088 return t->mixerChannelMask();
3089 } else {
3090 return t->channelMask();
3091 }
3092 } else if (!audio_is_global_session(c->sessionId())) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003093 if ((t->hasAudioSession_l(c->sessionId())
Andy Hung87c693c2023-07-06 20:56:16 -07003094 & IAfThreadBase::SPATIALIZED_SESSION) != 0) {
Eric Laurentb62d0362021-10-26 17:40:18 +02003095 return t->mixerChannelMask();
3096 } else {
3097 return t->channelMask();
3098 }
3099 } else {
3100 return t->channelMask();
3101 }
Eric Laurentf1f22e72021-07-13 14:04:14 +02003102 } else {
3103 return t->channelMask();
3104 }
3105}
3106
Andy Hung6ac17eb2023-06-20 18:56:17 -07003107uint32_t EffectChain::EffectCallback::inChannelCount(int id) const {
Eric Laurentb62d0362021-10-26 17:40:18 +02003108 return audio_channel_count_from_out_mask(inChannelMask(id));
Eric Laurentf1f22e72021-07-13 14:04:14 +02003109}
3110
Andy Hung6ac17eb2023-06-20 18:56:17 -07003111audio_channel_mask_t EffectChain::EffectCallback::outChannelMask() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003112 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003113 if (t == nullptr) {
3114 return AUDIO_CHANNEL_NONE;
3115 }
Andy Hung6ac17eb2023-06-20 18:56:17 -07003116 sp<IAfEffectChain> c = chain().promote();
Eric Laurentb62d0362021-10-26 17:40:18 +02003117 if (c == nullptr) {
3118 return AUDIO_CHANNEL_NONE;
3119 }
3120
Andy Hung87c693c2023-07-06 20:56:16 -07003121 if (mThreadType == IAfThreadBase::SPATIALIZER) {
Eric Laurentb62d0362021-10-26 17:40:18 +02003122 if (!audio_is_global_session(c->sessionId())) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003123 if ((t->hasAudioSession_l(c->sessionId())
Andy Hung87c693c2023-07-06 20:56:16 -07003124 & IAfThreadBase::SPATIALIZED_SESSION) != 0) {
Eric Laurentb62d0362021-10-26 17:40:18 +02003125 return t->mixerChannelMask();
3126 } else {
3127 return t->channelMask();
3128 }
3129 } else {
3130 return t->channelMask();
3131 }
3132 } else {
3133 return t->channelMask();
3134 }
Eric Laurent6b446ce2019-12-13 10:56:31 -08003135}
3136
Andy Hung6ac17eb2023-06-20 18:56:17 -07003137uint32_t EffectChain::EffectCallback::outChannelCount() const {
Eric Laurentb62d0362021-10-26 17:40:18 +02003138 return audio_channel_count_from_out_mask(outChannelMask());
Eric Laurent6b446ce2019-12-13 10:56:31 -08003139}
3140
Andy Hung6ac17eb2023-06-20 18:56:17 -07003141audio_channel_mask_t EffectChain::EffectCallback::hapticChannelMask() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003142 const sp<IAfThreadBase> t = thread().promote();
jiabineb3bda02020-06-30 14:07:03 -07003143 if (t == nullptr) {
3144 return AUDIO_CHANNEL_NONE;
3145 }
3146 return t->hapticChannelMask();
3147}
3148
Andy Hung6ac17eb2023-06-20 18:56:17 -07003149size_t EffectChain::EffectCallback::frameCount() const {
Andy Hung87c693c2023-07-06 20:56:16 -07003150 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003151 if (t == nullptr) {
3152 return 0;
3153 }
3154 return t->frameCount();
3155}
3156
Andy Hung6ac17eb2023-06-20 18:56:17 -07003157uint32_t EffectChain::EffectCallback::latency() const
Andy Hung920f6572022-10-06 12:09:49 -07003158NO_THREAD_SAFETY_ANALYSIS // latency_l() access
3159{
Andy Hung87c693c2023-07-06 20:56:16 -07003160 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003161 if (t == nullptr) {
3162 return 0;
3163 }
Andy Hung920f6572022-10-06 12:09:49 -07003164 // TODO(b/275956781) - this requires the thread lock.
Eric Laurent6b446ce2019-12-13 10:56:31 -08003165 return t->latency_l();
3166}
3167
Andy Hung6ac17eb2023-06-20 18:56:17 -07003168void EffectChain::EffectCallback::setVolumeForOutput(float left, float right) const
Andy Hung920f6572022-10-06 12:09:49 -07003169NO_THREAD_SAFETY_ANALYSIS // setVolumeForOutput_l() access
3170{
Andy Hung87c693c2023-07-06 20:56:16 -07003171 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003172 if (t == nullptr) {
3173 return;
3174 }
3175 t->setVolumeForOutput_l(left, right);
3176}
3177
Andy Hung6ac17eb2023-06-20 18:56:17 -07003178void EffectChain::EffectCallback::checkSuspendOnEffectEnabled(
3179 const sp<IAfEffectBase>& effect, bool enabled, bool threadLocked) {
Andy Hung87c693c2023-07-06 20:56:16 -07003180 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003181 if (t == nullptr) {
3182 return;
3183 }
3184 t->checkSuspendOnEffectEnabled(enabled, effect->sessionId(), threadLocked);
3185
Andy Hung6ac17eb2023-06-20 18:56:17 -07003186 sp<IAfEffectChain> c = chain().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003187 if (c == nullptr) {
3188 return;
3189 }
Eric Laurent41709552019-12-16 19:34:05 -08003190 // in EffectChain context, an EffectBase is always from an EffectModule so static cast is safe
3191 c->checkSuspendOnEffectEnabled(effect->asEffectModule(), enabled);
Eric Laurent6b446ce2019-12-13 10:56:31 -08003192}
3193
Andy Hung6ac17eb2023-06-20 18:56:17 -07003194void EffectChain::EffectCallback::onEffectEnable(const sp<IAfEffectBase>& effect) {
Andy Hung87c693c2023-07-06 20:56:16 -07003195 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003196 if (t == nullptr) {
3197 return;
3198 }
Eric Laurent41709552019-12-16 19:34:05 -08003199 // in EffectChain context, an EffectBase is always from an EffectModule so static cast is safe
3200 t->onEffectEnable(effect->asEffectModule());
Eric Laurent6b446ce2019-12-13 10:56:31 -08003201}
3202
Andy Hung6ac17eb2023-06-20 18:56:17 -07003203void EffectChain::EffectCallback::onEffectDisable(const sp<IAfEffectBase>& effect) {
Eric Laurent6b446ce2019-12-13 10:56:31 -08003204 checkSuspendOnEffectEnabled(effect, false, false /*threadLocked*/);
3205
Andy Hung87c693c2023-07-06 20:56:16 -07003206 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003207 if (t == nullptr) {
3208 return;
3209 }
3210 t->onEffectDisable();
3211}
3212
Andy Hung6ac17eb2023-06-20 18:56:17 -07003213bool EffectChain::EffectCallback::disconnectEffectHandle(IAfEffectHandle *handle,
Eric Laurent6b446ce2019-12-13 10:56:31 -08003214 bool unpinIfLast) {
Andy Hung87c693c2023-07-06 20:56:16 -07003215 const sp<IAfThreadBase> t = thread().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003216 if (t == nullptr) {
3217 return false;
3218 }
3219 t->disconnectEffectHandle(handle, unpinIfLast);
3220 return true;
3221}
3222
Andy Hung6ac17eb2023-06-20 18:56:17 -07003223void EffectChain::EffectCallback::resetVolume() {
3224 sp<IAfEffectChain> c = chain().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003225 if (c == nullptr) {
3226 return;
3227 }
3228 c->resetVolume_l();
3229
3230}
3231
Andy Hung6ac17eb2023-06-20 18:56:17 -07003232product_strategy_t EffectChain::EffectCallback::strategy() const {
3233 sp<IAfEffectChain> c = chain().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003234 if (c == nullptr) {
3235 return PRODUCT_STRATEGY_NONE;
3236 }
3237 return c->strategy();
3238}
3239
Andy Hung6ac17eb2023-06-20 18:56:17 -07003240int32_t EffectChain::EffectCallback::activeTrackCnt() const {
3241 sp<IAfEffectChain> c = chain().promote();
Eric Laurent6b446ce2019-12-13 10:56:31 -08003242 if (c == nullptr) {
3243 return 0;
3244 }
3245 return c->activeTrackCnt();
3246}
3247
Eric Laurentb82e6b72019-11-22 17:25:04 -08003248
3249#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -07003250#define LOG_TAG "DeviceEffectProxy"
Eric Laurentb82e6b72019-11-22 17:25:04 -08003251
Andy Hung6ac17eb2023-06-20 18:56:17 -07003252/* static */
3253sp<IAfDeviceEffectProxy> IAfDeviceEffectProxy::create(
3254 const AudioDeviceTypeAddr& device,
Andy Hung55a74fd2023-07-13 19:54:47 -07003255 const sp<DeviceEffectManagerCallback>& callback,
Andy Hung6ac17eb2023-06-20 18:56:17 -07003256 effect_descriptor_t *desc, int id, bool notifyFramesProcessed)
3257{
3258 return sp<DeviceEffectProxy>::make(device,
Andy Hung55a74fd2023-07-13 19:54:47 -07003259 callback,
Andy Hung6ac17eb2023-06-20 18:56:17 -07003260 desc, id, notifyFramesProcessed);
3261}
3262
3263status_t DeviceEffectProxy::setEnabled(bool enabled, bool fromHandle)
Eric Laurentb82e6b72019-11-22 17:25:04 -08003264{
3265 status_t status = EffectBase::setEnabled(enabled, fromHandle);
3266 Mutex::Autolock _l(mProxyLock);
3267 if (status == NO_ERROR) {
3268 for (auto& handle : mEffectHandles) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07003269 Status bs;
Eric Laurentb82e6b72019-11-22 17:25:04 -08003270 if (enabled) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003271 bs = handle.second->asIEffect()->enable(&status);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003272 } else {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003273 bs = handle.second->asIEffect()->disable(&status);
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07003274 }
3275 if (!bs.isOk()) {
Andy Hung1131b6e2020-12-08 20:47:45 -08003276 status = statusTFromBinderStatus(bs);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003277 }
3278 }
3279 }
3280 ALOGV("%s enable %d status %d", __func__, enabled, status);
3281 return status;
3282}
3283
Andy Hung6ac17eb2023-06-20 18:56:17 -07003284status_t DeviceEffectProxy::init(
Andy Hung8e6b62a2023-07-13 18:11:33 -07003285 const std::map <audio_patch_handle_t, IAfPatchPanel::Patch>& patches) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003286//For all audio patches
3287//If src or sink device match
3288//If the effect is HW accelerated
3289// if no corresponding effect module
3290// Create EffectModule: mHalEffect
3291//Create and attach EffectHandle
3292//If the effect is not HW accelerated and the patch sink or src is a mixer port
3293// Create Effect on patch input or output thread on session -1
3294//Add EffectHandle to EffectHandle map of Effect Proxy:
3295 ALOGV("%s device type %d address %s", __func__, mDevice.mType, mDevice.getAddress());
3296 status_t status = NO_ERROR;
3297 for (auto &patch : patches) {
3298 status = onCreatePatch(patch.first, patch.second);
3299 ALOGV("%s onCreatePatch status %d", __func__, status);
3300 if (status == BAD_VALUE) {
3301 return status;
3302 }
3303 }
3304 return status;
3305}
3306
François Gaffie58e73af2023-02-15 11:47:24 +01003307status_t DeviceEffectProxy::onUpdatePatch(audio_patch_handle_t oldPatchHandle,
3308 audio_patch_handle_t newPatchHandle,
Andy Hung8e6b62a2023-07-13 18:11:33 -07003309 const IAfPatchPanel::Patch& /* patch */) {
François Gaffie58e73af2023-02-15 11:47:24 +01003310 status_t status = NAME_NOT_FOUND;
3311 ALOGV("%s", __func__);
3312 Mutex::Autolock _l(mProxyLock);
3313 if (mEffectHandles.find(oldPatchHandle) != mEffectHandles.end()) {
3314 ALOGV("%s replacing effect from handle %d to handle %d", __func__, oldPatchHandle,
3315 newPatchHandle);
3316 sp<IAfEffectHandle> effect = mEffectHandles.at(oldPatchHandle);
3317 mEffectHandles.erase(oldPatchHandle);
3318 mEffectHandles.emplace(newPatchHandle, effect);
3319 status = NO_ERROR;
3320 }
3321 return status;
3322}
3323
Andy Hung6ac17eb2023-06-20 18:56:17 -07003324status_t DeviceEffectProxy::onCreatePatch(
Andy Hung8e6b62a2023-07-13 18:11:33 -07003325 audio_patch_handle_t patchHandle, const IAfPatchPanel::Patch& patch) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003326 status_t status = NAME_NOT_FOUND;
Andy Hung6ac17eb2023-06-20 18:56:17 -07003327 sp<IAfEffectHandle> handle;
Eric Laurentb82e6b72019-11-22 17:25:04 -08003328 // only consider source[0] as this is the only "true" source of a patch
3329 status = checkPort(patch, &patch.mAudioPatch.sources[0], &handle);
3330 ALOGV("%s source checkPort status %d", __func__, status);
3331 for (uint32_t i = 0; i < patch.mAudioPatch.num_sinks && status == NAME_NOT_FOUND; i++) {
3332 status = checkPort(patch, &patch.mAudioPatch.sinks[i], &handle);
3333 ALOGV("%s sink %d checkPort status %d", __func__, i, status);
3334 }
3335 if (status == NO_ERROR || status == ALREADY_EXISTS) {
3336 Mutex::Autolock _l(mProxyLock);
François Gaffie70c6c722023-06-22 12:23:32 +02003337 size_t erasedHandle = mEffectHandles.erase(patchHandle);
3338 ALOGV("%s %s effecthandle %p for patch %d",
3339 __func__, (erasedHandle == 0 ? "adding" : "replacing"), handle.get(), patchHandle);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003340 mEffectHandles.emplace(patchHandle, handle);
3341 }
3342 ALOGW_IF(status == BAD_VALUE,
3343 "%s cannot attach effect %s on patch %d", __func__, mDescriptor.name, patchHandle);
3344
3345 return status;
3346}
3347
Andy Hung8e6b62a2023-07-13 18:11:33 -07003348status_t DeviceEffectProxy::checkPort(const IAfPatchPanel::Patch& patch,
Andy Hung6ac17eb2023-06-20 18:56:17 -07003349 const struct audio_port_config *port, sp<IAfEffectHandle> *handle) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003350
3351 ALOGV("%s type %d device type %d address %s device ID %d patch.isSoftware() %d",
3352 __func__, port->type, port->ext.device.type,
3353 port->ext.device.address, port->id, patch.isSoftware());
Shunkai Yaob009ad52023-05-05 22:43:24 +00003354 if (port->type != AUDIO_PORT_TYPE_DEVICE || port->ext.device.type != mDevice.mType ||
3355 port->ext.device.address != mDevice.address()) {
3356 return NAME_NOT_FOUND;
3357 }
3358 if (((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_POST_PROC) &&
3359 (audio_port_config_has_input_direction(port))) {
3360 ALOGI("%s don't create postprocessing effect on record port", __func__);
3361 return NAME_NOT_FOUND;
3362 }
3363 if (((mDescriptor.flags & EFFECT_FLAG_TYPE_MASK) == EFFECT_FLAG_TYPE_PRE_PROC) &&
3364 (!audio_port_config_has_input_direction(port))) {
3365 ALOGI("%s don't create preprocessing effect on playback port", __func__);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003366 return NAME_NOT_FOUND;
3367 }
3368 status_t status = NAME_NOT_FOUND;
3369
3370 if (mDescriptor.flags & EFFECT_FLAG_HW_ACC_TUNNEL) {
3371 Mutex::Autolock _l(mProxyLock);
François Gaffie70c6c722023-06-22 12:23:32 +02003372 if (mHalEffect != nullptr && mDevicePort.id == port->id) {
3373 ALOGV("%s reusing HAL effect", __func__);
3374 } else {
3375 mDevicePort = *port;
3376 mHalEffect = new EffectModule(mMyCallback,
Eric Laurentb82e6b72019-11-22 17:25:04 -08003377 const_cast<effect_descriptor_t *>(&mDescriptor),
3378 mMyCallback->newEffectId(), AUDIO_SESSION_DEVICE,
3379 false /* pinned */, port->id);
François Gaffie70c6c722023-06-22 12:23:32 +02003380 if (audio_is_input_device(mDevice.mType)) {
3381 mHalEffect->setInputDevice(mDevice);
3382 } else {
3383 mHalEffect->setDevices({mDevice});
3384 }
3385 mHalEffect->configure();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003386 }
Eric Laurentde8caf42021-08-11 17:19:25 +02003387 *handle = new EffectHandle(mHalEffect, nullptr, nullptr, 0 /*priority*/,
3388 mNotifyFramesProcessed);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003389 status = (*handle)->initCheck();
3390 if (status == OK) {
3391 status = mHalEffect->addHandle((*handle).get());
3392 } else {
3393 mHalEffect.clear();
3394 mDevicePort.id = AUDIO_PORT_HANDLE_NONE;
3395 }
3396 } else if (patch.isSoftware() || patch.thread().promote() != nullptr) {
Andy Hung87c693c2023-07-06 20:56:16 -07003397 sp<IAfThreadBase> thread;
Eric Laurentb82e6b72019-11-22 17:25:04 -08003398 if (audio_port_config_has_input_direction(port)) {
3399 if (patch.isSoftware()) {
3400 thread = patch.mRecord.thread();
3401 } else {
3402 thread = patch.thread().promote();
3403 }
3404 } else {
3405 if (patch.isSoftware()) {
3406 thread = patch.mPlayback.thread();
3407 } else {
3408 thread = patch.thread().promote();
3409 }
3410 }
3411 int enabled;
3412 *handle = thread->createEffect_l(nullptr, nullptr, 0, AUDIO_SESSION_DEVICE,
3413 const_cast<effect_descriptor_t *>(&mDescriptor),
Eric Laurentde8caf42021-08-11 17:19:25 +02003414 &enabled, &status, false, false /*probe*/,
3415 mNotifyFramesProcessed);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003416 ALOGV("%s thread->createEffect_l status %d", __func__, status);
3417 } else {
3418 status = BAD_VALUE;
3419 }
Shunkai Yaob009ad52023-05-05 22:43:24 +00003420
Eric Laurentb82e6b72019-11-22 17:25:04 -08003421 if (status == NO_ERROR || status == ALREADY_EXISTS) {
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07003422 Status bs;
Eric Laurentb82e6b72019-11-22 17:25:04 -08003423 if (isEnabled()) {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003424 bs = (*handle)->asIEffect()->enable(&status);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003425 } else {
Andy Hung6ac17eb2023-06-20 18:56:17 -07003426 bs = (*handle)->asIEffect()->disable(&status);
Ytai Ben-Tsvi9cd89812020-07-01 17:12:06 -07003427 }
3428 if (!bs.isOk()) {
Andy Hung1131b6e2020-12-08 20:47:45 -08003429 status = statusTFromBinderStatus(bs);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003430 }
3431 }
3432 return status;
3433}
3434
Andy Hung6ac17eb2023-06-20 18:56:17 -07003435void DeviceEffectProxy::onReleasePatch(audio_patch_handle_t patchHandle) {
3436 sp<IAfEffectHandle> effect;
Eric Laurent76c89f32021-12-03 17:13:23 +01003437 {
3438 Mutex::Autolock _l(mProxyLock);
3439 if (mEffectHandles.find(patchHandle) != mEffectHandles.end()) {
3440 effect = mEffectHandles.at(patchHandle);
3441 mEffectHandles.erase(patchHandle);
3442 }
3443 }
Eric Laurentb82e6b72019-11-22 17:25:04 -08003444}
3445
3446
Andy Hung6ac17eb2023-06-20 18:56:17 -07003447size_t DeviceEffectProxy::removeEffect(const sp<IAfEffectModule>& effect)
Eric Laurentb82e6b72019-11-22 17:25:04 -08003448{
3449 Mutex::Autolock _l(mProxyLock);
3450 if (effect == mHalEffect) {
Eric Laurent76c89f32021-12-03 17:13:23 +01003451 mHalEffect->release_l();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003452 mHalEffect.clear();
3453 mDevicePort.id = AUDIO_PORT_HANDLE_NONE;
3454 }
3455 return mHalEffect == nullptr ? 0 : 1;
3456}
3457
Andy Hung6ac17eb2023-06-20 18:56:17 -07003458status_t DeviceEffectProxy::addEffectToHal(
Andy Hung920f6572022-10-06 12:09:49 -07003459 const sp<EffectHalInterface>& effect) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003460 if (mHalEffect == nullptr) {
3461 return NO_INIT;
3462 }
Mikhail Naganovd2c7f852023-06-14 18:00:13 -07003463 return mManagerCallback->addEffectToHal(&mDevicePort, effect);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003464}
3465
Andy Hung6ac17eb2023-06-20 18:56:17 -07003466status_t DeviceEffectProxy::removeEffectFromHal(
Andy Hung920f6572022-10-06 12:09:49 -07003467 const sp<EffectHalInterface>& effect) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003468 if (mHalEffect == nullptr) {
3469 return NO_INIT;
3470 }
Mikhail Naganovd2c7f852023-06-14 18:00:13 -07003471 return mManagerCallback->removeEffectFromHal(&mDevicePort, effect);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003472}
3473
François Gaffiea2e985b2023-06-09 14:37:56 +02003474status_t DeviceEffectProxy::command(
3475 int32_t cmdCode, const std::vector<uint8_t>& cmdData, int32_t maxReplySize,
3476 std::vector<uint8_t>* reply) {
3477 Mutex::Autolock _l(mProxyLock);
3478 status_t status = EffectBase::command(cmdCode, cmdData, maxReplySize, reply);
3479 if (status == NO_ERROR) {
3480 for (auto& handle : mEffectHandles) {
3481 sp<IAfEffectBase> effect = handle.second->effect().promote();
3482 if (effect != nullptr) {
3483 status = effect->command(cmdCode, cmdData, maxReplySize, reply);
3484 }
3485 }
3486 }
3487 ALOGV("%s status %d", __func__, status);
3488 return status;
3489}
3490
Andy Hung6ac17eb2023-06-20 18:56:17 -07003491bool DeviceEffectProxy::isOutput() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003492 if (mDevicePort.id != AUDIO_PORT_HANDLE_NONE) {
3493 return mDevicePort.role == AUDIO_PORT_ROLE_SINK;
3494 }
3495 return true;
3496}
3497
Andy Hung6ac17eb2023-06-20 18:56:17 -07003498uint32_t DeviceEffectProxy::sampleRate() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003499 if (mDevicePort.id != AUDIO_PORT_HANDLE_NONE &&
3500 (mDevicePort.config_mask & AUDIO_PORT_CONFIG_SAMPLE_RATE) != 0) {
3501 return mDevicePort.sample_rate;
3502 }
3503 return DEFAULT_OUTPUT_SAMPLE_RATE;
3504}
3505
Andy Hung6ac17eb2023-06-20 18:56:17 -07003506audio_channel_mask_t DeviceEffectProxy::channelMask() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003507 if (mDevicePort.id != AUDIO_PORT_HANDLE_NONE &&
3508 (mDevicePort.config_mask & AUDIO_PORT_CONFIG_CHANNEL_MASK) != 0) {
3509 return mDevicePort.channel_mask;
3510 }
3511 return AUDIO_CHANNEL_OUT_STEREO;
3512}
3513
Andy Hung6ac17eb2023-06-20 18:56:17 -07003514uint32_t DeviceEffectProxy::channelCount() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003515 if (isOutput()) {
3516 return audio_channel_count_from_out_mask(channelMask());
3517 }
3518 return audio_channel_count_from_in_mask(channelMask());
3519}
3520
Andy Hung6ac17eb2023-06-20 18:56:17 -07003521void DeviceEffectProxy::dump2(int fd, int spaces) const
Andy Hung920f6572022-10-06 12:09:49 -07003522NO_THREAD_SAFETY_ANALYSIS // conditional try lock
3523{
Eric Laurentb82e6b72019-11-22 17:25:04 -08003524 const Vector<String16> args;
3525 EffectBase::dump(fd, args);
3526
Andy Hung0a51b5c2023-07-18 20:54:44 -07003527 const bool locked = afutils::dumpTryLock(mProxyLock);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003528 if (!locked) {
3529 String8 result("DeviceEffectProxy may be deadlocked\n");
3530 write(fd, result.string(), result.size());
3531 }
3532
3533 String8 outStr;
3534 if (mHalEffect != nullptr) {
3535 outStr.appendFormat("%*sHAL Effect Id: %d\n", spaces, "", mHalEffect->id());
3536 } else {
3537 outStr.appendFormat("%*sNO HAL Effect\n", spaces, "");
3538 }
3539 write(fd, outStr.string(), outStr.size());
3540 outStr.clear();
3541
3542 outStr.appendFormat("%*sSub Effects:\n", spaces, "");
3543 write(fd, outStr.string(), outStr.size());
3544 outStr.clear();
3545
3546 for (const auto& iter : mEffectHandles) {
3547 outStr.appendFormat("%*sEffect for patch handle %d:\n", spaces + 2, "", iter.first);
3548 write(fd, outStr.string(), outStr.size());
3549 outStr.clear();
Andy Hung6ac17eb2023-06-20 18:56:17 -07003550 sp<IAfEffectBase> effect = iter.second->effect().promote();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003551 if (effect != nullptr) {
3552 effect->dump(fd, args);
3553 }
3554 }
3555
3556 if (locked) {
François Gaffiefcf15bf2023-02-15 11:37:43 +01003557 mProxyLock.unlock();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003558 }
3559}
3560
3561#undef LOG_TAG
Andy Hung6ac17eb2023-06-20 18:56:17 -07003562#define LOG_TAG "DeviceEffectProxy::ProxyCallback"
Eric Laurentb82e6b72019-11-22 17:25:04 -08003563
Andy Hung6ac17eb2023-06-20 18:56:17 -07003564int DeviceEffectProxy::ProxyCallback::newEffectId() {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003565 return mManagerCallback->newEffectId();
3566}
3567
3568
Andy Hung6ac17eb2023-06-20 18:56:17 -07003569bool DeviceEffectProxy::ProxyCallback::disconnectEffectHandle(
3570 IAfEffectHandle *handle, bool unpinIfLast) {
3571 sp<IAfEffectBase> effectBase = handle->effect().promote();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003572 if (effectBase == nullptr) {
3573 return false;
3574 }
3575
Andy Hung6ac17eb2023-06-20 18:56:17 -07003576 sp<IAfEffectModule> effect = effectBase->asEffectModule();
Eric Laurentb82e6b72019-11-22 17:25:04 -08003577 if (effect == nullptr) {
3578 return false;
3579 }
3580
3581 // restore suspended effects if the disconnected handle was enabled and the last one.
3582 bool remove = (effect->removeHandle(handle) == 0) && (!effect->isPinned() || unpinIfLast);
3583 if (remove) {
3584 sp<DeviceEffectProxy> proxy = mProxy.promote();
3585 if (proxy != nullptr) {
3586 proxy->removeEffect(effect);
3587 }
3588 if (handle->enabled()) {
3589 effectBase->checkSuspendOnEffectEnabled(false, false /*threadLocked*/);
3590 }
3591 }
3592 return true;
3593}
3594
Andy Hung6ac17eb2023-06-20 18:56:17 -07003595status_t DeviceEffectProxy::ProxyCallback::createEffectHal(
Eric Laurentb82e6b72019-11-22 17:25:04 -08003596 const effect_uuid_t *pEffectUuid, int32_t sessionId, int32_t deviceId,
3597 sp<EffectHalInterface> *effect) {
3598 return mManagerCallback->createEffectHal(pEffectUuid, sessionId, deviceId, effect);
3599}
3600
Andy Hung6ac17eb2023-06-20 18:56:17 -07003601status_t DeviceEffectProxy::ProxyCallback::addEffectToHal(
Andy Hung920f6572022-10-06 12:09:49 -07003602 const sp<EffectHalInterface>& effect) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003603 sp<DeviceEffectProxy> proxy = mProxy.promote();
3604 if (proxy == nullptr) {
3605 return NO_INIT;
3606 }
3607 return proxy->addEffectToHal(effect);
3608}
3609
Andy Hung6ac17eb2023-06-20 18:56:17 -07003610status_t DeviceEffectProxy::ProxyCallback::removeEffectFromHal(
Andy Hung920f6572022-10-06 12:09:49 -07003611 const sp<EffectHalInterface>& effect) {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003612 sp<DeviceEffectProxy> proxy = mProxy.promote();
3613 if (proxy == nullptr) {
3614 return NO_INIT;
3615 }
Eric Laurent76c89f32021-12-03 17:13:23 +01003616 return proxy->removeEffectFromHal(effect);
Eric Laurentb82e6b72019-11-22 17:25:04 -08003617}
3618
Andy Hung6ac17eb2023-06-20 18:56:17 -07003619bool DeviceEffectProxy::ProxyCallback::isOutput() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003620 sp<DeviceEffectProxy> proxy = mProxy.promote();
3621 if (proxy == nullptr) {
3622 return true;
3623 }
3624 return proxy->isOutput();
3625}
3626
Andy Hung6ac17eb2023-06-20 18:56:17 -07003627uint32_t DeviceEffectProxy::ProxyCallback::sampleRate() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003628 sp<DeviceEffectProxy> proxy = mProxy.promote();
3629 if (proxy == nullptr) {
3630 return DEFAULT_OUTPUT_SAMPLE_RATE;
3631 }
3632 return proxy->sampleRate();
3633}
3634
Andy Hung6ac17eb2023-06-20 18:56:17 -07003635audio_channel_mask_t DeviceEffectProxy::ProxyCallback::inChannelMask(
Eric Laurentf1f22e72021-07-13 14:04:14 +02003636 int id __unused) const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003637 sp<DeviceEffectProxy> proxy = mProxy.promote();
3638 if (proxy == nullptr) {
3639 return AUDIO_CHANNEL_OUT_STEREO;
3640 }
3641 return proxy->channelMask();
3642}
3643
Andy Hung6ac17eb2023-06-20 18:56:17 -07003644uint32_t DeviceEffectProxy::ProxyCallback::inChannelCount(int id __unused) const {
Eric Laurentf1f22e72021-07-13 14:04:14 +02003645 sp<DeviceEffectProxy> proxy = mProxy.promote();
3646 if (proxy == nullptr) {
3647 return 2;
3648 }
3649 return proxy->channelCount();
3650}
3651
Andy Hung6ac17eb2023-06-20 18:56:17 -07003652audio_channel_mask_t DeviceEffectProxy::ProxyCallback::outChannelMask() const {
Eric Laurentf1f22e72021-07-13 14:04:14 +02003653 sp<DeviceEffectProxy> proxy = mProxy.promote();
3654 if (proxy == nullptr) {
3655 return AUDIO_CHANNEL_OUT_STEREO;
3656 }
3657 return proxy->channelMask();
3658}
3659
Andy Hung6ac17eb2023-06-20 18:56:17 -07003660uint32_t DeviceEffectProxy::ProxyCallback::outChannelCount() const {
Eric Laurentb82e6b72019-11-22 17:25:04 -08003661 sp<DeviceEffectProxy> proxy = mProxy.promote();
3662 if (proxy == nullptr) {
3663 return 2;
3664 }
3665 return proxy->channelCount();
3666}
3667
Andy Hung6ac17eb2023-06-20 18:56:17 -07003668void DeviceEffectProxy::ProxyCallback::onEffectEnable(
3669 const sp<IAfEffectBase>& effectBase) {
3670 sp<IAfEffectModule> effect = effectBase->asEffectModule();
Eric Laurent76c89f32021-12-03 17:13:23 +01003671 if (effect == nullptr) {
3672 return;
3673 }
3674 effect->start();
3675}
3676
Andy Hung6ac17eb2023-06-20 18:56:17 -07003677void DeviceEffectProxy::ProxyCallback::onEffectDisable(
3678 const sp<IAfEffectBase>& effectBase) {
3679 sp<IAfEffectModule> effect = effectBase->asEffectModule();
Eric Laurent76c89f32021-12-03 17:13:23 +01003680 if (effect == nullptr) {
3681 return;
3682 }
3683 effect->stop();
3684}
3685
Glenn Kasten63238ef2015-03-02 15:50:29 -08003686} // namespace android