1 /* include/linux/msm_audio.h
2  *
3  * Copyright (C) 2008 Google, Inc.
4  * Copyright (c) 2012, 2014 The Linux Foundation. All rights reserved.
5  *
6  * This software is licensed under the terms of the GNU General Public
7  * License version 2, as published by the Free Software Foundation, and
8  * may be copied, distributed, and modified under those terms.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  */
16 
17 #ifndef _UAPI_LINUX_MSM_AUDIO_H
18 #define _UAPI_LINUX_MSM_AUDIO_H
19 
20 #include <linux/types.h>
21 #include <linux/ioctl.h>
22 
23 /* PCM Audio */
24 
25 #define AUDIO_IOCTL_MAGIC 'a'
26 
27 #define AUDIO_START        _IOW(AUDIO_IOCTL_MAGIC, 0, unsigned)
28 #define AUDIO_STOP         _IOW(AUDIO_IOCTL_MAGIC, 1, unsigned)
29 #define AUDIO_FLUSH        _IOW(AUDIO_IOCTL_MAGIC, 2, unsigned)
30 #define AUDIO_GET_CONFIG   _IOR(AUDIO_IOCTL_MAGIC, 3, \
31 		struct msm_audio_config)
32 #define AUDIO_SET_CONFIG   _IOW(AUDIO_IOCTL_MAGIC, 4, \
33 		struct msm_audio_config)
34 #define AUDIO_GET_STATS    _IOR(AUDIO_IOCTL_MAGIC, 5, \
35 		struct msm_audio_stats)
36 #define AUDIO_ENABLE_AUDPP _IOW(AUDIO_IOCTL_MAGIC, 6, unsigned)
37 #define AUDIO_SET_ADRC     _IOW(AUDIO_IOCTL_MAGIC, 7, unsigned)
38 #define AUDIO_SET_EQ       _IOW(AUDIO_IOCTL_MAGIC, 8, unsigned)
39 #define AUDIO_SET_RX_IIR   _IOW(AUDIO_IOCTL_MAGIC, 9, unsigned)
40 #define AUDIO_SET_VOLUME   _IOW(AUDIO_IOCTL_MAGIC, 10, unsigned)
41 #define AUDIO_PAUSE        _IOW(AUDIO_IOCTL_MAGIC, 11, unsigned)
42 #define AUDIO_PLAY_DTMF    _IOW(AUDIO_IOCTL_MAGIC, 12, unsigned)
43 #define AUDIO_GET_EVENT    _IOR(AUDIO_IOCTL_MAGIC, 13, \
44 		struct msm_audio_event)
45 #define AUDIO_ABORT_GET_EVENT _IOW(AUDIO_IOCTL_MAGIC, 14, unsigned)
46 #define AUDIO_REGISTER_PMEM _IOW(AUDIO_IOCTL_MAGIC, 15, unsigned)
47 #define AUDIO_DEREGISTER_PMEM _IOW(AUDIO_IOCTL_MAGIC, 16, unsigned)
48 #define AUDIO_ASYNC_WRITE _IOW(AUDIO_IOCTL_MAGIC, 17, \
49 		struct msm_audio_aio_buf)
50 #define AUDIO_ASYNC_READ _IOW(AUDIO_IOCTL_MAGIC, 18, \
51 		struct msm_audio_aio_buf)
52 #define AUDIO_SET_INCALL _IOW(AUDIO_IOCTL_MAGIC, 19, struct msm_voicerec_mode)
53 #define AUDIO_GET_NUM_SND_DEVICE _IOR(AUDIO_IOCTL_MAGIC, 20, unsigned)
54 #define AUDIO_GET_SND_DEVICES _IOWR(AUDIO_IOCTL_MAGIC, 21, \
55 				struct msm_snd_device_list)
56 #define AUDIO_ENABLE_SND_DEVICE _IOW(AUDIO_IOCTL_MAGIC, 22, unsigned)
57 #define AUDIO_DISABLE_SND_DEVICE _IOW(AUDIO_IOCTL_MAGIC, 23, unsigned)
58 #define AUDIO_ROUTE_STREAM _IOW(AUDIO_IOCTL_MAGIC, 24, \
59 				struct msm_audio_route_config)
60 #define AUDIO_GET_PCM_CONFIG _IOR(AUDIO_IOCTL_MAGIC, 30, unsigned)
61 #define AUDIO_SET_PCM_CONFIG _IOW(AUDIO_IOCTL_MAGIC, 31, unsigned)
62 #define AUDIO_SWITCH_DEVICE  _IOW(AUDIO_IOCTL_MAGIC, 32, unsigned)
63 #define AUDIO_SET_MUTE       _IOW(AUDIO_IOCTL_MAGIC, 33, unsigned)
64 #define AUDIO_UPDATE_ACDB    _IOW(AUDIO_IOCTL_MAGIC, 34, unsigned)
65 #define AUDIO_START_VOICE    _IOW(AUDIO_IOCTL_MAGIC, 35, unsigned)
66 #define AUDIO_STOP_VOICE     _IOW(AUDIO_IOCTL_MAGIC, 36, unsigned)
67 #define AUDIO_REINIT_ACDB    _IOW(AUDIO_IOCTL_MAGIC, 39, unsigned)
68 #define AUDIO_OUTPORT_FLUSH  _IOW(AUDIO_IOCTL_MAGIC, 40, unsigned short)
69 #define AUDIO_SET_ERR_THRESHOLD_VALUE _IOW(AUDIO_IOCTL_MAGIC, 41, \
70 					unsigned short)
71 #define AUDIO_GET_BITSTREAM_ERROR_INFO _IOR(AUDIO_IOCTL_MAGIC, 42, \
72 			       struct msm_audio_bitstream_error_info)
73 
74 #define AUDIO_SET_SRS_TRUMEDIA_PARAM _IOW(AUDIO_IOCTL_MAGIC, 43, unsigned)
75 
76 /* Qualcomm extensions */
77 #define AUDIO_SET_STREAM_CONFIG   _IOW(AUDIO_IOCTL_MAGIC, 80, \
78 				struct msm_audio_stream_config)
79 #define AUDIO_GET_STREAM_CONFIG   _IOR(AUDIO_IOCTL_MAGIC, 81, \
80 				struct msm_audio_stream_config)
81 #define AUDIO_GET_SESSION_ID _IOR(AUDIO_IOCTL_MAGIC, 82, unsigned short)
82 #define AUDIO_GET_STREAM_INFO   _IOR(AUDIO_IOCTL_MAGIC, 83, \
83 			       struct msm_audio_bitstream_info)
84 #define AUDIO_SET_PAN       _IOW(AUDIO_IOCTL_MAGIC, 84, unsigned)
85 #define AUDIO_SET_QCONCERT_PLUS       _IOW(AUDIO_IOCTL_MAGIC, 85, unsigned)
86 #define AUDIO_SET_MBADRC       _IOW(AUDIO_IOCTL_MAGIC, 86, unsigned)
87 #define AUDIO_SET_VOLUME_PATH   _IOW(AUDIO_IOCTL_MAGIC, 87, \
88 				     struct msm_vol_info)
89 #define AUDIO_SET_MAX_VOL_ALL _IOW(AUDIO_IOCTL_MAGIC, 88, unsigned)
90 #define AUDIO_ENABLE_AUDPRE  _IOW(AUDIO_IOCTL_MAGIC, 89, unsigned)
91 #define AUDIO_SET_AGC        _IOW(AUDIO_IOCTL_MAGIC, 90, unsigned)
92 #define AUDIO_SET_NS         _IOW(AUDIO_IOCTL_MAGIC, 91, unsigned)
93 #define AUDIO_SET_TX_IIR     _IOW(AUDIO_IOCTL_MAGIC, 92, unsigned)
94 #define AUDIO_GET_BUF_CFG    _IOW(AUDIO_IOCTL_MAGIC, 93, \
95 					struct msm_audio_buf_cfg)
96 #define AUDIO_SET_BUF_CFG    _IOW(AUDIO_IOCTL_MAGIC, 94, \
97 					struct msm_audio_buf_cfg)
98 #define AUDIO_SET_ACDB_BLK _IOW(AUDIO_IOCTL_MAGIC, 95,  \
99 					struct msm_acdb_cmd_device)
100 #define AUDIO_GET_ACDB_BLK _IOW(AUDIO_IOCTL_MAGIC, 96,  \
101 					struct msm_acdb_cmd_device)
102 
103 #define AUDIO_REGISTER_ION _IOW(AUDIO_IOCTL_MAGIC, 97, \
104 		struct msm_audio_ion_info)
105 #define AUDIO_DEREGISTER_ION _IOW(AUDIO_IOCTL_MAGIC, 98, \
106 		struct msm_audio_ion_info)
107 #define AUDIO_SET_EFFECTS_CONFIG   _IOW(AUDIO_IOCTL_MAGIC, 99, \
108 				struct msm_hwacc_effects_config)
109 #define AUDIO_EFFECTS_SET_BUF_LEN _IOW(AUDIO_IOCTL_MAGIC, 100, \
110 				struct msm_hwacc_buf_cfg)
111 #define AUDIO_EFFECTS_GET_BUF_AVAIL _IOW(AUDIO_IOCTL_MAGIC, 101, \
112 				struct msm_hwacc_buf_avail)
113 #define AUDIO_EFFECTS_WRITE _IOW(AUDIO_IOCTL_MAGIC, 102, void *)
114 #define AUDIO_EFFECTS_READ _IOWR(AUDIO_IOCTL_MAGIC, 103, void *)
115 #define AUDIO_EFFECTS_SET_PP_PARAMS _IOW(AUDIO_IOCTL_MAGIC, 104, void *)
116 
117 #define AUDIO_PM_AWAKE      _IOW(AUDIO_IOCTL_MAGIC, 105, unsigned)
118 #define AUDIO_PM_RELAX      _IOW(AUDIO_IOCTL_MAGIC, 106, unsigned)
119 
120 #define	AUDIO_MAX_COMMON_IOCTL_NUM	107
121 
122 
123 #define HANDSET_MIC			0x01
124 #define HANDSET_SPKR			0x02
125 #define HEADSET_MIC			0x03
126 #define HEADSET_SPKR_MONO		0x04
127 #define HEADSET_SPKR_STEREO		0x05
128 #define SPKR_PHONE_MIC			0x06
129 #define SPKR_PHONE_MONO			0x07
130 #define SPKR_PHONE_STEREO		0x08
131 #define BT_SCO_MIC			0x09
132 #define BT_SCO_SPKR			0x0A
133 #define BT_A2DP_SPKR			0x0B
134 #define TTY_HEADSET_MIC			0x0C
135 #define TTY_HEADSET_SPKR		0x0D
136 
137 /* Default devices are not supported in a */
138 /* device switching context. Only supported */
139 /* for stream devices. */
140 /* DO NOT USE */
141 #define DEFAULT_TX			0x0E
142 #define DEFAULT_RX			0x0F
143 
144 #define BT_A2DP_TX			0x10
145 
146 #define HEADSET_MONO_PLUS_SPKR_MONO_RX         0x11
147 #define HEADSET_MONO_PLUS_SPKR_STEREO_RX       0x12
148 #define HEADSET_STEREO_PLUS_SPKR_MONO_RX       0x13
149 #define HEADSET_STEREO_PLUS_SPKR_STEREO_RX     0x14
150 
151 #define I2S_RX				0x20
152 #define I2S_TX				0x21
153 
154 #define ADRC_ENABLE		0x0001
155 #define EQUALIZER_ENABLE	0x0002
156 #define IIR_ENABLE		0x0004
157 #define QCONCERT_PLUS_ENABLE	0x0008
158 #define MBADRC_ENABLE		0x0010
159 #define SRS_ENABLE		0x0020
160 #define SRS_DISABLE	0x0040
161 
162 #define AGC_ENABLE		0x0001
163 #define NS_ENABLE		0x0002
164 #define TX_IIR_ENABLE		0x0004
165 #define FLUENCE_ENABLE		0x0008
166 
167 #define VOC_REC_UPLINK		0x00
168 #define VOC_REC_DOWNLINK	0x01
169 #define VOC_REC_BOTH		0x02
170 
171 struct msm_audio_config {
172 	uint32_t buffer_size;
173 	uint32_t buffer_count;
174 	uint32_t channel_count;
175 	uint32_t sample_rate;
176 	uint32_t type;
177 	uint32_t meta_field;
178 	uint32_t bits;
179 	uint32_t unused[3];
180 };
181 
182 struct msm_audio_stream_config {
183 	uint32_t buffer_size;
184 	uint32_t buffer_count;
185 };
186 
187 struct msm_audio_buf_cfg{
188 	uint32_t meta_info_enable;
189 	uint32_t frames_per_buf;
190 };
191 
192 struct msm_audio_stats {
193 	uint32_t byte_count;
194 	uint32_t sample_count;
195 	uint32_t unused[2];
196 };
197 
198 struct msm_audio_ion_info {
199 	int fd;
200 	void *vaddr;
201 };
202 
203 struct msm_audio_pmem_info {
204 	int fd;
205 	void *vaddr;
206 };
207 
208 struct msm_audio_aio_buf {
209 	void *buf_addr;
210 	uint32_t buf_len;
211 	uint32_t data_len;
212 	void *private_data;
213 	unsigned short mfield_sz; /*only useful for data has meta field */
214 };
215 
216 /* Audio routing */
217 
218 #define SND_IOCTL_MAGIC 's'
219 
220 #define SND_MUTE_UNMUTED 0
221 #define SND_MUTE_MUTED   1
222 
223 struct msm_mute_info {
224 	uint32_t mute;
225 	uint32_t path;
226 };
227 
228 struct msm_vol_info {
229 	uint32_t vol;
230 	uint32_t path;
231 };
232 
233 struct msm_voicerec_mode {
234 	uint32_t rec_mode;
235 };
236 
237 struct msm_snd_device_config {
238 	uint32_t device;
239 	uint32_t ear_mute;
240 	uint32_t mic_mute;
241 };
242 
243 #define SND_SET_DEVICE _IOW(SND_IOCTL_MAGIC, 2, struct msm_device_config *)
244 
245 enum cad_device_path_type {
246 	CAD_DEVICE_PATH_RX,	/*For Decoding session*/
247 	CAD_DEVICE_PATH_TX,	/* For Encoding session*/
248 	CAD_DEVICE_PATH_RX_TX, /* For Voice call */
249 	CAD_DEVICE_PATH_LB,	/* For loopback (FM Analog)*/
250 	CAD_DEVICE_PATH_MAX
251 };
252 
253 struct cad_devices_type {
254 	uint32_t rx_device;
255 	uint32_t tx_device;
256 	enum cad_device_path_type pathtype;
257 };
258 
259 struct msm_cad_device_config {
260 	struct cad_devices_type device;
261 	uint32_t ear_mute;
262 	uint32_t mic_mute;
263 };
264 
265 #define CAD_SET_DEVICE _IOW(SND_IOCTL_MAGIC, 2, struct msm_cad_device_config *)
266 
267 #define SND_METHOD_VOICE 0
268 #define SND_METHOD_MIDI 4
269 
270 struct msm_snd_volume_config {
271 	uint32_t device;
272 	uint32_t method;
273 	uint32_t volume;
274 };
275 
276 #define SND_SET_VOLUME _IOW(SND_IOCTL_MAGIC, 3, struct msm_snd_volume_config *)
277 
278 struct msm_cad_volume_config {
279 	struct cad_devices_type device;
280 	uint32_t method;
281 	uint32_t volume;
282 };
283 
284 #define CAD_SET_VOLUME _IOW(SND_IOCTL_MAGIC, 3, struct msm_cad_volume_config *)
285 
286 /* Returns the number of SND endpoints supported. */
287 
288 #define SND_GET_NUM_ENDPOINTS _IOR(SND_IOCTL_MAGIC, 4, unsigned *)
289 
290 struct msm_snd_endpoint {
291 	int id; /* input and output */
292 	char name[64]; /* output only */
293 };
294 
295 /* Takes an index between 0 and one less than the number returned by
296  * SND_GET_NUM_ENDPOINTS, and returns the SND index and name of a
297  * SND endpoint.  On input, the .id field contains the number of the
298  * endpoint, and on exit it contains the SND index, while .name contains
299  * the description of the endpoint.
300  */
301 
302 #define SND_GET_ENDPOINT _IOWR(SND_IOCTL_MAGIC, 5, struct msm_snd_endpoint *)
303 
304 
305 #define SND_AVC_CTL _IOW(SND_IOCTL_MAGIC, 6, unsigned *)
306 #define SND_AGC_CTL _IOW(SND_IOCTL_MAGIC, 7, unsigned *)
307 
308 /*return the number of CAD endpoints supported. */
309 
310 #define CAD_GET_NUM_ENDPOINTS _IOR(SND_IOCTL_MAGIC, 4, unsigned *)
311 
312 struct msm_cad_endpoint {
313 	int id; /* input and output */
314 	char name[64]; /* output only */
315 };
316 
317 /* Takes an index between 0 and one less than the number returned by
318  * SND_GET_NUM_ENDPOINTS, and returns the CAD index and name of a
319  * CAD endpoint.  On input, the .id field contains the number of the
320  * endpoint, and on exit it contains the SND index, while .name contains
321  * the description of the endpoint.
322  */
323 
324 #define CAD_GET_ENDPOINT _IOWR(SND_IOCTL_MAGIC, 5, struct msm_cad_endpoint *)
325 
326 struct msm_audio_pcm_config {
327 	uint32_t pcm_feedback;	/* 0 - disable > 0 - enable */
328 	uint32_t buffer_count;	/* Number of buffers to allocate */
329 	uint32_t buffer_size;	/* Size of buffer for capturing of
330 				   PCM samples */
331 };
332 
333 #define AUDIO_EVENT_SUSPEND 0
334 #define AUDIO_EVENT_RESUME 1
335 #define AUDIO_EVENT_WRITE_DONE 2
336 #define AUDIO_EVENT_READ_DONE   3
337 #define AUDIO_EVENT_STREAM_INFO 4
338 #define AUDIO_EVENT_BITSTREAM_ERROR_INFO 5
339 
340 #define AUDIO_CODEC_TYPE_MP3 0
341 #define AUDIO_CODEC_TYPE_AAC 1
342 
343 struct msm_audio_bitstream_info {
344 	uint32_t codec_type;
345 	uint32_t chan_info;
346 	uint32_t sample_rate;
347 	uint32_t bit_stream_info;
348 	uint32_t bit_rate;
349 	uint32_t unused[3];
350 };
351 
352 struct msm_audio_bitstream_error_info {
353 	uint32_t dec_id;
354 	uint32_t err_msg_indicator;
355 	uint32_t err_type;
356 };
357 
358 union msm_audio_event_payload {
359 	struct msm_audio_aio_buf aio_buf;
360 	struct msm_audio_bitstream_info stream_info;
361 	struct msm_audio_bitstream_error_info error_info;
362 	int reserved;
363 };
364 
365 struct msm_audio_event {
366 	int event_type;
367 	int timeout_ms;
368 	union msm_audio_event_payload event_payload;
369 };
370 
371 #define MSM_SNDDEV_CAP_RX 0x1
372 #define MSM_SNDDEV_CAP_TX 0x2
373 #define MSM_SNDDEV_CAP_VOICE 0x4
374 
375 struct msm_snd_device_info {
376 	uint32_t dev_id;
377 	uint32_t dev_cap; /* bitmask describe capability of device */
378 	char dev_name[64];
379 };
380 
381 struct msm_snd_device_list {
382 	uint32_t  num_dev; /* Indicate number of device info to be retrieved */
383 	struct msm_snd_device_info *list;
384 };
385 
386 struct msm_dtmf_config {
387 	uint16_t path;
388 	uint16_t dtmf_hi;
389 	uint16_t dtmf_low;
390 	uint16_t duration;
391 	uint16_t tx_gain;
392 	uint16_t rx_gain;
393 	uint16_t mixing;
394 };
395 
396 #define AUDIO_ROUTE_STREAM_VOICE_RX 0
397 #define AUDIO_ROUTE_STREAM_VOICE_TX 1
398 #define AUDIO_ROUTE_STREAM_PLAYBACK 2
399 #define AUDIO_ROUTE_STREAM_REC      3
400 
401 struct msm_audio_route_config {
402 	uint32_t stream_type;
403 	uint32_t stream_id;
404 	uint32_t dev_id;
405 };
406 
407 #define AUDIO_MAX_EQ_BANDS 12
408 
409 struct msm_audio_eq_band {
410 	uint16_t     band_idx; /* The band index, 0 .. 11 */
411 	uint32_t     filter_type; /* Filter band type */
412 	uint32_t     center_freq_hz; /* Filter band center frequency */
413 	uint32_t     filter_gain; /* Filter band initial gain (dB) */
414 			/* Range is +12 dB to -12 dB with 1dB increments. */
415 	uint32_t     q_factor;
416 } __attribute__ ((packed));
417 
418 struct msm_audio_eq_stream_config {
419 	uint32_t	enable; /* Number of consequtive bands specified */
420 	uint32_t	num_bands;
421 	struct msm_audio_eq_band	eq_bands[AUDIO_MAX_EQ_BANDS];
422 } __attribute__ ((packed));
423 
424 struct msm_acdb_cmd_device {
425 	uint32_t     command_id;
426 	uint32_t     device_id;
427 	uint32_t     network_id;
428 	uint32_t     sample_rate_id;      /* Actual sample rate value */
429 	uint32_t     interface_id;        /* See interface id's above */
430 	uint32_t     algorithm_block_id;  /* See enumerations above */
431 	uint32_t     total_bytes;         /* Length in bytes used by buffer */
432 	uint32_t     *phys_buf;           /* Physical Address of data */
433 };
434 
435 struct msm_hwacc_data_config {
436 	__u32 buf_size;
437 	__u32 num_buf;
438 	__u32 num_channels;
439 	__u8 channel_map[8];
440 	__u32 sample_rate;
441 	__u32 bits_per_sample;
442 };
443 
444 struct msm_hwacc_buf_cfg {
445 	__u32 input_len;
446 	__u32 output_len;
447 };
448 
449 struct msm_hwacc_buf_avail {
450 	__u32 input_num_avail;
451 	__u32 output_num_avail;
452 };
453 
454 struct msm_hwacc_effects_config {
455 	struct msm_hwacc_data_config input;
456 	struct msm_hwacc_data_config output;
457 	struct msm_hwacc_buf_cfg buf_cfg;
458 	__u32 meta_mode_enabled;
459 	__u32 overwrite_topology;
460 	__s32 topology;
461 };
462 
463 #endif
464