1/* 2** Copyright 2010, The Android Open-Source Project 3** Copyright (c) 2011-2012, Code Aurora Forum. All rights reserved. 4** 5** Licensed under the Apache License, Version 2.0 (the "License"); 6** you may not use this file except in compliance with the License. 7** You may obtain a copy of the License at 8** 9** http://www.apache.org/licenses/LICENSE-2.0 10** 11** Unless required by applicable law or agreed to in writing, software 12** distributed under the License is distributed on an "AS IS" BASIS, 13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14** See the License for the specific language governing permissions and 15** limitations under the License. 16*/ 17 18#ifndef _AUDIO_H_ 19#define _AUDIO_H_ 20 21#include <sound/asound.h> 22#define PCM_ERROR_MAX 128 23 24struct pcm { 25 int fd; 26 int timer_fd; 27 unsigned rate; 28 unsigned channels; 29 unsigned flags; 30 unsigned format; 31 unsigned running:1; 32 int underruns; 33 unsigned buffer_size; 34 unsigned period_size; 35 unsigned period_cnt; 36 char error[PCM_ERROR_MAX]; 37 struct snd_pcm_hw_params *hw_p; 38 struct snd_pcm_sw_params *sw_p; 39 struct snd_pcm_sync_ptr *sync_ptr; 40 struct snd_pcm_channel_info ch[2]; 41 void *addr; 42 int card_no; 43 int device_no; 44 int start; 45}; 46 47enum decoder_alias { 48 FORMAT_MP3, 49 FORMAT_AC3_PASS_THROUGH = 2, 50}; 51 52#define FORMAT(v) SNDRV_PCM_FORMAT_##v 53 54#define PCM_OUT 0x00000000 55#define PCM_IN 0x10000000 56 57#define PCM_STEREO 0x00000000 58#define PCM_MONO 0x01000000 59#define PCM_QUAD 0x02000000 60#define PCM_5POINT1 0x04000000 61 62#define PCM_44100HZ 0x00000000 63#define PCM_48000HZ 0x00100000 64#define PCM_8000HZ 0x00200000 65#define PCM_RATE_MASK 0x00F00000 66 67#define PCM_MMAP 0x00010000 68#define PCM_NMMAP 0x00000000 69 70#define DEBUG_ON 0x00000001 71#define DEBUG_OFF 0x00000000 72 73#define PCM_PERIOD_CNT_MIN 2 74#define PCM_PERIOD_CNT_SHIFT 16 75#define PCM_PERIOD_CNT_MASK (0xF << PCM_PERIOD_CNT_SHIFT) 76#define PCM_PERIOD_SZ_MIN 128 77#define PCM_PERIOD_SZ_SHIFT 12 78#define PCM_PERIOD_SZ_MASK (0xF << PCM_PERIOD_SZ_SHIFT) 79 80#define TIMEOUT_INFINITE -1 81 82/* Acquire/release a pcm channel. 83 * Returns non-zero on error 84 */ 85 86struct mixer_ctl { 87 struct mixer *mixer; 88 struct snd_ctl_elem_info *info; 89 char **ename; 90}; 91 92#define __snd_alloca(ptr,type) do { *ptr = (type *) alloca(sizeof(type)); memset(*ptr, 0, sizeof(type)); } while (0) 93#define snd_ctl_elem_id_alloca(ptr) __snd_alloca(ptr, snd_ctl_elem_id) 94#define snd_ctl_card_info_alloca(ptr) __snd_alloca(ptr, snd_ctl_card_info) 95#define snd_ctl_event_alloca(ptr) __snd_alloca(ptr, snd_ctl_event) 96#define snd_ctl_elem_list_alloca(ptr) __snd_alloca(ptr, snd_ctl_elem_list) 97#define snd_ctl_elem_info_alloca(ptr) __snd_alloca(ptr, snd_ctl_elem_info) 98#define snd_ctl_elem_value_alloca(ptr) __snd_alloca(ptr, snd_ctl_elem_value) 99 100 101enum snd_pcm_stream_t { 102 /** Playback stream */ 103 SND_PCM_STREAM_PLAYBACK = 0, 104 /** Capture stream */ 105 SND_PCM_STREAM_CAPTURE, 106 SND_PCM_STREAM_LAST = SND_PCM_STREAM_CAPTURE 107}; 108 109enum _snd_ctl_elem_iface { 110 /** Card level */ 111 SND_CTL_ELEM_IFACE_CARD = 0, 112 /** Hardware dependent device */ 113 SND_CTL_ELEM_IFACE_HWDEP, 114 /** Mixer */ 115 SND_CTL_ELEM_IFACE_MIXER, 116 /** PCM */ 117 SND_CTL_ELEM_IFACE_PCM, 118 /** RawMidi */ 119 SND_CTL_ELEM_IFACE_RAWMIDI, 120 /** Timer */ 121 SND_CTL_ELEM_IFACE_TIMER, 122 /** Sequencer */ 123 SND_CTL_ELEM_IFACE_SEQUENCER, 124 SND_CTL_ELEM_IFACE_LAST = SND_CTL_ELEM_IFACE_SEQUENCER 125}; 126 127struct mixer { 128 int fd; 129 struct snd_ctl_elem_info *info; 130 struct mixer_ctl *ctl; 131 unsigned count; 132}; 133 134int get_format(const char* name); 135const char *get_format_name(int format); 136const char *get_format_desc(int format); 137struct pcm *pcm_open(unsigned flags, char *device); 138int pcm_close(struct pcm *pcm); 139int pcm_ready(struct pcm *pcm); 140int mmap_buffer(struct pcm *pcm); 141u_int8_t *dst_address(struct pcm *pcm); 142int sync_ptr(struct pcm *pcm); 143 144void param_init(struct snd_pcm_hw_params *p); 145void param_set_mask(struct snd_pcm_hw_params *p, int n, unsigned bit); 146void param_set_min(struct snd_pcm_hw_params *p, int n, unsigned val); 147void param_set_int(struct snd_pcm_hw_params *p, int n, unsigned val); 148void param_set_max(struct snd_pcm_hw_params *p, int n, unsigned val); 149int param_set_hw_refine(struct pcm *pcm, struct snd_pcm_hw_params *params); 150int param_set_hw_params(struct pcm *pcm, struct snd_pcm_hw_params *params); 151int param_set_sw_params(struct pcm *pcm, struct snd_pcm_sw_params *sparams); 152void param_dump(struct snd_pcm_hw_params *p); 153int pcm_prepare(struct pcm *pcm); 154long pcm_avail(struct pcm *pcm); 155 156/* Returns a human readable reason for the last error. */ 157const char *pcm_error(struct pcm *pcm); 158 159/* Returns the buffer size (int bytes) that should be used for pcm_write. 160 * This will be 1/2 of the actual fifo size. 161 */ 162int pcm_buffer_size(struct snd_pcm_hw_params *params); 163int pcm_period_size(struct snd_pcm_hw_params *params); 164 165/* Write data to the fifo. 166 * Will start playback on the first write or on a write that 167 * occurs after a fifo underrun. 168 */ 169int pcm_write(struct pcm *pcm, void *data, unsigned count); 170int pcm_read(struct pcm *pcm, void *data, unsigned count); 171 172struct mixer; 173struct mixer_ctl; 174 175struct mixer *mixer_open(const char *device); 176void mixer_close(struct mixer *mixer); 177void mixer_dump(struct mixer *mixer); 178 179struct mixer_ctl *mixer_get_control(struct mixer *mixer, 180 const char *name, unsigned index); 181struct mixer_ctl *mixer_get_nth_control(struct mixer *mixer, unsigned n); 182 183int mixer_ctl_set(struct mixer_ctl *ctl, unsigned percent); 184int mixer_ctl_select(struct mixer_ctl *ctl, const char *value); 185void mixer_ctl_get(struct mixer_ctl *ctl, unsigned *value); 186int mixer_ctl_set_value(struct mixer_ctl *ctl, int count, char ** argv); 187 188 189#define MAX_NUM_CODECS 32 190 191/* compressed audio support */ 192#ifdef QCOM_COMPRESSED_AUDIO_ENABLED 193struct snd_compr_caps { 194 __u32 num_codecs; 195 __u32 min_fragment_size; 196 __u32 max_fragment_size; 197 __u32 min_fragments; 198 __u32 max_fragments; 199 __u32 codecs[MAX_NUM_CODECS]; 200 __u32 reserved[11]; 201}; 202 203struct snd_enc_wma { 204 __u32 super_block_align; /* WMA Type-specific data */ 205 __u32 bits_per_sample; 206 __u32 channelmask; 207 __u32 encodeopt; 208}; 209 210struct snd_enc_vorbis { 211 int quality; 212 __u32 managed; 213 __u32 max_bit_rate; 214 __u32 min_bit_rate; 215 __u32 downmix; 216}; 217 218struct snd_enc_real { 219 __u32 quant_bits; 220 __u32 start_region; 221 __u32 num_regions; 222}; 223 224struct snd_enc_flac { 225 __u32 num; 226 __u32 gain; 227}; 228 229struct snd_enc_generic { 230 __u32 bw; /* encoder bandwidth */ 231 int reserved[15]; 232}; 233 234union snd_codec_options { 235 struct snd_enc_wma wma; 236 struct snd_enc_vorbis vorbis; 237 struct snd_enc_real real; 238 struct snd_enc_flac flac; 239 struct snd_enc_generic generic; 240}; 241 242struct snd_codec { 243 __u32 id; 244 __u32 ch_in; 245 __u32 ch_out; 246 __u32 sample_rate; 247 __u32 bit_rate; 248 __u32 rate_control; 249 __u32 profile; 250 __u32 level; 251 __u32 ch_mode; 252 __u32 format; 253 __u32 align; 254 union snd_codec_options options; 255 __u32 reserved[3]; 256}; 257 258struct snd_compressed_buffer { 259 size_t fragment_size; 260 int fragments; 261}; 262 263/* */ 264struct snd_compr_params { 265 struct snd_compressed_buffer buffer; 266 struct snd_codec codec; 267}; 268 269struct snd_compr_tstamp { 270 size_t copied_bytes; 271 size_t copied_total; 272 size_t decoded; 273 size_t rendered; 274 __u32 sampling_rate; 275 uint64_t timestamp; 276}; 277 278#define SNDRV_COMPRESS_GET_CAPS _IOWR('C', 0x00, struct snd_compr_caps *) 279#define SNDRV_COMPRESS_GET_CODEC_CAPS _IOWR('C', 0x01, struct snd_compr_codec_caps *) 280#define SNDRV_COMPRESS_SET_PARAMS _IOW('C', 0x02, struct snd_compr_params *) 281#define SNDRV_COMPRESS_GET_PARAMS _IOR('C', 0x03, struct snd_compr_params *) 282#define SNDRV_COMPRESS_TSTAMP _IOR('C', 0x10, struct snd_compr_tstamp *) 283#define SNDRV_COMPRESS_AVAIL _IOR('C', 0x11, struct snd_compr_avail *) 284#define SNDRV_COMPRESS_PAUSE _IO('C', 0x20) 285#define SNDRV_COMPRESS_RESUME _IO('C', 0x21) 286#define SNDRV_COMPRESS_START _IO('C', 0x22) 287#define SNDRV_COMPRESS_STOP _IO('C', 0x23) 288#define SNDRV_COMPRESS_DRAIN _IO('C', 0x24) 289#endif 290 291#endif 292