blob: 55c3be4127d19e148326d61fafb52041c7da4970 [file] [log] [blame]
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -08001/*
vivek mehtaa51fd402016-02-04 19:49:33 -08002 * Copyright (C) 2013-2016 The Android Open Source Project
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -08003 *
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
Eric Laurentb23d5282013-05-14 15:27:20 -070017#ifndef QCOM_AUDIO_HW_H
18#define QCOM_AUDIO_HW_H
19
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -080020#include <cutils/str_parms.h>
Eric Laurentb23d5282013-05-14 15:27:20 -070021#include <cutils/list.h>
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080022#include <hardware/audio.h>
23
24#include <tinyalsa/asoundlib.h>
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -070025#include <tinycompress/tinycompress.h>
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080026
27#include <audio_route/audio_route.h>
Vineeta Srivastava4b89e372014-06-19 14:21:42 -070028#include "voice.h"
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080029
Andy Hung7ddf8672016-03-31 10:30:42 -070030// dlopen() does not go through default library path search if there is a "/" in the library name.
31#ifdef __LP64__
32#define VISUALIZER_LIBRARY_PATH "/system/lib64/soundfx/libqcomvisualizer.so"
33#define OFFLOAD_EFFECTS_BUNDLE_LIBRARY_PATH "/system/lib64/soundfx/libqcompostprocbundle.so"
34#else
35#define VISUALIZER_LIBRARY_PATH "/system/lib/soundfx/libqcomvisualizer.so"
36#define OFFLOAD_EFFECTS_BUNDLE_LIBRARY_PATH "/system/lib/soundfx/libqcompostprocbundle.so"
37#endif
Andy Hung4bd229e2016-03-07 18:29:16 -080038#define ADM_LIBRARY_PATH "libadm.so"
Eric Laurentc4aef752013-09-12 17:45:53 -070039
Eric Laurentb23d5282013-05-14 15:27:20 -070040/* Flags used to initialize acdb_settings variable that goes to ACDB library */
41#define DMIC_FLAG 0x00000002
42#define TTY_MODE_OFF 0x00000010
43#define TTY_MODE_FULL 0x00000020
44#define TTY_MODE_VCO 0x00000040
45#define TTY_MODE_HCO 0x00000080
46#define TTY_MODE_CLEAR 0xFFFFFF0F
47
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080048#define ACDB_DEV_TYPE_OUT 1
49#define ACDB_DEV_TYPE_IN 2
50
Eric Laurentb23d5282013-05-14 15:27:20 -070051#define MAX_SUPPORTED_CHANNEL_MASKS 2
Eric Laurent07eeafd2013-10-06 12:52:49 -070052#define DEFAULT_HDMI_OUT_CHANNELS 2
Ravi Kumar Alamanda72c411f2013-02-12 02:09:33 -080053
Haynes Mathew Georgec735fb02016-06-30 18:00:28 -070054typedef enum card_status_t {
55 CARD_STATUS_OFFLINE,
56 CARD_STATUS_ONLINE
57} card_status_t;
58
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080059/* These are the supported use cases by the hardware.
60 * Each usecase is mapped to a specific PCM device.
61 * Refer to pcm_device_table[].
62 */
Ravi Kumar Alamanda08dbcfc2014-08-20 16:24:38 -070063enum {
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080064 USECASE_INVALID = -1,
65 /* Playback usecases */
66 USECASE_AUDIO_PLAYBACK_DEEP_BUFFER = 0,
67 USECASE_AUDIO_PLAYBACK_LOW_LATENCY,
68 USECASE_AUDIO_PLAYBACK_MULTI_CH,
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -070069 USECASE_AUDIO_PLAYBACK_OFFLOAD,
Ravi Kumar Alamandaf78a4d92015-04-24 15:18:23 -070070 USECASE_AUDIO_PLAYBACK_TTS,
Ravi Kumar Alamanda2bc7b022015-06-25 20:08:01 -070071 USECASE_AUDIO_PLAYBACK_ULL,
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080072
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -080073 /* HFP Use case*/
74 USECASE_AUDIO_HFP_SCO,
75 USECASE_AUDIO_HFP_SCO_WB,
76
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080077 /* Capture usecases */
78 USECASE_AUDIO_RECORD,
79 USECASE_AUDIO_RECORD_LOW_LATENCY,
80
vivek mehtaa51fd402016-02-04 19:49:33 -080081 /* Voice extension usecases
82 *
83 * Following usecase are specific to voice session names created by
84 * MODEM and APPS on 8992/8994/8084/8974 platforms.
85 */
86 USECASE_VOICE_CALL, /* Usecase setup for voice session on first subscription for DSDS/DSDA */
87 USECASE_VOICE2_CALL, /* Usecase setup for voice session on second subscription for DSDS/DSDA */
88 USECASE_VOLTE_CALL, /* Usecase setup for VoLTE session on first subscription */
89 USECASE_QCHAT_CALL, /* Usecase setup for QCHAT session */
90 USECASE_VOWLAN_CALL, /* Usecase setup for VoWLAN session */
Vineeta Srivastava4b89e372014-06-19 14:21:42 -070091
vivek mehtaa51fd402016-02-04 19:49:33 -080092 /*
93 * Following usecase are specific to voice session names created by
94 * MODEM and APPS on 8996 platforms.
95 */
96
97 USECASE_VOICEMMODE1_CALL, /* Usecase setup for Voice/VoLTE/VoWLAN sessions on first
98 * subscription for DSDS/DSDA
99 */
100 USECASE_VOICEMMODE2_CALL, /* Usecase setup for voice/VoLTE/VoWLAN sessions on second
101 * subscription for DSDS/DSDA
102 */
103
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700104 USECASE_INCALL_REC_UPLINK,
105 USECASE_INCALL_REC_DOWNLINK,
106 USECASE_INCALL_REC_UPLINK_AND_DOWNLINK,
Ravi Kumar Alamanda99c752d2014-08-20 17:55:26 -0700107
Ravi Kumar Alamanda63863002015-04-22 11:15:25 -0700108 USECASE_AUDIO_SPKR_CALIB_RX,
109 USECASE_AUDIO_SPKR_CALIB_TX,
110
Ravi Kumar Alamanda99c752d2014-08-20 17:55:26 -0700111 USECASE_AUDIO_PLAYBACK_AFE_PROXY,
112 USECASE_AUDIO_RECORD_AFE_PROXY,
zhaoyang yin4211fad2015-06-04 21:13:25 +0800113 USECASE_AUDIO_DSM_FEEDBACK,
Ravi Kumar Alamanda99c752d2014-08-20 17:55:26 -0700114
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800115 AUDIO_USECASE_MAX
Ravi Kumar Alamanda08dbcfc2014-08-20 16:24:38 -0700116};
117
118const char * const use_case_table[AUDIO_USECASE_MAX];
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800119
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800120#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
121
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800122/*
123 * tinyAlsa library interprets period size as number of frames
124 * one frame = channel_count * sizeof (pcm sample)
125 * so if format = 16-bit PCM and channels = Stereo, frame size = 2 ch * 2 = 4 bytes
126 * DEEP_BUFFER_OUTPUT_PERIOD_SIZE = 1024 means 1024 * 4 = 4096 bytes
127 * We should take care of returning proper size when AudioFlinger queries for
128 * the buffer size of an input/output stream
129 */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800130
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700131enum {
132 OFFLOAD_CMD_EXIT, /* exit compress offload thread loop*/
133 OFFLOAD_CMD_DRAIN, /* send a full drain request to DSP */
134 OFFLOAD_CMD_PARTIAL_DRAIN, /* send a partial drain request to DSP */
135 OFFLOAD_CMD_WAIT_FOR_BUFFER, /* wait for buffer released by DSP */
136};
137
138enum {
139 OFFLOAD_STATE_IDLE,
140 OFFLOAD_STATE_PLAYING,
141 OFFLOAD_STATE_PAUSED,
142};
143
144struct offload_cmd {
145 struct listnode node;
146 int cmd;
147 int data[];
148};
149
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800150struct stream_out {
151 struct audio_stream_out stream;
Eric Laurent150dbfe2013-02-27 14:31:02 -0800152 pthread_mutex_t lock; /* see note below on mutex acquisition order */
Eric Laurenta1478072015-09-21 17:21:52 -0700153 pthread_mutex_t pre_lock; /* acquire before lock to avoid DOS by playback thread */
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700154 pthread_cond_t cond;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800155 struct pcm_config config;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700156 struct compr_config compr_config;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800157 struct pcm *pcm;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700158 struct compress *compr;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800159 int standby;
160 int pcm_device_id;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700161 unsigned int sample_rate;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800162 audio_channel_mask_t channel_mask;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700163 audio_format_t format;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800164 audio_devices_t devices;
165 audio_output_flags_t flags;
166 audio_usecase_t usecase;
167 /* Array of supported channel mask configurations. +1 so that the last entry is always 0 */
168 audio_channel_mask_t supported_channel_masks[MAX_SUPPORTED_CHANNEL_MASKS + 1];
Eric Laurenta9024de2013-04-04 09:19:12 -0700169 bool muted;
Glenn Kasten2ccd7ba2013-09-10 09:04:31 -0700170 uint64_t written; /* total frames written, not cleared when entering standby */
Eric Laurentc4aef752013-09-12 17:45:53 -0700171 audio_io_handle_t handle;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800172
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700173 int non_blocking;
174 int playback_started;
175 int offload_state;
176 pthread_cond_t offload_cond;
177 pthread_t offload_thread;
178 struct listnode offload_cmd_list;
179 bool offload_thread_blocked;
180
181 stream_callback_t offload_callback;
182 void *offload_cookie;
Haynes Mathew George352f27b2013-07-26 00:00:15 -0700183 struct compr_gapless_mdata gapless_mdata;
184 int send_new_metadata;
Haynes Mathew George03c40102016-01-29 17:57:48 -0800185 bool realtime;
186 int af_period_multiplier;
187 bool routing_change;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800188 struct audio_device *dev;
Haynes Mathew Georgec735fb02016-06-30 18:00:28 -0700189 card_status_t card_status;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800190};
191
192struct stream_in {
193 struct audio_stream_in stream;
Eric Laurent150dbfe2013-02-27 14:31:02 -0800194 pthread_mutex_t lock; /* see note below on mutex acquisition order */
Eric Laurenta1478072015-09-21 17:21:52 -0700195 pthread_mutex_t pre_lock; /* acquire before lock to avoid DOS by capture thread */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800196 struct pcm_config config;
197 struct pcm *pcm;
198 int standby;
199 int source;
200 int pcm_device_id;
Ravi Kumar Alamanda99c752d2014-08-20 17:55:26 -0700201 audio_devices_t device;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800202 audio_channel_mask_t channel_mask;
203 audio_usecase_t usecase;
Ravi Kumar Alamandaf70ffb42013-04-16 15:55:53 -0700204 bool enable_aec;
Ravi Kumar Alamanda3ad4e1b2014-06-03 00:08:15 -0700205 bool enable_ns;
Andy Hung6ebe5962016-01-15 17:46:57 -0800206 int64_t frames_read; /* total frames read, not cleared when entering standby */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800207
Ravi Kumar Alamandaa417cc52015-05-01 16:41:56 -0700208 audio_io_handle_t capture_handle;
Haynes Mathew George88e6fb22015-08-19 11:51:34 -0700209 audio_input_flags_t flags;
Ravi Kumar Alamandaa417cc52015-05-01 16:41:56 -0700210 bool is_st_session;
211 bool is_st_session_active;
Haynes Mathew George03c40102016-01-29 17:57:48 -0800212 bool realtime;
213 int af_period_multiplier;
214 bool routing_change;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800215 struct audio_device *dev;
vivek mehta4ed66e62016-04-15 23:33:34 -0700216 audio_format_t format;
Haynes Mathew Georgec735fb02016-06-30 18:00:28 -0700217 card_status_t card_status;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800218};
219
220typedef enum {
221 PCM_PLAYBACK,
222 PCM_CAPTURE,
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800223 VOICE_CALL,
224 PCM_HFP_CALL
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800225} usecase_type_t;
226
Ravi Kumar Alamanda096c87f2013-02-28 20:54:57 -0800227union stream_ptr {
228 struct stream_in *in;
229 struct stream_out *out;
230};
231
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800232struct audio_usecase {
Ravi Kumar Alamanda3b1816c2013-02-27 23:01:21 -0800233 struct listnode list;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800234 audio_usecase_t id;
235 usecase_type_t type;
236 audio_devices_t devices;
Ravi Kumar Alamanda71c84b72013-03-10 23:50:28 -0700237 snd_device_t out_snd_device;
238 snd_device_t in_snd_device;
Ravi Kumar Alamanda096c87f2013-02-28 20:54:57 -0800239 union stream_ptr stream;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800240};
241
Haynes Mathew George88e6fb22015-08-19 11:51:34 -0700242typedef void* (*adm_init_t)();
243typedef void (*adm_deinit_t)(void *);
244typedef void (*adm_register_output_stream_t)(void *, audio_io_handle_t, audio_output_flags_t);
245typedef void (*adm_register_input_stream_t)(void *, audio_io_handle_t, audio_input_flags_t);
246typedef void (*adm_deregister_stream_t)(void *, audio_io_handle_t);
247typedef void (*adm_request_focus_t)(void *, audio_io_handle_t);
248typedef void (*adm_abandon_focus_t)(void *, audio_io_handle_t);
Haynes Mathew George03c40102016-01-29 17:57:48 -0800249typedef void (*adm_set_config_t)(void *, audio_io_handle_t,
250 struct pcm *,
251 struct pcm_config *);
252typedef void (*adm_request_focus_v2_t)(void *, audio_io_handle_t, long);
253typedef bool (*adm_is_noirq_avail_t)(void *, int, int, int);
254typedef void (*adm_on_routing_change_t)(void *, audio_io_handle_t);
Haynes Mathew George88e6fb22015-08-19 11:51:34 -0700255
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800256struct audio_device {
257 struct audio_hw_device device;
Eric Laurent150dbfe2013-02-27 14:31:02 -0800258 pthread_mutex_t lock; /* see note below on mutex acquisition order */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800259 struct mixer *mixer;
260 audio_mode_t mode;
Eric Laurentc8400632013-02-14 19:04:54 -0800261 struct stream_in *active_input;
Ravi Kumar Alamanda096c87f2013-02-28 20:54:57 -0800262 struct stream_out *primary_output;
Ravi Kumar Alamanda99c752d2014-08-20 17:55:26 -0700263 struct stream_out *voice_tx_output;
264 struct stream_out *current_call_output;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800265 bool bluetooth_nrec;
266 bool screen_off;
Eric Laurentb23d5282013-05-14 15:27:20 -0700267 int *snd_dev_ref_cnt;
Ravi Kumar Alamanda3b1816c2013-02-27 23:01:21 -0800268 struct listnode usecase_list;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800269 struct audio_route *audio_route;
270 int acdb_settings;
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700271 struct voice voice;
Eric Laurent07eeafd2013-10-06 12:52:49 -0700272 unsigned int cur_hdmi_channels;
Ravi Kumar Alamanda9f306542014-04-02 15:11:49 -0700273 bool bt_wb_speech_enabled;
Eric Laurent7b2b5ab2014-09-14 12:29:59 -0700274 bool mic_muted;
Eric Laurentcefbbac2014-09-04 13:54:10 -0500275 bool enable_voicerx;
Uday Kishore Pasupuleti76297192015-09-18 08:39:43 -0700276 bool enable_hfp;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800277
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700278 int snd_card;
Eric Laurentb23d5282013-05-14 15:27:20 -0700279 void *platform;
Eric Laurent0499d4f2014-08-25 22:39:29 -0500280 void *extspk;
Eric Laurentc4aef752013-09-12 17:45:53 -0700281
Haynes Mathew Georgec735fb02016-06-30 18:00:28 -0700282 card_status_t card_status;
283
Eric Laurentc4aef752013-09-12 17:45:53 -0700284 void *visualizer_lib;
Haynes Mathew George41f86652014-06-17 14:22:15 -0700285 int (*visualizer_start_output)(audio_io_handle_t, int);
286 int (*visualizer_stop_output)(audio_io_handle_t, int);
Andy Hung31aca912014-03-20 17:14:59 -0700287
288 /* The pcm_params use_case_table is loaded by adev_verify_devices() upon
289 * calling adev_open().
290 *
291 * If an entry is not NULL, it can be used to determine if extended precision
292 * or other capabilities are present for the device corresponding to that usecase.
293 */
294 struct pcm_params *use_case_table[AUDIO_USECASE_MAX];
Haynes Mathew George41f86652014-06-17 14:22:15 -0700295 void *offload_effects_lib;
296 int (*offload_effects_start_output)(audio_io_handle_t, int);
297 int (*offload_effects_stop_output)(audio_io_handle_t, int);
Haynes Mathew George88e6fb22015-08-19 11:51:34 -0700298
299 void *adm_data;
300 void *adm_lib;
301 adm_init_t adm_init;
302 adm_deinit_t adm_deinit;
303 adm_register_input_stream_t adm_register_input_stream;
304 adm_register_output_stream_t adm_register_output_stream;
305 adm_deregister_stream_t adm_deregister_stream;
306 adm_request_focus_t adm_request_focus;
307 adm_abandon_focus_t adm_abandon_focus;
Haynes Mathew George03c40102016-01-29 17:57:48 -0800308 adm_set_config_t adm_set_config;
309 adm_request_focus_v2_t adm_request_focus_v2;
310 adm_is_noirq_avail_t adm_is_noirq_avail;
311 adm_on_routing_change_t adm_on_routing_change;
Eric Laurent2bafff12016-03-17 12:17:23 -0700312
313 /* logging */
314 snd_device_t last_logged_snd_device[AUDIO_USECASE_MAX][2]; /* [out, in] */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800315};
316
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800317int select_devices(struct audio_device *adev,
318 audio_usecase_t uc_id);
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700319
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800320int disable_audio_route(struct audio_device *adev,
321 struct audio_usecase *usecase);
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700322
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800323int disable_snd_device(struct audio_device *adev,
324 snd_device_t snd_device);
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700325
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800326int enable_snd_device(struct audio_device *adev,
327 snd_device_t snd_device);
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700328
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800329int enable_audio_route(struct audio_device *adev,
330 struct audio_usecase *usecase);
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700331
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800332struct audio_usecase *get_usecase_from_list(struct audio_device *adev,
333 audio_usecase_t uc_id);
334
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700335#define LITERAL_TO_STRING(x) #x
336#define CHECK(condition) LOG_ALWAYS_FATAL_IF(!(condition), "%s",\
337 __FILE__ ":" LITERAL_TO_STRING(__LINE__)\
338 " ASSERT_FATAL(" #condition ") failed.")
339
Eric Laurent150dbfe2013-02-27 14:31:02 -0800340/*
341 * NOTE: when multiple mutexes have to be acquired, always take the
342 * stream_in or stream_out mutex first, followed by the audio_device mutex.
343 */
344
Eric Laurentb23d5282013-05-14 15:27:20 -0700345#endif // QCOM_AUDIO_HW_H