audio_hw.h revision 71c84b70ff7c428e35ac187ca4a234acac558240
1/* 2 * Copyright (C) 2013 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#include <hardware/audio.h> 18 19#include <tinyalsa/asoundlib.h> 20 21#include <audio_route/audio_route.h> 22 23#define ACDB_DEV_TYPE_OUT 1 24#define ACDB_DEV_TYPE_IN 2 25 26#define DUALMIC_CONFIG_NONE 0 /* Target does not contain 2 mics */ 27#define DUALMIC_CONFIG_ENDFIRE 1 28#define DUALMIC_CONFIG_BROADSIDE 2 29 30/* 31 * Below are the devices for which is back end is same, SLIMBUS_0_RX. 32 * All these devices are handled by the internal HW codec. We can 33 * enable any one of these devices at any time 34 */ 35#define AUDIO_DEVICE_OUT_ALL_CODEC_BACKEND \ 36 (AUDIO_DEVICE_OUT_EARPIECE | AUDIO_DEVICE_OUT_SPEAKER | \ 37 AUDIO_DEVICE_OUT_WIRED_HEADSET | AUDIO_DEVICE_OUT_WIRED_HEADPHONE) 38 39/* Sound devices specific to the platform 40 * The DEVICE_OUT_* and DEVICE_IN_* should be mapped to these sound 41 * devices to enable corresponding mixer paths 42 */ 43typedef enum { 44 SND_DEVICE_NONE = 0, 45 46 /* Playback devices */ 47 SND_DEVICE_MIN, 48 SND_DEVICE_OUT_BEGIN = SND_DEVICE_MIN, 49 SND_DEVICE_OUT_HANDSET = SND_DEVICE_OUT_BEGIN, 50 SND_DEVICE_OUT_SPEAKER, 51 SND_DEVICE_OUT_HEADPHONES, 52 SND_DEVICE_OUT_SPEAKER_AND_HEADPHONES, 53 SND_DEVICE_OUT_VOICE_SPEAKER, 54 SND_DEVICE_OUT_VOICE_HEADPHONES, 55 SND_DEVICE_OUT_HDMI, 56 SND_DEVICE_OUT_SPEAKER_AND_HDMI, 57 SND_DEVICE_OUT_BT_SCO, 58 SND_DEVICE_OUT_VOICE_HANDSET_TMUS, 59 SND_DEVICE_OUT_VOICE_TTY_FULL_HEADPHONES, 60 SND_DEVICE_OUT_VOICE_TTY_VCO_HEADPHONES, 61 SND_DEVICE_OUT_VOICE_TTY_HCO_HANDSET, 62 SND_DEVICE_OUT_END, 63 64 /* 65 * Note: IN_BEGIN should be same as OUT_END because total number of devices 66 * SND_DEVICES_MAX should not exceed MAX_RX + MAX_TX devices. 67 */ 68 /* Capture devices */ 69 SND_DEVICE_IN_BEGIN = SND_DEVICE_OUT_END, 70 SND_DEVICE_IN_HANDSET_MIC = SND_DEVICE_IN_BEGIN, 71 SND_DEVICE_IN_SPEAKER_MIC, 72 SND_DEVICE_IN_HEADSET_MIC, 73 SND_DEVICE_IN_VOICE_SPEAKER_MIC, 74 SND_DEVICE_IN_VOICE_HEADSET_MIC, 75 SND_DEVICE_IN_HDMI_MIC, 76 SND_DEVICE_IN_BT_SCO_MIC, 77 SND_DEVICE_IN_CAMCORDER_MIC, 78 SND_DEVICE_IN_VOICE_DMIC_EF, 79 SND_DEVICE_IN_VOICE_DMIC_BS, 80 SND_DEVICE_IN_VOICE_DMIC_EF_TMUS, 81 SND_DEVICE_IN_VOICE_SPEAKER_DMIC_EF, 82 SND_DEVICE_IN_VOICE_SPEAKER_DMIC_BS, 83 SND_DEVICE_IN_VOICE_TTY_FULL_HEADSET_MIC, 84 SND_DEVICE_IN_VOICE_TTY_VCO_HANDSET_MIC, 85 SND_DEVICE_IN_VOICE_TTY_HCO_HEADSET_MIC, 86 SND_DEVICE_IN_VOICE_REC_MIC, 87 SND_DEVICE_IN_VOICE_REC_DMIC_EF, 88 SND_DEVICE_IN_VOICE_REC_DMIC_BS, 89 SND_DEVICE_IN_VOICE_REC_DMIC_EF_FLUENCE, 90 SND_DEVICE_IN_VOICE_REC_DMIC_BS_FLUENCE, 91 SND_DEVICE_IN_END, 92 93 SND_DEVICE_MAX = SND_DEVICE_IN_END, 94 95} snd_device_t; 96 97 98/* These are the supported use cases by the hardware. 99 * Each usecase is mapped to a specific PCM device. 100 * Refer to pcm_device_table[]. 101 */ 102typedef enum { 103 USECASE_INVALID = -1, 104 /* Playback usecases */ 105 USECASE_AUDIO_PLAYBACK_DEEP_BUFFER = 0, 106 USECASE_AUDIO_PLAYBACK_LOW_LATENCY, 107 USECASE_AUDIO_PLAYBACK_MULTI_CH, 108 109 /* Capture usecases */ 110 USECASE_AUDIO_RECORD, 111 USECASE_AUDIO_RECORD_LOW_LATENCY, 112 113 USECASE_VOICE_CALL, 114 115 AUDIO_USECASE_MAX 116} audio_usecase_t; 117 118#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0])) 119 120#define SOUND_CARD 0 121 122#define DEFAULT_OUTPUT_SAMPLING_RATE 48000 123 124/* 125 * tinyAlsa library interprets period size as number of frames 126 * one frame = channel_count * sizeof (pcm sample) 127 * so if format = 16-bit PCM and channels = Stereo, frame size = 2 ch * 2 = 4 bytes 128 * DEEP_BUFFER_OUTPUT_PERIOD_SIZE = 1024 means 1024 * 4 = 4096 bytes 129 * We should take care of returning proper size when AudioFlinger queries for 130 * the buffer size of an input/output stream 131 */ 132#define DEEP_BUFFER_OUTPUT_PERIOD_SIZE 1024 133#define DEEP_BUFFER_OUTPUT_PERIOD_COUNT 8 134 135#define LOW_LATENCY_OUTPUT_PERIOD_SIZE 256 136#define LOW_LATENCY_OUTPUT_PERIOD_COUNT 2 137 138#define HDMI_MULTI_PERIOD_SIZE 336 139#define HDMI_MULTI_PERIOD_COUNT 8 140#define HDMI_MULTI_DEFAULT_CHANNEL_COUNT 6 141#define HDMI_MULTI_PERIOD_BYTES (HDMI_MULTI_PERIOD_SIZE * HDMI_MULTI_DEFAULT_CHANNEL_COUNT * 2) 142 143#define AUDIO_CAPTURE_PERIOD_SIZE 320 144#define AUDIO_CAPTURE_PERIOD_COUNT 2 145 146#define MAX_SUPPORTED_CHANNEL_MASKS 2 147 148struct stream_out { 149 struct audio_stream_out stream; 150 pthread_mutex_t lock; /* see note below on mutex acquisition order */ 151 struct pcm_config config; 152 struct pcm *pcm; 153 int standby; 154 int pcm_device_id; 155 audio_channel_mask_t channel_mask; 156 audio_devices_t devices; 157 audio_output_flags_t flags; 158 audio_usecase_t usecase; 159 /* Array of supported channel mask configurations. +1 so that the last entry is always 0 */ 160 audio_channel_mask_t supported_channel_masks[MAX_SUPPORTED_CHANNEL_MASKS + 1]; 161 162 struct audio_device *dev; 163}; 164 165struct stream_in { 166 struct audio_stream_in stream; 167 pthread_mutex_t lock; /* see note below on mutex acquisition order */ 168 struct pcm_config config; 169 struct pcm *pcm; 170 int standby; 171 int source; 172 int pcm_device_id; 173 int device; 174 audio_channel_mask_t channel_mask; 175 audio_usecase_t usecase; 176 177 struct audio_device *dev; 178}; 179 180typedef enum { 181 PCM_PLAYBACK, 182 PCM_CAPTURE, 183 VOICE_CALL 184} usecase_type_t; 185 186union stream_ptr { 187 struct stream_in *in; 188 struct stream_out *out; 189}; 190 191struct audio_usecase { 192 struct listnode list; 193 audio_usecase_t id; 194 usecase_type_t type; 195 audio_devices_t devices; 196 snd_device_t out_snd_device; 197 snd_device_t in_snd_device; 198 union stream_ptr stream; 199}; 200 201typedef void (*acdb_deallocate_t)(); 202typedef int (*acdb_init_t)(); 203typedef void (*acdb_send_audio_cal_t)(int, int); 204typedef void (*acdb_send_voice_cal_t)(int, int); 205 206typedef int (*csd_client_init_t)(); 207typedef int (*csd_client_deinit_t)(); 208typedef int (*csd_disable_device_t)(); 209typedef int (*csd_enable_device_t)(int, int, uint32_t); 210typedef int (*csd_volume_t)(int); 211typedef int (*csd_mic_mute_t)(int); 212typedef int (*csd_start_voice_t)(); 213typedef int (*csd_stop_voice_t)(); 214 215struct audio_device { 216 struct audio_hw_device device; 217 pthread_mutex_t lock; /* see note below on mutex acquisition order */ 218 struct mixer *mixer; 219 audio_mode_t mode; 220 audio_devices_t out_device; 221 struct stream_in *active_input; 222 struct stream_out *primary_output; 223 int in_call; 224 float voice_volume; 225 bool mic_mute; 226 int tty_mode; 227 bool bluetooth_nrec; 228 bool screen_off; 229 struct pcm *voice_call_rx; 230 struct pcm *voice_call_tx; 231 int snd_dev_ref_cnt[SND_DEVICE_MAX]; 232 struct listnode usecase_list; 233 struct audio_route *audio_route; 234 int acdb_settings; 235 236 bool mic_type_analog; 237 bool fluence_in_spkr_mode; 238 bool fluence_in_voice_call; 239 bool fluence_in_voice_rec; 240 int dualmic_config; 241 242 /* Audio calibration related functions */ 243 void *acdb_handle; 244 acdb_init_t acdb_init; 245 acdb_deallocate_t acdb_deallocate; 246 acdb_send_audio_cal_t acdb_send_audio_cal; 247 acdb_send_voice_cal_t acdb_send_voice_cal; 248 249 /* CSD Client related functions for voice call */ 250 void *csd_client; 251 csd_client_init_t csd_client_init; 252 csd_client_deinit_t csd_client_deinit; 253 csd_disable_device_t csd_disable_device; 254 csd_enable_device_t csd_enable_device; 255 csd_volume_t csd_volume; 256 csd_mic_mute_t csd_mic_mute; 257 csd_start_voice_t csd_start_voice; 258 csd_stop_voice_t csd_stop_voice; 259}; 260 261/* 262 * NOTE: when multiple mutexes have to be acquired, always take the 263 * stream_in or stream_out mutex first, followed by the audio_device mutex. 264 */ 265 266struct pcm_config pcm_config_deep_buffer = { 267 .channels = 2, 268 .rate = DEFAULT_OUTPUT_SAMPLING_RATE, 269 .period_size = DEEP_BUFFER_OUTPUT_PERIOD_SIZE, 270 .period_count = DEEP_BUFFER_OUTPUT_PERIOD_COUNT, 271 .format = PCM_FORMAT_S16_LE, 272 .start_threshold = DEEP_BUFFER_OUTPUT_PERIOD_SIZE / 4, 273 .avail_min = DEEP_BUFFER_OUTPUT_PERIOD_SIZE / 4, 274}; 275 276struct pcm_config pcm_config_low_latency = { 277 .channels = 2, 278 .rate = DEFAULT_OUTPUT_SAMPLING_RATE, 279 .period_size = LOW_LATENCY_OUTPUT_PERIOD_SIZE, 280 .period_count = LOW_LATENCY_OUTPUT_PERIOD_COUNT, 281 .format = PCM_FORMAT_S16_LE, 282 .start_threshold = LOW_LATENCY_OUTPUT_PERIOD_SIZE / 4, 283 .avail_min = LOW_LATENCY_OUTPUT_PERIOD_SIZE / 4, 284}; 285 286struct pcm_config pcm_config_hdmi_multi = { 287 .channels = HDMI_MULTI_DEFAULT_CHANNEL_COUNT, /* changed when the stream is opened */ 288 .rate = DEFAULT_OUTPUT_SAMPLING_RATE, /* changed when the stream is opened */ 289 .period_size = HDMI_MULTI_PERIOD_SIZE, 290 .period_count = HDMI_MULTI_PERIOD_COUNT, 291 .format = PCM_FORMAT_S16_LE, 292 .start_threshold = 0, 293 .avail_min = 0, 294}; 295 296struct pcm_config pcm_config_audio_capture = { 297 .channels = 2, 298 .period_size = AUDIO_CAPTURE_PERIOD_SIZE, 299 .period_count = AUDIO_CAPTURE_PERIOD_COUNT, 300 .format = PCM_FORMAT_S16_LE, 301}; 302 303struct pcm_config pcm_config_voice_call = { 304 .channels = 1, 305 .rate = 8000, 306 .period_size = 160, 307 .period_count = 2, 308 .format = PCM_FORMAT_S16_LE, 309}; 310 311