]>
Commit | Line | Data |
---|---|---|
fb065187 FB |
1 | /* |
2 | * QEMU Audio subsystem header | |
1d14ffa9 FB |
3 | * |
4 | * Copyright (c) 2003-2005 Vassili Karpov (malc) | |
5 | * | |
fb065187 FB |
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 | */ | |
175de524 | 24 | |
fb065187 FB |
25 | #ifndef QEMU_AUDIO_INT_H |
26 | #define QEMU_AUDIO_INT_H | |
27 | ||
1ef1ec2a | 28 | #ifdef CONFIG_AUDIO_COREAUDIO |
1d14ffa9 FB |
29 | #define FLOAT_MIXENG |
30 | /* #define RECIPROCAL */ | |
31 | #endif | |
32 | #include "mixeng.h" | |
33 | ||
739362d4 MAL |
34 | #ifdef CONFIG_GIO |
35 | #include <gio/gio.h> | |
36 | #endif | |
37 | ||
1d14ffa9 FB |
38 | struct audio_pcm_ops; |
39 | ||
1d14ffa9 FB |
40 | struct audio_callback { |
41 | void *opaque; | |
cb4f03e8 | 42 | audio_callback_fn fn; |
1d14ffa9 | 43 | }; |
fb065187 | 44 | |
1d14ffa9 FB |
45 | struct audio_pcm_info { |
46 | int bits; | |
ed2a4a79 KZ |
47 | bool is_signed; |
48 | bool is_float; | |
1d14ffa9 FB |
49 | int freq; |
50 | int nchannels; | |
2b9cce8c | 51 | int bytes_per_frame; |
1d14ffa9 | 52 | int bytes_per_second; |
d929eba5 | 53 | int swap_endianness; |
1d14ffa9 | 54 | }; |
fb065187 | 55 | |
526fb058 | 56 | typedef struct AudioState AudioState; |
ec36b695 FB |
57 | typedef struct SWVoiceCap SWVoiceCap; |
58 | ||
dc88e38f KZ |
59 | typedef struct STSampleBuffer { |
60 | size_t pos, size; | |
61 | st_sample samples[]; | |
62 | } STSampleBuffer; | |
63 | ||
1d14ffa9 | 64 | typedef struct HWVoiceOut { |
526fb058 | 65 | AudioState *s; |
fb065187 | 66 | int enabled; |
713a98f8 | 67 | int poll_mode; |
fb065187 | 68 | int pending_disable; |
1d14ffa9 | 69 | struct audio_pcm_info info; |
fb065187 FB |
70 | |
71 | f_sample *clip; | |
1d14ffa9 | 72 | uint64_t ts_helper; |
fb065187 | 73 | |
dc88e38f | 74 | STSampleBuffer *mix_buf; |
ff095e52 KZ |
75 | void *buf_emul; |
76 | size_t pos_emul, pending_emul, size_emul; | |
fb065187 | 77 | |
7520462b | 78 | size_t samples; |
72cf2d4f BS |
79 | QLIST_HEAD (sw_out_listhead, SWVoiceOut) sw_head; |
80 | QLIST_HEAD (sw_cap_listhead, SWVoiceCap) cap_head; | |
35f4b58c | 81 | struct audio_pcm_ops *pcm_ops; |
72cf2d4f | 82 | QLIST_ENTRY (HWVoiceOut) entries; |
1d14ffa9 | 83 | } HWVoiceOut; |
fb065187 | 84 | |
1d14ffa9 | 85 | typedef struct HWVoiceIn { |
526fb058 | 86 | AudioState *s; |
1d14ffa9 | 87 | int enabled; |
713a98f8 | 88 | int poll_mode; |
1d14ffa9 FB |
89 | struct audio_pcm_info info; |
90 | ||
91 | t_sample *conv; | |
7372f88d | 92 | |
7520462b | 93 | size_t total_samples_captured; |
1d14ffa9 | 94 | uint64_t ts_helper; |
fb065187 | 95 | |
dc88e38f | 96 | STSampleBuffer *conv_buf; |
ff095e52 KZ |
97 | void *buf_emul; |
98 | size_t pos_emul, pending_emul, size_emul; | |
fb065187 | 99 | |
7520462b | 100 | size_t samples; |
72cf2d4f | 101 | QLIST_HEAD (sw_in_listhead, SWVoiceIn) sw_head; |
35f4b58c | 102 | struct audio_pcm_ops *pcm_ops; |
72cf2d4f | 103 | QLIST_ENTRY (HWVoiceIn) entries; |
1d14ffa9 | 104 | } HWVoiceIn; |
fb065187 | 105 | |
1d14ffa9 | 106 | struct SWVoiceOut { |
1a7dafce | 107 | QEMUSoundCard *card; |
526fb058 | 108 | AudioState *s; |
1d14ffa9 | 109 | struct audio_pcm_info info; |
fb065187 | 110 | t_sample *conv; |
fb065187 | 111 | int64_t ratio; |
1ea879e5 | 112 | struct st_sample *buf; |
fb065187 | 113 | void *rate; |
7520462b | 114 | size_t total_hw_samples_mixed; |
1d14ffa9 FB |
115 | int active; |
116 | int empty; | |
117 | HWVoiceOut *hw; | |
118 | char *name; | |
1ea879e5 | 119 | struct mixeng_volume vol; |
1d14ffa9 | 120 | struct audio_callback callback; |
72cf2d4f | 121 | QLIST_ENTRY (SWVoiceOut) entries; |
1d14ffa9 | 122 | }; |
fb065187 | 123 | |
1d14ffa9 | 124 | struct SWVoiceIn { |
1a7dafce | 125 | QEMUSoundCard *card; |
526fb058 | 126 | AudioState *s; |
fb065187 | 127 | int active; |
1d14ffa9 FB |
128 | struct audio_pcm_info info; |
129 | int64_t ratio; | |
130 | void *rate; | |
7520462b | 131 | size_t total_hw_samples_acquired; |
1ea879e5 | 132 | struct st_sample *buf; |
1d14ffa9 FB |
133 | f_sample *clip; |
134 | HWVoiceIn *hw; | |
fb065187 | 135 | char *name; |
1ea879e5 | 136 | struct mixeng_volume vol; |
1d14ffa9 | 137 | struct audio_callback callback; |
72cf2d4f | 138 | QLIST_ENTRY (SWVoiceIn) entries; |
fb065187 FB |
139 | }; |
140 | ||
d3893a39 | 141 | typedef struct audio_driver audio_driver; |
c0fe3827 FB |
142 | struct audio_driver { |
143 | const char *name; | |
144 | const char *descr; | |
71830221 | 145 | void *(*init) (Audiodev *); |
c0fe3827 | 146 | void (*fini) (void *); |
739362d4 MAL |
147 | #ifdef CONFIG_GIO |
148 | void (*set_dbus_server) (AudioState *s, GDBusObjectManagerServer *manager); | |
149 | #endif | |
35f4b58c | 150 | struct audio_pcm_ops *pcm_ops; |
c0fe3827 FB |
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; | |
d3893a39 | 156 | QLIST_ENTRY(audio_driver) next; |
c0fe3827 FB |
157 | }; |
158 | ||
1d14ffa9 | 159 | struct audio_pcm_ops { |
ff095e52 KZ |
160 | int (*init_out)(HWVoiceOut *hw, audsettings *as, void *drv_opaque); |
161 | void (*fini_out)(HWVoiceOut *hw); | |
ff095e52 | 162 | size_t (*write) (HWVoiceOut *hw, void *buf, size_t size); |
fdc8c5f4 | 163 | void (*run_buffer_out)(HWVoiceOut *hw); |
9833438e VR |
164 | /* |
165 | * Get the free output buffer size. This is an upper limit. The size | |
166 | * returned by function get_buffer_out may be smaller. | |
167 | */ | |
168 | size_t (*buffer_get_free)(HWVoiceOut *hw); | |
ff095e52 KZ |
169 | /* |
170 | * get a buffer that after later can be passed to put_buffer_out; optional | |
171 | * returns the buffer, and writes it's size to size (in bytes) | |
ff095e52 KZ |
172 | */ |
173 | void *(*get_buffer_out)(HWVoiceOut *hw, size_t *size); | |
174 | /* | |
175 | * put back the buffer returned by get_buffer_out; optional | |
176 | * buf must be equal the pointer returned by get_buffer_out, | |
177 | * size may be smaller | |
178 | */ | |
179 | size_t (*put_buffer_out)(HWVoiceOut *hw, void *buf, size_t size); | |
571a8c52 | 180 | void (*enable_out)(HWVoiceOut *hw, bool enable); |
cecc1e79 | 181 | void (*volume_out)(HWVoiceOut *hw, Volume *vol); |
ff095e52 KZ |
182 | |
183 | int (*init_in) (HWVoiceIn *hw, audsettings *as, void *drv_opaque); | |
184 | void (*fini_in) (HWVoiceIn *hw); | |
ff095e52 | 185 | size_t (*read) (HWVoiceIn *hw, void *buf, size_t size); |
a2893c83 | 186 | void (*run_buffer_in)(HWVoiceIn *hw); |
ff095e52 KZ |
187 | void *(*get_buffer_in)(HWVoiceIn *hw, size_t *size); |
188 | void (*put_buffer_in)(HWVoiceIn *hw, void *buf, size_t size); | |
571a8c52 | 189 | void (*enable_in)(HWVoiceIn *hw, bool enable); |
cecc1e79 | 190 | void (*volume_in)(HWVoiceIn *hw, Volume *vol); |
fb065187 FB |
191 | }; |
192 | ||
a2893c83 | 193 | void audio_generic_run_buffer_in(HWVoiceIn *hw); |
ff095e52 KZ |
194 | void *audio_generic_get_buffer_in(HWVoiceIn *hw, size_t *size); |
195 | void audio_generic_put_buffer_in(HWVoiceIn *hw, void *buf, size_t size); | |
fdc8c5f4 | 196 | void audio_generic_run_buffer_out(HWVoiceOut *hw); |
9833438e | 197 | size_t audio_generic_buffer_get_free(HWVoiceOut *hw); |
ff095e52 KZ |
198 | void *audio_generic_get_buffer_out(HWVoiceOut *hw, size_t *size); |
199 | size_t audio_generic_put_buffer_out(HWVoiceOut *hw, void *buf, size_t size); | |
ff095e52 KZ |
200 | size_t audio_generic_write(HWVoiceOut *hw, void *buf, size_t size); |
201 | size_t audio_generic_read(HWVoiceIn *hw, void *buf, size_t size); | |
202 | ||
8ead62cf FB |
203 | struct capture_callback { |
204 | struct audio_capture_ops ops; | |
205 | void *opaque; | |
72cf2d4f | 206 | QLIST_ENTRY (capture_callback) entries; |
8ead62cf FB |
207 | }; |
208 | ||
ec36b695 | 209 | struct CaptureVoiceOut { |
8ead62cf FB |
210 | HWVoiceOut hw; |
211 | void *buf; | |
72cf2d4f BS |
212 | QLIST_HEAD (cb_listhead, capture_callback) cb_head; |
213 | QLIST_ENTRY (CaptureVoiceOut) entries; | |
ec36b695 FB |
214 | }; |
215 | ||
216 | struct SWVoiceCap { | |
217 | SWVoiceOut sw; | |
218 | CaptureVoiceOut *cap; | |
72cf2d4f | 219 | QLIST_ENTRY (SWVoiceCap) entries; |
ec36b695 | 220 | }; |
8ead62cf | 221 | |
fd5283fb | 222 | typedef struct AudioState { |
c0fe3827 | 223 | struct audio_driver *drv; |
71830221 | 224 | Audiodev *dev; |
c0fe3827 FB |
225 | void *drv_opaque; |
226 | ||
227 | QEMUTimer *ts; | |
72cf2d4f BS |
228 | QLIST_HEAD (card_listhead, QEMUSoundCard) card_head; |
229 | QLIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in; | |
230 | QLIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out; | |
231 | QLIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head; | |
c0fe3827 FB |
232 | int nb_hw_voices_out; |
233 | int nb_hw_voices_in; | |
978dd635 | 234 | int vm_running; |
71830221 | 235 | int64_t period_ticks; |
526fb058 KZ |
236 | |
237 | bool timer_running; | |
238 | uint64_t timer_last; | |
ecd97e95 KZ |
239 | |
240 | QTAILQ_ENTRY(AudioState) list; | |
fd5283fb | 241 | } AudioState; |
c0fe3827 | 242 | |
00e07679 | 243 | extern const struct mixeng_volume nominal_volume; |
c0fe3827 | 244 | |
71830221 KZ |
245 | extern const char *audio_prio_list[]; |
246 | ||
d3893a39 GH |
247 | void audio_driver_register(audio_driver *drv); |
248 | audio_driver *audio_driver_lookup(const char *name); | |
249 | ||
1ea879e5 | 250 | void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as); |
1d14ffa9 FB |
251 | void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len); |
252 | ||
c0fe3827 FB |
253 | int audio_bug (const char *funcname, int cond); |
254 | void *audio_calloc (const char *funcname, int nmemb, size_t size); | |
255 | ||
18e2c177 | 256 | void audio_run(AudioState *s, const char *msg); |
713a98f8 | 257 | |
37a54d05 VR |
258 | const char *audio_application_name(void); |
259 | ||
857271a2 KZ |
260 | typedef struct RateCtl { |
261 | int64_t start_ticks; | |
262 | int64_t bytes_sent; | |
263 | } RateCtl; | |
264 | ||
265 | void audio_rate_start(RateCtl *rate); | |
266 | size_t audio_rate_get_bytes(struct audio_pcm_info *info, RateCtl *rate, | |
267 | size_t bytes_avail); | |
268 | ||
7520462b | 269 | static inline size_t audio_ring_dist(size_t dst, size_t src, size_t len) |
1d14ffa9 FB |
270 | { |
271 | return (dst >= src) ? (dst - src) : (len - src + dst); | |
272 | } | |
273 | ||
18404ff1 VR |
274 | /** |
275 | * audio_ring_posb() - returns new position in ringbuffer in backward | |
276 | * direction at given distance | |
277 | * | |
278 | * @pos: current position in ringbuffer | |
279 | * @dist: distance in ringbuffer to walk in reverse direction | |
280 | * @len: size of ringbuffer | |
281 | */ | |
282 | static inline size_t audio_ring_posb(size_t pos, size_t dist, size_t len) | |
283 | { | |
284 | return pos >= dist ? pos - dist : len - dist + pos; | |
285 | } | |
286 | ||
87e613ea | 287 | #define dolog(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__) |
1d14ffa9 FB |
288 | |
289 | #ifdef DEBUG | |
87e613ea | 290 | #define ldebug(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__) |
1d14ffa9 | 291 | #else |
87e613ea | 292 | #define ldebug(fmt, ...) (void)0 |
1d14ffa9 | 293 | #endif |
1d14ffa9 FB |
294 | |
295 | #define AUDIO_STRINGIFY_(n) #n | |
296 | #define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n) | |
297 | ||
71830221 KZ |
298 | typedef struct AudiodevListEntry { |
299 | Audiodev *dev; | |
300 | QSIMPLEQ_ENTRY(AudiodevListEntry) next; | |
301 | } AudiodevListEntry; | |
302 | ||
303 | typedef QSIMPLEQ_HEAD(, AudiodevListEntry) AudiodevListHead; | |
304 | AudiodevListHead audio_handle_legacy_opts(void); | |
305 | ||
306 | void audio_free_audiodev_list(AudiodevListHead *head); | |
307 | ||
308 | void audio_create_pdos(Audiodev *dev); | |
309 | AudiodevPerDirectionOptions *audio_get_pdo_in(Audiodev *dev); | |
310 | AudiodevPerDirectionOptions *audio_get_pdo_out(Audiodev *dev); | |
311 | ||
175de524 | 312 | #endif /* QEMU_AUDIO_INT_H */ |