blob: 9a956f9d48f0cc644d1965dd77f7239186a70367 [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 Hung4bd229e2016-03-07 18:29:16 -080030#define VISUALIZER_LIBRARY_PATH "soundfx/libqcomvisualizer.so"
31#define OFFLOAD_EFFECTS_BUNDLE_LIBRARY_PATH "soundfx/libqcompostprocbundle.so"
32#define ADM_LIBRARY_PATH "libadm.so"
Eric Laurentc4aef752013-09-12 17:45:53 -070033
Eric Laurentb23d5282013-05-14 15:27:20 -070034/* Flags used to initialize acdb_settings variable that goes to ACDB library */
35#define DMIC_FLAG 0x00000002
36#define TTY_MODE_OFF 0x00000010
37#define TTY_MODE_FULL 0x00000020
38#define TTY_MODE_VCO 0x00000040
39#define TTY_MODE_HCO 0x00000080
40#define TTY_MODE_CLEAR 0xFFFFFF0F
41
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080042#define ACDB_DEV_TYPE_OUT 1
43#define ACDB_DEV_TYPE_IN 2
44
Eric Laurentb23d5282013-05-14 15:27:20 -070045#define MAX_SUPPORTED_CHANNEL_MASKS 2
Eric Laurent07eeafd2013-10-06 12:52:49 -070046#define DEFAULT_HDMI_OUT_CHANNELS 2
Ravi Kumar Alamanda72c411f2013-02-12 02:09:33 -080047
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080048/* These are the supported use cases by the hardware.
49 * Each usecase is mapped to a specific PCM device.
50 * Refer to pcm_device_table[].
51 */
Ravi Kumar Alamanda08dbcfc2014-08-20 16:24:38 -070052enum {
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080053 USECASE_INVALID = -1,
54 /* Playback usecases */
55 USECASE_AUDIO_PLAYBACK_DEEP_BUFFER = 0,
56 USECASE_AUDIO_PLAYBACK_LOW_LATENCY,
57 USECASE_AUDIO_PLAYBACK_MULTI_CH,
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -070058 USECASE_AUDIO_PLAYBACK_OFFLOAD,
Ravi Kumar Alamandaf78a4d92015-04-24 15:18:23 -070059 USECASE_AUDIO_PLAYBACK_TTS,
Ravi Kumar Alamanda2bc7b022015-06-25 20:08:01 -070060 USECASE_AUDIO_PLAYBACK_ULL,
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080061
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -080062 /* HFP Use case*/
63 USECASE_AUDIO_HFP_SCO,
64 USECASE_AUDIO_HFP_SCO_WB,
65
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080066 /* Capture usecases */
67 USECASE_AUDIO_RECORD,
68 USECASE_AUDIO_RECORD_LOW_LATENCY,
69
vivek mehtaa51fd402016-02-04 19:49:33 -080070 /* Voice extension usecases
71 *
72 * Following usecase are specific to voice session names created by
73 * MODEM and APPS on 8992/8994/8084/8974 platforms.
74 */
75 USECASE_VOICE_CALL, /* Usecase setup for voice session on first subscription for DSDS/DSDA */
76 USECASE_VOICE2_CALL, /* Usecase setup for voice session on second subscription for DSDS/DSDA */
77 USECASE_VOLTE_CALL, /* Usecase setup for VoLTE session on first subscription */
78 USECASE_QCHAT_CALL, /* Usecase setup for QCHAT session */
79 USECASE_VOWLAN_CALL, /* Usecase setup for VoWLAN session */
Vineeta Srivastava4b89e372014-06-19 14:21:42 -070080
vivek mehtaa51fd402016-02-04 19:49:33 -080081 /*
82 * Following usecase are specific to voice session names created by
83 * MODEM and APPS on 8996 platforms.
84 */
85
86 USECASE_VOICEMMODE1_CALL, /* Usecase setup for Voice/VoLTE/VoWLAN sessions on first
87 * subscription for DSDS/DSDA
88 */
89 USECASE_VOICEMMODE2_CALL, /* Usecase setup for voice/VoLTE/VoWLAN sessions on second
90 * subscription for DSDS/DSDA
91 */
92
Vineeta Srivastava4b89e372014-06-19 14:21:42 -070093 USECASE_INCALL_REC_UPLINK,
94 USECASE_INCALL_REC_DOWNLINK,
95 USECASE_INCALL_REC_UPLINK_AND_DOWNLINK,
Ravi Kumar Alamanda99c752d2014-08-20 17:55:26 -070096
Ravi Kumar Alamanda63863002015-04-22 11:15:25 -070097 USECASE_AUDIO_SPKR_CALIB_RX,
98 USECASE_AUDIO_SPKR_CALIB_TX,
99
Ravi Kumar Alamanda99c752d2014-08-20 17:55:26 -0700100 USECASE_AUDIO_PLAYBACK_AFE_PROXY,
101 USECASE_AUDIO_RECORD_AFE_PROXY,
zhaoyang yin4211fad2015-06-04 21:13:25 +0800102 USECASE_AUDIO_DSM_FEEDBACK,
Ravi Kumar Alamanda99c752d2014-08-20 17:55:26 -0700103
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800104 AUDIO_USECASE_MAX
Ravi Kumar Alamanda08dbcfc2014-08-20 16:24:38 -0700105};
106
107const char * const use_case_table[AUDIO_USECASE_MAX];
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800108
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800109#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
110
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800111/*
112 * tinyAlsa library interprets period size as number of frames
113 * one frame = channel_count * sizeof (pcm sample)
114 * so if format = 16-bit PCM and channels = Stereo, frame size = 2 ch * 2 = 4 bytes
115 * DEEP_BUFFER_OUTPUT_PERIOD_SIZE = 1024 means 1024 * 4 = 4096 bytes
116 * We should take care of returning proper size when AudioFlinger queries for
117 * the buffer size of an input/output stream
118 */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800119
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700120enum {
121 OFFLOAD_CMD_EXIT, /* exit compress offload thread loop*/
122 OFFLOAD_CMD_DRAIN, /* send a full drain request to DSP */
123 OFFLOAD_CMD_PARTIAL_DRAIN, /* send a partial drain request to DSP */
124 OFFLOAD_CMD_WAIT_FOR_BUFFER, /* wait for buffer released by DSP */
125};
126
127enum {
128 OFFLOAD_STATE_IDLE,
129 OFFLOAD_STATE_PLAYING,
130 OFFLOAD_STATE_PAUSED,
131};
132
133struct offload_cmd {
134 struct listnode node;
135 int cmd;
136 int data[];
137};
138
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800139struct stream_out {
140 struct audio_stream_out stream;
Eric Laurent150dbfe2013-02-27 14:31:02 -0800141 pthread_mutex_t lock; /* see note below on mutex acquisition order */
Eric Laurenta1478072015-09-21 17:21:52 -0700142 pthread_mutex_t pre_lock; /* acquire before lock to avoid DOS by playback thread */
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700143 pthread_cond_t cond;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800144 struct pcm_config config;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700145 struct compr_config compr_config;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800146 struct pcm *pcm;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700147 struct compress *compr;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800148 int standby;
149 int pcm_device_id;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700150 unsigned int sample_rate;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800151 audio_channel_mask_t channel_mask;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700152 audio_format_t format;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800153 audio_devices_t devices;
154 audio_output_flags_t flags;
155 audio_usecase_t usecase;
156 /* Array of supported channel mask configurations. +1 so that the last entry is always 0 */
157 audio_channel_mask_t supported_channel_masks[MAX_SUPPORTED_CHANNEL_MASKS + 1];
Eric Laurenta9024de2013-04-04 09:19:12 -0700158 bool muted;
Glenn Kasten2ccd7ba2013-09-10 09:04:31 -0700159 uint64_t written; /* total frames written, not cleared when entering standby */
Eric Laurentc4aef752013-09-12 17:45:53 -0700160 audio_io_handle_t handle;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800161
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700162 int non_blocking;
163 int playback_started;
164 int offload_state;
165 pthread_cond_t offload_cond;
166 pthread_t offload_thread;
167 struct listnode offload_cmd_list;
168 bool offload_thread_blocked;
169
170 stream_callback_t offload_callback;
171 void *offload_cookie;
Haynes Mathew George352f27b2013-07-26 00:00:15 -0700172 struct compr_gapless_mdata gapless_mdata;
173 int send_new_metadata;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700174
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800175 struct audio_device *dev;
176};
177
178struct stream_in {
179 struct audio_stream_in stream;
Eric Laurent150dbfe2013-02-27 14:31:02 -0800180 pthread_mutex_t lock; /* see note below on mutex acquisition order */
Eric Laurenta1478072015-09-21 17:21:52 -0700181 pthread_mutex_t pre_lock; /* acquire before lock to avoid DOS by capture thread */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800182 struct pcm_config config;
183 struct pcm *pcm;
184 int standby;
185 int source;
186 int pcm_device_id;
Ravi Kumar Alamanda99c752d2014-08-20 17:55:26 -0700187 audio_devices_t device;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800188 audio_channel_mask_t channel_mask;
189 audio_usecase_t usecase;
Ravi Kumar Alamandaf70ffb42013-04-16 15:55:53 -0700190 bool enable_aec;
Ravi Kumar Alamanda3ad4e1b2014-06-03 00:08:15 -0700191 bool enable_ns;
Andy Hung6ebe5962016-01-15 17:46:57 -0800192 int64_t frames_read; /* total frames read, not cleared when entering standby */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800193
Ravi Kumar Alamandaa417cc52015-05-01 16:41:56 -0700194 audio_io_handle_t capture_handle;
Haynes Mathew George88e6fb22015-08-19 11:51:34 -0700195 audio_input_flags_t flags;
Ravi Kumar Alamandaa417cc52015-05-01 16:41:56 -0700196 bool is_st_session;
197 bool is_st_session_active;
198
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800199 struct audio_device *dev;
200};
201
202typedef enum {
203 PCM_PLAYBACK,
204 PCM_CAPTURE,
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800205 VOICE_CALL,
206 PCM_HFP_CALL
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800207} usecase_type_t;
208
Ravi Kumar Alamanda096c87f2013-02-28 20:54:57 -0800209union stream_ptr {
210 struct stream_in *in;
211 struct stream_out *out;
212};
213
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800214struct audio_usecase {
Ravi Kumar Alamanda3b1816c2013-02-27 23:01:21 -0800215 struct listnode list;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800216 audio_usecase_t id;
217 usecase_type_t type;
218 audio_devices_t devices;
Ravi Kumar Alamanda71c84b72013-03-10 23:50:28 -0700219 snd_device_t out_snd_device;
220 snd_device_t in_snd_device;
Ravi Kumar Alamanda096c87f2013-02-28 20:54:57 -0800221 union stream_ptr stream;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800222};
223
Haynes Mathew George88e6fb22015-08-19 11:51:34 -0700224typedef void* (*adm_init_t)();
225typedef void (*adm_deinit_t)(void *);
226typedef void (*adm_register_output_stream_t)(void *, audio_io_handle_t, audio_output_flags_t);
227typedef void (*adm_register_input_stream_t)(void *, audio_io_handle_t, audio_input_flags_t);
228typedef void (*adm_deregister_stream_t)(void *, audio_io_handle_t);
229typedef void (*adm_request_focus_t)(void *, audio_io_handle_t);
230typedef void (*adm_abandon_focus_t)(void *, audio_io_handle_t);
231
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800232struct audio_device {
233 struct audio_hw_device device;
Eric Laurent150dbfe2013-02-27 14:31:02 -0800234 pthread_mutex_t lock; /* see note below on mutex acquisition order */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800235 struct mixer *mixer;
236 audio_mode_t mode;
Eric Laurentc8400632013-02-14 19:04:54 -0800237 struct stream_in *active_input;
Ravi Kumar Alamanda096c87f2013-02-28 20:54:57 -0800238 struct stream_out *primary_output;
Ravi Kumar Alamanda99c752d2014-08-20 17:55:26 -0700239 struct stream_out *voice_tx_output;
240 struct stream_out *current_call_output;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800241 bool bluetooth_nrec;
242 bool screen_off;
Eric Laurentb23d5282013-05-14 15:27:20 -0700243 int *snd_dev_ref_cnt;
Ravi Kumar Alamanda3b1816c2013-02-27 23:01:21 -0800244 struct listnode usecase_list;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800245 struct audio_route *audio_route;
246 int acdb_settings;
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700247 struct voice voice;
Eric Laurent07eeafd2013-10-06 12:52:49 -0700248 unsigned int cur_hdmi_channels;
Ravi Kumar Alamanda9f306542014-04-02 15:11:49 -0700249 bool bt_wb_speech_enabled;
Eric Laurent7b2b5ab2014-09-14 12:29:59 -0700250 bool mic_muted;
Eric Laurentcefbbac2014-09-04 13:54:10 -0500251 bool enable_voicerx;
Uday Kishore Pasupuleti76297192015-09-18 08:39:43 -0700252 bool enable_hfp;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800253
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700254 int snd_card;
Eric Laurentb23d5282013-05-14 15:27:20 -0700255 void *platform;
Eric Laurent0499d4f2014-08-25 22:39:29 -0500256 void *extspk;
Eric Laurentc4aef752013-09-12 17:45:53 -0700257
258 void *visualizer_lib;
Haynes Mathew George41f86652014-06-17 14:22:15 -0700259 int (*visualizer_start_output)(audio_io_handle_t, int);
260 int (*visualizer_stop_output)(audio_io_handle_t, int);
Andy Hung31aca912014-03-20 17:14:59 -0700261
262 /* The pcm_params use_case_table is loaded by adev_verify_devices() upon
263 * calling adev_open().
264 *
265 * If an entry is not NULL, it can be used to determine if extended precision
266 * or other capabilities are present for the device corresponding to that usecase.
267 */
268 struct pcm_params *use_case_table[AUDIO_USECASE_MAX];
Haynes Mathew George41f86652014-06-17 14:22:15 -0700269 void *offload_effects_lib;
270 int (*offload_effects_start_output)(audio_io_handle_t, int);
271 int (*offload_effects_stop_output)(audio_io_handle_t, int);
Haynes Mathew George88e6fb22015-08-19 11:51:34 -0700272
273 void *adm_data;
274 void *adm_lib;
275 adm_init_t adm_init;
276 adm_deinit_t adm_deinit;
277 adm_register_input_stream_t adm_register_input_stream;
278 adm_register_output_stream_t adm_register_output_stream;
279 adm_deregister_stream_t adm_deregister_stream;
280 adm_request_focus_t adm_request_focus;
281 adm_abandon_focus_t adm_abandon_focus;
Eric Laurent2bafff12016-03-17 12:17:23 -0700282
283 /* logging */
284 snd_device_t last_logged_snd_device[AUDIO_USECASE_MAX][2]; /* [out, in] */
285
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800286};
287
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800288int select_devices(struct audio_device *adev,
289 audio_usecase_t uc_id);
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700290
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800291int disable_audio_route(struct audio_device *adev,
292 struct audio_usecase *usecase);
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700293
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800294int disable_snd_device(struct audio_device *adev,
295 snd_device_t snd_device);
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700296
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800297int enable_snd_device(struct audio_device *adev,
298 snd_device_t snd_device);
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700299
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800300int enable_audio_route(struct audio_device *adev,
301 struct audio_usecase *usecase);
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700302
Ravi Kumar Alamanda8e6e98f2013-11-05 15:57:39 -0800303struct audio_usecase *get_usecase_from_list(struct audio_device *adev,
304 audio_usecase_t uc_id);
305
Vineeta Srivastava4b89e372014-06-19 14:21:42 -0700306#define LITERAL_TO_STRING(x) #x
307#define CHECK(condition) LOG_ALWAYS_FATAL_IF(!(condition), "%s",\
308 __FILE__ ":" LITERAL_TO_STRING(__LINE__)\
309 " ASSERT_FATAL(" #condition ") failed.")
310
Eric Laurent150dbfe2013-02-27 14:31:02 -0800311/*
312 * NOTE: when multiple mutexes have to be acquired, always take the
313 * stream_in or stream_out mutex first, followed by the audio_device mutex.
314 */
315
Eric Laurentb23d5282013-05-14 15:27:20 -0700316#endif // QCOM_AUDIO_HW_H