1 /* GStreamer OSS4 mixer implementation
2 * Copyright (C) 2007-2008 Tim-Philipp Müller <tim centricular net>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with mixer library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * SECTION:element-oss4mixer
23 * This element lets you adjust sound input and output levels with the
24 * Open Sound System (OSS) version 4. It supports the GstMixer interface, which
25 * can be used to obtain a list of available mixer tracks. Set the mixer
26 * element to READY state before using the GstMixer interface on it.
29 * <title>Example pipelines</title>
31 * oss4mixer can't be used in a sensible way in gst-launch.
38 /* Note: ioctl calls on the same open mixer device are serialised via
39 * the object lock to make sure we don't do concurrent ioctls from two
40 * different threads (e.g. app thread and mixer watch thread), since that
41 * will probably confuse OSS. */
53 #include <sys/ioctl.h>
55 #include <gst/interfaces/mixer.h>
56 #include <gst/gst-i18n-plugin.h>
58 #include <glib/gprintf.h>
60 #define NO_LEGACY_MIXER
62 #include "oss4-audio.h"
63 #include "oss4-mixer.h"
64 #include "oss4-mixer-enum.h"
65 #include "oss4-mixer-slider.h"
66 #include "oss4-mixer-switch.h"
67 #include "oss4-property-probe.h"
68 #include "oss4-soundcard.h"
70 #define GST_OSS4_MIXER_WATCH_INTERVAL 500 /* in millisecs, ie. 0.5s */
72 GST_DEBUG_CATEGORY_EXTERN (oss4mixer_debug);
73 #define GST_CAT_DEFAULT oss4mixer_debug
75 #define DEFAULT_DEVICE NULL
76 #define DEFAULT_DEVICE_NAME NULL
85 static void gst_oss4_mixer_init_interfaces (GType type);
87 GST_BOILERPLATE_FULL (GstOss4Mixer, gst_oss4_mixer, GstElement,
88 GST_TYPE_ELEMENT, gst_oss4_mixer_init_interfaces);
90 static GstStateChangeReturn gst_oss4_mixer_change_state (GstElement *
91 element, GstStateChange transition);
93 static void gst_oss4_mixer_set_property (GObject * object, guint prop_id,
94 const GValue * value, GParamSpec * pspec);
95 static void gst_oss4_mixer_get_property (GObject * object, guint prop_id,
96 GValue * value, GParamSpec * pspec);
97 static void gst_oss4_mixer_finalize (GObject * object);
99 static gboolean gst_oss4_mixer_open (GstOss4Mixer * mixer,
100 gboolean silent_errors);
101 static void gst_oss4_mixer_close (GstOss4Mixer * mixer);
103 static gboolean gst_oss4_mixer_enum_control_update_enum_list (GstOss4Mixer * m,
104 GstOss4MixerControl * mc);
106 #ifndef GST_DISABLE_GST_DEBUG
107 static const gchar *mixer_ext_type_get_name (gint type);
108 static const gchar *mixer_ext_flags_get_string (gint flags);
112 gst_oss4_mixer_base_init (gpointer klass)
114 gst_element_class_set_details_simple (GST_ELEMENT_CLASS (klass),
115 "OSS v4 Audio Mixer", "Generic/Audio",
116 "Control sound input and output levels with OSS4",
117 "Tim-Philipp Müller <tim centricular net>");
121 gst_oss4_mixer_class_init (GstOss4MixerClass * klass)
123 GstElementClass *element_class;
124 GObjectClass *gobject_class;
126 element_class = (GstElementClass *) klass;
127 gobject_class = (GObjectClass *) klass;
129 gobject_class->finalize = gst_oss4_mixer_finalize;
130 gobject_class->set_property = gst_oss4_mixer_set_property;
131 gobject_class->get_property = gst_oss4_mixer_get_property;
134 * GstOss4Mixer:device
136 * OSS4 mixer device (e.g. /dev/oss/hdaudio0/mix0 or /dev/mixerN)
139 g_object_class_install_property (gobject_class, PROP_DEVICE,
140 g_param_spec_string ("device", "Device",
141 "OSS mixer device (e.g. /dev/oss/hdaudio0/mix0 or /dev/mixerN) "
142 "(NULL = use first mixer device found)", DEFAULT_DEVICE,
143 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
146 * GstOss4Mixer:device-name
148 * Human-readable name of the sound device. May be NULL if the device is
149 * not open (ie. when the mixer is in NULL state)
152 g_object_class_install_property (gobject_class, PROP_DEVICE_NAME,
153 g_param_spec_string ("device-name", "Device name",
154 "Human-readable name of the sound device", DEFAULT_DEVICE_NAME,
155 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
157 element_class->change_state = GST_DEBUG_FUNCPTR (gst_oss4_mixer_change_state);
161 gst_oss4_mixer_finalize (GObject * obj)
163 GstOss4Mixer *mixer = GST_OSS4_MIXER (obj);
165 g_free (mixer->device);
167 G_OBJECT_CLASS (parent_class)->finalize (obj);
171 gst_oss4_mixer_reset (GstOss4Mixer * mixer)
174 mixer->need_update = TRUE;
175 memset (&mixer->last_mixext, 0, sizeof (oss_mixext));
179 gst_oss4_mixer_init (GstOss4Mixer * mixer, GstOss4MixerClass * g_class)
181 mixer->device = g_strdup (DEFAULT_DEVICE);
182 mixer->device_name = NULL;
184 gst_oss4_mixer_reset (mixer);
188 gst_oss4_mixer_set_property (GObject * object, guint prop_id,
189 const GValue * value, GParamSpec * pspec)
191 GstOss4Mixer *mixer = GST_OSS4_MIXER (object);
195 GST_OBJECT_LOCK (mixer);
196 if (!GST_OSS4_MIXER_IS_OPEN (mixer)) {
197 g_free (mixer->device);
198 mixer->device = g_value_dup_string (value);
199 /* unset any cached device-name */
200 g_free (mixer->device_name);
201 mixer->device_name = NULL;
203 g_warning ("%s: can't change \"device\" property while mixer is open",
204 GST_OBJECT_NAME (mixer));
206 GST_OBJECT_UNLOCK (mixer);
209 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
215 gst_oss4_mixer_get_property (GObject * object, guint prop_id,
216 GValue * value, GParamSpec * pspec)
218 GstOss4Mixer *mixer = GST_OSS4_MIXER (object);
222 GST_OBJECT_LOCK (mixer);
223 g_value_set_string (value, mixer->device);
224 GST_OBJECT_UNLOCK (mixer);
226 case PROP_DEVICE_NAME:
227 GST_OBJECT_LOCK (mixer);
228 /* If device is set, try to retrieve the name even if we're not open */
229 if (mixer->fd == -1 && mixer->device != NULL) {
230 if (gst_oss4_mixer_open (mixer, TRUE)) {
231 g_value_set_string (value, mixer->device_name);
232 gst_oss4_mixer_close (mixer);
234 g_value_set_string (value, mixer->device_name);
237 g_value_set_string (value, mixer->device_name);
239 GST_OBJECT_UNLOCK (mixer);
242 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
248 gst_oss4_mixer_open (GstOss4Mixer * mixer, gboolean silent_errors)
250 struct oss_mixerinfo mi = { 0, };
253 g_return_val_if_fail (!GST_OSS4_MIXER_IS_OPEN (mixer), FALSE);
256 device = g_strdup (mixer->device);
258 device = gst_oss4_audio_find_device (GST_OBJECT_CAST (mixer));
260 /* desperate times, desperate measures */
262 device = g_strdup ("/dev/mixer");
264 GST_INFO_OBJECT (mixer, "Trying to open OSS4 mixer device '%s'", device);
266 mixer->fd = open (device, O_RDWR, 0);
270 /* Make sure it's OSS4. If it's old OSS, let the old ossmixer handle it */
271 if (!gst_oss4_audio_check_version (GST_OBJECT (mixer), mixer->fd))
274 GST_INFO_OBJECT (mixer, "Opened mixer device '%s', which is mixer %d",
277 /* Get device name for currently open fd */
279 if (ioctl (mixer->fd, SNDCTL_MIXERINFO, &mi) == 0) {
280 mixer->modify_counter = mi.modify_counter;
281 if (mi.name[0] != '\0') {
282 mixer->device_name = g_strdup (mi.name);
285 mixer->modify_counter = 0;
288 if (mixer->device_name == NULL) {
289 mixer->device_name = g_strdup ("Unknown");
291 GST_INFO_OBJECT (mixer, "device name = '%s'", mixer->device_name);
293 mixer->open_device = device;
300 if (!silent_errors) {
301 GST_ELEMENT_ERROR (mixer, RESOURCE, OPEN_READ_WRITE,
302 (_("Could not open audio device for mixer control handling.")),
305 GST_DEBUG_OBJECT (mixer, "open failed: %s (ignoring errors)",
313 gst_oss4_mixer_close (mixer);
314 if (!silent_errors) {
315 GST_ELEMENT_ERROR (mixer, RESOURCE, OPEN_READ_WRITE,
316 (_("Could not open audio device for mixer control handling. "
317 "This version of the Open Sound System is not supported by this "
318 "element.")), ("Try the 'ossmixer' element instead"));
320 GST_DEBUG_OBJECT (mixer, "open failed: legacy oss (ignoring errors)");
328 gst_oss4_mixer_control_free (GstOss4MixerControl * mc)
330 g_list_free (mc->children);
331 g_list_free (mc->mute_group);
332 g_free (mc->enum_vals);
333 memset (mc, 0, sizeof (GstOss4MixerControl));
338 gst_oss4_mixer_free_tracks (GstOss4Mixer * mixer)
340 g_list_foreach (mixer->tracks, (GFunc) g_object_unref, NULL);
341 g_list_free (mixer->tracks);
342 mixer->tracks = NULL;
344 g_list_foreach (mixer->controls, (GFunc) gst_oss4_mixer_control_free, NULL);
345 g_list_free (mixer->controls);
346 mixer->controls = NULL;
350 gst_oss4_mixer_close (GstOss4Mixer * mixer)
352 g_free (mixer->device_name);
353 mixer->device_name = NULL;
355 g_free (mixer->open_device);
356 mixer->open_device = NULL;
358 gst_oss4_mixer_free_tracks (mixer);
360 if (mixer->fd != -1) {
365 gst_oss4_mixer_reset (mixer);
369 gst_oss4_mixer_watch_process_changes (GstOss4Mixer * mixer)
371 GList *c, *t, *tracks = NULL;
373 GST_INFO_OBJECT (mixer, "mixer interface or control changed");
375 /* this is all with the mixer object lock held */
377 /* we go through the list backwards so we can bail out faster when the entire
378 * interface needs to be rebuilt */
379 for (c = g_list_last (mixer->controls); c != NULL; c = c->prev) {
380 GstOss4MixerControl *mc = c->data;
381 oss_mixer_value ossval = { 0, };
384 mc->list_changed = FALSE;
386 /* not interested in controls we don't expose in the mixer interface */
390 /* don't try to read a value from controls that don't have one */
391 if (mc->mixext.type == MIXT_DEVROOT || mc->mixext.type == MIXT_GROUP)
394 /* is this an enum control whose list may change? */
395 if (mc->mixext.type == MIXT_ENUM && mc->enum_version != 0) {
396 if (gst_oss4_mixer_enum_control_update_enum_list (mixer, mc))
397 mc->list_changed = TRUE;
400 ossval.dev = mc->mixext.dev;
401 ossval.ctrl = mc->mixext.ctrl;
402 ossval.timestamp = mc->mixext.timestamp;
404 if (ioctl (mixer->fd, SNDCTL_MIX_READ, &ossval) == -1) {
405 if (errno == EIDRM || errno == EFAULT) {
406 GST_DEBUG ("%s has disappeared", mc->mixext.extname);
409 GST_WARNING_OBJECT (mixer, "MIX_READ failed: %s", g_strerror (errno));
410 /* just ignore, move on to next one */
414 if (ossval.value == mc->last_val) { /* no change */
415 /* GST_LOG_OBJECT (mixer, "%s hasn't changed", mc->mixext.extname); */
419 mc->last_val = ossval.value;
420 GST_LOG_OBJECT (mixer, "%s changed value to %u 0x%08x",
421 mc->mixext.extname, ossval.value, ossval.value);
425 /* copy list and take track refs, so we can safely drop the object lock,
426 * which we need to do to be able to post messages on the bus */
427 tracks = g_list_copy (mixer->tracks);
428 g_list_foreach (tracks, (GFunc) g_object_ref, NULL);
430 GST_OBJECT_UNLOCK (mixer);
432 /* since we don't know (or want to know exactly) which controls belong to
433 * which track, we just go through the tracks one-by-one now and make them
434 * check themselves if any of their controls have changed and which messages
435 * to post on the bus as a result */
436 for (t = tracks; t != NULL; t = t->next) {
437 GstMixerTrack *track = t->data;
439 if (GST_IS_OSS4_MIXER_SLIDER (track)) {
440 gst_oss4_mixer_slider_process_change_unlocked (track);
441 } else if (GST_IS_OSS4_MIXER_SWITCH (track)) {
442 gst_oss4_mixer_switch_process_change_unlocked (track);
443 } else if (GST_IS_OSS4_MIXER_ENUM (track)) {
444 gst_oss4_mixer_enum_process_change_unlocked (track);
447 g_object_unref (track);
449 g_list_free (tracks);
451 GST_OBJECT_LOCK (mixer);
456 GST_OBJECT_UNLOCK (mixer);
457 gst_mixer_mixer_changed (GST_MIXER (mixer));
458 GST_OBJECT_LOCK (mixer);
463 /* This thread watches the mixer for changes in a somewhat inefficient way
464 * (running an ioctl every half second or so). This is still better and
465 * cheaper than apps polling all tracks for changes a few times a second
466 * though. Needs more thought. There's probably (hopefully) a way to get
467 * notifications via the fd directly somehow. */
469 gst_oss4_mixer_watch_thread (gpointer thread_data)
471 GstOss4Mixer *mixer = GST_OSS4_MIXER_CAST (thread_data);
473 GST_DEBUG_OBJECT (mixer, "watch thread running");
475 GST_OBJECT_LOCK (mixer);
476 while (!mixer->watch_shutdown) {
477 oss_mixerinfo mi = { 0, };
481 if (ioctl (mixer->fd, SNDCTL_MIXERINFO, &mi) == 0) {
482 if (mixer->modify_counter != mi.modify_counter) {
483 /* GST_LOG ("processing changes"); */
484 gst_oss4_mixer_watch_process_changes (mixer);
485 mixer->modify_counter = mi.modify_counter;
487 /* GST_LOG ("no changes"); */
490 GST_WARNING_OBJECT (mixer, "MIXERINFO failed: %s", g_strerror (errno));
493 /* we could move the _get_current_time out of the loop and just do the
494 * add in ever iteration, which would be less exact, but who cares */
495 g_get_current_time (&tv);
496 g_time_val_add (&tv, GST_OSS4_MIXER_WATCH_INTERVAL * 1000);
497 (void) g_cond_timed_wait (mixer->watch_cond, GST_OBJECT_GET_LOCK (mixer),
500 GST_OBJECT_UNLOCK (mixer);
502 GST_DEBUG_OBJECT (mixer, "watch thread done");
503 gst_object_unref (mixer);
507 /* call with object lock held */
509 gst_oss4_mixer_wake_up_watch_task (GstOss4Mixer * mixer)
511 GST_LOG_OBJECT (mixer, "signalling watch thread to wake up");
512 g_cond_signal (mixer->watch_cond);
516 gst_oss4_mixer_stop_watch_task (GstOss4Mixer * mixer)
518 if (mixer->watch_thread) {
519 GST_OBJECT_LOCK (mixer);
520 mixer->watch_shutdown = TRUE;
521 GST_LOG_OBJECT (mixer, "signalling watch thread to stop");
522 g_cond_signal (mixer->watch_cond);
523 GST_OBJECT_UNLOCK (mixer);
524 GST_LOG_OBJECT (mixer, "waiting for watch thread to join");
525 g_thread_join (mixer->watch_thread);
526 GST_DEBUG_OBJECT (mixer, "watch thread stopped");
527 mixer->watch_thread = NULL;
530 if (mixer->watch_cond) {
531 g_cond_free (mixer->watch_cond);
532 mixer->watch_cond = NULL;
537 gst_oss4_mixer_start_watch_task (GstOss4Mixer * mixer)
541 mixer->watch_cond = g_cond_new ();
542 mixer->watch_shutdown = FALSE;
544 mixer->watch_thread = g_thread_create (gst_oss4_mixer_watch_thread,
545 gst_object_ref (mixer), TRUE, &err);
547 if (mixer->watch_thread == NULL) {
548 GST_ERROR_OBJECT (mixer, "Could not create watch thread: %s", err->message);
549 g_cond_free (mixer->watch_cond);
550 mixer->watch_cond = NULL;
555 static GstStateChangeReturn
556 gst_oss4_mixer_change_state (GstElement * element, GstStateChange transition)
558 GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
559 GstOss4Mixer *mixer = GST_OSS4_MIXER (element);
561 switch (transition) {
562 case GST_STATE_CHANGE_NULL_TO_READY:
563 if (!gst_oss4_mixer_open (mixer, FALSE))
564 return GST_STATE_CHANGE_FAILURE;
565 gst_oss4_mixer_start_watch_task (mixer);
571 ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
572 if (ret == GST_STATE_CHANGE_FAILURE)
575 switch (transition) {
576 case GST_STATE_CHANGE_READY_TO_NULL:
577 gst_oss4_mixer_stop_watch_task (mixer);
578 gst_oss4_mixer_close (mixer);
587 /* === GstMixer interface === */
589 static inline gboolean
590 gst_oss4_mixer_contains_track (GstMixer * mixer, GstMixerTrack * track)
592 return (g_list_find (GST_OSS4_MIXER (mixer)->tracks, track) != NULL);
595 static inline gboolean
596 gst_oss4_mixer_contains_options (GstMixer * mixer, GstMixerOptions * options)
598 return (g_list_find (GST_OSS4_MIXER (mixer)->tracks, options) != NULL);
602 gst_oss4_mixer_post_mixer_changed_msg (GstOss4Mixer * mixer)
604 /* only post mixer-changed message once */
605 if (!mixer->need_update) {
606 gst_mixer_mixer_changed (GST_MIXER (mixer));
607 mixer->need_update = TRUE;
611 /* call with mixer object lock held to serialise ioctl */
613 gst_oss4_mixer_get_control_val (GstOss4Mixer * mixer, GstOss4MixerControl * mc,
616 oss_mixer_value ossval = { 0, };
618 if (GST_OBJECT_TRYLOCK (mixer)) {
619 GST_ERROR ("must be called with mixer lock held");
620 GST_OBJECT_UNLOCK (mixer);
623 ossval.dev = mc->mixext.dev;
624 ossval.ctrl = mc->mixext.ctrl;
625 ossval.timestamp = mc->mixext.timestamp;
627 if (ioctl (mixer->fd, SNDCTL_MIX_READ, &ossval) == -1) {
628 if (errno == EIDRM) {
629 GST_DEBUG_OBJECT (mixer, "MIX_READ failed: mixer interface has changed");
630 gst_oss4_mixer_post_mixer_changed_msg (mixer);
632 GST_WARNING_OBJECT (mixer, "MIX_READ failed: %s", g_strerror (errno));
640 mc->last_val = ossval.value;
641 GST_LOG_OBJECT (mixer, "got value 0x%08x from %s)", *val, mc->mixext.extname);
645 /* call with mixer object lock held to serialise ioctl */
647 gst_oss4_mixer_set_control_val (GstOss4Mixer * mixer, GstOss4MixerControl * mc,
650 oss_mixer_value ossval = { 0, };
652 ossval.dev = mc->mixext.dev;
653 ossval.ctrl = mc->mixext.ctrl;
654 ossval.timestamp = mc->mixext.timestamp;
657 if (GST_OBJECT_TRYLOCK (mixer)) {
658 GST_ERROR ("must be called with mixer lock held");
659 GST_OBJECT_UNLOCK (mixer);
662 if (ioctl (mixer->fd, SNDCTL_MIX_WRITE, &ossval) == -1) {
663 if (errno == EIDRM) {
664 GST_LOG_OBJECT (mixer, "MIX_WRITE failed: mixer interface has changed");
665 gst_oss4_mixer_post_mixer_changed_msg (mixer);
667 GST_WARNING_OBJECT (mixer, "MIX_WRITE failed: %s", g_strerror (errno));
673 GST_LOG_OBJECT (mixer, "set value 0x%08x on %s", val, mc->mixext.extname);
679 gst_oss4_mixer_control_get_pretty_name (GstOss4MixerControl * mc)
683 const gchar *name, *u;
685 /* "The id field is the original name given by the driver when it called
686 * mixer_ext_create_control. This name can be used by fully featured GUI
687 * mixers. However this name should be downshifted and cut before the last
688 * underscore ("_") to get the proper name. For example mixer control name
689 * created as "MYDRV_MAINVOL" will become just "mainvol" after this
690 * transformation." */
691 name = mc->mixext.extname;
692 u = MAX (strrchr (name, '_'), strrchr (name, '.'));
696 /* maybe capitalize the first letter? */
697 return g_ascii_strdown (name, -1);
698 /* the .id thing doesn't really seem to work right, ie. for some sliders
699 * it's just '-' so you have to use the name of the parent control etc.
700 * let's not use it for now, much too painful. */
701 if (g_str_has_prefix (mc->mixext.extname, "misc."))
702 name = g_strdup (mc->mixext.extname + 5);
704 name = g_strdup (mc->mixext.extname);
705 /* chop off trailing digit (only one for now) */
706 if (strlen (name) > 0 && g_ascii_isdigit (name[strlen (name) - 1]))
707 name[strlen (name) - 1] = '\0';
708 g_strdelimit (name, ".", ' ');
713 /* these translations are a bit ad-hoc and horribly incomplete; it is not
714 * really going to work this way with all the different chipsets and drivers.
715 * We also use these for translating option values. */
718 const gchar oss_name[32];
722 "volume", N_("Volume")}, {
723 "master", N_("Master")}, {
724 "front", N_("Front")}, {
725 "rear", N_("Rear")}, {
726 "headphones", N_("Headphones")}, {
727 "center", N_("Center")}, {
729 "surround", N_("Surround")}, {
730 "side", N_("Side")}, {
731 "speaker", N_("Built-in Speaker")}, {
732 "aux1-out", N_("AUX 1 Out")}, {
733 "aux2-out", N_("AUX 2 Out")}, {
734 "aux-out", N_("AUX Out")}, {
735 "bass", N_("Bass")}, {
736 "treble", N_("Treble")}, {
737 "3d-depth", N_("3D Depth")}, {
738 "3d-center", N_("3D Center")}, {
739 "3d-enhance", N_("3D Enhance")}, {
740 "phone", N_("Telephone")}, {
741 "mic", N_("Microphone")}, {
742 "line-out", N_("Line Out")}, {
743 "line-in", N_("Line In")}, {
744 "linein", N_("Line In")}, {
745 "cd", N_("Internal CD")}, {
746 "video", N_("Video In")}, {
747 "aux1-in", N_("AUX 1 In")}, {
748 "aux2-in", N_("AUX 2 In")}, {
749 "aux-in", N_("AUX In")}, {
751 "record-gain", N_("Record Gain")}, {
752 "igain", N_("Record Gain")}, {
753 "ogain", N_("Output Gain")}, {
754 "micboost", N_("Microphone Boost")}, {
755 "loopback", N_("Loopback")}, {
756 "diag", N_("Diagnostic")}, {
757 "loudness", N_("Bass Boost")}, {
758 "outputs", N_("Playback Ports")}, {
759 "input", N_("Input")}, {
760 "inputs", N_("Record Source")}, {
761 "record-source", N_("Record Source")}, {
762 "monitor-source", N_("Monitor Source")}, {
763 "beep", N_("Keyboard Beep")}, {
764 "monitor-gain", N_("Monitor")}, {
765 "stereo-simulate", N_("Simulate Stereo")}, {
766 "stereo", N_("Stereo")}, {
767 "multich", N_("Surround Sound")}, {
768 "mic-gain", N_("Microphone Gain")}, {
769 "speaker-source", N_("Speaker Source")}, {
770 "mic-source", N_("Microphone Source")}, {
771 "jack", N_("Jack")}, {
772 "center/lfe", N_("Center / LFE")}, {
773 "stereo-mix", N_("Stereo Mix")}, {
774 "mono-mix", N_("Mono Mix")}, {
775 "input-mix", N_("Input Mix")}, {
776 "spdif-in", N_("SPDIF In")}, {
777 "spdif-out", N_("SPDIF Out")}, {
778 "mic1", N_("Microphone 1")}, {
779 "mic2", N_("Microphone 2")}, {
780 "digital-out", N_("Digital Out")}, {
781 "digital-in", N_("Digital In")}, {
782 "hdmi", N_("HDMI")}, {
783 "modem", N_("Modem")}, {
784 "handset", N_("Handset")}, {
785 "other", N_("Other")}, {
786 "stereo", N_("Stereo")}, {
787 "none", N_("None")}, {
790 "mute", N_("Mute")}, {
791 "fast", N_("Fast")}, {
792 /* TRANSLATORS: "Very Low" is a quality setting here */
793 "very-low", N_("Very Low")}, {
794 /* TRANSLATORS: "Low" is a quality setting here */
796 /* TRANSLATORS: "Medium" is a quality setting here */
797 "medium", N_("Medium")}, {
798 /* TRANSLATORS: "High" is a quality setting here */
799 "high", N_("High")}, {
800 /* TRANSLATORS: "Very High" is a quality setting here */
801 "very-high", N_("Very High")}, {
802 "high+", N_("Very High")}, {
803 /* TRANSLATORS: "Production" is a quality setting here */
804 "production", N_("Production")}, {
805 "fp-mic", N_("Front Panel Microphone")}, {
806 "fp-linein", N_("Front Panel Line In")}, {
807 "fp-headphones", N_("Front Panel Headphones")}, {
808 "fp-lineout", N_("Front Panel Line Out")}, {
809 "green", N_("Green Connector")}, {
810 "pink", N_("Pink Connector")}, {
811 "blue", N_("Blue Connector")}, {
812 "white", N_("White Connector")}, {
813 "black", N_("Black Connector")}, {
814 "gray", N_("Gray Connector")}, {
815 "orange", N_("Orange Connector")}, {
816 "red", N_("Red Connector")}, {
817 "yellow", N_("Yellow Connector")}, {
818 "fp-green", N_("Green Front Panel Connector")}, {
819 "fp-pink", N_("Pink Front Panel Connector")}, {
820 "fp-blue", N_("Blue Front Panel Connector")}, {
821 "fp-white", N_("White Front Panel Connector")}, {
822 "fp-black", N_("Black Front Panel Connector")}, {
823 "fp-gray", N_("Gray Front Panel Connector")}, {
824 "fp-orange", N_("Orange Front Panel Connector")}, {
825 "fp-red", N_("Red Front Panel Connector")}, {
826 "fp-yellow", N_("Yellow Front Panel Connector")}, {
827 "spread", N_("Spread Output")}, {
828 "downmix", N_("Downmix")},
829 /* FIXME translate Audigy NX USB labels) */
831 { "rec.src", N_("Record Source") },
832 { "output.mute", N_("Mute output") }
833 headph (Controller group)
834 headph.src (Enumeration control)
835 headph.mute (On/Off switch)
836 digital2 (Controller group)
837 digital2.src (Enumeration control)
838 digital2.mute (On/Off switch)
839 digital (Controller group)
840 digital.mute1 (On/Off switch)
841 digital.vol (Controller group)
842 digital.vol.front (Stereo slider (0-255))
843 digital.vol.surr (Stereo slider (0-255))
844 digital.vol.c/l (Stereo slider (0-255))
845 digital.vol.center (Stereo slider (0-255))
846 digital.mute2 (On/Off switch)
847 digital.vol (Stereo slider (0-255))
848 line (Controller group)
849 line.mute (On/Off switch)
850 line.vol (Stereo slider (0-255))
851 play-altset (Enumeration control)
852 rec-altset (Enumeration control)
856 /* Decent i18n is pretty much impossible with OSS's way of providing us with
857 * mixer labels (and the fact that they are pretty much random), but that
858 * doesn't mean we shouldn't at least try. */
860 gst_oss4_mixer_control_get_translated_name (GstOss4MixerControl * mc)
862 gchar name[128] = { 0, };
863 gchar vmix_str[32] = { '\0', };
867 gboolean function_suffix = FALSE;
869 /* main virtual mixer controls (we hide the stream volumes) */
870 if (sscanf (mc->mixext.extname, "vmix%d-%32c", &dummy, vmix_str) == 2) {
871 if (strcmp (vmix_str, "src") == 0)
872 return g_strdup (_("Virtual Mixer Input"));
873 else if (strcmp (vmix_str, "vol") == 0)
874 return g_strdup (_("Virtual Mixer Output"));
875 else if (strcmp (vmix_str, "channels") == 0)
876 return g_strdup (_("Virtual Mixer Channels"));
879 g_strlcpy (name, mc->mixext.extname, sizeof (name));
881 /* we deal with either "connector." or "jack." */
882 if ((g_str_has_prefix (name, "connector.")) ||
883 (g_str_has_prefix (name, "jack."))) {
884 ptr = strchr (mc->mixext.extname, '.');
886 g_strlcpy (name, ptr, sizeof (name));
889 /* special handling for jack retasking suffixes */
890 if (g_str_has_suffix (name, ".function") || g_str_has_suffix (name, ".mode")) {
891 function_suffix = TRUE;
892 ptr = strrchr (name, '.');
896 /* parse off trailing numbers */
898 while ((i > 0) && (g_ascii_isdigit (name[i - 1]))) {
901 /* the check catches the case where the control name is just a number */
902 if ((i > 0) && (name[i] != '\0')) {
903 num = atoi (name + i);
907 /* look for a match, progressively skipping '.' delimited prefixes as we go */
912 for (i = 0; i < G_N_ELEMENTS (labels); ++i) {
913 if (g_ascii_strcasecmp (ptr, labels[i].oss_name) == 0) {
914 g_strlcpy (name, _(labels[i].label), sizeof (name));
915 goto append_suffixes;
918 } while ((ptr = strchr (ptr, '.')) != NULL);
920 /* failing that, just replace periods with spaces */
921 g_strdelimit (name, ".", ' ');
925 if (function_suffix) {
926 /* TRANSLATORS: name + number of a volume mixer control */
927 return g_strdup_printf (_("%s %d Function"), name, num);
929 return g_strdup_printf ("%s %d", name, num);
932 if (function_suffix) {
933 /* TRANSLATORS: name of a volume mixer control */
934 return g_strdup_printf (_("%s Function"), name);
936 return g_strdup (name);
942 gst_oss4_mixer_control_get_translated_option (const gchar * name)
945 for (i = 0; i < G_N_ELEMENTS (labels); ++i) {
946 if (g_ascii_strcasecmp (name, labels[i].oss_name) == 0) {
947 return _(labels[i].label);
953 #ifndef GST_DISABLE_GST_DEBUG
955 mixer_ext_type_get_name (gint type)
959 return "Device root entry";
961 return "Controller group";
963 return "On/Off switch";
965 return "Enumeration control";
966 case MIXT_MONOSLIDER:
967 return "Mono slider (0-255)";
968 case MIXT_STEREOSLIDER:
969 return "Stereo slider (0-255)";
971 return "Textual message"; /* whatever this is */
973 return "Mono VU meter value";
975 return "Stereo VU meter value";
977 return "Mono VU meter peak value";
978 case MIXT_STEREOPEAK:
979 return "Stereo VU meter peak value";
980 case MIXT_RADIOGROUP:
981 return "Radio button group";
982 case MIXT_MARKER: /* Separator between normal and extension entries */
985 return "Decimal value entry";
987 return "Hex value entry";
989 return "Mono slider (31-bit value range)";
991 return "3D"; /* what's this? */
992 case MIXT_MONOSLIDER16:
993 return "Mono slider (0-32767)";
994 case MIXT_STEREOSLIDER16:
995 return "Stereo slider (0-32767)";
997 return "Mute switch";
1003 #endif /* GST_DISABLE_GST_DEBUG */
1005 #ifndef GST_DISABLE_GST_DEBUG
1006 static const gchar *
1007 mixer_ext_flags_get_string (gint flags)
1014 /* first the important ones */
1016 MIXF_MAINVOL, "MAINVOL"}, {
1017 MIXF_PCMVOL, "PCMVOL"}, {
1018 MIXF_RECVOL, "RECVOL"}, {
1019 MIXF_MONVOL, "MONVOL"}, {
1020 MIXF_DESCR, "DESCR"},
1021 /* now the rest in the right order */
1023 MIXF_READABLE, "READABLE"}, {
1024 MIXF_WRITEABLE, "WRITABLE"}, {
1025 MIXF_POLL, "POLL"}, {
1027 MIXF_STRING, "STRING"}, {
1028 MIXF_DYNAMIC, "DYNAMIC"}, {
1029 MIXF_OKFAIL, "OKFAIL"}, {
1030 MIXF_FLAT, "FLAT"}, {
1031 MIXF_LEGACY, "LEGACY"}, {
1032 MIXF_CENTIBEL, "CENTIBEL"}, {
1033 MIXF_DECIBEL, "DECIBEL"}, {
1043 s = g_string_new ("");
1044 for (i = 0; i < G_N_ELEMENTS (all_flags); ++i) {
1045 if ((flags & all_flags[i].flag)) {
1047 g_string_append (s, " | ");
1048 g_string_append (s, all_flags[i].nick);
1049 flags &= ~all_flags[i].flag; /* unset */
1053 /* unknown flags? */
1056 g_string_append (s, " | ");
1057 g_string_append (s, "???");
1060 /* we'll just put it into the global quark table (cheeky, eh?) */
1061 q = g_quark_from_string (s->str);
1062 g_string_free (s, TRUE);
1064 return g_quark_to_string (q);
1066 #endif /* GST_DISABLE_GST_DEBUG */
1068 #ifndef GST_DISABLE_GST_DEBUG
1070 gst_oss4_mixer_control_dump_tree (GstOss4MixerControl * mc, gint depth)
1076 depth = MIN (sizeof (spaces) - 1, depth);
1077 for (i = 0; i < depth; ++i)
1081 GST_LOG ("%s%s (%s)", spaces, mc->mixext.extname,
1082 mixer_ext_type_get_name (mc->mixext.type));
1083 for (c = mc->children; c != NULL; c = c->next) {
1084 GstOss4MixerControl *child_mc = (GstOss4MixerControl *) c->data;
1086 gst_oss4_mixer_control_dump_tree (child_mc, depth + 2);
1089 #endif /* GST_DISABLE_GST_DEBUG */
1092 gst_oss4_mixer_get_controls (GstOss4Mixer * mixer)
1094 GstOss4MixerControl *root_mc = NULL;
1095 oss_mixerinfo mi = { 0, };
1096 GList *controls = NULL;
1100 /* Get info for currently open fd */
1102 if (ioctl (mixer->fd, SNDCTL_MIXERINFO, &mi) == -1)
1105 if (mi.nrext <= 0) {
1106 GST_DEBUG ("mixer %s has no controls", mi.id);
1110 GST_INFO ("Reading controls for mixer %s", mi.id);
1112 for (i = 0; i < mi.nrext; ++i) {
1113 GstOss4MixerControl *mc;
1114 oss_mixext mix_ext = { 0, };
1116 mix_ext.dev = mi.dev;
1119 if (ioctl (mixer->fd, SNDCTL_MIX_EXTINFO, &mix_ext) == -1) {
1120 GST_DEBUG ("SNDCTL_MIX_EXTINFO failed on mixer %s, control %d: %s",
1121 mi.id, i, g_strerror (errno));
1125 /* if this is the last one, save it for is-interface-up-to-date checking */
1127 mixer->last_mixext = mix_ext;
1129 mc = g_new0 (GstOss4MixerControl, 1);
1130 mc->mixext = mix_ext;
1132 /* both control_no and desc fields are pretty useless, ie. not always set,
1133 * if ever, so not listed here */
1134 GST_INFO ("Control %d", mix_ext.ctrl);
1135 GST_INFO (" name : %s", mix_ext.extname);
1136 GST_INFO (" type : %s (%d)", mixer_ext_type_get_name (mix_ext.type),
1138 GST_INFO (" flags : %s (0x%04x)",
1139 mixer_ext_flags_get_string (mix_ext.flags), mix_ext.flags);
1140 GST_INFO (" parent : %d", mix_ext.parent);
1142 if (!MIXEXT_IS_ROOT (mix_ext)) {
1143 /* find parent (we assume it comes in the list before the child) */
1144 for (l = controls; l != NULL; l = l->next) {
1145 GstOss4MixerControl *parent_mc = (GstOss4MixerControl *) l->data;
1147 if (parent_mc->mixext.ctrl == mix_ext.parent) {
1148 mc->parent = parent_mc;
1149 parent_mc->children = g_list_append (parent_mc->children, mc);
1153 if (mc->parent == NULL) {
1154 GST_ERROR_OBJECT (mixer, "couldn't find parent for control %d", i);
1158 } else if (root_mc == NULL) {
1161 GST_WARNING_OBJECT (mixer, "two root controls?!");
1164 controls = g_list_prepend (controls, mc);
1167 #ifndef GST_DISABLE_GST_DEBUG
1168 gst_oss4_mixer_control_dump_tree (root_mc, 0);
1171 return g_list_reverse (controls);
1176 GST_WARNING ("SNDCTL_MIXERINFO failed on mixer device %s: %s", mi.id,
1177 g_strerror (errno));
1183 gst_oss4_mixer_controls_guess_master (GstOss4Mixer * mixer,
1184 const GList * controls)
1186 GstOss4MixerControl *master_mc = NULL;
1189 for (l = controls; l != NULL; l = l->next) {
1190 GstOss4MixerControl *mc = (GstOss4MixerControl *) l->data;
1192 /* do we need to check if it's a slider type here? */
1193 if ((mc->mixext.flags & MIXF_PCMVOL)) {
1194 GST_INFO_OBJECT (mixer, "First PCM control: %s", mc->mixext.extname);
1199 if (((mc->mixext.flags & MIXF_MAINVOL)) && master_mc == NULL) {
1200 GST_INFO_OBJECT (mixer, "First main volume control: %s",
1201 mc->mixext.extname);
1206 if (master_mc != NULL)
1207 master_mc->is_master = TRUE;
1210 /* type: -1 for all types, otherwise just return siblings with requested type */
1212 gst_oss4_mixer_control_get_siblings (GstOss4MixerControl * mc, gint type)
1214 GList *s, *siblings = NULL;
1216 if (mc->parent == NULL)
1219 for (s = mc->parent->children; s != NULL; s = s->next) {
1220 GstOss4MixerControl *sibling = (GstOss4MixerControl *) s->data;
1222 if (mc != sibling && (type < 0 || sibling->mixext.type == type))
1223 siblings = g_list_append (siblings, sibling);
1230 gst_oss4_mixer_controls_find_sliders (GstOss4Mixer * mixer,
1231 const GList * controls)
1235 for (l = controls; l != NULL; l = l->next) {
1236 GstOss4MixerControl *mc = (GstOss4MixerControl *) l->data;
1237 GList *s, *siblings;
1239 if (!MIXEXT_IS_SLIDER (mc->mixext) || mc->parent == NULL || mc->used)
1242 mc->is_slider = TRUE;
1245 siblings = gst_oss4_mixer_control_get_siblings (mc, -1);
1247 /* Note: the names can be misleading and may not reflect the actual
1248 * hierarchy of the controls, e.g. it's possible that a slider is called
1249 * connector.green and the mute control then connector.green.mute, but
1250 * both controls are in fact siblings and both children of the group
1251 * 'green' instead of mute being a child of connector.green as the naming
1252 * would seem to suggest */
1253 GST_LOG ("Slider: %s, parent=%s, %d siblings", mc->mixext.extname,
1254 mc->parent->mixext.extname, g_list_length (siblings));
1256 for (s = siblings; s != NULL; s = s->next) {
1257 GstOss4MixerControl *sibling = (GstOss4MixerControl *) s->data;
1259 GST_LOG (" %s (%s)", sibling->mixext.extname,
1260 mixer_ext_type_get_name (sibling->mixext.type));
1262 if (sibling->mixext.type == MIXT_MUTE ||
1263 g_str_has_suffix (sibling->mixext.extname, ".mute")) {
1264 /* simple case: slider with single mute sibling. We assume the .mute
1265 * suffix in the name won't change - can't really do much else anyway */
1266 if (sibling->mixext.type == MIXT_ONOFF ||
1267 sibling->mixext.type == MIXT_MUTE) {
1268 GST_LOG (" mute control for %s is %s", mc->mixext.extname,
1269 sibling->mixext.extname);
1271 sibling->used = TRUE;
1273 /* a group of .mute controls. We assume they are all switches here */
1274 if (sibling->mixext.type == MIXT_GROUP) {
1277 for (m = sibling->children; m != NULL; m = m->next) {
1278 GstOss4MixerControl *grouped_sibling = m->data;
1280 if (grouped_sibling->mixext.type == MIXT_ONOFF ||
1281 grouped_sibling->mixext.type == MIXT_MUTE) {
1282 GST_LOG (" %s is grouped mute control for %s",
1283 grouped_sibling->mixext.extname, mc->mixext.extname);
1284 mc->mute_group = g_list_append (mc->mute_group, grouped_sibling);
1288 GST_LOG (" %s has a group of %d mute controls",
1289 mc->mixext.extname, g_list_length (mc->mute_group));
1291 /* we don't mark the individual mute controls as used, only the
1292 * group control, as we still want individual switches for the
1293 * individual controls */
1294 sibling->used = TRUE;
1298 g_list_free (siblings);
1302 /* should be called with the mixer object lock held because of the ioctl;
1303 * returns TRUE if the list was read the first time or modified */
1305 gst_oss4_mixer_enum_control_update_enum_list (GstOss4Mixer * mixer,
1306 GstOss4MixerControl * mc)
1308 oss_mixer_enuminfo ei = { 0, };
1309 guint num_existing = 0;
1312 /* count and existing values */
1313 while (mc->enum_vals != NULL && mc->enum_vals[num_existing] != 0)
1316 ei.dev = mc->mixext.dev;
1317 ei.ctrl = mc->mixext.ctrl;
1319 /* if we have create a generic list with numeric IDs already and the
1320 * number of values hasn't changed, then there's not much to do here */
1321 if (mc->no_list && mc->enum_vals != NULL &&
1322 num_existing == mc->mixext.maxvalue) {
1326 /* if we have a list and it doesn't change, there's nothing to do either */
1327 if (mc->enum_vals != NULL && mc->enum_version == 0)
1330 if (ioctl (mixer->fd, SNDCTL_MIX_ENUMINFO, &ei) == -1) {
1331 g_free (mc->enum_vals);
1332 mc->enum_vals = g_new0 (GQuark, mc->mixext.maxvalue + 1);
1334 GST_DEBUG ("no enum info available, creating numeric values from 0-%d",
1335 mc->mixext.maxvalue - 1);
1337 /* "It is possible that some enum controls don't have any name list
1338 * available. In this case the application should automatically generate
1339 * list of numbers (0 to N-1)" */
1340 for (i = 0; i < mc->mixext.maxvalue; ++i) {
1343 g_snprintf (num_str, sizeof (num_str), "%d", i);
1344 mc->enum_vals[i] = g_quark_from_string (num_str);
1346 mc->enum_version = 0; /* the only way to change is via maxvalue */
1348 /* old list same as current list? */
1349 if (mc->enum_vals != NULL && mc->enum_version == ei.version)
1352 /* no list yet, or the list has changed */
1353 GST_LOG ("%s", (mc->enum_vals) ? "enum list has changed" : "reading list");
1354 if (ei.nvalues != mc->mixext.maxvalue) {
1355 GST_WARNING_OBJECT (mixer, "Enum: %s, nvalues %d != maxvalue %d",
1356 mc->mixext.extname, ei.nvalues, mc->mixext.maxvalue);
1357 mc->mixext.maxvalue = MIN (ei.nvalues, mc->mixext.maxvalue);
1360 mc->mixext.maxvalue = MIN (mc->mixext.maxvalue, OSS_ENUM_MAXVALUE);
1362 g_free (mc->enum_vals);
1363 mc->enum_vals = g_new0 (GQuark, mc->mixext.maxvalue + 1);
1364 for (i = 0; i < mc->mixext.maxvalue; ++i) {
1365 GST_LOG (" %s", ei.strings + ei.strindex[i]);
1367 g_quark_from_string (gst_oss4_mixer_control_get_translated_option
1368 (ei.strings + ei.strindex[i]));
1376 gst_oss4_mixer_controls_find_enums (GstOss4Mixer * mixer,
1377 const GList * controls)
1381 for (l = controls; l != NULL; l = l->next) {
1382 GstOss4MixerControl *mc = (GstOss4MixerControl *) l->data;
1384 if (mc->mixext.type != MIXT_ENUM || mc->used)
1390 /* Note: enums are special: for most controls, the maxvalue is inclusive,
1391 * but for enum controls it's actually exclusive (boggle), so that
1392 * mixext.maxvalue = num_values */
1394 GST_LOG ("Enum: %s, parent=%s, num_enums=%d", mc->mixext.extname,
1395 mc->parent->mixext.extname, mc->mixext.maxvalue);
1397 gst_oss4_mixer_enum_control_update_enum_list (mixer, mc);
1402 gst_oss4_mixer_controls_find_switches (GstOss4Mixer * mixer,
1403 const GList * controls)
1407 for (l = controls; l != NULL; l = l->next) {
1408 GstOss4MixerControl *mc = (GstOss4MixerControl *) l->data;
1413 if (mc->mixext.type != MIXT_ONOFF && mc->mixext.type != MIXT_MUTE)
1416 mc->is_switch = TRUE;
1419 GST_LOG ("Switch: %s, parent=%s", mc->mixext.extname,
1420 mc->parent->mixext.extname);
1425 gst_oss4_mixer_controls_find_virtual (GstOss4Mixer * mixer,
1426 const GList * controls)
1430 for (l = controls; l != NULL; l = l->next) {
1431 GstOss4MixerControl *mc = (GstOss4MixerControl *) l->data;
1433 /* or sscanf (mc->mixext.extname, "vmix%d-out.", &n) == 1 ? */
1434 /* for now we just flag all virtual controls with managed labels, those
1435 * are really more appropriate for a pavucontrol-type control thing than
1436 * the (more hardware-oriented) mixer interface */
1437 if (mc->mixext.id[0] == '@') {
1438 mc->is_virtual = TRUE;
1439 GST_LOG ("%s is virtual control with managed label", mc->mixext.extname);
1445 gst_oss4_mixer_controls_dump_unused (GstOss4Mixer * mixer,
1446 const GList * controls)
1450 for (l = controls; l != NULL; l = l->next) {
1451 GstOss4MixerControl *mc = (GstOss4MixerControl *) l->data;
1456 switch (mc->mixext.type) {
1463 case MIXT_STEREOPEAK:
1465 continue; /* not interested in these types of controls */
1468 GST_DEBUG ("obsolete control type %d", mc->mixext.type);
1470 case MIXT_MONOSLIDER:
1471 case MIXT_STEREOSLIDER:
1473 case MIXT_MONOSLIDER16:
1474 case MIXT_STEREOSLIDER16:
1475 /* this shouldn't happen */
1476 GST_ERROR ("unused slider control?!");
1480 /* value entry, not sure what to do with that, skip for now */
1486 case MIXT_RADIOGROUP:
1487 GST_DEBUG ("FIXME: handle %s %s",
1488 mixer_ext_type_get_name (mc->mixext.type), mc->mixext.extname);
1491 GST_WARNING ("unknown control type %d", mc->mixext.type);
1498 gst_oss4_mixer_create_tracks (GstOss4Mixer * mixer, const GList * controls)
1501 GList *tracks = NULL;
1503 for (c = controls; c != NULL; c = c->next) {
1504 GstOss4MixerControl *mc = (GstOss4MixerControl *) c->data;
1505 GstMixerTrack *track = NULL;
1510 if (mc->is_slider) {
1511 track = gst_oss4_mixer_slider_new (mixer, mc);
1512 } else if (mc->is_enum) {
1513 track = gst_oss4_mixer_enum_new (mixer, mc);
1514 } else if (mc->is_switch) {
1515 track = gst_oss4_mixer_switch_new (mixer, mc);
1521 track->label = gst_oss4_mixer_control_get_translated_name (mc);
1524 GST_LOG ("translated label: %s [%s] = %s", track->label, mc->mixext.id,
1527 /* This whole 'a track is either INPUT or OUTPUT' model is just flawed,
1528 * esp. if a slider's role can be changed on the fly, like when you change
1529 * function of a connector. What should we do in that case? Change the flag
1530 * and make the app rebuild the interface? Ignore it? */
1531 if (mc->mixext.flags & (MIXF_MAINVOL | MIXF_PCMVOL)) {
1532 track->flags = GST_MIXER_TRACK_OUTPUT | GST_MIXER_TRACK_WHITELIST;
1534 } else if (mc->mixext.flags & MIXF_RECVOL) {
1535 /* record gain whitelisted by default */
1536 track->flags = GST_MIXER_TRACK_INPUT | GST_MIXER_TRACK_NO_RECORD |
1537 GST_MIXER_TRACK_WHITELIST;
1539 } else if (mc->mixext.flags & MIXF_MONVOL) {
1540 /* monitor sources not whitelisted by default */
1541 track->flags = GST_MIXER_TRACK_INPUT | GST_MIXER_TRACK_NO_RECORD;
1545 * The kernel may give us better clues about the scope of a control.
1546 * If so, try to honor it.
1548 switch (mc->mixext.desc & MIXEXT_SCOPE_MASK) {
1549 case MIXEXT_SCOPE_INPUT:
1550 case MIXEXT_SCOPE_RECSWITCH:
1551 track->flags |= GST_MIXER_TRACK_INPUT | GST_MIXER_TRACK_NO_RECORD |
1552 GST_MIXER_TRACK_WHITELIST;
1554 case MIXEXT_SCOPE_MONITOR:
1555 /* don't whitelist monitor tracks by default */
1556 track->flags |= GST_MIXER_TRACK_INPUT | GST_MIXER_TRACK_NO_RECORD;
1558 case MIXEXT_SCOPE_OUTPUT:
1559 track->flags = GST_MIXER_TRACK_OUTPUT | GST_MIXER_TRACK_WHITELIST;
1563 if (mc->is_master) {
1564 track->flags |= GST_MIXER_TRACK_OUTPUT;
1568 track->flags |= GST_MIXER_TRACK_MASTER;
1570 tracks = g_list_append (tracks, track);
1577 gst_oss4_mixer_update_tracks (GstOss4Mixer * mixer)
1579 GList *controls, *tracks;
1581 /* read and process controls */
1582 controls = gst_oss4_mixer_get_controls (mixer);
1584 gst_oss4_mixer_controls_guess_master (mixer, controls);
1586 gst_oss4_mixer_controls_find_sliders (mixer, controls);
1588 gst_oss4_mixer_controls_find_enums (mixer, controls);
1590 gst_oss4_mixer_controls_find_switches (mixer, controls);
1592 gst_oss4_mixer_controls_find_virtual (mixer, controls);
1594 gst_oss4_mixer_controls_dump_unused (mixer, controls);
1596 tracks = gst_oss4_mixer_create_tracks (mixer, controls);
1598 /* free old tracks and controls */
1599 gst_oss4_mixer_free_tracks (mixer);
1601 /* replace old with new */
1602 mixer->tracks = tracks;
1603 mixer->controls = controls;
1606 static const GList *
1607 gst_oss4_mixer_list_tracks (GstMixer * mixer_iface)
1609 GstOss4Mixer *mixer = GST_OSS4_MIXER (mixer_iface);
1611 g_return_val_if_fail (mixer != NULL, NULL);
1612 g_return_val_if_fail (GST_OSS4_MIXER_IS_OPEN (mixer), NULL);
1614 GST_OBJECT_LOCK (mixer);
1616 /* Do a read on the last control to check if the interface has changed */
1617 if (!mixer->need_update && mixer->last_mixext.ctrl > 0) {
1618 GstOss4MixerControl mc = { {0,}
1623 mc.mixext = mixer->last_mixext;
1624 gst_oss4_mixer_get_control_val (mixer, &mc, &val);
1627 if (mixer->need_update || mixer->tracks == NULL) {
1628 gst_oss4_mixer_update_tracks (mixer);
1629 mixer->need_update = FALSE;
1632 GST_OBJECT_UNLOCK (mixer);
1634 return (const GList *) mixer->tracks;
1638 gst_oss4_mixer_set_volume (GstMixer * mixer, GstMixerTrack * track,
1643 g_return_if_fail (mixer != NULL);
1644 g_return_if_fail (GST_IS_OSS4_MIXER (mixer));
1645 g_return_if_fail (GST_OSS4_MIXER_IS_OPEN (mixer));
1646 g_return_if_fail (gst_oss4_mixer_contains_track (mixer, track));
1647 g_return_if_fail (volumes != NULL);
1649 oss = GST_OSS4_MIXER (mixer);
1651 GST_OBJECT_LOCK (oss);
1653 if (GST_IS_OSS4_MIXER_SLIDER (track)) {
1654 gst_oss4_mixer_slider_set_volume (GST_OSS4_MIXER_SLIDER (track), volumes);
1657 GST_OBJECT_UNLOCK (oss);
1661 gst_oss4_mixer_get_volume (GstMixer * mixer, GstMixerTrack * track,
1666 g_return_if_fail (mixer != NULL);
1667 g_return_if_fail (GST_IS_OSS4_MIXER (mixer));
1668 g_return_if_fail (GST_OSS4_MIXER_IS_OPEN (mixer));
1669 g_return_if_fail (gst_oss4_mixer_contains_track (mixer, track));
1670 g_return_if_fail (volumes != NULL);
1672 oss = GST_OSS4_MIXER (mixer);
1674 GST_OBJECT_LOCK (oss);
1676 memset (volumes, 0, track->num_channels * sizeof (gint));
1678 if (GST_IS_OSS4_MIXER_SWITCH (track)) {
1679 gboolean enabled = FALSE;
1680 gst_oss4_mixer_switch_get (GST_OSS4_MIXER_SWITCH (track), &enabled);
1682 if (GST_IS_OSS4_MIXER_SLIDER (track)) {
1683 gst_oss4_mixer_slider_get_volume (GST_OSS4_MIXER_SLIDER (track), volumes);
1686 GST_OBJECT_UNLOCK (oss);
1690 gst_oss4_mixer_set_record (GstMixer * mixer, GstMixerTrack * track,
1695 g_return_if_fail (mixer != NULL);
1696 g_return_if_fail (GST_IS_OSS4_MIXER (mixer));
1697 g_return_if_fail (GST_OSS4_MIXER_IS_OPEN (mixer));
1698 g_return_if_fail (gst_oss4_mixer_contains_track (mixer, track));
1700 oss = GST_OSS4_MIXER (mixer);
1702 GST_OBJECT_LOCK (oss);
1704 if (GST_IS_OSS4_MIXER_SLIDER (track)) {
1705 gst_oss4_mixer_slider_set_record (GST_OSS4_MIXER_SLIDER (track), record);
1706 } else if (GST_IS_OSS4_MIXER_SWITCH (track)) {
1707 if ((track->flags & GST_MIXER_TRACK_INPUT)) {
1708 gst_oss4_mixer_switch_set (GST_OSS4_MIXER_SWITCH (track), record);
1710 GST_WARNING_OBJECT (track, "set_record called on non-INPUT track");
1714 GST_OBJECT_UNLOCK (oss);
1718 gst_oss4_mixer_set_mute (GstMixer * mixer, GstMixerTrack * track, gboolean mute)
1722 g_return_if_fail (mixer != NULL);
1723 g_return_if_fail (GST_IS_OSS4_MIXER (mixer));
1724 g_return_if_fail (GST_OSS4_MIXER_IS_OPEN (mixer));
1725 g_return_if_fail (gst_oss4_mixer_contains_track (mixer, track));
1727 oss = GST_OSS4_MIXER (mixer);
1729 GST_OBJECT_LOCK (oss);
1731 if (GST_IS_OSS4_MIXER_SLIDER (track)) {
1732 gst_oss4_mixer_slider_set_mute (GST_OSS4_MIXER_SLIDER (track), mute);
1733 } else if (GST_IS_OSS4_MIXER_SWITCH (track)) {
1734 gst_oss4_mixer_switch_set (GST_OSS4_MIXER_SWITCH (track), mute);
1737 GST_OBJECT_UNLOCK (oss);
1741 gst_oss4_mixer_set_option (GstMixer * mixer, GstMixerOptions * options,
1746 g_return_if_fail (mixer != NULL);
1747 g_return_if_fail (value != NULL);
1748 g_return_if_fail (GST_IS_OSS4_MIXER (mixer));
1749 g_return_if_fail (GST_OSS4_MIXER_IS_OPEN (mixer));
1750 g_return_if_fail (GST_IS_OSS4_MIXER_ENUM (options));
1751 g_return_if_fail (gst_oss4_mixer_contains_options (mixer, options));
1753 oss = GST_OSS4_MIXER (mixer);
1755 GST_OBJECT_LOCK (oss);
1757 if (!gst_oss4_mixer_enum_set_option (GST_OSS4_MIXER_ENUM (options), value)) {
1758 /* not much we can do here but wake up the watch thread early, so it
1759 * can do its thing and post messages if anything has changed */
1760 gst_oss4_mixer_wake_up_watch_task (oss);
1763 GST_OBJECT_UNLOCK (oss);
1766 static const gchar *
1767 gst_oss4_mixer_get_option (GstMixer * mixer, GstMixerOptions * options)
1770 const gchar *current_val;
1772 g_return_val_if_fail (mixer != NULL, NULL);
1773 g_return_val_if_fail (GST_IS_OSS4_MIXER (mixer), NULL);
1774 g_return_val_if_fail (GST_OSS4_MIXER_IS_OPEN (mixer), NULL);
1775 g_return_val_if_fail (GST_IS_OSS4_MIXER_ENUM (options), NULL);
1776 g_return_val_if_fail (gst_oss4_mixer_contains_options (mixer, options), NULL);
1778 oss = GST_OSS4_MIXER (mixer);
1780 GST_OBJECT_LOCK (oss);
1782 current_val = gst_oss4_mixer_enum_get_option (GST_OSS4_MIXER_ENUM (options));
1784 if (current_val == NULL) {
1785 /* not much we can do here but wake up the watch thread early, so it
1786 * can do its thing and post messages if anything has changed */
1787 gst_oss4_mixer_wake_up_watch_task (oss);
1790 GST_OBJECT_UNLOCK (oss);
1795 static GstMixerFlags
1796 gst_oss4_mixer_get_mixer_flags (GstMixer * mixer)
1798 return GST_MIXER_FLAG_AUTO_NOTIFICATIONS | GST_MIXER_FLAG_HAS_WHITELIST |
1799 GST_MIXER_FLAG_GROUPING;
1803 gst_oss4_mixer_interface_init (GstMixerClass * klass)
1805 GST_MIXER_TYPE (klass) = GST_MIXER_HARDWARE;
1807 klass->list_tracks = gst_oss4_mixer_list_tracks;
1808 klass->set_volume = gst_oss4_mixer_set_volume;
1809 klass->get_volume = gst_oss4_mixer_get_volume;
1810 klass->set_mute = gst_oss4_mixer_set_mute;
1811 klass->set_record = gst_oss4_mixer_set_record;
1812 klass->set_option = gst_oss4_mixer_set_option;
1813 klass->get_option = gst_oss4_mixer_get_option;
1814 klass->get_mixer_flags = gst_oss4_mixer_get_mixer_flags;
1817 /* Implement the horror that is GstImplementsInterface */
1820 gst_oss4_mixer_supported (GstImplementsInterface * iface, GType iface_type)
1822 GstOss4Mixer *mixer;
1824 g_return_val_if_fail (iface_type == GST_TYPE_MIXER, FALSE);
1826 mixer = GST_OSS4_MIXER (iface);
1828 return GST_OSS4_MIXER_IS_OPEN (mixer);
1832 gst_oss4_mixer_implements_interface_init (GstImplementsInterfaceClass * klass)
1834 klass->supported = gst_oss4_mixer_supported;
1838 gst_oss4_mixer_init_interfaces (GType type)
1840 static const GInterfaceInfo implements_iface_info = {
1841 (GInterfaceInitFunc) gst_oss4_mixer_implements_interface_init,
1845 static const GInterfaceInfo mixer_iface_info = {
1846 (GInterfaceInitFunc) gst_oss4_mixer_interface_init,
1851 g_type_add_interface_static (type, GST_TYPE_IMPLEMENTS_INTERFACE,
1852 &implements_iface_info);
1853 g_type_add_interface_static (type, GST_TYPE_MIXER, &mixer_iface_info);
1855 gst_oss4_add_property_probe_interface (type);