audio_hw.h revision a9024defa11f6502ca55425a4803cd00441d51e7 
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 960
133#define DEEP_BUFFER_OUTPUT_PERIOD_COUNT 8
134
135#define LOW_LATENCY_OUTPUT_PERIOD_SIZE 240
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    bool muted;
162
163    struct audio_device *dev;
164};
165
166struct stream_in {
167    struct audio_stream_in stream;
168    pthread_mutex_t lock; /* see note below on mutex acquisition order */
169    struct pcm_config config;
170    struct pcm *pcm;
171    int standby;
172    int source;
173    int pcm_device_id;
174    int device;
175    audio_channel_mask_t channel_mask;
176    audio_usecase_t usecase;
177
178    struct audio_device *dev;
179};
180
181typedef enum {
182    PCM_PLAYBACK,
183    PCM_CAPTURE,
184    VOICE_CALL
185} usecase_type_t;
186
187union stream_ptr {
188    struct stream_in *in;
189    struct stream_out *out;
190};
191
192struct audio_usecase {
193    struct listnode list;
194    audio_usecase_t id;
195    usecase_type_t  type;
196    audio_devices_t devices;
197    snd_device_t out_snd_device;
198    snd_device_t in_snd_device;
199    union stream_ptr stream;
200};
201
202typedef void (*acdb_deallocate_t)();
203typedef int  (*acdb_init_t)();
204typedef void (*acdb_send_audio_cal_t)(int, int);
205typedef void (*acdb_send_voice_cal_t)(int, int);
206
207typedef int (*csd_client_init_t)();
208typedef int (*csd_client_deinit_t)();
209typedef int (*csd_disable_device_t)();
210typedef int (*csd_enable_device_t)(int, int, uint32_t);
211typedef int (*csd_volume_t)(int);
212typedef int (*csd_mic_mute_t)(int);
213typedef int (*csd_start_voice_t)();
214typedef int (*csd_stop_voice_t)();
215
216struct audio_device {
217    struct audio_hw_device device;
218    pthread_mutex_t lock; /* see note below on mutex acquisition order */
219    struct mixer *mixer;
220    audio_mode_t mode;
221    audio_devices_t out_device;
222    struct stream_in *active_input;
223    struct stream_out *primary_output;
224    int in_call;
225    float voice_volume;
226    bool mic_mute;
227    int tty_mode;
228    bool bluetooth_nrec;
229    bool screen_off;
230    struct pcm *voice_call_rx;
231    struct pcm *voice_call_tx;
232    int snd_dev_ref_cnt[SND_DEVICE_MAX];
233    struct listnode usecase_list;
234    struct audio_route *audio_route;
235    int acdb_settings;
236
237    bool mic_type_analog;
238    bool fluence_in_spkr_mode;
239    bool fluence_in_voice_call;
240    bool fluence_in_voice_rec;
241    int  dualmic_config;
242
243    /* Audio calibration related functions */
244    void *acdb_handle;
245    acdb_init_t acdb_init;
246    acdb_deallocate_t acdb_deallocate;
247    acdb_send_audio_cal_t acdb_send_audio_cal;
248    acdb_send_voice_cal_t acdb_send_voice_cal;
249
250    /* CSD Client related functions for voice call */
251    void *csd_client;
252    csd_client_init_t csd_client_init;
253    csd_client_deinit_t csd_client_deinit;
254    csd_disable_device_t csd_disable_device;
255    csd_enable_device_t csd_enable_device;
256    csd_volume_t csd_volume;
257    csd_mic_mute_t csd_mic_mute;
258    csd_start_voice_t csd_start_voice;
259    csd_stop_voice_t csd_stop_voice;
260};
261
262/*
263 * NOTE: when multiple mutexes have to be acquired, always take the
264 * stream_in or stream_out mutex first, followed by the audio_device mutex.
265 */
266
267struct pcm_config pcm_config_deep_buffer = {
268    .channels = 2,
269    .rate = DEFAULT_OUTPUT_SAMPLING_RATE,
270    .period_size = DEEP_BUFFER_OUTPUT_PERIOD_SIZE,
271    .period_count = DEEP_BUFFER_OUTPUT_PERIOD_COUNT,
272    .format = PCM_FORMAT_S16_LE,
273    .start_threshold = DEEP_BUFFER_OUTPUT_PERIOD_SIZE / 4,
274    .stop_threshold = INT_MAX,
275    .avail_min = DEEP_BUFFER_OUTPUT_PERIOD_SIZE / 4,
276};
277
278struct pcm_config pcm_config_low_latency = {
279    .channels = 2,
280    .rate = DEFAULT_OUTPUT_SAMPLING_RATE,
281    .period_size = LOW_LATENCY_OUTPUT_PERIOD_SIZE,
282    .period_count = LOW_LATENCY_OUTPUT_PERIOD_COUNT,
283    .format = PCM_FORMAT_S16_LE,
284    .start_threshold = LOW_LATENCY_OUTPUT_PERIOD_SIZE / 4,
285    .stop_threshold = INT_MAX,
286    .avail_min = LOW_LATENCY_OUTPUT_PERIOD_SIZE / 4,
287};
288
289struct pcm_config pcm_config_hdmi_multi = {
290    .channels = HDMI_MULTI_DEFAULT_CHANNEL_COUNT, /* changed when the stream is opened */
291    .rate = DEFAULT_OUTPUT_SAMPLING_RATE, /* changed when the stream is opened */
292    .period_size = HDMI_MULTI_PERIOD_SIZE,
293    .period_count = HDMI_MULTI_PERIOD_COUNT,
294    .format = PCM_FORMAT_S16_LE,
295    .start_threshold = 0,
296    .stop_threshold = INT_MAX,
297    .avail_min = 0,
298};
299
300struct pcm_config pcm_config_audio_capture = {
301    .channels = 2,
302    .period_size = AUDIO_CAPTURE_PERIOD_SIZE,
303    .period_count = AUDIO_CAPTURE_PERIOD_COUNT,
304    .format = PCM_FORMAT_S16_LE,
305};
306
307struct pcm_config pcm_config_voice_call = {
308    .channels = 1,
309    .rate = 8000,
310    .period_size = 160,
311    .period_count = 2,
312    .format = PCM_FORMAT_S16_LE,
313};
314
315