1/* 2 * Copyright (C) 2015 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17#pragma once 18 19#include <system/audio.h> 20 21static const audio_format_t gDynamicFormat = AUDIO_FORMAT_DEFAULT; 22 23// For mixed output and inputs, the policy will use max mixer sampling rates. 24// Do not limit sampling rate otherwise 25#define SAMPLE_RATE_HZ_MAX 192000 26 27// Used when a client opens a capture stream, without specifying a desired sample rate. 28#define SAMPLE_RATE_HZ_DEFAULT 48000 29 30// For mixed output and inputs, the policy will use max mixer channel count. 31// Do not limit channel count otherwise 32#define MAX_MIXER_CHANNEL_COUNT FCC_8 33 34/** 35 * A device mask for all audio input devices that are considered "virtual" when evaluating 36 * active inputs in getActiveInput() 37 */ 38#define APM_AUDIO_IN_DEVICE_VIRTUAL_ALL (AUDIO_DEVICE_IN_REMOTE_SUBMIX|AUDIO_DEVICE_IN_FM_TUNER) 39 40 41/** 42 * A device mask for all audio input and output devices where matching inputs/outputs on device 43 * type alone is not enough: the address must match too 44 */ 45#define APM_AUDIO_DEVICE_OUT_MATCH_ADDRESS_ALL (AUDIO_DEVICE_OUT_REMOTE_SUBMIX|AUDIO_DEVICE_OUT_BUS) 46 47#define APM_AUDIO_DEVICE_IN_MATCH_ADDRESS_ALL (AUDIO_DEVICE_IN_REMOTE_SUBMIX|AUDIO_DEVICE_IN_BUS) 48 49/** 50 * Stub audio output device. Used in policy configuration file on platforms without audio outputs. 51 * This alias value to AUDIO_DEVICE_OUT_DEFAULT is only used in the audio policy context. 52 */ 53#define AUDIO_DEVICE_OUT_STUB AUDIO_DEVICE_OUT_DEFAULT 54/** 55 * Stub audio input device. Used in policy configuration file on platforms without audio inputs. 56 * This alias value to AUDIO_DEVICE_IN_DEFAULT is only used in the audio policy context. 57 */ 58#define AUDIO_DEVICE_IN_STUB AUDIO_DEVICE_IN_DEFAULT 59/** 60 * Alias to AUDIO_DEVICE_OUT_DEFAULT defined for clarification when this value is used by volume 61 * control APIs (e.g setStreamVolumeIndex(). 62 */ 63#define AUDIO_DEVICE_OUT_DEFAULT_FOR_VOLUME AUDIO_DEVICE_OUT_DEFAULT 64 65 66/** 67 * Check if the state given correspond to an in call state. 68 * @TODO find a better name for widely call state 69 * 70 * @param[in] state to consider 71 * 72 * @return true if given state represents a device in a telephony or VoIP call 73 */ 74static inline bool is_state_in_call(int state) 75{ 76 return (state == AUDIO_MODE_IN_CALL) || (state == AUDIO_MODE_IN_COMMUNICATION); 77} 78 79/** 80 * Check if the input device given is considered as a virtual device. 81 * 82 * @param[in] device to consider 83 * 84 * @return true if the device is a virtual one, false otherwise. 85 */ 86static inline bool is_virtual_input_device(audio_devices_t device) 87{ 88 if ((device & AUDIO_DEVICE_BIT_IN) != 0) { 89 device &= ~AUDIO_DEVICE_BIT_IN; 90 if ((popcount(device) == 1) && ((device & ~APM_AUDIO_IN_DEVICE_VIRTUAL_ALL) == 0)) 91 return true; 92 } 93 return false; 94} 95 96/** 97 * Check whether the device type is one 98 * where addresses are used to distinguish between one connected device and another 99 * 100 * @param[in] device to consider 101 * 102 * @return true if the device needs distinguish on address, false otherwise.. 103 */ 104static inline bool device_distinguishes_on_address(audio_devices_t device) 105{ 106 return (((device & AUDIO_DEVICE_BIT_IN) != 0) && 107 ((~AUDIO_DEVICE_BIT_IN & device & APM_AUDIO_DEVICE_IN_MATCH_ADDRESS_ALL) != 0)) || 108 (((device & AUDIO_DEVICE_BIT_IN) == 0) && 109 ((device & APM_AUDIO_DEVICE_OUT_MATCH_ADDRESS_ALL) != 0)); 110} 111 112/* Indicates if audio formats are equivalent when considering a match between 113 * audio HAL supported formats and client requested formats 114 */ 115static inline bool audio_formats_match(audio_format_t format1, 116 audio_format_t format2) 117{ 118 if (audio_is_linear_pcm(format1) && 119 (audio_bytes_per_sample(format1) > 2) && 120 audio_is_linear_pcm(format2) && 121 (audio_bytes_per_sample(format2) > 2)) { 122 return true; 123 } 124 return format1 == format2; 125} 126