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