4 This file is part of PulseAudio.
6 PulseAudio is free software; you can redistribute it and/or modify
7 it under the terms of the GNU Lesser General Public License as published
8 by the Free Software Foundation; either version 2 of the License,
9 or (at your option) any later version.
11 PulseAudio is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with PulseAudio; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
29 #ifdef HAVE_SYS_POLL_H
35 #include <asoundlib.h>
37 #include <pulse/xmalloc.h>
39 #include <pulsecore/core.h>
40 #include <pulsecore/module.h>
41 #include <pulsecore/memchunk.h>
42 #include <pulsecore/sink.h>
43 #include <pulsecore/modargs.h>
44 #include <pulsecore/core-util.h>
45 #include <pulsecore/sample-util.h>
46 #include <pulsecore/log.h>
48 #include "alsa-util.h"
49 #include "module-alsa-sink-symdef.h"
51 PA_MODULE_AUTHOR("Lennart Poettering")
52 PA_MODULE_DESCRIPTION("ALSA Sink")
53 PA_MODULE_VERSION(PACKAGE_VERSION)
55 "sink_name=<name for the sink> "
56 "device=<ALSA device> "
57 "format=<sample format> "
58 "channels=<number of channels> "
60 "fragments=<number of fragments> "
61 "fragment_size=<fragment size> "
62 "channel_map=<channel map>")
65 snd_pcm_t *pcm_handle;
66 snd_mixer_t *mixer_handle;
67 snd_mixer_elem_t *mixer_elem;
69 struct pa_alsa_fdlist *pcm_fdl;
70 struct pa_alsa_fdlist *mixer_fdl;
71 long hw_volume_max, hw_volume_min;
73 size_t frame_size, fragment_size;
74 pa_memchunk memchunk, silence;
78 static const char* const valid_modargs[] = {
90 #define DEFAULT_SINK_NAME "alsa_output"
91 #define DEFAULT_DEVICE "default"
93 static void update_usage(struct userdata *u) {
94 pa_module_set_used(u->module,
95 (u->sink ? pa_idxset_size(u->sink->inputs) : 0) +
96 (u->sink ? pa_idxset_size(u->sink->monitor_source->outputs) : 0));
99 static void clear_up(struct userdata *u) {
103 pa_sink_disconnect(u->sink);
104 pa_sink_unref(u->sink);
109 pa_alsa_fdlist_free(u->pcm_fdl);
111 pa_alsa_fdlist_free(u->mixer_fdl);
113 u->pcm_fdl = u->mixer_fdl = NULL;
115 if (u->mixer_handle) {
116 snd_mixer_close(u->mixer_handle);
117 u->mixer_handle = NULL;
121 snd_pcm_drop(u->pcm_handle);
122 snd_pcm_close(u->pcm_handle);
123 u->pcm_handle = NULL;
127 static int xrun_recovery(struct userdata *u) {
131 pa_log_info(__FILE__": *** ALSA-XRUN (playback) ***");
133 if ((ret = snd_pcm_prepare(u->pcm_handle)) < 0) {
134 pa_log(__FILE__": snd_pcm_prepare() failed: %s", snd_strerror(-ret));
137 pa_module_unload_request(u->module);
144 static void do_write(struct userdata *u) {
150 pa_memchunk *memchunk = NULL;
151 snd_pcm_sframes_t frames;
153 if (u->memchunk.memblock)
154 memchunk = &u->memchunk;
156 if (pa_sink_render(u->sink, u->fragment_size, &u->memchunk) < 0)
157 memchunk = &u->silence;
159 memchunk = &u->memchunk;
162 assert(memchunk->memblock && memchunk->memblock->data && memchunk->length && memchunk->memblock->length && (memchunk->length % u->frame_size) == 0);
164 if ((frames = snd_pcm_writei(u->pcm_handle, (uint8_t*) memchunk->memblock->data + memchunk->index, memchunk->length / u->frame_size)) < 0) {
165 if (frames == -EAGAIN)
168 if (frames == -EPIPE) {
169 if (xrun_recovery(u) < 0)
175 pa_log(__FILE__": snd_pcm_writei() failed: %s", snd_strerror(-frames));
178 pa_module_unload_request(u->module);
182 if (memchunk == &u->memchunk) {
183 size_t l = frames * u->frame_size;
184 memchunk->index += l;
185 memchunk->length -= l;
187 if (memchunk->length == 0) {
188 pa_memblock_unref(memchunk->memblock);
189 memchunk->memblock = NULL;
190 memchunk->index = memchunk->length = 0;
198 static void fdl_callback(void *userdata) {
199 struct userdata *u = userdata;
202 if (snd_pcm_state(u->pcm_handle) == SND_PCM_STATE_XRUN)
203 if (xrun_recovery(u) < 0)
209 static int mixer_callback(snd_mixer_elem_t *elem, unsigned int mask) {
210 struct userdata *u = snd_mixer_elem_get_callback_private(elem);
212 assert(u && u->mixer_handle);
214 if (mask == SND_CTL_EVENT_MASK_REMOVE)
217 if (mask & SND_CTL_EVENT_MASK_VALUE) {
218 if (u->sink->get_hw_volume)
219 u->sink->get_hw_volume(u->sink);
220 if (u->sink->get_hw_mute)
221 u->sink->get_hw_mute(u->sink);
222 pa_subscription_post(u->sink->core,
223 PA_SUBSCRIPTION_EVENT_SINK|PA_SUBSCRIPTION_EVENT_CHANGE,
230 static pa_usec_t sink_get_latency_cb(pa_sink *s) {
232 struct userdata *u = s->userdata;
233 snd_pcm_sframes_t frames;
236 assert(s && u && u->sink);
238 if ((err = snd_pcm_delay(u->pcm_handle, &frames)) < 0) {
239 pa_log(__FILE__": failed to get delay: %s", snd_strerror(err));
240 s->get_latency = NULL;
247 r += pa_bytes_to_usec(frames * u->frame_size, &s->sample_spec);
249 if (u->memchunk.memblock)
250 r += pa_bytes_to_usec(u->memchunk.length, &s->sample_spec);
255 static int sink_get_hw_volume_cb(pa_sink *s) {
256 struct userdata *u = s->userdata;
261 assert(u->mixer_elem);
263 for (i = 0; i < s->hw_volume.channels; i++) {
266 assert(snd_mixer_selem_has_playback_channel(u->mixer_elem, i));
268 if ((err = snd_mixer_selem_get_playback_volume(u->mixer_elem, i, &vol)) < 0)
271 set_vol = (long) roundf(((float) s->hw_volume.values[i] * (u->hw_volume_max - u->hw_volume_min)) / PA_VOLUME_NORM) + u->hw_volume_min;
273 /* Try to avoid superfluous volume changes */
275 s->hw_volume.values[i] = (pa_volume_t) roundf(((float) (vol - u->hw_volume_min) * PA_VOLUME_NORM) / (u->hw_volume_max - u->hw_volume_min));
281 pa_log_error(__FILE__": Unable to read volume: %s", snd_strerror(err));
282 s->get_hw_volume = NULL;
283 s->set_hw_volume = NULL;
287 static int sink_set_hw_volume_cb(pa_sink *s) {
288 struct userdata *u = s->userdata;
294 assert(u->mixer_elem);
296 for (i = 0; i < s->hw_volume.channels; i++) {
299 assert(snd_mixer_selem_has_playback_channel(u->mixer_elem, i));
301 vol = s->hw_volume.values[i];
303 if (vol > PA_VOLUME_NORM)
304 vol = PA_VOLUME_NORM;
306 alsa_vol = (long) roundf(((float) vol * (u->hw_volume_max - u->hw_volume_min)) / PA_VOLUME_NORM) + u->hw_volume_min;
308 if ((err = snd_mixer_selem_set_playback_volume(u->mixer_elem, i, alsa_vol)) < 0)
315 pa_log_error(__FILE__": Unable to set volume: %s", snd_strerror(err));
316 s->get_hw_volume = NULL;
317 s->set_hw_volume = NULL;
321 static int sink_get_hw_mute_cb(pa_sink *s) {
322 struct userdata *u = s->userdata;
325 assert(u && u->mixer_elem);
327 err = snd_mixer_selem_get_playback_switch(u->mixer_elem, 0, &sw);
329 pa_log_error(__FILE__": Unable to get switch: %s", snd_strerror(err));
330 s->get_hw_mute = NULL;
331 s->set_hw_mute = NULL;
340 static int sink_set_hw_mute_cb(pa_sink *s) {
341 struct userdata *u = s->userdata;
344 assert(u && u->mixer_elem);
346 err = snd_mixer_selem_set_playback_switch_all(u->mixer_elem, !s->hw_muted);
348 pa_log_error(__FILE__": Unable to set switch: %s", snd_strerror(err));
349 s->get_hw_mute = NULL;
350 s->set_hw_mute = NULL;
357 int pa__init(pa_core *c, pa_module*m) {
358 pa_modargs *ma = NULL;
360 struct userdata *u = NULL;
364 uint32_t periods, fragsize;
365 snd_pcm_uframes_t period_size;
367 snd_pcm_info_t *pcm_info = NULL;
370 if (!(ma = pa_modargs_new(m->argument, valid_modargs))) {
371 pa_log(__FILE__": failed to parse module arguments");
375 ss = c->default_sample_spec;
376 if (pa_modargs_get_sample_spec_and_channel_map(ma, &ss, &map, PA_CHANNEL_MAP_ALSA) < 0) {
377 pa_log(__FILE__": failed to parse sample specification and channel map");
381 frame_size = pa_frame_size(&ss);
383 /* Fix latency to 100ms */
385 fragsize = pa_bytes_per_second(&ss)/128;
387 if (pa_modargs_get_value_u32(ma, "fragments", &periods) < 0 || pa_modargs_get_value_u32(ma, "fragment_size", &fragsize) < 0) {
388 pa_log(__FILE__": failed to parse buffer metrics");
391 period_size = fragsize/frame_size;
393 u = pa_xnew0(struct userdata, 1);
397 snd_config_update_free_global();
398 if ((err = snd_pcm_open(&u->pcm_handle, dev = pa_modargs_get_value(ma, "device", DEFAULT_DEVICE), SND_PCM_STREAM_PLAYBACK, SND_PCM_NONBLOCK)) < 0) {
399 pa_log(__FILE__": Error opening PCM device %s: %s", dev, snd_strerror(err));
403 if ((err = snd_pcm_info_malloc(&pcm_info)) < 0 ||
404 (err = snd_pcm_info(u->pcm_handle, pcm_info)) < 0) {
405 pa_log(__FILE__": Error fetching PCM info: %s", snd_strerror(err));
409 if ((err = pa_alsa_set_hw_params(u->pcm_handle, &ss, &periods, &period_size)) < 0) {
410 pa_log(__FILE__": Failed to set hardware parameters: %s", snd_strerror(err));
414 if (ss.channels != map.channels)
415 /* Seems ALSA didn't like the channel number, so let's fix the channel map */
416 pa_channel_map_init_auto(&map, ss.channels, PA_CHANNEL_MAP_ALSA);
418 if ((err = snd_mixer_open(&u->mixer_handle, 0)) < 0) {
419 pa_log(__FILE__": Error opening mixer: %s", snd_strerror(err));
423 if ((pa_alsa_prepare_mixer(u->mixer_handle, dev) < 0) ||
424 !(u->mixer_elem = pa_alsa_find_elem(u->mixer_handle, "PCM", "Master"))) {
425 snd_mixer_close(u->mixer_handle);
426 u->mixer_handle = NULL;
429 if (!(u->sink = pa_sink_new(c, __FILE__, pa_modargs_get_value(ma, "sink_name", DEFAULT_SINK_NAME), 0, &ss, &map))) {
430 pa_log(__FILE__": Failed to create sink object");
434 u->sink->is_hardware = 1;
435 u->sink->get_latency = sink_get_latency_cb;
436 if (u->mixer_handle) {
437 assert(u->mixer_elem);
438 if (snd_mixer_selem_has_playback_volume(u->mixer_elem)) {
441 for (i = 0;i < ss.channels;i++) {
442 if (!snd_mixer_selem_has_playback_channel(u->mixer_elem, i))
446 if (i == ss.channels) {
447 u->sink->get_hw_volume = sink_get_hw_volume_cb;
448 u->sink->set_hw_volume = sink_set_hw_volume_cb;
449 snd_mixer_selem_get_playback_volume_range(
450 u->mixer_elem, &u->hw_volume_min, &u->hw_volume_max);
453 if (snd_mixer_selem_has_playback_switch(u->mixer_elem)) {
454 u->sink->get_hw_mute = sink_get_hw_mute_cb;
455 u->sink->set_hw_mute = sink_set_hw_mute_cb;
458 u->sink->userdata = u;
459 pa_sink_set_owner(u->sink, m);
460 u->sink->description = pa_sprintf_malloc("ALSA PCM on %s (%s)", dev, snd_pcm_info_get_name(pcm_info));
462 u->pcm_fdl = pa_alsa_fdlist_new();
464 if (pa_alsa_fdlist_init_pcm(u->pcm_fdl, u->pcm_handle, c->mainloop, fdl_callback, u) < 0) {
465 pa_log(__FILE__": failed to initialise file descriptor monitoring");
469 if (u->mixer_handle) {
470 u->mixer_fdl = pa_alsa_fdlist_new();
471 assert(u->mixer_fdl);
472 if (pa_alsa_fdlist_init_mixer(u->mixer_fdl, u->mixer_handle, c->mainloop) < 0) {
473 pa_log(__FILE__": failed to initialise file descriptor monitoring");
476 snd_mixer_elem_set_callback(u->mixer_elem, mixer_callback);
477 snd_mixer_elem_set_callback_private(u->mixer_elem, u);
481 u->frame_size = frame_size;
482 u->fragment_size = period_size * frame_size;
484 pa_log_info(__FILE__": using %u fragments of size %lu bytes.", periods, (long unsigned)u->fragment_size);
486 u->silence.memblock = pa_memblock_new(u->silence.length = u->fragment_size, c->memblock_stat);
487 assert(u->silence.memblock);
488 pa_silence_memblock(u->silence.memblock, &ss);
489 u->silence.index = 0;
491 u->memchunk.memblock = NULL;
492 u->memchunk.index = u->memchunk.length = 0;
496 /* Get initial mixer settings */
497 if (u->sink->get_hw_volume)
498 u->sink->get_hw_volume(u->sink);
499 if (u->sink->get_hw_mute)
500 u->sink->get_hw_mute(u->sink);
507 snd_pcm_info_free(pcm_info);
519 void pa__done(pa_core *c, pa_module*m) {
523 if (!(u = m->userdata))
528 if (u->memchunk.memblock)
529 pa_memblock_unref(u->memchunk.memblock);
530 if (u->silence.memblock)
531 pa_memblock_unref(u->silence.memblock);