xref: /openbmc/qemu/audio/audio.c (revision d695918f)
1 /*
2  * QEMU Audio subsystem
3  *
4  * Copyright (c) 2003-2005 Vassili Karpov (malc)
5  *
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  */
24 
25 #include "qemu/osdep.h"
26 #include "audio.h"
27 #include "migration/vmstate.h"
28 #include "monitor/monitor.h"
29 #include "qemu/timer.h"
30 #include "qapi/error.h"
31 #include "qapi/qobject-input-visitor.h"
32 #include "qapi/qapi-visit-audio.h"
33 #include "qemu/cutils.h"
34 #include "qemu/module.h"
35 #include "sysemu/sysemu.h"
36 #include "sysemu/replay.h"
37 #include "sysemu/runstate.h"
38 #include "ui/qemu-spice.h"
39 #include "trace.h"
40 
41 #define AUDIO_CAP "audio"
42 #include "audio_int.h"
43 
44 /* #define DEBUG_LIVE */
45 /* #define DEBUG_OUT */
46 /* #define DEBUG_CAPTURE */
47 /* #define DEBUG_POLL */
48 
49 #define SW_NAME(sw) (sw)->name ? (sw)->name : "unknown"
50 
51 
52 /* Order of CONFIG_AUDIO_DRIVERS is import.
53    The 1st one is the one used by default, that is the reason
54     that we generate the list.
55 */
56 const char *audio_prio_list[] = {
57     "spice",
58     CONFIG_AUDIO_DRIVERS
59     "none",
60     "wav",
61     NULL
62 };
63 
64 static QLIST_HEAD(, audio_driver) audio_drivers;
65 static AudiodevListHead audiodevs = QSIMPLEQ_HEAD_INITIALIZER(audiodevs);
66 
67 void audio_driver_register(audio_driver *drv)
68 {
69     QLIST_INSERT_HEAD(&audio_drivers, drv, next);
70 }
71 
72 audio_driver *audio_driver_lookup(const char *name)
73 {
74     struct audio_driver *d;
75 
76     QLIST_FOREACH(d, &audio_drivers, next) {
77         if (strcmp(name, d->name) == 0) {
78             return d;
79         }
80     }
81 
82     audio_module_load_one(name);
83     QLIST_FOREACH(d, &audio_drivers, next) {
84         if (strcmp(name, d->name) == 0) {
85             return d;
86         }
87     }
88 
89     return NULL;
90 }
91 
92 static QTAILQ_HEAD(AudioStateHead, AudioState) audio_states =
93     QTAILQ_HEAD_INITIALIZER(audio_states);
94 
95 const struct mixeng_volume nominal_volume = {
96     .mute = 0,
97 #ifdef FLOAT_MIXENG
98     .r = 1.0,
99     .l = 1.0,
100 #else
101     .r = 1ULL << 32,
102     .l = 1ULL << 32,
103 #endif
104 };
105 
106 static bool legacy_config = true;
107 
108 int audio_bug (const char *funcname, int cond)
109 {
110     if (cond) {
111         static int shown;
112 
113         AUD_log (NULL, "A bug was just triggered in %s\n", funcname);
114         if (!shown) {
115             shown = 1;
116             AUD_log (NULL, "Save all your work and restart without audio\n");
117             AUD_log (NULL, "I am sorry\n");
118         }
119         AUD_log (NULL, "Context:\n");
120     }
121 
122     return cond;
123 }
124 
125 static inline int audio_bits_to_index (int bits)
126 {
127     switch (bits) {
128     case 8:
129         return 0;
130 
131     case 16:
132         return 1;
133 
134     case 32:
135         return 2;
136 
137     default:
138         audio_bug ("bits_to_index", 1);
139         AUD_log (NULL, "invalid bits %d\n", bits);
140         abort();
141     }
142 }
143 
144 void *audio_calloc (const char *funcname, int nmemb, size_t size)
145 {
146     int cond;
147     size_t len;
148 
149     len = nmemb * size;
150     cond = !nmemb || !size;
151     cond |= nmemb < 0;
152     cond |= len < size;
153 
154     if (audio_bug ("audio_calloc", cond)) {
155         AUD_log (NULL, "%s passed invalid arguments to audio_calloc\n",
156                  funcname);
157         AUD_log (NULL, "nmemb=%d size=%zu (len=%zu)\n", nmemb, size, len);
158         abort();
159     }
160 
161     return g_malloc0 (len);
162 }
163 
164 void AUD_vlog (const char *cap, const char *fmt, va_list ap)
165 {
166     if (cap) {
167         fprintf(stderr, "%s: ", cap);
168     }
169 
170     vfprintf(stderr, fmt, ap);
171 }
172 
173 void AUD_log (const char *cap, const char *fmt, ...)
174 {
175     va_list ap;
176 
177     va_start (ap, fmt);
178     AUD_vlog (cap, fmt, ap);
179     va_end (ap);
180 }
181 
182 static void audio_print_settings (struct audsettings *as)
183 {
184     dolog ("frequency=%d nchannels=%d fmt=", as->freq, as->nchannels);
185 
186     switch (as->fmt) {
187     case AUDIO_FORMAT_S8:
188         AUD_log (NULL, "S8");
189         break;
190     case AUDIO_FORMAT_U8:
191         AUD_log (NULL, "U8");
192         break;
193     case AUDIO_FORMAT_S16:
194         AUD_log (NULL, "S16");
195         break;
196     case AUDIO_FORMAT_U16:
197         AUD_log (NULL, "U16");
198         break;
199     case AUDIO_FORMAT_S32:
200         AUD_log (NULL, "S32");
201         break;
202     case AUDIO_FORMAT_U32:
203         AUD_log (NULL, "U32");
204         break;
205     case AUDIO_FORMAT_F32:
206         AUD_log (NULL, "F32");
207         break;
208     default:
209         AUD_log (NULL, "invalid(%d)", as->fmt);
210         break;
211     }
212 
213     AUD_log (NULL, " endianness=");
214     switch (as->endianness) {
215     case 0:
216         AUD_log (NULL, "little");
217         break;
218     case 1:
219         AUD_log (NULL, "big");
220         break;
221     default:
222         AUD_log (NULL, "invalid");
223         break;
224     }
225     AUD_log (NULL, "\n");
226 }
227 
228 static int audio_validate_settings (struct audsettings *as)
229 {
230     int invalid;
231 
232     invalid = as->nchannels < 1;
233     invalid |= as->endianness != 0 && as->endianness != 1;
234 
235     switch (as->fmt) {
236     case AUDIO_FORMAT_S8:
237     case AUDIO_FORMAT_U8:
238     case AUDIO_FORMAT_S16:
239     case AUDIO_FORMAT_U16:
240     case AUDIO_FORMAT_S32:
241     case AUDIO_FORMAT_U32:
242     case AUDIO_FORMAT_F32:
243         break;
244     default:
245         invalid = 1;
246         break;
247     }
248 
249     invalid |= as->freq <= 0;
250     return invalid ? -1 : 0;
251 }
252 
253 static int audio_pcm_info_eq (struct audio_pcm_info *info, struct audsettings *as)
254 {
255     int bits = 8;
256     bool is_signed = false, is_float = false;
257 
258     switch (as->fmt) {
259     case AUDIO_FORMAT_S8:
260         is_signed = true;
261         /* fall through */
262     case AUDIO_FORMAT_U8:
263         break;
264 
265     case AUDIO_FORMAT_S16:
266         is_signed = true;
267         /* fall through */
268     case AUDIO_FORMAT_U16:
269         bits = 16;
270         break;
271 
272     case AUDIO_FORMAT_F32:
273         is_float = true;
274         /* fall through */
275     case AUDIO_FORMAT_S32:
276         is_signed = true;
277         /* fall through */
278     case AUDIO_FORMAT_U32:
279         bits = 32;
280         break;
281 
282     default:
283         abort();
284     }
285     return info->freq == as->freq
286         && info->nchannels == as->nchannels
287         && info->is_signed == is_signed
288         && info->is_float == is_float
289         && info->bits == bits
290         && info->swap_endianness == (as->endianness != AUDIO_HOST_ENDIANNESS);
291 }
292 
293 void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as)
294 {
295     int bits = 8, mul;
296     bool is_signed = false, is_float = false;
297 
298     switch (as->fmt) {
299     case AUDIO_FORMAT_S8:
300         is_signed = true;
301         /* fall through */
302     case AUDIO_FORMAT_U8:
303         mul = 1;
304         break;
305 
306     case AUDIO_FORMAT_S16:
307         is_signed = true;
308         /* fall through */
309     case AUDIO_FORMAT_U16:
310         bits = 16;
311         mul = 2;
312         break;
313 
314     case AUDIO_FORMAT_F32:
315         is_float = true;
316         /* fall through */
317     case AUDIO_FORMAT_S32:
318         is_signed = true;
319         /* fall through */
320     case AUDIO_FORMAT_U32:
321         bits = 32;
322         mul = 4;
323         break;
324 
325     default:
326         abort();
327     }
328 
329     info->freq = as->freq;
330     info->bits = bits;
331     info->is_signed = is_signed;
332     info->is_float = is_float;
333     info->nchannels = as->nchannels;
334     info->bytes_per_frame = as->nchannels * mul;
335     info->bytes_per_second = info->freq * info->bytes_per_frame;
336     info->swap_endianness = (as->endianness != AUDIO_HOST_ENDIANNESS);
337 }
338 
339 void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len)
340 {
341     if (!len) {
342         return;
343     }
344 
345     if (info->is_signed || info->is_float) {
346         memset(buf, 0x00, len * info->bytes_per_frame);
347     } else {
348         switch (info->bits) {
349         case 8:
350             memset(buf, 0x80, len * info->bytes_per_frame);
351             break;
352 
353         case 16:
354             {
355                 int i;
356                 uint16_t *p = buf;
357                 short s = INT16_MAX;
358 
359                 if (info->swap_endianness) {
360                     s = bswap16 (s);
361                 }
362 
363                 for (i = 0; i < len * info->nchannels; i++) {
364                     p[i] = s;
365                 }
366             }
367             break;
368 
369         case 32:
370             {
371                 int i;
372                 uint32_t *p = buf;
373                 int32_t s = INT32_MAX;
374 
375                 if (info->swap_endianness) {
376                     s = bswap32 (s);
377                 }
378 
379                 for (i = 0; i < len * info->nchannels; i++) {
380                     p[i] = s;
381                 }
382             }
383             break;
384 
385         default:
386             AUD_log (NULL, "audio_pcm_info_clear_buf: invalid bits %d\n",
387                      info->bits);
388             break;
389         }
390     }
391 }
392 
393 /*
394  * Capture
395  */
396 static void noop_conv (struct st_sample *dst, const void *src, int samples)
397 {
398     (void) src;
399     (void) dst;
400     (void) samples;
401 }
402 
403 static CaptureVoiceOut *audio_pcm_capture_find_specific(AudioState *s,
404                                                         struct audsettings *as)
405 {
406     CaptureVoiceOut *cap;
407 
408     for (cap = s->cap_head.lh_first; cap; cap = cap->entries.le_next) {
409         if (audio_pcm_info_eq (&cap->hw.info, as)) {
410             return cap;
411         }
412     }
413     return NULL;
414 }
415 
416 static void audio_notify_capture (CaptureVoiceOut *cap, audcnotification_e cmd)
417 {
418     struct capture_callback *cb;
419 
420 #ifdef DEBUG_CAPTURE
421     dolog ("notification %d sent\n", cmd);
422 #endif
423     for (cb = cap->cb_head.lh_first; cb; cb = cb->entries.le_next) {
424         cb->ops.notify (cb->opaque, cmd);
425     }
426 }
427 
428 static void audio_capture_maybe_changed (CaptureVoiceOut *cap, int enabled)
429 {
430     if (cap->hw.enabled != enabled) {
431         audcnotification_e cmd;
432         cap->hw.enabled = enabled;
433         cmd = enabled ? AUD_CNOTIFY_ENABLE : AUD_CNOTIFY_DISABLE;
434         audio_notify_capture (cap, cmd);
435     }
436 }
437 
438 static void audio_recalc_and_notify_capture (CaptureVoiceOut *cap)
439 {
440     HWVoiceOut *hw = &cap->hw;
441     SWVoiceOut *sw;
442     int enabled = 0;
443 
444     for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
445         if (sw->active) {
446             enabled = 1;
447             break;
448         }
449     }
450     audio_capture_maybe_changed (cap, enabled);
451 }
452 
453 static void audio_detach_capture (HWVoiceOut *hw)
454 {
455     SWVoiceCap *sc = hw->cap_head.lh_first;
456 
457     while (sc) {
458         SWVoiceCap *sc1 = sc->entries.le_next;
459         SWVoiceOut *sw = &sc->sw;
460         CaptureVoiceOut *cap = sc->cap;
461         int was_active = sw->active;
462 
463         if (sw->rate) {
464             st_rate_stop (sw->rate);
465             sw->rate = NULL;
466         }
467 
468         QLIST_REMOVE (sw, entries);
469         QLIST_REMOVE (sc, entries);
470         g_free (sc);
471         if (was_active) {
472             /* We have removed soft voice from the capture:
473                this might have changed the overall status of the capture
474                since this might have been the only active voice */
475             audio_recalc_and_notify_capture (cap);
476         }
477         sc = sc1;
478     }
479 }
480 
481 static int audio_attach_capture (HWVoiceOut *hw)
482 {
483     AudioState *s = hw->s;
484     CaptureVoiceOut *cap;
485 
486     audio_detach_capture (hw);
487     for (cap = s->cap_head.lh_first; cap; cap = cap->entries.le_next) {
488         SWVoiceCap *sc;
489         SWVoiceOut *sw;
490         HWVoiceOut *hw_cap = &cap->hw;
491 
492         sc = g_malloc0(sizeof(*sc));
493 
494         sc->cap = cap;
495         sw = &sc->sw;
496         sw->hw = hw_cap;
497         sw->info = hw->info;
498         sw->empty = 1;
499         sw->active = hw->enabled;
500         sw->conv = noop_conv;
501         sw->ratio = ((int64_t) hw_cap->info.freq << 32) / sw->info.freq;
502         sw->vol = nominal_volume;
503         sw->rate = st_rate_start (sw->info.freq, hw_cap->info.freq);
504         if (!sw->rate) {
505             dolog ("Could not start rate conversion for `%s'\n", SW_NAME (sw));
506             g_free (sw);
507             return -1;
508         }
509         QLIST_INSERT_HEAD (&hw_cap->sw_head, sw, entries);
510         QLIST_INSERT_HEAD (&hw->cap_head, sc, entries);
511 #ifdef DEBUG_CAPTURE
512         sw->name = g_strdup_printf ("for %p %d,%d,%d",
513                                     hw, sw->info.freq, sw->info.bits,
514                                     sw->info.nchannels);
515         dolog ("Added %s active = %d\n", sw->name, sw->active);
516 #endif
517         if (sw->active) {
518             audio_capture_maybe_changed (cap, 1);
519         }
520     }
521     return 0;
522 }
523 
524 /*
525  * Hard voice (capture)
526  */
527 static size_t audio_pcm_hw_find_min_in (HWVoiceIn *hw)
528 {
529     SWVoiceIn *sw;
530     size_t m = hw->total_samples_captured;
531 
532     for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
533         if (sw->active) {
534             m = MIN (m, sw->total_hw_samples_acquired);
535         }
536     }
537     return m;
538 }
539 
540 static size_t audio_pcm_hw_get_live_in(HWVoiceIn *hw)
541 {
542     size_t live = hw->total_samples_captured - audio_pcm_hw_find_min_in (hw);
543     if (audio_bug(__func__, live > hw->conv_buf->size)) {
544         dolog("live=%zu hw->conv_buf->size=%zu\n", live, hw->conv_buf->size);
545         abort();
546     }
547     return live;
548 }
549 
550 static size_t audio_pcm_hw_conv_in(HWVoiceIn *hw, void *pcm_buf, size_t samples)
551 {
552     size_t conv = 0;
553     STSampleBuffer *conv_buf = hw->conv_buf;
554 
555     while (samples) {
556         uint8_t *src = advance(pcm_buf, conv * hw->info.bytes_per_frame);
557         size_t proc = MIN(samples, conv_buf->size - conv_buf->pos);
558 
559         hw->conv(conv_buf->samples + conv_buf->pos, src, proc);
560         conv_buf->pos = (conv_buf->pos + proc) % conv_buf->size;
561         samples -= proc;
562         conv += proc;
563     }
564 
565     return conv;
566 }
567 
568 /*
569  * Soft voice (capture)
570  */
571 static size_t audio_pcm_sw_read(SWVoiceIn *sw, void *buf, size_t size)
572 {
573     HWVoiceIn *hw = sw->hw;
574     size_t samples, live, ret = 0, swlim, isamp, osamp, rpos, total = 0;
575     struct st_sample *src, *dst = sw->buf;
576 
577     live = hw->total_samples_captured - sw->total_hw_samples_acquired;
578     if (!live) {
579         return 0;
580     }
581     if (audio_bug(__func__, live > hw->conv_buf->size)) {
582         dolog("live_in=%zu hw->conv_buf->size=%zu\n", live, hw->conv_buf->size);
583         abort();
584     }
585 
586     rpos = audio_ring_posb(hw->conv_buf->pos, live, hw->conv_buf->size);
587 
588     samples = size / sw->info.bytes_per_frame;
589 
590     swlim = (live * sw->ratio) >> 32;
591     swlim = MIN (swlim, samples);
592 
593     while (swlim) {
594         src = hw->conv_buf->samples + rpos;
595         if (hw->conv_buf->pos > rpos) {
596             isamp = hw->conv_buf->pos - rpos;
597         } else {
598             isamp = hw->conv_buf->size - rpos;
599         }
600 
601         if (!isamp) {
602             break;
603         }
604         osamp = swlim;
605 
606         st_rate_flow (sw->rate, src, dst, &isamp, &osamp);
607         swlim -= osamp;
608         rpos = (rpos + isamp) % hw->conv_buf->size;
609         dst += osamp;
610         ret += osamp;
611         total += isamp;
612     }
613 
614     if (!hw->pcm_ops->volume_in) {
615         mixeng_volume (sw->buf, ret, &sw->vol);
616     }
617 
618     sw->clip (buf, sw->buf, ret);
619     sw->total_hw_samples_acquired += total;
620     return ret * sw->info.bytes_per_frame;
621 }
622 
623 /*
624  * Hard voice (playback)
625  */
626 static size_t audio_pcm_hw_find_min_out (HWVoiceOut *hw, int *nb_livep)
627 {
628     SWVoiceOut *sw;
629     size_t m = SIZE_MAX;
630     int nb_live = 0;
631 
632     for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
633         if (sw->active || !sw->empty) {
634             m = MIN (m, sw->total_hw_samples_mixed);
635             nb_live += 1;
636         }
637     }
638 
639     *nb_livep = nb_live;
640     return m;
641 }
642 
643 static size_t audio_pcm_hw_get_live_out (HWVoiceOut *hw, int *nb_live)
644 {
645     size_t smin;
646     int nb_live1;
647 
648     smin = audio_pcm_hw_find_min_out (hw, &nb_live1);
649     if (nb_live) {
650         *nb_live = nb_live1;
651     }
652 
653     if (nb_live1) {
654         size_t live = smin;
655 
656         if (audio_bug(__func__, live > hw->mix_buf->size)) {
657             dolog("live=%zu hw->mix_buf->size=%zu\n", live, hw->mix_buf->size);
658             abort();
659         }
660         return live;
661     }
662     return 0;
663 }
664 
665 static size_t audio_pcm_hw_get_free(HWVoiceOut *hw)
666 {
667     return (hw->pcm_ops->buffer_get_free ? hw->pcm_ops->buffer_get_free(hw) :
668             INT_MAX) / hw->info.bytes_per_frame;
669 }
670 
671 static void audio_pcm_hw_clip_out(HWVoiceOut *hw, void *pcm_buf, size_t len)
672 {
673     size_t clipped = 0;
674     size_t pos = hw->mix_buf->pos;
675 
676     while (len) {
677         st_sample *src = hw->mix_buf->samples + pos;
678         uint8_t *dst = advance(pcm_buf, clipped * hw->info.bytes_per_frame);
679         size_t samples_till_end_of_buf = hw->mix_buf->size - pos;
680         size_t samples_to_clip = MIN(len, samples_till_end_of_buf);
681 
682         hw->clip(dst, src, samples_to_clip);
683 
684         pos = (pos + samples_to_clip) % hw->mix_buf->size;
685         len -= samples_to_clip;
686         clipped += samples_to_clip;
687     }
688 }
689 
690 /*
691  * Soft voice (playback)
692  */
693 static size_t audio_pcm_sw_write(SWVoiceOut *sw, void *buf, size_t size)
694 {
695     size_t hwsamples, samples, isamp, osamp, wpos, live, dead, left, blck;
696     size_t hw_free;
697     size_t ret = 0, pos = 0, total = 0;
698 
699     if (!sw) {
700         return size;
701     }
702 
703     hwsamples = sw->hw->mix_buf->size;
704 
705     live = sw->total_hw_samples_mixed;
706     if (audio_bug(__func__, live > hwsamples)) {
707         dolog("live=%zu hw->mix_buf->size=%zu\n", live, hwsamples);
708         abort();
709     }
710 
711     if (live == hwsamples) {
712 #ifdef DEBUG_OUT
713         dolog ("%s is full %zu\n", sw->name, live);
714 #endif
715         return 0;
716     }
717 
718     wpos = (sw->hw->mix_buf->pos + live) % hwsamples;
719 
720     dead = hwsamples - live;
721     hw_free = audio_pcm_hw_get_free(sw->hw);
722     hw_free = hw_free > live ? hw_free - live : 0;
723     samples = ((int64_t)MIN(dead, hw_free) << 32) / sw->ratio;
724     samples = MIN(samples, size / sw->info.bytes_per_frame);
725     if (samples) {
726         sw->conv(sw->buf, buf, samples);
727 
728         if (!sw->hw->pcm_ops->volume_out) {
729             mixeng_volume(sw->buf, samples, &sw->vol);
730         }
731     }
732 
733     while (samples) {
734         dead = hwsamples - live;
735         left = hwsamples - wpos;
736         blck = MIN (dead, left);
737         if (!blck) {
738             break;
739         }
740         isamp = samples;
741         osamp = blck;
742         st_rate_flow_mix (
743             sw->rate,
744             sw->buf + pos,
745             sw->hw->mix_buf->samples + wpos,
746             &isamp,
747             &osamp
748             );
749         ret += isamp;
750         samples -= isamp;
751         pos += isamp;
752         live += osamp;
753         wpos = (wpos + osamp) % hwsamples;
754         total += osamp;
755     }
756 
757     sw->total_hw_samples_mixed += total;
758     sw->empty = sw->total_hw_samples_mixed == 0;
759 
760 #ifdef DEBUG_OUT
761     dolog (
762         "%s: write size %zu ret %zu total sw %zu\n",
763         SW_NAME (sw),
764         size / sw->info.bytes_per_frame,
765         ret,
766         sw->total_hw_samples_mixed
767         );
768 #endif
769 
770     return ret * sw->info.bytes_per_frame;
771 }
772 
773 #ifdef DEBUG_AUDIO
774 static void audio_pcm_print_info (const char *cap, struct audio_pcm_info *info)
775 {
776     dolog("%s: bits %d, sign %d, float %d, freq %d, nchan %d\n",
777           cap, info->bits, info->is_signed, info->is_float, info->freq,
778           info->nchannels);
779 }
780 #endif
781 
782 #define DAC
783 #include "audio_template.h"
784 #undef DAC
785 #include "audio_template.h"
786 
787 /*
788  * Timer
789  */
790 static int audio_is_timer_needed(AudioState *s)
791 {
792     HWVoiceIn *hwi = NULL;
793     HWVoiceOut *hwo = NULL;
794 
795     while ((hwo = audio_pcm_hw_find_any_enabled_out(s, hwo))) {
796         if (!hwo->poll_mode) {
797             return 1;
798         }
799     }
800     while ((hwi = audio_pcm_hw_find_any_enabled_in(s, hwi))) {
801         if (!hwi->poll_mode) {
802             return 1;
803         }
804     }
805     return 0;
806 }
807 
808 static void audio_reset_timer (AudioState *s)
809 {
810     if (audio_is_timer_needed(s)) {
811         timer_mod_anticipate_ns(s->ts,
812             qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL) + s->period_ticks);
813         if (!s->timer_running) {
814             s->timer_running = true;
815             s->timer_last = qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL);
816             trace_audio_timer_start(s->period_ticks / SCALE_MS);
817         }
818     } else {
819         timer_del(s->ts);
820         if (s->timer_running) {
821             s->timer_running = false;
822             trace_audio_timer_stop();
823         }
824     }
825 }
826 
827 static void audio_timer (void *opaque)
828 {
829     int64_t now, diff;
830     AudioState *s = opaque;
831 
832     now = qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL);
833     diff = now - s->timer_last;
834     if (diff > s->period_ticks * 3 / 2) {
835         trace_audio_timer_delayed(diff / SCALE_MS);
836     }
837     s->timer_last = now;
838 
839     audio_run(s, "timer");
840     audio_reset_timer(s);
841 }
842 
843 /*
844  * Public API
845  */
846 size_t AUD_write(SWVoiceOut *sw, void *buf, size_t size)
847 {
848     HWVoiceOut *hw;
849 
850     if (!sw) {
851         /* XXX: Consider options */
852         return size;
853     }
854     hw = sw->hw;
855 
856     if (!hw->enabled) {
857         dolog ("Writing to disabled voice %s\n", SW_NAME (sw));
858         return 0;
859     }
860 
861     if (audio_get_pdo_out(hw->s->dev)->mixing_engine) {
862         return audio_pcm_sw_write(sw, buf, size);
863     } else {
864         return hw->pcm_ops->write(hw, buf, size);
865     }
866 }
867 
868 size_t AUD_read(SWVoiceIn *sw, void *buf, size_t size)
869 {
870     HWVoiceIn *hw;
871 
872     if (!sw) {
873         /* XXX: Consider options */
874         return size;
875     }
876     hw = sw->hw;
877 
878     if (!hw->enabled) {
879         dolog ("Reading from disabled voice %s\n", SW_NAME (sw));
880         return 0;
881     }
882 
883     if (audio_get_pdo_in(hw->s->dev)->mixing_engine) {
884         return audio_pcm_sw_read(sw, buf, size);
885     } else {
886         return hw->pcm_ops->read(hw, buf, size);
887     }
888 }
889 
890 int AUD_get_buffer_size_out(SWVoiceOut *sw)
891 {
892     return sw->hw->samples * sw->hw->info.bytes_per_frame;
893 }
894 
895 void AUD_set_active_out (SWVoiceOut *sw, int on)
896 {
897     HWVoiceOut *hw;
898 
899     if (!sw) {
900         return;
901     }
902 
903     hw = sw->hw;
904     if (sw->active != on) {
905         AudioState *s = sw->s;
906         SWVoiceOut *temp_sw;
907         SWVoiceCap *sc;
908 
909         if (on) {
910             hw->pending_disable = 0;
911             if (!hw->enabled) {
912                 hw->enabled = 1;
913                 if (s->vm_running) {
914                     if (hw->pcm_ops->enable_out) {
915                         hw->pcm_ops->enable_out(hw, true);
916                     }
917                     audio_reset_timer (s);
918                 }
919             }
920         } else {
921             if (hw->enabled) {
922                 int nb_active = 0;
923 
924                 for (temp_sw = hw->sw_head.lh_first; temp_sw;
925                      temp_sw = temp_sw->entries.le_next) {
926                     nb_active += temp_sw->active != 0;
927                 }
928 
929                 hw->pending_disable = nb_active == 1;
930             }
931         }
932 
933         for (sc = hw->cap_head.lh_first; sc; sc = sc->entries.le_next) {
934             sc->sw.active = hw->enabled;
935             if (hw->enabled) {
936                 audio_capture_maybe_changed (sc->cap, 1);
937             }
938         }
939         sw->active = on;
940     }
941 }
942 
943 void AUD_set_active_in (SWVoiceIn *sw, int on)
944 {
945     HWVoiceIn *hw;
946 
947     if (!sw) {
948         return;
949     }
950 
951     hw = sw->hw;
952     if (sw->active != on) {
953         AudioState *s = sw->s;
954         SWVoiceIn *temp_sw;
955 
956         if (on) {
957             if (!hw->enabled) {
958                 hw->enabled = 1;
959                 if (s->vm_running) {
960                     if (hw->pcm_ops->enable_in) {
961                         hw->pcm_ops->enable_in(hw, true);
962                     }
963                     audio_reset_timer (s);
964                 }
965             }
966             sw->total_hw_samples_acquired = hw->total_samples_captured;
967         } else {
968             if (hw->enabled) {
969                 int nb_active = 0;
970 
971                 for (temp_sw = hw->sw_head.lh_first; temp_sw;
972                      temp_sw = temp_sw->entries.le_next) {
973                     nb_active += temp_sw->active != 0;
974                 }
975 
976                 if (nb_active == 1) {
977                     hw->enabled = 0;
978                     if (hw->pcm_ops->enable_in) {
979                         hw->pcm_ops->enable_in(hw, false);
980                     }
981                 }
982             }
983         }
984         sw->active = on;
985     }
986 }
987 
988 static size_t audio_get_avail (SWVoiceIn *sw)
989 {
990     size_t live;
991 
992     if (!sw) {
993         return 0;
994     }
995 
996     live = sw->hw->total_samples_captured - sw->total_hw_samples_acquired;
997     if (audio_bug(__func__, live > sw->hw->conv_buf->size)) {
998         dolog("live=%zu sw->hw->conv_buf->size=%zu\n", live,
999               sw->hw->conv_buf->size);
1000         abort();
1001     }
1002 
1003     ldebug (
1004         "%s: get_avail live %zu ret %" PRId64 "\n",
1005         SW_NAME (sw),
1006         live, (((int64_t) live << 32) / sw->ratio) * sw->info.bytes_per_frame
1007         );
1008 
1009     return (((int64_t) live << 32) / sw->ratio) * sw->info.bytes_per_frame;
1010 }
1011 
1012 static size_t audio_sw_bytes_free(SWVoiceOut *sw, size_t free)
1013 {
1014     return (((int64_t)free << 32) / sw->ratio) * sw->info.bytes_per_frame;
1015 }
1016 
1017 static size_t audio_get_free(SWVoiceOut *sw)
1018 {
1019     size_t live, dead;
1020 
1021     if (!sw) {
1022         return 0;
1023     }
1024 
1025     live = sw->total_hw_samples_mixed;
1026 
1027     if (audio_bug(__func__, live > sw->hw->mix_buf->size)) {
1028         dolog("live=%zu sw->hw->mix_buf->size=%zu\n", live,
1029               sw->hw->mix_buf->size);
1030         abort();
1031     }
1032 
1033     dead = sw->hw->mix_buf->size - live;
1034 
1035 #ifdef DEBUG_OUT
1036     dolog("%s: get_free live %zu dead %zu sw_bytes %zu\n",
1037           SW_NAME(sw), live, dead, audio_sw_bytes_free(sw, dead));
1038 #endif
1039 
1040     return dead;
1041 }
1042 
1043 static void audio_capture_mix_and_clear(HWVoiceOut *hw, size_t rpos,
1044                                         size_t samples)
1045 {
1046     size_t n;
1047 
1048     if (hw->enabled) {
1049         SWVoiceCap *sc;
1050 
1051         for (sc = hw->cap_head.lh_first; sc; sc = sc->entries.le_next) {
1052             SWVoiceOut *sw = &sc->sw;
1053             int rpos2 = rpos;
1054 
1055             n = samples;
1056             while (n) {
1057                 size_t till_end_of_hw = hw->mix_buf->size - rpos2;
1058                 size_t to_write = MIN(till_end_of_hw, n);
1059                 size_t bytes = to_write * hw->info.bytes_per_frame;
1060                 size_t written;
1061 
1062                 sw->buf = hw->mix_buf->samples + rpos2;
1063                 written = audio_pcm_sw_write (sw, NULL, bytes);
1064                 if (written - bytes) {
1065                     dolog("Could not mix %zu bytes into a capture "
1066                           "buffer, mixed %zu\n",
1067                           bytes, written);
1068                     break;
1069                 }
1070                 n -= to_write;
1071                 rpos2 = (rpos2 + to_write) % hw->mix_buf->size;
1072             }
1073         }
1074     }
1075 
1076     n = MIN(samples, hw->mix_buf->size - rpos);
1077     mixeng_clear(hw->mix_buf->samples + rpos, n);
1078     mixeng_clear(hw->mix_buf->samples, samples - n);
1079 }
1080 
1081 static size_t audio_pcm_hw_run_out(HWVoiceOut *hw, size_t live)
1082 {
1083     size_t clipped = 0;
1084 
1085     while (live) {
1086         size_t size = live * hw->info.bytes_per_frame;
1087         size_t decr, proc;
1088         void *buf = hw->pcm_ops->get_buffer_out(hw, &size);
1089 
1090         if (size == 0) {
1091             break;
1092         }
1093 
1094         decr = MIN(size / hw->info.bytes_per_frame, live);
1095         if (buf) {
1096             audio_pcm_hw_clip_out(hw, buf, decr);
1097         }
1098         proc = hw->pcm_ops->put_buffer_out(hw, buf,
1099                                            decr * hw->info.bytes_per_frame) /
1100             hw->info.bytes_per_frame;
1101 
1102         live -= proc;
1103         clipped += proc;
1104         hw->mix_buf->pos = (hw->mix_buf->pos + proc) % hw->mix_buf->size;
1105 
1106         if (proc == 0 || proc < decr) {
1107             break;
1108         }
1109     }
1110 
1111     if (hw->pcm_ops->run_buffer_out) {
1112         hw->pcm_ops->run_buffer_out(hw);
1113     }
1114 
1115     return clipped;
1116 }
1117 
1118 static void audio_run_out (AudioState *s)
1119 {
1120     HWVoiceOut *hw = NULL;
1121     SWVoiceOut *sw;
1122 
1123     if (!audio_get_pdo_out(s->dev)->mixing_engine) {
1124         while ((hw = audio_pcm_hw_find_any_enabled_out(s, hw))) {
1125             /* there is exactly 1 sw for each hw with no mixeng */
1126             sw = hw->sw_head.lh_first;
1127 
1128             if (hw->pending_disable) {
1129                 hw->enabled = 0;
1130                 hw->pending_disable = 0;
1131                 if (hw->pcm_ops->enable_out) {
1132                     hw->pcm_ops->enable_out(hw, false);
1133                 }
1134             }
1135 
1136             if (sw->active) {
1137                 sw->callback.fn(sw->callback.opaque, INT_MAX);
1138             }
1139         }
1140         return;
1141     }
1142 
1143     while ((hw = audio_pcm_hw_find_any_enabled_out(s, hw))) {
1144         size_t played, live, prev_rpos;
1145         size_t hw_free = audio_pcm_hw_get_free(hw);
1146         int nb_live;
1147 
1148         for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
1149             if (sw->active) {
1150                 size_t sw_free = audio_get_free(sw);
1151                 size_t free;
1152 
1153                 if (hw_free > sw->total_hw_samples_mixed) {
1154                     free = audio_sw_bytes_free(sw,
1155                         MIN(sw_free, hw_free - sw->total_hw_samples_mixed));
1156                 } else {
1157                     free = 0;
1158                 }
1159                 if (free > 0) {
1160                     sw->callback.fn(sw->callback.opaque, free);
1161                 }
1162             }
1163         }
1164 
1165         live = audio_pcm_hw_get_live_out (hw, &nb_live);
1166         if (!nb_live) {
1167             live = 0;
1168         }
1169 
1170         if (audio_bug(__func__, live > hw->mix_buf->size)) {
1171             dolog("live=%zu hw->mix_buf->size=%zu\n", live, hw->mix_buf->size);
1172             abort();
1173         }
1174 
1175         if (hw->pending_disable && !nb_live) {
1176             SWVoiceCap *sc;
1177 #ifdef DEBUG_OUT
1178             dolog ("Disabling voice\n");
1179 #endif
1180             hw->enabled = 0;
1181             hw->pending_disable = 0;
1182             if (hw->pcm_ops->enable_out) {
1183                 hw->pcm_ops->enable_out(hw, false);
1184             }
1185             for (sc = hw->cap_head.lh_first; sc; sc = sc->entries.le_next) {
1186                 sc->sw.active = 0;
1187                 audio_recalc_and_notify_capture (sc->cap);
1188             }
1189             continue;
1190         }
1191 
1192         if (!live) {
1193             if (hw->pcm_ops->run_buffer_out) {
1194                 hw->pcm_ops->run_buffer_out(hw);
1195             }
1196             continue;
1197         }
1198 
1199         prev_rpos = hw->mix_buf->pos;
1200         played = audio_pcm_hw_run_out(hw, live);
1201         replay_audio_out(&played);
1202         if (audio_bug(__func__, hw->mix_buf->pos >= hw->mix_buf->size)) {
1203             dolog("hw->mix_buf->pos=%zu hw->mix_buf->size=%zu played=%zu\n",
1204                   hw->mix_buf->pos, hw->mix_buf->size, played);
1205             abort();
1206         }
1207 
1208 #ifdef DEBUG_OUT
1209         dolog("played=%zu\n", played);
1210 #endif
1211 
1212         if (played) {
1213             hw->ts_helper += played;
1214             audio_capture_mix_and_clear (hw, prev_rpos, played);
1215         }
1216 
1217         for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
1218             if (!sw->active && sw->empty) {
1219                 continue;
1220             }
1221 
1222             if (audio_bug(__func__, played > sw->total_hw_samples_mixed)) {
1223                 dolog("played=%zu sw->total_hw_samples_mixed=%zu\n",
1224                       played, sw->total_hw_samples_mixed);
1225                 abort();
1226             }
1227 
1228             sw->total_hw_samples_mixed -= played;
1229 
1230             if (!sw->total_hw_samples_mixed) {
1231                 sw->empty = 1;
1232             }
1233         }
1234     }
1235 }
1236 
1237 static size_t audio_pcm_hw_run_in(HWVoiceIn *hw, size_t samples)
1238 {
1239     size_t conv = 0;
1240 
1241     if (hw->pcm_ops->run_buffer_in) {
1242         hw->pcm_ops->run_buffer_in(hw);
1243     }
1244 
1245     while (samples) {
1246         size_t proc;
1247         size_t size = samples * hw->info.bytes_per_frame;
1248         void *buf = hw->pcm_ops->get_buffer_in(hw, &size);
1249 
1250         assert(size % hw->info.bytes_per_frame == 0);
1251         if (size == 0) {
1252             break;
1253         }
1254 
1255         proc = audio_pcm_hw_conv_in(hw, buf, size / hw->info.bytes_per_frame);
1256 
1257         samples -= proc;
1258         conv += proc;
1259         hw->pcm_ops->put_buffer_in(hw, buf, proc * hw->info.bytes_per_frame);
1260     }
1261 
1262     return conv;
1263 }
1264 
1265 static void audio_run_in (AudioState *s)
1266 {
1267     HWVoiceIn *hw = NULL;
1268 
1269     if (!audio_get_pdo_in(s->dev)->mixing_engine) {
1270         while ((hw = audio_pcm_hw_find_any_enabled_in(s, hw))) {
1271             /* there is exactly 1 sw for each hw with no mixeng */
1272             SWVoiceIn *sw = hw->sw_head.lh_first;
1273             if (sw->active) {
1274                 sw->callback.fn(sw->callback.opaque, INT_MAX);
1275             }
1276         }
1277         return;
1278     }
1279 
1280     while ((hw = audio_pcm_hw_find_any_enabled_in(s, hw))) {
1281         SWVoiceIn *sw;
1282         size_t captured = 0, min;
1283 
1284         if (replay_mode != REPLAY_MODE_PLAY) {
1285             captured = audio_pcm_hw_run_in(
1286                 hw, hw->conv_buf->size - audio_pcm_hw_get_live_in(hw));
1287         }
1288         replay_audio_in(&captured, hw->conv_buf->samples, &hw->conv_buf->pos,
1289                         hw->conv_buf->size);
1290 
1291         min = audio_pcm_hw_find_min_in (hw);
1292         hw->total_samples_captured += captured - min;
1293         hw->ts_helper += captured;
1294 
1295         for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
1296             sw->total_hw_samples_acquired -= min;
1297 
1298             if (sw->active) {
1299                 size_t avail;
1300 
1301                 avail = audio_get_avail (sw);
1302                 if (avail > 0) {
1303                     sw->callback.fn (sw->callback.opaque, avail);
1304                 }
1305             }
1306         }
1307     }
1308 }
1309 
1310 static void audio_run_capture (AudioState *s)
1311 {
1312     CaptureVoiceOut *cap;
1313 
1314     for (cap = s->cap_head.lh_first; cap; cap = cap->entries.le_next) {
1315         size_t live, rpos, captured;
1316         HWVoiceOut *hw = &cap->hw;
1317         SWVoiceOut *sw;
1318 
1319         captured = live = audio_pcm_hw_get_live_out (hw, NULL);
1320         rpos = hw->mix_buf->pos;
1321         while (live) {
1322             size_t left = hw->mix_buf->size - rpos;
1323             size_t to_capture = MIN(live, left);
1324             struct st_sample *src;
1325             struct capture_callback *cb;
1326 
1327             src = hw->mix_buf->samples + rpos;
1328             hw->clip (cap->buf, src, to_capture);
1329             mixeng_clear (src, to_capture);
1330 
1331             for (cb = cap->cb_head.lh_first; cb; cb = cb->entries.le_next) {
1332                 cb->ops.capture (cb->opaque, cap->buf,
1333                                  to_capture * hw->info.bytes_per_frame);
1334             }
1335             rpos = (rpos + to_capture) % hw->mix_buf->size;
1336             live -= to_capture;
1337         }
1338         hw->mix_buf->pos = rpos;
1339 
1340         for (sw = hw->sw_head.lh_first; sw; sw = sw->entries.le_next) {
1341             if (!sw->active && sw->empty) {
1342                 continue;
1343             }
1344 
1345             if (audio_bug(__func__, captured > sw->total_hw_samples_mixed)) {
1346                 dolog("captured=%zu sw->total_hw_samples_mixed=%zu\n",
1347                       captured, sw->total_hw_samples_mixed);
1348                 abort();
1349             }
1350 
1351             sw->total_hw_samples_mixed -= captured;
1352             sw->empty = sw->total_hw_samples_mixed == 0;
1353         }
1354     }
1355 }
1356 
1357 void audio_run(AudioState *s, const char *msg)
1358 {
1359     audio_run_out(s);
1360     audio_run_in(s);
1361     audio_run_capture(s);
1362 
1363 #ifdef DEBUG_POLL
1364     {
1365         static double prevtime;
1366         double currtime;
1367         struct timeval tv;
1368 
1369         if (gettimeofday (&tv, NULL)) {
1370             perror ("audio_run: gettimeofday");
1371             return;
1372         }
1373 
1374         currtime = tv.tv_sec + tv.tv_usec * 1e-6;
1375         dolog ("Elapsed since last %s: %f\n", msg, currtime - prevtime);
1376         prevtime = currtime;
1377     }
1378 #endif
1379 }
1380 
1381 void audio_generic_run_buffer_in(HWVoiceIn *hw)
1382 {
1383     if (unlikely(!hw->buf_emul)) {
1384         hw->size_emul = hw->samples * hw->info.bytes_per_frame;
1385         hw->buf_emul = g_malloc(hw->size_emul);
1386         hw->pos_emul = hw->pending_emul = 0;
1387     }
1388 
1389     while (hw->pending_emul < hw->size_emul) {
1390         size_t read_len = MIN(hw->size_emul - hw->pos_emul,
1391                               hw->size_emul - hw->pending_emul);
1392         size_t read = hw->pcm_ops->read(hw, hw->buf_emul + hw->pos_emul,
1393                                         read_len);
1394         hw->pending_emul += read;
1395         hw->pos_emul = (hw->pos_emul + read) % hw->size_emul;
1396         if (read < read_len) {
1397             break;
1398         }
1399     }
1400 }
1401 
1402 void *audio_generic_get_buffer_in(HWVoiceIn *hw, size_t *size)
1403 {
1404     size_t start;
1405 
1406     start = audio_ring_posb(hw->pos_emul, hw->pending_emul, hw->size_emul);
1407     assert(start < hw->size_emul);
1408 
1409     *size = MIN(*size, hw->pending_emul);
1410     *size = MIN(*size, hw->size_emul - start);
1411     return hw->buf_emul + start;
1412 }
1413 
1414 void audio_generic_put_buffer_in(HWVoiceIn *hw, void *buf, size_t size)
1415 {
1416     assert(size <= hw->pending_emul);
1417     hw->pending_emul -= size;
1418 }
1419 
1420 size_t audio_generic_buffer_get_free(HWVoiceOut *hw)
1421 {
1422     if (hw->buf_emul) {
1423         return hw->size_emul - hw->pending_emul;
1424     } else {
1425         return hw->samples * hw->info.bytes_per_frame;
1426     }
1427 }
1428 
1429 void audio_generic_run_buffer_out(HWVoiceOut *hw)
1430 {
1431     while (hw->pending_emul) {
1432         size_t write_len, written, start;
1433 
1434         start = audio_ring_posb(hw->pos_emul, hw->pending_emul, hw->size_emul);
1435         assert(start < hw->size_emul);
1436 
1437         write_len = MIN(hw->pending_emul, hw->size_emul - start);
1438 
1439         written = hw->pcm_ops->write(hw, hw->buf_emul + start, write_len);
1440         hw->pending_emul -= written;
1441 
1442         if (written < write_len) {
1443             break;
1444         }
1445     }
1446 }
1447 
1448 void *audio_generic_get_buffer_out(HWVoiceOut *hw, size_t *size)
1449 {
1450     if (unlikely(!hw->buf_emul)) {
1451         hw->size_emul = hw->samples * hw->info.bytes_per_frame;
1452         hw->buf_emul = g_malloc(hw->size_emul);
1453         hw->pos_emul = hw->pending_emul = 0;
1454     }
1455 
1456     *size = MIN(hw->size_emul - hw->pending_emul,
1457                 hw->size_emul - hw->pos_emul);
1458     return hw->buf_emul + hw->pos_emul;
1459 }
1460 
1461 size_t audio_generic_put_buffer_out(HWVoiceOut *hw, void *buf, size_t size)
1462 {
1463     assert(buf == hw->buf_emul + hw->pos_emul &&
1464            size + hw->pending_emul <= hw->size_emul);
1465 
1466     hw->pending_emul += size;
1467     hw->pos_emul = (hw->pos_emul + size) % hw->size_emul;
1468 
1469     return size;
1470 }
1471 
1472 size_t audio_generic_write(HWVoiceOut *hw, void *buf, size_t size)
1473 {
1474     size_t total = 0;
1475 
1476     if (hw->pcm_ops->buffer_get_free) {
1477         size_t free = hw->pcm_ops->buffer_get_free(hw);
1478 
1479         size = MIN(size, free);
1480     }
1481 
1482     while (total < size) {
1483         size_t dst_size = size - total;
1484         size_t copy_size, proc;
1485         void *dst = hw->pcm_ops->get_buffer_out(hw, &dst_size);
1486 
1487         if (dst_size == 0) {
1488             break;
1489         }
1490 
1491         copy_size = MIN(size - total, dst_size);
1492         if (dst) {
1493             memcpy(dst, (char *)buf + total, copy_size);
1494         }
1495         proc = hw->pcm_ops->put_buffer_out(hw, dst, copy_size);
1496         total += proc;
1497 
1498         if (proc == 0 || proc < copy_size) {
1499             break;
1500         }
1501     }
1502 
1503     if (hw->pcm_ops->run_buffer_out) {
1504         hw->pcm_ops->run_buffer_out(hw);
1505     }
1506 
1507     return total;
1508 }
1509 
1510 size_t audio_generic_read(HWVoiceIn *hw, void *buf, size_t size)
1511 {
1512     size_t total = 0;
1513 
1514     if (hw->pcm_ops->run_buffer_in) {
1515         hw->pcm_ops->run_buffer_in(hw);
1516     }
1517 
1518     while (total < size) {
1519         size_t src_size = size - total;
1520         void *src = hw->pcm_ops->get_buffer_in(hw, &src_size);
1521 
1522         if (src_size == 0) {
1523             break;
1524         }
1525 
1526         memcpy((char *)buf + total, src, src_size);
1527         hw->pcm_ops->put_buffer_in(hw, src, src_size);
1528         total += src_size;
1529     }
1530 
1531     return total;
1532 }
1533 
1534 static int audio_driver_init(AudioState *s, struct audio_driver *drv,
1535                              bool msg, Audiodev *dev)
1536 {
1537     s->drv_opaque = drv->init(dev);
1538 
1539     if (s->drv_opaque) {
1540         if (!drv->pcm_ops->get_buffer_in) {
1541             drv->pcm_ops->get_buffer_in = audio_generic_get_buffer_in;
1542             drv->pcm_ops->put_buffer_in = audio_generic_put_buffer_in;
1543         }
1544         if (!drv->pcm_ops->get_buffer_out) {
1545             drv->pcm_ops->get_buffer_out = audio_generic_get_buffer_out;
1546             drv->pcm_ops->put_buffer_out = audio_generic_put_buffer_out;
1547         }
1548 
1549         audio_init_nb_voices_out(s, drv);
1550         audio_init_nb_voices_in(s, drv);
1551         s->drv = drv;
1552         return 0;
1553     } else {
1554         if (msg) {
1555             dolog("Could not init `%s' audio driver\n", drv->name);
1556         }
1557         return -1;
1558     }
1559 }
1560 
1561 static void audio_vm_change_state_handler (void *opaque, bool running,
1562                                            RunState state)
1563 {
1564     AudioState *s = opaque;
1565     HWVoiceOut *hwo = NULL;
1566     HWVoiceIn *hwi = NULL;
1567 
1568     s->vm_running = running;
1569     while ((hwo = audio_pcm_hw_find_any_enabled_out(s, hwo))) {
1570         if (hwo->pcm_ops->enable_out) {
1571             hwo->pcm_ops->enable_out(hwo, running);
1572         }
1573     }
1574 
1575     while ((hwi = audio_pcm_hw_find_any_enabled_in(s, hwi))) {
1576         if (hwi->pcm_ops->enable_in) {
1577             hwi->pcm_ops->enable_in(hwi, running);
1578         }
1579     }
1580     audio_reset_timer (s);
1581 }
1582 
1583 static void free_audio_state(AudioState *s)
1584 {
1585     HWVoiceOut *hwo, *hwon;
1586     HWVoiceIn *hwi, *hwin;
1587 
1588     QLIST_FOREACH_SAFE(hwo, &s->hw_head_out, entries, hwon) {
1589         SWVoiceCap *sc;
1590 
1591         if (hwo->enabled && hwo->pcm_ops->enable_out) {
1592             hwo->pcm_ops->enable_out(hwo, false);
1593         }
1594         hwo->pcm_ops->fini_out (hwo);
1595 
1596         for (sc = hwo->cap_head.lh_first; sc; sc = sc->entries.le_next) {
1597             CaptureVoiceOut *cap = sc->cap;
1598             struct capture_callback *cb;
1599 
1600             for (cb = cap->cb_head.lh_first; cb; cb = cb->entries.le_next) {
1601                 cb->ops.destroy (cb->opaque);
1602             }
1603         }
1604         QLIST_REMOVE(hwo, entries);
1605     }
1606 
1607     QLIST_FOREACH_SAFE(hwi, &s->hw_head_in, entries, hwin) {
1608         if (hwi->enabled && hwi->pcm_ops->enable_in) {
1609             hwi->pcm_ops->enable_in(hwi, false);
1610         }
1611         hwi->pcm_ops->fini_in (hwi);
1612         QLIST_REMOVE(hwi, entries);
1613     }
1614 
1615     if (s->drv) {
1616         s->drv->fini (s->drv_opaque);
1617         s->drv = NULL;
1618     }
1619 
1620     if (s->dev) {
1621         qapi_free_Audiodev(s->dev);
1622         s->dev = NULL;
1623     }
1624 
1625     if (s->ts) {
1626         timer_free(s->ts);
1627         s->ts = NULL;
1628     }
1629 
1630     g_free(s);
1631 }
1632 
1633 void audio_cleanup(void)
1634 {
1635     while (!QTAILQ_EMPTY(&audio_states)) {
1636         AudioState *s = QTAILQ_FIRST(&audio_states);
1637         QTAILQ_REMOVE(&audio_states, s, list);
1638         free_audio_state(s);
1639     }
1640 }
1641 
1642 static bool vmstate_audio_needed(void *opaque)
1643 {
1644     /*
1645      * Never needed, this vmstate only exists in case
1646      * an old qemu sends it to us.
1647      */
1648     return false;
1649 }
1650 
1651 static const VMStateDescription vmstate_audio = {
1652     .name = "audio",
1653     .version_id = 1,
1654     .minimum_version_id = 1,
1655     .needed = vmstate_audio_needed,
1656     .fields = (VMStateField[]) {
1657         VMSTATE_END_OF_LIST()
1658     }
1659 };
1660 
1661 static void audio_validate_opts(Audiodev *dev, Error **errp);
1662 
1663 static AudiodevListEntry *audiodev_find(
1664     AudiodevListHead *head, const char *drvname)
1665 {
1666     AudiodevListEntry *e;
1667     QSIMPLEQ_FOREACH(e, head, next) {
1668         if (strcmp(AudiodevDriver_str(e->dev->driver), drvname) == 0) {
1669             return e;
1670         }
1671     }
1672 
1673     return NULL;
1674 }
1675 
1676 /*
1677  * if we have dev, this function was called because of an -audiodev argument =>
1678  *   initialize a new state with it
1679  * if dev == NULL => legacy implicit initialization, return the already created
1680  *   state or create a new one
1681  */
1682 static AudioState *audio_init(Audiodev *dev, const char *name)
1683 {
1684     static bool atexit_registered;
1685     size_t i;
1686     int done = 0;
1687     const char *drvname = NULL;
1688     VMChangeStateEntry *e;
1689     AudioState *s;
1690     struct audio_driver *driver;
1691     /* silence gcc warning about uninitialized variable */
1692     AudiodevListHead head = QSIMPLEQ_HEAD_INITIALIZER(head);
1693 
1694     if (using_spice) {
1695         /*
1696          * When using spice allow the spice audio driver being picked
1697          * as default.
1698          *
1699          * Temporary hack.  Using audio devices without explicit
1700          * audiodev= property is already deprecated.  Same goes for
1701          * the -soundhw switch.  Once this support gets finally
1702          * removed we can also drop the concept of a default audio
1703          * backend and this can go away.
1704          */
1705         driver = audio_driver_lookup("spice");
1706         if (driver) {
1707             driver->can_be_default = 1;
1708         }
1709     }
1710 
1711     if (dev) {
1712         /* -audiodev option */
1713         legacy_config = false;
1714         drvname = AudiodevDriver_str(dev->driver);
1715     } else if (!QTAILQ_EMPTY(&audio_states)) {
1716         if (!legacy_config) {
1717             dolog("Device %s: audiodev default parameter is deprecated, please "
1718                   "specify audiodev=%s\n", name,
1719                   QTAILQ_FIRST(&audio_states)->dev->id);
1720         }
1721         return QTAILQ_FIRST(&audio_states);
1722     } else {
1723         /* legacy implicit initialization */
1724         head = audio_handle_legacy_opts();
1725         /*
1726          * In case of legacy initialization, all Audiodevs in the list will have
1727          * the same configuration (except the driver), so it doesn't matter which
1728          * one we chose.  We need an Audiodev to set up AudioState before we can
1729          * init a driver.  Also note that dev at this point is still in the
1730          * list.
1731          */
1732         dev = QSIMPLEQ_FIRST(&head)->dev;
1733         audio_validate_opts(dev, &error_abort);
1734     }
1735 
1736     s = g_new0(AudioState, 1);
1737     s->dev = dev;
1738 
1739     QLIST_INIT (&s->hw_head_out);
1740     QLIST_INIT (&s->hw_head_in);
1741     QLIST_INIT (&s->cap_head);
1742     if (!atexit_registered) {
1743         atexit(audio_cleanup);
1744         atexit_registered = true;
1745     }
1746     QTAILQ_INSERT_TAIL(&audio_states, s, list);
1747 
1748     s->ts = timer_new_ns(QEMU_CLOCK_VIRTUAL, audio_timer, s);
1749 
1750     s->nb_hw_voices_out = audio_get_pdo_out(dev)->voices;
1751     s->nb_hw_voices_in = audio_get_pdo_in(dev)->voices;
1752 
1753     if (s->nb_hw_voices_out <= 0) {
1754         dolog ("Bogus number of playback voices %d, setting to 1\n",
1755                s->nb_hw_voices_out);
1756         s->nb_hw_voices_out = 1;
1757     }
1758 
1759     if (s->nb_hw_voices_in <= 0) {
1760         dolog ("Bogus number of capture voices %d, setting to 0\n",
1761                s->nb_hw_voices_in);
1762         s->nb_hw_voices_in = 0;
1763     }
1764 
1765     if (drvname) {
1766         driver = audio_driver_lookup(drvname);
1767         if (driver) {
1768             done = !audio_driver_init(s, driver, true, dev);
1769         } else {
1770             dolog ("Unknown audio driver `%s'\n", drvname);
1771         }
1772     } else {
1773         for (i = 0; audio_prio_list[i]; i++) {
1774             AudiodevListEntry *e = audiodev_find(&head, audio_prio_list[i]);
1775             driver = audio_driver_lookup(audio_prio_list[i]);
1776 
1777             if (e && driver) {
1778                 s->dev = dev = e->dev;
1779                 audio_validate_opts(dev, &error_abort);
1780                 done = !audio_driver_init(s, driver, false, dev);
1781                 if (done) {
1782                     e->dev = NULL;
1783                     break;
1784                 }
1785             }
1786         }
1787     }
1788     audio_free_audiodev_list(&head);
1789 
1790     if (!done) {
1791         driver = audio_driver_lookup("none");
1792         done = !audio_driver_init(s, driver, false, dev);
1793         assert(done);
1794         dolog("warning: Using timer based audio emulation\n");
1795     }
1796 
1797     if (dev->timer_period <= 0) {
1798         s->period_ticks = 1;
1799     } else {
1800         s->period_ticks = dev->timer_period * (int64_t)SCALE_US;
1801     }
1802 
1803     e = qemu_add_vm_change_state_handler (audio_vm_change_state_handler, s);
1804     if (!e) {
1805         dolog ("warning: Could not register change state handler\n"
1806                "(Audio can continue looping even after stopping the VM)\n");
1807     }
1808 
1809     QLIST_INIT (&s->card_head);
1810     vmstate_register (NULL, 0, &vmstate_audio, s);
1811     return s;
1812 }
1813 
1814 void audio_free_audiodev_list(AudiodevListHead *head)
1815 {
1816     AudiodevListEntry *e;
1817     while ((e = QSIMPLEQ_FIRST(head))) {
1818         QSIMPLEQ_REMOVE_HEAD(head, next);
1819         qapi_free_Audiodev(e->dev);
1820         g_free(e);
1821     }
1822 }
1823 
1824 void AUD_register_card (const char *name, QEMUSoundCard *card)
1825 {
1826     if (!card->state) {
1827         card->state = audio_init(NULL, name);
1828     }
1829 
1830     card->name = g_strdup (name);
1831     memset (&card->entries, 0, sizeof (card->entries));
1832     QLIST_INSERT_HEAD(&card->state->card_head, card, entries);
1833 }
1834 
1835 void AUD_remove_card (QEMUSoundCard *card)
1836 {
1837     QLIST_REMOVE (card, entries);
1838     g_free (card->name);
1839 }
1840 
1841 static struct audio_pcm_ops capture_pcm_ops;
1842 
1843 CaptureVoiceOut *AUD_add_capture(
1844     AudioState *s,
1845     struct audsettings *as,
1846     struct audio_capture_ops *ops,
1847     void *cb_opaque
1848     )
1849 {
1850     CaptureVoiceOut *cap;
1851     struct capture_callback *cb;
1852 
1853     if (!s) {
1854         if (!legacy_config) {
1855             dolog("Capturing without setting an audiodev is deprecated\n");
1856         }
1857         s = audio_init(NULL, NULL);
1858     }
1859 
1860     if (!audio_get_pdo_out(s->dev)->mixing_engine) {
1861         dolog("Can't capture with mixeng disabled\n");
1862         return NULL;
1863     }
1864 
1865     if (audio_validate_settings (as)) {
1866         dolog ("Invalid settings were passed when trying to add capture\n");
1867         audio_print_settings (as);
1868         return NULL;
1869     }
1870 
1871     cb = g_malloc0(sizeof(*cb));
1872     cb->ops = *ops;
1873     cb->opaque = cb_opaque;
1874 
1875     cap = audio_pcm_capture_find_specific(s, as);
1876     if (cap) {
1877         QLIST_INSERT_HEAD (&cap->cb_head, cb, entries);
1878         return cap;
1879     } else {
1880         HWVoiceOut *hw;
1881         CaptureVoiceOut *cap;
1882 
1883         cap = g_malloc0(sizeof(*cap));
1884 
1885         hw = &cap->hw;
1886         hw->s = s;
1887         hw->pcm_ops = &capture_pcm_ops;
1888         QLIST_INIT (&hw->sw_head);
1889         QLIST_INIT (&cap->cb_head);
1890 
1891         /* XXX find a more elegant way */
1892         hw->samples = 4096 * 4;
1893         audio_pcm_hw_alloc_resources_out(hw);
1894 
1895         audio_pcm_init_info (&hw->info, as);
1896 
1897         cap->buf = g_malloc0_n(hw->mix_buf->size, hw->info.bytes_per_frame);
1898 
1899         if (hw->info.is_float) {
1900             hw->clip = mixeng_clip_float[hw->info.nchannels == 2];
1901         } else {
1902             hw->clip = mixeng_clip
1903                 [hw->info.nchannels == 2]
1904                 [hw->info.is_signed]
1905                 [hw->info.swap_endianness]
1906                 [audio_bits_to_index(hw->info.bits)];
1907         }
1908 
1909         QLIST_INSERT_HEAD (&s->cap_head, cap, entries);
1910         QLIST_INSERT_HEAD (&cap->cb_head, cb, entries);
1911 
1912         QLIST_FOREACH(hw, &s->hw_head_out, entries) {
1913             audio_attach_capture (hw);
1914         }
1915         return cap;
1916     }
1917 }
1918 
1919 void AUD_del_capture (CaptureVoiceOut *cap, void *cb_opaque)
1920 {
1921     struct capture_callback *cb;
1922 
1923     for (cb = cap->cb_head.lh_first; cb; cb = cb->entries.le_next) {
1924         if (cb->opaque == cb_opaque) {
1925             cb->ops.destroy (cb_opaque);
1926             QLIST_REMOVE (cb, entries);
1927             g_free (cb);
1928 
1929             if (!cap->cb_head.lh_first) {
1930                 SWVoiceOut *sw = cap->hw.sw_head.lh_first, *sw1;
1931 
1932                 while (sw) {
1933                     SWVoiceCap *sc = (SWVoiceCap *) sw;
1934 #ifdef DEBUG_CAPTURE
1935                     dolog ("freeing %s\n", sw->name);
1936 #endif
1937 
1938                     sw1 = sw->entries.le_next;
1939                     if (sw->rate) {
1940                         st_rate_stop (sw->rate);
1941                         sw->rate = NULL;
1942                     }
1943                     QLIST_REMOVE (sw, entries);
1944                     QLIST_REMOVE (sc, entries);
1945                     g_free (sc);
1946                     sw = sw1;
1947                 }
1948                 QLIST_REMOVE (cap, entries);
1949                 g_free (cap->hw.mix_buf);
1950                 g_free (cap->buf);
1951                 g_free (cap);
1952             }
1953             return;
1954         }
1955     }
1956 }
1957 
1958 void AUD_set_volume_out (SWVoiceOut *sw, int mute, uint8_t lvol, uint8_t rvol)
1959 {
1960     Volume vol = { .mute = mute, .channels = 2, .vol = { lvol, rvol } };
1961     audio_set_volume_out(sw, &vol);
1962 }
1963 
1964 void audio_set_volume_out(SWVoiceOut *sw, Volume *vol)
1965 {
1966     if (sw) {
1967         HWVoiceOut *hw = sw->hw;
1968 
1969         sw->vol.mute = vol->mute;
1970         sw->vol.l = nominal_volume.l * vol->vol[0] / 255;
1971         sw->vol.r = nominal_volume.l * vol->vol[vol->channels > 1 ? 1 : 0] /
1972             255;
1973 
1974         if (hw->pcm_ops->volume_out) {
1975             hw->pcm_ops->volume_out(hw, vol);
1976         }
1977     }
1978 }
1979 
1980 void AUD_set_volume_in (SWVoiceIn *sw, int mute, uint8_t lvol, uint8_t rvol)
1981 {
1982     Volume vol = { .mute = mute, .channels = 2, .vol = { lvol, rvol } };
1983     audio_set_volume_in(sw, &vol);
1984 }
1985 
1986 void audio_set_volume_in(SWVoiceIn *sw, Volume *vol)
1987 {
1988     if (sw) {
1989         HWVoiceIn *hw = sw->hw;
1990 
1991         sw->vol.mute = vol->mute;
1992         sw->vol.l = nominal_volume.l * vol->vol[0] / 255;
1993         sw->vol.r = nominal_volume.r * vol->vol[vol->channels > 1 ? 1 : 0] /
1994             255;
1995 
1996         if (hw->pcm_ops->volume_in) {
1997             hw->pcm_ops->volume_in(hw, vol);
1998         }
1999     }
2000 }
2001 
2002 void audio_create_pdos(Audiodev *dev)
2003 {
2004     switch (dev->driver) {
2005 #define CASE(DRIVER, driver, pdo_name)                              \
2006     case AUDIODEV_DRIVER_##DRIVER:                                  \
2007         if (!dev->u.driver.has_in) {                                \
2008             dev->u.driver.in = g_malloc0(                           \
2009                 sizeof(Audiodev##pdo_name##PerDirectionOptions));   \
2010             dev->u.driver.has_in = true;                            \
2011         }                                                           \
2012         if (!dev->u.driver.has_out) {                               \
2013             dev->u.driver.out = g_malloc0(                          \
2014                 sizeof(Audiodev##pdo_name##PerDirectionOptions));   \
2015             dev->u.driver.has_out = true;                           \
2016         }                                                           \
2017         break
2018 
2019         CASE(NONE, none, );
2020         CASE(ALSA, alsa, Alsa);
2021         CASE(COREAUDIO, coreaudio, Coreaudio);
2022         CASE(DBUS, dbus, );
2023         CASE(DSOUND, dsound, );
2024         CASE(JACK, jack, Jack);
2025         CASE(OSS, oss, Oss);
2026         CASE(PA, pa, Pa);
2027         CASE(SDL, sdl, Sdl);
2028         CASE(SPICE, spice, );
2029         CASE(WAV, wav, );
2030 
2031     case AUDIODEV_DRIVER__MAX:
2032         abort();
2033     };
2034 }
2035 
2036 static void audio_validate_per_direction_opts(
2037     AudiodevPerDirectionOptions *pdo, Error **errp)
2038 {
2039     if (!pdo->has_mixing_engine) {
2040         pdo->has_mixing_engine = true;
2041         pdo->mixing_engine = true;
2042     }
2043     if (!pdo->has_fixed_settings) {
2044         pdo->has_fixed_settings = true;
2045         pdo->fixed_settings = pdo->mixing_engine;
2046     }
2047     if (!pdo->fixed_settings &&
2048         (pdo->has_frequency || pdo->has_channels || pdo->has_format)) {
2049         error_setg(errp,
2050                    "You can't use frequency, channels or format with fixed-settings=off");
2051         return;
2052     }
2053     if (!pdo->mixing_engine && pdo->fixed_settings) {
2054         error_setg(errp, "You can't use fixed-settings without mixeng");
2055         return;
2056     }
2057 
2058     if (!pdo->has_frequency) {
2059         pdo->has_frequency = true;
2060         pdo->frequency = 44100;
2061     }
2062     if (!pdo->has_channels) {
2063         pdo->has_channels = true;
2064         pdo->channels = 2;
2065     }
2066     if (!pdo->has_voices) {
2067         pdo->has_voices = true;
2068         pdo->voices = pdo->mixing_engine ? 1 : INT_MAX;
2069     }
2070     if (!pdo->has_format) {
2071         pdo->has_format = true;
2072         pdo->format = AUDIO_FORMAT_S16;
2073     }
2074 }
2075 
2076 static void audio_validate_opts(Audiodev *dev, Error **errp)
2077 {
2078     Error *err = NULL;
2079 
2080     audio_create_pdos(dev);
2081 
2082     audio_validate_per_direction_opts(audio_get_pdo_in(dev), &err);
2083     if (err) {
2084         error_propagate(errp, err);
2085         return;
2086     }
2087 
2088     audio_validate_per_direction_opts(audio_get_pdo_out(dev), &err);
2089     if (err) {
2090         error_propagate(errp, err);
2091         return;
2092     }
2093 
2094     if (!dev->has_timer_period) {
2095         dev->has_timer_period = true;
2096         dev->timer_period = 10000; /* 100Hz -> 10ms */
2097     }
2098 }
2099 
2100 void audio_parse_option(const char *opt)
2101 {
2102     Audiodev *dev = NULL;
2103 
2104     Visitor *v = qobject_input_visitor_new_str(opt, "driver", &error_fatal);
2105     visit_type_Audiodev(v, NULL, &dev, &error_fatal);
2106     visit_free(v);
2107 
2108     audio_define(dev);
2109 }
2110 
2111 void audio_define(Audiodev *dev)
2112 {
2113     AudiodevListEntry *e;
2114 
2115     audio_validate_opts(dev, &error_fatal);
2116 
2117     e = g_new0(AudiodevListEntry, 1);
2118     e->dev = dev;
2119     QSIMPLEQ_INSERT_TAIL(&audiodevs, e, next);
2120 }
2121 
2122 void audio_init_audiodevs(void)
2123 {
2124     AudiodevListEntry *e;
2125 
2126     QSIMPLEQ_FOREACH(e, &audiodevs, next) {
2127         audio_init(e->dev, NULL);
2128     }
2129 }
2130 
2131 audsettings audiodev_to_audsettings(AudiodevPerDirectionOptions *pdo)
2132 {
2133     return (audsettings) {
2134         .freq = pdo->frequency,
2135         .nchannels = pdo->channels,
2136         .fmt = pdo->format,
2137         .endianness = AUDIO_HOST_ENDIANNESS,
2138     };
2139 }
2140 
2141 int audioformat_bytes_per_sample(AudioFormat fmt)
2142 {
2143     switch (fmt) {
2144     case AUDIO_FORMAT_U8:
2145     case AUDIO_FORMAT_S8:
2146         return 1;
2147 
2148     case AUDIO_FORMAT_U16:
2149     case AUDIO_FORMAT_S16:
2150         return 2;
2151 
2152     case AUDIO_FORMAT_U32:
2153     case AUDIO_FORMAT_S32:
2154     case AUDIO_FORMAT_F32:
2155         return 4;
2156 
2157     case AUDIO_FORMAT__MAX:
2158         ;
2159     }
2160     abort();
2161 }
2162 
2163 
2164 /* frames = freq * usec / 1e6 */
2165 int audio_buffer_frames(AudiodevPerDirectionOptions *pdo,
2166                         audsettings *as, int def_usecs)
2167 {
2168     uint64_t usecs = pdo->has_buffer_length ? pdo->buffer_length : def_usecs;
2169     return (as->freq * usecs + 500000) / 1000000;
2170 }
2171 
2172 /* samples = channels * frames = channels * freq * usec / 1e6 */
2173 int audio_buffer_samples(AudiodevPerDirectionOptions *pdo,
2174                          audsettings *as, int def_usecs)
2175 {
2176     return as->nchannels * audio_buffer_frames(pdo, as, def_usecs);
2177 }
2178 
2179 /*
2180  * bytes = bytes_per_sample * samples =
2181  *     bytes_per_sample * channels * freq * usec / 1e6
2182  */
2183 int audio_buffer_bytes(AudiodevPerDirectionOptions *pdo,
2184                        audsettings *as, int def_usecs)
2185 {
2186     return audio_buffer_samples(pdo, as, def_usecs) *
2187         audioformat_bytes_per_sample(as->fmt);
2188 }
2189 
2190 AudioState *audio_state_by_name(const char *name)
2191 {
2192     AudioState *s;
2193     QTAILQ_FOREACH(s, &audio_states, list) {
2194         assert(s->dev);
2195         if (strcmp(name, s->dev->id) == 0) {
2196             return s;
2197         }
2198     }
2199     return NULL;
2200 }
2201 
2202 const char *audio_get_id(QEMUSoundCard *card)
2203 {
2204     if (card->state) {
2205         assert(card->state->dev);
2206         return card->state->dev->id;
2207     } else {
2208         return "";
2209     }
2210 }
2211 
2212 const char *audio_application_name(void)
2213 {
2214     const char *vm_name;
2215 
2216     vm_name = qemu_get_vm_name();
2217     return vm_name ? vm_name : "qemu";
2218 }
2219 
2220 void audio_rate_start(RateCtl *rate)
2221 {
2222     memset(rate, 0, sizeof(RateCtl));
2223     rate->start_ticks = qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL);
2224 }
2225 
2226 size_t audio_rate_get_bytes(struct audio_pcm_info *info, RateCtl *rate,
2227                             size_t bytes_avail)
2228 {
2229     int64_t now;
2230     int64_t ticks;
2231     int64_t bytes;
2232     int64_t samples;
2233     size_t ret;
2234 
2235     now = qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL);
2236     ticks = now - rate->start_ticks;
2237     bytes = muldiv64(ticks, info->bytes_per_second, NANOSECONDS_PER_SECOND);
2238     samples = (bytes - rate->bytes_sent) / info->bytes_per_frame;
2239     if (samples < 0 || samples > 65536) {
2240         AUD_log(NULL, "Resetting rate control (%" PRId64 " samples)\n", samples);
2241         audio_rate_start(rate);
2242         samples = 0;
2243     }
2244 
2245     ret = MIN(samples * info->bytes_per_frame, bytes_avail);
2246     rate->bytes_sent += ret;
2247     return ret;
2248 }
2249