audio.h revision 427d2b43c23c48aedadca008482f495145411e2b
1e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/*
2e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * Copyright (C) 2011 The Android Open Source Project
3e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin *
4e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * Licensed under the Apache License, Version 2.0 (the "License");
5e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * you may not use this file except in compliance with the License.
6e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * You may obtain a copy of the License at
7e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin *
8e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin *      http://www.apache.org/licenses/LICENSE-2.0
9e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin *
10e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * Unless required by applicable law or agreed to in writing, software
11e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * distributed under the License is distributed on an "AS IS" BASIS,
12e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * See the License for the specific language governing permissions and
14e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * limitations under the License.
15e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */
16e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
17e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
18e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin#ifndef ANDROID_AUDIO_CORE_H
19e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin#define ANDROID_AUDIO_CORE_H
20e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
21e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin#include <stdbool.h>
22e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin#include <stdint.h>
23e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin#include <sys/cdefs.h>
24e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin#include <sys/types.h>
25e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
26e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin#include <cutils/bitops.h>
27e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
28e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin__BEGIN_DECLS
29e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
30e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* The enums were moved here mostly from
31e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * frameworks/base/include/media/AudioSystem.h
32e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */
33e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
34e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef int audio_io_handle_t;
35e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
36e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* Audio stream types */
37e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
38e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_DEFAULT          = -1,
39e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_VOICE_CALL       = 0,
40e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_SYSTEM           = 1,
41e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_RING             = 2,
42e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_MUSIC            = 3,
43e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_ALARM            = 4,
44e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_NOTIFICATION     = 5,
45e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_BLUETOOTH_SCO    = 6,
46e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_ENFORCED_AUDIBLE = 7, /* Sounds that cannot be muted by user and must be routed to speaker */
47e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_DTMF             = 8,
48e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_TTS              = 9,
49e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
50e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_CNT,
51e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_STREAM_MAX              = AUDIO_STREAM_CNT - 1,
52e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_stream_type_t;
53e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
54e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* Do not change these values without updating their counterparts
55e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * in media/java/android/media/MediaRecorder.java!
56e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */
57e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
58e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SOURCE_DEFAULT             = 0,
59e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SOURCE_MIC                 = 1,
60e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SOURCE_VOICE_UPLINK        = 2,
61e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SOURCE_VOICE_DOWNLINK      = 3,
62e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SOURCE_VOICE_CALL          = 4,
63e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SOURCE_CAMCORDER           = 5,
64e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SOURCE_VOICE_RECOGNITION   = 6,
65e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SOURCE_VOICE_COMMUNICATION = 7,
66e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
67e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SOURCE_CNT,
68e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SOURCE_MAX                 = AUDIO_SOURCE_CNT - 1,
69e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_source_t;
70e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
71e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* special audio session values
72e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * (XXX: should this be living in the audio effects land?)
73e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */
74e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
75e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    /* session for effects attached to a particular output stream
76e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin     * (value must be less than 0)
77e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin     */
78e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SESSION_OUTPUT_STAGE = -1,
79e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
80e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    /* session for effects applied to output mix. These effects can
81e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin     * be moved by audio policy manager to another output stream
82e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin     * (value must be 0)
83e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin     */
84e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_SESSION_OUTPUT_MIX = 0,
85e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_session_t;
86e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
87e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* Audio sub formats (see enum audio_format). */
88e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
89e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* PCM sub formats */
90e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
919714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent    AUDIO_FORMAT_PCM_SUB_16_BIT          = 0x1, /* DO NOT CHANGE - PCM signed 16 bits */
929714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent    AUDIO_FORMAT_PCM_SUB_8_BIT           = 0x2, /* DO NOT CHANGE - PCM unsigned 8 bits */
939714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent    AUDIO_FORMAT_PCM_SUB_32_BIT          = 0x3, /* PCM signed .31 fixed point */
949714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent    AUDIO_FORMAT_PCM_SUB_8_24_BIT        = 0x4, /* PCM signed 7.24 fixed point */
95e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_pcm_sub_fmt_t;
96e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
97e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* MP3 sub format field definition : can use 11 LSBs in the same way as MP3
98e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * frame header to specify bit rate, stereo mode, version...
99e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */
100e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
101e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_MP3_SUB_NONE            = 0x0,
102e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_mp3_sub_fmt_t;
103e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
104e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* AMR NB/WB sub format field definition: specify frame block interleaving,
105e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * bandwidth efficient or octet aligned, encoding mode for recording...
106e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */
107e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
108e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_AMR_SUB_NONE            = 0x0,
109e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_amr_sub_fmt_t;
110e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
111e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* AAC sub format field definition: specify profile or bitrate for recording... */
112e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
113e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_AAC_SUB_NONE            = 0x0,
114e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_aac_sub_fmt_t;
115e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
116e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* VORBIS sub format field definition: specify quality for recording... */
117e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
118e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_VORBIS_SUB_NONE         = 0x0,
119e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_vorbis_sub_fmt_t;
120e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
121e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* Audio format consists in a main format field (upper 8 bits) and a sub format
122e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * field (lower 24 bits).
123e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin *
124e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * The main format indicates the main codec type. The sub format field
125e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * indicates options and parameters for each format. The sub format is mainly
126e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * used for record to indicate for instance the requested bitrate or profile.
127e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * It can also be used for certain formats to give informations not present in
128e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * the encoded audio stream (e.g. octet alignement for AMR).
129e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */
130e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
131e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_INVALID             = 0xFFFFFFFFUL,
132e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_DEFAULT             = 0,
133e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_PCM                 = 0x00000000UL, /* DO NOT CHANGE */
134e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_MP3                 = 0x01000000UL,
135e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_AMR_NB              = 0x02000000UL,
136e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_AMR_WB              = 0x03000000UL,
137e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_AAC                 = 0x04000000UL,
138e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_HE_AAC_V1           = 0x05000000UL,
139e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_HE_AAC_V2           = 0x06000000UL,
140e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_VORBIS              = 0x07000000UL,
141e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_MAIN_MASK           = 0xFF000000UL,
142e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_SUB_MASK            = 0x00FFFFFFUL,
143e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
144e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    /* Aliases */
145e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_PCM_16_BIT          = (AUDIO_FORMAT_PCM |
146e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                        AUDIO_FORMAT_PCM_SUB_16_BIT),
147e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_FORMAT_PCM_8_BIT           = (AUDIO_FORMAT_PCM |
148e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                        AUDIO_FORMAT_PCM_SUB_8_BIT),
1499714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent    AUDIO_FORMAT_PCM_32_BIT          = (AUDIO_FORMAT_PCM |
1509714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent                                        AUDIO_FORMAT_PCM_SUB_32_BIT),
1519714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent    AUDIO_FORMAT_PCM_8_24_BIT        = (AUDIO_FORMAT_PCM |
1529714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent                                        AUDIO_FORMAT_PCM_SUB_8_24_BIT),
153e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_t;
154e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
155e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
156e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    /* output channels */
1576d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_FRONT_LEFT            = 0x1,
1586d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_FRONT_RIGHT           = 0x2,
1596d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_FRONT_CENTER          = 0x4,
1606d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_LOW_FREQUENCY         = 0x8,
1616d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_BACK_LEFT             = 0x10,
1626d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_BACK_RIGHT            = 0x20,
1636d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_FRONT_LEFT_OF_CENTER  = 0x40,
1646d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_FRONT_RIGHT_OF_CENTER = 0x80,
1656d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_BACK_CENTER           = 0x100,
1666d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_SIDE_LEFT             = 0x200,
1676d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_SIDE_RIGHT            = 0x400,
1686d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_TOP_CENTER            = 0x800,
1696d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_TOP_FRONT_LEFT        = 0x1000,
1706d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_TOP_FRONT_CENTER      = 0x2000,
1716d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_TOP_FRONT_RIGHT       = 0x4000,
1726d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_TOP_BACK_LEFT         = 0x8000,
1736d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_TOP_BACK_CENTER       = 0x10000,
1746d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi    AUDIO_CHANNEL_OUT_TOP_BACK_RIGHT        = 0x20000,
175e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
176e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_OUT_MONO     = AUDIO_CHANNEL_OUT_FRONT_LEFT,
177e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_OUT_STEREO   = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
178e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT),
179e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_OUT_QUAD     = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
180e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
181e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_BACK_LEFT |
182e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_BACK_RIGHT),
183e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_OUT_SURROUND = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
184e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
185e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_CENTER |
186e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_BACK_CENTER),
187e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_OUT_5POINT1  = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
188e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
189e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_CENTER |
190e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_LOW_FREQUENCY |
191e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_BACK_LEFT |
192e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_BACK_RIGHT),
19333fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi    // matches the correct AudioFormat.CHANNEL_OUT_7POINT1_SURROUND definition for 7.1
194e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_OUT_7POINT1  = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
195e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
196e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_CENTER |
197e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_LOW_FREQUENCY |
198e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_BACK_LEFT |
199e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_BACK_RIGHT |
20033fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_SIDE_LEFT |
20133fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_SIDE_RIGHT),
202e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_OUT_ALL      = (AUDIO_CHANNEL_OUT_FRONT_LEFT |
203e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT |
204e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_CENTER |
205e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_LOW_FREQUENCY |
206e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_BACK_LEFT |
207e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_BACK_RIGHT |
208e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_LEFT_OF_CENTER |
209e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                  AUDIO_CHANNEL_OUT_FRONT_RIGHT_OF_CENTER |
21033fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_BACK_CENTER|
21133fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_SIDE_LEFT|
21233fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_SIDE_RIGHT|
21333fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_TOP_CENTER|
21433fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_TOP_FRONT_LEFT|
21533fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_TOP_FRONT_CENTER|
21633fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_TOP_FRONT_RIGHT|
21733fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_TOP_BACK_LEFT|
21833fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_TOP_BACK_CENTER|
21933fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi                                  AUDIO_CHANNEL_OUT_TOP_BACK_RIGHT),
220e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
221e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    /* input channels */
222e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_LEFT            = 0x4,
223e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_RIGHT           = 0x8,
224e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_FRONT           = 0x10,
225e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_BACK            = 0x20,
226e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_LEFT_PROCESSED  = 0x40,
227e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_RIGHT_PROCESSED = 0x80,
228e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_FRONT_PROCESSED = 0x100,
229e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_BACK_PROCESSED  = 0x200,
230e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_PRESSURE        = 0x400,
231e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_X_AXIS          = 0x800,
232e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_Y_AXIS          = 0x1000,
233e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_Z_AXIS          = 0x2000,
234e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_VOICE_UPLINK    = 0x4000,
235e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_VOICE_DNLINK    = 0x8000,
236e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
237e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_MONO   = AUDIO_CHANNEL_IN_FRONT,
238e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_STEREO = (AUDIO_CHANNEL_IN_LEFT | AUDIO_CHANNEL_IN_RIGHT),
239e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_CHANNEL_IN_ALL    = (AUDIO_CHANNEL_IN_LEFT |
240e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_RIGHT |
241e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_FRONT |
242e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_BACK|
243e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_LEFT_PROCESSED |
244e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_RIGHT_PROCESSED |
245e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_FRONT_PROCESSED |
246e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_BACK_PROCESSED|
247e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_PRESSURE |
248e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_X_AXIS |
249e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_Y_AXIS |
250e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_Z_AXIS |
251e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_VOICE_UPLINK |
252e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_CHANNEL_IN_VOICE_DNLINK),
2534ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi};
2544ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi
2554ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivitypedef uint32_t audio_channel_mask_t;
256e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
257e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
258e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_MODE_INVALID          = -2,
259e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_MODE_CURRENT          = -1,
260e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_MODE_NORMAL           = 0,
261e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_MODE_RINGTONE         = 1,
262e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_MODE_IN_CALL          = 2,
263e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_MODE_IN_COMMUNICATION = 3,
264e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
265e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_MODE_CNT,
266e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_MODE_MAX              = AUDIO_MODE_CNT - 1,
267e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_mode_t;
268e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
269e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
270e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_IN_ACOUSTICS_AGC_ENABLE    = 0x0001,
271e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_IN_ACOUSTICS_AGC_DISABLE   = 0,
272e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_IN_ACOUSTICS_NS_ENABLE     = 0x0002,
273e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_IN_ACOUSTICS_NS_DISABLE    = 0,
274e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_IN_ACOUSTICS_TX_IIR_ENABLE = 0x0004,
275e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_IN_ACOUSTICS_TX_DISABLE    = 0,
276e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_in_acoustics_t;
277e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
278e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum {
279e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    /* output devices */
280e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_EARPIECE                  = 0x1,
281e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_SPEAKER                   = 0x2,
282e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_WIRED_HEADSET             = 0x4,
283e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_WIRED_HEADPHONE           = 0x8,
284e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_BLUETOOTH_SCO             = 0x10,
285e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET     = 0x20,
286e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT      = 0x40,
287e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_BLUETOOTH_A2DP            = 0x80,
288e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 0x100,
289e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER    = 0x200,
290e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_AUX_DIGITAL               = 0x400,
291e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET         = 0x800,
292e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET         = 0x1000,
293e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_DEFAULT                   = 0x8000,
294e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_ALL      = (AUDIO_DEVICE_OUT_EARPIECE |
295e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_SPEAKER |
296e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_WIRED_HEADSET |
297e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_WIRED_HEADPHONE |
298e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_BLUETOOTH_SCO |
299e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET |
300e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT |
301e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_BLUETOOTH_A2DP |
302e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES |
303e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER |
304e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_AUX_DIGITAL |
305e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET |
306e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET |
307e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_DEFAULT),
308e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_ALL_A2DP = (AUDIO_DEVICE_OUT_BLUETOOTH_A2DP |
309e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES |
310e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER),
311e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_OUT_ALL_SCO  = (AUDIO_DEVICE_OUT_BLUETOOTH_SCO |
312e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET |
313e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                                 AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT),
314e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
315e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    /* input devices */
316e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_COMMUNICATION         = 0x10000,
317e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_AMBIENT               = 0x20000,
318e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_BUILTIN_MIC           = 0x40000,
319e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET = 0x80000,
320e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_WIRED_HEADSET         = 0x100000,
321e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_AUX_DIGITAL           = 0x200000,
322e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_VOICE_CALL            = 0x400000,
323e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_BACK_MIC              = 0x800000,
324e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_DEFAULT               = 0x80000000,
325e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
326e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_ALL     = (AUDIO_DEVICE_IN_COMMUNICATION |
327e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_DEVICE_IN_AMBIENT |
328e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_DEVICE_IN_BUILTIN_MIC |
329e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET |
330e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_DEVICE_IN_WIRED_HEADSET |
331e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_DEVICE_IN_AUX_DIGITAL |
332e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_DEVICE_IN_VOICE_CALL |
333e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_DEVICE_IN_BACK_MIC |
334e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                               AUDIO_DEVICE_IN_DEFAULT),
335e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    AUDIO_DEVICE_IN_ALL_SCO = AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET,
336e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_devices_t;
337e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
338e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavinstatic inline bool audio_is_output_device(audio_devices_t device)
339e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{
340e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    if ((popcount(device) == 1) && ((device & ~AUDIO_DEVICE_OUT_ALL) == 0))
341e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return true;
342e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    else
343e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return false;
344e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin}
345e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
346e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavinstatic inline bool audio_is_input_device(audio_devices_t device)
347e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{
348e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    if ((popcount(device) == 1) && ((device & ~AUDIO_DEVICE_IN_ALL) == 0))
349e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return true;
350e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    else
351e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return false;
352e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin}
353e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
354e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavinstatic inline bool audio_is_a2dp_device(audio_devices_t device)
355e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{
356e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    if ((popcount(device) == 1) && (device & AUDIO_DEVICE_OUT_ALL_A2DP))
357e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return true;
358e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    else
359e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return false;
360e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin}
361e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
362e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavinstatic inline bool audio_is_bluetooth_sco_device(audio_devices_t device)
363e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{
364e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    if ((popcount(device) == 1) && (device & (AUDIO_DEVICE_OUT_ALL_SCO |
365e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin                   AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET)))
366e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return true;
367e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    else
368e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return false;
369e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin}
370e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
371e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavinstatic inline bool audio_is_input_channel(uint32_t channel)
372e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{
373e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    if ((channel & ~AUDIO_CHANNEL_IN_ALL) == 0)
374e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return true;
375e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    else
376e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return false;
377e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin}
378e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
379e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavinstatic inline bool audio_is_output_channel(uint32_t channel)
380e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{
381e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    if ((channel & ~AUDIO_CHANNEL_OUT_ALL) == 0)
382e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return true;
383e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    else
384e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return false;
385e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin}
386e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
3874ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi/* Derive a channel mask from a channel count.
3884ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * This is to be used when the content channel mask is unknown. The 1, 2, 4, 5, 6, 7 and 8 channel
3894ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * cases are mapped to the standard game/home-theater layouts, but note that 4 is mapped to quad,
3904ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * and not stereo + FC + mono surround. A channel count of 3 is arbitrarily mapped to stereo + FC
3914ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * for continuity with stereo.
3924ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * Returns the matching channel mask, or 0 if the number of channels exceeds that of the
3934ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * configurations for which a default channel mask is defined.
3944ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi */
3954ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivistatic inline audio_channel_mask_t audio_channel_mask_from_count(uint32_t channel_count)
3964ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi{
3974ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    switch(channel_count) {
3984ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    case 1:
3994ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi        return AUDIO_CHANNEL_OUT_MONO;
4004ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    case 2:
4014ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi        return AUDIO_CHANNEL_OUT_STEREO;
4024ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    case 3:
4034ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi        return (AUDIO_CHANNEL_OUT_STEREO | AUDIO_CHANNEL_OUT_FRONT_CENTER);
4044ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    case 4: // 4.0
4054ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi        return AUDIO_CHANNEL_OUT_QUAD;
4064ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    case 5: // 5.0
4074ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi        return (AUDIO_CHANNEL_OUT_QUAD | AUDIO_CHANNEL_OUT_FRONT_CENTER);
4084ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    case 6: // 5.1
4094ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi        return AUDIO_CHANNEL_OUT_5POINT1;
4104ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    case 7: // 6.1
4114ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi        return (AUDIO_CHANNEL_OUT_5POINT1 | AUDIO_CHANNEL_OUT_BACK_CENTER);
4124ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    case 8:
4134ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi        return AUDIO_CHANNEL_OUT_7POINT1;
4144ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    default:
4154ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi        return 0;
4164ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi    }
4174ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi}
4184ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi
419828bf0cdf4e869fa7bb007331670328c834f8277Glenn Kastenstatic inline bool audio_is_valid_format(audio_format_t format)
420e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{
421e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    switch (format & AUDIO_FORMAT_MAIN_MASK) {
422e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    case AUDIO_FORMAT_PCM:
423da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent        if (format != AUDIO_FORMAT_PCM_16_BIT &&
424da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent                format != AUDIO_FORMAT_PCM_8_BIT) {
425da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent            return false;
426da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent        }
427e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    case AUDIO_FORMAT_MP3:
428e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    case AUDIO_FORMAT_AMR_NB:
429e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    case AUDIO_FORMAT_AMR_WB:
430e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    case AUDIO_FORMAT_AAC:
431e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    case AUDIO_FORMAT_HE_AAC_V1:
432e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    case AUDIO_FORMAT_HE_AAC_V2:
433e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    case AUDIO_FORMAT_VORBIS:
434e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return true;
435e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    default:
436e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin        return false;
437e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    }
438e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin}
439e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
440828bf0cdf4e869fa7bb007331670328c834f8277Glenn Kastenstatic inline bool audio_is_linear_pcm(audio_format_t format)
441e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{
442da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent    return ((format & AUDIO_FORMAT_MAIN_MASK) == AUDIO_FORMAT_PCM);
443da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent}
444da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent
445828bf0cdf4e869fa7bb007331670328c834f8277Glenn Kastenstatic inline size_t audio_bytes_per_sample(audio_format_t format)
446da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent{
447da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent    size_t size = 0;
448da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent
449e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    switch (format) {
450427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi    case AUDIO_FORMAT_PCM_32_BIT:
451427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi    case AUDIO_FORMAT_PCM_8_24_BIT:
452427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi        size = sizeof(int32_t);
453427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi        break;
454427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi    case AUDIO_FORMAT_PCM_16_BIT:
455427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi        size = sizeof(int16_t);
456427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi        break;
457427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi    case AUDIO_FORMAT_PCM_8_BIT:
458427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi        size = sizeof(uint8_t);
459427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi        break;
460427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi    default:
461427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi        break;
462e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin    }
463da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent    return size;
464e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin}
465e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
466e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin__END_DECLS
467e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin
468e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin#endif  // ANDROID_AUDIO_CORE_H
469