Modules/linuxaudiodev.c

   1 /* Hey Emacs, this is -*-C-*-
   2  ******************************************************************************
   3  * linuxaudiodev.c -- Linux audio device for python.
   4  *
   5  * Author          : Peter Bosch
   6  * Created On      : Thu Mar  2 21:10:33 2000
   7  * Status          : Unknown, Use with caution!
   8  *
   9  * Unless other notices are present in any part of this file
  10  * explicitly claiming copyrights for other people and/or
  11  * organizations, the contents of this file is fully copyright
  12  * (C) 2000 Peter Bosch, all rights reserved.
  13  ******************************************************************************
  14  */
  15
  16 #include "Python.h"
  17 #include "structmember.h"
  18
  19 #ifdef HAVE_FCNTL_H
  20 #include <fcntl.h>
  21 #else
  22 #define O_RDONLY 00
  23 #define O_WRONLY 01
  24 #endif
  25
  26
  27 #include <sys/ioctl.h>
  28 #if defined(linux)
  29 #include <linux/soundcard.h>
  30
  31 typedef unsigned long uint32_t;
  32
  33 #elif defined(__FreeBSD__)
  34 #include <machine/soundcard.h>
  35
  36 #ifndef SNDCTL_DSP_CHANNELS
  37 #define SNDCTL_DSP_CHANNELS SOUND_PCM_WRITE_CHANNELS
  38 #endif
  39
  40 #endif
  41
  42 typedef struct {
  43     PyObject_HEAD
  44     int         x_fd;           /* The open file */
  45     int         x_mode;           /* file mode */
  46     int         x_icount;       /* Input count */
  47     int         x_ocount;       /* Output count */
  48     uint32_t    x_afmts;        /* Audio formats supported by hardware*/
  49 } lad_t;
  50
  51 /* XXX several format defined in soundcard.h are not supported,
  52    including _NE (native endian) options and S32 options
  53 */
  54
  55 static struct {
  56     int         a_bps;
  57     uint32_t    a_fmt;
  58     char       *a_name;
  59 } audio_types[] = {
  60     {  8,       AFMT_MU_LAW, "logarithmic mu-law 8-bit audio" },
  61     {  8,       AFMT_A_LAW,  "logarithmic A-law 8-bit audio" },
  62     {  8,       AFMT_U8,     "linear unsigned 8-bit audio" },
  63     {  8,       AFMT_S8,     "linear signed 8-bit audio" },
  64     { 16,       AFMT_U16_BE, "linear unsigned 16-bit big-endian audio" },
  65     { 16,       AFMT_U16_LE, "linear unsigned 16-bit little-endian audio" },
  66     { 16,       AFMT_S16_BE, "linear signed 16-bit big-endian audio" },
  67     { 16,       AFMT_S16_LE, "linear signed 16-bit little-endian audio" },
  68     { 16,       AFMT_S16_NE, "linear signed 16-bit native-endian audio" },
  69 };
  70
  71 static int n_audio_types = sizeof(audio_types) / sizeof(audio_types[0]);
  72
  73 static PyTypeObject Ladtype;
  74
  75 static PyObject *LinuxAudioError;
  76
  77 static lad_t *
  78 newladobject(PyObject *arg)
  79 {
  80     lad_t *xp;
  81     int fd, afmts, imode;
  82     char *basedev = NULL;
  83     char *mode = NULL;
  84
  85     /* Two ways to call linuxaudiodev.open():
  86          open(device, mode) (for consistency with builtin open())
  87          open(mode)         (for backwards compatibility)
  88        because the *first* argument is optional, parsing args is
  89        a wee bit tricky. */
  90     if (!PyArg_ParseTuple(arg, "s|s:open", &basedev, &mode))
  91        return NULL;
  92     if (mode == NULL) {                 /* only one arg supplied */
  93        mode = basedev;
  94        basedev = NULL;
  95     }
  96
  97     if (strcmp(mode, "r") == 0)
  98         imode = O_RDONLY;
  99     else if (strcmp(mode, "w") == 0)
 100         imode = O_WRONLY;
 101     else {
 102         PyErr_SetString(LinuxAudioError, "mode should be 'r' or 'w'");
 103         return NULL;
 104     }
 105
 106     /* Open the correct device.  The base device name comes from the
 107      * AUDIODEV environment variable first, then /dev/dsp.  The
 108      * control device tacks "ctl" onto the base device name.
 109      *
 110      * Note that the only difference between /dev/audio and /dev/dsp
 111      * is that the former uses logarithmic mu-law encoding and the
 112      * latter uses 8-bit unsigned encoding.
 113      */
 114
 115     if (basedev == NULL) {              /* called with one arg */
 116        basedev = getenv("AUDIODEV");
 117        if (basedev == NULL)             /* $AUDIODEV not set */
 118           basedev = "/dev/dsp";
 119     }
 120
 121     if ((fd = open(basedev, imode)) == -1) {
 122         PyErr_SetFromErrnoWithFilename(LinuxAudioError, basedev);
 123         return NULL;
 124     }
 125     if (imode == O_WRONLY && ioctl(fd, SNDCTL_DSP_NONBLOCK, NULL) == -1) {
 126         PyErr_SetFromErrnoWithFilename(LinuxAudioError, basedev);
 127         return NULL;
 128     }
 129     if (ioctl(fd, SNDCTL_DSP_GETFMTS, &afmts) == -1) {
 130         PyErr_SetFromErrnoWithFilename(LinuxAudioError, basedev);
 131         return NULL;
 132     }
 133     /* Create and initialize the object */
 134     if ((xp = PyObject_New(lad_t, &Ladtype)) == NULL) {
 135         close(fd);
 136         return NULL;
 137     }
 138     xp->x_fd = fd;
 139     xp->x_mode = imode;
 140     xp->x_icount = xp->x_ocount = 0;
 141     xp->x_afmts  = afmts;
 142     return xp;
 143 }
 144
 145 static void
 146 lad_dealloc(lad_t *xp)
 147 {
 148     /* if already closed, don't reclose it */
 149     if (xp->x_fd != -1)
 150         close(xp->x_fd);
 151     PyObject_Del(xp);
 152 }
 153
 154 static PyObject *
 155 lad_read(lad_t *self, PyObject *args)
 156 {
 157     int size, count;
 158     char *cp;
 159     PyObject *rv;
 160
 161     if (!PyArg_ParseTuple(args, "i:read", &size))
 162         return NULL;
 163     rv = PyString_FromStringAndSize(NULL, size);
 164     if (rv == NULL)
 165         return NULL;
 166     cp = PyString_AS_STRING(rv);
 167     if ((count = read(self->x_fd, cp, size)) < 0) {
 168         PyErr_SetFromErrno(LinuxAudioError);
 169         Py_DECREF(rv);
 170         return NULL;
 171     }
 172     self->x_icount += count;
 173     _PyString_Resize(&rv, count);
 174     return rv;
 175 }
 176
 177 static PyObject *
 178 lad_write(lad_t *self, PyObject *args)
 179 {
 180     char *cp;
 181     int rv, size;
 182     fd_set write_set_fds;
 183     struct timeval tv;
 184     int select_retval;
 185
 186     if (!PyArg_ParseTuple(args, "s#:write", &cp, &size))
 187         return NULL;
 188
 189     /* use select to wait for audio device to be available */
 190     FD_ZERO(&write_set_fds);
 191     FD_SET(self->x_fd, &write_set_fds);
 192     tv.tv_sec = 4; /* timeout values */
 193     tv.tv_usec = 0;
 194
 195     while (size > 0) {
 196       select_retval = select(self->x_fd+1, NULL, &write_set_fds, NULL, &tv);
 197       tv.tv_sec = 1; tv.tv_usec = 0; /* willing to wait this long next time*/
 198       if (select_retval) {
 199         if ((rv = write(self->x_fd, cp, size)) == -1) {
 200           if (errno != EAGAIN) {
 201             PyErr_SetFromErrno(LinuxAudioError);
 202             return NULL;
 203           } else {
 204             errno = 0; /* EAGAIN: buffer is full, try again */
 205           }
 206         } else {
 207           self->x_ocount += rv;
 208           size -= rv;
 209           cp += rv;
 210         }
 211       } else {
 212         /* printf("Not able to write to linux audio device within %ld seconds\n", tv.tv_sec); */
 213         PyErr_SetFromErrno(LinuxAudioError);
 214         return NULL;
 215       }
 216     }
 217     Py_INCREF(Py_None);
 218     return Py_None;
 219 }
 220
 221 static PyObject *
 222 lad_close(lad_t *self, PyObject *args)
 223 {
 224     if (!PyArg_ParseTuple(args, ":close"))
 225         return NULL;
 226
 227     if (self->x_fd >= 0) {
 228         close(self->x_fd);
 229         self->x_fd = -1;
 230     }
 231     Py_INCREF(Py_None);
 232     return Py_None;
 233 }
 234
 235 static PyObject *
 236 lad_fileno(lad_t *self, PyObject *args)
 237 {
 238     if (!PyArg_ParseTuple(args, ":fileno"))
 239         return NULL;
 240     return PyInt_FromLong(self->x_fd);
 241 }
 242
 243 static PyObject *
 244 lad_setparameters(lad_t *self, PyObject *args)
 245 {
 246     int rate, ssize, nchannels, n, fmt, emulate=0;
 247
 248     if (!PyArg_ParseTuple(args, "iiii|i:setparameters",
 249                           &rate, &ssize, &nchannels, &fmt, &emulate))
 250         return NULL;
 251
 252     if (rate < 0) {
 253         PyErr_Format(PyExc_ValueError, "expected rate >= 0, not %d",
 254                      rate);
 255         return NULL;
 256     }
 257     if (ssize < 0) {
 258         PyErr_Format(PyExc_ValueError, "expected sample size >= 0, not %d",
 259                      ssize);
 260         return NULL;
 261     }
 262     if (nchannels != 1 && nchannels != 2) {
 263         PyErr_Format(PyExc_ValueError, "nchannels must be 1 or 2, not %d",
 264                      nchannels);
 265         return NULL;
 266     }
 267
 268     for (n = 0; n < n_audio_types; n++)
 269         if (fmt == audio_types[n].a_fmt)
 270             break;
 271     if (n == n_audio_types) {
 272         PyErr_Format(PyExc_ValueError, "unknown audio encoding: %d", fmt);
 273         return NULL;
 274     }
 275     if (audio_types[n].a_bps != ssize) {
 276         PyErr_Format(PyExc_ValueError,
 277                      "for %s, expected sample size %d, not %d",
 278                      audio_types[n].a_name, audio_types[n].a_bps, ssize);
 279         return NULL;
 280     }
 281
 282     if (emulate == 0) {
 283         if ((self->x_afmts & audio_types[n].a_fmt) == 0) {
 284             PyErr_Format(PyExc_ValueError,
 285                          "%s format not supported by device",
 286                          audio_types[n].a_name);
 287             return NULL;
 288         }
 289     }
 290     if (ioctl(self->x_fd, SNDCTL_DSP_SETFMT,
 291               &audio_types[n].a_fmt) == -1) {
 292         PyErr_SetFromErrno(LinuxAudioError);
 293         return NULL;
 294     }
 295     if (ioctl(self->x_fd, SNDCTL_DSP_CHANNELS, &nchannels) == -1) {
 296         PyErr_SetFromErrno(LinuxAudioError);
 297         return NULL;
 298     }
 299     if (ioctl(self->x_fd, SNDCTL_DSP_SPEED, &rate) == -1) {
 300         PyErr_SetFromErrno(LinuxAudioError);
 301         return NULL;
 302     }
 303
 304     Py_INCREF(Py_None);
 305     return Py_None;
 306 }
 307
 308 static int
 309 _ssize(lad_t *self, int *nchannels, int *ssize)
 310 {
 311     int fmt;
 312
 313     fmt = 0;
 314     if (ioctl(self->x_fd, SNDCTL_DSP_SETFMT, &fmt) < 0)
 315         return -errno;
 316
 317     switch (fmt) {
 318     case AFMT_MU_LAW:
 319     case AFMT_A_LAW:
 320     case AFMT_U8:
 321     case AFMT_S8:
 322         *ssize = sizeof(char);
 323         break;
 324     case AFMT_S16_LE:
 325     case AFMT_S16_BE:
 326     case AFMT_U16_LE:
 327     case AFMT_U16_BE:
 328         *ssize = sizeof(short);
 329         break;
 330     case AFMT_MPEG:
 331     case AFMT_IMA_ADPCM:
 332     default:
 333         return -EOPNOTSUPP;
 334     }
 335     *nchannels = 0;
 336     if (ioctl(self->x_fd, SNDCTL_DSP_CHANNELS, nchannels) < 0)
 337         return -errno;
 338     return 0;
 339 }
 340
 341
 342 /* bufsize returns the size of the hardware audio buffer in number
 343    of samples */
 344 static PyObject *
 345 lad_bufsize(lad_t *self, PyObject *args)
 346 {
 347     audio_buf_info ai;
 348     int nchannels, ssize;
 349
 350     if (!PyArg_ParseTuple(args, ":bufsize")) return NULL;
 351
 352     if (_ssize(self, &nchannels, &ssize) < 0) {
 353         PyErr_SetFromErrno(LinuxAudioError);
 354         return NULL;
 355     }
 356     if (ioctl(self->x_fd, SNDCTL_DSP_GETOSPACE, &ai) < 0) {
 357         PyErr_SetFromErrno(LinuxAudioError);
 358         return NULL;
 359     }
 360     return PyInt_FromLong((ai.fragstotal * ai.fragsize) / (nchannels * ssize));
 361 }
 362
 363 /* obufcount returns the number of samples that are available in the
 364    hardware for playing */
 365 static PyObject *
 366 lad_obufcount(lad_t *self, PyObject *args)
 367 {
 368     audio_buf_info ai;
 369     int nchannels, ssize;
 370
 371     if (!PyArg_ParseTuple(args, ":obufcount"))
 372         return NULL;
 373
 374     if (_ssize(self, &nchannels, &ssize) < 0) {
 375         PyErr_SetFromErrno(LinuxAudioError);
 376         return NULL;
 377     }
 378     if (ioctl(self->x_fd, SNDCTL_DSP_GETOSPACE, &ai) < 0) {
 379         PyErr_SetFromErrno(LinuxAudioError);
 380         return NULL;
 381     }
 382     return PyInt_FromLong((ai.fragstotal * ai.fragsize - ai.bytes) /
 383                           (ssize * nchannels));
 384 }
 385
 386 /* obufcount returns the number of samples that can be played without
 387    blocking */
 388 static PyObject *
 389 lad_obuffree(lad_t *self, PyObject *args)
 390 {
 391     audio_buf_info ai;
 392     int nchannels, ssize;
 393
 394     if (!PyArg_ParseTuple(args, ":obuffree"))
 395         return NULL;
 396
 397     if (_ssize(self, &nchannels, &ssize) < 0) {
 398         PyErr_SetFromErrno(LinuxAudioError);
 399         return NULL;
 400     }
 401     if (ioctl(self->x_fd, SNDCTL_DSP_GETOSPACE, &ai) < 0) {
 402         PyErr_SetFromErrno(LinuxAudioError);
 403         return NULL;
 404     }
 405     return PyInt_FromLong(ai.bytes / (ssize * nchannels));
 406 }
 407
 408 /* Flush the device */
 409 static PyObject *
 410 lad_flush(lad_t *self, PyObject *args)
 411 {
 412     if (!PyArg_ParseTuple(args, ":flush")) return NULL;
 413
 414     if (ioctl(self->x_fd, SNDCTL_DSP_SYNC, NULL) == -1) {
 415         PyErr_SetFromErrno(LinuxAudioError);
 416         return NULL;
 417     }
 418     Py_INCREF(Py_None);
 419     return Py_None;
 420 }
 421
 422 static PyObject *
 423 lad_getptr(lad_t *self, PyObject *args)
 424 {
 425     count_info info;
 426     int req;
 427
 428     if (!PyArg_ParseTuple(args, ":getptr"))
 429         return NULL;
 430
 431     if (self->x_mode == O_RDONLY)
 432         req = SNDCTL_DSP_GETIPTR;
 433     else
 434         req = SNDCTL_DSP_GETOPTR;
 435     if (ioctl(self->x_fd, req, &info) == -1) {
 436         PyErr_SetFromErrno(LinuxAudioError);
 437         return NULL;
 438     }
 439     return Py_BuildValue("iii", info.bytes, info.blocks, info.ptr);
 440 }
 441
 442 static PyMethodDef lad_methods[] = {
 443     { "read",           (PyCFunction)lad_read, METH_VARARGS },
 444     { "write",          (PyCFunction)lad_write, METH_VARARGS },
 445     { "setparameters",  (PyCFunction)lad_setparameters, METH_VARARGS },
 446     { "bufsize",        (PyCFunction)lad_bufsize, METH_VARARGS },
 447     { "obufcount",      (PyCFunction)lad_obufcount, METH_VARARGS },
 448     { "obuffree",       (PyCFunction)lad_obuffree, METH_VARARGS },
 449     { "flush",          (PyCFunction)lad_flush, METH_VARARGS },
 450     { "close",          (PyCFunction)lad_close, METH_VARARGS },
 451     { "fileno",         (PyCFunction)lad_fileno, METH_VARARGS },
 452     { "getptr",         (PyCFunction)lad_getptr, METH_VARARGS },
 453     { NULL,             NULL}           /* sentinel */
 454 };
 455
 456 static PyObject *
 457 lad_getattr(lad_t *xp, char *name)
 458 {
 459     return Py_FindMethod(lad_methods, (PyObject *)xp, name);
 460 }
 461
 462 static PyTypeObject Ladtype = {
 463     PyObject_HEAD_INIT(&PyType_Type)
 464     0,                          /*ob_size*/
 465     "linuxaudiodev.linux_audio_device", /*tp_name*/
 466     sizeof(lad_t),              /*tp_size*/
 467     0,                          /*tp_itemsize*/
 468     /* methods */
 469     (destructor)lad_dealloc,    /*tp_dealloc*/
 470     0,                          /*tp_print*/
 471     (getattrfunc)lad_getattr,   /*tp_getattr*/
 472     0,                          /*tp_setattr*/
 473     0,                          /*tp_compare*/
 474     0,                          /*tp_repr*/
 475 };
 476
 477 static PyObject *
 478 ladopen(PyObject *self, PyObject *args)
 479 {
 480     return (PyObject *)newladobject(args);
 481 }
 482
 483 static PyMethodDef linuxaudiodev_methods[] = {
 484     { "open", ladopen, METH_VARARGS },
 485     { 0, 0 },
 486 };
 487
 488 void
 489 initlinuxaudiodev(void)
 490 {
 491     PyObject *m;
 492
 493     m = Py_InitModule("linuxaudiodev", linuxaudiodev_methods);
 494
 495     LinuxAudioError = PyErr_NewException("linuxaudiodev.error", NULL, NULL);
 496     if (LinuxAudioError)
 497         PyModule_AddObject(m, "error", LinuxAudioError);
 498
 499     if (PyModule_AddIntConstant(m, "AFMT_MU_LAW", (long)AFMT_MU_LAW) == -1)
 500         return;
 501     if (PyModule_AddIntConstant(m, "AFMT_A_LAW", (long)AFMT_A_LAW) == -1)
 502         return;
 503     if (PyModule_AddIntConstant(m, "AFMT_U8", (long)AFMT_U8) == -1)
 504         return;
 505     if (PyModule_AddIntConstant(m, "AFMT_S8", (long)AFMT_S8) == -1)
 506         return;
 507     if (PyModule_AddIntConstant(m, "AFMT_U16_BE", (long)AFMT_U16_BE) == -1)
 508         return;
 509     if (PyModule_AddIntConstant(m, "AFMT_U16_LE", (long)AFMT_U16_LE) == -1)
 510         return;
 511     if (PyModule_AddIntConstant(m, "AFMT_S16_BE", (long)AFMT_S16_BE) == -1)
 512         return;
 513     if (PyModule_AddIntConstant(m, "AFMT_S16_LE", (long)AFMT_S16_LE) == -1)
 514         return;
 515     if (PyModule_AddIntConstant(m, "AFMT_S16_NE", (long)AFMT_S16_NE) == -1)
 516         return;
 517
 518     return;
 519 }