2 * QEMU Audio subsystem header
4 * Copyright (c) 2005 Vassili Karpov (malc)
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:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
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
26 #define NAME "playback"
27 #define HWBUF hw->mix_buf
32 #define NAME "capture"
36 #define HWBUF hw->conv_buf
39 static void glue(audio_init_nb_voices_
, TYPE
)(AudioState
*s
,
40 struct audio_driver
*drv
)
42 int max_voices
= glue (drv
->max_voices_
, TYPE
);
43 size_t voice_size
= glue(drv
->voice_size_
, TYPE
);
45 if (glue (s
->nb_hw_voices_
, TYPE
) > max_voices
) {
48 dolog ("Driver `%s' does not support " NAME
"\n", drv
->name
);
51 dolog ("Driver `%s' does not support %d " NAME
" voices, max %d\n",
53 glue (s
->nb_hw_voices_
, TYPE
),
56 glue (s
->nb_hw_voices_
, TYPE
) = max_voices
;
59 if (audio_bug(__func__
, !voice_size
&& max_voices
)) {
60 dolog ("drv=`%s' voice_size=0 max_voices=%d\n",
61 drv
->name
, max_voices
);
62 glue (s
->nb_hw_voices_
, TYPE
) = 0;
65 if (audio_bug(__func__
, voice_size
&& !max_voices
)) {
66 dolog("drv=`%s' voice_size=%zu max_voices=0\n",
67 drv
->name
, voice_size
);
71 static void glue (audio_pcm_hw_free_resources_
, TYPE
) (HW
*hw
)
79 static void glue(audio_pcm_hw_alloc_resources_
, TYPE
)(HW
*hw
)
81 if (glue(audio_get_pdo_
, TYPE
)(hw
->s
->dev
)->mixing_engine
) {
82 size_t samples
= hw
->samples
;
83 if (audio_bug(__func__
, samples
== 0)) {
84 dolog("Attempted to allocate empty buffer\n");
87 HWBUF
.buffer
= g_new0(st_sample
, samples
);
96 static void glue (audio_pcm_sw_free_resources_
, TYPE
) (SW
*sw
)
98 g_free(sw
->resample_buf
.buffer
);
99 sw
->resample_buf
.buffer
= NULL
;
100 sw
->resample_buf
.size
= 0;
103 st_rate_stop (sw
->rate
);
108 static int glue (audio_pcm_sw_alloc_resources_
, TYPE
) (SW
*sw
)
113 if (!glue(audio_get_pdo_
, TYPE
)(sw
->s
->dev
)->mixing_engine
) {
117 samples
= muldiv64(HWBUF
.size
, sw
->info
.freq
, hw
->info
.freq
);
120 uint64_t f_be
= (uint32_t)hw
->info
.freq
;
122 /* f_fe_min = ceil(1 [frames] * f_be [Hz] / size_be [frames]) */
123 f_fe_min
= (f_be
+ HWBUF
.size
- 1) / HWBUF
.size
;
124 qemu_log_mask(LOG_UNIMP
,
125 AUDIO_CAP
": The guest selected a " NAME
" sample rate"
126 " of %d Hz for %s. Only sample rates >= %" PRIu64
" Hz"
128 sw
->info
.freq
, sw
->name
, f_fe_min
);
133 * Allocate one additional audio frame that is needed for upsampling
134 * if the resample buffer size is small. For large buffer sizes take
135 * care of overflows and truncation.
137 samples
= samples
< SIZE_MAX
? samples
+ 1 : SIZE_MAX
;
138 sw
->resample_buf
.buffer
= g_new0(st_sample
, samples
);
139 sw
->resample_buf
.size
= samples
;
140 sw
->resample_buf
.pos
= 0;
143 sw
->rate
= st_rate_start(sw
->info
.freq
, hw
->info
.freq
);
145 sw
->rate
= st_rate_start(hw
->info
.freq
, sw
->info
.freq
);
151 static int glue (audio_pcm_sw_init_
, TYPE
) (
155 struct audsettings
*as
160 audio_pcm_init_info (&sw
->info
, as
);
164 sw
->total_hw_samples_mixed
= 0;
168 if (sw
->info
.is_float
) {
170 sw
->conv
= mixeng_conv_float
[sw
->info
.nchannels
== 2];
172 sw
->clip
= mixeng_clip_float
[sw
->info
.nchannels
== 2];
176 sw
->conv
= mixeng_conv
178 sw
->clip
= mixeng_clip
180 [sw
->info
.nchannels
== 2]
182 [sw
->info
.swap_endianness
]
183 [audio_bits_to_index(sw
->info
.bits
)];
186 sw
->name
= g_strdup (name
);
187 err
= glue (audio_pcm_sw_alloc_resources_
, TYPE
) (sw
);
195 static void glue (audio_pcm_sw_fini_
, TYPE
) (SW
*sw
)
197 glue (audio_pcm_sw_free_resources_
, TYPE
) (sw
);
202 static void glue (audio_pcm_hw_add_sw_
, TYPE
) (HW
*hw
, SW
*sw
)
204 QLIST_INSERT_HEAD (&hw
->sw_head
, sw
, entries
);
207 static void glue (audio_pcm_hw_del_sw_
, TYPE
) (SW
*sw
)
209 QLIST_REMOVE (sw
, entries
);
212 static void glue (audio_pcm_hw_gc_
, TYPE
) (HW
**hwp
)
215 AudioState
*s
= hw
->s
;
217 if (!hw
->sw_head
.lh_first
) {
219 audio_detach_capture(hw
);
221 QLIST_REMOVE(hw
, entries
);
222 glue(hw
->pcm_ops
->fini_
, TYPE
) (hw
);
223 glue(s
->nb_hw_voices_
, TYPE
) += 1;
224 glue(audio_pcm_hw_free_resources_
, TYPE
) (hw
);
230 static HW
*glue(audio_pcm_hw_find_any_
, TYPE
)(AudioState
*s
, HW
*hw
)
232 return hw
? hw
->entries
.le_next
: glue (s
->hw_head_
, TYPE
).lh_first
;
235 static HW
*glue(audio_pcm_hw_find_any_enabled_
, TYPE
)(AudioState
*s
, HW
*hw
)
237 while ((hw
= glue(audio_pcm_hw_find_any_
, TYPE
)(s
, hw
))) {
245 static HW
*glue(audio_pcm_hw_find_specific_
, TYPE
)(AudioState
*s
, HW
*hw
,
246 struct audsettings
*as
)
248 while ((hw
= glue(audio_pcm_hw_find_any_
, TYPE
)(s
, hw
))) {
249 if (audio_pcm_info_eq (&hw
->info
, as
)) {
256 static HW
*glue(audio_pcm_hw_add_new_
, TYPE
)(AudioState
*s
,
257 struct audsettings
*as
)
260 struct audio_driver
*drv
= s
->drv
;
262 if (!glue (s
->nb_hw_voices_
, TYPE
)) {
266 if (audio_bug(__func__
, !drv
)) {
267 dolog ("No host audio driver\n");
271 if (audio_bug(__func__
, !drv
->pcm_ops
)) {
272 dolog ("Host audio driver without pcm_ops\n");
277 * Since glue(s->nb_hw_voices_, TYPE) is != 0, glue(drv->voice_size_, TYPE)
278 * is guaranteed to be != 0. See the audio_init_nb_voices_* functions.
280 hw
= g_malloc0(glue(drv
->voice_size_
, TYPE
));
282 hw
->pcm_ops
= drv
->pcm_ops
;
284 QLIST_INIT (&hw
->sw_head
);
286 QLIST_INIT (&hw
->cap_head
);
288 if (glue (hw
->pcm_ops
->init_
, TYPE
) (hw
, as
, s
->drv_opaque
)) {
292 if (audio_bug(__func__
, hw
->samples
<= 0)) {
293 dolog("hw->samples=%zd\n", hw
->samples
);
297 if (hw
->info
.is_float
) {
299 hw
->clip
= mixeng_clip_float
[hw
->info
.nchannels
== 2];
301 hw
->conv
= mixeng_conv_float
[hw
->info
.nchannels
== 2];
305 hw
->clip
= mixeng_clip
307 hw
->conv
= mixeng_conv
309 [hw
->info
.nchannels
== 2]
311 [hw
->info
.swap_endianness
]
312 [audio_bits_to_index(hw
->info
.bits
)];
315 glue(audio_pcm_hw_alloc_resources_
, TYPE
)(hw
);
317 QLIST_INSERT_HEAD (&s
->glue (hw_head_
, TYPE
), hw
, entries
);
318 glue (s
->nb_hw_voices_
, TYPE
) -= 1;
320 audio_attach_capture (hw
);
325 glue (hw
->pcm_ops
->fini_
, TYPE
) (hw
);
331 AudiodevPerDirectionOptions
*glue(audio_get_pdo_
, TYPE
)(Audiodev
*dev
)
333 switch (dev
->driver
) {
334 case AUDIODEV_DRIVER_NONE
:
335 return dev
->u
.none
.TYPE
;
336 #ifdef CONFIG_AUDIO_ALSA
337 case AUDIODEV_DRIVER_ALSA
:
338 return qapi_AudiodevAlsaPerDirectionOptions_base(dev
->u
.alsa
.TYPE
);
340 #ifdef CONFIG_AUDIO_COREAUDIO
341 case AUDIODEV_DRIVER_COREAUDIO
:
342 return qapi_AudiodevCoreaudioPerDirectionOptions_base(
343 dev
->u
.coreaudio
.TYPE
);
345 #ifdef CONFIG_DBUS_DISPLAY
346 case AUDIODEV_DRIVER_DBUS
:
347 return dev
->u
.dbus
.TYPE
;
349 #ifdef CONFIG_AUDIO_DSOUND
350 case AUDIODEV_DRIVER_DSOUND
:
351 return dev
->u
.dsound
.TYPE
;
353 #ifdef CONFIG_AUDIO_JACK
354 case AUDIODEV_DRIVER_JACK
:
355 return qapi_AudiodevJackPerDirectionOptions_base(dev
->u
.jack
.TYPE
);
357 #ifdef CONFIG_AUDIO_OSS
358 case AUDIODEV_DRIVER_OSS
:
359 return qapi_AudiodevOssPerDirectionOptions_base(dev
->u
.oss
.TYPE
);
361 #ifdef CONFIG_AUDIO_PA
362 case AUDIODEV_DRIVER_PA
:
363 return qapi_AudiodevPaPerDirectionOptions_base(dev
->u
.pa
.TYPE
);
365 #ifdef CONFIG_AUDIO_PIPEWIRE
366 case AUDIODEV_DRIVER_PIPEWIRE
:
367 return qapi_AudiodevPipewirePerDirectionOptions_base(dev
->u
.pipewire
.TYPE
);
369 #ifdef CONFIG_AUDIO_SDL
370 case AUDIODEV_DRIVER_SDL
:
371 return qapi_AudiodevSdlPerDirectionOptions_base(dev
->u
.sdl
.TYPE
);
373 #ifdef CONFIG_AUDIO_SNDIO
374 case AUDIODEV_DRIVER_SNDIO
:
375 return dev
->u
.sndio
.TYPE
;
378 case AUDIODEV_DRIVER_SPICE
:
379 return dev
->u
.spice
.TYPE
;
381 case AUDIODEV_DRIVER_WAV
:
382 return dev
->u
.wav
.TYPE
;
384 case AUDIODEV_DRIVER__MAX
:
390 static HW
*glue(audio_pcm_hw_add_
, TYPE
)(AudioState
*s
, struct audsettings
*as
)
393 AudiodevPerDirectionOptions
*pdo
= glue(audio_get_pdo_
, TYPE
)(s
->dev
);
395 if (!pdo
->mixing_engine
|| pdo
->fixed_settings
) {
396 hw
= glue(audio_pcm_hw_add_new_
, TYPE
)(s
, as
);
397 if (!pdo
->mixing_engine
|| hw
) {
402 hw
= glue(audio_pcm_hw_find_specific_
, TYPE
)(s
, NULL
, as
);
407 hw
= glue(audio_pcm_hw_add_new_
, TYPE
)(s
, as
);
412 return glue(audio_pcm_hw_find_any_
, TYPE
)(s
, NULL
);
415 static SW
*glue(audio_pcm_create_voice_pair_
, TYPE
)(
418 struct audsettings
*as
423 struct audsettings hw_as
;
424 AudiodevPerDirectionOptions
*pdo
= glue(audio_get_pdo_
, TYPE
)(s
->dev
);
426 if (pdo
->fixed_settings
) {
427 hw_as
= audiodev_to_audsettings(pdo
);
435 hw
= glue(audio_pcm_hw_add_
, TYPE
)(s
, &hw_as
);
437 dolog("Could not create a backend for voice `%s'\n", sw_name
);
441 glue (audio_pcm_hw_add_sw_
, TYPE
) (hw
, sw
);
443 if (glue (audio_pcm_sw_init_
, TYPE
) (sw
, hw
, sw_name
, as
)) {
450 glue (audio_pcm_hw_del_sw_
, TYPE
) (sw
);
451 glue (audio_pcm_hw_gc_
, TYPE
) (&hw
);
457 static void glue (audio_close_
, TYPE
) (SW
*sw
)
459 glue (audio_pcm_sw_fini_
, TYPE
) (sw
);
460 glue (audio_pcm_hw_del_sw_
, TYPE
) (sw
);
461 glue (audio_pcm_hw_gc_
, TYPE
) (&sw
->hw
);
465 void glue (AUD_close_
, TYPE
) (QEMUSoundCard
*card
, SW
*sw
)
468 if (audio_bug(__func__
, !card
)) {
469 dolog ("card=%p\n", card
);
473 glue (audio_close_
, TYPE
) (sw
);
477 SW
*glue (AUD_open_
, TYPE
) (
481 void *callback_opaque
,
482 audio_callback_fn callback_fn
,
483 struct audsettings
*as
487 AudiodevPerDirectionOptions
*pdo
;
489 if (audio_bug(__func__
, !card
|| !name
|| !callback_fn
|| !as
)) {
490 dolog ("card=%p name=%p callback_fn=%p as=%p\n",
491 card
, name
, callback_fn
, as
);
496 pdo
= glue(audio_get_pdo_
, TYPE
)(s
->dev
);
498 ldebug ("open %s, freq %d, nchannels %d, fmt %d\n",
499 name
, as
->freq
, as
->nchannels
, as
->fmt
);
501 if (audio_bug(__func__
, audio_validate_settings(as
))) {
502 audio_print_settings (as
);
506 if (audio_bug(__func__
, !s
->drv
)) {
507 dolog ("Can not open `%s' (no host audio driver)\n", name
);
511 if (sw
&& audio_pcm_info_eq (&sw
->info
, as
)) {
515 if (!pdo
->fixed_settings
&& sw
) {
516 glue (AUD_close_
, TYPE
) (card
, sw
);
524 dolog("Internal logic error: voice `%s' has no backend\n",
529 glue (audio_pcm_sw_fini_
, TYPE
) (sw
);
530 if (glue (audio_pcm_sw_init_
, TYPE
) (sw
, hw
, name
, as
)) {
534 sw
= glue(audio_pcm_create_voice_pair_
, TYPE
)(s
, name
, as
);
541 sw
->vol
= nominal_volume
;
542 sw
->callback
.fn
= callback_fn
;
543 sw
->callback
.opaque
= callback_opaque
;
546 dolog ("%s\n", name
);
547 audio_pcm_print_info ("hw", &sw
->hw
->info
);
548 audio_pcm_print_info ("sw", &sw
->info
);
554 glue (AUD_close_
, TYPE
) (card
, sw
);
558 int glue (AUD_is_active_
, TYPE
) (SW
*sw
)
560 return sw
? sw
->active
: 0;
563 void glue (AUD_init_time_stamp_
, TYPE
) (SW
*sw
, QEMUAudioTimeStamp
*ts
)
569 ts
->old_ts
= sw
->hw
->ts_helper
;
572 uint64_t glue (AUD_get_elapsed_usec_
, TYPE
) (SW
*sw
, QEMUAudioTimeStamp
*ts
)
574 uint64_t delta
, cur_ts
, old_ts
;
580 cur_ts
= sw
->hw
->ts_helper
;
582 /* dolog ("cur %" PRId64 " old %" PRId64 "\n", cur_ts, old_ts); */
584 if (cur_ts
>= old_ts
) {
585 delta
= cur_ts
- old_ts
;
587 delta
= UINT64_MAX
- old_ts
+ cur_ts
;
594 return muldiv64 (delta
, sw
->hw
->info
.freq
, 1000000);