~sergiusens/libhybris/autotests

« back to all changes in this revision

Viewing changes to hybris/include/android/system/audio.h

  • Committer: Package Import Robot
  • Author(s): Ricardo Salveti de Araujo
  • Date: 2013-06-24 01:28:22 UTC
  • Revision ID: package-import@ubuntu.com-20130624012822-uk1ppfvw6ubb88bb
Tags: 0.1.0+git20130606+c5d897a-0ubuntu4
* Adding 0010-hardware-include-adding-audio-hal-related-headers-fr.patch:
  - Exporting headers needed to access the Android Audio HAL

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
/*
 
2
 * Copyright (C) 2011 The Android Open Source Project
 
3
 * Copyright (c) 2012, The Linux Foundation. All rights reserved.
 
4
 *
 
5
 * Licensed under the Apache License, Version 2.0 (the "License");
 
6
 * you may not use this file except in compliance with the License.
 
7
 * You may obtain a copy of the License at
 
8
 *
 
9
 *      http://www.apache.org/licenses/LICENSE-2.0
 
10
 *
 
11
 * Unless required by applicable law or agreed to in writing, software
 
12
 * distributed under the License is distributed on an "AS IS" BASIS,
 
13
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 
14
 * See the License for the specific language governing permissions and
 
15
 * limitations under the License.
 
16
 */
 
17
 
 
18
 
 
19
#ifndef ANDROID_AUDIO_CORE_H
 
20
#define ANDROID_AUDIO_CORE_H
 
21
 
 
22
#include <stdbool.h>
 
23
#include <stdint.h>
 
24
#include <sys/cdefs.h>
 
25
#include <sys/types.h>
 
26
 
 
27
#include <android/cutils/bitops.h>
 
28
 
 
29
__BEGIN_DECLS
 
30
 
 
31
/* The enums were moved here mostly from
 
32
 * frameworks/base/include/media/AudioSystem.h
 
33
 */
 
34
 
 
35
typedef int audio_io_handle_t;
 
36
 
 
37
/* Audio stream types */
 
38
typedef enum {
 
39
    AUDIO_STREAM_DEFAULT          = -1,
 
40
    AUDIO_STREAM_VOICE_CALL       = 0,
 
41
    AUDIO_STREAM_SYSTEM           = 1,
 
42
    AUDIO_STREAM_RING             = 2,
 
43
    AUDIO_STREAM_MUSIC            = 3,
 
44
    AUDIO_STREAM_ALARM            = 4,
 
45
    AUDIO_STREAM_NOTIFICATION     = 5,
 
46
    AUDIO_STREAM_BLUETOOTH_SCO    = 6,
 
47
    AUDIO_STREAM_ENFORCED_AUDIBLE = 7, /* Sounds that cannot be muted by user and must be routed to speaker */
 
48
    AUDIO_STREAM_DTMF             = 8,
 
49
    AUDIO_STREAM_TTS              = 9,
 
50
 
 
51
    AUDIO_STREAM_CNT,
 
52
    AUDIO_STREAM_MAX              = AUDIO_STREAM_CNT - 1,
 
53
} audio_stream_type_t;
 
54
 
 
55
/* Do not change these values without updating their counterparts
 
56
 * in media/java/android/media/MediaRecorder.java!
 
57
 */
 
58
typedef enum {
 
59
    AUDIO_SOURCE_DEFAULT             = 0,
 
60
    AUDIO_SOURCE_MIC                 = 1,
 
61
    AUDIO_SOURCE_VOICE_UPLINK        = 2,
 
62
    AUDIO_SOURCE_VOICE_DOWNLINK      = 3,
 
63
    AUDIO_SOURCE_VOICE_CALL          = 4,
 
64
    AUDIO_SOURCE_CAMCORDER           = 5,
 
65
    AUDIO_SOURCE_VOICE_RECOGNITION   = 6,
 
66
    AUDIO_SOURCE_VOICE_COMMUNICATION = 7,
 
67
    AUDIO_SOURCE_REMOTE_SUBMIX       = 8, /* Source for the mix to be presented remotely.      */
 
68
                                          /* An example of remote presentation is Wifi Display */
 
69
                                          /*  where a dongle attached to a TV can be used to   */
 
70
                                          /*  play the mix captured by this audio source.      */
 
71
    AUDIO_SOURCE_CNT,
 
72
    AUDIO_SOURCE_MAX                 = AUDIO_SOURCE_CNT - 1,
 
73
} audio_source_t;
 
74
 
 
75
/* special audio session values
 
76
 * (XXX: should this be living in the audio effects land?)
 
77
 */
 
78
typedef enum {
 
79
    /* session for effects attached to a particular output stream
 
80
     * (value must be less than 0)
 
81
     */
 
82
    AUDIO_SESSION_OUTPUT_STAGE = -1,
 
83
 
 
84
    /* session for effects applied to output mix. These effects can
 
85
     * be moved by audio policy manager to another output stream
 
86
     * (value must be 0)
 
87
     */
 
88
    AUDIO_SESSION_OUTPUT_MIX = 0,
 
89
} audio_session_t;
 
90
 
 
91
/* Audio sub formats (see enum audio_format). */
 
92
 
 
93
/* PCM sub formats */
 
94
typedef enum {
 
95
    AUDIO_FORMAT_PCM_SUB_16_BIT          = 0x1, /* DO NOT CHANGE - PCM signed 16 bits */
 
96
    AUDIO_FORMAT_PCM_SUB_8_BIT           = 0x2, /* DO NOT CHANGE - PCM unsigned 8 bits */
 
97
    AUDIO_FORMAT_PCM_SUB_32_BIT          = 0x3, /* PCM signed .31 fixed point */
 
98
    AUDIO_FORMAT_PCM_SUB_8_24_BIT        = 0x4, /* PCM signed 7.24 fixed point */
 
99
} audio_format_pcm_sub_fmt_t;
 
100
 
 
101
/* MP3 sub format field definition : can use 11 LSBs in the same way as MP3
 
102
 * frame header to specify bit rate, stereo mode, version...
 
103
 */
 
104
typedef enum {
 
105
    AUDIO_FORMAT_MP3_SUB_NONE            = 0x0,
 
106
} audio_format_mp3_sub_fmt_t;
 
107
 
 
108
/* AMR NB/WB sub format field definition: specify frame block interleaving,
 
109
 * bandwidth efficient or octet aligned, encoding mode for recording...
 
110
 */
 
111
typedef enum {
 
112
    AUDIO_FORMAT_AMR_SUB_NONE            = 0x0,
 
113
} audio_format_amr_sub_fmt_t;
 
114
 
 
115
/* AAC sub format field definition: specify profile or bitrate for recording... */
 
116
typedef enum {
 
117
    AUDIO_FORMAT_AAC_SUB_NONE            = 0x0,
 
118
} audio_format_aac_sub_fmt_t;
 
119
 
 
120
/* VORBIS sub format field definition: specify quality for recording... */
 
121
typedef enum {
 
122
    AUDIO_FORMAT_VORBIS_SUB_NONE         = 0x0,
 
123
} audio_format_vorbis_sub_fmt_t;
 
124
 
 
125
/* Audio format consists in a main format field (upper 8 bits) and a sub format
 
126
 * field (lower 24 bits).
 
127
 *
 
128
 * The main format indicates the main codec type. The sub format field
 
129
 * indicates options and parameters for each format. The sub format is mainly
 
130
 * used for record to indicate for instance the requested bitrate or profile.
 
131
 * It can also be used for certain formats to give informations not present in
 
132
 * the encoded audio stream (e.g. octet alignement for AMR).
 
133
 */
 
134
typedef enum {
 
135
    AUDIO_FORMAT_INVALID             = 0xFFFFFFFFUL,
 
136
    AUDIO_FORMAT_DEFAULT             = 0,
 
137
    AUDIO_FORMAT_PCM                 = 0x00000000UL, /* DO NOT CHANGE */
 
138
    AUDIO_FORMAT_MP3                 = 0x01000000UL,
 
139
    AUDIO_FORMAT_AMR_NB              = 0x02000000UL,
 
140
    AUDIO_FORMAT_AMR_WB              = 0x03000000UL,
 
141
    AUDIO_FORMAT_AAC                 = 0x04000000UL,
 
142
    AUDIO_FORMAT_HE_AAC_V1           = 0x05000000UL,
 
143
    AUDIO_FORMAT_HE_AAC_V2           = 0x06000000UL,
 
144
    AUDIO_FORMAT_VORBIS              = 0x07000000UL,
 
145
#ifdef QCOM_HARDWARE
 
146
    AUDIO_FORMAT_EVRC                = 0x08000000UL,
 
147
    AUDIO_FORMAT_QCELP               = 0x09000000UL,
 
148
    AUDIO_FORMAT_AC3                 = 0x0a000000UL,
 
149
    AUDIO_FORMAT_AC3_PLUS            = 0x0b000000UL,
 
150
    AUDIO_FORMAT_DTS                 = 0x0c000000UL,
 
151
    AUDIO_FORMAT_WMA                 = 0x0d000000UL,
 
152
    AUDIO_FORMAT_WMA_PRO             = 0x0e000000UL,
 
153
    AUDIO_FORMAT_AAC_ADIF            = 0x0f000000UL,
 
154
    AUDIO_FORMAT_EVRCB               = 0x10000000UL,
 
155
    AUDIO_FORMAT_EVRCWB              = 0x11000000UL,
 
156
    AUDIO_FORMAT_EAC3                = 0x12000000UL,
 
157
    AUDIO_FORMAT_DTS_LBR             = 0x13000000UL,
 
158
    AUDIO_FORMAT_AMR_WB_PLUS         = 0x14000000UL,
 
159
    AUDIO_FORMAT_MP2                 = 0x15000000UL,
 
160
#endif
 
161
    AUDIO_FORMAT_MAIN_MASK           = 0xFF000000UL,
 
162
    AUDIO_FORMAT_SUB_MASK            = 0x00FFFFFFUL,
 
163
 
 
164
    /* Aliases */
 
165
    AUDIO_FORMAT_PCM_16_BIT          = (AUDIO_FORMAT_PCM |
 
166
                                        AUDIO_FORMAT_PCM_SUB_16_BIT),
 
167
    AUDIO_FORMAT_PCM_8_BIT           = (AUDIO_FORMAT_PCM |
 
168
                                        AUDIO_FORMAT_PCM_SUB_8_BIT),
 
169
    AUDIO_FORMAT_PCM_32_BIT          = (AUDIO_FORMAT_PCM |
 
170
                                        AUDIO_FORMAT_PCM_SUB_32_BIT),
 
171
    AUDIO_FORMAT_PCM_8_24_BIT        = (AUDIO_FORMAT_PCM |
 
172
                                        AUDIO_FORMAT_PCM_SUB_8_24_BIT),
 
173
} audio_format_t;
 
174
 
 
175
enum {
 
176
    /* output channels */
 
177
    AUDIO_CHANNEL_OUT_FRONT_LEFT            = 0x1,
 
178
    AUDIO_CHANNEL_OUT_FRONT_RIGHT           = 0x2,
 
179
    AUDIO_CHANNEL_OUT_FRONT_CENTER          = 0x4,
 
180
    AUDIO_CHANNEL_OUT_LOW_FREQUENCY         = 0x8,
 
181
    AUDIO_CHANNEL_OUT_BACK_LEFT             = 0x10,
 
182
    AUDIO_CHANNEL_OUT_BACK_RIGHT            = 0x20,
 
183
    AUDIO_CHANNEL_OUT_FRONT_LEFT_OF_CENTER  = 0x40,
 
184
    AUDIO_CHANNEL_OUT_FRONT_RIGHT_OF_CENTER = 0x80,
 
185
    AUDIO_CHANNEL_OUT_BACK_CENTER           = 0x100,
 
186
    AUDIO_CHANNEL_OUT_SIDE_LEFT             = 0x200,
 
187
    AUDIO_CHANNEL_OUT_SIDE_RIGHT            = 0x400,
 
188
    AUDIO_CHANNEL_OUT_TOP_CENTER            = 0x800,
 
189
    AUDIO_CHANNEL_OUT_TOP_FRONT_LEFT        = 0x1000,
 
190
    AUDIO_CHANNEL_OUT_TOP_FRONT_CENTER      = 0x2000,
 
191
    AUDIO_CHANNEL_OUT_TOP_FRONT_RIGHT       = 0x4000,
 
192
    AUDIO_CHANNEL_OUT_TOP_BACK_LEFT         = 0x8000,
 
193
    AUDIO_CHANNEL_OUT_TOP_BACK_CENTER       = 0x10000,
 
194
    AUDIO_CHANNEL_OUT_TOP_BACK_RIGHT        = 0x20000,
 
195
 
 
196
    AUDIO_CHANNEL_OUT_MONO     = AUDIO_CHANNEL_OUT_FRONT_LEFT,
 
197
    AUDIO_CHANNEL_OUT_STEREO   = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
 
198
                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT),
 
199
#ifdef QCOM_HARDWARE
 
200
    AUDIO_CHANNEL_OUT_2POINT1  = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
 
201
                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
 
202
                                  AUDIO_CHANNEL_OUT_FRONT_CENTER),
 
203
#endif
 
204
    AUDIO_CHANNEL_OUT_QUAD     = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
 
205
                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
 
206
                                  AUDIO_CHANNEL_OUT_BACK_LEFT |
 
207
                                  AUDIO_CHANNEL_OUT_BACK_RIGHT),
 
208
    AUDIO_CHANNEL_OUT_SURROUND = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
 
209
                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
 
210
                                  AUDIO_CHANNEL_OUT_FRONT_CENTER |
 
211
                                  AUDIO_CHANNEL_OUT_BACK_CENTER),
 
212
#ifdef QCOM_HARDWARE
 
213
    AUDIO_CHANNEL_OUT_PENTA =    (AUDIO_CHANNEL_OUT_QUAD |
 
214
                                  AUDIO_CHANNEL_OUT_FRONT_CENTER),
 
215
#endif
 
216
    AUDIO_CHANNEL_OUT_5POINT1  = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
 
217
                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
 
218
                                  AUDIO_CHANNEL_OUT_FRONT_CENTER |
 
219
                                  AUDIO_CHANNEL_OUT_LOW_FREQUENCY |
 
220
                                  AUDIO_CHANNEL_OUT_BACK_LEFT |
 
221
                                  AUDIO_CHANNEL_OUT_BACK_RIGHT),
 
222
#ifdef QCOM_HARDWARE
 
223
    AUDIO_CHANNEL_OUT_6POINT1  = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
 
224
                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
 
225
                                  AUDIO_CHANNEL_OUT_FRONT_CENTER |
 
226
                                  AUDIO_CHANNEL_OUT_LOW_FREQUENCY |
 
227
                                  AUDIO_CHANNEL_OUT_BACK_LEFT |
 
228
                                  AUDIO_CHANNEL_OUT_BACK_RIGHT |
 
229
                                  AUDIO_CHANNEL_OUT_BACK_CENTER),
 
230
#endif
 
231
    // matches the correct AudioFormat.CHANNEL_OUT_7POINT1_SURROUND definition for 7.1
 
232
    AUDIO_CHANNEL_OUT_7POINT1  = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
 
233
                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
 
234
                                  AUDIO_CHANNEL_OUT_FRONT_CENTER |
 
235
                                  AUDIO_CHANNEL_OUT_LOW_FREQUENCY |
 
236
                                  AUDIO_CHANNEL_OUT_BACK_LEFT |
 
237
                                  AUDIO_CHANNEL_OUT_BACK_RIGHT |
 
238
                                  AUDIO_CHANNEL_OUT_SIDE_LEFT |
 
239
                                  AUDIO_CHANNEL_OUT_SIDE_RIGHT),
 
240
    AUDIO_CHANNEL_OUT_ALL      = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
 
241
                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
 
242
                                  AUDIO_CHANNEL_OUT_FRONT_CENTER |
 
243
                                  AUDIO_CHANNEL_OUT_LOW_FREQUENCY |
 
244
                                  AUDIO_CHANNEL_OUT_BACK_LEFT |
 
245
                                  AUDIO_CHANNEL_OUT_BACK_RIGHT |
 
246
                                  AUDIO_CHANNEL_OUT_FRONT_LEFT_OF_CENTER |
 
247
                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT_OF_CENTER |
 
248
                                  AUDIO_CHANNEL_OUT_BACK_CENTER|
 
249
                                  AUDIO_CHANNEL_OUT_SIDE_LEFT|
 
250
                                  AUDIO_CHANNEL_OUT_SIDE_RIGHT|
 
251
                                  AUDIO_CHANNEL_OUT_TOP_CENTER|
 
252
                                  AUDIO_CHANNEL_OUT_TOP_FRONT_LEFT|
 
253
                                  AUDIO_CHANNEL_OUT_TOP_FRONT_CENTER|
 
254
                                  AUDIO_CHANNEL_OUT_TOP_FRONT_RIGHT|
 
255
                                  AUDIO_CHANNEL_OUT_TOP_BACK_LEFT|
 
256
                                  AUDIO_CHANNEL_OUT_TOP_BACK_CENTER|
 
257
                                  AUDIO_CHANNEL_OUT_TOP_BACK_RIGHT),
 
258
 
 
259
    /* input channels */
 
260
    AUDIO_CHANNEL_IN_LEFT            = 0x4,
 
261
    AUDIO_CHANNEL_IN_RIGHT           = 0x8,
 
262
    AUDIO_CHANNEL_IN_FRONT           = 0x10,
 
263
    AUDIO_CHANNEL_IN_BACK            = 0x20,
 
264
    AUDIO_CHANNEL_IN_LEFT_PROCESSED  = 0x40,
 
265
    AUDIO_CHANNEL_IN_RIGHT_PROCESSED = 0x80,
 
266
    AUDIO_CHANNEL_IN_FRONT_PROCESSED = 0x100,
 
267
    AUDIO_CHANNEL_IN_BACK_PROCESSED  = 0x200,
 
268
    AUDIO_CHANNEL_IN_PRESSURE        = 0x400,
 
269
    AUDIO_CHANNEL_IN_X_AXIS          = 0x800,
 
270
    AUDIO_CHANNEL_IN_Y_AXIS          = 0x1000,
 
271
    AUDIO_CHANNEL_IN_Z_AXIS          = 0x2000,
 
272
    AUDIO_CHANNEL_IN_VOICE_UPLINK    = 0x4000,
 
273
    AUDIO_CHANNEL_IN_VOICE_DNLINK    = 0x8000,
 
274
#ifdef QCOM_HARDWARE
 
275
    AUDIO_CHANNEL_IN_FRONT_LEFT      = 0x10000,
 
276
    AUDIO_CHANNEL_IN_FRONT_RIGHT     = 0x20000,
 
277
    AUDIO_CHANNEL_IN_FRONT_CENTER    = 0x40000,
 
278
    AUDIO_CHANNEL_IN_LOW_FREQUENCY   = 0x80000,
 
279
    AUDIO_CHANNEL_IN_BACK_LEFT       = 0x100000,
 
280
    AUDIO_CHANNEL_IN_BACK_RIGHT      = 0x200000,
 
281
#endif
 
282
 
 
283
    AUDIO_CHANNEL_IN_MONO   = AUDIO_CHANNEL_IN_FRONT,
 
284
    AUDIO_CHANNEL_IN_STEREO = (AUDIO_CHANNEL_IN_LEFT | AUDIO_CHANNEL_IN_RIGHT),
 
285
#ifdef QCOM_HARDWARE
 
286
    AUDIO_CHANNEL_IN_5POINT1 = (AUDIO_CHANNEL_IN_FRONT_LEFT |
 
287
                               AUDIO_CHANNEL_IN_FRONT_RIGHT |
 
288
                               AUDIO_CHANNEL_IN_FRONT_CENTER |
 
289
                               AUDIO_CHANNEL_IN_LOW_FREQUENCY |
 
290
                               AUDIO_CHANNEL_IN_BACK_LEFT |
 
291
                               AUDIO_CHANNEL_IN_BACK_RIGHT),
 
292
    AUDIO_CHANNEL_IN_VOICE_UPLINK_MONO = (AUDIO_CHANNEL_IN_VOICE_UPLINK | AUDIO_CHANNEL_IN_MONO),
 
293
    AUDIO_CHANNEL_IN_VOICE_DNLINK_MONO = (AUDIO_CHANNEL_IN_VOICE_DNLINK | AUDIO_CHANNEL_IN_MONO),
 
294
    AUDIO_CHANNEL_IN_VOICE_CALL_MONO   = (AUDIO_CHANNEL_IN_VOICE_UPLINK_MONO | AUDIO_CHANNEL_IN_VOICE_DNLINK_MONO),
 
295
#endif
 
296
    AUDIO_CHANNEL_IN_ALL    = (AUDIO_CHANNEL_IN_LEFT |
 
297
                               AUDIO_CHANNEL_IN_RIGHT |
 
298
                               AUDIO_CHANNEL_IN_FRONT |
 
299
                               AUDIO_CHANNEL_IN_BACK|
 
300
                               AUDIO_CHANNEL_IN_LEFT_PROCESSED |
 
301
                               AUDIO_CHANNEL_IN_RIGHT_PROCESSED |
 
302
                               AUDIO_CHANNEL_IN_FRONT_PROCESSED |
 
303
                               AUDIO_CHANNEL_IN_BACK_PROCESSED|
 
304
                               AUDIO_CHANNEL_IN_PRESSURE |
 
305
                               AUDIO_CHANNEL_IN_X_AXIS |
 
306
                               AUDIO_CHANNEL_IN_Y_AXIS |
 
307
                               AUDIO_CHANNEL_IN_Z_AXIS |
 
308
#ifdef QCOM_HARDWARE
 
309
                               AUDIO_CHANNEL_IN_5POINT1 |
 
310
#endif
 
311
                               AUDIO_CHANNEL_IN_VOICE_UPLINK |
 
312
                               AUDIO_CHANNEL_IN_VOICE_DNLINK)
 
313
};
 
314
 
 
315
typedef uint32_t audio_channel_mask_t;
 
316
 
 
317
typedef enum {
 
318
    AUDIO_MODE_INVALID          = -2,
 
319
    AUDIO_MODE_CURRENT          = -1,
 
320
    AUDIO_MODE_NORMAL           = 0,
 
321
    AUDIO_MODE_RINGTONE         = 1,
 
322
    AUDIO_MODE_IN_CALL          = 2,
 
323
    AUDIO_MODE_IN_COMMUNICATION = 3,
 
324
 
 
325
    AUDIO_MODE_CNT,
 
326
    AUDIO_MODE_MAX              = AUDIO_MODE_CNT - 1,
 
327
} audio_mode_t;
 
328
 
 
329
typedef enum {
 
330
    AUDIO_IN_ACOUSTICS_AGC_ENABLE    = 0x0001,
 
331
    AUDIO_IN_ACOUSTICS_AGC_DISABLE   = 0,
 
332
    AUDIO_IN_ACOUSTICS_NS_ENABLE     = 0x0002,
 
333
    AUDIO_IN_ACOUSTICS_NS_DISABLE    = 0,
 
334
    AUDIO_IN_ACOUSTICS_TX_IIR_ENABLE = 0x0004,
 
335
    AUDIO_IN_ACOUSTICS_TX_DISABLE    = 0,
 
336
} audio_in_acoustics_t;
 
337
 
 
338
enum {
 
339
    AUDIO_DEVICE_NONE                          = 0x0,
 
340
    /* reserved bits */
 
341
#if defined(ICS_AUDIO_BLOB) || defined(MR0_AUDIO_BLOB)
 
342
    AUDIO_DEVICE_BIT_IN                        = 0x10000,
 
343
#else
 
344
    AUDIO_DEVICE_BIT_IN                        = 0x80000000,
 
345
#endif
 
346
    AUDIO_DEVICE_BIT_DEFAULT                   = 0x40000000,
 
347
    /* output devices */
 
348
    AUDIO_DEVICE_OUT_EARPIECE                  = 0x1,
 
349
    AUDIO_DEVICE_OUT_SPEAKER                   = 0x2,
 
350
    AUDIO_DEVICE_OUT_WIRED_HEADSET             = 0x4,
 
351
    AUDIO_DEVICE_OUT_WIRED_HEADPHONE           = 0x8,
 
352
    AUDIO_DEVICE_OUT_BLUETOOTH_SCO             = 0x10,
 
353
    AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET     = 0x20,
 
354
    AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT      = 0x40,
 
355
    AUDIO_DEVICE_OUT_BLUETOOTH_A2DP            = 0x80,
 
356
    AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 0x100,
 
357
    AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER    = 0x200,
 
358
    AUDIO_DEVICE_OUT_AUX_DIGITAL               = 0x400,
 
359
    AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET         = 0x800,
 
360
    AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET         = 0x1000,
 
361
    AUDIO_DEVICE_OUT_USB_ACCESSORY             = 0x2000,
 
362
    AUDIO_DEVICE_OUT_USB_DEVICE                = 0x4000,
 
363
    AUDIO_DEVICE_OUT_REMOTE_SUBMIX             = 0x8000,
 
364
#ifdef QCOM_HARDWARE
 
365
    AUDIO_DEVICE_OUT_ANC_HEADSET               = 0x10000,
 
366
    AUDIO_DEVICE_OUT_ANC_HEADPHONE             = 0x20000,
 
367
    AUDIO_DEVICE_OUT_PROXY                     = 0x40000,
 
368
    AUDIO_DEVICE_OUT_FM                        = 0x80000,
 
369
    AUDIO_DEVICE_OUT_FM_TX                     = 0x100000,
 
370
#endif
 
371
    AUDIO_DEVICE_OUT_DEFAULT                   = AUDIO_DEVICE_BIT_DEFAULT,
 
372
    AUDIO_DEVICE_OUT_ALL      = (AUDIO_DEVICE_OUT_EARPIECE |
 
373
                                 AUDIO_DEVICE_OUT_SPEAKER |
 
374
                                 AUDIO_DEVICE_OUT_WIRED_HEADSET |
 
375
                                 AUDIO_DEVICE_OUT_WIRED_HEADPHONE |
 
376
                                 AUDIO_DEVICE_OUT_BLUETOOTH_SCO |
 
377
                                 AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET |
 
378
                                 AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT |
 
379
                                 AUDIO_DEVICE_OUT_BLUETOOTH_A2DP |
 
380
                                 AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES |
 
381
                                 AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER |
 
382
                                 AUDIO_DEVICE_OUT_AUX_DIGITAL |
 
383
                                 AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET |
 
384
                                 AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET |
 
385
                                 AUDIO_DEVICE_OUT_USB_ACCESSORY |
 
386
                                 AUDIO_DEVICE_OUT_USB_DEVICE |
 
387
                                 AUDIO_DEVICE_OUT_REMOTE_SUBMIX |
 
388
#ifdef QCOM_HARDWARE
 
389
                                 AUDIO_DEVICE_OUT_ANC_HEADSET |
 
390
                                 AUDIO_DEVICE_OUT_ANC_HEADPHONE |
 
391
                                 AUDIO_DEVICE_OUT_PROXY |
 
392
                                 AUDIO_DEVICE_OUT_FM |
 
393
                                 AUDIO_DEVICE_OUT_FM_TX |
 
394
#endif
 
395
                                 AUDIO_DEVICE_OUT_DEFAULT),
 
396
    AUDIO_DEVICE_OUT_ALL_A2DP = (AUDIO_DEVICE_OUT_BLUETOOTH_A2DP |
 
397
                                 AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES |
 
398
                                 AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER),
 
399
    AUDIO_DEVICE_OUT_ALL_SCO  = (AUDIO_DEVICE_OUT_BLUETOOTH_SCO |
 
400
                                 AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET |
 
401
                                 AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT),
 
402
    AUDIO_DEVICE_OUT_ALL_USB  = (AUDIO_DEVICE_OUT_USB_ACCESSORY |
 
403
                                 AUDIO_DEVICE_OUT_USB_DEVICE),
 
404
 
 
405
    /* input devices */
 
406
#if defined(ICS_AUDIO_BLOB) || defined(MR0_AUDIO_BLOB)
 
407
    AUDIO_DEVICE_IN_COMMUNICATION         = AUDIO_DEVICE_BIT_IN * 0x1,
 
408
    AUDIO_DEVICE_IN_AMBIENT               = AUDIO_DEVICE_BIT_IN * 0x2,
 
409
    AUDIO_DEVICE_IN_BUILTIN_MIC           = AUDIO_DEVICE_BIT_IN * 0x4,
 
410
    AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET = AUDIO_DEVICE_BIT_IN * 0x8,
 
411
    AUDIO_DEVICE_IN_WIRED_HEADSET         = AUDIO_DEVICE_BIT_IN * 0x10,
 
412
    AUDIO_DEVICE_IN_AUX_DIGITAL           = AUDIO_DEVICE_BIT_IN * 0x20,
 
413
    AUDIO_DEVICE_IN_VOICE_CALL            = AUDIO_DEVICE_BIT_IN * 0x40,
 
414
    AUDIO_DEVICE_IN_BACK_MIC              = AUDIO_DEVICE_BIT_IN * 0x80,
 
415
    AUDIO_DEVICE_IN_REMOTE_SUBMIX         = AUDIO_DEVICE_BIT_IN * 0x100,
 
416
    AUDIO_DEVICE_IN_ANLG_DOCK_HEADSET     = AUDIO_DEVICE_BIT_IN * 0x200,
 
417
    AUDIO_DEVICE_IN_DGTL_DOCK_HEADSET     = AUDIO_DEVICE_BIT_IN * 0x400,
 
418
    AUDIO_DEVICE_IN_USB_ACCESSORY         = AUDIO_DEVICE_BIT_IN * 0x800,
 
419
    AUDIO_DEVICE_IN_USB_DEVICE            = AUDIO_DEVICE_BIT_IN * 0x1000,
 
420
    AUDIO_DEVICE_IN_DEFAULT               = AUDIO_DEVICE_IN_BUILTIN_MIC,
 
421
#else
 
422
    AUDIO_DEVICE_IN_COMMUNICATION         = AUDIO_DEVICE_BIT_IN | 0x1,
 
423
    AUDIO_DEVICE_IN_AMBIENT               = AUDIO_DEVICE_BIT_IN | 0x2,
 
424
    AUDIO_DEVICE_IN_BUILTIN_MIC           = AUDIO_DEVICE_BIT_IN | 0x4,
 
425
    AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET = AUDIO_DEVICE_BIT_IN | 0x8,
 
426
    AUDIO_DEVICE_IN_WIRED_HEADSET         = AUDIO_DEVICE_BIT_IN | 0x10,
 
427
    AUDIO_DEVICE_IN_AUX_DIGITAL           = AUDIO_DEVICE_BIT_IN | 0x20,
 
428
    AUDIO_DEVICE_IN_VOICE_CALL            = AUDIO_DEVICE_BIT_IN | 0x40,
 
429
    AUDIO_DEVICE_IN_BACK_MIC              = AUDIO_DEVICE_BIT_IN | 0x80,
 
430
    AUDIO_DEVICE_IN_REMOTE_SUBMIX         = AUDIO_DEVICE_BIT_IN | 0x100,
 
431
    AUDIO_DEVICE_IN_ANLG_DOCK_HEADSET     = AUDIO_DEVICE_BIT_IN | 0x200,
 
432
    AUDIO_DEVICE_IN_DGTL_DOCK_HEADSET     = AUDIO_DEVICE_BIT_IN | 0x400,
 
433
    AUDIO_DEVICE_IN_USB_ACCESSORY         = AUDIO_DEVICE_BIT_IN | 0x800,
 
434
    AUDIO_DEVICE_IN_USB_DEVICE            = AUDIO_DEVICE_BIT_IN | 0x1000,
 
435
#ifdef QCOM_HARDWARE
 
436
    AUDIO_DEVICE_IN_ANC_HEADSET           = AUDIO_DEVICE_BIT_IN | 0x2000,
 
437
    AUDIO_DEVICE_IN_PROXY                 = AUDIO_DEVICE_BIT_IN | 0x4000,
 
438
    AUDIO_DEVICE_IN_FM_RX                 = AUDIO_DEVICE_BIT_IN | 0x8000,
 
439
    AUDIO_DEVICE_IN_FM_RX_A2DP            = AUDIO_DEVICE_BIT_IN | 0x10000,
 
440
#endif
 
441
    AUDIO_DEVICE_IN_DEFAULT               = AUDIO_DEVICE_BIT_IN | AUDIO_DEVICE_BIT_DEFAULT,
 
442
#endif
 
443
 
 
444
    AUDIO_DEVICE_IN_ALL     = (AUDIO_DEVICE_IN_COMMUNICATION |
 
445
                               AUDIO_DEVICE_IN_AMBIENT |
 
446
                               AUDIO_DEVICE_IN_BUILTIN_MIC |
 
447
                               AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET |
 
448
                               AUDIO_DEVICE_IN_WIRED_HEADSET |
 
449
                               AUDIO_DEVICE_IN_AUX_DIGITAL |
 
450
                               AUDIO_DEVICE_IN_VOICE_CALL |
 
451
                               AUDIO_DEVICE_IN_BACK_MIC |
 
452
                               AUDIO_DEVICE_IN_REMOTE_SUBMIX |
 
453
                               AUDIO_DEVICE_IN_ANLG_DOCK_HEADSET |
 
454
                               AUDIO_DEVICE_IN_DGTL_DOCK_HEADSET |
 
455
                               AUDIO_DEVICE_IN_USB_ACCESSORY |
 
456
                               AUDIO_DEVICE_IN_USB_DEVICE |
 
457
#ifdef QCOM_HARDWARE
 
458
                               AUDIO_DEVICE_IN_ANC_HEADSET |
 
459
                               AUDIO_DEVICE_IN_FM_RX |
 
460
                               AUDIO_DEVICE_IN_FM_RX_A2DP |
 
461
                               AUDIO_DEVICE_IN_PROXY |
 
462
#endif
 
463
                               AUDIO_DEVICE_IN_DEFAULT),
 
464
    AUDIO_DEVICE_IN_ALL_SCO = AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET,
 
465
};
 
466
 
 
467
typedef uint32_t audio_devices_t;
 
468
 
 
469
/* the audio output flags serve two purposes:
 
470
 * - when an AudioTrack is created they indicate a "wish" to be connected to an
 
471
 * output stream with attributes corresponding to the specified flags
 
472
 * - when present in an output profile descriptor listed for a particular audio
 
473
 * hardware module, they indicate that an output stream can be opened that
 
474
 * supports the attributes indicated by the flags.
 
475
 * the audio policy manager will try to match the flags in the request
 
476
 * (when getOuput() is called) to an available output stream.
 
477
 */
 
478
typedef enum {
 
479
    AUDIO_OUTPUT_FLAG_NONE = 0x0,       // no attributes
 
480
    AUDIO_OUTPUT_FLAG_DIRECT = 0x1,     // this output directly connects a track
 
481
                                        // to one output stream: no software mixer
 
482
    AUDIO_OUTPUT_FLAG_PRIMARY = 0x2,    // this output is the primary output of
 
483
                                        // the device. It is unique and must be
 
484
                                        // present. It is opened by default and
 
485
                                        // receives routing, audio mode and volume
 
486
                                        // controls related to voice calls.
 
487
    AUDIO_OUTPUT_FLAG_FAST = 0x4,       // output supports "fast tracks",
 
488
                                        // defined elsewhere
 
489
    AUDIO_OUTPUT_FLAG_DEEP_BUFFER = 0x8,// use deep audio buffers
 
490
#ifdef QCOM_HARDWARE
 
491
    //Qualcomm Flags
 
492
    AUDIO_OUTPUT_FLAG_LPA = 0x1000,      // use LPA
 
493
    AUDIO_OUTPUT_FLAG_TUNNEL = 0x2000,   // use Tunnel
 
494
    AUDIO_OUTPUT_FLAG_VOIP_RX = 0x4000   // use this flag in combination with DIRECT to
 
495
                                         // indicate HAL to activate EC & NS
 
496
                                         // path for VOIP calls
 
497
#endif
 
498
} audio_output_flags_t;
 
499
 
 
500
static inline bool audio_is_output_device(audio_devices_t device)
 
501
{
 
502
    if (((device & AUDIO_DEVICE_BIT_IN) == 0) &&
 
503
            (popcount(device) == 1) && ((device & ~AUDIO_DEVICE_OUT_ALL) == 0))
 
504
        return true;
 
505
    else
 
506
        return false;
 
507
}
 
508
 
 
509
static inline bool audio_is_input_device(audio_devices_t device)
 
510
{
 
511
    if ((device & AUDIO_DEVICE_BIT_IN) != 0) {
 
512
        device &= ~AUDIO_DEVICE_BIT_IN;
 
513
        if ((popcount(device) == 1) && ((device & ~AUDIO_DEVICE_IN_ALL) == 0))
 
514
            return true;
 
515
    }
 
516
    return false;
 
517
}
 
518
 
 
519
static inline bool audio_is_output_devices(audio_devices_t device)
 
520
{
 
521
    return (device & AUDIO_DEVICE_BIT_IN) == 0;
 
522
}
 
523
 
 
524
 
 
525
static inline bool audio_is_a2dp_device(audio_devices_t device)
 
526
{
 
527
    if ((popcount(device) == 1) && (device & AUDIO_DEVICE_OUT_ALL_A2DP))
 
528
        return true;
 
529
    else
 
530
        return false;
 
531
}
 
532
 
 
533
static inline bool audio_is_bluetooth_sco_device(audio_devices_t device)
 
534
{
 
535
    device &= ~AUDIO_DEVICE_BIT_IN;
 
536
    if ((popcount(device) == 1) && (device & (AUDIO_DEVICE_OUT_ALL_SCO |
 
537
                   AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET)))
 
538
        return true;
 
539
    else
 
540
        return false;
 
541
}
 
542
 
 
543
static inline bool audio_is_usb_device(audio_devices_t device)
 
544
{
 
545
    if ((popcount(device) == 1) && (device & AUDIO_DEVICE_OUT_ALL_USB))
 
546
        return true;
 
547
    else
 
548
        return false;
 
549
}
 
550
 
 
551
static inline bool audio_is_remote_submix_device(audio_devices_t device)
 
552
{
 
553
    if ((popcount(device) == 1) && (device & AUDIO_DEVICE_OUT_REMOTE_SUBMIX))
 
554
        return true;
 
555
    else
 
556
        return false;
 
557
}
 
558
 
 
559
static inline bool audio_is_input_channel(uint32_t channel)
 
560
{
 
561
    if ((channel & ~AUDIO_CHANNEL_IN_ALL) == 0)
 
562
        return true;
 
563
    else
 
564
        return false;
 
565
}
 
566
 
 
567
static inline bool audio_is_output_channel(uint32_t channel)
 
568
{
 
569
    if ((channel & ~AUDIO_CHANNEL_OUT_ALL) == 0)
 
570
        return true;
 
571
    else
 
572
        return false;
 
573
}
 
574
 
 
575
/* Derive an output channel mask from a channel count.
 
576
 * This is to be used when the content channel mask is unknown. The 1, 2, 4, 5, 6, 7 and 8 channel
 
577
 * cases are mapped to the standard game/home-theater layouts, but note that 4 is mapped to quad,
 
578
 * and not stereo + FC + mono surround. A channel count of 3 is arbitrarily mapped to stereo + FC
 
579
 * for continuity with stereo.
 
580
 * Returns the matching channel mask, or 0 if the number of channels exceeds that of the
 
581
 * configurations for which a default channel mask is defined.
 
582
 */
 
583
static inline audio_channel_mask_t audio_channel_out_mask_from_count(uint32_t channel_count)
 
584
{
 
585
    switch(channel_count) {
 
586
    case 1:
 
587
        return AUDIO_CHANNEL_OUT_MONO;
 
588
    case 2:
 
589
        return AUDIO_CHANNEL_OUT_STEREO;
 
590
    case 3:
 
591
        return (AUDIO_CHANNEL_OUT_STEREO | AUDIO_CHANNEL_OUT_FRONT_CENTER);
 
592
    case 4: // 4.0
 
593
        return AUDIO_CHANNEL_OUT_QUAD;
 
594
    case 5: // 5.0
 
595
        return (AUDIO_CHANNEL_OUT_QUAD | AUDIO_CHANNEL_OUT_FRONT_CENTER);
 
596
    case 6: // 5.1
 
597
        return AUDIO_CHANNEL_OUT_5POINT1;
 
598
    case 7: // 6.1
 
599
        return (AUDIO_CHANNEL_OUT_5POINT1 | AUDIO_CHANNEL_OUT_BACK_CENTER);
 
600
    case 8:
 
601
        return AUDIO_CHANNEL_OUT_7POINT1;
 
602
    default:
 
603
        return 0;
 
604
    }
 
605
}
 
606
 
 
607
/* Similar to above, but for input.  Currently handles mono and stereo and 5.1 input. */
 
608
static inline audio_channel_mask_t audio_channel_in_mask_from_count(uint32_t channel_count)
 
609
{
 
610
    switch (channel_count) {
 
611
    case 1:
 
612
        return AUDIO_CHANNEL_IN_MONO;
 
613
    case 2:
 
614
        return AUDIO_CHANNEL_IN_STEREO;
 
615
#ifdef QCOM_HARDWARE
 
616
    case 6:
 
617
        return AUDIO_CHANNEL_IN_5POINT1;
 
618
#endif
 
619
    default:
 
620
        return 0;
 
621
    }
 
622
}
 
623
 
 
624
static inline bool audio_is_valid_format(audio_format_t format)
 
625
{
 
626
    switch (format & AUDIO_FORMAT_MAIN_MASK) {
 
627
    case AUDIO_FORMAT_PCM:
 
628
        if (format != AUDIO_FORMAT_PCM_16_BIT &&
 
629
                format != AUDIO_FORMAT_PCM_8_BIT) {
 
630
            return false;
 
631
        }
 
632
    case AUDIO_FORMAT_MP3:
 
633
    case AUDIO_FORMAT_AMR_NB:
 
634
    case AUDIO_FORMAT_AMR_WB:
 
635
    case AUDIO_FORMAT_AAC:
 
636
    case AUDIO_FORMAT_HE_AAC_V1:
 
637
    case AUDIO_FORMAT_HE_AAC_V2:
 
638
    case AUDIO_FORMAT_VORBIS:
 
639
#ifdef QCOM_HARDWARE
 
640
    case AUDIO_FORMAT_QCELP:
 
641
    case AUDIO_FORMAT_EVRC:
 
642
    case AUDIO_FORMAT_EVRCB:
 
643
    case AUDIO_FORMAT_EVRCWB:
 
644
    case AUDIO_FORMAT_AC3:
 
645
    case AUDIO_FORMAT_EAC3:
 
646
    case AUDIO_FORMAT_AAC_ADIF:
 
647
    case AUDIO_FORMAT_WMA:
 
648
    case AUDIO_FORMAT_WMA_PRO:
 
649
    case AUDIO_FORMAT_DTS:
 
650
    case AUDIO_FORMAT_DTS_LBR:
 
651
    case AUDIO_FORMAT_AMR_WB_PLUS:
 
652
    case AUDIO_FORMAT_MP2:
 
653
#endif
 
654
        return true;
 
655
    default:
 
656
        return false;
 
657
    }
 
658
}
 
659
 
 
660
static inline bool audio_is_linear_pcm(audio_format_t format)
 
661
{
 
662
    return ((format & AUDIO_FORMAT_MAIN_MASK) == AUDIO_FORMAT_PCM);
 
663
}
 
664
 
 
665
static inline size_t audio_bytes_per_sample(audio_format_t format)
 
666
{
 
667
    size_t size = 0;
 
668
 
 
669
    switch (format) {
 
670
    case AUDIO_FORMAT_PCM_32_BIT:
 
671
    case AUDIO_FORMAT_PCM_8_24_BIT:
 
672
        size = sizeof(int32_t);
 
673
        break;
 
674
    case AUDIO_FORMAT_PCM_16_BIT:
 
675
        size = sizeof(int16_t);
 
676
        break;
 
677
    case AUDIO_FORMAT_PCM_8_BIT:
 
678
        size = sizeof(uint8_t);
 
679
        break;
 
680
#ifdef QCOM_HARDWARE
 
681
    case AUDIO_FORMAT_AMR_WB:
 
682
        size = 61;
 
683
        break;
 
684
#endif
 
685
    default:
 
686
        break;
 
687
    }
 
688
    return size;
 
689
}
 
690
 
 
691
__END_DECLS
 
692
 
 
693
#endif  // ANDROID_AUDIO_CORE_H