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 #ifndef QEMU_AUDIO_INT_H
25 #define QEMU_AUDIO_INT_H
26
27 #include "audio/audio.h"
28
29 #ifdef CONFIG_COREAUDIO
30 #define FLOAT_MIXENG
31 /* #define RECIPROCAL */
32 #endif
33 #include "mixeng.h"
34
35 struct audio_pcm_ops;
36
37 typedef enum {
38 AUD_OPT_INT,
39 AUD_OPT_FMT,
40 AUD_OPT_STR,
41 AUD_OPT_BOOL
42 } audio_option_tag_e;
43
44 struct audio_option {
45 const char *name;
46 audio_option_tag_e tag;
47 void *valp;
48 const char *descr;
49 int *overriddenp;
50 int overridden;
51 };
52
53 struct audio_callback {
54 void *opaque;
55 audio_callback_fn_t fn;
56 };
57
58 struct audio_pcm_info {
59 int bits;
60 int sign;
61 int freq;
62 int nchannels;
63 int align;
64 int shift;
65 int bytes_per_second;
66 int swap_endianness;
67 };
68
69 typedef struct SWVoiceCap SWVoiceCap;
70
71 typedef struct HWVoiceOut {
72 int enabled;
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 LIST_HEAD (sw_out_listhead, SWVoiceOut) sw_head;
85 LIST_HEAD (sw_cap_listhead, SWVoiceCap) cap_head;
86 struct audio_pcm_ops *pcm_ops;
87 LIST_ENTRY (HWVoiceOut) entries;
88 } HWVoiceOut;
89
90 typedef struct HWVoiceIn {
91 int enabled;
92 struct audio_pcm_info info;
93
94 t_sample *conv;
95
96 int wpos;
97 int total_samples_captured;
98 uint64_t ts_helper;
99
100 struct st_sample *conv_buf;
101
102 int samples;
103 LIST_HEAD (sw_in_listhead, SWVoiceIn) sw_head;
104 struct audio_pcm_ops *pcm_ops;
105 LIST_ENTRY (HWVoiceIn) entries;
106 } HWVoiceIn;
107
108 struct SWVoiceOut {
109 QEMUSoundCard *card;
110 struct audio_pcm_info info;
111 t_sample *conv;
112 int64_t ratio;
113 struct st_sample *buf;
114 void *rate;
115 int total_hw_samples_mixed;
116 int active;
117 int empty;
118 HWVoiceOut *hw;
119 char *name;
120 struct mixeng_volume vol;
121 struct audio_callback callback;
122 LIST_ENTRY (SWVoiceOut) entries;
123 };
124
125 struct SWVoiceIn {
126 QEMUSoundCard *card;
127 int active;
128 struct audio_pcm_info info;
129 int64_t ratio;
130 void *rate;
131 int total_hw_samples_acquired;
132 struct st_sample *buf;
133 f_sample *clip;
134 HWVoiceIn *hw;
135 char *name;
136 struct mixeng_volume vol;
137 struct audio_callback callback;
138 LIST_ENTRY (SWVoiceIn) entries;
139 };
140
141 struct audio_driver {
142 const char *name;
143 const char *descr;
144 struct audio_option *options;
145 void *(*init) (void);
146 void (*fini) (void *);
147 struct audio_pcm_ops *pcm_ops;
148 int can_be_default;
149 int max_voices_out;
150 int max_voices_in;
151 int voice_size_out;
152 int voice_size_in;
153 };
154
155 struct audio_pcm_ops {
156 int (*init_out)(HWVoiceOut *hw, struct audsettings *as);
157 void (*fini_out)(HWVoiceOut *hw);
158 int (*run_out) (HWVoiceOut *hw);
159 int (*write) (SWVoiceOut *sw, void *buf, int size);
160 int (*ctl_out) (HWVoiceOut *hw, int cmd, ...);
161
162 int (*init_in) (HWVoiceIn *hw, struct audsettings *as);
163 void (*fini_in) (HWVoiceIn *hw);
164 int (*run_in) (HWVoiceIn *hw);
165 int (*read) (SWVoiceIn *sw, void *buf, int size);
166 int (*ctl_in) (HWVoiceIn *hw, int cmd, ...);
167 };
168
169 struct capture_callback {
170 struct audio_capture_ops ops;
171 void *opaque;
172 LIST_ENTRY (capture_callback) entries;
173 };
174
175 struct CaptureVoiceOut {
176 HWVoiceOut hw;
177 void *buf;
178 LIST_HEAD (cb_listhead, capture_callback) cb_head;
179 LIST_ENTRY (CaptureVoiceOut) entries;
180 };
181
182 struct SWVoiceCap {
183 SWVoiceOut sw;
184 CaptureVoiceOut *cap;
185 LIST_ENTRY (SWVoiceCap) entries;
186 };
187
188 struct AudioState {
189 struct audio_driver* drv_in;
190 void* drv_in_opaque;
191 struct audio_driver* drv_out;
192 void* drv_out_opaque;
193
194 QEMUTimer *ts;
195 LIST_HEAD (card_listhead, QEMUSoundCard) card_head;
196 LIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in;
197 LIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out;
198 LIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head;
199 int nb_hw_voices_out;
200 int nb_hw_voices_in;
201 int vm_running;
202 };
203
204 extern struct audio_driver no_audio_driver;
205 extern struct audio_driver oss_audio_driver;
206 extern struct audio_driver sdl_audio_driver;
207 extern struct audio_driver win_audio_driver;
208 extern struct audio_driver wav_audio_driver;
209 extern struct audio_driver fmod_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 esd_audio_driver;
214 extern struct audio_driver pa_audio_driver;
215 extern 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 int audio_pcm_hw_get_live_out (HWVoiceOut *hw);
225 int audio_pcm_hw_get_live_out2 (HWVoiceOut *hw, int *nb_live);
226
227 int audio_bug (const char *funcname, int cond);
228 void *audio_calloc (const char *funcname, int nmemb, size_t size);
229
230 #define VOICE_ENABLE 1
231 #define VOICE_DISABLE 2
232
audio_ring_dist(int dst,int src,int len)233 static inline int audio_ring_dist (int dst, int src, int len)
234 {
235 return (dst >= src) ? (dst - src) : (len - src + dst);
236 }
237
238 #if defined __GNUC__
239 #define GCC_ATTR __attribute__ ((__unused__, __format__ (__printf__, 1, 2)))
240 #define INIT_FIELD(f) . f
241 #define GCC_FMT_ATTR(n, m) __attribute__ ((__format__ (__printf__, n, m)))
242 #else
243 #define GCC_ATTR /**/
244 #define INIT_FIELD(f) /**/
245 #define GCC_FMT_ATTR(n, m)
246 #endif
247
dolog(const char * fmt,...)248 static void GCC_ATTR dolog (const char *fmt, ...)
249 {
250 va_list ap;
251
252 va_start (ap, fmt);
253 AUD_vlog (AUDIO_CAP, fmt, ap);
254 va_end (ap);
255 }
256
257 #ifdef DEBUG
ldebug(const char * fmt,...)258 static void GCC_ATTR ldebug (const char *fmt, ...)
259 {
260 va_list ap;
261
262 va_start (ap, fmt);
263 AUD_vlog (AUDIO_CAP, fmt, ap);
264 va_end (ap);
265 }
266 #else
267 #if defined NDEBUG && defined __GNUC__
268 #define ldebug(...)
269 #elif defined NDEBUG && defined _MSC_VER
270 #define ldebug __noop
271 #else
ldebug(const char * fmt,...)272 static void GCC_ATTR ldebug (const char *fmt, ...)
273 {
274 (void) fmt;
275 }
276 #endif
277 #endif
278
279 #undef GCC_ATTR
280
281 #define AUDIO_STRINGIFY_(n) #n
282 #define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n)
283
284 #if defined _MSC_VER || defined __GNUC__
285 #define AUDIO_FUNC __FUNCTION__
286 #else
287 #define AUDIO_FUNC __FILE__ ":" AUDIO_STRINGIFY (__LINE__)
288 #endif
289
290 #endif /* audio_int.h */
291