2 * This file is part of DisOrder
3 * Copyright (C) 2007, 2008 Richard Kettlewell
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
20 /** @file lib/mixer-alsa.c
21 * @brief ALSA mixer support
23 * The documentation for ALSA's mixer support is completely hopeless,
24 * which is a particular nuisnace given it's got an incredibly verbose
25 * API. Much of this code is cribbed from
26 * alsa-utils-1.0.13/amixer/amixer.c.
28 * Mono output devices are supported, but the support is not tested
34 #if HAVE_ALSA_ASOUNDLIB_H
41 #include <sys/ioctl.h>
42 #include <alsa/asoundlib.h>
44 #include "configuration.h"
49 /** @brief Shared state for ALSA mixer support */
50 struct alsa_mixer_state {
51 /** @brief Mixer handle */
54 /** @brief Mixer control */
55 snd_mixer_elem_t *elem;
57 /** @brief Left channel */
58 snd_mixer_selem_channel_id_t left;
60 /** @brief Right channel */
61 snd_mixer_selem_channel_id_t right;
63 /** @brief Minimum level */
66 /** @brief Maximum level */
70 /** @brief Destroy a @ref alsa_mixer_state */
71 static void alsa_close(struct alsa_mixer_state *h) {
74 snd_mixer_close(h->handle);
77 /** @brief Initialize a @ref alsa_mixer_state */
78 static int alsa_open(struct alsa_mixer_state *h) {
80 snd_mixer_selem_id_t *id;
82 snd_mixer_selem_id_alloca(&id);
83 memset(h, 0, sizeof h);
84 if((err = snd_mixer_open(&h->handle, 0))) {
85 error(0, "snd_mixer_open: %s", snd_strerror(err));
88 if((err = snd_mixer_attach(h->handle, config->device))) {
89 error(0, "snd_mixer_attach %s: %s",
90 config->device, snd_strerror(err));
93 if((err = snd_mixer_selem_register(h->handle, 0/*options*/, 0/*classp*/))) {
94 error(0, "snd_mixer_selem_register %s: %s",
95 config->device, snd_strerror(err));
98 if((err = snd_mixer_load(h->handle))) {
99 error(0, "snd_mixer_load %s: %s",
100 config->device, snd_strerror(err));
103 snd_mixer_selem_id_set_name(id, config->channel);
104 snd_mixer_selem_id_set_index(id, atoi(config->mixer));
105 if(!(h->elem = snd_mixer_find_selem(h->handle, id))) {
106 error(0, "device '%s' mixer control '%s,%s' does not exist",
107 config->device, config->channel, config->mixer);
110 if(!snd_mixer_selem_has_playback_volume(h->elem)) {
111 error(0, "device '%s' mixer control '%s,%s' has no playback volume",
112 config->device, config->channel, config->mixer);
115 if(snd_mixer_selem_is_playback_mono(h->elem)) {
116 h->left = h->right = SND_MIXER_SCHN_MONO;
118 h->left = SND_MIXER_SCHN_FRONT_LEFT;
119 h->right = SND_MIXER_SCHN_FRONT_RIGHT;
121 if(!snd_mixer_selem_has_playback_channel(h->elem, h->left)
122 || !snd_mixer_selem_has_playback_channel(h->elem, h->right)) {
123 error(0, "device '%s' mixer control '%s,%s' lacks required playback channels",
124 config->device, config->channel, config->mixer);
127 snd_mixer_selem_get_playback_volume_range(h->elem, &h->min, &h->max);
134 /** @brief Convert a level to a percentage */
135 static int to_percent(const struct alsa_mixer_state *h, long n) {
136 return (n - h->min) * 100 / (h->max - h->min);
139 /** @brief Get ALSA volume */
140 static int alsa_get(int *left, int *right) {
141 struct alsa_mixer_state h[1];
147 if((err = snd_mixer_selem_get_playback_volume(h->elem, h->left, &l))
148 || (err = snd_mixer_selem_get_playback_volume(h->elem, h->right, &r))) {
149 error(0, "snd_mixer_selem_get_playback_volume: %s", snd_strerror(err));
152 *left = to_percent(h, l);
153 *right = to_percent(h, r);
161 /** @brief Convert a percentage to a level */
162 static int from_percent(const struct alsa_mixer_state *h, int n) {
163 return h->min + n * (h->max - h->min) / 100;
166 /** @brief Set ALSA volume */
167 static int alsa_set(int *left, int *right) {
168 struct alsa_mixer_state h[1];
175 if(h->left == h->right) {
176 /* Mono output - just use the loudest */
177 if((err = snd_mixer_selem_set_playback_volume
179 from_percent(h, *left > *right ? *left : *right)))) {
180 error(0, "snd_mixer_selem_set_playback_volume: %s", snd_strerror(err));
185 if((err = snd_mixer_selem_set_playback_volume
186 (h->elem, h->left, from_percent(h, *left)))
187 || (err = snd_mixer_selem_set_playback_volume
188 (h->elem, h->right, from_percent(h, *right)))) {
189 error(0, "snd_mixer_selem_set_playback_volume: %s", snd_strerror(err));
193 /* Read it back to see what we ended up at */
194 if((err = snd_mixer_selem_get_playback_volume(h->elem, h->left, &l))
195 || (err = snd_mixer_selem_get_playback_volume(h->elem, h->right, &r))) {
196 error(0, "snd_mixer_selem_get_playback_volume: %s", snd_strerror(err));
199 *left = to_percent(h, l);
200 *right = to_percent(h, r);
208 /** @brief ALSA mixer vtable */
209 const struct mixer mixer_alsa = {