source: vendor/python/2.5/Modules/ossaudiodev.c

Last change on this file was 3225, checked in by bird, 18 years ago

Python 2.5
File size: 32.0 KB
Line 
1/*
2 * ossaudiodev -- Python interface to the OSS (Open Sound System) API.
3 * This is the standard audio API for Linux and some
4 * flavours of BSD [XXX which ones?]; it is also available
5 * for a wide range of commercial Unices.
6 *
7 * Originally written by Peter Bosch, March 2000, as linuxaudiodev.
8 *
9 * Renamed to ossaudiodev and rearranged/revised/hacked up
10 * by Greg Ward <gward@python.net>, November 2002.
11 * Mixer interface by Nicholas FitzRoy-Dale <wzdd@lardcave.net>, Dec 2002.
12 *
13 * (c) 2000 Peter Bosch. All Rights Reserved.
14 * (c) 2002 Gregory P. Ward. All Rights Reserved.
15 * (c) 2002 Python Software Foundation. All Rights Reserved.
16 *
17 * XXX need a license statement
18 *
19 * $Id: ossaudiodev.c 46533 2006-05-29 21:04:52Z georg.brandl $
20 */
21
22#include "Python.h"
23#include "structmember.h"
24
25#ifdef HAVE_FCNTL_H
26#include <fcntl.h>
27#else
28#define O_RDONLY 00
29#define O_WRONLY 01
30#endif
31
32#include <sys/ioctl.h>
33#include <sys/soundcard.h>
34
35#if defined(linux)
36
37typedef unsigned long uint32_t;
38
39#elif defined(__FreeBSD__)
40
41# ifndef SNDCTL_DSP_CHANNELS
42# define SNDCTL_DSP_CHANNELS SOUND_PCM_WRITE_CHANNELS
43# endif
44
45#endif
46
47typedef struct {
48 PyObject_HEAD
49 char *devicename; /* name of the device file */
50 int fd; /* file descriptor */
51 int mode; /* file mode (O_RDONLY, etc.) */
52 int icount; /* input count */
53 int ocount; /* output count */
54 uint32_t afmts; /* audio formats supported by hardware */
55} oss_audio_t;
56
57typedef struct {
58 PyObject_HEAD
59 int fd; /* The open mixer device */
60} oss_mixer_t;
61
62
63static PyTypeObject OSSAudioType;
64static PyTypeObject OSSMixerType;
65
66static PyObject *OSSAudioError;
67
68
69/* ----------------------------------------------------------------------
70 * DSP object initialization/deallocation
71 */
72
73static oss_audio_t *
74newossobject(PyObject *arg)
75{
76 oss_audio_t *self;
77 int fd, afmts, imode;
78 char *devicename = NULL;
79 char *mode = NULL;
80
81 /* Two ways to call open():
82 open(device, mode) (for consistency with builtin open())
83 open(mode) (for backwards compatibility)
84 because the *first* argument is optional, parsing args is
85 a wee bit tricky. */
86 if (!PyArg_ParseTuple(arg, "s|s:open", &devicename, &mode))
87 return NULL;
88 if (mode == NULL) { /* only one arg supplied */
89 mode = devicename;
90 devicename = NULL;
91 }
92
93 if (strcmp(mode, "r") == 0)
94 imode = O_RDONLY;
95 else if (strcmp(mode, "w") == 0)
96 imode = O_WRONLY;
97 else if (strcmp(mode, "rw") == 0)
98 imode = O_RDWR;
99 else {
100 PyErr_SetString(OSSAudioError, "mode must be 'r', 'w', or 'rw'");
101 return NULL;
102 }
103
104 /* Open the correct device: either the 'device' argument,
105 or the AUDIODEV environment variable, or "/dev/dsp". */
106 if (devicename == NULL) { /* called with one arg */
107 devicename = getenv("AUDIODEV");
108 if (devicename == NULL) /* $AUDIODEV not set */
109 devicename = "/dev/dsp";
110 }
111
112 /* Open with O_NONBLOCK to avoid hanging on devices that only allow
113 one open at a time. This does *not* affect later I/O; OSS
114 provides a special ioctl() for non-blocking read/write, which is
115 exposed via oss_nonblock() below. */
116 if ((fd = open(devicename, imode|O_NONBLOCK)) == -1) {
117 PyErr_SetFromErrnoWithFilename(PyExc_IOError, devicename);
118 return NULL;
119 }
120
121 /* And (try to) put it back in blocking mode so we get the
122 expected write() semantics. */
123 if (fcntl(fd, F_SETFL, 0) == -1) {
124 close(fd);
125 PyErr_SetFromErrnoWithFilename(PyExc_IOError, devicename);
126 return NULL;
127 }
128
129 if (ioctl(fd, SNDCTL_DSP_GETFMTS, &afmts) == -1) {
130 PyErr_SetFromErrnoWithFilename(PyExc_IOError, devicename);
131 return NULL;
132 }
133 /* Create and initialize the object */
134 if ((self = PyObject_New(oss_audio_t, &OSSAudioType)) == NULL) {
135 close(fd);
136 return NULL;
137 }
138 self->devicename = devicename;
139 self->fd = fd;
140 self->mode = imode;
141 self->icount = self->ocount = 0;
142 self->afmts = afmts;
143 return self;
144}
145
146static void
147oss_dealloc(oss_audio_t *self)
148{
149 /* if already closed, don't reclose it */
150 if (self->fd != -1)
151 close(self->fd);
152 PyObject_Del(self);
153}
154
155
156/* ----------------------------------------------------------------------
157 * Mixer object initialization/deallocation
158 */
159
160static oss_mixer_t *
161newossmixerobject(PyObject *arg)
162{
163 char *devicename = NULL;
164 int fd;
165 oss_mixer_t *self;
166
167 if (!PyArg_ParseTuple(arg, "|s", &devicename)) {
168 return NULL;
169 }
170
171 if (devicename == NULL) {
172 devicename = getenv("MIXERDEV");
173 if (devicename == NULL) /* MIXERDEV not set */
174 devicename = "/dev/mixer";
175 }
176
177 if ((fd = open(devicename, O_RDWR)) == -1) {
178 PyErr_SetFromErrnoWithFilename(PyExc_IOError, devicename);
179 return NULL;
180 }
181
182 if ((self = PyObject_New(oss_mixer_t, &OSSMixerType)) == NULL) {
183 close(fd);
184 return NULL;
185 }
186
187 self->fd = fd;
188
189 return self;
190}
191
192static void
193oss_mixer_dealloc(oss_mixer_t *self)
194{
195 /* if already closed, don't reclose it */
196 if (self->fd != -1)
197 close(self->fd);
198 PyObject_Del(self);
199}
200
201
202/* Methods to wrap the OSS ioctls. The calling convention is pretty
203 simple:
204 nonblock() -> ioctl(fd, SNDCTL_DSP_NONBLOCK)
205 fmt = setfmt(fmt) -> ioctl(fd, SNDCTL_DSP_SETFMT, &fmt)
206 etc.
207*/
208
209
210/* ----------------------------------------------------------------------
211 * Helper functions
212 */
213
214/* _do_ioctl_1() is a private helper function used for the OSS ioctls --
215 SNDCTL_DSP_{SETFMT,CHANNELS,SPEED} -- that that are called from C
216 like this:
217 ioctl(fd, SNDCTL_DSP_cmd, &arg)
218
219 where arg is the value to set, and on return the driver sets arg to
220 the value that was actually set. Mapping this to Python is obvious:
221 arg = dsp.xxx(arg)
222*/
223static PyObject *
224_do_ioctl_1(int fd, PyObject *args, char *fname, int cmd)
225{
226 char argfmt[33] = "i:";
227 int arg;
228
229 assert(strlen(fname) <= 30);
230 strcat(argfmt, fname);
231 if (!PyArg_ParseTuple(args, argfmt, &arg))
232 return NULL;
233
234 if (ioctl(fd, cmd, &arg) == -1)
235 return PyErr_SetFromErrno(PyExc_IOError);
236 return PyInt_FromLong(arg);
237}
238
239
240/* _do_ioctl_1_internal() is a wrapper for ioctls that take no inputs
241 but return an output -- ie. we need to pass a pointer to a local C
242 variable so the driver can write its output there, but from Python
243 all we see is the return value. For example,
244 SOUND_MIXER_READ_DEVMASK returns a bitmask of available mixer
245 devices, but does not use the value of the parameter passed-in in any
246 way.
247*/
248static PyObject *
249_do_ioctl_1_internal(int fd, PyObject *args, char *fname, int cmd)
250{
251 char argfmt[32] = ":";
252 int arg = 0;
253
254 assert(strlen(fname) <= 30);
255 strcat(argfmt, fname);
256 if (!PyArg_ParseTuple(args, argfmt, &arg))
257 return NULL;
258
259 if (ioctl(fd, cmd, &arg) == -1)
260 return PyErr_SetFromErrno(PyExc_IOError);
261 return PyInt_FromLong(arg);
262}
263
264
265
266/* _do_ioctl_0() is a private helper for the no-argument ioctls:
267 SNDCTL_DSP_{SYNC,RESET,POST}. */
268static PyObject *
269_do_ioctl_0(int fd, PyObject *args, char *fname, int cmd)
270{
271 char argfmt[32] = ":";
272 int rv;
273
274 assert(strlen(fname) <= 30);
275 strcat(argfmt, fname);
276 if (!PyArg_ParseTuple(args, argfmt))
277 return NULL;
278
279 /* According to hannu@opensound.com, all three of the ioctls that
280 use this function can block, so release the GIL. This is
281 especially important for SYNC, which can block for several
282 seconds. */
283 Py_BEGIN_ALLOW_THREADS
284 rv = ioctl(fd, cmd, 0);
285 Py_END_ALLOW_THREADS
286
287 if (rv == -1)
288 return PyErr_SetFromErrno(PyExc_IOError);
289 Py_INCREF(Py_None);
290 return Py_None;
291}
292
293
294/* ----------------------------------------------------------------------
295 * Methods of DSP objects (OSSAudioType)
296 */
297
298static PyObject *
299oss_nonblock(oss_audio_t *self, PyObject *unused)
300{
301 /* Hmmm: it doesn't appear to be possible to return to blocking
302 mode once we're in non-blocking mode! */
303 if (ioctl(self->fd, SNDCTL_DSP_NONBLOCK, NULL) == -1)
304 return PyErr_SetFromErrno(PyExc_IOError);
305 Py_INCREF(Py_None);
306 return Py_None;
307}
308
309static PyObject *
310oss_setfmt(oss_audio_t *self, PyObject *args)
311{
312 return _do_ioctl_1(self->fd, args, "setfmt", SNDCTL_DSP_SETFMT);
313}
314
315static PyObject *
316oss_getfmts(oss_audio_t *self, PyObject *unused)
317{
318 int mask;
319 if (ioctl(self->fd, SNDCTL_DSP_GETFMTS, &mask) == -1)
320 return PyErr_SetFromErrno(PyExc_IOError);
321 return PyInt_FromLong(mask);
322}
323
324static PyObject *
325oss_channels(oss_audio_t *self, PyObject *args)
326{
327 return _do_ioctl_1(self->fd, args, "channels", SNDCTL_DSP_CHANNELS);
328}
329
330static PyObject *
331oss_speed(oss_audio_t *self, PyObject *args)
332{
333 return _do_ioctl_1(self->fd, args, "speed", SNDCTL_DSP_SPEED);
334}
335
336static PyObject *
337oss_sync(oss_audio_t *self, PyObject *args)
338{
339 return _do_ioctl_0(self->fd, args, "sync", SNDCTL_DSP_SYNC);
340}
341
342static PyObject *
343oss_reset(oss_audio_t *self, PyObject *args)
344{
345 return _do_ioctl_0(self->fd, args, "reset", SNDCTL_DSP_RESET);
346}
347
348static PyObject *
349oss_post(oss_audio_t *self, PyObject *args)
350{
351 return _do_ioctl_0(self->fd, args, "post", SNDCTL_DSP_POST);
352}
353
354
355/* Regular file methods: read(), write(), close(), etc. as well
356 as one convenience method, writeall(). */
357
358static PyObject *
359oss_read(oss_audio_t *self, PyObject *args)
360{
361 int size, count;
362 char *cp;
363 PyObject *rv;
364
365 if (!PyArg_ParseTuple(args, "i:read", &size))
366 return NULL;
367 rv = PyString_FromStringAndSize(NULL, size);
368 if (rv == NULL)
369 return NULL;
370 cp = PyString_AS_STRING(rv);
371
372 Py_BEGIN_ALLOW_THREADS
373 count = read(self->fd, cp, size);
374 Py_END_ALLOW_THREADS
375
376 if (count < 0) {
377 PyErr_SetFromErrno(PyExc_IOError);
378 Py_DECREF(rv);
379 return NULL;
380 }
381 self->icount += count;
382 _PyString_Resize(&rv, count);
383 return rv;
384}
385
386static PyObject *
387oss_write(oss_audio_t *self, PyObject *args)
388{
389 char *cp;
390 int rv, size;
391
392 if (!PyArg_ParseTuple(args, "s#:write", &cp, &size)) {
393 return NULL;
394 }
395
396 Py_BEGIN_ALLOW_THREADS
397 rv = write(self->fd, cp, size);
398 Py_END_ALLOW_THREADS
399
400 if (rv == -1) {
401 return PyErr_SetFromErrno(PyExc_IOError);
402 } else {
403 self->ocount += rv;
404 }
405 return PyInt_FromLong(rv);
406}
407
408static PyObject *
409oss_writeall(oss_audio_t *self, PyObject *args)
410{
411 char *cp;
412 int rv, size;
413 fd_set write_set_fds;
414 int select_rv;
415
416 /* NB. writeall() is only useful in non-blocking mode: according to
417 Guenter Geiger <geiger@xdv.org> on the linux-audio-dev list
418 (http://eca.cx/lad/2002/11/0380.html), OSS guarantees that
419 write() in blocking mode consumes the whole buffer. In blocking
420 mode, the behaviour of write() and writeall() from Python is
421 indistinguishable. */
422
423 if (!PyArg_ParseTuple(args, "s#:write", &cp, &size))
424 return NULL;
425
426 /* use select to wait for audio device to be available */
427 FD_ZERO(&write_set_fds);
428 FD_SET(self->fd, &write_set_fds);
429
430 while (size > 0) {
431 Py_BEGIN_ALLOW_THREADS
432 select_rv = select(self->fd+1, NULL, &write_set_fds, NULL, NULL);
433 Py_END_ALLOW_THREADS
434 assert(select_rv != 0); /* no timeout, can't expire */
435 if (select_rv == -1)
436 return PyErr_SetFromErrno(PyExc_IOError);
437
438 Py_BEGIN_ALLOW_THREADS
439 rv = write(self->fd, cp, size);
440 Py_END_ALLOW_THREADS
441 if (rv == -1) {
442 if (errno == EAGAIN) { /* buffer is full, try again */
443 errno = 0;
444 continue;
445 } else /* it's a real error */
446 return PyErr_SetFromErrno(PyExc_IOError);
447 } else { /* wrote rv bytes */
448 self->ocount += rv;
449 size -= rv;
450 cp += rv;
451 }
452 }
453 Py_INCREF(Py_None);
454 return Py_None;
455}
456
457static PyObject *
458oss_close(oss_audio_t *self, PyObject *unused)
459{
460 if (self->fd >= 0) {
461 Py_BEGIN_ALLOW_THREADS
462 close(self->fd);
463 Py_END_ALLOW_THREADS
464 self->fd = -1;
465 }
466 Py_INCREF(Py_None);
467 return Py_None;
468}
469
470static PyObject *
471oss_fileno(oss_audio_t *self, PyObject *unused)
472{
473 return PyInt_FromLong(self->fd);
474}
475
476
477/* Convenience methods: these generally wrap a couple of ioctls into one
478 common task. */
479
480static PyObject *
481oss_setparameters(oss_audio_t *self, PyObject *args)
482{
483 int wanted_fmt, wanted_channels, wanted_rate, strict=0;
484 int fmt, channels, rate;
485 PyObject * rv; /* return tuple (fmt, channels, rate) */
486
487 if (!PyArg_ParseTuple(args, "iii|i:setparameters",
488 &wanted_fmt, &wanted_channels, &wanted_rate,
489 &strict))
490 return NULL;
491
492 fmt = wanted_fmt;
493 if (ioctl(self->fd, SNDCTL_DSP_SETFMT, &fmt) == -1) {
494 return PyErr_SetFromErrno(PyExc_IOError);
495 }
496 if (strict && fmt != wanted_fmt) {
497 return PyErr_Format
498 (OSSAudioError,
499 "unable to set requested format (wanted %d, got %d)",
500 wanted_fmt, fmt);
501 }
502
503 channels = wanted_channels;
504 if (ioctl(self->fd, SNDCTL_DSP_CHANNELS, &channels) == -1) {
505 return PyErr_SetFromErrno(PyExc_IOError);
506 }
507 if (strict && channels != wanted_channels) {
508 return PyErr_Format
509 (OSSAudioError,
510 "unable to set requested channels (wanted %d, got %d)",
511 wanted_channels, channels);
512 }
513
514 rate = wanted_rate;
515 if (ioctl(self->fd, SNDCTL_DSP_SPEED, &rate) == -1) {
516 return PyErr_SetFromErrno(PyExc_IOError);
517 }
518 if (strict && rate != wanted_rate) {
519 return PyErr_Format
520 (OSSAudioError,
521 "unable to set requested rate (wanted %d, got %d)",
522 wanted_rate, rate);
523 }
524
525 /* Construct the return value: a (fmt, channels, rate) tuple that
526 tells what the audio hardware was actually set to. */
527 rv = PyTuple_New(3);
528 if (rv == NULL)
529 return NULL;
530 PyTuple_SET_ITEM(rv, 0, PyInt_FromLong(fmt));
531 PyTuple_SET_ITEM(rv, 1, PyInt_FromLong(channels));
532 PyTuple_SET_ITEM(rv, 2, PyInt_FromLong(rate));
533 return rv;
534}
535
536static int
537_ssize(oss_audio_t *self, int *nchannels, int *ssize)
538{
539 int fmt;
540
541 fmt = 0;
542 if (ioctl(self->fd, SNDCTL_DSP_SETFMT, &fmt) < 0)
543 return -errno;
544
545 switch (fmt) {
546 case AFMT_MU_LAW:
547 case AFMT_A_LAW:
548 case AFMT_U8:
549 case AFMT_S8:
550 *ssize = 1; /* 8 bit formats: 1 byte */
551 break;
552 case AFMT_S16_LE:
553 case AFMT_S16_BE:
554 case AFMT_U16_LE:
555 case AFMT_U16_BE:
556 *ssize = 2; /* 16 bit formats: 2 byte */
557 break;
558 case AFMT_MPEG:
559 case AFMT_IMA_ADPCM:
560 default:
561 return -EOPNOTSUPP;
562 }
563 if (ioctl(self->fd, SNDCTL_DSP_CHANNELS, nchannels) < 0)
564 return -errno;
565 return 0;
566}
567
568
569/* bufsize returns the size of the hardware audio buffer in number
570 of samples */
571static PyObject *
572oss_bufsize(oss_audio_t *self, PyObject *unused)
573{
574 audio_buf_info ai;
575 int nchannels=0, ssize=0;
576
577 if (_ssize(self, &nchannels, &ssize) < 0 || !nchannels || !ssize) {
578 PyErr_SetFromErrno(PyExc_IOError);
579 return NULL;
580 }
581 if (ioctl(self->fd, SNDCTL_DSP_GETOSPACE, &ai) < 0) {
582 PyErr_SetFromErrno(PyExc_IOError);
583 return NULL;
584 }
585 return PyInt_FromLong((ai.fragstotal * ai.fragsize) / (nchannels * ssize));
586}
587
588/* obufcount returns the number of samples that are available in the
589 hardware for playing */
590static PyObject *
591oss_obufcount(oss_audio_t *self, PyObject *unused)
592{
593 audio_buf_info ai;
594 int nchannels=0, ssize=0;
595
596 if (_ssize(self, &nchannels, &ssize) < 0 || !nchannels || !ssize) {
597 PyErr_SetFromErrno(PyExc_IOError);
598 return NULL;
599 }
600 if (ioctl(self->fd, SNDCTL_DSP_GETOSPACE, &ai) < 0) {
601 PyErr_SetFromErrno(PyExc_IOError);
602 return NULL;
603 }
604 return PyInt_FromLong((ai.fragstotal * ai.fragsize - ai.bytes) /
605 (ssize * nchannels));
606}
607
608/* obufcount returns the number of samples that can be played without
609 blocking */
610static PyObject *
611oss_obuffree(oss_audio_t *self, PyObject *unused)
612{
613 audio_buf_info ai;
614 int nchannels=0, ssize=0;
615
616 if (_ssize(self, &nchannels, &ssize) < 0 || !nchannels || !ssize) {
617 PyErr_SetFromErrno(PyExc_IOError);
618 return NULL;
619 }
620 if (ioctl(self->fd, SNDCTL_DSP_GETOSPACE, &ai) < 0) {
621 PyErr_SetFromErrno(PyExc_IOError);
622 return NULL;
623 }
624 return PyInt_FromLong(ai.bytes / (ssize * nchannels));
625}
626
627static PyObject *
628oss_getptr(oss_audio_t *self, PyObject *unused)
629{
630 count_info info;
631 int req;
632
633 if (self->mode == O_RDONLY)
634 req = SNDCTL_DSP_GETIPTR;
635 else
636 req = SNDCTL_DSP_GETOPTR;
637 if (ioctl(self->fd, req, &info) == -1) {
638 PyErr_SetFromErrno(PyExc_IOError);
639 return NULL;
640 }
641 return Py_BuildValue("iii", info.bytes, info.blocks, info.ptr);
642}
643
644
645/* ----------------------------------------------------------------------
646 * Methods of mixer objects (OSSMixerType)
647 */
648
649static PyObject *
650oss_mixer_close(oss_mixer_t *self, PyObject *unused)
651{
652 if (self->fd >= 0) {
653 close(self->fd);
654 self->fd = -1;
655 }
656 Py_INCREF(Py_None);
657 return Py_None;
658}
659
660static PyObject *
661oss_mixer_fileno(oss_mixer_t *self, PyObject *unused)
662{
663 return PyInt_FromLong(self->fd);
664}
665
666/* Simple mixer interface methods */
667
668static PyObject *
669oss_mixer_controls(oss_mixer_t *self, PyObject *args)
670{
671 return _do_ioctl_1_internal(self->fd, args, "controls",
672 SOUND_MIXER_READ_DEVMASK);
673}
674
675static PyObject *
676oss_mixer_stereocontrols(oss_mixer_t *self, PyObject *args)
677{
678 return _do_ioctl_1_internal(self->fd, args, "stereocontrols",
679 SOUND_MIXER_READ_STEREODEVS);
680}
681
682static PyObject *
683oss_mixer_reccontrols(oss_mixer_t *self, PyObject *args)
684{
685 return _do_ioctl_1_internal(self->fd, args, "reccontrols",
686 SOUND_MIXER_READ_RECMASK);
687}
688
689static PyObject *
690oss_mixer_get(oss_mixer_t *self, PyObject *args)
691{
692 int channel, volume;
693
694 /* Can't use _do_ioctl_1 because of encoded arg thingy. */
695 if (!PyArg_ParseTuple(args, "i:get", &channel))
696 return NULL;
697
698 if (channel < 0 || channel > SOUND_MIXER_NRDEVICES) {
699 PyErr_SetString(OSSAudioError, "Invalid mixer channel specified.");
700 return NULL;
701 }
702
703 if (ioctl(self->fd, MIXER_READ(channel), &volume) == -1)
704 return PyErr_SetFromErrno(PyExc_IOError);
705
706 return Py_BuildValue("(ii)", volume & 0xff, (volume & 0xff00) >> 8);
707}
708
709static PyObject *
710oss_mixer_set(oss_mixer_t *self, PyObject *args)
711{
712 int channel, volume, leftVol, rightVol;
713
714 /* Can't use _do_ioctl_1 because of encoded arg thingy. */
715 if (!PyArg_ParseTuple(args, "i(ii):set", &channel, &leftVol, &rightVol))
716 return NULL;
717
718 if (channel < 0 || channel > SOUND_MIXER_NRDEVICES) {
719 PyErr_SetString(OSSAudioError, "Invalid mixer channel specified.");
720 return NULL;
721 }
722
723 if (leftVol < 0 || rightVol < 0 || leftVol > 100 || rightVol > 100) {
724 PyErr_SetString(OSSAudioError, "Volumes must be between 0 and 100.");
725 return NULL;
726 }
727
728 volume = (rightVol << 8) | leftVol;
729
730 if (ioctl(self->fd, MIXER_WRITE(channel), &volume) == -1)
731 return PyErr_SetFromErrno(PyExc_IOError);
732
733 return Py_BuildValue("(ii)", volume & 0xff, (volume & 0xff00) >> 8);
734}
735
736static PyObject *
737oss_mixer_get_recsrc(oss_mixer_t *self, PyObject *args)
738{
739 return _do_ioctl_1_internal(self->fd, args, "get_recsrc",
740 SOUND_MIXER_READ_RECSRC);
741}
742
743static PyObject *
744oss_mixer_set_recsrc(oss_mixer_t *self, PyObject *args)
745{
746 return _do_ioctl_1(self->fd, args, "set_recsrc",
747 SOUND_MIXER_WRITE_RECSRC);
748}
749
750
751/* ----------------------------------------------------------------------
752 * Method tables and other bureaucracy
753 */
754
755static PyMethodDef oss_methods[] = {
756 /* Regular file methods */
757 { "read", (PyCFunction)oss_read, METH_VARARGS },
758 { "write", (PyCFunction)oss_write, METH_VARARGS },
759 { "writeall", (PyCFunction)oss_writeall, METH_VARARGS },
760 { "close", (PyCFunction)oss_close, METH_NOARGS },
761 { "fileno", (PyCFunction)oss_fileno, METH_NOARGS },
762
763 /* Simple ioctl wrappers */
764 { "nonblock", (PyCFunction)oss_nonblock, METH_NOARGS },
765 { "setfmt", (PyCFunction)oss_setfmt, METH_VARARGS },
766 { "getfmts", (PyCFunction)oss_getfmts, METH_NOARGS },
767 { "channels", (PyCFunction)oss_channels, METH_VARARGS },
768 { "speed", (PyCFunction)oss_speed, METH_VARARGS },
769 { "sync", (PyCFunction)oss_sync, METH_VARARGS },
770 { "reset", (PyCFunction)oss_reset, METH_VARARGS },
771 { "post", (PyCFunction)oss_post, METH_VARARGS },
772
773 /* Convenience methods -- wrap a couple of ioctls together */
774 { "setparameters", (PyCFunction)oss_setparameters, METH_VARARGS },
775 { "bufsize", (PyCFunction)oss_bufsize, METH_NOARGS },
776 { "obufcount", (PyCFunction)oss_obufcount, METH_NOARGS },
777 { "obuffree", (PyCFunction)oss_obuffree, METH_NOARGS },
778 { "getptr", (PyCFunction)oss_getptr, METH_NOARGS },
779
780 /* Aliases for backwards compatibility */
781 { "flush", (PyCFunction)oss_sync, METH_VARARGS },
782
783 { NULL, NULL} /* sentinel */
784};
785
786static PyMethodDef oss_mixer_methods[] = {
787 /* Regular file method - OSS mixers are ioctl-only interface */
788 { "close", (PyCFunction)oss_mixer_close, METH_NOARGS },
789 { "fileno", (PyCFunction)oss_mixer_fileno, METH_NOARGS },
790
791 /* Simple ioctl wrappers */
792 { "controls", (PyCFunction)oss_mixer_controls, METH_VARARGS },
793 { "stereocontrols", (PyCFunction)oss_mixer_stereocontrols, METH_VARARGS},
794 { "reccontrols", (PyCFunction)oss_mixer_reccontrols, METH_VARARGS},
795 { "get", (PyCFunction)oss_mixer_get, METH_VARARGS },
796 { "set", (PyCFunction)oss_mixer_set, METH_VARARGS },
797 { "get_recsrc", (PyCFunction)oss_mixer_get_recsrc, METH_VARARGS },
798 { "set_recsrc", (PyCFunction)oss_mixer_set_recsrc, METH_VARARGS },
799
800 { NULL, NULL}
801};
802
803static PyObject *
804oss_getattr(oss_audio_t *self, char *name)
805{
806 PyObject * rval = NULL;
807 if (strcmp(name, "closed") == 0) {
808 rval = (self->fd == -1) ? Py_True : Py_False;
809 Py_INCREF(rval);
810 }
811 else if (strcmp(name, "name") == 0) {
812 rval = PyString_FromString(self->devicename);
813 }
814 else if (strcmp(name, "mode") == 0) {
815 /* No need for a "default" in this switch: from newossobject(),
816 self->mode can only be one of these three values. */
817 switch(self->mode) {
818 case O_RDONLY:
819 rval = PyString_FromString("r");
820 break;
821 case O_RDWR:
822 rval = PyString_FromString("rw");
823 break;
824 case O_WRONLY:
825 rval = PyString_FromString("w");
826 break;
827 }
828 }
829 else {
830 rval = Py_FindMethod(oss_methods, (PyObject *)self, name);
831 }
832 return rval;
833}
834
835static PyObject *
836oss_mixer_getattr(oss_mixer_t *self, char *name)
837{
838 return Py_FindMethod(oss_mixer_methods, (PyObject *)self, name);
839}
840
841static PyTypeObject OSSAudioType = {
842 PyObject_HEAD_INIT(&PyType_Type)
843 0, /*ob_size*/
844 "ossaudiodev.oss_audio_device", /*tp_name*/
845 sizeof(oss_audio_t), /*tp_size*/
846 0, /*tp_itemsize*/
847 /* methods */
848 (destructor)oss_dealloc, /*tp_dealloc*/
849 0, /*tp_print*/
850 (getattrfunc)oss_getattr, /*tp_getattr*/
851 0, /*tp_setattr*/
852 0, /*tp_compare*/
853 0, /*tp_repr*/
854};
855
856static PyTypeObject OSSMixerType = {
857 PyObject_HEAD_INIT(&PyType_Type)
858 0, /*ob_size*/
859 "ossaudiodev.oss_mixer_device", /*tp_name*/
860 sizeof(oss_mixer_t), /*tp_size*/
861 0, /*tp_itemsize*/
862 /* methods */
863 (destructor)oss_mixer_dealloc, /*tp_dealloc*/
864 0, /*tp_print*/
865 (getattrfunc)oss_mixer_getattr, /*tp_getattr*/
866 0, /*tp_setattr*/
867 0, /*tp_compare*/
868 0, /*tp_repr*/
869};
870
871
872static PyObject *
873ossopen(PyObject *self, PyObject *args)
874{
875 return (PyObject *)newossobject(args);
876}
877
878static PyObject *
879ossopenmixer(PyObject *self, PyObject *args)
880{
881 return (PyObject *)newossmixerobject(args);
882}
883
884static PyMethodDef ossaudiodev_methods[] = {
885 { "open", ossopen, METH_VARARGS },
886 { "openmixer", ossopenmixer, METH_VARARGS },
887 { 0, 0 },
888};
889
890
891#define _EXPORT_INT(mod, name) \
892 if (PyModule_AddIntConstant(mod, #name, (long) (name)) == -1) return;
893
894
895static char *control_labels[] = SOUND_DEVICE_LABELS;
896static char *control_names[] = SOUND_DEVICE_NAMES;
897
898
899static int
900build_namelists (PyObject *module)
901{
902 PyObject *labels;
903 PyObject *names;
904 PyObject *s;
905 int num_controls;
906 int i;
907
908 num_controls = sizeof(control_labels) / sizeof(control_labels[0]);
909 assert(num_controls == sizeof(control_names) / sizeof(control_names[0]));
910
911 labels = PyList_New(num_controls);
912 names = PyList_New(num_controls);
913 if (labels == NULL || names == NULL)
914 goto error2;
915 for (i = 0; i < num_controls; i++) {
916 s = PyString_FromString(control_labels[i]);
917 if (s == NULL)
918 goto error2;
919 PyList_SET_ITEM(labels, i, s);
920
921 s = PyString_FromString(control_names[i]);
922 if (s == NULL)
923 goto error2;
924 PyList_SET_ITEM(names, i, s);
925 }
926
927 if (PyModule_AddObject(module, "control_labels", labels) == -1)
928 goto error2;
929 if (PyModule_AddObject(module, "control_names", names) == -1)
930 goto error1;
931
932 return 0;
933
934error2:
935 Py_XDECREF(labels);
936error1:
937 Py_XDECREF(names);
938 return -1;
939}
940
941
942void
943initossaudiodev(void)
944{
945 PyObject *m;
946
947 m = Py_InitModule("ossaudiodev", ossaudiodev_methods);
948 if (m == NULL)
949 return;
950
951 OSSAudioError = PyErr_NewException("ossaudiodev.OSSAudioError",
952 NULL, NULL);
953 if (OSSAudioError) {
954 /* Each call to PyModule_AddObject decrefs it; compensate: */
955 Py_INCREF(OSSAudioError);
956 Py_INCREF(OSSAudioError);
957 PyModule_AddObject(m, "error", OSSAudioError);
958 PyModule_AddObject(m, "OSSAudioError", OSSAudioError);
959 }
960
961 /* Build 'control_labels' and 'control_names' lists and add them
962 to the module. */
963 if (build_namelists(m) == -1) /* XXX what to do here? */
964 return;
965
966 /* Expose the audio format numbers -- essential! */
967 _EXPORT_INT(m, AFMT_QUERY);
968 _EXPORT_INT(m, AFMT_MU_LAW);
969 _EXPORT_INT(m, AFMT_A_LAW);
970 _EXPORT_INT(m, AFMT_IMA_ADPCM);
971 _EXPORT_INT(m, AFMT_U8);
972 _EXPORT_INT(m, AFMT_S16_LE);
973 _EXPORT_INT(m, AFMT_S16_BE);
974 _EXPORT_INT(m, AFMT_S8);
975 _EXPORT_INT(m, AFMT_U16_LE);
976 _EXPORT_INT(m, AFMT_U16_BE);
977 _EXPORT_INT(m, AFMT_MPEG);
978#ifdef AFMT_AC3
979 _EXPORT_INT(m, AFMT_AC3);
980#endif
981#ifdef AFMT_S16_NE
982 _EXPORT_INT(m, AFMT_S16_NE);
983#endif
984#ifdef AFMT_U16_NE
985 _EXPORT_INT(m, AFMT_U16_NE);
986#endif
987#ifdef AFMT_S32_LE
988 _EXPORT_INT(m, AFMT_S32_LE);
989#endif
990#ifdef AFMT_S32_BE
991 _EXPORT_INT(m, AFMT_S32_BE);
992#endif
993#ifdef AFMT_MPEG
994 _EXPORT_INT(m, AFMT_MPEG);
995#endif
996
997 /* Expose the sound mixer device numbers. */
998 _EXPORT_INT(m, SOUND_MIXER_NRDEVICES);
999 _EXPORT_INT(m, SOUND_MIXER_VOLUME);
1000 _EXPORT_INT(m, SOUND_MIXER_BASS);
1001 _EXPORT_INT(m, SOUND_MIXER_TREBLE);
1002 _EXPORT_INT(m, SOUND_MIXER_SYNTH);
1003 _EXPORT_INT(m, SOUND_MIXER_PCM);
1004 _EXPORT_INT(m, SOUND_MIXER_SPEAKER);
1005 _EXPORT_INT(m, SOUND_MIXER_LINE);
1006 _EXPORT_INT(m, SOUND_MIXER_MIC);
1007 _EXPORT_INT(m, SOUND_MIXER_CD);
1008 _EXPORT_INT(m, SOUND_MIXER_IMIX);
1009 _EXPORT_INT(m, SOUND_MIXER_ALTPCM);
1010 _EXPORT_INT(m, SOUND_MIXER_RECLEV);
1011 _EXPORT_INT(m, SOUND_MIXER_IGAIN);
1012 _EXPORT_INT(m, SOUND_MIXER_OGAIN);
1013 _EXPORT_INT(m, SOUND_MIXER_LINE1);
1014 _EXPORT_INT(m, SOUND_MIXER_LINE2);
1015 _EXPORT_INT(m, SOUND_MIXER_LINE3);
1016#ifdef SOUND_MIXER_DIGITAL1
1017 _EXPORT_INT(m, SOUND_MIXER_DIGITAL1);
1018#endif
1019#ifdef SOUND_MIXER_DIGITAL2
1020 _EXPORT_INT(m, SOUND_MIXER_DIGITAL2);
1021#endif
1022#ifdef SOUND_MIXER_DIGITAL3
1023 _EXPORT_INT(m, SOUND_MIXER_DIGITAL3);
1024#endif
1025#ifdef SOUND_MIXER_PHONEIN
1026 _EXPORT_INT(m, SOUND_MIXER_PHONEIN);
1027#endif
1028#ifdef SOUND_MIXER_PHONEOUT
1029 _EXPORT_INT(m, SOUND_MIXER_PHONEOUT);
1030#endif
1031#ifdef SOUND_MIXER_VIDEO
1032 _EXPORT_INT(m, SOUND_MIXER_VIDEO);
1033#endif
1034#ifdef SOUND_MIXER_RADIO
1035 _EXPORT_INT(m, SOUND_MIXER_RADIO);
1036#endif
1037#ifdef SOUND_MIXER_MONITOR
1038 _EXPORT_INT(m, SOUND_MIXER_MONITOR);
1039#endif
1040
1041 /* Expose all the ioctl numbers for masochists who like to do this
1042 stuff directly. */
1043 _EXPORT_INT(m, SNDCTL_COPR_HALT);
1044 _EXPORT_INT(m, SNDCTL_COPR_LOAD);
1045 _EXPORT_INT(m, SNDCTL_COPR_RCODE);
1046 _EXPORT_INT(m, SNDCTL_COPR_RCVMSG);
1047 _EXPORT_INT(m, SNDCTL_COPR_RDATA);
1048 _EXPORT_INT(m, SNDCTL_COPR_RESET);
1049 _EXPORT_INT(m, SNDCTL_COPR_RUN);
1050 _EXPORT_INT(m, SNDCTL_COPR_SENDMSG);
1051 _EXPORT_INT(m, SNDCTL_COPR_WCODE);
1052 _EXPORT_INT(m, SNDCTL_COPR_WDATA);
1053#ifdef SNDCTL_DSP_BIND_CHANNEL
1054 _EXPORT_INT(m, SNDCTL_DSP_BIND_CHANNEL);
1055#endif
1056 _EXPORT_INT(m, SNDCTL_DSP_CHANNELS);
1057 _EXPORT_INT(m, SNDCTL_DSP_GETBLKSIZE);
1058 _EXPORT_INT(m, SNDCTL_DSP_GETCAPS);
1059#ifdef SNDCTL_DSP_GETCHANNELMASK
1060 _EXPORT_INT(m, SNDCTL_DSP_GETCHANNELMASK);
1061#endif
1062 _EXPORT_INT(m, SNDCTL_DSP_GETFMTS);
1063 _EXPORT_INT(m, SNDCTL_DSP_GETIPTR);
1064 _EXPORT_INT(m, SNDCTL_DSP_GETISPACE);
1065#ifdef SNDCTL_DSP_GETODELAY
1066 _EXPORT_INT(m, SNDCTL_DSP_GETODELAY);
1067#endif
1068 _EXPORT_INT(m, SNDCTL_DSP_GETOPTR);
1069 _EXPORT_INT(m, SNDCTL_DSP_GETOSPACE);
1070#ifdef SNDCTL_DSP_GETSPDIF
1071 _EXPORT_INT(m, SNDCTL_DSP_GETSPDIF);
1072#endif
1073 _EXPORT_INT(m, SNDCTL_DSP_GETTRIGGER);
1074 _EXPORT_INT(m, SNDCTL_DSP_MAPINBUF);
1075 _EXPORT_INT(m, SNDCTL_DSP_MAPOUTBUF);
1076 _EXPORT_INT(m, SNDCTL_DSP_NONBLOCK);
1077 _EXPORT_INT(m, SNDCTL_DSP_POST);
1078#ifdef SNDCTL_DSP_PROFILE
1079 _EXPORT_INT(m, SNDCTL_DSP_PROFILE);
1080#endif
1081 _EXPORT_INT(m, SNDCTL_DSP_RESET);
1082 _EXPORT_INT(m, SNDCTL_DSP_SAMPLESIZE);
1083 _EXPORT_INT(m, SNDCTL_DSP_SETDUPLEX);
1084 _EXPORT_INT(m, SNDCTL_DSP_SETFMT);
1085 _EXPORT_INT(m, SNDCTL_DSP_SETFRAGMENT);
1086#ifdef SNDCTL_DSP_SETSPDIF
1087 _EXPORT_INT(m, SNDCTL_DSP_SETSPDIF);
1088#endif
1089 _EXPORT_INT(m, SNDCTL_DSP_SETSYNCRO);
1090 _EXPORT_INT(m, SNDCTL_DSP_SETTRIGGER);
1091 _EXPORT_INT(m, SNDCTL_DSP_SPEED);
1092 _EXPORT_INT(m, SNDCTL_DSP_STEREO);
1093 _EXPORT_INT(m, SNDCTL_DSP_SUBDIVIDE);
1094 _EXPORT_INT(m, SNDCTL_DSP_SYNC);
1095 _EXPORT_INT(m, SNDCTL_FM_4OP_ENABLE);
1096 _EXPORT_INT(m, SNDCTL_FM_LOAD_INSTR);
1097 _EXPORT_INT(m, SNDCTL_MIDI_INFO);
1098 _EXPORT_INT(m, SNDCTL_MIDI_MPUCMD);
1099 _EXPORT_INT(m, SNDCTL_MIDI_MPUMODE);
1100 _EXPORT_INT(m, SNDCTL_MIDI_PRETIME);
1101 _EXPORT_INT(m, SNDCTL_SEQ_CTRLRATE);
1102 _EXPORT_INT(m, SNDCTL_SEQ_GETINCOUNT);
1103 _EXPORT_INT(m, SNDCTL_SEQ_GETOUTCOUNT);
1104#ifdef SNDCTL_SEQ_GETTIME
1105 _EXPORT_INT(m, SNDCTL_SEQ_GETTIME);
1106#endif
1107 _EXPORT_INT(m, SNDCTL_SEQ_NRMIDIS);
1108 _EXPORT_INT(m, SNDCTL_SEQ_NRSYNTHS);
1109 _EXPORT_INT(m, SNDCTL_SEQ_OUTOFBAND);
1110 _EXPORT_INT(m, SNDCTL_SEQ_PANIC);
1111 _EXPORT_INT(m, SNDCTL_SEQ_PERCMODE);
1112 _EXPORT_INT(m, SNDCTL_SEQ_RESET);
1113 _EXPORT_INT(m, SNDCTL_SEQ_RESETSAMPLES);
1114 _EXPORT_INT(m, SNDCTL_SEQ_SYNC);
1115 _EXPORT_INT(m, SNDCTL_SEQ_TESTMIDI);
1116 _EXPORT_INT(m, SNDCTL_SEQ_THRESHOLD);
1117#ifdef SNDCTL_SYNTH_CONTROL
1118 _EXPORT_INT(m, SNDCTL_SYNTH_CONTROL);
1119#endif
1120#ifdef SNDCTL_SYNTH_ID
1121 _EXPORT_INT(m, SNDCTL_SYNTH_ID);
1122#endif
1123 _EXPORT_INT(m, SNDCTL_SYNTH_INFO);
1124 _EXPORT_INT(m, SNDCTL_SYNTH_MEMAVL);
1125#ifdef SNDCTL_SYNTH_REMOVESAMPLE
1126 _EXPORT_INT(m, SNDCTL_SYNTH_REMOVESAMPLE);
1127#endif
1128 _EXPORT_INT(m, SNDCTL_TMR_CONTINUE);
1129 _EXPORT_INT(m, SNDCTL_TMR_METRONOME);
1130 _EXPORT_INT(m, SNDCTL_TMR_SELECT);
1131 _EXPORT_INT(m, SNDCTL_TMR_SOURCE);
1132 _EXPORT_INT(m, SNDCTL_TMR_START);
1133 _EXPORT_INT(m, SNDCTL_TMR_STOP);
1134 _EXPORT_INT(m, SNDCTL_TMR_TEMPO);
1135 _EXPORT_INT(m, SNDCTL_TMR_TIMEBASE);
1136}
Note: See TracBrowser for help on using the repository browser.