2 This file is part of PulseAudio.
4 Copyright 2004-2006 Lennart Poettering
5 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
7 PulseAudio is free software; you can redistribute it and/or modify
8 it under the terms of the GNU Lesser General Public License as published
9 by the Free Software Foundation; either version 2 of the License,
10 or (at your option) any later version.
12 PulseAudio is distributed in the hope that it will be useful, but
13 WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 General Public License for more details.
17 You should have received a copy of the GNU Lesser General Public License
18 along with PulseAudio; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
27 #include <sys/types.h>
29 #include <asoundlib.h>
31 #include <pulse/sample.h>
32 #include <pulse/xmalloc.h>
34 #include <pulsecore/log.h>
35 #include <pulsecore/macro.h>
36 #include <pulsecore/core-util.h>
37 #include <pulsecore/atomic.h>
39 #include "alsa-util.h"
41 struct pa_alsa_fdlist
{
44 /* This is a temporary buffer used to avoid lots of mallocs */
45 struct pollfd
*work_fds
;
50 pa_defer_event
*defer
;
55 void (*cb
)(void *userdata
);
59 static void io_cb(pa_mainloop_api
*a
, pa_io_event
* e
, int fd
, pa_io_event_flags_t events
, void *userdata
) {
61 struct pa_alsa_fdlist
*fdl
= userdata
;
63 unsigned short revents
;
67 pa_assert(fdl
->mixer
);
69 pa_assert(fdl
->work_fds
);
76 memcpy(fdl
->work_fds
, fdl
->fds
, sizeof(struct pollfd
) * fdl
->num_fds
);
78 for (i
= 0;i
< fdl
->num_fds
; i
++) {
79 if (e
== fdl
->ios
[i
]) {
80 if (events
& PA_IO_EVENT_INPUT
)
81 fdl
->work_fds
[i
].revents
|= POLLIN
;
82 if (events
& PA_IO_EVENT_OUTPUT
)
83 fdl
->work_fds
[i
].revents
|= POLLOUT
;
84 if (events
& PA_IO_EVENT_ERROR
)
85 fdl
->work_fds
[i
].revents
|= POLLERR
;
86 if (events
& PA_IO_EVENT_HANGUP
)
87 fdl
->work_fds
[i
].revents
|= POLLHUP
;
92 pa_assert(i
!= fdl
->num_fds
);
94 if ((err
= snd_mixer_poll_descriptors_revents(fdl
->mixer
, fdl
->work_fds
, fdl
->num_fds
, &revents
)) < 0) {
95 pa_log_error("Unable to get poll revent: %s", snd_strerror(err
));
99 a
->defer_enable(fdl
->defer
, 1);
102 snd_mixer_handle_events(fdl
->mixer
);
105 static void defer_cb(pa_mainloop_api
*a
, pa_defer_event
* e
, void *userdata
) {
106 struct pa_alsa_fdlist
*fdl
= userdata
;
112 pa_assert(fdl
->mixer
);
114 a
->defer_enable(fdl
->defer
, 0);
116 num_fds
= snd_mixer_poll_descriptors_count(fdl
->mixer
);
117 pa_assert(num_fds
> 0);
119 if (num_fds
!= fdl
->num_fds
) {
123 pa_xfree(fdl
->work_fds
);
124 fdl
->fds
= pa_xnew0(struct pollfd
, num_fds
);
125 fdl
->work_fds
= pa_xnew(struct pollfd
, num_fds
);
128 memset(fdl
->work_fds
, 0, sizeof(struct pollfd
) * num_fds
);
130 if ((err
= snd_mixer_poll_descriptors(fdl
->mixer
, fdl
->work_fds
, num_fds
)) < 0) {
131 pa_log_error("Unable to get poll descriptors: %s", snd_strerror(err
));
137 if (memcmp(fdl
->fds
, fdl
->work_fds
, sizeof(struct pollfd
) * num_fds
) == 0)
141 for (i
= 0; i
< fdl
->num_fds
; i
++)
142 a
->io_free(fdl
->ios
[i
]);
144 if (num_fds
!= fdl
->num_fds
) {
151 fdl
->ios
= pa_xnew(pa_io_event
*, num_fds
);
154 temp
= fdl
->work_fds
;
155 fdl
->work_fds
= fdl
->fds
;
158 fdl
->num_fds
= num_fds
;
160 for (i
= 0;i
< num_fds
;i
++)
161 fdl
->ios
[i
] = a
->io_new(a
, fdl
->fds
[i
].fd
,
162 ((fdl
->fds
[i
].events
& POLLIN
) ? PA_IO_EVENT_INPUT
: 0) |
163 ((fdl
->fds
[i
].events
& POLLOUT
) ? PA_IO_EVENT_OUTPUT
: 0),
167 struct pa_alsa_fdlist
*pa_alsa_fdlist_new(void) {
168 struct pa_alsa_fdlist
*fdl
;
170 fdl
= pa_xnew0(struct pa_alsa_fdlist
, 1);
174 fdl
->work_fds
= NULL
;
184 void pa_alsa_fdlist_free(struct pa_alsa_fdlist
*fdl
) {
189 fdl
->m
->defer_free(fdl
->defer
);
195 for (i
= 0;i
< fdl
->num_fds
;i
++)
196 fdl
->m
->io_free(fdl
->ios
[i
]);
203 pa_xfree(fdl
->work_fds
);
208 int pa_alsa_fdlist_set_mixer(struct pa_alsa_fdlist
*fdl
, snd_mixer_t
*mixer_handle
, pa_mainloop_api
* m
) {
210 pa_assert(mixer_handle
);
214 fdl
->mixer
= mixer_handle
;
216 fdl
->defer
= m
->defer_new(m
, defer_cb
, fdl
);
221 static int set_format(snd_pcm_t
*pcm_handle
, snd_pcm_hw_params_t
*hwparams
, pa_sample_format_t
*f
) {
223 static const snd_pcm_format_t format_trans
[] = {
224 [PA_SAMPLE_U8
] = SND_PCM_FORMAT_U8
,
225 [PA_SAMPLE_ALAW
] = SND_PCM_FORMAT_A_LAW
,
226 [PA_SAMPLE_ULAW
] = SND_PCM_FORMAT_MU_LAW
,
227 [PA_SAMPLE_S16LE
] = SND_PCM_FORMAT_S16_LE
,
228 [PA_SAMPLE_S16BE
] = SND_PCM_FORMAT_S16_BE
,
229 [PA_SAMPLE_FLOAT32LE
] = SND_PCM_FORMAT_FLOAT_LE
,
230 [PA_SAMPLE_FLOAT32BE
] = SND_PCM_FORMAT_FLOAT_BE
,
231 [PA_SAMPLE_S32LE
] = SND_PCM_FORMAT_S32_LE
,
232 [PA_SAMPLE_S32BE
] = SND_PCM_FORMAT_S32_BE
,
235 static const pa_sample_format_t try_order
[] = {
250 pa_assert(pcm_handle
);
253 if ((ret
= snd_pcm_hw_params_set_format(pcm_handle
, hwparams
, format_trans
[*f
])) >= 0)
256 if (*f
== PA_SAMPLE_FLOAT32BE
)
257 *f
= PA_SAMPLE_FLOAT32LE
;
258 else if (*f
== PA_SAMPLE_FLOAT32LE
)
259 *f
= PA_SAMPLE_FLOAT32BE
;
260 else if (*f
== PA_SAMPLE_S16BE
)
261 *f
= PA_SAMPLE_S16LE
;
262 else if (*f
== PA_SAMPLE_S16LE
)
263 *f
= PA_SAMPLE_S16BE
;
264 else if (*f
== PA_SAMPLE_S32BE
)
265 *f
= PA_SAMPLE_S32LE
;
266 else if (*f
== PA_SAMPLE_S32LE
)
267 *f
= PA_SAMPLE_S32BE
;
271 if ((ret
= snd_pcm_hw_params_set_format(pcm_handle
, hwparams
, format_trans
[*f
])) >= 0)
276 for (i
= 0; try_order
[i
] != PA_SAMPLE_INVALID
; i
++) {
279 if ((ret
= snd_pcm_hw_params_set_format(pcm_handle
, hwparams
, format_trans
[*f
])) >= 0)
286 /* Set the hardware parameters of the given ALSA device. Returns the
287 * selected fragment settings in *period and *period_size */
288 int pa_alsa_set_hw_params(
289 snd_pcm_t
*pcm_handle
,
292 snd_pcm_uframes_t
*period_size
,
293 snd_pcm_uframes_t tsched_size
,
295 pa_bool_t
*use_tsched
,
296 pa_bool_t require_exact_channel_number
) {
299 snd_pcm_uframes_t _period_size
= *period_size
;
300 unsigned int _periods
= *periods
;
301 snd_pcm_uframes_t buffer_size
;
302 unsigned int r
= ss
->rate
;
303 unsigned int c
= ss
->channels
;
304 pa_sample_format_t f
= ss
->format
;
305 snd_pcm_hw_params_t
*hwparams
;
306 pa_bool_t _use_mmap
= use_mmap
&& *use_mmap
;
307 pa_bool_t _use_tsched
= use_tsched
&& *use_tsched
;
310 pa_assert(pcm_handle
);
313 pa_assert(period_size
);
315 snd_pcm_hw_params_alloca(&hwparams
);
317 if ((ret
= snd_pcm_hw_params_any(pcm_handle
, hwparams
)) < 0)
320 if ((ret
= snd_pcm_hw_params_set_rate_resample(pcm_handle
, hwparams
, 0)) < 0)
324 if ((ret
= snd_pcm_hw_params_set_access(pcm_handle
, hwparams
, SND_PCM_ACCESS_MMAP_INTERLEAVED
)) < 0) {
326 /* mmap() didn't work, fall back to interleaved */
328 if ((ret
= snd_pcm_hw_params_set_access(pcm_handle
, hwparams
, SND_PCM_ACCESS_RW_INTERLEAVED
)) < 0)
334 } else if ((ret
= snd_pcm_hw_params_set_access(pcm_handle
, hwparams
, SND_PCM_ACCESS_RW_INTERLEAVED
)) < 0)
340 if ((ret
= set_format(pcm_handle
, hwparams
, &f
)) < 0)
343 if ((ret
= snd_pcm_hw_params_set_rate_near(pcm_handle
, hwparams
, &r
, NULL
)) < 0)
346 /* Adjust the buffer sizes, if we didn't get the rate we were asking for */
347 _period_size
= (snd_pcm_uframes_t
) (((uint64_t) _period_size
* r
) / ss
->rate
);
348 tsched_size
= (snd_pcm_uframes_t
) (((uint64_t) tsched_size
* r
) / ss
->rate
);
350 if (require_exact_channel_number
) {
351 if ((ret
= snd_pcm_hw_params_set_channels(pcm_handle
, hwparams
, c
)) < 0)
354 if ((ret
= snd_pcm_hw_params_set_channels_near(pcm_handle
, hwparams
, &c
)) < 0)
359 _period_size
= tsched_size
;
362 pa_assert_se(snd_pcm_hw_params_get_buffer_size_max(hwparams
, &buffer_size
) == 0);
363 pa_log_debug("Maximum hw buffer size is %u ms", (unsigned) buffer_size
* 1000 / r
);
366 buffer_size
= _periods
* _period_size
;
368 if ((ret
= snd_pcm_hw_params_set_periods_integer(pcm_handle
, hwparams
)) < 0)
373 if ((ret
= snd_pcm_hw_params_set_periods_near(pcm_handle
, hwparams
, &_periods
, &dir
)) < 0) {
375 if ((ret
= snd_pcm_hw_params_set_periods_near(pcm_handle
, hwparams
, &_periods
, &dir
)) < 0)
380 if (_period_size
> 0)
381 if ((ret
= snd_pcm_hw_params_set_buffer_size_near(pcm_handle
, hwparams
, &buffer_size
)) < 0)
384 if ((ret
= snd_pcm_hw_params(pcm_handle
, hwparams
)) < 0)
388 pa_log_warn("Device %s doesn't support %u Hz, changed to %u Hz.", snd_pcm_name(pcm_handle
), ss
->rate
, r
);
390 if (ss
->channels
!= c
)
391 pa_log_warn("Device %s doesn't support %u channels, changed to %u.", snd_pcm_name(pcm_handle
), ss
->channels
, c
);
394 pa_log_warn("Device %s doesn't support sample format %s, changed to %s.", snd_pcm_name(pcm_handle
), pa_sample_format_to_string(ss
->format
), pa_sample_format_to_string(f
));
396 if ((ret
= snd_pcm_prepare(pcm_handle
)) < 0)
399 if ((ret
= snd_pcm_hw_params_get_period_size(hwparams
, &_period_size
, &dir
)) < 0 ||
400 (ret
= snd_pcm_hw_params_get_periods(hwparams
, &_periods
, &dir
)) < 0)
403 /* If the sample rate deviates too much, we need to resample */
404 if (r
< ss
->rate
*.95 || r
> ss
->rate
*1.05)
409 pa_assert(_periods
> 0);
410 pa_assert(_period_size
> 0);
413 *period_size
= _period_size
;
416 *use_mmap
= _use_mmap
;
419 *use_tsched
= _use_tsched
;
428 int pa_alsa_set_sw_params(snd_pcm_t
*pcm
, snd_pcm_uframes_t avail_min
) {
429 snd_pcm_sw_params_t
*swparams
;
434 snd_pcm_sw_params_alloca(&swparams
);
436 if ((err
= snd_pcm_sw_params_current(pcm
, swparams
) < 0)) {
437 pa_log_warn("Unable to determine current swparams: %s\n", snd_strerror(err
));
441 if ((err
= snd_pcm_sw_params_set_stop_threshold(pcm
, swparams
, (snd_pcm_uframes_t
) -1)) < 0) {
442 pa_log_warn("Unable to set stop threshold: %s\n", snd_strerror(err
));
446 if ((err
= snd_pcm_sw_params_set_start_threshold(pcm
, swparams
, (snd_pcm_uframes_t
) -1)) < 0) {
447 pa_log_warn("Unable to set start threshold: %s\n", snd_strerror(err
));
451 if ((err
= snd_pcm_sw_params_set_avail_min(pcm
, swparams
, avail_min
)) < 0) {
452 pa_log_error("snd_pcm_sw_params_set_avail_min() failed: %s", snd_strerror(err
));
456 if ((err
= snd_pcm_sw_params(pcm
, swparams
)) < 0) {
457 pa_log_warn("Unable to set sw params: %s\n", snd_strerror(err
));
469 static const struct device_info device_table
[] = {
470 {{ 2, { PA_CHANNEL_POSITION_LEFT
, PA_CHANNEL_POSITION_RIGHT
} }, "front" },
472 {{ 4, { PA_CHANNEL_POSITION_FRONT_LEFT
, PA_CHANNEL_POSITION_FRONT_RIGHT
,
473 PA_CHANNEL_POSITION_REAR_LEFT
, PA_CHANNEL_POSITION_REAR_RIGHT
}}, "surround40" },
475 {{ 5, { PA_CHANNEL_POSITION_FRONT_LEFT
, PA_CHANNEL_POSITION_FRONT_RIGHT
,
476 PA_CHANNEL_POSITION_REAR_LEFT
, PA_CHANNEL_POSITION_REAR_RIGHT
,
477 PA_CHANNEL_POSITION_LFE
}}, "surround41" },
479 {{ 5, { PA_CHANNEL_POSITION_FRONT_LEFT
, PA_CHANNEL_POSITION_FRONT_RIGHT
,
480 PA_CHANNEL_POSITION_REAR_LEFT
, PA_CHANNEL_POSITION_REAR_RIGHT
,
481 PA_CHANNEL_POSITION_CENTER
}}, "surround50" },
483 {{ 6, { PA_CHANNEL_POSITION_FRONT_LEFT
, PA_CHANNEL_POSITION_FRONT_RIGHT
,
484 PA_CHANNEL_POSITION_REAR_LEFT
, PA_CHANNEL_POSITION_REAR_RIGHT
,
485 PA_CHANNEL_POSITION_CENTER
, PA_CHANNEL_POSITION_LFE
}}, "surround51" },
487 {{ 8, { PA_CHANNEL_POSITION_FRONT_LEFT
, PA_CHANNEL_POSITION_FRONT_RIGHT
,
488 PA_CHANNEL_POSITION_REAR_LEFT
, PA_CHANNEL_POSITION_REAR_RIGHT
,
489 PA_CHANNEL_POSITION_CENTER
, PA_CHANNEL_POSITION_LFE
,
490 PA_CHANNEL_POSITION_SIDE_LEFT
, PA_CHANNEL_POSITION_SIDE_RIGHT
}} , "surround71" },
495 static pa_bool_t
channel_map_superset(const pa_channel_map
*a
, const pa_channel_map
*b
) {
496 pa_bool_t in_a
[PA_CHANNEL_POSITION_MAX
];
502 memset(in_a
, 0, sizeof(in_a
));
504 for (i
= 0; i
< a
->channels
; i
++)
505 in_a
[a
->map
[i
]] = TRUE
;
507 for (i
= 0; i
< b
->channels
; i
++)
508 if (!in_a
[b
->map
[i
]])
514 snd_pcm_t
*pa_alsa_open_by_device_id(
521 snd_pcm_uframes_t
*period_size
,
522 snd_pcm_uframes_t tsched_size
,
524 pa_bool_t
*use_tsched
) {
530 snd_pcm_t
*pcm_handle
;
537 pa_assert(period_size
);
539 /* First we try to find a device string with a superset of the
540 * requested channel map and open it without the plug: prefix. We
541 * iterate through our device table from top to bottom and take
542 * the first that matches. If we didn't find a working device that
543 * way, we iterate backwards, and check all devices that do not
544 * provide a superset of the requested channel map.*/
546 for (i
= 0;; i
+= direction
) {
547 pa_sample_spec try_ss
;
550 pa_assert(direction
== -1);
552 /* OK, so we iterated backwards, and now are at the
553 * beginning of our list. */
557 } else if (!device_table
[i
].name
) {
558 pa_assert(direction
== 1);
560 /* OK, so we are at the end of our list. at iterated
567 if ((direction
> 0) == !channel_map_superset(&device_table
[i
].map
, map
))
570 d
= pa_sprintf_malloc("%s:%s", device_table
[i
].name
, dev_id
);
571 pa_log_debug("Trying %s...", d
);
573 if ((err
= snd_pcm_open(&pcm_handle
, d
, mode
,
575 SND_PCM_NO_AUTO_RESAMPLE
|
576 SND_PCM_NO_AUTO_CHANNELS
|
577 SND_PCM_NO_AUTO_FORMAT
|
578 SND_PCM_NO_SOFTVOL
)) < 0) {
579 pa_log_info("Couldn't open PCM device %s: %s", d
, snd_strerror(err
));
584 try_ss
.channels
= device_table
[i
].map
.channels
;
585 try_ss
.rate
= ss
->rate
;
586 try_ss
.format
= ss
->format
;
588 if ((err
= pa_alsa_set_hw_params(pcm_handle
, &try_ss
, nfrags
, period_size
, tsched_size
, use_mmap
, use_tsched
, TRUE
)) < 0) {
589 pa_log_info("PCM device %s refused our hw parameters: %s", d
, snd_strerror(err
));
591 snd_pcm_close(pcm_handle
);
596 *map
= device_table
[i
].map
;
597 pa_assert(map
->channels
== ss
->channels
);
602 /* OK, we didn't find any good device, so let's try the raw plughw: stuff */
604 d
= pa_sprintf_malloc("plughw:%s", dev_id
);
605 pa_log_debug("Trying %s as last resort...", d
);
606 pcm_handle
= pa_alsa_open_by_device_string(d
, dev
, ss
, map
, mode
, nfrags
, period_size
, tsched_size
, use_mmap
, use_tsched
);
612 snd_pcm_t
*pa_alsa_open_by_device_string(
619 snd_pcm_uframes_t
*period_size
,
620 snd_pcm_uframes_t tsched_size
,
622 pa_bool_t
*use_tsched
) {
626 snd_pcm_t
*pcm_handle
;
633 pa_assert(period_size
);
635 d
= pa_xstrdup(device
);
639 if ((err
= snd_pcm_open(&pcm_handle
, d
, mode
, SND_PCM_NONBLOCK
|
640 SND_PCM_NO_AUTO_RESAMPLE
|
641 SND_PCM_NO_AUTO_CHANNELS
|
642 SND_PCM_NO_AUTO_FORMAT
)) < 0) {
643 pa_log("Error opening PCM device %s: %s", d
, snd_strerror(err
));
648 if ((err
= pa_alsa_set_hw_params(pcm_handle
, ss
, nfrags
, period_size
, tsched_size
, use_mmap
, use_tsched
, FALSE
)) < 0) {
651 /* Hmm, some hw is very exotic, so we retry with plug, if without it didn't work */
653 if (pa_startswith(d
, "hw:")) {
654 char *t
= pa_sprintf_malloc("plughw:%s", d
+3);
655 pa_log_debug("Opening the device as '%s' didn't work, retrying with '%s'.", d
, t
);
659 snd_pcm_close(pcm_handle
);
663 pa_log("Failed to set hardware parameters on %s: %s", d
, snd_strerror(err
));
665 snd_pcm_close(pcm_handle
);
672 if (ss
->channels
!= map
->channels
)
673 pa_channel_map_init_extend(map
, ss
->channels
, PA_CHANNEL_MAP_ALSA
);
679 int pa_alsa_prepare_mixer(snd_mixer_t
*mixer
, const char *dev
) {
685 if ((err
= snd_mixer_attach(mixer
, dev
)) < 0) {
686 pa_log_info("Unable to attach to mixer %s: %s", dev
, snd_strerror(err
));
690 if ((err
= snd_mixer_selem_register(mixer
, NULL
, NULL
)) < 0) {
691 pa_log_warn("Unable to register mixer: %s", snd_strerror(err
));
695 if ((err
= snd_mixer_load(mixer
)) < 0) {
696 pa_log_warn("Unable to load mixer: %s", snd_strerror(err
));
700 pa_log_info("Successfully attached to mixer '%s'", dev
);
705 snd_mixer_elem_t
*pa_alsa_find_elem(snd_mixer_t
*mixer
, const char *name
, const char *fallback
) {
706 snd_mixer_elem_t
*elem
;
707 snd_mixer_selem_id_t
*sid
= NULL
;
709 snd_mixer_selem_id_alloca(&sid
);
714 snd_mixer_selem_id_set_name(sid
, name
);
716 if (!(elem
= snd_mixer_find_selem(mixer
, sid
))) {
717 pa_log_info("Cannot find mixer control \"%s\".", snd_mixer_selem_id_get_name(sid
));
720 snd_mixer_selem_id_set_name(sid
, fallback
);
722 if (!(elem
= snd_mixer_find_selem(mixer
, sid
)))
723 pa_log_warn("Cannot find fallback mixer control \"%s\".", snd_mixer_selem_id_get_name(sid
));
728 pa_log_info("Using mixer control \"%s\".", snd_mixer_selem_id_get_name(sid
));
733 static const snd_mixer_selem_channel_id_t alsa_channel_ids
[PA_CHANNEL_POSITION_MAX
] = {
734 [PA_CHANNEL_POSITION_MONO
] = SND_MIXER_SCHN_MONO
, /* The ALSA name is just an alias! */
736 [PA_CHANNEL_POSITION_FRONT_CENTER
] = SND_MIXER_SCHN_FRONT_CENTER
,
737 [PA_CHANNEL_POSITION_FRONT_LEFT
] = SND_MIXER_SCHN_FRONT_LEFT
,
738 [PA_CHANNEL_POSITION_FRONT_RIGHT
] = SND_MIXER_SCHN_FRONT_RIGHT
,
740 [PA_CHANNEL_POSITION_REAR_CENTER
] = SND_MIXER_SCHN_REAR_CENTER
,
741 [PA_CHANNEL_POSITION_REAR_LEFT
] = SND_MIXER_SCHN_REAR_LEFT
,
742 [PA_CHANNEL_POSITION_REAR_RIGHT
] = SND_MIXER_SCHN_REAR_RIGHT
,
744 [PA_CHANNEL_POSITION_LFE
] = SND_MIXER_SCHN_WOOFER
,
746 [PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER
] = SND_MIXER_SCHN_UNKNOWN
,
747 [PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER
] = SND_MIXER_SCHN_UNKNOWN
,
749 [PA_CHANNEL_POSITION_SIDE_LEFT
] = SND_MIXER_SCHN_SIDE_LEFT
,
750 [PA_CHANNEL_POSITION_SIDE_RIGHT
] = SND_MIXER_SCHN_SIDE_RIGHT
,
752 [PA_CHANNEL_POSITION_AUX0
] = SND_MIXER_SCHN_UNKNOWN
,
753 [PA_CHANNEL_POSITION_AUX1
] = SND_MIXER_SCHN_UNKNOWN
,
754 [PA_CHANNEL_POSITION_AUX2
] = SND_MIXER_SCHN_UNKNOWN
,
755 [PA_CHANNEL_POSITION_AUX3
] = SND_MIXER_SCHN_UNKNOWN
,
756 [PA_CHANNEL_POSITION_AUX4
] = SND_MIXER_SCHN_UNKNOWN
,
757 [PA_CHANNEL_POSITION_AUX5
] = SND_MIXER_SCHN_UNKNOWN
,
758 [PA_CHANNEL_POSITION_AUX6
] = SND_MIXER_SCHN_UNKNOWN
,
759 [PA_CHANNEL_POSITION_AUX7
] = SND_MIXER_SCHN_UNKNOWN
,
760 [PA_CHANNEL_POSITION_AUX8
] = SND_MIXER_SCHN_UNKNOWN
,
761 [PA_CHANNEL_POSITION_AUX9
] = SND_MIXER_SCHN_UNKNOWN
,
762 [PA_CHANNEL_POSITION_AUX10
] = SND_MIXER_SCHN_UNKNOWN
,
763 [PA_CHANNEL_POSITION_AUX11
] = SND_MIXER_SCHN_UNKNOWN
,
764 [PA_CHANNEL_POSITION_AUX12
] = SND_MIXER_SCHN_UNKNOWN
,
765 [PA_CHANNEL_POSITION_AUX13
] = SND_MIXER_SCHN_UNKNOWN
,
766 [PA_CHANNEL_POSITION_AUX14
] = SND_MIXER_SCHN_UNKNOWN
,
767 [PA_CHANNEL_POSITION_AUX15
] = SND_MIXER_SCHN_UNKNOWN
,
768 [PA_CHANNEL_POSITION_AUX16
] = SND_MIXER_SCHN_UNKNOWN
,
769 [PA_CHANNEL_POSITION_AUX17
] = SND_MIXER_SCHN_UNKNOWN
,
770 [PA_CHANNEL_POSITION_AUX18
] = SND_MIXER_SCHN_UNKNOWN
,
771 [PA_CHANNEL_POSITION_AUX19
] = SND_MIXER_SCHN_UNKNOWN
,
772 [PA_CHANNEL_POSITION_AUX20
] = SND_MIXER_SCHN_UNKNOWN
,
773 [PA_CHANNEL_POSITION_AUX21
] = SND_MIXER_SCHN_UNKNOWN
,
774 [PA_CHANNEL_POSITION_AUX22
] = SND_MIXER_SCHN_UNKNOWN
,
775 [PA_CHANNEL_POSITION_AUX23
] = SND_MIXER_SCHN_UNKNOWN
,
776 [PA_CHANNEL_POSITION_AUX24
] = SND_MIXER_SCHN_UNKNOWN
,
777 [PA_CHANNEL_POSITION_AUX25
] = SND_MIXER_SCHN_UNKNOWN
,
778 [PA_CHANNEL_POSITION_AUX26
] = SND_MIXER_SCHN_UNKNOWN
,
779 [PA_CHANNEL_POSITION_AUX27
] = SND_MIXER_SCHN_UNKNOWN
,
780 [PA_CHANNEL_POSITION_AUX28
] = SND_MIXER_SCHN_UNKNOWN
,
781 [PA_CHANNEL_POSITION_AUX29
] = SND_MIXER_SCHN_UNKNOWN
,
782 [PA_CHANNEL_POSITION_AUX30
] = SND_MIXER_SCHN_UNKNOWN
,
783 [PA_CHANNEL_POSITION_AUX31
] = SND_MIXER_SCHN_UNKNOWN
,
785 [PA_CHANNEL_POSITION_TOP_CENTER
] = SND_MIXER_SCHN_UNKNOWN
,
787 [PA_CHANNEL_POSITION_TOP_FRONT_CENTER
] = SND_MIXER_SCHN_UNKNOWN
,
788 [PA_CHANNEL_POSITION_TOP_FRONT_LEFT
] = SND_MIXER_SCHN_UNKNOWN
,
789 [PA_CHANNEL_POSITION_TOP_FRONT_RIGHT
] = SND_MIXER_SCHN_UNKNOWN
,
791 [PA_CHANNEL_POSITION_TOP_REAR_CENTER
] = SND_MIXER_SCHN_UNKNOWN
,
792 [PA_CHANNEL_POSITION_TOP_REAR_LEFT
] = SND_MIXER_SCHN_UNKNOWN
,
793 [PA_CHANNEL_POSITION_TOP_REAR_RIGHT
] = SND_MIXER_SCHN_UNKNOWN
797 int pa_alsa_calc_mixer_map(snd_mixer_elem_t
*elem
, const pa_channel_map
*channel_map
, snd_mixer_selem_channel_id_t mixer_map
[], pa_bool_t playback
) {
799 pa_bool_t alsa_channel_used
[SND_MIXER_SCHN_LAST
];
800 pa_bool_t mono_used
= FALSE
;
803 pa_assert(channel_map
);
804 pa_assert(mixer_map
);
806 memset(&alsa_channel_used
, 0, sizeof(alsa_channel_used
));
808 if (channel_map
->channels
> 1 &&
809 ((playback
&& snd_mixer_selem_has_playback_volume_joined(elem
)) ||
810 (!playback
&& snd_mixer_selem_has_capture_volume_joined(elem
)))) {
811 pa_log_info("ALSA device lacks independant volume controls for each channel, falling back to software volume control.");
815 for (i
= 0; i
< channel_map
->channels
; i
++) {
816 snd_mixer_selem_channel_id_t id
;
819 is_mono
= channel_map
->map
[i
] == PA_CHANNEL_POSITION_MONO
;
820 id
= alsa_channel_ids
[channel_map
->map
[i
]];
822 if (!is_mono
&& id
== SND_MIXER_SCHN_UNKNOWN
) {
823 pa_log_info("Configured channel map contains channel '%s' that is unknown to the ALSA mixer. Falling back to software volume control.", pa_channel_position_to_string(channel_map
->map
[i
]));
827 if ((is_mono
&& mono_used
) || (!is_mono
&& alsa_channel_used
[id
])) {
828 pa_log_info("Channel map has duplicate channel '%s', falling back to software volume control.", pa_channel_position_to_string(channel_map
->map
[i
]));
832 if ((playback
&& (!snd_mixer_selem_has_playback_channel(elem
, id
) || (is_mono
&& !snd_mixer_selem_is_playback_mono(elem
)))) ||
833 (!playback
&& (!snd_mixer_selem_has_capture_channel(elem
, id
) || (is_mono
&& !snd_mixer_selem_is_capture_mono(elem
))))) {
835 pa_log_info("ALSA device lacks separate volumes control for channel '%s', falling back to software volume control.", pa_channel_position_to_string(channel_map
->map
[i
]));
840 mixer_map
[i
] = SND_MIXER_SCHN_MONO
;
844 alsa_channel_used
[id
] = TRUE
;
848 pa_log_info("All %u channels can be mapped to mixer channels.", channel_map
->channels
);
853 void pa_alsa_0dB_playback(snd_mixer_elem_t
*elem
) {
858 /* Try to enable 0 dB if possible. If ALSA cannot do dB, then use
859 * raw volume levels and fix them to 75% */
861 if (snd_mixer_selem_set_playback_dB_all(elem
, 0, -1) >= 0)
864 if (snd_mixer_selem_set_playback_dB_all(elem
, 0, 1) >= 0)
867 if (snd_mixer_selem_get_playback_volume_range(elem
, &min
, &max
) < 0)
870 v
= min
+ ((max
- min
) * 3) / 4; /* 75% */
875 snd_mixer_selem_set_playback_volume_all(elem
, v
);
878 void pa_alsa_0dB_capture(snd_mixer_elem_t
*elem
) {
883 /* Try to enable 0 dB if possible. If ALSA cannot do dB, then use
884 * raw volume levels and fix them to 75% */
886 if (snd_mixer_selem_set_capture_dB_all(elem
, 0, -1) >= 0)
889 if (snd_mixer_selem_set_capture_dB_all(elem
, 0, 1) >= 0)
892 if (snd_mixer_selem_get_capture_volume_range(elem
, &min
, &max
) < 0)
895 v
= min
+ ((max
- min
) * 3) / 4; /* 75% */
900 snd_mixer_selem_set_capture_volume_all(elem
, v
);
903 void pa_alsa_dump(snd_pcm_t
*pcm
) {
909 pa_assert_se(snd_output_buffer_open(&out
) == 0);
911 if ((err
= snd_pcm_dump(pcm
, out
)) < 0)
912 pa_log_debug("snd_pcm_dump(): %s", snd_strerror(err
));
915 snd_output_buffer_string(out
, &s
);
916 pa_log_debug("snd_pcm_dump():\n%s", pa_strnull(s
));
919 pa_assert_se(snd_output_close(out
) == 0);
922 void pa_alsa_dump_status(snd_pcm_t
*pcm
) {
925 snd_pcm_status_t
*status
;
929 snd_pcm_status_alloca(&status
);
931 pa_assert_se(snd_output_buffer_open(&out
) == 0);
933 pa_assert_se(snd_pcm_status(pcm
, status
) == 0);
935 if ((err
= snd_pcm_status_dump(status
, out
)) < 0)
936 pa_log_debug("snd_pcm_dump(): %s", snd_strerror(err
));
939 snd_output_buffer_string(out
, &s
);
940 pa_log_debug("snd_pcm_dump():\n%s", pa_strnull(s
));
943 pa_assert_se(snd_output_close(out
) == 0);
946 static void alsa_error_handler(const char *file
, int line
, const char *function
, int err
, const char *fmt
,...) {
951 pa_log_levelv_meta(PA_LOG_WARN
, file
, line
, function
, fmt
, ap
);
956 static pa_atomic_t n_error_handler_installed
= PA_ATOMIC_INIT(0);
958 void pa_alsa_redirect_errors_inc(void) {
959 /* This is not really thread safe, but we do our best */
961 if (pa_atomic_inc(&n_error_handler_installed
) == 0)
962 snd_lib_error_set_handler(alsa_error_handler
);
965 void pa_alsa_redirect_errors_dec(void) {
968 pa_assert_se((r
= pa_atomic_dec(&n_error_handler_installed
)) >= 1);
971 snd_lib_error_set_handler(NULL
);
974 void pa_alsa_init_proplist(pa_proplist
*p
, snd_pcm_info_t
*pcm_info
) {
976 static const char * const alsa_class_table
[SND_PCM_CLASS_LAST
+1] = {
977 [SND_PCM_CLASS_GENERIC
] = "generic",
978 [SND_PCM_CLASS_MULTI
] = "multi",
979 [SND_PCM_CLASS_MODEM
] = "modem",
980 [SND_PCM_CLASS_DIGITIZER
] = "digitizer"
982 static const char * const class_table
[SND_PCM_CLASS_LAST
+1] = {
983 [SND_PCM_CLASS_GENERIC
] = "sound",
984 [SND_PCM_CLASS_MULTI
] = NULL
,
985 [SND_PCM_CLASS_MODEM
] = "modem",
986 [SND_PCM_CLASS_DIGITIZER
] = NULL
988 static const char * const alsa_subclass_table
[SND_PCM_SUBCLASS_LAST
+1] = {
989 [SND_PCM_SUBCLASS_GENERIC_MIX
] = "generic-mix",
990 [SND_PCM_SUBCLASS_MULTI_MIX
] = "multi-mix"
993 snd_pcm_class_t
class;
994 snd_pcm_subclass_t subclass
;
995 const char *n
, *id
, *sdn
;
996 char *cn
= NULL
, *lcn
= NULL
;
1000 pa_assert(pcm_info
);
1002 pa_proplist_sets(p
, PA_PROP_DEVICE_API
, "alsa");
1004 class = snd_pcm_info_get_class(pcm_info
);
1005 if (class <= SND_PCM_CLASS_LAST
) {
1006 if (class_table
[class])
1007 pa_proplist_sets(p
, PA_PROP_DEVICE_CLASS
, class_table
[class]);
1008 if (alsa_class_table
[class])
1009 pa_proplist_sets(p
, "alsa.class", alsa_class_table
[class]);
1011 subclass
= snd_pcm_info_get_subclass(pcm_info
);
1012 if (subclass
<= SND_PCM_SUBCLASS_LAST
)
1013 if (alsa_subclass_table
[subclass
])
1014 pa_proplist_sets(p
, "alsa.subclass", alsa_subclass_table
[subclass
]);
1016 if ((n
= snd_pcm_info_get_name(pcm_info
)))
1017 pa_proplist_sets(p
, "alsa.name", n
);
1019 if ((id
= snd_pcm_info_get_id(pcm_info
)))
1020 pa_proplist_sets(p
, "alsa.id", id
);
1022 pa_proplist_setf(p
, "alsa.subdevice", "%u", snd_pcm_info_get_subdevice(pcm_info
));
1023 if ((sdn
= snd_pcm_info_get_subdevice_name(pcm_info
)))
1024 pa_proplist_sets(p
, "alsa.subdevice_name", sdn
);
1026 pa_proplist_setf(p
, "alsa.device", "%u", snd_pcm_info_get_device(pcm_info
));
1028 if ((card
= snd_pcm_info_get_card(pcm_info
)) >= 0) {
1029 pa_proplist_setf(p
, "alsa.card", "%i", card
);
1031 if (snd_card_get_name(card
, &cn
) >= 0)
1032 pa_proplist_sets(p
, "alsa.card_name", cn
);
1034 if (snd_card_get_longname(card
, &lcn
) >= 0)
1035 pa_proplist_sets(p
, "alsa.long_card_name", lcn
);
1039 pa_proplist_setf(p
, PA_PROP_DEVICE_DESCRIPTION
, "%s - %s", cn
, n
);
1041 pa_proplist_sets(p
, PA_PROP_DEVICE_DESCRIPTION
, cn
);
1043 pa_proplist_sets(p
, PA_PROP_DEVICE_DESCRIPTION
, n
);
1049 int pa_alsa_recover_from_poll(snd_pcm_t
*pcm
, int revents
) {
1050 snd_pcm_state_t state
;
1055 if (revents
& POLLERR
)
1056 pa_log_warn("Got POLLERR from ALSA");
1057 if (revents
& POLLNVAL
)
1058 pa_log_warn("Got POLLNVAL from ALSA");
1059 if (revents
& POLLHUP
)
1060 pa_log_warn("Got POLLHUP from ALSA");
1062 state
= snd_pcm_state(pcm
);
1063 pa_log_warn("PCM state is %s", snd_pcm_state_name(state
));
1065 /* Try to recover from this error */
1069 case SND_PCM_STATE_XRUN
:
1070 if ((err
= snd_pcm_recover(pcm
, -EPIPE
, 1)) != 0) {
1071 pa_log_warn("Could not recover from POLLERR|POLLNVAL|POLLHUP and XRUN: %s", snd_strerror(err
));
1076 case SND_PCM_STATE_SUSPENDED
:
1077 if ((err
= snd_pcm_recover(pcm
, -ESTRPIPE
, 1)) != 0) {
1078 pa_log_warn("Could not recover from POLLERR|POLLNVAL|POLLHUP and SUSPENDED: %s", snd_strerror(err
));
1087 if ((err
= snd_pcm_prepare(pcm
)) < 0) {
1088 pa_log_warn("Could not recover from POLLERR|POLLNVAL|POLLHUP with snd_pcm_prepare(): %s", snd_strerror(err
));
1097 pa_rtpoll_item
* pa_alsa_build_pollfd(snd_pcm_t
*pcm
, pa_rtpoll
*rtpoll
) {
1099 struct pollfd
*pollfd
;
1100 pa_rtpoll_item
*item
;
1104 if ((n
= snd_pcm_poll_descriptors_count(pcm
)) < 0) {
1105 pa_log("snd_pcm_poll_descriptors_count() failed: %s", snd_strerror(n
));
1109 item
= pa_rtpoll_item_new(rtpoll
, PA_RTPOLL_NEVER
, n
);
1110 pollfd
= pa_rtpoll_item_get_pollfd(item
, NULL
);
1112 if ((err
= snd_pcm_poll_descriptors(pcm
, pollfd
, n
)) < 0) {
1113 pa_log("snd_pcm_poll_descriptors() failed: %s", snd_strerror(err
));
1114 pa_rtpoll_item_free(item
);