5 * Copyright (c) by Jaroslav Kysela <perex@perex.cz>
7 * More accurate positioning and full-duplex support:
8 * Copyright (c) Ahmet İnan <ainan at mathematik.uni-freiburg.de>
10 * Major (almost complete) rewrite:
11 * Copyright (c) by Takashi Iwai <tiwai@suse.de>
13 * A next major update in 2010 (separate timers for playback and capture):
14 * Copyright (c) Jaroslav Kysela <perex@perex.cz>
16 * This program is free software; you can redistribute it and/or modify
17 * it under the terms of the GNU General Public License as published by
18 * the Free Software Foundation; either version 2 of the License, or
19 * (at your option) any later version.
21 * This program is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 * GNU General Public License for more details.
26 * You should have received a copy of the GNU General Public License
27 * along with this program; if not, write to the Free Software
28 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
32 #include <linux/init.h>
33 #include <linux/jiffies.h>
34 #include <linux/slab.h>
35 #include <linux/time.h>
36 #include <linux/wait.h>
37 #include <linux/module.h>
38 #include <linux/platform_device.h>
39 #include <sound/core.h>
40 #include <sound/control.h>
41 #include <sound/pcm.h>
42 #include <sound/info.h>
43 #include <sound/initval.h>
45 MODULE_AUTHOR("Jaroslav Kysela <perex@perex.cz>");
46 MODULE_DESCRIPTION("A loopback soundcard");
47 MODULE_LICENSE("GPL");
48 MODULE_SUPPORTED_DEVICE("{{ALSA,Loopback soundcard}}");
50 #define MAX_PCM_SUBSTREAMS 8
52 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-MAX */
53 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* ID for this card */
54 static bool enable[SNDRV_CARDS] = {1, [1 ... (SNDRV_CARDS - 1)] = 0};
55 static int pcm_substreams[SNDRV_CARDS] = {[0 ... (SNDRV_CARDS - 1)] = 8};
56 static int pcm_notify[SNDRV_CARDS];
58 module_param_array(index, int, NULL, 0444);
59 MODULE_PARM_DESC(index, "Index value for loopback soundcard.");
60 module_param_array(id, charp, NULL, 0444);
61 MODULE_PARM_DESC(id, "ID string for loopback soundcard.");
62 module_param_array(enable, bool, NULL, 0444);
63 MODULE_PARM_DESC(enable, "Enable this loopback soundcard.");
64 module_param_array(pcm_substreams, int, NULL, 0444);
65 MODULE_PARM_DESC(pcm_substreams, "PCM substreams # (1-8) for loopback driver.");
66 module_param_array(pcm_notify, int, NULL, 0444);
67 MODULE_PARM_DESC(pcm_notify, "Break capture when PCM format/rate/channels changes.");
69 #define NO_PITCH 100000
73 struct loopback_cable {
75 struct loopback_pcm *streams[2];
76 struct snd_pcm_hardware hw;
83 struct loopback_setup {
84 unsigned int notify: 1;
85 unsigned int rate_shift;
88 unsigned int channels;
89 struct snd_ctl_elem_id active_id;
90 struct snd_ctl_elem_id format_id;
91 struct snd_ctl_elem_id rate_id;
92 struct snd_ctl_elem_id channels_id;
96 struct snd_card *card;
97 struct mutex cable_lock;
98 struct loopback_cable *cables[MAX_PCM_SUBSTREAMS][2];
99 struct snd_pcm *pcm[2];
100 struct loopback_setup setup[MAX_PCM_SUBSTREAMS][2];
103 struct loopback_pcm {
104 struct loopback *loopback;
105 struct snd_pcm_substream *substream;
106 struct loopback_cable *cable;
107 unsigned int pcm_buffer_size;
108 unsigned int buf_pos; /* position in buffer */
109 unsigned int silent_size;
111 unsigned int pcm_period_size;
112 unsigned int pcm_bps; /* bytes per second */
113 unsigned int pcm_salign; /* bytes per sample * channels */
114 unsigned int pcm_rate_shift; /* rate shift value */
116 unsigned int period_update_pending :1;
118 unsigned int irq_pos; /* fractional IRQ position */
119 unsigned int period_size_frac;
120 unsigned int last_drift;
121 unsigned long last_jiffies;
122 struct timer_list timer;
125 static struct platform_device *devices[SNDRV_CARDS];
127 static inline unsigned int byte_pos(struct loopback_pcm *dpcm, unsigned int x)
129 if (dpcm->pcm_rate_shift == NO_PITCH) {
132 x = div_u64(NO_PITCH * (unsigned long long)x,
133 HZ * (unsigned long long)dpcm->pcm_rate_shift);
135 return x - (x % dpcm->pcm_salign);
138 static inline unsigned int frac_pos(struct loopback_pcm *dpcm, unsigned int x)
140 if (dpcm->pcm_rate_shift == NO_PITCH) { /* no pitch */
143 x = div_u64(dpcm->pcm_rate_shift * (unsigned long long)x * HZ,
149 static inline struct loopback_setup *get_setup(struct loopback_pcm *dpcm)
151 int device = dpcm->substream->pstr->pcm->device;
153 if (dpcm->substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
155 return &dpcm->loopback->setup[dpcm->substream->number][device];
158 static inline unsigned int get_notify(struct loopback_pcm *dpcm)
160 return get_setup(dpcm)->notify;
163 static inline unsigned int get_rate_shift(struct loopback_pcm *dpcm)
165 return get_setup(dpcm)->rate_shift;
168 /* call in cable->lock */
169 static void loopback_timer_start(struct loopback_pcm *dpcm)
172 unsigned int rate_shift = get_rate_shift(dpcm);
174 if (rate_shift != dpcm->pcm_rate_shift) {
175 dpcm->pcm_rate_shift = rate_shift;
176 dpcm->period_size_frac = frac_pos(dpcm, dpcm->pcm_period_size);
178 if (dpcm->period_size_frac <= dpcm->irq_pos) {
179 dpcm->irq_pos %= dpcm->period_size_frac;
180 dpcm->period_update_pending = 1;
182 tick = dpcm->period_size_frac - dpcm->irq_pos;
183 tick = (tick + dpcm->pcm_bps - 1) / dpcm->pcm_bps;
184 dpcm->timer.expires = jiffies + tick;
185 add_timer(&dpcm->timer);
188 /* call in cable->lock */
189 static inline void loopback_timer_stop(struct loopback_pcm *dpcm)
191 del_timer(&dpcm->timer);
192 dpcm->timer.expires = 0;
195 #define CABLE_VALID_PLAYBACK (1 << SNDRV_PCM_STREAM_PLAYBACK)
196 #define CABLE_VALID_CAPTURE (1 << SNDRV_PCM_STREAM_CAPTURE)
197 #define CABLE_VALID_BOTH (CABLE_VALID_PLAYBACK|CABLE_VALID_CAPTURE)
199 static int loopback_check_format(struct loopback_cable *cable, int stream)
201 struct snd_pcm_runtime *runtime, *cruntime;
202 struct loopback_setup *setup;
203 struct snd_card *card;
206 if (cable->valid != CABLE_VALID_BOTH) {
207 if (stream == SNDRV_PCM_STREAM_PLAYBACK)
211 runtime = cable->streams[SNDRV_PCM_STREAM_PLAYBACK]->
213 cruntime = cable->streams[SNDRV_PCM_STREAM_CAPTURE]->
215 check = runtime->format != cruntime->format ||
216 runtime->rate != cruntime->rate ||
217 runtime->channels != cruntime->channels;
220 if (stream == SNDRV_PCM_STREAM_CAPTURE) {
223 snd_pcm_stop(cable->streams[SNDRV_PCM_STREAM_CAPTURE]->
224 substream, SNDRV_PCM_STATE_DRAINING);
226 runtime = cable->streams[SNDRV_PCM_STREAM_PLAYBACK]->
228 setup = get_setup(cable->streams[SNDRV_PCM_STREAM_PLAYBACK]);
229 card = cable->streams[SNDRV_PCM_STREAM_PLAYBACK]->loopback->card;
230 if (setup->format != runtime->format) {
231 snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_VALUE,
233 setup->format = runtime->format;
235 if (setup->rate != runtime->rate) {
236 snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_VALUE,
238 setup->rate = runtime->rate;
240 if (setup->channels != runtime->channels) {
241 snd_ctl_notify(card, SNDRV_CTL_EVENT_MASK_VALUE,
242 &setup->channels_id);
243 setup->channels = runtime->channels;
249 static void loopback_active_notify(struct loopback_pcm *dpcm)
251 snd_ctl_notify(dpcm->loopback->card,
252 SNDRV_CTL_EVENT_MASK_VALUE,
253 &get_setup(dpcm)->active_id);
256 static int loopback_trigger(struct snd_pcm_substream *substream, int cmd)
258 struct snd_pcm_runtime *runtime = substream->runtime;
259 struct loopback_pcm *dpcm = runtime->private_data;
260 struct loopback_cable *cable = dpcm->cable;
261 int err, stream = 1 << substream->stream;
264 case SNDRV_PCM_TRIGGER_START:
265 err = loopback_check_format(cable, substream->stream);
268 dpcm->last_jiffies = jiffies;
269 dpcm->pcm_rate_shift = 0;
270 dpcm->last_drift = 0;
271 spin_lock(&cable->lock);
272 cable->running |= stream;
273 cable->pause &= ~stream;
274 loopback_timer_start(dpcm);
275 spin_unlock(&cable->lock);
276 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
277 loopback_active_notify(dpcm);
279 case SNDRV_PCM_TRIGGER_STOP:
280 spin_lock(&cable->lock);
281 cable->running &= ~stream;
282 cable->pause &= ~stream;
283 loopback_timer_stop(dpcm);
284 spin_unlock(&cable->lock);
285 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK)
286 loopback_active_notify(dpcm);
288 case SNDRV_PCM_TRIGGER_PAUSE_PUSH:
289 case SNDRV_PCM_TRIGGER_SUSPEND:
290 spin_lock(&cable->lock);
291 cable->pause |= stream;
292 loopback_timer_stop(dpcm);
293 spin_unlock(&cable->lock);
295 case SNDRV_PCM_TRIGGER_PAUSE_RELEASE:
296 case SNDRV_PCM_TRIGGER_RESUME:
297 spin_lock(&cable->lock);
298 dpcm->last_jiffies = jiffies;
299 cable->pause &= ~stream;
300 loopback_timer_start(dpcm);
301 spin_unlock(&cable->lock);
309 static void params_change_substream(struct loopback_pcm *dpcm,
310 struct snd_pcm_runtime *runtime)
312 struct snd_pcm_runtime *dst_runtime;
314 if (dpcm == NULL || dpcm->substream == NULL)
316 dst_runtime = dpcm->substream->runtime;
317 if (dst_runtime == NULL)
319 dst_runtime->hw = dpcm->cable->hw;
322 static void params_change(struct snd_pcm_substream *substream)
324 struct snd_pcm_runtime *runtime = substream->runtime;
325 struct loopback_pcm *dpcm = runtime->private_data;
326 struct loopback_cable *cable = dpcm->cable;
328 cable->hw.formats = pcm_format_to_bits(runtime->format);
329 cable->hw.rate_min = runtime->rate;
330 cable->hw.rate_max = runtime->rate;
331 cable->hw.channels_min = runtime->channels;
332 cable->hw.channels_max = runtime->channels;
333 params_change_substream(cable->streams[SNDRV_PCM_STREAM_PLAYBACK],
335 params_change_substream(cable->streams[SNDRV_PCM_STREAM_CAPTURE],
339 static int loopback_prepare(struct snd_pcm_substream *substream)
341 struct snd_pcm_runtime *runtime = substream->runtime;
342 struct loopback_pcm *dpcm = runtime->private_data;
343 struct loopback_cable *cable = dpcm->cable;
346 salign = (snd_pcm_format_width(runtime->format) *
347 runtime->channels) / 8;
348 bps = salign * runtime->rate;
349 if (bps <= 0 || salign <= 0)
353 dpcm->pcm_buffer_size = frames_to_bytes(runtime, runtime->buffer_size);
354 if (substream->stream == SNDRV_PCM_STREAM_CAPTURE) {
355 /* clear capture buffer */
356 dpcm->silent_size = dpcm->pcm_buffer_size;
357 snd_pcm_format_set_silence(runtime->format, runtime->dma_area,
358 runtime->buffer_size * runtime->channels);
362 dpcm->period_update_pending = 0;
364 dpcm->pcm_salign = salign;
365 dpcm->pcm_period_size = frames_to_bytes(runtime, runtime->period_size);
367 mutex_lock(&dpcm->loopback->cable_lock);
368 if (!(cable->valid & ~(1 << substream->stream)) ||
369 (get_setup(dpcm)->notify &&
370 substream->stream == SNDRV_PCM_STREAM_PLAYBACK))
371 params_change(substream);
372 cable->valid |= 1 << substream->stream;
373 mutex_unlock(&dpcm->loopback->cable_lock);
378 static void clear_capture_buf(struct loopback_pcm *dpcm, unsigned int bytes)
380 struct snd_pcm_runtime *runtime = dpcm->substream->runtime;
381 char *dst = runtime->dma_area;
382 unsigned int dst_off = dpcm->buf_pos;
384 if (dpcm->silent_size >= dpcm->pcm_buffer_size)
386 if (dpcm->silent_size + bytes > dpcm->pcm_buffer_size)
387 bytes = dpcm->pcm_buffer_size - dpcm->silent_size;
390 unsigned int size = bytes;
391 if (dst_off + size > dpcm->pcm_buffer_size)
392 size = dpcm->pcm_buffer_size - dst_off;
393 snd_pcm_format_set_silence(runtime->format, dst + dst_off,
394 bytes_to_frames(runtime, size) *
396 dpcm->silent_size += size;
404 static void copy_play_buf(struct loopback_pcm *play,
405 struct loopback_pcm *capt,
408 struct snd_pcm_runtime *runtime = play->substream->runtime;
409 char *src = runtime->dma_area;
410 char *dst = capt->substream->runtime->dma_area;
411 unsigned int src_off = play->buf_pos;
412 unsigned int dst_off = capt->buf_pos;
413 unsigned int clear_bytes = 0;
415 /* check if playback is draining, trim the capture copy size
416 * when our pointer is at the end of playback ring buffer */
417 if (runtime->status->state == SNDRV_PCM_STATE_DRAINING &&
418 snd_pcm_playback_hw_avail(runtime) < runtime->buffer_size) {
419 snd_pcm_uframes_t appl_ptr, appl_ptr1, diff;
420 appl_ptr = appl_ptr1 = runtime->control->appl_ptr;
421 appl_ptr1 -= appl_ptr1 % runtime->buffer_size;
422 appl_ptr1 += play->buf_pos / play->pcm_salign;
423 if (appl_ptr < appl_ptr1)
424 appl_ptr1 -= runtime->buffer_size;
425 diff = (appl_ptr - appl_ptr1) * play->pcm_salign;
427 clear_bytes = bytes - diff;
433 unsigned int size = bytes;
434 if (src_off + size > play->pcm_buffer_size)
435 size = play->pcm_buffer_size - src_off;
436 if (dst_off + size > capt->pcm_buffer_size)
437 size = capt->pcm_buffer_size - dst_off;
438 memcpy(dst + dst_off, src + src_off, size);
439 capt->silent_size = 0;
443 src_off = (src_off + size) % play->pcm_buffer_size;
444 dst_off = (dst_off + size) % capt->pcm_buffer_size;
447 if (clear_bytes > 0) {
448 clear_capture_buf(capt, clear_bytes);
449 capt->silent_size = 0;
453 static inline unsigned int bytepos_delta(struct loopback_pcm *dpcm,
454 unsigned int jiffies_delta)
456 unsigned long last_pos;
459 last_pos = byte_pos(dpcm, dpcm->irq_pos);
460 dpcm->irq_pos += jiffies_delta * dpcm->pcm_bps;
461 delta = byte_pos(dpcm, dpcm->irq_pos) - last_pos;
462 if (delta >= dpcm->last_drift)
463 delta -= dpcm->last_drift;
464 dpcm->last_drift = 0;
465 if (dpcm->irq_pos >= dpcm->period_size_frac) {
466 dpcm->irq_pos %= dpcm->period_size_frac;
467 dpcm->period_update_pending = 1;
472 static inline void bytepos_finish(struct loopback_pcm *dpcm,
475 dpcm->buf_pos += delta;
476 dpcm->buf_pos %= dpcm->pcm_buffer_size;
479 /* call in cable->lock */
480 static unsigned int loopback_pos_update(struct loopback_cable *cable)
482 struct loopback_pcm *dpcm_play =
483 cable->streams[SNDRV_PCM_STREAM_PLAYBACK];
484 struct loopback_pcm *dpcm_capt =
485 cable->streams[SNDRV_PCM_STREAM_CAPTURE];
486 unsigned long delta_play = 0, delta_capt = 0;
487 unsigned int running, count1, count2;
489 running = cable->running ^ cable->pause;
490 if (running & (1 << SNDRV_PCM_STREAM_PLAYBACK)) {
491 delta_play = jiffies - dpcm_play->last_jiffies;
492 dpcm_play->last_jiffies += delta_play;
495 if (running & (1 << SNDRV_PCM_STREAM_CAPTURE)) {
496 delta_capt = jiffies - dpcm_capt->last_jiffies;
497 dpcm_capt->last_jiffies += delta_capt;
500 if (delta_play == 0 && delta_capt == 0)
503 if (delta_play > delta_capt) {
504 count1 = bytepos_delta(dpcm_play, delta_play - delta_capt);
505 bytepos_finish(dpcm_play, count1);
506 delta_play = delta_capt;
507 } else if (delta_play < delta_capt) {
508 count1 = bytepos_delta(dpcm_capt, delta_capt - delta_play);
509 clear_capture_buf(dpcm_capt, count1);
510 bytepos_finish(dpcm_capt, count1);
511 delta_capt = delta_play;
514 if (delta_play == 0 && delta_capt == 0)
517 /* note delta_capt == delta_play at this moment */
518 count1 = bytepos_delta(dpcm_play, delta_play);
519 count2 = bytepos_delta(dpcm_capt, delta_capt);
520 if (count1 < count2) {
521 dpcm_capt->last_drift = count2 - count1;
523 } else if (count1 > count2) {
524 dpcm_play->last_drift = count1 - count2;
526 copy_play_buf(dpcm_play, dpcm_capt, count1);
527 bytepos_finish(dpcm_play, count1);
528 bytepos_finish(dpcm_capt, count1);
533 static void loopback_timer_function(unsigned long data)
535 struct loopback_pcm *dpcm = (struct loopback_pcm *)data;
538 spin_lock_irqsave(&dpcm->cable->lock, flags);
539 if (loopback_pos_update(dpcm->cable) & (1 << dpcm->substream->stream)) {
540 loopback_timer_start(dpcm);
541 if (dpcm->period_update_pending) {
542 dpcm->period_update_pending = 0;
543 spin_unlock_irqrestore(&dpcm->cable->lock, flags);
544 /* need to unlock before calling below */
545 snd_pcm_period_elapsed(dpcm->substream);
549 spin_unlock_irqrestore(&dpcm->cable->lock, flags);
552 static snd_pcm_uframes_t loopback_pointer(struct snd_pcm_substream *substream)
554 struct snd_pcm_runtime *runtime = substream->runtime;
555 struct loopback_pcm *dpcm = runtime->private_data;
556 snd_pcm_uframes_t pos;
558 spin_lock(&dpcm->cable->lock);
559 loopback_pos_update(dpcm->cable);
561 spin_unlock(&dpcm->cable->lock);
562 return bytes_to_frames(runtime, pos);
565 static struct snd_pcm_hardware loopback_pcm_hardware =
567 .info = (SNDRV_PCM_INFO_INTERLEAVED | SNDRV_PCM_INFO_MMAP |
568 SNDRV_PCM_INFO_MMAP_VALID | SNDRV_PCM_INFO_PAUSE |
569 SNDRV_PCM_INFO_RESUME),
570 .formats = (SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_S16_BE |
571 SNDRV_PCM_FMTBIT_S32_LE | SNDRV_PCM_FMTBIT_S32_BE |
572 SNDRV_PCM_FMTBIT_FLOAT_LE | SNDRV_PCM_FMTBIT_FLOAT_BE),
573 .rates = SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_8000_192000,
578 .buffer_bytes_max = 2 * 1024 * 1024,
579 .period_bytes_min = 64,
580 /* note check overflow in frac_pos() using pcm_rate_shift before
581 changing period_bytes_max value */
582 .period_bytes_max = 1024 * 1024,
588 static void loopback_runtime_free(struct snd_pcm_runtime *runtime)
590 struct loopback_pcm *dpcm = runtime->private_data;
594 static int loopback_hw_params(struct snd_pcm_substream *substream,
595 struct snd_pcm_hw_params *params)
597 return snd_pcm_lib_alloc_vmalloc_buffer(substream,
598 params_buffer_bytes(params));
601 static int loopback_hw_free(struct snd_pcm_substream *substream)
603 struct snd_pcm_runtime *runtime = substream->runtime;
604 struct loopback_pcm *dpcm = runtime->private_data;
605 struct loopback_cable *cable = dpcm->cable;
607 mutex_lock(&dpcm->loopback->cable_lock);
608 cable->valid &= ~(1 << substream->stream);
609 mutex_unlock(&dpcm->loopback->cable_lock);
610 return snd_pcm_lib_free_vmalloc_buffer(substream);
613 static unsigned int get_cable_index(struct snd_pcm_substream *substream)
615 if (!substream->pcm->device)
616 return substream->stream;
618 return !substream->stream;
621 static int rule_format(struct snd_pcm_hw_params *params,
622 struct snd_pcm_hw_rule *rule)
625 struct snd_pcm_hardware *hw = rule->private;
626 struct snd_mask *maskp = hw_param_mask(params, rule->var);
628 maskp->bits[0] &= (u_int32_t)hw->formats;
629 maskp->bits[1] &= (u_int32_t)(hw->formats >> 32);
630 memset(maskp->bits + 2, 0, (SNDRV_MASK_MAX-64) / 8); /* clear rest */
631 if (! maskp->bits[0] && ! maskp->bits[1])
636 static int rule_rate(struct snd_pcm_hw_params *params,
637 struct snd_pcm_hw_rule *rule)
639 struct snd_pcm_hardware *hw = rule->private;
640 struct snd_interval t;
642 t.min = hw->rate_min;
643 t.max = hw->rate_max;
644 t.openmin = t.openmax = 0;
646 return snd_interval_refine(hw_param_interval(params, rule->var), &t);
649 static int rule_channels(struct snd_pcm_hw_params *params,
650 struct snd_pcm_hw_rule *rule)
652 struct snd_pcm_hardware *hw = rule->private;
653 struct snd_interval t;
655 t.min = hw->channels_min;
656 t.max = hw->channels_max;
657 t.openmin = t.openmax = 0;
659 return snd_interval_refine(hw_param_interval(params, rule->var), &t);
662 static int loopback_open(struct snd_pcm_substream *substream)
664 struct snd_pcm_runtime *runtime = substream->runtime;
665 struct loopback *loopback = substream->private_data;
666 struct loopback_pcm *dpcm;
667 struct loopback_cable *cable;
669 int dev = get_cable_index(substream);
671 mutex_lock(&loopback->cable_lock);
672 dpcm = kzalloc(sizeof(*dpcm), GFP_KERNEL);
677 dpcm->loopback = loopback;
678 dpcm->substream = substream;
679 setup_timer(&dpcm->timer, loopback_timer_function,
680 (unsigned long)dpcm);
682 cable = loopback->cables[substream->number][dev];
684 cable = kzalloc(sizeof(*cable), GFP_KERNEL);
690 spin_lock_init(&cable->lock);
691 cable->hw = loopback_pcm_hardware;
692 loopback->cables[substream->number][dev] = cable;
695 cable->streams[substream->stream] = dpcm;
697 snd_pcm_hw_constraint_integer(runtime, SNDRV_PCM_HW_PARAM_PERIODS);
699 /* use dynamic rules based on actual runtime->hw values */
700 /* note that the default rules created in the PCM midlevel code */
701 /* are cached -> they do not reflect the actual state */
702 err = snd_pcm_hw_rule_add(runtime, 0,
703 SNDRV_PCM_HW_PARAM_FORMAT,
704 rule_format, &runtime->hw,
705 SNDRV_PCM_HW_PARAM_FORMAT, -1);
708 err = snd_pcm_hw_rule_add(runtime, 0,
709 SNDRV_PCM_HW_PARAM_RATE,
710 rule_rate, &runtime->hw,
711 SNDRV_PCM_HW_PARAM_RATE, -1);
714 err = snd_pcm_hw_rule_add(runtime, 0,
715 SNDRV_PCM_HW_PARAM_CHANNELS,
716 rule_channels, &runtime->hw,
717 SNDRV_PCM_HW_PARAM_CHANNELS, -1);
721 runtime->private_data = dpcm;
722 runtime->private_free = loopback_runtime_free;
723 if (get_notify(dpcm))
724 runtime->hw = loopback_pcm_hardware;
726 runtime->hw = cable->hw;
728 mutex_unlock(&loopback->cable_lock);
732 static int loopback_close(struct snd_pcm_substream *substream)
734 struct loopback *loopback = substream->private_data;
735 struct loopback_pcm *dpcm = substream->runtime->private_data;
736 struct loopback_cable *cable;
737 int dev = get_cable_index(substream);
739 loopback_timer_stop(dpcm);
740 mutex_lock(&loopback->cable_lock);
741 cable = loopback->cables[substream->number][dev];
742 if (cable->streams[!substream->stream]) {
743 /* other stream is still alive */
744 cable->streams[substream->stream] = NULL;
747 loopback->cables[substream->number][dev] = NULL;
750 mutex_unlock(&loopback->cable_lock);
754 static struct snd_pcm_ops loopback_playback_ops = {
755 .open = loopback_open,
756 .close = loopback_close,
757 .ioctl = snd_pcm_lib_ioctl,
758 .hw_params = loopback_hw_params,
759 .hw_free = loopback_hw_free,
760 .prepare = loopback_prepare,
761 .trigger = loopback_trigger,
762 .pointer = loopback_pointer,
763 .page = snd_pcm_lib_get_vmalloc_page,
764 .mmap = snd_pcm_lib_mmap_vmalloc,
767 static struct snd_pcm_ops loopback_capture_ops = {
768 .open = loopback_open,
769 .close = loopback_close,
770 .ioctl = snd_pcm_lib_ioctl,
771 .hw_params = loopback_hw_params,
772 .hw_free = loopback_hw_free,
773 .prepare = loopback_prepare,
774 .trigger = loopback_trigger,
775 .pointer = loopback_pointer,
776 .page = snd_pcm_lib_get_vmalloc_page,
777 .mmap = snd_pcm_lib_mmap_vmalloc,
780 static int loopback_pcm_new(struct loopback *loopback,
781 int device, int substreams)
786 err = snd_pcm_new(loopback->card, "Loopback PCM", device,
787 substreams, substreams, &pcm);
790 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK, &loopback_playback_ops);
791 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &loopback_capture_ops);
793 pcm->private_data = loopback;
795 strcpy(pcm->name, "Loopback PCM");
797 loopback->pcm[device] = pcm;
801 static int loopback_rate_shift_info(struct snd_kcontrol *kcontrol,
802 struct snd_ctl_elem_info *uinfo)
804 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
806 uinfo->value.integer.min = 80000;
807 uinfo->value.integer.max = 120000;
808 uinfo->value.integer.step = 1;
812 static int loopback_rate_shift_get(struct snd_kcontrol *kcontrol,
813 struct snd_ctl_elem_value *ucontrol)
815 struct loopback *loopback = snd_kcontrol_chip(kcontrol);
817 ucontrol->value.integer.value[0] =
818 loopback->setup[kcontrol->id.subdevice]
819 [kcontrol->id.device].rate_shift;
823 static int loopback_rate_shift_put(struct snd_kcontrol *kcontrol,
824 struct snd_ctl_elem_value *ucontrol)
826 struct loopback *loopback = snd_kcontrol_chip(kcontrol);
830 val = ucontrol->value.integer.value[0];
835 mutex_lock(&loopback->cable_lock);
836 if (val != loopback->setup[kcontrol->id.subdevice]
837 [kcontrol->id.device].rate_shift) {
838 loopback->setup[kcontrol->id.subdevice]
839 [kcontrol->id.device].rate_shift = val;
842 mutex_unlock(&loopback->cable_lock);
846 static int loopback_notify_get(struct snd_kcontrol *kcontrol,
847 struct snd_ctl_elem_value *ucontrol)
849 struct loopback *loopback = snd_kcontrol_chip(kcontrol);
851 ucontrol->value.integer.value[0] =
852 loopback->setup[kcontrol->id.subdevice]
853 [kcontrol->id.device].notify;
857 static int loopback_notify_put(struct snd_kcontrol *kcontrol,
858 struct snd_ctl_elem_value *ucontrol)
860 struct loopback *loopback = snd_kcontrol_chip(kcontrol);
864 val = ucontrol->value.integer.value[0] ? 1 : 0;
865 if (val != loopback->setup[kcontrol->id.subdevice]
866 [kcontrol->id.device].notify) {
867 loopback->setup[kcontrol->id.subdevice]
868 [kcontrol->id.device].notify = val;
874 static int loopback_active_get(struct snd_kcontrol *kcontrol,
875 struct snd_ctl_elem_value *ucontrol)
877 struct loopback *loopback = snd_kcontrol_chip(kcontrol);
878 struct loopback_cable *cable = loopback->cables
879 [kcontrol->id.subdevice][kcontrol->id.device ^ 1];
880 unsigned int val = 0;
883 val = (cable->running & (1 << SNDRV_PCM_STREAM_PLAYBACK)) ?
885 ucontrol->value.integer.value[0] = val;
889 static int loopback_format_info(struct snd_kcontrol *kcontrol,
890 struct snd_ctl_elem_info *uinfo)
892 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
894 uinfo->value.integer.min = 0;
895 uinfo->value.integer.max = SNDRV_PCM_FORMAT_LAST;
896 uinfo->value.integer.step = 1;
900 static int loopback_format_get(struct snd_kcontrol *kcontrol,
901 struct snd_ctl_elem_value *ucontrol)
903 struct loopback *loopback = snd_kcontrol_chip(kcontrol);
905 ucontrol->value.integer.value[0] =
906 loopback->setup[kcontrol->id.subdevice]
907 [kcontrol->id.device].format;
911 static int loopback_rate_info(struct snd_kcontrol *kcontrol,
912 struct snd_ctl_elem_info *uinfo)
914 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
916 uinfo->value.integer.min = 0;
917 uinfo->value.integer.max = 192000;
918 uinfo->value.integer.step = 1;
922 static int loopback_rate_get(struct snd_kcontrol *kcontrol,
923 struct snd_ctl_elem_value *ucontrol)
925 struct loopback *loopback = snd_kcontrol_chip(kcontrol);
927 ucontrol->value.integer.value[0] =
928 loopback->setup[kcontrol->id.subdevice]
929 [kcontrol->id.device].rate;
933 static int loopback_channels_info(struct snd_kcontrol *kcontrol,
934 struct snd_ctl_elem_info *uinfo)
936 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
938 uinfo->value.integer.min = 1;
939 uinfo->value.integer.max = 1024;
940 uinfo->value.integer.step = 1;
944 static int loopback_channels_get(struct snd_kcontrol *kcontrol,
945 struct snd_ctl_elem_value *ucontrol)
947 struct loopback *loopback = snd_kcontrol_chip(kcontrol);
949 ucontrol->value.integer.value[0] =
950 loopback->setup[kcontrol->id.subdevice]
951 [kcontrol->id.device].channels;
955 static struct snd_kcontrol_new loopback_controls[] = {
957 .iface = SNDRV_CTL_ELEM_IFACE_PCM,
958 .name = "PCM Rate Shift 100000",
959 .info = loopback_rate_shift_info,
960 .get = loopback_rate_shift_get,
961 .put = loopback_rate_shift_put,
964 .iface = SNDRV_CTL_ELEM_IFACE_PCM,
965 .name = "PCM Notify",
966 .info = snd_ctl_boolean_mono_info,
967 .get = loopback_notify_get,
968 .put = loopback_notify_put,
972 .access = SNDRV_CTL_ELEM_ACCESS_READ,
973 .iface = SNDRV_CTL_ELEM_IFACE_PCM,
974 .name = "PCM Slave Active",
975 .info = snd_ctl_boolean_mono_info,
976 .get = loopback_active_get,
980 .access = SNDRV_CTL_ELEM_ACCESS_READ,
981 .iface = SNDRV_CTL_ELEM_IFACE_PCM,
982 .name = "PCM Slave Format",
983 .info = loopback_format_info,
984 .get = loopback_format_get
988 .access = SNDRV_CTL_ELEM_ACCESS_READ,
989 .iface = SNDRV_CTL_ELEM_IFACE_PCM,
990 .name = "PCM Slave Rate",
991 .info = loopback_rate_info,
992 .get = loopback_rate_get
994 #define CHANNELS_IDX 5
996 .access = SNDRV_CTL_ELEM_ACCESS_READ,
997 .iface = SNDRV_CTL_ELEM_IFACE_PCM,
998 .name = "PCM Slave Channels",
999 .info = loopback_channels_info,
1000 .get = loopback_channels_get
1004 static int loopback_mixer_new(struct loopback *loopback, int notify)
1006 struct snd_card *card = loopback->card;
1007 struct snd_pcm *pcm;
1008 struct snd_kcontrol *kctl;
1009 struct loopback_setup *setup;
1010 int err, dev, substr, substr_count, idx;
1012 strcpy(card->mixername, "Loopback Mixer");
1013 for (dev = 0; dev < 2; dev++) {
1014 pcm = loopback->pcm[dev];
1016 pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream_count;
1017 for (substr = 0; substr < substr_count; substr++) {
1018 setup = &loopback->setup[substr][dev];
1019 setup->notify = notify;
1020 setup->rate_shift = NO_PITCH;
1021 setup->format = SNDRV_PCM_FORMAT_S16_LE;
1022 setup->rate = 48000;
1023 setup->channels = 2;
1024 for (idx = 0; idx < ARRAY_SIZE(loopback_controls);
1026 kctl = snd_ctl_new1(&loopback_controls[idx],
1030 kctl->id.device = dev;
1031 kctl->id.subdevice = substr;
1034 setup->active_id = kctl->id;
1037 setup->format_id = kctl->id;
1040 setup->rate_id = kctl->id;
1043 setup->channels_id = kctl->id;
1048 err = snd_ctl_add(card, kctl);
1057 #ifdef CONFIG_PROC_FS
1059 static void print_dpcm_info(struct snd_info_buffer *buffer,
1060 struct loopback_pcm *dpcm,
1063 snd_iprintf(buffer, " %s\n", id);
1065 snd_iprintf(buffer, " inactive\n");
1068 snd_iprintf(buffer, " buffer_size:\t%u\n", dpcm->pcm_buffer_size);
1069 snd_iprintf(buffer, " buffer_pos:\t\t%u\n", dpcm->buf_pos);
1070 snd_iprintf(buffer, " silent_size:\t%u\n", dpcm->silent_size);
1071 snd_iprintf(buffer, " period_size:\t%u\n", dpcm->pcm_period_size);
1072 snd_iprintf(buffer, " bytes_per_sec:\t%u\n", dpcm->pcm_bps);
1073 snd_iprintf(buffer, " sample_align:\t%u\n", dpcm->pcm_salign);
1074 snd_iprintf(buffer, " rate_shift:\t\t%u\n", dpcm->pcm_rate_shift);
1075 snd_iprintf(buffer, " update_pending:\t%u\n",
1076 dpcm->period_update_pending);
1077 snd_iprintf(buffer, " irq_pos:\t\t%u\n", dpcm->irq_pos);
1078 snd_iprintf(buffer, " period_frac:\t%u\n", dpcm->period_size_frac);
1079 snd_iprintf(buffer, " last_jiffies:\t%lu (%lu)\n",
1080 dpcm->last_jiffies, jiffies);
1081 snd_iprintf(buffer, " timer_expires:\t%lu\n", dpcm->timer.expires);
1084 static void print_substream_info(struct snd_info_buffer *buffer,
1085 struct loopback *loopback,
1089 struct loopback_cable *cable = loopback->cables[sub][num];
1091 snd_iprintf(buffer, "Cable %i substream %i:\n", num, sub);
1092 if (cable == NULL) {
1093 snd_iprintf(buffer, " inactive\n");
1096 snd_iprintf(buffer, " valid: %u\n", cable->valid);
1097 snd_iprintf(buffer, " running: %u\n", cable->running);
1098 snd_iprintf(buffer, " pause: %u\n", cable->pause);
1099 print_dpcm_info(buffer, cable->streams[0], "Playback");
1100 print_dpcm_info(buffer, cable->streams[1], "Capture");
1103 static void print_cable_info(struct snd_info_entry *entry,
1104 struct snd_info_buffer *buffer)
1106 struct loopback *loopback = entry->private_data;
1109 mutex_lock(&loopback->cable_lock);
1110 num = entry->name[strlen(entry->name)-1];
1111 num = num == '0' ? 0 : 1;
1112 for (sub = 0; sub < MAX_PCM_SUBSTREAMS; sub++)
1113 print_substream_info(buffer, loopback, sub, num);
1114 mutex_unlock(&loopback->cable_lock);
1117 static int loopback_proc_new(struct loopback *loopback, int cidx)
1120 struct snd_info_entry *entry;
1123 snprintf(name, sizeof(name), "cable#%d", cidx);
1124 err = snd_card_proc_new(loopback->card, name, &entry);
1128 snd_info_set_text_ops(entry, loopback, print_cable_info);
1132 #else /* !CONFIG_PROC_FS */
1134 #define loopback_proc_new(loopback, cidx) do { } while (0)
1138 static int loopback_probe(struct platform_device *devptr)
1140 struct snd_card *card;
1141 struct loopback *loopback;
1142 int dev = devptr->id;
1145 err = snd_card_create(index[dev], id[dev], THIS_MODULE,
1146 sizeof(struct loopback), &card);
1149 loopback = card->private_data;
1151 if (pcm_substreams[dev] < 1)
1152 pcm_substreams[dev] = 1;
1153 if (pcm_substreams[dev] > MAX_PCM_SUBSTREAMS)
1154 pcm_substreams[dev] = MAX_PCM_SUBSTREAMS;
1156 loopback->card = card;
1157 mutex_init(&loopback->cable_lock);
1159 err = loopback_pcm_new(loopback, 0, pcm_substreams[dev]);
1162 err = loopback_pcm_new(loopback, 1, pcm_substreams[dev]);
1165 err = loopback_mixer_new(loopback, pcm_notify[dev] ? 1 : 0);
1168 loopback_proc_new(loopback, 0);
1169 loopback_proc_new(loopback, 1);
1170 strcpy(card->driver, "Loopback");
1171 strcpy(card->shortname, "Loopback");
1172 sprintf(card->longname, "Loopback %i", dev + 1);
1173 err = snd_card_register(card);
1175 platform_set_drvdata(devptr, card);
1179 snd_card_free(card);
1183 static int loopback_remove(struct platform_device *devptr)
1185 snd_card_free(platform_get_drvdata(devptr));
1189 #ifdef CONFIG_PM_SLEEP
1190 static int loopback_suspend(struct device *pdev)
1192 struct snd_card *card = dev_get_drvdata(pdev);
1193 struct loopback *loopback = card->private_data;
1195 snd_power_change_state(card, SNDRV_CTL_POWER_D3hot);
1197 snd_pcm_suspend_all(loopback->pcm[0]);
1198 snd_pcm_suspend_all(loopback->pcm[1]);
1202 static int loopback_resume(struct device *pdev)
1204 struct snd_card *card = dev_get_drvdata(pdev);
1206 snd_power_change_state(card, SNDRV_CTL_POWER_D0);
1210 static SIMPLE_DEV_PM_OPS(loopback_pm, loopback_suspend, loopback_resume);
1211 #define LOOPBACK_PM_OPS &loopback_pm
1213 #define LOOPBACK_PM_OPS NULL
1216 #define SND_LOOPBACK_DRIVER "snd_aloop"
1218 static struct platform_driver loopback_driver = {
1219 .probe = loopback_probe,
1220 .remove = loopback_remove,
1222 .name = SND_LOOPBACK_DRIVER,
1223 .owner = THIS_MODULE,
1224 .pm = LOOPBACK_PM_OPS,
1228 static void loopback_unregister_all(void)
1232 for (i = 0; i < ARRAY_SIZE(devices); ++i)
1233 platform_device_unregister(devices[i]);
1234 platform_driver_unregister(&loopback_driver);
1237 static int __init alsa_card_loopback_init(void)
1241 err = platform_driver_register(&loopback_driver);
1247 for (i = 0; i < SNDRV_CARDS; i++) {
1248 struct platform_device *device;
1251 device = platform_device_register_simple(SND_LOOPBACK_DRIVER,
1255 if (!platform_get_drvdata(device)) {
1256 platform_device_unregister(device);
1259 devices[i] = device;
1264 printk(KERN_ERR "aloop: No loopback enabled\n");
1266 loopback_unregister_all();
1272 static void __exit alsa_card_loopback_exit(void)
1274 loopback_unregister_all();
1277 module_init(alsa_card_loopback_init)
1278 module_exit(alsa_card_loopback_exit)