4 * Copyright (c) 2003-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
24 #include "qemu/osdep.h"
27 #include "monitor/monitor.h"
28 #include "qemu/timer.h"
29 #include "sysemu/sysemu.h"
30 #include "qemu/cutils.h"
31 #include "sysemu/replay.h"
33 #define AUDIO_CAP "audio"
34 #include "audio_int.h"
36 /* #define DEBUG_LIVE */
37 /* #define DEBUG_OUT */
38 /* #define DEBUG_CAPTURE */
39 /* #define DEBUG_POLL */
41 #define SW_NAME(sw) (sw)->name ? (sw)->name : "unknown"
44 /* Order of CONFIG_AUDIO_DRIVERS is import.
45 The 1st one is the one used by default, that is the reason
46 that we generate the list.
48 static const char *audio_prio_list[] = {
55 static QLIST_HEAD(, audio_driver) audio_drivers;
57 void audio_driver_register(audio_driver *drv)
59 QLIST_INSERT_HEAD(&audio_drivers, drv, next);
62 audio_driver *audio_driver_lookup(const char *name)
64 struct audio_driver *d;
66 QLIST_FOREACH(d, &audio_drivers, next) {
67 if (strcmp(name, d->name) == 0) {
72 audio_module_load_one(name);
73 QLIST_FOREACH(d, &audio_drivers, next) {
74 if (strcmp(name, d->name) == 0) {
82 static void audio_module_load_all(void)
86 for (i = 0; i < ARRAY_SIZE(audio_prio_list); i++) {
87 audio_driver_lookup(audio_prio_list[i]);
91 struct fixed_settings {
95 struct audsettings settings;
99 struct fixed_settings fixed_out;
100 struct fixed_settings fixed_in;
108 .fixed_out = { /* DAC fixed settings */
116 .endianness = AUDIO_HOST_ENDIANNESS,
120 .fixed_in = { /* ADC fixed settings */
128 .endianness = AUDIO_HOST_ENDIANNESS,
132 .period = { .hertz = 100 },
137 static AudioState glob_audio_state;
139 const struct mixeng_volume nominal_volume = {
150 #ifdef AUDIO_IS_FLAWLESS_AND_NO_CHECKS_ARE_REQURIED
153 static void audio_print_options (const char *prefix,
154 struct audio_option *opt);
156 int audio_bug (const char *funcname, int cond)
161 AUD_log (NULL, "A bug was just triggered in %s\n", funcname);
163 struct audio_driver *d;
166 AUD_log (NULL, "Save all your work and restart without audio\n");
168 AUD_log (NULL, "I am sorry\n");
169 d = glob_audio_state.drv;
171 audio_print_options (d->name, d->options);
174 AUD_log (NULL, "Context:\n");
176 #if defined AUDIO_BREAKPOINT_ON_BUG
177 # if defined HOST_I386
178 # if defined __GNUC__
180 # elif defined _MSC_VER
195 static inline int audio_bits_to_index (int bits)
208 audio_bug ("bits_to_index", 1);
209 AUD_log (NULL, "invalid bits %d\n", bits);
214 void *audio_calloc (const char *funcname, int nmemb, size_t size)
220 cond = !nmemb || !size;
224 if (audio_bug ("audio_calloc", cond)) {
225 AUD_log (NULL, "%s passed invalid arguments to audio_calloc\n",
227 AUD_log (NULL, "nmemb=%d size=%zu (len=%zu)\n", nmemb, size, len);
231 return g_malloc0 (len);
234 static char *audio_alloc_prefix (const char *s)
236 const char qemu_prefix[] = "QEMU_";
245 r = g_malloc (len + sizeof (qemu_prefix));
247 u = r + sizeof (qemu_prefix) - 1;
249 pstrcpy (r, len + sizeof (qemu_prefix), qemu_prefix);
250 pstrcat (r, len + sizeof (qemu_prefix), s);
252 for (i = 0; i < len; ++i) {
253 u[i] = qemu_toupper(u[i]);
259 static const char *audio_audfmt_to_string (audfmt_e fmt)
281 dolog ("Bogus audfmt %d returning S16\n", fmt);
285 static audfmt_e audio_string_to_audfmt (const char *s, audfmt_e defval,
288 if (!strcasecmp (s, "u8")) {
292 else if (!strcasecmp (s, "u16")) {
296 else if (!strcasecmp (s, "u32")) {
300 else if (!strcasecmp (s, "s8")) {
304 else if (!strcasecmp (s, "s16")) {
308 else if (!strcasecmp (s, "s32")) {
313 dolog ("Bogus audio format `%s' using %s\n",
314 s, audio_audfmt_to_string (defval));
320 static audfmt_e audio_get_conf_fmt (const char *envname,
324 const char *var = getenv (envname);
329 return audio_string_to_audfmt (var, defval, defaultp);
332 static int audio_get_conf_int (const char *key, int defval, int *defaultp)
337 strval = getenv (key);
338 if (strval && !qemu_strtoi(strval, NULL, 10, &val)) {
348 static const char *audio_get_conf_str (const char *key,
352 const char *val = getenv (key);
363 void AUD_vlog (const char *cap, const char *fmt, va_list ap)
366 fprintf(stderr, "%s: ", cap);
369 vfprintf(stderr, fmt, ap);
372 void AUD_log (const char *cap, const char *fmt, ...)
377 AUD_vlog (cap, fmt, ap);
381 static void audio_print_options (const char *prefix,
382 struct audio_option *opt)
387 dolog ("No prefix specified\n");
392 dolog ("No options\n");
396 uprefix = audio_alloc_prefix (prefix);
398 for (; opt->name; opt++) {
399 const char *state = "default";
400 printf (" %s_%s: ", uprefix, opt->name);
402 if (opt->overriddenp && *opt->overriddenp) {
409 int *intp = opt->valp;
410 printf ("boolean, %s = %d\n", state, *intp ? 1 : 0);
416 int *intp = opt->valp;
417 printf ("integer, %s = %d\n", state, *intp);
423 audfmt_e *fmtp = opt->valp;
425 "format, %s = %s, (one of: U8 S8 U16 S16 U32 S32)\n",
427 audio_audfmt_to_string (*fmtp)
434 const char **strp = opt->valp;
435 printf ("string, %s = %s\n",
437 *strp ? *strp : "(not set)");
443 dolog ("Bad value tag for option %s_%s %d\n",
444 uprefix, opt->name, opt->tag);
447 printf (" %s\n", opt->descr);
453 static void audio_process_options (const char *prefix,
454 struct audio_option *opt)
457 const char qemu_prefix[] = "QEMU_";
458 size_t preflen, optlen;
460 if (audio_bug(__func__, !prefix)) {
461 dolog ("prefix = NULL\n");
465 if (audio_bug(__func__, !opt)) {
466 dolog ("opt = NULL\n");
470 preflen = strlen (prefix);
472 for (; opt->name; opt++) {
477 dolog ("Option value pointer for `%s' is not set\n",
482 len = strlen (opt->name);
483 /* len of opt->name + len of prefix + size of qemu_prefix
484 * (includes trailing zero) + zero + underscore (on behalf of
486 optlen = len + preflen + sizeof (qemu_prefix) + 1;
487 optname = g_malloc (optlen);
489 pstrcpy (optname, optlen, qemu_prefix);
491 /* copy while upper-casing, including trailing zero */
492 for (i = 0; i <= preflen; ++i) {
493 optname[i + sizeof (qemu_prefix) - 1] = qemu_toupper(prefix[i]);
495 pstrcat (optname, optlen, "_");
496 pstrcat (optname, optlen, opt->name);
503 int *intp = opt->valp;
504 *intp = audio_get_conf_int (optname, *intp, &def);
510 audfmt_e *fmtp = opt->valp;
511 *fmtp = audio_get_conf_fmt (optname, *fmtp, &def);
517 const char **strp = opt->valp;
518 *strp = audio_get_conf_str (optname, *strp, &def);
523 dolog ("Bad value tag for option `%s' - %d\n",
528 if (!opt->overriddenp) {
529 opt->overriddenp = &opt->overridden;
531 *opt->overriddenp = !def;
536 static void audio_print_settings (struct audsettings *as)
538 dolog ("frequency=%d nchannels=%d fmt=", as->freq, as->nchannels);
542 AUD_log (NULL, "S8");
545 AUD_log (NULL, "U8");
548 AUD_log (NULL, "S16");
551 AUD_log (NULL, "U16");
554 AUD_log (NULL, "S32");
557 AUD_log (NULL, "U32");
560 AUD_log (NULL, "invalid(%d)", as->fmt);
564 AUD_log (NULL, " endianness=");
565 switch (as->endianness) {
567 AUD_log (NULL, "little");
570 AUD_log (NULL, "big");
573 AUD_log (NULL, "invalid");
576 AUD_log (NULL, "\n");
579 static int audio_validate_settings (struct audsettings *as)
583 invalid = as->nchannels != 1 && as->nchannels != 2;
584 invalid |= as->endianness != 0 && as->endianness != 1;
599 invalid |= as->freq <= 0;
600 return invalid ? -1 : 0;
603 static int audio_pcm_info_eq (struct audio_pcm_info *info, struct audsettings *as)
605 int bits = 8, sign = 0;
628 return info->freq == as->freq
629 && info->nchannels == as->nchannels
630 && info->sign == sign
631 && info->bits == bits
632 && info->swap_endianness == (as->endianness != AUDIO_HOST_ENDIANNESS);
635 void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as)
637 int bits = 8, sign = 0, shift = 0;
660 info->freq = as->freq;
663 info->nchannels = as->nchannels;
664 info->shift = (as->nchannels == 2) + shift;
665 info->align = (1 << info->shift) - 1;
666 info->bytes_per_second = info->freq << info->shift;
667 info->swap_endianness = (as->endianness != AUDIO_HOST_ENDIANNESS);
670 void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len)
677 memset (buf, 0x00, len << info->shift);
680 switch (info->bits) {
682 memset (buf, 0x80, len << info->shift);
689 int shift = info->nchannels - 1;
692 if (info->swap_endianness) {
696 for (i = 0; i < len << shift; i++) {
706 int shift = info->nchannels - 1;
707 int32_t s = INT32_MAX;
709 if (info->swap_endianness) {
713 for (i = 0; i < len << shift; i++) {
720 AUD_log (NULL, "audio_pcm_info_clear_buf: invalid bits %d\n",
730 static void noop_conv (struct st_sample *dst, const void *src, int samples)
737 static CaptureVoiceOut *audio_pcm_capture_find_specific (
738 struct audsettings *as
741 CaptureVoiceOut *cap;
742 AudioState *s = &glob_audio_state;
744 for (cap = s->cap_head.lh_first; cap; cap = cap->entries.le_next) {
745 if (audio_pcm_info_eq (&cap->hw.info, as)) {
752 static void audio_notify_capture (CaptureVoiceOut *cap, audcnotification_e cmd)
754 struct capture_callback *cb;
757 dolog ("notification %d sent\n", cmd);
759 for (cb = cap->cb_head.lh_first; cb; cb = cb->entries.le_next) {
760 cb->ops.notify (cb->opaque, cmd);
764 static void audio_capture_maybe_changed (CaptureVoiceOut *cap, int enabled)
766 if (cap->hw.enabled != enabled) {
767 audcnotification_e cmd;
768 cap->hw.enabled = enabled;
769 cmd = enabled ? AUD_CNOTIFY_ENABLE : AUD_CNOTIFY_DISABLE;
770 audio_notify_capture (cap, cmd);
774 static void audio_recalc_and_notify_capture (CaptureVoiceOut *cap)
776 HWVoiceOut *hw = &cap->hw;
780 for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
786 audio_capture_maybe_changed (cap, enabled);
789 static void audio_detach_capture (HWVoiceOut *hw)
791 SWVoiceCap *sc = hw->cap_head.lh_first;
794 SWVoiceCap *sc1 = sc->entries.le_next;
795 SWVoiceOut *sw = &sc->sw;
796 CaptureVoiceOut *cap = sc->cap;
797 int was_active = sw->active;
800 st_rate_stop (sw->rate);
804 QLIST_REMOVE (sw, entries);
805 QLIST_REMOVE (sc, entries);
808 /* We have removed soft voice from the capture:
809 this might have changed the overall status of the capture
810 since this might have been the only active voice */
811 audio_recalc_and_notify_capture (cap);
817 static int audio_attach_capture (HWVoiceOut *hw)
819 AudioState *s = &glob_audio_state;
820 CaptureVoiceOut *cap;
822 audio_detach_capture (hw);
823 for (cap = s->cap_head.lh_first; cap; cap = cap->entries.le_next) {
826 HWVoiceOut *hw_cap = &cap->hw;
828 sc = audio_calloc(__func__, 1, sizeof(*sc));
830 dolog ("Could not allocate soft capture voice (%zu bytes)\n",
840 sw->active = hw->enabled;
841 sw->conv = noop_conv;
842 sw->ratio = ((int64_t) hw_cap->info.freq << 32) / sw->info.freq;
843 sw->vol = nominal_volume;
844 sw->rate = st_rate_start (sw->info.freq, hw_cap->info.freq);
846 dolog ("Could not start rate conversion for `%s'\n", SW_NAME (sw));
850 QLIST_INSERT_HEAD (&hw_cap->sw_head, sw, entries);
851 QLIST_INSERT_HEAD (&hw->cap_head, sc, entries);
853 sw->name = g_strdup_printf ("for %p %d,%d,%d",
854 hw, sw->info.freq, sw->info.bits,
856 dolog ("Added %s active = %d\n", sw->name, sw->active);
859 audio_capture_maybe_changed (cap, 1);
866 * Hard voice (capture)
868 static int audio_pcm_hw_find_min_in (HWVoiceIn *hw)
871 int m = hw->total_samples_captured;
873 for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
875 m = audio_MIN (m, sw->total_hw_samples_acquired);
881 int audio_pcm_hw_get_live_in (HWVoiceIn *hw)
883 int live = hw->total_samples_captured - audio_pcm_hw_find_min_in (hw);
884 if (audio_bug(__func__, live < 0 || live > hw->samples)) {
885 dolog ("live=%d hw->samples=%d\n", live, hw->samples);
891 int audio_pcm_hw_clip_out (HWVoiceOut *hw, void *pcm_buf,
892 int live, int pending)
894 int left = hw->samples - pending;
895 int len = audio_MIN (left, live);
899 struct st_sample *src = hw->mix_buf + hw->rpos;
900 uint8_t *dst = advance (pcm_buf, hw->rpos << hw->info.shift);
901 int samples_till_end_of_buf = hw->samples - hw->rpos;
902 int samples_to_clip = audio_MIN (len, samples_till_end_of_buf);
904 hw->clip (dst, src, samples_to_clip);
906 hw->rpos = (hw->rpos + samples_to_clip) % hw->samples;
907 len -= samples_to_clip;
908 clipped += samples_to_clip;
914 * Soft voice (capture)
916 static int audio_pcm_sw_get_rpos_in (SWVoiceIn *sw)
918 HWVoiceIn *hw = sw->hw;
919 int live = hw->total_samples_captured - sw->total_hw_samples_acquired;
922 if (audio_bug(__func__, live < 0 || live > hw->samples)) {
923 dolog ("live=%d hw->samples=%d\n", live, hw->samples);
927 rpos = hw->wpos - live;
932 return hw->samples + rpos;
936 int audio_pcm_sw_read (SWVoiceIn *sw, void *buf, int size)
938 HWVoiceIn *hw = sw->hw;
939 int samples, live, ret = 0, swlim, isamp, osamp, rpos, total = 0;
940 struct st_sample *src, *dst = sw->buf;
942 rpos = audio_pcm_sw_get_rpos_in (sw) % hw->samples;
944 live = hw->total_samples_captured - sw->total_hw_samples_acquired;
945 if (audio_bug(__func__, live < 0 || live > hw->samples)) {
946 dolog ("live_in=%d hw->samples=%d\n", live, hw->samples);
950 samples = size >> sw->info.shift;
955 swlim = (live * sw->ratio) >> 32;
956 swlim = audio_MIN (swlim, samples);
959 src = hw->conv_buf + rpos;
960 isamp = hw->wpos - rpos;
963 isamp = hw->samples - rpos;
971 if (audio_bug(__func__, osamp < 0)) {
972 dolog ("osamp=%d\n", osamp);
976 st_rate_flow (sw->rate, src, dst, &isamp, &osamp);
978 rpos = (rpos + isamp) % hw->samples;
984 if (!(hw->ctl_caps & VOICE_VOLUME_CAP)) {
985 mixeng_volume (sw->buf, ret, &sw->vol);
988 sw->clip (buf, sw->buf, ret);
989 sw->total_hw_samples_acquired += total;
990 return ret << sw->info.shift;
994 * Hard voice (playback)
996 static int audio_pcm_hw_find_min_out (HWVoiceOut *hw, int *nb_livep)
1002 for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
1003 if (sw->active || !sw->empty) {
1004 m = audio_MIN (m, sw->total_hw_samples_mixed);
1009 *nb_livep = nb_live;
1013 static int audio_pcm_hw_get_live_out (HWVoiceOut *hw, int *nb_live)
1018 smin = audio_pcm_hw_find_min_out (hw, &nb_live1);
1020 *nb_live = nb_live1;
1026 if (audio_bug(__func__, live < 0 || live > hw->samples)) {
1027 dolog ("live=%d hw->samples=%d\n", live, hw->samples);
1036 * Soft voice (playback)
1038 int audio_pcm_sw_write (SWVoiceOut *sw, void *buf, int size)
1040 int hwsamples, samples, isamp, osamp, wpos, live, dead, left, swlim, blck;
1041 int ret = 0, pos = 0, total = 0;
1047 hwsamples = sw->hw->samples;
1049 live = sw->total_hw_samples_mixed;
1050 if (audio_bug(__func__, live < 0 || live > hwsamples)) {
1051 dolog ("live=%d hw->samples=%d\n", live, hwsamples);
1055 if (live == hwsamples) {
1057 dolog ("%s is full %d\n", sw->name, live);
1062 wpos = (sw->hw->rpos + live) % hwsamples;
1063 samples = size >> sw->info.shift;
1065 dead = hwsamples - live;
1066 swlim = ((int64_t) dead << 32) / sw->ratio;
1067 swlim = audio_MIN (swlim, samples);
1069 sw->conv (sw->buf, buf, swlim);
1071 if (!(sw->hw->ctl_caps & VOICE_VOLUME_CAP)) {
1072 mixeng_volume (sw->buf, swlim, &sw->vol);
1077 dead = hwsamples - live;
1078 left = hwsamples - wpos;
1079 blck = audio_MIN (dead, left);
1088 sw->hw->mix_buf + wpos,
1096 wpos = (wpos + osamp) % hwsamples;
1100 sw->total_hw_samples_mixed += total;
1101 sw->empty = sw->total_hw_samples_mixed == 0;
1105 "%s: write size %d ret %d total sw %d\n",
1107 size >> sw->info.shift,
1109 sw->total_hw_samples_mixed
1113 return ret << sw->info.shift;
1117 static void audio_pcm_print_info (const char *cap, struct audio_pcm_info *info)
1119 dolog ("%s: bits %d, sign %d, freq %d, nchan %d\n",
1120 cap, info->bits, info->sign, info->freq, info->nchannels);
1125 #include "audio_template.h"
1127 #include "audio_template.h"
1132 static int audio_is_timer_needed (void)
1134 HWVoiceIn *hwi = NULL;
1135 HWVoiceOut *hwo = NULL;
1137 while ((hwo = audio_pcm_hw_find_any_enabled_out (hwo))) {
1138 if (!hwo->poll_mode) return 1;
1140 while ((hwi = audio_pcm_hw_find_any_enabled_in (hwi))) {
1141 if (!hwi->poll_mode) return 1;
1146 static void audio_reset_timer (AudioState *s)
1148 if (audio_is_timer_needed ()) {
1149 timer_mod_anticipate_ns(s->ts,
1150 qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL) + conf.period.ticks);
1157 static void audio_timer (void *opaque)
1159 audio_run ("timer");
1160 audio_reset_timer (opaque);
1166 int AUD_write (SWVoiceOut *sw, void *buf, int size)
1169 /* XXX: Consider options */
1173 if (!sw->hw->enabled) {
1174 dolog ("Writing to disabled voice %s\n", SW_NAME (sw));
1178 return sw->hw->pcm_ops->write(sw, buf, size);
1181 int AUD_read (SWVoiceIn *sw, void *buf, int size)
1184 /* XXX: Consider options */
1188 if (!sw->hw->enabled) {
1189 dolog ("Reading from disabled voice %s\n", SW_NAME (sw));
1193 return sw->hw->pcm_ops->read(sw, buf, size);
1196 int AUD_get_buffer_size_out (SWVoiceOut *sw)
1198 return sw->hw->samples << sw->hw->info.shift;
1201 void AUD_set_active_out (SWVoiceOut *sw, int on)
1210 if (sw->active != on) {
1211 AudioState *s = &glob_audio_state;
1212 SWVoiceOut *temp_sw;
1216 hw->pending_disable = 0;
1219 if (s->vm_running) {
1220 hw->pcm_ops->ctl_out (hw, VOICE_ENABLE, conf.try_poll_out);
1221 audio_reset_timer (s);
1229 for (temp_sw = hw->sw_head.lh_first; temp_sw;
1230 temp_sw = temp_sw->entries.le_next) {
1231 nb_active += temp_sw->active != 0;
1234 hw->pending_disable = nb_active == 1;
1238 for (sc = hw->cap_head.lh_first; sc; sc = sc->entries.le_next) {
1239 sc->sw.active = hw->enabled;
1241 audio_capture_maybe_changed (sc->cap, 1);
1248 void AUD_set_active_in (SWVoiceIn *sw, int on)
1257 if (sw->active != on) {
1258 AudioState *s = &glob_audio_state;
1264 if (s->vm_running) {
1265 hw->pcm_ops->ctl_in (hw, VOICE_ENABLE, conf.try_poll_in);
1266 audio_reset_timer (s);
1269 sw->total_hw_samples_acquired = hw->total_samples_captured;
1275 for (temp_sw = hw->sw_head.lh_first; temp_sw;
1276 temp_sw = temp_sw->entries.le_next) {
1277 nb_active += temp_sw->active != 0;
1280 if (nb_active == 1) {
1282 hw->pcm_ops->ctl_in (hw, VOICE_DISABLE);
1290 static int audio_get_avail (SWVoiceIn *sw)
1298 live = sw->hw->total_samples_captured - sw->total_hw_samples_acquired;
1299 if (audio_bug(__func__, live < 0 || live > sw->hw->samples)) {
1300 dolog ("live=%d sw->hw->samples=%d\n", live, sw->hw->samples);
1305 "%s: get_avail live %d ret %" PRId64 "\n",
1307 live, (((int64_t) live << 32) / sw->ratio) << sw->info.shift
1310 return (((int64_t) live << 32) / sw->ratio) << sw->info.shift;
1313 static int audio_get_free (SWVoiceOut *sw)
1321 live = sw->total_hw_samples_mixed;
1323 if (audio_bug(__func__, live < 0 || live > sw->hw->samples)) {
1324 dolog ("live=%d sw->hw->samples=%d\n", live, sw->hw->samples);
1328 dead = sw->hw->samples - live;
1331 dolog ("%s: get_free live %d dead %d ret %" PRId64 "\n",
1333 live, dead, (((int64_t) dead << 32) / sw->ratio) << sw->info.shift);
1336 return (((int64_t) dead << 32) / sw->ratio) << sw->info.shift;
1339 static void audio_capture_mix_and_clear (HWVoiceOut *hw, int rpos, int samples)
1346 for (sc = hw->cap_head.lh_first; sc; sc = sc->entries.le_next) {
1347 SWVoiceOut *sw = &sc->sw;
1352 int till_end_of_hw = hw->samples - rpos2;
1353 int to_write = audio_MIN (till_end_of_hw, n);
1354 int bytes = to_write << hw->info.shift;
1357 sw->buf = hw->mix_buf + rpos2;
1358 written = audio_pcm_sw_write (sw, NULL, bytes);
1359 if (written - bytes) {
1360 dolog ("Could not mix %d bytes into a capture "
1361 "buffer, mixed %d\n",
1366 rpos2 = (rpos2 + to_write) % hw->samples;
1371 n = audio_MIN (samples, hw->samples - rpos);
1372 mixeng_clear (hw->mix_buf + rpos, n);
1373 mixeng_clear (hw->mix_buf, samples - n);
1376 static void audio_run_out (AudioState *s)
1378 HWVoiceOut *hw = NULL;
1381 while ((hw = audio_pcm_hw_find_any_enabled_out (hw))) {
1383 int live, free, nb_live, cleanup_required, prev_rpos;
1385 live = audio_pcm_hw_get_live_out (hw, &nb_live);
1390 if (audio_bug(__func__, live < 0 || live > hw->samples)) {
1391 dolog ("live=%d hw->samples=%d\n", live, hw->samples);
1395 if (hw->pending_disable && !nb_live) {
1398 dolog ("Disabling voice\n");
1401 hw->pending_disable = 0;
1402 hw->pcm_ops->ctl_out (hw, VOICE_DISABLE);
1403 for (sc = hw->cap_head.lh_first; sc; sc = sc->entries.le_next) {
1405 audio_recalc_and_notify_capture (sc->cap);
1411 for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
1413 free = audio_get_free (sw);
1415 sw->callback.fn (sw->callback.opaque, free);
1422 prev_rpos = hw->rpos;
1423 played = hw->pcm_ops->run_out (hw, live);
1424 replay_audio_out(&played);
1425 if (audio_bug(__func__, hw->rpos >= hw->samples)) {
1426 dolog ("hw->rpos=%d hw->samples=%d played=%d\n",
1427 hw->rpos, hw->samples, played);
1432 dolog ("played=%d\n", played);
1436 hw->ts_helper += played;
1437 audio_capture_mix_and_clear (hw, prev_rpos, played);
1440 cleanup_required = 0;
1441 for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
1442 if (!sw->active && sw->empty) {
1446 if (audio_bug(__func__, played > sw->total_hw_samples_mixed)) {
1447 dolog ("played=%d sw->total_hw_samples_mixed=%d\n",
1448 played, sw->total_hw_samples_mixed);
1449 played = sw->total_hw_samples_mixed;
1452 sw->total_hw_samples_mixed -= played;
1454 if (!sw->total_hw_samples_mixed) {
1456 cleanup_required |= !sw->active && !sw->callback.fn;
1460 free = audio_get_free (sw);
1462 sw->callback.fn (sw->callback.opaque, free);
1467 if (cleanup_required) {
1470 sw = hw->sw_head.lh_first;
1472 sw1 = sw->entries.le_next;
1473 if (!sw->active && !sw->callback.fn) {
1474 audio_close_out (sw);
1482 static void audio_run_in (AudioState *s)
1484 HWVoiceIn *hw = NULL;
1486 while ((hw = audio_pcm_hw_find_any_enabled_in (hw))) {
1488 int captured = 0, min;
1490 if (replay_mode != REPLAY_MODE_PLAY) {
1491 captured = hw->pcm_ops->run_in(hw);
1493 replay_audio_in(&captured, hw->conv_buf, &hw->wpos, hw->samples);
1495 min = audio_pcm_hw_find_min_in (hw);
1496 hw->total_samples_captured += captured - min;
1497 hw->ts_helper += captured;
1499 for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
1500 sw->total_hw_samples_acquired -= min;
1505 avail = audio_get_avail (sw);
1507 sw->callback.fn (sw->callback.opaque, avail);
1514 static void audio_run_capture (AudioState *s)
1516 CaptureVoiceOut *cap;
1518 for (cap = s->cap_head.lh_first; cap; cap = cap->entries.le_next) {
1519 int live, rpos, captured;
1520 HWVoiceOut *hw = &cap->hw;
1523 captured = live = audio_pcm_hw_get_live_out (hw, NULL);
1526 int left = hw->samples - rpos;
1527 int to_capture = audio_MIN (live, left);
1528 struct st_sample *src;
1529 struct capture_callback *cb;
1531 src = hw->mix_buf + rpos;
1532 hw->clip (cap->buf, src, to_capture);
1533 mixeng_clear (src, to_capture);
1535 for (cb = cap->cb_head.lh_first; cb; cb = cb->entries.le_next) {
1536 cb->ops.capture (cb->opaque, cap->buf,
1537 to_capture << hw->info.shift);
1539 rpos = (rpos + to_capture) % hw->samples;
1544 for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
1545 if (!sw->active && sw->empty) {
1549 if (audio_bug(__func__, captured > sw->total_hw_samples_mixed)) {
1550 dolog ("captured=%d sw->total_hw_samples_mixed=%d\n",
1551 captured, sw->total_hw_samples_mixed);
1552 captured = sw->total_hw_samples_mixed;
1555 sw->total_hw_samples_mixed -= captured;
1556 sw->empty = sw->total_hw_samples_mixed == 0;
1561 void audio_run (const char *msg)
1563 AudioState *s = &glob_audio_state;
1567 audio_run_capture (s);
1570 static double prevtime;
1574 if (gettimeofday (&tv, NULL)) {
1575 perror ("audio_run: gettimeofday");
1579 currtime = tv.tv_sec + tv.tv_usec * 1e-6;
1580 dolog ("Elapsed since last %s: %f\n", msg, currtime - prevtime);
1581 prevtime = currtime;
1586 static struct audio_option audio_options[] = {
1589 .name = "DAC_FIXED_SETTINGS",
1590 .tag = AUD_OPT_BOOL,
1591 .valp = &conf.fixed_out.enabled,
1592 .descr = "Use fixed settings for host DAC"
1595 .name = "DAC_FIXED_FREQ",
1597 .valp = &conf.fixed_out.settings.freq,
1598 .descr = "Frequency for fixed host DAC"
1601 .name = "DAC_FIXED_FMT",
1603 .valp = &conf.fixed_out.settings.fmt,
1604 .descr = "Format for fixed host DAC"
1607 .name = "DAC_FIXED_CHANNELS",
1609 .valp = &conf.fixed_out.settings.nchannels,
1610 .descr = "Number of channels for fixed DAC (1 - mono, 2 - stereo)"
1613 .name = "DAC_VOICES",
1615 .valp = &conf.fixed_out.nb_voices,
1616 .descr = "Number of voices for DAC"
1619 .name = "DAC_TRY_POLL",
1620 .tag = AUD_OPT_BOOL,
1621 .valp = &conf.try_poll_out,
1622 .descr = "Attempt using poll mode for DAC"
1626 .name = "ADC_FIXED_SETTINGS",
1627 .tag = AUD_OPT_BOOL,
1628 .valp = &conf.fixed_in.enabled,
1629 .descr = "Use fixed settings for host ADC"
1632 .name = "ADC_FIXED_FREQ",
1634 .valp = &conf.fixed_in.settings.freq,
1635 .descr = "Frequency for fixed host ADC"
1638 .name = "ADC_FIXED_FMT",
1640 .valp = &conf.fixed_in.settings.fmt,
1641 .descr = "Format for fixed host ADC"
1644 .name = "ADC_FIXED_CHANNELS",
1646 .valp = &conf.fixed_in.settings.nchannels,
1647 .descr = "Number of channels for fixed ADC (1 - mono, 2 - stereo)"
1650 .name = "ADC_VOICES",
1652 .valp = &conf.fixed_in.nb_voices,
1653 .descr = "Number of voices for ADC"
1656 .name = "ADC_TRY_POLL",
1657 .tag = AUD_OPT_BOOL,
1658 .valp = &conf.try_poll_in,
1659 .descr = "Attempt using poll mode for ADC"
1663 .name = "TIMER_PERIOD",
1665 .valp = &conf.period.hertz,
1666 .descr = "Timer period in HZ (0 - use lowest possible)"
1668 { /* End of list */ }
1671 static void audio_pp_nb_voices (const char *typ, int nb)
1675 printf ("Does not support %s\n", typ);
1678 printf ("One %s voice\n", typ);
1681 printf ("Theoretically supports many %s voices\n", typ);
1684 printf ("Theoretically supports up to %d %s voices\n", nb, typ);
1690 void AUD_help (void)
1692 struct audio_driver *d;
1694 /* make sure we print the help text for modular drivers too */
1695 audio_module_load_all();
1697 audio_process_options ("AUDIO", audio_options);
1698 QLIST_FOREACH(d, &audio_drivers, next) {
1700 audio_process_options (d->name, d->options);
1704 printf ("Audio options:\n");
1705 audio_print_options ("AUDIO", audio_options);
1708 printf ("Available drivers:\n");
1710 QLIST_FOREACH(d, &audio_drivers, next) {
1712 printf ("Name: %s\n", d->name);
1713 printf ("Description: %s\n", d->descr);
1715 audio_pp_nb_voices ("playback", d->max_voices_out);
1716 audio_pp_nb_voices ("capture", d->max_voices_in);
1719 printf ("Options:\n");
1720 audio_print_options (d->name, d->options);
1723 printf ("No options\n");
1729 "Options are settable through environment variables.\n"
1732 " set QEMU_AUDIO_DRV=wav\n"
1733 " set QEMU_WAV_PATH=c:\\tune.wav\n"
1735 " export QEMU_AUDIO_DRV=wav\n"
1736 " export QEMU_WAV_PATH=$HOME/tune.wav\n"
1737 "(for csh replace export with setenv in the above)\n"
1743 static int audio_driver_init (AudioState *s, struct audio_driver *drv)
1746 audio_process_options (drv->name, drv->options);
1748 s->drv_opaque = drv->init ();
1750 if (s->drv_opaque) {
1751 audio_init_nb_voices_out (drv);
1752 audio_init_nb_voices_in (drv);
1757 dolog ("Could not init `%s' audio driver\n", drv->name);
1762 static void audio_vm_change_state_handler (void *opaque, int running,
1765 AudioState *s = opaque;
1766 HWVoiceOut *hwo = NULL;
1767 HWVoiceIn *hwi = NULL;
1768 int op = running ? VOICE_ENABLE : VOICE_DISABLE;
1770 s->vm_running = running;
1771 while ((hwo = audio_pcm_hw_find_any_enabled_out (hwo))) {
1772 hwo->pcm_ops->ctl_out (hwo, op, conf.try_poll_out);
1775 while ((hwi = audio_pcm_hw_find_any_enabled_in (hwi))) {
1776 hwi->pcm_ops->ctl_in (hwi, op, conf.try_poll_in);
1778 audio_reset_timer (s);
1781 static bool is_cleaning_up;
1783 bool audio_is_cleaning_up(void)
1785 return is_cleaning_up;
1788 void audio_cleanup(void)
1790 AudioState *s = &glob_audio_state;
1791 HWVoiceOut *hwo, *hwon;
1792 HWVoiceIn *hwi, *hwin;
1794 is_cleaning_up = true;
1795 QLIST_FOREACH_SAFE(hwo, &glob_audio_state.hw_head_out, entries, hwon) {
1799 hwo->pcm_ops->ctl_out (hwo, VOICE_DISABLE);
1801 hwo->pcm_ops->fini_out (hwo);
1803 for (sc = hwo->cap_head.lh_first; sc; sc = sc->entries.le_next) {
1804 CaptureVoiceOut *cap = sc->cap;
1805 struct capture_callback *cb;
1807 for (cb = cap->cb_head.lh_first; cb; cb = cb->entries.le_next) {
1808 cb->ops.destroy (cb->opaque);
1811 QLIST_REMOVE(hwo, entries);
1814 QLIST_FOREACH_SAFE(hwi, &glob_audio_state.hw_head_in, entries, hwin) {
1816 hwi->pcm_ops->ctl_in (hwi, VOICE_DISABLE);
1818 hwi->pcm_ops->fini_in (hwi);
1819 QLIST_REMOVE(hwi, entries);
1823 s->drv->fini (s->drv_opaque);
1828 static const VMStateDescription vmstate_audio = {
1831 .minimum_version_id = 1,
1832 .fields = (VMStateField[]) {
1833 VMSTATE_END_OF_LIST()
1837 static void audio_init (void)
1841 const char *drvname;
1842 VMChangeStateEntry *e;
1843 AudioState *s = &glob_audio_state;
1844 struct audio_driver *driver;
1850 QLIST_INIT (&s->hw_head_out);
1851 QLIST_INIT (&s->hw_head_in);
1852 QLIST_INIT (&s->cap_head);
1853 atexit(audio_cleanup);
1855 s->ts = timer_new_ns(QEMU_CLOCK_VIRTUAL, audio_timer, s);
1857 audio_process_options ("AUDIO", audio_options);
1859 s->nb_hw_voices_out = conf.fixed_out.nb_voices;
1860 s->nb_hw_voices_in = conf.fixed_in.nb_voices;
1862 if (s->nb_hw_voices_out <= 0) {
1863 dolog ("Bogus number of playback voices %d, setting to 1\n",
1864 s->nb_hw_voices_out);
1865 s->nb_hw_voices_out = 1;
1868 if (s->nb_hw_voices_in <= 0) {
1869 dolog ("Bogus number of capture voices %d, setting to 0\n",
1870 s->nb_hw_voices_in);
1871 s->nb_hw_voices_in = 0;
1876 drvname = audio_get_conf_str ("QEMU_AUDIO_DRV", NULL, &def);
1880 driver = audio_driver_lookup(drvname);
1882 done = !audio_driver_init(s, driver);
1884 dolog ("Unknown audio driver `%s'\n", drvname);
1885 dolog ("Run with -audio-help to list available drivers\n");
1890 for (i = 0; !done && i < ARRAY_SIZE(audio_prio_list); i++) {
1891 driver = audio_driver_lookup(audio_prio_list[i]);
1892 if (driver && driver->can_be_default) {
1893 done = !audio_driver_init(s, driver);
1899 driver = audio_driver_lookup("none");
1900 done = !audio_driver_init(s, driver);
1902 dolog("warning: Using timer based audio emulation\n");
1905 if (conf.period.hertz <= 0) {
1906 if (conf.period.hertz < 0) {
1907 dolog ("warning: Timer period is negative - %d "
1908 "treating as zero\n",
1911 conf.period.ticks = 1;
1913 conf.period.ticks = NANOSECONDS_PER_SECOND / conf.period.hertz;
1916 e = qemu_add_vm_change_state_handler (audio_vm_change_state_handler, s);
1918 dolog ("warning: Could not register change state handler\n"
1919 "(Audio can continue looping even after stopping the VM)\n");
1922 QLIST_INIT (&s->card_head);
1923 vmstate_register (NULL, 0, &vmstate_audio, s);
1926 void AUD_register_card (const char *name, QEMUSoundCard *card)
1929 card->name = g_strdup (name);
1930 memset (&card->entries, 0, sizeof (card->entries));
1931 QLIST_INSERT_HEAD (&glob_audio_state.card_head, card, entries);
1934 void AUD_remove_card (QEMUSoundCard *card)
1936 QLIST_REMOVE (card, entries);
1937 g_free (card->name);
1941 CaptureVoiceOut *AUD_add_capture (
1942 struct audsettings *as,
1943 struct audio_capture_ops *ops,
1947 AudioState *s = &glob_audio_state;
1948 CaptureVoiceOut *cap;
1949 struct capture_callback *cb;
1951 if (audio_validate_settings (as)) {
1952 dolog ("Invalid settings were passed when trying to add capture\n");
1953 audio_print_settings (as);
1957 cb = audio_calloc(__func__, 1, sizeof(*cb));
1959 dolog ("Could not allocate capture callback information, size %zu\n",
1964 cb->opaque = cb_opaque;
1966 cap = audio_pcm_capture_find_specific (as);
1968 QLIST_INSERT_HEAD (&cap->cb_head, cb, entries);
1973 CaptureVoiceOut *cap;
1975 cap = audio_calloc(__func__, 1, sizeof(*cap));
1977 dolog ("Could not allocate capture voice, size %zu\n",
1983 QLIST_INIT (&hw->sw_head);
1984 QLIST_INIT (&cap->cb_head);
1986 /* XXX find a more elegant way */
1987 hw->samples = 4096 * 4;
1988 hw->mix_buf = audio_calloc(__func__, hw->samples,
1989 sizeof(struct st_sample));
1991 dolog ("Could not allocate capture mix buffer (%d samples)\n",
1996 audio_pcm_init_info (&hw->info, as);
1998 cap->buf = audio_calloc(__func__, hw->samples, 1 << hw->info.shift);
2000 dolog ("Could not allocate capture buffer "
2001 "(%d samples, each %d bytes)\n",
2002 hw->samples, 1 << hw->info.shift);
2006 hw->clip = mixeng_clip
2007 [hw->info.nchannels == 2]
2009 [hw->info.swap_endianness]
2010 [audio_bits_to_index (hw->info.bits)];
2012 QLIST_INSERT_HEAD (&s->cap_head, cap, entries);
2013 QLIST_INSERT_HEAD (&cap->cb_head, cb, entries);
2015 QLIST_FOREACH(hw, &glob_audio_state.hw_head_out, entries) {
2016 audio_attach_capture (hw);
2021 g_free (cap->hw.mix_buf);
2031 void AUD_del_capture (CaptureVoiceOut *cap, void *cb_opaque)
2033 struct capture_callback *cb;
2035 for (cb = cap->cb_head.lh_first; cb; cb = cb->entries.le_next) {
2036 if (cb->opaque == cb_opaque) {
2037 cb->ops.destroy (cb_opaque);
2038 QLIST_REMOVE (cb, entries);
2041 if (!cap->cb_head.lh_first) {
2042 SWVoiceOut *sw = cap->hw.sw_head.lh_first, *sw1;
2045 SWVoiceCap *sc = (SWVoiceCap *) sw;
2046 #ifdef DEBUG_CAPTURE
2047 dolog ("freeing %s\n", sw->name);
2050 sw1 = sw->entries.le_next;
2052 st_rate_stop (sw->rate);
2055 QLIST_REMOVE (sw, entries);
2056 QLIST_REMOVE (sc, entries);
2060 QLIST_REMOVE (cap, entries);
2061 g_free (cap->hw.mix_buf);
2070 void AUD_set_volume_out (SWVoiceOut *sw, int mute, uint8_t lvol, uint8_t rvol)
2073 HWVoiceOut *hw = sw->hw;
2075 sw->vol.mute = mute;
2076 sw->vol.l = nominal_volume.l * lvol / 255;
2077 sw->vol.r = nominal_volume.r * rvol / 255;
2079 if (hw->pcm_ops->ctl_out) {
2080 hw->pcm_ops->ctl_out (hw, VOICE_VOLUME, sw);
2085 void AUD_set_volume_in (SWVoiceIn *sw, int mute, uint8_t lvol, uint8_t rvol)
2088 HWVoiceIn *hw = sw->hw;
2090 sw->vol.mute = mute;
2091 sw->vol.l = nominal_volume.l * lvol / 255;
2092 sw->vol.r = nominal_volume.r * rvol / 255;
2094 if (hw->pcm_ops->ctl_in) {
2095 hw->pcm_ops->ctl_in (hw, VOICE_VOLUME, sw);