2 This file is part of PulseAudio.
4 Copyright 2004-2008 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.1 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
30 #include <asoundlib.h>
32 #ifdef HAVE_VALGRIND_MEMCHECK_H
33 #include <valgrind/memcheck.h>
36 #include <pulse/rtclock.h>
37 #include <pulse/timeval.h>
38 #include <pulse/volume.h>
39 #include <pulse/xmalloc.h>
40 #include <pulse/internal.h>
42 #include <pulsecore/core.h>
43 #include <pulsecore/i18n.h>
44 #include <pulsecore/module.h>
45 #include <pulsecore/memchunk.h>
46 #include <pulsecore/sink.h>
47 #include <pulsecore/modargs.h>
48 #include <pulsecore/core-rtclock.h>
49 #include <pulsecore/core-util.h>
50 #include <pulsecore/sample-util.h>
51 #include <pulsecore/log.h>
52 #include <pulsecore/macro.h>
53 #include <pulsecore/thread.h>
54 #include <pulsecore/thread-mq.h>
55 #include <pulsecore/rtpoll.h>
56 #include <pulsecore/time-smoother.h>
58 #include <modules/reserve-wrap.h>
60 #include "alsa-util.h"
61 #include "alsa-sink.h"
63 /* #define DEBUG_TIMING */
65 #define DEFAULT_DEVICE "default"
67 #define DEFAULT_TSCHED_BUFFER_USEC (2*PA_USEC_PER_SEC) /* 2s -- Overall buffer size */
68 #define DEFAULT_TSCHED_WATERMARK_USEC (20*PA_USEC_PER_MSEC) /* 20ms -- Fill up when only this much is left in the buffer */
70 #define TSCHED_WATERMARK_INC_STEP_USEC (10*PA_USEC_PER_MSEC) /* 10ms -- On underrun, increase watermark by this */
71 #define TSCHED_WATERMARK_DEC_STEP_USEC (5*PA_USEC_PER_MSEC) /* 5ms -- When everything's great, decrease watermark by this */
72 #define TSCHED_WATERMARK_VERIFY_AFTER_USEC (20*PA_USEC_PER_SEC) /* 20s -- How long after a drop out recheck if things are good now */
73 #define TSCHED_WATERMARK_INC_THRESHOLD_USEC (0*PA_USEC_PER_MSEC) /* 0ms -- If the buffer level ever below this threshold, increase the watermark */
74 #define TSCHED_WATERMARK_DEC_THRESHOLD_USEC (100*PA_USEC_PER_MSEC) /* 100ms -- If the buffer level didn't drop below this threshold in the verification time, decrease the watermark */
76 /* Note that TSCHED_WATERMARK_INC_THRESHOLD_USEC == 0 means that we
77 * will increase the watermark only if we hit a real underrun. */
79 #define TSCHED_MIN_SLEEP_USEC (10*PA_USEC_PER_MSEC) /* 10ms -- Sleep at least 10ms on each iteration */
80 #define TSCHED_MIN_WAKEUP_USEC (4*PA_USEC_PER_MSEC) /* 4ms -- Wakeup at least this long before the buffer runs empty*/
82 #define SMOOTHER_WINDOW_USEC (10*PA_USEC_PER_SEC) /* 10s -- smoother windows size */
83 #define SMOOTHER_ADJUST_USEC (1*PA_USEC_PER_SEC) /* 1s -- smoother adjust time */
85 #define SMOOTHER_MIN_INTERVAL (2*PA_USEC_PER_MSEC) /* 2ms -- min smoother update interval */
86 #define SMOOTHER_MAX_INTERVAL (200*PA_USEC_PER_MSEC) /* 200ms -- max smoother update interval */
88 #define VOLUME_ACCURACY (PA_VOLUME_NORM/100) /* don't require volume adjustments to be perfectly correct. don't necessarily extend granularity in software unless the differences get greater than this level */
90 #define DEFAULT_REWIND_SAFEGUARD_BYTES (256U) /* 1.33ms @48kHz, we'll never rewind less than this */
91 #define DEFAULT_REWIND_SAFEGUARD_USEC (1330) /* 1.33ms, depending on channels/rate/sample we may rewind more than 256 above */
99 pa_thread_mq thread_mq
;
102 snd_pcm_t
*pcm_handle
;
105 pa_alsa_fdlist
*mixer_fdl
;
106 pa_alsa_mixer_pdata
*mixer_pd
;
107 snd_mixer_t
*mixer_handle
;
108 pa_alsa_path_set
*mixer_path_set
;
109 pa_alsa_path
*mixer_path
;
111 pa_cvolume hardware_volume
;
120 tsched_watermark_ref
,
126 watermark_inc_threshold
,
127 watermark_dec_threshold
,
130 pa_usec_t watermark_dec_not_before
;
131 pa_usec_t min_latency_ref
;
132 pa_usec_t tsched_watermark_usec
;
134 pa_memchunk memchunk
;
136 char *device_name
; /* name of the PCM device */
137 char *control_device
; /* name of the control device */
139 bool use_mmap
:1, use_tsched
:1, deferred_volume
:1, fixed_latency_range
:1;
141 bool first
, after_rewind
;
143 pa_rtpoll_item
*alsa_rtpoll_item
;
145 pa_smoother
*smoother
;
146 uint64_t write_count
;
147 uint64_t since_start
;
148 pa_usec_t smoother_interval
;
149 pa_usec_t last_smoother_update
;
153 pa_reserve_wrapper
*reserve
;
154 pa_hook_slot
*reserve_slot
;
155 pa_reserve_monitor_wrapper
*monitor
;
156 pa_hook_slot
*monitor_slot
;
159 pa_alsa_ucm_mapping_context
*ucm_context
;
162 static void userdata_free(struct userdata
*u
);
164 /* FIXME: Is there a better way to do this than device names? */
165 static bool is_iec958(struct userdata
*u
) {
166 return (strncmp("iec958", u
->device_name
, 6) == 0);
169 static bool is_hdmi(struct userdata
*u
) {
170 return (strncmp("hdmi", u
->device_name
, 4) == 0);
173 static pa_hook_result_t
reserve_cb(pa_reserve_wrapper
*r
, void *forced
, struct userdata
*u
) {
177 pa_log_debug("Suspending sink %s, because another application requested us to release the device.", u
->sink
->name
);
179 if (pa_sink_suspend(u
->sink
, true, PA_SUSPEND_APPLICATION
) < 0)
180 return PA_HOOK_CANCEL
;
185 static void reserve_done(struct userdata
*u
) {
188 if (u
->reserve_slot
) {
189 pa_hook_slot_free(u
->reserve_slot
);
190 u
->reserve_slot
= NULL
;
194 pa_reserve_wrapper_unref(u
->reserve
);
199 static void reserve_update(struct userdata
*u
) {
200 const char *description
;
203 if (!u
->sink
|| !u
->reserve
)
206 if ((description
= pa_proplist_gets(u
->sink
->proplist
, PA_PROP_DEVICE_DESCRIPTION
)))
207 pa_reserve_wrapper_set_application_device_name(u
->reserve
, description
);
210 static int reserve_init(struct userdata
*u
, const char *dname
) {
219 if (pa_in_system_mode())
222 if (!(rname
= pa_alsa_get_reserve_name(dname
)))
225 /* We are resuming, try to lock the device */
226 u
->reserve
= pa_reserve_wrapper_get(u
->core
, rname
);
234 pa_assert(!u
->reserve_slot
);
235 u
->reserve_slot
= pa_hook_connect(pa_reserve_wrapper_hook(u
->reserve
), PA_HOOK_NORMAL
, (pa_hook_cb_t
) reserve_cb
, u
);
240 static pa_hook_result_t
monitor_cb(pa_reserve_monitor_wrapper
*w
, void* busy
, struct userdata
*u
) {
244 if (PA_PTR_TO_UINT(busy
) && !u
->reserve
) {
245 pa_log_debug("Suspending sink %s, because another application is blocking the access to the device.", u
->sink
->name
);
246 pa_sink_suspend(u
->sink
, true, PA_SUSPEND_APPLICATION
);
248 pa_log_debug("Resuming sink %s, because other applications aren't blocking access to the device any more.", u
->sink
->name
);
249 pa_sink_suspend(u
->sink
, false, PA_SUSPEND_APPLICATION
);
255 static void monitor_done(struct userdata
*u
) {
258 if (u
->monitor_slot
) {
259 pa_hook_slot_free(u
->monitor_slot
);
260 u
->monitor_slot
= NULL
;
264 pa_reserve_monitor_wrapper_unref(u
->monitor
);
269 static int reserve_monitor_init(struct userdata
*u
, const char *dname
) {
275 if (pa_in_system_mode())
278 if (!(rname
= pa_alsa_get_reserve_name(dname
)))
281 /* We are resuming, try to lock the device */
282 u
->monitor
= pa_reserve_monitor_wrapper_get(u
->core
, rname
);
288 pa_assert(!u
->monitor_slot
);
289 u
->monitor_slot
= pa_hook_connect(pa_reserve_monitor_wrapper_hook(u
->monitor
), PA_HOOK_NORMAL
, (pa_hook_cb_t
) monitor_cb
, u
);
294 static void fix_min_sleep_wakeup(struct userdata
*u
) {
295 size_t max_use
, max_use_2
;
298 pa_assert(u
->use_tsched
);
300 max_use
= u
->hwbuf_size
- u
->hwbuf_unused
;
301 max_use_2
= pa_frame_align(max_use
/2, &u
->sink
->sample_spec
);
303 u
->min_sleep
= pa_usec_to_bytes(TSCHED_MIN_SLEEP_USEC
, &u
->sink
->sample_spec
);
304 u
->min_sleep
= PA_CLAMP(u
->min_sleep
, u
->frame_size
, max_use_2
);
306 u
->min_wakeup
= pa_usec_to_bytes(TSCHED_MIN_WAKEUP_USEC
, &u
->sink
->sample_spec
);
307 u
->min_wakeup
= PA_CLAMP(u
->min_wakeup
, u
->frame_size
, max_use_2
);
310 static void fix_tsched_watermark(struct userdata
*u
) {
313 pa_assert(u
->use_tsched
);
315 max_use
= u
->hwbuf_size
- u
->hwbuf_unused
;
317 if (u
->tsched_watermark
> max_use
- u
->min_sleep
)
318 u
->tsched_watermark
= max_use
- u
->min_sleep
;
320 if (u
->tsched_watermark
< u
->min_wakeup
)
321 u
->tsched_watermark
= u
->min_wakeup
;
323 u
->tsched_watermark_usec
= pa_bytes_to_usec(u
->tsched_watermark
, &u
->sink
->sample_spec
);
326 static void increase_watermark(struct userdata
*u
) {
327 size_t old_watermark
;
328 pa_usec_t old_min_latency
, new_min_latency
;
331 pa_assert(u
->use_tsched
);
333 /* First, just try to increase the watermark */
334 old_watermark
= u
->tsched_watermark
;
335 u
->tsched_watermark
= PA_MIN(u
->tsched_watermark
* 2, u
->tsched_watermark
+ u
->watermark_inc_step
);
336 fix_tsched_watermark(u
);
338 if (old_watermark
!= u
->tsched_watermark
) {
339 pa_log_info("Increasing wakeup watermark to %0.2f ms",
340 (double) u
->tsched_watermark_usec
/ PA_USEC_PER_MSEC
);
344 /* Hmm, we cannot increase the watermark any further, hence let's
345 raise the latency, unless doing so was disabled in
347 if (u
->fixed_latency_range
)
350 old_min_latency
= u
->sink
->thread_info
.min_latency
;
351 new_min_latency
= PA_MIN(old_min_latency
* 2, old_min_latency
+ TSCHED_WATERMARK_INC_STEP_USEC
);
352 new_min_latency
= PA_MIN(new_min_latency
, u
->sink
->thread_info
.max_latency
);
354 if (old_min_latency
!= new_min_latency
) {
355 pa_log_info("Increasing minimal latency to %0.2f ms",
356 (double) new_min_latency
/ PA_USEC_PER_MSEC
);
358 pa_sink_set_latency_range_within_thread(u
->sink
, new_min_latency
, u
->sink
->thread_info
.max_latency
);
361 /* When we reach this we're officialy fucked! */
364 static void decrease_watermark(struct userdata
*u
) {
365 size_t old_watermark
;
369 pa_assert(u
->use_tsched
);
371 now
= pa_rtclock_now();
373 if (u
->watermark_dec_not_before
<= 0)
376 if (u
->watermark_dec_not_before
> now
)
379 old_watermark
= u
->tsched_watermark
;
381 if (u
->tsched_watermark
< u
->watermark_dec_step
)
382 u
->tsched_watermark
= u
->tsched_watermark
/ 2;
384 u
->tsched_watermark
= PA_MAX(u
->tsched_watermark
/ 2, u
->tsched_watermark
- u
->watermark_dec_step
);
386 fix_tsched_watermark(u
);
388 if (old_watermark
!= u
->tsched_watermark
)
389 pa_log_info("Decreasing wakeup watermark to %0.2f ms",
390 (double) u
->tsched_watermark_usec
/ PA_USEC_PER_MSEC
);
392 /* We don't change the latency range*/
395 u
->watermark_dec_not_before
= now
+ TSCHED_WATERMARK_VERIFY_AFTER_USEC
;
398 static void hw_sleep_time(struct userdata
*u
, pa_usec_t
*sleep_usec
, pa_usec_t
*process_usec
) {
401 pa_assert(sleep_usec
);
402 pa_assert(process_usec
);
405 pa_assert(u
->use_tsched
);
407 usec
= pa_sink_get_requested_latency_within_thread(u
->sink
);
409 if (usec
== (pa_usec_t
) -1)
410 usec
= pa_bytes_to_usec(u
->hwbuf_size
, &u
->sink
->sample_spec
);
412 wm
= u
->tsched_watermark_usec
;
417 *sleep_usec
= usec
- wm
;
421 pa_log_debug("Buffer time: %lu ms; Sleep time: %lu ms; Process time: %lu ms",
422 (unsigned long) (usec
/ PA_USEC_PER_MSEC
),
423 (unsigned long) (*sleep_usec
/ PA_USEC_PER_MSEC
),
424 (unsigned long) (*process_usec
/ PA_USEC_PER_MSEC
));
428 static int try_recover(struct userdata
*u
, const char *call
, int err
) {
433 pa_log_debug("%s: %s", call
, pa_alsa_strerror(err
));
435 pa_assert(err
!= -EAGAIN
);
438 pa_log_debug("%s: Buffer underrun!", call
);
440 if (err
== -ESTRPIPE
)
441 pa_log_debug("%s: System suspended!", call
);
443 if ((err
= snd_pcm_recover(u
->pcm_handle
, err
, 1)) < 0) {
444 pa_log("%s: %s", call
, pa_alsa_strerror(err
));
453 static size_t check_left_to_play(struct userdata
*u
, size_t n_bytes
, bool on_timeout
) {
455 bool underrun
= false;
457 /* We use <= instead of < for this check here because an underrun
458 * only happens after the last sample was processed, not already when
459 * it is removed from the buffer. This is particularly important
460 * when block transfer is used. */
462 if (n_bytes
<= u
->hwbuf_size
)
463 left_to_play
= u
->hwbuf_size
- n_bytes
;
466 /* We got a dropout. What a mess! */
474 if (!u
->first
&& !u
->after_rewind
)
475 if (pa_log_ratelimit(PA_LOG_INFO
))
476 pa_log_info("Underrun!");
480 pa_log_debug("%0.2f ms left to play; inc threshold = %0.2f ms; dec threshold = %0.2f ms",
481 (double) pa_bytes_to_usec(left_to_play
, &u
->sink
->sample_spec
) / PA_USEC_PER_MSEC
,
482 (double) pa_bytes_to_usec(u
->watermark_inc_threshold
, &u
->sink
->sample_spec
) / PA_USEC_PER_MSEC
,
483 (double) pa_bytes_to_usec(u
->watermark_dec_threshold
, &u
->sink
->sample_spec
) / PA_USEC_PER_MSEC
);
487 bool reset_not_before
= true;
489 if (!u
->first
&& !u
->after_rewind
) {
490 if (underrun
|| left_to_play
< u
->watermark_inc_threshold
)
491 increase_watermark(u
);
492 else if (left_to_play
> u
->watermark_dec_threshold
) {
493 reset_not_before
= false;
495 /* We decrease the watermark only if have actually
496 * been woken up by a timeout. If something else woke
497 * us up it's too easy to fulfill the deadlines... */
500 decrease_watermark(u
);
504 if (reset_not_before
)
505 u
->watermark_dec_not_before
= 0;
511 static int mmap_write(struct userdata
*u
, pa_usec_t
*sleep_usec
, bool polled
, bool on_timeout
) {
512 bool work_done
= false;
513 pa_usec_t max_sleep_usec
= 0, process_usec
= 0;
514 size_t left_to_play
, input_underrun
;
518 pa_sink_assert_ref(u
->sink
);
521 hw_sleep_time(u
, &max_sleep_usec
, &process_usec
);
527 bool after_avail
= true;
529 /* First we determine how many samples are missing to fill the
530 * buffer up to 100% */
532 if (PA_UNLIKELY((n
= pa_alsa_safe_avail(u
->pcm_handle
, u
->hwbuf_size
, &u
->sink
->sample_spec
)) < 0)) {
534 if ((r
= try_recover(u
, "snd_pcm_avail", (int) n
)) == 0)
540 n_bytes
= (size_t) n
* u
->frame_size
;
543 pa_log_debug("avail: %lu", (unsigned long) n_bytes
);
546 left_to_play
= check_left_to_play(u
, n_bytes
, on_timeout
);
551 /* We won't fill up the playback buffer before at least
552 * half the sleep time is over because otherwise we might
553 * ask for more data from the clients then they expect. We
554 * need to guarantee that clients only have to keep around
555 * a single hw buffer length. */
558 pa_bytes_to_usec(left_to_play
, &u
->sink
->sample_spec
) > process_usec
+max_sleep_usec
/2) {
560 pa_log_debug("Not filling up, because too early.");
565 if (PA_UNLIKELY(n_bytes
<= u
->hwbuf_unused
)) {
569 char *dn
= pa_alsa_get_driver_name_by_pcm(u
->pcm_handle
);
570 pa_log(_("ALSA woke us up to write new data to the device, but there was actually nothing to write!\n"
571 "Most likely this is a bug in the ALSA driver '%s'. Please report this issue to the ALSA developers.\n"
572 "We were woken up with POLLOUT set -- however a subsequent snd_pcm_avail() returned 0 or another value < min_avail."),
578 pa_log_debug("Not filling up, because not necessary.");
585 pa_log_debug("Not filling up, because already too many iterations.");
591 n_bytes
-= u
->hwbuf_unused
;
595 pa_log_debug("Filling up");
602 const snd_pcm_channel_area_t
*areas
;
603 snd_pcm_uframes_t offset
, frames
;
604 snd_pcm_sframes_t sframes
;
607 frames
= (snd_pcm_uframes_t
) (n_bytes
/ u
->frame_size
);
608 /* pa_log_debug("%lu frames to write", (unsigned long) frames); */
610 if (PA_UNLIKELY((err
= pa_alsa_safe_mmap_begin(u
->pcm_handle
, &areas
, &offset
, &frames
, u
->hwbuf_size
, &u
->sink
->sample_spec
)) < 0)) {
612 if (!after_avail
&& err
== -EAGAIN
)
615 if ((r
= try_recover(u
, "snd_pcm_mmap_begin", err
)) == 0)
621 /* Make sure that if these memblocks need to be copied they will fit into one slot */
622 if (frames
> pa_mempool_block_size_max(u
->core
->mempool
)/u
->frame_size
)
623 frames
= pa_mempool_block_size_max(u
->core
->mempool
)/u
->frame_size
;
625 if (!after_avail
&& frames
== 0)
628 pa_assert(frames
> 0);
631 /* Check these are multiples of 8 bit */
632 pa_assert((areas
[0].first
& 7) == 0);
633 pa_assert((areas
[0].step
& 7)== 0);
635 /* We assume a single interleaved memory buffer */
636 pa_assert((areas
[0].first
>> 3) == 0);
637 pa_assert((areas
[0].step
>> 3) == u
->frame_size
);
639 p
= (uint8_t*) areas
[0].addr
+ (offset
* u
->frame_size
);
641 written
= frames
* u
->frame_size
;
642 chunk
.memblock
= pa_memblock_new_fixed(u
->core
->mempool
, p
, written
, true);
643 chunk
.length
= pa_memblock_get_length(chunk
.memblock
);
646 pa_sink_render_into_full(u
->sink
, &chunk
);
647 pa_memblock_unref_fixed(chunk
.memblock
);
649 if (PA_UNLIKELY((sframes
= snd_pcm_mmap_commit(u
->pcm_handle
, offset
, frames
)) < 0)) {
651 if (!after_avail
&& (int) sframes
== -EAGAIN
)
654 if ((r
= try_recover(u
, "snd_pcm_mmap_commit", (int) sframes
)) == 0)
662 u
->write_count
+= written
;
663 u
->since_start
+= written
;
666 pa_log_debug("Wrote %lu bytes (of possible %lu bytes)", (unsigned long) written
, (unsigned long) n_bytes
);
669 if (written
>= n_bytes
)
676 input_underrun
= pa_sink_process_input_underruns(u
->sink
, left_to_play
);
679 pa_usec_t underrun_sleep
= pa_bytes_to_usec_round_up(input_underrun
, &u
->sink
->sample_spec
);
681 *sleep_usec
= pa_bytes_to_usec(left_to_play
, &u
->sink
->sample_spec
);
682 process_usec
= u
->tsched_watermark_usec
;
684 if (*sleep_usec
> process_usec
)
685 *sleep_usec
-= process_usec
;
689 *sleep_usec
= PA_MIN(*sleep_usec
, underrun_sleep
);
693 return work_done
? 1 : 0;
696 static int unix_write(struct userdata
*u
, pa_usec_t
*sleep_usec
, bool polled
, bool on_timeout
) {
697 bool work_done
= false;
698 pa_usec_t max_sleep_usec
= 0, process_usec
= 0;
699 size_t left_to_play
, input_underrun
;
703 pa_sink_assert_ref(u
->sink
);
706 hw_sleep_time(u
, &max_sleep_usec
, &process_usec
);
712 bool after_avail
= true;
714 if (PA_UNLIKELY((n
= pa_alsa_safe_avail(u
->pcm_handle
, u
->hwbuf_size
, &u
->sink
->sample_spec
)) < 0)) {
716 if ((r
= try_recover(u
, "snd_pcm_avail", (int) n
)) == 0)
722 n_bytes
= (size_t) n
* u
->frame_size
;
725 pa_log_debug("avail: %lu", (unsigned long) n_bytes
);
728 left_to_play
= check_left_to_play(u
, n_bytes
, on_timeout
);
733 /* We won't fill up the playback buffer before at least
734 * half the sleep time is over because otherwise we might
735 * ask for more data from the clients then they expect. We
736 * need to guarantee that clients only have to keep around
737 * a single hw buffer length. */
740 pa_bytes_to_usec(left_to_play
, &u
->sink
->sample_spec
) > process_usec
+max_sleep_usec
/2)
743 if (PA_UNLIKELY(n_bytes
<= u
->hwbuf_unused
)) {
747 char *dn
= pa_alsa_get_driver_name_by_pcm(u
->pcm_handle
);
748 pa_log(_("ALSA woke us up to write new data to the device, but there was actually nothing to write!\n"
749 "Most likely this is a bug in the ALSA driver '%s'. Please report this issue to the ALSA developers.\n"
750 "We were woken up with POLLOUT set -- however a subsequent snd_pcm_avail() returned 0 or another value < min_avail."),
760 pa_log_debug("Not filling up, because already too many iterations.");
766 n_bytes
-= u
->hwbuf_unused
;
770 snd_pcm_sframes_t frames
;
774 /* pa_log_debug("%lu frames to write", (unsigned long) frames); */
776 if (u
->memchunk
.length
<= 0)
777 pa_sink_render(u
->sink
, n_bytes
, &u
->memchunk
);
779 pa_assert(u
->memchunk
.length
> 0);
781 frames
= (snd_pcm_sframes_t
) (u
->memchunk
.length
/ u
->frame_size
);
783 if (frames
> (snd_pcm_sframes_t
) (n_bytes
/u
->frame_size
))
784 frames
= (snd_pcm_sframes_t
) (n_bytes
/u
->frame_size
);
786 p
= pa_memblock_acquire(u
->memchunk
.memblock
);
787 frames
= snd_pcm_writei(u
->pcm_handle
, (const uint8_t*) p
+ u
->memchunk
.index
, (snd_pcm_uframes_t
) frames
);
788 pa_memblock_release(u
->memchunk
.memblock
);
790 if (PA_UNLIKELY(frames
< 0)) {
792 if (!after_avail
&& (int) frames
== -EAGAIN
)
795 if ((r
= try_recover(u
, "snd_pcm_writei", (int) frames
)) == 0)
801 if (!after_avail
&& frames
== 0)
804 pa_assert(frames
> 0);
807 written
= frames
* u
->frame_size
;
808 u
->memchunk
.index
+= written
;
809 u
->memchunk
.length
-= written
;
811 if (u
->memchunk
.length
<= 0) {
812 pa_memblock_unref(u
->memchunk
.memblock
);
813 pa_memchunk_reset(&u
->memchunk
);
818 u
->write_count
+= written
;
819 u
->since_start
+= written
;
821 /* pa_log_debug("wrote %lu frames", (unsigned long) frames); */
823 if (written
>= n_bytes
)
830 input_underrun
= pa_sink_process_input_underruns(u
->sink
, left_to_play
);
833 pa_usec_t underrun_sleep
= pa_bytes_to_usec_round_up(input_underrun
, &u
->sink
->sample_spec
);
835 *sleep_usec
= pa_bytes_to_usec(left_to_play
, &u
->sink
->sample_spec
);
836 process_usec
= u
->tsched_watermark_usec
;
838 if (*sleep_usec
> process_usec
)
839 *sleep_usec
-= process_usec
;
843 *sleep_usec
= PA_MIN(*sleep_usec
, underrun_sleep
);
847 return work_done
? 1 : 0;
850 static void update_smoother(struct userdata
*u
) {
851 snd_pcm_sframes_t delay
= 0;
854 pa_usec_t now1
= 0, now2
;
855 snd_pcm_status_t
*status
;
856 snd_htimestamp_t htstamp
= { 0, 0 };
858 snd_pcm_status_alloca(&status
);
861 pa_assert(u
->pcm_handle
);
863 /* Let's update the time smoother */
865 if (PA_UNLIKELY((err
= pa_alsa_safe_delay(u
->pcm_handle
, status
, &delay
, u
->hwbuf_size
, &u
->sink
->sample_spec
, false)) < 0)) {
866 pa_log_warn("Failed to query DSP status data: %s", pa_alsa_strerror(err
));
870 snd_pcm_status_get_htstamp(status
, &htstamp
);
871 now1
= pa_timespec_load(&htstamp
);
873 /* Hmm, if the timestamp is 0, then it wasn't set and we take the current time */
875 now1
= pa_rtclock_now();
877 /* check if the time since the last update is bigger than the interval */
878 if (u
->last_smoother_update
> 0)
879 if (u
->last_smoother_update
+ u
->smoother_interval
> now1
)
882 position
= (int64_t) u
->write_count
- ((int64_t) delay
* (int64_t) u
->frame_size
);
884 if (PA_UNLIKELY(position
< 0))
887 now2
= pa_bytes_to_usec((uint64_t) position
, &u
->sink
->sample_spec
);
889 pa_smoother_put(u
->smoother
, now1
, now2
);
891 u
->last_smoother_update
= now1
;
892 /* exponentially increase the update interval up to the MAX limit */
893 u
->smoother_interval
= PA_MIN (u
->smoother_interval
* 2, SMOOTHER_MAX_INTERVAL
);
896 static pa_usec_t
sink_get_latency(struct userdata
*u
) {
899 pa_usec_t now1
, now2
;
903 now1
= pa_rtclock_now();
904 now2
= pa_smoother_get(u
->smoother
, now1
);
906 delay
= (int64_t) pa_bytes_to_usec(u
->write_count
, &u
->sink
->sample_spec
) - (int64_t) now2
;
908 r
= delay
>= 0 ? (pa_usec_t
) delay
: 0;
910 if (u
->memchunk
.memblock
)
911 r
+= pa_bytes_to_usec(u
->memchunk
.length
, &u
->sink
->sample_spec
);
916 static int build_pollfd(struct userdata
*u
) {
918 pa_assert(u
->pcm_handle
);
920 if (u
->alsa_rtpoll_item
)
921 pa_rtpoll_item_free(u
->alsa_rtpoll_item
);
923 if (!(u
->alsa_rtpoll_item
= pa_alsa_build_pollfd(u
->pcm_handle
, u
->rtpoll
)))
929 /* Called from IO context */
930 static int suspend(struct userdata
*u
) {
932 pa_assert(u
->pcm_handle
);
934 pa_smoother_pause(u
->smoother
, pa_rtclock_now());
936 /* Let's suspend -- we don't call snd_pcm_drain() here since that might
937 * take awfully long with our long buffer sizes today. */
938 snd_pcm_close(u
->pcm_handle
);
939 u
->pcm_handle
= NULL
;
941 if (u
->alsa_rtpoll_item
) {
942 pa_rtpoll_item_free(u
->alsa_rtpoll_item
);
943 u
->alsa_rtpoll_item
= NULL
;
946 /* We reset max_rewind/max_request here to make sure that while we
947 * are suspended the old max_request/max_rewind values set before
948 * the suspend can influence the per-stream buffer of newly
949 * created streams, without their requirements having any
950 * influence on them. */
951 pa_sink_set_max_rewind_within_thread(u
->sink
, 0);
952 pa_sink_set_max_request_within_thread(u
->sink
, 0);
954 pa_log_info("Device suspended...");
959 /* Called from IO context */
960 static int update_sw_params(struct userdata
*u
) {
961 snd_pcm_uframes_t avail_min
;
966 /* Use the full buffer if no one asked us for anything specific */
972 if ((latency
= pa_sink_get_requested_latency_within_thread(u
->sink
)) != (pa_usec_t
) -1) {
975 pa_log_debug("Latency set to %0.2fms", (double) latency
/ PA_USEC_PER_MSEC
);
977 b
= pa_usec_to_bytes(latency
, &u
->sink
->sample_spec
);
979 /* We need at least one sample in our buffer */
981 if (PA_UNLIKELY(b
< u
->frame_size
))
984 u
->hwbuf_unused
= PA_LIKELY(b
< u
->hwbuf_size
) ? (u
->hwbuf_size
- b
) : 0;
987 fix_min_sleep_wakeup(u
);
988 fix_tsched_watermark(u
);
991 pa_log_debug("hwbuf_unused=%lu", (unsigned long) u
->hwbuf_unused
);
993 /* We need at last one frame in the used part of the buffer */
994 avail_min
= (snd_pcm_uframes_t
) u
->hwbuf_unused
/ u
->frame_size
+ 1;
997 pa_usec_t sleep_usec
, process_usec
;
999 hw_sleep_time(u
, &sleep_usec
, &process_usec
);
1000 avail_min
+= pa_usec_to_bytes(sleep_usec
, &u
->sink
->sample_spec
) / u
->frame_size
;
1003 pa_log_debug("setting avail_min=%lu", (unsigned long) avail_min
);
1005 if ((err
= pa_alsa_set_sw_params(u
->pcm_handle
, avail_min
, !u
->use_tsched
)) < 0) {
1006 pa_log("Failed to set software parameters: %s", pa_alsa_strerror(err
));
1010 pa_sink_set_max_request_within_thread(u
->sink
, u
->hwbuf_size
- u
->hwbuf_unused
);
1011 if (pa_alsa_pcm_is_hw(u
->pcm_handle
))
1012 pa_sink_set_max_rewind_within_thread(u
->sink
, u
->hwbuf_size
);
1014 pa_log_info("Disabling rewind_within_thread for device %s", u
->device_name
);
1015 pa_sink_set_max_rewind_within_thread(u
->sink
, 0);
1021 /* Called from IO Context on unsuspend or from main thread when creating sink */
1022 static void reset_watermark(struct userdata
*u
, size_t tsched_watermark
, pa_sample_spec
*ss
,
1024 u
->tsched_watermark
= pa_usec_to_bytes_round_up(pa_bytes_to_usec_round_up(tsched_watermark
, ss
),
1025 &u
->sink
->sample_spec
);
1027 u
->watermark_inc_step
= pa_usec_to_bytes(TSCHED_WATERMARK_INC_STEP_USEC
, &u
->sink
->sample_spec
);
1028 u
->watermark_dec_step
= pa_usec_to_bytes(TSCHED_WATERMARK_DEC_STEP_USEC
, &u
->sink
->sample_spec
);
1030 u
->watermark_inc_threshold
= pa_usec_to_bytes_round_up(TSCHED_WATERMARK_INC_THRESHOLD_USEC
, &u
->sink
->sample_spec
);
1031 u
->watermark_dec_threshold
= pa_usec_to_bytes_round_up(TSCHED_WATERMARK_DEC_THRESHOLD_USEC
, &u
->sink
->sample_spec
);
1033 fix_min_sleep_wakeup(u
);
1034 fix_tsched_watermark(u
);
1037 pa_sink_set_latency_range_within_thread(u
->sink
,
1039 pa_bytes_to_usec(u
->hwbuf_size
, ss
));
1041 pa_sink_set_latency_range(u
->sink
,
1043 pa_bytes_to_usec(u
->hwbuf_size
, ss
));
1045 /* work-around assert in pa_sink_set_latency_within_thead,
1046 keep track of min_latency and reuse it when
1047 this routine is called from IO context */
1048 u
->min_latency_ref
= u
->sink
->thread_info
.min_latency
;
1051 pa_log_info("Time scheduling watermark is %0.2fms",
1052 (double) u
->tsched_watermark_usec
/ PA_USEC_PER_MSEC
);
1055 /* Called from IO context */
1056 static int unsuspend(struct userdata
*u
) {
1060 snd_pcm_uframes_t period_size
, buffer_size
;
1061 char *device_name
= NULL
;
1064 pa_assert(!u
->pcm_handle
);
1066 pa_log_info("Trying resume...");
1068 if ((is_iec958(u
) || is_hdmi(u
)) && pa_sink_is_passthrough(u
->sink
)) {
1069 /* Need to open device in NONAUDIO mode */
1070 int len
= strlen(u
->device_name
) + 8;
1072 device_name
= pa_xmalloc(len
);
1073 pa_snprintf(device_name
, len
, "%s,AES0=6", u
->device_name
);
1076 if ((err
= snd_pcm_open(&u
->pcm_handle
, device_name
? device_name
: u
->device_name
, SND_PCM_STREAM_PLAYBACK
,
1078 SND_PCM_NO_AUTO_RESAMPLE
|
1079 SND_PCM_NO_AUTO_CHANNELS
|
1080 SND_PCM_NO_AUTO_FORMAT
)) < 0) {
1081 pa_log("Error opening PCM device %s: %s", u
->device_name
, pa_alsa_strerror(err
));
1085 ss
= u
->sink
->sample_spec
;
1086 period_size
= u
->fragment_size
/ u
->frame_size
;
1087 buffer_size
= u
->hwbuf_size
/ u
->frame_size
;
1091 if ((err
= pa_alsa_set_hw_params(u
->pcm_handle
, &ss
, &period_size
, &buffer_size
, 0, &b
, &d
, true)) < 0) {
1092 pa_log("Failed to set hardware parameters: %s", pa_alsa_strerror(err
));
1096 if (b
!= u
->use_mmap
|| d
!= u
->use_tsched
) {
1097 pa_log_warn("Resume failed, couldn't get original access mode.");
1101 if (!pa_sample_spec_equal(&ss
, &u
->sink
->sample_spec
)) {
1102 pa_log_warn("Resume failed, couldn't restore original sample settings.");
1106 if (period_size
*u
->frame_size
!= u
->fragment_size
||
1107 buffer_size
*u
->frame_size
!= u
->hwbuf_size
) {
1108 pa_log_warn("Resume failed, couldn't restore original fragment settings. (Old: %lu/%lu, New %lu/%lu)",
1109 (unsigned long) u
->hwbuf_size
, (unsigned long) u
->fragment_size
,
1110 (unsigned long) (buffer_size
*u
->frame_size
), (unsigned long) (period_size
*u
->frame_size
));
1114 if (update_sw_params(u
) < 0)
1117 if (build_pollfd(u
) < 0)
1121 pa_smoother_reset(u
->smoother
, pa_rtclock_now(), true);
1122 u
->smoother_interval
= SMOOTHER_MIN_INTERVAL
;
1123 u
->last_smoother_update
= 0;
1128 /* reset the watermark to the value defined when sink was created */
1130 reset_watermark(u
, u
->tsched_watermark_ref
, &u
->sink
->sample_spec
, true);
1132 pa_log_info("Resumed successfully...");
1134 pa_xfree(device_name
);
1138 if (u
->pcm_handle
) {
1139 snd_pcm_close(u
->pcm_handle
);
1140 u
->pcm_handle
= NULL
;
1143 pa_xfree(device_name
);
1148 /* Called from IO context */
1149 static int sink_process_msg(pa_msgobject
*o
, int code
, void *data
, int64_t offset
, pa_memchunk
*chunk
) {
1150 struct userdata
*u
= PA_SINK(o
)->userdata
;
1154 case PA_SINK_MESSAGE_GET_LATENCY
: {
1158 r
= sink_get_latency(u
);
1160 *((pa_usec_t
*) data
) = r
;
1165 case PA_SINK_MESSAGE_SET_STATE
:
1167 switch ((pa_sink_state_t
) PA_PTR_TO_UINT(data
)) {
1169 case PA_SINK_SUSPENDED
: {
1172 pa_assert(PA_SINK_IS_OPENED(u
->sink
->thread_info
.state
));
1174 if ((r
= suspend(u
)) < 0)
1181 case PA_SINK_RUNNING
: {
1184 if (u
->sink
->thread_info
.state
== PA_SINK_INIT
) {
1185 if (build_pollfd(u
) < 0)
1189 if (u
->sink
->thread_info
.state
== PA_SINK_SUSPENDED
) {
1190 if ((r
= unsuspend(u
)) < 0)
1197 case PA_SINK_UNLINKED
:
1199 case PA_SINK_INVALID_STATE
:
1206 return pa_sink_process_msg(o
, code
, data
, offset
, chunk
);
1209 /* Called from main context */
1210 static int sink_set_state_cb(pa_sink
*s
, pa_sink_state_t new_state
) {
1211 pa_sink_state_t old_state
;
1214 pa_sink_assert_ref(s
);
1215 pa_assert_se(u
= s
->userdata
);
1217 old_state
= pa_sink_get_state(u
->sink
);
1219 if (PA_SINK_IS_OPENED(old_state
) && new_state
== PA_SINK_SUSPENDED
)
1221 else if (old_state
== PA_SINK_SUSPENDED
&& PA_SINK_IS_OPENED(new_state
))
1222 if (reserve_init(u
, u
->device_name
) < 0)
1223 return -PA_ERR_BUSY
;
1228 static int ctl_mixer_callback(snd_mixer_elem_t
*elem
, unsigned int mask
) {
1229 struct userdata
*u
= snd_mixer_elem_get_callback_private(elem
);
1232 pa_assert(u
->mixer_handle
);
1234 if (mask
== SND_CTL_EVENT_MASK_REMOVE
)
1237 if (!PA_SINK_IS_LINKED(u
->sink
->state
))
1240 if (u
->sink
->suspend_cause
& PA_SUSPEND_SESSION
) {
1241 pa_sink_set_mixer_dirty(u
->sink
, true);
1245 if (mask
& SND_CTL_EVENT_MASK_VALUE
) {
1246 pa_sink_get_volume(u
->sink
, true);
1247 pa_sink_get_mute(u
->sink
, true);
1253 static int io_mixer_callback(snd_mixer_elem_t
*elem
, unsigned int mask
) {
1254 struct userdata
*u
= snd_mixer_elem_get_callback_private(elem
);
1257 pa_assert(u
->mixer_handle
);
1259 if (mask
== SND_CTL_EVENT_MASK_REMOVE
)
1262 if (u
->sink
->suspend_cause
& PA_SUSPEND_SESSION
) {
1263 pa_sink_set_mixer_dirty(u
->sink
, true);
1267 if (mask
& SND_CTL_EVENT_MASK_VALUE
)
1268 pa_sink_update_volume_and_mute(u
->sink
);
1273 static void sink_get_volume_cb(pa_sink
*s
) {
1274 struct userdata
*u
= s
->userdata
;
1276 char volume_buf
[PA_CVOLUME_SNPRINT_VERBOSE_MAX
];
1279 pa_assert(u
->mixer_path
);
1280 pa_assert(u
->mixer_handle
);
1282 if (pa_alsa_path_get_volume(u
->mixer_path
, u
->mixer_handle
, &s
->channel_map
, &r
) < 0)
1285 /* Shift down by the base volume, so that 0dB becomes maximum volume */
1286 pa_sw_cvolume_multiply_scalar(&r
, &r
, s
->base_volume
);
1288 pa_log_debug("Read hardware volume: %s",
1289 pa_cvolume_snprint_verbose(volume_buf
, sizeof(volume_buf
), &r
, &s
->channel_map
, u
->mixer_path
->has_dB
));
1291 if (pa_cvolume_equal(&u
->hardware_volume
, &r
))
1294 s
->real_volume
= u
->hardware_volume
= r
;
1296 /* Hmm, so the hardware volume changed, let's reset our software volume */
1297 if (u
->mixer_path
->has_dB
)
1298 pa_sink_set_soft_volume(s
, NULL
);
1301 static void sink_set_volume_cb(pa_sink
*s
) {
1302 struct userdata
*u
= s
->userdata
;
1304 char volume_buf
[PA_CVOLUME_SNPRINT_VERBOSE_MAX
];
1305 bool deferred_volume
= !!(s
->flags
& PA_SINK_DEFERRED_VOLUME
);
1308 pa_assert(u
->mixer_path
);
1309 pa_assert(u
->mixer_handle
);
1311 /* Shift up by the base volume */
1312 pa_sw_cvolume_divide_scalar(&r
, &s
->real_volume
, s
->base_volume
);
1314 if (pa_alsa_path_set_volume(u
->mixer_path
, u
->mixer_handle
, &s
->channel_map
, &r
, deferred_volume
, !deferred_volume
) < 0)
1317 /* Shift down by the base volume, so that 0dB becomes maximum volume */
1318 pa_sw_cvolume_multiply_scalar(&r
, &r
, s
->base_volume
);
1320 u
->hardware_volume
= r
;
1322 if (u
->mixer_path
->has_dB
) {
1323 pa_cvolume new_soft_volume
;
1324 bool accurate_enough
;
1326 /* Match exactly what the user requested by software */
1327 pa_sw_cvolume_divide(&new_soft_volume
, &s
->real_volume
, &u
->hardware_volume
);
1329 /* If the adjustment to do in software is only minimal we
1330 * can skip it. That saves us CPU at the expense of a bit of
1333 (pa_cvolume_min(&new_soft_volume
) >= (PA_VOLUME_NORM
- VOLUME_ACCURACY
)) &&
1334 (pa_cvolume_max(&new_soft_volume
) <= (PA_VOLUME_NORM
+ VOLUME_ACCURACY
));
1336 pa_log_debug("Requested volume: %s",
1337 pa_cvolume_snprint_verbose(volume_buf
, sizeof(volume_buf
), &s
->real_volume
, &s
->channel_map
, true));
1338 pa_log_debug("Got hardware volume: %s",
1339 pa_cvolume_snprint_verbose(volume_buf
, sizeof(volume_buf
), &u
->hardware_volume
, &s
->channel_map
, true));
1340 pa_log_debug("Calculated software volume: %s (accurate-enough=%s)",
1341 pa_cvolume_snprint_verbose(volume_buf
, sizeof(volume_buf
), &new_soft_volume
, &s
->channel_map
, true),
1342 pa_yes_no(accurate_enough
));
1344 if (!accurate_enough
)
1345 s
->soft_volume
= new_soft_volume
;
1348 pa_log_debug("Wrote hardware volume: %s",
1349 pa_cvolume_snprint_verbose(volume_buf
, sizeof(volume_buf
), &r
, &s
->channel_map
, false));
1351 /* We can't match exactly what the user requested, hence let's
1352 * at least tell the user about it */
1358 static void sink_write_volume_cb(pa_sink
*s
) {
1359 struct userdata
*u
= s
->userdata
;
1360 pa_cvolume hw_vol
= s
->thread_info
.current_hw_volume
;
1363 pa_assert(u
->mixer_path
);
1364 pa_assert(u
->mixer_handle
);
1365 pa_assert(s
->flags
& PA_SINK_DEFERRED_VOLUME
);
1367 /* Shift up by the base volume */
1368 pa_sw_cvolume_divide_scalar(&hw_vol
, &hw_vol
, s
->base_volume
);
1370 if (pa_alsa_path_set_volume(u
->mixer_path
, u
->mixer_handle
, &s
->channel_map
, &hw_vol
, true, true) < 0)
1371 pa_log_error("Writing HW volume failed");
1374 bool accurate_enough
;
1376 /* Shift down by the base volume, so that 0dB becomes maximum volume */
1377 pa_sw_cvolume_multiply_scalar(&hw_vol
, &hw_vol
, s
->base_volume
);
1379 pa_sw_cvolume_divide(&tmp_vol
, &hw_vol
, &s
->thread_info
.current_hw_volume
);
1381 (pa_cvolume_min(&tmp_vol
) >= (PA_VOLUME_NORM
- VOLUME_ACCURACY
)) &&
1382 (pa_cvolume_max(&tmp_vol
) <= (PA_VOLUME_NORM
+ VOLUME_ACCURACY
));
1384 if (!accurate_enough
) {
1385 char volume_buf
[2][PA_CVOLUME_SNPRINT_VERBOSE_MAX
];
1387 pa_log_debug("Written HW volume did not match with the request: %s (request) != %s",
1388 pa_cvolume_snprint_verbose(volume_buf
[0],
1389 sizeof(volume_buf
[0]),
1390 &s
->thread_info
.current_hw_volume
,
1393 pa_cvolume_snprint_verbose(volume_buf
[1], sizeof(volume_buf
[1]), &hw_vol
, &s
->channel_map
, true));
1398 static void sink_get_mute_cb(pa_sink
*s
) {
1399 struct userdata
*u
= s
->userdata
;
1403 pa_assert(u
->mixer_path
);
1404 pa_assert(u
->mixer_handle
);
1406 if (pa_alsa_path_get_mute(u
->mixer_path
, u
->mixer_handle
, &b
) < 0)
1412 static void sink_set_mute_cb(pa_sink
*s
) {
1413 struct userdata
*u
= s
->userdata
;
1416 pa_assert(u
->mixer_path
);
1417 pa_assert(u
->mixer_handle
);
1419 pa_alsa_path_set_mute(u
->mixer_path
, u
->mixer_handle
, s
->muted
);
1422 static void mixer_volume_init(struct userdata
*u
) {
1425 if (!u
->mixer_path
->has_volume
) {
1426 pa_sink_set_write_volume_callback(u
->sink
, NULL
);
1427 pa_sink_set_get_volume_callback(u
->sink
, NULL
);
1428 pa_sink_set_set_volume_callback(u
->sink
, NULL
);
1430 pa_log_info("Driver does not support hardware volume control, falling back to software volume control.");
1432 pa_sink_set_get_volume_callback(u
->sink
, sink_get_volume_cb
);
1433 pa_sink_set_set_volume_callback(u
->sink
, sink_set_volume_cb
);
1435 if (u
->mixer_path
->has_dB
&& u
->deferred_volume
) {
1436 pa_sink_set_write_volume_callback(u
->sink
, sink_write_volume_cb
);
1437 pa_log_info("Successfully enabled deferred volume.");
1439 pa_sink_set_write_volume_callback(u
->sink
, NULL
);
1441 if (u
->mixer_path
->has_dB
) {
1442 pa_sink_enable_decibel_volume(u
->sink
, true);
1443 pa_log_info("Hardware volume ranges from %0.2f dB to %0.2f dB.", u
->mixer_path
->min_dB
, u
->mixer_path
->max_dB
);
1445 u
->sink
->base_volume
= pa_sw_volume_from_dB(-u
->mixer_path
->max_dB
);
1446 u
->sink
->n_volume_steps
= PA_VOLUME_NORM
+1;
1448 pa_log_info("Fixing base volume to %0.2f dB", pa_sw_volume_to_dB(u
->sink
->base_volume
));
1450 pa_sink_enable_decibel_volume(u
->sink
, false);
1451 pa_log_info("Hardware volume ranges from %li to %li.", u
->mixer_path
->min_volume
, u
->mixer_path
->max_volume
);
1453 u
->sink
->base_volume
= PA_VOLUME_NORM
;
1454 u
->sink
->n_volume_steps
= u
->mixer_path
->max_volume
- u
->mixer_path
->min_volume
+ 1;
1457 pa_log_info("Using hardware volume control. Hardware dB scale %s.", u
->mixer_path
->has_dB
? "supported" : "not supported");
1460 if (!u
->mixer_path
->has_mute
) {
1461 pa_sink_set_get_mute_callback(u
->sink
, NULL
);
1462 pa_sink_set_set_mute_callback(u
->sink
, NULL
);
1463 pa_log_info("Driver does not support hardware mute control, falling back to software mute control.");
1465 pa_sink_set_get_mute_callback(u
->sink
, sink_get_mute_cb
);
1466 pa_sink_set_set_mute_callback(u
->sink
, sink_set_mute_cb
);
1467 pa_log_info("Using hardware mute control.");
1471 static int sink_set_port_ucm_cb(pa_sink
*s
, pa_device_port
*p
) {
1472 struct userdata
*u
= s
->userdata
;
1476 pa_assert(u
->ucm_context
);
1478 return pa_alsa_ucm_set_port(u
->ucm_context
, p
, true);
1481 static int sink_set_port_cb(pa_sink
*s
, pa_device_port
*p
) {
1482 struct userdata
*u
= s
->userdata
;
1483 pa_alsa_port_data
*data
;
1487 pa_assert(u
->mixer_handle
);
1489 data
= PA_DEVICE_PORT_DATA(p
);
1491 pa_assert_se(u
->mixer_path
= data
->path
);
1492 pa_alsa_path_select(u
->mixer_path
, data
->setting
, u
->mixer_handle
, s
->muted
);
1494 mixer_volume_init(u
);
1498 if (s
->flags
& PA_SINK_DEFERRED_VOLUME
) {
1499 if (s
->write_volume
)
1509 static void sink_update_requested_latency_cb(pa_sink
*s
) {
1510 struct userdata
*u
= s
->userdata
;
1513 pa_assert(u
->use_tsched
); /* only when timer scheduling is used
1514 * we can dynamically adjust the
1520 before
= u
->hwbuf_unused
;
1521 update_sw_params(u
);
1523 /* Let's check whether we now use only a smaller part of the
1524 buffer then before. If so, we need to make sure that subsequent
1525 rewinds are relative to the new maximum fill level and not to the
1526 current fill level. Thus, let's do a full rewind once, to clear
1529 if (u
->hwbuf_unused
> before
) {
1530 pa_log_debug("Requesting rewind due to latency change.");
1531 pa_sink_request_rewind(s
, (size_t) -1);
1535 static pa_idxset
* sink_get_formats(pa_sink
*s
) {
1536 struct userdata
*u
= s
->userdata
;
1540 return pa_idxset_copy(u
->formats
, (pa_copy_func_t
) pa_format_info_copy
);
1543 static bool sink_set_formats(pa_sink
*s
, pa_idxset
*formats
) {
1544 struct userdata
*u
= s
->userdata
;
1545 pa_format_info
*f
, *g
;
1550 /* FIXME: also validate sample rates against what the device supports */
1551 PA_IDXSET_FOREACH(f
, formats
, idx
) {
1552 if (is_iec958(u
) && f
->encoding
== PA_ENCODING_EAC3_IEC61937
)
1553 /* EAC3 cannot be sent over over S/PDIF */
1557 pa_idxset_free(u
->formats
, (pa_free_cb_t
) pa_format_info_free
);
1558 u
->formats
= pa_idxset_new(NULL
, NULL
);
1560 /* Note: the logic below won't apply if we're using software encoding.
1561 * This is fine for now since we don't support that via the passthrough
1562 * framework, but this must be changed if we do. */
1564 /* Count how many sample rates we support */
1565 for (idx
= 0, n
= 0; u
->rates
[idx
]; idx
++)
1568 /* First insert non-PCM formats since we prefer those. */
1569 PA_IDXSET_FOREACH(f
, formats
, idx
) {
1570 if (!pa_format_info_is_pcm(f
)) {
1571 g
= pa_format_info_copy(f
);
1572 pa_format_info_set_prop_int_array(g
, PA_PROP_FORMAT_RATE
, (int *) u
->rates
, n
);
1573 pa_idxset_put(u
->formats
, g
, NULL
);
1577 /* Now add any PCM formats */
1578 PA_IDXSET_FOREACH(f
, formats
, idx
) {
1579 if (pa_format_info_is_pcm(f
)) {
1580 /* We don't set rates here since we'll just tack on a resampler for
1581 * unsupported rates */
1582 pa_idxset_put(u
->formats
, pa_format_info_copy(f
), NULL
);
1589 static int sink_update_rate_cb(pa_sink
*s
, uint32_t rate
) {
1590 struct userdata
*u
= s
->userdata
;
1592 bool supported
= false;
1596 for (i
= 0; u
->rates
[i
]; i
++) {
1597 if (u
->rates
[i
] == rate
) {
1604 pa_log_info("Sink does not support sample rate of %d Hz", rate
);
1608 if (!PA_SINK_IS_OPENED(s
->state
)) {
1609 pa_log_info("Updating rate for device %s, new rate is %d",u
->device_name
, rate
);
1610 u
->sink
->sample_spec
.rate
= rate
;
1617 static int process_rewind(struct userdata
*u
) {
1618 snd_pcm_sframes_t unused
;
1619 size_t rewind_nbytes
, unused_nbytes
, limit_nbytes
;
1622 if (!PA_SINK_IS_OPENED(u
->sink
->thread_info
.state
)) {
1623 pa_sink_process_rewind(u
->sink
, 0);
1627 /* Figure out how much we shall rewind and reset the counter */
1628 rewind_nbytes
= u
->sink
->thread_info
.rewind_nbytes
;
1630 pa_log_debug("Requested to rewind %lu bytes.", (unsigned long) rewind_nbytes
);
1632 if (PA_UNLIKELY((unused
= pa_alsa_safe_avail(u
->pcm_handle
, u
->hwbuf_size
, &u
->sink
->sample_spec
)) < 0)) {
1633 pa_log("snd_pcm_avail() failed: %s", pa_alsa_strerror((int) unused
));
1637 unused_nbytes
= (size_t) unused
* u
->frame_size
;
1639 /* make sure rewind doesn't go too far, can cause issues with DMAs */
1640 unused_nbytes
+= u
->rewind_safeguard
;
1642 if (u
->hwbuf_size
> unused_nbytes
)
1643 limit_nbytes
= u
->hwbuf_size
- unused_nbytes
;
1647 if (rewind_nbytes
> limit_nbytes
)
1648 rewind_nbytes
= limit_nbytes
;
1650 if (rewind_nbytes
> 0) {
1651 snd_pcm_sframes_t in_frames
, out_frames
;
1653 pa_log_debug("Limited to %lu bytes.", (unsigned long) rewind_nbytes
);
1655 in_frames
= (snd_pcm_sframes_t
) (rewind_nbytes
/ u
->frame_size
);
1656 pa_log_debug("before: %lu", (unsigned long) in_frames
);
1657 if ((out_frames
= snd_pcm_rewind(u
->pcm_handle
, (snd_pcm_uframes_t
) in_frames
)) < 0) {
1658 pa_log("snd_pcm_rewind() failed: %s", pa_alsa_strerror((int) out_frames
));
1659 if (try_recover(u
, "process_rewind", out_frames
) < 0)
1664 pa_log_debug("after: %lu", (unsigned long) out_frames
);
1666 rewind_nbytes
= (size_t) out_frames
* u
->frame_size
;
1668 if (rewind_nbytes
<= 0)
1669 pa_log_info("Tried rewind, but was apparently not possible.");
1671 u
->write_count
-= rewind_nbytes
;
1672 pa_log_debug("Rewound %lu bytes.", (unsigned long) rewind_nbytes
);
1673 pa_sink_process_rewind(u
->sink
, rewind_nbytes
);
1675 u
->after_rewind
= true;
1679 pa_log_debug("Mhmm, actually there is nothing to rewind.");
1681 pa_sink_process_rewind(u
->sink
, 0);
1685 static void thread_func(void *userdata
) {
1686 struct userdata
*u
= userdata
;
1687 unsigned short revents
= 0;
1691 pa_log_debug("Thread starting up");
1693 if (u
->core
->realtime_scheduling
)
1694 pa_make_realtime(u
->core
->realtime_priority
);
1696 pa_thread_mq_install(&u
->thread_mq
);
1700 pa_usec_t rtpoll_sleep
= 0, real_sleep
;
1703 pa_log_debug("Loop");
1706 if (PA_UNLIKELY(u
->sink
->thread_info
.rewind_requested
)) {
1707 if (process_rewind(u
) < 0)
1711 /* Render some data and write it to the dsp */
1712 if (PA_SINK_IS_OPENED(u
->sink
->thread_info
.state
)) {
1714 pa_usec_t sleep_usec
= 0;
1715 bool on_timeout
= pa_rtpoll_timer_elapsed(u
->rtpoll
);
1718 work_done
= mmap_write(u
, &sleep_usec
, revents
& POLLOUT
, on_timeout
);
1720 work_done
= unix_write(u
, &sleep_usec
, revents
& POLLOUT
, on_timeout
);
1725 /* pa_log_debug("work_done = %i", work_done); */
1730 pa_log_info("Starting playback.");
1731 snd_pcm_start(u
->pcm_handle
);
1733 pa_smoother_resume(u
->smoother
, pa_rtclock_now(), true);
1741 if (u
->use_tsched
) {
1744 if (u
->since_start
<= u
->hwbuf_size
) {
1746 /* USB devices on ALSA seem to hit a buffer
1747 * underrun during the first iterations much
1748 * quicker then we calculate here, probably due to
1749 * the transport latency. To accommodate for that
1750 * we artificially decrease the sleep time until
1751 * we have filled the buffer at least once
1754 if (pa_log_ratelimit(PA_LOG_DEBUG
))
1755 pa_log_debug("Cutting sleep time for the initial iterations by half.");
1759 /* OK, the playback buffer is now full, let's
1760 * calculate when to wake up next */
1762 pa_log_debug("Waking up in %0.2fms (sound card clock).", (double) sleep_usec
/ PA_USEC_PER_MSEC
);
1765 /* Convert from the sound card time domain to the
1766 * system time domain */
1767 cusec
= pa_smoother_translate(u
->smoother
, pa_rtclock_now(), sleep_usec
);
1770 pa_log_debug("Waking up in %0.2fms (system clock).", (double) cusec
/ PA_USEC_PER_MSEC
);
1773 /* We don't trust the conversion, so we wake up whatever comes first */
1774 rtpoll_sleep
= PA_MIN(sleep_usec
, cusec
);
1777 u
->after_rewind
= false;
1781 if (u
->sink
->flags
& PA_SINK_DEFERRED_VOLUME
) {
1782 pa_usec_t volume_sleep
;
1783 pa_sink_volume_change_apply(u
->sink
, &volume_sleep
);
1784 if (volume_sleep
> 0) {
1785 if (rtpoll_sleep
> 0)
1786 rtpoll_sleep
= PA_MIN(volume_sleep
, rtpoll_sleep
);
1788 rtpoll_sleep
= volume_sleep
;
1792 if (rtpoll_sleep
> 0) {
1793 pa_rtpoll_set_timer_relative(u
->rtpoll
, rtpoll_sleep
);
1794 real_sleep
= pa_rtclock_now();
1797 pa_rtpoll_set_timer_disabled(u
->rtpoll
);
1799 /* Hmm, nothing to do. Let's sleep */
1800 if ((ret
= pa_rtpoll_run(u
->rtpoll
, true)) < 0)
1803 if (rtpoll_sleep
> 0) {
1804 real_sleep
= pa_rtclock_now() - real_sleep
;
1806 pa_log_debug("Expected sleep: %0.2fms, real sleep: %0.2fms (diff %0.2f ms)",
1807 (double) rtpoll_sleep
/ PA_USEC_PER_MSEC
, (double) real_sleep
/ PA_USEC_PER_MSEC
,
1808 (double) ((int64_t) real_sleep
- (int64_t) rtpoll_sleep
) / PA_USEC_PER_MSEC
);
1810 if (u
->use_tsched
&& real_sleep
> rtpoll_sleep
+ u
->tsched_watermark_usec
)
1811 pa_log_info("Scheduling delay of %0.2f ms > %0.2f ms, you might want to investigate this to improve latency...",
1812 (double) (real_sleep
- rtpoll_sleep
) / PA_USEC_PER_MSEC
,
1813 (double) (u
->tsched_watermark_usec
) / PA_USEC_PER_MSEC
);
1816 if (u
->sink
->flags
& PA_SINK_DEFERRED_VOLUME
)
1817 pa_sink_volume_change_apply(u
->sink
, NULL
);
1822 /* Tell ALSA about this and process its response */
1823 if (PA_SINK_IS_OPENED(u
->sink
->thread_info
.state
)) {
1824 struct pollfd
*pollfd
;
1828 pollfd
= pa_rtpoll_item_get_pollfd(u
->alsa_rtpoll_item
, &n
);
1830 if ((err
= snd_pcm_poll_descriptors_revents(u
->pcm_handle
, pollfd
, n
, &revents
)) < 0) {
1831 pa_log("snd_pcm_poll_descriptors_revents() failed: %s", pa_alsa_strerror(err
));
1835 if (revents
& ~POLLOUT
) {
1836 if (pa_alsa_recover_from_poll(u
->pcm_handle
, revents
) < 0)
1842 } else if (revents
&& u
->use_tsched
&& pa_log_ratelimit(PA_LOG_DEBUG
))
1843 pa_log_debug("Wakeup from ALSA!");
1850 /* If this was no regular exit from the loop we have to continue
1851 * processing messages until we received PA_MESSAGE_SHUTDOWN */
1852 pa_asyncmsgq_post(u
->thread_mq
.outq
, PA_MSGOBJECT(u
->core
), PA_CORE_MESSAGE_UNLOAD_MODULE
, u
->module
, 0, NULL
, NULL
);
1853 pa_asyncmsgq_wait_for(u
->thread_mq
.inq
, PA_MESSAGE_SHUTDOWN
);
1856 pa_log_debug("Thread shutting down");
1859 static void set_sink_name(pa_sink_new_data
*data
, pa_modargs
*ma
, const char *device_id
, const char *device_name
, pa_alsa_mapping
*mapping
) {
1865 pa_assert(device_name
);
1867 if ((n
= pa_modargs_get_value(ma
, "sink_name", NULL
))) {
1868 pa_sink_new_data_set_name(data
, n
);
1869 data
->namereg_fail
= true;
1873 if ((n
= pa_modargs_get_value(ma
, "name", NULL
)))
1874 data
->namereg_fail
= true;
1876 n
= device_id
? device_id
: device_name
;
1877 data
->namereg_fail
= false;
1881 t
= pa_sprintf_malloc("alsa_output.%s.%s", n
, mapping
->name
);
1883 t
= pa_sprintf_malloc("alsa_output.%s", n
);
1885 pa_sink_new_data_set_name(data
, t
);
1889 static void find_mixer(struct userdata
*u
, pa_alsa_mapping
*mapping
, const char *element
, bool ignore_dB
) {
1892 if (!mapping
&& !element
)
1895 if (!(u
->mixer_handle
= pa_alsa_open_mixer_for_pcm(u
->pcm_handle
, &u
->control_device
, &hctl
))) {
1896 pa_log_info("Failed to find a working mixer device.");
1902 if (!(u
->mixer_path
= pa_alsa_path_synthesize(element
, PA_ALSA_DIRECTION_OUTPUT
)))
1905 if (pa_alsa_path_probe(u
->mixer_path
, u
->mixer_handle
, hctl
, ignore_dB
) < 0)
1908 pa_log_debug("Probed mixer path %s:", u
->mixer_path
->name
);
1909 pa_alsa_path_dump(u
->mixer_path
);
1910 } else if (!(u
->mixer_path_set
= mapping
->output_path_set
))
1917 if (u
->mixer_path
) {
1918 pa_alsa_path_free(u
->mixer_path
);
1919 u
->mixer_path
= NULL
;
1922 if (u
->mixer_handle
) {
1923 snd_mixer_close(u
->mixer_handle
);
1924 u
->mixer_handle
= NULL
;
1928 static int setup_mixer(struct userdata
*u
, bool ignore_dB
) {
1929 bool need_mixer_callback
= false;
1933 if (!u
->mixer_handle
)
1936 if (u
->sink
->active_port
) {
1937 pa_alsa_port_data
*data
;
1939 /* We have a list of supported paths, so let's activate the
1940 * one that has been chosen as active */
1942 data
= PA_DEVICE_PORT_DATA(u
->sink
->active_port
);
1943 u
->mixer_path
= data
->path
;
1945 pa_alsa_path_select(data
->path
, data
->setting
, u
->mixer_handle
, u
->sink
->muted
);
1949 if (!u
->mixer_path
&& u
->mixer_path_set
)
1950 u
->mixer_path
= pa_hashmap_first(u
->mixer_path_set
->paths
);
1952 if (u
->mixer_path
) {
1953 /* Hmm, we have only a single path, then let's activate it */
1955 pa_alsa_path_select(u
->mixer_path
, u
->mixer_path
->settings
, u
->mixer_handle
, u
->sink
->muted
);
1961 mixer_volume_init(u
);
1963 /* Will we need to register callbacks? */
1964 if (u
->mixer_path_set
&& u
->mixer_path_set
->paths
) {
1968 PA_HASHMAP_FOREACH(p
, u
->mixer_path_set
->paths
, state
) {
1969 if (p
->has_volume
|| p
->has_mute
)
1970 need_mixer_callback
= true;
1973 else if (u
->mixer_path
)
1974 need_mixer_callback
= u
->mixer_path
->has_volume
|| u
->mixer_path
->has_mute
;
1976 if (need_mixer_callback
) {
1977 int (*mixer_callback
)(snd_mixer_elem_t
*, unsigned int);
1978 if (u
->sink
->flags
& PA_SINK_DEFERRED_VOLUME
) {
1979 u
->mixer_pd
= pa_alsa_mixer_pdata_new();
1980 mixer_callback
= io_mixer_callback
;
1982 if (pa_alsa_set_mixer_rtpoll(u
->mixer_pd
, u
->mixer_handle
, u
->rtpoll
) < 0) {
1983 pa_log("Failed to initialize file descriptor monitoring");
1987 u
->mixer_fdl
= pa_alsa_fdlist_new();
1988 mixer_callback
= ctl_mixer_callback
;
1990 if (pa_alsa_fdlist_set_handle(u
->mixer_fdl
, u
->mixer_handle
, NULL
, u
->core
->mainloop
) < 0) {
1991 pa_log("Failed to initialize file descriptor monitoring");
1996 if (u
->mixer_path_set
)
1997 pa_alsa_path_set_set_callback(u
->mixer_path_set
, u
->mixer_handle
, mixer_callback
, u
);
1999 pa_alsa_path_set_callback(u
->mixer_path
, u
->mixer_handle
, mixer_callback
, u
);
2005 pa_sink
*pa_alsa_sink_new(pa_module
*m
, pa_modargs
*ma
, const char*driver
, pa_card
*card
, pa_alsa_mapping
*mapping
) {
2007 struct userdata
*u
= NULL
;
2008 const char *dev_id
= NULL
, *key
, *mod_name
;
2010 char *thread_name
= NULL
;
2011 uint32_t alternate_sample_rate
;
2013 uint32_t nfrags
, frag_size
, buffer_size
, tsched_size
, tsched_watermark
, rewind_safeguard
;
2014 snd_pcm_uframes_t period_frames
, buffer_frames
, tsched_frames
;
2016 bool use_mmap
= true, b
, use_tsched
= true, d
, ignore_dB
= false, namereg_fail
= false, deferred_volume
= false, set_formats
= false, fixed_latency_range
= false;
2017 pa_sink_new_data data
;
2018 pa_alsa_profile_set
*profile_set
= NULL
;
2024 ss
= m
->core
->default_sample_spec
;
2025 map
= m
->core
->default_channel_map
;
2027 /* Pick sample spec overrides from the mapping, if any */
2029 if (mapping
->sample_spec
.format
!= PA_SAMPLE_INVALID
)
2030 ss
.format
= mapping
->sample_spec
.format
;
2031 if (mapping
->sample_spec
.rate
!= 0)
2032 ss
.rate
= mapping
->sample_spec
.rate
;
2033 if (mapping
->sample_spec
.channels
!= 0) {
2034 ss
.channels
= mapping
->sample_spec
.channels
;
2035 if (pa_channel_map_valid(&mapping
->channel_map
))
2036 pa_assert(pa_channel_map_compatible(&mapping
->channel_map
, &ss
));
2040 /* Override with modargs if provided */
2041 if (pa_modargs_get_sample_spec_and_channel_map(ma
, &ss
, &map
, PA_CHANNEL_MAP_ALSA
) < 0) {
2042 pa_log("Failed to parse sample specification and channel map");
2046 alternate_sample_rate
= m
->core
->alternate_sample_rate
;
2047 if (pa_modargs_get_alternate_sample_rate(ma
, &alternate_sample_rate
) < 0) {
2048 pa_log("Failed to parse alternate sample rate");
2052 frame_size
= pa_frame_size(&ss
);
2054 nfrags
= m
->core
->default_n_fragments
;
2055 frag_size
= (uint32_t) pa_usec_to_bytes(m
->core
->default_fragment_size_msec
*PA_USEC_PER_MSEC
, &ss
);
2057 frag_size
= (uint32_t) frame_size
;
2058 tsched_size
= (uint32_t) pa_usec_to_bytes(DEFAULT_TSCHED_BUFFER_USEC
, &ss
);
2059 tsched_watermark
= (uint32_t) pa_usec_to_bytes(DEFAULT_TSCHED_WATERMARK_USEC
, &ss
);
2061 if (pa_modargs_get_value_u32(ma
, "fragments", &nfrags
) < 0 ||
2062 pa_modargs_get_value_u32(ma
, "fragment_size", &frag_size
) < 0 ||
2063 pa_modargs_get_value_u32(ma
, "tsched_buffer_size", &tsched_size
) < 0 ||
2064 pa_modargs_get_value_u32(ma
, "tsched_buffer_watermark", &tsched_watermark
) < 0) {
2065 pa_log("Failed to parse buffer metrics");
2069 buffer_size
= nfrags
* frag_size
;
2071 period_frames
= frag_size
/frame_size
;
2072 buffer_frames
= buffer_size
/frame_size
;
2073 tsched_frames
= tsched_size
/frame_size
;
2075 if (pa_modargs_get_value_boolean(ma
, "mmap", &use_mmap
) < 0) {
2076 pa_log("Failed to parse mmap argument.");
2080 if (pa_modargs_get_value_boolean(ma
, "tsched", &use_tsched
) < 0) {
2081 pa_log("Failed to parse tsched argument.");
2085 if (pa_modargs_get_value_boolean(ma
, "ignore_dB", &ignore_dB
) < 0) {
2086 pa_log("Failed to parse ignore_dB argument.");
2090 rewind_safeguard
= PA_MAX(DEFAULT_REWIND_SAFEGUARD_BYTES
, pa_usec_to_bytes(DEFAULT_REWIND_SAFEGUARD_USEC
, &ss
));
2091 if (pa_modargs_get_value_u32(ma
, "rewind_safeguard", &rewind_safeguard
) < 0) {
2092 pa_log("Failed to parse rewind_safeguard argument");
2096 deferred_volume
= m
->core
->deferred_volume
;
2097 if (pa_modargs_get_value_boolean(ma
, "deferred_volume", &deferred_volume
) < 0) {
2098 pa_log("Failed to parse deferred_volume argument.");
2102 if (pa_modargs_get_value_boolean(ma
, "fixed_latency_range", &fixed_latency_range
) < 0) {
2103 pa_log("Failed to parse fixed_latency_range argument.");
2107 use_tsched
= pa_alsa_may_tsched(use_tsched
);
2109 u
= pa_xnew0(struct userdata
, 1);
2112 u
->use_mmap
= use_mmap
;
2113 u
->use_tsched
= use_tsched
;
2114 u
->deferred_volume
= deferred_volume
;
2115 u
->fixed_latency_range
= fixed_latency_range
;
2117 u
->rewind_safeguard
= rewind_safeguard
;
2118 u
->rtpoll
= pa_rtpoll_new();
2119 pa_thread_mq_init(&u
->thread_mq
, m
->core
->mainloop
, u
->rtpoll
);
2121 u
->smoother
= pa_smoother_new(
2122 SMOOTHER_ADJUST_USEC
,
2123 SMOOTHER_WINDOW_USEC
,
2129 u
->smoother_interval
= SMOOTHER_MIN_INTERVAL
;
2132 if (mapping
&& mapping
->ucm_context
.ucm
)
2133 u
->ucm_context
= &mapping
->ucm_context
;
2135 dev_id
= pa_modargs_get_value(
2137 pa_modargs_get_value(ma
, "device", DEFAULT_DEVICE
));
2139 u
->paths_dir
= pa_xstrdup(pa_modargs_get_value(ma
, "paths_dir", NULL
));
2141 if (reserve_init(u
, dev_id
) < 0)
2144 if (reserve_monitor_init(u
, dev_id
) < 0)
2152 if (!(dev_id
= pa_modargs_get_value(ma
, "device_id", NULL
))) {
2153 pa_log("device_id= not set");
2157 if ((mod_name
= pa_proplist_gets(mapping
->proplist
, PA_ALSA_PROP_UCM_MODIFIER
))) {
2158 if (snd_use_case_set(u
->ucm_context
->ucm
->ucm_mgr
, "_enamod", mod_name
) < 0)
2159 pa_log("Failed to enable ucm modifier %s", mod_name
);
2161 pa_log_debug("Enabled ucm modifier %s", mod_name
);
2164 if (!(u
->pcm_handle
= pa_alsa_open_by_device_id_mapping(
2168 SND_PCM_STREAM_PLAYBACK
,
2169 &period_frames
, &buffer_frames
, tsched_frames
,
2173 } else if ((dev_id
= pa_modargs_get_value(ma
, "device_id", NULL
))) {
2175 if (!(profile_set
= pa_alsa_profile_set_new(NULL
, &map
)))
2178 if (!(u
->pcm_handle
= pa_alsa_open_by_device_id_auto(
2182 SND_PCM_STREAM_PLAYBACK
,
2183 &period_frames
, &buffer_frames
, tsched_frames
,
2184 &b
, &d
, profile_set
, &mapping
)))
2189 if (!(u
->pcm_handle
= pa_alsa_open_by_device_string(
2190 pa_modargs_get_value(ma
, "device", DEFAULT_DEVICE
),
2193 SND_PCM_STREAM_PLAYBACK
,
2194 &period_frames
, &buffer_frames
, tsched_frames
,
2199 pa_assert(u
->device_name
);
2200 pa_log_info("Successfully opened device %s.", u
->device_name
);
2202 if (pa_alsa_pcm_is_modem(u
->pcm_handle
)) {
2203 pa_log_notice("Device %s is modem, refusing further initialization.", u
->device_name
);
2208 pa_log_info("Selected mapping '%s' (%s).", mapping
->description
, mapping
->name
);
2210 if (use_mmap
&& !b
) {
2211 pa_log_info("Device doesn't support mmap(), falling back to UNIX read/write mode.");
2212 u
->use_mmap
= use_mmap
= false;
2215 if (use_tsched
&& (!b
|| !d
)) {
2216 pa_log_info("Cannot enable timer-based scheduling, falling back to sound IRQ scheduling.");
2217 u
->use_tsched
= use_tsched
= false;
2221 pa_log_info("Successfully enabled mmap() mode.");
2223 if (u
->use_tsched
) {
2224 pa_log_info("Successfully enabled timer-based scheduling mode.");
2226 if (u
->fixed_latency_range
)
2227 pa_log_info("Disabling latency range changes on underrun");
2230 if (is_iec958(u
) || is_hdmi(u
))
2233 u
->rates
= pa_alsa_get_supported_rates(u
->pcm_handle
, ss
.rate
);
2235 pa_log_error("Failed to find any supported sample rates.");
2239 /* ALSA might tweak the sample spec, so recalculate the frame size */
2240 frame_size
= pa_frame_size(&ss
);
2242 if (!u
->ucm_context
)
2243 find_mixer(u
, mapping
, pa_modargs_get_value(ma
, "control", NULL
), ignore_dB
);
2245 pa_sink_new_data_init(&data
);
2246 data
.driver
= driver
;
2249 set_sink_name(&data
, ma
, dev_id
, u
->device_name
, mapping
);
2251 /* We need to give pa_modargs_get_value_boolean() a pointer to a local
2252 * variable instead of using &data.namereg_fail directly, because
2253 * data.namereg_fail is a bitfield and taking the address of a bitfield
2254 * variable is impossible. */
2255 namereg_fail
= data
.namereg_fail
;
2256 if (pa_modargs_get_value_boolean(ma
, "namereg_fail", &namereg_fail
) < 0) {
2257 pa_log("Failed to parse namereg_fail argument.");
2258 pa_sink_new_data_done(&data
);
2261 data
.namereg_fail
= namereg_fail
;
2263 pa_sink_new_data_set_sample_spec(&data
, &ss
);
2264 pa_sink_new_data_set_channel_map(&data
, &map
);
2265 pa_sink_new_data_set_alternate_sample_rate(&data
, alternate_sample_rate
);
2267 pa_alsa_init_proplist_pcm(m
->core
, data
.proplist
, u
->pcm_handle
);
2268 pa_proplist_sets(data
.proplist
, PA_PROP_DEVICE_STRING
, u
->device_name
);
2269 pa_proplist_setf(data
.proplist
, PA_PROP_DEVICE_BUFFERING_BUFFER_SIZE
, "%lu", (unsigned long) (buffer_frames
* frame_size
));
2270 pa_proplist_setf(data
.proplist
, PA_PROP_DEVICE_BUFFERING_FRAGMENT_SIZE
, "%lu", (unsigned long) (period_frames
* frame_size
));
2271 pa_proplist_sets(data
.proplist
, PA_PROP_DEVICE_ACCESS_MODE
, u
->use_tsched
? "mmap+timer" : (u
->use_mmap
? "mmap" : "serial"));
2274 pa_proplist_sets(data
.proplist
, PA_PROP_DEVICE_PROFILE_NAME
, mapping
->name
);
2275 pa_proplist_sets(data
.proplist
, PA_PROP_DEVICE_PROFILE_DESCRIPTION
, mapping
->description
);
2277 while ((key
= pa_proplist_iterate(mapping
->proplist
, &state
)))
2278 pa_proplist_sets(data
.proplist
, key
, pa_proplist_gets(mapping
->proplist
, key
));
2281 pa_alsa_init_description(data
.proplist
);
2283 if (u
->control_device
)
2284 pa_alsa_init_proplist_ctl(data
.proplist
, u
->control_device
);
2286 if (pa_modargs_get_proplist(ma
, "sink_properties", data
.proplist
, PA_UPDATE_REPLACE
) < 0) {
2287 pa_log("Invalid properties");
2288 pa_sink_new_data_done(&data
);
2293 pa_alsa_ucm_add_ports(&data
.ports
, data
.proplist
, u
->ucm_context
, true, card
);
2294 else if (u
->mixer_path_set
)
2295 pa_alsa_add_ports(&data
, u
->mixer_path_set
, card
);
2297 u
->sink
= pa_sink_new(m
->core
, &data
, PA_SINK_HARDWARE
| PA_SINK_LATENCY
| (u
->use_tsched
? PA_SINK_DYNAMIC_LATENCY
: 0) |
2298 (set_formats
? PA_SINK_SET_FORMATS
: 0));
2299 pa_sink_new_data_done(&data
);
2302 pa_log("Failed to create sink object");
2306 if (pa_modargs_get_value_u32(ma
, "deferred_volume_safety_margin",
2307 &u
->sink
->thread_info
.volume_change_safety_margin
) < 0) {
2308 pa_log("Failed to parse deferred_volume_safety_margin parameter");
2312 if (pa_modargs_get_value_s32(ma
, "deferred_volume_extra_delay",
2313 &u
->sink
->thread_info
.volume_change_extra_delay
) < 0) {
2314 pa_log("Failed to parse deferred_volume_extra_delay parameter");
2318 u
->sink
->parent
.process_msg
= sink_process_msg
;
2320 u
->sink
->update_requested_latency
= sink_update_requested_latency_cb
;
2321 u
->sink
->set_state
= sink_set_state_cb
;
2323 u
->sink
->set_port
= sink_set_port_ucm_cb
;
2325 u
->sink
->set_port
= sink_set_port_cb
;
2326 if (u
->sink
->alternate_sample_rate
)
2327 u
->sink
->update_rate
= sink_update_rate_cb
;
2328 u
->sink
->userdata
= u
;
2330 pa_sink_set_asyncmsgq(u
->sink
, u
->thread_mq
.inq
);
2331 pa_sink_set_rtpoll(u
->sink
, u
->rtpoll
);
2333 u
->frame_size
= frame_size
;
2334 u
->fragment_size
= frag_size
= (size_t) (period_frames
* frame_size
);
2335 u
->hwbuf_size
= buffer_size
= (size_t) (buffer_frames
* frame_size
);
2336 pa_cvolume_mute(&u
->hardware_volume
, u
->sink
->sample_spec
.channels
);
2338 pa_log_info("Using %0.1f fragments of size %lu bytes (%0.2fms), buffer size is %lu bytes (%0.2fms)",
2339 (double) u
->hwbuf_size
/ (double) u
->fragment_size
,
2340 (long unsigned) u
->fragment_size
,
2341 (double) pa_bytes_to_usec(u
->fragment_size
, &ss
) / PA_USEC_PER_MSEC
,
2342 (long unsigned) u
->hwbuf_size
,
2343 (double) pa_bytes_to_usec(u
->hwbuf_size
, &ss
) / PA_USEC_PER_MSEC
);
2345 pa_sink_set_max_request(u
->sink
, u
->hwbuf_size
);
2346 if (pa_alsa_pcm_is_hw(u
->pcm_handle
))
2347 pa_sink_set_max_rewind(u
->sink
, u
->hwbuf_size
);
2349 pa_log_info("Disabling rewind for device %s", u
->device_name
);
2350 pa_sink_set_max_rewind(u
->sink
, 0);
2353 if (u
->use_tsched
) {
2354 u
->tsched_watermark_ref
= tsched_watermark
;
2355 reset_watermark(u
, u
->tsched_watermark_ref
, &ss
, false);
2357 pa_sink_set_fixed_latency(u
->sink
, pa_bytes_to_usec(u
->hwbuf_size
, &ss
));
2361 if (update_sw_params(u
) < 0)
2364 if (u
->ucm_context
) {
2365 if (u
->sink
->active_port
&& pa_alsa_ucm_set_port(u
->ucm_context
, u
->sink
->active_port
, true) < 0)
2367 } else if (setup_mixer(u
, ignore_dB
) < 0)
2370 pa_alsa_dump(PA_LOG_DEBUG
, u
->pcm_handle
);
2372 thread_name
= pa_sprintf_malloc("alsa-sink-%s", pa_strnull(pa_proplist_gets(u
->sink
->proplist
, "alsa.id")));
2373 if (!(u
->thread
= pa_thread_new(thread_name
, thread_func
, u
))) {
2374 pa_log("Failed to create thread.");
2377 pa_xfree(thread_name
);
2380 /* Get initial mixer settings */
2381 if (data
.volume_is_set
) {
2382 if (u
->sink
->set_volume
)
2383 u
->sink
->set_volume(u
->sink
);
2385 if (u
->sink
->get_volume
)
2386 u
->sink
->get_volume(u
->sink
);
2389 if (data
.muted_is_set
) {
2390 if (u
->sink
->set_mute
)
2391 u
->sink
->set_mute(u
->sink
);
2393 if (u
->sink
->get_mute
)
2394 u
->sink
->get_mute(u
->sink
);
2397 if ((data
.volume_is_set
|| data
.muted_is_set
) && u
->sink
->write_volume
)
2398 u
->sink
->write_volume(u
->sink
);
2401 /* For S/PDIF and HDMI, allow getting/setting custom formats */
2402 pa_format_info
*format
;
2404 /* To start with, we only support PCM formats. Other formats may be added
2405 * with pa_sink_set_formats().*/
2406 format
= pa_format_info_new();
2407 format
->encoding
= PA_ENCODING_PCM
;
2408 u
->formats
= pa_idxset_new(NULL
, NULL
);
2409 pa_idxset_put(u
->formats
, format
, NULL
);
2411 u
->sink
->get_formats
= sink_get_formats
;
2412 u
->sink
->set_formats
= sink_set_formats
;
2415 pa_sink_put(u
->sink
);
2418 pa_alsa_profile_set_free(profile_set
);
2423 pa_xfree(thread_name
);
2429 pa_alsa_profile_set_free(profile_set
);
2434 static void userdata_free(struct userdata
*u
) {
2438 pa_sink_unlink(u
->sink
);
2441 pa_asyncmsgq_send(u
->thread_mq
.inq
, NULL
, PA_MESSAGE_SHUTDOWN
, NULL
, 0, NULL
);
2442 pa_thread_free(u
->thread
);
2445 pa_thread_mq_done(&u
->thread_mq
);
2448 pa_sink_unref(u
->sink
);
2450 if (u
->memchunk
.memblock
)
2451 pa_memblock_unref(u
->memchunk
.memblock
);
2454 pa_alsa_mixer_pdata_free(u
->mixer_pd
);
2456 if (u
->alsa_rtpoll_item
)
2457 pa_rtpoll_item_free(u
->alsa_rtpoll_item
);
2460 pa_rtpoll_free(u
->rtpoll
);
2462 if (u
->pcm_handle
) {
2463 snd_pcm_drop(u
->pcm_handle
);
2464 snd_pcm_close(u
->pcm_handle
);
2468 pa_alsa_fdlist_free(u
->mixer_fdl
);
2470 if (u
->mixer_path
&& !u
->mixer_path_set
)
2471 pa_alsa_path_free(u
->mixer_path
);
2473 if (u
->mixer_handle
)
2474 snd_mixer_close(u
->mixer_handle
);
2477 pa_smoother_free(u
->smoother
);
2480 pa_idxset_free(u
->formats
, (pa_free_cb_t
) pa_format_info_free
);
2488 pa_xfree(u
->device_name
);
2489 pa_xfree(u
->control_device
);
2490 pa_xfree(u
->paths_dir
);
2494 void pa_alsa_sink_free(pa_sink
*s
) {
2497 pa_sink_assert_ref(s
);
2498 pa_assert_se(u
= s
->userdata
);