audio.h revision 0d580e83dd97b7f36869041cdc8f1af12dff8675
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 348ecc7afca42d0bb27aad25733790309f71f307d6Jeff Brown/* device address used to refer to the standard remote submix */ 358ecc7afca42d0bb27aad25733790309f71f307d6Jeff Brown#define AUDIO_REMOTE_SUBMIX_DEVICE_ADDRESS "0" 368ecc7afca42d0bb27aad25733790309f71f307d6Jeff Brown 371c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten/* AudioFlinger and AudioPolicy services use I/O handles to identify audio sources and sinks */ 38e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef int audio_io_handle_t; 391c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten#define AUDIO_IO_HANDLE_NONE 0 40e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 41e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* Audio stream types */ 42e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 431c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten /* These values must kept in sync with 441c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten * frameworks/base/media/java/android/media/AudioSystem.java 451c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten */ 46e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_DEFAULT = -1, 471c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten AUDIO_STREAM_MIN = 0, 48e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_VOICE_CALL = 0, 49e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_SYSTEM = 1, 50e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_RING = 2, 51e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_MUSIC = 3, 52e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_ALARM = 4, 53e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_NOTIFICATION = 5, 54e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_BLUETOOTH_SCO = 6, 55e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_ENFORCED_AUDIBLE = 7, /* Sounds that cannot be muted by user and must be routed to speaker */ 56e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_DTMF = 8, 57e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_TTS = 9, 58e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 59e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_CNT, 60e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_STREAM_MAX = AUDIO_STREAM_CNT - 1, 61e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_stream_type_t; 62e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 63e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* Do not change these values without updating their counterparts 640d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi * in frameworks/base/media/java/android/media/AudioAttributes.java 650d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi */ 660d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivitypedef enum { 670d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_CONTENT_TYPE_UNKNOWN = 0, 680d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_CONTENT_TYPE_SPEECH = 1, 690d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_CONTENT_TYPE_MUSIC = 2, 700d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_CONTENT_TYPE_MOVIE = 3, 710d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_CONTENT_TYPE_SONIFICATION = 4, 720d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi 730d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_CONTENT_TYPE_CNT, 740d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_CONTENT_TYPE_MAX = AUDIO_CONTENT_TYPE_CNT - 1, 750d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi} audio_content_type_t; 760d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi 770d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi/* Do not change these values without updating their counterparts 780d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi * in frameworks/base/media/java/android/media/AudioAttributes.java 790d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi */ 800d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivitypedef enum { 810d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_UNKNOWN = 0, 820d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_MEDIA = 1, 830d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_VOICE_COMMUNICATION = 2, 840d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_VOICE_COMMUNICATION_SIGNALLING = 3, 850d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_ALARM = 4, 860d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_NOTIFICATION = 5, 870d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_NOTIFICATION_TELEPHONY_RINGTONE = 6, 880d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_NOTIFICATION_COMMUNICATION_REQUEST = 7, 890d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_NOTIFICATION_COMMUNICATION_INSTANT = 8, 900d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_NOTIFICATION_COMMUNICATION_DELAYED = 9, 910d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_NOTIFICATION_EVENT = 10, 920d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY = 11, 930d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE = 12, 940d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_ASSISTANCE_SONIFICATION = 13, 950d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_GAME = 14, 960d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi 970d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_CNT, 980d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_USAGE_MAX = AUDIO_USAGE_CNT - 1, 990d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi} audio_usage_t; 1000d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi 1010d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivitypedef uint32_t audio_flags_mask_t; 1020d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi 1030d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi/* Do not change these values without updating their counterparts 1040d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi * in frameworks/base/media/java/android/media/AudioAttributes.java 1050d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi */ 1060d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivienum { 1070d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_FLAG_AUDIBILITY_ENFORCED = 0x1, 1080d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_FLAG_SECURE = 0x2, 1090d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi AUDIO_FLAG_SCO = 0x4, 1100d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi}; 1110d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi 1120d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi/* Do not change these values without updating their counterparts 1131c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten * in frameworks/base/media/java/android/media/MediaRecorder.java, 114c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood * frameworks/av/services/audiopolicy/AudioPolicyService.cpp, 1151c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten * and system/media/audio_effects/include/audio_effects/audio_effects_conf.h! 116e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */ 117e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 118e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SOURCE_DEFAULT = 0, 119e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SOURCE_MIC = 1, 120e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SOURCE_VOICE_UPLINK = 2, 121e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SOURCE_VOICE_DOWNLINK = 3, 122e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SOURCE_VOICE_CALL = 4, 123e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SOURCE_CAMCORDER = 5, 124e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SOURCE_VOICE_RECOGNITION = 6, 125e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SOURCE_VOICE_COMMUNICATION = 7, 126e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivi AUDIO_SOURCE_REMOTE_SUBMIX = 8, /* Source for the mix to be presented remotely. */ 127e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivi /* An example of remote presentation is Wifi Display */ 128e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivi /* where a dongle attached to a TV can be used to */ 129e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivi /* play the mix captured by this audio source. */ 130e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SOURCE_CNT, 131e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SOURCE_MAX = AUDIO_SOURCE_CNT - 1, 13204c12ca061cd4ffe79a8eb5d570c4830a0950c85Eric Laurent AUDIO_SOURCE_HOTWORD = 1999, /* A low-priority, preemptible audio source for 13304c12ca061cd4ffe79a8eb5d570c4830a0950c85Eric Laurent for background software hotword detection. 13404c12ca061cd4ffe79a8eb5d570c4830a0950c85Eric Laurent Same tuning as AUDIO_SOURCE_VOICE_RECOGNITION. 13504c12ca061cd4ffe79a8eb5d570c4830a0950c85Eric Laurent Used only internally to the framework. Not exposed 13604c12ca061cd4ffe79a8eb5d570c4830a0950c85Eric Laurent at the audio HAL. */ 137e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_source_t; 138e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 1390d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi/* Audio attributes */ 1400d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi#define AUDIO_ATTRIBUTES_TAGS_MAX_SIZE 256 1410d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivitypedef struct { 1420d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi audio_content_type_t content_type; 1430d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi audio_usage_t usage; 1440d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi audio_source_t source; 1450d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi audio_flags_mask_t flags; 1460d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi char tags[AUDIO_ATTRIBUTES_TAGS_MAX_SIZE]; /* UTF8 */ 1470d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi} audio_attributes_t; 1480d580e83dd97b7f36869041cdc8f1af12dff8675Jean-Michel Trivi 149e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* special audio session values 150e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * (XXX: should this be living in the audio effects land?) 151e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */ 152e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 153e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin /* session for effects attached to a particular output stream 154e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * (value must be less than 0) 155e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */ 156e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SESSION_OUTPUT_STAGE = -1, 157e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 158e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin /* session for effects applied to output mix. These effects can 159e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * be moved by audio policy manager to another output stream 160e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * (value must be 0) 161e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */ 162e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_SESSION_OUTPUT_MIX = 0, 163b4f2b4eac4b9ae3d8c7804c5902343c4235f81adGlenn Kasten 164b4f2b4eac4b9ae3d8c7804c5902343c4235f81adGlenn Kasten /* application does not specify an explicit session ID to be used, 165b4f2b4eac4b9ae3d8c7804c5902343c4235f81adGlenn Kasten * and requests a new session ID to be allocated 166b4f2b4eac4b9ae3d8c7804c5902343c4235f81adGlenn Kasten * TODO use unique values for AUDIO_SESSION_OUTPUT_MIX and AUDIO_SESSION_ALLOCATE, 167b4f2b4eac4b9ae3d8c7804c5902343c4235f81adGlenn Kasten * after all uses have been updated from 0 to the appropriate symbol, and have been tested. 168b4f2b4eac4b9ae3d8c7804c5902343c4235f81adGlenn Kasten */ 169b4f2b4eac4b9ae3d8c7804c5902343c4235f81adGlenn Kasten AUDIO_SESSION_ALLOCATE = 0, 170e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_session_t; 171e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 172e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* Audio sub formats (see enum audio_format). */ 173e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 174e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* PCM sub formats */ 175e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 176c0a51093a2604b27f7d78f88eecaea15ac744f2eGlenn Kasten /* All of these are in native byte order */ 1779714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent AUDIO_FORMAT_PCM_SUB_16_BIT = 0x1, /* DO NOT CHANGE - PCM signed 16 bits */ 1789714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent AUDIO_FORMAT_PCM_SUB_8_BIT = 0x2, /* DO NOT CHANGE - PCM unsigned 8 bits */ 1799714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent AUDIO_FORMAT_PCM_SUB_32_BIT = 0x3, /* PCM signed .31 fixed point */ 1809714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent AUDIO_FORMAT_PCM_SUB_8_24_BIT = 0x4, /* PCM signed 7.24 fixed point */ 1811c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten AUDIO_FORMAT_PCM_SUB_FLOAT = 0x5, /* PCM single-precision floating point */ 182c0a51093a2604b27f7d78f88eecaea15ac744f2eGlenn Kasten AUDIO_FORMAT_PCM_SUB_24_BIT_PACKED = 0x6, /* PCM signed .23 fixed point packed in 3 bytes */ 183e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_pcm_sub_fmt_t; 184e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 1851c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten/* The audio_format_*_sub_fmt_t declarations are not currently used */ 1861c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten 187e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* MP3 sub format field definition : can use 11 LSBs in the same way as MP3 188e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * frame header to specify bit rate, stereo mode, version... 189e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */ 190e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 191e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_MP3_SUB_NONE = 0x0, 192e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_mp3_sub_fmt_t; 193e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 194e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* AMR NB/WB sub format field definition: specify frame block interleaving, 195e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * bandwidth efficient or octet aligned, encoding mode for recording... 196e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */ 197e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 198e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_AMR_SUB_NONE = 0x0, 199e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_amr_sub_fmt_t; 200e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 201e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* AAC sub format field definition: specify profile or bitrate for recording... */ 202e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 203e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_AAC_SUB_NONE = 0x0, 204e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_aac_sub_fmt_t; 205e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 206e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin/* VORBIS sub format field definition: specify quality for recording... */ 207e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 208e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_VORBIS_SUB_NONE = 0x0, 209e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_vorbis_sub_fmt_t; 210e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 2111c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten/* Audio format consists of a main format field (upper 8 bits) and a sub format 212e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * field (lower 24 bits). 213e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * 214e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * The main format indicates the main codec type. The sub format field 215e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * indicates options and parameters for each format. The sub format is mainly 216e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * used for record to indicate for instance the requested bitrate or profile. 217e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * It can also be used for certain formats to give informations not present in 218e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin * the encoded audio stream (e.g. octet alignement for AMR). 219e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin */ 220e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 221e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_INVALID = 0xFFFFFFFFUL, 222e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_DEFAULT = 0, 223e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_PCM = 0x00000000UL, /* DO NOT CHANGE */ 224e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_MP3 = 0x01000000UL, 225e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_AMR_NB = 0x02000000UL, 226e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_AMR_WB = 0x03000000UL, 227e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_AAC = 0x04000000UL, 228e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_HE_AAC_V1 = 0x05000000UL, 229e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_HE_AAC_V2 = 0x06000000UL, 230e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_VORBIS = 0x07000000UL, 23176edb1c0e644fe9f0b9f93939647a34123a60063Vignesh Venkatasubramanian AUDIO_FORMAT_OPUS = 0x08000000UL, 232e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_MAIN_MASK = 0xFF000000UL, 233e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_SUB_MASK = 0x00FFFFFFUL, 234e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 235e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin /* Aliases */ 2361c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten /* note != AudioFormat.ENCODING_PCM_16BIT */ 237e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_PCM_16_BIT = (AUDIO_FORMAT_PCM | 238e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_PCM_SUB_16_BIT), 2391c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten /* note != AudioFormat.ENCODING_PCM_8BIT */ 240e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_PCM_8_BIT = (AUDIO_FORMAT_PCM | 241e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_FORMAT_PCM_SUB_8_BIT), 2429714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent AUDIO_FORMAT_PCM_32_BIT = (AUDIO_FORMAT_PCM | 2439714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent AUDIO_FORMAT_PCM_SUB_32_BIT), 2449714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent AUDIO_FORMAT_PCM_8_24_BIT = (AUDIO_FORMAT_PCM | 2459714b27bb41d999cb61b22833d3f253552b3c82bEric Laurent AUDIO_FORMAT_PCM_SUB_8_24_BIT), 2461c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten AUDIO_FORMAT_PCM_FLOAT = (AUDIO_FORMAT_PCM | 2471c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten AUDIO_FORMAT_PCM_SUB_FLOAT), 248c0a51093a2604b27f7d78f88eecaea15ac744f2eGlenn Kasten AUDIO_FORMAT_PCM_24_BIT_PACKED = (AUDIO_FORMAT_PCM | 249c0a51093a2604b27f7d78f88eecaea15ac744f2eGlenn Kasten AUDIO_FORMAT_PCM_SUB_24_BIT_PACKED), 250e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_format_t; 251e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 25216a7a0443a59c636ab20a3161ec630d037766eccGlenn Kastenenum { 2534cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_CHANNEL_NONE = 0x0, 254e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin /* output channels */ 2556d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_FRONT_LEFT = 0x1, 2566d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_FRONT_RIGHT = 0x2, 2576d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_FRONT_CENTER = 0x4, 2586d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_LOW_FREQUENCY = 0x8, 2596d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_BACK_LEFT = 0x10, 2606d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_BACK_RIGHT = 0x20, 2616d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_FRONT_LEFT_OF_CENTER = 0x40, 2626d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_FRONT_RIGHT_OF_CENTER = 0x80, 2636d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_BACK_CENTER = 0x100, 2646d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_SIDE_LEFT = 0x200, 2656d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_SIDE_RIGHT = 0x400, 2666d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_CENTER = 0x800, 2676d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_FRONT_LEFT = 0x1000, 2686d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_FRONT_CENTER = 0x2000, 2696d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_FRONT_RIGHT = 0x4000, 2706d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_BACK_LEFT = 0x8000, 2716d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_BACK_CENTER = 0x10000, 2726d4f39754bff9c1dcb8023839ea583b6d0723b14Jean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_BACK_RIGHT = 0x20000, 273e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 274e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_MONO = AUDIO_CHANNEL_OUT_FRONT_LEFT, 275e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_STEREO = (AUDIO_CHANNEL_OUT_FRONT_LEFT | 276e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_FRONT_RIGHT), 277e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_QUAD = (AUDIO_CHANNEL_OUT_FRONT_LEFT | 278e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_FRONT_RIGHT | 279e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_BACK_LEFT | 280e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_BACK_RIGHT), 281b8d59396dfb3b9135bb6dc869aa723ca618bd95dGlenn Kasten AUDIO_CHANNEL_OUT_QUAD_BACK = AUDIO_CHANNEL_OUT_QUAD, 282ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten /* like AUDIO_CHANNEL_OUT_QUAD_BACK with *_SIDE_* instead of *_BACK_* */ 283ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten AUDIO_CHANNEL_OUT_QUAD_SIDE = (AUDIO_CHANNEL_OUT_FRONT_LEFT | 284ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten AUDIO_CHANNEL_OUT_FRONT_RIGHT | 285ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten AUDIO_CHANNEL_OUT_SIDE_LEFT | 286ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten AUDIO_CHANNEL_OUT_SIDE_RIGHT), 287e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_5POINT1 = (AUDIO_CHANNEL_OUT_FRONT_LEFT | 288e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_FRONT_RIGHT | 289e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_FRONT_CENTER | 290e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_LOW_FREQUENCY | 291e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_BACK_LEFT | 292e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_BACK_RIGHT), 293b8d59396dfb3b9135bb6dc869aa723ca618bd95dGlenn Kasten AUDIO_CHANNEL_OUT_5POINT1_BACK = AUDIO_CHANNEL_OUT_5POINT1, 294ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten /* like AUDIO_CHANNEL_OUT_5POINT1_BACK with *_SIDE_* instead of *_BACK_* */ 295ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten AUDIO_CHANNEL_OUT_5POINT1_SIDE = (AUDIO_CHANNEL_OUT_FRONT_LEFT | 296ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten AUDIO_CHANNEL_OUT_FRONT_RIGHT | 297ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten AUDIO_CHANNEL_OUT_FRONT_CENTER | 298ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten AUDIO_CHANNEL_OUT_LOW_FREQUENCY | 299ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten AUDIO_CHANNEL_OUT_SIDE_LEFT | 300ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten AUDIO_CHANNEL_OUT_SIDE_RIGHT), 30133fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi // matches the correct AudioFormat.CHANNEL_OUT_7POINT1_SURROUND definition for 7.1 302e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_7POINT1 = (AUDIO_CHANNEL_OUT_FRONT_LEFT | 303e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_FRONT_RIGHT | 304e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_FRONT_CENTER | 305e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_LOW_FREQUENCY | 306e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_BACK_LEFT | 307e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_BACK_RIGHT | 30833fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_SIDE_LEFT | 30933fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_SIDE_RIGHT), 310e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_ALL = (AUDIO_CHANNEL_OUT_FRONT_LEFT | 311e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_FRONT_RIGHT | 312e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_FRONT_CENTER | 313e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_LOW_FREQUENCY | 314e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_BACK_LEFT | 315e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_BACK_RIGHT | 316e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_FRONT_LEFT_OF_CENTER | 317e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_OUT_FRONT_RIGHT_OF_CENTER | 31833fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_BACK_CENTER| 31933fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_SIDE_LEFT| 32033fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_SIDE_RIGHT| 32133fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_CENTER| 32233fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_FRONT_LEFT| 32333fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_FRONT_CENTER| 32433fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_FRONT_RIGHT| 32533fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_BACK_LEFT| 32633fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_BACK_CENTER| 32733fad99acfaffb775ce0792b06ba97bb6cacce1aJean-Michel Trivi AUDIO_CHANNEL_OUT_TOP_BACK_RIGHT), 328e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 329e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin /* input channels */ 330e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_LEFT = 0x4, 331e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_RIGHT = 0x8, 332e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_FRONT = 0x10, 333e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_BACK = 0x20, 334e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_LEFT_PROCESSED = 0x40, 335e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_RIGHT_PROCESSED = 0x80, 336e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_FRONT_PROCESSED = 0x100, 337e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_BACK_PROCESSED = 0x200, 338e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_PRESSURE = 0x400, 339e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_X_AXIS = 0x800, 340e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_Y_AXIS = 0x1000, 341e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_Z_AXIS = 0x2000, 342e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_VOICE_UPLINK = 0x4000, 343e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_VOICE_DNLINK = 0x8000, 344e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 345e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_MONO = AUDIO_CHANNEL_IN_FRONT, 346e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_STEREO = (AUDIO_CHANNEL_IN_LEFT | AUDIO_CHANNEL_IN_RIGHT), 3476c70ceeefe4cd2838b5788f6db8eb35751a5ce21Eric Laurent AUDIO_CHANNEL_IN_FRONT_BACK = (AUDIO_CHANNEL_IN_FRONT | AUDIO_CHANNEL_IN_BACK), 348e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_ALL = (AUDIO_CHANNEL_IN_LEFT | 349e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_RIGHT | 350e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_FRONT | 351e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_BACK| 352e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_LEFT_PROCESSED | 353e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_RIGHT_PROCESSED | 354e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_FRONT_PROCESSED | 355e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_BACK_PROCESSED| 356e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_PRESSURE | 357e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_X_AXIS | 358e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_Y_AXIS | 359e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_Z_AXIS | 360e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_VOICE_UPLINK | 361e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_CHANNEL_IN_VOICE_DNLINK), 3624ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi}; 3634ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi 364ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten/* A channel mask per se only defines the presence or absence of a channel, not the order. 365ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten * But see AUDIO_INTERLEAVE_* below for the platform convention of order. 366ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten */ 3674ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivitypedef uint32_t audio_channel_mask_t; 368e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 3691c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten/* Expresses the convention when stereo audio samples are stored interleaved 3701c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten * in an array. This should improve readability by allowing code to use 3711c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten * symbolic indices instead of hard-coded [0] and [1]. 372ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten * 373ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten * For multi-channel beyond stereo, the platform convention is that channels 374ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten * are interleaved in order from least significant channel mask bit 375ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten * to most significant channel mask bit, with unused bits skipped. 376ee7c17b7fc816393afcc7e8dbe751c55a512495bGlenn Kasten * Any exceptions to this convention will be noted at the appropriate API. 3771c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten */ 3781c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kastenenum { 3791c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten AUDIO_INTERLEAVE_LEFT = 0, 3801c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten AUDIO_INTERLEAVE_RIGHT = 1, 3811c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten}; 3821c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten 383e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 384e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_MODE_INVALID = -2, 385e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_MODE_CURRENT = -1, 386e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_MODE_NORMAL = 0, 387e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_MODE_RINGTONE = 1, 388e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_MODE_IN_CALL = 2, 389e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_MODE_IN_COMMUNICATION = 3, 390e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 391e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_MODE_CNT, 392e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_MODE_MAX = AUDIO_MODE_CNT - 1, 393e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_mode_t; 394e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 3951c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten/* This enum is deprecated */ 396e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavintypedef enum { 3971c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten AUDIO_IN_ACOUSTICS_NONE = 0, 398e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_IN_ACOUSTICS_AGC_ENABLE = 0x0001, 399e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_IN_ACOUSTICS_AGC_DISABLE = 0, 400e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_IN_ACOUSTICS_NS_ENABLE = 0x0002, 401e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_IN_ACOUSTICS_NS_DISABLE = 0, 402e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_IN_ACOUSTICS_TX_IIR_ENABLE = 0x0004, 403e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_IN_ACOUSTICS_TX_DISABLE = 0, 404e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} audio_in_acoustics_t; 405e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 40616a7a0443a59c636ab20a3161ec630d037766eccGlenn Kastenenum { 407eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_NONE = 0x0, 408eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent /* reserved bits */ 409eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_BIT_IN = 0x80000000, 410eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_BIT_DEFAULT = 0x40000000, 411e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin /* output devices */ 412e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_EARPIECE = 0x1, 413e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_SPEAKER = 0x2, 414e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_WIRED_HEADSET = 0x4, 415e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_WIRED_HEADPHONE = 0x8, 416e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_SCO = 0x10, 417e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 0x20, 418e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 0x40, 419e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_A2DP = 0x80, 420e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 0x100, 421e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 0x200, 422e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_AUX_DIGITAL = 0x400, 423abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_HDMI = AUDIO_DEVICE_OUT_AUX_DIGITAL, 4241c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten /* uses an analog connection (multiplexed over the USB connector pins for instance) */ 425e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET = 0x800, 426e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET = 0x1000, 4271c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten /* USB accessory mode: your Android device is a USB device and the dock is a USB host */ 42879f90bdc7de561aa31888948c0661568ccc33da1Eric Laurent AUDIO_DEVICE_OUT_USB_ACCESSORY = 0x2000, 4291c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten /* USB host mode: your Android device is a USB host and the dock is a USB device */ 43079f90bdc7de561aa31888948c0661568ccc33da1Eric Laurent AUDIO_DEVICE_OUT_USB_DEVICE = 0x4000, 431eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_OUT_REMOTE_SUBMIX = 0x8000, 432abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent /* Telephony voice TX path */ 433abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_TELEPHONY_TX = 0x10000, 434abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent /* Analog jack with line impedance detected */ 435abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_LINE = 0x20000, 436abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent /* HDMI Audio Return Channel */ 437abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_HDMI_ARC = 0x40000, 438abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent /* S/PDIF out */ 439abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_SPDIF = 0x80000, 440abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent /* FM transmitter out */ 441abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_FM = 0x100000, 442eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_OUT_DEFAULT = AUDIO_DEVICE_BIT_DEFAULT, 443e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_ALL = (AUDIO_DEVICE_OUT_EARPIECE | 444e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_SPEAKER | 445e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_WIRED_HEADSET | 446e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_WIRED_HEADPHONE | 447e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_SCO | 448e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET | 449e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT | 450e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_A2DP | 451e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | 452e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER | 453abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_HDMI | 454e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET | 455e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET | 45679f90bdc7de561aa31888948c0661568ccc33da1Eric Laurent AUDIO_DEVICE_OUT_USB_ACCESSORY | 45779f90bdc7de561aa31888948c0661568ccc33da1Eric Laurent AUDIO_DEVICE_OUT_USB_DEVICE | 458eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_OUT_REMOTE_SUBMIX | 459abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_TELEPHONY_TX | 460abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_LINE | 461abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_HDMI_ARC | 462abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_SPDIF | 463abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_OUT_FM | 464e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_DEFAULT), 465e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_ALL_A2DP = (AUDIO_DEVICE_OUT_BLUETOOTH_A2DP | 466e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | 467e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER), 468e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_ALL_SCO = (AUDIO_DEVICE_OUT_BLUETOOTH_SCO | 469e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET | 470e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT), 47179f90bdc7de561aa31888948c0661568ccc33da1Eric Laurent AUDIO_DEVICE_OUT_ALL_USB = (AUDIO_DEVICE_OUT_USB_ACCESSORY | 47279f90bdc7de561aa31888948c0661568ccc33da1Eric Laurent AUDIO_DEVICE_OUT_USB_DEVICE), 473e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 474e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin /* input devices */ 475eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_COMMUNICATION = AUDIO_DEVICE_BIT_IN | 0x1, 476eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_AMBIENT = AUDIO_DEVICE_BIT_IN | 0x2, 477eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_BUILTIN_MIC = AUDIO_DEVICE_BIT_IN | 0x4, 478eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET = AUDIO_DEVICE_BIT_IN | 0x8, 479eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_WIRED_HEADSET = AUDIO_DEVICE_BIT_IN | 0x10, 480eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_AUX_DIGITAL = AUDIO_DEVICE_BIT_IN | 0x20, 481abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_HDMI = AUDIO_DEVICE_IN_AUX_DIGITAL, 482abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent /* Telephony voice RX path */ 483eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_VOICE_CALL = AUDIO_DEVICE_BIT_IN | 0x40, 484abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_TELEPHONY_RX = AUDIO_DEVICE_IN_VOICE_CALL, 485eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_BACK_MIC = AUDIO_DEVICE_BIT_IN | 0x80, 486eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_REMOTE_SUBMIX = AUDIO_DEVICE_BIT_IN | 0x100, 487eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_ANLG_DOCK_HEADSET = AUDIO_DEVICE_BIT_IN | 0x200, 488eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_DGTL_DOCK_HEADSET = AUDIO_DEVICE_BIT_IN | 0x400, 489eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_USB_ACCESSORY = AUDIO_DEVICE_BIT_IN | 0x800, 490eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_USB_DEVICE = AUDIO_DEVICE_BIT_IN | 0x1000, 491abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent /* FM tuner input */ 492abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_FM_TUNER = AUDIO_DEVICE_BIT_IN | 0x2000, 493abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent /* TV tuner input */ 494abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_TV_TUNER = AUDIO_DEVICE_BIT_IN | 0x4000, 495abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent /* Analog jack with line impedance detected */ 496abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_LINE = AUDIO_DEVICE_BIT_IN | 0x8000, 497abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent /* S/PDIF in */ 498abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_SPDIF = AUDIO_DEVICE_BIT_IN | 0x10000, 499c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood AUDIO_DEVICE_IN_BLUETOOTH_A2DP = AUDIO_DEVICE_BIT_IN | 0x20000, 500eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_DEFAULT = AUDIO_DEVICE_BIT_IN | AUDIO_DEVICE_BIT_DEFAULT, 501e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 502e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_IN_ALL = (AUDIO_DEVICE_IN_COMMUNICATION | 503e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_IN_AMBIENT | 504e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_IN_BUILTIN_MIC | 505e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET | 506e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_IN_WIRED_HEADSET | 507abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_HDMI | 508abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_TELEPHONY_RX | 509e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_IN_BACK_MIC | 510eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_REMOTE_SUBMIX | 511eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_ANLG_DOCK_HEADSET | 512eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_DGTL_DOCK_HEADSET | 513eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_USB_ACCESSORY | 514eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent AUDIO_DEVICE_IN_USB_DEVICE | 515abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_FM_TUNER | 516abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_TV_TUNER | 517abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_LINE | 518abcb99927d9ad3f66288a5ce16d7c86c14b49249Eric Laurent AUDIO_DEVICE_IN_SPDIF | 519c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood AUDIO_DEVICE_IN_BLUETOOTH_A2DP | 520e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_IN_DEFAULT), 521e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin AUDIO_DEVICE_IN_ALL_SCO = AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET, 52200b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean AUDIO_DEVICE_IN_ALL_USB = (AUDIO_DEVICE_IN_USB_ACCESSORY | 52300b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean AUDIO_DEVICE_IN_USB_DEVICE), 52416a7a0443a59c636ab20a3161ec630d037766eccGlenn Kasten}; 52516a7a0443a59c636ab20a3161ec630d037766eccGlenn Kasten 52616a7a0443a59c636ab20a3161ec630d037766eccGlenn Kastentypedef uint32_t audio_devices_t; 527e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 528545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent/* the audio output flags serve two purposes: 529545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent * - when an AudioTrack is created they indicate a "wish" to be connected to an 530545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent * output stream with attributes corresponding to the specified flags 531545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent * - when present in an output profile descriptor listed for a particular audio 532545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent * hardware module, they indicate that an output stream can be opened that 533545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent * supports the attributes indicated by the flags. 534545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent * the audio policy manager will try to match the flags in the request 535545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent * (when getOuput() is called) to an available output stream. 536545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent */ 537545ab46063f083239b29e59b8b491656d93f2a38Eric Laurenttypedef enum { 5389aec362e76a60725df1a444214f222297caf46a2Eric Laurent AUDIO_OUTPUT_FLAG_NONE = 0x0, // no attributes 5399aec362e76a60725df1a444214f222297caf46a2Eric Laurent AUDIO_OUTPUT_FLAG_DIRECT = 0x1, // this output directly connects a track 5409aec362e76a60725df1a444214f222297caf46a2Eric Laurent // to one output stream: no software mixer 5419aec362e76a60725df1a444214f222297caf46a2Eric Laurent AUDIO_OUTPUT_FLAG_PRIMARY = 0x2, // this output is the primary output of 5429aec362e76a60725df1a444214f222297caf46a2Eric Laurent // the device. It is unique and must be 5439aec362e76a60725df1a444214f222297caf46a2Eric Laurent // present. It is opened by default and 5449aec362e76a60725df1a444214f222297caf46a2Eric Laurent // receives routing, audio mode and volume 5459aec362e76a60725df1a444214f222297caf46a2Eric Laurent // controls related to voice calls. 5469aec362e76a60725df1a444214f222297caf46a2Eric Laurent AUDIO_OUTPUT_FLAG_FAST = 0x4, // output supports "fast tracks", 5479aec362e76a60725df1a444214f222297caf46a2Eric Laurent // defined elsewhere 54805529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald AUDIO_OUTPUT_FLAG_DEEP_BUFFER = 0x8, // use deep audio buffers 54905529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald AUDIO_OUTPUT_FLAG_COMPRESS_OFFLOAD = 0x10, // offload playback of compressed 55005529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald // streams to hardware codec 55105529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald AUDIO_OUTPUT_FLAG_NON_BLOCKING = 0x20 // use non-blocking write 552545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent} audio_output_flags_t; 553545ab46063f083239b29e59b8b491656d93f2a38Eric Laurent 554c051ffd7c24bbe989c9e39c793c6bbbac3ee3effGlenn Kasten/* The audio input flags are analogous to audio output flags. 555c051ffd7c24bbe989c9e39c793c6bbbac3ee3effGlenn Kasten * Currently they are used only when an AudioRecord is created, 556c051ffd7c24bbe989c9e39c793c6bbbac3ee3effGlenn Kasten * to indicate a preference to be connected to an input stream with 557c051ffd7c24bbe989c9e39c793c6bbbac3ee3effGlenn Kasten * attributes corresponding to the specified flags. 558c051ffd7c24bbe989c9e39c793c6bbbac3ee3effGlenn Kasten */ 559c051ffd7c24bbe989c9e39c793c6bbbac3ee3effGlenn Kastentypedef enum { 560c051ffd7c24bbe989c9e39c793c6bbbac3ee3effGlenn Kasten AUDIO_INPUT_FLAG_NONE = 0x0, // no attributes 561c051ffd7c24bbe989c9e39c793c6bbbac3ee3effGlenn Kasten AUDIO_INPUT_FLAG_FAST = 0x1, // prefer an input that supports "fast tracks" 562c051ffd7c24bbe989c9e39c793c6bbbac3ee3effGlenn Kasten} audio_input_flags_t; 563c051ffd7c24bbe989c9e39c793c6bbbac3ee3effGlenn Kasten 56405529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald/* Additional information about compressed streams offloaded to 56505529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald * hardware playback 56605529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald * The version and size fields must be initialized by the caller by using 56705529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald * one of the constants defined here. 56805529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald */ 56905529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgeraldtypedef struct { 57005529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald uint16_t version; // version of the info structure 57105529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald uint16_t size; // total size of the structure including version and size 57205529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald uint32_t sample_rate; // sample rate in Hz 57305529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald audio_channel_mask_t channel_mask; // channel mask 57405529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald audio_format_t format; // audio format 57505529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald audio_stream_type_t stream_type; // stream type 57605529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald uint32_t bit_rate; // bit rate in bits per second 57705529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald int64_t duration_us; // duration in microseconds, -1 if unknown 57805529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald bool has_video; // true if stream is tied to a video stream 57905529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald bool is_streaming; // true if streaming, false if local playback 58005529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald} audio_offload_info_t; 58105529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald 58205529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald#define AUDIO_MAKE_OFFLOAD_INFO_VERSION(maj,min) \ 58305529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald ((((maj) & 0xff) << 8) | ((min) & 0xff)) 58405529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald 58505529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald#define AUDIO_OFFLOAD_INFO_VERSION_0_1 AUDIO_MAKE_OFFLOAD_INFO_VERSION(0, 1) 58605529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald#define AUDIO_OFFLOAD_INFO_VERSION_CURRENT AUDIO_OFFLOAD_INFO_VERSION_0_1 58705529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald 58805529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgeraldstatic const audio_offload_info_t AUDIO_INFO_INITIALIZER = { 58905529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald version: AUDIO_OFFLOAD_INFO_VERSION_CURRENT, 59005529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald size: sizeof(audio_offload_info_t), 5914887842c925f304dc862bdd5810f27cdd2eaedcbMark Salyzyn sample_rate: 0, 5924887842c925f304dc862bdd5810f27cdd2eaedcbMark Salyzyn channel_mask: 0, 5934887842c925f304dc862bdd5810f27cdd2eaedcbMark Salyzyn format: AUDIO_FORMAT_DEFAULT, 5944887842c925f304dc862bdd5810f27cdd2eaedcbMark Salyzyn stream_type: AUDIO_STREAM_VOICE_CALL, 5954887842c925f304dc862bdd5810f27cdd2eaedcbMark Salyzyn bit_rate: 0, 5964887842c925f304dc862bdd5810f27cdd2eaedcbMark Salyzyn duration_us: 0, 5974887842c925f304dc862bdd5810f27cdd2eaedcbMark Salyzyn has_video: false, 5984887842c925f304dc862bdd5810f27cdd2eaedcbMark Salyzyn is_streaming: false 59905529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald}; 60005529a1a10711d93745a9fcf07520f65a3eb4f3dRichard Fitzgerald 6014cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6024cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* audio hw module handle functions or structures referencing a module */ 6034cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurenttypedef int audio_module_handle_t; 6044cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6054cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/****************************** 6064cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * Volume control 6074cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent *****************************/ 6084cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6094cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* If the audio hardware supports gain control on some audio paths, 6104cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * the platform can expose them in the audio_policy.conf file. The audio HAL 6114cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * will then implement gain control functions that will use the following data 6124cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * structures. */ 6134cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6144cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* Type of gain control exposed by an audio port */ 6154cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_GAIN_MODE_JOINT 0x1 /* supports joint channel gain control */ 6164cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_GAIN_MODE_CHANNELS 0x2 /* supports separate channel gain control */ 6174cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_GAIN_MODE_RAMP 0x4 /* supports gain ramps */ 6184cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6194cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurenttypedef uint32_t audio_gain_mode_t; 6204cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6214cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6224cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* An audio_gain struct is a representation of a gain stage. 6234cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * A gain stage is always attached to an audio port. */ 6244cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_gain { 6254cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_gain_mode_t mode; /* e.g. AUDIO_GAIN_MODE_JOINT */ 6264cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_channel_mask_t channel_mask; /* channels which gain an be controlled. 6274cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent N/A if AUDIO_GAIN_MODE_CHANNELS is not supported */ 6284cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent int min_value; /* minimum gain value in millibels */ 6294cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent int max_value; /* maximum gain value in millibels */ 6304cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent int default_value; /* default gain value in millibels */ 6314cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int step_value; /* gain step in millibels */ 6324cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int min_ramp_ms; /* minimum ramp duration in ms */ 6334cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int max_ramp_ms; /* maximum ramp duration in ms */ 6344cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 6354cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6364cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* The gain configuration structure is used to get or set the gain values of a 6374cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * given port */ 6384cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_gain_config { 6394cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent int index; /* index of the corresponding audio_gain in the 6404cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_port gains[] table */ 6414cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_gain_mode_t mode; /* mode requested for this command */ 6424cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_channel_mask_t channel_mask; /* channels which gain value follows. 6434cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent N/A in joint mode */ 6444cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent int values[sizeof(audio_channel_mask_t)]; /* gain values in millibels for each 6454cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent channel ordered from LSb to MSb in channel mask. 6464cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent The number of values is 1 in joint mode or 6474cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent popcount(channel_mask) */ 6484cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int ramp_duration_ms; /* ramp duration in ms */ 6494cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 6504cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6514cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/****************************** 6524cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * Routing control 6534cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent *****************************/ 6544cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6554cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* Types defined here are used to describe an audio source or sink at internal 6564cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * framework interfaces (audio policy, patch panel) or at the audio HAL. 6574cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * Sink and sources are grouped in a concept of “audio port” representing an 6584cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * audio end point at the edge of the system managed by the module exposing 6594cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * the interface. */ 6604cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6614cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* Audio port role: either source or sink */ 6624cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurenttypedef enum { 6634cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_PORT_ROLE_NONE, 6644cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_PORT_ROLE_SOURCE, 6654cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_PORT_ROLE_SINK, 6664cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent} audio_port_role_t; 6674cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6684cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* Audio port type indicates if it is a session (e.g AudioTrack), 6694cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * a mix (e.g PlaybackThread output) or a physical device 6704cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * (e.g AUDIO_DEVICE_OUT_SPEAKER) */ 6714cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurenttypedef enum { 6724cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_PORT_TYPE_NONE, 6734cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_PORT_TYPE_DEVICE, 6744cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_PORT_TYPE_MIX, 6754cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_PORT_TYPE_SESSION, 6764cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent} audio_port_type_t; 6774cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6784cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* Each port has a unique ID or handle allocated by policy manager */ 6794cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurenttypedef int audio_port_handle_t; 6804cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PORT_HANDLE_NONE 0 6814cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6824cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6834cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* maximum audio device address length */ 6844cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_DEVICE_MAX_ADDRESS_LEN 32 6854cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6864cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* extension for audio port configuration structure when the audio port is a 6874cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * hardware device */ 6884cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_port_config_device_ext { 6894cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_module_handle_t hw_module; /* module the device is attached to */ 6904cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_devices_t type; /* device type (e.g AUDIO_DEVICE_OUT_SPEAKER) */ 6914cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent char address[AUDIO_DEVICE_MAX_ADDRESS_LEN]; /* device address. "" if N/A */ 6924cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 6934cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 6944cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* extension for audio port configuration structure when the audio port is a 6954cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * sub mix */ 6964cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_port_config_mix_ext { 6974cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_module_handle_t hw_module; /* module the stream is attached to */ 6984cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_io_handle_t handle; /* I/O handle of the input/output stream */ 6994cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent union { 7004cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent //TODO: change use case for output streams: use strategy and mixer attributes 7014cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_stream_type_t stream; 7024cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_source_t source; 7034cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent } usecase; 7044cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 7054cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7064cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* extension for audio port configuration structure when the audio port is an 7074cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * audio session */ 7084cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_port_config_session_ext { 7094cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_session_t session; /* audio session */ 7104cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 7114cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7124cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* Flags indicating which fields are to be considered in struct audio_port_config */ 7134cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PORT_CONFIG_SAMPLE_RATE 0x1 7144cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PORT_CONFIG_CHANNEL_MASK 0x2 7154cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PORT_CONFIG_FORMAT 0x4 7164cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PORT_CONFIG_GAIN 0x8 7174cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PORT_CONFIG_ALL (AUDIO_PORT_CONFIG_SAMPLE_RATE | \ 7184cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_PORT_CONFIG_CHANNEL_MASK | \ 7194cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_PORT_CONFIG_FORMAT | \ 7204cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_PORT_CONFIG_GAIN) 7214cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7224cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* audio port configuration structure used to specify a particular configuration of 7234cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * an audio port */ 7244cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_port_config { 7254cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_port_handle_t id; /* port unique ID */ 7264cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_port_role_t role; /* sink or source */ 7274cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_port_type_t type; /* device, mix ... */ 7284cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int config_mask; /* e.g AUDIO_PORT_CONFIG_ALL */ 7294cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int sample_rate; /* sampling rate in Hz */ 7304cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_channel_mask_t channel_mask; /* channel mask if applicable */ 7314cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_format_t format; /* format if applicable */ 7324cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_gain_config gain; /* gain to apply if applicable */ 7334cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent union { 7344cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_port_config_device_ext device; /* device specific info */ 7354cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_port_config_mix_ext mix; /* mix specific info */ 7364cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_port_config_session_ext session; /* session specific info */ 7374cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent } ext; 7384cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 7394cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7404cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7414cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* max number of sampling rates in audio port */ 7424cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PORT_MAX_SAMPLING_RATES 16 7434cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* max number of channel masks in audio port */ 7444cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PORT_MAX_CHANNEL_MASKS 16 7454cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* max number of audio formats in audio port */ 7464cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PORT_MAX_FORMATS 16 7474cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* max number of gain controls in audio port */ 7484cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PORT_MAX_GAINS 16 7494cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7504cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* extension for audio port structure when the audio port is a hardware device */ 7514cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_port_device_ext { 7524cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_module_handle_t hw_module; /* module the device is attached to */ 7534cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_devices_t type; /* device type (e.g AUDIO_DEVICE_OUT_SPEAKER) */ 7544cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent char address[AUDIO_DEVICE_MAX_ADDRESS_LEN]; 7554cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 7564cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7574cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* Latency class of the audio mix */ 7584cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurenttypedef enum { 7594cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_LATENCY_LOW, 7604cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent AUDIO_LATENCY_NORMAL, 7614cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent} audio_mix_latency_class_t; 7624cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7634cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* extension for audio port structure when the audio port is a sub mix */ 7644cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_port_mix_ext { 7654cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_module_handle_t hw_module; /* module the stream is attached to */ 7664cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_io_handle_t handle; /* I/O handle of the input.output stream */ 7674cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_mix_latency_class_t latency_class; /* latency class */ 7684cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent // other attributes: routing strategies 7694cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 7704cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7714cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* extension for audio port structure when the audio port is an audio session */ 7724cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_port_session_ext { 7734cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_session_t session; /* audio session */ 7744cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 7754cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7764cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7774cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_port { 7784cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_port_handle_t id; /* port unique ID */ 7794cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_port_role_t role; /* sink or source */ 7804cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_port_type_t type; /* device, mix ... */ 7814cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int num_sample_rates; /* number of sampling rates in following array */ 7824cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int sample_rates[AUDIO_PORT_MAX_SAMPLING_RATES]; 7834cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int num_channel_masks; /* number of channel masks in following array */ 7844cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_channel_mask_t channel_masks[AUDIO_PORT_MAX_CHANNEL_MASKS]; 7854cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int num_formats; /* number of formats in following array */ 7864cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_format_t formats[AUDIO_PORT_MAX_FORMATS]; 7874cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int num_gains; /* number of gains in following array */ 7884cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_gain gains[AUDIO_PORT_MAX_GAINS]; 7894cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_port_config active_config; /* current audio port configuration */ 7904cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent union { 7914cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_port_device_ext device; 7924cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_port_mix_ext mix; 7934cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_port_session_ext session; 7944cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent } ext; 7954cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 7964cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 7974cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent/* An audio patch represents a connection between one or more source ports and 7984cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * one or more sink ports. Patches are connected and disconnected by audio policy manager or by 7994cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * applications via framework APIs. 8004cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * Each patch is identified by a handle at the interface used to create that patch. For instance, 8014cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * when a patch is created by the audio HAL, the HAL allocates and returns a handle. 8024cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * This handle is unique to a given audio HAL hardware module. 8034cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * But the same patch receives another system wide unique handle allocated by the framework. 8044cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent * This unique handle is used for all transactions inside the framework. 8054cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent */ 8064cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurenttypedef int audio_patch_handle_t; 8074cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PATCH_HANDLE_NONE 0 8084cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 8094cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent#define AUDIO_PATCH_PORTS_MAX 16 8104cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 8114cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurentstruct audio_patch { 8124cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent audio_patch_handle_t id; /* patch unique ID */ 8134cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int num_sources; /* number of sources in following array */ 8144cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_port_config sources[AUDIO_PATCH_PORTS_MAX]; 8154cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent unsigned int num_sinks; /* number of sinks in following array */ 8164cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent struct audio_port_config sinks[AUDIO_PATCH_PORTS_MAX]; 8174cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent}; 8184cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 8194cd050121fd22c0f7277a988d548d0e8f327a760Eric Laurent 820e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavinstatic inline bool audio_is_output_device(audio_devices_t device) 821e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{ 822eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent if (((device & AUDIO_DEVICE_BIT_IN) == 0) && 823eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent (popcount(device) == 1) && ((device & ~AUDIO_DEVICE_OUT_ALL) == 0)) 824e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin return true; 825e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin else 826e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin return false; 827e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} 828e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 829e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavinstatic inline bool audio_is_input_device(audio_devices_t device) 830e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{ 831eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent if ((device & AUDIO_DEVICE_BIT_IN) != 0) { 832eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent device &= ~AUDIO_DEVICE_BIT_IN; 833eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent if ((popcount(device) == 1) && ((device & ~AUDIO_DEVICE_IN_ALL) == 0)) 834eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent return true; 835eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent } 836eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent return false; 837e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} 838e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 839eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurentstatic inline bool audio_is_output_devices(audio_devices_t device) 840eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent{ 841eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent return (device & AUDIO_DEVICE_BIT_IN) == 0; 842eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent} 843eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent 844c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwoodstatic inline bool audio_is_a2dp_in_device(audio_devices_t device) 845c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood{ 846c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood if ((device & AUDIO_DEVICE_BIT_IN) != 0) { 847c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood device &= ~AUDIO_DEVICE_BIT_IN; 848c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood if ((popcount(device) == 1) && (device & AUDIO_DEVICE_IN_BLUETOOTH_A2DP)) 849c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood return true; 850c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood } 851c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood return false; 852c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood} 853eeeee802e9837c592b0f0f9fd183bcaa9e77732eEric Laurent 854c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwoodstatic inline bool audio_is_a2dp_out_device(audio_devices_t device) 855e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{ 856e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin if ((popcount(device) == 1) && (device & AUDIO_DEVICE_OUT_ALL_A2DP)) 857e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin return true; 858e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin else 859e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin return false; 860e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} 861e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 862c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood// Deprecated - use audio_is_a2dp_out_device() instead 863c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwoodstatic inline bool audio_is_a2dp_device(audio_devices_t device) 864c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood{ 865c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood return audio_is_a2dp_out_device(device); 866c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood} 867c8183af4b3a3515f8f0cff27b2808a7139f18230Mike Lockwood 868e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavinstatic inline bool audio_is_bluetooth_sco_device(audio_devices_t device) 869e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{ 870b526630ab843f9a405be23618d5808d8e65755f3Eric Laurent if ((device & AUDIO_DEVICE_BIT_IN) == 0) { 871b526630ab843f9a405be23618d5808d8e65755f3Eric Laurent if ((popcount(device) == 1) && ((device & ~AUDIO_DEVICE_OUT_ALL_SCO) == 0)) 872b526630ab843f9a405be23618d5808d8e65755f3Eric Laurent return true; 873b526630ab843f9a405be23618d5808d8e65755f3Eric Laurent } else { 874b526630ab843f9a405be23618d5808d8e65755f3Eric Laurent device &= ~AUDIO_DEVICE_BIT_IN; 875b526630ab843f9a405be23618d5808d8e65755f3Eric Laurent if ((popcount(device) == 1) && ((device & ~AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET) == 0)) 876b526630ab843f9a405be23618d5808d8e65755f3Eric Laurent return true; 877b526630ab843f9a405be23618d5808d8e65755f3Eric Laurent } 878b526630ab843f9a405be23618d5808d8e65755f3Eric Laurent 879b526630ab843f9a405be23618d5808d8e65755f3Eric Laurent return false; 880e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} 881e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 88200b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLeanstatic inline bool audio_is_usb_out_device(audio_devices_t device) 88300b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean{ 88400b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean return ((popcount(device) == 1) && (device & AUDIO_DEVICE_OUT_ALL_USB)); 88500b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean} 88600b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean 88700b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLeanstatic inline bool audio_is_usb_in_device(audio_devices_t device) 88800b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean{ 88900b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean if ((device & AUDIO_DEVICE_BIT_IN) != 0) { 89000b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean device &= ~AUDIO_DEVICE_BIT_IN; 89100b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean if (popcount(device) == 1 && (device & AUDIO_DEVICE_IN_ALL_USB) != 0) 89200b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean return true; 89300b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean } 89400b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean return false; 89500b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean} 89600b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean 89700b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean/* OBSOLETE - use audio_is_usb_out_device() instead. */ 89879f90bdc7de561aa31888948c0661568ccc33da1Eric Laurentstatic inline bool audio_is_usb_device(audio_devices_t device) 89979f90bdc7de561aa31888948c0661568ccc33da1Eric Laurent{ 90000b8972062fb32dd02bcac7821a6612ce27ebd86Paul McLean return audio_is_usb_out_device(device); 90179f90bdc7de561aa31888948c0661568ccc33da1Eric Laurent} 90279f90bdc7de561aa31888948c0661568ccc33da1Eric Laurent 903e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivistatic inline bool audio_is_remote_submix_device(audio_devices_t device) 904e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivi{ 9058ecc7afca42d0bb27aad25733790309f71f307d6Jeff Brown if ((device & AUDIO_DEVICE_OUT_REMOTE_SUBMIX) == AUDIO_DEVICE_OUT_REMOTE_SUBMIX 9068ecc7afca42d0bb27aad25733790309f71f307d6Jeff Brown || (device & AUDIO_DEVICE_IN_REMOTE_SUBMIX) == AUDIO_DEVICE_IN_REMOTE_SUBMIX) 907e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivi return true; 908e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivi else 909e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivi return false; 910e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivi} 911e11866a8799a2357b82c9217c8d6b726726f23feJean-Michel Trivi 912f7326dc0aa2da2df6bf1fa1ae7ef259a0ebdbd7bGlenn Kastenstatic inline bool audio_is_input_channel(audio_channel_mask_t channel) 913e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{ 914e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin if ((channel & ~AUDIO_CHANNEL_IN_ALL) == 0) 915f7326dc0aa2da2df6bf1fa1ae7ef259a0ebdbd7bGlenn Kasten return channel != 0; 916e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin else 917e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin return false; 918e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} 919e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 920f7326dc0aa2da2df6bf1fa1ae7ef259a0ebdbd7bGlenn Kastenstatic inline bool audio_is_output_channel(audio_channel_mask_t channel) 921e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{ 922e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin if ((channel & ~AUDIO_CHANNEL_OUT_ALL) == 0) 923f7326dc0aa2da2df6bf1fa1ae7ef259a0ebdbd7bGlenn Kasten return channel != 0; 924e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin else 925e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin return false; 926e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} 927e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 928a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung/* Returns the number of channels from an input channel mask, 929a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung * used in the context of audio input or recording. 930a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung */ 931a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hungstatic inline uint32_t audio_channel_count_from_in_mask(audio_channel_mask_t channel) 932a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung{ 933a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung return popcount(channel & AUDIO_CHANNEL_IN_ALL); 934a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung} 935a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung 936a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung/* Returns the number of channels from an output channel mask, 937a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung * used in the context of audio output or playback. 938a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung */ 939a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hungstatic inline uint32_t audio_channel_count_from_out_mask(audio_channel_mask_t channel) 940a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung{ 941a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung return popcount(channel & AUDIO_CHANNEL_OUT_ALL); 942a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung} 943a7e8f8615d357357712660d1ed3863c274c2c7bbAndy Hung 94489f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten/* Derive an output channel mask from a channel count. 9454ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * This is to be used when the content channel mask is unknown. The 1, 2, 4, 5, 6, 7 and 8 channel 9464ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * cases are mapped to the standard game/home-theater layouts, but note that 4 is mapped to quad, 9474ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * and not stereo + FC + mono surround. A channel count of 3 is arbitrarily mapped to stereo + FC 9484ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * for continuity with stereo. 9494ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * Returns the matching channel mask, or 0 if the number of channels exceeds that of the 9504ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi * configurations for which a default channel mask is defined. 9514ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi */ 95289f7ba3df8fc359023b494c2e625beed900bc706Glenn Kastenstatic inline audio_channel_mask_t audio_channel_out_mask_from_count(uint32_t channel_count) 9534ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi{ 9541c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten switch (channel_count) { 9554ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi case 1: 9564ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi return AUDIO_CHANNEL_OUT_MONO; 9574ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi case 2: 9584ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi return AUDIO_CHANNEL_OUT_STEREO; 9594ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi case 3: 9604ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi return (AUDIO_CHANNEL_OUT_STEREO | AUDIO_CHANNEL_OUT_FRONT_CENTER); 9614ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi case 4: // 4.0 9624ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi return AUDIO_CHANNEL_OUT_QUAD; 9634ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi case 5: // 5.0 9644ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi return (AUDIO_CHANNEL_OUT_QUAD | AUDIO_CHANNEL_OUT_FRONT_CENTER); 9654ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi case 6: // 5.1 9664ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi return AUDIO_CHANNEL_OUT_5POINT1; 9674ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi case 7: // 6.1 9684ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi return (AUDIO_CHANNEL_OUT_5POINT1 | AUDIO_CHANNEL_OUT_BACK_CENTER); 9694ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi case 8: 9704ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi return AUDIO_CHANNEL_OUT_7POINT1; 9714ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi default: 9724ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi return 0; 9734ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi } 9744ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi} 9754ab051ab4613f2622dc3f3f0f57bb34d8a40a6a9Jean-Michel Trivi 97689f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten/* Similar to above, but for input. Currently handles only mono and stereo. */ 97789f7ba3df8fc359023b494c2e625beed900bc706Glenn Kastenstatic inline audio_channel_mask_t audio_channel_in_mask_from_count(uint32_t channel_count) 97889f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten{ 97989f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten switch (channel_count) { 98089f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten case 1: 98189f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten return AUDIO_CHANNEL_IN_MONO; 98289f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten case 2: 98389f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten return AUDIO_CHANNEL_IN_STEREO; 98489f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten default: 98589f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten return 0; 98689f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten } 98789f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten} 98889f7ba3df8fc359023b494c2e625beed900bc706Glenn Kasten 989828bf0cdf4e869fa7bb007331670328c834f8277Glenn Kastenstatic inline bool audio_is_valid_format(audio_format_t format) 990e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{ 991e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin switch (format & AUDIO_FORMAT_MAIN_MASK) { 992e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin case AUDIO_FORMAT_PCM: 99345b9581fc9884da4bf60203ece1563e29aac8c96Glenn Kasten switch (format) { 99445b9581fc9884da4bf60203ece1563e29aac8c96Glenn Kasten case AUDIO_FORMAT_PCM_16_BIT: 99545b9581fc9884da4bf60203ece1563e29aac8c96Glenn Kasten case AUDIO_FORMAT_PCM_8_BIT: 99645b9581fc9884da4bf60203ece1563e29aac8c96Glenn Kasten case AUDIO_FORMAT_PCM_32_BIT: 99745b9581fc9884da4bf60203ece1563e29aac8c96Glenn Kasten case AUDIO_FORMAT_PCM_8_24_BIT: 99845b9581fc9884da4bf60203ece1563e29aac8c96Glenn Kasten case AUDIO_FORMAT_PCM_FLOAT: 99945b9581fc9884da4bf60203ece1563e29aac8c96Glenn Kasten case AUDIO_FORMAT_PCM_24_BIT_PACKED: 100045b9581fc9884da4bf60203ece1563e29aac8c96Glenn Kasten return true; 100145b9581fc9884da4bf60203ece1563e29aac8c96Glenn Kasten default: 1002da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent return false; 1003da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent } 100445b9581fc9884da4bf60203ece1563e29aac8c96Glenn Kasten /* not reached */ 1005e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin case AUDIO_FORMAT_MP3: 1006e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin case AUDIO_FORMAT_AMR_NB: 1007e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin case AUDIO_FORMAT_AMR_WB: 1008e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin case AUDIO_FORMAT_AAC: 1009e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin case AUDIO_FORMAT_HE_AAC_V1: 1010e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin case AUDIO_FORMAT_HE_AAC_V2: 1011e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin case AUDIO_FORMAT_VORBIS: 1012e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin return true; 1013e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin default: 1014e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin return false; 1015e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin } 1016e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} 1017e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 1018828bf0cdf4e869fa7bb007331670328c834f8277Glenn Kastenstatic inline bool audio_is_linear_pcm(audio_format_t format) 1019e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin{ 1020da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent return ((format & AUDIO_FORMAT_MAIN_MASK) == AUDIO_FORMAT_PCM); 1021da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent} 1022da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent 1023828bf0cdf4e869fa7bb007331670328c834f8277Glenn Kastenstatic inline size_t audio_bytes_per_sample(audio_format_t format) 1024da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent{ 1025da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent size_t size = 0; 1026da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent 1027e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin switch (format) { 1028427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi case AUDIO_FORMAT_PCM_32_BIT: 1029427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi case AUDIO_FORMAT_PCM_8_24_BIT: 1030427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi size = sizeof(int32_t); 1031427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi break; 1032173f4995b075e67abdb1874da9f6e83fd7324a5eAndy Hung case AUDIO_FORMAT_PCM_24_BIT_PACKED: 1033173f4995b075e67abdb1874da9f6e83fd7324a5eAndy Hung size = sizeof(uint8_t) * 3; 1034173f4995b075e67abdb1874da9f6e83fd7324a5eAndy Hung break; 1035427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi case AUDIO_FORMAT_PCM_16_BIT: 1036427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi size = sizeof(int16_t); 1037427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi break; 1038427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi case AUDIO_FORMAT_PCM_8_BIT: 1039427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi size = sizeof(uint8_t); 1040427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi break; 10411c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten case AUDIO_FORMAT_PCM_FLOAT: 10421c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten size = sizeof(float); 10431c3e16fb40780c010f35119cdf782e6fcb7ce017Glenn Kasten break; 1044427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi default: 1045427d2b43c23c48aedadca008482f495145411e2bJean-Michel Trivi break; 1046e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin } 1047da382248758eacd9f91d6f0a50dff3f021791c24Eric Laurent return size; 1048e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin} 1049e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 1050e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin__END_DECLS 1051e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin 1052e8e4be57aa45f621d231a40801a4dea877be09d5Dima Zavin#endif // ANDROID_AUDIO_CORE_H 1053