1 /* 2 * QEMU Audio subsystem header 3 * 4 * Copyright (c) 2003-2005 Vassili Karpov (malc) 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining a copy 7 * of this software and associated documentation files (the "Software"), to deal 8 * in the Software without restriction, including without limitation the rights 9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 10 * copies of the Software, and to permit persons to whom the Software is 11 * furnished to do so, subject to the following conditions: 12 * 13 * The above copyright notice and this permission notice shall be included in 14 * all copies or substantial portions of the Software. 15 * 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 22 * THE SOFTWARE. 23 */ 24 25 #ifndef QEMU_AUDIO_INT_H 26 #define QEMU_AUDIO_INT_H 27 28 #ifdef CONFIG_COREAUDIO 29 #define FLOAT_MIXENG 30 /* #define RECIPROCAL */ 31 #endif 32 #include "mixeng.h" 33 34 struct audio_pcm_ops; 35 36 typedef enum { 37 AUD_OPT_INT, 38 AUD_OPT_FMT, 39 AUD_OPT_STR, 40 AUD_OPT_BOOL 41 } audio_option_tag_e; 42 43 struct audio_option { 44 const char *name; 45 audio_option_tag_e tag; 46 void *valp; 47 const char *descr; 48 int *overriddenp; 49 int overridden; 50 }; 51 52 struct audio_callback { 53 void *opaque; 54 audio_callback_fn fn; 55 }; 56 57 struct audio_pcm_info { 58 int bits; 59 int sign; 60 int freq; 61 int nchannels; 62 int align; 63 int shift; 64 int bytes_per_second; 65 int swap_endianness; 66 }; 67 68 typedef struct SWVoiceCap SWVoiceCap; 69 70 typedef struct HWVoiceOut { 71 int enabled; 72 int poll_mode; 73 int pending_disable; 74 struct audio_pcm_info info; 75 76 f_sample *clip; 77 78 int rpos; 79 uint64_t ts_helper; 80 81 struct st_sample *mix_buf; 82 83 int samples; 84 QLIST_HEAD (sw_out_listhead, SWVoiceOut) sw_head; 85 QLIST_HEAD (sw_cap_listhead, SWVoiceCap) cap_head; 86 int ctl_caps; 87 struct audio_pcm_ops *pcm_ops; 88 QLIST_ENTRY (HWVoiceOut) entries; 89 } HWVoiceOut; 90 91 typedef struct HWVoiceIn { 92 int enabled; 93 int poll_mode; 94 struct audio_pcm_info info; 95 96 t_sample *conv; 97 98 int wpos; 99 int total_samples_captured; 100 uint64_t ts_helper; 101 102 struct st_sample *conv_buf; 103 104 int samples; 105 QLIST_HEAD (sw_in_listhead, SWVoiceIn) sw_head; 106 int ctl_caps; 107 struct audio_pcm_ops *pcm_ops; 108 QLIST_ENTRY (HWVoiceIn) entries; 109 } HWVoiceIn; 110 111 struct SWVoiceOut { 112 QEMUSoundCard *card; 113 struct audio_pcm_info info; 114 t_sample *conv; 115 int64_t ratio; 116 struct st_sample *buf; 117 void *rate; 118 int total_hw_samples_mixed; 119 int active; 120 int empty; 121 HWVoiceOut *hw; 122 char *name; 123 struct mixeng_volume vol; 124 struct audio_callback callback; 125 QLIST_ENTRY (SWVoiceOut) entries; 126 }; 127 128 struct SWVoiceIn { 129 QEMUSoundCard *card; 130 int active; 131 struct audio_pcm_info info; 132 int64_t ratio; 133 void *rate; 134 int total_hw_samples_acquired; 135 struct st_sample *buf; 136 f_sample *clip; 137 HWVoiceIn *hw; 138 char *name; 139 struct mixeng_volume vol; 140 struct audio_callback callback; 141 QLIST_ENTRY (SWVoiceIn) entries; 142 }; 143 144 struct audio_driver { 145 const char *name; 146 const char *descr; 147 struct audio_option *options; 148 void *(*init) (void); 149 void (*fini) (void *); 150 struct audio_pcm_ops *pcm_ops; 151 int can_be_default; 152 int max_voices_out; 153 int max_voices_in; 154 int voice_size_out; 155 int voice_size_in; 156 int ctl_caps; 157 }; 158 159 struct audio_pcm_ops { 160 int (*init_out)(HWVoiceOut *hw, struct audsettings *as, void *drv_opaque); 161 void (*fini_out)(HWVoiceOut *hw); 162 int (*run_out) (HWVoiceOut *hw, int live); 163 int (*write) (SWVoiceOut *sw, void *buf, int size); 164 int (*ctl_out) (HWVoiceOut *hw, int cmd, ...); 165 166 int (*init_in) (HWVoiceIn *hw, struct audsettings *as, void *drv_opaque); 167 void (*fini_in) (HWVoiceIn *hw); 168 int (*run_in) (HWVoiceIn *hw); 169 int (*read) (SWVoiceIn *sw, void *buf, int size); 170 int (*ctl_in) (HWVoiceIn *hw, int cmd, ...); 171 }; 172 173 struct capture_callback { 174 struct audio_capture_ops ops; 175 void *opaque; 176 QLIST_ENTRY (capture_callback) entries; 177 }; 178 179 struct CaptureVoiceOut { 180 HWVoiceOut hw; 181 void *buf; 182 QLIST_HEAD (cb_listhead, capture_callback) cb_head; 183 QLIST_ENTRY (CaptureVoiceOut) entries; 184 }; 185 186 struct SWVoiceCap { 187 SWVoiceOut sw; 188 CaptureVoiceOut *cap; 189 QLIST_ENTRY (SWVoiceCap) entries; 190 }; 191 192 struct AudioState { 193 struct audio_driver *drv; 194 void *drv_opaque; 195 196 QEMUTimer *ts; 197 QLIST_HEAD (card_listhead, QEMUSoundCard) card_head; 198 QLIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in; 199 QLIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out; 200 QLIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head; 201 int nb_hw_voices_out; 202 int nb_hw_voices_in; 203 int vm_running; 204 }; 205 206 extern struct audio_driver no_audio_driver; 207 extern struct audio_driver oss_audio_driver; 208 extern struct audio_driver sdl_audio_driver; 209 extern struct audio_driver wav_audio_driver; 210 extern struct audio_driver alsa_audio_driver; 211 extern struct audio_driver coreaudio_audio_driver; 212 extern struct audio_driver dsound_audio_driver; 213 extern struct audio_driver pa_audio_driver; 214 extern struct audio_driver spice_audio_driver; 215 extern const struct mixeng_volume nominal_volume; 216 217 void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as); 218 void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len); 219 220 int audio_pcm_sw_write (SWVoiceOut *sw, void *buf, int len); 221 int audio_pcm_hw_get_live_in (HWVoiceIn *hw); 222 223 int audio_pcm_sw_read (SWVoiceIn *sw, void *buf, int len); 224 225 int audio_pcm_hw_clip_out (HWVoiceOut *hw, void *pcm_buf, 226 int live, int pending); 227 228 int audio_bug (const char *funcname, int cond); 229 void *audio_calloc (const char *funcname, int nmemb, size_t size); 230 231 void audio_run (const char *msg); 232 233 #define VOICE_ENABLE 1 234 #define VOICE_DISABLE 2 235 #define VOICE_VOLUME 3 236 237 #define VOICE_VOLUME_CAP (1 << VOICE_VOLUME) 238 239 static inline int audio_ring_dist (int dst, int src, int len) 240 { 241 return (dst >= src) ? (dst - src) : (len - src + dst); 242 } 243 244 #define dolog(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__) 245 246 #ifdef DEBUG 247 #define ldebug(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__) 248 #else 249 #define ldebug(fmt, ...) (void)0 250 #endif 251 252 #define AUDIO_STRINGIFY_(n) #n 253 #define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n) 254 255 #if defined _MSC_VER || defined __GNUC__ 256 #define AUDIO_FUNC __FUNCTION__ 257 #else 258 #define AUDIO_FUNC __FILE__ ":" AUDIO_STRINGIFY (__LINE__) 259 #endif 260 261 #endif /* QEMU_AUDIO_INT_H */ 262