| /* |
| * Copyright (C) 2011 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| |
| #ifndef ANDROID_AUDIO_CORE_H |
| #define ANDROID_AUDIO_CORE_H |
| |
| #include <stdbool.h> |
| #include <stdint.h> |
| #include <sys/cdefs.h> |
| #include <sys/types.h> |
| |
| #include <cutils/bitops.h> |
| |
| __BEGIN_DECLS |
| |
| /* The enums were moved here mostly from |
| * frameworks/base/include/media/AudioSystem.h |
| */ |
| |
| typedef int audio_io_handle_t; |
| |
| /* Audio stream types */ |
| typedef enum { |
| AUDIO_STREAM_DEFAULT = -1, |
| AUDIO_STREAM_VOICE_CALL = 0, |
| AUDIO_STREAM_SYSTEM = 1, |
| AUDIO_STREAM_RING = 2, |
| AUDIO_STREAM_MUSIC = 3, |
| AUDIO_STREAM_ALARM = 4, |
| AUDIO_STREAM_NOTIFICATION = 5, |
| AUDIO_STREAM_BLUETOOTH_SCO = 6, |
| AUDIO_STREAM_ENFORCED_AUDIBLE = 7, /* Sounds that cannot be muted by user and must be routed to speaker */ |
| AUDIO_STREAM_DTMF = 8, |
| AUDIO_STREAM_TTS = 9, |
| |
| AUDIO_STREAM_CNT, |
| AUDIO_STREAM_MAX = AUDIO_STREAM_CNT - 1, |
| } audio_stream_type_t; |
| |
| /* Do not change these values without updating their counterparts |
| * in media/java/android/media/MediaRecorder.java! |
| */ |
| typedef enum { |
| AUDIO_SOURCE_DEFAULT = 0, |
| AUDIO_SOURCE_MIC = 1, |
| AUDIO_SOURCE_VOICE_UPLINK = 2, |
| AUDIO_SOURCE_VOICE_DOWNLINK = 3, |
| AUDIO_SOURCE_VOICE_CALL = 4, |
| AUDIO_SOURCE_CAMCORDER = 5, |
| AUDIO_SOURCE_VOICE_RECOGNITION = 6, |
| AUDIO_SOURCE_VOICE_COMMUNICATION = 7, |
| |
| AUDIO_SOURCE_CNT, |
| AUDIO_SOURCE_MAX = AUDIO_SOURCE_CNT - 1, |
| } audio_source_t; |
| |
| /* special audio session values |
| * (XXX: should this be living in the audio effects land?) |
| */ |
| typedef enum { |
| /* session for effects attached to a particular output stream |
| * (value must be less than 0) |
| */ |
| AUDIO_SESSION_OUTPUT_STAGE = -1, |
| |
| /* session for effects applied to output mix. These effects can |
| * be moved by audio policy manager to another output stream |
| * (value must be 0) |
| */ |
| AUDIO_SESSION_OUTPUT_MIX = 0, |
| } audio_session_t; |
| |
| /* Audio sub formats (see enum audio_format). */ |
| |
| /* PCM sub formats */ |
| typedef enum { |
| AUDIO_FORMAT_PCM_SUB_16_BIT = 0x1, /* DO NOT CHANGE - PCM signed 16 bits */ |
| AUDIO_FORMAT_PCM_SUB_8_BIT = 0x2, /* DO NOT CHANGE - PCM unsigned 8 bits */ |
| AUDIO_FORMAT_PCM_SUB_32_BIT = 0x3, /* PCM signed .31 fixed point */ |
| AUDIO_FORMAT_PCM_SUB_8_24_BIT = 0x4, /* PCM signed 7.24 fixed point */ |
| } audio_format_pcm_sub_fmt_t; |
| |
| /* MP3 sub format field definition : can use 11 LSBs in the same way as MP3 |
| * frame header to specify bit rate, stereo mode, version... |
| */ |
| typedef enum { |
| AUDIO_FORMAT_MP3_SUB_NONE = 0x0, |
| } audio_format_mp3_sub_fmt_t; |
| |
| /* AMR NB/WB sub format field definition: specify frame block interleaving, |
| * bandwidth efficient or octet aligned, encoding mode for recording... |
| */ |
| typedef enum { |
| AUDIO_FORMAT_AMR_SUB_NONE = 0x0, |
| } audio_format_amr_sub_fmt_t; |
| |
| /* AAC sub format field definition: specify profile or bitrate for recording... */ |
| typedef enum { |
| AUDIO_FORMAT_AAC_SUB_NONE = 0x0, |
| } audio_format_aac_sub_fmt_t; |
| |
| /* VORBIS sub format field definition: specify quality for recording... */ |
| typedef enum { |
| AUDIO_FORMAT_VORBIS_SUB_NONE = 0x0, |
| } audio_format_vorbis_sub_fmt_t; |
| |
| /* Audio format consists in a main format field (upper 8 bits) and a sub format |
| * field (lower 24 bits). |
| * |
| * The main format indicates the main codec type. The sub format field |
| * indicates options and parameters for each format. The sub format is mainly |
| * used for record to indicate for instance the requested bitrate or profile. |
| * It can also be used for certain formats to give informations not present in |
| * the encoded audio stream (e.g. octet alignement for AMR). |
| */ |
| typedef enum { |
| AUDIO_FORMAT_INVALID = 0xFFFFFFFFUL, |
| AUDIO_FORMAT_DEFAULT = 0, |
| AUDIO_FORMAT_PCM = 0x00000000UL, /* DO NOT CHANGE */ |
| AUDIO_FORMAT_MP3 = 0x01000000UL, |
| AUDIO_FORMAT_AMR_NB = 0x02000000UL, |
| AUDIO_FORMAT_AMR_WB = 0x03000000UL, |
| AUDIO_FORMAT_AAC = 0x04000000UL, |
| AUDIO_FORMAT_HE_AAC_V1 = 0x05000000UL, |
| AUDIO_FORMAT_HE_AAC_V2 = 0x06000000UL, |
| AUDIO_FORMAT_VORBIS = 0x07000000UL, |
| AUDIO_FORMAT_MAIN_MASK = 0xFF000000UL, |
| AUDIO_FORMAT_SUB_MASK = 0x00FFFFFFUL, |
| |
| /* Aliases */ |
| AUDIO_FORMAT_PCM_16_BIT = (AUDIO_FORMAT_PCM | |
| AUDIO_FORMAT_PCM_SUB_16_BIT), |
| AUDIO_FORMAT_PCM_8_BIT = (AUDIO_FORMAT_PCM | |
| AUDIO_FORMAT_PCM_SUB_8_BIT), |
| AUDIO_FORMAT_PCM_32_BIT = (AUDIO_FORMAT_PCM | |
| AUDIO_FORMAT_PCM_SUB_32_BIT), |
| AUDIO_FORMAT_PCM_8_24_BIT = (AUDIO_FORMAT_PCM | |
| AUDIO_FORMAT_PCM_SUB_8_24_BIT), |
| } audio_format_t; |
| |
| typedef enum { |
| /* output channels */ |
| AUDIO_CHANNEL_OUT_FRONT_LEFT = 0x1, |
| AUDIO_CHANNEL_OUT_FRONT_RIGHT = 0x2, |
| AUDIO_CHANNEL_OUT_FRONT_CENTER = 0x4, |
| AUDIO_CHANNEL_OUT_LOW_FREQUENCY = 0x8, |
| AUDIO_CHANNEL_OUT_BACK_LEFT = 0x10, |
| AUDIO_CHANNEL_OUT_BACK_RIGHT = 0x20, |
| AUDIO_CHANNEL_OUT_FRONT_LEFT_OF_CENTER = 0x40, |
| AUDIO_CHANNEL_OUT_FRONT_RIGHT_OF_CENTER = 0x80, |
| AUDIO_CHANNEL_OUT_BACK_CENTER = 0x100, |
| AUDIO_CHANNEL_OUT_SIDE_LEFT = 0x200, |
| AUDIO_CHANNEL_OUT_SIDE_RIGHT = 0x400, |
| AUDIO_CHANNEL_OUT_TOP_CENTER = 0x800, |
| AUDIO_CHANNEL_OUT_TOP_FRONT_LEFT = 0x1000, |
| AUDIO_CHANNEL_OUT_TOP_FRONT_CENTER = 0x2000, |
| AUDIO_CHANNEL_OUT_TOP_FRONT_RIGHT = 0x4000, |
| AUDIO_CHANNEL_OUT_TOP_BACK_LEFT = 0x8000, |
| AUDIO_CHANNEL_OUT_TOP_BACK_CENTER = 0x10000, |
| AUDIO_CHANNEL_OUT_TOP_BACK_RIGHT = 0x20000, |
| |
| AUDIO_CHANNEL_OUT_MONO = AUDIO_CHANNEL_OUT_FRONT_LEFT, |
| AUDIO_CHANNEL_OUT_STEREO = (AUDIO_CHANNEL_OUT_FRONT_LEFT | |
| AUDIO_CHANNEL_OUT_FRONT_RIGHT), |
| AUDIO_CHANNEL_OUT_QUAD = (AUDIO_CHANNEL_OUT_FRONT_LEFT | |
| AUDIO_CHANNEL_OUT_FRONT_RIGHT | |
| AUDIO_CHANNEL_OUT_BACK_LEFT | |
| AUDIO_CHANNEL_OUT_BACK_RIGHT), |
| AUDIO_CHANNEL_OUT_SURROUND = (AUDIO_CHANNEL_OUT_FRONT_LEFT | |
| AUDIO_CHANNEL_OUT_FRONT_RIGHT | |
| AUDIO_CHANNEL_OUT_FRONT_CENTER | |
| AUDIO_CHANNEL_OUT_BACK_CENTER), |
| AUDIO_CHANNEL_OUT_5POINT1 = (AUDIO_CHANNEL_OUT_FRONT_LEFT | |
| AUDIO_CHANNEL_OUT_FRONT_RIGHT | |
| AUDIO_CHANNEL_OUT_FRONT_CENTER | |
| AUDIO_CHANNEL_OUT_LOW_FREQUENCY | |
| AUDIO_CHANNEL_OUT_BACK_LEFT | |
| AUDIO_CHANNEL_OUT_BACK_RIGHT), |
| // matches the correct AudioFormat.CHANNEL_OUT_7POINT1_SURROUND definition for 7.1 |
| AUDIO_CHANNEL_OUT_7POINT1 = (AUDIO_CHANNEL_OUT_FRONT_LEFT | |
| AUDIO_CHANNEL_OUT_FRONT_RIGHT | |
| AUDIO_CHANNEL_OUT_FRONT_CENTER | |
| AUDIO_CHANNEL_OUT_LOW_FREQUENCY | |
| AUDIO_CHANNEL_OUT_BACK_LEFT | |
| AUDIO_CHANNEL_OUT_BACK_RIGHT | |
| AUDIO_CHANNEL_OUT_SIDE_LEFT | |
| AUDIO_CHANNEL_OUT_SIDE_RIGHT), |
| AUDIO_CHANNEL_OUT_ALL = (AUDIO_CHANNEL_OUT_FRONT_LEFT | |
| AUDIO_CHANNEL_OUT_FRONT_RIGHT | |
| AUDIO_CHANNEL_OUT_FRONT_CENTER | |
| AUDIO_CHANNEL_OUT_LOW_FREQUENCY | |
| AUDIO_CHANNEL_OUT_BACK_LEFT | |
| AUDIO_CHANNEL_OUT_BACK_RIGHT | |
| AUDIO_CHANNEL_OUT_FRONT_LEFT_OF_CENTER | |
| AUDIO_CHANNEL_OUT_FRONT_RIGHT_OF_CENTER | |
| AUDIO_CHANNEL_OUT_BACK_CENTER| |
| AUDIO_CHANNEL_OUT_SIDE_LEFT| |
| AUDIO_CHANNEL_OUT_SIDE_RIGHT| |
| AUDIO_CHANNEL_OUT_TOP_CENTER| |
| AUDIO_CHANNEL_OUT_TOP_FRONT_LEFT| |
| AUDIO_CHANNEL_OUT_TOP_FRONT_CENTER| |
| AUDIO_CHANNEL_OUT_TOP_FRONT_RIGHT| |
| AUDIO_CHANNEL_OUT_TOP_BACK_LEFT| |
| AUDIO_CHANNEL_OUT_TOP_BACK_CENTER| |
| AUDIO_CHANNEL_OUT_TOP_BACK_RIGHT), |
| |
| /* input channels */ |
| AUDIO_CHANNEL_IN_LEFT = 0x4, |
| AUDIO_CHANNEL_IN_RIGHT = 0x8, |
| AUDIO_CHANNEL_IN_FRONT = 0x10, |
| AUDIO_CHANNEL_IN_BACK = 0x20, |
| AUDIO_CHANNEL_IN_LEFT_PROCESSED = 0x40, |
| AUDIO_CHANNEL_IN_RIGHT_PROCESSED = 0x80, |
| AUDIO_CHANNEL_IN_FRONT_PROCESSED = 0x100, |
| AUDIO_CHANNEL_IN_BACK_PROCESSED = 0x200, |
| AUDIO_CHANNEL_IN_PRESSURE = 0x400, |
| AUDIO_CHANNEL_IN_X_AXIS = 0x800, |
| AUDIO_CHANNEL_IN_Y_AXIS = 0x1000, |
| AUDIO_CHANNEL_IN_Z_AXIS = 0x2000, |
| AUDIO_CHANNEL_IN_VOICE_UPLINK = 0x4000, |
| AUDIO_CHANNEL_IN_VOICE_DNLINK = 0x8000, |
| |
| AUDIO_CHANNEL_IN_MONO = AUDIO_CHANNEL_IN_FRONT, |
| AUDIO_CHANNEL_IN_STEREO = (AUDIO_CHANNEL_IN_LEFT | AUDIO_CHANNEL_IN_RIGHT), |
| AUDIO_CHANNEL_IN_ALL = (AUDIO_CHANNEL_IN_LEFT | |
| AUDIO_CHANNEL_IN_RIGHT | |
| AUDIO_CHANNEL_IN_FRONT | |
| AUDIO_CHANNEL_IN_BACK| |
| AUDIO_CHANNEL_IN_LEFT_PROCESSED | |
| AUDIO_CHANNEL_IN_RIGHT_PROCESSED | |
| AUDIO_CHANNEL_IN_FRONT_PROCESSED | |
| AUDIO_CHANNEL_IN_BACK_PROCESSED| |
| AUDIO_CHANNEL_IN_PRESSURE | |
| AUDIO_CHANNEL_IN_X_AXIS | |
| AUDIO_CHANNEL_IN_Y_AXIS | |
| AUDIO_CHANNEL_IN_Z_AXIS | |
| AUDIO_CHANNEL_IN_VOICE_UPLINK | |
| AUDIO_CHANNEL_IN_VOICE_DNLINK), |
| } audio_channels_t; |
| |
| typedef enum { |
| AUDIO_MODE_INVALID = -2, |
| AUDIO_MODE_CURRENT = -1, |
| AUDIO_MODE_NORMAL = 0, |
| AUDIO_MODE_RINGTONE = 1, |
| AUDIO_MODE_IN_CALL = 2, |
| AUDIO_MODE_IN_COMMUNICATION = 3, |
| |
| AUDIO_MODE_CNT, |
| AUDIO_MODE_MAX = AUDIO_MODE_CNT - 1, |
| } audio_mode_t; |
| |
| typedef enum { |
| AUDIO_IN_ACOUSTICS_AGC_ENABLE = 0x0001, |
| AUDIO_IN_ACOUSTICS_AGC_DISABLE = 0, |
| AUDIO_IN_ACOUSTICS_NS_ENABLE = 0x0002, |
| AUDIO_IN_ACOUSTICS_NS_DISABLE = 0, |
| AUDIO_IN_ACOUSTICS_TX_IIR_ENABLE = 0x0004, |
| AUDIO_IN_ACOUSTICS_TX_DISABLE = 0, |
| } audio_in_acoustics_t; |
| |
| typedef enum { |
| /* output devices */ |
| AUDIO_DEVICE_OUT_EARPIECE = 0x1, |
| AUDIO_DEVICE_OUT_SPEAKER = 0x2, |
| AUDIO_DEVICE_OUT_WIRED_HEADSET = 0x4, |
| AUDIO_DEVICE_OUT_WIRED_HEADPHONE = 0x8, |
| AUDIO_DEVICE_OUT_BLUETOOTH_SCO = 0x10, |
| AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET = 0x20, |
| AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT = 0x40, |
| AUDIO_DEVICE_OUT_BLUETOOTH_A2DP = 0x80, |
| AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES = 0x100, |
| AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER = 0x200, |
| AUDIO_DEVICE_OUT_AUX_DIGITAL = 0x400, |
| AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET = 0x800, |
| AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET = 0x1000, |
| AUDIO_DEVICE_OUT_DEFAULT = 0x8000, |
| AUDIO_DEVICE_OUT_ALL = (AUDIO_DEVICE_OUT_EARPIECE | |
| AUDIO_DEVICE_OUT_SPEAKER | |
| AUDIO_DEVICE_OUT_WIRED_HEADSET | |
| AUDIO_DEVICE_OUT_WIRED_HEADPHONE | |
| AUDIO_DEVICE_OUT_BLUETOOTH_SCO | |
| AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET | |
| AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT | |
| AUDIO_DEVICE_OUT_BLUETOOTH_A2DP | |
| AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | |
| AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER | |
| AUDIO_DEVICE_OUT_AUX_DIGITAL | |
| AUDIO_DEVICE_OUT_ANLG_DOCK_HEADSET | |
| AUDIO_DEVICE_OUT_DGTL_DOCK_HEADSET | |
| AUDIO_DEVICE_OUT_DEFAULT), |
| AUDIO_DEVICE_OUT_ALL_A2DP = (AUDIO_DEVICE_OUT_BLUETOOTH_A2DP | |
| AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_HEADPHONES | |
| AUDIO_DEVICE_OUT_BLUETOOTH_A2DP_SPEAKER), |
| AUDIO_DEVICE_OUT_ALL_SCO = (AUDIO_DEVICE_OUT_BLUETOOTH_SCO | |
| AUDIO_DEVICE_OUT_BLUETOOTH_SCO_HEADSET | |
| AUDIO_DEVICE_OUT_BLUETOOTH_SCO_CARKIT), |
| |
| /* input devices */ |
| AUDIO_DEVICE_IN_COMMUNICATION = 0x10000, |
| AUDIO_DEVICE_IN_AMBIENT = 0x20000, |
| AUDIO_DEVICE_IN_BUILTIN_MIC = 0x40000, |
| AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET = 0x80000, |
| AUDIO_DEVICE_IN_WIRED_HEADSET = 0x100000, |
| AUDIO_DEVICE_IN_AUX_DIGITAL = 0x200000, |
| AUDIO_DEVICE_IN_VOICE_CALL = 0x400000, |
| AUDIO_DEVICE_IN_BACK_MIC = 0x800000, |
| AUDIO_DEVICE_IN_DEFAULT = 0x80000000, |
| |
| AUDIO_DEVICE_IN_ALL = (AUDIO_DEVICE_IN_COMMUNICATION | |
| AUDIO_DEVICE_IN_AMBIENT | |
| AUDIO_DEVICE_IN_BUILTIN_MIC | |
| AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET | |
| AUDIO_DEVICE_IN_WIRED_HEADSET | |
| AUDIO_DEVICE_IN_AUX_DIGITAL | |
| AUDIO_DEVICE_IN_VOICE_CALL | |
| AUDIO_DEVICE_IN_BACK_MIC | |
| AUDIO_DEVICE_IN_DEFAULT), |
| AUDIO_DEVICE_IN_ALL_SCO = AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET, |
| } audio_devices_t; |
| |
| static inline bool audio_is_output_device(audio_devices_t device) |
| { |
| if ((popcount(device) == 1) && ((device & ~AUDIO_DEVICE_OUT_ALL) == 0)) |
| return true; |
| else |
| return false; |
| } |
| |
| static inline bool audio_is_input_device(audio_devices_t device) |
| { |
| if ((popcount(device) == 1) && ((device & ~AUDIO_DEVICE_IN_ALL) == 0)) |
| return true; |
| else |
| return false; |
| } |
| |
| static inline bool audio_is_a2dp_device(audio_devices_t device) |
| { |
| if ((popcount(device) == 1) && (device & AUDIO_DEVICE_OUT_ALL_A2DP)) |
| return true; |
| else |
| return false; |
| } |
| |
| static inline bool audio_is_bluetooth_sco_device(audio_devices_t device) |
| { |
| if ((popcount(device) == 1) && (device & (AUDIO_DEVICE_OUT_ALL_SCO | |
| AUDIO_DEVICE_IN_BLUETOOTH_SCO_HEADSET))) |
| return true; |
| else |
| return false; |
| } |
| |
| static inline bool audio_is_input_channel(uint32_t channel) |
| { |
| if ((channel & ~AUDIO_CHANNEL_IN_ALL) == 0) |
| return true; |
| else |
| return false; |
| } |
| |
| static inline bool audio_is_output_channel(uint32_t channel) |
| { |
| if ((channel & ~AUDIO_CHANNEL_OUT_ALL) == 0) |
| return true; |
| else |
| return false; |
| } |
| |
| static inline bool audio_is_valid_format(uint32_t format) |
| { |
| switch (format & AUDIO_FORMAT_MAIN_MASK) { |
| case AUDIO_FORMAT_PCM: |
| if (format != AUDIO_FORMAT_PCM_16_BIT && |
| format != AUDIO_FORMAT_PCM_8_BIT) { |
| return false; |
| } |
| case AUDIO_FORMAT_MP3: |
| case AUDIO_FORMAT_AMR_NB: |
| case AUDIO_FORMAT_AMR_WB: |
| case AUDIO_FORMAT_AAC: |
| case AUDIO_FORMAT_HE_AAC_V1: |
| case AUDIO_FORMAT_HE_AAC_V2: |
| case AUDIO_FORMAT_VORBIS: |
| return true; |
| default: |
| return false; |
| } |
| } |
| |
| static inline bool audio_is_linear_pcm(uint32_t format) |
| { |
| return ((format & AUDIO_FORMAT_MAIN_MASK) == AUDIO_FORMAT_PCM); |
| } |
| |
| static inline size_t audio_bytes_per_sample(uint32_t format) |
| { |
| size_t size = 0; |
| |
| switch (format) { |
| case AUDIO_FORMAT_PCM_32_BIT: |
| case AUDIO_FORMAT_PCM_8_24_BIT: |
| size = sizeof(int32_t); |
| break; |
| case AUDIO_FORMAT_PCM_16_BIT: |
| size = sizeof(int16_t); |
| break; |
| case AUDIO_FORMAT_PCM_8_BIT: |
| size = sizeof(uint8_t); |
| break; |
| default: |
| break; |
| } |
| return size; |
| } |
| |
| __END_DECLS |
| |
| #endif // ANDROID_AUDIO_CORE_H |
