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_AUDIO_COREAUDIO 29 #define FLOAT_MIXENG 30 /* #define RECIPROCAL */ 31 #endif 32 #include "mixeng.h" 33 34 struct audio_pcm_ops; 35 36 struct audio_callback { 37 void *opaque; 38 audio_callback_fn fn; 39 }; 40 41 struct audio_pcm_info { 42 int bits; 43 int sign; 44 int freq; 45 int nchannels; 46 int align; 47 int shift; 48 int bytes_per_second; 49 int swap_endianness; 50 }; 51 52 typedef struct AudioState AudioState; 53 typedef struct SWVoiceCap SWVoiceCap; 54 55 typedef struct HWVoiceOut { 56 AudioState *s; 57 int enabled; 58 int poll_mode; 59 int pending_disable; 60 struct audio_pcm_info info; 61 62 f_sample *clip; 63 64 size_t rpos; 65 uint64_t ts_helper; 66 67 struct st_sample *mix_buf; 68 69 size_t samples; 70 QLIST_HEAD (sw_out_listhead, SWVoiceOut) sw_head; 71 QLIST_HEAD (sw_cap_listhead, SWVoiceCap) cap_head; 72 int ctl_caps; 73 struct audio_pcm_ops *pcm_ops; 74 QLIST_ENTRY (HWVoiceOut) entries; 75 } HWVoiceOut; 76 77 typedef struct HWVoiceIn { 78 AudioState *s; 79 int enabled; 80 int poll_mode; 81 struct audio_pcm_info info; 82 83 t_sample *conv; 84 85 size_t wpos; 86 size_t total_samples_captured; 87 uint64_t ts_helper; 88 89 struct st_sample *conv_buf; 90 91 size_t samples; 92 QLIST_HEAD (sw_in_listhead, SWVoiceIn) sw_head; 93 int ctl_caps; 94 struct audio_pcm_ops *pcm_ops; 95 QLIST_ENTRY (HWVoiceIn) entries; 96 } HWVoiceIn; 97 98 struct SWVoiceOut { 99 QEMUSoundCard *card; 100 AudioState *s; 101 struct audio_pcm_info info; 102 t_sample *conv; 103 int64_t ratio; 104 struct st_sample *buf; 105 void *rate; 106 size_t total_hw_samples_mixed; 107 int active; 108 int empty; 109 HWVoiceOut *hw; 110 char *name; 111 struct mixeng_volume vol; 112 struct audio_callback callback; 113 QLIST_ENTRY (SWVoiceOut) entries; 114 }; 115 116 struct SWVoiceIn { 117 QEMUSoundCard *card; 118 AudioState *s; 119 int active; 120 struct audio_pcm_info info; 121 int64_t ratio; 122 void *rate; 123 size_t total_hw_samples_acquired; 124 struct st_sample *buf; 125 f_sample *clip; 126 HWVoiceIn *hw; 127 char *name; 128 struct mixeng_volume vol; 129 struct audio_callback callback; 130 QLIST_ENTRY (SWVoiceIn) entries; 131 }; 132 133 typedef struct audio_driver audio_driver; 134 struct audio_driver { 135 const char *name; 136 const char *descr; 137 void *(*init) (Audiodev *); 138 void (*fini) (void *); 139 struct audio_pcm_ops *pcm_ops; 140 int can_be_default; 141 int max_voices_out; 142 int max_voices_in; 143 int voice_size_out; 144 int voice_size_in; 145 int ctl_caps; 146 QLIST_ENTRY(audio_driver) next; 147 }; 148 149 struct audio_pcm_ops { 150 int (*init_out)(HWVoiceOut *hw, struct audsettings *as, void *drv_opaque); 151 void (*fini_out)(HWVoiceOut *hw); 152 size_t (*run_out)(HWVoiceOut *hw, size_t live); 153 int (*ctl_out) (HWVoiceOut *hw, int cmd, ...); 154 155 int (*init_in) (HWVoiceIn *hw, struct audsettings *as, void *drv_opaque); 156 void (*fini_in) (HWVoiceIn *hw); 157 size_t (*run_in)(HWVoiceIn *hw); 158 int (*ctl_in) (HWVoiceIn *hw, int cmd, ...); 159 }; 160 161 struct capture_callback { 162 struct audio_capture_ops ops; 163 void *opaque; 164 QLIST_ENTRY (capture_callback) entries; 165 }; 166 167 struct CaptureVoiceOut { 168 HWVoiceOut hw; 169 void *buf; 170 QLIST_HEAD (cb_listhead, capture_callback) cb_head; 171 QLIST_ENTRY (CaptureVoiceOut) entries; 172 }; 173 174 struct SWVoiceCap { 175 SWVoiceOut sw; 176 CaptureVoiceOut *cap; 177 QLIST_ENTRY (SWVoiceCap) entries; 178 }; 179 180 typedef struct AudioState { 181 struct audio_driver *drv; 182 Audiodev *dev; 183 void *drv_opaque; 184 185 QEMUTimer *ts; 186 QLIST_HEAD (card_listhead, QEMUSoundCard) card_head; 187 QLIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in; 188 QLIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out; 189 QLIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head; 190 int nb_hw_voices_out; 191 int nb_hw_voices_in; 192 int vm_running; 193 int64_t period_ticks; 194 195 bool timer_running; 196 uint64_t timer_last; 197 198 QTAILQ_ENTRY(AudioState) list; 199 } AudioState; 200 201 extern const struct mixeng_volume nominal_volume; 202 203 extern const char *audio_prio_list[]; 204 205 void audio_driver_register(audio_driver *drv); 206 audio_driver *audio_driver_lookup(const char *name); 207 208 void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as); 209 void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len); 210 211 size_t audio_pcm_hw_get_live_in(HWVoiceIn *hw); 212 213 size_t audio_pcm_hw_clip_out(HWVoiceOut *hw, void *pcm_buf, 214 size_t live, size_t pending); 215 216 int audio_bug (const char *funcname, int cond); 217 void *audio_calloc (const char *funcname, int nmemb, size_t size); 218 219 void audio_run(AudioState *s, const char *msg); 220 221 #define VOICE_ENABLE 1 222 #define VOICE_DISABLE 2 223 #define VOICE_VOLUME 3 224 225 #define VOICE_VOLUME_CAP (1 << VOICE_VOLUME) 226 227 static inline size_t audio_ring_dist(size_t dst, size_t src, size_t len) 228 { 229 return (dst >= src) ? (dst - src) : (len - src + dst); 230 } 231 232 #define dolog(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__) 233 234 #ifdef DEBUG 235 #define ldebug(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__) 236 #else 237 #define ldebug(fmt, ...) (void)0 238 #endif 239 240 #define AUDIO_STRINGIFY_(n) #n 241 #define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n) 242 243 typedef struct AudiodevListEntry { 244 Audiodev *dev; 245 QSIMPLEQ_ENTRY(AudiodevListEntry) next; 246 } AudiodevListEntry; 247 248 typedef QSIMPLEQ_HEAD(, AudiodevListEntry) AudiodevListHead; 249 AudiodevListHead audio_handle_legacy_opts(void); 250 251 void audio_free_audiodev_list(AudiodevListHead *head); 252 253 void audio_create_pdos(Audiodev *dev); 254 AudiodevPerDirectionOptions *audio_get_pdo_in(Audiodev *dev); 255 AudiodevPerDirectionOptions *audio_get_pdo_out(Audiodev *dev); 256 257 #endif /* QEMU_AUDIO_INT_H */ 258