2 * QEMU OSS audio driver
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
26 #include <sys/types.h>
27 #include <sys/ioctl.h>
29 #include <soundcard.h>
31 #include <sys/soundcard.h>
33 #include "qemu-common.h"
34 #include "host-utils.h"
35 #include "qemu-char.h"
38 #define AUDIO_CAP "oss"
39 #include "audio_int.h"
41 typedef struct OSSVoiceOut {
52 typedef struct OSSVoiceIn {
64 const char *devpath_out;
65 const char *devpath_in;
73 .devpath_out = "/dev/dsp",
74 .devpath_in = "/dev/dsp",
88 static void GCC_FMT_ATTR (2, 3) oss_logerr (int err, const char *fmt, ...)
93 AUD_vlog (AUDIO_CAP, fmt, ap);
96 AUD_log (AUDIO_CAP, "Reason: %s\n", strerror (err));
99 static void GCC_FMT_ATTR (3, 4) oss_logerr2 (
108 AUD_log (AUDIO_CAP, "Could not initialize %s\n", typ);
111 AUD_vlog (AUDIO_CAP, fmt, ap);
114 AUD_log (AUDIO_CAP, "Reason: %s\n", strerror (err));
117 static void oss_anal_close (int *fdp)
121 qemu_set_fd_handler (*fdp, NULL, NULL, NULL);
124 oss_logerr (errno, "Failed to close file(fd=%d)\n", *fdp);
129 static void oss_helper_poll_out (void *opaque)
132 audio_run ("oss_poll_out");
135 static void oss_helper_poll_in (void *opaque)
138 audio_run ("oss_poll_in");
141 static int oss_poll_out (HWVoiceOut *hw)
143 OSSVoiceOut *oss = (OSSVoiceOut *) hw;
145 return qemu_set_fd_handler (oss->fd, NULL, oss_helper_poll_out, NULL);
148 static int oss_poll_in (HWVoiceIn *hw)
150 OSSVoiceIn *oss = (OSSVoiceIn *) hw;
152 return qemu_set_fd_handler (oss->fd, oss_helper_poll_in, NULL, NULL);
155 static int oss_write (SWVoiceOut *sw, void *buf, int len)
157 return audio_pcm_sw_write (sw, buf, len);
160 static int aud_to_ossfmt (audfmt_e fmt)
176 dolog ("Internal logic error: Bad audio format %d\n", fmt);
184 static int oss_to_audfmt (int ossfmt, audfmt_e *fmt, int *endianness)
218 dolog ("Unrecognized audio format %d\n", ossfmt);
225 #if defined DEBUG_MISMATCHES || defined DEBUG
226 static void oss_dump_info (struct oss_params *req, struct oss_params *obt)
228 dolog ("parameter | requested value | obtained value\n");
229 dolog ("format | %10d | %10d\n", req->fmt, obt->fmt);
230 dolog ("channels | %10d | %10d\n",
231 req->nchannels, obt->nchannels);
232 dolog ("frequency | %10d | %10d\n", req->freq, obt->freq);
233 dolog ("nfrags | %10d | %10d\n", req->nfrags, obt->nfrags);
234 dolog ("fragsize | %10d | %10d\n",
235 req->fragsize, obt->fragsize);
239 static int oss_open (int in, struct oss_params *req,
240 struct oss_params *obt, int *pfd)
244 int oflags = conf.exclusive ? O_EXCL : 0;
245 audio_buf_info abinfo;
246 int fmt, freq, nchannels;
247 const char *dspname = in ? conf.devpath_in : conf.devpath_out;
248 const char *typ = in ? "ADC" : "DAC";
250 /* Kludge needed to have working mmap on Linux */
251 oflags |= conf.try_mmap ? O_RDWR : (in ? O_RDONLY : O_WRONLY);
253 fd = open (dspname, oflags | O_NONBLOCK);
255 oss_logerr2 (errno, typ, "Failed to open `%s'\n", dspname);
260 nchannels = req->nchannels;
263 if (ioctl (fd, SNDCTL_DSP_SAMPLESIZE, &fmt)) {
264 oss_logerr2 (errno, typ, "Failed to set sample size %d\n", req->fmt);
268 if (ioctl (fd, SNDCTL_DSP_CHANNELS, &nchannels)) {
269 oss_logerr2 (errno, typ, "Failed to set number of channels %d\n",
274 if (ioctl (fd, SNDCTL_DSP_SPEED, &freq)) {
275 oss_logerr2 (errno, typ, "Failed to set frequency %d\n", req->freq);
279 if (ioctl (fd, SNDCTL_DSP_NONBLOCK, NULL)) {
280 oss_logerr2 (errno, typ, "Failed to set non-blocking mode\n");
284 if (ioctl (fd, OSS_GETVERSION, &version)) {
285 oss_logerr2 (errno, typ, "Failed to get OSS version\n");
290 dolog ("OSS version = %#x\n", version);
293 #ifdef SNDCTL_DSP_POLICY
294 if (conf.policy >= 0 && version >= 0x040000) {
295 int policy = conf.policy;
296 if (ioctl (fd, SNDCTL_DSP_POLICY, &policy)) {
297 oss_logerr2 (errno, typ, "Failed to set timing policy to %d\n",
305 int mmmmssss = (req->nfrags << 16) | ctz32 (req->fragsize);
306 if (ioctl (fd, SNDCTL_DSP_SETFRAGMENT, &mmmmssss)) {
307 oss_logerr2 (errno, typ, "Failed to set buffer length (%d, %d)\n",
308 req->nfrags, req->fragsize);
313 if (ioctl (fd, in ? SNDCTL_DSP_GETISPACE : SNDCTL_DSP_GETOSPACE, &abinfo)) {
314 oss_logerr2 (errno, typ, "Failed to get buffer length\n");
318 if (!abinfo.fragstotal || !abinfo.fragsize) {
319 AUD_log (AUDIO_CAP, "Returned bogus buffer information(%d, %d) for %s\n",
320 abinfo.fragstotal, abinfo.fragsize, typ);
325 obt->nchannels = nchannels;
327 obt->nfrags = abinfo.fragstotal;
328 obt->fragsize = abinfo.fragsize;
331 #ifdef DEBUG_MISMATCHES
332 if ((req->fmt != obt->fmt) ||
333 (req->nchannels != obt->nchannels) ||
334 (req->freq != obt->freq) ||
335 (req->fragsize != obt->fragsize) ||
336 (req->nfrags != obt->nfrags)) {
337 dolog ("Audio parameters mismatch\n");
338 oss_dump_info (req, obt);
343 oss_dump_info (req, obt);
348 oss_anal_close (&fd);
352 static void oss_write_pending (OSSVoiceOut *oss)
354 HWVoiceOut *hw = &oss->hw;
360 while (oss->pending) {
362 ssize_t bytes_written;
363 int samples_till_end = hw->samples - oss->wpos;
364 int samples_to_write = audio_MIN (oss->pending, samples_till_end);
365 int bytes_to_write = samples_to_write << hw->info.shift;
366 void *pcm = advance (oss->pcm_buf, oss->wpos << hw->info.shift);
368 bytes_written = write (oss->fd, pcm, bytes_to_write);
369 if (bytes_written < 0) {
370 if (errno != EAGAIN) {
371 oss_logerr (errno, "failed to write %d bytes\n",
377 if (bytes_written & hw->info.align) {
378 dolog ("misaligned write asked for %d, but got %zd\n",
379 bytes_to_write, bytes_written);
383 samples_written = bytes_written >> hw->info.shift;
384 oss->pending -= samples_written;
385 oss->wpos = (oss->wpos + samples_written) % hw->samples;
386 if (bytes_written - bytes_to_write) {
392 static int oss_run_out (HWVoiceOut *hw)
394 OSSVoiceOut *oss = (OSSVoiceOut *) hw;
396 struct audio_buf_info abinfo;
397 struct count_info cntinfo;
400 live = audio_pcm_hw_get_live_out (hw);
405 bufsize = hw->samples << hw->info.shift;
410 err = ioctl (oss->fd, SNDCTL_DSP_GETOPTR, &cntinfo);
412 oss_logerr (errno, "SNDCTL_DSP_GETOPTR failed\n");
416 pos = hw->rpos << hw->info.shift;
417 bytes = audio_ring_dist (cntinfo.ptr, pos, bufsize);
418 decr = audio_MIN (bytes >> hw->info.shift, live);
421 err = ioctl (oss->fd, SNDCTL_DSP_GETOSPACE, &abinfo);
423 oss_logerr (errno, "SNDCTL_DSP_GETOPTR failed\n");
427 if (abinfo.bytes > bufsize) {
429 dolog ("warning: Invalid available size, size=%d bufsize=%d\n"
430 "please report your OS/audio hw to malc@pulsesoft.com\n",
431 abinfo.bytes, bufsize);
433 abinfo.bytes = bufsize;
436 if (abinfo.bytes < 0) {
438 dolog ("warning: Invalid available size, size=%d bufsize=%d\n",
439 abinfo.bytes, bufsize);
444 decr = audio_MIN (abinfo.bytes >> hw->info.shift, live);
450 decr = audio_pcm_hw_clip_out (hw, oss->pcm_buf, decr, oss->pending);
451 oss->pending += decr;
452 oss_write_pending (oss);
457 static void oss_fini_out (HWVoiceOut *hw)
460 OSSVoiceOut *oss = (OSSVoiceOut *) hw;
462 ldebug ("oss_fini\n");
463 oss_anal_close (&oss->fd);
467 err = munmap (oss->pcm_buf, hw->samples << hw->info.shift);
469 oss_logerr (errno, "Failed to unmap buffer %p, size %d\n",
470 oss->pcm_buf, hw->samples << hw->info.shift);
474 qemu_free (oss->pcm_buf);
480 static int oss_init_out (HWVoiceOut *hw, struct audsettings *as)
482 OSSVoiceOut *oss = (OSSVoiceOut *) hw;
483 struct oss_params req, obt;
487 audfmt_e effective_fmt;
488 struct audsettings obt_as;
492 req.fmt = aud_to_ossfmt (as->fmt);
494 req.nchannels = as->nchannels;
495 req.fragsize = conf.fragsize;
496 req.nfrags = conf.nfrags;
498 if (oss_open (0, &req, &obt, &fd)) {
502 err = oss_to_audfmt (obt.fmt, &effective_fmt, &endianness);
504 oss_anal_close (&fd);
508 obt_as.freq = obt.freq;
509 obt_as.nchannels = obt.nchannels;
510 obt_as.fmt = effective_fmt;
511 obt_as.endianness = endianness;
513 audio_pcm_init_info (&hw->info, &obt_as);
514 oss->nfrags = obt.nfrags;
515 oss->fragsize = obt.fragsize;
517 if (obt.nfrags * obt.fragsize & hw->info.align) {
518 dolog ("warning: Misaligned DAC buffer, size %d, alignment %d\n",
519 obt.nfrags * obt.fragsize, hw->info.align + 1);
522 hw->samples = (obt.nfrags * obt.fragsize) >> hw->info.shift;
526 oss->pcm_buf = mmap (
528 hw->samples << hw->info.shift,
529 PROT_READ | PROT_WRITE,
534 if (oss->pcm_buf == MAP_FAILED) {
535 oss_logerr (errno, "Failed to map %d bytes of DAC\n",
536 hw->samples << hw->info.shift);
541 if (ioctl (fd, SNDCTL_DSP_SETTRIGGER, &trig) < 0) {
542 oss_logerr (errno, "SNDCTL_DSP_SETTRIGGER 0 failed\n");
545 trig = PCM_ENABLE_OUTPUT;
546 if (ioctl (fd, SNDCTL_DSP_SETTRIGGER, &trig) < 0) {
549 "SNDCTL_DSP_SETTRIGGER PCM_ENABLE_OUTPUT failed\n"
558 err = munmap (oss->pcm_buf, hw->samples << hw->info.shift);
560 oss_logerr (errno, "Failed to unmap buffer %p size %d\n",
561 oss->pcm_buf, hw->samples << hw->info.shift);
568 oss->pcm_buf = audio_calloc (
575 "Could not allocate DAC buffer (%d samples, each %d bytes)\n",
579 oss_anal_close (&fd);
588 static int oss_ctl_out (HWVoiceOut *hw, int cmd, ...)
593 OSSVoiceOut *oss = (OSSVoiceOut *) hw;
596 poll_mode = va_arg (ap, int);
601 ldebug ("enabling voice\n");
602 if (poll_mode && oss_poll_out (hw)) {
605 hw->poll_mode = poll_mode;
611 audio_pcm_info_clear_buf (&hw->info, oss->pcm_buf, hw->samples);
612 trig = PCM_ENABLE_OUTPUT;
613 if (ioctl (oss->fd, SNDCTL_DSP_SETTRIGGER, &trig) < 0) {
616 "SNDCTL_DSP_SETTRIGGER PCM_ENABLE_OUTPUT failed\n"
624 qemu_set_fd_handler (oss->fd, NULL, NULL, NULL);
632 ldebug ("disabling voice\n");
634 if (ioctl (oss->fd, SNDCTL_DSP_SETTRIGGER, &trig) < 0) {
635 oss_logerr (errno, "SNDCTL_DSP_SETTRIGGER 0 failed\n");
643 static int oss_init_in (HWVoiceIn *hw, struct audsettings *as)
645 OSSVoiceIn *oss = (OSSVoiceIn *) hw;
646 struct oss_params req, obt;
650 audfmt_e effective_fmt;
651 struct audsettings obt_as;
655 req.fmt = aud_to_ossfmt (as->fmt);
657 req.nchannels = as->nchannels;
658 req.fragsize = conf.fragsize;
659 req.nfrags = conf.nfrags;
660 if (oss_open (1, &req, &obt, &fd)) {
664 err = oss_to_audfmt (obt.fmt, &effective_fmt, &endianness);
666 oss_anal_close (&fd);
670 obt_as.freq = obt.freq;
671 obt_as.nchannels = obt.nchannels;
672 obt_as.fmt = effective_fmt;
673 obt_as.endianness = endianness;
675 audio_pcm_init_info (&hw->info, &obt_as);
676 oss->nfrags = obt.nfrags;
677 oss->fragsize = obt.fragsize;
679 if (obt.nfrags * obt.fragsize & hw->info.align) {
680 dolog ("warning: Misaligned ADC buffer, size %d, alignment %d\n",
681 obt.nfrags * obt.fragsize, hw->info.align + 1);
684 hw->samples = (obt.nfrags * obt.fragsize) >> hw->info.shift;
685 oss->pcm_buf = audio_calloc (AUDIO_FUNC, hw->samples, 1 << hw->info.shift);
687 dolog ("Could not allocate ADC buffer (%d samples, each %d bytes)\n",
688 hw->samples, 1 << hw->info.shift);
689 oss_anal_close (&fd);
697 static void oss_fini_in (HWVoiceIn *hw)
699 OSSVoiceIn *oss = (OSSVoiceIn *) hw;
701 oss_anal_close (&oss->fd);
704 qemu_free (oss->pcm_buf);
709 static int oss_run_in (HWVoiceIn *hw)
711 OSSVoiceIn *oss = (OSSVoiceIn *) hw;
712 int hwshift = hw->info.shift;
714 int live = audio_pcm_hw_get_live_in (hw);
715 int dead = hw->samples - live;
716 size_t read_samples = 0;
721 { .add = hw->wpos, .len = 0 },
722 { .add = 0, .len = 0 }
729 if (hw->wpos + dead > hw->samples) {
730 bufs[0].len = (hw->samples - hw->wpos) << hwshift;
731 bufs[1].len = (dead - (hw->samples - hw->wpos)) << hwshift;
734 bufs[0].len = dead << hwshift;
737 for (i = 0; i < 2; ++i) {
741 void *p = advance (oss->pcm_buf, bufs[i].add << hwshift);
742 nread = read (oss->fd, p, bufs[i].len);
745 if (nread & hw->info.align) {
746 dolog ("warning: Misaligned read %zd (requested %d), "
747 "alignment %d\n", nread, bufs[i].add << hwshift,
750 read_samples += nread >> hwshift;
751 hw->conv (hw->conv_buf + bufs[i].add, p, nread >> hwshift,
755 if (bufs[i].len - nread) {
764 "Failed to read %d bytes of audio (to %p)\n",
775 hw->wpos = (hw->wpos + read_samples) % hw->samples;
779 static int oss_read (SWVoiceIn *sw, void *buf, int size)
781 return audio_pcm_sw_read (sw, buf, size);
784 static int oss_ctl_in (HWVoiceIn *hw, int cmd, ...)
788 OSSVoiceIn *oss = (OSSVoiceIn *) hw;
791 poll_mode = va_arg (ap, int);
796 if (poll_mode && oss_poll_in (hw)) {
799 hw->poll_mode = poll_mode;
805 qemu_set_fd_handler (oss->fd, NULL, NULL, NULL);
812 static void *oss_audio_init (void)
817 static void oss_audio_fini (void *opaque)
822 static struct audio_option oss_options[] = {
826 .valp = &conf.fragsize,
827 .descr = "Fragment size in bytes"
832 .valp = &conf.nfrags,
833 .descr = "Number of fragments"
838 .valp = &conf.try_mmap,
839 .descr = "Try using memory mapped access"
844 .valp = &conf.devpath_out,
845 .descr = "Path to DAC device"
850 .valp = &conf.devpath_in,
851 .descr = "Path to ADC device"
856 .valp = &conf.exclusive,
857 .descr = "Open device in exclusive mode (vmix wont work)"
859 #ifdef SNDCTL_DSP_POLICY
863 .valp = &conf.policy,
864 .descr = "Set the timing policy of the device, -1 to use fragment mode",
871 .descr = "Turn on some debugging messages"
873 { /* End of list */ }
876 static struct audio_pcm_ops oss_pcm_ops = {
877 .init_out = oss_init_out,
878 .fini_out = oss_fini_out,
879 .run_out = oss_run_out,
881 .ctl_out = oss_ctl_out,
883 .init_in = oss_init_in,
884 .fini_in = oss_fini_in,
885 .run_in = oss_run_in,
890 struct audio_driver oss_audio_driver = {
892 .descr = "OSS http://www.opensound.com",
893 .options = oss_options,
894 .init = oss_audio_init,
895 .fini = oss_audio_fini,
896 .pcm_ops = &oss_pcm_ops,
898 .max_voices_out = INT_MAX,
899 .max_voices_in = INT_MAX,
900 .voice_size_out = sizeof (OSSVoiceOut),
901 .voice_size_in = sizeof (OSSVoiceIn)