/* * Copyright (C) 2009 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #define LOG_TAG "AudioPolicyManager" //#define LOG_NDEBUG 0 //#define VERY_VERBOSE_LOGGING #ifdef VERY_VERBOSE_LOGGING #define ALOGVV ALOGV #else #define ALOGVV(a...) do { } while(0) #endif // A device mask for all audio input devices that are considered "virtual" when evaluating // active inputs in getActiveInput() #define APM_AUDIO_IN_DEVICE_VIRTUAL_ALL AUDIO_DEVICE_IN_REMOTE_SUBMIX // A device mask for all audio output devices that are considered "remote" when evaluating // active output devices in isStreamActiveRemotely() #define APM_AUDIO_OUT_DEVICE_REMOTE_ALL AUDIO_DEVICE_OUT_REMOTE_SUBMIX #include #include #include #include #include #include #include #include #include "AudioPolicyManager.h" namespace android { // ---------------------------------------------------------------------------- // Definitions for audio_policy.conf file parsing // ---------------------------------------------------------------------------- struct StringToEnum { const char *name; uint32_t value; }; #define STRING_TO_ENUM(string) { #string, string } #define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0])) const StringToEnum sDeviceNameToEnumTable[] = { STRING_TO_ENUM(AUDIO_DEVICE_OUT_EARPIECE), STRING_TO_ENUM(AUDIO_DEVICE_OUT_SPEAKER), STRING_TO_ENUM(AUDIO_DEVICE_OUT_WIRED_HEADSET), STRING_TO_ENUM(AUDIO_DEVICE_OUT_WIRED_HEADPHONE), STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_SCO), STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET), STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT), STRING_TO_ENUM(AUDIO_DEVICE_OUT_ALL_SCO), STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_A2DP), STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES), STRING_TO_ENUM(AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER), STRING_TO_ENUM(AUDIO_DEVICE_OUT_ALL_A2DP), STRING_TO_ENUM(AUDIO_DEVICE_OUT_AUX_DIGITAL), STRING_TO_ENUM(AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET), STRING_TO_ENUM(AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET), STRING_TO_ENUM(AUDIO_DEVICE_OUT_USB_ACCESSORY), STRING_TO_ENUM(AUDIO_DEVICE_OUT_USB_DEVICE), STRING_TO_ENUM(AUDIO_DEVICE_OUT_ALL_USB), STRING_TO_ENUM(AUDIO_DEVICE_OUT_REMOTE_SUBMIX), STRING_TO_ENUM(AUDIO_DEVICE_IN_BUILTIN_MIC), STRING_TO_ENUM(AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET), STRING_TO_ENUM(AUDIO_DEVICE_IN_ALL_SCO), STRING_TO_ENUM(AUDIO_DEVICE_IN_WIRED_HEADSET), STRING_TO_ENUM(AUDIO_DEVICE_IN_AUX_DIGITAL), STRING_TO_ENUM(AUDIO_DEVICE_IN_VOICE_CALL), STRING_TO_ENUM(AUDIO_DEVICE_IN_BACK_MIC), STRING_TO_ENUM(AUDIO_DEVICE_IN_REMOTE_SUBMIX), STRING_TO_ENUM(AUDIO_DEVICE_IN_ANLG_DOCK_HEADSET), STRING_TO_ENUM(AUDIO_DEVICE_IN_DGTL_DOCK_HEADSET), STRING_TO_ENUM(AUDIO_DEVICE_IN_USB_ACCESSORY), STRING_TO_ENUM(AUDIO_DEVICE_IN_USB_DEVICE), }; const StringToEnum sFlagNameToEnumTable[] = { STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_DIRECT), STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_PRIMARY), STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_FAST), STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_DEEP_BUFFER), STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD), STRING_TO_ENUM(AUDIO_OUTPUT_FLAG_NON_BLOCKING), }; const StringToEnum sFormatNameToEnumTable[] = { STRING_TO_ENUM(AUDIO_FORMAT_PCM_16_BIT), STRING_TO_ENUM(AUDIO_FORMAT_PCM_8_BIT), STRING_TO_ENUM(AUDIO_FORMAT_PCM_32_BIT), STRING_TO_ENUM(AUDIO_FORMAT_PCM_8_24_BIT), STRING_TO_ENUM(AUDIO_FORMAT_PCM_FLOAT), STRING_TO_ENUM(AUDIO_FORMAT_PCM_24_BIT_PACKED), STRING_TO_ENUM(AUDIO_FORMAT_MP3), STRING_TO_ENUM(AUDIO_FORMAT_AAC), STRING_TO_ENUM(AUDIO_FORMAT_VORBIS), }; const StringToEnum sOutChannelsNameToEnumTable[] = { STRING_TO_ENUM(AUDIO_CHANNEL_OUT_MONO), STRING_TO_ENUM(AUDIO_CHANNEL_OUT_STEREO), STRING_TO_ENUM(AUDIO_CHANNEL_OUT_5POINT1), STRING_TO_ENUM(AUDIO_CHANNEL_OUT_7POINT1), }; const StringToEnum sInChannelsNameToEnumTable[] = { STRING_TO_ENUM(AUDIO_CHANNEL_IN_MONO), STRING_TO_ENUM(AUDIO_CHANNEL_IN_STEREO), STRING_TO_ENUM(AUDIO_CHANNEL_IN_FRONT_BACK), }; uint32_t AudioPolicyManager::stringToEnum(const struct StringToEnum *table, size_t size, const char *name) { for (size_t i = 0; i < size; i++) { if (strcmp(table[i].name, name) == 0) { ALOGV("stringToEnum() found %s", table[i].name); return table[i].value; } } return 0; } const char *AudioPolicyManager::enumToString(const struct StringToEnum *table, size_t size, uint32_t value) { for (size_t i = 0; i < size; i++) { if (table[i].value == value) { return table[i].name; } } return ""; } bool AudioPolicyManager::stringToBool(const char *value) { return ((strcasecmp("true", value) == 0) || (strcmp("1", value) == 0)); } // ---------------------------------------------------------------------------- // AudioPolicyInterface implementation // ---------------------------------------------------------------------------- status_t AudioPolicyManager::setDeviceConnectionState(audio_devices_t device, audio_policy_dev_state_t state, const char *device_address) { String8 address = String8(device_address); ALOGV("setDeviceConnectionState() device: %x, state %d, address %s", device, state, device_address); // connect/disconnect only 1 device at a time if (!audio_is_output_device(device) && !audio_is_input_device(device)) return BAD_VALUE; // handle output devices if (audio_is_output_device(device)) { SortedVector outputs; sp devDesc = new DeviceDescriptor(device, address, 0); ssize_t index = mAvailableOutputDevices.indexOf(devDesc); // save a copy of the opened output descriptors before any output is opened or closed // by checkOutputsForDevice(). This will be needed by checkOutputForAllStrategies() mPreviousOutputs = mOutputs; switch (state) { // handle output device connection case AUDIO_POLICY_DEVICE_STATE_AVAILABLE: if (index >= 0) { ALOGW("setDeviceConnectionState() device already connected: %x", device); return INVALID_OPERATION; } ALOGV("setDeviceConnectionState() connecting device %x", device); if (checkOutputsForDevice(device, state, outputs, address) != NO_ERROR) { return INVALID_OPERATION; } ALOGV("setDeviceConnectionState() checkOutputsForDevice() returned %zu outputs", outputs.size()); // register new device as available index = mAvailableOutputDevices.add(devDesc); if (index >= 0) { mAvailableOutputDevices[index]->mId = nextUniqueId(); } else { return NO_MEMORY; } break; // handle output device disconnection case AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE: { if (index < 0) { ALOGW("setDeviceConnectionState() device not connected: %x", device); return INVALID_OPERATION; } ALOGV("setDeviceConnectionState() disconnecting device %x", device); // remove device from available output devices mAvailableOutputDevices.remove(devDesc); checkOutputsForDevice(device, state, outputs, address); // not currently handling multiple simultaneous submixes: ignoring remote submix // case and address } break; default: ALOGE("setDeviceConnectionState() invalid state: %x", state); return BAD_VALUE; } // checkA2dpSuspend must run before checkOutputForAllStrategies so that A2DP // output is suspended before any tracks are moved to it checkA2dpSuspend(); checkOutputForAllStrategies(); // outputs must be closed after checkOutputForAllStrategies() is executed if (!outputs.isEmpty()) { for (size_t i = 0; i < outputs.size(); i++) { AudioOutputDescriptor *desc = mOutputs.valueFor(outputs[i]); // close unused outputs after device disconnection or direct outputs that have been // opened by checkOutputsForDevice() to query dynamic parameters if ((state == AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE) || (((desc->mFlags & AUDIO_OUTPUT_FLAG_DIRECT) != 0) && (desc->mDirectOpenCount == 0))) { closeOutput(outputs[i]); } } // check again after closing A2DP output to reset mA2dpSuspended if needed checkA2dpSuspend(); } updateDevicesAndOutputs(); for (size_t i = 0; i < mOutputs.size(); i++) { // do not force device change on duplicated output because if device is 0, it will // also force a device 0 for the two outputs it is duplicated to which may override // a valid device selection on those outputs. setOutputDevice(mOutputs.keyAt(i), getNewDevice(mOutputs.keyAt(i), true /*fromCache*/), !mOutputs.valueAt(i)->isDuplicated(), 0); } if (device == AUDIO_DEVICE_OUT_WIRED_HEADSET) { device = AUDIO_DEVICE_IN_WIRED_HEADSET; } else if (device == AUDIO_DEVICE_OUT_BLUETOOTH_SCO || device == AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET || device == AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT) { device = AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET; } else { return NO_ERROR; } } // end if is output device // handle input devices if (audio_is_input_device(device)) { SortedVector inputs; sp devDesc = new DeviceDescriptor(device, address, 0); ssize_t index = mAvailableInputDevices.indexOf(devDesc); switch (state) { // handle input device connection case AUDIO_POLICY_DEVICE_STATE_AVAILABLE: { if (index >= 0) { ALOGW("setDeviceConnectionState() device already connected: %d", device); return INVALID_OPERATION; } if (checkInputsForDevice(device, state, inputs, address) != NO_ERROR) { return INVALID_OPERATION; } index = mAvailableInputDevices.add(devDesc); if (index >= 0) { mAvailableInputDevices[index]->mId = nextUniqueId(); } else { return NO_MEMORY; } } break; // handle input device disconnection case AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE: { if (index < 0) { ALOGW("setDeviceConnectionState() device not connected: %d", device); return INVALID_OPERATION; } checkInputsForDevice(device, state, inputs, address); mAvailableInputDevices.remove(devDesc); } break; default: ALOGE("setDeviceConnectionState() invalid state: %x", state); return BAD_VALUE; } closeAllInputs(); return NO_ERROR; } // end if is input device ALOGW("setDeviceConnectionState() invalid device: %x", device); return BAD_VALUE; } audio_policy_dev_state_t AudioPolicyManager::getDeviceConnectionState(audio_devices_t device, const char *device_address) { audio_policy_dev_state_t state = AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE; String8 address = String8(device_address); sp devDesc = new DeviceDescriptor(device, String8(device_address), 0); ssize_t index; DeviceVector *deviceVector; if (audio_is_output_device(device)) { deviceVector = &mAvailableOutputDevices; } else if (audio_is_input_device(device)) { deviceVector = &mAvailableInputDevices; } else { ALOGW("getDeviceConnectionState() invalid device type %08x", device); return AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE; } index = deviceVector->indexOf(devDesc); if (index >= 0) { return AUDIO_POLICY_DEVICE_STATE_AVAILABLE; } else { return AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE; } } void AudioPolicyManager::setPhoneState(audio_mode_t state) { ALOGV("setPhoneState() state %d", state); audio_devices_t newDevice = AUDIO_DEVICE_NONE; if (state < 0 || state >= AUDIO_MODE_CNT) { ALOGW("setPhoneState() invalid state %d", state); return; } if (state == mPhoneState ) { ALOGW("setPhoneState() setting same state %d", state); return; } // if leaving call state, handle special case of active streams // pertaining to sonification strategy see handleIncallSonification() if (isInCall()) { ALOGV("setPhoneState() in call state management: new state is %d", state); for (int stream = 0; stream < AUDIO_STREAM_CNT; stream++) { handleIncallSonification((audio_stream_type_t)stream, false, true); } } // store previous phone state for management of sonification strategy below int oldState = mPhoneState; mPhoneState = state; bool force = false; // are we entering or starting a call if (!isStateInCall(oldState) && isStateInCall(state)) { ALOGV(" Entering call in setPhoneState()"); // force routing command to audio hardware when starting a call // even if no device change is needed force = true; for (int j = 0; j < DEVICE_CATEGORY_CNT; j++) { mStreams[AUDIO_STREAM_DTMF].mVolumeCurve[j] = sVolumeProfiles[AUDIO_STREAM_VOICE_CALL][j]; } } else if (isStateInCall(oldState) && !isStateInCall(state)) { ALOGV(" Exiting call in setPhoneState()"); // force routing command to audio hardware when exiting a call // even if no device change is needed force = true; for (int j = 0; j < DEVICE_CATEGORY_CNT; j++) { mStreams[AUDIO_STREAM_DTMF].mVolumeCurve[j] = sVolumeProfiles[AUDIO_STREAM_DTMF][j]; } } else if (isStateInCall(state) && (state != oldState)) { ALOGV(" Switching between telephony and VoIP in setPhoneState()"); // force routing command to audio hardware when switching between telephony and VoIP // even if no device change is needed force = true; } // check for device and output changes triggered by new phone state newDevice = getNewDevice(mPrimaryOutput, false /*fromCache*/); checkA2dpSuspend(); checkOutputForAllStrategies(); updateDevicesAndOutputs(); AudioOutputDescriptor *hwOutputDesc = mOutputs.valueFor(mPrimaryOutput); // force routing command to audio hardware when ending call // even if no device change is needed if (isStateInCall(oldState) && newDevice == AUDIO_DEVICE_NONE) { newDevice = hwOutputDesc->device(); } int delayMs = 0; if (isStateInCall(state)) { nsecs_t sysTime = systemTime(); for (size_t i = 0; i < mOutputs.size(); i++) { AudioOutputDescriptor *desc = mOutputs.valueAt(i); // mute media and sonification strategies and delay device switch by the largest // latency of any output where either strategy is active. // This avoid sending the ring tone or music tail into the earpiece or headset. if ((desc->isStrategyActive(STRATEGY_MEDIA, SONIFICATION_HEADSET_MUSIC_DELAY, sysTime) || desc->isStrategyActive(STRATEGY_SONIFICATION, SONIFICATION_HEADSET_MUSIC_DELAY, sysTime)) && (delayMs < (int)desc->mLatency*2)) { delayMs = desc->mLatency*2; } setStrategyMute(STRATEGY_MEDIA, true, mOutputs.keyAt(i)); setStrategyMute(STRATEGY_MEDIA, false, mOutputs.keyAt(i), MUTE_TIME_MS, getDeviceForStrategy(STRATEGY_MEDIA, true /*fromCache*/)); setStrategyMute(STRATEGY_SONIFICATION, true, mOutputs.keyAt(i)); setStrategyMute(STRATEGY_SONIFICATION, false, mOutputs.keyAt(i), MUTE_TIME_MS, getDeviceForStrategy(STRATEGY_SONIFICATION, true /*fromCache*/)); } } // change routing is necessary setOutputDevice(mPrimaryOutput, newDevice, force, delayMs); // if entering in call state, handle special case of active streams // pertaining to sonification strategy see handleIncallSonification() if (isStateInCall(state)) { ALOGV("setPhoneState() in call state management: new state is %d", state); for (int stream = 0; stream < AUDIO_STREAM_CNT; stream++) { handleIncallSonification((audio_stream_type_t)stream, true, true); } } // Flag that ringtone volume must be limited to music volume until we exit MODE_RINGTONE if (state == AUDIO_MODE_RINGTONE && isStreamActive(AUDIO_STREAM_MUSIC, SONIFICATION_HEADSET_MUSIC_DELAY)) { mLimitRingtoneVolume = true; } else { mLimitRingtoneVolume = false; } } void AudioPolicyManager::setForceUse(audio_policy_force_use_t usage, audio_policy_forced_cfg_t config) { ALOGV("setForceUse() usage %d, config %d, mPhoneState %d", usage, config, mPhoneState); bool forceVolumeReeval = false; switch(usage) { case AUDIO_POLICY_FORCE_FOR_COMMUNICATION: if (config != AUDIO_POLICY_FORCE_SPEAKER && config != AUDIO_POLICY_FORCE_BT_SCO && config != AUDIO_POLICY_FORCE_NONE) { ALOGW("setForceUse() invalid config %d for FOR_COMMUNICATION", config); return; } forceVolumeReeval = true; mForceUse[usage] = config; break; case AUDIO_POLICY_FORCE_FOR_MEDIA: if (config != AUDIO_POLICY_FORCE_HEADPHONES && config != AUDIO_POLICY_FORCE_BT_A2DP && config != AUDIO_POLICY_FORCE_WIRED_ACCESSORY && config != AUDIO_POLICY_FORCE_ANALOG_DOCK && config != AUDIO_POLICY_FORCE_DIGITAL_DOCK && config != AUDIO_POLICY_FORCE_NONE && config != AUDIO_POLICY_FORCE_NO_BT_A2DP) { ALOGW("setForceUse() invalid config %d for FOR_MEDIA", config); return; } mForceUse[usage] = config; break; case AUDIO_POLICY_FORCE_FOR_RECORD: if (config != AUDIO_POLICY_FORCE_BT_SCO && config != AUDIO_POLICY_FORCE_WIRED_ACCESSORY && config != AUDIO_POLICY_FORCE_NONE) { ALOGW("setForceUse() invalid config %d for FOR_RECORD", config); return; } mForceUse[usage] = config; break; case AUDIO_POLICY_FORCE_FOR_DOCK: if (config != AUDIO_POLICY_FORCE_NONE && config != AUDIO_POLICY_FORCE_BT_CAR_DOCK && config != AUDIO_POLICY_FORCE_BT_DESK_DOCK && config != AUDIO_POLICY_FORCE_WIRED_ACCESSORY && config != AUDIO_POLICY_FORCE_ANALOG_DOCK && config != AUDIO_POLICY_FORCE_DIGITAL_DOCK) { ALOGW("setForceUse() invalid config %d for FOR_DOCK", config); } forceVolumeReeval = true; mForceUse[usage] = config; break; case AUDIO_POLICY_FORCE_FOR_SYSTEM: if (config != AUDIO_POLICY_FORCE_NONE && config != AUDIO_POLICY_FORCE_SYSTEM_ENFORCED) { ALOGW("setForceUse() invalid config %d for FOR_SYSTEM", config); } forceVolumeReeval = true; mForceUse[usage] = config; break; default: ALOGW("setForceUse() invalid usage %d", usage); break; } // check for device and output changes triggered by new force usage checkA2dpSuspend(); checkOutputForAllStrategies(); updateDevicesAndOutputs(); for (size_t i = 0; i < mOutputs.size(); i++) { audio_io_handle_t output = mOutputs.keyAt(i); audio_devices_t newDevice = getNewDevice(output, true /*fromCache*/); setOutputDevice(output, newDevice, (newDevice != AUDIO_DEVICE_NONE)); if (forceVolumeReeval && (newDevice != AUDIO_DEVICE_NONE)) { applyStreamVolumes(output, newDevice, 0, true); } } audio_io_handle_t activeInput = getActiveInput(); if (activeInput != 0) { AudioInputDescriptor *inputDesc = mInputs.valueFor(activeInput); audio_devices_t newDevice = getDeviceForInputSource(inputDesc->mInputSource); if ((newDevice != AUDIO_DEVICE_NONE) && (newDevice != inputDesc->mDevice)) { ALOGV("setForceUse() changing device from %x to %x for input %d", inputDesc->mDevice, newDevice, activeInput); inputDesc->mDevice = newDevice; AudioParameter param = AudioParameter(); param.addInt(String8(AudioParameter::keyRouting), (int)newDevice); mpClientInterface->setParameters(activeInput, param.toString()); } } } audio_policy_forced_cfg_t AudioPolicyManager::getForceUse(audio_policy_force_use_t usage) { return mForceUse[usage]; } void AudioPolicyManager::setSystemProperty(const char* property, const char* value) { ALOGV("setSystemProperty() property %s, value %s", property, value); } // Find a direct output profile compatible with the parameters passed, even if the input flags do // not explicitly request a direct output AudioPolicyManager::IOProfile *AudioPolicyManager::getProfileForDirectOutput( audio_devices_t device, uint32_t samplingRate, audio_format_t format, audio_channel_mask_t channelMask, audio_output_flags_t flags) { for (size_t i = 0; i < mHwModules.size(); i++) { if (mHwModules[i]->mHandle == 0) { continue; } for (size_t j = 0; j < mHwModules[i]->mOutputProfiles.size(); j++) { IOProfile *profile = mHwModules[i]->mOutputProfiles[j]; bool found = false; if (flags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD) { if (profile->isCompatibleProfile(device, samplingRate, format, channelMask, AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD)) { found = true; } } else { if (profile->isCompatibleProfile(device, samplingRate, format, channelMask, AUDIO_OUTPUT_FLAG_DIRECT)) { found = true; } } if (found && (mAvailableOutputDevices.types() & profile->mSupportedDevices.types())) { return profile; } } } return 0; } audio_io_handle_t AudioPolicyManager::getOutput(audio_stream_type_t stream, uint32_t samplingRate, audio_format_t format, audio_channel_mask_t channelMask, audio_output_flags_t flags, const audio_offload_info_t *offloadInfo) { audio_io_handle_t output = 0; uint32_t latency = 0; routing_strategy strategy = getStrategy(stream); audio_devices_t device = getDeviceForStrategy(strategy, false /*fromCache*/); ALOGV("getOutput() device %d, stream %d, samplingRate %d, format %x, channelMask %x, flags %x", device, stream, samplingRate, format, channelMask, flags); #ifdef AUDIO_POLICY_TEST if (mCurOutput != 0) { ALOGV("getOutput() test output mCurOutput %d, samplingRate %d, format %d, channelMask %x, mDirectOutput %d", mCurOutput, mTestSamplingRate, mTestFormat, mTestChannels, mDirectOutput); if (mTestOutputs[mCurOutput] == 0) { ALOGV("getOutput() opening test output"); AudioOutputDescriptor *outputDesc = new AudioOutputDescriptor(NULL); outputDesc->mDevice = mTestDevice; outputDesc->mSamplingRate = mTestSamplingRate; outputDesc->mFormat = mTestFormat; outputDesc->mChannelMask = mTestChannels; outputDesc->mLatency = mTestLatencyMs; outputDesc->mFlags = (audio_output_flags_t)(mDirectOutput ? AUDIO_OUTPUT_FLAG_DIRECT : 0); outputDesc->mRefCount[stream] = 0; mTestOutputs[mCurOutput] = mpClientInterface->openOutput(0, &outputDesc->mDevice, &outputDesc->mSamplingRate, &outputDesc->mFormat, &outputDesc->mChannelMask, &outputDesc->mLatency, outputDesc->mFlags, offloadInfo); if (mTestOutputs[mCurOutput]) { AudioParameter outputCmd = AudioParameter(); outputCmd.addInt(String8("set_id"),mCurOutput); mpClientInterface->setParameters(mTestOutputs[mCurOutput],outputCmd.toString()); addOutput(mTestOutputs[mCurOutput], outputDesc); } } return mTestOutputs[mCurOutput]; } #endif //AUDIO_POLICY_TEST // open a direct output if required by specified parameters //force direct flag if offload flag is set: offloading implies a direct output stream // and all common behaviors are driven by checking only the direct flag // this should normally be set appropriately in the policy configuration file if ((flags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD) != 0) { flags = (audio_output_flags_t)(flags | AUDIO_OUTPUT_FLAG_DIRECT); } // Do not allow offloading if one non offloadable effect is enabled. This prevents from // creating an offloaded track and tearing it down immediately after start when audioflinger // detects there is an active non offloadable effect. // FIXME: We should check the audio session here but we do not have it in this context. // This may prevent offloading in rare situations where effects are left active by apps // in the background. IOProfile *profile = NULL; if (((flags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD) == 0) || !isNonOffloadableEffectEnabled()) { profile = getProfileForDirectOutput(device, samplingRate, format, channelMask, (audio_output_flags_t)flags); } if (profile != NULL) { AudioOutputDescriptor *outputDesc = NULL; for (size_t i = 0; i < mOutputs.size(); i++) { AudioOutputDescriptor *desc = mOutputs.valueAt(i); if (!desc->isDuplicated() && (profile == desc->mProfile)) { outputDesc = desc; // reuse direct output if currently open and configured with same parameters if ((samplingRate == outputDesc->mSamplingRate) && (format == outputDesc->mFormat) && (channelMask == outputDesc->mChannelMask)) { outputDesc->mDirectOpenCount++; ALOGV("getOutput() reusing direct output %d", mOutputs.keyAt(i)); return mOutputs.keyAt(i); } } } // close direct output if currently open and configured with different parameters if (outputDesc != NULL) { closeOutput(outputDesc->mId); } outputDesc = new AudioOutputDescriptor(profile); outputDesc->mDevice = device; outputDesc->mSamplingRate = samplingRate; outputDesc->mFormat = format; outputDesc->mChannelMask = channelMask; outputDesc->mLatency = 0; outputDesc->mFlags =(audio_output_flags_t) (outputDesc->mFlags | flags); outputDesc->mRefCount[stream] = 0; outputDesc->mStopTime[stream] = 0; outputDesc->mDirectOpenCount = 1; output = mpClientInterface->openOutput(profile->mModule->mHandle, &outputDesc->mDevice, &outputDesc->mSamplingRate, &outputDesc->mFormat, &outputDesc->mChannelMask, &outputDesc->mLatency, outputDesc->mFlags, offloadInfo); // only accept an output with the requested parameters if (output == 0 || (samplingRate != 0 && samplingRate != outputDesc->mSamplingRate) || (format != AUDIO_FORMAT_DEFAULT && format != outputDesc->mFormat) || (channelMask != 0 && channelMask != outputDesc->mChannelMask)) { ALOGV("getOutput() failed opening direct output: output %d samplingRate %d %d," "format %d %d, channelMask %04x %04x", output, samplingRate, outputDesc->mSamplingRate, format, outputDesc->mFormat, channelMask, outputDesc->mChannelMask); if (output != 0) { mpClientInterface->closeOutput(output); } delete outputDesc; return 0; } audio_io_handle_t srcOutput = getOutputForEffect(); addOutput(output, outputDesc); audio_io_handle_t dstOutput = getOutputForEffect(); if (dstOutput == output) { mpClientInterface->moveEffects(AUDIO_SESSION_OUTPUT_MIX, srcOutput, dstOutput); } mPreviousOutputs = mOutputs; ALOGV("getOutput() returns new direct output %d", output); return output; } // ignoring channel mask due to downmix capability in mixer // open a non direct output // for non direct outputs, only PCM is supported if (audio_is_linear_pcm(format)) { // get which output is suitable for the specified stream. The actual // routing change will happen when startOutput() will be called SortedVector outputs = getOutputsForDevice(device, mOutputs); output = selectOutput(outputs, flags); } ALOGW_IF((output == 0), "getOutput() could not find output for stream %d, samplingRate %d," "format %d, channels %x, flags %x", stream, samplingRate, format, channelMask, flags); ALOGV("getOutput() returns output %d", output); return output; } audio_io_handle_t AudioPolicyManager::selectOutput(const SortedVector& outputs, audio_output_flags_t flags) { // select one output among several that provide a path to a particular device or set of // devices (the list was previously build by getOutputsForDevice()). // The priority is as follows: // 1: the output with the highest number of requested policy flags // 2: the primary output // 3: the first output in the list if (outputs.size() == 0) { return 0; } if (outputs.size() == 1) { return outputs[0]; } int maxCommonFlags = 0; audio_io_handle_t outputFlags = 0; audio_io_handle_t outputPrimary = 0; for (size_t i = 0; i < outputs.size(); i++) { AudioOutputDescriptor *outputDesc = mOutputs.valueFor(outputs[i]); if (!outputDesc->isDuplicated()) { int commonFlags = popcount(outputDesc->mProfile->mFlags & flags); if (commonFlags > maxCommonFlags) { outputFlags = outputs[i]; maxCommonFlags = commonFlags; ALOGV("selectOutput() commonFlags for output %d, %04x", outputs[i], commonFlags); } if (outputDesc->mProfile->mFlags & AUDIO_OUTPUT_FLAG_PRIMARY) { outputPrimary = outputs[i]; } } } if (outputFlags != 0) { return outputFlags; } if (outputPrimary != 0) { return outputPrimary; } return outputs[0]; } status_t AudioPolicyManager::startOutput(audio_io_handle_t output, audio_stream_type_t stream, int session) { ALOGV("startOutput() output %d, stream %d, session %d", output, stream, session); ssize_t index = mOutputs.indexOfKey(output); if (index < 0) { ALOGW("startOutput() unknown output %d", output); return BAD_VALUE; } AudioOutputDescriptor *outputDesc = mOutputs.valueAt(index); // increment usage count for this stream on the requested output: // NOTE that the usage count is the same for duplicated output and hardware output which is // necessary for a correct control of hardware output routing by startOutput() and stopOutput() outputDesc->changeRefCount(stream, 1); if (outputDesc->mRefCount[stream] == 1) { audio_devices_t newDevice = getNewDevice(output, false /*fromCache*/); routing_strategy strategy = getStrategy(stream); bool shouldWait = (strategy == STRATEGY_SONIFICATION) || (strategy == STRATEGY_SONIFICATION_RESPECTFUL); uint32_t waitMs = 0; bool force = false; for (size_t i = 0; i < mOutputs.size(); i++) { AudioOutputDescriptor *desc = mOutputs.valueAt(i); if (desc != outputDesc) { // force a device change if any other output is managed by the same hw // module and has a current device selection that differs from selected device. // In this case, the audio HAL must receive the new device selection so that it can // change the device currently selected by the other active output. if (outputDesc->sharesHwModuleWith(desc) && desc->device() != newDevice) { force = true; } // wait for audio on other active outputs to be presented when starting // a notification so that audio focus effect can propagate. uint32_t latency = desc->latency(); if (shouldWait && desc->isActive(latency * 2) && (waitMs < latency)) { waitMs = latency; } } } uint32_t muteWaitMs = setOutputDevice(output, newDevice, force); // handle special case for sonification while in call if (isInCall()) { handleIncallSonification(stream, true, false); } // apply volume rules for current stream and device if necessary checkAndSetVolume(stream, mStreams[stream].getVolumeIndex(newDevice), output, newDevice); // update the outputs if starting an output with a stream that can affect notification // routing handleNotificationRoutingForStream(stream); if (waitMs > muteWaitMs) { usleep((waitMs - muteWaitMs) * 2 * 1000); } } return NO_ERROR; } status_t AudioPolicyManager::stopOutput(audio_io_handle_t output, audio_stream_type_t stream, int session) { ALOGV("stopOutput() output %d, stream %d, session %d", output, stream, session); ssize_t index = mOutputs.indexOfKey(output); if (index < 0) { ALOGW("stopOutput() unknown output %d", output); return BAD_VALUE; } AudioOutputDescriptor *outputDesc = mOutputs.valueAt(index); // handle special case for sonification while in call if (isInCall()) { handleIncallSonification(stream, false, false); } if (outputDesc->mRefCount[stream] > 0) { // decrement usage count of this stream on the output outputDesc->changeRefCount(stream, -1); // store time at which the stream was stopped - see isStreamActive() if (outputDesc->mRefCount[stream] == 0) { outputDesc->mStopTime[stream] = systemTime(); audio_devices_t newDevice = getNewDevice(output, false /*fromCache*/); // delay the device switch by twice the latency because stopOutput() is executed when // the track stop() command is received and at that time the audio track buffer can // still contain data that needs to be drained. The latency only covers the audio HAL // and kernel buffers. Also the latency does not always include additional delay in the // audio path (audio DSP, CODEC ...) setOutputDevice(output, newDevice, false, outputDesc->mLatency*2); // force restoring the device selection on other active outputs if it differs from the // one being selected for this output for (size_t i = 0; i < mOutputs.size(); i++) { audio_io_handle_t curOutput = mOutputs.keyAt(i); AudioOutputDescriptor *desc = mOutputs.valueAt(i); if (curOutput != output && desc->isActive() && outputDesc->sharesHwModuleWith(desc) && (newDevice != desc->device())) { setOutputDevice(curOutput, getNewDevice(curOutput, false /*fromCache*/), true, outputDesc->mLatency*2); } } // update the outputs if stopping one with a stream that can affect notification routing handleNotificationRoutingForStream(stream); } return NO_ERROR; } else { ALOGW("stopOutput() refcount is already 0 for output %d", output); return INVALID_OPERATION; } } void AudioPolicyManager::releaseOutput(audio_io_handle_t output) { ALOGV("releaseOutput() %d", output); ssize_t index = mOutputs.indexOfKey(output); if (index < 0) { ALOGW("releaseOutput() releasing unknown output %d", output); return; } #ifdef AUDIO_POLICY_TEST int testIndex = testOutputIndex(output); if (testIndex != 0) { AudioOutputDescriptor *outputDesc = mOutputs.valueAt(index); if (outputDesc->isActive()) { mpClientInterface->closeOutput(output); delete mOutputs.valueAt(index); mOutputs.removeItem(output); mTestOutputs[testIndex] = 0; } return; } #endif //AUDIO_POLICY_TEST AudioOutputDescriptor *desc = mOutputs.valueAt(index); if (desc->mFlags & AUDIO_OUTPUT_FLAG_DIRECT) { if (desc->mDirectOpenCount <= 0) { ALOGW("releaseOutput() invalid open count %d for output %d", desc->mDirectOpenCount, output); return; } if (--desc->mDirectOpenCount == 0) { closeOutput(output); // If effects where present on the output, audioflinger moved them to the primary // output by default: move them back to the appropriate output. audio_io_handle_t dstOutput = getOutputForEffect(); if (dstOutput != mPrimaryOutput) { mpClientInterface->moveEffects(AUDIO_SESSION_OUTPUT_MIX, mPrimaryOutput, dstOutput); } } } } audio_io_handle_t AudioPolicyManager::getInput(audio_source_t inputSource, uint32_t samplingRate, audio_format_t format, audio_channel_mask_t channelMask, audio_in_acoustics_t acoustics) { audio_io_handle_t input = 0; audio_devices_t device = getDeviceForInputSource(inputSource); ALOGV("getInput() inputSource %d, samplingRate %d, format %d, channelMask %x, acoustics %x", inputSource, samplingRate, format, channelMask, acoustics); if (device == AUDIO_DEVICE_NONE) { ALOGW("getInput() could not find device for inputSource %d", inputSource); return 0; } // adapt channel selection to input source switch(inputSource) { case AUDIO_SOURCE_VOICE_UPLINK: channelMask = AUDIO_CHANNEL_IN_VOICE_UPLINK; break; case AUDIO_SOURCE_VOICE_DOWNLINK: channelMask = AUDIO_CHANNEL_IN_VOICE_DNLINK; break; case AUDIO_SOURCE_VOICE_CALL: channelMask = AUDIO_CHANNEL_IN_VOICE_UPLINK | AUDIO_CHANNEL_IN_VOICE_DNLINK; break; default: break; } IOProfile *profile = getInputProfile(device, samplingRate, format, channelMask); if (profile == NULL) { ALOGW("getInput() could not find profile for device %04x, samplingRate %d, format %d, " "channelMask %04x", device, samplingRate, format, channelMask); return 0; } if (profile->mModule->mHandle == 0) { ALOGE("getInput(): HW module %s not opened", profile->mModule->mName); return 0; } AudioInputDescriptor *inputDesc = new AudioInputDescriptor(profile); inputDesc->mInputSource = inputSource; inputDesc->mDevice = device; inputDesc->mSamplingRate = samplingRate; inputDesc->mFormat = format; inputDesc->mChannelMask = channelMask; inputDesc->mRefCount = 0; input = mpClientInterface->openInput(profile->mModule->mHandle, &inputDesc->mDevice, &inputDesc->mSamplingRate, &inputDesc->mFormat, &inputDesc->mChannelMask); // only accept input with the exact requested set of parameters if (input == 0 || (samplingRate != inputDesc->mSamplingRate) || (format != inputDesc->mFormat) || (channelMask != inputDesc->mChannelMask)) { ALOGI("getInput() failed opening input: samplingRate %d, format %d, channelMask %x", samplingRate, format, channelMask); if (input != 0) { mpClientInterface->closeInput(input); } delete inputDesc; return 0; } addInput(input, inputDesc); return input; } status_t AudioPolicyManager::startInput(audio_io_handle_t input) { ALOGV("startInput() input %d", input); ssize_t index = mInputs.indexOfKey(input); if (index < 0) { ALOGW("startInput() unknown input %d", input); return BAD_VALUE; } AudioInputDescriptor *inputDesc = mInputs.valueAt(index); #ifdef AUDIO_POLICY_TEST if (mTestInput == 0) #endif //AUDIO_POLICY_TEST { // refuse 2 active AudioRecord clients at the same time except if the active input // uses AUDIO_SOURCE_HOTWORD in which case it is closed. audio_io_handle_t activeInput = getActiveInput(); if (!isVirtualInputDevice(inputDesc->mDevice) && activeInput != 0) { AudioInputDescriptor *activeDesc = mInputs.valueFor(activeInput); if (activeDesc->mInputSource == AUDIO_SOURCE_HOTWORD) { ALOGW("startInput() preempting already started low-priority input %d", activeInput); stopInput(activeInput); releaseInput(activeInput); } else { ALOGW("startInput() input %d failed: other input already started", input); return INVALID_OPERATION; } } } audio_devices_t newDevice = getDeviceForInputSource(inputDesc->mInputSource); if ((newDevice != AUDIO_DEVICE_NONE) && (newDevice != inputDesc->mDevice)) { inputDesc->mDevice = newDevice; } // automatically enable the remote submix output when input is started if (audio_is_remote_submix_device(inputDesc->mDevice)) { setDeviceConnectionState(AUDIO_DEVICE_OUT_REMOTE_SUBMIX, AUDIO_POLICY_DEVICE_STATE_AVAILABLE, AUDIO_REMOTE_SUBMIX_DEVICE_ADDRESS); } AudioParameter param = AudioParameter(); param.addInt(String8(AudioParameter::keyRouting), (int)inputDesc->mDevice); int aliasSource = (inputDesc->mInputSource == AUDIO_SOURCE_HOTWORD) ? AUDIO_SOURCE_VOICE_RECOGNITION : inputDesc->mInputSource; param.addInt(String8(AudioParameter::keyInputSource), aliasSource); ALOGV("AudioPolicyManager::startInput() input source = %d", inputDesc->mInputSource); mpClientInterface->setParameters(input, param.toString()); inputDesc->mRefCount = 1; return NO_ERROR; } status_t AudioPolicyManager::stopInput(audio_io_handle_t input) { ALOGV("stopInput() input %d", input); ssize_t index = mInputs.indexOfKey(input); if (index < 0) { ALOGW("stopInput() unknown input %d", input); return BAD_VALUE; } AudioInputDescriptor *inputDesc = mInputs.valueAt(index); if (inputDesc->mRefCount == 0) { ALOGW("stopInput() input %d already stopped", input); return INVALID_OPERATION; } else { // automatically disable the remote submix output when input is stopped if (audio_is_remote_submix_device(inputDesc->mDevice)) { setDeviceConnectionState(AUDIO_DEVICE_OUT_REMOTE_SUBMIX, AUDIO_POLICY_DEVICE_STATE_UNAVAILABLE, AUDIO_REMOTE_SUBMIX_DEVICE_ADDRESS); } AudioParameter param = AudioParameter(); param.addInt(String8(AudioParameter::keyRouting), 0); mpClientInterface->setParameters(input, param.toString()); inputDesc->mRefCount = 0; return NO_ERROR; } } void AudioPolicyManager::releaseInput(audio_io_handle_t input) { ALOGV("releaseInput() %d", input); ssize_t index = mInputs.indexOfKey(input); if (index < 0) { ALOGW("releaseInput() releasing unknown input %d", input); return; } mpClientInterface->closeInput(input); delete mInputs.valueAt(index); mInputs.removeItem(input); ALOGV("releaseInput() exit"); } void AudioPolicyManager::closeAllInputs() { for(size_t input_index = 0; input_index < mInputs.size(); input_index++) { mpClientInterface->closeInput(mInputs.keyAt(input_index)); } mInputs.clear(); } void AudioPolicyManager::initStreamVolume(audio_stream_type_t stream, int indexMin, int indexMax) { ALOGV("initStreamVolume() stream %d, min %d, max %d", stream , indexMin, indexMax); if (indexMin < 0 || indexMin >= indexMax) { ALOGW("initStreamVolume() invalid index limits for stream %d, min %d, max %d", stream , indexMin, indexMax); return; } mStreams[stream].mIndexMin = indexMin; mStreams[stream].mIndexMax = indexMax; } status_t AudioPolicyManager::setStreamVolumeIndex(audio_stream_type_t stream, int index, audio_devices_t device) { if ((index < mStreams[stream].mIndexMin) || (index > mStreams[stream].mIndexMax)) { return BAD_VALUE; } if (!audio_is_output_device(device)) { return BAD_VALUE; } // Force max volume if stream cannot be muted if (!mStreams[stream].mCanBeMuted) index = mStreams[stream].mIndexMax; ALOGV("setStreamVolumeIndex() stream %d, device %04x, index %d", stream, device, index); // if device is AUDIO_DEVICE_OUT_DEFAULT set default value and // clear all device specific values if (device == AUDIO_DEVICE_OUT_DEFAULT) { mStreams[stream].mIndexCur.clear(); } mStreams[stream].mIndexCur.add(device, index); // compute and apply stream volume on all outputs according to connected device status_t status = NO_ERROR; for (size_t i = 0; i < mOutputs.size(); i++) { audio_devices_t curDevice = getDeviceForVolume(mOutputs.valueAt(i)->device()); if ((device == AUDIO_DEVICE_OUT_DEFAULT) || (device == curDevice)) { status_t volStatus = checkAndSetVolume(stream, index, mOutputs.keyAt(i), curDevice); if (volStatus != NO_ERROR) { status = volStatus; } } } return status; } status_t AudioPolicyManager::getStreamVolumeIndex(audio_stream_type_t stream, int *index, audio_devices_t device) { if (index == NULL) { return BAD_VALUE; } if (!audio_is_output_device(device)) { return BAD_VALUE; } // if device is AUDIO_DEVICE_OUT_DEFAULT, return volume for device corresponding to // the strategy the stream belongs to. if (device == AUDIO_DEVICE_OUT_DEFAULT) { device = getDeviceForStrategy(getStrategy(stream), true /*fromCache*/); } device = getDeviceForVolume(device); *index = mStreams[stream].getVolumeIndex(device); ALOGV("getStreamVolumeIndex() stream %d device %08x index %d", stream, device, *index); return NO_ERROR; } audio_io_handle_t AudioPolicyManager::selectOutputForEffects( const SortedVector& outputs) { // select one output among several suitable for global effects. // The priority is as follows: // 1: An offloaded output. If the effect ends up not being offloadable, // AudioFlinger will invalidate the track and the offloaded output // will be closed causing the effect to be moved to a PCM output. // 2: A deep buffer output // 3: the first output in the list if (outputs.size() == 0) { return 0; } audio_io_handle_t outputOffloaded = 0; audio_io_handle_t outputDeepBuffer = 0; for (size_t i = 0; i < outputs.size(); i++) { AudioOutputDescriptor *desc = mOutputs.valueFor(outputs[i]); ALOGV("selectOutputForEffects outputs[%zu] flags %x", i, desc->mFlags); if ((desc->mFlags & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD) != 0) { outputOffloaded = outputs[i]; } if ((desc->mFlags & AUDIO_OUTPUT_FLAG_DEEP_BUFFER) != 0) { outputDeepBuffer = outputs[i]; } } ALOGV("selectOutputForEffects outputOffloaded %d outputDeepBuffer %d", outputOffloaded, outputDeepBuffer); if (outputOffloaded != 0) { return outputOffloaded; } if (outputDeepBuffer != 0) { return outputDeepBuffer; } return outputs[0]; } audio_io_handle_t AudioPolicyManager::getOutputForEffect(const effect_descriptor_t *desc) { // apply simple rule where global effects are attached to the same output as MUSIC streams routing_strategy strategy = getStrategy(AUDIO_STREAM_MUSIC); audio_devices_t device = getDeviceForStrategy(strategy, false /*fromCache*/); SortedVector dstOutputs = getOutputsForDevice(device, mOutputs); audio_io_handle_t output = selectOutputForEffects(dstOutputs); ALOGV("getOutputForEffect() got output %d for fx %s flags %x", output, (desc == NULL) ? "unspecified" : desc->name, (desc == NULL) ? 0 : desc->flags); return output; } status_t AudioPolicyManager::registerEffect(const effect_descriptor_t *desc, audio_io_handle_t io, uint32_t strategy, int session, int id) { ssize_t index = mOutputs.indexOfKey(io); if (index < 0) { index = mInputs.indexOfKey(io); if (index < 0) { ALOGW("registerEffect() unknown io %d", io); return INVALID_OPERATION; } } if (mTotalEffectsMemory + desc->memoryUsage > getMaxEffectsMemory()) { ALOGW("registerEffect() memory limit exceeded for Fx %s, Memory %d KB", desc->name, desc->memoryUsage); return INVALID_OPERATION; } mTotalEffectsMemory += desc->memoryUsage; ALOGV("registerEffect() effect %s, io %d, strategy %d session %d id %d", desc->name, io, strategy, session, id); ALOGV("registerEffect() memory %d, total memory %d", desc->memoryUsage, mTotalEffectsMemory); EffectDescriptor *pDesc = new EffectDescriptor(); memcpy (&pDesc->mDesc, desc, sizeof(effect_descriptor_t)); pDesc->mIo = io; pDesc->mStrategy = (routing_strategy)strategy; pDesc->mSession = session; pDesc->mEnabled = false; mEffects.add(id, pDesc); return NO_ERROR; } status_t AudioPolicyManager::unregisterEffect(int id) { ssize_t index = mEffects.indexOfKey(id); if (index < 0) { ALOGW("unregisterEffect() unknown effect ID %d", id); return INVALID_OPERATION; } EffectDescriptor *pDesc = mEffects.valueAt(index); setEffectEnabled(pDesc, false); if (mTotalEffectsMemory < pDesc->mDesc.memoryUsage) { ALOGW("unregisterEffect() memory %d too big for total %d", pDesc->mDesc.memoryUsage, mTotalEffectsMemory); pDesc->mDesc.memoryUsage = mTotalEffectsMemory; } mTotalEffectsMemory -= pDesc->mDesc.memoryUsage; ALOGV("unregisterEffect() effect %s, ID %d, memory %d total memory %d", pDesc->mDesc.name, id, pDesc->mDesc.memoryUsage, mTotalEffectsMemory); mEffects.removeItem(id); delete pDesc; return NO_ERROR; } status_t AudioPolicyManager::setEffectEnabled(int id, bool enabled) { ssize_t index = mEffects.indexOfKey(id); if (index < 0) { ALOGW("unregisterEffect() unknown effect ID %d", id); return INVALID_OPERATION; } return setEffectEnabled(mEffects.valueAt(index), enabled); } status_t AudioPolicyManager::setEffectEnabled(EffectDescriptor *pDesc, bool enabled) { if (enabled == pDesc->mEnabled) { ALOGV("setEffectEnabled(%s) effect already %s", enabled?"true":"false", enabled?"enabled":"disabled"); return INVALID_OPERATION; } if (enabled) { if (mTotalEffectsCpuLoad + pDesc->mDesc.cpuLoad > getMaxEffectsCpuLoad()) { ALOGW("setEffectEnabled(true) CPU Load limit exceeded for Fx %s, CPU %f MIPS", pDesc->mDesc.name, (float)pDesc->mDesc.cpuLoad/10); return INVALID_OPERATION; } mTotalEffectsCpuLoad += pDesc->mDesc.cpuLoad; ALOGV("setEffectEnabled(true) total CPU %d", mTotalEffectsCpuLoad); } else { if (mTotalEffectsCpuLoad < pDesc->mDesc.cpuLoad) { ALOGW("setEffectEnabled(false) CPU load %d too high for total %d", pDesc->mDesc.cpuLoad, mTotalEffectsCpuLoad); pDesc->mDesc.cpuLoad = mTotalEffectsCpuLoad; } mTotalEffectsCpuLoad -= pDesc->mDesc.cpuLoad; ALOGV("setEffectEnabled(false) total CPU %d", mTotalEffectsCpuLoad); } pDesc->mEnabled = enabled; return NO_ERROR; } bool AudioPolicyManager::isNonOffloadableEffectEnabled() { for (size_t i = 0; i < mEffects.size(); i++) { const EffectDescriptor * const pDesc = mEffects.valueAt(i); if (pDesc->mEnabled && (pDesc->mStrategy == STRATEGY_MEDIA) && ((pDesc->mDesc.flags & EFFECT_FLAG_OFFLOAD_SUPPORTED) == 0)) { ALOGV("isNonOffloadableEffectEnabled() non offloadable effect %s enabled on session %d", pDesc->mDesc.name, pDesc->mSession); return true; } } return false; } bool AudioPolicyManager::isStreamActive(audio_stream_type_t stream, uint32_t inPastMs) const { nsecs_t sysTime = systemTime(); for (size_t i = 0; i < mOutputs.size(); i++) { const AudioOutputDescriptor *outputDesc = mOutputs.valueAt(i); if (outputDesc->isStreamActive(stream, inPastMs, sysTime)) { return true; } } return false; } bool AudioPolicyManager::isStreamActiveRemotely(audio_stream_type_t stream, uint32_t inPastMs) const { nsecs_t sysTime = systemTime(); for (size_t i = 0; i < mOutputs.size(); i++) { const AudioOutputDescriptor *outputDesc = mOutputs.valueAt(i); if (((outputDesc->device() & APM_AUDIO_OUT_DEVICE_REMOTE_ALL) != 0) && outputDesc->isStreamActive(stream, inPastMs, sysTime)) { return true; } } return false; } bool AudioPolicyManager::isSourceActive(audio_source_t source) const { for (size_t i = 0; i < mInputs.size(); i++) { const AudioInputDescriptor * inputDescriptor = mInputs.valueAt(i); if ((inputDescriptor->mInputSource == (int)source || (source == AUDIO_SOURCE_VOICE_RECOGNITION && inputDescriptor->mInputSource == AUDIO_SOURCE_HOTWORD)) && (inputDescriptor->mRefCount > 0)) { return true; } } return false; } status_t AudioPolicyManager::dump(int fd) { const size_t SIZE = 256; char buffer[SIZE]; String8 result; snprintf(buffer, SIZE, "\nAudioPolicyManager Dump: %p\n", this); result.append(buffer); snprintf(buffer, SIZE, " Primary Output: %d\n", mPrimaryOutput); result.append(buffer); snprintf(buffer, SIZE, " Phone state: %d\n", mPhoneState); result.append(buffer); snprintf(buffer, SIZE, " Force use for communications %d\n", mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION]); result.append(buffer); snprintf(buffer, SIZE, " Force use for media %d\n", mForceUse[AUDIO_POLICY_FORCE_FOR_MEDIA]); result.append(buffer); snprintf(buffer, SIZE, " Force use for record %d\n", mForceUse[AUDIO_POLICY_FORCE_FOR_RECORD]); result.append(buffer); snprintf(buffer, SIZE, " Force use for dock %d\n", mForceUse[AUDIO_POLICY_FORCE_FOR_DOCK]); result.append(buffer); snprintf(buffer, SIZE, " Force use for system %d\n", mForceUse[AUDIO_POLICY_FORCE_FOR_SYSTEM]); result.append(buffer); snprintf(buffer, SIZE, " Available output devices:\n"); result.append(buffer); write(fd, result.string(), result.size()); DeviceDescriptor::dumpHeader(fd, 2); for (size_t i = 0; i < mAvailableOutputDevices.size(); i++) { mAvailableOutputDevices[i]->dump(fd, 2); } snprintf(buffer, SIZE, "\n Available input devices:\n"); write(fd, buffer, strlen(buffer)); DeviceDescriptor::dumpHeader(fd, 2); for (size_t i = 0; i < mAvailableInputDevices.size(); i++) { mAvailableInputDevices[i]->dump(fd, 2); } snprintf(buffer, SIZE, "\nHW Modules dump:\n"); write(fd, buffer, strlen(buffer)); for (size_t i = 0; i < mHwModules.size(); i++) { snprintf(buffer, SIZE, "- HW Module %zu:\n", i + 1); write(fd, buffer, strlen(buffer)); mHwModules[i]->dump(fd); } snprintf(buffer, SIZE, "\nOutputs dump:\n"); write(fd, buffer, strlen(buffer)); for (size_t i = 0; i < mOutputs.size(); i++) { snprintf(buffer, SIZE, "- Output %d dump:\n", mOutputs.keyAt(i)); write(fd, buffer, strlen(buffer)); mOutputs.valueAt(i)->dump(fd); } snprintf(buffer, SIZE, "\nInputs dump:\n"); write(fd, buffer, strlen(buffer)); for (size_t i = 0; i < mInputs.size(); i++) { snprintf(buffer, SIZE, "- Input %d dump:\n", mInputs.keyAt(i)); write(fd, buffer, strlen(buffer)); mInputs.valueAt(i)->dump(fd); } snprintf(buffer, SIZE, "\nStreams dump:\n"); write(fd, buffer, strlen(buffer)); snprintf(buffer, SIZE, " Stream Can be muted Index Min Index Max Index Cur [device : index]...\n"); write(fd, buffer, strlen(buffer)); for (int i = 0; i < AUDIO_STREAM_CNT; i++) { snprintf(buffer, SIZE, " %02zu ", i); write(fd, buffer, strlen(buffer)); mStreams[i].dump(fd); } snprintf(buffer, SIZE, "\nTotal Effects CPU: %f MIPS, Total Effects memory: %d KB\n", (float)mTotalEffectsCpuLoad/10, mTotalEffectsMemory); write(fd, buffer, strlen(buffer)); snprintf(buffer, SIZE, "Registered effects:\n"); write(fd, buffer, strlen(buffer)); for (size_t i = 0; i < mEffects.size(); i++) { snprintf(buffer, SIZE, "- Effect %d dump:\n", mEffects.keyAt(i)); write(fd, buffer, strlen(buffer)); mEffects.valueAt(i)->dump(fd); } return NO_ERROR; } // This function checks for the parameters which can be offloaded. // This can be enhanced depending on the capability of the DSP and policy // of the system. bool AudioPolicyManager::isOffloadSupported(const audio_offload_info_t& offloadInfo) { ALOGV("isOffloadSupported: SR=%u, CM=0x%x, Format=0x%x, StreamType=%d," " BitRate=%u, duration=%" PRId64 " us, has_video=%d", offloadInfo.sample_rate, offloadInfo.channel_mask, offloadInfo.format, offloadInfo.stream_type, offloadInfo.bit_rate, offloadInfo.duration_us, offloadInfo.has_video); // Check if offload has been disabled char propValue[PROPERTY_VALUE_MAX]; if (property_get("audio.offload.disable", propValue, "0")) { if (atoi(propValue) != 0) { ALOGV("offload disabled by audio.offload.disable=%s", propValue ); return false; } } // Check if stream type is music, then only allow offload as of now. if (offloadInfo.stream_type != AUDIO_STREAM_MUSIC) { ALOGV("isOffloadSupported: stream_type != MUSIC, returning false"); return false; } //TODO: enable audio offloading with video when ready if (offloadInfo.has_video) { ALOGV("isOffloadSupported: has_video == true, returning false"); return false; } //If duration is less than minimum value defined in property, return false if (property_get("audio.offload.min.duration.secs", propValue, NULL)) { if (offloadInfo.duration_us < (atoi(propValue) * 1000000 )) { ALOGV("Offload denied by duration < audio.offload.min.duration.secs(=%s)", propValue); return false; } } else if (offloadInfo.duration_us < OFFLOAD_DEFAULT_MIN_DURATION_SECS * 1000000) { ALOGV("Offload denied by duration < default min(=%u)", OFFLOAD_DEFAULT_MIN_DURATION_SECS); return false; } // Do not allow offloading if one non offloadable effect is enabled. This prevents from // creating an offloaded track and tearing it down immediately after start when audioflinger // detects there is an active non offloadable effect. // FIXME: We should check the audio session here but we do not have it in this context. // This may prevent offloading in rare situations where effects are left active by apps // in the background. if (isNonOffloadableEffectEnabled()) { return false; } // See if there is a profile to support this. // AUDIO_DEVICE_NONE IOProfile *profile = getProfileForDirectOutput(AUDIO_DEVICE_NONE /*ignore device */, offloadInfo.sample_rate, offloadInfo.format, offloadInfo.channel_mask, AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD); ALOGV("isOffloadSupported() profile %sfound", profile != NULL ? "" : "NOT "); return (profile != NULL); } // ---------------------------------------------------------------------------- // AudioPolicyManager // ---------------------------------------------------------------------------- uint32_t AudioPolicyManager::nextUniqueId() { return android_atomic_inc(&mNextUniqueId); } AudioPolicyManager::AudioPolicyManager(AudioPolicyClientInterface *clientInterface) : #ifdef AUDIO_POLICY_TEST Thread(false), #endif //AUDIO_POLICY_TEST mPrimaryOutput((audio_io_handle_t)0), mPhoneState(AUDIO_MODE_NORMAL), mLimitRingtoneVolume(false), mLastVoiceVolume(-1.0f), mTotalEffectsCpuLoad(0), mTotalEffectsMemory(0), mA2dpSuspended(false), mSpeakerDrcEnabled(false), mNextUniqueId(0) { mpClientInterface = clientInterface; for (int i = 0; i < AUDIO_POLICY_FORCE_USE_CNT; i++) { mForceUse[i] = AUDIO_POLICY_FORCE_NONE; } mDefaultOutputDevice = new DeviceDescriptor(AUDIO_DEVICE_OUT_SPEAKER); if (loadAudioPolicyConfig(AUDIO_POLICY_VENDOR_CONFIG_FILE) != NO_ERROR) { if (loadAudioPolicyConfig(AUDIO_POLICY_CONFIG_FILE) != NO_ERROR) { ALOGE("could not load audio policy configuration file, setting defaults"); defaultAudioPolicyConfig(); } } // mAvailableOutputDevices and mAvailableInputDevices now contain all attached devices // must be done after reading the policy initializeVolumeCurves(); // open all output streams needed to access attached devices audio_devices_t outputDeviceTypes = mAvailableOutputDevices.types(); audio_devices_t inputDeviceTypes = mAvailableInputDevices.types() & ~AUDIO_DEVICE_BIT_IN; for (size_t i = 0; i < mHwModules.size(); i++) { mHwModules[i]->mHandle = mpClientInterface->loadHwModule(mHwModules[i]->mName); if (mHwModules[i]->mHandle == 0) { ALOGW("could not open HW module %s", mHwModules[i]->mName); continue; } // open all output streams needed to access attached devices // except for direct output streams that are only opened when they are actually // required by an app. // This also validates mAvailableOutputDevices list for (size_t j = 0; j < mHwModules[i]->mOutputProfiles.size(); j++) { const IOProfile *outProfile = mHwModules[i]->mOutputProfiles[j]; if (outProfile->mSupportedDevices.isEmpty()) { ALOGW("Output profile contains no device on module %s", mHwModules[i]->mName); continue; } audio_devices_t profileTypes = outProfile->mSupportedDevices.types(); if ((profileTypes & outputDeviceTypes) && ((outProfile->mFlags & AUDIO_OUTPUT_FLAG_DIRECT) == 0)) { AudioOutputDescriptor *outputDesc = new AudioOutputDescriptor(outProfile); outputDesc->mDevice = (audio_devices_t)(mDefaultOutputDevice->mType & profileTypes); audio_io_handle_t output = mpClientInterface->openOutput( outProfile->mModule->mHandle, &outputDesc->mDevice, &outputDesc->mSamplingRate, &outputDesc->mFormat, &outputDesc->mChannelMask, &outputDesc->mLatency, outputDesc->mFlags); if (output == 0) { ALOGW("Cannot open output stream for device %08x on hw module %s", outputDesc->mDevice, mHwModules[i]->mName); delete outputDesc; } else { for (size_t k = 0; k < outProfile->mSupportedDevices.size(); k++) { audio_devices_t type = outProfile->mSupportedDevices[k]->mType; ssize_t index = mAvailableOutputDevices.indexOf(outProfile->mSupportedDevices[k]); // give a valid ID to an attached device once confirmed it is reachable if ((index >= 0) && (mAvailableOutputDevices[index]->mId == 0)) { mAvailableOutputDevices[index]->mId = nextUniqueId(); } } if (mPrimaryOutput == 0 && outProfile->mFlags & AUDIO_OUTPUT_FLAG_PRIMARY) { mPrimaryOutput = output; } addOutput(output, outputDesc); setOutputDevice(output, outputDesc->mDevice, true); } } } // open input streams needed to access attached devices to validate // mAvailableInputDevices list for (size_t j = 0; j < mHwModules[i]->mInputProfiles.size(); j++) { const IOProfile *inProfile = mHwModules[i]->mInputProfiles[j]; if (inProfile->mSupportedDevices.isEmpty()) { ALOGW("Input profile contains no device on module %s", mHwModules[i]->mName); continue; } audio_devices_t profileTypes = inProfile->mSupportedDevices.types(); if (profileTypes & inputDeviceTypes) { AudioInputDescriptor *inputDesc = new AudioInputDescriptor(inProfile); inputDesc->mInputSource = AUDIO_SOURCE_MIC; inputDesc->mDevice = inProfile->mSupportedDevices[0]->mType; audio_io_handle_t input = mpClientInterface->openInput( inProfile->mModule->mHandle, &inputDesc->mDevice, &inputDesc->mSamplingRate, &inputDesc->mFormat, &inputDesc->mChannelMask); if (input != 0) { for (size_t k = 0; k < inProfile->mSupportedDevices.size(); k++) { audio_devices_t type = inProfile->mSupportedDevices[k]->mType; ssize_t index = mAvailableInputDevices.indexOf(inProfile->mSupportedDevices[k]); // give a valid ID to an attached device once confirmed it is reachable if ((index >= 0) && (mAvailableInputDevices[index]->mId == 0)) { mAvailableInputDevices[index]->mId = nextUniqueId(); } } mpClientInterface->closeInput(input); } else { ALOGW("Cannot open input stream for device %08x on hw module %s", inputDesc->mDevice, mHwModules[i]->mName); } delete inputDesc; } } } // make sure all attached devices have been allocated a unique ID for (size_t i = 0; i < mAvailableOutputDevices.size();) { if (mAvailableOutputDevices[i]->mId == 0) { ALOGW("Input device %08x unreachable", mAvailableOutputDevices[i]->mType); mAvailableOutputDevices.remove(mAvailableOutputDevices[i]); continue; } i++; } for (size_t i = 0; i < mAvailableInputDevices.size();) { if (mAvailableInputDevices[i]->mId == 0) { ALOGW("Input device %08x unreachable", mAvailableInputDevices[i]->mType); mAvailableInputDevices.remove(mAvailableInputDevices[i]); continue; } i++; } // make sure default device is reachable if (mAvailableOutputDevices.indexOf(mDefaultOutputDevice) < 0) { ALOGE("Default device %08x is unreachable", mDefaultOutputDevice->mType); } ALOGE_IF((mPrimaryOutput == 0), "Failed to open primary output"); updateDevicesAndOutputs(); #ifdef AUDIO_POLICY_TEST if (mPrimaryOutput != 0) { AudioParameter outputCmd = AudioParameter(); outputCmd.addInt(String8("set_id"), 0); mpClientInterface->setParameters(mPrimaryOutput, outputCmd.toString()); mTestDevice = AUDIO_DEVICE_OUT_SPEAKER; mTestSamplingRate = 44100; mTestFormat = AUDIO_FORMAT_PCM_16_BIT; mTestChannels = AUDIO_CHANNEL_OUT_STEREO; mTestLatencyMs = 0; mCurOutput = 0; mDirectOutput = false; for (int i = 0; i < NUM_TEST_OUTPUTS; i++) { mTestOutputs[i] = 0; } const size_t SIZE = 256; char buffer[SIZE]; snprintf(buffer, SIZE, "AudioPolicyManagerTest"); run(buffer, ANDROID_PRIORITY_AUDIO); } #endif //AUDIO_POLICY_TEST } AudioPolicyManager::~AudioPolicyManager() { #ifdef AUDIO_POLICY_TEST exit(); #endif //AUDIO_POLICY_TEST for (size_t i = 0; i < mOutputs.size(); i++) { mpClientInterface->closeOutput(mOutputs.keyAt(i)); delete mOutputs.valueAt(i); } for (size_t i = 0; i < mInputs.size(); i++) { mpClientInterface->closeInput(mInputs.keyAt(i)); delete mInputs.valueAt(i); } for (size_t i = 0; i < mHwModules.size(); i++) { delete mHwModules[i]; } mAvailableOutputDevices.clear(); mAvailableInputDevices.clear(); } status_t AudioPolicyManager::initCheck() { return (mPrimaryOutput == 0) ? NO_INIT : NO_ERROR; } #ifdef AUDIO_POLICY_TEST bool AudioPolicyManager::threadLoop() { ALOGV("entering threadLoop()"); while (!exitPending()) { String8 command; int valueInt; String8 value; Mutex::Autolock _l(mLock); mWaitWorkCV.waitRelative(mLock, milliseconds(50)); command = mpClientInterface->getParameters(0, String8("test_cmd_policy")); AudioParameter param = AudioParameter(command); if (param.getInt(String8("test_cmd_policy"), valueInt) == NO_ERROR && valueInt != 0) { ALOGV("Test command %s received", command.string()); String8 target; if (param.get(String8("target"), target) != NO_ERROR) { target = "Manager"; } if (param.getInt(String8("test_cmd_policy_output"), valueInt) == NO_ERROR) { param.remove(String8("test_cmd_policy_output")); mCurOutput = valueInt; } if (param.get(String8("test_cmd_policy_direct"), value) == NO_ERROR) { param.remove(String8("test_cmd_policy_direct")); if (value == "false") { mDirectOutput = false; } else if (value == "true") { mDirectOutput = true; } } if (param.getInt(String8("test_cmd_policy_input"), valueInt) == NO_ERROR) { param.remove(String8("test_cmd_policy_input")); mTestInput = valueInt; } if (param.get(String8("test_cmd_policy_format"), value) == NO_ERROR) { param.remove(String8("test_cmd_policy_format")); int format = AUDIO_FORMAT_INVALID; if (value == "PCM 16 bits") { format = AUDIO_FORMAT_PCM_16_BIT; } else if (value == "PCM 8 bits") { format = AUDIO_FORMAT_PCM_8_BIT; } else if (value == "Compressed MP3") { format = AUDIO_FORMAT_MP3; } if (format != AUDIO_FORMAT_INVALID) { if (target == "Manager") { mTestFormat = format; } else if (mTestOutputs[mCurOutput] != 0) { AudioParameter outputParam = AudioParameter(); outputParam.addInt(String8("format"), format); mpClientInterface->setParameters(mTestOutputs[mCurOutput], outputParam.toString()); } } } if (param.get(String8("test_cmd_policy_channels"), value) == NO_ERROR) { param.remove(String8("test_cmd_policy_channels")); int channels = 0; if (value == "Channels Stereo") { channels = AUDIO_CHANNEL_OUT_STEREO; } else if (value == "Channels Mono") { channels = AUDIO_CHANNEL_OUT_MONO; } if (channels != 0) { if (target == "Manager") { mTestChannels = channels; } else if (mTestOutputs[mCurOutput] != 0) { AudioParameter outputParam = AudioParameter(); outputParam.addInt(String8("channels"), channels); mpClientInterface->setParameters(mTestOutputs[mCurOutput], outputParam.toString()); } } } if (param.getInt(String8("test_cmd_policy_sampleRate"), valueInt) == NO_ERROR) { param.remove(String8("test_cmd_policy_sampleRate")); if (valueInt >= 0 && valueInt <= 96000) { int samplingRate = valueInt; if (target == "Manager") { mTestSamplingRate = samplingRate; } else if (mTestOutputs[mCurOutput] != 0) { AudioParameter outputParam = AudioParameter(); outputParam.addInt(String8("sampling_rate"), samplingRate); mpClientInterface->setParameters(mTestOutputs[mCurOutput], outputParam.toString()); } } } if (param.get(String8("test_cmd_policy_reopen"), value) == NO_ERROR) { param.remove(String8("test_cmd_policy_reopen")); AudioOutputDescriptor *outputDesc = mOutputs.valueFor(mPrimaryOutput); mpClientInterface->closeOutput(mPrimaryOutput); audio_module_handle_t moduleHandle = outputDesc->mModule->mHandle; delete mOutputs.valueFor(mPrimaryOutput); mOutputs.removeItem(mPrimaryOutput); AudioOutputDescriptor *outputDesc = new AudioOutputDescriptor(NULL); outputDesc->mDevice = AUDIO_DEVICE_OUT_SPEAKER; mPrimaryOutput = mpClientInterface->openOutput(moduleHandle, &outputDesc->mDevice, &outputDesc->mSamplingRate, &outputDesc->mFormat, &outputDesc->mChannelMask, &outputDesc->mLatency, outputDesc->mFlags); if (mPrimaryOutput == 0) { ALOGE("Failed to reopen hardware output stream, samplingRate: %d, format %d, channels %d", outputDesc->mSamplingRate, outputDesc->mFormat, outputDesc->mChannelMask); } else { AudioParameter outputCmd = AudioParameter(); outputCmd.addInt(String8("set_id"), 0); mpClientInterface->setParameters(mPrimaryOutput, outputCmd.toString()); addOutput(mPrimaryOutput, outputDesc); } } mpClientInterface->setParameters(0, String8("test_cmd_policy=")); } } return false; } void AudioPolicyManager::exit() { { AutoMutex _l(mLock); requestExit(); mWaitWorkCV.signal(); } requestExitAndWait(); } int AudioPolicyManager::testOutputIndex(audio_io_handle_t output) { for (int i = 0; i < NUM_TEST_OUTPUTS; i++) { if (output == mTestOutputs[i]) return i; } return 0; } #endif //AUDIO_POLICY_TEST // --- void AudioPolicyManager::addOutput(audio_io_handle_t id, AudioOutputDescriptor *outputDesc) { outputDesc->mId = id; mOutputs.add(id, outputDesc); } void AudioPolicyManager::addInput(audio_io_handle_t id, AudioInputDescriptor *inputDesc) { inputDesc->mId = id; mInputs.add(id, inputDesc); } String8 AudioPolicyManager::addressToParameter(audio_devices_t device, const String8 address) { if (device & AUDIO_DEVICE_OUT_ALL_A2DP) { return String8("a2dp_sink_address=")+address; } return address; } status_t AudioPolicyManager::checkOutputsForDevice(audio_devices_t device, audio_policy_dev_state_t state, SortedVector& outputs, const String8 address) { AudioOutputDescriptor *desc; if (state == AUDIO_POLICY_DEVICE_STATE_AVAILABLE) { // first list already open outputs that can be routed to this device for (size_t i = 0; i < mOutputs.size(); i++) { desc = mOutputs.valueAt(i); if (!desc->isDuplicated() && (desc->mProfile->mSupportedDevices.types() & device)) { ALOGV("checkOutputsForDevice(): adding opened output %d", mOutputs.keyAt(i)); outputs.add(mOutputs.keyAt(i)); } } // then look for output profiles that can be routed to this device SortedVector profiles; for (size_t i = 0; i < mHwModules.size(); i++) { if (mHwModules[i]->mHandle == 0) { continue; } for (size_t j = 0; j < mHwModules[i]->mOutputProfiles.size(); j++) { if (mHwModules[i]->mOutputProfiles[j]->mSupportedDevices.types() & device) { ALOGV("checkOutputsForDevice(): adding profile %zu from module %zu", j, i); profiles.add(mHwModules[i]->mOutputProfiles[j]); } } } if (profiles.isEmpty() && outputs.isEmpty()) { ALOGW("checkOutputsForDevice(): No output available for device %04x", device); return BAD_VALUE; } // open outputs for matching profiles if needed. Direct outputs are also opened to // query for dynamic parameters and will be closed later by setDeviceConnectionState() for (ssize_t profile_index = 0; profile_index < (ssize_t)profiles.size(); profile_index++) { IOProfile *profile = profiles[profile_index]; // nothing to do if one output is already opened for this profile size_t j; for (j = 0; j < mOutputs.size(); j++) { desc = mOutputs.valueAt(j); if (!desc->isDuplicated() && desc->mProfile == profile) { break; } } if (j != mOutputs.size()) { continue; } ALOGV("opening output for device %08x with params %s", device, address.string()); desc = new AudioOutputDescriptor(profile); desc->mDevice = device; audio_offload_info_t offloadInfo = AUDIO_INFO_INITIALIZER; offloadInfo.sample_rate = desc->mSamplingRate; offloadInfo.format = desc->mFormat; offloadInfo.channel_mask = desc->mChannelMask; audio_io_handle_t output = mpClientInterface->openOutput(profile->mModule->mHandle, &desc->mDevice, &desc->mSamplingRate, &desc->mFormat, &desc->mChannelMask, &desc->mLatency, desc->mFlags, &offloadInfo); if (output != 0) { // Here is where the out_set_parameters() for card & device gets called if (!address.isEmpty()) { mpClientInterface->setParameters(output, addressToParameter(device, address)); } // Here is where we step through and resolve any "dynamic" fields String8 reply; char *value; if (profile->mSamplingRates[0] == 0) { reply = mpClientInterface->getParameters(output, String8(AUDIO_PARAMETER_STREAM_SUP_SAMPLING_RATES)); ALOGV("checkOutputsForDevice() direct output sup sampling rates %s", reply.string()); value = strpbrk((char *)reply.string(), "="); if (value != NULL) { loadSamplingRates(value + 1, profile); } } if (profile->mFormats[0] == AUDIO_FORMAT_DEFAULT) { reply = mpClientInterface->getParameters(output, String8(AUDIO_PARAMETER_STREAM_SUP_FORMATS)); ALOGV("checkOutputsForDevice() direct output sup formats %s", reply.string()); value = strpbrk((char *)reply.string(), "="); if (value != NULL) { loadFormats(value + 1, profile); } } if (profile->mChannelMasks[0] == 0) { reply = mpClientInterface->getParameters(output, String8(AUDIO_PARAMETER_STREAM_SUP_CHANNELS)); ALOGV("checkOutputsForDevice() direct output sup channel masks %s", reply.string()); value = strpbrk((char *)reply.string(), "="); if (value != NULL) { loadOutChannels(value + 1, profile); } } if (((profile->mSamplingRates[0] == 0) && (profile->mSamplingRates.size() < 2)) || ((profile->mFormats[0] == AUDIO_FORMAT_DEFAULT) && (profile->mFormats.size() < 2)) || ((profile->mChannelMasks[0] == 0) && (profile->mChannelMasks.size() < 2))) { ALOGW("checkOutputsForDevice() direct output missing param"); mpClientInterface->closeOutput(output); output = 0; } else if (profile->mSamplingRates[0] == 0) { mpClientInterface->closeOutput(output); desc->mSamplingRate = profile->mSamplingRates[1]; offloadInfo.sample_rate = desc->mSamplingRate; output = mpClientInterface->openOutput( profile->mModule->mHandle, &desc->mDevice, &desc->mSamplingRate, &desc->mFormat, &desc->mChannelMask, &desc->mLatency, desc->mFlags, &offloadInfo); } if (output != 0) { addOutput(output, desc); if ((desc->mFlags & AUDIO_OUTPUT_FLAG_DIRECT) == 0) { audio_io_handle_t duplicatedOutput = 0; // set initial stream volume for device applyStreamVolumes(output, device, 0, true); //TODO: configure audio effect output stage here // open a duplicating output thread for the new output and the primary output duplicatedOutput = mpClientInterface->openDuplicateOutput(output, mPrimaryOutput); if (duplicatedOutput != 0) { // add duplicated output descriptor AudioOutputDescriptor *dupOutputDesc = new AudioOutputDescriptor(NULL); dupOutputDesc->mOutput1 = mOutputs.valueFor(mPrimaryOutput); dupOutputDesc->mOutput2 = mOutputs.valueFor(output); dupOutputDesc->mSamplingRate = desc->mSamplingRate; dupOutputDesc->mFormat = desc->mFormat; dupOutputDesc->mChannelMask = desc->mChannelMask; dupOutputDesc->mLatency = desc->mLatency; addOutput(duplicatedOutput, dupOutputDesc); applyStreamVolumes(duplicatedOutput, device, 0, true); } else { ALOGW("checkOutputsForDevice() could not open dup output for %d and %d", mPrimaryOutput, output); mpClientInterface->closeOutput(output); mOutputs.removeItem(output); output = 0; } } } } if (output == 0) { ALOGW("checkOutputsForDevice() could not open output for device %x", device); delete desc; profiles.removeAt(profile_index); profile_index--; } else { outputs.add(output); ALOGV("checkOutputsForDevice(): adding output %d", output); } } if (profiles.isEmpty()) { ALOGW("checkOutputsForDevice(): No output available for device %04x", device); return BAD_VALUE; } } else { // Disconnect // check if one opened output is not needed any more after disconnecting one device for (size_t i = 0; i < mOutputs.size(); i++) { desc = mOutputs.valueAt(i); if (!desc->isDuplicated() && !(desc->mProfile->mSupportedDevices.types() & mAvailableOutputDevices.types())) { ALOGV("checkOutputsForDevice(): disconnecting adding output %d", mOutputs.keyAt(i)); outputs.add(mOutputs.keyAt(i)); } } // Clear any profiles associated with the disconnected device. for (size_t i = 0; i < mHwModules.size(); i++) { if (mHwModules[i]->mHandle == 0) { continue; } for (size_t j = 0; j < mHwModules[i]->mOutputProfiles.size(); j++) { IOProfile *profile = mHwModules[i]->mOutputProfiles[j]; if (profile->mSupportedDevices.types() & device) { ALOGV("checkOutputsForDevice(): " "clearing direct output profile %zu on module %zu", j, i); if (profile->mSamplingRates[0] == 0) { profile->mSamplingRates.clear(); profile->mSamplingRates.add(0); } if (profile->mFormats[0] == AUDIO_FORMAT_DEFAULT) { profile->mFormats.clear(); profile->mFormats.add(AUDIO_FORMAT_DEFAULT); } if (profile->mChannelMasks[0] == 0) { profile->mChannelMasks.clear(); profile->mChannelMasks.add(0); } } } } } return NO_ERROR; } status_t AudioPolicyManager::checkInputsForDevice(audio_devices_t device, audio_policy_dev_state_t state, SortedVector& inputs, const String8 address) { AudioInputDescriptor *desc; if (state == AUDIO_POLICY_DEVICE_STATE_AVAILABLE) { // first list already open inputs that can be routed to this device for (size_t input_index = 0; input_index < mInputs.size(); input_index++) { desc = mInputs.valueAt(input_index); if (desc->mProfile->mSupportedDevices.types() & (device & ~AUDIO_DEVICE_BIT_IN)) { ALOGV("checkInputsForDevice(): adding opened input %d", mInputs.keyAt(input_index)); inputs.add(mInputs.keyAt(input_index)); } } // then look for input profiles that can be routed to this device SortedVector profiles; for (size_t module_idx = 0; module_idx < mHwModules.size(); module_idx++) { if (mHwModules[module_idx]->mHandle == 0) { continue; } for (size_t profile_index = 0; profile_index < mHwModules[module_idx]->mInputProfiles.size(); profile_index++) { if (mHwModules[module_idx]->mInputProfiles[profile_index]->mSupportedDevices.types() & (device & ~AUDIO_DEVICE_BIT_IN)) { ALOGV("checkInputsForDevice(): adding profile %d from module %d", profile_index, module_idx); profiles.add(mHwModules[module_idx]->mInputProfiles[profile_index]); } } } if (profiles.isEmpty() && inputs.isEmpty()) { ALOGW("checkInputsForDevice(): No input available for device 0x%X", device); return BAD_VALUE; } // open inputs for matching profiles if needed. Direct inputs are also opened to // query for dynamic parameters and will be closed later by setDeviceConnectionState() for (ssize_t profile_index = 0; profile_index < (ssize_t)profiles.size(); profile_index++) { IOProfile *profile = profiles[profile_index]; // nothing to do if one input is already opened for this profile size_t input_index; for (input_index = 0; input_index < mInputs.size(); input_index++) { desc = mInputs.valueAt(input_index); if (desc->mProfile == profile) { break; } } if (input_index != mInputs.size()) { continue; } ALOGV("opening input for device 0x%X with params %s", device, address.string()); desc = new AudioInputDescriptor(profile); desc->mDevice = device; audio_io_handle_t input = mpClientInterface->openInput(profile->mModule->mHandle, &desc->mDevice, &desc->mSamplingRate, &desc->mFormat, &desc->mChannelMask); if (input != 0) { if (!address.isEmpty()) { mpClientInterface->setParameters(input, addressToParameter(device, address)); } // Here is where we step through and resolve any "dynamic" fields String8 reply; char *value; if (profile->mSamplingRates[0] == 0) { reply = mpClientInterface->getParameters(input, String8(AUDIO_PARAMETER_STREAM_SUP_SAMPLING_RATES)); ALOGV("checkInputsForDevice() direct input sup sampling rates %s", reply.string()); value = strpbrk((char *)reply.string(), "="); if (value != NULL) { loadSamplingRates(value + 1, profile); } } if (profile->mFormats[0] == AUDIO_FORMAT_DEFAULT) { reply = mpClientInterface->getParameters(input, String8(AUDIO_PARAMETER_STREAM_SUP_FORMATS)); ALOGV("checkInputsForDevice() direct input sup formats %s", reply.string()); value = strpbrk((char *)reply.string(), "="); if (value != NULL) { loadFormats(value + 1, profile); } } if (profile->mChannelMasks[0] == 0) { reply = mpClientInterface->getParameters(input, String8(AUDIO_PARAMETER_STREAM_SUP_CHANNELS)); ALOGV("checkInputsForDevice() direct input sup channel masks %s", reply.string()); value = strpbrk((char *)reply.string(), "="); if (value != NULL) { loadInChannels(value + 1, profile); } } if (((profile->mSamplingRates[0] == 0) && (profile->mSamplingRates.size() < 2)) || ((profile->mFormats[0] == 0) && (profile->mFormats.size() < 2)) || ((profile->mChannelMasks[0] == 0) && (profile->mChannelMasks.size() < 2))) { ALOGW("checkInputsForDevice() direct input missing param"); mpClientInterface->closeInput(input); input = 0; } if (input != 0) { addInput(input, desc); } } // endif input != 0 if (input == 0) { ALOGW("checkInputsForDevice() could not open input for device 0x%X", device); delete desc; profiles.removeAt(profile_index); profile_index--; } else { inputs.add(input); ALOGV("checkInputsForDevice(): adding input %d", input); } } // end scan profiles if (profiles.isEmpty()) { ALOGW("checkInputsForDevice(): No input available for device 0x%X", device); return BAD_VALUE; } } else { // Disconnect // check if one opened input is not needed any more after disconnecting one device for (size_t input_index = 0; input_index < mInputs.size(); input_index++) { desc = mInputs.valueAt(input_index); if (!(desc->mProfile->mSupportedDevices.types() & mAvailableInputDevices.types())) { ALOGV("checkInputsForDevice(): disconnecting adding input %d", mInputs.keyAt(input_index)); inputs.add(mInputs.keyAt(input_index)); } } // Clear any profiles associated with the disconnected device. for (size_t module_index = 0; module_index < mHwModules.size(); module_index++) { if (mHwModules[module_index]->mHandle == 0) { continue; } for (size_t profile_index = 0; profile_index < mHwModules[module_index]->mInputProfiles.size(); profile_index++) { IOProfile *profile = mHwModules[module_index]->mInputProfiles[profile_index]; if (profile->mSupportedDevices.types() & device) { ALOGV("checkInputsForDevice(): clearing direct input profile %d on module %d", profile_index, module_index); if (profile->mSamplingRates[0] == 0) { profile->mSamplingRates.clear(); profile->mSamplingRates.add(0); } if (profile->mFormats[0] == AUDIO_FORMAT_DEFAULT) { profile->mFormats.clear(); profile->mFormats.add(AUDIO_FORMAT_DEFAULT); } if (profile->mChannelMasks[0] == 0) { profile->mChannelMasks.clear(); profile->mChannelMasks.add(0); } } } } } // end disconnect return NO_ERROR; } void AudioPolicyManager::closeOutput(audio_io_handle_t output) { ALOGV("closeOutput(%d)", output); AudioOutputDescriptor *outputDesc = mOutputs.valueFor(output); if (outputDesc == NULL) { ALOGW("closeOutput() unknown output %d", output); return; } // look for duplicated outputs connected to the output being removed. for (size_t i = 0; i < mOutputs.size(); i++) { AudioOutputDescriptor *dupOutputDesc = mOutputs.valueAt(i); if (dupOutputDesc->isDuplicated() && (dupOutputDesc->mOutput1 == outputDesc || dupOutputDesc->mOutput2 == outputDesc)) { AudioOutputDescriptor *outputDesc2; if (dupOutputDesc->mOutput1 == outputDesc) { outputDesc2 = dupOutputDesc->mOutput2; } else { outputDesc2 = dupOutputDesc->mOutput1; } // As all active tracks on duplicated output will be deleted, // and as they were also referenced on the other output, the reference // count for their stream type must be adjusted accordingly on // the other output. for (int j = 0; j < AUDIO_STREAM_CNT; j++) { int refCount = dupOutputDesc->mRefCount[j]; outputDesc2->changeRefCount((audio_stream_type_t)j,-refCount); } audio_io_handle_t duplicatedOutput = mOutputs.keyAt(i); ALOGV("closeOutput() closing also duplicated output %d", duplicatedOutput); mpClientInterface->closeOutput(duplicatedOutput); delete mOutputs.valueFor(duplicatedOutput); mOutputs.removeItem(duplicatedOutput); } } AudioParameter param; param.add(String8("closing"), String8("true")); mpClientInterface->setParameters(output, param.toString()); mpClientInterface->closeOutput(output); delete outputDesc; mOutputs.removeItem(output); mPreviousOutputs = mOutputs; } SortedVector AudioPolicyManager::getOutputsForDevice(audio_devices_t device, DefaultKeyedVector openOutputs) { SortedVector outputs; ALOGVV("getOutputsForDevice() device %04x", device); for (size_t i = 0; i < openOutputs.size(); i++) { ALOGVV("output %d isDuplicated=%d device=%04x", i, openOutputs.valueAt(i)->isDuplicated(), openOutputs.valueAt(i)->supportedDevices()); if ((device & openOutputs.valueAt(i)->supportedDevices()) == device) { ALOGVV("getOutputsForDevice() found output %d", openOutputs.keyAt(i)); outputs.add(openOutputs.keyAt(i)); } } return outputs; } bool AudioPolicyManager::vectorsEqual(SortedVector& outputs1, SortedVector& outputs2) { if (outputs1.size() != outputs2.size()) { return false; } for (size_t i = 0; i < outputs1.size(); i++) { if (outputs1[i] != outputs2[i]) { return false; } } return true; } void AudioPolicyManager::checkOutputForStrategy(routing_strategy strategy) { audio_devices_t oldDevice = getDeviceForStrategy(strategy, true /*fromCache*/); audio_devices_t newDevice = getDeviceForStrategy(strategy, false /*fromCache*/); SortedVector srcOutputs = getOutputsForDevice(oldDevice, mPreviousOutputs); SortedVector dstOutputs = getOutputsForDevice(newDevice, mOutputs); if (!vectorsEqual(srcOutputs,dstOutputs)) { ALOGV("checkOutputForStrategy() strategy %d, moving from output %d to output %d", strategy, srcOutputs[0], dstOutputs[0]); // mute strategy while moving tracks from one output to another for (size_t i = 0; i < srcOutputs.size(); i++) { AudioOutputDescriptor *desc = mOutputs.valueFor(srcOutputs[i]); if (desc->isStrategyActive(strategy)) { setStrategyMute(strategy, true, srcOutputs[i]); setStrategyMute(strategy, false, srcOutputs[i], MUTE_TIME_MS, newDevice); } } // Move effects associated to this strategy from previous output to new output if (strategy == STRATEGY_MEDIA) { audio_io_handle_t fxOutput = selectOutputForEffects(dstOutputs); SortedVector moved; for (size_t i = 0; i < mEffects.size(); i++) { EffectDescriptor *desc = mEffects.valueAt(i); if (desc->mSession == AUDIO_SESSION_OUTPUT_MIX && desc->mIo != fxOutput) { if (moved.indexOf(desc->mIo) < 0) { ALOGV("checkOutputForStrategy() moving effect %d to output %d", mEffects.keyAt(i), fxOutput); mpClientInterface->moveEffects(AUDIO_SESSION_OUTPUT_MIX, desc->mIo, fxOutput); moved.add(desc->mIo); } desc->mIo = fxOutput; } } } // Move tracks associated to this strategy from previous output to new output for (int i = 0; i < AUDIO_STREAM_CNT; i++) { if (getStrategy((audio_stream_type_t)i) == strategy) { mpClientInterface->invalidateStream((audio_stream_type_t)i); } } } } void AudioPolicyManager::checkOutputForAllStrategies() { checkOutputForStrategy(STRATEGY_ENFORCED_AUDIBLE); checkOutputForStrategy(STRATEGY_PHONE); checkOutputForStrategy(STRATEGY_SONIFICATION); checkOutputForStrategy(STRATEGY_SONIFICATION_RESPECTFUL); checkOutputForStrategy(STRATEGY_MEDIA); checkOutputForStrategy(STRATEGY_DTMF); } audio_io_handle_t AudioPolicyManager::getA2dpOutput() { for (size_t i = 0; i < mOutputs.size(); i++) { AudioOutputDescriptor *outputDesc = mOutputs.valueAt(i); if (!outputDesc->isDuplicated() && outputDesc->device() & AUDIO_DEVICE_OUT_ALL_A2DP) { return mOutputs.keyAt(i); } } return 0; } void AudioPolicyManager::checkA2dpSuspend() { audio_io_handle_t a2dpOutput = getA2dpOutput(); if (a2dpOutput == 0) { mA2dpSuspended = false; return; } bool isScoConnected = (mAvailableInputDevices.types() & AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET) != 0; // suspend A2DP output if: // (NOT already suspended) && // ((SCO device is connected && // (forced usage for communication || for record is SCO))) || // (phone state is ringing || in call) // // restore A2DP output if: // (Already suspended) && // ((SCO device is NOT connected || // (forced usage NOT for communication && NOT for record is SCO))) && // (phone state is NOT ringing && NOT in call) // if (mA2dpSuspended) { if ((!isScoConnected || ((mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION] != AUDIO_POLICY_FORCE_BT_SCO) && (mForceUse[AUDIO_POLICY_FORCE_FOR_RECORD] != AUDIO_POLICY_FORCE_BT_SCO))) && ((mPhoneState != AUDIO_MODE_IN_CALL) && (mPhoneState != AUDIO_MODE_RINGTONE))) { mpClientInterface->restoreOutput(a2dpOutput); mA2dpSuspended = false; } } else { if ((isScoConnected && ((mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION] == AUDIO_POLICY_FORCE_BT_SCO) || (mForceUse[AUDIO_POLICY_FORCE_FOR_RECORD] == AUDIO_POLICY_FORCE_BT_SCO))) || ((mPhoneState == AUDIO_MODE_IN_CALL) || (mPhoneState == AUDIO_MODE_RINGTONE))) { mpClientInterface->suspendOutput(a2dpOutput); mA2dpSuspended = true; } } } audio_devices_t AudioPolicyManager::getNewDevice(audio_io_handle_t output, bool fromCache) { audio_devices_t device = AUDIO_DEVICE_NONE; AudioOutputDescriptor *outputDesc = mOutputs.valueFor(output); // check the following by order of priority to request a routing change if necessary: // 1: the strategy enforced audible is active on the output: // use device for strategy enforced audible // 2: we are in call or the strategy phone is active on the output: // use device for strategy phone // 3: the strategy sonification is active on the output: // use device for strategy sonification // 4: the strategy "respectful" sonification is active on the output: // use device for strategy "respectful" sonification // 5: the strategy media is active on the output: // use device for strategy media // 6: the strategy DTMF is active on the output: // use device for strategy DTMF if (outputDesc->isStrategyActive(STRATEGY_ENFORCED_AUDIBLE)) { device = getDeviceForStrategy(STRATEGY_ENFORCED_AUDIBLE, fromCache); } else if (isInCall() || outputDesc->isStrategyActive(STRATEGY_PHONE)) { device = getDeviceForStrategy(STRATEGY_PHONE, fromCache); } else if (outputDesc->isStrategyActive(STRATEGY_SONIFICATION)) { device = getDeviceForStrategy(STRATEGY_SONIFICATION, fromCache); } else if (outputDesc->isStrategyActive(STRATEGY_SONIFICATION_RESPECTFUL)) { device = getDeviceForStrategy(STRATEGY_SONIFICATION_RESPECTFUL, fromCache); } else if (outputDesc->isStrategyActive(STRATEGY_MEDIA)) { device = getDeviceForStrategy(STRATEGY_MEDIA, fromCache); } else if (outputDesc->isStrategyActive(STRATEGY_DTMF)) { device = getDeviceForStrategy(STRATEGY_DTMF, fromCache); } ALOGV("getNewDevice() selected device %x", device); return device; } uint32_t AudioPolicyManager::getStrategyForStream(audio_stream_type_t stream) { return (uint32_t)getStrategy(stream); } audio_devices_t AudioPolicyManager::getDevicesForStream(audio_stream_type_t stream) { audio_devices_t devices; // By checking the range of stream before calling getStrategy, we avoid // getStrategy's behavior for invalid streams. getStrategy would do a ALOGE // and then return STRATEGY_MEDIA, but we want to return the empty set. if (stream < (audio_stream_type_t) 0 || stream >= AUDIO_STREAM_CNT) { devices = AUDIO_DEVICE_NONE; } else { AudioPolicyManager::routing_strategy strategy = getStrategy(stream); devices = getDeviceForStrategy(strategy, true /*fromCache*/); } return devices; } AudioPolicyManager::routing_strategy AudioPolicyManager::getStrategy( audio_stream_type_t stream) { // stream to strategy mapping switch (stream) { case AUDIO_STREAM_VOICE_CALL: case AUDIO_STREAM_BLUETOOTH_SCO: return STRATEGY_PHONE; case AUDIO_STREAM_RING: case AUDIO_STREAM_ALARM: return STRATEGY_SONIFICATION; case AUDIO_STREAM_NOTIFICATION: return STRATEGY_SONIFICATION_RESPECTFUL; case AUDIO_STREAM_DTMF: return STRATEGY_DTMF; default: ALOGE("unknown stream type"); case AUDIO_STREAM_SYSTEM: // NOTE: SYSTEM stream uses MEDIA strategy because muting music and switching outputs // while key clicks are played produces a poor result case AUDIO_STREAM_TTS: case AUDIO_STREAM_MUSIC: return STRATEGY_MEDIA; case AUDIO_STREAM_ENFORCED_AUDIBLE: return STRATEGY_ENFORCED_AUDIBLE; } } void AudioPolicyManager::handleNotificationRoutingForStream(audio_stream_type_t stream) { switch(stream) { case AUDIO_STREAM_MUSIC: checkOutputForStrategy(STRATEGY_SONIFICATION_RESPECTFUL); updateDevicesAndOutputs(); break; default: break; } } audio_devices_t AudioPolicyManager::getDeviceForStrategy(routing_strategy strategy, bool fromCache) { uint32_t device = AUDIO_DEVICE_NONE; if (fromCache) { ALOGVV("getDeviceForStrategy() from cache strategy %d, device %x", strategy, mDeviceForStrategy[strategy]); return mDeviceForStrategy[strategy]; } audio_devices_t availableOutputDeviceTypes = mAvailableOutputDevices.types(); switch (strategy) { case STRATEGY_SONIFICATION_RESPECTFUL: if (isInCall()) { device = getDeviceForStrategy(STRATEGY_SONIFICATION, false /*fromCache*/); } else if (isStreamActiveRemotely(AUDIO_STREAM_MUSIC, SONIFICATION_RESPECTFUL_AFTER_MUSIC_DELAY)) { // while media is playing on a remote device, use the the sonification behavior. // Note that we test this usecase before testing if media is playing because // the isStreamActive() method only informs about the activity of a stream, not // if it's for local playback. Note also that we use the same delay between both tests device = getDeviceForStrategy(STRATEGY_SONIFICATION, false /*fromCache*/); } else if (isStreamActive(AUDIO_STREAM_MUSIC, SONIFICATION_RESPECTFUL_AFTER_MUSIC_DELAY)) { // while media is playing (or has recently played), use the same device device = getDeviceForStrategy(STRATEGY_MEDIA, false /*fromCache*/); } else { // when media is not playing anymore, fall back on the sonification behavior device = getDeviceForStrategy(STRATEGY_SONIFICATION, false /*fromCache*/); } break; case STRATEGY_DTMF: if (!isInCall()) { // when off call, DTMF strategy follows the same rules as MEDIA strategy device = getDeviceForStrategy(STRATEGY_MEDIA, false /*fromCache*/); break; } // when in call, DTMF and PHONE strategies follow the same rules // FALL THROUGH case STRATEGY_PHONE: // for phone strategy, we first consider the forced use and then the available devices by order // of priority switch (mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION]) { case AUDIO_POLICY_FORCE_BT_SCO: if (!isInCall() || strategy != STRATEGY_DTMF) { device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT; if (device) break; } device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_SCO; if (device) break; // if SCO device is requested but no SCO device is available, fall back to default case // FALL THROUGH default: // FORCE_NONE // when not in a phone call, phone strategy should route STREAM_VOICE_CALL to A2DP if (!isInCall() && (mForceUse[AUDIO_POLICY_FORCE_FOR_MEDIA] != AUDIO_POLICY_FORCE_NO_BT_A2DP) && (getA2dpOutput() != 0) && !mA2dpSuspended) { device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES; if (device) break; } device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_WIRED_HEADPHONE; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_WIRED_HEADSET; if (device) break; if (mPhoneState != AUDIO_MODE_IN_CALL) { device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_ACCESSORY; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_DEVICE; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_AUX_DIGITAL; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET; if (device) break; } device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_EARPIECE; if (device) break; device = mDefaultOutputDevice->mType; if (device == AUDIO_DEVICE_NONE) { ALOGE("getDeviceForStrategy() no device found for STRATEGY_PHONE"); } break; case AUDIO_POLICY_FORCE_SPEAKER: // when not in a phone call, phone strategy should route STREAM_VOICE_CALL to // A2DP speaker when forcing to speaker output if (!isInCall() && (mForceUse[AUDIO_POLICY_FORCE_FOR_MEDIA] != AUDIO_POLICY_FORCE_NO_BT_A2DP) && (getA2dpOutput() != 0) && !mA2dpSuspended) { device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER; if (device) break; } if (mPhoneState != AUDIO_MODE_IN_CALL) { device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_ACCESSORY; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_DEVICE; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_AUX_DIGITAL; if (device) break; device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET; if (device) break; } device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_SPEAKER; if (device) break; device = mDefaultOutputDevice->mType; if (device == AUDIO_DEVICE_NONE) { ALOGE("getDeviceForStrategy() no device found for STRATEGY_PHONE, FORCE_SPEAKER"); } break; } break; case STRATEGY_SONIFICATION: // If incall, just select the STRATEGY_PHONE device: The rest of the behavior is handled by // handleIncallSonification(). if (isInCall()) { device = getDeviceForStrategy(STRATEGY_PHONE, false /*fromCache*/); break; } // FALL THROUGH case STRATEGY_ENFORCED_AUDIBLE: // strategy STRATEGY_ENFORCED_AUDIBLE uses same routing policy as STRATEGY_SONIFICATION // except: // - when in call where it doesn't default to STRATEGY_PHONE behavior // - in countries where not enforced in which case it follows STRATEGY_MEDIA if ((strategy == STRATEGY_SONIFICATION) || (mForceUse[AUDIO_POLICY_FORCE_FOR_SYSTEM] == AUDIO_POLICY_FORCE_SYSTEM_ENFORCED)) { device = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_SPEAKER; if (device == AUDIO_DEVICE_NONE) { ALOGE("getDeviceForStrategy() speaker device not found for STRATEGY_SONIFICATION"); } } // The second device used for sonification is the same as the device used by media strategy // FALL THROUGH case STRATEGY_MEDIA: { uint32_t device2 = AUDIO_DEVICE_NONE; if (strategy != STRATEGY_SONIFICATION) { // no sonification on remote submix (e.g. WFD) device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_REMOTE_SUBMIX; } if ((device2 == AUDIO_DEVICE_NONE) && (mForceUse[AUDIO_POLICY_FORCE_FOR_MEDIA] != AUDIO_POLICY_FORCE_NO_BT_A2DP) && (getA2dpOutput() != 0) && !mA2dpSuspended) { device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP; if (device2 == AUDIO_DEVICE_NONE) { device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES; } if (device2 == AUDIO_DEVICE_NONE) { device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER; } } if (device2 == AUDIO_DEVICE_NONE) { device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_WIRED_HEADPHONE; } if (device2 == AUDIO_DEVICE_NONE) { device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_WIRED_HEADSET; } if (device2 == AUDIO_DEVICE_NONE) { device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_ACCESSORY; } if (device2 == AUDIO_DEVICE_NONE) { device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_USB_DEVICE; } if (device2 == AUDIO_DEVICE_NONE) { device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET; } if ((device2 == AUDIO_DEVICE_NONE) && (strategy != STRATEGY_SONIFICATION)) { // no sonification on aux digital (e.g. HDMI) device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_AUX_DIGITAL; } if ((device2 == AUDIO_DEVICE_NONE) && (mForceUse[AUDIO_POLICY_FORCE_FOR_DOCK] == AUDIO_POLICY_FORCE_ANALOG_DOCK)) { device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET; } if (device2 == AUDIO_DEVICE_NONE) { device2 = availableOutputDeviceTypes & AUDIO_DEVICE_OUT_SPEAKER; } // device is DEVICE_OUT_SPEAKER if we come from case STRATEGY_SONIFICATION or // STRATEGY_ENFORCED_AUDIBLE, AUDIO_DEVICE_NONE otherwise device |= device2; if (device) break; device = mDefaultOutputDevice->mType; if (device == AUDIO_DEVICE_NONE) { ALOGE("getDeviceForStrategy() no device found for STRATEGY_MEDIA"); } } break; default: ALOGW("getDeviceForStrategy() unknown strategy: %d", strategy); break; } ALOGVV("getDeviceForStrategy() strategy %d, device %x", strategy, device); return device; } void AudioPolicyManager::updateDevicesAndOutputs() { for (int i = 0; i < NUM_STRATEGIES; i++) { mDeviceForStrategy[i] = getDeviceForStrategy((routing_strategy)i, false /*fromCache*/); } mPreviousOutputs = mOutputs; } uint32_t AudioPolicyManager::checkDeviceMuteStrategies(AudioOutputDescriptor *outputDesc, audio_devices_t prevDevice, uint32_t delayMs) { // mute/unmute strategies using an incompatible device combination // if muting, wait for the audio in pcm buffer to be drained before proceeding // if unmuting, unmute only after the specified delay if (outputDesc->isDuplicated()) { return 0; } uint32_t muteWaitMs = 0; audio_devices_t device = outputDesc->device(); bool shouldMute = outputDesc->isActive() && (popcount(device) >= 2); for (size_t i = 0; i < NUM_STRATEGIES; i++) { audio_devices_t curDevice = getDeviceForStrategy((routing_strategy)i, false /*fromCache*/); bool mute = shouldMute && (curDevice & device) && (curDevice != device); bool doMute = false; if (mute && !outputDesc->mStrategyMutedByDevice[i]) { doMute = true; outputDesc->mStrategyMutedByDevice[i] = true; } else if (!mute && outputDesc->mStrategyMutedByDevice[i]){ doMute = true; outputDesc->mStrategyMutedByDevice[i] = false; } if (doMute) { for (size_t j = 0; j < mOutputs.size(); j++) { AudioOutputDescriptor *desc = mOutputs.valueAt(j); // skip output if it does not share any device with current output if ((desc->supportedDevices() & outputDesc->supportedDevices()) == AUDIO_DEVICE_NONE) { continue; } audio_io_handle_t curOutput = mOutputs.keyAt(j); ALOGVV("checkDeviceMuteStrategies() %s strategy %d (curDevice %04x) on output %d", mute ? "muting" : "unmuting", i, curDevice, curOutput); setStrategyMute((routing_strategy)i, mute, curOutput, mute ? 0 : delayMs); if (desc->isStrategyActive((routing_strategy)i)) { if (mute) { // FIXME: should not need to double latency if volume could be applied // immediately by the audioflinger mixer. We must account for the delay // between now and the next time the audioflinger thread for this output // will process a buffer (which corresponds to one buffer size, // usually 1/2 or 1/4 of the latency). if (muteWaitMs < desc->latency() * 2) { muteWaitMs = desc->latency() * 2; } } } } } } // temporary mute output if device selection changes to avoid volume bursts due to // different per device volumes if (outputDesc->isActive() && (device != prevDevice)) { if (muteWaitMs < outputDesc->latency() * 2) { muteWaitMs = outputDesc->latency() * 2; } for (size_t i = 0; i < NUM_STRATEGIES; i++) { if (outputDesc->isStrategyActive((routing_strategy)i)) { setStrategyMute((routing_strategy)i, true, outputDesc->mId); // do tempMute unmute after twice the mute wait time setStrategyMute((routing_strategy)i, false, outputDesc->mId, muteWaitMs *2, device); } } } // wait for the PCM output buffers to empty before proceeding with the rest of the command if (muteWaitMs > delayMs) { muteWaitMs -= delayMs; usleep(muteWaitMs * 1000); return muteWaitMs; } return 0; } uint32_t AudioPolicyManager::setOutputDevice(audio_io_handle_t output, audio_devices_t device, bool force, int delayMs) { ALOGV("setOutputDevice() output %d device %04x delayMs %d", output, device, delayMs); AudioOutputDescriptor *outputDesc = mOutputs.valueFor(output); AudioParameter param; uint32_t muteWaitMs; if (outputDesc->isDuplicated()) { muteWaitMs = setOutputDevice(outputDesc->mOutput1->mId, device, force, delayMs); muteWaitMs += setOutputDevice(outputDesc->mOutput2->mId, device, force, delayMs); return muteWaitMs; } // no need to proceed if new device is not AUDIO_DEVICE_NONE and not supported by current // output profile if ((device != AUDIO_DEVICE_NONE) && ((device & outputDesc->mProfile->mSupportedDevices.types()) == 0)) { return 0; } // filter devices according to output selected device = (audio_devices_t)(device & outputDesc->mProfile->mSupportedDevices.types()); audio_devices_t prevDevice = outputDesc->mDevice; ALOGV("setOutputDevice() prevDevice %04x", prevDevice); if (device != AUDIO_DEVICE_NONE) { outputDesc->mDevice = device; } muteWaitMs = checkDeviceMuteStrategies(outputDesc, prevDevice, delayMs); // Do not change the routing if: // - the requested device is AUDIO_DEVICE_NONE // - the requested device is the same as current device and force is not specified. // Doing this check here allows the caller to call setOutputDevice() without conditions if ((device == AUDIO_DEVICE_NONE || device == prevDevice) && !force) { ALOGV("setOutputDevice() setting same device %04x or null device for output %d", device, output); return muteWaitMs; } ALOGV("setOutputDevice() changing device"); // do the routing param.addInt(String8(AudioParameter::keyRouting), (int)device); mpClientInterface->setParameters(output, param.toString(), delayMs); // update stream volumes according to new device applyStreamVolumes(output, device, delayMs); return muteWaitMs; } AudioPolicyManager::IOProfile *AudioPolicyManager::getInputProfile(audio_devices_t device, uint32_t samplingRate, audio_format_t format, audio_channel_mask_t channelMask) { // Choose an input profile based on the requested capture parameters: select the first available // profile supporting all requested parameters. for (size_t i = 0; i < mHwModules.size(); i++) { if (mHwModules[i]->mHandle == 0) { continue; } for (size_t j = 0; j < mHwModules[i]->mInputProfiles.size(); j++) { IOProfile *profile = mHwModules[i]->mInputProfiles[j]; // profile->log(); if (profile->isCompatibleProfile(device, samplingRate, format, channelMask, AUDIO_OUTPUT_FLAG_NONE)) { return profile; } } } return NULL; } audio_devices_t AudioPolicyManager::getDeviceForInputSource(audio_source_t inputSource) { uint32_t device = AUDIO_DEVICE_NONE; audio_devices_t availableDeviceTypes = mAvailableInputDevices.types() & ~AUDIO_DEVICE_BIT_IN; switch (inputSource) { case AUDIO_SOURCE_VOICE_UPLINK: if (availableDeviceTypes & AUDIO_DEVICE_IN_VOICE_CALL) { device = AUDIO_DEVICE_IN_VOICE_CALL; break; } // FALL THROUGH case AUDIO_SOURCE_DEFAULT: case AUDIO_SOURCE_MIC: case AUDIO_SOURCE_VOICE_RECOGNITION: case AUDIO_SOURCE_HOTWORD: case AUDIO_SOURCE_VOICE_COMMUNICATION: if (mForceUse[AUDIO_POLICY_FORCE_FOR_RECORD] == AUDIO_POLICY_FORCE_BT_SCO && availableDeviceTypes & AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET) { device = AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET; } else if (availableDeviceTypes & AUDIO_DEVICE_IN_WIRED_HEADSET) { device = AUDIO_DEVICE_IN_WIRED_HEADSET; } else if (availableDeviceTypes & AUDIO_DEVICE_IN_USB_DEVICE) { device = AUDIO_DEVICE_IN_USB_DEVICE; } else if (availableDeviceTypes & AUDIO_DEVICE_IN_BUILTIN_MIC) { device = AUDIO_DEVICE_IN_BUILTIN_MIC; } break; case AUDIO_SOURCE_CAMCORDER: if (availableDeviceTypes & AUDIO_DEVICE_IN_BACK_MIC) { device = AUDIO_DEVICE_IN_BACK_MIC; } else if (availableDeviceTypes & AUDIO_DEVICE_IN_BUILTIN_MIC) { device = AUDIO_DEVICE_IN_BUILTIN_MIC; } break; case AUDIO_SOURCE_VOICE_DOWNLINK: case AUDIO_SOURCE_VOICE_CALL: if (availableDeviceTypes & AUDIO_DEVICE_IN_VOICE_CALL) { device = AUDIO_DEVICE_IN_VOICE_CALL; } break; case AUDIO_SOURCE_REMOTE_SUBMIX: if (availableDeviceTypes & AUDIO_DEVICE_IN_REMOTE_SUBMIX) { device = AUDIO_DEVICE_IN_REMOTE_SUBMIX; } break; default: ALOGW("getDeviceForInputSource() invalid input source %d", inputSource); break; } ALOGV("getDeviceForInputSource()input source %d, device %08x", inputSource, device); return device; } bool AudioPolicyManager::isVirtualInputDevice(audio_devices_t device) { if ((device & AUDIO_DEVICE_BIT_IN) != 0) { device &= ~AUDIO_DEVICE_BIT_IN; if ((popcount(device) == 1) && ((device & ~APM_AUDIO_IN_DEVICE_VIRTUAL_ALL) == 0)) return true; } return false; } audio_io_handle_t AudioPolicyManager::getActiveInput(bool ignoreVirtualInputs) { for (size_t i = 0; i < mInputs.size(); i++) { const AudioInputDescriptor * input_descriptor = mInputs.valueAt(i); if ((input_descriptor->mRefCount > 0) && (!ignoreVirtualInputs || !isVirtualInputDevice(input_descriptor->mDevice))) { return mInputs.keyAt(i); } } return 0; } audio_devices_t AudioPolicyManager::getDeviceForVolume(audio_devices_t device) { if (device == AUDIO_DEVICE_NONE) { // this happens when forcing a route update and no track is active on an output. // In this case the returned category is not important. device = AUDIO_DEVICE_OUT_SPEAKER; } else if (popcount(device) > 1) { // Multiple device selection is either: // - speaker + one other device: give priority to speaker in this case. // - one A2DP device + another device: happens with duplicated output. In this case // retain the device on the A2DP output as the other must not correspond to an active // selection if not the speaker. if (device & AUDIO_DEVICE_OUT_SPEAKER) { device = AUDIO_DEVICE_OUT_SPEAKER; } else { device = (audio_devices_t)(device & AUDIO_DEVICE_OUT_ALL_A2DP); } } ALOGW_IF(popcount(device) != 1, "getDeviceForVolume() invalid device combination: %08x", device); return device; } AudioPolicyManager::device_category AudioPolicyManager::getDeviceCategory(audio_devices_t device) { switch(getDeviceForVolume(device)) { case AUDIO_DEVICE_OUT_EARPIECE: return DEVICE_CATEGORY_EARPIECE; case AUDIO_DEVICE_OUT_WIRED_HEADSET: case AUDIO_DEVICE_OUT_WIRED_HEADPHONE: case AUDIO_DEVICE_OUT_BLUETOOTH_SCO: case AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET: case AUDIO_DEVICE_OUT_BLUETOOTH_A2DP: case AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES: return DEVICE_CATEGORY_HEADSET; case AUDIO_DEVICE_OUT_SPEAKER: case AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT: case AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER: case AUDIO_DEVICE_OUT_AUX_DIGITAL: case AUDIO_DEVICE_OUT_USB_ACCESSORY: case AUDIO_DEVICE_OUT_USB_DEVICE: case AUDIO_DEVICE_OUT_REMOTE_SUBMIX: default: return DEVICE_CATEGORY_SPEAKER; } } float AudioPolicyManager::volIndexToAmpl(audio_devices_t device, const StreamDescriptor& streamDesc, int indexInUi) { device_category deviceCategory = getDeviceCategory(device); const VolumeCurvePoint *curve = streamDesc.mVolumeCurve[deviceCategory]; // the volume index in the UI is relative to the min and max volume indices for this stream type int nbSteps = 1 + curve[VOLMAX].mIndex - curve[VOLMIN].mIndex; int volIdx = (nbSteps * (indexInUi - streamDesc.mIndexMin)) / (streamDesc.mIndexMax - streamDesc.mIndexMin); // find what part of the curve this index volume belongs to, or if it's out of bounds int segment = 0; if (volIdx < curve[VOLMIN].mIndex) { // out of bounds return 0.0f; } else if (volIdx < curve[VOLKNEE1].mIndex) { segment = 0; } else if (volIdx < curve[VOLKNEE2].mIndex) { segment = 1; } else if (volIdx <= curve[VOLMAX].mIndex) { segment = 2; } else { // out of bounds return 1.0f; } // linear interpolation in the attenuation table in dB float decibels = curve[segment].mDBAttenuation + ((float)(volIdx - curve[segment].mIndex)) * ( (curve[segment+1].mDBAttenuation - curve[segment].mDBAttenuation) / ((float)(curve[segment+1].mIndex - curve[segment].mIndex)) ); float amplification = exp( decibels * 0.115129f); // exp( dB * ln(10) / 20 ) ALOGVV("VOLUME vol index=[%d %d %d], dB=[%.1f %.1f %.1f] ampl=%.5f", curve[segment].mIndex, volIdx, curve[segment+1].mIndex, curve[segment].mDBAttenuation, decibels, curve[segment+1].mDBAttenuation, amplification); return amplification; } const AudioPolicyManager::VolumeCurvePoint AudioPolicyManager::sDefaultVolumeCurve[AudioPolicyManager::VOLCNT] = { {1, -49.5f}, {33, -33.5f}, {66, -17.0f}, {100, 0.0f} }; const AudioPolicyManager::VolumeCurvePoint AudioPolicyManager::sDefaultMediaVolumeCurve[AudioPolicyManager::VOLCNT] = { {1, -58.0f}, {20, -40.0f}, {60, -17.0f}, {100, 0.0f} }; const AudioPolicyManager::VolumeCurvePoint AudioPolicyManager::sSpeakerMediaVolumeCurve[AudioPolicyManager::VOLCNT] = { {1, -56.0f}, {20, -34.0f}, {60, -11.0f}, {100, 0.0f} }; const AudioPolicyManager::VolumeCurvePoint AudioPolicyManager::sSpeakerSonificationVolumeCurve[AudioPolicyManager::VOLCNT] = { {1, -29.7f}, {33, -20.1f}, {66, -10.2f}, {100, 0.0f} }; const AudioPolicyManager::VolumeCurvePoint AudioPolicyManager::sSpeakerSonificationVolumeCurveDrc[AudioPolicyManager::VOLCNT] = { {1, -35.7f}, {33, -26.1f}, {66, -13.2f}, {100, 0.0f} }; // AUDIO_STREAM_SYSTEM, AUDIO_STREAM_ENFORCED_AUDIBLE and AUDIO_STREAM_DTMF volume tracks // AUDIO_STREAM_RING on phones and AUDIO_STREAM_MUSIC on tablets. // AUDIO_STREAM_DTMF tracks AUDIO_STREAM_VOICE_CALL while in call (See AudioService.java). // The range is constrained between -24dB and -6dB over speaker and -30dB and -18dB over headset. const AudioPolicyManager::VolumeCurvePoint AudioPolicyManager::sDefaultSystemVolumeCurve[AudioPolicyManager::VOLCNT] = { {1, -24.0f}, {33, -18.0f}, {66, -12.0f}, {100, -6.0f} }; const AudioPolicyManager::VolumeCurvePoint AudioPolicyManager::sDefaultSystemVolumeCurveDrc[AudioPolicyManager::VOLCNT] = { {1, -34.0f}, {33, -24.0f}, {66, -15.0f}, {100, -6.0f} }; const AudioPolicyManager::VolumeCurvePoint AudioPolicyManager::sHeadsetSystemVolumeCurve[AudioPolicyManager::VOLCNT] = { {1, -30.0f}, {33, -26.0f}, {66, -22.0f}, {100, -18.0f} }; const AudioPolicyManager::VolumeCurvePoint AudioPolicyManager::sDefaultVoiceVolumeCurve[AudioPolicyManager::VOLCNT] = { {0, -42.0f}, {33, -28.0f}, {66, -14.0f}, {100, 0.0f} }; const AudioPolicyManager::VolumeCurvePoint AudioPolicyManager::sSpeakerVoiceVolumeCurve[AudioPolicyManager::VOLCNT] = { {0, -24.0f}, {33, -16.0f}, {66, -8.0f}, {100, 0.0f} }; const AudioPolicyManager::VolumeCurvePoint *AudioPolicyManager::sVolumeProfiles[AUDIO_STREAM_CNT] [AudioPolicyManager::DEVICE_CATEGORY_CNT] = { { // AUDIO_STREAM_VOICE_CALL sDefaultVoiceVolumeCurve, // DEVICE_CATEGORY_HEADSET sSpeakerVoiceVolumeCurve, // DEVICE_CATEGORY_SPEAKER sDefaultVoiceVolumeCurve // DEVICE_CATEGORY_EARPIECE }, { // AUDIO_STREAM_SYSTEM sHeadsetSystemVolumeCurve, // DEVICE_CATEGORY_HEADSET sDefaultSystemVolumeCurve, // DEVICE_CATEGORY_SPEAKER sDefaultSystemVolumeCurve // DEVICE_CATEGORY_EARPIECE }, { // AUDIO_STREAM_RING sDefaultVolumeCurve, // DEVICE_CATEGORY_HEADSET sSpeakerSonificationVolumeCurve, // DEVICE_CATEGORY_SPEAKER sDefaultVolumeCurve // DEVICE_CATEGORY_EARPIECE }, { // AUDIO_STREAM_MUSIC sDefaultMediaVolumeCurve, // DEVICE_CATEGORY_HEADSET sSpeakerMediaVolumeCurve, // DEVICE_CATEGORY_SPEAKER sDefaultMediaVolumeCurve // DEVICE_CATEGORY_EARPIECE }, { // AUDIO_STREAM_ALARM sDefaultVolumeCurve, // DEVICE_CATEGORY_HEADSET sSpeakerSonificationVolumeCurve, // DEVICE_CATEGORY_SPEAKER sDefaultVolumeCurve // DEVICE_CATEGORY_EARPIECE }, { // AUDIO_STREAM_NOTIFICATION sDefaultVolumeCurve, // DEVICE_CATEGORY_HEADSET sSpeakerSonificationVolumeCurve, // DEVICE_CATEGORY_SPEAKER sDefaultVolumeCurve // DEVICE_CATEGORY_EARPIECE }, { // AUDIO_STREAM_BLUETOOTH_SCO sDefaultVoiceVolumeCurve, // DEVICE_CATEGORY_HEADSET sSpeakerVoiceVolumeCurve, // DEVICE_CATEGORY_SPEAKER sDefaultVoiceVolumeCurve // DEVICE_CATEGORY_EARPIECE }, { // AUDIO_STREAM_ENFORCED_AUDIBLE sHeadsetSystemVolumeCurve, // DEVICE_CATEGORY_HEADSET sDefaultSystemVolumeCurve, // DEVICE_CATEGORY_SPEAKER sDefaultSystemVolumeCurve // DEVICE_CATEGORY_EARPIECE }, { // AUDIO_STREAM_DTMF sHeadsetSystemVolumeCurve, // DEVICE_CATEGORY_HEADSET sDefaultSystemVolumeCurve, // DEVICE_CATEGORY_SPEAKER sDefaultSystemVolumeCurve // DEVICE_CATEGORY_EARPIECE }, { // AUDIO_STREAM_TTS sDefaultMediaVolumeCurve, // DEVICE_CATEGORY_HEADSET sSpeakerMediaVolumeCurve, // DEVICE_CATEGORY_SPEAKER sDefaultMediaVolumeCurve // DEVICE_CATEGORY_EARPIECE }, }; void AudioPolicyManager::initializeVolumeCurves() { for (int i = 0; i < AUDIO_STREAM_CNT; i++) { for (int j = 0; j < DEVICE_CATEGORY_CNT; j++) { mStreams[i].mVolumeCurve[j] = sVolumeProfiles[i][j]; } } // Check availability of DRC on speaker path: if available, override some of the speaker curves if (mSpeakerDrcEnabled) { mStreams[AUDIO_STREAM_SYSTEM].mVolumeCurve[DEVICE_CATEGORY_SPEAKER] = sDefaultSystemVolumeCurveDrc; mStreams[AUDIO_STREAM_RING].mVolumeCurve[DEVICE_CATEGORY_SPEAKER] = sSpeakerSonificationVolumeCurveDrc; mStreams[AUDIO_STREAM_ALARM].mVolumeCurve[DEVICE_CATEGORY_SPEAKER] = sSpeakerSonificationVolumeCurveDrc; mStreams[AUDIO_STREAM_NOTIFICATION].mVolumeCurve[DEVICE_CATEGORY_SPEAKER] = sSpeakerSonificationVolumeCurveDrc; } } float AudioPolicyManager::computeVolume(audio_stream_type_t stream, int index, audio_io_handle_t output, audio_devices_t device) { float volume = 1.0; AudioOutputDescriptor *outputDesc = mOutputs.valueFor(output); StreamDescriptor &streamDesc = mStreams[stream]; if (device == AUDIO_DEVICE_NONE) { device = outputDesc->device(); } // if volume is not 0 (not muted), force media volume to max on digital output if (stream == AUDIO_STREAM_MUSIC && index != mStreams[stream].mIndexMin && (device == AUDIO_DEVICE_OUT_AUX_DIGITAL || device == AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET || device == AUDIO_DEVICE_OUT_USB_ACCESSORY || device == AUDIO_DEVICE_OUT_USB_DEVICE)) { return 1.0; } volume = volIndexToAmpl(device, streamDesc, index); // if a headset is connected, apply the following rules to ring tones and notifications // to avoid sound level bursts in user's ears: // - always attenuate ring tones and notifications volume by 6dB // - if music is playing, always limit the volume to current music volume, // with a minimum threshold at -36dB so that notification is always perceived. const routing_strategy stream_strategy = getStrategy(stream); if ((device & (AUDIO_DEVICE_OUT_BLUETOOTH_A2DP | AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | AUDIO_DEVICE_OUT_WIRED_HEADSET | AUDIO_DEVICE_OUT_WIRED_HEADPHONE)) && ((stream_strategy == STRATEGY_SONIFICATION) || (stream_strategy == STRATEGY_SONIFICATION_RESPECTFUL) || (stream == AUDIO_STREAM_SYSTEM) || ((stream_strategy == STRATEGY_ENFORCED_AUDIBLE) && (mForceUse[AUDIO_POLICY_FORCE_FOR_SYSTEM] == AUDIO_POLICY_FORCE_NONE))) && streamDesc.mCanBeMuted) { volume *= SONIFICATION_HEADSET_VOLUME_FACTOR; // when the phone is ringing we must consider that music could have been paused just before // by the music application and behave as if music was active if the last music track was // just stopped if (isStreamActive(AUDIO_STREAM_MUSIC, SONIFICATION_HEADSET_MUSIC_DELAY) || mLimitRingtoneVolume) { audio_devices_t musicDevice = getDeviceForStrategy(STRATEGY_MEDIA, true /*fromCache*/); float musicVol = computeVolume(AUDIO_STREAM_MUSIC, mStreams[AUDIO_STREAM_MUSIC].getVolumeIndex(musicDevice), output, musicDevice); float minVol = (musicVol > SONIFICATION_HEADSET_VOLUME_MIN) ? musicVol : SONIFICATION_HEADSET_VOLUME_MIN; if (volume > minVol) { volume = minVol; ALOGV("computeVolume limiting volume to %f musicVol %f", minVol, musicVol); } } } return volume; } status_t AudioPolicyManager::checkAndSetVolume(audio_stream_type_t stream, int index, audio_io_handle_t output, audio_devices_t device, int delayMs, bool force) { // do not change actual stream volume if the stream is muted if (mOutputs.valueFor(output)->mMuteCount[stream] != 0) { ALOGVV("checkAndSetVolume() stream %d muted count %d", stream, mOutputs.valueFor(output)->mMuteCount[stream]); return NO_ERROR; } // do not change in call volume if bluetooth is connected and vice versa if ((stream == AUDIO_STREAM_VOICE_CALL && mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION] == AUDIO_POLICY_FORCE_BT_SCO) || (stream == AUDIO_STREAM_BLUETOOTH_SCO && mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION] != AUDIO_POLICY_FORCE_BT_SCO)) { ALOGV("checkAndSetVolume() cannot set stream %d volume with force use = %d for comm", stream, mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION]); return INVALID_OPERATION; } float volume = computeVolume(stream, index, output, device); // We actually change the volume if: // - the float value returned by computeVolume() changed // - the force flag is set if (volume != mOutputs.valueFor(output)->mCurVolume[stream] || force) { mOutputs.valueFor(output)->mCurVolume[stream] = volume; ALOGVV("checkAndSetVolume() for output %d stream %d, volume %f, delay %d", output, stream, volume, delayMs); // Force VOICE_CALL to track BLUETOOTH_SCO stream volume when bluetooth audio is // enabled if (stream == AUDIO_STREAM_BLUETOOTH_SCO) { mpClientInterface->setStreamVolume(AUDIO_STREAM_VOICE_CALL, volume, output, delayMs); } mpClientInterface->setStreamVolume(stream, volume, output, delayMs); } if (stream == AUDIO_STREAM_VOICE_CALL || stream == AUDIO_STREAM_BLUETOOTH_SCO) { float voiceVolume; // Force voice volume to max for bluetooth SCO as volume is managed by the headset if (stream == AUDIO_STREAM_VOICE_CALL) { voiceVolume = (float)index/(float)mStreams[stream].mIndexMax; } else { voiceVolume = 1.0; } if (voiceVolume != mLastVoiceVolume && output == mPrimaryOutput) { mpClientInterface->setVoiceVolume(voiceVolume, delayMs); mLastVoiceVolume = voiceVolume; } } return NO_ERROR; } void AudioPolicyManager::applyStreamVolumes(audio_io_handle_t output, audio_devices_t device, int delayMs, bool force) { ALOGVV("applyStreamVolumes() for output %d and device %x", output, device); for (int stream = 0; stream < AUDIO_STREAM_CNT; stream++) { checkAndSetVolume((audio_stream_type_t)stream, mStreams[stream].getVolumeIndex(device), output, device, delayMs, force); } } void AudioPolicyManager::setStrategyMute(routing_strategy strategy, bool on, audio_io_handle_t output, int delayMs, audio_devices_t device) { ALOGVV("setStrategyMute() strategy %d, mute %d, output %d", strategy, on, output); for (int stream = 0; stream < AUDIO_STREAM_CNT; stream++) { if (getStrategy((audio_stream_type_t)stream) == strategy) { setStreamMute((audio_stream_type_t)stream, on, output, delayMs, device); } } } void AudioPolicyManager::setStreamMute(audio_stream_type_t stream, bool on, audio_io_handle_t output, int delayMs, audio_devices_t device) { StreamDescriptor &streamDesc = mStreams[stream]; AudioOutputDescriptor *outputDesc = mOutputs.valueFor(output); if (device == AUDIO_DEVICE_NONE) { device = outputDesc->device(); } ALOGVV("setStreamMute() stream %d, mute %d, output %d, mMuteCount %d device %04x", stream, on, output, outputDesc->mMuteCount[stream], device); if (on) { if (outputDesc->mMuteCount[stream] == 0) { if (streamDesc.mCanBeMuted && ((stream != AUDIO_STREAM_ENFORCED_AUDIBLE) || (mForceUse[AUDIO_POLICY_FORCE_FOR_SYSTEM] == AUDIO_POLICY_FORCE_NONE))) { checkAndSetVolume(stream, 0, output, device, delayMs); } } // increment mMuteCount after calling checkAndSetVolume() so that volume change is not ignored outputDesc->mMuteCount[stream]++; } else { if (outputDesc->mMuteCount[stream] == 0) { ALOGV("setStreamMute() unmuting non muted stream!"); return; } if (--outputDesc->mMuteCount[stream] == 0) { checkAndSetVolume(stream, streamDesc.getVolumeIndex(device), output, device, delayMs); } } } void AudioPolicyManager::handleIncallSonification(audio_stream_type_t stream, bool starting, bool stateChange) { // if the stream pertains to sonification strategy and we are in call we must // mute the stream if it is low visibility. If it is high visibility, we must play a tone // in the device used for phone strategy and play the tone if the selected device does not // interfere with the device used for phone strategy // if stateChange is true, we are called from setPhoneState() and we must mute or unmute as // many times as there are active tracks on the output const routing_strategy stream_strategy = getStrategy(stream); if ((stream_strategy == STRATEGY_SONIFICATION) || ((stream_strategy == STRATEGY_SONIFICATION_RESPECTFUL))) { AudioOutputDescriptor *outputDesc = mOutputs.valueFor(mPrimaryOutput); ALOGV("handleIncallSonification() stream %d starting %d device %x stateChange %d", stream, starting, outputDesc->mDevice, stateChange); if (outputDesc->mRefCount[stream]) { int muteCount = 1; if (stateChange) { muteCount = outputDesc->mRefCount[stream]; } if (audio_is_low_visibility(stream)) { ALOGV("handleIncallSonification() low visibility, muteCount %d", muteCount); for (int i = 0; i < muteCount; i++) { setStreamMute(stream, starting, mPrimaryOutput); } } else { ALOGV("handleIncallSonification() high visibility"); if (outputDesc->device() & getDeviceForStrategy(STRATEGY_PHONE, true /*fromCache*/)) { ALOGV("handleIncallSonification() high visibility muted, muteCount %d", muteCount); for (int i = 0; i < muteCount; i++) { setStreamMute(stream, starting, mPrimaryOutput); } } if (starting) { mpClientInterface->startTone(AUDIO_POLICY_TONE_IN_CALL_NOTIFICATION, AUDIO_STREAM_VOICE_CALL); } else { mpClientInterface->stopTone(); } } } } } bool AudioPolicyManager::isInCall() { return isStateInCall(mPhoneState); } bool AudioPolicyManager::isStateInCall(int state) { return ((state == AUDIO_MODE_IN_CALL) || (state == AUDIO_MODE_IN_COMMUNICATION)); } uint32_t AudioPolicyManager::getMaxEffectsCpuLoad() { return MAX_EFFECTS_CPU_LOAD; } uint32_t AudioPolicyManager::getMaxEffectsMemory() { return MAX_EFFECTS_MEMORY; } // --- AudioOutputDescriptor class implementation AudioPolicyManager::AudioOutputDescriptor::AudioOutputDescriptor( const IOProfile *profile) : mId(0), mSamplingRate(0), mFormat(AUDIO_FORMAT_DEFAULT), mChannelMask(0), mLatency(0), mFlags((audio_output_flags_t)0), mDevice(AUDIO_DEVICE_NONE), mOutput1(0), mOutput2(0), mProfile(profile), mDirectOpenCount(0) { // clear usage count for all stream types for (int i = 0; i < AUDIO_STREAM_CNT; i++) { mRefCount[i] = 0; mCurVolume[i] = -1.0; mMuteCount[i] = 0; mStopTime[i] = 0; } for (int i = 0; i < NUM_STRATEGIES; i++) { mStrategyMutedByDevice[i] = false; } if (profile != NULL) { mSamplingRate = profile->mSamplingRates[0]; mFormat = profile->mFormats[0]; mChannelMask = profile->mChannelMasks[0]; mFlags = profile->mFlags; } } audio_devices_t AudioPolicyManager::AudioOutputDescriptor::device() const { if (isDuplicated()) { return (audio_devices_t)(mOutput1->mDevice | mOutput2->mDevice); } else { return mDevice; } } uint32_t AudioPolicyManager::AudioOutputDescriptor::latency() { if (isDuplicated()) { return (mOutput1->mLatency > mOutput2->mLatency) ? mOutput1->mLatency : mOutput2->mLatency; } else { return mLatency; } } bool AudioPolicyManager::AudioOutputDescriptor::sharesHwModuleWith( const AudioOutputDescriptor *outputDesc) { if (isDuplicated()) { return mOutput1->sharesHwModuleWith(outputDesc) || mOutput2->sharesHwModuleWith(outputDesc); } else if (outputDesc->isDuplicated()){ return sharesHwModuleWith(outputDesc->mOutput1) || sharesHwModuleWith(outputDesc->mOutput2); } else { return (mProfile->mModule == outputDesc->mProfile->mModule); } } void AudioPolicyManager::AudioOutputDescriptor::changeRefCount(audio_stream_type_t stream, int delta) { // forward usage count change to attached outputs if (isDuplicated()) { mOutput1->changeRefCount(stream, delta); mOutput2->changeRefCount(stream, delta); } if ((delta + (int)mRefCount[stream]) < 0) { ALOGW("changeRefCount() invalid delta %d for stream %d, refCount %d", delta, stream, mRefCount[stream]); mRefCount[stream] = 0; return; } mRefCount[stream] += delta; ALOGV("changeRefCount() stream %d, count %d", stream, mRefCount[stream]); } audio_devices_t AudioPolicyManager::AudioOutputDescriptor::supportedDevices() { if (isDuplicated()) { return (audio_devices_t)(mOutput1->supportedDevices() | mOutput2->supportedDevices()); } else { return mProfile->mSupportedDevices.types() ; } } bool AudioPolicyManager::AudioOutputDescriptor::isActive(uint32_t inPastMs) const { return isStrategyActive(NUM_STRATEGIES, inPastMs); } bool AudioPolicyManager::AudioOutputDescriptor::isStrategyActive(routing_strategy strategy, uint32_t inPastMs, nsecs_t sysTime) const { if ((sysTime == 0) && (inPastMs != 0)) { sysTime = systemTime(); } for (int i = 0; i < (int)AUDIO_STREAM_CNT; i++) { if (((getStrategy((audio_stream_type_t)i) == strategy) || (NUM_STRATEGIES == strategy)) && isStreamActive((audio_stream_type_t)i, inPastMs, sysTime)) { return true; } } return false; } bool AudioPolicyManager::AudioOutputDescriptor::isStreamActive(audio_stream_type_t stream, uint32_t inPastMs, nsecs_t sysTime) const { if (mRefCount[stream] != 0) { return true; } if (inPastMs == 0) { return false; } if (sysTime == 0) { sysTime = systemTime(); } if (ns2ms(sysTime - mStopTime[stream]) < inPastMs) { return true; } return false; } status_t AudioPolicyManager::AudioOutputDescriptor::dump(int fd) { const size_t SIZE = 256; char buffer[SIZE]; String8 result; snprintf(buffer, SIZE, " Sampling rate: %d\n", mSamplingRate); result.append(buffer); snprintf(buffer, SIZE, " Format: %08x\n", mFormat); result.append(buffer); snprintf(buffer, SIZE, " Channels: %08x\n", mChannelMask); result.append(buffer); snprintf(buffer, SIZE, " Latency: %d\n", mLatency); result.append(buffer); snprintf(buffer, SIZE, " Flags %08x\n", mFlags); result.append(buffer); snprintf(buffer, SIZE, " Devices %08x\n", device()); result.append(buffer); snprintf(buffer, SIZE, " Stream volume refCount muteCount\n"); result.append(buffer); for (int i = 0; i < (int)AUDIO_STREAM_CNT; i++) { snprintf(buffer, SIZE, " %02d %.03f %02d %02d\n", i, mCurVolume[i], mRefCount[i], mMuteCount[i]); result.append(buffer); } write(fd, result.string(), result.size()); return NO_ERROR; } // --- AudioInputDescriptor class implementation AudioPolicyManager::AudioInputDescriptor::AudioInputDescriptor(const IOProfile *profile) : mId(0), mSamplingRate(0), mFormat(AUDIO_FORMAT_DEFAULT), mChannelMask(0), mDevice(AUDIO_DEVICE_NONE), mRefCount(0), mInputSource(AUDIO_SOURCE_DEFAULT), mProfile(profile) { if (profile != NULL) { mSamplingRate = profile->mSamplingRates[0]; mFormat = profile->mFormats[0]; mChannelMask = profile->mChannelMasks[0]; } } status_t AudioPolicyManager::AudioInputDescriptor::dump(int fd) { const size_t SIZE = 256; char buffer[SIZE]; String8 result; snprintf(buffer, SIZE, " Sampling rate: %d\n", mSamplingRate); result.append(buffer); snprintf(buffer, SIZE, " Format: %d\n", mFormat); result.append(buffer); snprintf(buffer, SIZE, " Channels: %08x\n", mChannelMask); result.append(buffer); snprintf(buffer, SIZE, " Devices %08x\n", mDevice); result.append(buffer); snprintf(buffer, SIZE, " Ref Count %d\n", mRefCount); result.append(buffer); write(fd, result.string(), result.size()); return NO_ERROR; } // --- StreamDescriptor class implementation AudioPolicyManager::StreamDescriptor::StreamDescriptor() : mIndexMin(0), mIndexMax(1), mCanBeMuted(true) { mIndexCur.add(AUDIO_DEVICE_OUT_DEFAULT, 0); } int AudioPolicyManager::StreamDescriptor::getVolumeIndex(audio_devices_t device) { device = AudioPolicyManager::getDeviceForVolume(device); // there is always a valid entry for AUDIO_DEVICE_OUT_DEFAULT if (mIndexCur.indexOfKey(device) < 0) { device = AUDIO_DEVICE_OUT_DEFAULT; } return mIndexCur.valueFor(device); } void AudioPolicyManager::StreamDescriptor::dump(int fd) { const size_t SIZE = 256; char buffer[SIZE]; String8 result; snprintf(buffer, SIZE, "%s %02d %02d ", mCanBeMuted ? "true " : "false", mIndexMin, mIndexMax); result.append(buffer); for (size_t i = 0; i < mIndexCur.size(); i++) { snprintf(buffer, SIZE, "%04x : %02d, ", mIndexCur.keyAt(i), mIndexCur.valueAt(i)); result.append(buffer); } result.append("\n"); write(fd, result.string(), result.size()); } // --- EffectDescriptor class implementation status_t AudioPolicyManager::EffectDescriptor::dump(int fd) { const size_t SIZE = 256; char buffer[SIZE]; String8 result; snprintf(buffer, SIZE, " I/O: %d\n", mIo); result.append(buffer); snprintf(buffer, SIZE, " Strategy: %d\n", mStrategy); result.append(buffer); snprintf(buffer, SIZE, " Session: %d\n", mSession); result.append(buffer); snprintf(buffer, SIZE, " Name: %s\n", mDesc.name); result.append(buffer); snprintf(buffer, SIZE, " %s\n", mEnabled ? "Enabled" : "Disabled"); result.append(buffer); write(fd, result.string(), result.size()); return NO_ERROR; } // --- IOProfile class implementation AudioPolicyManager::HwModule::HwModule(const char *name) : mName(strndup(name, AUDIO_HARDWARE_MODULE_ID_MAX_LEN)), mHandle(0) { } AudioPolicyManager::HwModule::~HwModule() { for (size_t i = 0; i < mOutputProfiles.size(); i++) { mOutputProfiles[i]->mSupportedDevices.clear(); delete mOutputProfiles[i]; } for (size_t i = 0; i < mInputProfiles.size(); i++) { mInputProfiles[i]->mSupportedDevices.clear(); delete mInputProfiles[i]; } free((void *)mName); } void AudioPolicyManager::HwModule::dump(int fd) { const size_t SIZE = 256; char buffer[SIZE]; String8 result; snprintf(buffer, SIZE, " - name: %s\n", mName); result.append(buffer); snprintf(buffer, SIZE, " - handle: %d\n", mHandle); result.append(buffer); write(fd, result.string(), result.size()); if (mOutputProfiles.size()) { write(fd, " - outputs:\n", strlen(" - outputs:\n")); for (size_t i = 0; i < mOutputProfiles.size(); i++) { snprintf(buffer, SIZE, " output %zu:\n", i); write(fd, buffer, strlen(buffer)); mOutputProfiles[i]->dump(fd); } } if (mInputProfiles.size()) { write(fd, " - inputs:\n", strlen(" - inputs:\n")); for (size_t i = 0; i < mInputProfiles.size(); i++) { snprintf(buffer, SIZE, " input %zu:\n", i); write(fd, buffer, strlen(buffer)); mInputProfiles[i]->dump(fd); } } } AudioPolicyManager::IOProfile::IOProfile(HwModule *module) : mFlags((audio_output_flags_t)0), mModule(module) { } AudioPolicyManager::IOProfile::~IOProfile() { } // checks if the IO profile is compatible with specified parameters. // Sampling rate, format and channel mask must be specified in order to // get a valid a match bool AudioPolicyManager::IOProfile::isCompatibleProfile(audio_devices_t device, uint32_t samplingRate, audio_format_t format, audio_channel_mask_t channelMask, audio_output_flags_t flags) const { if (samplingRate == 0 || !audio_is_valid_format(format) || channelMask == 0) { return false; } if ((mSupportedDevices.types() & device) != device) { return false; } if ((mFlags & flags) != flags) { return false; } size_t i; for (i = 0; i < mSamplingRates.size(); i++) { if (mSamplingRates[i] == samplingRate) { break; } } if (i == mSamplingRates.size()) { return false; } for (i = 0; i < mFormats.size(); i++) { if (mFormats[i] == format) { break; } } if (i == mFormats.size()) { return false; } for (i = 0; i < mChannelMasks.size(); i++) { if (mChannelMasks[i] == channelMask) { break; } } if (i == mChannelMasks.size()) { return false; } return true; } void AudioPolicyManager::IOProfile::dump(int fd) { const size_t SIZE = 256; char buffer[SIZE]; String8 result; snprintf(buffer, SIZE, " - sampling rates: "); result.append(buffer); for (size_t i = 0; i < mSamplingRates.size(); i++) { snprintf(buffer, SIZE, "%d", mSamplingRates[i]); result.append(buffer); result.append(i == (mSamplingRates.size() - 1) ? "\n" : ", "); } snprintf(buffer, SIZE, " - channel masks: "); result.append(buffer); for (size_t i = 0; i < mChannelMasks.size(); i++) { snprintf(buffer, SIZE, "0x%04x", mChannelMasks[i]); result.append(buffer); result.append(i == (mChannelMasks.size() - 1) ? "\n" : ", "); } snprintf(buffer, SIZE, " - formats: "); result.append(buffer); for (size_t i = 0; i < mFormats.size(); i++) { snprintf(buffer, SIZE, "0x%08x", mFormats[i]); result.append(buffer); result.append(i == (mFormats.size() - 1) ? "\n" : ", "); } snprintf(buffer, SIZE, " - devices:\n"); result.append(buffer); write(fd, result.string(), result.size()); DeviceDescriptor::dumpHeader(fd, 6); for (size_t i = 0; i < mSupportedDevices.size(); i++) { mSupportedDevices[i]->dump(fd, 6); } snprintf(buffer, SIZE, " - flags: 0x%04x\n", mFlags); result.append(buffer); write(fd, result.string(), result.size()); } void AudioPolicyManager::IOProfile::log() { const size_t SIZE = 256; char buffer[SIZE]; String8 result; ALOGV(" - sampling rates: "); for (size_t i = 0; i < mSamplingRates.size(); i++) { ALOGV(" %d", mSamplingRates[i]); } ALOGV(" - channel masks: "); for (size_t i = 0; i < mChannelMasks.size(); i++) { ALOGV(" 0x%04x", mChannelMasks[i]); } ALOGV(" - formats: "); for (size_t i = 0; i < mFormats.size(); i++) { ALOGV(" 0x%08x", mFormats[i]); } ALOGV(" - devices: 0x%04x\n", mSupportedDevices.types()); ALOGV(" - flags: 0x%04x\n", mFlags); } // --- DeviceDescriptor implementation bool AudioPolicyManager::DeviceDescriptor::equals(const sp& other) const { // Devices are considered equal if they: // - are of the same type (a device type cannot be AUDIO_DEVICE_NONE) // - have the same address or one device does not specify the address // - have the same channel mask or one device does not specify the channel mask return (mType == other->mType) && (mAddress == "" || other->mAddress == "" || mAddress == other->mAddress) && (mChannelMask == 0 || other->mChannelMask == 0 || mChannelMask == other->mChannelMask); } void AudioPolicyManager::DeviceVector::refreshTypes() { mTypes = AUDIO_DEVICE_NONE; for(size_t i = 0; i < size(); i++) { mTypes |= itemAt(i)->mType; } ALOGV("DeviceVector::refreshTypes() mTypes %08x", mTypes); } ssize_t AudioPolicyManager::DeviceVector::indexOf(const sp& item) const { for(size_t i = 0; i < size(); i++) { if (item->equals(itemAt(i))) { return i; } } return -1; } ssize_t AudioPolicyManager::DeviceVector::add(const sp& item) { ssize_t ret = indexOf(item); if (ret < 0) { ret = SortedVector::add(item); if (ret >= 0) { refreshTypes(); } } else { ALOGW("DeviceVector::add device %08x already in", item->mType); ret = -1; } return ret; } ssize_t AudioPolicyManager::DeviceVector::remove(const sp& item) { size_t i; ssize_t ret = indexOf(item); if (ret < 0) { ALOGW("DeviceVector::remove device %08x not in", item->mType); } else { ret = SortedVector::removeAt(ret); if (ret >= 0) { refreshTypes(); } } return ret; } void AudioPolicyManager::DeviceVector::loadDevicesFromType(audio_devices_t types) { DeviceVector deviceList; uint32_t role_bit = AUDIO_DEVICE_BIT_IN & types; types &= ~role_bit; while (types) { uint32_t i = 31 - __builtin_clz(types); uint32_t type = 1 << i; types &= ~type; add(new DeviceDescriptor(type | role_bit)); } } void AudioPolicyManager::DeviceDescriptor::dumpHeader(int fd, int spaces) { const size_t SIZE = 256; char buffer[SIZE]; snprintf(buffer, SIZE, "%*s%-48s %-2s %-8s %-32s \n", spaces, "", "Type", "ID", "Cnl Mask", "Address"); write(fd, buffer, strlen(buffer)); } status_t AudioPolicyManager::DeviceDescriptor::dump(int fd, int spaces) const { const size_t SIZE = 256; char buffer[SIZE]; snprintf(buffer, SIZE, "%*s%-48s %2d %08x %-32s \n", spaces, "", enumToString(sDeviceNameToEnumTable, ARRAY_SIZE(sDeviceNameToEnumTable), mType), mId, mChannelMask, mAddress.string()); write(fd, buffer, strlen(buffer)); return NO_ERROR; } // --- audio_policy.conf file parsing audio_output_flags_t AudioPolicyManager::parseFlagNames(char *name) { uint32_t flag = 0; // it is OK to cast name to non const here as we are not going to use it after // strtok() modifies it char *flagName = strtok(name, "|"); while (flagName != NULL) { if (strlen(flagName) != 0) { flag |= stringToEnum(sFlagNameToEnumTable, ARRAY_SIZE(sFlagNameToEnumTable), flagName); } flagName = strtok(NULL, "|"); } //force direct flag if offload flag is set: offloading implies a direct output stream // and all common behaviors are driven by checking only the direct flag // this should normally be set appropriately in the policy configuration file if ((flag & AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD) != 0) { flag |= AUDIO_OUTPUT_FLAG_DIRECT; } return (audio_output_flags_t)flag; } audio_devices_t AudioPolicyManager::parseDeviceNames(char *name) { uint32_t device = 0; char *devName = strtok(name, "|"); while (devName != NULL) { if (strlen(devName) != 0) { device |= stringToEnum(sDeviceNameToEnumTable, ARRAY_SIZE(sDeviceNameToEnumTable), devName); } devName = strtok(NULL, "|"); } return device; } void AudioPolicyManager::loadSamplingRates(char *name, IOProfile *profile) { char *str = strtok(name, "|"); // by convention, "0' in the first entry in mSamplingRates indicates the supported sampling // rates should be read from the output stream after it is opened for the first time if (str != NULL && strcmp(str, DYNAMIC_VALUE_TAG) == 0) { profile->mSamplingRates.add(0); return; } while (str != NULL) { uint32_t rate = atoi(str); if (rate != 0) { ALOGV("loadSamplingRates() adding rate %d", rate); profile->mSamplingRates.add(rate); } str = strtok(NULL, "|"); } return; } void AudioPolicyManager::loadFormats(char *name, IOProfile *profile) { char *str = strtok(name, "|"); // by convention, "0' in the first entry in mFormats indicates the supported formats // should be read from the output stream after it is opened for the first time if (str != NULL && strcmp(str, DYNAMIC_VALUE_TAG) == 0) { profile->mFormats.add(AUDIO_FORMAT_DEFAULT); return; } while (str != NULL) { audio_format_t format = (audio_format_t)stringToEnum(sFormatNameToEnumTable, ARRAY_SIZE(sFormatNameToEnumTable), str); if (format != AUDIO_FORMAT_DEFAULT) { profile->mFormats.add(format); } str = strtok(NULL, "|"); } return; } void AudioPolicyManager::loadInChannels(char *name, IOProfile *profile) { const char *str = strtok(name, "|"); ALOGV("loadInChannels() %s", name); if (str != NULL && strcmp(str, DYNAMIC_VALUE_TAG) == 0) { profile->mChannelMasks.add(0); return; } while (str != NULL) { audio_channel_mask_t channelMask = (audio_channel_mask_t)stringToEnum(sInChannelsNameToEnumTable, ARRAY_SIZE(sInChannelsNameToEnumTable), str); if (channelMask != 0) { ALOGV("loadInChannels() adding channelMask %04x", channelMask); profile->mChannelMasks.add(channelMask); } str = strtok(NULL, "|"); } return; } void AudioPolicyManager::loadOutChannels(char *name, IOProfile *profile) { const char *str = strtok(name, "|"); ALOGV("loadOutChannels() %s", name); // by convention, "0' in the first entry in mChannelMasks indicates the supported channel // masks should be read from the output stream after it is opened for the first time if (str != NULL && strcmp(str, DYNAMIC_VALUE_TAG) == 0) { profile->mChannelMasks.add(0); return; } while (str != NULL) { audio_channel_mask_t channelMask = (audio_channel_mask_t)stringToEnum(sOutChannelsNameToEnumTable, ARRAY_SIZE(sOutChannelsNameToEnumTable), str); if (channelMask != 0) { profile->mChannelMasks.add(channelMask); } str = strtok(NULL, "|"); } return; } status_t AudioPolicyManager::loadInput(cnode *root, HwModule *module) { cnode *node = root->first_child; IOProfile *profile = new IOProfile(module); while (node) { if (strcmp(node->name, SAMPLING_RATES_TAG) == 0) { loadSamplingRates((char *)node->value, profile); } else if (strcmp(node->name, FORMATS_TAG) == 0) { loadFormats((char *)node->value, profile); } else if (strcmp(node->name, CHANNELS_TAG) == 0) { loadInChannels((char *)node->value, profile); } else if (strcmp(node->name, DEVICES_TAG) == 0) { profile->mSupportedDevices.loadDevicesFromType(parseDeviceNames((char *)node->value)); } node = node->next; } ALOGW_IF(profile->mSupportedDevices.isEmpty(), "loadInput() invalid supported devices"); ALOGW_IF(profile->mChannelMasks.size() == 0, "loadInput() invalid supported channel masks"); ALOGW_IF(profile->mSamplingRates.size() == 0, "loadInput() invalid supported sampling rates"); ALOGW_IF(profile->mFormats.size() == 0, "loadInput() invalid supported formats"); if (!profile->mSupportedDevices.isEmpty() && (profile->mChannelMasks.size() != 0) && (profile->mSamplingRates.size() != 0) && (profile->mFormats.size() != 0)) { ALOGV("loadInput() adding input Supported Devices %04x", profile->mSupportedDevices.types()); module->mInputProfiles.add(profile); return NO_ERROR; } else { delete profile; return BAD_VALUE; } } status_t AudioPolicyManager::loadOutput(cnode *root, HwModule *module) { cnode *node = root->first_child; IOProfile *profile = new IOProfile(module); while (node) { if (strcmp(node->name, SAMPLING_RATES_TAG) == 0) { loadSamplingRates((char *)node->value, profile); } else if (strcmp(node->name, FORMATS_TAG) == 0) { loadFormats((char *)node->value, profile); } else if (strcmp(node->name, CHANNELS_TAG) == 0) { loadOutChannels((char *)node->value, profile); } else if (strcmp(node->name, DEVICES_TAG) == 0) { profile->mSupportedDevices.loadDevicesFromType(parseDeviceNames((char *)node->value)); } else if (strcmp(node->name, FLAGS_TAG) == 0) { profile->mFlags = parseFlagNames((char *)node->value); } node = node->next; } ALOGW_IF(profile->mSupportedDevices.isEmpty(), "loadOutput() invalid supported devices"); ALOGW_IF(profile->mChannelMasks.size() == 0, "loadOutput() invalid supported channel masks"); ALOGW_IF(profile->mSamplingRates.size() == 0, "loadOutput() invalid supported sampling rates"); ALOGW_IF(profile->mFormats.size() == 0, "loadOutput() invalid supported formats"); if (!profile->mSupportedDevices.isEmpty() && (profile->mChannelMasks.size() != 0) && (profile->mSamplingRates.size() != 0) && (profile->mFormats.size() != 0)) { ALOGV("loadOutput() adding output Supported Devices %04x, mFlags %04x", profile->mSupportedDevices.types(), profile->mFlags); module->mOutputProfiles.add(profile); return NO_ERROR; } else { delete profile; return BAD_VALUE; } } void AudioPolicyManager::loadHwModule(cnode *root) { cnode *node = config_find(root, OUTPUTS_TAG); status_t status = NAME_NOT_FOUND; HwModule *module = new HwModule(root->name); if (node != NULL) { node = node->first_child; while (node) { ALOGV("loadHwModule() loading output %s", node->name); status_t tmpStatus = loadOutput(node, module); if (status == NAME_NOT_FOUND || status == NO_ERROR) { status = tmpStatus; } node = node->next; } } node = config_find(root, INPUTS_TAG); if (node != NULL) { node = node->first_child; while (node) { ALOGV("loadHwModule() loading input %s", node->name); status_t tmpStatus = loadInput(node, module); if (status == NAME_NOT_FOUND || status == NO_ERROR) { status = tmpStatus; } node = node->next; } } if (status == NO_ERROR) { mHwModules.add(module); } else { delete module; } } void AudioPolicyManager::loadHwModules(cnode *root) { cnode *node = config_find(root, AUDIO_HW_MODULE_TAG); if (node == NULL) { return; } node = node->first_child; while (node) { ALOGV("loadHwModules() loading module %s", node->name); loadHwModule(node); node = node->next; } } void AudioPolicyManager::loadGlobalConfig(cnode *root) { cnode *node = config_find(root, GLOBAL_CONFIG_TAG); if (node == NULL) { return; } node = node->first_child; while (node) { if (strcmp(ATTACHED_OUTPUT_DEVICES_TAG, node->name) == 0) { mAvailableOutputDevices.loadDevicesFromType(parseDeviceNames((char *)node->value)); ALOGV("loadGlobalConfig() Attached Output Devices %08x", mAvailableOutputDevices.types()); } else if (strcmp(DEFAULT_OUTPUT_DEVICE_TAG, node->name) == 0) { audio_devices_t device = (audio_devices_t)stringToEnum(sDeviceNameToEnumTable, ARRAY_SIZE(sDeviceNameToEnumTable), (char *)node->value); if (device != AUDIO_DEVICE_NONE) { mDefaultOutputDevice = new DeviceDescriptor(device); } else { ALOGW("loadGlobalConfig() default device not specified"); } ALOGV("loadGlobalConfig() mDefaultOutputDevice %08x", mDefaultOutputDevice->mType); } else if (strcmp(ATTACHED_INPUT_DEVICES_TAG, node->name) == 0) { mAvailableInputDevices.loadDevicesFromType(parseDeviceNames((char *)node->value)); ALOGV("loadGlobalConfig() Available InputDevices %08x", mAvailableInputDevices.types()); } else if (strcmp(SPEAKER_DRC_ENABLED_TAG, node->name) == 0) { mSpeakerDrcEnabled = stringToBool((char *)node->value); ALOGV("loadGlobalConfig() mSpeakerDrcEnabled = %d", mSpeakerDrcEnabled); } node = node->next; } } status_t AudioPolicyManager::loadAudioPolicyConfig(const char *path) { cnode *root; char *data; data = (char *)load_file(path, NULL); if (data == NULL) { return -ENODEV; } root = config_node("", ""); config_load(root, data); loadGlobalConfig(root); loadHwModules(root); config_free(root); free(root); free(data); ALOGI("loadAudioPolicyConfig() loaded %s\n", path); return NO_ERROR; } void AudioPolicyManager::defaultAudioPolicyConfig(void) { HwModule *module; IOProfile *profile; sp defaultInputDevice = new DeviceDescriptor(AUDIO_DEVICE_IN_BUILTIN_MIC); mAvailableOutputDevices.add(mDefaultOutputDevice); mAvailableInputDevices.add(defaultInputDevice); module = new HwModule("primary"); profile = new IOProfile(module); profile->mSamplingRates.add(44100); profile->mFormats.add(AUDIO_FORMAT_PCM_16_BIT); profile->mChannelMasks.add(AUDIO_CHANNEL_OUT_STEREO); profile->mSupportedDevices.add(mDefaultOutputDevice); profile->mFlags = AUDIO_OUTPUT_FLAG_PRIMARY; module->mOutputProfiles.add(profile); profile = new IOProfile(module); profile->mSamplingRates.add(8000); profile->mFormats.add(AUDIO_FORMAT_PCM_16_BIT); profile->mChannelMasks.add(AUDIO_CHANNEL_IN_MONO); profile->mSupportedDevices.add(defaultInputDevice); module->mInputProfiles.add(profile); mHwModules.add(module); } }; // namespace android