AudioPolicyManager.cpp revision 828bcffa0d5f73461c6c1ba4ef6d3da704c27b7e 
1/*
2 * Copyright (C) 2009 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17#define LOG_TAG "AudioPolicyManager"
18//#define LOG_NDEBUG 0
19
20//#define VERY_VERBOSE_LOGGING
21#ifdef VERY_VERBOSE_LOGGING
22#define ALOGVV ALOGV
23#else
24#define ALOGVV(a...) do { } while(0)
25#endif
26
27// A device mask for all audio input devices that are considered "virtual" when evaluating
28// active inputs in getActiveInput()
29#define APM_AUDIO_IN_DEVICE_VIRTUAL_ALL  AUDIO_DEVICE_IN_REMOTE_SUBMIX
30// A device mask for all audio output devices that are considered "remote" when evaluating
31// active output devices in isStreamActiveRemotely()
32#define APM_AUDIO_OUT_DEVICE_REMOTE_ALL  AUDIO_DEVICE_OUT_REMOTE_SUBMIX
33// A device mask for all audio input and output devices where matching inputs/outputs on device
34// type alone is not enough: the address must match too
35#define APM_AUDIO_DEVICE_MATCH_ADDRESS_ALL (AUDIO_DEVICE_IN_REMOTE_SUBMIX | \
36                                            AUDIO_DEVICE_OUT_REMOTE_SUBMIX)
37
38#include <inttypes.h>
39#include <math.h>
40
41#include <cutils/properties.h>
42#include <utils/Log.h>
43#include <hardware/audio.h>
44#include <hardware/audio_effect.h>
45#include <media/AudioParameter.h>
46#include <soundtrigger/SoundTrigger.h>
47#include "AudioPolicyManager.h"
48#include "audio_policy_conf.h"
49
50namespace android {
51
52// ----------------------------------------------------------------------------
53// Definitions for audio_policy.conf file parsing
54// ----------------------------------------------------------------------------
55
56struct StringToEnum {
57    const char *name;
58    uint32_t value;
59};
60
61#define STRING_TO_ENUM(string) { #string, string }
62#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
63
64const StringToEnum sDeviceNameToEnumTable[] = {
65    STRING_TO_ENUM(AUDIO_DEVICE_OUT_EARPIECE),
66    STRING_TO_ENUM(AUDIO_DEVICE_OUT_SPEAKER),
67    STRING_TO_ENUM(AUDIO_DEVICE_OUT_WIRED_HEADSET),
68    STRING_TO_ENUM(AUDIO_DEVICE_OUT_WIRED_HEADPHONE),
69    STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_SCO),
70    STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET),
71    STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT),
72    STRING_TO_ENUM(AUDIO_DEVICE_OUT_ALL_SCO),
73    STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_A2DP),
74    STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES),
75    STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER),
76    STRING_TO_ENUM(AUDIO_DEVICE_OUT_ALL_A2DP),
77    STRING_TO_ENUM(AUDIO_DEVICE_OUT_AUX_DIGITAL),
78    STRING_TO_ENUM(AUDIO_DEVICE_OUT_HDMI),
79    STRING_TO_ENUM(AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET),
80    STRING_TO_ENUM(AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET),
81    STRING_TO_ENUM(AUDIO_DEVICE_OUT_USB_ACCESSORY),
82    STRING_TO_ENUM(AUDIO_DEVICE_OUT_USB_DEVICE),
83    STRING_TO_ENUM(AUDIO_DEVICE_OUT_ALL_USB),
84    STRING_TO_ENUM(AUDIO_DEVICE_OUT_REMOTE_SUBMIX),
85    STRING_TO_ENUM(AUDIO_DEVICE_OUT_TELEPHONY_TX),
86    STRING_TO_ENUM(AUDIO_DEVICE_OUT_LINE),
87    STRING_TO_ENUM(AUDIO_DEVICE_OUT_HDMI_ARC),
88    STRING_TO_ENUM(AUDIO_DEVICE_OUT_SPDIF),
89    STRING_TO_ENUM(AUDIO_DEVICE_OUT_FM),
90    STRING_TO_ENUM(AUDIO_DEVICE_OUT_AUX_LINE),
91    STRING_TO_ENUM(AUDIO_DEVICE_IN_AMBIENT),
92    STRING_TO_ENUM(AUDIO_DEVICE_IN_BUILTIN_MIC),
93    STRING_TO_ENUM(AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET),
94    STRING_TO_ENUM(AUDIO_DEVICE_IN_ALL_SCO),
95    STRING_TO_ENUM(AUDIO_DEVICE_IN_WIRED_HEADSET),
96    STRING_TO_ENUM(AUDIO_DEVICE_IN_AUX_DIGITAL),
97    STRING_TO_ENUM(AUDIO_DEVICE_IN_HDMI),
98    STRING_TO_ENUM(AUDIO_DEVICE_IN_TELEPHONY_RX),
99    STRING_TO_ENUM(AUDIO_DEVICE_IN_VOICE_CALL),
100    STRING_TO_ENUM(AUDIO_DEVICE_IN_BACK_MIC),
101    STRING_TO_ENUM(AUDIO_DEVICE_IN_REMOTE_SUBMIX),
102    STRING_TO_ENUM(AUDIO_DEVICE_IN_ANLG_DOCK_HEADSET),
103    STRING_TO_ENUM(AUDIO_DEVICE_IN_DGTL_DOCK_HEADSET),
104    STRING_TO_ENUM(AUDIO_DEVICE_IN_USB_ACCESSORY),
105    STRING_TO_ENUM(AUDIO_DEVICE_IN_USB_DEVICE),
106    STRING_TO_ENUM(AUDIO_DEVICE_IN_FM_TUNER),
107    STRING_TO_ENUM(AUDIO_DEVICE_IN_TV_TUNER),
108    STRING_TO_ENUM(AUDIO_DEVICE_IN_LINE),
109    STRING_TO_ENUM(AUDIO_DEVICE_IN_SPDIF),
110    STRING_TO_ENUM(AUDIO_DEVICE_IN_BLUETOOTH_A2DP),
111    STRING_TO_ENUM(AUDIO_DEVICE_IN_LOOPBACK),
112};
113
114const StringToEnum sFlagNameToEnumTable[] = {
115    STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_DIRECT),
116    STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_PRIMARY),
117    STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_FAST),
118    STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_DEEP_BUFFER),
119    STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD),
120    STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_NON_BLOCKING),
121    STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_HW_AV_SYNC),
122};
123
124const StringToEnum sFormatNameToEnumTable[] = {
125    STRING_TO_ENUM(AUDIO_FORMAT_PCM_16_BIT),
126    STRING_TO_ENUM(AUDIO_FORMAT_PCM_8_BIT),
127    STRING_TO_ENUM(AUDIO_FORMAT_PCM_32_BIT),
128    STRING_TO_ENUM(AUDIO_FORMAT_PCM_8_24_BIT),
129    STRING_TO_ENUM(AUDIO_FORMAT_PCM_FLOAT),
130    STRING_TO_ENUM(AUDIO_FORMAT_PCM_24_BIT_PACKED),
131    STRING_TO_ENUM(AUDIO_FORMAT_MP3),
132    STRING_TO_ENUM(AUDIO_FORMAT_AAC),
133    STRING_TO_ENUM(AUDIO_FORMAT_AAC_MAIN),
134    STRING_TO_ENUM(AUDIO_FORMAT_AAC_LC),
135    STRING_TO_ENUM(AUDIO_FORMAT_AAC_SSR),
136    STRING_TO_ENUM(AUDIO_FORMAT_AAC_LTP),
137    STRING_TO_ENUM(AUDIO_FORMAT_AAC_HE_V1),
138    STRING_TO_ENUM(AUDIO_FORMAT_AAC_SCALABLE),
139    STRING_TO_ENUM(AUDIO_FORMAT_AAC_ERLC),
140    STRING_TO_ENUM(AUDIO_FORMAT_AAC_LD),
141    STRING_TO_ENUM(AUDIO_FORMAT_AAC_HE_V2),
142    STRING_TO_ENUM(AUDIO_FORMAT_AAC_ELD),
143    STRING_TO_ENUM(AUDIO_FORMAT_VORBIS),
144    STRING_TO_ENUM(AUDIO_FORMAT_HE_AAC_V1),
145    STRING_TO_ENUM(AUDIO_FORMAT_HE_AAC_V2),
146    STRING_TO_ENUM(AUDIO_FORMAT_OPUS),
147    STRING_TO_ENUM(AUDIO_FORMAT_AC3),
148    STRING_TO_ENUM(AUDIO_FORMAT_E_AC3),
149};
150
151const StringToEnum sOutChannelsNameToEnumTable[] = {
152    STRING_TO_ENUM(AUDIO_CHANNEL_OUT_MONO),
153    STRING_TO_ENUM(AUDIO_CHANNEL_OUT_STEREO),
154    STRING_TO_ENUM(AUDIO_CHANNEL_OUT_QUAD),
155    STRING_TO_ENUM(AUDIO_CHANNEL_OUT_5POINT1),
156    STRING_TO_ENUM(AUDIO_CHANNEL_OUT_7POINT1),
157};
158
159const StringToEnum sInChannelsNameToEnumTable[] = {
160    STRING_TO_ENUM(AUDIO_CHANNEL_IN_MONO),
161    STRING_TO_ENUM(AUDIO_CHANNEL_IN_STEREO),
162    STRING_TO_ENUM(AUDIO_CHANNEL_IN_FRONT_BACK),
163};
164
165const StringToEnum sGainModeNameToEnumTable[] = {
166    STRING_TO_ENUM(AUDIO_GAIN_MODE_JOINT),
167    STRING_TO_ENUM(AUDIO_GAIN_MODE_CHANNELS),
168    STRING_TO_ENUM(AUDIO_GAIN_MODE_RAMP),
169};
170
171
172uint32_t AudioPolicyManager::stringToEnum(const struct StringToEnum *table,
173                                              size_t size,
174                                              const char *name)
175{
176    for (size_t i = 0; i < size; i++) {
177        if (strcmp(table[i].name, name) == 0) {
178            ALOGV("stringToEnum() found %s", table[i].name);
179            return table[i].value;
180        }
181    }
182    return 0;
183}
184
185const char *AudioPolicyManager::enumToString(const struct StringToEnum *table,
186                                              size_t size,
187                                              uint32_t value)
188{
189    for (size_t i = 0; i < size; i++) {
190        if (table[i].value == value) {
191            return table[i].name;
192        }
193    }
194    return "";
195}
196
197bool AudioPolicyManager::stringToBool(const char *value)
198{
199    return ((strcasecmp("true", value) == 0) || (strcmp("1", value) == 0));
200}
201
202
203// ----------------------------------------------------------------------------
204// AudioPolicyInterface implementation
205// ----------------------------------------------------------------------------
206
207
208status_t AudioPolicyManager::setDeviceConnectionState(audio_devices_t device,
209                                                          audio_policy_dev_state_t state,
210                                                  const char *device_address)
211{
212    String8 address = (device_address == NULL) ? String8("") : String8(device_address);
213
214    ALOGV("setDeviceConnectionState() device: %x, state %d, address %s",
215            device, state, address.string());
216
217    // connect/disconnect only 1 device at a time
218    if (!audio_is_output_device(device) && !audio_is_input_device(device)) return BAD_VALUE;
219
220    // handle output devices
221    if (audio_is_output_device(device)) {
222        SortedVector <audio_io_handle_t> outputs;
223
224        sp<DeviceDescriptor> devDesc = new DeviceDescriptor(String8(""), device);
225        devDesc->mAddress = address;
226        ssize_t index = mAvailableOutputDevices.indexOf(devDesc);
227
228        // save a copy of the opened output descriptors before any output is opened or closed
229        // by checkOutputsForDevice(). This will be needed by checkOutputForAllStrategies()
230        mPreviousOutputs = mOutputs;
231        switch (state)
232        {
233        // handle output device connection
234        case AUDIO_POLICY_DEVICE_STATE_AVAILABLE:
235            if (index >= 0) {
236                ALOGW("setDeviceConnectionState() device already connected: %x", device);
237                return INVALID_OPERATION;
238            }
239            ALOGV("setDeviceConnectionState() connecting device %x", device);
240
241            // register new device as available
242            index = mAvailableOutputDevices.add(devDesc);
243            if (index >= 0) {
244                sp<HwModule> module = getModuleForDevice(device);
245                if (module == 0) {
246                    ALOGD("setDeviceConnectionState() could not find HW module for device %08x",
247                          device);
248                    mAvailableOutputDevices.remove(devDesc);
249                    return INVALID_OPERATION;
250                }
251                mAvailableOutputDevices[index]->mId = nextUniqueId();
252                mAvailableOutputDevices[index]->mModule = module;
253            } else {
254                return NO_MEMORY;
255            }
256
257            if (checkOutputsForDevice(devDesc, state, outputs, address) != NO_ERROR) {
258                mAvailableOutputDevices.remove(devDesc);
259                return INVALID_OPERATION;
260            }
261            // outputs should never be empty here
262            ALOG_ASSERT(outputs.size() != 0, "setDeviceConnectionState():"
263                    "checkOutputsForDevice() returned no outputs but status OK");
264            ALOGV("setDeviceConnectionState() checkOutputsForDevice() returned %zu outputs",
265                  outputs.size());
266            break;
267        // handle output device disconnection
268        case AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE: {
269            if (index < 0) {
270                ALOGW("setDeviceConnectionState() device not connected: %x", device);
271                return INVALID_OPERATION;
272            }
273
274            ALOGV("setDeviceConnectionState() disconnecting output device %x", device);
275
276            // Set Disconnect to HALs
277            AudioParameter param = AudioParameter(address);
278            param.addInt(String8(AUDIO_PARAMETER_DEVICE_DISCONNECT), device);
279            mpClientInterface->setParameters(AUDIO_IO_HANDLE_NONE, param.toString());
280
281            // remove device from available output devices
282            mAvailableOutputDevices.remove(devDesc);
283
284            checkOutputsForDevice(devDesc, state, outputs, address);
285            } break;
286
287        default:
288            ALOGE("setDeviceConnectionState() invalid state: %x", state);
289            return BAD_VALUE;
290        }
291
292        // checkA2dpSuspend must run before checkOutputForAllStrategies so that A2DP
293        // output is suspended before any tracks are moved to it
294        checkA2dpSuspend();
295        checkOutputForAllStrategies();
296        // outputs must be closed after checkOutputForAllStrategies() is executed
297        if (!outputs.isEmpty()) {
298            for (size_t i = 0; i < outputs.size(); i++) {
299                sp<AudioOutputDescriptor> desc = mOutputs.valueFor(outputs[i]);
300                // close unused outputs after device disconnection or direct outputs that have been
301                // opened by checkOutputsForDevice() to query dynamic parameters
302                if ((state == AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE) ||
303                        (((desc->mFlags & AUDIO_OUTPUT_FLAG_DIRECT) != 0) &&
304                         (desc->mDirectOpenCount == 0))) {
305                    closeOutput(outputs[i]);
306                }
307            }
308            // check again after closing A2DP output to reset mA2dpSuspended if needed
309            checkA2dpSuspend();
310        }
311
312        updateDevicesAndOutputs();
313        if (mPhoneState == AUDIO_MODE_IN_CALL) {
314            audio_devices_t newDevice = getNewOutputDevice(mPrimaryOutput, false /*fromCache*/);
315            updateCallRouting(newDevice);
316        }
317        for (size_t i = 0; i < mOutputs.size(); i++) {
318            audio_io_handle_t output = mOutputs.keyAt(i);
319            if ((mPhoneState != AUDIO_MODE_IN_CALL) || (output != mPrimaryOutput)) {
320                audio_devices_t newDevice = getNewOutputDevice(mOutputs.keyAt(i),
321                                                               true /*fromCache*/);
322                // do not force device change on duplicated output because if device is 0, it will
323                // also force a device 0 for the two outputs it is duplicated to which may override
324                // a valid device selection on those outputs.
325                bool force = !mOutputs.valueAt(i)->isDuplicated()
326                        && (!deviceDistinguishesOnAddress(device)
327                                // always force when disconnecting (a non-duplicated device)
328                                || (state == AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE));
329                setOutputDevice(output, newDevice, force, 0);
330            }
331        }
332
333        mpClientInterface->onAudioPortListUpdate();
334        return NO_ERROR;
335    }  // end if is output device
336
337    // handle input devices
338    if (audio_is_input_device(device)) {
339        SortedVector <audio_io_handle_t> inputs;
340
341        sp<DeviceDescriptor> devDesc = new DeviceDescriptor(String8(""), device);
342        devDesc->mAddress = address;
343        ssize_t index = mAvailableInputDevices.indexOf(devDesc);
344        switch (state)
345        {
346        // handle input device connection
347        case AUDIO_POLICY_DEVICE_STATE_AVAILABLE: {
348            if (index >= 0) {
349                ALOGW("setDeviceConnectionState() device already connected: %d", device);
350                return INVALID_OPERATION;
351            }
352            sp<HwModule> module = getModuleForDevice(device);
353            if (module == NULL) {
354                ALOGW("setDeviceConnectionState(): could not find HW module for device %08x",
355                      device);
356                return INVALID_OPERATION;
357            }
358            if (checkInputsForDevice(device, state, inputs, address) != NO_ERROR) {
359                return INVALID_OPERATION;
360            }
361
362            index = mAvailableInputDevices.add(devDesc);
363            if (index >= 0) {
364                mAvailableInputDevices[index]->mId = nextUniqueId();
365                mAvailableInputDevices[index]->mModule = module;
366            } else {
367                return NO_MEMORY;
368            }
369        } break;
370
371        // handle input device disconnection
372        case AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE: {
373            if (index < 0) {
374                ALOGW("setDeviceConnectionState() device not connected: %d", device);
375                return INVALID_OPERATION;
376            }
377
378            ALOGV("setDeviceConnectionState() disconnecting input device %x", device);
379
380            // Set Disconnect to HALs
381            AudioParameter param = AudioParameter(address);
382            param.addInt(String8(AUDIO_PARAMETER_DEVICE_DISCONNECT), device);
383            mpClientInterface->setParameters(AUDIO_IO_HANDLE_NONE, param.toString());
384
385            checkInputsForDevice(device, state, inputs, address);
386            mAvailableInputDevices.remove(devDesc);
387
388        } break;
389
390        default:
391            ALOGE("setDeviceConnectionState() invalid state: %x", state);
392            return BAD_VALUE;
393        }
394
395        closeAllInputs();
396
397        if (mPhoneState == AUDIO_MODE_IN_CALL) {
398            audio_devices_t newDevice = getNewOutputDevice(mPrimaryOutput, false /*fromCache*/);
399            updateCallRouting(newDevice);
400        }
401
402        mpClientInterface->onAudioPortListUpdate();
403        return NO_ERROR;
404    } // end if is input device
405
406    ALOGW("setDeviceConnectionState() invalid device: %x", device);
407    return BAD_VALUE;
408}
409
410audio_policy_dev_state_t AudioPolicyManager::getDeviceConnectionState(audio_devices_t device,
411                                                  const char *device_address)
412{
413    audio_policy_dev_state_t state = AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE;
414    sp<DeviceDescriptor> devDesc = new DeviceDescriptor(String8(""), device);
415    devDesc->mAddress = (device_address == NULL) ? String8("") : String8(device_address);
416    ssize_t index;
417    DeviceVector *deviceVector;
418
419    if (audio_is_output_device(device)) {
420        deviceVector = &mAvailableOutputDevices;
421    } else if (audio_is_input_device(device)) {
422        deviceVector = &mAvailableInputDevices;
423    } else {
424        ALOGW("getDeviceConnectionState() invalid device type %08x", device);
425        return AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE;
426    }
427
428    index = deviceVector->indexOf(devDesc);
429    if (index >= 0) {
430        return AUDIO_POLICY_DEVICE_STATE_AVAILABLE;
431    } else {
432        return AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE;
433    }
434}
435
436void AudioPolicyManager::updateCallRouting(audio_devices_t rxDevice, int delayMs)
437{
438    bool createTxPatch = false;
439    struct audio_patch patch;
440    patch.num_sources = 1;
441    patch.num_sinks = 1;
442    status_t status;
443    audio_patch_handle_t afPatchHandle;
444    DeviceVector deviceList;
445
446    audio_devices_t txDevice = getDeviceForInputSource(AUDIO_SOURCE_VOICE_COMMUNICATION);
447    ALOGV("updateCallRouting device rxDevice %08x txDevice %08x", rxDevice, txDevice);
448
449    // release existing RX patch if any
450    if (mCallRxPatch != 0) {
451        mpClientInterface->releaseAudioPatch(mCallRxPatch->mAfPatchHandle, 0);
452        mCallRxPatch.clear();
453    }
454    // release TX patch if any
455    if (mCallTxPatch != 0) {
456        mpClientInterface->releaseAudioPatch(mCallTxPatch->mAfPatchHandle, 0);
457        mCallTxPatch.clear();
458    }
459
460    // If the RX device is on the primary HW module, then use legacy routing method for voice calls
461    // via setOutputDevice() on primary output.
462    // Otherwise, create two audio patches for TX and RX path.
463    if (availablePrimaryOutputDevices() & rxDevice) {
464        setOutputDevice(mPrimaryOutput, rxDevice, true, delayMs);
465        // If the TX device is also on the primary HW module, setOutputDevice() will take care
466        // of it due to legacy implementation. If not, create a patch.
467        if ((availablePrimaryInputDevices() & txDevice & ~AUDIO_DEVICE_BIT_IN)
468                == AUDIO_DEVICE_NONE) {
469            createTxPatch = true;
470        }
471    } else {
472        // create RX path audio patch
473        deviceList = mAvailableOutputDevices.getDevicesFromType(rxDevice);
474        ALOG_ASSERT(!deviceList.isEmpty(),
475                    "updateCallRouting() selected device not in output device list");
476        sp<DeviceDescriptor> rxSinkDeviceDesc = deviceList.itemAt(0);
477        deviceList = mAvailableInputDevices.getDevicesFromType(AUDIO_DEVICE_IN_TELEPHONY_RX);
478        ALOG_ASSERT(!deviceList.isEmpty(),
479                    "updateCallRouting() no telephony RX device");
480        sp<DeviceDescriptor> rxSourceDeviceDesc = deviceList.itemAt(0);
481
482        rxSourceDeviceDesc->toAudioPortConfig(&patch.sources[0]);
483        rxSinkDeviceDesc->toAudioPortConfig(&patch.sinks[0]);
484
485        // request to reuse existing output stream if one is already opened to reach the RX device
486        SortedVector<audio_io_handle_t> outputs =
487                                getOutputsForDevice(rxDevice, mOutputs);
488        audio_io_handle_t output = selectOutput(outputs, AUDIO_OUTPUT_FLAG_NONE);
489        if (output != AUDIO_IO_HANDLE_NONE) {
490            sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(output);
491            ALOG_ASSERT(!outputDesc->isDuplicated(),
492                        "updateCallRouting() RX device output is duplicated");
493            outputDesc->toAudioPortConfig(&patch.sources[1]);
494            patch.num_sources = 2;
495        }
496
497        afPatchHandle = AUDIO_PATCH_HANDLE_NONE;
498        status = mpClientInterface->createAudioPatch(&patch, &afPatchHandle, 0);
499        ALOGW_IF(status != NO_ERROR, "updateCallRouting() error %d creating RX audio patch",
500                                               status);
501        if (status == NO_ERROR) {
502            mCallRxPatch = new AudioPatch((audio_patch_handle_t)nextUniqueId(),
503                                       &patch, mUidCached);
504            mCallRxPatch->mAfPatchHandle = afPatchHandle;
505            mCallRxPatch->mUid = mUidCached;
506        }
507        createTxPatch = true;
508    }
509    if (createTxPatch) {
510
511        struct audio_patch patch;
512        patch.num_sources = 1;
513        patch.num_sinks = 1;
514        deviceList = mAvailableInputDevices.getDevicesFromType(txDevice);
515        ALOG_ASSERT(!deviceList.isEmpty(),
516                    "updateCallRouting() selected device not in input device list");
517        sp<DeviceDescriptor> txSourceDeviceDesc = deviceList.itemAt(0);
518        txSourceDeviceDesc->toAudioPortConfig(&patch.sources[0]);
519        deviceList = mAvailableOutputDevices.getDevicesFromType(AUDIO_DEVICE_OUT_TELEPHONY_TX);
520        ALOG_ASSERT(!deviceList.isEmpty(),
521                    "updateCallRouting() no telephony TX device");
522        sp<DeviceDescriptor> txSinkDeviceDesc = deviceList.itemAt(0);
523        txSinkDeviceDesc->toAudioPortConfig(&patch.sinks[0]);
524
525        SortedVector<audio_io_handle_t> outputs =
526                                getOutputsForDevice(AUDIO_DEVICE_OUT_TELEPHONY_TX, mOutputs);
527        audio_io_handle_t output = selectOutput(outputs, AUDIO_OUTPUT_FLAG_NONE);
528        // request to reuse existing output stream if one is already opened to reach the TX
529        // path output device
530        if (output != AUDIO_IO_HANDLE_NONE) {
531            sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(output);
532            ALOG_ASSERT(!outputDesc->isDuplicated(),
533                        "updateCallRouting() RX device output is duplicated");
534            outputDesc->toAudioPortConfig(&patch.sources[1]);
535            patch.num_sources = 2;
536        }
537
538        afPatchHandle = AUDIO_PATCH_HANDLE_NONE;
539        status = mpClientInterface->createAudioPatch(&patch, &afPatchHandle, 0);
540        ALOGW_IF(status != NO_ERROR, "setPhoneState() error %d creating TX audio patch",
541                                               status);
542        if (status == NO_ERROR) {
543            mCallTxPatch = new AudioPatch((audio_patch_handle_t)nextUniqueId(),
544                                       &patch, mUidCached);
545            mCallTxPatch->mAfPatchHandle = afPatchHandle;
546            mCallTxPatch->mUid = mUidCached;
547        }
548    }
549}
550
551void AudioPolicyManager::setPhoneState(audio_mode_t state)
552{
553    ALOGV("setPhoneState() state %d", state);
554    if (state < 0 || state >= AUDIO_MODE_CNT) {
555        ALOGW("setPhoneState() invalid state %d", state);
556        return;
557    }
558
559    if (state == mPhoneState ) {
560        ALOGW("setPhoneState() setting same state %d", state);
561        return;
562    }
563
564    // if leaving call state, handle special case of active streams
565    // pertaining to sonification strategy see handleIncallSonification()
566    if (isInCall()) {
567        ALOGV("setPhoneState() in call state management: new state is %d", state);
568        for (int stream = 0; stream < AUDIO_STREAM_CNT; stream++) {
569            handleIncallSonification((audio_stream_type_t)stream, false, true);
570        }
571    }
572
573    // store previous phone state for management of sonification strategy below
574    int oldState = mPhoneState;
575    mPhoneState = state;
576    bool force = false;
577
578    // are we entering or starting a call
579    if (!isStateInCall(oldState) && isStateInCall(state)) {
580        ALOGV("  Entering call in setPhoneState()");
581        // force routing command to audio hardware when starting a call
582        // even if no device change is needed
583        force = true;
584        for (int j = 0; j < DEVICE_CATEGORY_CNT; j++) {
585            mStreams[AUDIO_STREAM_DTMF].mVolumeCurve[j] =
586                    sVolumeProfiles[AUDIO_STREAM_VOICE_CALL][j];
587        }
588    } else if (isStateInCall(oldState) && !isStateInCall(state)) {
589        ALOGV("  Exiting call in setPhoneState()");
590        // force routing command to audio hardware when exiting a call
591        // even if no device change is needed
592        force = true;
593        for (int j = 0; j < DEVICE_CATEGORY_CNT; j++) {
594            mStreams[AUDIO_STREAM_DTMF].mVolumeCurve[j] =
595                    sVolumeProfiles[AUDIO_STREAM_DTMF][j];
596        }
597    } else if (isStateInCall(state) && (state != oldState)) {
598        ALOGV("  Switching between telephony and VoIP in setPhoneState()");
599        // force routing command to audio hardware when switching between telephony and VoIP
600        // even if no device change is needed
601        force = true;
602    }
603
604    // check for device and output changes triggered by new phone state
605    checkA2dpSuspend();
606    checkOutputForAllStrategies();
607    updateDevicesAndOutputs();
608
609    sp<AudioOutputDescriptor> hwOutputDesc = mOutputs.valueFor(mPrimaryOutput);
610
611    int delayMs = 0;
612    if (isStateInCall(state)) {
613        nsecs_t sysTime = systemTime();
614        for (size_t i = 0; i < mOutputs.size(); i++) {
615            sp<AudioOutputDescriptor> desc = mOutputs.valueAt(i);
616            // mute media and sonification strategies and delay device switch by the largest
617            // latency of any output where either strategy is active.
618            // This avoid sending the ring tone or music tail into the earpiece or headset.
619            if ((desc->isStrategyActive(STRATEGY_MEDIA,
620                                     SONIFICATION_HEADSET_MUSIC_DELAY,
621                                     sysTime) ||
622                    desc->isStrategyActive(STRATEGY_SONIFICATION,
623                                         SONIFICATION_HEADSET_MUSIC_DELAY,
624                                         sysTime)) &&
625                    (delayMs < (int)desc->mLatency*2)) {
626                delayMs = desc->mLatency*2;
627            }
628            setStrategyMute(STRATEGY_MEDIA, true, mOutputs.keyAt(i));
629            setStrategyMute(STRATEGY_MEDIA, false, mOutputs.keyAt(i), MUTE_TIME_MS,
630                getDeviceForStrategy(STRATEGY_MEDIA, true /*fromCache*/));
631            setStrategyMute(STRATEGY_SONIFICATION, true, mOutputs.keyAt(i));
632            setStrategyMute(STRATEGY_SONIFICATION, false, mOutputs.keyAt(i), MUTE_TIME_MS,
633                getDeviceForStrategy(STRATEGY_SONIFICATION, true /*fromCache*/));
634        }
635    }
636
637    // Note that despite the fact that getNewOutputDevice() is called on the primary output,
638    // the device returned is not necessarily reachable via this output
639    audio_devices_t rxDevice = getNewOutputDevice(mPrimaryOutput, false /*fromCache*/);
640    // force routing command to audio hardware when ending call
641    // even if no device change is needed
642    if (isStateInCall(oldState) && rxDevice == AUDIO_DEVICE_NONE) {
643        rxDevice = hwOutputDesc->device();
644    }
645
646    if (state == AUDIO_MODE_IN_CALL) {
647        updateCallRouting(rxDevice, delayMs);
648    } else if (oldState == AUDIO_MODE_IN_CALL) {
649        if (mCallRxPatch != 0) {
650            mpClientInterface->releaseAudioPatch(mCallRxPatch->mAfPatchHandle, 0);
651            mCallRxPatch.clear();
652        }
653        if (mCallTxPatch != 0) {
654            mpClientInterface->releaseAudioPatch(mCallTxPatch->mAfPatchHandle, 0);
655            mCallTxPatch.clear();
656        }
657        setOutputDevice(mPrimaryOutput, rxDevice, force, 0);
658    } else {
659        setOutputDevice(mPrimaryOutput, rxDevice, force, 0);
660    }
661    // if entering in call state, handle special case of active streams
662    // pertaining to sonification strategy see handleIncallSonification()
663    if (isStateInCall(state)) {
664        ALOGV("setPhoneState() in call state management: new state is %d", state);
665        for (int stream = 0; stream < AUDIO_STREAM_CNT; stream++) {
666            handleIncallSonification((audio_stream_type_t)stream, true, true);
667        }
668    }
669
670    // Flag that ringtone volume must be limited to music volume until we exit MODE_RINGTONE
671    if (state == AUDIO_MODE_RINGTONE &&
672        isStreamActive(AUDIO_STREAM_MUSIC, SONIFICATION_HEADSET_MUSIC_DELAY)) {
673        mLimitRingtoneVolume = true;
674    } else {
675        mLimitRingtoneVolume = false;
676    }
677}
678
679void AudioPolicyManager::setForceUse(audio_policy_force_use_t usage,
680                                         audio_policy_forced_cfg_t config)
681{
682    ALOGV("setForceUse() usage %d, config %d, mPhoneState %d", usage, config, mPhoneState);
683
684    bool forceVolumeReeval = false;
685    switch(usage) {
686    case AUDIO_POLICY_FORCE_FOR_COMMUNICATION:
687        if (config != AUDIO_POLICY_FORCE_SPEAKER && config != AUDIO_POLICY_FORCE_BT_SCO &&
688            config != AUDIO_POLICY_FORCE_NONE) {
689            ALOGW("setForceUse() invalid config %d for FOR_COMMUNICATION", config);
690            return;
691        }
692        forceVolumeReeval = true;
693        mForceUse[usage] = config;
694        break;
695    case AUDIO_POLICY_FORCE_FOR_MEDIA:
696        if (config != AUDIO_POLICY_FORCE_HEADPHONES && config != AUDIO_POLICY_FORCE_BT_A2DP &&
697            config != AUDIO_POLICY_FORCE_WIRED_ACCESSORY &&
698            config != AUDIO_POLICY_FORCE_ANALOG_DOCK &&
699            config != AUDIO_POLICY_FORCE_DIGITAL_DOCK && config != AUDIO_POLICY_FORCE_NONE &&
700            config != AUDIO_POLICY_FORCE_NO_BT_A2DP) {
701            ALOGW("setForceUse() invalid config %d for FOR_MEDIA", config);
702            return;
703        }
704        mForceUse[usage] = config;
705        break;
706    case AUDIO_POLICY_FORCE_FOR_RECORD:
707        if (config != AUDIO_POLICY_FORCE_BT_SCO && config != AUDIO_POLICY_FORCE_WIRED_ACCESSORY &&
708            config != AUDIO_POLICY_FORCE_NONE) {
709            ALOGW("setForceUse() invalid config %d for FOR_RECORD", config);
710            return;
711        }
712        mForceUse[usage] = config;
713        break;
714    case AUDIO_POLICY_FORCE_FOR_DOCK:
715        if (config != AUDIO_POLICY_FORCE_NONE && config != AUDIO_POLICY_FORCE_BT_CAR_DOCK &&
716            config != AUDIO_POLICY_FORCE_BT_DESK_DOCK &&
717            config != AUDIO_POLICY_FORCE_WIRED_ACCESSORY &&
718            config != AUDIO_POLICY_FORCE_ANALOG_DOCK &&
719            config != AUDIO_POLICY_FORCE_DIGITAL_DOCK) {
720            ALOGW("setForceUse() invalid config %d for FOR_DOCK", config);
721        }
722        forceVolumeReeval = true;
723        mForceUse[usage] = config;
724        break;
725    case AUDIO_POLICY_FORCE_FOR_SYSTEM:
726        if (config != AUDIO_POLICY_FORCE_NONE &&
727            config != AUDIO_POLICY_FORCE_SYSTEM_ENFORCED) {
728            ALOGW("setForceUse() invalid config %d for FOR_SYSTEM", config);
729        }
730        forceVolumeReeval = true;
731        mForceUse[usage] = config;
732        break;
733    case AUDIO_POLICY_FORCE_FOR_HDMI_SYSTEM_AUDIO:
734        if (config != AUDIO_POLICY_FORCE_NONE &&
735            config != AUDIO_POLICY_FORCE_HDMI_SYSTEM_AUDIO_ENFORCED) {
736            ALOGW("setForceUse() invalid config %d forHDMI_SYSTEM_AUDIO", config);
737        }
738        mForceUse[usage] = config;
739        break;
740    default:
741        ALOGW("setForceUse() invalid usage %d", usage);
742        break;
743    }
744
745    // check for device and output changes triggered by new force usage
746    checkA2dpSuspend();
747    checkOutputForAllStrategies();
748    updateDevicesAndOutputs();
749    if (mPhoneState == AUDIO_MODE_IN_CALL) {
750        audio_devices_t newDevice = getNewOutputDevice(mPrimaryOutput, true /*fromCache*/);
751        updateCallRouting(newDevice);
752    }
753    for (size_t i = 0; i < mOutputs.size(); i++) {
754        audio_io_handle_t output = mOutputs.keyAt(i);
755        audio_devices_t newDevice = getNewOutputDevice(output, true /*fromCache*/);
756        if ((mPhoneState != AUDIO_MODE_IN_CALL) || (output != mPrimaryOutput)) {
757            setOutputDevice(output, newDevice, (newDevice != AUDIO_DEVICE_NONE));
758        }
759        if (forceVolumeReeval && (newDevice != AUDIO_DEVICE_NONE)) {
760            applyStreamVolumes(output, newDevice, 0, true);
761        }
762    }
763
764    audio_io_handle_t activeInput = getActiveInput();
765    if (activeInput != 0) {
766        setInputDevice(activeInput, getNewInputDevice(activeInput));
767    }
768
769}
770
771audio_policy_forced_cfg_t AudioPolicyManager::getForceUse(audio_policy_force_use_t usage)
772{
773    return mForceUse[usage];
774}
775
776void AudioPolicyManager::setSystemProperty(const char* property, const char* value)
777{
778    ALOGV("setSystemProperty() property %s, value %s", property, value);
779}
780
781// Find a direct output profile compatible with the parameters passed, even if the input flags do
782// not explicitly request a direct output
783sp<AudioPolicyManager::IOProfile> AudioPolicyManager::getProfileForDirectOutput(
784                                                               audio_devices_t device,
785                                                               uint32_t samplingRate,
786                                                               audio_format_t format,
787                                                               audio_channel_mask_t channelMask,
788                                                               audio_output_flags_t flags)
789{
790    for (size_t i = 0; i < mHwModules.size(); i++) {
791        if (mHwModules[i]->mHandle == 0) {
792            continue;
793        }
794        for (size_t j = 0; j < mHwModules[i]->mOutputProfiles.size(); j++) {
795            sp<IOProfile> profile = mHwModules[i]->mOutputProfiles[j];
796            bool found = profile->isCompatibleProfile(device, samplingRate,
797                    NULL /*updatedSamplingRate*/, format, channelMask,
798                    flags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD ?
799                        AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD : AUDIO_OUTPUT_FLAG_DIRECT);
800            if (found && (mAvailableOutputDevices.types() & profile->mSupportedDevices.types())) {
801                return profile;
802            }
803        }
804    }
805    return 0;
806}
807
808audio_io_handle_t AudioPolicyManager::getOutput(audio_stream_type_t stream,
809                                    uint32_t samplingRate,
810                                    audio_format_t format,
811                                    audio_channel_mask_t channelMask,
812                                    audio_output_flags_t flags,
813                                    const audio_offload_info_t *offloadInfo)
814{
815
816    routing_strategy strategy = getStrategy(stream);
817    audio_devices_t device = getDeviceForStrategy(strategy, false /*fromCache*/);
818    ALOGV("getOutput() device %d, stream %d, samplingRate %d, format %x, channelMask %x, flags %x",
819          device, stream, samplingRate, format, channelMask, flags);
820
821    return getOutputForDevice(device, stream, samplingRate,format, channelMask, flags,
822            offloadInfo);
823}
824
825audio_io_handle_t AudioPolicyManager::getOutputForAttr(const audio_attributes_t *attr,
826                                    uint32_t samplingRate,
827                                    audio_format_t format,
828                                    audio_channel_mask_t channelMask,
829                                    audio_output_flags_t flags,
830                                    const audio_offload_info_t *offloadInfo)
831{
832    if (attr == NULL) {
833        ALOGE("getOutputForAttr() called with NULL audio attributes");
834        return 0;
835    }
836    ALOGV("getOutputForAttr() usage=%d, content=%d, tag=%s flags=%08x",
837            attr->usage, attr->content_type, attr->tags, attr->flags);
838
839    // TODO this is where filtering for custom policies (rerouting, dynamic sources) will go
840    routing_strategy strategy = (routing_strategy) getStrategyForAttr(attr);
841    audio_devices_t device = getDeviceForStrategy(strategy, false /*fromCache*/);
842
843    if ((attr->flags & AUDIO_FLAG_HW_AV_SYNC) != 0) {
844        flags = (audio_output_flags_t)(flags | AUDIO_OUTPUT_FLAG_HW_AV_SYNC);
845    }
846
847    ALOGV("getOutputForAttr() device %d, samplingRate %d, format %x, channelMask %x, flags %x",
848          device, samplingRate, format, channelMask, flags);
849
850    audio_stream_type_t stream = streamTypefromAttributesInt(attr);
851    return getOutputForDevice(device, stream, samplingRate, format, channelMask, flags,
852                offloadInfo);
853}
854
855audio_io_handle_t AudioPolicyManager::getOutputForDevice(
856        audio_devices_t device,
857        audio_stream_type_t stream,
858        uint32_t samplingRate,
859        audio_format_t format,
860        audio_channel_mask_t channelMask,
861        audio_output_flags_t flags,
862        const audio_offload_info_t *offloadInfo)
863{
864    audio_io_handle_t output = AUDIO_IO_HANDLE_NONE;
865    uint32_t latency = 0;
866    status_t status;
867
868#ifdef AUDIO_POLICY_TEST
869    if (mCurOutput != 0) {
870        ALOGV("getOutput() test output mCurOutput %d, samplingRate %d, format %d, channelMask %x, mDirectOutput %d",
871                mCurOutput, mTestSamplingRate, mTestFormat, mTestChannels, mDirectOutput);
872
873        if (mTestOutputs[mCurOutput] == 0) {
874            ALOGV("getOutput() opening test output");
875            sp<AudioOutputDescriptor> outputDesc = new AudioOutputDescriptor(NULL);
876            outputDesc->mDevice = mTestDevice;
877            outputDesc->mLatency = mTestLatencyMs;
878            outputDesc->mFlags =
879                    (audio_output_flags_t)(mDirectOutput ? AUDIO_OUTPUT_FLAG_DIRECT : 0);
880            outputDesc->mRefCount[stream] = 0;
881            audio_config_t config = AUDIO_CONFIG_INITIALIZER;
882            config.sample_rate = mTestSamplingRate;
883            config.channel_mask = mTestChannels;
884            config.format = mTestFormat;
885            if (offloadInfo != NULL) {
886                config.offload_info = *offloadInfo;
887            }
888            status = mpClientInterface->openOutput(0,
889                                                  &mTestOutputs[mCurOutput],
890                                                  &config,
891                                                  &outputDesc->mDevice,
892                                                  String8(""),
893                                                  &outputDesc->mLatency,
894                                                  outputDesc->mFlags);
895            if (status == NO_ERROR) {
896                outputDesc->mSamplingRate = config.sample_rate;
897                outputDesc->mFormat = config.format;
898                outputDesc->mChannelMask = config.channel_mask;
899                AudioParameter outputCmd = AudioParameter();
900                outputCmd.addInt(String8("set_id"),mCurOutput);
901                mpClientInterface->setParameters(mTestOutputs[mCurOutput],outputCmd.toString());
902                addOutput(mTestOutputs[mCurOutput], outputDesc);
903            }
904        }
905        return mTestOutputs[mCurOutput];
906    }
907#endif //AUDIO_POLICY_TEST
908
909    // open a direct output if required by specified parameters
910    //force direct flag if offload flag is set: offloading implies a direct output stream
911    // and all common behaviors are driven by checking only the direct flag
912    // this should normally be set appropriately in the policy configuration file
913    if ((flags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD) != 0) {
914        flags = (audio_output_flags_t)(flags | AUDIO_OUTPUT_FLAG_DIRECT);
915    }
916    if ((flags & AUDIO_OUTPUT_FLAG_HW_AV_SYNC) != 0) {
917        flags = (audio_output_flags_t)(flags | AUDIO_OUTPUT_FLAG_DIRECT);
918    }
919
920    // Do not allow offloading if one non offloadable effect is enabled. This prevents from
921    // creating an offloaded track and tearing it down immediately after start when audioflinger
922    // detects there is an active non offloadable effect.
923    // FIXME: We should check the audio session here but we do not have it in this context.
924    // This may prevent offloading in rare situations where effects are left active by apps
925    // in the background.
926    sp<IOProfile> profile;
927    if (((flags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD) == 0) ||
928            !isNonOffloadableEffectEnabled()) {
929        profile = getProfileForDirectOutput(device,
930                                           samplingRate,
931                                           format,
932                                           channelMask,
933                                           (audio_output_flags_t)flags);
934    }
935
936    if (profile != 0) {
937        sp<AudioOutputDescriptor> outputDesc = NULL;
938
939        for (size_t i = 0; i < mOutputs.size(); i++) {
940            sp<AudioOutputDescriptor> desc = mOutputs.valueAt(i);
941            if (!desc->isDuplicated() && (profile == desc->mProfile)) {
942                outputDesc = desc;
943                // reuse direct output if currently open and configured with same parameters
944                if ((samplingRate == outputDesc->mSamplingRate) &&
945                        (format == outputDesc->mFormat) &&
946                        (channelMask == outputDesc->mChannelMask)) {
947                    outputDesc->mDirectOpenCount++;
948                    ALOGV("getOutput() reusing direct output %d", mOutputs.keyAt(i));
949                    return mOutputs.keyAt(i);
950                }
951            }
952        }
953        // close direct output if currently open and configured with different parameters
954        if (outputDesc != NULL) {
955            closeOutput(outputDesc->mIoHandle);
956        }
957        outputDesc = new AudioOutputDescriptor(profile);
958        outputDesc->mDevice = device;
959        outputDesc->mLatency = 0;
960        outputDesc->mFlags =(audio_output_flags_t) (outputDesc->mFlags | flags);
961        audio_config_t config = AUDIO_CONFIG_INITIALIZER;
962        config.sample_rate = samplingRate;
963        config.channel_mask = channelMask;
964        config.format = format;
965        if (offloadInfo != NULL) {
966            config.offload_info = *offloadInfo;
967        }
968        status = mpClientInterface->openOutput(profile->mModule->mHandle,
969                                               &output,
970                                               &config,
971                                               &outputDesc->mDevice,
972                                               String8(""),
973                                               &outputDesc->mLatency,
974                                               outputDesc->mFlags);
975
976        // only accept an output with the requested parameters
977        if (status != NO_ERROR ||
978            (samplingRate != 0 && samplingRate != config.sample_rate) ||
979            (format != AUDIO_FORMAT_DEFAULT && format != config.format) ||
980            (channelMask != 0 && channelMask != config.channel_mask)) {
981            ALOGV("getOutput() failed opening direct output: output %d samplingRate %d %d,"
982                    "format %d %d, channelMask %04x %04x", output, samplingRate,
983                    outputDesc->mSamplingRate, format, outputDesc->mFormat, channelMask,
984                    outputDesc->mChannelMask);
985            if (output != AUDIO_IO_HANDLE_NONE) {
986                mpClientInterface->closeOutput(output);
987            }
988            return AUDIO_IO_HANDLE_NONE;
989        }
990        outputDesc->mSamplingRate = config.sample_rate;
991        outputDesc->mChannelMask = config.channel_mask;
992        outputDesc->mFormat = config.format;
993        outputDesc->mRefCount[stream] = 0;
994        outputDesc->mStopTime[stream] = 0;
995        outputDesc->mDirectOpenCount = 1;
996
997        audio_io_handle_t srcOutput = getOutputForEffect();
998        addOutput(output, outputDesc);
999        audio_io_handle_t dstOutput = getOutputForEffect();
1000        if (dstOutput == output) {
1001            mpClientInterface->moveEffects(AUDIO_SESSION_OUTPUT_MIX, srcOutput, dstOutput);
1002        }
1003        mPreviousOutputs = mOutputs;
1004        ALOGV("getOutput() returns new direct output %d", output);
1005        mpClientInterface->onAudioPortListUpdate();
1006        return output;
1007    }
1008
1009    // ignoring channel mask due to downmix capability in mixer
1010
1011    // open a non direct output
1012
1013    // for non direct outputs, only PCM is supported
1014    if (audio_is_linear_pcm(format)) {
1015        // get which output is suitable for the specified stream. The actual
1016        // routing change will happen when startOutput() will be called
1017        SortedVector<audio_io_handle_t> outputs = getOutputsForDevice(device, mOutputs);
1018
1019        output = selectOutput(outputs, flags);
1020    }
1021    ALOGW_IF((output == 0), "getOutput() could not find output for stream %d, samplingRate %d,"
1022            "format %d, channels %x, flags %x", stream, samplingRate, format, channelMask, flags);
1023
1024    ALOGV("getOutput() returns output %d", output);
1025
1026    return output;
1027}
1028
1029audio_io_handle_t AudioPolicyManager::selectOutput(const SortedVector<audio_io_handle_t>& outputs,
1030                                                       audio_output_flags_t flags)
1031{
1032    // select one output among several that provide a path to a particular device or set of
1033    // devices (the list was previously build by getOutputsForDevice()).
1034    // The priority is as follows:
1035    // 1: the output with the highest number of requested policy flags
1036    // 2: the primary output
1037    // 3: the first output in the list
1038
1039    if (outputs.size() == 0) {
1040        return 0;
1041    }
1042    if (outputs.size() == 1) {
1043        return outputs[0];
1044    }
1045
1046    int maxCommonFlags = 0;
1047    audio_io_handle_t outputFlags = 0;
1048    audio_io_handle_t outputPrimary = 0;
1049
1050    for (size_t i = 0; i < outputs.size(); i++) {
1051        sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(outputs[i]);
1052        if (!outputDesc->isDuplicated()) {
1053            int commonFlags = popcount(outputDesc->mProfile->mFlags & flags);
1054            if (commonFlags > maxCommonFlags) {
1055                outputFlags = outputs[i];
1056                maxCommonFlags = commonFlags;
1057                ALOGV("selectOutput() commonFlags for output %d, %04x", outputs[i], commonFlags);
1058            }
1059            if (outputDesc->mProfile->mFlags & AUDIO_OUTPUT_FLAG_PRIMARY) {
1060                outputPrimary = outputs[i];
1061            }
1062        }
1063    }
1064
1065    if (outputFlags != 0) {
1066        return outputFlags;
1067    }
1068    if (outputPrimary != 0) {
1069        return outputPrimary;
1070    }
1071
1072    return outputs[0];
1073}
1074
1075status_t AudioPolicyManager::startOutput(audio_io_handle_t output,
1076                                             audio_stream_type_t stream,
1077                                             int session)
1078{
1079    ALOGV("startOutput() output %d, stream %d, session %d", output, stream, session);
1080    ssize_t index = mOutputs.indexOfKey(output);
1081    if (index < 0) {
1082        ALOGW("startOutput() unknown output %d", output);
1083        return BAD_VALUE;
1084    }
1085
1086    sp<AudioOutputDescriptor> outputDesc = mOutputs.valueAt(index);
1087
1088    // increment usage count for this stream on the requested output:
1089    // NOTE that the usage count is the same for duplicated output and hardware output which is
1090    // necessary for a correct control of hardware output routing by startOutput() and stopOutput()
1091    outputDesc->changeRefCount(stream, 1);
1092
1093    if (outputDesc->mRefCount[stream] == 1) {
1094        audio_devices_t newDevice = getNewOutputDevice(output, false /*fromCache*/);
1095        routing_strategy strategy = getStrategy(stream);
1096        bool shouldWait = (strategy == STRATEGY_SONIFICATION) ||
1097                            (strategy == STRATEGY_SONIFICATION_RESPECTFUL);
1098        uint32_t waitMs = 0;
1099        bool force = false;
1100        for (size_t i = 0; i < mOutputs.size(); i++) {
1101            sp<AudioOutputDescriptor> desc = mOutputs.valueAt(i);
1102            if (desc != outputDesc) {
1103                // force a device change if any other output is managed by the same hw
1104                // module and has a current device selection that differs from selected device.
1105                // In this case, the audio HAL must receive the new device selection so that it can
1106                // change the device currently selected by the other active output.
1107                if (outputDesc->sharesHwModuleWith(desc) &&
1108                    desc->device() != newDevice) {
1109                    force = true;
1110                }
1111                // wait for audio on other active outputs to be presented when starting
1112                // a notification so that audio focus effect can propagate.
1113                uint32_t latency = desc->latency();
1114                if (shouldWait && desc->isActive(latency * 2) && (waitMs < latency)) {
1115                    waitMs = latency;
1116                }
1117            }
1118        }
1119        uint32_t muteWaitMs = setOutputDevice(output, newDevice, force);
1120
1121        // handle special case for sonification while in call
1122        if (isInCall()) {
1123            handleIncallSonification(stream, true, false);
1124        }
1125
1126        // apply volume rules for current stream and device if necessary
1127        checkAndSetVolume(stream,
1128                          mStreams[stream].getVolumeIndex(newDevice),
1129                          output,
1130                          newDevice);
1131
1132        // update the outputs if starting an output with a stream that can affect notification
1133        // routing
1134        handleNotificationRoutingForStream(stream);
1135        if (waitMs > muteWaitMs) {
1136            usleep((waitMs - muteWaitMs) * 2 * 1000);
1137        }
1138    }
1139    return NO_ERROR;
1140}
1141
1142
1143status_t AudioPolicyManager::stopOutput(audio_io_handle_t output,
1144                                            audio_stream_type_t stream,
1145                                            int session)
1146{
1147    ALOGV("stopOutput() output %d, stream %d, session %d", output, stream, session);
1148    ssize_t index = mOutputs.indexOfKey(output);
1149    if (index < 0) {
1150        ALOGW("stopOutput() unknown output %d", output);
1151        return BAD_VALUE;
1152    }
1153
1154    sp<AudioOutputDescriptor> outputDesc = mOutputs.valueAt(index);
1155
1156    // handle special case for sonification while in call
1157    if (isInCall()) {
1158        handleIncallSonification(stream, false, false);
1159    }
1160
1161    if (outputDesc->mRefCount[stream] > 0) {
1162        // decrement usage count of this stream on the output
1163        outputDesc->changeRefCount(stream, -1);
1164        // store time at which the stream was stopped - see isStreamActive()
1165        if (outputDesc->mRefCount[stream] == 0) {
1166            outputDesc->mStopTime[stream] = systemTime();
1167            audio_devices_t newDevice = getNewOutputDevice(output, false /*fromCache*/);
1168            // delay the device switch by twice the latency because stopOutput() is executed when
1169            // the track stop() command is received and at that time the audio track buffer can
1170            // still contain data that needs to be drained. The latency only covers the audio HAL
1171            // and kernel buffers. Also the latency does not always include additional delay in the
1172            // audio path (audio DSP, CODEC ...)
1173            setOutputDevice(output, newDevice, false, outputDesc->mLatency*2);
1174
1175            // force restoring the device selection on other active outputs if it differs from the
1176            // one being selected for this output
1177            for (size_t i = 0; i < mOutputs.size(); i++) {
1178                audio_io_handle_t curOutput = mOutputs.keyAt(i);
1179                sp<AudioOutputDescriptor> desc = mOutputs.valueAt(i);
1180                if (curOutput != output &&
1181                        desc->isActive() &&
1182                        outputDesc->sharesHwModuleWith(desc) &&
1183                        (newDevice != desc->device())) {
1184                    setOutputDevice(curOutput,
1185                                    getNewOutputDevice(curOutput, false /*fromCache*/),
1186                                    true,
1187                                    outputDesc->mLatency*2);
1188                }
1189            }
1190            // update the outputs if stopping one with a stream that can affect notification routing
1191            handleNotificationRoutingForStream(stream);
1192        }
1193        return NO_ERROR;
1194    } else {
1195        ALOGW("stopOutput() refcount is already 0 for output %d", output);
1196        return INVALID_OPERATION;
1197    }
1198}
1199
1200void AudioPolicyManager::releaseOutput(audio_io_handle_t output)
1201{
1202    ALOGV("releaseOutput() %d", output);
1203    ssize_t index = mOutputs.indexOfKey(output);
1204    if (index < 0) {
1205        ALOGW("releaseOutput() releasing unknown output %d", output);
1206        return;
1207    }
1208
1209#ifdef AUDIO_POLICY_TEST
1210    int testIndex = testOutputIndex(output);
1211    if (testIndex != 0) {
1212        sp<AudioOutputDescriptor> outputDesc = mOutputs.valueAt(index);
1213        if (outputDesc->isActive()) {
1214            mpClientInterface->closeOutput(output);
1215            mOutputs.removeItem(output);
1216            mTestOutputs[testIndex] = 0;
1217        }
1218        return;
1219    }
1220#endif //AUDIO_POLICY_TEST
1221
1222    sp<AudioOutputDescriptor> desc = mOutputs.valueAt(index);
1223    if (desc->mFlags & AUDIO_OUTPUT_FLAG_DIRECT) {
1224        if (desc->mDirectOpenCount <= 0) {
1225            ALOGW("releaseOutput() invalid open count %d for output %d",
1226                                                              desc->mDirectOpenCount, output);
1227            return;
1228        }
1229        if (--desc->mDirectOpenCount == 0) {
1230            closeOutput(output);
1231            // If effects where present on the output, audioflinger moved them to the primary
1232            // output by default: move them back to the appropriate output.
1233            audio_io_handle_t dstOutput = getOutputForEffect();
1234            if (dstOutput != mPrimaryOutput) {
1235                mpClientInterface->moveEffects(AUDIO_SESSION_OUTPUT_MIX, mPrimaryOutput, dstOutput);
1236            }
1237            mpClientInterface->onAudioPortListUpdate();
1238        }
1239    }
1240}
1241
1242
1243audio_io_handle_t AudioPolicyManager::getInput(audio_source_t inputSource,
1244                                    uint32_t samplingRate,
1245                                    audio_format_t format,
1246                                    audio_channel_mask_t channelMask,
1247                                    audio_session_t session,
1248                                    audio_input_flags_t flags)
1249{
1250    ALOGV("getInput() inputSource %d, samplingRate %d, format %d, channelMask %x, session %d, "
1251          "flags %#x",
1252          inputSource, samplingRate, format, channelMask, session, flags);
1253
1254    audio_devices_t device = getDeviceForInputSource(inputSource);
1255
1256    if (device == AUDIO_DEVICE_NONE) {
1257        ALOGW("getInput() could not find device for inputSource %d", inputSource);
1258        return AUDIO_IO_HANDLE_NONE;
1259    }
1260
1261    // adapt channel selection to input source
1262    switch (inputSource) {
1263    case AUDIO_SOURCE_VOICE_UPLINK:
1264        channelMask = AUDIO_CHANNEL_IN_VOICE_UPLINK;
1265        break;
1266    case AUDIO_SOURCE_VOICE_DOWNLINK:
1267        channelMask = AUDIO_CHANNEL_IN_VOICE_DNLINK;
1268        break;
1269    case AUDIO_SOURCE_VOICE_CALL:
1270        channelMask = AUDIO_CHANNEL_IN_VOICE_UPLINK | AUDIO_CHANNEL_IN_VOICE_DNLINK;
1271        break;
1272    default:
1273        break;
1274    }
1275
1276    sp<IOProfile> profile = getInputProfile(device,
1277                                         samplingRate,
1278                                         format,
1279                                         channelMask,
1280                                         flags);
1281    if (profile == 0) {
1282        ALOGW("getInput() could not find profile for device 0x%X, samplingRate %u, format %#x, "
1283                "channelMask 0x%X, flags %#x",
1284                device, samplingRate, format, channelMask, flags);
1285        return AUDIO_IO_HANDLE_NONE;
1286    }
1287
1288    if (profile->mModule->mHandle == 0) {
1289        ALOGE("getInput(): HW module %s not opened", profile->mModule->mName);
1290        return AUDIO_IO_HANDLE_NONE;
1291    }
1292
1293    audio_config_t config = AUDIO_CONFIG_INITIALIZER;
1294    config.sample_rate = samplingRate;
1295    config.channel_mask = channelMask;
1296    config.format = format;
1297    audio_io_handle_t input = AUDIO_IO_HANDLE_NONE;
1298
1299    bool isSoundTrigger = false;
1300    audio_source_t halInputSource = inputSource;
1301    if (inputSource == AUDIO_SOURCE_HOTWORD) {
1302        ssize_t index = mSoundTriggerSessions.indexOfKey(session);
1303        if (index >= 0) {
1304            input = mSoundTriggerSessions.valueFor(session);
1305            isSoundTrigger = true;
1306            ALOGV("SoundTrigger capture on session %d input %d", session, input);
1307        } else {
1308            halInputSource = AUDIO_SOURCE_VOICE_RECOGNITION;
1309        }
1310    }
1311    status_t status = mpClientInterface->openInput(profile->mModule->mHandle,
1312                                                   &input,
1313                                                   &config,
1314                                                   &device,
1315                                                   String8(""),
1316                                                   halInputSource,
1317                                                   flags);
1318
1319    // only accept input with the exact requested set of parameters
1320    if (status != NO_ERROR ||
1321        (samplingRate != config.sample_rate) ||
1322        (format != config.format) ||
1323        (channelMask != config.channel_mask)) {
1324        ALOGW("getInput() failed opening input: samplingRate %d, format %d, channelMask %x",
1325                samplingRate, format, channelMask);
1326        if (input != AUDIO_IO_HANDLE_NONE) {
1327            mpClientInterface->closeInput(input);
1328        }
1329        return AUDIO_IO_HANDLE_NONE;
1330    }
1331
1332    sp<AudioInputDescriptor> inputDesc = new AudioInputDescriptor(profile);
1333    inputDesc->mInputSource = inputSource;
1334    inputDesc->mRefCount = 0;
1335    inputDesc->mOpenRefCount = 1;
1336    inputDesc->mSamplingRate = samplingRate;
1337    inputDesc->mFormat = format;
1338    inputDesc->mChannelMask = channelMask;
1339    inputDesc->mDevice = device;
1340    inputDesc->mSessions.add(session);
1341    inputDesc->mIsSoundTrigger = isSoundTrigger;
1342
1343    addInput(input, inputDesc);
1344    mpClientInterface->onAudioPortListUpdate();
1345    return input;
1346}
1347
1348status_t AudioPolicyManager::startInput(audio_io_handle_t input,
1349                                        audio_session_t session)
1350{
1351    ALOGV("startInput() input %d", input);
1352    ssize_t index = mInputs.indexOfKey(input);
1353    if (index < 0) {
1354        ALOGW("startInput() unknown input %d", input);
1355        return BAD_VALUE;
1356    }
1357    sp<AudioInputDescriptor> inputDesc = mInputs.valueAt(index);
1358
1359    index = inputDesc->mSessions.indexOf(session);
1360    if (index < 0) {
1361        ALOGW("startInput() unknown session %d on input %d", session, input);
1362        return BAD_VALUE;
1363    }
1364
1365    // virtual input devices are compatible with other input devices
1366    if (!isVirtualInputDevice(inputDesc->mDevice)) {
1367
1368        // for a non-virtual input device, check if there is another (non-virtual) active input
1369        audio_io_handle_t activeInput = getActiveInput();
1370        if (activeInput != 0 && activeInput != input) {
1371
1372            // If the already active input uses AUDIO_SOURCE_HOTWORD then it is closed,
1373            // otherwise the active input continues and the new input cannot be started.
1374            sp<AudioInputDescriptor> activeDesc = mInputs.valueFor(activeInput);
1375            if (activeDesc->mInputSource == AUDIO_SOURCE_HOTWORD) {
1376                ALOGW("startInput(%d) preempting low-priority input %d", input, activeInput);
1377                stopInput(activeInput, activeDesc->mSessions.itemAt(0));
1378                releaseInput(activeInput, activeDesc->mSessions.itemAt(0));
1379            } else {
1380                ALOGE("startInput(%d) failed: other input %d already started", input, activeInput);
1381                return INVALID_OPERATION;
1382            }
1383        }
1384    }
1385
1386    if (inputDesc->mRefCount == 0) {
1387        if (activeInputsCount() == 0) {
1388            SoundTrigger::setCaptureState(true);
1389        }
1390        setInputDevice(input, getNewInputDevice(input), true /* force */);
1391
1392        // Automatically enable the remote submix output when input is started.
1393        // For remote submix (a virtual device), we open only one input per capture request.
1394        if (audio_is_remote_submix_device(inputDesc->mDevice)) {
1395            setDeviceConnectionState(AUDIO_DEVICE_OUT_REMOTE_SUBMIX,
1396                    AUDIO_POLICY_DEVICE_STATE_AVAILABLE, AUDIO_REMOTE_SUBMIX_DEVICE_ADDRESS);
1397        }
1398    }
1399
1400    ALOGV("AudioPolicyManager::startInput() input source = %d", inputDesc->mInputSource);
1401
1402    inputDesc->mRefCount++;
1403    return NO_ERROR;
1404}
1405
1406status_t AudioPolicyManager::stopInput(audio_io_handle_t input,
1407                                       audio_session_t session)
1408{
1409    ALOGV("stopInput() input %d", input);
1410    ssize_t index = mInputs.indexOfKey(input);
1411    if (index < 0) {
1412        ALOGW("stopInput() unknown input %d", input);
1413        return BAD_VALUE;
1414    }
1415    sp<AudioInputDescriptor> inputDesc = mInputs.valueAt(index);
1416
1417    index = inputDesc->mSessions.indexOf(session);
1418    if (index < 0) {
1419        ALOGW("stopInput() unknown session %d on input %d", session, input);
1420        return BAD_VALUE;
1421    }
1422
1423    if (inputDesc->mRefCount == 0) {
1424        ALOGW("stopInput() input %d already stopped", input);
1425        return INVALID_OPERATION;
1426    }
1427
1428    inputDesc->mRefCount--;
1429    if (inputDesc->mRefCount == 0) {
1430
1431        // automatically disable the remote submix output when input is stopped
1432        if (audio_is_remote_submix_device(inputDesc->mDevice)) {
1433            setDeviceConnectionState(AUDIO_DEVICE_OUT_REMOTE_SUBMIX,
1434                    AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE, AUDIO_REMOTE_SUBMIX_DEVICE_ADDRESS);
1435        }
1436
1437        resetInputDevice(input);
1438
1439        if (activeInputsCount() == 0) {
1440            SoundTrigger::setCaptureState(false);
1441        }
1442    }
1443    return NO_ERROR;
1444}
1445
1446void AudioPolicyManager::releaseInput(audio_io_handle_t input,
1447                                      audio_session_t session)
1448{
1449    ALOGV("releaseInput() %d", input);
1450    ssize_t index = mInputs.indexOfKey(input);
1451    if (index < 0) {
1452        ALOGW("releaseInput() releasing unknown input %d", input);
1453        return;
1454    }
1455    sp<AudioInputDescriptor> inputDesc = mInputs.valueAt(index);
1456    ALOG_ASSERT(inputDesc != 0);
1457
1458    index = inputDesc->mSessions.indexOf(session);
1459    if (index < 0) {
1460        ALOGW("releaseInput() unknown session %d on input %d", session, input);
1461        return;
1462    }
1463    inputDesc->mSessions.remove(session);
1464    if (inputDesc->mOpenRefCount == 0) {
1465        ALOGW("releaseInput() invalid open ref count %d", inputDesc->mOpenRefCount);
1466        return;
1467    }
1468    inputDesc->mOpenRefCount--;
1469    if (inputDesc->mOpenRefCount > 0) {
1470        ALOGV("releaseInput() exit > 0");
1471        return;
1472    }
1473
1474    closeInput(input);
1475    mpClientInterface->onAudioPortListUpdate();
1476    ALOGV("releaseInput() exit");
1477}
1478
1479void AudioPolicyManager::closeAllInputs() {
1480    bool patchRemoved = false;
1481
1482    for(size_t input_index = 0; input_index < mInputs.size(); input_index++) {
1483        sp<AudioInputDescriptor> inputDesc = mInputs.valueAt(input_index);
1484        ssize_t patch_index = mAudioPatches.indexOfKey(inputDesc->mPatchHandle);
1485        if (patch_index >= 0) {
1486            sp<AudioPatch> patchDesc = mAudioPatches.valueAt(patch_index);
1487            status_t status = mpClientInterface->releaseAudioPatch(patchDesc->mAfPatchHandle, 0);
1488            mAudioPatches.removeItemsAt(patch_index);
1489            patchRemoved = true;
1490        }
1491        mpClientInterface->closeInput(mInputs.keyAt(input_index));
1492    }
1493    mInputs.clear();
1494    nextAudioPortGeneration();
1495
1496    if (patchRemoved) {
1497        mpClientInterface->onAudioPatchListUpdate();
1498    }
1499}
1500
1501void AudioPolicyManager::initStreamVolume(audio_stream_type_t stream,
1502                                            int indexMin,
1503                                            int indexMax)
1504{
1505    ALOGV("initStreamVolume() stream %d, min %d, max %d", stream , indexMin, indexMax);
1506    if (indexMin < 0 || indexMin >= indexMax) {
1507        ALOGW("initStreamVolume() invalid index limits for stream %d, min %d, max %d", stream , indexMin, indexMax);
1508        return;
1509    }
1510    mStreams[stream].mIndexMin = indexMin;
1511    mStreams[stream].mIndexMax = indexMax;
1512}
1513
1514status_t AudioPolicyManager::setStreamVolumeIndex(audio_stream_type_t stream,
1515                                                      int index,
1516                                                      audio_devices_t device)
1517{
1518
1519    if ((index < mStreams[stream].mIndexMin) || (index > mStreams[stream].mIndexMax)) {
1520        return BAD_VALUE;
1521    }
1522    if (!audio_is_output_device(device)) {
1523        return BAD_VALUE;
1524    }
1525
1526    // Force max volume if stream cannot be muted
1527    if (!mStreams[stream].mCanBeMuted) index = mStreams[stream].mIndexMax;
1528
1529    ALOGV("setStreamVolumeIndex() stream %d, device %04x, index %d",
1530          stream, device, index);
1531
1532    // if device is AUDIO_DEVICE_OUT_DEFAULT set default value and
1533    // clear all device specific values
1534    if (device == AUDIO_DEVICE_OUT_DEFAULT) {
1535        mStreams[stream].mIndexCur.clear();
1536    }
1537    mStreams[stream].mIndexCur.add(device, index);
1538
1539    // compute and apply stream volume on all outputs according to connected device
1540    status_t status = NO_ERROR;
1541    for (size_t i = 0; i < mOutputs.size(); i++) {
1542        audio_devices_t curDevice =
1543                getDeviceForVolume(mOutputs.valueAt(i)->device());
1544        if ((device == AUDIO_DEVICE_OUT_DEFAULT) || (device == curDevice)) {
1545            status_t volStatus = checkAndSetVolume(stream, index, mOutputs.keyAt(i), curDevice);
1546            if (volStatus != NO_ERROR) {
1547                status = volStatus;
1548            }
1549        }
1550    }
1551    return status;
1552}
1553
1554status_t AudioPolicyManager::getStreamVolumeIndex(audio_stream_type_t stream,
1555                                                      int *index,
1556                                                      audio_devices_t device)
1557{
1558    if (index == NULL) {
1559        return BAD_VALUE;
1560    }
1561    if (!audio_is_output_device(device)) {
1562        return BAD_VALUE;
1563    }
1564    // if device is AUDIO_DEVICE_OUT_DEFAULT, return volume for device corresponding to
1565    // the strategy the stream belongs to.
1566    if (device == AUDIO_DEVICE_OUT_DEFAULT) {
1567        device = getDeviceForStrategy(getStrategy(stream), true /*fromCache*/);
1568    }
1569    device = getDeviceForVolume(device);
1570
1571    *index =  mStreams[stream].getVolumeIndex(device);
1572    ALOGV("getStreamVolumeIndex() stream %d device %08x index %d", stream, device, *index);
1573    return NO_ERROR;
1574}
1575
1576audio_io_handle_t AudioPolicyManager::selectOutputForEffects(
1577                                            const SortedVector<audio_io_handle_t>& outputs)
1578{
1579    // select one output among several suitable for global effects.
1580    // The priority is as follows:
1581    // 1: An offloaded output. If the effect ends up not being offloadable,
1582    //    AudioFlinger will invalidate the track and the offloaded output
1583    //    will be closed causing the effect to be moved to a PCM output.
1584    // 2: A deep buffer output
1585    // 3: the first output in the list
1586
1587    if (outputs.size() == 0) {
1588        return 0;
1589    }
1590
1591    audio_io_handle_t outputOffloaded = 0;
1592    audio_io_handle_t outputDeepBuffer = 0;
1593
1594    for (size_t i = 0; i < outputs.size(); i++) {
1595        sp<AudioOutputDescriptor> desc = mOutputs.valueFor(outputs[i]);
1596        ALOGV("selectOutputForEffects outputs[%zu] flags %x", i, desc->mFlags);
1597        if ((desc->mFlags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD) != 0) {
1598            outputOffloaded = outputs[i];
1599        }
1600        if ((desc->mFlags & AUDIO_OUTPUT_FLAG_DEEP_BUFFER) != 0) {
1601            outputDeepBuffer = outputs[i];
1602        }
1603    }
1604
1605    ALOGV("selectOutputForEffects outputOffloaded %d outputDeepBuffer %d",
1606          outputOffloaded, outputDeepBuffer);
1607    if (outputOffloaded != 0) {
1608        return outputOffloaded;
1609    }
1610    if (outputDeepBuffer != 0) {
1611        return outputDeepBuffer;
1612    }
1613
1614    return outputs[0];
1615}
1616
1617audio_io_handle_t AudioPolicyManager::getOutputForEffect(const effect_descriptor_t *desc)
1618{
1619    // apply simple rule where global effects are attached to the same output as MUSIC streams
1620
1621    routing_strategy strategy = getStrategy(AUDIO_STREAM_MUSIC);
1622    audio_devices_t device = getDeviceForStrategy(strategy, false /*fromCache*/);
1623    SortedVector<audio_io_handle_t> dstOutputs = getOutputsForDevice(device, mOutputs);
1624
1625    audio_io_handle_t output = selectOutputForEffects(dstOutputs);
1626    ALOGV("getOutputForEffect() got output %d for fx %s flags %x",
1627          output, (desc == NULL) ? "unspecified" : desc->name,  (desc == NULL) ? 0 : desc->flags);
1628
1629    return output;
1630}
1631
1632status_t AudioPolicyManager::registerEffect(const effect_descriptor_t *desc,
1633                                audio_io_handle_t io,
1634                                uint32_t strategy,
1635                                int session,
1636                                int id)
1637{
1638    ssize_t index = mOutputs.indexOfKey(io);
1639    if (index < 0) {
1640        index = mInputs.indexOfKey(io);
1641        if (index < 0) {
1642            ALOGW("registerEffect() unknown io %d", io);
1643            return INVALID_OPERATION;
1644        }
1645    }
1646
1647    if (mTotalEffectsMemory + desc->memoryUsage > getMaxEffectsMemory()) {
1648        ALOGW("registerEffect() memory limit exceeded for Fx %s, Memory %d KB",
1649                desc->name, desc->memoryUsage);
1650        return INVALID_OPERATION;
1651    }
1652    mTotalEffectsMemory += desc->memoryUsage;
1653    ALOGV("registerEffect() effect %s, io %d, strategy %d session %d id %d",
1654            desc->name, io, strategy, session, id);
1655    ALOGV("registerEffect() memory %d, total memory %d", desc->memoryUsage, mTotalEffectsMemory);
1656
1657    sp<EffectDescriptor> effectDesc = new EffectDescriptor();
1658    memcpy (&effectDesc->mDesc, desc, sizeof(effect_descriptor_t));
1659    effectDesc->mIo = io;
1660    effectDesc->mStrategy = (routing_strategy)strategy;
1661    effectDesc->mSession = session;
1662    effectDesc->mEnabled = false;
1663
1664    mEffects.add(id, effectDesc);
1665
1666    return NO_ERROR;
1667}
1668
1669status_t AudioPolicyManager::unregisterEffect(int id)
1670{
1671    ssize_t index = mEffects.indexOfKey(id);
1672    if (index < 0) {
1673        ALOGW("unregisterEffect() unknown effect ID %d", id);
1674        return INVALID_OPERATION;
1675    }
1676
1677    sp<EffectDescriptor> effectDesc = mEffects.valueAt(index);
1678
1679    setEffectEnabled(effectDesc, false);
1680
1681    if (mTotalEffectsMemory < effectDesc->mDesc.memoryUsage) {
1682        ALOGW("unregisterEffect() memory %d too big for total %d",
1683                effectDesc->mDesc.memoryUsage, mTotalEffectsMemory);
1684        effectDesc->mDesc.memoryUsage = mTotalEffectsMemory;
1685    }
1686    mTotalEffectsMemory -= effectDesc->mDesc.memoryUsage;
1687    ALOGV("unregisterEffect() effect %s, ID %d, memory %d total memory %d",
1688            effectDesc->mDesc.name, id, effectDesc->mDesc.memoryUsage, mTotalEffectsMemory);
1689
1690    mEffects.removeItem(id);
1691
1692    return NO_ERROR;
1693}
1694
1695status_t AudioPolicyManager::setEffectEnabled(int id, bool enabled)
1696{
1697    ssize_t index = mEffects.indexOfKey(id);
1698    if (index < 0) {
1699        ALOGW("unregisterEffect() unknown effect ID %d", id);
1700        return INVALID_OPERATION;
1701    }
1702
1703    return setEffectEnabled(mEffects.valueAt(index), enabled);
1704}
1705
1706status_t AudioPolicyManager::setEffectEnabled(const sp<EffectDescriptor>& effectDesc, bool enabled)
1707{
1708    if (enabled == effectDesc->mEnabled) {
1709        ALOGV("setEffectEnabled(%s) effect already %s",
1710             enabled?"true":"false", enabled?"enabled":"disabled");
1711        return INVALID_OPERATION;
1712    }
1713
1714    if (enabled) {
1715        if (mTotalEffectsCpuLoad + effectDesc->mDesc.cpuLoad > getMaxEffectsCpuLoad()) {
1716            ALOGW("setEffectEnabled(true) CPU Load limit exceeded for Fx %s, CPU %f MIPS",
1717                 effectDesc->mDesc.name, (float)effectDesc->mDesc.cpuLoad/10);
1718            return INVALID_OPERATION;
1719        }
1720        mTotalEffectsCpuLoad += effectDesc->mDesc.cpuLoad;
1721        ALOGV("setEffectEnabled(true) total CPU %d", mTotalEffectsCpuLoad);
1722    } else {
1723        if (mTotalEffectsCpuLoad < effectDesc->mDesc.cpuLoad) {
1724            ALOGW("setEffectEnabled(false) CPU load %d too high for total %d",
1725                    effectDesc->mDesc.cpuLoad, mTotalEffectsCpuLoad);
1726            effectDesc->mDesc.cpuLoad = mTotalEffectsCpuLoad;
1727        }
1728        mTotalEffectsCpuLoad -= effectDesc->mDesc.cpuLoad;
1729        ALOGV("setEffectEnabled(false) total CPU %d", mTotalEffectsCpuLoad);
1730    }
1731    effectDesc->mEnabled = enabled;
1732    return NO_ERROR;
1733}
1734
1735bool AudioPolicyManager::isNonOffloadableEffectEnabled()
1736{
1737    for (size_t i = 0; i < mEffects.size(); i++) {
1738        sp<EffectDescriptor> effectDesc = mEffects.valueAt(i);
1739        if (effectDesc->mEnabled && (effectDesc->mStrategy == STRATEGY_MEDIA) &&
1740                ((effectDesc->mDesc.flags & EFFECT_FLAG_OFFLOAD_SUPPORTED) == 0)) {
1741            ALOGV("isNonOffloadableEffectEnabled() non offloadable effect %s enabled on session %d",
1742                  effectDesc->mDesc.name, effectDesc->mSession);
1743            return true;
1744        }
1745    }
1746    return false;
1747}
1748
1749bool AudioPolicyManager::isStreamActive(audio_stream_type_t stream, uint32_t inPastMs) const
1750{
1751    nsecs_t sysTime = systemTime();
1752    for (size_t i = 0; i < mOutputs.size(); i++) {
1753        const sp<AudioOutputDescriptor> outputDesc = mOutputs.valueAt(i);
1754        if (outputDesc->isStreamActive(stream, inPastMs, sysTime)) {
1755            return true;
1756        }
1757    }
1758    return false;
1759}
1760
1761bool AudioPolicyManager::isStreamActiveRemotely(audio_stream_type_t stream,
1762                                                    uint32_t inPastMs) const
1763{
1764    nsecs_t sysTime = systemTime();
1765    for (size_t i = 0; i < mOutputs.size(); i++) {
1766        const sp<AudioOutputDescriptor> outputDesc = mOutputs.valueAt(i);
1767        if (((outputDesc->device() & APM_AUDIO_OUT_DEVICE_REMOTE_ALL) != 0) &&
1768                outputDesc->isStreamActive(stream, inPastMs, sysTime)) {
1769            return true;
1770        }
1771    }
1772    return false;
1773}
1774
1775bool AudioPolicyManager::isSourceActive(audio_source_t source) const
1776{
1777    for (size_t i = 0; i < mInputs.size(); i++) {
1778        const sp<AudioInputDescriptor>  inputDescriptor = mInputs.valueAt(i);
1779        if ((inputDescriptor->mInputSource == (int)source ||
1780                (source == AUDIO_SOURCE_VOICE_RECOGNITION &&
1781                 inputDescriptor->mInputSource == AUDIO_SOURCE_HOTWORD))
1782             && (inputDescriptor->mRefCount > 0)) {
1783            return true;
1784        }
1785    }
1786    return false;
1787}
1788
1789
1790status_t AudioPolicyManager::dump(int fd)
1791{
1792    const size_t SIZE = 256;
1793    char buffer[SIZE];
1794    String8 result;
1795
1796    snprintf(buffer, SIZE, "\nAudioPolicyManager Dump: %p\n", this);
1797    result.append(buffer);
1798
1799    snprintf(buffer, SIZE, " Primary Output: %d\n", mPrimaryOutput);
1800    result.append(buffer);
1801    snprintf(buffer, SIZE, " Phone state: %d\n", mPhoneState);
1802    result.append(buffer);
1803    snprintf(buffer, SIZE, " Force use for communications %d\n",
1804             mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION]);
1805    result.append(buffer);
1806    snprintf(buffer, SIZE, " Force use for media %d\n", mForceUse[AUDIO_POLICY_FORCE_FOR_MEDIA]);
1807    result.append(buffer);
1808    snprintf(buffer, SIZE, " Force use for record %d\n", mForceUse[AUDIO_POLICY_FORCE_FOR_RECORD]);
1809    result.append(buffer);
1810    snprintf(buffer, SIZE, " Force use for dock %d\n", mForceUse[AUDIO_POLICY_FORCE_FOR_DOCK]);
1811    result.append(buffer);
1812    snprintf(buffer, SIZE, " Force use for system %d\n", mForceUse[AUDIO_POLICY_FORCE_FOR_SYSTEM]);
1813    result.append(buffer);
1814    snprintf(buffer, SIZE, " Force use for hdmi system audio %d\n",
1815            mForceUse[AUDIO_POLICY_FORCE_FOR_HDMI_SYSTEM_AUDIO]);
1816    result.append(buffer);
1817
1818    snprintf(buffer, SIZE, " Available output devices:\n");
1819    result.append(buffer);
1820    write(fd, result.string(), result.size());
1821    for (size_t i = 0; i < mAvailableOutputDevices.size(); i++) {
1822        mAvailableOutputDevices[i]->dump(fd, 2, i);
1823    }
1824    snprintf(buffer, SIZE, "\n Available input devices:\n");
1825    write(fd, buffer, strlen(buffer));
1826    for (size_t i = 0; i < mAvailableInputDevices.size(); i++) {
1827        mAvailableInputDevices[i]->dump(fd, 2, i);
1828    }
1829
1830    snprintf(buffer, SIZE, "\nHW Modules dump:\n");
1831    write(fd, buffer, strlen(buffer));
1832    for (size_t i = 0; i < mHwModules.size(); i++) {
1833        snprintf(buffer, SIZE, "- HW Module %zu:\n", i + 1);
1834        write(fd, buffer, strlen(buffer));
1835        mHwModules[i]->dump(fd);
1836    }
1837
1838    snprintf(buffer, SIZE, "\nOutputs dump:\n");
1839    write(fd, buffer, strlen(buffer));
1840    for (size_t i = 0; i < mOutputs.size(); i++) {
1841        snprintf(buffer, SIZE, "- Output %d dump:\n", mOutputs.keyAt(i));
1842        write(fd, buffer, strlen(buffer));
1843        mOutputs.valueAt(i)->dump(fd);
1844    }
1845
1846    snprintf(buffer, SIZE, "\nInputs dump:\n");
1847    write(fd, buffer, strlen(buffer));
1848    for (size_t i = 0; i < mInputs.size(); i++) {
1849        snprintf(buffer, SIZE, "- Input %d dump:\n", mInputs.keyAt(i));
1850        write(fd, buffer, strlen(buffer));
1851        mInputs.valueAt(i)->dump(fd);
1852    }
1853
1854    snprintf(buffer, SIZE, "\nStreams dump:\n");
1855    write(fd, buffer, strlen(buffer));
1856    snprintf(buffer, SIZE,
1857             " Stream  Can be muted  Index Min  Index Max  Index Cur [device : index]...\n");
1858    write(fd, buffer, strlen(buffer));
1859    for (size_t i = 0; i < AUDIO_STREAM_CNT; i++) {
1860        snprintf(buffer, SIZE, " %02zu      ", i);
1861        write(fd, buffer, strlen(buffer));
1862        mStreams[i].dump(fd);
1863    }
1864
1865    snprintf(buffer, SIZE, "\nTotal Effects CPU: %f MIPS, Total Effects memory: %d KB\n",
1866            (float)mTotalEffectsCpuLoad/10, mTotalEffectsMemory);
1867    write(fd, buffer, strlen(buffer));
1868
1869    snprintf(buffer, SIZE, "Registered effects:\n");
1870    write(fd, buffer, strlen(buffer));
1871    for (size_t i = 0; i < mEffects.size(); i++) {
1872        snprintf(buffer, SIZE, "- Effect %d dump:\n", mEffects.keyAt(i));
1873        write(fd, buffer, strlen(buffer));
1874        mEffects.valueAt(i)->dump(fd);
1875    }
1876
1877    snprintf(buffer, SIZE, "\nAudio Patches:\n");
1878    write(fd, buffer, strlen(buffer));
1879    for (size_t i = 0; i < mAudioPatches.size(); i++) {
1880        mAudioPatches[i]->dump(fd, 2, i);
1881    }
1882
1883    return NO_ERROR;
1884}
1885
1886// This function checks for the parameters which can be offloaded.
1887// This can be enhanced depending on the capability of the DSP and policy
1888// of the system.
1889bool AudioPolicyManager::isOffloadSupported(const audio_offload_info_t& offloadInfo)
1890{
1891    ALOGV("isOffloadSupported: SR=%u, CM=0x%x, Format=0x%x, StreamType=%d,"
1892     " BitRate=%u, duration=%" PRId64 " us, has_video=%d",
1893     offloadInfo.sample_rate, offloadInfo.channel_mask,
1894     offloadInfo.format,
1895     offloadInfo.stream_type, offloadInfo.bit_rate, offloadInfo.duration_us,
1896     offloadInfo.has_video);
1897
1898    // Check if offload has been disabled
1899    char propValue[PROPERTY_VALUE_MAX];
1900    if (property_get("audio.offload.disable", propValue, "0")) {
1901        if (atoi(propValue) != 0) {
1902            ALOGV("offload disabled by audio.offload.disable=%s", propValue );
1903            return false;
1904        }
1905    }
1906
1907    // Check if stream type is music, then only allow offload as of now.
1908    if (offloadInfo.stream_type != AUDIO_STREAM_MUSIC)
1909    {
1910        ALOGV("isOffloadSupported: stream_type != MUSIC, returning false");
1911        return false;
1912    }
1913
1914    //TODO: enable audio offloading with video when ready
1915    if (offloadInfo.has_video)
1916    {
1917        ALOGV("isOffloadSupported: has_video == true, returning false");
1918        return false;
1919    }
1920
1921    //If duration is less than minimum value defined in property, return false
1922    if (property_get("audio.offload.min.duration.secs", propValue, NULL)) {
1923        if (offloadInfo.duration_us < (atoi(propValue) * 1000000 )) {
1924            ALOGV("Offload denied by duration < audio.offload.min.duration.secs(=%s)", propValue);
1925            return false;
1926        }
1927    } else if (offloadInfo.duration_us < OFFLOAD_DEFAULT_MIN_DURATION_SECS * 1000000) {
1928        ALOGV("Offload denied by duration < default min(=%u)", OFFLOAD_DEFAULT_MIN_DURATION_SECS);
1929        return false;
1930    }
1931
1932    // Do not allow offloading if one non offloadable effect is enabled. This prevents from
1933    // creating an offloaded track and tearing it down immediately after start when audioflinger
1934    // detects there is an active non offloadable effect.
1935    // FIXME: We should check the audio session here but we do not have it in this context.
1936    // This may prevent offloading in rare situations where effects are left active by apps
1937    // in the background.
1938    if (isNonOffloadableEffectEnabled()) {
1939        return false;
1940    }
1941
1942    // See if there is a profile to support this.
1943    // AUDIO_DEVICE_NONE
1944    sp<IOProfile> profile = getProfileForDirectOutput(AUDIO_DEVICE_NONE /*ignore device */,
1945                                            offloadInfo.sample_rate,
1946                                            offloadInfo.format,
1947                                            offloadInfo.channel_mask,
1948                                            AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD);
1949    ALOGV("isOffloadSupported() profile %sfound", profile != 0 ? "" : "NOT ");
1950    return (profile != 0);
1951}
1952
1953status_t AudioPolicyManager::listAudioPorts(audio_port_role_t role,
1954                                            audio_port_type_t type,
1955                                            unsigned int *num_ports,
1956                                            struct audio_port *ports,
1957                                            unsigned int *generation)
1958{
1959    if (num_ports == NULL || (*num_ports != 0 && ports == NULL) ||
1960            generation == NULL) {
1961        return BAD_VALUE;
1962    }
1963    ALOGV("listAudioPorts() role %d type %d num_ports %d ports %p", role, type, *num_ports, ports);
1964    if (ports == NULL) {
1965        *num_ports = 0;
1966    }
1967
1968    size_t portsWritten = 0;
1969    size_t portsMax = *num_ports;
1970    *num_ports = 0;
1971    if (type == AUDIO_PORT_TYPE_NONE || type == AUDIO_PORT_TYPE_DEVICE) {
1972        if (role == AUDIO_PORT_ROLE_SINK || role == AUDIO_PORT_ROLE_NONE) {
1973            for (size_t i = 0;
1974                    i  < mAvailableOutputDevices.size() && portsWritten < portsMax; i++) {
1975                mAvailableOutputDevices[i]->toAudioPort(&ports[portsWritten++]);
1976            }
1977            *num_ports += mAvailableOutputDevices.size();
1978        }
1979        if (role == AUDIO_PORT_ROLE_SOURCE || role == AUDIO_PORT_ROLE_NONE) {
1980            for (size_t i = 0;
1981                    i  < mAvailableInputDevices.size() && portsWritten < portsMax; i++) {
1982                mAvailableInputDevices[i]->toAudioPort(&ports[portsWritten++]);
1983            }
1984            *num_ports += mAvailableInputDevices.size();
1985        }
1986    }
1987    if (type == AUDIO_PORT_TYPE_NONE || type == AUDIO_PORT_TYPE_MIX) {
1988        if (role == AUDIO_PORT_ROLE_SINK || role == AUDIO_PORT_ROLE_NONE) {
1989            for (size_t i = 0; i < mInputs.size() && portsWritten < portsMax; i++) {
1990                mInputs[i]->toAudioPort(&ports[portsWritten++]);
1991            }
1992            *num_ports += mInputs.size();
1993        }
1994        if (role == AUDIO_PORT_ROLE_SOURCE || role == AUDIO_PORT_ROLE_NONE) {
1995            size_t numOutputs = 0;
1996            for (size_t i = 0; i < mOutputs.size(); i++) {
1997                if (!mOutputs[i]->isDuplicated()) {
1998                    numOutputs++;
1999                    if (portsWritten < portsMax) {
2000                        mOutputs[i]->toAudioPort(&ports[portsWritten++]);
2001                    }
2002                }
2003            }
2004            *num_ports += numOutputs;
2005        }
2006    }
2007    *generation = curAudioPortGeneration();
2008    ALOGV("listAudioPorts() got %zu ports needed %d", portsWritten, *num_ports);
2009    return NO_ERROR;
2010}
2011
2012status_t AudioPolicyManager::getAudioPort(struct audio_port *port __unused)
2013{
2014    return NO_ERROR;
2015}
2016
2017sp<AudioPolicyManager::AudioOutputDescriptor> AudioPolicyManager::getOutputFromId(
2018                                                                    audio_port_handle_t id) const
2019{
2020    sp<AudioOutputDescriptor> outputDesc = NULL;
2021    for (size_t i = 0; i < mOutputs.size(); i++) {
2022        outputDesc = mOutputs.valueAt(i);
2023        if (outputDesc->mId == id) {
2024            break;
2025        }
2026    }
2027    return outputDesc;
2028}
2029
2030sp<AudioPolicyManager::AudioInputDescriptor> AudioPolicyManager::getInputFromId(
2031                                                                    audio_port_handle_t id) const
2032{
2033    sp<AudioInputDescriptor> inputDesc = NULL;
2034    for (size_t i = 0; i < mInputs.size(); i++) {
2035        inputDesc = mInputs.valueAt(i);
2036        if (inputDesc->mId == id) {
2037            break;
2038        }
2039    }
2040    return inputDesc;
2041}
2042
2043sp <AudioPolicyManager::HwModule> AudioPolicyManager::getModuleForDevice(
2044                                                                    audio_devices_t device) const
2045{
2046    sp <HwModule> module;
2047
2048    for (size_t i = 0; i < mHwModules.size(); i++) {
2049        if (mHwModules[i]->mHandle == 0) {
2050            continue;
2051        }
2052        if (audio_is_output_device(device)) {
2053            for (size_t j = 0; j < mHwModules[i]->mOutputProfiles.size(); j++)
2054            {
2055                if (mHwModules[i]->mOutputProfiles[j]->mSupportedDevices.types() & device) {
2056                    return mHwModules[i];
2057                }
2058            }
2059        } else {
2060            for (size_t j = 0; j < mHwModules[i]->mInputProfiles.size(); j++) {
2061                if (mHwModules[i]->mInputProfiles[j]->mSupportedDevices.types() &
2062                        device & ~AUDIO_DEVICE_BIT_IN) {
2063                    return mHwModules[i];
2064                }
2065            }
2066        }
2067    }
2068    return module;
2069}
2070
2071sp <AudioPolicyManager::HwModule> AudioPolicyManager::getModuleFromName(const char *name) const
2072{
2073    sp <HwModule> module;
2074
2075    for (size_t i = 0; i < mHwModules.size(); i++)
2076    {
2077        if (strcmp(mHwModules[i]->mName, name) == 0) {
2078            return mHwModules[i];
2079        }
2080    }
2081    return module;
2082}
2083
2084audio_devices_t AudioPolicyManager::availablePrimaryOutputDevices()
2085{
2086    sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(mPrimaryOutput);
2087    audio_devices_t devices = outputDesc->mProfile->mSupportedDevices.types();
2088    return devices & mAvailableOutputDevices.types();
2089}
2090
2091audio_devices_t AudioPolicyManager::availablePrimaryInputDevices()
2092{
2093    audio_module_handle_t primaryHandle =
2094                                mOutputs.valueFor(mPrimaryOutput)->mProfile->mModule->mHandle;
2095    audio_devices_t devices = AUDIO_DEVICE_NONE;
2096    for (size_t i = 0; i < mAvailableInputDevices.size(); i++) {
2097        if (mAvailableInputDevices[i]->mModule->mHandle == primaryHandle) {
2098            devices |= mAvailableInputDevices[i]->mDeviceType;
2099        }
2100    }
2101    return devices;
2102}
2103
2104status_t AudioPolicyManager::createAudioPatch(const struct audio_patch *patch,
2105                                               audio_patch_handle_t *handle,
2106                                               uid_t uid)
2107{
2108    ALOGV("createAudioPatch()");
2109
2110    if (handle == NULL || patch == NULL) {
2111        return BAD_VALUE;
2112    }
2113    ALOGV("createAudioPatch() num sources %d num sinks %d", patch->num_sources, patch->num_sinks);
2114
2115    if (patch->num_sources == 0 || patch->num_sources > AUDIO_PATCH_PORTS_MAX ||
2116            patch->num_sinks == 0 || patch->num_sinks > AUDIO_PATCH_PORTS_MAX) {
2117        return BAD_VALUE;
2118    }
2119    // only one source per audio patch supported for now
2120    if (patch->num_sources > 1) {
2121        return INVALID_OPERATION;
2122    }
2123
2124    if (patch->sources[0].role != AUDIO_PORT_ROLE_SOURCE) {
2125        return INVALID_OPERATION;
2126    }
2127    for (size_t i = 0; i < patch->num_sinks; i++) {
2128        if (patch->sinks[i].role != AUDIO_PORT_ROLE_SINK) {
2129            return INVALID_OPERATION;
2130        }
2131    }
2132
2133    sp<AudioPatch> patchDesc;
2134    ssize_t index = mAudioPatches.indexOfKey(*handle);
2135
2136    ALOGV("createAudioPatch source id %d role %d type %d", patch->sources[0].id,
2137                                                           patch->sources[0].role,
2138                                                           patch->sources[0].type);
2139#if LOG_NDEBUG == 0
2140    for (size_t i = 0; i < patch->num_sinks; i++) {
2141        ALOGV("createAudioPatch sink %d: id %d role %d type %d", i, patch->sinks[i].id,
2142                                                             patch->sinks[i].role,
2143                                                             patch->sinks[i].type);
2144    }
2145#endif
2146
2147    if (index >= 0) {
2148        patchDesc = mAudioPatches.valueAt(index);
2149        ALOGV("createAudioPatch() mUidCached %d patchDesc->mUid %d uid %d",
2150                                                                  mUidCached, patchDesc->mUid, uid);
2151        if (patchDesc->mUid != mUidCached && uid != patchDesc->mUid) {
2152            return INVALID_OPERATION;
2153        }
2154    } else {
2155        *handle = 0;
2156    }
2157
2158    if (patch->sources[0].type == AUDIO_PORT_TYPE_MIX) {
2159        sp<AudioOutputDescriptor> outputDesc = getOutputFromId(patch->sources[0].id);
2160        if (outputDesc == NULL) {
2161            ALOGV("createAudioPatch() output not found for id %d", patch->sources[0].id);
2162            return BAD_VALUE;
2163        }
2164        ALOG_ASSERT(!outputDesc->isDuplicated(),"duplicated output %d in source in ports",
2165                                                outputDesc->mIoHandle);
2166        if (patchDesc != 0) {
2167            if (patchDesc->mPatch.sources[0].id != patch->sources[0].id) {
2168                ALOGV("createAudioPatch() source id differs for patch current id %d new id %d",
2169                                          patchDesc->mPatch.sources[0].id, patch->sources[0].id);
2170                return BAD_VALUE;
2171            }
2172        }
2173        DeviceVector devices;
2174        for (size_t i = 0; i < patch->num_sinks; i++) {
2175            // Only support mix to devices connection
2176            // TODO add support for mix to mix connection
2177            if (patch->sinks[i].type != AUDIO_PORT_TYPE_DEVICE) {
2178                ALOGV("createAudioPatch() source mix but sink is not a device");
2179                return INVALID_OPERATION;
2180            }
2181            sp<DeviceDescriptor> devDesc =
2182                    mAvailableOutputDevices.getDeviceFromId(patch->sinks[i].id);
2183            if (devDesc == 0) {
2184                ALOGV("createAudioPatch() out device not found for id %d", patch->sinks[i].id);
2185                return BAD_VALUE;
2186            }
2187
2188            if (!outputDesc->mProfile->isCompatibleProfile(devDesc->mDeviceType,
2189                                                           patch->sources[0].sample_rate,
2190                                                         NULL,  // updatedSamplingRate
2191                                                         patch->sources[0].format,
2192                                                         patch->sources[0].channel_mask,
2193                                                         AUDIO_OUTPUT_FLAG_NONE /*FIXME*/)) {
2194                ALOGV("createAudioPatch() profile not supported for device %08x",
2195                      devDesc->mDeviceType);
2196                return INVALID_OPERATION;
2197            }
2198            devices.add(devDesc);
2199        }
2200        if (devices.size() == 0) {
2201            return INVALID_OPERATION;
2202        }
2203
2204        // TODO: reconfigure output format and channels here
2205        ALOGV("createAudioPatch() setting device %08x on output %d",
2206              devices.types(), outputDesc->mIoHandle);
2207        setOutputDevice(outputDesc->mIoHandle, devices.types(), true, 0, handle);
2208        index = mAudioPatches.indexOfKey(*handle);
2209        if (index >= 0) {
2210            if (patchDesc != 0 && patchDesc != mAudioPatches.valueAt(index)) {
2211                ALOGW("createAudioPatch() setOutputDevice() did not reuse the patch provided");
2212            }
2213            patchDesc = mAudioPatches.valueAt(index);
2214            patchDesc->mUid = uid;
2215            ALOGV("createAudioPatch() success");
2216        } else {
2217            ALOGW("createAudioPatch() setOutputDevice() failed to create a patch");
2218            return INVALID_OPERATION;
2219        }
2220    } else if (patch->sources[0].type == AUDIO_PORT_TYPE_DEVICE) {
2221        if (patch->sinks[0].type == AUDIO_PORT_TYPE_MIX) {
2222            // input device to input mix connection
2223            // only one sink supported when connecting an input device to a mix
2224            if (patch->num_sinks > 1) {
2225                return INVALID_OPERATION;
2226            }
2227            sp<AudioInputDescriptor> inputDesc = getInputFromId(patch->sinks[0].id);
2228            if (inputDesc == NULL) {
2229                return BAD_VALUE;
2230            }
2231            if (patchDesc != 0) {
2232                if (patchDesc->mPatch.sinks[0].id != patch->sinks[0].id) {
2233                    return BAD_VALUE;
2234                }
2235            }
2236            sp<DeviceDescriptor> devDesc =
2237                    mAvailableInputDevices.getDeviceFromId(patch->sources[0].id);
2238            if (devDesc == 0) {
2239                return BAD_VALUE;
2240            }
2241
2242            if (!inputDesc->mProfile->isCompatibleProfile(devDesc->mDeviceType,
2243                                                         patch->sinks[0].sample_rate,
2244                                                         NULL, /*updatedSampleRate*/
2245                                                         patch->sinks[0].format,
2246                                                         patch->sinks[0].channel_mask,
2247                                                         // FIXME for the parameter type,
2248                                                         // and the NONE
2249                                                         (audio_output_flags_t)
2250                                                            AUDIO_INPUT_FLAG_NONE)) {
2251                return INVALID_OPERATION;
2252            }
2253            // TODO: reconfigure output format and channels here
2254            ALOGV("createAudioPatch() setting device %08x on output %d",
2255                                                  devDesc->mDeviceType, inputDesc->mIoHandle);
2256            setInputDevice(inputDesc->mIoHandle, devDesc->mDeviceType, true, handle);
2257            index = mAudioPatches.indexOfKey(*handle);
2258            if (index >= 0) {
2259                if (patchDesc != 0 && patchDesc != mAudioPatches.valueAt(index)) {
2260                    ALOGW("createAudioPatch() setInputDevice() did not reuse the patch provided");
2261                }
2262                patchDesc = mAudioPatches.valueAt(index);
2263                patchDesc->mUid = uid;
2264                ALOGV("createAudioPatch() success");
2265            } else {
2266                ALOGW("createAudioPatch() setInputDevice() failed to create a patch");
2267                return INVALID_OPERATION;
2268            }
2269        } else if (patch->sinks[0].type == AUDIO_PORT_TYPE_DEVICE) {
2270            // device to device connection
2271            if (patchDesc != 0) {
2272                if (patchDesc->mPatch.sources[0].id != patch->sources[0].id) {
2273                    return BAD_VALUE;
2274                }
2275            }
2276            sp<DeviceDescriptor> srcDeviceDesc =
2277                    mAvailableInputDevices.getDeviceFromId(patch->sources[0].id);
2278
2279            //update source and sink with our own data as the data passed in the patch may
2280            // be incomplete.
2281            struct audio_patch newPatch = *patch;
2282            srcDeviceDesc->toAudioPortConfig(&newPatch.sources[0], &patch->sources[0]);
2283            if (srcDeviceDesc == 0) {
2284                return BAD_VALUE;
2285            }
2286
2287            for (size_t i = 0; i < patch->num_sinks; i++) {
2288                if (patch->sinks[i].type != AUDIO_PORT_TYPE_DEVICE) {
2289                    ALOGV("createAudioPatch() source device but one sink is not a device");
2290                    return INVALID_OPERATION;
2291                }
2292
2293                sp<DeviceDescriptor> sinkDeviceDesc =
2294                        mAvailableOutputDevices.getDeviceFromId(patch->sinks[i].id);
2295                if (sinkDeviceDesc == 0) {
2296                    return BAD_VALUE;
2297                }
2298                sinkDeviceDesc->toAudioPortConfig(&newPatch.sinks[i], &patch->sinks[i]);
2299
2300                if (srcDeviceDesc->mModule != sinkDeviceDesc->mModule) {
2301                    // only one sink supported when connected devices across HW modules
2302                    if (patch->num_sinks > 1) {
2303                        return INVALID_OPERATION;
2304                    }
2305                    SortedVector<audio_io_handle_t> outputs =
2306                                            getOutputsForDevice(sinkDeviceDesc->mDeviceType,
2307                                                                mOutputs);
2308                    // if the sink device is reachable via an opened output stream, request to go via
2309                    // this output stream by adding a second source to the patch description
2310                    audio_io_handle_t output = selectOutput(outputs, AUDIO_OUTPUT_FLAG_NONE);
2311                    if (output != AUDIO_IO_HANDLE_NONE) {
2312                        sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(output);
2313                        if (outputDesc->isDuplicated()) {
2314                            return INVALID_OPERATION;
2315                        }
2316                        outputDesc->toAudioPortConfig(&newPatch.sources[1], &patch->sources[0]);
2317                        newPatch.num_sources = 2;
2318                    }
2319                }
2320            }
2321            // TODO: check from routing capabilities in config file and other conflicting patches
2322
2323            audio_patch_handle_t afPatchHandle = AUDIO_PATCH_HANDLE_NONE;
2324            if (index >= 0) {
2325                afPatchHandle = patchDesc->mAfPatchHandle;
2326            }
2327
2328            status_t status = mpClientInterface->createAudioPatch(&newPatch,
2329                                                                  &afPatchHandle,
2330                                                                  0);
2331            ALOGV("createAudioPatch() patch panel returned %d patchHandle %d",
2332                                                                  status, afPatchHandle);
2333            if (status == NO_ERROR) {
2334                if (index < 0) {
2335                    patchDesc = new AudioPatch((audio_patch_handle_t)nextUniqueId(),
2336                                               &newPatch, uid);
2337                    addAudioPatch(patchDesc->mHandle, patchDesc);
2338                } else {
2339                    patchDesc->mPatch = newPatch;
2340                }
2341                patchDesc->mAfPatchHandle = afPatchHandle;
2342                *handle = patchDesc->mHandle;
2343                nextAudioPortGeneration();
2344                mpClientInterface->onAudioPatchListUpdate();
2345            } else {
2346                ALOGW("createAudioPatch() patch panel could not connect device patch, error %d",
2347                status);
2348                return INVALID_OPERATION;
2349            }
2350        } else {
2351            return BAD_VALUE;
2352        }
2353    } else {
2354        return BAD_VALUE;
2355    }
2356    return NO_ERROR;
2357}
2358
2359status_t AudioPolicyManager::releaseAudioPatch(audio_patch_handle_t handle,
2360                                                  uid_t uid)
2361{
2362    ALOGV("releaseAudioPatch() patch %d", handle);
2363
2364    ssize_t index = mAudioPatches.indexOfKey(handle);
2365
2366    if (index < 0) {
2367        return BAD_VALUE;
2368    }
2369    sp<AudioPatch> patchDesc = mAudioPatches.valueAt(index);
2370    ALOGV("releaseAudioPatch() mUidCached %d patchDesc->mUid %d uid %d",
2371          mUidCached, patchDesc->mUid, uid);
2372    if (patchDesc->mUid != mUidCached && uid != patchDesc->mUid) {
2373        return INVALID_OPERATION;
2374    }
2375
2376    struct audio_patch *patch = &patchDesc->mPatch;
2377    patchDesc->mUid = mUidCached;
2378    if (patch->sources[0].type == AUDIO_PORT_TYPE_MIX) {
2379        sp<AudioOutputDescriptor> outputDesc = getOutputFromId(patch->sources[0].id);
2380        if (outputDesc == NULL) {
2381            ALOGV("releaseAudioPatch() output not found for id %d", patch->sources[0].id);
2382            return BAD_VALUE;
2383        }
2384
2385        setOutputDevice(outputDesc->mIoHandle,
2386                        getNewOutputDevice(outputDesc->mIoHandle, true /*fromCache*/),
2387                       true,
2388                       0,
2389                       NULL);
2390    } else if (patch->sources[0].type == AUDIO_PORT_TYPE_DEVICE) {
2391        if (patch->sinks[0].type == AUDIO_PORT_TYPE_MIX) {
2392            sp<AudioInputDescriptor> inputDesc = getInputFromId(patch->sinks[0].id);
2393            if (inputDesc == NULL) {
2394                ALOGV("releaseAudioPatch() input not found for id %d", patch->sinks[0].id);
2395                return BAD_VALUE;
2396            }
2397            setInputDevice(inputDesc->mIoHandle,
2398                           getNewInputDevice(inputDesc->mIoHandle),
2399                           true,
2400                           NULL);
2401        } else if (patch->sinks[0].type == AUDIO_PORT_TYPE_DEVICE) {
2402            audio_patch_handle_t afPatchHandle = patchDesc->mAfPatchHandle;
2403            status_t status = mpClientInterface->releaseAudioPatch(patchDesc->mAfPatchHandle, 0);
2404            ALOGV("releaseAudioPatch() patch panel returned %d patchHandle %d",
2405                                                              status, patchDesc->mAfPatchHandle);
2406            removeAudioPatch(patchDesc->mHandle);
2407            nextAudioPortGeneration();
2408            mpClientInterface->onAudioPatchListUpdate();
2409        } else {
2410            return BAD_VALUE;
2411        }
2412    } else {
2413        return BAD_VALUE;
2414    }
2415    return NO_ERROR;
2416}
2417
2418status_t AudioPolicyManager::listAudioPatches(unsigned int *num_patches,
2419                                              struct audio_patch *patches,
2420                                              unsigned int *generation)
2421{
2422    if (num_patches == NULL || (*num_patches != 0 && patches == NULL) ||
2423            generation == NULL) {
2424        return BAD_VALUE;
2425    }
2426    ALOGV("listAudioPatches() num_patches %d patches %p available patches %zu",
2427          *num_patches, patches, mAudioPatches.size());
2428    if (patches == NULL) {
2429        *num_patches = 0;
2430    }
2431
2432    size_t patchesWritten = 0;
2433    size_t patchesMax = *num_patches;
2434    for (size_t i = 0;
2435            i  < mAudioPatches.size() && patchesWritten < patchesMax; i++) {
2436        patches[patchesWritten] = mAudioPatches[i]->mPatch;
2437        patches[patchesWritten++].id = mAudioPatches[i]->mHandle;
2438        ALOGV("listAudioPatches() patch %zu num_sources %d num_sinks %d",
2439              i, mAudioPatches[i]->mPatch.num_sources, mAudioPatches[i]->mPatch.num_sinks);
2440    }
2441    *num_patches = mAudioPatches.size();
2442
2443    *generation = curAudioPortGeneration();
2444    ALOGV("listAudioPatches() got %zu patches needed %d", patchesWritten, *num_patches);
2445    return NO_ERROR;
2446}
2447
2448status_t AudioPolicyManager::setAudioPortConfig(const struct audio_port_config *config)
2449{
2450    ALOGV("setAudioPortConfig()");
2451
2452    if (config == NULL) {
2453        return BAD_VALUE;
2454    }
2455    ALOGV("setAudioPortConfig() on port handle %d", config->id);
2456    // Only support gain configuration for now
2457    if (config->config_mask != AUDIO_PORT_CONFIG_GAIN) {
2458        return INVALID_OPERATION;
2459    }
2460
2461    sp<AudioPortConfig> audioPortConfig;
2462    if (config->type == AUDIO_PORT_TYPE_MIX) {
2463        if (config->role == AUDIO_PORT_ROLE_SOURCE) {
2464            sp<AudioOutputDescriptor> outputDesc = getOutputFromId(config->id);
2465            if (outputDesc == NULL) {
2466                return BAD_VALUE;
2467            }
2468            ALOG_ASSERT(!outputDesc->isDuplicated(),
2469                        "setAudioPortConfig() called on duplicated output %d",
2470                        outputDesc->mIoHandle);
2471            audioPortConfig = outputDesc;
2472        } else if (config->role == AUDIO_PORT_ROLE_SINK) {
2473            sp<AudioInputDescriptor> inputDesc = getInputFromId(config->id);
2474            if (inputDesc == NULL) {
2475                return BAD_VALUE;
2476            }
2477            audioPortConfig = inputDesc;
2478        } else {
2479            return BAD_VALUE;
2480        }
2481    } else if (config->type == AUDIO_PORT_TYPE_DEVICE) {
2482        sp<DeviceDescriptor> deviceDesc;
2483        if (config->role == AUDIO_PORT_ROLE_SOURCE) {
2484            deviceDesc = mAvailableInputDevices.getDeviceFromId(config->id);
2485        } else if (config->role == AUDIO_PORT_ROLE_SINK) {
2486            deviceDesc = mAvailableOutputDevices.getDeviceFromId(config->id);
2487        } else {
2488            return BAD_VALUE;
2489        }
2490        if (deviceDesc == NULL) {
2491            return BAD_VALUE;
2492        }
2493        audioPortConfig = deviceDesc;
2494    } else {
2495        return BAD_VALUE;
2496    }
2497
2498    struct audio_port_config backupConfig;
2499    status_t status = audioPortConfig->applyAudioPortConfig(config, &backupConfig);
2500    if (status == NO_ERROR) {
2501        struct audio_port_config newConfig;
2502        audioPortConfig->toAudioPortConfig(&newConfig, config);
2503        status = mpClientInterface->setAudioPortConfig(&newConfig, 0);
2504    }
2505    if (status != NO_ERROR) {
2506        audioPortConfig->applyAudioPortConfig(&backupConfig);
2507    }
2508
2509    return status;
2510}
2511
2512void AudioPolicyManager::clearAudioPatches(uid_t uid)
2513{
2514    for (ssize_t i = 0; i < (ssize_t)mAudioPatches.size(); i++)  {
2515        sp<AudioPatch> patchDesc = mAudioPatches.valueAt(i);
2516        if (patchDesc->mUid == uid) {
2517            // releaseAudioPatch() removes the patch from mAudioPatches
2518            if (releaseAudioPatch(mAudioPatches.keyAt(i), uid) == NO_ERROR) {
2519                i--;
2520            }
2521        }
2522    }
2523}
2524
2525status_t AudioPolicyManager::acquireSoundTriggerSession(audio_session_t *session,
2526                                       audio_io_handle_t *ioHandle,
2527                                       audio_devices_t *device)
2528{
2529    *session = (audio_session_t)mpClientInterface->newAudioUniqueId();
2530    *ioHandle = (audio_io_handle_t)mpClientInterface->newAudioUniqueId();
2531    *device = getDeviceForInputSource(AUDIO_SOURCE_HOTWORD);
2532
2533    mSoundTriggerSessions.add(*session, *ioHandle);
2534
2535    return NO_ERROR;
2536}
2537
2538status_t AudioPolicyManager::releaseSoundTriggerSession(audio_session_t session)
2539{
2540    ssize_t index = mSoundTriggerSessions.indexOfKey(session);
2541    if (index < 0) {
2542        ALOGW("acquireSoundTriggerSession() session %d not registered", session);
2543        return BAD_VALUE;
2544    }
2545
2546    mSoundTriggerSessions.removeItem(session);
2547    return NO_ERROR;
2548}
2549
2550status_t AudioPolicyManager::addAudioPatch(audio_patch_handle_t handle,
2551                                           const sp<AudioPatch>& patch)
2552{
2553    ssize_t index = mAudioPatches.indexOfKey(handle);
2554
2555    if (index >= 0) {
2556        ALOGW("addAudioPatch() patch %d already in", handle);
2557        return ALREADY_EXISTS;
2558    }
2559    mAudioPatches.add(handle, patch);
2560    ALOGV("addAudioPatch() handle %d af handle %d num_sources %d num_sinks %d source handle %d"
2561            "sink handle %d",
2562          handle, patch->mAfPatchHandle, patch->mPatch.num_sources, patch->mPatch.num_sinks,
2563          patch->mPatch.sources[0].id, patch->mPatch.sinks[0].id);
2564    return NO_ERROR;
2565}
2566
2567status_t AudioPolicyManager::removeAudioPatch(audio_patch_handle_t handle)
2568{
2569    ssize_t index = mAudioPatches.indexOfKey(handle);
2570
2571    if (index < 0) {
2572        ALOGW("removeAudioPatch() patch %d not in", handle);
2573        return ALREADY_EXISTS;
2574    }
2575    ALOGV("removeAudioPatch() handle %d af handle %d", handle,
2576                      mAudioPatches.valueAt(index)->mAfPatchHandle);
2577    mAudioPatches.removeItemsAt(index);
2578    return NO_ERROR;
2579}
2580
2581// ----------------------------------------------------------------------------
2582// AudioPolicyManager
2583// ----------------------------------------------------------------------------
2584
2585uint32_t AudioPolicyManager::nextUniqueId()
2586{
2587    return android_atomic_inc(&mNextUniqueId);
2588}
2589
2590uint32_t AudioPolicyManager::nextAudioPortGeneration()
2591{
2592    return android_atomic_inc(&mAudioPortGeneration);
2593}
2594
2595AudioPolicyManager::AudioPolicyManager(AudioPolicyClientInterface *clientInterface)
2596    :
2597#ifdef AUDIO_POLICY_TEST
2598    Thread(false),
2599#endif //AUDIO_POLICY_TEST
2600    mPrimaryOutput((audio_io_handle_t)0),
2601    mPhoneState(AUDIO_MODE_NORMAL),
2602    mLimitRingtoneVolume(false), mLastVoiceVolume(-1.0f),
2603    mTotalEffectsCpuLoad(0), mTotalEffectsMemory(0),
2604    mA2dpSuspended(false),
2605    mSpeakerDrcEnabled(false), mNextUniqueId(1),
2606    mAudioPortGeneration(1)
2607{
2608    mUidCached = getuid();
2609    mpClientInterface = clientInterface;
2610
2611    for (int i = 0; i < AUDIO_POLICY_FORCE_USE_CNT; i++) {
2612        mForceUse[i] = AUDIO_POLICY_FORCE_NONE;
2613    }
2614
2615    mDefaultOutputDevice = new DeviceDescriptor(String8(""), AUDIO_DEVICE_OUT_SPEAKER);
2616    if (loadAudioPolicyConfig(AUDIO_POLICY_VENDOR_CONFIG_FILE) != NO_ERROR) {
2617        if (loadAudioPolicyConfig(AUDIO_POLICY_CONFIG_FILE) != NO_ERROR) {
2618            ALOGE("could not load audio policy configuration file, setting defaults");
2619            defaultAudioPolicyConfig();
2620        }
2621    }
2622    // mAvailableOutputDevices and mAvailableInputDevices now contain all attached devices
2623
2624    // must be done after reading the policy
2625    initializeVolumeCurves();
2626
2627    // open all output streams needed to access attached devices
2628    audio_devices_t outputDeviceTypes = mAvailableOutputDevices.types();
2629    audio_devices_t inputDeviceTypes = mAvailableInputDevices.types() & ~AUDIO_DEVICE_BIT_IN;
2630    for (size_t i = 0; i < mHwModules.size(); i++) {
2631        mHwModules[i]->mHandle = mpClientInterface->loadHwModule(mHwModules[i]->mName);
2632        if (mHwModules[i]->mHandle == 0) {
2633            ALOGW("could not open HW module %s", mHwModules[i]->mName);
2634            continue;
2635        }
2636        // open all output streams needed to access attached devices
2637        // except for direct output streams that are only opened when they are actually
2638        // required by an app.
2639        // This also validates mAvailableOutputDevices list
2640        for (size_t j = 0; j < mHwModules[i]->mOutputProfiles.size(); j++)
2641        {
2642            const sp<IOProfile> outProfile = mHwModules[i]->mOutputProfiles[j];
2643
2644            if (outProfile->mSupportedDevices.isEmpty()) {
2645                ALOGW("Output profile contains no device on module %s", mHwModules[i]->mName);
2646                continue;
2647            }
2648
2649            audio_devices_t profileType = outProfile->mSupportedDevices.types();
2650            if ((profileType & mDefaultOutputDevice->mDeviceType) != AUDIO_DEVICE_NONE) {
2651                profileType = mDefaultOutputDevice->mDeviceType;
2652            } else {
2653                profileType = outProfile->mSupportedDevices[0]->mDeviceType;
2654            }
2655            if ((profileType & outputDeviceTypes) &&
2656                    ((outProfile->mFlags & AUDIO_OUTPUT_FLAG_DIRECT) == 0)) {
2657                sp<AudioOutputDescriptor> outputDesc = new AudioOutputDescriptor(outProfile);
2658
2659                outputDesc->mDevice = profileType;
2660                audio_config_t config = AUDIO_CONFIG_INITIALIZER;
2661                config.sample_rate = outputDesc->mSamplingRate;
2662                config.channel_mask = outputDesc->mChannelMask;
2663                config.format = outputDesc->mFormat;
2664                audio_io_handle_t output = AUDIO_IO_HANDLE_NONE;
2665                status_t status = mpClientInterface->openOutput(outProfile->mModule->mHandle,
2666                                                                &output,
2667                                                                &config,
2668                                                                &outputDesc->mDevice,
2669                                                                String8(""),
2670                                                                &outputDesc->mLatency,
2671                                                                outputDesc->mFlags);
2672
2673                if (status != NO_ERROR) {
2674                    ALOGW("Cannot open output stream for device %08x on hw module %s",
2675                          outputDesc->mDevice,
2676                          mHwModules[i]->mName);
2677                } else {
2678                    outputDesc->mSamplingRate = config.sample_rate;
2679                    outputDesc->mChannelMask = config.channel_mask;
2680                    outputDesc->mFormat = config.format;
2681
2682                    for (size_t k = 0; k  < outProfile->mSupportedDevices.size(); k++) {
2683                        audio_devices_t type = outProfile->mSupportedDevices[k]->mDeviceType;
2684                        ssize_t index =
2685                                mAvailableOutputDevices.indexOf(outProfile->mSupportedDevices[k]);
2686                        // give a valid ID to an attached device once confirmed it is reachable
2687                        if ((index >= 0) && (mAvailableOutputDevices[index]->mId == 0)) {
2688                            mAvailableOutputDevices[index]->mId = nextUniqueId();
2689                            mAvailableOutputDevices[index]->mModule = mHwModules[i];
2690                        }
2691                    }
2692                    if (mPrimaryOutput == 0 &&
2693                            outProfile->mFlags & AUDIO_OUTPUT_FLAG_PRIMARY) {
2694                        mPrimaryOutput = output;
2695                    }
2696                    addOutput(output, outputDesc);
2697                    setOutputDevice(output,
2698                                    outputDesc->mDevice,
2699                                    true);
2700                }
2701            }
2702        }
2703        // open input streams needed to access attached devices to validate
2704        // mAvailableInputDevices list
2705        for (size_t j = 0; j < mHwModules[i]->mInputProfiles.size(); j++)
2706        {
2707            const sp<IOProfile> inProfile = mHwModules[i]->mInputProfiles[j];
2708
2709            if (inProfile->mSupportedDevices.isEmpty()) {
2710                ALOGW("Input profile contains no device on module %s", mHwModules[i]->mName);
2711                continue;
2712            }
2713
2714            audio_devices_t profileType = inProfile->mSupportedDevices[0]->mDeviceType;
2715            if (profileType & inputDeviceTypes) {
2716                sp<AudioInputDescriptor> inputDesc = new AudioInputDescriptor(inProfile);
2717
2718                inputDesc->mInputSource = AUDIO_SOURCE_MIC;
2719                inputDesc->mDevice = profileType;
2720
2721                audio_config_t config = AUDIO_CONFIG_INITIALIZER;
2722                config.sample_rate = inputDesc->mSamplingRate;
2723                config.channel_mask = inputDesc->mChannelMask;
2724                config.format = inputDesc->mFormat;
2725                audio_io_handle_t input = AUDIO_IO_HANDLE_NONE;
2726                status_t status = mpClientInterface->openInput(inProfile->mModule->mHandle,
2727                                                               &input,
2728                                                               &config,
2729                                                               &inputDesc->mDevice,
2730                                                               String8(""),
2731                                                               AUDIO_SOURCE_MIC,
2732                                                               AUDIO_INPUT_FLAG_NONE);
2733
2734                if (status == NO_ERROR) {
2735                    for (size_t k = 0; k  < inProfile->mSupportedDevices.size(); k++) {
2736                        audio_devices_t type = inProfile->mSupportedDevices[k]->mDeviceType;
2737                        ssize_t index =
2738                                mAvailableInputDevices.indexOf(inProfile->mSupportedDevices[k]);
2739                        // give a valid ID to an attached device once confirmed it is reachable
2740                        if ((index >= 0) && (mAvailableInputDevices[index]->mId == 0)) {
2741                            mAvailableInputDevices[index]->mId = nextUniqueId();
2742                            mAvailableInputDevices[index]->mModule = mHwModules[i];
2743                        }
2744                    }
2745                    mpClientInterface->closeInput(input);
2746                } else {
2747                    ALOGW("Cannot open input stream for device %08x on hw module %s",
2748                          inputDesc->mDevice,
2749                          mHwModules[i]->mName);
2750                }
2751            }
2752        }
2753    }
2754    // make sure all attached devices have been allocated a unique ID
2755    for (size_t i = 0; i  < mAvailableOutputDevices.size();) {
2756        if (mAvailableOutputDevices[i]->mId == 0) {
2757            ALOGW("Input device %08x unreachable", mAvailableOutputDevices[i]->mDeviceType);
2758            mAvailableOutputDevices.remove(mAvailableOutputDevices[i]);
2759            continue;
2760        }
2761        i++;
2762    }
2763    for (size_t i = 0; i  < mAvailableInputDevices.size();) {
2764        if (mAvailableInputDevices[i]->mId == 0) {
2765            ALOGW("Input device %08x unreachable", mAvailableInputDevices[i]->mDeviceType);
2766            mAvailableInputDevices.remove(mAvailableInputDevices[i]);
2767            continue;
2768        }
2769        i++;
2770    }
2771    // make sure default device is reachable
2772    if (mAvailableOutputDevices.indexOf(mDefaultOutputDevice) < 0) {
2773        ALOGE("Default device %08x is unreachable", mDefaultOutputDevice->mDeviceType);
2774    }
2775
2776    ALOGE_IF((mPrimaryOutput == 0), "Failed to open primary output");
2777
2778    updateDevicesAndOutputs();
2779
2780#ifdef AUDIO_POLICY_TEST
2781    if (mPrimaryOutput != 0) {
2782        AudioParameter outputCmd = AudioParameter();
2783        outputCmd.addInt(String8("set_id"), 0);
2784        mpClientInterface->setParameters(mPrimaryOutput, outputCmd.toString());
2785
2786        mTestDevice = AUDIO_DEVICE_OUT_SPEAKER;
2787        mTestSamplingRate = 44100;
2788        mTestFormat = AUDIO_FORMAT_PCM_16_BIT;
2789        mTestChannels =  AUDIO_CHANNEL_OUT_STEREO;
2790        mTestLatencyMs = 0;
2791        mCurOutput = 0;
2792        mDirectOutput = false;
2793        for (int i = 0; i < NUM_TEST_OUTPUTS; i++) {
2794            mTestOutputs[i] = 0;
2795        }
2796
2797        const size_t SIZE = 256;
2798        char buffer[SIZE];
2799        snprintf(buffer, SIZE, "AudioPolicyManagerTest");
2800        run(buffer, ANDROID_PRIORITY_AUDIO);
2801    }
2802#endif //AUDIO_POLICY_TEST
2803}
2804
2805AudioPolicyManager::~AudioPolicyManager()
2806{
2807#ifdef AUDIO_POLICY_TEST
2808    exit();
2809#endif //AUDIO_POLICY_TEST
2810   for (size_t i = 0; i < mOutputs.size(); i++) {
2811        mpClientInterface->closeOutput(mOutputs.keyAt(i));
2812   }
2813   for (size_t i = 0; i < mInputs.size(); i++) {
2814        mpClientInterface->closeInput(mInputs.keyAt(i));
2815   }
2816   mAvailableOutputDevices.clear();
2817   mAvailableInputDevices.clear();
2818   mOutputs.clear();
2819   mInputs.clear();
2820   mHwModules.clear();
2821}
2822
2823status_t AudioPolicyManager::initCheck()
2824{
2825    return (mPrimaryOutput == 0) ? NO_INIT : NO_ERROR;
2826}
2827
2828#ifdef AUDIO_POLICY_TEST
2829bool AudioPolicyManager::threadLoop()
2830{
2831    ALOGV("entering threadLoop()");
2832    while (!exitPending())
2833    {
2834        String8 command;
2835        int valueInt;
2836        String8 value;
2837
2838        Mutex::Autolock _l(mLock);
2839        mWaitWorkCV.waitRelative(mLock, milliseconds(50));
2840
2841        command = mpClientInterface->getParameters(0, String8("test_cmd_policy"));
2842        AudioParameter param = AudioParameter(command);
2843
2844        if (param.getInt(String8("test_cmd_policy"), valueInt) == NO_ERROR &&
2845            valueInt != 0) {
2846            ALOGV("Test command %s received", command.string());
2847            String8 target;
2848            if (param.get(String8("target"), target) != NO_ERROR) {
2849                target = "Manager";
2850            }
2851            if (param.getInt(String8("test_cmd_policy_output"), valueInt) == NO_ERROR) {
2852                param.remove(String8("test_cmd_policy_output"));
2853                mCurOutput = valueInt;
2854            }
2855            if (param.get(String8("test_cmd_policy_direct"), value) == NO_ERROR) {
2856                param.remove(String8("test_cmd_policy_direct"));
2857                if (value == "false") {
2858                    mDirectOutput = false;
2859                } else if (value == "true") {
2860                    mDirectOutput = true;
2861                }
2862            }
2863            if (param.getInt(String8("test_cmd_policy_input"), valueInt) == NO_ERROR) {
2864                param.remove(String8("test_cmd_policy_input"));
2865                mTestInput = valueInt;
2866            }
2867
2868            if (param.get(String8("test_cmd_policy_format"), value) == NO_ERROR) {
2869                param.remove(String8("test_cmd_policy_format"));
2870                int format = AUDIO_FORMAT_INVALID;
2871                if (value == "PCM 16 bits") {
2872                    format = AUDIO_FORMAT_PCM_16_BIT;
2873                } else if (value == "PCM 8 bits") {
2874                    format = AUDIO_FORMAT_PCM_8_BIT;
2875                } else if (value == "Compressed MP3") {
2876                    format = AUDIO_FORMAT_MP3;
2877                }
2878                if (format != AUDIO_FORMAT_INVALID) {
2879                    if (target == "Manager") {
2880                        mTestFormat = format;
2881                    } else if (mTestOutputs[mCurOutput] != 0) {
2882                        AudioParameter outputParam = AudioParameter();
2883                        outputParam.addInt(String8("format"), format);
2884                        mpClientInterface->setParameters(mTestOutputs[mCurOutput], outputParam.toString());
2885                    }
2886                }
2887            }
2888            if (param.get(String8("test_cmd_policy_channels"), value) == NO_ERROR) {
2889                param.remove(String8("test_cmd_policy_channels"));
2890                int channels = 0;
2891
2892                if (value == "Channels Stereo") {
2893                    channels =  AUDIO_CHANNEL_OUT_STEREO;
2894                } else if (value == "Channels Mono") {
2895                    channels =  AUDIO_CHANNEL_OUT_MONO;
2896                }
2897                if (channels != 0) {
2898                    if (target == "Manager") {
2899                        mTestChannels = channels;
2900                    } else if (mTestOutputs[mCurOutput] != 0) {
2901                        AudioParameter outputParam = AudioParameter();
2902                        outputParam.addInt(String8("channels"), channels);
2903                        mpClientInterface->setParameters(mTestOutputs[mCurOutput], outputParam.toString());
2904                    }
2905                }
2906            }
2907            if (param.getInt(String8("test_cmd_policy_sampleRate"), valueInt) == NO_ERROR) {
2908                param.remove(String8("test_cmd_policy_sampleRate"));
2909                if (valueInt >= 0 && valueInt <= 96000) {
2910                    int samplingRate = valueInt;
2911                    if (target == "Manager") {
2912                        mTestSamplingRate = samplingRate;
2913                    } else if (mTestOutputs[mCurOutput] != 0) {
2914                        AudioParameter outputParam = AudioParameter();
2915                        outputParam.addInt(String8("sampling_rate"), samplingRate);
2916                        mpClientInterface->setParameters(mTestOutputs[mCurOutput], outputParam.toString());
2917                    }
2918                }
2919            }
2920
2921            if (param.get(String8("test_cmd_policy_reopen"), value) == NO_ERROR) {
2922                param.remove(String8("test_cmd_policy_reopen"));
2923
2924                sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(mPrimaryOutput);
2925                mpClientInterface->closeOutput(mPrimaryOutput);
2926
2927                audio_module_handle_t moduleHandle = outputDesc->mModule->mHandle;
2928
2929                mOutputs.removeItem(mPrimaryOutput);
2930
2931                sp<AudioOutputDescriptor> outputDesc = new AudioOutputDescriptor(NULL);
2932                outputDesc->mDevice = AUDIO_DEVICE_OUT_SPEAKER;
2933                audio_config_t config = AUDIO_CONFIG_INITIALIZER;
2934                config.sample_rate = outputDesc->mSamplingRate;
2935                config.channel_mask = outputDesc->mChannelMask;
2936                config.format = outputDesc->mFormat;
2937                status_t status = mpClientInterface->openOutput(moduleHandle,
2938                                                                &mPrimaryOutput,
2939                                                                &config,
2940                                                                &outputDesc->mDevice,
2941                                                                String8(""),
2942                                                                &outputDesc->mLatency,
2943                                                                outputDesc->mFlags);
2944                if (status != NO_ERROR) {
2945                    ALOGE("Failed to reopen hardware output stream, "
2946                        "samplingRate: %d, format %d, channels %d",
2947                        outputDesc->mSamplingRate, outputDesc->mFormat, outputDesc->mChannelMask);
2948                } else {
2949                    outputDesc->mSamplingRate = config.sample_rate;
2950                    outputDesc->mChannelMask = config.channel_mask;
2951                    outputDesc->mFormat = config.format;
2952                    AudioParameter outputCmd = AudioParameter();
2953                    outputCmd.addInt(String8("set_id"), 0);
2954                    mpClientInterface->setParameters(mPrimaryOutput, outputCmd.toString());
2955                    addOutput(mPrimaryOutput, outputDesc);
2956                }
2957            }
2958
2959
2960            mpClientInterface->setParameters(0, String8("test_cmd_policy="));
2961        }
2962    }
2963    return false;
2964}
2965
2966void AudioPolicyManager::exit()
2967{
2968    {
2969        AutoMutex _l(mLock);
2970        requestExit();
2971        mWaitWorkCV.signal();
2972    }
2973    requestExitAndWait();
2974}
2975
2976int AudioPolicyManager::testOutputIndex(audio_io_handle_t output)
2977{
2978    for (int i = 0; i < NUM_TEST_OUTPUTS; i++) {
2979        if (output == mTestOutputs[i]) return i;
2980    }
2981    return 0;
2982}
2983#endif //AUDIO_POLICY_TEST
2984
2985// ---
2986
2987void AudioPolicyManager::addOutput(audio_io_handle_t output, sp<AudioOutputDescriptor> outputDesc)
2988{
2989    outputDesc->mIoHandle = output;
2990    outputDesc->mId = nextUniqueId();
2991    mOutputs.add(output, outputDesc);
2992    nextAudioPortGeneration();
2993}
2994
2995void AudioPolicyManager::addInput(audio_io_handle_t input, sp<AudioInputDescriptor> inputDesc)
2996{
2997    inputDesc->mIoHandle = input;
2998    inputDesc->mId = nextUniqueId();
2999    mInputs.add(input, inputDesc);
3000    nextAudioPortGeneration();
3001}
3002
3003void AudioPolicyManager::findIoHandlesByAddress(sp<AudioOutputDescriptor> desc /*in*/,
3004        const String8 address /*in*/,
3005        SortedVector<audio_io_handle_t>& outputs /*out*/) {
3006    // look for a match on the given address on the addresses of the outputs:
3007    // find the address by finding the patch that maps to this output
3008    ssize_t patchIdx = mAudioPatches.indexOfKey(desc->mPatchHandle);
3009    //ALOGV("    inspecting output %d (patch %d) for supported device=0x%x",
3010    //        outputIdx, patchIdx,  desc->mProfile->mSupportedDevices.types());
3011    if (patchIdx >= 0) {
3012        const sp<AudioPatch> patchDesc = mAudioPatches.valueAt(patchIdx);
3013        const int numSinks = patchDesc->mPatch.num_sinks;
3014        for (ssize_t j=0; j < numSinks; j++) {
3015            if (patchDesc->mPatch.sinks[j].type == AUDIO_PORT_TYPE_DEVICE) {
3016                const char* patchAddr =
3017                        patchDesc->mPatch.sinks[j].ext.device.address;
3018                if (strncmp(patchAddr,
3019                        address.string(), AUDIO_DEVICE_MAX_ADDRESS_LEN) == 0) {
3020                    ALOGV("findIoHandlesByAddress(): adding opened output %d on same address %s",
3021                            desc->mIoHandle,  patchDesc->mPatch.sinks[j].ext.device.address);
3022                    outputs.add(desc->mIoHandle);
3023                    break;
3024                }
3025            }
3026        }
3027    }
3028}
3029
3030status_t AudioPolicyManager::checkOutputsForDevice(const sp<DeviceDescriptor> devDesc,
3031                                                       audio_policy_dev_state_t state,
3032                                                       SortedVector<audio_io_handle_t>& outputs,
3033                                                       const String8 address)
3034{
3035    audio_devices_t device = devDesc->mDeviceType;
3036    sp<AudioOutputDescriptor> desc;
3037    // erase all current sample rates, formats and channel masks
3038    devDesc->clearCapabilities();
3039
3040    if (state == AUDIO_POLICY_DEVICE_STATE_AVAILABLE) {
3041        // first list already open outputs that can be routed to this device
3042        for (size_t i = 0; i < mOutputs.size(); i++) {
3043            desc = mOutputs.valueAt(i);
3044            if (!desc->isDuplicated() && (desc->mProfile->mSupportedDevices.types() & device)) {
3045                if (!deviceDistinguishesOnAddress(device)) {
3046                    ALOGV("checkOutputsForDevice(): adding opened output %d", mOutputs.keyAt(i));
3047                    outputs.add(mOutputs.keyAt(i));
3048                } else {
3049                    ALOGV("  checking address match due to device 0x%x", device);
3050                    findIoHandlesByAddress(desc, address, outputs);
3051                }
3052            }
3053        }
3054        // then look for output profiles that can be routed to this device
3055        SortedVector< sp<IOProfile> > profiles;
3056        for (size_t i = 0; i < mHwModules.size(); i++)
3057        {
3058            if (mHwModules[i]->mHandle == 0) {
3059                continue;
3060            }
3061            for (size_t j = 0; j < mHwModules[i]->mOutputProfiles.size(); j++)
3062            {
3063                if (mHwModules[i]->mOutputProfiles[j]->mSupportedDevices.types() & device) {
3064                    ALOGV("checkOutputsForDevice(): adding profile %zu from module %zu", j, i);
3065                    profiles.add(mHwModules[i]->mOutputProfiles[j]);
3066                }
3067            }
3068        }
3069
3070        ALOGV("  found %d profiles, %d outputs", profiles.size(), outputs.size());
3071
3072        if (profiles.isEmpty() && outputs.isEmpty()) {
3073            ALOGW("checkOutputsForDevice(): No output available for device %04x", device);
3074            return BAD_VALUE;
3075        }
3076
3077        // open outputs for matching profiles if needed. Direct outputs are also opened to
3078        // query for dynamic parameters and will be closed later by setDeviceConnectionState()
3079        for (ssize_t profile_index = 0; profile_index < (ssize_t)profiles.size(); profile_index++) {
3080            sp<IOProfile> profile = profiles[profile_index];
3081
3082            // nothing to do if one output is already opened for this profile
3083            size_t j;
3084            for (j = 0; j < outputs.size(); j++) {
3085                desc = mOutputs.valueFor(outputs.itemAt(j));
3086                if (!desc->isDuplicated() && desc->mProfile == profile) {
3087                    // matching profile: save the sample rates, format and channel masks supported
3088                    // by the profile in our device descriptor
3089                    devDesc->importAudioPort(profile);
3090                    break;
3091                }
3092            }
3093            if (j != outputs.size()) {
3094                continue;
3095            }
3096
3097            ALOGV("opening output for device %08x with params %s profile %p",
3098                                                      device, address.string(), profile.get());
3099            desc = new AudioOutputDescriptor(profile);
3100            desc->mDevice = device;
3101            audio_config_t config = AUDIO_CONFIG_INITIALIZER;
3102            config.sample_rate = desc->mSamplingRate;
3103            config.channel_mask = desc->mChannelMask;
3104            config.format = desc->mFormat;
3105            config.offload_info.sample_rate = desc->mSamplingRate;
3106            config.offload_info.channel_mask = desc->mChannelMask;
3107            config.offload_info.format = desc->mFormat;
3108            audio_io_handle_t output = AUDIO_IO_HANDLE_NONE;
3109            status_t status = mpClientInterface->openOutput(profile->mModule->mHandle,
3110                                                            &output,
3111                                                            &config,
3112                                                            &desc->mDevice,
3113                                                            address,
3114                                                            &desc->mLatency,
3115                                                            desc->mFlags);
3116            if (status == NO_ERROR) {
3117                desc->mSamplingRate = config.sample_rate;
3118                desc->mChannelMask = config.channel_mask;
3119                desc->mFormat = config.format;
3120
3121                // Here is where the out_set_parameters() for card & device gets called
3122                if (!address.isEmpty()) {
3123                    char *param = audio_device_address_to_parameter(device, address);
3124                    mpClientInterface->setParameters(output, String8(param));
3125                    free(param);
3126                }
3127
3128                // Here is where we step through and resolve any "dynamic" fields
3129                String8 reply;
3130                char *value;
3131                if (profile->mSamplingRates[0] == 0) {
3132                    reply = mpClientInterface->getParameters(output,
3133                                            String8(AUDIO_PARAMETER_STREAM_SUP_SAMPLING_RATES));
3134                    ALOGV("checkOutputsForDevice() supported sampling rates %s",
3135                              reply.string());
3136                    value = strpbrk((char *)reply.string(), "=");
3137                    if (value != NULL) {
3138                        profile->loadSamplingRates(value + 1);
3139                    }
3140                }
3141                if (profile->mFormats[0] == AUDIO_FORMAT_DEFAULT) {
3142                    reply = mpClientInterface->getParameters(output,
3143                                                   String8(AUDIO_PARAMETER_STREAM_SUP_FORMATS));
3144                    ALOGV("checkOutputsForDevice() supported formats %s",
3145                              reply.string());
3146                    value = strpbrk((char *)reply.string(), "=");
3147                    if (value != NULL) {
3148                        profile->loadFormats(value + 1);
3149                    }
3150                }
3151                if (profile->mChannelMasks[0] == 0) {
3152                    reply = mpClientInterface->getParameters(output,
3153                                                  String8(AUDIO_PARAMETER_STREAM_SUP_CHANNELS));
3154                    ALOGV("checkOutputsForDevice() supported channel masks %s",
3155                              reply.string());
3156                    value = strpbrk((char *)reply.string(), "=");
3157                    if (value != NULL) {
3158                        profile->loadOutChannels(value + 1);
3159                    }
3160                }
3161                if (((profile->mSamplingRates[0] == 0) &&
3162                         (profile->mSamplingRates.size() < 2)) ||
3163                     ((profile->mFormats[0] == AUDIO_FORMAT_DEFAULT) &&
3164                         (profile->mFormats.size() < 2)) ||
3165                     ((profile->mChannelMasks[0] == 0) &&
3166                         (profile->mChannelMasks.size() < 2))) {
3167                    ALOGW("checkOutputsForDevice() missing param");
3168                    mpClientInterface->closeOutput(output);
3169                    output = AUDIO_IO_HANDLE_NONE;
3170                } else if (profile->mSamplingRates[0] == 0 || profile->mFormats[0] == 0 ||
3171                            profile->mChannelMasks[0] == 0) {
3172                    mpClientInterface->closeOutput(output);
3173                    config.sample_rate = profile->pickSamplingRate();
3174                    config.channel_mask = profile->pickChannelMask();
3175                    config.format = profile->pickFormat();
3176                    config.offload_info.sample_rate = config.sample_rate;
3177                    config.offload_info.channel_mask = config.channel_mask;
3178                    config.offload_info.format = config.format;
3179                    status = mpClientInterface->openOutput(profile->mModule->mHandle,
3180                                                           &output,
3181                                                           &config,
3182                                                           &desc->mDevice,
3183                                                           address,
3184                                                           &desc->mLatency,
3185                                                           desc->mFlags);
3186                    if (status == NO_ERROR) {
3187                        desc->mSamplingRate = config.sample_rate;
3188                        desc->mChannelMask = config.channel_mask;
3189                        desc->mFormat = config.format;
3190                    } else {
3191                        output = AUDIO_IO_HANDLE_NONE;
3192                    }
3193                }
3194
3195                if (output != AUDIO_IO_HANDLE_NONE) {
3196                    addOutput(output, desc);
3197                    if ((desc->mFlags & AUDIO_OUTPUT_FLAG_DIRECT) == 0) {
3198                        audio_io_handle_t duplicatedOutput = AUDIO_IO_HANDLE_NONE;
3199
3200                        // set initial stream volume for device
3201                        applyStreamVolumes(output, device, 0, true);
3202
3203                        //TODO: configure audio effect output stage here
3204
3205                        // open a duplicating output thread for the new output and the primary output
3206                        duplicatedOutput = mpClientInterface->openDuplicateOutput(output,
3207                                                                                  mPrimaryOutput);
3208                        if (duplicatedOutput != AUDIO_IO_HANDLE_NONE) {
3209                            // add duplicated output descriptor
3210                            sp<AudioOutputDescriptor> dupOutputDesc =
3211                                    new AudioOutputDescriptor(NULL);
3212                            dupOutputDesc->mOutput1 = mOutputs.valueFor(mPrimaryOutput);
3213                            dupOutputDesc->mOutput2 = mOutputs.valueFor(output);
3214                            dupOutputDesc->mSamplingRate = desc->mSamplingRate;
3215                            dupOutputDesc->mFormat = desc->mFormat;
3216                            dupOutputDesc->mChannelMask = desc->mChannelMask;
3217                            dupOutputDesc->mLatency = desc->mLatency;
3218                            addOutput(duplicatedOutput, dupOutputDesc);
3219                            applyStreamVolumes(duplicatedOutput, device, 0, true);
3220                        } else {
3221                            ALOGW("checkOutputsForDevice() could not open dup output for %d and %d",
3222                                    mPrimaryOutput, output);
3223                            mpClientInterface->closeOutput(output);
3224                            mOutputs.removeItem(output);
3225                            nextAudioPortGeneration();
3226                            output = AUDIO_IO_HANDLE_NONE;
3227                        }
3228                    }
3229                }
3230            } else {
3231                output = AUDIO_IO_HANDLE_NONE;
3232            }
3233            if (output == AUDIO_IO_HANDLE_NONE) {
3234                ALOGW("checkOutputsForDevice() could not open output for device %x", device);
3235                profiles.removeAt(profile_index);
3236                profile_index--;
3237            } else {
3238                outputs.add(output);
3239                devDesc->importAudioPort(profile);
3240
3241                if (deviceDistinguishesOnAddress(device)) {
3242                    ALOGV("checkOutputsForDevice(): setOutputDevice(dev=0x%x, addr=%s)",
3243                            device, address.string());
3244                    setOutputDevice(output, device, true/*force*/, 0/*delay*/,
3245                            NULL/*patch handle*/, address.string());
3246                }
3247                ALOGV("checkOutputsForDevice(): adding output %d", output);
3248            }
3249        }
3250
3251        if (profiles.isEmpty()) {
3252            ALOGW("checkOutputsForDevice(): No output available for device %04x", device);
3253            return BAD_VALUE;
3254        }
3255    } else { // Disconnect
3256        // check if one opened output is not needed any more after disconnecting one device
3257        for (size_t i = 0; i < mOutputs.size(); i++) {
3258            desc = mOutputs.valueAt(i);
3259            if (!desc->isDuplicated()) {
3260                if  (!(desc->mProfile->mSupportedDevices.types()
3261                        & mAvailableOutputDevices.types())) {
3262                    ALOGV("checkOutputsForDevice(): disconnecting adding output %d",
3263                            mOutputs.keyAt(i));
3264                    outputs.add(mOutputs.keyAt(i));
3265                } else if (deviceDistinguishesOnAddress(device) &&
3266                        // exact match on device
3267                        (desc->mProfile->mSupportedDevices.types() == device)) {
3268                    findIoHandlesByAddress(desc, address, outputs);
3269                }
3270            }
3271        }
3272        // Clear any profiles associated with the disconnected device.
3273        for (size_t i = 0; i < mHwModules.size(); i++)
3274        {
3275            if (mHwModules[i]->mHandle == 0) {
3276                continue;
3277            }
3278            for (size_t j = 0; j < mHwModules[i]->mOutputProfiles.size(); j++)
3279            {
3280                sp<IOProfile> profile = mHwModules[i]->mOutputProfiles[j];
3281                if (profile->mSupportedDevices.types() & device) {
3282                    ALOGV("checkOutputsForDevice(): "
3283                            "clearing direct output profile %zu on module %zu", j, i);
3284                    if (profile->mSamplingRates[0] == 0) {
3285                        profile->mSamplingRates.clear();
3286                        profile->mSamplingRates.add(0);
3287                    }
3288                    if (profile->mFormats[0] == AUDIO_FORMAT_DEFAULT) {
3289                        profile->mFormats.clear();
3290                        profile->mFormats.add(AUDIO_FORMAT_DEFAULT);
3291                    }
3292                    if (profile->mChannelMasks[0] == 0) {
3293                        profile->mChannelMasks.clear();
3294                        profile->mChannelMasks.add(0);
3295                    }
3296                }
3297            }
3298        }
3299    }
3300    return NO_ERROR;
3301}
3302
3303status_t AudioPolicyManager::checkInputsForDevice(audio_devices_t device,
3304                                                      audio_policy_dev_state_t state,
3305                                                      SortedVector<audio_io_handle_t>& inputs,
3306                                                      const String8 address)
3307{
3308    sp<AudioInputDescriptor> desc;
3309    if (state == AUDIO_POLICY_DEVICE_STATE_AVAILABLE) {
3310        // first list already open inputs that can be routed to this device
3311        for (size_t input_index = 0; input_index < mInputs.size(); input_index++) {
3312            desc = mInputs.valueAt(input_index);
3313            if (desc->mProfile->mSupportedDevices.types() & (device & ~AUDIO_DEVICE_BIT_IN)) {
3314                ALOGV("checkInputsForDevice(): adding opened input %d", mInputs.keyAt(input_index));
3315               inputs.add(mInputs.keyAt(input_index));
3316            }
3317        }
3318
3319        // then look for input profiles that can be routed to this device
3320        SortedVector< sp<IOProfile> > profiles;
3321        for (size_t module_idx = 0; module_idx < mHwModules.size(); module_idx++)
3322        {
3323            if (mHwModules[module_idx]->mHandle == 0) {
3324                continue;
3325            }
3326            for (size_t profile_index = 0;
3327                 profile_index < mHwModules[module_idx]->mInputProfiles.size();
3328                 profile_index++)
3329            {
3330                if (mHwModules[module_idx]->mInputProfiles[profile_index]->mSupportedDevices.types()
3331                        & (device & ~AUDIO_DEVICE_BIT_IN)) {
3332                    ALOGV("checkInputsForDevice(): adding profile %zu from module %zu",
3333                          profile_index, module_idx);
3334                    profiles.add(mHwModules[module_idx]->mInputProfiles[profile_index]);
3335                }
3336            }
3337        }
3338
3339        if (profiles.isEmpty() && inputs.isEmpty()) {
3340            ALOGW("checkInputsForDevice(): No input available for device 0x%X", device);
3341            return BAD_VALUE;
3342        }
3343
3344        // open inputs for matching profiles if needed. Direct inputs are also opened to
3345        // query for dynamic parameters and will be closed later by setDeviceConnectionState()
3346        for (ssize_t profile_index = 0; profile_index < (ssize_t)profiles.size(); profile_index++) {
3347
3348            sp<IOProfile> profile = profiles[profile_index];
3349            // nothing to do if one input is already opened for this profile
3350            size_t input_index;
3351            for (input_index = 0; input_index < mInputs.size(); input_index++) {
3352                desc = mInputs.valueAt(input_index);
3353                if (desc->mProfile == profile) {
3354                    break;
3355                }
3356            }
3357            if (input_index != mInputs.size()) {
3358                continue;
3359            }
3360
3361            ALOGV("opening input for device 0x%X with params %s", device, address.string());
3362            desc = new AudioInputDescriptor(profile);
3363            desc->mDevice = device;
3364            audio_config_t config = AUDIO_CONFIG_INITIALIZER;
3365            config.sample_rate = desc->mSamplingRate;
3366            config.channel_mask = desc->mChannelMask;
3367            config.format = desc->mFormat;
3368            audio_io_handle_t input = AUDIO_IO_HANDLE_NONE;
3369            status_t status = mpClientInterface->openInput(profile->mModule->mHandle,
3370                                                           &input,
3371                                                           &config,
3372                                                           &desc->mDevice,
3373                                                           address,
3374                                                           AUDIO_SOURCE_MIC,
3375                                                           AUDIO_INPUT_FLAG_NONE /*FIXME*/);
3376
3377            if (status == NO_ERROR) {
3378                desc->mSamplingRate = config.sample_rate;
3379                desc->mChannelMask = config.channel_mask;
3380                desc->mFormat = config.format;
3381
3382                if (!address.isEmpty()) {
3383                    char *param = audio_device_address_to_parameter(device, address);
3384                    mpClientInterface->setParameters(input, String8(param));
3385                    free(param);
3386                }
3387
3388                // Here is where we step through and resolve any "dynamic" fields
3389                String8 reply;
3390                char *value;
3391                if (profile->mSamplingRates[0] == 0) {
3392                    reply = mpClientInterface->getParameters(input,
3393                                            String8(AUDIO_PARAMETER_STREAM_SUP_SAMPLING_RATES));
3394                    ALOGV("checkInputsForDevice() direct input sup sampling rates %s",
3395                              reply.string());
3396                    value = strpbrk((char *)reply.string(), "=");
3397                    if (value != NULL) {
3398                        profile->loadSamplingRates(value + 1);
3399                    }
3400                }
3401                if (profile->mFormats[0] == AUDIO_FORMAT_DEFAULT) {
3402                    reply = mpClientInterface->getParameters(input,
3403                                                   String8(AUDIO_PARAMETER_STREAM_SUP_FORMATS));
3404                    ALOGV("checkInputsForDevice() direct input sup formats %s", reply.string());
3405                    value = strpbrk((char *)reply.string(), "=");
3406                    if (value != NULL) {
3407                        profile->loadFormats(value + 1);
3408                    }
3409                }
3410                if (profile->mChannelMasks[0] == 0) {
3411                    reply = mpClientInterface->getParameters(input,
3412                                                  String8(AUDIO_PARAMETER_STREAM_SUP_CHANNELS));
3413                    ALOGV("checkInputsForDevice() direct input sup channel masks %s",
3414                              reply.string());
3415                    value = strpbrk((char *)reply.string(), "=");
3416                    if (value != NULL) {
3417                        profile->loadInChannels(value + 1);
3418                    }
3419                }
3420                if (((profile->mSamplingRates[0] == 0) && (profile->mSamplingRates.size() < 2)) ||
3421                     ((profile->mFormats[0] == 0) && (profile->mFormats.size() < 2)) ||
3422                     ((profile->mChannelMasks[0] == 0) && (profile->mChannelMasks.size() < 2))) {
3423                    ALOGW("checkInputsForDevice() direct input missing param");
3424                    mpClientInterface->closeInput(input);
3425                    input = AUDIO_IO_HANDLE_NONE;
3426                }
3427
3428                if (input != 0) {
3429                    addInput(input, desc);
3430                }
3431            } // endif input != 0
3432
3433            if (input == AUDIO_IO_HANDLE_NONE) {
3434                ALOGW("checkInputsForDevice() could not open input for device 0x%X", device);
3435                profiles.removeAt(profile_index);
3436                profile_index--;
3437            } else {
3438                inputs.add(input);
3439                ALOGV("checkInputsForDevice(): adding input %d", input);
3440            }
3441        } // end scan profiles
3442
3443        if (profiles.isEmpty()) {
3444            ALOGW("checkInputsForDevice(): No input available for device 0x%X", device);
3445            return BAD_VALUE;
3446        }
3447    } else {
3448        // Disconnect
3449        // check if one opened input is not needed any more after disconnecting one device
3450        for (size_t input_index = 0; input_index < mInputs.size(); input_index++) {
3451            desc = mInputs.valueAt(input_index);
3452            if (!(desc->mProfile->mSupportedDevices.types() & mAvailableInputDevices.types())) {
3453                ALOGV("checkInputsForDevice(): disconnecting adding input %d",
3454                      mInputs.keyAt(input_index));
3455                inputs.add(mInputs.keyAt(input_index));
3456            }
3457        }
3458        // Clear any profiles associated with the disconnected device.
3459        for (size_t module_index = 0; module_index < mHwModules.size(); module_index++) {
3460            if (mHwModules[module_index]->mHandle == 0) {
3461                continue;
3462            }
3463            for (size_t profile_index = 0;
3464                 profile_index < mHwModules[module_index]->mInputProfiles.size();
3465                 profile_index++) {
3466                sp<IOProfile> profile = mHwModules[module_index]->mInputProfiles[profile_index];
3467                if (profile->mSupportedDevices.types() & device) {
3468                    ALOGV("checkInputsForDevice(): clearing direct input profile %zu on module %zu",
3469                          profile_index, module_index);
3470                    if (profile->mSamplingRates[0] == 0) {
3471                        profile->mSamplingRates.clear();
3472                        profile->mSamplingRates.add(0);
3473                    }
3474                    if (profile->mFormats[0] == AUDIO_FORMAT_DEFAULT) {
3475                        profile->mFormats.clear();
3476                        profile->mFormats.add(AUDIO_FORMAT_DEFAULT);
3477                    }
3478                    if (profile->mChannelMasks[0] == 0) {
3479                        profile->mChannelMasks.clear();
3480                        profile->mChannelMasks.add(0);
3481                    }
3482                }
3483            }
3484        }
3485    } // end disconnect
3486
3487    return NO_ERROR;
3488}
3489
3490
3491void AudioPolicyManager::closeOutput(audio_io_handle_t output)
3492{
3493    ALOGV("closeOutput(%d)", output);
3494
3495    sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(output);
3496    if (outputDesc == NULL) {
3497        ALOGW("closeOutput() unknown output %d", output);
3498        return;
3499    }
3500
3501    // look for duplicated outputs connected to the output being removed.
3502    for (size_t i = 0; i < mOutputs.size(); i++) {
3503        sp<AudioOutputDescriptor> dupOutputDesc = mOutputs.valueAt(i);
3504        if (dupOutputDesc->isDuplicated() &&
3505                (dupOutputDesc->mOutput1 == outputDesc ||
3506                dupOutputDesc->mOutput2 == outputDesc)) {
3507            sp<AudioOutputDescriptor> outputDesc2;
3508            if (dupOutputDesc->mOutput1 == outputDesc) {
3509                outputDesc2 = dupOutputDesc->mOutput2;
3510            } else {
3511                outputDesc2 = dupOutputDesc->mOutput1;
3512            }
3513            // As all active tracks on duplicated output will be deleted,
3514            // and as they were also referenced on the other output, the reference
3515            // count for their stream type must be adjusted accordingly on
3516            // the other output.
3517            for (int j = 0; j < AUDIO_STREAM_CNT; j++) {
3518                int refCount = dupOutputDesc->mRefCount[j];
3519                outputDesc2->changeRefCount((audio_stream_type_t)j,-refCount);
3520            }
3521            audio_io_handle_t duplicatedOutput = mOutputs.keyAt(i);
3522            ALOGV("closeOutput() closing also duplicated output %d", duplicatedOutput);
3523
3524            mpClientInterface->closeOutput(duplicatedOutput);
3525            mOutputs.removeItem(duplicatedOutput);
3526        }
3527    }
3528
3529    nextAudioPortGeneration();
3530
3531    ssize_t index = mAudioPatches.indexOfKey(outputDesc->mPatchHandle);
3532    if (index >= 0) {
3533        sp<AudioPatch> patchDesc = mAudioPatches.valueAt(index);
3534        status_t status = mpClientInterface->releaseAudioPatch(patchDesc->mAfPatchHandle, 0);
3535        mAudioPatches.removeItemsAt(index);
3536        mpClientInterface->onAudioPatchListUpdate();
3537    }
3538
3539    AudioParameter param;
3540    param.add(String8("closing"), String8("true"));
3541    mpClientInterface->setParameters(output, param.toString());
3542
3543    mpClientInterface->closeOutput(output);
3544    mOutputs.removeItem(output);
3545    mPreviousOutputs = mOutputs;
3546}
3547
3548void AudioPolicyManager::closeInput(audio_io_handle_t input)
3549{
3550    ALOGV("closeInput(%d)", input);
3551
3552    sp<AudioInputDescriptor> inputDesc = mInputs.valueFor(input);
3553    if (inputDesc == NULL) {
3554        ALOGW("closeInput() unknown input %d", input);
3555        return;
3556    }
3557
3558    nextAudioPortGeneration();
3559
3560    ssize_t index = mAudioPatches.indexOfKey(inputDesc->mPatchHandle);
3561    if (index >= 0) {
3562        sp<AudioPatch> patchDesc = mAudioPatches.valueAt(index);
3563        status_t status = mpClientInterface->releaseAudioPatch(patchDesc->mAfPatchHandle, 0);
3564        mAudioPatches.removeItemsAt(index);
3565        mpClientInterface->onAudioPatchListUpdate();
3566    }
3567
3568    mpClientInterface->closeInput(input);
3569    mInputs.removeItem(input);
3570}
3571
3572SortedVector<audio_io_handle_t> AudioPolicyManager::getOutputsForDevice(audio_devices_t device,
3573                        DefaultKeyedVector<audio_io_handle_t, sp<AudioOutputDescriptor> > openOutputs)
3574{
3575    SortedVector<audio_io_handle_t> outputs;
3576
3577    ALOGVV("getOutputsForDevice() device %04x", device);
3578    for (size_t i = 0; i < openOutputs.size(); i++) {
3579        ALOGVV("output %d isDuplicated=%d device=%04x",
3580                i, openOutputs.valueAt(i)->isDuplicated(), openOutputs.valueAt(i)->supportedDevices());
3581        if ((device & openOutputs.valueAt(i)->supportedDevices()) == device) {
3582            ALOGVV("getOutputsForDevice() found output %d", openOutputs.keyAt(i));
3583            outputs.add(openOutputs.keyAt(i));
3584        }
3585    }
3586    return outputs;
3587}
3588
3589bool AudioPolicyManager::vectorsEqual(SortedVector<audio_io_handle_t>& outputs1,
3590                                   SortedVector<audio_io_handle_t>& outputs2)
3591{
3592    if (outputs1.size() != outputs2.size()) {
3593        return false;
3594    }
3595    for (size_t i = 0; i < outputs1.size(); i++) {
3596        if (outputs1[i] != outputs2[i]) {
3597            return false;
3598        }
3599    }
3600    return true;
3601}
3602
3603void AudioPolicyManager::checkOutputForStrategy(routing_strategy strategy)
3604{
3605    audio_devices_t oldDevice = getDeviceForStrategy(strategy, true /*fromCache*/);
3606    audio_devices_t newDevice = getDeviceForStrategy(strategy, false /*fromCache*/);
3607    SortedVector<audio_io_handle_t> srcOutputs = getOutputsForDevice(oldDevice, mPreviousOutputs);
3608    SortedVector<audio_io_handle_t> dstOutputs = getOutputsForDevice(newDevice, mOutputs);
3609
3610    if (!vectorsEqual(srcOutputs,dstOutputs)) {
3611        ALOGV("checkOutputForStrategy() strategy %d, moving from output %d to output %d",
3612              strategy, srcOutputs[0], dstOutputs[0]);
3613        // mute strategy while moving tracks from one output to another
3614        for (size_t i = 0; i < srcOutputs.size(); i++) {
3615            sp<AudioOutputDescriptor> desc = mOutputs.valueFor(srcOutputs[i]);
3616            if (desc->isStrategyActive(strategy)) {
3617                setStrategyMute(strategy, true, srcOutputs[i]);
3618                setStrategyMute(strategy, false, srcOutputs[i], MUTE_TIME_MS, newDevice);
3619            }
3620        }
3621
3622        // Move effects associated to this strategy from previous output to new output
3623        if (strategy == STRATEGY_MEDIA) {
3624            audio_io_handle_t fxOutput = selectOutputForEffects(dstOutputs);
3625            SortedVector<audio_io_handle_t> moved;
3626            for (size_t i = 0; i < mEffects.size(); i++) {
3627                sp<EffectDescriptor> effectDesc = mEffects.valueAt(i);
3628                if (effectDesc->mSession == AUDIO_SESSION_OUTPUT_MIX &&
3629                        effectDesc->mIo != fxOutput) {
3630                    if (moved.indexOf(effectDesc->mIo) < 0) {
3631                        ALOGV("checkOutputForStrategy() moving effect %d to output %d",
3632                              mEffects.keyAt(i), fxOutput);
3633                        mpClientInterface->moveEffects(AUDIO_SESSION_OUTPUT_MIX, effectDesc->mIo,
3634                                                       fxOutput);
3635                        moved.add(effectDesc->mIo);
3636                    }
3637                    effectDesc->mIo = fxOutput;
3638                }
3639            }
3640        }
3641        // Move tracks associated to this strategy from previous output to new output
3642        for (int i = 0; i < AUDIO_STREAM_CNT; i++) {
3643            if (getStrategy((audio_stream_type_t)i) == strategy) {
3644                mpClientInterface->invalidateStream((audio_stream_type_t)i);
3645            }
3646        }
3647    }
3648}
3649
3650void AudioPolicyManager::checkOutputForAllStrategies()
3651{
3652    checkOutputForStrategy(STRATEGY_ENFORCED_AUDIBLE);
3653    checkOutputForStrategy(STRATEGY_PHONE);
3654    checkOutputForStrategy(STRATEGY_SONIFICATION);
3655    checkOutputForStrategy(STRATEGY_SONIFICATION_RESPECTFUL);
3656    checkOutputForStrategy(STRATEGY_MEDIA);
3657    checkOutputForStrategy(STRATEGY_DTMF);
3658}
3659
3660audio_io_handle_t AudioPolicyManager::getA2dpOutput()
3661{
3662    for (size_t i = 0; i < mOutputs.size(); i++) {
3663        sp<AudioOutputDescriptor> outputDesc = mOutputs.valueAt(i);
3664        if (!outputDesc->isDuplicated() && outputDesc->device() & AUDIO_DEVICE_OUT_ALL_A2DP) {
3665            return mOutputs.keyAt(i);
3666        }
3667    }
3668
3669    return 0;
3670}
3671
3672void AudioPolicyManager::checkA2dpSuspend()
3673{
3674    audio_io_handle_t a2dpOutput = getA2dpOutput();
3675    if (a2dpOutput == 0) {
3676        mA2dpSuspended = false;
3677        return;
3678    }
3679
3680    bool isScoConnected =
3681            (mAvailableInputDevices.types() & AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET) != 0;
3682    // suspend A2DP output if:
3683    //      (NOT already suspended) &&
3684    //      ((SCO device is connected &&
3685    //       (forced usage for communication || for record is SCO))) ||
3686    //      (phone state is ringing || in call)
3687    //
3688    // restore A2DP output if:
3689    //      (Already suspended) &&
3690    //      ((SCO device is NOT connected ||
3691    //       (forced usage NOT for communication && NOT for record is SCO))) &&
3692    //      (phone state is NOT ringing && NOT in call)
3693    //
3694    if (mA2dpSuspended) {
3695        if ((!isScoConnected ||
3696             ((mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION] != AUDIO_POLICY_FORCE_BT_SCO) &&
3697              (mForceUse[AUDIO_POLICY_FORCE_FOR_RECORD] != AUDIO_POLICY_FORCE_BT_SCO))) &&
3698             ((mPhoneState != AUDIO_MODE_IN_CALL) &&
3699              (mPhoneState != AUDIO_MODE_RINGTONE))) {
3700
3701            mpClientInterface->restoreOutput(a2dpOutput);
3702            mA2dpSuspended = false;
3703        }
3704    } else {
3705        if ((isScoConnected &&
3706             ((mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION] == AUDIO_POLICY_FORCE_BT_SCO) ||
3707              (mForceUse[AUDIO_POLICY_FORCE_FOR_RECORD] == AUDIO_POLICY_FORCE_BT_SCO))) ||
3708             ((mPhoneState == AUDIO_MODE_IN_CALL) ||
3709              (mPhoneState == AUDIO_MODE_RINGTONE))) {
3710
3711            mpClientInterface->suspendOutput(a2dpOutput);
3712            mA2dpSuspended = true;
3713        }
3714    }
3715}
3716
3717audio_devices_t AudioPolicyManager::getNewOutputDevice(audio_io_handle_t output, bool fromCache)
3718{
3719    audio_devices_t device = AUDIO_DEVICE_NONE;
3720
3721    sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(output);
3722
3723    ssize_t index = mAudioPatches.indexOfKey(outputDesc->mPatchHandle);
3724    if (index >= 0) {
3725        sp<AudioPatch> patchDesc = mAudioPatches.valueAt(index);
3726        if (patchDesc->mUid != mUidCached) {
3727            ALOGV("getNewOutputDevice() device %08x forced by patch %d",
3728                  outputDesc->device(), outputDesc->mPatchHandle);
3729            return outputDesc->device();
3730        }
3731    }
3732
3733    // check the following by order of priority to request a routing change if necessary:
3734    // 1: the strategy enforced audible is active on the output:
3735    //      use device for strategy enforced audible
3736    // 2: we are in call or the strategy phone is active on the output:
3737    //      use device for strategy phone
3738    // 3: the strategy sonification is active on the output:
3739    //      use device for strategy sonification
3740    // 4: the strategy "respectful" sonification is active on the output:
3741    //      use device for strategy "respectful" sonification
3742    // 5: the strategy media is active on the output:
3743    //      use device for strategy media
3744    // 6: the strategy DTMF is active on the output:
3745    //      use device for strategy DTMF
3746    if (outputDesc->isStrategyActive(STRATEGY_ENFORCED_AUDIBLE)) {
3747        device = getDeviceForStrategy(STRATEGY_ENFORCED_AUDIBLE, fromCache);
3748    } else if (isInCall() ||
3749                    outputDesc->isStrategyActive(STRATEGY_PHONE)) {
3750        device = getDeviceForStrategy(STRATEGY_PHONE, fromCache);
3751    } else if (outputDesc->isStrategyActive(STRATEGY_SONIFICATION)) {
3752        device = getDeviceForStrategy(STRATEGY_SONIFICATION, fromCache);
3753    } else if (outputDesc->isStrategyActive(STRATEGY_SONIFICATION_RESPECTFUL)) {
3754        device = getDeviceForStrategy(STRATEGY_SONIFICATION_RESPECTFUL, fromCache);
3755    } else if (outputDesc->isStrategyActive(STRATEGY_MEDIA)) {
3756        device = getDeviceForStrategy(STRATEGY_MEDIA, fromCache);
3757    } else if (outputDesc->isStrategyActive(STRATEGY_DTMF)) {
3758        device = getDeviceForStrategy(STRATEGY_DTMF, fromCache);
3759    }
3760
3761    ALOGV("getNewOutputDevice() selected device %x", device);
3762    return device;
3763}
3764
3765audio_devices_t AudioPolicyManager::getNewInputDevice(audio_io_handle_t input)
3766{
3767    sp<AudioInputDescriptor> inputDesc = mInputs.valueFor(input);
3768
3769    ssize_t index = mAudioPatches.indexOfKey(inputDesc->mPatchHandle);
3770    if (index >= 0) {
3771        sp<AudioPatch> patchDesc = mAudioPatches.valueAt(index);
3772        if (patchDesc->mUid != mUidCached) {
3773            ALOGV("getNewInputDevice() device %08x forced by patch %d",
3774                  inputDesc->mDevice, inputDesc->mPatchHandle);
3775            return inputDesc->mDevice;
3776        }
3777    }
3778
3779    audio_devices_t device = getDeviceForInputSource(inputDesc->mInputSource);
3780
3781    ALOGV("getNewInputDevice() selected device %x", device);
3782    return device;
3783}
3784
3785uint32_t AudioPolicyManager::getStrategyForStream(audio_stream_type_t stream) {
3786    return (uint32_t)getStrategy(stream);
3787}
3788
3789audio_devices_t AudioPolicyManager::getDevicesForStream(audio_stream_type_t stream) {
3790    // By checking the range of stream before calling getStrategy, we avoid
3791    // getStrategy's behavior for invalid streams.  getStrategy would do a ALOGE
3792    // and then return STRATEGY_MEDIA, but we want to return the empty set.
3793    if (stream < (audio_stream_type_t) 0 || stream >= AUDIO_STREAM_CNT) {
3794        return AUDIO_DEVICE_NONE;
3795    }
3796    audio_devices_t devices;
3797    AudioPolicyManager::routing_strategy strategy = getStrategy(stream);
3798    devices = getDeviceForStrategy(strategy, true /*fromCache*/);
3799    SortedVector<audio_io_handle_t> outputs = getOutputsForDevice(devices, mOutputs);
3800    for (size_t i = 0; i < outputs.size(); i++) {
3801        sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(outputs[i]);
3802        if (outputDesc->isStrategyActive(strategy)) {
3803            devices = outputDesc->device();
3804            break;
3805        }
3806    }
3807    return devices;
3808}
3809
3810AudioPolicyManager::routing_strategy AudioPolicyManager::getStrategy(
3811        audio_stream_type_t stream) {
3812    // stream to strategy mapping
3813    switch (stream) {
3814    case AUDIO_STREAM_VOICE_CALL:
3815    case AUDIO_STREAM_BLUETOOTH_SCO:
3816        return STRATEGY_PHONE;
3817    case AUDIO_STREAM_RING:
3818    case AUDIO_STREAM_ALARM:
3819        return STRATEGY_SONIFICATION;
3820    case AUDIO_STREAM_NOTIFICATION:
3821        return STRATEGY_SONIFICATION_RESPECTFUL;
3822    case AUDIO_STREAM_DTMF:
3823        return STRATEGY_DTMF;
3824    default:
3825        ALOGE("unknown stream type");
3826    case AUDIO_STREAM_SYSTEM:
3827        // NOTE: SYSTEM stream uses MEDIA strategy because muting music and switching outputs
3828        // while key clicks are played produces a poor result
3829    case AUDIO_STREAM_TTS:
3830    case AUDIO_STREAM_MUSIC:
3831        return STRATEGY_MEDIA;
3832    case AUDIO_STREAM_ENFORCED_AUDIBLE:
3833        return STRATEGY_ENFORCED_AUDIBLE;
3834    }
3835}
3836
3837uint32_t AudioPolicyManager::getStrategyForAttr(const audio_attributes_t *attr) {
3838    // flags to strategy mapping
3839    if ((attr->flags & AUDIO_FLAG_AUDIBILITY_ENFORCED) == AUDIO_FLAG_AUDIBILITY_ENFORCED) {
3840        return (uint32_t) STRATEGY_ENFORCED_AUDIBLE;
3841    }
3842
3843    // usage to strategy mapping
3844    switch (attr->usage) {
3845    case AUDIO_USAGE_MEDIA:
3846    case AUDIO_USAGE_GAME:
3847    case AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY:
3848    case AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE:
3849    case AUDIO_USAGE_ASSISTANCE_SONIFICATION:
3850        return (uint32_t) STRATEGY_MEDIA;
3851
3852    case AUDIO_USAGE_VOICE_COMMUNICATION:
3853        return (uint32_t) STRATEGY_PHONE;
3854
3855    case AUDIO_USAGE_VOICE_COMMUNICATION_SIGNALLING:
3856        return (uint32_t) STRATEGY_DTMF;
3857
3858    case AUDIO_USAGE_ALARM:
3859    case AUDIO_USAGE_NOTIFICATION_TELEPHONY_RINGTONE:
3860        return (uint32_t) STRATEGY_SONIFICATION;
3861
3862    case AUDIO_USAGE_NOTIFICATION:
3863    case AUDIO_USAGE_NOTIFICATION_COMMUNICATION_REQUEST:
3864    case AUDIO_USAGE_NOTIFICATION_COMMUNICATION_INSTANT:
3865    case AUDIO_USAGE_NOTIFICATION_COMMUNICATION_DELAYED:
3866    case AUDIO_USAGE_NOTIFICATION_EVENT:
3867        return (uint32_t) STRATEGY_SONIFICATION_RESPECTFUL;
3868
3869    case AUDIO_USAGE_UNKNOWN:
3870    default:
3871        return (uint32_t) STRATEGY_MEDIA;
3872    }
3873}
3874
3875void AudioPolicyManager::handleNotificationRoutingForStream(audio_stream_type_t stream) {
3876    switch(stream) {
3877    case AUDIO_STREAM_MUSIC:
3878        checkOutputForStrategy(STRATEGY_SONIFICATION_RESPECTFUL);
3879        updateDevicesAndOutputs();
3880        break;
3881    default:
3882        break;
3883    }
3884}
3885
3886audio_devices_t AudioPolicyManager::getDeviceForStrategy(routing_strategy strategy,
3887                                                             bool fromCache)
3888{
3889    uint32_t device = AUDIO_DEVICE_NONE;
3890
3891    if (fromCache) {
3892        ALOGVV("getDeviceForStrategy() from cache strategy %d, device %x",
3893              strategy, mDeviceForStrategy[strategy]);
3894        return mDeviceForStrategy[strategy];
3895    }
3896    audio_devices_t availableOutputDeviceTypes = mAvailableOutputDevices.types();
3897    switch (strategy) {
3898
3899    case STRATEGY_SONIFICATION_RESPECTFUL:
3900        if (isInCall()) {
3901            device = getDeviceForStrategy(STRATEGY_SONIFICATION, false /*fromCache*/);
3902        } else if (isStreamActiveRemotely(AUDIO_STREAM_MUSIC,
3903                SONIFICATION_RESPECTFUL_AFTER_MUSIC_DELAY)) {
3904            // while media is playing on a remote device, use the the sonification behavior.
3905            // Note that we test this usecase before testing if media is playing because
3906            //   the isStreamActive() method only informs about the activity of a stream, not
3907            //   if it's for local playback. Note also that we use the same delay between both tests
3908            device = getDeviceForStrategy(STRATEGY_SONIFICATION, false /*fromCache*/);
3909        } else if (isStreamActive(AUDIO_STREAM_MUSIC, SONIFICATION_RESPECTFUL_AFTER_MUSIC_DELAY)) {
3910            // while media is playing (or has recently played), use the same device
3911            device = getDeviceForStrategy(STRATEGY_MEDIA, false /*fromCache*/);
3912        } else {
3913            // when media is not playing anymore, fall back on the sonification behavior
3914            device = getDeviceForStrategy(STRATEGY_SONIFICATION, false /*fromCache*/);
3915        }
3916
3917        break;
3918
3919    case STRATEGY_DTMF:
3920        if (!isInCall()) {
3921            // when off call, DTMF strategy follows the same rules as MEDIA strategy
3922            device = getDeviceForStrategy(STRATEGY_MEDIA, false /*fromCache*/);
3923            break;
3924        }
3925        // when in call, DTMF and PHONE strategies follow the same rules
3926        // FALL THROUGH
3927
3928    case STRATEGY_PHONE:
3929        // Force use of only devices on primary output if:
3930        // - in call AND
3931        //   - cannot route from voice call RX OR
3932        //   - audio HAL version is < 3.0 and TX device is on the primary HW module
3933        if (mPhoneState == AUDIO_MODE_IN_CALL) {
3934            audio_devices_t txDevice = getDeviceForInputSource(AUDIO_SOURCE_VOICE_COMMUNICATION);
3935            sp<AudioOutputDescriptor> hwOutputDesc = mOutputs.valueFor(mPrimaryOutput);
3936            if (((mAvailableInputDevices.types() &
3937                    AUDIO_DEVICE_IN_TELEPHONY_RX & ~AUDIO_DEVICE_BIT_IN) == 0) ||
3938                    (((txDevice & availablePrimaryInputDevices() & ~AUDIO_DEVICE_BIT_IN) != 0) &&
3939                         (hwOutputDesc->getAudioPort()->mModule->mHalVersion <
3940                             AUDIO_DEVICE_API_VERSION_3_0))) {
3941                availableOutputDeviceTypes = availablePrimaryOutputDevices();
3942            }
3943        }
3944        // for phone strategy, we first consider the forced use and then the available devices by order
3945        // of priority
3946        switch (mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION]) {
3947        case AUDIO_POLICY_FORCE_BT_SCO:
3948            if (!isInCall() || strategy != STRATEGY_DTMF) {
3949                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT;
3950                if (device) break;
3951            }
3952            device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET;
3953            if (device) break;
3954            device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_SCO;
3955            if (device) break;
3956            // if SCO device is requested but no SCO device is available, fall back to default case
3957            // FALL THROUGH
3958
3959        default:    // FORCE_NONE
3960            // when not in a phone call, phone strategy should route STREAM_VOICE_CALL to A2DP
3961            if (!isInCall() &&
3962                    (mForceUse[AUDIO_POLICY_FORCE_FOR_MEDIA] != AUDIO_POLICY_FORCE_NO_BT_A2DP) &&
3963                    (getA2dpOutput() != 0) && !mA2dpSuspended) {
3964                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP;
3965                if (device) break;
3966                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES;
3967                if (device) break;
3968            }
3969            device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_WIRED_HEADPHONE;
3970            if (device) break;
3971            device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_WIRED_HEADSET;
3972            if (device) break;
3973            device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_DEVICE;
3974            if (device) break;
3975            if (mPhoneState != AUDIO_MODE_IN_CALL) {
3976                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_ACCESSORY;
3977                if (device) break;
3978                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET;
3979                if (device) break;
3980                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_AUX_DIGITAL;
3981                if (device) break;
3982                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET;
3983                if (device) break;
3984            }
3985            device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_EARPIECE;
3986            if (device) break;
3987            device = mDefaultOutputDevice->mDeviceType;
3988            if (device == AUDIO_DEVICE_NONE) {
3989                ALOGE("getDeviceForStrategy() no device found for STRATEGY_PHONE");
3990            }
3991            break;
3992
3993        case AUDIO_POLICY_FORCE_SPEAKER:
3994            // when not in a phone call, phone strategy should route STREAM_VOICE_CALL to
3995            // A2DP speaker when forcing to speaker output
3996            if (!isInCall() &&
3997                    (mForceUse[AUDIO_POLICY_FORCE_FOR_MEDIA] != AUDIO_POLICY_FORCE_NO_BT_A2DP) &&
3998                    (getA2dpOutput() != 0) && !mA2dpSuspended) {
3999                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER;
4000                if (device) break;
4001            }
4002            if (mPhoneState != AUDIO_MODE_IN_CALL) {
4003                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_ACCESSORY;
4004                if (device) break;
4005                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_DEVICE;
4006                if (device) break;
4007                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET;
4008                if (device) break;
4009                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_AUX_DIGITAL;
4010                if (device) break;
4011                device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET;
4012                if (device) break;
4013            }
4014            device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_LINE;
4015            if (device) break;
4016            device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_SPEAKER;
4017            if (device) break;
4018            device = mDefaultOutputDevice->mDeviceType;
4019            if (device == AUDIO_DEVICE_NONE) {
4020                ALOGE("getDeviceForStrategy() no device found for STRATEGY_PHONE, FORCE_SPEAKER");
4021            }
4022            break;
4023        }
4024    break;
4025
4026    case STRATEGY_SONIFICATION:
4027
4028        // If incall, just select the STRATEGY_PHONE device: The rest of the behavior is handled by
4029        // handleIncallSonification().
4030        if (isInCall()) {
4031            device = getDeviceForStrategy(STRATEGY_PHONE, false /*fromCache*/);
4032            break;
4033        }
4034        // FALL THROUGH
4035
4036    case STRATEGY_ENFORCED_AUDIBLE:
4037        // strategy STRATEGY_ENFORCED_AUDIBLE uses same routing policy as STRATEGY_SONIFICATION
4038        // except:
4039        //   - when in call where it doesn't default to STRATEGY_PHONE behavior
4040        //   - in countries where not enforced in which case it follows STRATEGY_MEDIA
4041
4042        if ((strategy == STRATEGY_SONIFICATION) ||
4043                (mForceUse[AUDIO_POLICY_FORCE_FOR_SYSTEM] == AUDIO_POLICY_FORCE_SYSTEM_ENFORCED)) {
4044            device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_SPEAKER;
4045            if (device == AUDIO_DEVICE_NONE) {
4046                ALOGE("getDeviceForStrategy() speaker device not found for STRATEGY_SONIFICATION");
4047            }
4048        }
4049        // The second device used for sonification is the same as the device used by media strategy
4050        // FALL THROUGH
4051
4052    case STRATEGY_MEDIA: {
4053        uint32_t device2 = AUDIO_DEVICE_NONE;
4054        if (strategy != STRATEGY_SONIFICATION) {
4055            // no sonification on remote submix (e.g. WFD)
4056            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_REMOTE_SUBMIX;
4057        }
4058        if ((device2 == AUDIO_DEVICE_NONE) &&
4059                (mForceUse[AUDIO_POLICY_FORCE_FOR_MEDIA] != AUDIO_POLICY_FORCE_NO_BT_A2DP) &&
4060                (getA2dpOutput() != 0) && !mA2dpSuspended) {
4061            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP;
4062            if (device2 == AUDIO_DEVICE_NONE) {
4063                device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES;
4064            }
4065            if (device2 == AUDIO_DEVICE_NONE) {
4066                device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER;
4067            }
4068        }
4069        if (device2 == AUDIO_DEVICE_NONE) {
4070            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_WIRED_HEADPHONE;
4071        }
4072        if ((device2 == AUDIO_DEVICE_NONE)) {
4073            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_LINE;
4074        }
4075        if (device2 == AUDIO_DEVICE_NONE) {
4076            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_WIRED_HEADSET;
4077        }
4078        if (device2 == AUDIO_DEVICE_NONE) {
4079            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_ACCESSORY;
4080        }
4081        if (device2 == AUDIO_DEVICE_NONE) {
4082            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_DEVICE;
4083        }
4084        if (device2 == AUDIO_DEVICE_NONE) {
4085            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET;
4086        }
4087        if ((device2 == AUDIO_DEVICE_NONE) && (strategy != STRATEGY_SONIFICATION)) {
4088            // no sonification on aux digital (e.g. HDMI)
4089            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_AUX_DIGITAL;
4090        }
4091        if ((device2 == AUDIO_DEVICE_NONE) &&
4092                (mForceUse[AUDIO_POLICY_FORCE_FOR_DOCK] == AUDIO_POLICY_FORCE_ANALOG_DOCK)) {
4093            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET;
4094        }
4095        if (device2 == AUDIO_DEVICE_NONE) {
4096            device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_SPEAKER;
4097        }
4098        int device3 = AUDIO_DEVICE_NONE;
4099        if (strategy == STRATEGY_MEDIA) {
4100            // ARC, SPDIF and AUX_LINE can co-exist with others.
4101            device3 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_HDMI_ARC;
4102            device3 |= (availableOutputDeviceTypes & AUDIO_DEVICE_OUT_SPDIF);
4103            device3 |= (availableOutputDeviceTypes & AUDIO_DEVICE_OUT_AUX_LINE);
4104        }
4105
4106        device2 |= device3;
4107        // device is DEVICE_OUT_SPEAKER if we come from case STRATEGY_SONIFICATION or
4108        // STRATEGY_ENFORCED_AUDIBLE, AUDIO_DEVICE_NONE otherwise
4109        device |= device2;
4110
4111        // If hdmi system audio mode is on, remove speaker out of output list.
4112        if ((strategy == STRATEGY_MEDIA) &&
4113            (mForceUse[AUDIO_POLICY_FORCE_FOR_HDMI_SYSTEM_AUDIO] ==
4114                AUDIO_POLICY_FORCE_HDMI_SYSTEM_AUDIO_ENFORCED)) {
4115            device &= ~AUDIO_DEVICE_OUT_SPEAKER;
4116        }
4117
4118        if (device) break;
4119        device = mDefaultOutputDevice->mDeviceType;
4120        if (device == AUDIO_DEVICE_NONE) {
4121            ALOGE("getDeviceForStrategy() no device found for STRATEGY_MEDIA");
4122        }
4123        } break;
4124
4125    default:
4126        ALOGW("getDeviceForStrategy() unknown strategy: %d", strategy);
4127        break;
4128    }
4129
4130    ALOGVV("getDeviceForStrategy() strategy %d, device %x", strategy, device);
4131    return device;
4132}
4133
4134void AudioPolicyManager::updateDevicesAndOutputs()
4135{
4136    for (int i = 0; i < NUM_STRATEGIES; i++) {
4137        mDeviceForStrategy[i] = getDeviceForStrategy((routing_strategy)i, false /*fromCache*/);
4138    }
4139    mPreviousOutputs = mOutputs;
4140}
4141
4142uint32_t AudioPolicyManager::checkDeviceMuteStrategies(sp<AudioOutputDescriptor> outputDesc,
4143                                                       audio_devices_t prevDevice,
4144                                                       uint32_t delayMs)
4145{
4146    // mute/unmute strategies using an incompatible device combination
4147    // if muting, wait for the audio in pcm buffer to be drained before proceeding
4148    // if unmuting, unmute only after the specified delay
4149    if (outputDesc->isDuplicated()) {
4150        return 0;
4151    }
4152
4153    uint32_t muteWaitMs = 0;
4154    audio_devices_t device = outputDesc->device();
4155    bool shouldMute = outputDesc->isActive() && (popcount(device) >= 2);
4156
4157    for (size_t i = 0; i < NUM_STRATEGIES; i++) {
4158        audio_devices_t curDevice = getDeviceForStrategy((routing_strategy)i, false /*fromCache*/);
4159        bool mute = shouldMute && (curDevice & device) && (curDevice != device);
4160        bool doMute = false;
4161
4162        if (mute && !outputDesc->mStrategyMutedByDevice[i]) {
4163            doMute = true;
4164            outputDesc->mStrategyMutedByDevice[i] = true;
4165        } else if (!mute && outputDesc->mStrategyMutedByDevice[i]){
4166            doMute = true;
4167            outputDesc->mStrategyMutedByDevice[i] = false;
4168        }
4169        if (doMute) {
4170            for (size_t j = 0; j < mOutputs.size(); j++) {
4171                sp<AudioOutputDescriptor> desc = mOutputs.valueAt(j);
4172                // skip output if it does not share any device with current output
4173                if ((desc->supportedDevices() & outputDesc->supportedDevices())
4174                        == AUDIO_DEVICE_NONE) {
4175                    continue;
4176                }
4177                audio_io_handle_t curOutput = mOutputs.keyAt(j);
4178                ALOGVV("checkDeviceMuteStrategies() %s strategy %d (curDevice %04x) on output %d",
4179                      mute ? "muting" : "unmuting", i, curDevice, curOutput);
4180                setStrategyMute((routing_strategy)i, mute, curOutput, mute ? 0 : delayMs);
4181                if (desc->isStrategyActive((routing_strategy)i)) {
4182                    if (mute) {
4183                        // FIXME: should not need to double latency if volume could be applied
4184                        // immediately by the audioflinger mixer. We must account for the delay
4185                        // between now and the next time the audioflinger thread for this output
4186                        // will process a buffer (which corresponds to one buffer size,
4187                        // usually 1/2 or 1/4 of the latency).
4188                        if (muteWaitMs < desc->latency() * 2) {
4189                            muteWaitMs = desc->latency() * 2;
4190                        }
4191                    }
4192                }
4193            }
4194        }
4195    }
4196
4197    // temporary mute output if device selection changes to avoid volume bursts due to
4198    // different per device volumes
4199    if (outputDesc->isActive() && (device != prevDevice)) {
4200        if (muteWaitMs < outputDesc->latency() * 2) {
4201            muteWaitMs = outputDesc->latency() * 2;
4202        }
4203        for (size_t i = 0; i < NUM_STRATEGIES; i++) {
4204            if (outputDesc->isStrategyActive((routing_strategy)i)) {
4205                setStrategyMute((routing_strategy)i, true, outputDesc->mIoHandle);
4206                // do tempMute unmute after twice the mute wait time
4207                setStrategyMute((routing_strategy)i, false, outputDesc->mIoHandle,
4208                                muteWaitMs *2, device);
4209            }
4210        }
4211    }
4212
4213    // wait for the PCM output buffers to empty before proceeding with the rest of the command
4214    if (muteWaitMs > delayMs) {
4215        muteWaitMs -= delayMs;
4216        usleep(muteWaitMs * 1000);
4217        return muteWaitMs;
4218    }
4219    return 0;
4220}
4221
4222uint32_t AudioPolicyManager::setOutputDevice(audio_io_handle_t output,
4223                                             audio_devices_t device,
4224                                             bool force,
4225                                             int delayMs,
4226                                             audio_patch_handle_t *patchHandle,
4227                                             const char* address)
4228{
4229    ALOGV("setOutputDevice() output %d device %04x delayMs %d", output, device, delayMs);
4230    sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(output);
4231    AudioParameter param;
4232    uint32_t muteWaitMs;
4233
4234    if (outputDesc->isDuplicated()) {
4235        muteWaitMs = setOutputDevice(outputDesc->mOutput1->mIoHandle, device, force, delayMs);
4236        muteWaitMs += setOutputDevice(outputDesc->mOutput2->mIoHandle, device, force, delayMs);
4237        return muteWaitMs;
4238    }
4239    // no need to proceed if new device is not AUDIO_DEVICE_NONE and not supported by current
4240    // output profile
4241    if ((device != AUDIO_DEVICE_NONE) &&
4242            ((device & outputDesc->mProfile->mSupportedDevices.types()) == 0)) {
4243        return 0;
4244    }
4245
4246    // filter devices according to output selected
4247    device = (audio_devices_t)(device & outputDesc->mProfile->mSupportedDevices.types());
4248
4249    audio_devices_t prevDevice = outputDesc->mDevice;
4250
4251    ALOGV("setOutputDevice() prevDevice %04x", prevDevice);
4252
4253    if (device != AUDIO_DEVICE_NONE) {
4254        outputDesc->mDevice = device;
4255    }
4256    muteWaitMs = checkDeviceMuteStrategies(outputDesc, prevDevice, delayMs);
4257
4258    // Do not change the routing if:
4259    //  - the requested device is AUDIO_DEVICE_NONE
4260    //  - the requested device is the same as current device and force is not specified.
4261    // Doing this check here allows the caller to call setOutputDevice() without conditions
4262    if ((device == AUDIO_DEVICE_NONE || device == prevDevice) && !force) {
4263        ALOGV("setOutputDevice() setting same device %04x or null device for output %d", device, output);
4264        return muteWaitMs;
4265    }
4266
4267    ALOGV("setOutputDevice() changing device");
4268
4269    // do the routing
4270    if (device == AUDIO_DEVICE_NONE) {
4271        resetOutputDevice(output, delayMs, NULL);
4272    } else {
4273        DeviceVector deviceList = (address == NULL) ?
4274                mAvailableOutputDevices.getDevicesFromType(device)
4275                : mAvailableOutputDevices.getDevicesFromTypeAddr(device, String8(address));
4276        if (!deviceList.isEmpty()) {
4277            struct audio_patch patch;
4278            outputDesc->toAudioPortConfig(&patch.sources[0]);
4279            patch.num_sources = 1;
4280            patch.num_sinks = 0;
4281            for (size_t i = 0; i < deviceList.size() && i < AUDIO_PATCH_PORTS_MAX; i++) {
4282                deviceList.itemAt(i)->toAudioPortConfig(&patch.sinks[i]);
4283                patch.num_sinks++;
4284            }
4285            ssize_t index;
4286            if (patchHandle && *patchHandle != AUDIO_PATCH_HANDLE_NONE) {
4287                index = mAudioPatches.indexOfKey(*patchHandle);
4288            } else {
4289                index = mAudioPatches.indexOfKey(outputDesc->mPatchHandle);
4290            }
4291            sp< AudioPatch> patchDesc;
4292            audio_patch_handle_t afPatchHandle = AUDIO_PATCH_HANDLE_NONE;
4293            if (index >= 0) {
4294                patchDesc = mAudioPatches.valueAt(index);
4295                afPatchHandle = patchDesc->mAfPatchHandle;
4296            }
4297
4298            status_t status = mpClientInterface->createAudioPatch(&patch,
4299                                                                   &afPatchHandle,
4300                                                                   delayMs);
4301            ALOGV("setOutputDevice() createAudioPatch returned %d patchHandle %d"
4302                    "num_sources %d num_sinks %d",
4303                                       status, afPatchHandle, patch.num_sources, patch.num_sinks);
4304            if (status == NO_ERROR) {
4305                if (index < 0) {
4306                    patchDesc = new AudioPatch((audio_patch_handle_t)nextUniqueId(),
4307                                               &patch, mUidCached);
4308                    addAudioPatch(patchDesc->mHandle, patchDesc);
4309                } else {
4310                    patchDesc->mPatch = patch;
4311                }
4312                patchDesc->mAfPatchHandle = afPatchHandle;
4313                patchDesc->mUid = mUidCached;
4314                if (patchHandle) {
4315                    *patchHandle = patchDesc->mHandle;
4316                }
4317                outputDesc->mPatchHandle = patchDesc->mHandle;
4318                nextAudioPortGeneration();
4319                mpClientInterface->onAudioPatchListUpdate();
4320            }
4321        }
4322
4323        // inform all input as well
4324        for (size_t i = 0; i < mInputs.size(); i++) {
4325            const sp<AudioInputDescriptor>  inputDescriptor = mInputs.valueAt(i);
4326            if (!isVirtualInputDevice(inputDescriptor->mDevice)) {
4327                AudioParameter inputCmd = AudioParameter();
4328                ALOGV("%s: inform input %d of device:%d", __func__,
4329                      inputDescriptor->mIoHandle, device);
4330                inputCmd.addInt(String8(AudioParameter::keyRouting),device);
4331                mpClientInterface->setParameters(inputDescriptor->mIoHandle,
4332                                                 inputCmd.toString(),
4333                                                 delayMs);
4334            }
4335        }
4336    }
4337
4338    // update stream volumes according to new device
4339    applyStreamVolumes(output, device, delayMs);
4340
4341    return muteWaitMs;
4342}
4343
4344status_t AudioPolicyManager::resetOutputDevice(audio_io_handle_t output,
4345                                               int delayMs,
4346                                               audio_patch_handle_t *patchHandle)
4347{
4348    sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(output);
4349    ssize_t index;
4350    if (patchHandle) {
4351        index = mAudioPatches.indexOfKey(*patchHandle);
4352    } else {
4353        index = mAudioPatches.indexOfKey(outputDesc->mPatchHandle);
4354    }
4355    if (index < 0) {
4356        return INVALID_OPERATION;
4357    }
4358    sp< AudioPatch> patchDesc = mAudioPatches.valueAt(index);
4359    status_t status = mpClientInterface->releaseAudioPatch(patchDesc->mAfPatchHandle, delayMs);
4360    ALOGV("resetOutputDevice() releaseAudioPatch returned %d", status);
4361    outputDesc->mPatchHandle = 0;
4362    removeAudioPatch(patchDesc->mHandle);
4363    nextAudioPortGeneration();
4364    mpClientInterface->onAudioPatchListUpdate();
4365    return status;
4366}
4367
4368status_t AudioPolicyManager::setInputDevice(audio_io_handle_t input,
4369                                            audio_devices_t device,
4370                                            bool force,
4371                                            audio_patch_handle_t *patchHandle)
4372{
4373    status_t status = NO_ERROR;
4374
4375    sp<AudioInputDescriptor> inputDesc = mInputs.valueFor(input);
4376    if ((device != AUDIO_DEVICE_NONE) && ((device != inputDesc->mDevice) || force)) {
4377        inputDesc->mDevice = device;
4378
4379        DeviceVector deviceList = mAvailableInputDevices.getDevicesFromType(device);
4380        if (!deviceList.isEmpty()) {
4381            struct audio_patch patch;
4382            inputDesc->toAudioPortConfig(&patch.sinks[0]);
4383            // AUDIO_SOURCE_HOTWORD is for internal use only:
4384            // handled as AUDIO_SOURCE_VOICE_RECOGNITION by the audio HAL
4385            if (patch.sinks[0].ext.mix.usecase.source == AUDIO_SOURCE_HOTWORD &&
4386                    !inputDesc->mIsSoundTrigger) {
4387                patch.sinks[0].ext.mix.usecase.source = AUDIO_SOURCE_VOICE_RECOGNITION;
4388            }
4389            patch.num_sinks = 1;
4390            //only one input device for now
4391            deviceList.itemAt(0)->toAudioPortConfig(&patch.sources[0]);
4392            patch.num_sources = 1;
4393            ssize_t index;
4394            if (patchHandle && *patchHandle != AUDIO_PATCH_HANDLE_NONE) {
4395                index = mAudioPatches.indexOfKey(*patchHandle);
4396            } else {
4397                index = mAudioPatches.indexOfKey(inputDesc->mPatchHandle);
4398            }
4399            sp< AudioPatch> patchDesc;
4400            audio_patch_handle_t afPatchHandle = AUDIO_PATCH_HANDLE_NONE;
4401            if (index >= 0) {
4402                patchDesc = mAudioPatches.valueAt(index);
4403                afPatchHandle = patchDesc->mAfPatchHandle;
4404            }
4405
4406            status_t status = mpClientInterface->createAudioPatch(&patch,
4407                                                                  &afPatchHandle,
4408                                                                  0);
4409            ALOGV("setInputDevice() createAudioPatch returned %d patchHandle %d",
4410                                                                          status, afPatchHandle);
4411            if (status == NO_ERROR) {
4412                if (index < 0) {
4413                    patchDesc = new AudioPatch((audio_patch_handle_t)nextUniqueId(),
4414                                               &patch, mUidCached);
4415                    addAudioPatch(patchDesc->mHandle, patchDesc);
4416                } else {
4417                    patchDesc->mPatch = patch;
4418                }
4419                patchDesc->mAfPatchHandle = afPatchHandle;
4420                patchDesc->mUid = mUidCached;
4421                if (patchHandle) {
4422                    *patchHandle = patchDesc->mHandle;
4423                }
4424                inputDesc->mPatchHandle = patchDesc->mHandle;
4425                nextAudioPortGeneration();
4426                mpClientInterface->onAudioPatchListUpdate();
4427            }
4428        }
4429    }
4430    return status;
4431}
4432
4433status_t AudioPolicyManager::resetInputDevice(audio_io_handle_t input,
4434                                              audio_patch_handle_t *patchHandle)
4435{
4436    sp<AudioInputDescriptor> inputDesc = mInputs.valueFor(input);
4437    ssize_t index;
4438    if (patchHandle) {
4439        index = mAudioPatches.indexOfKey(*patchHandle);
4440    } else {
4441        index = mAudioPatches.indexOfKey(inputDesc->mPatchHandle);
4442    }
4443    if (index < 0) {
4444        return INVALID_OPERATION;
4445    }
4446    sp< AudioPatch> patchDesc = mAudioPatches.valueAt(index);
4447    status_t status = mpClientInterface->releaseAudioPatch(patchDesc->mAfPatchHandle, 0);
4448    ALOGV("resetInputDevice() releaseAudioPatch returned %d", status);
4449    inputDesc->mPatchHandle = 0;
4450    removeAudioPatch(patchDesc->mHandle);
4451    nextAudioPortGeneration();
4452    mpClientInterface->onAudioPatchListUpdate();
4453    return status;
4454}
4455
4456sp<AudioPolicyManager::IOProfile> AudioPolicyManager::getInputProfile(audio_devices_t device,
4457                                                   uint32_t& samplingRate,
4458                                                   audio_format_t format,
4459                                                   audio_channel_mask_t channelMask,
4460                                                   audio_input_flags_t flags)
4461{
4462    // Choose an input profile based on the requested capture parameters: select the first available
4463    // profile supporting all requested parameters.
4464
4465    for (size_t i = 0; i < mHwModules.size(); i++)
4466    {
4467        if (mHwModules[i]->mHandle == 0) {
4468            continue;
4469        }
4470        for (size_t j = 0; j < mHwModules[i]->mInputProfiles.size(); j++)
4471        {
4472            sp<IOProfile> profile = mHwModules[i]->mInputProfiles[j];
4473            // profile->log();
4474            if (profile->isCompatibleProfile(device, samplingRate,
4475                                             &samplingRate /*updatedSamplingRate*/,
4476                                             format, channelMask, (audio_output_flags_t) flags)) {
4477                return profile;
4478            }
4479        }
4480    }
4481    return NULL;
4482}
4483
4484audio_devices_t AudioPolicyManager::getDeviceForInputSource(audio_source_t inputSource)
4485{
4486    uint32_t device = AUDIO_DEVICE_NONE;
4487    audio_devices_t availableDeviceTypes = mAvailableInputDevices.types() &
4488                                            ~AUDIO_DEVICE_BIT_IN;
4489    switch (inputSource) {
4490    case AUDIO_SOURCE_VOICE_UPLINK:
4491      if (availableDeviceTypes & AUDIO_DEVICE_IN_VOICE_CALL) {
4492          device = AUDIO_DEVICE_IN_VOICE_CALL;
4493          break;
4494      }
4495      break;
4496
4497    case AUDIO_SOURCE_DEFAULT:
4498    case AUDIO_SOURCE_MIC:
4499    if (availableDeviceTypes & AUDIO_DEVICE_IN_BLUETOOTH_A2DP) {
4500        device = AUDIO_DEVICE_IN_BLUETOOTH_A2DP;
4501    } else if (availableDeviceTypes & AUDIO_DEVICE_IN_WIRED_HEADSET) {
4502        device = AUDIO_DEVICE_IN_WIRED_HEADSET;
4503    } else if (availableDeviceTypes & AUDIO_DEVICE_IN_USB_DEVICE) {
4504        device = AUDIO_DEVICE_IN_USB_DEVICE;
4505    } else if (availableDeviceTypes & AUDIO_DEVICE_IN_BUILTIN_MIC) {
4506        device = AUDIO_DEVICE_IN_BUILTIN_MIC;
4507    }
4508    break;
4509
4510    case AUDIO_SOURCE_VOICE_COMMUNICATION:
4511        // Allow only use of devices on primary input if in call and HAL does not support routing
4512        // to voice call path.
4513        if ((mPhoneState == AUDIO_MODE_IN_CALL) &&
4514                (mAvailableOutputDevices.types() & AUDIO_DEVICE_OUT_TELEPHONY_TX) == 0) {
4515            availableDeviceTypes = availablePrimaryInputDevices() & ~AUDIO_DEVICE_BIT_IN;
4516        }
4517
4518        switch (mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION]) {
4519        case AUDIO_POLICY_FORCE_BT_SCO:
4520            // if SCO device is requested but no SCO device is available, fall back to default case
4521            if (availableDeviceTypes & AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET) {
4522                device = AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET;
4523                break;
4524            }
4525            // FALL THROUGH
4526
4527        default:    // FORCE_NONE
4528            if (availableDeviceTypes & AUDIO_DEVICE_IN_WIRED_HEADSET) {
4529                device = AUDIO_DEVICE_IN_WIRED_HEADSET;
4530            } else if (availableDeviceTypes & AUDIO_DEVICE_IN_USB_DEVICE) {
4531                device = AUDIO_DEVICE_IN_USB_DEVICE;
4532            } else if (availableDeviceTypes & AUDIO_DEVICE_IN_BUILTIN_MIC) {
4533                device = AUDIO_DEVICE_IN_BUILTIN_MIC;
4534            }
4535            break;
4536
4537        case AUDIO_POLICY_FORCE_SPEAKER:
4538            if (availableDeviceTypes & AUDIO_DEVICE_IN_BACK_MIC) {
4539                device = AUDIO_DEVICE_IN_BACK_MIC;
4540            } else if (availableDeviceTypes & AUDIO_DEVICE_IN_BUILTIN_MIC) {
4541                device = AUDIO_DEVICE_IN_BUILTIN_MIC;
4542            }
4543            break;
4544        }
4545        break;
4546
4547    case AUDIO_SOURCE_VOICE_RECOGNITION:
4548    case AUDIO_SOURCE_HOTWORD:
4549        if (mForceUse[AUDIO_POLICY_FORCE_FOR_RECORD] == AUDIO_POLICY_FORCE_BT_SCO &&
4550                availableDeviceTypes & AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET) {
4551            device = AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET;
4552        } else if (availableDeviceTypes & AUDIO_DEVICE_IN_WIRED_HEADSET) {
4553            device = AUDIO_DEVICE_IN_WIRED_HEADSET;
4554        } else if (availableDeviceTypes & AUDIO_DEVICE_IN_USB_DEVICE) {
4555            device = AUDIO_DEVICE_IN_USB_DEVICE;
4556        } else if (availableDeviceTypes & AUDIO_DEVICE_IN_BUILTIN_MIC) {
4557            device = AUDIO_DEVICE_IN_BUILTIN_MIC;
4558        }
4559        break;
4560    case AUDIO_SOURCE_CAMCORDER:
4561        if (availableDeviceTypes & AUDIO_DEVICE_IN_BACK_MIC) {
4562            device = AUDIO_DEVICE_IN_BACK_MIC;
4563        } else if (availableDeviceTypes & AUDIO_DEVICE_IN_BUILTIN_MIC) {
4564            device = AUDIO_DEVICE_IN_BUILTIN_MIC;
4565        }
4566        break;
4567    case AUDIO_SOURCE_VOICE_DOWNLINK:
4568    case AUDIO_SOURCE_VOICE_CALL:
4569        if (availableDeviceTypes & AUDIO_DEVICE_IN_VOICE_CALL) {
4570            device = AUDIO_DEVICE_IN_VOICE_CALL;
4571        }
4572        break;
4573    case AUDIO_SOURCE_REMOTE_SUBMIX:
4574        if (availableDeviceTypes & AUDIO_DEVICE_IN_REMOTE_SUBMIX) {
4575            device = AUDIO_DEVICE_IN_REMOTE_SUBMIX;
4576        }
4577        break;
4578    default:
4579        ALOGW("getDeviceForInputSource() invalid input source %d", inputSource);
4580        break;
4581    }
4582    ALOGV("getDeviceForInputSource()input source %d, device %08x", inputSource, device);
4583    return device;
4584}
4585
4586bool AudioPolicyManager::isVirtualInputDevice(audio_devices_t device)
4587{
4588    if ((device & AUDIO_DEVICE_BIT_IN) != 0) {
4589        device &= ~AUDIO_DEVICE_BIT_IN;
4590        if ((popcount(device) == 1) && ((device & ~APM_AUDIO_IN_DEVICE_VIRTUAL_ALL) == 0))
4591            return true;
4592    }
4593    return false;
4594}
4595
4596bool AudioPolicyManager::deviceDistinguishesOnAddress(audio_devices_t device) {
4597    return ((device & APM_AUDIO_DEVICE_MATCH_ADDRESS_ALL) != 0);
4598}
4599
4600audio_io_handle_t AudioPolicyManager::getActiveInput(bool ignoreVirtualInputs)
4601{
4602    for (size_t i = 0; i < mInputs.size(); i++) {
4603        const sp<AudioInputDescriptor>  input_descriptor = mInputs.valueAt(i);
4604        if ((input_descriptor->mRefCount > 0)
4605                && (!ignoreVirtualInputs || !isVirtualInputDevice(input_descriptor->mDevice))) {
4606            return mInputs.keyAt(i);
4607        }
4608    }
4609    return 0;
4610}
4611
4612uint32_t AudioPolicyManager::activeInputsCount() const
4613{
4614    uint32_t count = 0;
4615    for (size_t i = 0; i < mInputs.size(); i++) {
4616        const sp<AudioInputDescriptor>  desc = mInputs.valueAt(i);
4617        if (desc->mRefCount > 0) {
4618            return count++;
4619        }
4620    }
4621    return count;
4622}
4623
4624
4625audio_devices_t AudioPolicyManager::getDeviceForVolume(audio_devices_t device)
4626{
4627    if (device == AUDIO_DEVICE_NONE) {
4628        // this happens when forcing a route update and no track is active on an output.
4629        // In this case the returned category is not important.
4630        device =  AUDIO_DEVICE_OUT_SPEAKER;
4631    } else if (popcount(device) > 1) {
4632        // Multiple device selection is either:
4633        //  - speaker + one other device: give priority to speaker in this case.
4634        //  - one A2DP device + another device: happens with duplicated output. In this case
4635        // retain the device on the A2DP output as the other must not correspond to an active
4636        // selection if not the speaker.
4637        if (device & AUDIO_DEVICE_OUT_SPEAKER) {
4638            device = AUDIO_DEVICE_OUT_SPEAKER;
4639        } else {
4640            device = (audio_devices_t)(device & AUDIO_DEVICE_OUT_ALL_A2DP);
4641        }
4642    }
4643
4644    ALOGW_IF(popcount(device) != 1,
4645            "getDeviceForVolume() invalid device combination: %08x",
4646            device);
4647
4648    return device;
4649}
4650
4651AudioPolicyManager::device_category AudioPolicyManager::getDeviceCategory(audio_devices_t device)
4652{
4653    switch(getDeviceForVolume(device)) {
4654        case AUDIO_DEVICE_OUT_EARPIECE:
4655            return DEVICE_CATEGORY_EARPIECE;
4656        case AUDIO_DEVICE_OUT_WIRED_HEADSET:
4657        case AUDIO_DEVICE_OUT_WIRED_HEADPHONE:
4658        case AUDIO_DEVICE_OUT_BLUETOOTH_SCO:
4659        case AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET:
4660        case AUDIO_DEVICE_OUT_BLUETOOTH_A2DP:
4661        case AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES:
4662            return DEVICE_CATEGORY_HEADSET;
4663        case AUDIO_DEVICE_OUT_LINE:
4664        case AUDIO_DEVICE_OUT_AUX_DIGITAL:
4665        /*USB?  Remote submix?*/
4666            return DEVICE_CATEGORY_EXT_MEDIA;
4667        case AUDIO_DEVICE_OUT_SPEAKER:
4668        case AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT:
4669        case AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER:
4670        case AUDIO_DEVICE_OUT_USB_ACCESSORY:
4671        case AUDIO_DEVICE_OUT_USB_DEVICE:
4672        case AUDIO_DEVICE_OUT_REMOTE_SUBMIX:
4673        default:
4674            return DEVICE_CATEGORY_SPEAKER;
4675    }
4676}
4677
4678float AudioPolicyManager::volIndexToAmpl(audio_devices_t device, const StreamDescriptor& streamDesc,
4679        int indexInUi)
4680{
4681    device_category deviceCategory = getDeviceCategory(device);
4682    const VolumeCurvePoint *curve = streamDesc.mVolumeCurve[deviceCategory];
4683
4684    // the volume index in the UI is relative to the min and max volume indices for this stream type
4685    int nbSteps = 1 + curve[VOLMAX].mIndex -
4686            curve[VOLMIN].mIndex;
4687    int volIdx = (nbSteps * (indexInUi - streamDesc.mIndexMin)) /
4688            (streamDesc.mIndexMax - streamDesc.mIndexMin);
4689
4690    // find what part of the curve this index volume belongs to, or if it's out of bounds
4691    int segment = 0;
4692    if (volIdx < curve[VOLMIN].mIndex) {         // out of bounds
4693        return 0.0f;
4694    } else if (volIdx < curve[VOLKNEE1].mIndex) {
4695        segment = 0;
4696    } else if (volIdx < curve[VOLKNEE2].mIndex) {
4697        segment = 1;
4698    } else if (volIdx <= curve[VOLMAX].mIndex) {
4699        segment = 2;
4700    } else {                                                               // out of bounds
4701        return 1.0f;
4702    }
4703
4704    // linear interpolation in the attenuation table in dB
4705    float decibels = curve[segment].mDBAttenuation +
4706            ((float)(volIdx - curve[segment].mIndex)) *
4707                ( (curve[segment+1].mDBAttenuation -
4708                        curve[segment].mDBAttenuation) /
4709                    ((float)(curve[segment+1].mIndex -
4710                            curve[segment].mIndex)) );
4711
4712    float amplification = exp( decibels * 0.115129f); // exp( dB * ln(10) / 20 )
4713
4714    ALOGVV("VOLUME vol index=[%d %d %d], dB=[%.1f %.1f %.1f] ampl=%.5f",
4715            curve[segment].mIndex, volIdx,
4716            curve[segment+1].mIndex,
4717            curve[segment].mDBAttenuation,
4718            decibels,
4719            curve[segment+1].mDBAttenuation,
4720            amplification);
4721
4722    return amplification;
4723}
4724
4725const AudioPolicyManager::VolumeCurvePoint
4726    AudioPolicyManager::sDefaultVolumeCurve[AudioPolicyManager::VOLCNT] = {
4727    {1, -49.5f}, {33, -33.5f}, {66, -17.0f}, {100, 0.0f}
4728};
4729
4730const AudioPolicyManager::VolumeCurvePoint
4731    AudioPolicyManager::sDefaultMediaVolumeCurve[AudioPolicyManager::VOLCNT] = {
4732    {1, -58.0f}, {20, -40.0f}, {60, -17.0f}, {100, 0.0f}
4733};
4734
4735const AudioPolicyManager::VolumeCurvePoint
4736    AudioPolicyManager::sExtMediaSystemVolumeCurve[AudioPolicyManager::VOLCNT] = {
4737    {1, -58.0f}, {20, -40.0f}, {60, -21.0f}, {100, -10.0f}
4738};
4739
4740const AudioPolicyManager::VolumeCurvePoint
4741    AudioPolicyManager::sSpeakerMediaVolumeCurve[AudioPolicyManager::VOLCNT] = {
4742    {1, -56.0f}, {20, -34.0f}, {60, -11.0f}, {100, 0.0f}
4743};
4744
4745const AudioPolicyManager::VolumeCurvePoint
4746    AudioPolicyManager::sSpeakerMediaVolumeCurveDrc[AudioPolicyManager::VOLCNT] = {
4747    {1, -55.0f}, {20, -43.0f}, {86, -12.0f}, {100, 0.0f}
4748};
4749
4750const AudioPolicyManager::VolumeCurvePoint
4751    AudioPolicyManager::sSpeakerSonificationVolumeCurve[AudioPolicyManager::VOLCNT] = {
4752    {1, -29.7f}, {33, -20.1f}, {66, -10.2f}, {100, 0.0f}
4753};
4754
4755const AudioPolicyManager::VolumeCurvePoint
4756    AudioPolicyManager::sSpeakerSonificationVolumeCurveDrc[AudioPolicyManager::VOLCNT] = {
4757    {1, -35.7f}, {33, -26.1f}, {66, -13.2f}, {100, 0.0f}
4758};
4759
4760// AUDIO_STREAM_SYSTEM, AUDIO_STREAM_ENFORCED_AUDIBLE and AUDIO_STREAM_DTMF volume tracks
4761// AUDIO_STREAM_RING on phones and AUDIO_STREAM_MUSIC on tablets.
4762// AUDIO_STREAM_DTMF tracks AUDIO_STREAM_VOICE_CALL while in call (See AudioService.java).
4763// The range is constrained between -24dB and -6dB over speaker and -30dB and -18dB over headset.
4764
4765const AudioPolicyManager::VolumeCurvePoint
4766    AudioPolicyManager::sDefaultSystemVolumeCurve[AudioPolicyManager::VOLCNT] = {
4767    {1, -24.0f}, {33, -18.0f}, {66, -12.0f}, {100, -6.0f}
4768};
4769
4770const AudioPolicyManager::VolumeCurvePoint
4771    AudioPolicyManager::sDefaultSystemVolumeCurveDrc[AudioPolicyManager::VOLCNT] = {
4772    {1, -34.0f}, {33, -24.0f}, {66, -15.0f}, {100, -6.0f}
4773};
4774
4775const AudioPolicyManager::VolumeCurvePoint
4776    AudioPolicyManager::sHeadsetSystemVolumeCurve[AudioPolicyManager::VOLCNT] = {
4777    {1, -30.0f}, {33, -26.0f}, {66, -22.0f}, {100, -18.0f}
4778};
4779
4780const AudioPolicyManager::VolumeCurvePoint
4781    AudioPolicyManager::sDefaultVoiceVolumeCurve[AudioPolicyManager::VOLCNT] = {
4782    {0, -42.0f}, {33, -28.0f}, {66, -14.0f}, {100, 0.0f}
4783};
4784
4785const AudioPolicyManager::VolumeCurvePoint
4786    AudioPolicyManager::sSpeakerVoiceVolumeCurve[AudioPolicyManager::VOLCNT] = {
4787    {0, -24.0f}, {33, -16.0f}, {66, -8.0f}, {100, 0.0f}
4788};
4789
4790const AudioPolicyManager::VolumeCurvePoint
4791            *AudioPolicyManager::sVolumeProfiles[AUDIO_STREAM_CNT]
4792                                                   [AudioPolicyManager::DEVICE_CATEGORY_CNT] = {
4793    { // AUDIO_STREAM_VOICE_CALL
4794        sDefaultVoiceVolumeCurve, // DEVICE_CATEGORY_HEADSET
4795        sSpeakerVoiceVolumeCurve, // DEVICE_CATEGORY_SPEAKER
4796        sDefaultVoiceVolumeCurve, // DEVICE_CATEGORY_EARPIECE
4797        sDefaultMediaVolumeCurve  // DEVICE_CATEGORY_EXT_MEDIA
4798    },
4799    { // AUDIO_STREAM_SYSTEM
4800        sHeadsetSystemVolumeCurve, // DEVICE_CATEGORY_HEADSET
4801        sDefaultSystemVolumeCurve, // DEVICE_CATEGORY_SPEAKER
4802        sDefaultSystemVolumeCurve,  // DEVICE_CATEGORY_EARPIECE
4803        sExtMediaSystemVolumeCurve  // DEVICE_CATEGORY_EXT_MEDIA
4804    },
4805    { // AUDIO_STREAM_RING
4806        sDefaultVolumeCurve, // DEVICE_CATEGORY_HEADSET
4807        sSpeakerSonificationVolumeCurve, // DEVICE_CATEGORY_SPEAKER
4808        sDefaultVolumeCurve,  // DEVICE_CATEGORY_EARPIECE
4809        sExtMediaSystemVolumeCurve  // DEVICE_CATEGORY_EXT_MEDIA
4810    },
4811    { // AUDIO_STREAM_MUSIC
4812        sDefaultMediaVolumeCurve, // DEVICE_CATEGORY_HEADSET
4813        sSpeakerMediaVolumeCurve, // DEVICE_CATEGORY_SPEAKER
4814        sDefaultMediaVolumeCurve, // DEVICE_CATEGORY_EARPIECE
4815        sDefaultMediaVolumeCurve  // DEVICE_CATEGORY_EXT_MEDIA
4816    },
4817    { // AUDIO_STREAM_ALARM
4818        sDefaultVolumeCurve, // DEVICE_CATEGORY_HEADSET
4819        sSpeakerSonificationVolumeCurve, // DEVICE_CATEGORY_SPEAKER
4820        sDefaultVolumeCurve,  // DEVICE_CATEGORY_EARPIECE
4821        sExtMediaSystemVolumeCurve  // DEVICE_CATEGORY_EXT_MEDIA
4822    },
4823    { // AUDIO_STREAM_NOTIFICATION
4824        sDefaultVolumeCurve, // DEVICE_CATEGORY_HEADSET
4825        sSpeakerSonificationVolumeCurve, // DEVICE_CATEGORY_SPEAKER
4826        sDefaultVolumeCurve,  // DEVICE_CATEGORY_EARPIECE
4827        sExtMediaSystemVolumeCurve  // DEVICE_CATEGORY_EXT_MEDIA
4828    },
4829    { // AUDIO_STREAM_BLUETOOTH_SCO
4830        sDefaultVoiceVolumeCurve, // DEVICE_CATEGORY_HEADSET
4831        sSpeakerVoiceVolumeCurve, // DEVICE_CATEGORY_SPEAKER
4832        sDefaultVoiceVolumeCurve, // DEVICE_CATEGORY_EARPIECE
4833        sDefaultMediaVolumeCurve  // DEVICE_CATEGORY_EXT_MEDIA
4834    },
4835    { // AUDIO_STREAM_ENFORCED_AUDIBLE
4836        sHeadsetSystemVolumeCurve, // DEVICE_CATEGORY_HEADSET
4837        sDefaultSystemVolumeCurve, // DEVICE_CATEGORY_SPEAKER
4838        sDefaultSystemVolumeCurve, // DEVICE_CATEGORY_EARPIECE
4839        sExtMediaSystemVolumeCurve  // DEVICE_CATEGORY_EXT_MEDIA
4840    },
4841    {  // AUDIO_STREAM_DTMF
4842        sHeadsetSystemVolumeCurve, // DEVICE_CATEGORY_HEADSET
4843        sDefaultSystemVolumeCurve, // DEVICE_CATEGORY_SPEAKER
4844        sDefaultSystemVolumeCurve, // DEVICE_CATEGORY_EARPIECE
4845        sExtMediaSystemVolumeCurve  // DEVICE_CATEGORY_EXT_MEDIA
4846    },
4847    { // AUDIO_STREAM_TTS
4848        sDefaultMediaVolumeCurve, // DEVICE_CATEGORY_HEADSET
4849        sSpeakerMediaVolumeCurve, // DEVICE_CATEGORY_SPEAKER
4850        sDefaultMediaVolumeCurve, // DEVICE_CATEGORY_EARPIECE
4851        sDefaultMediaVolumeCurve  // DEVICE_CATEGORY_EXT_MEDIA
4852    },
4853};
4854
4855void AudioPolicyManager::initializeVolumeCurves()
4856{
4857    for (int i = 0; i < AUDIO_STREAM_CNT; i++) {
4858        for (int j = 0; j < DEVICE_CATEGORY_CNT; j++) {
4859            mStreams[i].mVolumeCurve[j] =
4860                    sVolumeProfiles[i][j];
4861        }
4862    }
4863
4864    // Check availability of DRC on speaker path: if available, override some of the speaker curves
4865    if (mSpeakerDrcEnabled) {
4866        mStreams[AUDIO_STREAM_SYSTEM].mVolumeCurve[DEVICE_CATEGORY_SPEAKER] =
4867                sDefaultSystemVolumeCurveDrc;
4868        mStreams[AUDIO_STREAM_RING].mVolumeCurve[DEVICE_CATEGORY_SPEAKER] =
4869                sSpeakerSonificationVolumeCurveDrc;
4870        mStreams[AUDIO_STREAM_ALARM].mVolumeCurve[DEVICE_CATEGORY_SPEAKER] =
4871                sSpeakerSonificationVolumeCurveDrc;
4872        mStreams[AUDIO_STREAM_NOTIFICATION].mVolumeCurve[DEVICE_CATEGORY_SPEAKER] =
4873                sSpeakerSonificationVolumeCurveDrc;
4874        mStreams[AUDIO_STREAM_MUSIC].mVolumeCurve[DEVICE_CATEGORY_SPEAKER] =
4875                sSpeakerMediaVolumeCurveDrc;
4876    }
4877}
4878
4879float AudioPolicyManager::computeVolume(audio_stream_type_t stream,
4880                                            int index,
4881                                            audio_io_handle_t output,
4882                                            audio_devices_t device)
4883{
4884    float volume = 1.0;
4885    sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(output);
4886    StreamDescriptor &streamDesc = mStreams[stream];
4887
4888    if (device == AUDIO_DEVICE_NONE) {
4889        device = outputDesc->device();
4890    }
4891
4892    volume = volIndexToAmpl(device, streamDesc, index);
4893
4894    // if a headset is connected, apply the following rules to ring tones and notifications
4895    // to avoid sound level bursts in user's ears:
4896    // - always attenuate ring tones and notifications volume by 6dB
4897    // - if music is playing, always limit the volume to current music volume,
4898    // with a minimum threshold at -36dB so that notification is always perceived.
4899    const routing_strategy stream_strategy = getStrategy(stream);
4900    if ((device & (AUDIO_DEVICE_OUT_BLUETOOTH_A2DP |
4901            AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES |
4902            AUDIO_DEVICE_OUT_WIRED_HEADSET |
4903            AUDIO_DEVICE_OUT_WIRED_HEADPHONE)) &&
4904        ((stream_strategy == STRATEGY_SONIFICATION)
4905                || (stream_strategy == STRATEGY_SONIFICATION_RESPECTFUL)
4906                || (stream == AUDIO_STREAM_SYSTEM)
4907                || ((stream_strategy == STRATEGY_ENFORCED_AUDIBLE) &&
4908                    (mForceUse[AUDIO_POLICY_FORCE_FOR_SYSTEM] == AUDIO_POLICY_FORCE_NONE))) &&
4909        streamDesc.mCanBeMuted) {
4910        volume *= SONIFICATION_HEADSET_VOLUME_FACTOR;
4911        // when the phone is ringing we must consider that music could have been paused just before
4912        // by the music application and behave as if music was active if the last music track was
4913        // just stopped
4914        if (isStreamActive(AUDIO_STREAM_MUSIC, SONIFICATION_HEADSET_MUSIC_DELAY) ||
4915                mLimitRingtoneVolume) {
4916            audio_devices_t musicDevice = getDeviceForStrategy(STRATEGY_MEDIA, true /*fromCache*/);
4917            float musicVol = computeVolume(AUDIO_STREAM_MUSIC,
4918                               mStreams[AUDIO_STREAM_MUSIC].getVolumeIndex(musicDevice),
4919                               output,
4920                               musicDevice);
4921            float minVol = (musicVol > SONIFICATION_HEADSET_VOLUME_MIN) ?
4922                                musicVol : SONIFICATION_HEADSET_VOLUME_MIN;
4923            if (volume > minVol) {
4924                volume = minVol;
4925                ALOGV("computeVolume limiting volume to %f musicVol %f", minVol, musicVol);
4926            }
4927        }
4928    }
4929
4930    return volume;
4931}
4932
4933status_t AudioPolicyManager::checkAndSetVolume(audio_stream_type_t stream,
4934                                                   int index,
4935                                                   audio_io_handle_t output,
4936                                                   audio_devices_t device,
4937                                                   int delayMs,
4938                                                   bool force)
4939{
4940
4941    // do not change actual stream volume if the stream is muted
4942    if (mOutputs.valueFor(output)->mMuteCount[stream] != 0) {
4943        ALOGVV("checkAndSetVolume() stream %d muted count %d",
4944              stream, mOutputs.valueFor(output)->mMuteCount[stream]);
4945        return NO_ERROR;
4946    }
4947
4948    // do not change in call volume if bluetooth is connected and vice versa
4949    if ((stream == AUDIO_STREAM_VOICE_CALL &&
4950            mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION] == AUDIO_POLICY_FORCE_BT_SCO) ||
4951        (stream == AUDIO_STREAM_BLUETOOTH_SCO &&
4952                mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION] != AUDIO_POLICY_FORCE_BT_SCO)) {
4953        ALOGV("checkAndSetVolume() cannot set stream %d volume with force use = %d for comm",
4954             stream, mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION]);
4955        return INVALID_OPERATION;
4956    }
4957
4958    float volume = computeVolume(stream, index, output, device);
4959    // We actually change the volume if:
4960    // - the float value returned by computeVolume() changed
4961    // - the force flag is set
4962    if (volume != mOutputs.valueFor(output)->mCurVolume[stream] ||
4963            force) {
4964        mOutputs.valueFor(output)->mCurVolume[stream] = volume;
4965        ALOGVV("checkAndSetVolume() for output %d stream %d, volume %f, delay %d", output, stream, volume, delayMs);
4966        // Force VOICE_CALL to track BLUETOOTH_SCO stream volume when bluetooth audio is
4967        // enabled
4968        if (stream == AUDIO_STREAM_BLUETOOTH_SCO) {
4969            mpClientInterface->setStreamVolume(AUDIO_STREAM_VOICE_CALL, volume, output, delayMs);
4970        }
4971        mpClientInterface->setStreamVolume(stream, volume, output, delayMs);
4972    }
4973
4974    if (stream == AUDIO_STREAM_VOICE_CALL ||
4975        stream == AUDIO_STREAM_BLUETOOTH_SCO) {
4976        float voiceVolume;
4977        // Force voice volume to max for bluetooth SCO as volume is managed by the headset
4978        if (stream == AUDIO_STREAM_VOICE_CALL) {
4979            voiceVolume = (float)index/(float)mStreams[stream].mIndexMax;
4980        } else {
4981            voiceVolume = 1.0;
4982        }
4983
4984        if (voiceVolume != mLastVoiceVolume && output == mPrimaryOutput) {
4985            mpClientInterface->setVoiceVolume(voiceVolume, delayMs);
4986            mLastVoiceVolume = voiceVolume;
4987        }
4988    }
4989
4990    return NO_ERROR;
4991}
4992
4993void AudioPolicyManager::applyStreamVolumes(audio_io_handle_t output,
4994                                                audio_devices_t device,
4995                                                int delayMs,
4996                                                bool force)
4997{
4998    ALOGVV("applyStreamVolumes() for output %d and device %x", output, device);
4999
5000    for (int stream = 0; stream < AUDIO_STREAM_CNT; stream++) {
5001        checkAndSetVolume((audio_stream_type_t)stream,
5002                          mStreams[stream].getVolumeIndex(device),
5003                          output,
5004                          device,
5005                          delayMs,
5006                          force);
5007    }
5008}
5009
5010void AudioPolicyManager::setStrategyMute(routing_strategy strategy,
5011                                             bool on,
5012                                             audio_io_handle_t output,
5013                                             int delayMs,
5014                                             audio_devices_t device)
5015{
5016    ALOGVV("setStrategyMute() strategy %d, mute %d, output %d", strategy, on, output);
5017    for (int stream = 0; stream < AUDIO_STREAM_CNT; stream++) {
5018        if (getStrategy((audio_stream_type_t)stream) == strategy) {
5019            setStreamMute((audio_stream_type_t)stream, on, output, delayMs, device);
5020        }
5021    }
5022}
5023
5024void AudioPolicyManager::setStreamMute(audio_stream_type_t stream,
5025                                           bool on,
5026                                           audio_io_handle_t output,
5027                                           int delayMs,
5028                                           audio_devices_t device)
5029{
5030    StreamDescriptor &streamDesc = mStreams[stream];
5031    sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(output);
5032    if (device == AUDIO_DEVICE_NONE) {
5033        device = outputDesc->device();
5034    }
5035
5036    ALOGVV("setStreamMute() stream %d, mute %d, output %d, mMuteCount %d device %04x",
5037          stream, on, output, outputDesc->mMuteCount[stream], device);
5038
5039    if (on) {
5040        if (outputDesc->mMuteCount[stream] == 0) {
5041            if (streamDesc.mCanBeMuted &&
5042                    ((stream != AUDIO_STREAM_ENFORCED_AUDIBLE) ||
5043                     (mForceUse[AUDIO_POLICY_FORCE_FOR_SYSTEM] == AUDIO_POLICY_FORCE_NONE))) {
5044                checkAndSetVolume(stream, 0, output, device, delayMs);
5045            }
5046        }
5047        // increment mMuteCount after calling checkAndSetVolume() so that volume change is not ignored
5048        outputDesc->mMuteCount[stream]++;
5049    } else {
5050        if (outputDesc->mMuteCount[stream] == 0) {
5051            ALOGV("setStreamMute() unmuting non muted stream!");
5052            return;
5053        }
5054        if (--outputDesc->mMuteCount[stream] == 0) {
5055            checkAndSetVolume(stream,
5056                              streamDesc.getVolumeIndex(device),
5057                              output,
5058                              device,
5059                              delayMs);
5060        }
5061    }
5062}
5063
5064void AudioPolicyManager::handleIncallSonification(audio_stream_type_t stream,
5065                                                      bool starting, bool stateChange)
5066{
5067    // if the stream pertains to sonification strategy and we are in call we must
5068    // mute the stream if it is low visibility. If it is high visibility, we must play a tone
5069    // in the device used for phone strategy and play the tone if the selected device does not
5070    // interfere with the device used for phone strategy
5071    // if stateChange is true, we are called from setPhoneState() and we must mute or unmute as
5072    // many times as there are active tracks on the output
5073    const routing_strategy stream_strategy = getStrategy(stream);
5074    if ((stream_strategy == STRATEGY_SONIFICATION) ||
5075            ((stream_strategy == STRATEGY_SONIFICATION_RESPECTFUL))) {
5076        sp<AudioOutputDescriptor> outputDesc = mOutputs.valueFor(mPrimaryOutput);
5077        ALOGV("handleIncallSonification() stream %d starting %d device %x stateChange %d",
5078                stream, starting, outputDesc->mDevice, stateChange);
5079        if (outputDesc->mRefCount[stream]) {
5080            int muteCount = 1;
5081            if (stateChange) {
5082                muteCount = outputDesc->mRefCount[stream];
5083            }
5084            if (audio_is_low_visibility(stream)) {
5085                ALOGV("handleIncallSonification() low visibility, muteCount %d", muteCount);
5086                for (int i = 0; i < muteCount; i++) {
5087                    setStreamMute(stream, starting, mPrimaryOutput);
5088                }
5089            } else {
5090                ALOGV("handleIncallSonification() high visibility");
5091                if (outputDesc->device() &
5092                        getDeviceForStrategy(STRATEGY_PHONE, true /*fromCache*/)) {
5093                    ALOGV("handleIncallSonification() high visibility muted, muteCount %d", muteCount);
5094                    for (int i = 0; i < muteCount; i++) {
5095                        setStreamMute(stream, starting, mPrimaryOutput);
5096                    }
5097                }
5098                if (starting) {
5099                    mpClientInterface->startTone(AUDIO_POLICY_TONE_IN_CALL_NOTIFICATION,
5100                                                 AUDIO_STREAM_VOICE_CALL);
5101                } else {
5102                    mpClientInterface->stopTone();
5103                }
5104            }
5105        }
5106    }
5107}
5108
5109bool AudioPolicyManager::isInCall()
5110{
5111    return isStateInCall(mPhoneState);
5112}
5113
5114bool AudioPolicyManager::isStateInCall(int state) {
5115    return ((state == AUDIO_MODE_IN_CALL) ||
5116            (state == AUDIO_MODE_IN_COMMUNICATION));
5117}
5118
5119uint32_t AudioPolicyManager::getMaxEffectsCpuLoad()
5120{
5121    return MAX_EFFECTS_CPU_LOAD;
5122}
5123
5124uint32_t AudioPolicyManager::getMaxEffectsMemory()
5125{
5126    return MAX_EFFECTS_MEMORY;
5127}
5128
5129
5130// --- AudioOutputDescriptor class implementation
5131
5132AudioPolicyManager::AudioOutputDescriptor::AudioOutputDescriptor(
5133        const sp<IOProfile>& profile)
5134    : mId(0), mIoHandle(0), mLatency(0),
5135    mFlags((audio_output_flags_t)0), mDevice(AUDIO_DEVICE_NONE), mPatchHandle(0),
5136    mOutput1(0), mOutput2(0), mProfile(profile), mDirectOpenCount(0)
5137{
5138    // clear usage count for all stream types
5139    for (int i = 0; i < AUDIO_STREAM_CNT; i++) {
5140        mRefCount[i] = 0;
5141        mCurVolume[i] = -1.0;
5142        mMuteCount[i] = 0;
5143        mStopTime[i] = 0;
5144    }
5145    for (int i = 0; i < NUM_STRATEGIES; i++) {
5146        mStrategyMutedByDevice[i] = false;
5147    }
5148    if (profile != NULL) {
5149        mFlags = profile->mFlags;
5150        mSamplingRate = profile->pickSamplingRate();
5151        mFormat = profile->pickFormat();
5152        mChannelMask = profile->pickChannelMask();
5153        if (profile->mGains.size() > 0) {
5154            profile->mGains[0]->getDefaultConfig(&mGain);
5155        }
5156    }
5157}
5158
5159audio_devices_t AudioPolicyManager::AudioOutputDescriptor::device() const
5160{
5161    if (isDuplicated()) {
5162        return (audio_devices_t)(mOutput1->mDevice | mOutput2->mDevice);
5163    } else {
5164        return mDevice;
5165    }
5166}
5167
5168uint32_t AudioPolicyManager::AudioOutputDescriptor::latency()
5169{
5170    if (isDuplicated()) {
5171        return (mOutput1->mLatency > mOutput2->mLatency) ? mOutput1->mLatency : mOutput2->mLatency;
5172    } else {
5173        return mLatency;
5174    }
5175}
5176
5177bool AudioPolicyManager::AudioOutputDescriptor::sharesHwModuleWith(
5178        const sp<AudioOutputDescriptor> outputDesc)
5179{
5180    if (isDuplicated()) {
5181        return mOutput1->sharesHwModuleWith(outputDesc) || mOutput2->sharesHwModuleWith(outputDesc);
5182    } else if (outputDesc->isDuplicated()){
5183        return sharesHwModuleWith(outputDesc->mOutput1) || sharesHwModuleWith(outputDesc->mOutput2);
5184    } else {
5185        return (mProfile->mModule == outputDesc->mProfile->mModule);
5186    }
5187}
5188
5189void AudioPolicyManager::AudioOutputDescriptor::changeRefCount(audio_stream_type_t stream,
5190                                                                   int delta)
5191{
5192    // forward usage count change to attached outputs
5193    if (isDuplicated()) {
5194        mOutput1->changeRefCount(stream, delta);
5195        mOutput2->changeRefCount(stream, delta);
5196    }
5197    if ((delta + (int)mRefCount[stream]) < 0) {
5198        ALOGW("changeRefCount() invalid delta %d for stream %d, refCount %d",
5199              delta, stream, mRefCount[stream]);
5200        mRefCount[stream] = 0;
5201        return;
5202    }
5203    mRefCount[stream] += delta;
5204    ALOGV("changeRefCount() stream %d, count %d", stream, mRefCount[stream]);
5205}
5206
5207audio_devices_t AudioPolicyManager::AudioOutputDescriptor::supportedDevices()
5208{
5209    if (isDuplicated()) {
5210        return (audio_devices_t)(mOutput1->supportedDevices() | mOutput2->supportedDevices());
5211    } else {
5212        return mProfile->mSupportedDevices.types() ;
5213    }
5214}
5215
5216bool AudioPolicyManager::AudioOutputDescriptor::isActive(uint32_t inPastMs) const
5217{
5218    return isStrategyActive(NUM_STRATEGIES, inPastMs);
5219}
5220
5221bool AudioPolicyManager::AudioOutputDescriptor::isStrategyActive(routing_strategy strategy,
5222                                                                       uint32_t inPastMs,
5223                                                                       nsecs_t sysTime) const
5224{
5225    if ((sysTime == 0) && (inPastMs != 0)) {
5226        sysTime = systemTime();
5227    }
5228    for (int i = 0; i < (int)AUDIO_STREAM_CNT; i++) {
5229        if (((getStrategy((audio_stream_type_t)i) == strategy) ||
5230                (NUM_STRATEGIES == strategy)) &&
5231                isStreamActive((audio_stream_type_t)i, inPastMs, sysTime)) {
5232            return true;
5233        }
5234    }
5235    return false;
5236}
5237
5238bool AudioPolicyManager::AudioOutputDescriptor::isStreamActive(audio_stream_type_t stream,
5239                                                                       uint32_t inPastMs,
5240                                                                       nsecs_t sysTime) const
5241{
5242    if (mRefCount[stream] != 0) {
5243        return true;
5244    }
5245    if (inPastMs == 0) {
5246        return false;
5247    }
5248    if (sysTime == 0) {
5249        sysTime = systemTime();
5250    }
5251    if (ns2ms(sysTime - mStopTime[stream]) < inPastMs) {
5252        return true;
5253    }
5254    return false;
5255}
5256
5257void AudioPolicyManager::AudioOutputDescriptor::toAudioPortConfig(
5258                                                 struct audio_port_config *dstConfig,
5259                                                 const struct audio_port_config *srcConfig) const
5260{
5261    ALOG_ASSERT(!isDuplicated(), "toAudioPortConfig() called on duplicated output %d", mIoHandle);
5262
5263    dstConfig->config_mask = AUDIO_PORT_CONFIG_SAMPLE_RATE|AUDIO_PORT_CONFIG_CHANNEL_MASK|
5264                            AUDIO_PORT_CONFIG_FORMAT|AUDIO_PORT_CONFIG_GAIN;
5265    if (srcConfig != NULL) {
5266        dstConfig->config_mask |= srcConfig->config_mask;
5267    }
5268    AudioPortConfig::toAudioPortConfig(dstConfig, srcConfig);
5269
5270    dstConfig->id = mId;
5271    dstConfig->role = AUDIO_PORT_ROLE_SOURCE;
5272    dstConfig->type = AUDIO_PORT_TYPE_MIX;
5273    dstConfig->ext.mix.hw_module = mProfile->mModule->mHandle;
5274    dstConfig->ext.mix.handle = mIoHandle;
5275    dstConfig->ext.mix.usecase.stream = AUDIO_STREAM_DEFAULT;
5276}
5277
5278void AudioPolicyManager::AudioOutputDescriptor::toAudioPort(
5279                                                    struct audio_port *port) const
5280{
5281    ALOG_ASSERT(!isDuplicated(), "toAudioPort() called on duplicated output %d", mIoHandle);
5282    mProfile->toAudioPort(port);
5283    port->id = mId;
5284    toAudioPortConfig(&port->active_config);
5285    port->ext.mix.hw_module = mProfile->mModule->mHandle;
5286    port->ext.mix.handle = mIoHandle;
5287    port->ext.mix.latency_class =
5288            mFlags & AUDIO_OUTPUT_FLAG_FAST ? AUDIO_LATENCY_LOW : AUDIO_LATENCY_NORMAL;
5289}
5290
5291status_t AudioPolicyManager::AudioOutputDescriptor::dump(int fd)
5292{
5293    const size_t SIZE = 256;
5294    char buffer[SIZE];
5295    String8 result;
5296
5297    snprintf(buffer, SIZE, " ID: %d\n", mId);
5298    result.append(buffer);
5299    snprintf(buffer, SIZE, " Sampling rate: %d\n", mSamplingRate);
5300    result.append(buffer);
5301    snprintf(buffer, SIZE, " Format: %08x\n", mFormat);
5302    result.append(buffer);
5303    snprintf(buffer, SIZE, " Channels: %08x\n", mChannelMask);
5304    result.append(buffer);
5305    snprintf(buffer, SIZE, " Latency: %d\n", mLatency);
5306    result.append(buffer);
5307    snprintf(buffer, SIZE, " Flags %08x\n", mFlags);
5308    result.append(buffer);
5309    snprintf(buffer, SIZE, " Devices %08x\n", device());
5310    result.append(buffer);
5311    snprintf(buffer, SIZE, " Stream volume refCount muteCount\n");
5312    result.append(buffer);
5313    for (int i = 0; i < (int)AUDIO_STREAM_CNT; i++) {
5314        snprintf(buffer, SIZE, " %02d     %.03f     %02d       %02d\n",
5315                 i, mCurVolume[i], mRefCount[i], mMuteCount[i]);
5316        result.append(buffer);
5317    }
5318    write(fd, result.string(), result.size());
5319
5320    return NO_ERROR;
5321}
5322
5323// --- AudioInputDescriptor class implementation
5324
5325AudioPolicyManager::AudioInputDescriptor::AudioInputDescriptor(const sp<IOProfile>& profile)
5326    : mId(0), mIoHandle(0),
5327      mDevice(AUDIO_DEVICE_NONE), mPatchHandle(0), mRefCount(0),
5328      mInputSource(AUDIO_SOURCE_DEFAULT), mProfile(profile), mIsSoundTrigger(false)
5329{
5330    if (profile != NULL) {
5331        mSamplingRate = profile->pickSamplingRate();
5332        mFormat = profile->pickFormat();
5333        mChannelMask = profile->pickChannelMask();
5334        if (profile->mGains.size() > 0) {
5335            profile->mGains[0]->getDefaultConfig(&mGain);
5336        }
5337    }
5338}
5339
5340void AudioPolicyManager::AudioInputDescriptor::toAudioPortConfig(
5341                                                   struct audio_port_config *dstConfig,
5342                                                   const struct audio_port_config *srcConfig) const
5343{
5344    ALOG_ASSERT(mProfile != 0,
5345                "toAudioPortConfig() called on input with null profile %d", mIoHandle);
5346    dstConfig->config_mask = AUDIO_PORT_CONFIG_SAMPLE_RATE|AUDIO_PORT_CONFIG_CHANNEL_MASK|
5347                            AUDIO_PORT_CONFIG_FORMAT|AUDIO_PORT_CONFIG_GAIN;
5348    if (srcConfig != NULL) {
5349        dstConfig->config_mask |= srcConfig->config_mask;
5350    }
5351
5352    AudioPortConfig::toAudioPortConfig(dstConfig, srcConfig);
5353
5354    dstConfig->id = mId;
5355    dstConfig->role = AUDIO_PORT_ROLE_SINK;
5356    dstConfig->type = AUDIO_PORT_TYPE_MIX;
5357    dstConfig->ext.mix.hw_module = mProfile->mModule->mHandle;
5358    dstConfig->ext.mix.handle = mIoHandle;
5359    dstConfig->ext.mix.usecase.source = mInputSource;
5360}
5361
5362void AudioPolicyManager::AudioInputDescriptor::toAudioPort(
5363                                                    struct audio_port *port) const
5364{
5365    ALOG_ASSERT(mProfile != 0, "toAudioPort() called on input with null profile %d", mIoHandle);
5366
5367    mProfile->toAudioPort(port);
5368    port->id = mId;
5369    toAudioPortConfig(&port->active_config);
5370    port->ext.mix.hw_module = mProfile->mModule->mHandle;
5371    port->ext.mix.handle = mIoHandle;
5372    port->ext.mix.latency_class = AUDIO_LATENCY_NORMAL;
5373}
5374
5375status_t AudioPolicyManager::AudioInputDescriptor::dump(int fd)
5376{
5377    const size_t SIZE = 256;
5378    char buffer[SIZE];
5379    String8 result;
5380
5381    snprintf(buffer, SIZE, " ID: %d\n", mId);
5382    result.append(buffer);
5383    snprintf(buffer, SIZE, " Sampling rate: %d\n", mSamplingRate);
5384    result.append(buffer);
5385    snprintf(buffer, SIZE, " Format: %d\n", mFormat);
5386    result.append(buffer);
5387    snprintf(buffer, SIZE, " Channels: %08x\n", mChannelMask);
5388    result.append(buffer);
5389    snprintf(buffer, SIZE, " Devices %08x\n", mDevice);
5390    result.append(buffer);
5391    snprintf(buffer, SIZE, " Ref Count %d\n", mRefCount);
5392    result.append(buffer);
5393    snprintf(buffer, SIZE, " Open Ref Count %d\n", mOpenRefCount);
5394    result.append(buffer);
5395
5396    write(fd, result.string(), result.size());
5397
5398    return NO_ERROR;
5399}
5400
5401// --- StreamDescriptor class implementation
5402
5403AudioPolicyManager::StreamDescriptor::StreamDescriptor()
5404    :   mIndexMin(0), mIndexMax(1), mCanBeMuted(true)
5405{
5406    mIndexCur.add(AUDIO_DEVICE_OUT_DEFAULT, 0);
5407}
5408
5409int AudioPolicyManager::StreamDescriptor::getVolumeIndex(audio_devices_t device)
5410{
5411    device = AudioPolicyManager::getDeviceForVolume(device);
5412    // there is always a valid entry for AUDIO_DEVICE_OUT_DEFAULT
5413    if (mIndexCur.indexOfKey(device) < 0) {
5414        device = AUDIO_DEVICE_OUT_DEFAULT;
5415    }
5416    return mIndexCur.valueFor(device);
5417}
5418
5419void AudioPolicyManager::StreamDescriptor::dump(int fd)
5420{
5421    const size_t SIZE = 256;
5422    char buffer[SIZE];
5423    String8 result;
5424
5425    snprintf(buffer, SIZE, "%s         %02d         %02d         ",
5426             mCanBeMuted ? "true " : "false", mIndexMin, mIndexMax);
5427    result.append(buffer);
5428    for (size_t i = 0; i < mIndexCur.size(); i++) {
5429        snprintf(buffer, SIZE, "%04x : %02d, ",
5430                 mIndexCur.keyAt(i),
5431                 mIndexCur.valueAt(i));
5432        result.append(buffer);
5433    }
5434    result.append("\n");
5435
5436    write(fd, result.string(), result.size());
5437}
5438
5439// --- EffectDescriptor class implementation
5440
5441status_t AudioPolicyManager::EffectDescriptor::dump(int fd)
5442{
5443    const size_t SIZE = 256;
5444    char buffer[SIZE];
5445    String8 result;
5446
5447    snprintf(buffer, SIZE, " I/O: %d\n", mIo);
5448    result.append(buffer);
5449    snprintf(buffer, SIZE, " Strategy: %d\n", mStrategy);
5450    result.append(buffer);
5451    snprintf(buffer, SIZE, " Session: %d\n", mSession);
5452    result.append(buffer);
5453    snprintf(buffer, SIZE, " Name: %s\n",  mDesc.name);
5454    result.append(buffer);
5455    snprintf(buffer, SIZE, " %s\n",  mEnabled ? "Enabled" : "Disabled");
5456    result.append(buffer);
5457    write(fd, result.string(), result.size());
5458
5459    return NO_ERROR;
5460}
5461
5462// --- HwModule class implementation
5463
5464AudioPolicyManager::HwModule::HwModule(const char *name)
5465    : mName(strndup(name, AUDIO_HARDWARE_MODULE_ID_MAX_LEN)),
5466      mHalVersion(AUDIO_DEVICE_API_VERSION_MIN), mHandle(0)
5467{
5468}
5469
5470AudioPolicyManager::HwModule::~HwModule()
5471{
5472    for (size_t i = 0; i < mOutputProfiles.size(); i++) {
5473        mOutputProfiles[i]->mSupportedDevices.clear();
5474    }
5475    for (size_t i = 0; i < mInputProfiles.size(); i++) {
5476        mInputProfiles[i]->mSupportedDevices.clear();
5477    }
5478    free((void *)mName);
5479}
5480
5481status_t AudioPolicyManager::HwModule::loadInput(cnode *root)
5482{
5483    cnode *node = root->first_child;
5484
5485    sp<IOProfile> profile = new IOProfile(String8(root->name), AUDIO_PORT_ROLE_SINK, this);
5486
5487    while (node) {
5488        if (strcmp(node->name, SAMPLING_RATES_TAG) == 0) {
5489            profile->loadSamplingRates((char *)node->value);
5490        } else if (strcmp(node->name, FORMATS_TAG) == 0) {
5491            profile->loadFormats((char *)node->value);
5492        } else if (strcmp(node->name, CHANNELS_TAG) == 0) {
5493            profile->loadInChannels((char *)node->value);
5494        } else if (strcmp(node->name, DEVICES_TAG) == 0) {
5495            profile->mSupportedDevices.loadDevicesFromName((char *)node->value,
5496                                                           mDeclaredDevices);
5497        } else if (strcmp(node->name, GAINS_TAG) == 0) {
5498            profile->loadGains(node);
5499        }
5500        node = node->next;
5501    }
5502    ALOGW_IF(profile->mSupportedDevices.isEmpty(),
5503            "loadInput() invalid supported devices");
5504    ALOGW_IF(profile->mChannelMasks.size() == 0,
5505            "loadInput() invalid supported channel masks");
5506    ALOGW_IF(profile->mSamplingRates.size() == 0,
5507            "loadInput() invalid supported sampling rates");
5508    ALOGW_IF(profile->mFormats.size() == 0,
5509            "loadInput() invalid supported formats");
5510    if (!profile->mSupportedDevices.isEmpty() &&
5511            (profile->mChannelMasks.size() != 0) &&
5512            (profile->mSamplingRates.size() != 0) &&
5513            (profile->mFormats.size() != 0)) {
5514
5515        ALOGV("loadInput() adding input Supported Devices %04x",
5516              profile->mSupportedDevices.types());
5517
5518        mInputProfiles.add(profile);
5519        return NO_ERROR;
5520    } else {
5521        return BAD_VALUE;
5522    }
5523}
5524
5525status_t AudioPolicyManager::HwModule::loadOutput(cnode *root)
5526{
5527    cnode *node = root->first_child;
5528
5529    sp<IOProfile> profile = new IOProfile(String8(root->name), AUDIO_PORT_ROLE_SOURCE, this);
5530
5531    while (node) {
5532        if (strcmp(node->name, SAMPLING_RATES_TAG) == 0) {
5533            profile->loadSamplingRates((char *)node->value);
5534        } else if (strcmp(node->name, FORMATS_TAG) == 0) {
5535            profile->loadFormats((char *)node->value);
5536        } else if (strcmp(node->name, CHANNELS_TAG) == 0) {
5537            profile->loadOutChannels((char *)node->value);
5538        } else if (strcmp(node->name, DEVICES_TAG) == 0) {
5539            profile->mSupportedDevices.loadDevicesFromName((char *)node->value,
5540                                                           mDeclaredDevices);
5541        } else if (strcmp(node->name, FLAGS_TAG) == 0) {
5542            profile->mFlags = parseFlagNames((char *)node->value);
5543        } else if (strcmp(node->name, GAINS_TAG) == 0) {
5544            profile->loadGains(node);
5545        }
5546        node = node->next;
5547    }
5548    ALOGW_IF(profile->mSupportedDevices.isEmpty(),
5549            "loadOutput() invalid supported devices");
5550    ALOGW_IF(profile->mChannelMasks.size() == 0,
5551            "loadOutput() invalid supported channel masks");
5552    ALOGW_IF(profile->mSamplingRates.size() == 0,
5553            "loadOutput() invalid supported sampling rates");
5554    ALOGW_IF(profile->mFormats.size() == 0,
5555            "loadOutput() invalid supported formats");
5556    if (!profile->mSupportedDevices.isEmpty() &&
5557            (profile->mChannelMasks.size() != 0) &&
5558            (profile->mSamplingRates.size() != 0) &&
5559            (profile->mFormats.size() != 0)) {
5560
5561        ALOGV("loadOutput() adding output Supported Devices %04x, mFlags %04x",
5562              profile->mSupportedDevices.types(), profile->mFlags);
5563
5564        mOutputProfiles.add(profile);
5565        return NO_ERROR;
5566    } else {
5567        return BAD_VALUE;
5568    }
5569}
5570
5571status_t AudioPolicyManager::HwModule::loadDevice(cnode *root)
5572{
5573    cnode *node = root->first_child;
5574
5575    audio_devices_t type = AUDIO_DEVICE_NONE;
5576    while (node) {
5577        if (strcmp(node->name, DEVICE_TYPE) == 0) {
5578            type = parseDeviceNames((char *)node->value);
5579            break;
5580        }
5581        node = node->next;
5582    }
5583    if (type == AUDIO_DEVICE_NONE ||
5584            (!audio_is_input_device(type) && !audio_is_output_device(type))) {
5585        ALOGW("loadDevice() bad type %08x", type);
5586        return BAD_VALUE;
5587    }
5588    sp<DeviceDescriptor> deviceDesc = new DeviceDescriptor(String8(root->name), type);
5589    deviceDesc->mModule = this;
5590
5591    node = root->first_child;
5592    while (node) {
5593        if (strcmp(node->name, DEVICE_ADDRESS) == 0) {
5594            deviceDesc->mAddress = String8((char *)node->value);
5595        } else if (strcmp(node->name, CHANNELS_TAG) == 0) {
5596            if (audio_is_input_device(type)) {
5597                deviceDesc->loadInChannels((char *)node->value);
5598            } else {
5599                deviceDesc->loadOutChannels((char *)node->value);
5600            }
5601        } else if (strcmp(node->name, GAINS_TAG) == 0) {
5602            deviceDesc->loadGains(node);
5603        }
5604        node = node->next;
5605    }
5606
5607    ALOGV("loadDevice() adding device name %s type %08x address %s",
5608          deviceDesc->mName.string(), type, deviceDesc->mAddress.string());
5609
5610    mDeclaredDevices.add(deviceDesc);
5611
5612    return NO_ERROR;
5613}
5614
5615void AudioPolicyManager::HwModule::dump(int fd)
5616{
5617    const size_t SIZE = 256;
5618    char buffer[SIZE];
5619    String8 result;
5620
5621    snprintf(buffer, SIZE, "  - name: %s\n", mName);
5622    result.append(buffer);
5623    snprintf(buffer, SIZE, "  - handle: %d\n", mHandle);
5624    result.append(buffer);
5625    snprintf(buffer, SIZE, "  - version: %u.%u\n", mHalVersion >> 8, mHalVersion & 0xFF);
5626    result.append(buffer);
5627    write(fd, result.string(), result.size());
5628    if (mOutputProfiles.size()) {
5629        write(fd, "  - outputs:\n", strlen("  - outputs:\n"));
5630        for (size_t i = 0; i < mOutputProfiles.size(); i++) {
5631            snprintf(buffer, SIZE, "    output %zu:\n", i);
5632            write(fd, buffer, strlen(buffer));
5633            mOutputProfiles[i]->dump(fd);
5634        }
5635    }
5636    if (mInputProfiles.size()) {
5637        write(fd, "  - inputs:\n", strlen("  - inputs:\n"));
5638        for (size_t i = 0; i < mInputProfiles.size(); i++) {
5639            snprintf(buffer, SIZE, "    input %zu:\n", i);
5640            write(fd, buffer, strlen(buffer));
5641            mInputProfiles[i]->dump(fd);
5642        }
5643    }
5644    if (mDeclaredDevices.size()) {
5645        write(fd, "  - devices:\n", strlen("  - devices:\n"));
5646        for (size_t i = 0; i < mDeclaredDevices.size(); i++) {
5647            mDeclaredDevices[i]->dump(fd, 4, i);
5648        }
5649    }
5650}
5651
5652// --- AudioPort class implementation
5653
5654
5655AudioPolicyManager::AudioPort::AudioPort(const String8& name, audio_port_type_t type,
5656          audio_port_role_t role, const sp<HwModule>& module) :
5657    mName(name), mType(type), mRole(role), mModule(module), mFlags((audio_output_flags_t)0)
5658{
5659    mUseInChannelMask = ((type == AUDIO_PORT_TYPE_DEVICE) && (role == AUDIO_PORT_ROLE_SOURCE)) ||
5660                    ((type == AUDIO_PORT_TYPE_MIX) && (role == AUDIO_PORT_ROLE_SINK));
5661}
5662
5663void AudioPolicyManager::AudioPort::toAudioPort(struct audio_port *port) const
5664{
5665    port->role = mRole;
5666    port->type = mType;
5667    unsigned int i;
5668    for (i = 0; i < mSamplingRates.size() && i < AUDIO_PORT_MAX_SAMPLING_RATES; i++) {
5669        if (mSamplingRates[i] != 0) {
5670            port->sample_rates[i] = mSamplingRates[i];
5671        }
5672    }
5673    port->num_sample_rates = i;
5674    for (i = 0; i < mChannelMasks.size() && i < AUDIO_PORT_MAX_CHANNEL_MASKS; i++) {
5675        if (mChannelMasks[i] != 0) {
5676            port->channel_masks[i] = mChannelMasks[i];
5677        }
5678    }
5679    port->num_channel_masks = i;
5680    for (i = 0; i < mFormats.size() && i < AUDIO_PORT_MAX_FORMATS; i++) {
5681        if (mFormats[i] != 0) {
5682            port->formats[i] = mFormats[i];
5683        }
5684    }
5685    port->num_formats = i;
5686
5687    ALOGV("AudioPort::toAudioPort() num gains %zu", mGains.size());
5688
5689    for (i = 0; i < mGains.size() && i < AUDIO_PORT_MAX_GAINS; i++) {
5690        port->gains[i] = mGains[i]->mGain;
5691    }
5692    port->num_gains = i;
5693}
5694
5695void AudioPolicyManager::AudioPort::importAudioPort(const sp<AudioPort> port) {
5696    for (size_t k = 0 ; k < port->mSamplingRates.size() ; k++) {
5697        const uint32_t rate = port->mSamplingRates.itemAt(k);
5698        if (rate != 0) { // skip "dynamic" rates
5699            bool hasRate = false;
5700            for (size_t l = 0 ; l < mSamplingRates.size() ; l++) {
5701                if (rate == mSamplingRates.itemAt(l)) {
5702                    hasRate = true;
5703                    break;
5704                }
5705            }
5706            if (!hasRate) { // never import a sampling rate twice
5707                mSamplingRates.add(rate);
5708            }
5709        }
5710    }
5711    for (size_t k = 0 ; k < port->mChannelMasks.size() ; k++) {
5712        const audio_channel_mask_t mask = port->mChannelMasks.itemAt(k);
5713        if (mask != 0) { // skip "dynamic" masks
5714            bool hasMask = false;
5715            for (size_t l = 0 ; l < mChannelMasks.size() ; l++) {
5716                if (mask == mChannelMasks.itemAt(l)) {
5717                    hasMask = true;
5718                    break;
5719                }
5720            }
5721            if (!hasMask) { // never import a channel mask twice
5722                mChannelMasks.add(mask);
5723            }
5724        }
5725    }
5726    for (size_t k = 0 ; k < port->mFormats.size() ; k++) {
5727        const audio_format_t format = port->mFormats.itemAt(k);
5728        if (format != 0) { // skip "dynamic" formats
5729            bool hasFormat = false;
5730            for (size_t l = 0 ; l < mFormats.size() ; l++) {
5731                if (format == mFormats.itemAt(l)) {
5732                    hasFormat = true;
5733                    break;
5734                }
5735            }
5736            if (!hasFormat) { // never import a channel mask twice
5737                mFormats.add(format);
5738            }
5739        }
5740    }
5741}
5742
5743void AudioPolicyManager::AudioPort::clearCapabilities() {
5744    mChannelMasks.clear();
5745    mFormats.clear();
5746    mSamplingRates.clear();
5747}
5748
5749void AudioPolicyManager::AudioPort::loadSamplingRates(char *name)
5750{
5751    char *str = strtok(name, "|");
5752
5753    // by convention, "0' in the first entry in mSamplingRates indicates the supported sampling
5754    // rates should be read from the output stream after it is opened for the first time
5755    if (str != NULL && strcmp(str, DYNAMIC_VALUE_TAG) == 0) {
5756        mSamplingRates.add(0);
5757        return;
5758    }
5759
5760    while (str != NULL) {
5761        uint32_t rate = atoi(str);
5762        if (rate != 0) {
5763            ALOGV("loadSamplingRates() adding rate %d", rate);
5764            mSamplingRates.add(rate);
5765        }
5766        str = strtok(NULL, "|");
5767    }
5768}
5769
5770void AudioPolicyManager::AudioPort::loadFormats(char *name)
5771{
5772    char *str = strtok(name, "|");
5773
5774    // by convention, "0' in the first entry in mFormats indicates the supported formats
5775    // should be read from the output stream after it is opened for the first time
5776    if (str != NULL && strcmp(str, DYNAMIC_VALUE_TAG) == 0) {
5777        mFormats.add(AUDIO_FORMAT_DEFAULT);
5778        return;
5779    }
5780
5781    while (str != NULL) {
5782        audio_format_t format = (audio_format_t)stringToEnum(sFormatNameToEnumTable,
5783                                                             ARRAY_SIZE(sFormatNameToEnumTable),
5784                                                             str);
5785        if (format != AUDIO_FORMAT_DEFAULT) {
5786            mFormats.add(format);
5787        }
5788        str = strtok(NULL, "|");
5789    }
5790}
5791
5792void AudioPolicyManager::AudioPort::loadInChannels(char *name)
5793{
5794    const char *str = strtok(name, "|");
5795
5796    ALOGV("loadInChannels() %s", name);
5797
5798    if (str != NULL && strcmp(str, DYNAMIC_VALUE_TAG) == 0) {
5799        mChannelMasks.add(0);
5800        return;
5801    }
5802
5803    while (str != NULL) {
5804        audio_channel_mask_t channelMask =
5805                (audio_channel_mask_t)stringToEnum(sInChannelsNameToEnumTable,
5806                                                   ARRAY_SIZE(sInChannelsNameToEnumTable),
5807                                                   str);
5808        if (channelMask != 0) {
5809            ALOGV("loadInChannels() adding channelMask %04x", channelMask);
5810            mChannelMasks.add(channelMask);
5811        }
5812        str = strtok(NULL, "|");
5813    }
5814}
5815
5816void AudioPolicyManager::AudioPort::loadOutChannels(char *name)
5817{
5818    const char *str = strtok(name, "|");
5819
5820    ALOGV("loadOutChannels() %s", name);
5821
5822    // by convention, "0' in the first entry in mChannelMasks indicates the supported channel
5823    // masks should be read from the output stream after it is opened for the first time
5824    if (str != NULL && strcmp(str, DYNAMIC_VALUE_TAG) == 0) {
5825        mChannelMasks.add(0);
5826        return;
5827    }
5828
5829    while (str != NULL) {
5830        audio_channel_mask_t channelMask =
5831                (audio_channel_mask_t)stringToEnum(sOutChannelsNameToEnumTable,
5832                                                   ARRAY_SIZE(sOutChannelsNameToEnumTable),
5833                                                   str);
5834        if (channelMask != 0) {
5835            mChannelMasks.add(channelMask);
5836        }
5837        str = strtok(NULL, "|");
5838    }
5839    return;
5840}
5841
5842audio_gain_mode_t AudioPolicyManager::AudioPort::loadGainMode(char *name)
5843{
5844    const char *str = strtok(name, "|");
5845
5846    ALOGV("loadGainMode() %s", name);
5847    audio_gain_mode_t mode = 0;
5848    while (str != NULL) {
5849        mode |= (audio_gain_mode_t)stringToEnum(sGainModeNameToEnumTable,
5850                                                ARRAY_SIZE(sGainModeNameToEnumTable),
5851                                                str);
5852        str = strtok(NULL, "|");
5853    }
5854    return mode;
5855}
5856
5857void AudioPolicyManager::AudioPort::loadGain(cnode *root, int index)
5858{
5859    cnode *node = root->first_child;
5860
5861    sp<AudioGain> gain = new AudioGain(index, mUseInChannelMask);
5862
5863    while (node) {
5864        if (strcmp(node->name, GAIN_MODE) == 0) {
5865            gain->mGain.mode = loadGainMode((char *)node->value);
5866        } else if (strcmp(node->name, GAIN_CHANNELS) == 0) {
5867            if (mUseInChannelMask) {
5868                gain->mGain.channel_mask =
5869                        (audio_channel_mask_t)stringToEnum(sInChannelsNameToEnumTable,
5870                                                           ARRAY_SIZE(sInChannelsNameToEnumTable),
5871                                                           (char *)node->value);
5872            } else {
5873                gain->mGain.channel_mask =
5874                        (audio_channel_mask_t)stringToEnum(sOutChannelsNameToEnumTable,
5875                                                           ARRAY_SIZE(sOutChannelsNameToEnumTable),
5876                                                           (char *)node->value);
5877            }
5878        } else if (strcmp(node->name, GAIN_MIN_VALUE) == 0) {
5879            gain->mGain.min_value = atoi((char *)node->value);
5880        } else if (strcmp(node->name, GAIN_MAX_VALUE) == 0) {
5881            gain->mGain.max_value = atoi((char *)node->value);
5882        } else if (strcmp(node->name, GAIN_DEFAULT_VALUE) == 0) {
5883            gain->mGain.default_value = atoi((char *)node->value);
5884        } else if (strcmp(node->name, GAIN_STEP_VALUE) == 0) {
5885            gain->mGain.step_value = atoi((char *)node->value);
5886        } else if (strcmp(node->name, GAIN_MIN_RAMP_MS) == 0) {
5887            gain->mGain.min_ramp_ms = atoi((char *)node->value);
5888        } else if (strcmp(node->name, GAIN_MAX_RAMP_MS) == 0) {
5889            gain->mGain.max_ramp_ms = atoi((char *)node->value);
5890        }
5891        node = node->next;
5892    }
5893
5894    ALOGV("loadGain() adding new gain mode %08x channel mask %08x min mB %d max mB %d",
5895          gain->mGain.mode, gain->mGain.channel_mask, gain->mGain.min_value, gain->mGain.max_value);
5896
5897    if (gain->mGain.mode == 0) {
5898        return;
5899    }
5900    mGains.add(gain);
5901}
5902
5903void AudioPolicyManager::AudioPort::loadGains(cnode *root)
5904{
5905    cnode *node = root->first_child;
5906    int index = 0;
5907    while (node) {
5908        ALOGV("loadGains() loading gain %s", node->name);
5909        loadGain(node, index++);
5910        node = node->next;
5911    }
5912}
5913
5914status_t AudioPolicyManager::AudioPort::checkExactSamplingRate(uint32_t samplingRate) const
5915{
5916    for (size_t i = 0; i < mSamplingRates.size(); i ++) {
5917        if (mSamplingRates[i] == samplingRate) {
5918            return NO_ERROR;
5919        }
5920    }
5921    return BAD_VALUE;
5922}
5923
5924status_t AudioPolicyManager::AudioPort::checkCompatibleSamplingRate(uint32_t samplingRate,
5925        uint32_t *updatedSamplingRate) const
5926{
5927    // Search for the closest supported sampling rate that is above (preferred)
5928    // or below (acceptable) the desired sampling rate, within a permitted ratio.
5929    // The sampling rates do not need to be sorted in ascending order.
5930    ssize_t maxBelow = -1;
5931    ssize_t minAbove = -1;
5932    uint32_t candidate;
5933    for (size_t i = 0; i < mSamplingRates.size(); i++) {
5934        candidate = mSamplingRates[i];
5935        if (candidate == samplingRate) {
5936            if (updatedSamplingRate != NULL) {
5937                *updatedSamplingRate = candidate;
5938            }
5939            return NO_ERROR;
5940        }
5941        // candidate < desired
5942        if (candidate < samplingRate) {
5943            if (maxBelow < 0 || candidate > mSamplingRates[maxBelow]) {
5944                maxBelow = i;
5945            }
5946        // candidate > desired
5947        } else {
5948            if (minAbove < 0 || candidate < mSamplingRates[minAbove]) {
5949                minAbove = i;
5950            }
5951        }
5952    }
5953    // This uses hard-coded knowledge about AudioFlinger resampling ratios.
5954    // TODO Move these assumptions out.
5955    static const uint32_t kMaxDownSampleRatio = 6;  // beyond this aliasing occurs
5956    static const uint32_t kMaxUpSampleRatio = 256;  // beyond this sample rate inaccuracies occur
5957                                                    // due to approximation by an int32_t of the
5958                                                    // phase increments
5959    // Prefer to down-sample from a higher sampling rate, as we get the desired frequency spectrum.
5960    if (minAbove >= 0) {
5961        candidate = mSamplingRates[minAbove];
5962        if (candidate / kMaxDownSampleRatio <= samplingRate) {
5963            if (updatedSamplingRate != NULL) {
5964                *updatedSamplingRate = candidate;
5965            }
5966            return NO_ERROR;
5967        }
5968    }
5969    // But if we have to up-sample from a lower sampling rate, that's OK.
5970    if (maxBelow >= 0) {
5971        candidate = mSamplingRates[maxBelow];
5972        if (candidate * kMaxUpSampleRatio >= samplingRate) {
5973            if (updatedSamplingRate != NULL) {
5974                *updatedSamplingRate = candidate;
5975            }
5976            return NO_ERROR;
5977        }
5978    }
5979    // leave updatedSamplingRate unmodified
5980    return BAD_VALUE;
5981}
5982
5983status_t AudioPolicyManager::AudioPort::checkExactChannelMask(audio_channel_mask_t channelMask) const
5984{
5985    for (size_t i = 0; i < mChannelMasks.size(); i++) {
5986        if (mChannelMasks[i] == channelMask) {
5987            return NO_ERROR;
5988        }
5989    }
5990    return BAD_VALUE;
5991}
5992
5993status_t AudioPolicyManager::AudioPort::checkCompatibleChannelMask(audio_channel_mask_t channelMask)
5994        const
5995{
5996    const bool isRecordThread = mType == AUDIO_PORT_TYPE_MIX && mRole == AUDIO_PORT_ROLE_SINK;
5997    for (size_t i = 0; i < mChannelMasks.size(); i ++) {
5998        // FIXME Does not handle multi-channel automatic conversions yet
5999        audio_channel_mask_t supported = mChannelMasks[i];
6000        if (supported == channelMask) {
6001            return NO_ERROR;
6002        }
6003        if (isRecordThread) {
6004            // This uses hard-coded knowledge that AudioFlinger can silently down-mix and up-mix.
6005            // FIXME Abstract this out to a table.
6006            if (((supported == AUDIO_CHANNEL_IN_FRONT_BACK || supported == AUDIO_CHANNEL_IN_STEREO)
6007                    && channelMask == AUDIO_CHANNEL_IN_MONO) ||
6008                (supported == AUDIO_CHANNEL_IN_MONO && (channelMask == AUDIO_CHANNEL_IN_FRONT_BACK
6009                    || channelMask == AUDIO_CHANNEL_IN_STEREO))) {
6010                return NO_ERROR;
6011            }
6012        }
6013    }
6014    return BAD_VALUE;
6015}
6016
6017status_t AudioPolicyManager::AudioPort::checkFormat(audio_format_t format) const
6018{
6019    for (size_t i = 0; i < mFormats.size(); i ++) {
6020        if (mFormats[i] == format) {
6021            return NO_ERROR;
6022        }
6023    }
6024    return BAD_VALUE;
6025}
6026
6027
6028uint32_t AudioPolicyManager::AudioPort::pickSamplingRate() const
6029{
6030    // special case for uninitialized dynamic profile
6031    if (mSamplingRates.size() == 1 && mSamplingRates[0] == 0) {
6032        return 0;
6033    }
6034
6035    // For direct outputs, pick minimum sampling rate: this helps ensuring that the
6036    // channel count / sampling rate combination chosen will be supported by the connected
6037    // sink
6038    if ((mType == AUDIO_PORT_TYPE_MIX) && (mRole == AUDIO_PORT_ROLE_SOURCE) &&
6039            (mFlags & (AUDIO_OUTPUT_FLAG_DIRECT | AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD))) {
6040        uint32_t samplingRate = UINT_MAX;
6041        for (size_t i = 0; i < mSamplingRates.size(); i ++) {
6042            if ((mSamplingRates[i] < samplingRate) && (mSamplingRates[i] > 0)) {
6043                samplingRate = mSamplingRates[i];
6044            }
6045        }
6046        return (samplingRate == UINT_MAX) ? 0 : samplingRate;
6047    }
6048
6049    uint32_t samplingRate = 0;
6050    uint32_t maxRate = MAX_MIXER_SAMPLING_RATE;
6051
6052    // For mixed output and inputs, use max mixer sampling rates. Do not
6053    // limit sampling rate otherwise
6054    if (mType != AUDIO_PORT_TYPE_MIX) {
6055        maxRate = UINT_MAX;
6056    }
6057    for (size_t i = 0; i < mSamplingRates.size(); i ++) {
6058        if ((mSamplingRates[i] > samplingRate) && (mSamplingRates[i] <= maxRate)) {
6059            samplingRate = mSamplingRates[i];
6060        }
6061    }
6062    return samplingRate;
6063}
6064
6065audio_channel_mask_t AudioPolicyManager::AudioPort::pickChannelMask() const
6066{
6067    // special case for uninitialized dynamic profile
6068    if (mChannelMasks.size() == 1 && mChannelMasks[0] == 0) {
6069        return AUDIO_CHANNEL_NONE;
6070    }
6071    audio_channel_mask_t channelMask = AUDIO_CHANNEL_NONE;
6072
6073    // For direct outputs, pick minimum channel count: this helps ensuring that the
6074    // channel count / sampling rate combination chosen will be supported by the connected
6075    // sink
6076    if ((mType == AUDIO_PORT_TYPE_MIX) && (mRole == AUDIO_PORT_ROLE_SOURCE) &&
6077            (mFlags & (AUDIO_OUTPUT_FLAG_DIRECT | AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD))) {
6078        uint32_t channelCount = UINT_MAX;
6079        for (size_t i = 0; i < mChannelMasks.size(); i ++) {
6080            uint32_t cnlCount;
6081            if (mUseInChannelMask) {
6082                cnlCount = audio_channel_count_from_in_mask(mChannelMasks[i]);
6083            } else {
6084                cnlCount = audio_channel_count_from_out_mask(mChannelMasks[i]);
6085            }
6086            if ((cnlCount < channelCount) && (cnlCount > 0)) {
6087                channelMask = mChannelMasks[i];
6088                channelCount = cnlCount;
6089            }
6090        }
6091        return channelMask;
6092    }
6093
6094    uint32_t channelCount = 0;
6095    uint32_t maxCount = MAX_MIXER_CHANNEL_COUNT;
6096
6097    // For mixed output and inputs, use max mixer channel count. Do not
6098    // limit channel count otherwise
6099    if (mType != AUDIO_PORT_TYPE_MIX) {
6100        maxCount = UINT_MAX;
6101    }
6102    for (size_t i = 0; i < mChannelMasks.size(); i ++) {
6103        uint32_t cnlCount;
6104        if (mUseInChannelMask) {
6105            cnlCount = audio_channel_count_from_in_mask(mChannelMasks[i]);
6106        } else {
6107            cnlCount = audio_channel_count_from_out_mask(mChannelMasks[i]);
6108        }
6109        if ((cnlCount > channelCount) && (cnlCount <= maxCount)) {
6110            channelMask = mChannelMasks[i];
6111            channelCount = cnlCount;
6112        }
6113    }
6114    return channelMask;
6115}
6116
6117/* format in order of increasing preference */
6118const audio_format_t AudioPolicyManager::AudioPort::sPcmFormatCompareTable[] = {
6119        AUDIO_FORMAT_DEFAULT,
6120        AUDIO_FORMAT_PCM_16_BIT,
6121        AUDIO_FORMAT_PCM_8_24_BIT,
6122        AUDIO_FORMAT_PCM_24_BIT_PACKED,
6123        AUDIO_FORMAT_PCM_32_BIT,
6124        AUDIO_FORMAT_PCM_FLOAT,
6125};
6126
6127int AudioPolicyManager::AudioPort::compareFormats(audio_format_t format1,
6128                                                  audio_format_t format2)
6129{
6130    // NOTE: AUDIO_FORMAT_INVALID is also considered not PCM and will be compared equal to any
6131    // compressed format and better than any PCM format. This is by design of pickFormat()
6132    if (!audio_is_linear_pcm(format1)) {
6133        if (!audio_is_linear_pcm(format2)) {
6134            return 0;
6135        }
6136        return 1;
6137    }
6138    if (!audio_is_linear_pcm(format2)) {
6139        return -1;
6140    }
6141
6142    int index1 = -1, index2 = -1;
6143    for (size_t i = 0;
6144            (i < ARRAY_SIZE(sPcmFormatCompareTable)) && ((index1 == -1) || (index2 == -1));
6145            i ++) {
6146        if (sPcmFormatCompareTable[i] == format1) {
6147            index1 = i;
6148        }
6149        if (sPcmFormatCompareTable[i] == format2) {
6150            index2 = i;
6151        }
6152    }
6153    // format1 not found => index1 < 0 => format2 > format1
6154    // format2 not found => index2 < 0 => format2 < format1
6155    return index1 - index2;
6156}
6157
6158audio_format_t AudioPolicyManager::AudioPort::pickFormat() const
6159{
6160    // special case for uninitialized dynamic profile
6161    if (mFormats.size() == 1 && mFormats[0] == 0) {
6162        return AUDIO_FORMAT_DEFAULT;
6163    }
6164
6165    audio_format_t format = AUDIO_FORMAT_DEFAULT;
6166    audio_format_t bestFormat =
6167            AudioPolicyManager::AudioPort::sPcmFormatCompareTable[
6168                ARRAY_SIZE(AudioPolicyManager::AudioPort::sPcmFormatCompareTable) - 1];
6169    // For mixed output and inputs, use best mixer output format. Do not
6170    // limit format otherwise
6171    if ((mType != AUDIO_PORT_TYPE_MIX) ||
6172            ((mRole == AUDIO_PORT_ROLE_SOURCE) &&
6173             (((mFlags & (AUDIO_OUTPUT_FLAG_DIRECT | AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD)) != 0)))) {
6174        bestFormat = AUDIO_FORMAT_INVALID;
6175    }
6176
6177    for (size_t i = 0; i < mFormats.size(); i ++) {
6178        if ((compareFormats(mFormats[i], format) > 0) &&
6179                (compareFormats(mFormats[i], bestFormat) <= 0)) {
6180            format = mFormats[i];
6181        }
6182    }
6183    return format;
6184}
6185
6186status_t AudioPolicyManager::AudioPort::checkGain(const struct audio_gain_config *gainConfig,
6187                                                  int index) const
6188{
6189    if (index < 0 || (size_t)index >= mGains.size()) {
6190        return BAD_VALUE;
6191    }
6192    return mGains[index]->checkConfig(gainConfig);
6193}
6194
6195void AudioPolicyManager::AudioPort::dump(int fd, int spaces) const
6196{
6197    const size_t SIZE = 256;
6198    char buffer[SIZE];
6199    String8 result;
6200
6201    if (mName.size() != 0) {
6202        snprintf(buffer, SIZE, "%*s- name: %s\n", spaces, "", mName.string());
6203        result.append(buffer);
6204    }
6205
6206    if (mSamplingRates.size() != 0) {
6207        snprintf(buffer, SIZE, "%*s- sampling rates: ", spaces, "");
6208        result.append(buffer);
6209        for (size_t i = 0; i < mSamplingRates.size(); i++) {
6210            if (i == 0 && mSamplingRates[i] == 0) {
6211                snprintf(buffer, SIZE, "Dynamic");
6212            } else {
6213                snprintf(buffer, SIZE, "%d", mSamplingRates[i]);
6214            }
6215            result.append(buffer);
6216            result.append(i == (mSamplingRates.size() - 1) ? "" : ", ");
6217        }
6218        result.append("\n");
6219    }
6220
6221    if (mChannelMasks.size() != 0) {
6222        snprintf(buffer, SIZE, "%*s- channel masks: ", spaces, "");
6223        result.append(buffer);
6224        for (size_t i = 0; i < mChannelMasks.size(); i++) {
6225            ALOGV("AudioPort::dump mChannelMasks %zu %08x", i, mChannelMasks[i]);
6226
6227            if (i == 0 && mChannelMasks[i] == 0) {
6228                snprintf(buffer, SIZE, "Dynamic");
6229            } else {
6230                snprintf(buffer, SIZE, "0x%04x", mChannelMasks[i]);
6231            }
6232            result.append(buffer);
6233            result.append(i == (mChannelMasks.size() - 1) ? "" : ", ");
6234        }
6235        result.append("\n");
6236    }
6237
6238    if (mFormats.size() != 0) {
6239        snprintf(buffer, SIZE, "%*s- formats: ", spaces, "");
6240        result.append(buffer);
6241        for (size_t i = 0; i < mFormats.size(); i++) {
6242            const char *formatStr = enumToString(sFormatNameToEnumTable,
6243                                                 ARRAY_SIZE(sFormatNameToEnumTable),
6244                                                 mFormats[i]);
6245            if (i == 0 && strcmp(formatStr, "") == 0) {
6246                snprintf(buffer, SIZE, "Dynamic");
6247            } else {
6248                snprintf(buffer, SIZE, "%s", formatStr);
6249            }
6250            result.append(buffer);
6251            result.append(i == (mFormats.size() - 1) ? "" : ", ");
6252        }
6253        result.append("\n");
6254    }
6255    write(fd, result.string(), result.size());
6256    if (mGains.size() != 0) {
6257        snprintf(buffer, SIZE, "%*s- gains:\n", spaces, "");
6258        write(fd, buffer, strlen(buffer) + 1);
6259        result.append(buffer);
6260        for (size_t i = 0; i < mGains.size(); i++) {
6261            mGains[i]->dump(fd, spaces + 2, i);
6262        }
6263    }
6264}
6265
6266// --- AudioGain class implementation
6267
6268AudioPolicyManager::AudioGain::AudioGain(int index, bool useInChannelMask)
6269{
6270    mIndex = index;
6271    mUseInChannelMask = useInChannelMask;
6272    memset(&mGain, 0, sizeof(struct audio_gain));
6273}
6274
6275void AudioPolicyManager::AudioGain::getDefaultConfig(struct audio_gain_config *config)
6276{
6277    config->index = mIndex;
6278    config->mode = mGain.mode;
6279    config->channel_mask = mGain.channel_mask;
6280    if ((mGain.mode & AUDIO_GAIN_MODE_JOINT) == AUDIO_GAIN_MODE_JOINT) {
6281        config->values[0] = mGain.default_value;
6282    } else {
6283        uint32_t numValues;
6284        if (mUseInChannelMask) {
6285            numValues = audio_channel_count_from_in_mask(mGain.channel_mask);
6286        } else {
6287            numValues = audio_channel_count_from_out_mask(mGain.channel_mask);
6288        }
6289        for (size_t i = 0; i < numValues; i++) {
6290            config->values[i] = mGain.default_value;
6291        }
6292    }
6293    if ((mGain.mode & AUDIO_GAIN_MODE_RAMP) == AUDIO_GAIN_MODE_RAMP) {
6294        config->ramp_duration_ms = mGain.min_ramp_ms;
6295    }
6296}
6297
6298status_t AudioPolicyManager::AudioGain::checkConfig(const struct audio_gain_config *config)
6299{
6300    if ((config->mode & ~mGain.mode) != 0) {
6301        return BAD_VALUE;
6302    }
6303    if ((config->mode & AUDIO_GAIN_MODE_JOINT) == AUDIO_GAIN_MODE_JOINT) {
6304        if ((config->values[0] < mGain.min_value) ||
6305                    (config->values[0] > mGain.max_value)) {
6306            return BAD_VALUE;
6307        }
6308    } else {
6309        if ((config->channel_mask & ~mGain.channel_mask) != 0) {
6310            return BAD_VALUE;
6311        }
6312        uint32_t numValues;
6313        if (mUseInChannelMask) {
6314            numValues = audio_channel_count_from_in_mask(config->channel_mask);
6315        } else {
6316            numValues = audio_channel_count_from_out_mask(config->channel_mask);
6317        }
6318        for (size_t i = 0; i < numValues; i++) {
6319            if ((config->values[i] < mGain.min_value) ||
6320                    (config->values[i] > mGain.max_value)) {
6321                return BAD_VALUE;
6322            }
6323        }
6324    }
6325    if ((config->mode & AUDIO_GAIN_MODE_RAMP) == AUDIO_GAIN_MODE_RAMP) {
6326        if ((config->ramp_duration_ms < mGain.min_ramp_ms) ||
6327                    (config->ramp_duration_ms > mGain.max_ramp_ms)) {
6328            return BAD_VALUE;
6329        }
6330    }
6331    return NO_ERROR;
6332}
6333
6334void AudioPolicyManager::AudioGain::dump(int fd, int spaces, int index) const
6335{
6336    const size_t SIZE = 256;
6337    char buffer[SIZE];
6338    String8 result;
6339
6340    snprintf(buffer, SIZE, "%*sGain %d:\n", spaces, "", index+1);
6341    result.append(buffer);
6342    snprintf(buffer, SIZE, "%*s- mode: %08x\n", spaces, "", mGain.mode);
6343    result.append(buffer);
6344    snprintf(buffer, SIZE, "%*s- channel_mask: %08x\n", spaces, "", mGain.channel_mask);
6345    result.append(buffer);
6346    snprintf(buffer, SIZE, "%*s- min_value: %d mB\n", spaces, "", mGain.min_value);
6347    result.append(buffer);
6348    snprintf(buffer, SIZE, "%*s- max_value: %d mB\n", spaces, "", mGain.max_value);
6349    result.append(buffer);
6350    snprintf(buffer, SIZE, "%*s- default_value: %d mB\n", spaces, "", mGain.default_value);
6351    result.append(buffer);
6352    snprintf(buffer, SIZE, "%*s- step_value: %d mB\n", spaces, "", mGain.step_value);
6353    result.append(buffer);
6354    snprintf(buffer, SIZE, "%*s- min_ramp_ms: %d ms\n", spaces, "", mGain.min_ramp_ms);
6355    result.append(buffer);
6356    snprintf(buffer, SIZE, "%*s- max_ramp_ms: %d ms\n", spaces, "", mGain.max_ramp_ms);
6357    result.append(buffer);
6358
6359    write(fd, result.string(), result.size());
6360}
6361
6362// --- AudioPortConfig class implementation
6363
6364AudioPolicyManager::AudioPortConfig::AudioPortConfig()
6365{
6366    mSamplingRate = 0;
6367    mChannelMask = AUDIO_CHANNEL_NONE;
6368    mFormat = AUDIO_FORMAT_INVALID;
6369    mGain.index = -1;
6370}
6371
6372status_t AudioPolicyManager::AudioPortConfig::applyAudioPortConfig(
6373                                                        const struct audio_port_config *config,
6374                                                        struct audio_port_config *backupConfig)
6375{
6376    struct audio_port_config localBackupConfig;
6377    status_t status = NO_ERROR;
6378
6379    localBackupConfig.config_mask = config->config_mask;
6380    toAudioPortConfig(&localBackupConfig);
6381
6382    sp<AudioPort> audioport = getAudioPort();
6383    if (audioport == 0) {
6384        status = NO_INIT;
6385        goto exit;
6386    }
6387    if (config->config_mask & AUDIO_PORT_CONFIG_SAMPLE_RATE) {
6388        status = audioport->checkExactSamplingRate(config->sample_rate);
6389        if (status != NO_ERROR) {
6390            goto exit;
6391        }
6392        mSamplingRate = config->sample_rate;
6393    }
6394    if (config->config_mask & AUDIO_PORT_CONFIG_CHANNEL_MASK) {
6395        status = audioport->checkExactChannelMask(config->channel_mask);
6396        if (status != NO_ERROR) {
6397            goto exit;
6398        }
6399        mChannelMask = config->channel_mask;
6400    }
6401    if (config->config_mask & AUDIO_PORT_CONFIG_FORMAT) {
6402        status = audioport->checkFormat(config->format);
6403        if (status != NO_ERROR) {
6404            goto exit;
6405        }
6406        mFormat = config->format;
6407    }
6408    if (config->config_mask & AUDIO_PORT_CONFIG_GAIN) {
6409        status = audioport->checkGain(&config->gain, config->gain.index);
6410        if (status != NO_ERROR) {
6411            goto exit;
6412        }
6413        mGain = config->gain;
6414    }
6415
6416exit:
6417    if (status != NO_ERROR) {
6418        applyAudioPortConfig(&localBackupConfig);
6419    }
6420    if (backupConfig != NULL) {
6421        *backupConfig = localBackupConfig;
6422    }
6423    return status;
6424}
6425
6426void AudioPolicyManager::AudioPortConfig::toAudioPortConfig(
6427                                                    struct audio_port_config *dstConfig,
6428                                                    const struct audio_port_config *srcConfig) const
6429{
6430    if (dstConfig->config_mask & AUDIO_PORT_CONFIG_SAMPLE_RATE) {
6431        dstConfig->sample_rate = mSamplingRate;
6432        if ((srcConfig != NULL) && (srcConfig->config_mask & AUDIO_PORT_CONFIG_SAMPLE_RATE)) {
6433            dstConfig->sample_rate = srcConfig->sample_rate;
6434        }
6435    } else {
6436        dstConfig->sample_rate = 0;
6437    }
6438    if (dstConfig->config_mask & AUDIO_PORT_CONFIG_CHANNEL_MASK) {
6439        dstConfig->channel_mask = mChannelMask;
6440        if ((srcConfig != NULL) && (srcConfig->config_mask & AUDIO_PORT_CONFIG_CHANNEL_MASK)) {
6441            dstConfig->channel_mask = srcConfig->channel_mask;
6442        }
6443    } else {
6444        dstConfig->channel_mask = AUDIO_CHANNEL_NONE;
6445    }
6446    if (dstConfig->config_mask & AUDIO_PORT_CONFIG_FORMAT) {
6447        dstConfig->format = mFormat;
6448        if ((srcConfig != NULL) && (srcConfig->config_mask & AUDIO_PORT_CONFIG_FORMAT)) {
6449            dstConfig->format = srcConfig->format;
6450        }
6451    } else {
6452        dstConfig->format = AUDIO_FORMAT_INVALID;
6453    }
6454    if (dstConfig->config_mask & AUDIO_PORT_CONFIG_GAIN) {
6455        dstConfig->gain = mGain;
6456        if ((srcConfig != NULL) && (srcConfig->config_mask & AUDIO_PORT_CONFIG_GAIN)) {
6457            dstConfig->gain = srcConfig->gain;
6458        }
6459    } else {
6460        dstConfig->gain.index = -1;
6461    }
6462    if (dstConfig->gain.index != -1) {
6463        dstConfig->config_mask |= AUDIO_PORT_CONFIG_GAIN;
6464    } else {
6465        dstConfig->config_mask &= ~AUDIO_PORT_CONFIG_GAIN;
6466    }
6467}
6468
6469// --- IOProfile class implementation
6470
6471AudioPolicyManager::IOProfile::IOProfile(const String8& name, audio_port_role_t role,
6472                                         const sp<HwModule>& module)
6473    : AudioPort(name, AUDIO_PORT_TYPE_MIX, role, module)
6474{
6475}
6476
6477AudioPolicyManager::IOProfile::~IOProfile()
6478{
6479}
6480
6481// checks if the IO profile is compatible with specified parameters.
6482// Sampling rate, format and channel mask must be specified in order to
6483// get a valid a match
6484bool AudioPolicyManager::IOProfile::isCompatibleProfile(audio_devices_t device,
6485                                                            uint32_t samplingRate,
6486                                                            uint32_t *updatedSamplingRate,
6487                                                            audio_format_t format,
6488                                                            audio_channel_mask_t channelMask,
6489                                                            audio_output_flags_t flags) const
6490{
6491    const bool isPlaybackThread = mType == AUDIO_PORT_TYPE_MIX && mRole == AUDIO_PORT_ROLE_SOURCE;
6492    const bool isRecordThread = mType == AUDIO_PORT_TYPE_MIX && mRole == AUDIO_PORT_ROLE_SINK;
6493    ALOG_ASSERT(isPlaybackThread != isRecordThread);
6494
6495    if ((mSupportedDevices.types() & device) != device) {
6496        return false;
6497    }
6498
6499    if (samplingRate == 0) {
6500         return false;
6501    }
6502    uint32_t myUpdatedSamplingRate = samplingRate;
6503    if (isPlaybackThread && checkExactSamplingRate(samplingRate) != NO_ERROR) {
6504         return false;
6505    }
6506    if (isRecordThread && checkCompatibleSamplingRate(samplingRate, &myUpdatedSamplingRate) !=
6507            NO_ERROR) {
6508         return false;
6509    }
6510
6511    if (!audio_is_valid_format(format) || checkFormat(format) != NO_ERROR) {
6512        return false;
6513    }
6514
6515    if (isPlaybackThread && (!audio_is_output_channel(channelMask) ||
6516            checkExactChannelMask(channelMask) != NO_ERROR)) {
6517        return false;
6518    }
6519    if (isRecordThread && (!audio_is_input_channel(channelMask) ||
6520            checkCompatibleChannelMask(channelMask) != NO_ERROR)) {
6521        return false;
6522    }
6523
6524    if (isPlaybackThread && (mFlags & flags) != flags) {
6525        return false;
6526    }
6527    // The only input flag that is allowed to be different is the fast flag.
6528    // An existing fast stream is compatible with a normal track request.
6529    // An existing normal stream is compatible with a fast track request,
6530    // but the fast request will be denied by AudioFlinger and converted to normal track.
6531    if (isRecordThread && (((audio_input_flags_t) mFlags ^ (audio_input_flags_t) flags) &
6532            ~AUDIO_INPUT_FLAG_FAST)) {
6533        return false;
6534    }
6535
6536    if (updatedSamplingRate != NULL) {
6537        *updatedSamplingRate = myUpdatedSamplingRate;
6538    }
6539    return true;
6540}
6541
6542void AudioPolicyManager::IOProfile::dump(int fd)
6543{
6544    const size_t SIZE = 256;
6545    char buffer[SIZE];
6546    String8 result;
6547
6548    AudioPort::dump(fd, 4);
6549
6550    snprintf(buffer, SIZE, "    - flags: 0x%04x\n", mFlags);
6551    result.append(buffer);
6552    snprintf(buffer, SIZE, "    - devices:\n");
6553    result.append(buffer);
6554    write(fd, result.string(), result.size());
6555    for (size_t i = 0; i < mSupportedDevices.size(); i++) {
6556        mSupportedDevices[i]->dump(fd, 6, i);
6557    }
6558}
6559
6560void AudioPolicyManager::IOProfile::log()
6561{
6562    const size_t SIZE = 256;
6563    char buffer[SIZE];
6564    String8 result;
6565
6566    ALOGV("    - sampling rates: ");
6567    for (size_t i = 0; i < mSamplingRates.size(); i++) {
6568        ALOGV("  %d", mSamplingRates[i]);
6569    }
6570
6571    ALOGV("    - channel masks: ");
6572    for (size_t i = 0; i < mChannelMasks.size(); i++) {
6573        ALOGV("  0x%04x", mChannelMasks[i]);
6574    }
6575
6576    ALOGV("    - formats: ");
6577    for (size_t i = 0; i < mFormats.size(); i++) {
6578        ALOGV("  0x%08x", mFormats[i]);
6579    }
6580
6581    ALOGV("    - devices: 0x%04x\n", mSupportedDevices.types());
6582    ALOGV("    - flags: 0x%04x\n", mFlags);
6583}
6584
6585
6586// --- DeviceDescriptor implementation
6587
6588
6589AudioPolicyManager::DeviceDescriptor::DeviceDescriptor(const String8& name, audio_devices_t type) :
6590                     AudioPort(name, AUDIO_PORT_TYPE_DEVICE,
6591                               audio_is_output_device(type) ? AUDIO_PORT_ROLE_SINK :
6592                                                              AUDIO_PORT_ROLE_SOURCE,
6593                             NULL),
6594                     mDeviceType(type), mAddress(""), mId(0)
6595{
6596    if (mGains.size() > 0) {
6597        mGains[0]->getDefaultConfig(&mGain);
6598    }
6599}
6600
6601bool AudioPolicyManager::DeviceDescriptor::equals(const sp<DeviceDescriptor>& other) const
6602{
6603    // Devices are considered equal if they:
6604    // - are of the same type (a device type cannot be AUDIO_DEVICE_NONE)
6605    // - have the same address or one device does not specify the address
6606    // - have the same channel mask or one device does not specify the channel mask
6607    return (mDeviceType == other->mDeviceType) &&
6608           (mAddress == "" || other->mAddress == "" || mAddress == other->mAddress) &&
6609           (mChannelMask == 0 || other->mChannelMask == 0 ||
6610                mChannelMask == other->mChannelMask);
6611}
6612
6613void AudioPolicyManager::DeviceVector::refreshTypes()
6614{
6615    mDeviceTypes = AUDIO_DEVICE_NONE;
6616    for(size_t i = 0; i < size(); i++) {
6617        mDeviceTypes |= itemAt(i)->mDeviceType;
6618    }
6619    ALOGV("DeviceVector::refreshTypes() mDeviceTypes %08x", mDeviceTypes);
6620}
6621
6622ssize_t AudioPolicyManager::DeviceVector::indexOf(const sp<DeviceDescriptor>& item) const
6623{
6624    for(size_t i = 0; i < size(); i++) {
6625        if (item->equals(itemAt(i))) {
6626            return i;
6627        }
6628    }
6629    return -1;
6630}
6631
6632ssize_t AudioPolicyManager::DeviceVector::add(const sp<DeviceDescriptor>& item)
6633{
6634    ssize_t ret = indexOf(item);
6635
6636    if (ret < 0) {
6637        ret = SortedVector::add(item);
6638        if (ret >= 0) {
6639            refreshTypes();
6640        }
6641    } else {
6642        ALOGW("DeviceVector::add device %08x already in", item->mDeviceType);
6643        ret = -1;
6644    }
6645    return ret;
6646}
6647
6648ssize_t AudioPolicyManager::DeviceVector::remove(const sp<DeviceDescriptor>& item)
6649{
6650    size_t i;
6651    ssize_t ret = indexOf(item);
6652
6653    if (ret < 0) {
6654        ALOGW("DeviceVector::remove device %08x not in", item->mDeviceType);
6655    } else {
6656        ret = SortedVector::removeAt(ret);
6657        if (ret >= 0) {
6658            refreshTypes();
6659        }
6660    }
6661    return ret;
6662}
6663
6664void AudioPolicyManager::DeviceVector::loadDevicesFromType(audio_devices_t types)
6665{
6666    DeviceVector deviceList;
6667
6668    uint32_t role_bit = AUDIO_DEVICE_BIT_IN & types;
6669    types &= ~role_bit;
6670
6671    while (types) {
6672        uint32_t i = 31 - __builtin_clz(types);
6673        uint32_t type = 1 << i;
6674        types &= ~type;
6675        add(new DeviceDescriptor(String8(""), type | role_bit));
6676    }
6677}
6678
6679void AudioPolicyManager::DeviceVector::loadDevicesFromName(char *name,
6680                                                           const DeviceVector& declaredDevices)
6681{
6682    char *devName = strtok(name, "|");
6683    while (devName != NULL) {
6684        if (strlen(devName) != 0) {
6685            audio_devices_t type = stringToEnum(sDeviceNameToEnumTable,
6686                                 ARRAY_SIZE(sDeviceNameToEnumTable),
6687                                 devName);
6688            if (type != AUDIO_DEVICE_NONE) {
6689                add(new DeviceDescriptor(String8(""), type));
6690            } else {
6691                sp<DeviceDescriptor> deviceDesc =
6692                        declaredDevices.getDeviceFromName(String8(devName));
6693                if (deviceDesc != 0) {
6694                    add(deviceDesc);
6695                }
6696            }
6697         }
6698        devName = strtok(NULL, "|");
6699     }
6700}
6701
6702sp<AudioPolicyManager::DeviceDescriptor> AudioPolicyManager::DeviceVector::getDevice(
6703                                                        audio_devices_t type, String8 address) const
6704{
6705    sp<DeviceDescriptor> device;
6706    for (size_t i = 0; i < size(); i++) {
6707        if (itemAt(i)->mDeviceType == type) {
6708            device = itemAt(i);
6709            if (itemAt(i)->mAddress = address) {
6710                break;
6711            }
6712        }
6713    }
6714    ALOGV("DeviceVector::getDevice() for type %d address %s found %p",
6715          type, address.string(), device.get());
6716    return device;
6717}
6718
6719sp<AudioPolicyManager::DeviceDescriptor> AudioPolicyManager::DeviceVector::getDeviceFromId(
6720                                                                    audio_port_handle_t id) const
6721{
6722    sp<DeviceDescriptor> device;
6723    for (size_t i = 0; i < size(); i++) {
6724        ALOGV("DeviceVector::getDeviceFromId(%d) itemAt(%zu)->mId %d", id, i, itemAt(i)->mId);
6725        if (itemAt(i)->mId == id) {
6726            device = itemAt(i);
6727            break;
6728        }
6729    }
6730    return device;
6731}
6732
6733AudioPolicyManager::DeviceVector AudioPolicyManager::DeviceVector::getDevicesFromType(
6734                                                                        audio_devices_t type) const
6735{
6736    DeviceVector devices;
6737    for (size_t i = 0; (i < size()) && (type != AUDIO_DEVICE_NONE); i++) {
6738        if (itemAt(i)->mDeviceType & type & ~AUDIO_DEVICE_BIT_IN) {
6739            devices.add(itemAt(i));
6740            type &= ~itemAt(i)->mDeviceType;
6741            ALOGV("DeviceVector::getDevicesFromType() for type %x found %p",
6742                  itemAt(i)->mDeviceType, itemAt(i).get());
6743        }
6744    }
6745    return devices;
6746}
6747
6748AudioPolicyManager::DeviceVector AudioPolicyManager::DeviceVector::getDevicesFromTypeAddr(
6749        audio_devices_t type, String8 address) const
6750{
6751    DeviceVector devices;
6752    //ALOGV("   looking for device=%x, addr=%s", type, address.string());
6753    for (size_t i = 0; i < size(); i++) {
6754        //ALOGV("     at i=%d: device=%x, addr=%s",
6755        //        i, itemAt(i)->mDeviceType, itemAt(i)->mAddress.string());
6756        if (itemAt(i)->mDeviceType == type) {
6757            if (itemAt(i)->mAddress == address) {
6758                //ALOGV("      found matching address %s", address.string());
6759                devices.add(itemAt(i));
6760            }
6761        }
6762    }
6763    return devices;
6764}
6765
6766sp<AudioPolicyManager::DeviceDescriptor> AudioPolicyManager::DeviceVector::getDeviceFromName(
6767        const String8& name) const
6768{
6769    sp<DeviceDescriptor> device;
6770    for (size_t i = 0; i < size(); i++) {
6771        if (itemAt(i)->mName == name) {
6772            device = itemAt(i);
6773            break;
6774        }
6775    }
6776    return device;
6777}
6778
6779void AudioPolicyManager::DeviceDescriptor::toAudioPortConfig(
6780                                                    struct audio_port_config *dstConfig,
6781                                                    const struct audio_port_config *srcConfig) const
6782{
6783    dstConfig->config_mask = AUDIO_PORT_CONFIG_CHANNEL_MASK|AUDIO_PORT_CONFIG_GAIN;
6784    if (srcConfig != NULL) {
6785        dstConfig->config_mask |= srcConfig->config_mask;
6786    }
6787
6788    AudioPortConfig::toAudioPortConfig(dstConfig, srcConfig);
6789
6790    dstConfig->id = mId;
6791    dstConfig->role = audio_is_output_device(mDeviceType) ?
6792                        AUDIO_PORT_ROLE_SINK : AUDIO_PORT_ROLE_SOURCE;
6793    dstConfig->type = AUDIO_PORT_TYPE_DEVICE;
6794    dstConfig->ext.device.type = mDeviceType;
6795    dstConfig->ext.device.hw_module = mModule->mHandle;
6796    strncpy(dstConfig->ext.device.address, mAddress.string(), AUDIO_DEVICE_MAX_ADDRESS_LEN);
6797}
6798
6799void AudioPolicyManager::DeviceDescriptor::toAudioPort(struct audio_port *port) const
6800{
6801    ALOGV("DeviceDescriptor::toAudioPort() handle %d type %x", mId, mDeviceType);
6802    AudioPort::toAudioPort(port);
6803    port->id = mId;
6804    toAudioPortConfig(&port->active_config);
6805    port->ext.device.type = mDeviceType;
6806    port->ext.device.hw_module = mModule->mHandle;
6807    strncpy(port->ext.device.address, mAddress.string(), AUDIO_DEVICE_MAX_ADDRESS_LEN);
6808}
6809
6810status_t AudioPolicyManager::DeviceDescriptor::dump(int fd, int spaces, int index) const
6811{
6812    const size_t SIZE = 256;
6813    char buffer[SIZE];
6814    String8 result;
6815
6816    snprintf(buffer, SIZE, "%*sDevice %d:\n", spaces, "", index+1);
6817    result.append(buffer);
6818    if (mId != 0) {
6819        snprintf(buffer, SIZE, "%*s- id: %2d\n", spaces, "", mId);
6820        result.append(buffer);
6821    }
6822    snprintf(buffer, SIZE, "%*s- type: %-48s\n", spaces, "",
6823                                              enumToString(sDeviceNameToEnumTable,
6824                                                           ARRAY_SIZE(sDeviceNameToEnumTable),
6825                                                           mDeviceType));
6826    result.append(buffer);
6827    if (mAddress.size() != 0) {
6828        snprintf(buffer, SIZE, "%*s- address: %-32s\n", spaces, "", mAddress.string());
6829        result.append(buffer);
6830    }
6831    write(fd, result.string(), result.size());
6832    AudioPort::dump(fd, spaces);
6833
6834    return NO_ERROR;
6835}
6836
6837status_t AudioPolicyManager::AudioPatch::dump(int fd, int spaces, int index) const
6838{
6839    const size_t SIZE = 256;
6840    char buffer[SIZE];
6841    String8 result;
6842
6843
6844    snprintf(buffer, SIZE, "%*sAudio patch %d:\n", spaces, "", index+1);
6845    result.append(buffer);
6846    snprintf(buffer, SIZE, "%*s- handle: %2d\n", spaces, "", mHandle);
6847    result.append(buffer);
6848    snprintf(buffer, SIZE, "%*s- audio flinger handle: %2d\n", spaces, "", mAfPatchHandle);
6849    result.append(buffer);
6850    snprintf(buffer, SIZE, "%*s- owner uid: %2d\n", spaces, "", mUid);
6851    result.append(buffer);
6852    snprintf(buffer, SIZE, "%*s- %d sources:\n", spaces, "", mPatch.num_sources);
6853    result.append(buffer);
6854    for (size_t i = 0; i < mPatch.num_sources; i++) {
6855        if (mPatch.sources[i].type == AUDIO_PORT_TYPE_DEVICE) {
6856            snprintf(buffer, SIZE, "%*s- Device ID %d %s\n", spaces + 2, "",
6857                     mPatch.sources[i].id, enumToString(sDeviceNameToEnumTable,
6858                                                        ARRAY_SIZE(sDeviceNameToEnumTable),
6859                                                        mPatch.sources[i].ext.device.type));
6860        } else {
6861            snprintf(buffer, SIZE, "%*s- Mix ID %d I/O handle %d\n", spaces + 2, "",
6862                     mPatch.sources[i].id, mPatch.sources[i].ext.mix.handle);
6863        }
6864        result.append(buffer);
6865    }
6866    snprintf(buffer, SIZE, "%*s- %d sinks:\n", spaces, "", mPatch.num_sinks);
6867    result.append(buffer);
6868    for (size_t i = 0; i < mPatch.num_sinks; i++) {
6869        if (mPatch.sinks[i].type == AUDIO_PORT_TYPE_DEVICE) {
6870            snprintf(buffer, SIZE, "%*s- Device ID %d %s\n", spaces + 2, "",
6871                     mPatch.sinks[i].id, enumToString(sDeviceNameToEnumTable,
6872                                                        ARRAY_SIZE(sDeviceNameToEnumTable),
6873                                                        mPatch.sinks[i].ext.device.type));
6874        } else {
6875            snprintf(buffer, SIZE, "%*s- Mix ID %d I/O handle %d\n", spaces + 2, "",
6876                     mPatch.sinks[i].id, mPatch.sinks[i].ext.mix.handle);
6877        }
6878        result.append(buffer);
6879    }
6880
6881    write(fd, result.string(), result.size());
6882    return NO_ERROR;
6883}
6884
6885// --- audio_policy.conf file parsing
6886
6887audio_output_flags_t AudioPolicyManager::parseFlagNames(char *name)
6888{
6889    uint32_t flag = 0;
6890
6891    // it is OK to cast name to non const here as we are not going to use it after
6892    // strtok() modifies it
6893    char *flagName = strtok(name, "|");
6894    while (flagName != NULL) {
6895        if (strlen(flagName) != 0) {
6896            flag |= stringToEnum(sFlagNameToEnumTable,
6897                               ARRAY_SIZE(sFlagNameToEnumTable),
6898                               flagName);
6899        }
6900        flagName = strtok(NULL, "|");
6901    }
6902    //force direct flag if offload flag is set: offloading implies a direct output stream
6903    // and all common behaviors are driven by checking only the direct flag
6904    // this should normally be set appropriately in the policy configuration file
6905    if ((flag & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD) != 0) {
6906        flag |= AUDIO_OUTPUT_FLAG_DIRECT;
6907    }
6908
6909    return (audio_output_flags_t)flag;
6910}
6911
6912audio_devices_t AudioPolicyManager::parseDeviceNames(char *name)
6913{
6914    uint32_t device = 0;
6915
6916    char *devName = strtok(name, "|");
6917    while (devName != NULL) {
6918        if (strlen(devName) != 0) {
6919            device |= stringToEnum(sDeviceNameToEnumTable,
6920                                 ARRAY_SIZE(sDeviceNameToEnumTable),
6921                                 devName);
6922         }
6923        devName = strtok(NULL, "|");
6924     }
6925    return device;
6926}
6927
6928void AudioPolicyManager::loadHwModule(cnode *root)
6929{
6930    status_t status = NAME_NOT_FOUND;
6931    cnode *node;
6932    sp<HwModule> module = new HwModule(root->name);
6933
6934    node = config_find(root, DEVICES_TAG);
6935    if (node != NULL) {
6936        node = node->first_child;
6937        while (node) {
6938            ALOGV("loadHwModule() loading device %s", node->name);
6939            status_t tmpStatus = module->loadDevice(node);
6940            if (status == NAME_NOT_FOUND || status == NO_ERROR) {
6941                status = tmpStatus;
6942            }
6943            node = node->next;
6944        }
6945    }
6946    node = config_find(root, OUTPUTS_TAG);
6947    if (node != NULL) {
6948        node = node->first_child;
6949        while (node) {
6950            ALOGV("loadHwModule() loading output %s", node->name);
6951            status_t tmpStatus = module->loadOutput(node);
6952            if (status == NAME_NOT_FOUND || status == NO_ERROR) {
6953                status = tmpStatus;
6954            }
6955            node = node->next;
6956        }
6957    }
6958    node = config_find(root, INPUTS_TAG);
6959    if (node != NULL) {
6960        node = node->first_child;
6961        while (node) {
6962            ALOGV("loadHwModule() loading input %s", node->name);
6963            status_t tmpStatus = module->loadInput(node);
6964            if (status == NAME_NOT_FOUND || status == NO_ERROR) {
6965                status = tmpStatus;
6966            }
6967            node = node->next;
6968        }
6969    }
6970    loadGlobalConfig(root, module);
6971
6972    if (status == NO_ERROR) {
6973        mHwModules.add(module);
6974    }
6975}
6976
6977void AudioPolicyManager::loadHwModules(cnode *root)
6978{
6979    cnode *node = config_find(root, AUDIO_HW_MODULE_TAG);
6980    if (node == NULL) {
6981        return;
6982    }
6983
6984    node = node->first_child;
6985    while (node) {
6986        ALOGV("loadHwModules() loading module %s", node->name);
6987        loadHwModule(node);
6988        node = node->next;
6989    }
6990}
6991
6992void AudioPolicyManager::loadGlobalConfig(cnode *root, const sp<HwModule>& module)
6993{
6994    cnode *node = config_find(root, GLOBAL_CONFIG_TAG);
6995
6996    if (node == NULL) {
6997        return;
6998    }
6999    DeviceVector declaredDevices;
7000    if (module != NULL) {
7001        declaredDevices = module->mDeclaredDevices;
7002    }
7003
7004    node = node->first_child;
7005    while (node) {
7006        if (strcmp(ATTACHED_OUTPUT_DEVICES_TAG, node->name) == 0) {
7007            mAvailableOutputDevices.loadDevicesFromName((char *)node->value,
7008                                                        declaredDevices);
7009            ALOGV("loadGlobalConfig() Attached Output Devices %08x",
7010                  mAvailableOutputDevices.types());
7011        } else if (strcmp(DEFAULT_OUTPUT_DEVICE_TAG, node->name) == 0) {
7012            audio_devices_t device = (audio_devices_t)stringToEnum(sDeviceNameToEnumTable,
7013                                              ARRAY_SIZE(sDeviceNameToEnumTable),
7014                                              (char *)node->value);
7015            if (device != AUDIO_DEVICE_NONE) {
7016                mDefaultOutputDevice = new DeviceDescriptor(String8(""), device);
7017            } else {
7018                ALOGW("loadGlobalConfig() default device not specified");
7019            }
7020            ALOGV("loadGlobalConfig() mDefaultOutputDevice %08x", mDefaultOutputDevice->mDeviceType);
7021        } else if (strcmp(ATTACHED_INPUT_DEVICES_TAG, node->name) == 0) {
7022            mAvailableInputDevices.loadDevicesFromName((char *)node->value,
7023                                                       declaredDevices);
7024            ALOGV("loadGlobalConfig() Available InputDevices %08x", mAvailableInputDevices.types());
7025        } else if (strcmp(SPEAKER_DRC_ENABLED_TAG, node->name) == 0) {
7026            mSpeakerDrcEnabled = stringToBool((char *)node->value);
7027            ALOGV("loadGlobalConfig() mSpeakerDrcEnabled = %d", mSpeakerDrcEnabled);
7028        } else if (strcmp(AUDIO_HAL_VERSION_TAG, node->name) == 0) {
7029            uint32_t major, minor;
7030            sscanf((char *)node->value, "%u.%u", &major, &minor);
7031            module->mHalVersion = HARDWARE_DEVICE_API_VERSION(major, minor);
7032            ALOGV("loadGlobalConfig() mHalVersion = %04x major %u minor %u",
7033                  module->mHalVersion, major, minor);
7034        }
7035        node = node->next;
7036    }
7037}
7038
7039status_t AudioPolicyManager::loadAudioPolicyConfig(const char *path)
7040{
7041    cnode *root;
7042    char *data;
7043
7044    data = (char *)load_file(path, NULL);
7045    if (data == NULL) {
7046        return -ENODEV;
7047    }
7048    root = config_node("", "");
7049    config_load(root, data);
7050
7051    loadHwModules(root);
7052    // legacy audio_policy.conf files have one global_configuration section
7053    loadGlobalConfig(root, getModuleFromName(AUDIO_HARDWARE_MODULE_ID_PRIMARY));
7054    config_free(root);
7055    free(root);
7056    free(data);
7057
7058    ALOGI("loadAudioPolicyConfig() loaded %s\n", path);
7059
7060    return NO_ERROR;
7061}
7062
7063void AudioPolicyManager::defaultAudioPolicyConfig(void)
7064{
7065    sp<HwModule> module;
7066    sp<IOProfile> profile;
7067    sp<DeviceDescriptor> defaultInputDevice = new DeviceDescriptor(String8(""),
7068                                                                   AUDIO_DEVICE_IN_BUILTIN_MIC);
7069    mAvailableOutputDevices.add(mDefaultOutputDevice);
7070    mAvailableInputDevices.add(defaultInputDevice);
7071
7072    module = new HwModule("primary");
7073
7074    profile = new IOProfile(String8("primary"), AUDIO_PORT_ROLE_SOURCE, module);
7075    profile->mSamplingRates.add(44100);
7076    profile->mFormats.add(AUDIO_FORMAT_PCM_16_BIT);
7077    profile->mChannelMasks.add(AUDIO_CHANNEL_OUT_STEREO);
7078    profile->mSupportedDevices.add(mDefaultOutputDevice);
7079    profile->mFlags = AUDIO_OUTPUT_FLAG_PRIMARY;
7080    module->mOutputProfiles.add(profile);
7081
7082    profile = new IOProfile(String8("primary"), AUDIO_PORT_ROLE_SINK, module);
7083    profile->mSamplingRates.add(8000);
7084    profile->mFormats.add(AUDIO_FORMAT_PCM_16_BIT);
7085    profile->mChannelMasks.add(AUDIO_CHANNEL_IN_MONO);
7086    profile->mSupportedDevices.add(defaultInputDevice);
7087    module->mInputProfiles.add(profile);
7088
7089    mHwModules.add(module);
7090}
7091
7092audio_stream_type_t AudioPolicyManager::streamTypefromAttributesInt(const audio_attributes_t *attr)
7093{
7094    // flags to stream type mapping
7095    if ((attr->flags & AUDIO_FLAG_AUDIBILITY_ENFORCED) == AUDIO_FLAG_AUDIBILITY_ENFORCED) {
7096        return AUDIO_STREAM_ENFORCED_AUDIBLE;
7097    }
7098    if ((attr->flags & AUDIO_FLAG_SCO) == AUDIO_FLAG_SCO) {
7099        return AUDIO_STREAM_BLUETOOTH_SCO;
7100    }
7101
7102    // usage to stream type mapping
7103    switch (attr->usage) {
7104    case AUDIO_USAGE_MEDIA:
7105    case AUDIO_USAGE_GAME:
7106    case AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY:
7107    case AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE:
7108        return AUDIO_STREAM_MUSIC;
7109    case AUDIO_USAGE_ASSISTANCE_SONIFICATION:
7110        return AUDIO_STREAM_SYSTEM;
7111    case AUDIO_USAGE_VOICE_COMMUNICATION:
7112        return AUDIO_STREAM_VOICE_CALL;
7113
7114    case AUDIO_USAGE_VOICE_COMMUNICATION_SIGNALLING:
7115        return AUDIO_STREAM_DTMF;
7116
7117    case AUDIO_USAGE_ALARM:
7118        return AUDIO_STREAM_ALARM;
7119    case AUDIO_USAGE_NOTIFICATION_TELEPHONY_RINGTONE:
7120        return AUDIO_STREAM_RING;
7121
7122    case AUDIO_USAGE_NOTIFICATION:
7123    case AUDIO_USAGE_NOTIFICATION_COMMUNICATION_REQUEST:
7124    case AUDIO_USAGE_NOTIFICATION_COMMUNICATION_INSTANT:
7125    case AUDIO_USAGE_NOTIFICATION_COMMUNICATION_DELAYED:
7126    case AUDIO_USAGE_NOTIFICATION_EVENT:
7127        return AUDIO_STREAM_NOTIFICATION;
7128
7129    case AUDIO_USAGE_UNKNOWN:
7130    default:
7131        return AUDIO_STREAM_MUSIC;
7132    }
7133}
7134}; // namespace android
7135