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
29 #include <asoundlib.h>
31 #include <pulse/rtclock.h>
32 #include <pulse/timeval.h>
33 #include <pulse/volume.h>
34 #include <pulse/xmalloc.h>
36 #include <pulsecore/core.h>
37 #include <pulsecore/i18n.h>
38 #include <pulsecore/module.h>
39 #include <pulsecore/memchunk.h>
40 #include <pulsecore/sink.h>
41 #include <pulsecore/modargs.h>
42 #include <pulsecore/core-rtclock.h>
43 #include <pulsecore/core-util.h>
44 #include <pulsecore/sample-util.h>
45 #include <pulsecore/log.h>
46 #include <pulsecore/macro.h>
47 #include <pulsecore/thread.h>
48 #include <pulsecore/thread-mq.h>
49 #include <pulsecore/rtpoll.h>
50 #include <pulsecore/time-smoother.h>
52 #include <modules/reserve-wrap.h>
54 #include "alsa-util.h"
55 #include "alsa-source.h"
57 /* #define DEBUG_TIMING */
59 #define DEFAULT_DEVICE "default"
61 #define DEFAULT_TSCHED_BUFFER_USEC (2*PA_USEC_PER_SEC) /* 2s */
62 #define DEFAULT_TSCHED_WATERMARK_USEC (20*PA_USEC_PER_MSEC) /* 20ms */
64 #define TSCHED_WATERMARK_INC_STEP_USEC (10*PA_USEC_PER_MSEC) /* 10ms */
65 #define TSCHED_WATERMARK_DEC_STEP_USEC (5*PA_USEC_PER_MSEC) /* 5ms */
66 #define TSCHED_WATERMARK_VERIFY_AFTER_USEC (20*PA_USEC_PER_SEC) /* 20s */
67 #define TSCHED_WATERMARK_INC_THRESHOLD_USEC (0*PA_USEC_PER_MSEC) /* 0ms */
68 #define TSCHED_WATERMARK_DEC_THRESHOLD_USEC (100*PA_USEC_PER_MSEC) /* 100ms */
69 #define TSCHED_WATERMARK_STEP_USEC (10*PA_USEC_PER_MSEC) /* 10ms */
71 #define TSCHED_MIN_SLEEP_USEC (10*PA_USEC_PER_MSEC) /* 10ms */
72 #define TSCHED_MIN_WAKEUP_USEC (4*PA_USEC_PER_MSEC) /* 4ms */
74 #define SMOOTHER_WINDOW_USEC (10*PA_USEC_PER_SEC) /* 10s */
75 #define SMOOTHER_ADJUST_USEC (1*PA_USEC_PER_SEC) /* 1s */
77 #define SMOOTHER_MIN_INTERVAL (2*PA_USEC_PER_MSEC) /* 2ms */
78 #define SMOOTHER_MAX_INTERVAL (200*PA_USEC_PER_MSEC) /* 200ms */
80 #define VOLUME_ACCURACY (PA_VOLUME_NORM/100)
88 pa_thread_mq thread_mq
;
91 snd_pcm_t
*pcm_handle
;
94 pa_alsa_fdlist
*mixer_fdl
;
95 pa_alsa_mixer_pdata
*mixer_pd
;
96 snd_mixer_t
*mixer_handle
;
97 pa_alsa_path_set
*mixer_path_set
;
98 pa_alsa_path
*mixer_path
;
100 pa_cvolume hardware_volume
;
107 tsched_watermark_ref
,
113 watermark_inc_threshold
,
114 watermark_dec_threshold
;
116 pa_usec_t watermark_dec_not_before
;
117 pa_usec_t min_latency_ref
;
119 char *device_name
; /* name of the PCM device */
120 char *control_device
; /* name of the control device */
122 pa_bool_t use_mmap
:1, use_tsched
:1, deferred_volume
:1;
126 pa_rtpoll_item
*alsa_rtpoll_item
;
128 snd_mixer_selem_channel_id_t mixer_map
[SND_MIXER_SCHN_LAST
];
130 pa_smoother
*smoother
;
132 pa_usec_t smoother_interval
;
133 pa_usec_t last_smoother_update
;
135 pa_reserve_wrapper
*reserve
;
136 pa_hook_slot
*reserve_slot
;
137 pa_reserve_monitor_wrapper
*monitor
;
138 pa_hook_slot
*monitor_slot
;
141 static void userdata_free(struct userdata
*u
);
143 static pa_hook_result_t
reserve_cb(pa_reserve_wrapper
*r
, void *forced
, struct userdata
*u
) {
147 if (pa_source_suspend(u
->source
, TRUE
, PA_SUSPEND_APPLICATION
) < 0)
148 return PA_HOOK_CANCEL
;
153 static void reserve_done(struct userdata
*u
) {
156 if (u
->reserve_slot
) {
157 pa_hook_slot_free(u
->reserve_slot
);
158 u
->reserve_slot
= NULL
;
162 pa_reserve_wrapper_unref(u
->reserve
);
167 static void reserve_update(struct userdata
*u
) {
168 const char *description
;
171 if (!u
->source
|| !u
->reserve
)
174 if ((description
= pa_proplist_gets(u
->source
->proplist
, PA_PROP_DEVICE_DESCRIPTION
)))
175 pa_reserve_wrapper_set_application_device_name(u
->reserve
, description
);
178 static int reserve_init(struct userdata
*u
, const char *dname
) {
187 if (pa_in_system_mode())
190 if (!(rname
= pa_alsa_get_reserve_name(dname
)))
193 /* We are resuming, try to lock the device */
194 u
->reserve
= pa_reserve_wrapper_get(u
->core
, rname
);
202 pa_assert(!u
->reserve_slot
);
203 u
->reserve_slot
= pa_hook_connect(pa_reserve_wrapper_hook(u
->reserve
), PA_HOOK_NORMAL
, (pa_hook_cb_t
) reserve_cb
, u
);
208 static pa_hook_result_t
monitor_cb(pa_reserve_monitor_wrapper
*w
, void* busy
, struct userdata
*u
) {
214 b
= PA_PTR_TO_UINT(busy
) && !u
->reserve
;
216 pa_source_suspend(u
->source
, b
, PA_SUSPEND_APPLICATION
);
220 static void monitor_done(struct userdata
*u
) {
223 if (u
->monitor_slot
) {
224 pa_hook_slot_free(u
->monitor_slot
);
225 u
->monitor_slot
= NULL
;
229 pa_reserve_monitor_wrapper_unref(u
->monitor
);
234 static int reserve_monitor_init(struct userdata
*u
, const char *dname
) {
240 if (pa_in_system_mode())
243 if (!(rname
= pa_alsa_get_reserve_name(dname
)))
246 /* We are resuming, try to lock the device */
247 u
->monitor
= pa_reserve_monitor_wrapper_get(u
->core
, rname
);
253 pa_assert(!u
->monitor_slot
);
254 u
->monitor_slot
= pa_hook_connect(pa_reserve_monitor_wrapper_hook(u
->monitor
), PA_HOOK_NORMAL
, (pa_hook_cb_t
) monitor_cb
, u
);
259 static void fix_min_sleep_wakeup(struct userdata
*u
) {
260 size_t max_use
, max_use_2
;
263 pa_assert(u
->use_tsched
);
265 max_use
= u
->hwbuf_size
- u
->hwbuf_unused
;
266 max_use_2
= pa_frame_align(max_use
/2, &u
->source
->sample_spec
);
268 u
->min_sleep
= pa_usec_to_bytes(TSCHED_MIN_SLEEP_USEC
, &u
->source
->sample_spec
);
269 u
->min_sleep
= PA_CLAMP(u
->min_sleep
, u
->frame_size
, max_use_2
);
271 u
->min_wakeup
= pa_usec_to_bytes(TSCHED_MIN_WAKEUP_USEC
, &u
->source
->sample_spec
);
272 u
->min_wakeup
= PA_CLAMP(u
->min_wakeup
, u
->frame_size
, max_use_2
);
275 static void fix_tsched_watermark(struct userdata
*u
) {
278 pa_assert(u
->use_tsched
);
280 max_use
= u
->hwbuf_size
- u
->hwbuf_unused
;
282 if (u
->tsched_watermark
> max_use
- u
->min_sleep
)
283 u
->tsched_watermark
= max_use
- u
->min_sleep
;
285 if (u
->tsched_watermark
< u
->min_wakeup
)
286 u
->tsched_watermark
= u
->min_wakeup
;
289 static void increase_watermark(struct userdata
*u
) {
290 size_t old_watermark
;
291 pa_usec_t old_min_latency
, new_min_latency
;
294 pa_assert(u
->use_tsched
);
296 /* First, just try to increase the watermark */
297 old_watermark
= u
->tsched_watermark
;
298 u
->tsched_watermark
= PA_MIN(u
->tsched_watermark
* 2, u
->tsched_watermark
+ u
->watermark_inc_step
);
299 fix_tsched_watermark(u
);
301 if (old_watermark
!= u
->tsched_watermark
) {
302 pa_log_info("Increasing wakeup watermark to %0.2f ms",
303 (double) pa_bytes_to_usec(u
->tsched_watermark
, &u
->source
->sample_spec
) / PA_USEC_PER_MSEC
);
307 /* Hmm, we cannot increase the watermark any further, hence let's raise the latency */
308 old_min_latency
= u
->source
->thread_info
.min_latency
;
309 new_min_latency
= PA_MIN(old_min_latency
* 2, old_min_latency
+ TSCHED_WATERMARK_INC_STEP_USEC
);
310 new_min_latency
= PA_MIN(new_min_latency
, u
->source
->thread_info
.max_latency
);
312 if (old_min_latency
!= new_min_latency
) {
313 pa_log_info("Increasing minimal latency to %0.2f ms",
314 (double) new_min_latency
/ PA_USEC_PER_MSEC
);
316 pa_source_set_latency_range_within_thread(u
->source
, new_min_latency
, u
->source
->thread_info
.max_latency
);
319 /* When we reach this we're officialy fucked! */
322 static void decrease_watermark(struct userdata
*u
) {
323 size_t old_watermark
;
327 pa_assert(u
->use_tsched
);
329 now
= pa_rtclock_now();
331 if (u
->watermark_dec_not_before
<= 0)
334 if (u
->watermark_dec_not_before
> now
)
337 old_watermark
= u
->tsched_watermark
;
339 if (u
->tsched_watermark
< u
->watermark_dec_step
)
340 u
->tsched_watermark
= u
->tsched_watermark
/ 2;
342 u
->tsched_watermark
= PA_MAX(u
->tsched_watermark
/ 2, u
->tsched_watermark
- u
->watermark_dec_step
);
344 fix_tsched_watermark(u
);
346 if (old_watermark
!= u
->tsched_watermark
)
347 pa_log_info("Decreasing wakeup watermark to %0.2f ms",
348 (double) pa_bytes_to_usec(u
->tsched_watermark
, &u
->source
->sample_spec
) / PA_USEC_PER_MSEC
);
350 /* We don't change the latency range*/
353 u
->watermark_dec_not_before
= now
+ TSCHED_WATERMARK_VERIFY_AFTER_USEC
;
356 static void hw_sleep_time(struct userdata
*u
, pa_usec_t
*sleep_usec
, pa_usec_t
*process_usec
) {
359 pa_assert(sleep_usec
);
360 pa_assert(process_usec
);
363 pa_assert(u
->use_tsched
);
365 usec
= pa_source_get_requested_latency_within_thread(u
->source
);
367 if (usec
== (pa_usec_t
) -1)
368 usec
= pa_bytes_to_usec(u
->hwbuf_size
, &u
->source
->sample_spec
);
370 wm
= pa_bytes_to_usec(u
->tsched_watermark
, &u
->source
->sample_spec
);
375 *sleep_usec
= usec
- wm
;
379 pa_log_debug("Buffer time: %lu ms; Sleep time: %lu ms; Process time: %lu ms",
380 (unsigned long) (usec
/ PA_USEC_PER_MSEC
),
381 (unsigned long) (*sleep_usec
/ PA_USEC_PER_MSEC
),
382 (unsigned long) (*process_usec
/ PA_USEC_PER_MSEC
));
386 static int try_recover(struct userdata
*u
, const char *call
, int err
) {
391 pa_log_debug("%s: %s", call
, pa_alsa_strerror(err
));
393 pa_assert(err
!= -EAGAIN
);
396 pa_log_debug("%s: Buffer overrun!", call
);
398 if (err
== -ESTRPIPE
)
399 pa_log_debug("%s: System suspended!", call
);
401 if ((err
= snd_pcm_recover(u
->pcm_handle
, err
, 1)) < 0) {
402 pa_log("%s: %s", call
, pa_alsa_strerror(err
));
410 static size_t check_left_to_record(struct userdata
*u
, size_t n_bytes
, pa_bool_t on_timeout
) {
411 size_t left_to_record
;
412 size_t rec_space
= u
->hwbuf_size
- u
->hwbuf_unused
;
413 pa_bool_t overrun
= FALSE
;
415 /* We use <= instead of < for this check here because an overrun
416 * only happens after the last sample was processed, not already when
417 * it is removed from the buffer. This is particularly important
418 * when block transfer is used. */
420 if (n_bytes
<= rec_space
)
421 left_to_record
= rec_space
- n_bytes
;
424 /* We got a dropout. What a mess! */
432 if (pa_log_ratelimit(PA_LOG_INFO
))
433 pa_log_info("Overrun!");
437 pa_log_debug("%0.2f ms left to record", (double) pa_bytes_to_usec(left_to_record
, &u
->source
->sample_spec
) / PA_USEC_PER_MSEC
);
441 pa_bool_t reset_not_before
= TRUE
;
443 if (overrun
|| left_to_record
< u
->watermark_inc_threshold
)
444 increase_watermark(u
);
445 else if (left_to_record
> u
->watermark_dec_threshold
) {
446 reset_not_before
= FALSE
;
448 /* We decrease the watermark only if have actually
449 * been woken up by a timeout. If something else woke
450 * us up it's too easy to fulfill the deadlines... */
453 decrease_watermark(u
);
456 if (reset_not_before
)
457 u
->watermark_dec_not_before
= 0;
460 return left_to_record
;
463 static int mmap_read(struct userdata
*u
, pa_usec_t
*sleep_usec
, pa_bool_t polled
, pa_bool_t on_timeout
) {
464 pa_bool_t work_done
= FALSE
;
465 pa_usec_t max_sleep_usec
= 0, process_usec
= 0;
466 size_t left_to_record
;
470 pa_source_assert_ref(u
->source
);
473 hw_sleep_time(u
, &max_sleep_usec
, &process_usec
);
479 pa_bool_t after_avail
= TRUE
;
481 if (PA_UNLIKELY((n
= pa_alsa_safe_avail(u
->pcm_handle
, u
->hwbuf_size
, &u
->source
->sample_spec
)) < 0)) {
483 if ((r
= try_recover(u
, "snd_pcm_avail", (int) n
)) == 0)
489 n_bytes
= (size_t) n
* u
->frame_size
;
492 pa_log_debug("avail: %lu", (unsigned long) n_bytes
);
495 left_to_record
= check_left_to_record(u
, n_bytes
, on_timeout
);
500 pa_bytes_to_usec(left_to_record
, &u
->source
->sample_spec
) > process_usec
+max_sleep_usec
/2) {
502 pa_log_debug("Not reading, because too early.");
507 if (PA_UNLIKELY(n_bytes
<= 0)) {
511 char *dn
= pa_alsa_get_driver_name_by_pcm(u
->pcm_handle
);
512 pa_log(_("ALSA woke us up to read new data from the device, but there was actually nothing to read!\n"
513 "Most likely this is a bug in the ALSA driver '%s'. Please report this issue to the ALSA developers.\n"
514 "We were woken up with POLLIN set -- however a subsequent snd_pcm_avail() returned 0 or another value < min_avail."),
520 pa_log_debug("Not reading, because not necessary.");
528 pa_log_debug("Not filling up, because already too many iterations.");
537 pa_log_debug("Reading");
544 const snd_pcm_channel_area_t
*areas
;
545 snd_pcm_uframes_t offset
, frames
;
546 snd_pcm_sframes_t sframes
;
548 frames
= (snd_pcm_uframes_t
) (n_bytes
/ u
->frame_size
);
549 /* pa_log_debug("%lu frames to read", (unsigned long) frames); */
551 if (PA_UNLIKELY((err
= pa_alsa_safe_mmap_begin(u
->pcm_handle
, &areas
, &offset
, &frames
, u
->hwbuf_size
, &u
->source
->sample_spec
)) < 0)) {
553 if (!after_avail
&& err
== -EAGAIN
)
556 if ((r
= try_recover(u
, "snd_pcm_mmap_begin", err
)) == 0)
562 /* Make sure that if these memblocks need to be copied they will fit into one slot */
563 if (frames
> pa_mempool_block_size_max(u
->core
->mempool
)/u
->frame_size
)
564 frames
= pa_mempool_block_size_max(u
->core
->mempool
)/u
->frame_size
;
566 if (!after_avail
&& frames
== 0)
569 pa_assert(frames
> 0);
572 /* Check these are multiples of 8 bit */
573 pa_assert((areas
[0].first
& 7) == 0);
574 pa_assert((areas
[0].step
& 7)== 0);
576 /* We assume a single interleaved memory buffer */
577 pa_assert((areas
[0].first
>> 3) == 0);
578 pa_assert((areas
[0].step
>> 3) == u
->frame_size
);
580 p
= (uint8_t*) areas
[0].addr
+ (offset
* u
->frame_size
);
582 chunk
.memblock
= pa_memblock_new_fixed(u
->core
->mempool
, p
, frames
* u
->frame_size
, TRUE
);
583 chunk
.length
= pa_memblock_get_length(chunk
.memblock
);
586 pa_source_post(u
->source
, &chunk
);
587 pa_memblock_unref_fixed(chunk
.memblock
);
589 if (PA_UNLIKELY((sframes
= snd_pcm_mmap_commit(u
->pcm_handle
, offset
, frames
)) < 0)) {
591 if ((r
= try_recover(u
, "snd_pcm_mmap_commit", (int) sframes
)) == 0)
599 u
->read_count
+= frames
* u
->frame_size
;
602 pa_log_debug("Read %lu bytes (of possible %lu bytes)", (unsigned long) (frames
* u
->frame_size
), (unsigned long) n_bytes
);
605 if ((size_t) frames
* u
->frame_size
>= n_bytes
)
608 n_bytes
-= (size_t) frames
* u
->frame_size
;
613 *sleep_usec
= pa_bytes_to_usec(left_to_record
, &u
->source
->sample_spec
);
614 process_usec
= pa_bytes_to_usec(u
->tsched_watermark
, &u
->source
->sample_spec
);
616 if (*sleep_usec
> process_usec
)
617 *sleep_usec
-= process_usec
;
622 return work_done
? 1 : 0;
625 static int unix_read(struct userdata
*u
, pa_usec_t
*sleep_usec
, pa_bool_t polled
, pa_bool_t on_timeout
) {
626 int work_done
= FALSE
;
627 pa_usec_t max_sleep_usec
= 0, process_usec
= 0;
628 size_t left_to_record
;
632 pa_source_assert_ref(u
->source
);
635 hw_sleep_time(u
, &max_sleep_usec
, &process_usec
);
641 pa_bool_t after_avail
= TRUE
;
643 if (PA_UNLIKELY((n
= pa_alsa_safe_avail(u
->pcm_handle
, u
->hwbuf_size
, &u
->source
->sample_spec
)) < 0)) {
645 if ((r
= try_recover(u
, "snd_pcm_avail", (int) n
)) == 0)
651 n_bytes
= (size_t) n
* u
->frame_size
;
652 left_to_record
= check_left_to_record(u
, n_bytes
, on_timeout
);
657 pa_bytes_to_usec(left_to_record
, &u
->source
->sample_spec
) > process_usec
+max_sleep_usec
/2)
660 if (PA_UNLIKELY(n_bytes
<= 0)) {
664 char *dn
= pa_alsa_get_driver_name_by_pcm(u
->pcm_handle
);
665 pa_log(_("ALSA woke us up to read new data from the device, but there was actually nothing to read!\n"
666 "Most likely this is a bug in the ALSA driver '%s'. Please report this issue to the ALSA developers.\n"
667 "We were woken up with POLLIN set -- however a subsequent snd_pcm_avail() returned 0 or another value < min_avail."),
677 pa_log_debug("Not filling up, because already too many iterations.");
687 snd_pcm_sframes_t frames
;
690 chunk
.memblock
= pa_memblock_new(u
->core
->mempool
, (size_t) -1);
692 frames
= (snd_pcm_sframes_t
) (pa_memblock_get_length(chunk
.memblock
) / u
->frame_size
);
694 if (frames
> (snd_pcm_sframes_t
) (n_bytes
/u
->frame_size
))
695 frames
= (snd_pcm_sframes_t
) (n_bytes
/u
->frame_size
);
697 /* pa_log_debug("%lu frames to read", (unsigned long) n); */
699 p
= pa_memblock_acquire(chunk
.memblock
);
700 frames
= snd_pcm_readi(u
->pcm_handle
, (uint8_t*) p
, (snd_pcm_uframes_t
) frames
);
701 pa_memblock_release(chunk
.memblock
);
703 if (PA_UNLIKELY(frames
< 0)) {
704 pa_memblock_unref(chunk
.memblock
);
706 if (!after_avail
&& (int) frames
== -EAGAIN
)
709 if ((r
= try_recover(u
, "snd_pcm_readi", (int) frames
)) == 0)
715 if (!after_avail
&& frames
== 0) {
716 pa_memblock_unref(chunk
.memblock
);
720 pa_assert(frames
> 0);
724 chunk
.length
= (size_t) frames
* u
->frame_size
;
726 pa_source_post(u
->source
, &chunk
);
727 pa_memblock_unref(chunk
.memblock
);
731 u
->read_count
+= frames
* u
->frame_size
;
733 /* pa_log_debug("read %lu frames", (unsigned long) frames); */
735 if ((size_t) frames
* u
->frame_size
>= n_bytes
)
738 n_bytes
-= (size_t) frames
* u
->frame_size
;
743 *sleep_usec
= pa_bytes_to_usec(left_to_record
, &u
->source
->sample_spec
);
744 process_usec
= pa_bytes_to_usec(u
->tsched_watermark
, &u
->source
->sample_spec
);
746 if (*sleep_usec
> process_usec
)
747 *sleep_usec
-= process_usec
;
752 return work_done
? 1 : 0;
755 static void update_smoother(struct userdata
*u
) {
756 snd_pcm_sframes_t delay
= 0;
759 pa_usec_t now1
= 0, now2
;
760 snd_pcm_status_t
*status
;
762 snd_pcm_status_alloca(&status
);
765 pa_assert(u
->pcm_handle
);
767 /* Let's update the time smoother */
769 if (PA_UNLIKELY((err
= pa_alsa_safe_delay(u
->pcm_handle
, &delay
, u
->hwbuf_size
, &u
->source
->sample_spec
, TRUE
)) < 0)) {
770 pa_log_warn("Failed to get delay: %s", pa_alsa_strerror(err
));
774 if (PA_UNLIKELY((err
= snd_pcm_status(u
->pcm_handle
, status
)) < 0))
775 pa_log_warn("Failed to get timestamp: %s", pa_alsa_strerror(err
));
777 snd_htimestamp_t htstamp
= { 0, 0 };
778 snd_pcm_status_get_htstamp(status
, &htstamp
);
779 now1
= pa_timespec_load(&htstamp
);
782 /* Hmm, if the timestamp is 0, then it wasn't set and we take the current time */
784 now1
= pa_rtclock_now();
786 /* check if the time since the last update is bigger than the interval */
787 if (u
->last_smoother_update
> 0)
788 if (u
->last_smoother_update
+ u
->smoother_interval
> now1
)
791 position
= u
->read_count
+ ((uint64_t) delay
* (uint64_t) u
->frame_size
);
792 now2
= pa_bytes_to_usec(position
, &u
->source
->sample_spec
);
794 pa_smoother_put(u
->smoother
, now1
, now2
);
796 u
->last_smoother_update
= now1
;
797 /* exponentially increase the update interval up to the MAX limit */
798 u
->smoother_interval
= PA_MIN (u
->smoother_interval
* 2, SMOOTHER_MAX_INTERVAL
);
801 static pa_usec_t
source_get_latency(struct userdata
*u
) {
803 pa_usec_t now1
, now2
;
807 now1
= pa_rtclock_now();
808 now2
= pa_smoother_get(u
->smoother
, now1
);
810 delay
= (int64_t) now2
- (int64_t) pa_bytes_to_usec(u
->read_count
, &u
->source
->sample_spec
);
812 return delay
>= 0 ? (pa_usec_t
) delay
: 0;
815 static int build_pollfd(struct userdata
*u
) {
817 pa_assert(u
->pcm_handle
);
819 if (u
->alsa_rtpoll_item
)
820 pa_rtpoll_item_free(u
->alsa_rtpoll_item
);
822 if (!(u
->alsa_rtpoll_item
= pa_alsa_build_pollfd(u
->pcm_handle
, u
->rtpoll
)))
828 /* Called from IO context */
829 static int suspend(struct userdata
*u
) {
831 pa_assert(u
->pcm_handle
);
833 pa_smoother_pause(u
->smoother
, pa_rtclock_now());
836 snd_pcm_close(u
->pcm_handle
);
837 u
->pcm_handle
= NULL
;
839 if (u
->alsa_rtpoll_item
) {
840 pa_rtpoll_item_free(u
->alsa_rtpoll_item
);
841 u
->alsa_rtpoll_item
= NULL
;
844 pa_log_info("Device suspended...");
849 /* Called from IO context */
850 static int update_sw_params(struct userdata
*u
) {
851 snd_pcm_uframes_t avail_min
;
856 /* Use the full buffer if no one asked us for anything specific */
862 if ((latency
= pa_source_get_requested_latency_within_thread(u
->source
)) != (pa_usec_t
) -1) {
865 pa_log_debug("latency set to %0.2fms", (double) latency
/ PA_USEC_PER_MSEC
);
867 b
= pa_usec_to_bytes(latency
, &u
->source
->sample_spec
);
869 /* We need at least one sample in our buffer */
871 if (PA_UNLIKELY(b
< u
->frame_size
))
874 u
->hwbuf_unused
= PA_LIKELY(b
< u
->hwbuf_size
) ? (u
->hwbuf_size
- b
) : 0;
877 fix_min_sleep_wakeup(u
);
878 fix_tsched_watermark(u
);
881 pa_log_debug("hwbuf_unused=%lu", (unsigned long) u
->hwbuf_unused
);
886 pa_usec_t sleep_usec
, process_usec
;
888 hw_sleep_time(u
, &sleep_usec
, &process_usec
);
889 avail_min
+= pa_usec_to_bytes(sleep_usec
, &u
->source
->sample_spec
) / u
->frame_size
;
892 pa_log_debug("setting avail_min=%lu", (unsigned long) avail_min
);
894 if ((err
= pa_alsa_set_sw_params(u
->pcm_handle
, avail_min
, !u
->use_tsched
)) < 0) {
895 pa_log("Failed to set software parameters: %s", pa_alsa_strerror(err
));
902 /* Called from IO Context on unsuspend or from main thread when creating source */
903 static void reset_watermark(struct userdata
*u
, size_t tsched_watermark
, pa_sample_spec
*ss
,
906 u
->tsched_watermark
= pa_usec_to_bytes_round_up(pa_bytes_to_usec_round_up(tsched_watermark
, ss
),
907 &u
->source
->sample_spec
);
909 u
->watermark_inc_step
= pa_usec_to_bytes(TSCHED_WATERMARK_INC_STEP_USEC
, &u
->source
->sample_spec
);
910 u
->watermark_dec_step
= pa_usec_to_bytes(TSCHED_WATERMARK_DEC_STEP_USEC
, &u
->source
->sample_spec
);
912 u
->watermark_inc_threshold
= pa_usec_to_bytes_round_up(TSCHED_WATERMARK_INC_THRESHOLD_USEC
, &u
->source
->sample_spec
);
913 u
->watermark_dec_threshold
= pa_usec_to_bytes_round_up(TSCHED_WATERMARK_DEC_THRESHOLD_USEC
, &u
->source
->sample_spec
);
915 fix_min_sleep_wakeup(u
);
916 fix_tsched_watermark(u
);
919 pa_source_set_latency_range_within_thread(u
->source
,
921 pa_bytes_to_usec(u
->hwbuf_size
, ss
));
923 pa_source_set_latency_range(u
->source
,
925 pa_bytes_to_usec(u
->hwbuf_size
, ss
));
927 /* work-around assert in pa_source_set_latency_within_thead,
928 keep track of min_latency and reuse it when
929 this routine is called from IO context */
930 u
->min_latency_ref
= u
->source
->thread_info
.min_latency
;
933 pa_log_info("Time scheduling watermark is %0.2fms",
934 (double) pa_bytes_to_usec(u
->tsched_watermark
, ss
) / PA_USEC_PER_MSEC
);
937 /* Called from IO context */
938 static int unsuspend(struct userdata
*u
) {
942 snd_pcm_uframes_t period_size
, buffer_size
;
945 pa_assert(!u
->pcm_handle
);
947 pa_log_info("Trying resume...");
949 if ((err
= snd_pcm_open(&u
->pcm_handle
, u
->device_name
, SND_PCM_STREAM_CAPTURE
,
951 SND_PCM_NO_AUTO_RESAMPLE
|
952 SND_PCM_NO_AUTO_CHANNELS
|
953 SND_PCM_NO_AUTO_FORMAT
)) < 0) {
954 pa_log("Error opening PCM device %s: %s", u
->device_name
, pa_alsa_strerror(err
));
958 ss
= u
->source
->sample_spec
;
959 period_size
= u
->fragment_size
/ u
->frame_size
;
960 buffer_size
= u
->hwbuf_size
/ u
->frame_size
;
964 if ((err
= pa_alsa_set_hw_params(u
->pcm_handle
, &ss
, &period_size
, &buffer_size
, 0, &b
, &d
, TRUE
)) < 0) {
965 pa_log("Failed to set hardware parameters: %s", pa_alsa_strerror(err
));
969 if (b
!= u
->use_mmap
|| d
!= u
->use_tsched
) {
970 pa_log_warn("Resume failed, couldn't get original access mode.");
974 if (!pa_sample_spec_equal(&ss
, &u
->source
->sample_spec
)) {
975 pa_log_warn("Resume failed, couldn't restore original sample settings.");
979 if (period_size
*u
->frame_size
!= u
->fragment_size
||
980 buffer_size
*u
->frame_size
!= u
->hwbuf_size
) {
981 pa_log_warn("Resume failed, couldn't restore original fragment settings. (Old: %lu/%lu, New %lu/%lu)",
982 (unsigned long) u
->hwbuf_size
, (unsigned long) u
->fragment_size
,
983 (unsigned long) (buffer_size
*u
->frame_size
), (unsigned long) (period_size
*u
->frame_size
));
987 if (update_sw_params(u
) < 0)
990 if (build_pollfd(u
) < 0)
993 /* FIXME: We need to reload the volume somehow */
996 pa_smoother_reset(u
->smoother
, pa_rtclock_now(), TRUE
);
997 u
->smoother_interval
= SMOOTHER_MIN_INTERVAL
;
998 u
->last_smoother_update
= 0;
1002 /* reset the watermark to the value defined when source was created */
1004 reset_watermark(u
, u
->tsched_watermark_ref
, &u
->source
->sample_spec
, TRUE
);
1006 pa_log_info("Resumed successfully...");
1011 if (u
->pcm_handle
) {
1012 snd_pcm_close(u
->pcm_handle
);
1013 u
->pcm_handle
= NULL
;
1019 /* Called from IO context */
1020 static int source_process_msg(pa_msgobject
*o
, int code
, void *data
, int64_t offset
, pa_memchunk
*chunk
) {
1021 struct userdata
*u
= PA_SOURCE(o
)->userdata
;
1025 case PA_SOURCE_MESSAGE_GET_LATENCY
: {
1029 r
= source_get_latency(u
);
1031 *((pa_usec_t
*) data
) = r
;
1036 case PA_SOURCE_MESSAGE_SET_STATE
:
1038 switch ((pa_source_state_t
) PA_PTR_TO_UINT(data
)) {
1040 case PA_SOURCE_SUSPENDED
: {
1043 pa_assert(PA_SOURCE_IS_OPENED(u
->source
->thread_info
.state
));
1045 if ((r
= suspend(u
)) < 0)
1051 case PA_SOURCE_IDLE
:
1052 case PA_SOURCE_RUNNING
: {
1055 if (u
->source
->thread_info
.state
== PA_SOURCE_INIT
) {
1056 if (build_pollfd(u
) < 0)
1060 if (u
->source
->thread_info
.state
== PA_SOURCE_SUSPENDED
) {
1061 if ((r
= unsuspend(u
)) < 0)
1068 case PA_SOURCE_UNLINKED
:
1069 case PA_SOURCE_INIT
:
1070 case PA_SOURCE_INVALID_STATE
:
1077 return pa_source_process_msg(o
, code
, data
, offset
, chunk
);
1080 /* Called from main context */
1081 static int source_set_state_cb(pa_source
*s
, pa_source_state_t new_state
) {
1082 pa_source_state_t old_state
;
1085 pa_source_assert_ref(s
);
1086 pa_assert_se(u
= s
->userdata
);
1088 old_state
= pa_source_get_state(u
->source
);
1090 if (PA_SOURCE_IS_OPENED(old_state
) && new_state
== PA_SOURCE_SUSPENDED
)
1092 else if (old_state
== PA_SOURCE_SUSPENDED
&& PA_SOURCE_IS_OPENED(new_state
))
1093 if (reserve_init(u
, u
->device_name
) < 0)
1094 return -PA_ERR_BUSY
;
1099 static int ctl_mixer_callback(snd_mixer_elem_t
*elem
, unsigned int mask
) {
1100 struct userdata
*u
= snd_mixer_elem_get_callback_private(elem
);
1103 pa_assert(u
->mixer_handle
);
1105 if (mask
== SND_CTL_EVENT_MASK_REMOVE
)
1108 if (!PA_SOURCE_IS_LINKED(u
->source
->state
))
1111 if (u
->source
->suspend_cause
& PA_SUSPEND_SESSION
)
1114 if (mask
& SND_CTL_EVENT_MASK_VALUE
) {
1115 pa_source_get_volume(u
->source
, TRUE
);
1116 pa_source_get_mute(u
->source
, TRUE
);
1122 static int io_mixer_callback(snd_mixer_elem_t
*elem
, unsigned int mask
) {
1123 struct userdata
*u
= snd_mixer_elem_get_callback_private(elem
);
1126 pa_assert(u
->mixer_handle
);
1128 if (mask
== SND_CTL_EVENT_MASK_REMOVE
)
1131 if (u
->source
->suspend_cause
& PA_SUSPEND_SESSION
)
1134 if (mask
& SND_CTL_EVENT_MASK_VALUE
)
1135 pa_source_update_volume_and_mute(u
->source
);
1140 static void source_get_volume_cb(pa_source
*s
) {
1141 struct userdata
*u
= s
->userdata
;
1143 char vol_str_pcnt
[PA_CVOLUME_SNPRINT_MAX
];
1146 pa_assert(u
->mixer_path
);
1147 pa_assert(u
->mixer_handle
);
1149 if (pa_alsa_path_get_volume(u
->mixer_path
, u
->mixer_handle
, &s
->channel_map
, &r
) < 0)
1152 /* Shift down by the base volume, so that 0dB becomes maximum volume */
1153 pa_sw_cvolume_multiply_scalar(&r
, &r
, s
->base_volume
);
1155 pa_log_debug("Read hardware volume: %s", pa_cvolume_snprint(vol_str_pcnt
, sizeof(vol_str_pcnt
), &r
));
1157 if (u
->mixer_path
->has_dB
) {
1158 char vol_str_db
[PA_SW_CVOLUME_SNPRINT_DB_MAX
];
1160 pa_log_debug(" in dB: %s", pa_sw_cvolume_snprint_dB(vol_str_db
, sizeof(vol_str_db
), &r
));
1163 if (pa_cvolume_equal(&u
->hardware_volume
, &r
))
1166 s
->real_volume
= u
->hardware_volume
= r
;
1168 /* Hmm, so the hardware volume changed, let's reset our software volume */
1169 if (u
->mixer_path
->has_dB
)
1170 pa_source_set_soft_volume(s
, NULL
);
1173 static void source_set_volume_cb(pa_source
*s
) {
1174 struct userdata
*u
= s
->userdata
;
1176 char vol_str_pcnt
[PA_CVOLUME_SNPRINT_MAX
];
1177 pa_bool_t deferred_volume
= !!(s
->flags
& PA_SOURCE_DEFERRED_VOLUME
);
1180 pa_assert(u
->mixer_path
);
1181 pa_assert(u
->mixer_handle
);
1183 /* Shift up by the base volume */
1184 pa_sw_cvolume_divide_scalar(&r
, &s
->real_volume
, s
->base_volume
);
1186 if (pa_alsa_path_set_volume(u
->mixer_path
, u
->mixer_handle
, &s
->channel_map
, &r
, deferred_volume
, !deferred_volume
) < 0)
1189 /* Shift down by the base volume, so that 0dB becomes maximum volume */
1190 pa_sw_cvolume_multiply_scalar(&r
, &r
, s
->base_volume
);
1192 u
->hardware_volume
= r
;
1194 if (u
->mixer_path
->has_dB
) {
1195 pa_cvolume new_soft_volume
;
1196 pa_bool_t accurate_enough
;
1197 char vol_str_db
[PA_SW_CVOLUME_SNPRINT_DB_MAX
];
1199 /* Match exactly what the user requested by software */
1200 pa_sw_cvolume_divide(&new_soft_volume
, &s
->real_volume
, &u
->hardware_volume
);
1202 /* If the adjustment to do in software is only minimal we
1203 * can skip it. That saves us CPU at the expense of a bit of
1206 (pa_cvolume_min(&new_soft_volume
) >= (PA_VOLUME_NORM
- VOLUME_ACCURACY
)) &&
1207 (pa_cvolume_max(&new_soft_volume
) <= (PA_VOLUME_NORM
+ VOLUME_ACCURACY
));
1209 pa_log_debug("Requested volume: %s", pa_cvolume_snprint(vol_str_pcnt
, sizeof(vol_str_pcnt
), &s
->real_volume
));
1210 pa_log_debug(" in dB: %s", pa_sw_cvolume_snprint_dB(vol_str_db
, sizeof(vol_str_db
), &s
->real_volume
));
1211 pa_log_debug("Got hardware volume: %s", pa_cvolume_snprint(vol_str_pcnt
, sizeof(vol_str_pcnt
), &u
->hardware_volume
));
1212 pa_log_debug(" in dB: %s", pa_sw_cvolume_snprint_dB(vol_str_db
, sizeof(vol_str_db
), &u
->hardware_volume
));
1213 pa_log_debug("Calculated software volume: %s (accurate-enough=%s)",
1214 pa_cvolume_snprint(vol_str_pcnt
, sizeof(vol_str_pcnt
), &new_soft_volume
),
1215 pa_yes_no(accurate_enough
));
1216 pa_log_debug(" in dB: %s", pa_sw_cvolume_snprint_dB(vol_str_db
, sizeof(vol_str_db
), &new_soft_volume
));
1218 if (!accurate_enough
)
1219 s
->soft_volume
= new_soft_volume
;
1222 pa_log_debug("Wrote hardware volume: %s", pa_cvolume_snprint(vol_str_pcnt
, sizeof(vol_str_pcnt
), &r
));
1224 /* We can't match exactly what the user requested, hence let's
1225 * at least tell the user about it */
1231 static void source_write_volume_cb(pa_source
*s
) {
1232 struct userdata
*u
= s
->userdata
;
1233 pa_cvolume hw_vol
= s
->thread_info
.current_hw_volume
;
1236 pa_assert(u
->mixer_path
);
1237 pa_assert(u
->mixer_handle
);
1238 pa_assert(s
->flags
& PA_SOURCE_DEFERRED_VOLUME
);
1240 /* Shift up by the base volume */
1241 pa_sw_cvolume_divide_scalar(&hw_vol
, &hw_vol
, s
->base_volume
);
1243 if (pa_alsa_path_set_volume(u
->mixer_path
, u
->mixer_handle
, &s
->channel_map
, &hw_vol
, TRUE
, TRUE
) < 0)
1244 pa_log_error("Writing HW volume failed");
1247 pa_bool_t accurate_enough
;
1249 /* Shift down by the base volume, so that 0dB becomes maximum volume */
1250 pa_sw_cvolume_multiply_scalar(&hw_vol
, &hw_vol
, s
->base_volume
);
1252 pa_sw_cvolume_divide(&tmp_vol
, &hw_vol
, &s
->thread_info
.current_hw_volume
);
1254 (pa_cvolume_min(&tmp_vol
) >= (PA_VOLUME_NORM
- VOLUME_ACCURACY
)) &&
1255 (pa_cvolume_max(&tmp_vol
) <= (PA_VOLUME_NORM
+ VOLUME_ACCURACY
));
1257 if (!accurate_enough
) {
1259 char db
[2][PA_SW_CVOLUME_SNPRINT_DB_MAX
];
1260 char pcnt
[2][PA_CVOLUME_SNPRINT_MAX
];
1263 pa_log_debug("Written HW volume did not match with the request: %s (request) != %s",
1264 pa_cvolume_snprint(vol
.pcnt
[0], sizeof(vol
.pcnt
[0]), &s
->thread_info
.current_hw_volume
),
1265 pa_cvolume_snprint(vol
.pcnt
[1], sizeof(vol
.pcnt
[1]), &hw_vol
));
1266 pa_log_debug(" in dB: %s (request) != %s",
1267 pa_sw_cvolume_snprint_dB(vol
.db
[0], sizeof(vol
.db
[0]), &s
->thread_info
.current_hw_volume
),
1268 pa_sw_cvolume_snprint_dB(vol
.db
[1], sizeof(vol
.db
[1]), &hw_vol
));
1273 static void source_get_mute_cb(pa_source
*s
) {
1274 struct userdata
*u
= s
->userdata
;
1278 pa_assert(u
->mixer_path
);
1279 pa_assert(u
->mixer_handle
);
1281 if (pa_alsa_path_get_mute(u
->mixer_path
, u
->mixer_handle
, &b
) < 0)
1287 static void source_set_mute_cb(pa_source
*s
) {
1288 struct userdata
*u
= s
->userdata
;
1291 pa_assert(u
->mixer_path
);
1292 pa_assert(u
->mixer_handle
);
1294 pa_alsa_path_set_mute(u
->mixer_path
, u
->mixer_handle
, s
->muted
);
1297 static void mixer_volume_init(struct userdata
*u
) {
1300 if (!u
->mixer_path
->has_volume
) {
1301 pa_source_set_write_volume_callback(u
->source
, NULL
);
1302 pa_source_set_get_volume_callback(u
->source
, NULL
);
1303 pa_source_set_set_volume_callback(u
->source
, NULL
);
1305 pa_log_info("Driver does not support hardware volume control, falling back to software volume control.");
1307 pa_source_set_get_volume_callback(u
->source
, source_get_volume_cb
);
1308 pa_source_set_set_volume_callback(u
->source
, source_set_volume_cb
);
1310 if (u
->mixer_path
->has_dB
&& u
->deferred_volume
) {
1311 pa_source_set_write_volume_callback(u
->source
, source_write_volume_cb
);
1312 pa_log_info("Successfully enabled synchronous volume.");
1314 pa_source_set_write_volume_callback(u
->source
, NULL
);
1316 if (u
->mixer_path
->has_dB
) {
1317 pa_source_enable_decibel_volume(u
->source
, TRUE
);
1318 pa_log_info("Hardware volume ranges from %0.2f dB to %0.2f dB.", u
->mixer_path
->min_dB
, u
->mixer_path
->max_dB
);
1320 u
->source
->base_volume
= pa_sw_volume_from_dB(-u
->mixer_path
->max_dB
);
1321 u
->source
->n_volume_steps
= PA_VOLUME_NORM
+1;
1323 pa_log_info("Fixing base volume to %0.2f dB", pa_sw_volume_to_dB(u
->source
->base_volume
));
1325 pa_source_enable_decibel_volume(u
->source
, FALSE
);
1326 pa_log_info("Hardware volume ranges from %li to %li.", u
->mixer_path
->min_volume
, u
->mixer_path
->max_volume
);
1328 u
->source
->base_volume
= PA_VOLUME_NORM
;
1329 u
->source
->n_volume_steps
= u
->mixer_path
->max_volume
- u
->mixer_path
->min_volume
+ 1;
1332 pa_log_info("Using hardware volume control. Hardware dB scale %s.", u
->mixer_path
->has_dB
? "supported" : "not supported");
1335 if (!u
->mixer_path
->has_mute
) {
1336 pa_source_set_get_mute_callback(u
->source
, NULL
);
1337 pa_source_set_set_mute_callback(u
->source
, NULL
);
1338 pa_log_info("Driver does not support hardware mute control, falling back to software mute control.");
1340 pa_source_set_get_mute_callback(u
->source
, source_get_mute_cb
);
1341 pa_source_set_set_mute_callback(u
->source
, source_set_mute_cb
);
1342 pa_log_info("Using hardware mute control.");
1346 static int source_set_port_cb(pa_source
*s
, pa_device_port
*p
) {
1347 struct userdata
*u
= s
->userdata
;
1348 pa_alsa_port_data
*data
;
1352 pa_assert(u
->mixer_handle
);
1354 data
= PA_DEVICE_PORT_DATA(p
);
1356 pa_assert_se(u
->mixer_path
= data
->path
);
1357 pa_alsa_path_select(u
->mixer_path
, u
->mixer_handle
);
1359 mixer_volume_init(u
);
1362 pa_alsa_setting_select(data
->setting
, u
->mixer_handle
);
1372 static void source_update_requested_latency_cb(pa_source
*s
) {
1373 struct userdata
*u
= s
->userdata
;
1375 pa_assert(u
->use_tsched
); /* only when timer scheduling is used
1376 * we can dynamically adjust the
1382 update_sw_params(u
);
1385 static void thread_func(void *userdata
) {
1386 struct userdata
*u
= userdata
;
1387 unsigned short revents
= 0;
1391 pa_log_debug("Thread starting up");
1393 if (u
->core
->realtime_scheduling
)
1394 pa_make_realtime(u
->core
->realtime_priority
);
1396 pa_thread_mq_install(&u
->thread_mq
);
1400 pa_usec_t rtpoll_sleep
= 0;
1403 pa_log_debug("Loop");
1406 /* Read some data and pass it to the sources */
1407 if (PA_SOURCE_IS_OPENED(u
->source
->thread_info
.state
)) {
1409 pa_usec_t sleep_usec
= 0;
1410 pa_bool_t on_timeout
= pa_rtpoll_timer_elapsed(u
->rtpoll
);
1413 pa_log_info("Starting capture.");
1414 snd_pcm_start(u
->pcm_handle
);
1416 pa_smoother_resume(u
->smoother
, pa_rtclock_now(), TRUE
);
1422 work_done
= mmap_read(u
, &sleep_usec
, revents
& POLLIN
, on_timeout
);
1424 work_done
= unix_read(u
, &sleep_usec
, revents
& POLLIN
, on_timeout
);
1429 /* pa_log_debug("work_done = %i", work_done); */
1434 if (u
->use_tsched
) {
1437 /* OK, the capture buffer is now empty, let's
1438 * calculate when to wake up next */
1440 /* pa_log_debug("Waking up in %0.2fms (sound card clock).", (double) sleep_usec / PA_USEC_PER_MSEC); */
1442 /* Convert from the sound card time domain to the
1443 * system time domain */
1444 cusec
= pa_smoother_translate(u
->smoother
, pa_rtclock_now(), sleep_usec
);
1446 /* pa_log_debug("Waking up in %0.2fms (system clock).", (double) cusec / PA_USEC_PER_MSEC); */
1448 /* We don't trust the conversion, so we wake up whatever comes first */
1449 rtpoll_sleep
= PA_MIN(sleep_usec
, cusec
);
1453 if (u
->source
->flags
& PA_SOURCE_DEFERRED_VOLUME
) {
1454 pa_usec_t volume_sleep
;
1455 pa_source_volume_change_apply(u
->source
, &volume_sleep
);
1456 if (volume_sleep
> 0) {
1457 if (rtpoll_sleep
> 0)
1458 rtpoll_sleep
= PA_MIN(volume_sleep
, rtpoll_sleep
);
1460 rtpoll_sleep
= volume_sleep
;
1464 if (rtpoll_sleep
> 0)
1465 pa_rtpoll_set_timer_relative(u
->rtpoll
, rtpoll_sleep
);
1467 pa_rtpoll_set_timer_disabled(u
->rtpoll
);
1469 /* Hmm, nothing to do. Let's sleep */
1470 if ((ret
= pa_rtpoll_run(u
->rtpoll
, TRUE
)) < 0)
1473 if (u
->source
->flags
& PA_SOURCE_DEFERRED_VOLUME
)
1474 pa_source_volume_change_apply(u
->source
, NULL
);
1479 /* Tell ALSA about this and process its response */
1480 if (PA_SOURCE_IS_OPENED(u
->source
->thread_info
.state
)) {
1481 struct pollfd
*pollfd
;
1485 pollfd
= pa_rtpoll_item_get_pollfd(u
->alsa_rtpoll_item
, &n
);
1487 if ((err
= snd_pcm_poll_descriptors_revents(u
->pcm_handle
, pollfd
, n
, &revents
)) < 0) {
1488 pa_log("snd_pcm_poll_descriptors_revents() failed: %s", pa_alsa_strerror(err
));
1492 if (revents
& ~POLLIN
) {
1493 if (pa_alsa_recover_from_poll(u
->pcm_handle
, revents
) < 0)
1498 } else if (revents
&& u
->use_tsched
&& pa_log_ratelimit(PA_LOG_DEBUG
))
1499 pa_log_debug("Wakeup from ALSA!");
1506 /* If this was no regular exit from the loop we have to continue
1507 * processing messages until we received PA_MESSAGE_SHUTDOWN */
1508 pa_asyncmsgq_post(u
->thread_mq
.outq
, PA_MSGOBJECT(u
->core
), PA_CORE_MESSAGE_UNLOAD_MODULE
, u
->module
, 0, NULL
, NULL
);
1509 pa_asyncmsgq_wait_for(u
->thread_mq
.inq
, PA_MESSAGE_SHUTDOWN
);
1512 pa_log_debug("Thread shutting down");
1515 static void set_source_name(pa_source_new_data
*data
, pa_modargs
*ma
, const char *device_id
, const char *device_name
, pa_alsa_mapping
*mapping
) {
1521 pa_assert(device_name
);
1523 if ((n
= pa_modargs_get_value(ma
, "source_name", NULL
))) {
1524 pa_source_new_data_set_name(data
, n
);
1525 data
->namereg_fail
= TRUE
;
1529 if ((n
= pa_modargs_get_value(ma
, "name", NULL
)))
1530 data
->namereg_fail
= TRUE
;
1532 n
= device_id
? device_id
: device_name
;
1533 data
->namereg_fail
= FALSE
;
1537 t
= pa_sprintf_malloc("alsa_input.%s.%s", n
, mapping
->name
);
1539 t
= pa_sprintf_malloc("alsa_input.%s", n
);
1541 pa_source_new_data_set_name(data
, t
);
1545 static void find_mixer(struct userdata
*u
, pa_alsa_mapping
*mapping
, const char *element
, pa_bool_t ignore_dB
) {
1547 if (!mapping
&& !element
)
1550 if (!(u
->mixer_handle
= pa_alsa_open_mixer_for_pcm(u
->pcm_handle
, &u
->control_device
))) {
1551 pa_log_info("Failed to find a working mixer device.");
1557 if (!(u
->mixer_path
= pa_alsa_path_synthesize(element
, PA_ALSA_DIRECTION_INPUT
)))
1560 if (pa_alsa_path_probe(u
->mixer_path
, u
->mixer_handle
, ignore_dB
) < 0)
1563 pa_log_debug("Probed mixer path %s:", u
->mixer_path
->name
);
1564 pa_alsa_path_dump(u
->mixer_path
);
1567 if (!(u
->mixer_path_set
= pa_alsa_path_set_new(mapping
, PA_ALSA_DIRECTION_INPUT
, u
->paths_dir
)))
1570 pa_alsa_path_set_probe(u
->mixer_path_set
, u
->mixer_handle
, ignore_dB
);
1577 if (u
->mixer_path_set
) {
1578 pa_alsa_path_set_free(u
->mixer_path_set
);
1579 u
->mixer_path_set
= NULL
;
1580 } else if (u
->mixer_path
) {
1581 pa_alsa_path_free(u
->mixer_path
);
1582 u
->mixer_path
= NULL
;
1585 if (u
->mixer_handle
) {
1586 snd_mixer_close(u
->mixer_handle
);
1587 u
->mixer_handle
= NULL
;
1591 static int setup_mixer(struct userdata
*u
, pa_bool_t ignore_dB
) {
1592 pa_bool_t need_mixer_callback
= FALSE
;
1596 if (!u
->mixer_handle
)
1599 if (u
->source
->active_port
) {
1600 pa_alsa_port_data
*data
;
1602 /* We have a list of supported paths, so let's activate the
1603 * one that has been chosen as active */
1605 data
= PA_DEVICE_PORT_DATA(u
->source
->active_port
);
1606 u
->mixer_path
= data
->path
;
1608 pa_alsa_path_select(data
->path
, u
->mixer_handle
);
1611 pa_alsa_setting_select(data
->setting
, u
->mixer_handle
);
1615 if (!u
->mixer_path
&& u
->mixer_path_set
)
1616 u
->mixer_path
= u
->mixer_path_set
->paths
;
1618 if (u
->mixer_path
) {
1619 /* Hmm, we have only a single path, then let's activate it */
1621 pa_alsa_path_select(u
->mixer_path
, u
->mixer_handle
);
1623 if (u
->mixer_path
->settings
)
1624 pa_alsa_setting_select(u
->mixer_path
->settings
, u
->mixer_handle
);
1629 mixer_volume_init(u
);
1631 /* Will we need to register callbacks? */
1632 if (u
->mixer_path_set
&& u
->mixer_path_set
->paths
) {
1635 PA_LLIST_FOREACH(p
, u
->mixer_path_set
->paths
) {
1636 if (p
->has_volume
|| p
->has_mute
)
1637 need_mixer_callback
= TRUE
;
1640 else if (u
->mixer_path
)
1641 need_mixer_callback
= u
->mixer_path
->has_volume
|| u
->mixer_path
->has_mute
;
1643 if (need_mixer_callback
) {
1644 int (*mixer_callback
)(snd_mixer_elem_t
*, unsigned int);
1645 if (u
->source
->flags
& PA_SOURCE_DEFERRED_VOLUME
) {
1646 u
->mixer_pd
= pa_alsa_mixer_pdata_new();
1647 mixer_callback
= io_mixer_callback
;
1649 if (pa_alsa_set_mixer_rtpoll(u
->mixer_pd
, u
->mixer_handle
, u
->rtpoll
) < 0) {
1650 pa_log("Failed to initialize file descriptor monitoring");
1654 u
->mixer_fdl
= pa_alsa_fdlist_new();
1655 mixer_callback
= ctl_mixer_callback
;
1657 if (pa_alsa_fdlist_set_mixer(u
->mixer_fdl
, u
->mixer_handle
, u
->core
->mainloop
) < 0) {
1658 pa_log("Failed to initialize file descriptor monitoring");
1663 if (u
->mixer_path_set
)
1664 pa_alsa_path_set_set_callback(u
->mixer_path_set
, u
->mixer_handle
, mixer_callback
, u
);
1666 pa_alsa_path_set_callback(u
->mixer_path
, u
->mixer_handle
, mixer_callback
, u
);
1672 pa_source
*pa_alsa_source_new(pa_module
*m
, pa_modargs
*ma
, const char*driver
, pa_card
*card
, pa_alsa_mapping
*mapping
) {
1674 struct userdata
*u
= NULL
;
1675 const char *dev_id
= NULL
;
1678 uint32_t nfrags
, frag_size
, buffer_size
, tsched_size
, tsched_watermark
;
1679 snd_pcm_uframes_t period_frames
, buffer_frames
, tsched_frames
;
1681 pa_bool_t use_mmap
= TRUE
, b
, use_tsched
= TRUE
, d
, ignore_dB
= FALSE
, namereg_fail
= FALSE
, deferred_volume
= FALSE
;
1682 pa_source_new_data data
;
1683 pa_alsa_profile_set
*profile_set
= NULL
;
1688 ss
= m
->core
->default_sample_spec
;
1689 map
= m
->core
->default_channel_map
;
1690 if (pa_modargs_get_sample_spec_and_channel_map(ma
, &ss
, &map
, PA_CHANNEL_MAP_ALSA
) < 0) {
1691 pa_log("Failed to parse sample specification and channel map");
1695 frame_size
= pa_frame_size(&ss
);
1697 nfrags
= m
->core
->default_n_fragments
;
1698 frag_size
= (uint32_t) pa_usec_to_bytes(m
->core
->default_fragment_size_msec
*PA_USEC_PER_MSEC
, &ss
);
1700 frag_size
= (uint32_t) frame_size
;
1701 tsched_size
= (uint32_t) pa_usec_to_bytes(DEFAULT_TSCHED_BUFFER_USEC
, &ss
);
1702 tsched_watermark
= (uint32_t) pa_usec_to_bytes(DEFAULT_TSCHED_WATERMARK_USEC
, &ss
);
1704 if (pa_modargs_get_value_u32(ma
, "fragments", &nfrags
) < 0 ||
1705 pa_modargs_get_value_u32(ma
, "fragment_size", &frag_size
) < 0 ||
1706 pa_modargs_get_value_u32(ma
, "tsched_buffer_size", &tsched_size
) < 0 ||
1707 pa_modargs_get_value_u32(ma
, "tsched_buffer_watermark", &tsched_watermark
) < 0) {
1708 pa_log("Failed to parse buffer metrics");
1712 buffer_size
= nfrags
* frag_size
;
1714 period_frames
= frag_size
/frame_size
;
1715 buffer_frames
= buffer_size
/frame_size
;
1716 tsched_frames
= tsched_size
/frame_size
;
1718 if (pa_modargs_get_value_boolean(ma
, "mmap", &use_mmap
) < 0) {
1719 pa_log("Failed to parse mmap argument.");
1723 if (pa_modargs_get_value_boolean(ma
, "tsched", &use_tsched
) < 0) {
1724 pa_log("Failed to parse tsched argument.");
1728 if (pa_modargs_get_value_boolean(ma
, "ignore_dB", &ignore_dB
) < 0) {
1729 pa_log("Failed to parse ignore_dB argument.");
1733 deferred_volume
= m
->core
->deferred_volume
;
1734 if (pa_modargs_get_value_boolean(ma
, "deferred_volume", &deferred_volume
) < 0) {
1735 pa_log("Failed to parse deferred_volume argument.");
1739 use_tsched
= pa_alsa_may_tsched(use_tsched
);
1741 u
= pa_xnew0(struct userdata
, 1);
1744 u
->use_mmap
= use_mmap
;
1745 u
->use_tsched
= use_tsched
;
1746 u
->deferred_volume
= deferred_volume
;
1748 u
->rtpoll
= pa_rtpoll_new();
1749 pa_thread_mq_init(&u
->thread_mq
, m
->core
->mainloop
, u
->rtpoll
);
1751 u
->smoother
= pa_smoother_new(
1752 SMOOTHER_ADJUST_USEC
,
1753 SMOOTHER_WINDOW_USEC
,
1759 u
->smoother_interval
= SMOOTHER_MIN_INTERVAL
;
1761 dev_id
= pa_modargs_get_value(
1763 pa_modargs_get_value(ma
, "device", DEFAULT_DEVICE
));
1765 u
->paths_dir
= pa_xstrdup(pa_modargs_get_value(ma
, "paths_dir", NULL
));
1767 if (reserve_init(u
, dev_id
) < 0)
1770 if (reserve_monitor_init(u
, dev_id
) < 0)
1778 if (!(dev_id
= pa_modargs_get_value(ma
, "device_id", NULL
))) {
1779 pa_log("device_id= not set");
1783 if (!(u
->pcm_handle
= pa_alsa_open_by_device_id_mapping(
1787 SND_PCM_STREAM_CAPTURE
,
1788 &period_frames
, &buffer_frames
, tsched_frames
,
1792 } else if ((dev_id
= pa_modargs_get_value(ma
, "device_id", NULL
))) {
1794 if (!(profile_set
= pa_alsa_profile_set_new(NULL
, &map
)))
1797 if (!(u
->pcm_handle
= pa_alsa_open_by_device_id_auto(
1801 SND_PCM_STREAM_CAPTURE
,
1802 &period_frames
, &buffer_frames
, tsched_frames
,
1803 &b
, &d
, profile_set
, &mapping
)))
1808 if (!(u
->pcm_handle
= pa_alsa_open_by_device_string(
1809 pa_modargs_get_value(ma
, "device", DEFAULT_DEVICE
),
1812 SND_PCM_STREAM_CAPTURE
,
1813 &period_frames
, &buffer_frames
, tsched_frames
,
1818 pa_assert(u
->device_name
);
1819 pa_log_info("Successfully opened device %s.", u
->device_name
);
1821 if (pa_alsa_pcm_is_modem(u
->pcm_handle
)) {
1822 pa_log_notice("Device %s is modem, refusing further initialization.", u
->device_name
);
1827 pa_log_info("Selected mapping '%s' (%s).", mapping
->description
, mapping
->name
);
1829 if (use_mmap
&& !b
) {
1830 pa_log_info("Device doesn't support mmap(), falling back to UNIX read/write mode.");
1831 u
->use_mmap
= use_mmap
= FALSE
;
1834 if (use_tsched
&& (!b
|| !d
)) {
1835 pa_log_info("Cannot enable timer-based scheduling, falling back to sound IRQ scheduling.");
1836 u
->use_tsched
= use_tsched
= FALSE
;
1840 pa_log_info("Successfully enabled mmap() mode.");
1843 pa_log_info("Successfully enabled timer-based scheduling mode.");
1845 /* ALSA might tweak the sample spec, so recalculate the frame size */
1846 frame_size
= pa_frame_size(&ss
);
1848 find_mixer(u
, mapping
, pa_modargs_get_value(ma
, "control", NULL
), ignore_dB
);
1850 pa_source_new_data_init(&data
);
1851 data
.driver
= driver
;
1854 set_source_name(&data
, ma
, dev_id
, u
->device_name
, mapping
);
1856 /* We need to give pa_modargs_get_value_boolean() a pointer to a local
1857 * variable instead of using &data.namereg_fail directly, because
1858 * data.namereg_fail is a bitfield and taking the address of a bitfield
1859 * variable is impossible. */
1860 namereg_fail
= data
.namereg_fail
;
1861 if (pa_modargs_get_value_boolean(ma
, "namereg_fail", &namereg_fail
) < 0) {
1862 pa_log("Failed to parse namereg_fail argument.");
1863 pa_source_new_data_done(&data
);
1866 data
.namereg_fail
= namereg_fail
;
1868 pa_source_new_data_set_sample_spec(&data
, &ss
);
1869 pa_source_new_data_set_channel_map(&data
, &map
);
1871 pa_alsa_init_proplist_pcm(m
->core
, data
.proplist
, u
->pcm_handle
);
1872 pa_proplist_sets(data
.proplist
, PA_PROP_DEVICE_STRING
, u
->device_name
);
1873 pa_proplist_setf(data
.proplist
, PA_PROP_DEVICE_BUFFERING_BUFFER_SIZE
, "%lu", (unsigned long) (buffer_frames
* frame_size
));
1874 pa_proplist_setf(data
.proplist
, PA_PROP_DEVICE_BUFFERING_FRAGMENT_SIZE
, "%lu", (unsigned long) (period_frames
* frame_size
));
1875 pa_proplist_sets(data
.proplist
, PA_PROP_DEVICE_ACCESS_MODE
, u
->use_tsched
? "mmap+timer" : (u
->use_mmap
? "mmap" : "serial"));
1878 pa_proplist_sets(data
.proplist
, PA_PROP_DEVICE_PROFILE_NAME
, mapping
->name
);
1879 pa_proplist_sets(data
.proplist
, PA_PROP_DEVICE_PROFILE_DESCRIPTION
, mapping
->description
);
1882 pa_alsa_init_description(data
.proplist
);
1884 if (u
->control_device
)
1885 pa_alsa_init_proplist_ctl(data
.proplist
, u
->control_device
);
1887 if (pa_modargs_get_proplist(ma
, "source_properties", data
.proplist
, PA_UPDATE_REPLACE
) < 0) {
1888 pa_log("Invalid properties");
1889 pa_source_new_data_done(&data
);
1893 if (u
->mixer_path_set
)
1894 pa_alsa_add_ports(&data
.ports
, u
->mixer_path_set
);
1896 u
->source
= pa_source_new(m
->core
, &data
, PA_SOURCE_HARDWARE
|PA_SOURCE_LATENCY
|(u
->use_tsched
? PA_SOURCE_DYNAMIC_LATENCY
: 0));
1897 pa_source_new_data_done(&data
);
1900 pa_log("Failed to create source object");
1904 if (pa_modargs_get_value_u32(ma
, "deferred_volume_safety_margin",
1905 &u
->source
->thread_info
.volume_change_safety_margin
) < 0) {
1906 pa_log("Failed to parse deferred_volume_safety_margin parameter");
1910 if (pa_modargs_get_value_s32(ma
, "deferred_volume_extra_delay",
1911 &u
->source
->thread_info
.volume_change_extra_delay
) < 0) {
1912 pa_log("Failed to parse deferred_volume_extra_delay parameter");
1916 u
->source
->parent
.process_msg
= source_process_msg
;
1918 u
->source
->update_requested_latency
= source_update_requested_latency_cb
;
1919 u
->source
->set_state
= source_set_state_cb
;
1920 u
->source
->set_port
= source_set_port_cb
;
1921 u
->source
->userdata
= u
;
1923 pa_source_set_asyncmsgq(u
->source
, u
->thread_mq
.inq
);
1924 pa_source_set_rtpoll(u
->source
, u
->rtpoll
);
1926 u
->frame_size
= frame_size
;
1927 u
->fragment_size
= frag_size
= (size_t) (period_frames
* frame_size
);
1928 u
->hwbuf_size
= buffer_size
= (size_t) (buffer_frames
* frame_size
);
1929 pa_cvolume_mute(&u
->hardware_volume
, u
->source
->sample_spec
.channels
);
1931 pa_log_info("Using %0.1f fragments of size %lu bytes (%0.2fms), buffer size is %lu bytes (%0.2fms)",
1932 (double) u
->hwbuf_size
/ (double) u
->fragment_size
,
1933 (long unsigned) u
->fragment_size
,
1934 (double) pa_bytes_to_usec(u
->fragment_size
, &ss
) / PA_USEC_PER_MSEC
,
1935 (long unsigned) u
->hwbuf_size
,
1936 (double) pa_bytes_to_usec(u
->hwbuf_size
, &ss
) / PA_USEC_PER_MSEC
);
1938 if (u
->use_tsched
) {
1939 u
->tsched_watermark_ref
= tsched_watermark
;
1940 reset_watermark(u
, u
->tsched_watermark_ref
, &ss
, FALSE
);
1943 pa_source_set_fixed_latency(u
->source
, pa_bytes_to_usec(u
->hwbuf_size
, &ss
));
1947 if (update_sw_params(u
) < 0)
1950 if (setup_mixer(u
, ignore_dB
) < 0)
1953 pa_alsa_dump(PA_LOG_DEBUG
, u
->pcm_handle
);
1955 if (!(u
->thread
= pa_thread_new("alsa-source", thread_func
, u
))) {
1956 pa_log("Failed to create thread.");
1960 /* Get initial mixer settings */
1961 if (data
.volume_is_set
) {
1962 if (u
->source
->set_volume
)
1963 u
->source
->set_volume(u
->source
);
1965 if (u
->source
->get_volume
)
1966 u
->source
->get_volume(u
->source
);
1969 if (data
.muted_is_set
) {
1970 if (u
->source
->set_mute
)
1971 u
->source
->set_mute(u
->source
);
1973 if (u
->source
->get_mute
)
1974 u
->source
->get_mute(u
->source
);
1977 if ((data
.volume_is_set
|| data
.muted_is_set
) && u
->source
->write_volume
)
1978 u
->source
->write_volume(u
->source
);
1980 pa_source_put(u
->source
);
1983 pa_alsa_profile_set_free(profile_set
);
1993 pa_alsa_profile_set_free(profile_set
);
1998 static void userdata_free(struct userdata
*u
) {
2002 pa_source_unlink(u
->source
);
2005 pa_asyncmsgq_send(u
->thread_mq
.inq
, NULL
, PA_MESSAGE_SHUTDOWN
, NULL
, 0, NULL
);
2006 pa_thread_free(u
->thread
);
2009 pa_thread_mq_done(&u
->thread_mq
);
2012 pa_source_unref(u
->source
);
2015 pa_alsa_mixer_pdata_free(u
->mixer_pd
);
2017 if (u
->alsa_rtpoll_item
)
2018 pa_rtpoll_item_free(u
->alsa_rtpoll_item
);
2021 pa_rtpoll_free(u
->rtpoll
);
2023 if (u
->pcm_handle
) {
2024 snd_pcm_drop(u
->pcm_handle
);
2025 snd_pcm_close(u
->pcm_handle
);
2029 pa_alsa_fdlist_free(u
->mixer_fdl
);
2031 if (u
->mixer_path_set
)
2032 pa_alsa_path_set_free(u
->mixer_path_set
);
2033 else if (u
->mixer_path
)
2034 pa_alsa_path_free(u
->mixer_path
);
2036 if (u
->mixer_handle
)
2037 snd_mixer_close(u
->mixer_handle
);
2040 pa_smoother_free(u
->smoother
);
2045 pa_xfree(u
->device_name
);
2046 pa_xfree(u
->control_device
);
2047 pa_xfree(u
->paths_dir
);
2051 void pa_alsa_source_free(pa_source
*s
) {
2054 pa_source_assert_ref(s
);
2055 pa_assert_se(u
= s
->userdata
);