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
)
78 static void glue(audio_pcm_hw_alloc_resources_
, TYPE
)(HW
*hw
)
80 if (glue(audio_get_pdo_
, TYPE
)(hw
->s
->dev
)->mixing_engine
) {
81 size_t samples
= hw
->samples
;
82 if (audio_bug(__func__
, samples
== 0)) {
83 dolog("Attempted to allocate empty buffer\n");
86 HWBUF
= g_malloc0(sizeof(STSampleBuffer
) + sizeof(st_sample
) * samples
);
87 HWBUF
->size
= samples
;
93 static void glue (audio_pcm_sw_free_resources_
, TYPE
) (SW
*sw
)
98 st_rate_stop (sw
->rate
);
105 static int glue (audio_pcm_sw_alloc_resources_
, TYPE
) (SW
*sw
)
109 if (!glue(audio_get_pdo_
, TYPE
)(sw
->s
->dev
)->mixing_engine
) {
114 samples
= ((int64_t) sw
->HWBUF
->size
<< 32) / sw
->ratio
;
116 samples
= (int64_t)sw
->HWBUF
->size
* sw
->ratio
>> 32;
118 if (audio_bug(__func__
, samples
< 0)) {
119 dolog("Can not allocate buffer for `%s' (%d samples)\n",
120 SW_NAME(sw
), samples
);
128 /* f_fe_min = ceil(1 [frames] * f_be [Hz] / size_be [frames]) */
129 f_fe_min
= (hw
->info
.freq
+ HWBUF
->size
- 1) / HWBUF
->size
;
130 qemu_log_mask(LOG_UNIMP
,
131 AUDIO_CAP
": The guest selected a " NAME
" sample rate"
132 " of %d Hz for %s. Only sample rates >= %zu Hz are"
134 sw
->info
.freq
, sw
->name
, f_fe_min
);
138 sw
->buf
= g_new0(st_sample
, samples
);
141 sw
->rate
= st_rate_start (sw
->info
.freq
, sw
->hw
->info
.freq
);
143 sw
->rate
= st_rate_start (sw
->hw
->info
.freq
, sw
->info
.freq
);
149 static int glue (audio_pcm_sw_init_
, TYPE
) (
153 struct audsettings
*as
158 audio_pcm_init_info (&sw
->info
, as
);
162 sw
->ratio
= ((int64_t) sw
->hw
->info
.freq
<< 32) / sw
->info
.freq
;
163 sw
->total_hw_samples_mixed
= 0;
166 sw
->ratio
= ((int64_t) sw
->info
.freq
<< 32) / sw
->hw
->info
.freq
;
169 if (sw
->info
.is_float
) {
171 sw
->conv
= mixeng_conv_float
[sw
->info
.nchannels
== 2];
173 sw
->clip
= mixeng_clip_float
[sw
->info
.nchannels
== 2];
177 sw
->conv
= mixeng_conv
179 sw
->clip
= mixeng_clip
181 [sw
->info
.nchannels
== 2]
183 [sw
->info
.swap_endianness
]
184 [audio_bits_to_index(sw
->info
.bits
)];
187 sw
->name
= g_strdup (name
);
188 err
= glue (audio_pcm_sw_alloc_resources_
, TYPE
) (sw
);
196 static void glue (audio_pcm_sw_fini_
, TYPE
) (SW
*sw
)
198 glue (audio_pcm_sw_free_resources_
, TYPE
) (sw
);
203 static void glue (audio_pcm_hw_add_sw_
, TYPE
) (HW
*hw
, SW
*sw
)
205 QLIST_INSERT_HEAD (&hw
->sw_head
, sw
, entries
);
208 static void glue (audio_pcm_hw_del_sw_
, TYPE
) (SW
*sw
)
210 QLIST_REMOVE (sw
, entries
);
213 static void glue (audio_pcm_hw_gc_
, TYPE
) (HW
**hwp
)
216 AudioState
*s
= hw
->s
;
218 if (!hw
->sw_head
.lh_first
) {
220 audio_detach_capture(hw
);
222 QLIST_REMOVE(hw
, entries
);
223 glue(hw
->pcm_ops
->fini_
, TYPE
) (hw
);
224 glue(s
->nb_hw_voices_
, TYPE
) += 1;
225 glue(audio_pcm_hw_free_resources_
, TYPE
) (hw
);
231 static HW
*glue(audio_pcm_hw_find_any_
, TYPE
)(AudioState
*s
, HW
*hw
)
233 return hw
? hw
->entries
.le_next
: glue (s
->hw_head_
, TYPE
).lh_first
;
236 static HW
*glue(audio_pcm_hw_find_any_enabled_
, TYPE
)(AudioState
*s
, HW
*hw
)
238 while ((hw
= glue(audio_pcm_hw_find_any_
, TYPE
)(s
, hw
))) {
246 static HW
*glue(audio_pcm_hw_find_specific_
, TYPE
)(AudioState
*s
, HW
*hw
,
247 struct audsettings
*as
)
249 while ((hw
= glue(audio_pcm_hw_find_any_
, TYPE
)(s
, hw
))) {
250 if (audio_pcm_info_eq (&hw
->info
, as
)) {
257 static HW
*glue(audio_pcm_hw_add_new_
, TYPE
)(AudioState
*s
,
258 struct audsettings
*as
)
261 struct audio_driver
*drv
= s
->drv
;
263 if (!glue (s
->nb_hw_voices_
, TYPE
)) {
267 if (audio_bug(__func__
, !drv
)) {
268 dolog ("No host audio driver\n");
272 if (audio_bug(__func__
, !drv
->pcm_ops
)) {
273 dolog ("Host audio driver without pcm_ops\n");
278 * Since glue(s->nb_hw_voices_, TYPE) is != 0, glue(drv->voice_size_, TYPE)
279 * is guaranteed to be != 0. See the audio_init_nb_voices_* functions.
281 hw
= g_malloc0(glue(drv
->voice_size_
, TYPE
));
283 hw
->pcm_ops
= drv
->pcm_ops
;
285 QLIST_INIT (&hw
->sw_head
);
287 QLIST_INIT (&hw
->cap_head
);
289 if (glue (hw
->pcm_ops
->init_
, TYPE
) (hw
, as
, s
->drv_opaque
)) {
293 if (audio_bug(__func__
, hw
->samples
<= 0)) {
294 dolog("hw->samples=%zd\n", hw
->samples
);
298 if (hw
->info
.is_float
) {
300 hw
->clip
= mixeng_clip_float
[hw
->info
.nchannels
== 2];
302 hw
->conv
= mixeng_conv_float
[hw
->info
.nchannels
== 2];
306 hw
->clip
= mixeng_clip
308 hw
->conv
= mixeng_conv
310 [hw
->info
.nchannels
== 2]
312 [hw
->info
.swap_endianness
]
313 [audio_bits_to_index(hw
->info
.bits
)];
316 glue(audio_pcm_hw_alloc_resources_
, TYPE
)(hw
);
318 QLIST_INSERT_HEAD (&s
->glue (hw_head_
, TYPE
), hw
, entries
);
319 glue (s
->nb_hw_voices_
, TYPE
) -= 1;
321 audio_attach_capture (hw
);
326 glue (hw
->pcm_ops
->fini_
, TYPE
) (hw
);
332 AudiodevPerDirectionOptions
*glue(audio_get_pdo_
, TYPE
)(Audiodev
*dev
)
334 switch (dev
->driver
) {
335 case AUDIODEV_DRIVER_NONE
:
336 return dev
->u
.none
.TYPE
;
337 #ifdef CONFIG_AUDIO_ALSA
338 case AUDIODEV_DRIVER_ALSA
:
339 return qapi_AudiodevAlsaPerDirectionOptions_base(dev
->u
.alsa
.TYPE
);
341 #ifdef CONFIG_AUDIO_COREAUDIO
342 case AUDIODEV_DRIVER_COREAUDIO
:
343 return qapi_AudiodevCoreaudioPerDirectionOptions_base(
344 dev
->u
.coreaudio
.TYPE
);
346 #ifdef CONFIG_DBUS_DISPLAY
347 case AUDIODEV_DRIVER_DBUS
:
348 return dev
->u
.dbus
.TYPE
;
350 #ifdef CONFIG_AUDIO_DSOUND
351 case AUDIODEV_DRIVER_DSOUND
:
352 return dev
->u
.dsound
.TYPE
;
354 #ifdef CONFIG_AUDIO_JACK
355 case AUDIODEV_DRIVER_JACK
:
356 return qapi_AudiodevJackPerDirectionOptions_base(dev
->u
.jack
.TYPE
);
358 #ifdef CONFIG_AUDIO_OSS
359 case AUDIODEV_DRIVER_OSS
:
360 return qapi_AudiodevOssPerDirectionOptions_base(dev
->u
.oss
.TYPE
);
362 #ifdef CONFIG_AUDIO_PA
363 case AUDIODEV_DRIVER_PA
:
364 return qapi_AudiodevPaPerDirectionOptions_base(dev
->u
.pa
.TYPE
);
366 #ifdef CONFIG_AUDIO_SDL
367 case AUDIODEV_DRIVER_SDL
:
368 return qapi_AudiodevSdlPerDirectionOptions_base(dev
->u
.sdl
.TYPE
);
370 #ifdef CONFIG_AUDIO_SNDIO
371 case AUDIODEV_DRIVER_SNDIO
:
372 return dev
->u
.sndio
.TYPE
;
375 case AUDIODEV_DRIVER_SPICE
:
376 return dev
->u
.spice
.TYPE
;
378 case AUDIODEV_DRIVER_WAV
:
379 return dev
->u
.wav
.TYPE
;
381 case AUDIODEV_DRIVER__MAX
:
387 static HW
*glue(audio_pcm_hw_add_
, TYPE
)(AudioState
*s
, struct audsettings
*as
)
390 AudiodevPerDirectionOptions
*pdo
= glue(audio_get_pdo_
, TYPE
)(s
->dev
);
392 if (!pdo
->mixing_engine
|| pdo
->fixed_settings
) {
393 hw
= glue(audio_pcm_hw_add_new_
, TYPE
)(s
, as
);
394 if (!pdo
->mixing_engine
|| hw
) {
399 hw
= glue(audio_pcm_hw_find_specific_
, TYPE
)(s
, NULL
, as
);
404 hw
= glue(audio_pcm_hw_add_new_
, TYPE
)(s
, as
);
409 return glue(audio_pcm_hw_find_any_
, TYPE
)(s
, NULL
);
412 static SW
*glue(audio_pcm_create_voice_pair_
, TYPE
)(
415 struct audsettings
*as
420 struct audsettings hw_as
;
421 AudiodevPerDirectionOptions
*pdo
= glue(audio_get_pdo_
, TYPE
)(s
->dev
);
423 if (pdo
->fixed_settings
) {
424 hw_as
= audiodev_to_audsettings(pdo
);
432 hw
= glue(audio_pcm_hw_add_
, TYPE
)(s
, &hw_as
);
434 dolog("Could not create a backend for voice `%s'\n", sw_name
);
438 glue (audio_pcm_hw_add_sw_
, TYPE
) (hw
, sw
);
440 if (glue (audio_pcm_sw_init_
, TYPE
) (sw
, hw
, sw_name
, as
)) {
447 glue (audio_pcm_hw_del_sw_
, TYPE
) (sw
);
448 glue (audio_pcm_hw_gc_
, TYPE
) (&hw
);
454 static void glue (audio_close_
, TYPE
) (SW
*sw
)
456 glue (audio_pcm_sw_fini_
, TYPE
) (sw
);
457 glue (audio_pcm_hw_del_sw_
, TYPE
) (sw
);
458 glue (audio_pcm_hw_gc_
, TYPE
) (&sw
->hw
);
462 void glue (AUD_close_
, TYPE
) (QEMUSoundCard
*card
, SW
*sw
)
465 if (audio_bug(__func__
, !card
)) {
466 dolog ("card=%p\n", card
);
470 glue (audio_close_
, TYPE
) (sw
);
474 SW
*glue (AUD_open_
, TYPE
) (
478 void *callback_opaque
,
479 audio_callback_fn callback_fn
,
480 struct audsettings
*as
484 AudiodevPerDirectionOptions
*pdo
;
486 if (audio_bug(__func__
, !card
|| !name
|| !callback_fn
|| !as
)) {
487 dolog ("card=%p name=%p callback_fn=%p as=%p\n",
488 card
, name
, callback_fn
, as
);
493 pdo
= glue(audio_get_pdo_
, TYPE
)(s
->dev
);
495 ldebug ("open %s, freq %d, nchannels %d, fmt %d\n",
496 name
, as
->freq
, as
->nchannels
, as
->fmt
);
498 if (audio_bug(__func__
, audio_validate_settings(as
))) {
499 audio_print_settings (as
);
503 if (audio_bug(__func__
, !s
->drv
)) {
504 dolog ("Can not open `%s' (no host audio driver)\n", name
);
508 if (sw
&& audio_pcm_info_eq (&sw
->info
, as
)) {
512 if (!pdo
->fixed_settings
&& sw
) {
513 glue (AUD_close_
, TYPE
) (card
, sw
);
521 dolog("Internal logic error: voice `%s' has no backend\n",
526 glue (audio_pcm_sw_fini_
, TYPE
) (sw
);
527 if (glue (audio_pcm_sw_init_
, TYPE
) (sw
, hw
, name
, as
)) {
531 sw
= glue(audio_pcm_create_voice_pair_
, TYPE
)(s
, name
, as
);
538 sw
->vol
= nominal_volume
;
539 sw
->callback
.fn
= callback_fn
;
540 sw
->callback
.opaque
= callback_opaque
;
543 dolog ("%s\n", name
);
544 audio_pcm_print_info ("hw", &sw
->hw
->info
);
545 audio_pcm_print_info ("sw", &sw
->info
);
551 glue (AUD_close_
, TYPE
) (card
, sw
);
555 int glue (AUD_is_active_
, TYPE
) (SW
*sw
)
557 return sw
? sw
->active
: 0;
560 void glue (AUD_init_time_stamp_
, TYPE
) (SW
*sw
, QEMUAudioTimeStamp
*ts
)
566 ts
->old_ts
= sw
->hw
->ts_helper
;
569 uint64_t glue (AUD_get_elapsed_usec_
, TYPE
) (SW
*sw
, QEMUAudioTimeStamp
*ts
)
571 uint64_t delta
, cur_ts
, old_ts
;
577 cur_ts
= sw
->hw
->ts_helper
;
579 /* dolog ("cur %" PRId64 " old %" PRId64 "\n", cur_ts, old_ts); */
581 if (cur_ts
>= old_ts
) {
582 delta
= cur_ts
- old_ts
;
584 delta
= UINT64_MAX
- old_ts
+ cur_ts
;
591 return muldiv64 (delta
, sw
->hw
->info
.freq
, 1000000);