1 /* include/linux/msm_audio.h
2  *
3  * Copyright (C) 2008 Google, Inc.
4  * Copyright (c) 2012 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 
108 #define	AUDIO_MAX_COMMON_IOCTL_NUM	100
109 
110 
111 #define HANDSET_MIC			0x01
112 #define HANDSET_SPKR			0x02
113 #define HEADSET_MIC			0x03
114 #define HEADSET_SPKR_MONO		0x04
115 #define HEADSET_SPKR_STEREO		0x05
116 #define SPKR_PHONE_MIC			0x06
117 #define SPKR_PHONE_MONO			0x07
118 #define SPKR_PHONE_STEREO		0x08
119 #define BT_SCO_MIC			0x09
120 #define BT_SCO_SPKR			0x0A
121 #define BT_A2DP_SPKR			0x0B
122 #define TTY_HEADSET_MIC			0x0C
123 #define TTY_HEADSET_SPKR		0x0D
124 
125 /* Default devices are not supported in a */
126 /* device switching context. Only supported */
127 /* for stream devices. */
128 /* DO NOT USE */
129 #define DEFAULT_TX			0x0E
130 #define DEFAULT_RX			0x0F
131 
132 #define BT_A2DP_TX			0x10
133 
134 #define HEADSET_MONO_PLUS_SPKR_MONO_RX         0x11
135 #define HEADSET_MONO_PLUS_SPKR_STEREO_RX       0x12
136 #define HEADSET_STEREO_PLUS_SPKR_MONO_RX       0x13
137 #define HEADSET_STEREO_PLUS_SPKR_STEREO_RX     0x14
138 
139 #define I2S_RX				0x20
140 #define I2S_TX				0x21
141 
142 #define ADRC_ENABLE		0x0001
143 #define EQ_ENABLE		0x0002
144 #define IIR_ENABLE		0x0004
145 #define QCONCERT_PLUS_ENABLE	0x0008
146 #define MBADRC_ENABLE		0x0010
147 #define SRS_ENABLE		0x0020
148 #define SRS_DISABLE	0x0040
149 
150 #define AGC_ENABLE		0x0001
151 #define NS_ENABLE		0x0002
152 #define TX_IIR_ENABLE		0x0004
153 #define FLUENCE_ENABLE		0x0008
154 
155 #define VOC_REC_UPLINK		0x00
156 #define VOC_REC_DOWNLINK	0x01
157 #define VOC_REC_BOTH		0x02
158 
159 struct msm_audio_config {
160 	uint32_t buffer_size;
161 	uint32_t buffer_count;
162 	uint32_t channel_count;
163 	uint32_t sample_rate;
164 	uint32_t type;
165 	uint32_t meta_field;
166 	uint32_t bits;
167 	uint32_t unused[3];
168 };
169 
170 struct msm_audio_stream_config {
171 	uint32_t buffer_size;
172 	uint32_t buffer_count;
173 };
174 
175 struct msm_audio_buf_cfg{
176 	uint32_t meta_info_enable;
177 	uint32_t frames_per_buf;
178 };
179 
180 struct msm_audio_stats {
181 	uint32_t byte_count;
182 	uint32_t sample_count;
183 	uint32_t unused[2];
184 };
185 
186 struct msm_audio_ion_info {
187 	int fd;
188 	void *vaddr;
189 };
190 
191 struct msm_audio_pmem_info {
192 	int fd;
193 	void *vaddr;
194 };
195 
196 struct msm_audio_aio_buf {
197 	void *buf_addr;
198 	uint32_t buf_len;
199 	uint32_t data_len;
200 	void *private_data;
201 	unsigned short mfield_sz; /*only useful for data has meta field */
202 };
203 
204 /* Audio routing */
205 
206 #define SND_IOCTL_MAGIC 's'
207 
208 #define SND_MUTE_UNMUTED 0
209 #define SND_MUTE_MUTED   1
210 
211 struct msm_mute_info {
212 	uint32_t mute;
213 	uint32_t path;
214 };
215 
216 struct msm_vol_info {
217 	uint32_t vol;
218 	uint32_t path;
219 };
220 
221 struct msm_voicerec_mode {
222 	uint32_t rec_mode;
223 };
224 
225 struct msm_snd_device_config {
226 	uint32_t device;
227 	uint32_t ear_mute;
228 	uint32_t mic_mute;
229 };
230 
231 #define SND_SET_DEVICE _IOW(SND_IOCTL_MAGIC, 2, struct msm_device_config *)
232 
233 enum cad_device_path_type {
234 	CAD_DEVICE_PATH_RX,	/*For Decoding session*/
235 	CAD_DEVICE_PATH_TX,	/* For Encoding session*/
236 	CAD_DEVICE_PATH_RX_TX, /* For Voice call */
237 	CAD_DEVICE_PATH_LB,	/* For loopback (FM Analog)*/
238 	CAD_DEVICE_PATH_MAX
239 };
240 
241 struct cad_devices_type {
242 	uint32_t rx_device;
243 	uint32_t tx_device;
244 	enum cad_device_path_type pathtype;
245 };
246 
247 struct msm_cad_device_config {
248 	struct cad_devices_type device;
249 	uint32_t ear_mute;
250 	uint32_t mic_mute;
251 };
252 
253 #define CAD_SET_DEVICE _IOW(SND_IOCTL_MAGIC, 2, struct msm_cad_device_config *)
254 
255 #define SND_METHOD_VOICE 0
256 #define SND_METHOD_MIDI 4
257 
258 struct msm_snd_volume_config {
259 	uint32_t device;
260 	uint32_t method;
261 	uint32_t volume;
262 };
263 
264 #define SND_SET_VOLUME _IOW(SND_IOCTL_MAGIC, 3, struct msm_snd_volume_config *)
265 
266 struct msm_cad_volume_config {
267 	struct cad_devices_type device;
268 	uint32_t method;
269 	uint32_t volume;
270 };
271 
272 #define CAD_SET_VOLUME _IOW(SND_IOCTL_MAGIC, 3, struct msm_cad_volume_config *)
273 
274 /* Returns the number of SND endpoints supported. */
275 
276 #define SND_GET_NUM_ENDPOINTS _IOR(SND_IOCTL_MAGIC, 4, unsigned *)
277 
278 struct msm_snd_endpoint {
279 	int id; /* input and output */
280 	char name[64]; /* output only */
281 };
282 
283 /* Takes an index between 0 and one less than the number returned by
284  * SND_GET_NUM_ENDPOINTS, and returns the SND index and name of a
285  * SND endpoint.  On input, the .id field contains the number of the
286  * endpoint, and on exit it contains the SND index, while .name contains
287  * the description of the endpoint.
288  */
289 
290 #define SND_GET_ENDPOINT _IOWR(SND_IOCTL_MAGIC, 5, struct msm_snd_endpoint *)
291 
292 
293 #define SND_AVC_CTL _IOW(SND_IOCTL_MAGIC, 6, unsigned *)
294 #define SND_AGC_CTL _IOW(SND_IOCTL_MAGIC, 7, unsigned *)
295 
296 /*return the number of CAD endpoints supported. */
297 
298 #define CAD_GET_NUM_ENDPOINTS _IOR(SND_IOCTL_MAGIC, 4, unsigned *)
299 
300 struct msm_cad_endpoint {
301 	int id; /* input and output */
302 	char name[64]; /* output only */
303 };
304 
305 /* Takes an index between 0 and one less than the number returned by
306  * SND_GET_NUM_ENDPOINTS, and returns the CAD index and name of a
307  * CAD endpoint.  On input, the .id field contains the number of the
308  * endpoint, and on exit it contains the SND index, while .name contains
309  * the description of the endpoint.
310  */
311 
312 #define CAD_GET_ENDPOINT _IOWR(SND_IOCTL_MAGIC, 5, struct msm_cad_endpoint *)
313 
314 struct msm_audio_pcm_config {
315 	uint32_t pcm_feedback;	/* 0 - disable > 0 - enable */
316 	uint32_t buffer_count;	/* Number of buffers to allocate */
317 	uint32_t buffer_size;	/* Size of buffer for capturing of
318 				   PCM samples */
319 };
320 
321 #define AUDIO_EVENT_SUSPEND 0
322 #define AUDIO_EVENT_RESUME 1
323 #define AUDIO_EVENT_WRITE_DONE 2
324 #define AUDIO_EVENT_READ_DONE   3
325 #define AUDIO_EVENT_STREAM_INFO 4
326 #define AUDIO_EVENT_BITSTREAM_ERROR_INFO 5
327 
328 #define AUDIO_CODEC_TYPE_MP3 0
329 #define AUDIO_CODEC_TYPE_AAC 1
330 
331 struct msm_audio_bitstream_info {
332 	uint32_t codec_type;
333 	uint32_t chan_info;
334 	uint32_t sample_rate;
335 	uint32_t bit_stream_info;
336 	uint32_t bit_rate;
337 	uint32_t unused[3];
338 };
339 
340 struct msm_audio_bitstream_error_info {
341 	uint32_t dec_id;
342 	uint32_t err_msg_indicator;
343 	uint32_t err_type;
344 };
345 
346 union msm_audio_event_payload {
347 	struct msm_audio_aio_buf aio_buf;
348 	struct msm_audio_bitstream_info stream_info;
349 	struct msm_audio_bitstream_error_info error_info;
350 	int reserved;
351 };
352 
353 struct msm_audio_event {
354 	int event_type;
355 	int timeout_ms;
356 	union msm_audio_event_payload event_payload;
357 };
358 
359 #define MSM_SNDDEV_CAP_RX 0x1
360 #define MSM_SNDDEV_CAP_TX 0x2
361 #define MSM_SNDDEV_CAP_VOICE 0x4
362 
363 struct msm_snd_device_info {
364 	uint32_t dev_id;
365 	uint32_t dev_cap; /* bitmask describe capability of device */
366 	char dev_name[64];
367 };
368 
369 struct msm_snd_device_list {
370 	uint32_t  num_dev; /* Indicate number of device info to be retrieved */
371 	struct msm_snd_device_info *list;
372 };
373 
374 struct msm_dtmf_config {
375 	uint16_t path;
376 	uint16_t dtmf_hi;
377 	uint16_t dtmf_low;
378 	uint16_t duration;
379 	uint16_t tx_gain;
380 	uint16_t rx_gain;
381 	uint16_t mixing;
382 };
383 
384 #define AUDIO_ROUTE_STREAM_VOICE_RX 0
385 #define AUDIO_ROUTE_STREAM_VOICE_TX 1
386 #define AUDIO_ROUTE_STREAM_PLAYBACK 2
387 #define AUDIO_ROUTE_STREAM_REC      3
388 
389 struct msm_audio_route_config {
390 	uint32_t stream_type;
391 	uint32_t stream_id;
392 	uint32_t dev_id;
393 };
394 
395 #define AUDIO_MAX_EQ_BANDS 12
396 
397 struct msm_audio_eq_band {
398 	uint16_t     band_idx; /* The band index, 0 .. 11 */
399 	uint32_t     filter_type; /* Filter band type */
400 	uint32_t     center_freq_hz; /* Filter band center frequency */
401 	uint32_t     filter_gain; /* Filter band initial gain (dB) */
402 			/* Range is +12 dB to -12 dB with 1dB increments. */
403 	uint32_t     q_factor;
404 } __attribute__ ((packed));
405 
406 struct msm_audio_eq_stream_config {
407 	uint32_t	enable; /* Number of consequtive bands specified */
408 	uint32_t	num_bands;
409 	struct msm_audio_eq_band	eq_bands[AUDIO_MAX_EQ_BANDS];
410 } __attribute__ ((packed));
411 
412 struct msm_acdb_cmd_device {
413 	uint32_t     command_id;
414 	uint32_t     device_id;
415 	uint32_t     network_id;
416 	uint32_t     sample_rate_id;      /* Actual sample rate value */
417 	uint32_t     interface_id;        /* See interface id's above */
418 	uint32_t     algorithm_block_id;  /* See enumerations above */
419 	uint32_t     total_bytes;         /* Length in bytes used by buffer */
420 	uint32_t     *phys_buf;           /* Physical Address of data */
421 };
422 
423 
424 #endif
425