]>
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; | |
8dbd3d17 | 61 | st_sample *buffer; |
dc88e38f KZ |
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 | |
8dbd3d17 | 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 | |
8dbd3d17 | 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; |
2c3f9a0a | 111 | STSampleBuffer resample_buf; |
fb065187 | 112 | void *rate; |
7520462b | 113 | size_t total_hw_samples_mixed; |
1d14ffa9 FB |
114 | int active; |
115 | int empty; | |
116 | HWVoiceOut *hw; | |
117 | char *name; | |
1ea879e5 | 118 | struct mixeng_volume vol; |
1d14ffa9 | 119 | struct audio_callback callback; |
72cf2d4f | 120 | QLIST_ENTRY (SWVoiceOut) entries; |
1d14ffa9 | 121 | }; |
fb065187 | 122 | |
1d14ffa9 | 123 | struct SWVoiceIn { |
1a7dafce | 124 | QEMUSoundCard *card; |
526fb058 | 125 | AudioState *s; |
fb065187 | 126 | int active; |
1d14ffa9 | 127 | struct audio_pcm_info info; |
1d14ffa9 | 128 | void *rate; |
7520462b | 129 | size_t total_hw_samples_acquired; |
2c3f9a0a | 130 | STSampleBuffer resample_buf; |
1d14ffa9 FB |
131 | f_sample *clip; |
132 | HWVoiceIn *hw; | |
fb065187 | 133 | char *name; |
1ea879e5 | 134 | struct mixeng_volume vol; |
1d14ffa9 | 135 | struct audio_callback callback; |
72cf2d4f | 136 | QLIST_ENTRY (SWVoiceIn) entries; |
fb065187 FB |
137 | }; |
138 | ||
d3893a39 | 139 | typedef struct audio_driver audio_driver; |
c0fe3827 FB |
140 | struct audio_driver { |
141 | const char *name; | |
142 | const char *descr; | |
f6061733 | 143 | void *(*init) (Audiodev *, Error **); |
c0fe3827 | 144 | void (*fini) (void *); |
739362d4 | 145 | #ifdef CONFIG_GIO |
e74fec9a | 146 | void (*set_dbus_server) (AudioState *s, GDBusObjectManagerServer *manager, bool p2p); |
739362d4 | 147 | #endif |
35f4b58c | 148 | struct audio_pcm_ops *pcm_ops; |
c0fe3827 FB |
149 | int max_voices_out; |
150 | int max_voices_in; | |
3724ab3b VR |
151 | size_t voice_size_out; |
152 | size_t voice_size_in; | |
d3893a39 | 153 | QLIST_ENTRY(audio_driver) next; |
c0fe3827 FB |
154 | }; |
155 | ||
1d14ffa9 | 156 | struct audio_pcm_ops { |
ff095e52 KZ |
157 | int (*init_out)(HWVoiceOut *hw, audsettings *as, void *drv_opaque); |
158 | void (*fini_out)(HWVoiceOut *hw); | |
ff095e52 | 159 | size_t (*write) (HWVoiceOut *hw, void *buf, size_t size); |
fdc8c5f4 | 160 | void (*run_buffer_out)(HWVoiceOut *hw); |
9833438e VR |
161 | /* |
162 | * Get the free output buffer size. This is an upper limit. The size | |
163 | * returned by function get_buffer_out may be smaller. | |
164 | */ | |
165 | size_t (*buffer_get_free)(HWVoiceOut *hw); | |
ff095e52 KZ |
166 | /* |
167 | * get a buffer that after later can be passed to put_buffer_out; optional | |
168 | * returns the buffer, and writes it's size to size (in bytes) | |
ff095e52 KZ |
169 | */ |
170 | void *(*get_buffer_out)(HWVoiceOut *hw, size_t *size); | |
171 | /* | |
172 | * put back the buffer returned by get_buffer_out; optional | |
173 | * buf must be equal the pointer returned by get_buffer_out, | |
174 | * size may be smaller | |
175 | */ | |
176 | size_t (*put_buffer_out)(HWVoiceOut *hw, void *buf, size_t size); | |
571a8c52 | 177 | void (*enable_out)(HWVoiceOut *hw, bool enable); |
cecc1e79 | 178 | void (*volume_out)(HWVoiceOut *hw, Volume *vol); |
ff095e52 KZ |
179 | |
180 | int (*init_in) (HWVoiceIn *hw, audsettings *as, void *drv_opaque); | |
181 | void (*fini_in) (HWVoiceIn *hw); | |
ff095e52 | 182 | size_t (*read) (HWVoiceIn *hw, void *buf, size_t size); |
a2893c83 | 183 | void (*run_buffer_in)(HWVoiceIn *hw); |
ff095e52 KZ |
184 | void *(*get_buffer_in)(HWVoiceIn *hw, size_t *size); |
185 | void (*put_buffer_in)(HWVoiceIn *hw, void *buf, size_t size); | |
571a8c52 | 186 | void (*enable_in)(HWVoiceIn *hw, bool enable); |
cecc1e79 | 187 | void (*volume_in)(HWVoiceIn *hw, Volume *vol); |
fb065187 FB |
188 | }; |
189 | ||
a2893c83 | 190 | void audio_generic_run_buffer_in(HWVoiceIn *hw); |
ff095e52 KZ |
191 | void *audio_generic_get_buffer_in(HWVoiceIn *hw, size_t *size); |
192 | void audio_generic_put_buffer_in(HWVoiceIn *hw, void *buf, size_t size); | |
fdc8c5f4 | 193 | void audio_generic_run_buffer_out(HWVoiceOut *hw); |
9833438e | 194 | size_t audio_generic_buffer_get_free(HWVoiceOut *hw); |
ff095e52 KZ |
195 | void *audio_generic_get_buffer_out(HWVoiceOut *hw, size_t *size); |
196 | size_t audio_generic_put_buffer_out(HWVoiceOut *hw, void *buf, size_t size); | |
ff095e52 KZ |
197 | size_t audio_generic_write(HWVoiceOut *hw, void *buf, size_t size); |
198 | size_t audio_generic_read(HWVoiceIn *hw, void *buf, size_t size); | |
199 | ||
8ead62cf FB |
200 | struct capture_callback { |
201 | struct audio_capture_ops ops; | |
202 | void *opaque; | |
72cf2d4f | 203 | QLIST_ENTRY (capture_callback) entries; |
8ead62cf FB |
204 | }; |
205 | ||
ec36b695 | 206 | struct CaptureVoiceOut { |
8ead62cf FB |
207 | HWVoiceOut hw; |
208 | void *buf; | |
72cf2d4f BS |
209 | QLIST_HEAD (cb_listhead, capture_callback) cb_head; |
210 | QLIST_ENTRY (CaptureVoiceOut) entries; | |
ec36b695 FB |
211 | }; |
212 | ||
213 | struct SWVoiceCap { | |
214 | SWVoiceOut sw; | |
215 | CaptureVoiceOut *cap; | |
72cf2d4f | 216 | QLIST_ENTRY (SWVoiceCap) entries; |
ec36b695 | 217 | }; |
8ead62cf | 218 | |
fd5283fb | 219 | typedef struct AudioState { |
c0fe3827 | 220 | struct audio_driver *drv; |
71830221 | 221 | Audiodev *dev; |
c0fe3827 FB |
222 | void *drv_opaque; |
223 | ||
224 | QEMUTimer *ts; | |
72cf2d4f BS |
225 | QLIST_HEAD (card_listhead, QEMUSoundCard) card_head; |
226 | QLIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in; | |
227 | QLIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out; | |
228 | QLIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head; | |
c0fe3827 FB |
229 | int nb_hw_voices_out; |
230 | int nb_hw_voices_in; | |
978dd635 | 231 | int vm_running; |
71830221 | 232 | int64_t period_ticks; |
526fb058 KZ |
233 | |
234 | bool timer_running; | |
235 | uint64_t timer_last; | |
ecd97e95 KZ |
236 | |
237 | QTAILQ_ENTRY(AudioState) list; | |
fd5283fb | 238 | } AudioState; |
c0fe3827 | 239 | |
00e07679 | 240 | extern const struct mixeng_volume nominal_volume; |
c0fe3827 | 241 | |
71830221 KZ |
242 | extern const char *audio_prio_list[]; |
243 | ||
d3893a39 | 244 | void audio_driver_register(audio_driver *drv); |
d3893a39 | 245 | |
1ea879e5 | 246 | void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as); |
1d14ffa9 FB |
247 | void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len); |
248 | ||
c0fe3827 | 249 | int audio_bug (const char *funcname, int cond); |
c0fe3827 | 250 | |
18e2c177 | 251 | void audio_run(AudioState *s, const char *msg); |
713a98f8 | 252 | |
37a54d05 VR |
253 | const char *audio_application_name(void); |
254 | ||
857271a2 KZ |
255 | typedef struct RateCtl { |
256 | int64_t start_ticks; | |
257 | int64_t bytes_sent; | |
258 | } RateCtl; | |
259 | ||
260 | void audio_rate_start(RateCtl *rate); | |
02732641 VR |
261 | size_t audio_rate_peek_bytes(RateCtl *rate, struct audio_pcm_info *info); |
262 | void audio_rate_add_bytes(RateCtl *rate, size_t bytes_used); | |
613fe02b | 263 | size_t audio_rate_get_bytes(RateCtl *rate, struct audio_pcm_info *info, |
857271a2 KZ |
264 | size_t bytes_avail); |
265 | ||
7520462b | 266 | static inline size_t audio_ring_dist(size_t dst, size_t src, size_t len) |
1d14ffa9 FB |
267 | { |
268 | return (dst >= src) ? (dst - src) : (len - src + dst); | |
269 | } | |
270 | ||
18404ff1 VR |
271 | /** |
272 | * audio_ring_posb() - returns new position in ringbuffer in backward | |
273 | * direction at given distance | |
274 | * | |
275 | * @pos: current position in ringbuffer | |
276 | * @dist: distance in ringbuffer to walk in reverse direction | |
277 | * @len: size of ringbuffer | |
278 | */ | |
279 | static inline size_t audio_ring_posb(size_t pos, size_t dist, size_t len) | |
280 | { | |
281 | return pos >= dist ? pos - dist : len - dist + pos; | |
282 | } | |
283 | ||
87e613ea | 284 | #define dolog(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__) |
1d14ffa9 FB |
285 | |
286 | #ifdef DEBUG | |
87e613ea | 287 | #define ldebug(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__) |
1d14ffa9 | 288 | #else |
87e613ea | 289 | #define ldebug(fmt, ...) (void)0 |
1d14ffa9 | 290 | #endif |
1d14ffa9 | 291 | |
71830221 KZ |
292 | typedef struct AudiodevListEntry { |
293 | Audiodev *dev; | |
294 | QSIMPLEQ_ENTRY(AudiodevListEntry) next; | |
295 | } AudiodevListEntry; | |
296 | ||
297 | typedef QSIMPLEQ_HEAD(, AudiodevListEntry) AudiodevListHead; | |
71830221 KZ |
298 | |
299 | void audio_create_pdos(Audiodev *dev); | |
300 | AudiodevPerDirectionOptions *audio_get_pdo_in(Audiodev *dev); | |
301 | AudiodevPerDirectionOptions *audio_get_pdo_out(Audiodev *dev); | |
302 | ||
175de524 | 303 | #endif /* QEMU_AUDIO_INT_H */ |