2 * Digital Audio (PCM) abstract layer
3 * Copyright (c) by Jaroslav Kysela <perex@suse.cz>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 #include <sound/driver.h>
23 #include <linux/init.h>
24 #include <linux/slab.h>
25 #include <linux/time.h>
26 #include <sound/core.h>
27 #include <sound/minors.h>
28 #include <sound/pcm.h>
29 #include <sound/control.h>
30 #include <sound/info.h>
32 MODULE_AUTHOR("Jaroslav Kysela <perex@suse.cz>, Abramo Bagnara <abramo@alsa-project.org>");
33 MODULE_DESCRIPTION("Midlevel PCM code for ALSA.");
34 MODULE_LICENSE("GPL");
36 static LIST_HEAD(snd_pcm_devices);
37 static LIST_HEAD(snd_pcm_notify_list);
38 static DECLARE_MUTEX(register_mutex);
40 static int snd_pcm_free(struct snd_pcm *pcm);
41 static int snd_pcm_dev_free(struct snd_device *device);
42 static int snd_pcm_dev_register(struct snd_device *device);
43 static int snd_pcm_dev_disconnect(struct snd_device *device);
44 static int snd_pcm_dev_unregister(struct snd_device *device);
46 static struct snd_pcm *snd_pcm_search(struct snd_card *card, int device)
51 list_for_each(p, &snd_pcm_devices) {
52 pcm = list_entry(p, struct snd_pcm, list);
53 if (pcm->card == card && pcm->device == device)
59 static int snd_pcm_control_ioctl(struct snd_card *card,
60 struct snd_ctl_file *control,
61 unsigned int cmd, unsigned long arg)
64 case SNDRV_CTL_IOCTL_PCM_NEXT_DEVICE:
68 if (get_user(device, (int __user *)arg))
70 down(®ister_mutex);
71 device = device < 0 ? 0 : device + 1;
72 while (device < SNDRV_PCM_DEVICES) {
73 if (snd_pcm_search(card, device))
77 if (device == SNDRV_PCM_DEVICES)
80 if (put_user(device, (int __user *)arg))
84 case SNDRV_CTL_IOCTL_PCM_INFO:
86 struct snd_pcm_info __user *info;
87 unsigned int device, subdevice;
90 struct snd_pcm_str *pstr;
91 struct snd_pcm_substream *substream;
94 info = (struct snd_pcm_info __user *)arg;
95 if (get_user(device, &info->device))
97 if (get_user(stream, &info->stream))
99 if (stream < 0 || stream > 1)
101 if (get_user(subdevice, &info->subdevice))
103 down(®ister_mutex);
104 pcm = snd_pcm_search(card, device);
109 pstr = &pcm->streams[stream];
110 if (pstr->substream_count == 0) {
114 if (subdevice >= pstr->substream_count) {
118 for (substream = pstr->substream; substream;
119 substream = substream->next)
120 if (substream->number == (int)subdevice)
122 if (substream == NULL) {
126 err = snd_pcm_info_user(substream, info);
131 case SNDRV_CTL_IOCTL_PCM_PREFER_SUBDEVICE:
135 if (get_user(val, (int __user *)arg))
137 control->prefer_pcm_subdevice = val;
144 #if defined(CONFIG_PROC_FS) && defined(CONFIG_SND_VERBOSE_PROCFS)
146 #define STATE(v) [SNDRV_PCM_STATE_##v] = #v
147 #define STREAM(v) [SNDRV_PCM_STREAM_##v] = #v
148 #define READY(v) [SNDRV_PCM_READY_##v] = #v
149 #define XRUN(v) [SNDRV_PCM_XRUN_##v] = #v
150 #define SILENCE(v) [SNDRV_PCM_SILENCE_##v] = #v
151 #define TSTAMP(v) [SNDRV_PCM_TSTAMP_##v] = #v
152 #define ACCESS(v) [SNDRV_PCM_ACCESS_##v] = #v
153 #define START(v) [SNDRV_PCM_START_##v] = #v
154 #define FORMAT(v) [SNDRV_PCM_FORMAT_##v] = #v
155 #define SUBFORMAT(v) [SNDRV_PCM_SUBFORMAT_##v] = #v
157 static char *snd_pcm_format_names[] = {
176 FORMAT(IEC958_SUBFRAME_LE),
177 FORMAT(IEC958_SUBFRAME_BE),
198 const char *snd_pcm_format_name(snd_pcm_format_t format)
200 return snd_pcm_format_names[format];
203 static char *snd_pcm_stream_names[] = {
208 static char *snd_pcm_state_names[] = {
219 static char *snd_pcm_access_names[] = {
220 ACCESS(MMAP_INTERLEAVED),
221 ACCESS(MMAP_NONINTERLEAVED),
222 ACCESS(MMAP_COMPLEX),
223 ACCESS(RW_INTERLEAVED),
224 ACCESS(RW_NONINTERLEAVED),
227 static char *snd_pcm_subformat_names[] = {
231 static char *snd_pcm_tstamp_mode_names[] = {
236 static const char *snd_pcm_stream_name(int stream)
238 snd_assert(stream <= SNDRV_PCM_STREAM_LAST, return NULL);
239 return snd_pcm_stream_names[stream];
242 static const char *snd_pcm_access_name(snd_pcm_access_t access)
244 return snd_pcm_access_names[access];
247 static const char *snd_pcm_subformat_name(snd_pcm_subformat_t subformat)
249 return snd_pcm_subformat_names[subformat];
252 static const char *snd_pcm_tstamp_mode_name(int mode)
254 snd_assert(mode <= SNDRV_PCM_TSTAMP_LAST, return NULL);
255 return snd_pcm_tstamp_mode_names[mode];
258 static const char *snd_pcm_state_name(snd_pcm_state_t state)
260 return snd_pcm_state_names[state];
263 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
264 #include <linux/soundcard.h>
265 static const char *snd_pcm_oss_format_name(int format)
294 static void snd_pcm_proc_info_read(struct snd_pcm_substream *substream,
295 struct snd_info_buffer *buffer)
297 struct snd_pcm_info *info;
303 info = kmalloc(sizeof(*info), GFP_KERNEL);
305 printk(KERN_DEBUG "snd_pcm_proc_info_read: cannot malloc\n");
309 err = snd_pcm_info(substream, info);
311 snd_iprintf(buffer, "error %d\n", err);
315 snd_iprintf(buffer, "card: %d\n", info->card);
316 snd_iprintf(buffer, "device: %d\n", info->device);
317 snd_iprintf(buffer, "subdevice: %d\n", info->subdevice);
318 snd_iprintf(buffer, "stream: %s\n", snd_pcm_stream_name(info->stream));
319 snd_iprintf(buffer, "id: %s\n", info->id);
320 snd_iprintf(buffer, "name: %s\n", info->name);
321 snd_iprintf(buffer, "subname: %s\n", info->subname);
322 snd_iprintf(buffer, "class: %d\n", info->dev_class);
323 snd_iprintf(buffer, "subclass: %d\n", info->dev_subclass);
324 snd_iprintf(buffer, "subdevices_count: %d\n", info->subdevices_count);
325 snd_iprintf(buffer, "subdevices_avail: %d\n", info->subdevices_avail);
329 static void snd_pcm_stream_proc_info_read(struct snd_info_entry *entry,
330 struct snd_info_buffer *buffer)
332 snd_pcm_proc_info_read(((struct snd_pcm_str *)entry->private_data)->substream,
336 static void snd_pcm_substream_proc_info_read(struct snd_info_entry *entry,
337 struct snd_info_buffer *buffer)
339 snd_pcm_proc_info_read((struct snd_pcm_substream *)entry->private_data,
343 static void snd_pcm_substream_proc_hw_params_read(struct snd_info_entry *entry,
344 struct snd_info_buffer *buffer)
346 struct snd_pcm_substream *substream = entry->private_data;
347 struct snd_pcm_runtime *runtime = substream->runtime;
349 snd_iprintf(buffer, "closed\n");
352 snd_pcm_stream_lock_irq(substream);
353 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) {
354 snd_iprintf(buffer, "no setup\n");
355 snd_pcm_stream_unlock_irq(substream);
358 snd_iprintf(buffer, "access: %s\n", snd_pcm_access_name(runtime->access));
359 snd_iprintf(buffer, "format: %s\n", snd_pcm_format_name(runtime->format));
360 snd_iprintf(buffer, "subformat: %s\n", snd_pcm_subformat_name(runtime->subformat));
361 snd_iprintf(buffer, "channels: %u\n", runtime->channels);
362 snd_iprintf(buffer, "rate: %u (%u/%u)\n", runtime->rate, runtime->rate_num, runtime->rate_den);
363 snd_iprintf(buffer, "period_size: %lu\n", runtime->period_size);
364 snd_iprintf(buffer, "buffer_size: %lu\n", runtime->buffer_size);
365 snd_iprintf(buffer, "tick_time: %u\n", runtime->tick_time);
366 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
367 if (substream->oss.oss) {
368 snd_iprintf(buffer, "OSS format: %s\n", snd_pcm_oss_format_name(runtime->oss.format));
369 snd_iprintf(buffer, "OSS channels: %u\n", runtime->oss.channels);
370 snd_iprintf(buffer, "OSS rate: %u\n", runtime->oss.rate);
371 snd_iprintf(buffer, "OSS period bytes: %lu\n", (unsigned long)runtime->oss.period_bytes);
372 snd_iprintf(buffer, "OSS periods: %u\n", runtime->oss.periods);
373 snd_iprintf(buffer, "OSS period frames: %lu\n", (unsigned long)runtime->oss.period_frames);
376 snd_pcm_stream_unlock_irq(substream);
379 static void snd_pcm_substream_proc_sw_params_read(struct snd_info_entry *entry,
380 struct snd_info_buffer *buffer)
382 struct snd_pcm_substream *substream = entry->private_data;
383 struct snd_pcm_runtime *runtime = substream->runtime;
385 snd_iprintf(buffer, "closed\n");
388 snd_pcm_stream_lock_irq(substream);
389 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) {
390 snd_iprintf(buffer, "no setup\n");
391 snd_pcm_stream_unlock_irq(substream);
394 snd_iprintf(buffer, "tstamp_mode: %s\n", snd_pcm_tstamp_mode_name(runtime->tstamp_mode));
395 snd_iprintf(buffer, "period_step: %u\n", runtime->period_step);
396 snd_iprintf(buffer, "sleep_min: %u\n", runtime->sleep_min);
397 snd_iprintf(buffer, "avail_min: %lu\n", runtime->control->avail_min);
398 snd_iprintf(buffer, "xfer_align: %lu\n", runtime->xfer_align);
399 snd_iprintf(buffer, "start_threshold: %lu\n", runtime->start_threshold);
400 snd_iprintf(buffer, "stop_threshold: %lu\n", runtime->stop_threshold);
401 snd_iprintf(buffer, "silence_threshold: %lu\n", runtime->silence_threshold);
402 snd_iprintf(buffer, "silence_size: %lu\n", runtime->silence_size);
403 snd_iprintf(buffer, "boundary: %lu\n", runtime->boundary);
404 snd_pcm_stream_unlock_irq(substream);
407 static void snd_pcm_substream_proc_status_read(struct snd_info_entry *entry,
408 struct snd_info_buffer *buffer)
410 struct snd_pcm_substream *substream = entry->private_data;
411 struct snd_pcm_runtime *runtime = substream->runtime;
412 struct snd_pcm_status status;
415 snd_iprintf(buffer, "closed\n");
418 memset(&status, 0, sizeof(status));
419 err = snd_pcm_status(substream, &status);
421 snd_iprintf(buffer, "error %d\n", err);
424 snd_iprintf(buffer, "state: %s\n", snd_pcm_state_name(status.state));
425 snd_iprintf(buffer, "trigger_time: %ld.%09ld\n",
426 status.trigger_tstamp.tv_sec, status.trigger_tstamp.tv_nsec);
427 snd_iprintf(buffer, "tstamp : %ld.%09ld\n",
428 status.tstamp.tv_sec, status.tstamp.tv_nsec);
429 snd_iprintf(buffer, "delay : %ld\n", status.delay);
430 snd_iprintf(buffer, "avail : %ld\n", status.avail);
431 snd_iprintf(buffer, "avail_max : %ld\n", status.avail_max);
432 snd_iprintf(buffer, "-----\n");
433 snd_iprintf(buffer, "hw_ptr : %ld\n", runtime->status->hw_ptr);
434 snd_iprintf(buffer, "appl_ptr : %ld\n", runtime->control->appl_ptr);
437 #ifdef CONFIG_SND_DEBUG
438 static void snd_pcm_xrun_debug_read(struct snd_info_entry *entry,
439 struct snd_info_buffer *buffer)
441 struct snd_pcm_str *pstr = entry->private_data;
442 snd_iprintf(buffer, "%d\n", pstr->xrun_debug);
445 static void snd_pcm_xrun_debug_write(struct snd_info_entry *entry,
446 struct snd_info_buffer *buffer)
448 struct snd_pcm_str *pstr = entry->private_data;
450 if (!snd_info_get_line(buffer, line, sizeof(line)))
451 pstr->xrun_debug = simple_strtoul(line, NULL, 10);
455 static int snd_pcm_stream_proc_init(struct snd_pcm_str *pstr)
457 struct snd_pcm *pcm = pstr->pcm;
458 struct snd_info_entry *entry;
461 sprintf(name, "pcm%i%c", pcm->device,
462 pstr->stream == SNDRV_PCM_STREAM_PLAYBACK ? 'p' : 'c');
463 if ((entry = snd_info_create_card_entry(pcm->card, name, pcm->card->proc_root)) == NULL)
465 entry->mode = S_IFDIR | S_IRUGO | S_IXUGO;
466 if (snd_info_register(entry) < 0) {
467 snd_info_free_entry(entry);
470 pstr->proc_root = entry;
472 if ((entry = snd_info_create_card_entry(pcm->card, "info", pstr->proc_root)) != NULL) {
473 snd_info_set_text_ops(entry, pstr, 256, snd_pcm_stream_proc_info_read);
474 if (snd_info_register(entry) < 0) {
475 snd_info_free_entry(entry);
479 pstr->proc_info_entry = entry;
481 #ifdef CONFIG_SND_DEBUG
482 if ((entry = snd_info_create_card_entry(pcm->card, "xrun_debug",
483 pstr->proc_root)) != NULL) {
484 entry->c.text.read_size = 64;
485 entry->c.text.read = snd_pcm_xrun_debug_read;
486 entry->c.text.write_size = 64;
487 entry->c.text.write = snd_pcm_xrun_debug_write;
488 entry->mode |= S_IWUSR;
489 entry->private_data = pstr;
490 if (snd_info_register(entry) < 0) {
491 snd_info_free_entry(entry);
495 pstr->proc_xrun_debug_entry = entry;
500 static int snd_pcm_stream_proc_done(struct snd_pcm_str *pstr)
502 #ifdef CONFIG_SND_DEBUG
503 if (pstr->proc_xrun_debug_entry) {
504 snd_info_unregister(pstr->proc_xrun_debug_entry);
505 pstr->proc_xrun_debug_entry = NULL;
508 if (pstr->proc_info_entry) {
509 snd_info_unregister(pstr->proc_info_entry);
510 pstr->proc_info_entry = NULL;
512 if (pstr->proc_root) {
513 snd_info_unregister(pstr->proc_root);
514 pstr->proc_root = NULL;
519 static int snd_pcm_substream_proc_init(struct snd_pcm_substream *substream)
521 struct snd_info_entry *entry;
522 struct snd_card *card;
525 card = substream->pcm->card;
527 sprintf(name, "sub%i", substream->number);
528 if ((entry = snd_info_create_card_entry(card, name, substream->pstr->proc_root)) == NULL)
530 entry->mode = S_IFDIR | S_IRUGO | S_IXUGO;
531 if (snd_info_register(entry) < 0) {
532 snd_info_free_entry(entry);
535 substream->proc_root = entry;
537 if ((entry = snd_info_create_card_entry(card, "info", substream->proc_root)) != NULL) {
538 snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_info_read);
539 if (snd_info_register(entry) < 0) {
540 snd_info_free_entry(entry);
544 substream->proc_info_entry = entry;
546 if ((entry = snd_info_create_card_entry(card, "hw_params", substream->proc_root)) != NULL) {
547 snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_hw_params_read);
548 if (snd_info_register(entry) < 0) {
549 snd_info_free_entry(entry);
553 substream->proc_hw_params_entry = entry;
555 if ((entry = snd_info_create_card_entry(card, "sw_params", substream->proc_root)) != NULL) {
556 snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_sw_params_read);
557 if (snd_info_register(entry) < 0) {
558 snd_info_free_entry(entry);
562 substream->proc_sw_params_entry = entry;
564 if ((entry = snd_info_create_card_entry(card, "status", substream->proc_root)) != NULL) {
565 snd_info_set_text_ops(entry, substream, 256, snd_pcm_substream_proc_status_read);
566 if (snd_info_register(entry) < 0) {
567 snd_info_free_entry(entry);
571 substream->proc_status_entry = entry;
576 static int snd_pcm_substream_proc_done(struct snd_pcm_substream *substream)
578 if (substream->proc_info_entry) {
579 snd_info_unregister(substream->proc_info_entry);
580 substream->proc_info_entry = NULL;
582 if (substream->proc_hw_params_entry) {
583 snd_info_unregister(substream->proc_hw_params_entry);
584 substream->proc_hw_params_entry = NULL;
586 if (substream->proc_sw_params_entry) {
587 snd_info_unregister(substream->proc_sw_params_entry);
588 substream->proc_sw_params_entry = NULL;
590 if (substream->proc_status_entry) {
591 snd_info_unregister(substream->proc_status_entry);
592 substream->proc_status_entry = NULL;
594 if (substream->proc_root) {
595 snd_info_unregister(substream->proc_root);
596 substream->proc_root = NULL;
600 #else /* !CONFIG_PROC_FS */
601 static inline int snd_pcm_stream_proc_init(struct snd_pcm_str *pstr) { return 0; }
602 static inline int snd_pcm_stream_proc_done(struct snd_pcm_str *pstr) { return 0; }
603 static inline int snd_pcm_substream_proc_init(struct snd_pcm_substream *substream) { return 0; }
604 static inline int snd_pcm_substream_proc_done(struct snd_pcm_substream *substream) { return 0; }
605 #endif /* CONFIG_PROC_FS */
608 * snd_pcm_new_stream - create a new PCM stream
609 * @pcm: the pcm instance
610 * @stream: the stream direction, SNDRV_PCM_STREAM_XXX
611 * @substream_count: the number of substreams
613 * Creates a new stream for the pcm.
614 * The corresponding stream on the pcm must have been empty before
615 * calling this, i.e. zero must be given to the argument of
618 * Returns zero if successful, or a negative error code on failure.
620 int snd_pcm_new_stream(struct snd_pcm *pcm, int stream, int substream_count)
623 struct snd_pcm_str *pstr = &pcm->streams[stream];
624 struct snd_pcm_substream *substream, *prev;
626 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
627 init_MUTEX(&pstr->oss.setup_mutex);
629 pstr->stream = stream;
631 pstr->substream_count = substream_count;
632 if (substream_count > 0) {
633 err = snd_pcm_stream_proc_init(pstr);
635 snd_printk(KERN_ERR "Error in snd_pcm_stream_proc_init\n");
640 for (idx = 0, prev = NULL; idx < substream_count; idx++) {
641 substream = kzalloc(sizeof(*substream), GFP_KERNEL);
642 if (substream == NULL) {
643 snd_printk(KERN_ERR "Cannot allocate PCM substream\n");
646 substream->pcm = pcm;
647 substream->pstr = pstr;
648 substream->number = idx;
649 substream->stream = stream;
650 sprintf(substream->name, "subdevice #%i", idx);
651 substream->buffer_bytes_max = UINT_MAX;
653 pstr->substream = substream;
655 prev->next = substream;
656 err = snd_pcm_substream_proc_init(substream);
658 snd_printk(KERN_ERR "Error in snd_pcm_stream_proc_init\n");
662 substream->group = &substream->self_group;
663 spin_lock_init(&substream->self_group.lock);
664 INIT_LIST_HEAD(&substream->self_group.substreams);
665 list_add_tail(&substream->link_list, &substream->self_group.substreams);
666 spin_lock_init(&substream->timer_lock);
673 * snd_pcm_new - create a new PCM instance
674 * @card: the card instance
676 * @device: the device index (zero based)
677 * @playback_count: the number of substreams for playback
678 * @capture_count: the number of substreams for capture
679 * @rpcm: the pointer to store the new pcm instance
681 * Creates a new PCM instance.
683 * The pcm operators have to be set afterwards to the new instance
684 * via snd_pcm_set_ops().
686 * Returns zero if successful, or a negative error code on failure.
688 int snd_pcm_new(struct snd_card *card, char *id, int device,
689 int playback_count, int capture_count,
690 struct snd_pcm ** rpcm)
694 static struct snd_device_ops ops = {
695 .dev_free = snd_pcm_dev_free,
696 .dev_register = snd_pcm_dev_register,
697 .dev_disconnect = snd_pcm_dev_disconnect,
698 .dev_unregister = snd_pcm_dev_unregister
701 snd_assert(rpcm != NULL, return -EINVAL);
703 snd_assert(card != NULL, return -ENXIO);
704 pcm = kzalloc(sizeof(*pcm), GFP_KERNEL);
706 snd_printk(KERN_ERR "Cannot allocate PCM\n");
710 pcm->device = device;
712 strlcpy(pcm->id, id, sizeof(pcm->id));
713 if ((err = snd_pcm_new_stream(pcm, SNDRV_PCM_STREAM_PLAYBACK, playback_count)) < 0) {
717 if ((err = snd_pcm_new_stream(pcm, SNDRV_PCM_STREAM_CAPTURE, capture_count)) < 0) {
721 init_MUTEX(&pcm->open_mutex);
722 init_waitqueue_head(&pcm->open_wait);
723 if ((err = snd_device_new(card, SNDRV_DEV_PCM, pcm, &ops)) < 0) {
731 static void snd_pcm_free_stream(struct snd_pcm_str * pstr)
733 struct snd_pcm_substream *substream, *substream_next;
734 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
735 struct snd_pcm_oss_setup *setup, *setupn;
737 substream = pstr->substream;
739 substream_next = substream->next;
740 snd_pcm_substream_proc_done(substream);
742 substream = substream_next;
744 snd_pcm_stream_proc_done(pstr);
745 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
746 for (setup = pstr->oss.setup_list; setup; setup = setupn) {
747 setupn = setup->next;
748 kfree(setup->task_name);
754 static int snd_pcm_free(struct snd_pcm *pcm)
756 snd_assert(pcm != NULL, return -ENXIO);
757 if (pcm->private_free)
758 pcm->private_free(pcm);
759 snd_pcm_lib_preallocate_free_for_all(pcm);
760 snd_pcm_free_stream(&pcm->streams[SNDRV_PCM_STREAM_PLAYBACK]);
761 snd_pcm_free_stream(&pcm->streams[SNDRV_PCM_STREAM_CAPTURE]);
766 static int snd_pcm_dev_free(struct snd_device *device)
768 struct snd_pcm *pcm = device->device_data;
769 return snd_pcm_free(pcm);
772 static void snd_pcm_tick_timer_func(unsigned long data)
774 struct snd_pcm_substream *substream = (struct snd_pcm_substream *) data;
775 snd_pcm_tick_elapsed(substream);
778 int snd_pcm_open_substream(struct snd_pcm *pcm, int stream,
779 struct snd_pcm_substream **rsubstream)
781 struct snd_pcm_str * pstr;
782 struct snd_pcm_substream *substream;
783 struct snd_pcm_runtime *runtime;
784 struct snd_ctl_file *kctl;
785 struct snd_card *card;
786 struct list_head *list;
787 int prefer_subdevice = -1;
790 snd_assert(rsubstream != NULL, return -EINVAL);
792 snd_assert(pcm != NULL, return -ENXIO);
793 pstr = &pcm->streams[stream];
794 if (pstr->substream == NULL)
798 down_read(&card->controls_rwsem);
799 list_for_each(list, &card->ctl_files) {
800 kctl = snd_ctl_file(list);
801 if (kctl->pid == current->pid) {
802 prefer_subdevice = kctl->prefer_pcm_subdevice;
806 up_read(&card->controls_rwsem);
808 if (pstr->substream_count == 0)
811 case SNDRV_PCM_STREAM_PLAYBACK:
812 if (pcm->info_flags & SNDRV_PCM_INFO_HALF_DUPLEX) {
813 for (substream = pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream; substream; substream = substream->next) {
814 if (SUBSTREAM_BUSY(substream))
819 case SNDRV_PCM_STREAM_CAPTURE:
820 if (pcm->info_flags & SNDRV_PCM_INFO_HALF_DUPLEX) {
821 for (substream = pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream; substream; substream = substream->next) {
822 if (SUBSTREAM_BUSY(substream))
831 if (prefer_subdevice >= 0) {
832 for (substream = pstr->substream; substream; substream = substream->next)
833 if (!SUBSTREAM_BUSY(substream) && substream->number == prefer_subdevice)
836 for (substream = pstr->substream; substream; substream = substream->next)
837 if (!SUBSTREAM_BUSY(substream))
840 if (substream == NULL)
843 runtime = kzalloc(sizeof(*runtime), GFP_KERNEL);
847 size = PAGE_ALIGN(sizeof(struct snd_pcm_mmap_status));
848 runtime->status = snd_malloc_pages(size, GFP_KERNEL);
849 if (runtime->status == NULL) {
853 memset((void*)runtime->status, 0, size);
855 size = PAGE_ALIGN(sizeof(struct snd_pcm_mmap_control));
856 runtime->control = snd_malloc_pages(size, GFP_KERNEL);
857 if (runtime->control == NULL) {
858 snd_free_pages((void*)runtime->status,
859 PAGE_ALIGN(sizeof(struct snd_pcm_mmap_status)));
863 memset((void*)runtime->control, 0, size);
865 init_waitqueue_head(&runtime->sleep);
866 atomic_set(&runtime->mmap_count, 0);
867 init_timer(&runtime->tick_timer);
868 runtime->tick_timer.function = snd_pcm_tick_timer_func;
869 runtime->tick_timer.data = (unsigned long) substream;
871 runtime->status->state = SNDRV_PCM_STATE_OPEN;
873 substream->runtime = runtime;
874 substream->private_data = pcm->private_data;
875 pstr->substream_opened++;
876 *rsubstream = substream;
880 void snd_pcm_release_substream(struct snd_pcm_substream *substream)
882 struct snd_pcm_runtime *runtime;
883 substream->file = NULL;
884 runtime = substream->runtime;
885 snd_assert(runtime != NULL, return);
886 if (runtime->private_free != NULL)
887 runtime->private_free(runtime);
888 snd_free_pages((void*)runtime->status,
889 PAGE_ALIGN(sizeof(struct snd_pcm_mmap_status)));
890 snd_free_pages((void*)runtime->control,
891 PAGE_ALIGN(sizeof(struct snd_pcm_mmap_control)));
892 kfree(runtime->hw_constraints.rules);
894 substream->runtime = NULL;
895 substream->pstr->substream_opened--;
898 static int snd_pcm_dev_register(struct snd_device *device)
901 struct snd_pcm_substream *substream;
902 struct list_head *list;
904 struct snd_pcm *pcm = device->device_data;
906 snd_assert(pcm != NULL && device != NULL, return -ENXIO);
907 down(®ister_mutex);
908 if (snd_pcm_search(pcm->card, pcm->device)) {
912 list_add_tail(&pcm->list, &snd_pcm_devices);
913 for (cidx = 0; cidx < 2; cidx++) {
915 if (pcm->streams[cidx].substream == NULL)
918 case SNDRV_PCM_STREAM_PLAYBACK:
919 sprintf(str, "pcmC%iD%ip", pcm->card->number, pcm->device);
920 devtype = SNDRV_DEVICE_TYPE_PCM_PLAYBACK;
922 case SNDRV_PCM_STREAM_CAPTURE:
923 sprintf(str, "pcmC%iD%ic", pcm->card->number, pcm->device);
924 devtype = SNDRV_DEVICE_TYPE_PCM_CAPTURE;
927 if ((err = snd_register_device(devtype, pcm->card,
929 &snd_pcm_f_ops[cidx],
932 list_del(&pcm->list);
936 for (substream = pcm->streams[cidx].substream; substream; substream = substream->next)
937 snd_pcm_timer_init(substream);
939 list_for_each(list, &snd_pcm_notify_list) {
940 struct snd_pcm_notify *notify;
941 notify = list_entry(list, struct snd_pcm_notify, list);
942 notify->n_register(pcm);
948 static int snd_pcm_dev_disconnect(struct snd_device *device)
950 struct snd_pcm *pcm = device->device_data;
951 struct list_head *list;
952 struct snd_pcm_substream *substream;
955 down(®ister_mutex);
956 list_del_init(&pcm->list);
957 for (cidx = 0; cidx < 2; cidx++)
958 for (substream = pcm->streams[cidx].substream; substream; substream = substream->next)
959 if (substream->runtime)
960 substream->runtime->status->state = SNDRV_PCM_STATE_DISCONNECTED;
961 list_for_each(list, &snd_pcm_notify_list) {
962 struct snd_pcm_notify *notify;
963 notify = list_entry(list, struct snd_pcm_notify, list);
964 notify->n_disconnect(pcm);
970 static int snd_pcm_dev_unregister(struct snd_device *device)
973 struct snd_pcm_substream *substream;
974 struct list_head *list;
975 struct snd_pcm *pcm = device->device_data;
977 snd_assert(pcm != NULL, return -ENXIO);
978 down(®ister_mutex);
979 list_del(&pcm->list);
980 for (cidx = 0; cidx < 2; cidx++) {
983 case SNDRV_PCM_STREAM_PLAYBACK:
984 devtype = SNDRV_DEVICE_TYPE_PCM_PLAYBACK;
986 case SNDRV_PCM_STREAM_CAPTURE:
987 devtype = SNDRV_DEVICE_TYPE_PCM_CAPTURE;
990 snd_unregister_device(devtype, pcm->card, pcm->device);
991 for (substream = pcm->streams[cidx].substream; substream; substream = substream->next)
992 snd_pcm_timer_done(substream);
994 list_for_each(list, &snd_pcm_notify_list) {
995 struct snd_pcm_notify *notify;
996 notify = list_entry(list, struct snd_pcm_notify, list);
997 notify->n_unregister(pcm);
1000 return snd_pcm_free(pcm);
1003 int snd_pcm_notify(struct snd_pcm_notify *notify, int nfree)
1005 struct list_head *p;
1007 snd_assert(notify != NULL && notify->n_register != NULL && notify->n_unregister != NULL, return -EINVAL);
1008 down(®ister_mutex);
1010 list_del(¬ify->list);
1011 list_for_each(p, &snd_pcm_devices)
1012 notify->n_unregister(list_entry(p,
1013 struct snd_pcm, list));
1015 list_add_tail(¬ify->list, &snd_pcm_notify_list);
1016 list_for_each(p, &snd_pcm_devices)
1017 notify->n_register(list_entry(p, struct snd_pcm, list));
1019 up(®ister_mutex);
1023 #ifdef CONFIG_PROC_FS
1028 static void snd_pcm_proc_read(struct snd_info_entry *entry,
1029 struct snd_info_buffer *buffer)
1031 struct list_head *p;
1032 struct snd_pcm *pcm;
1034 down(®ister_mutex);
1035 list_for_each(p, &snd_pcm_devices) {
1036 pcm = list_entry(p, struct snd_pcm, list);
1037 snd_iprintf(buffer, "%02i-%02i: %s : %s",
1038 pcm->card->number, pcm->device, pcm->id, pcm->name);
1039 if (pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream)
1040 snd_iprintf(buffer, " : playback %i",
1041 pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream_count);
1042 if (pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream)
1043 snd_iprintf(buffer, " : capture %i",
1044 pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream_count);
1045 snd_iprintf(buffer, "\n");
1047 up(®ister_mutex);
1050 static struct snd_info_entry *snd_pcm_proc_entry = NULL;
1052 static void snd_pcm_proc_init(void)
1054 struct snd_info_entry *entry;
1056 if ((entry = snd_info_create_module_entry(THIS_MODULE, "pcm", NULL)) != NULL) {
1057 snd_info_set_text_ops(entry, NULL, SNDRV_CARDS * SNDRV_PCM_DEVICES * 128,
1059 if (snd_info_register(entry) < 0) {
1060 snd_info_free_entry(entry);
1064 snd_pcm_proc_entry = entry;
1067 static void snd_pcm_proc_done(void)
1069 if (snd_pcm_proc_entry)
1070 snd_info_unregister(snd_pcm_proc_entry);
1073 #else /* !CONFIG_PROC_FS */
1074 #define snd_pcm_proc_init()
1075 #define snd_pcm_proc_done()
1076 #endif /* CONFIG_PROC_FS */
1083 static int __init alsa_pcm_init(void)
1085 snd_ctl_register_ioctl(snd_pcm_control_ioctl);
1086 snd_ctl_register_ioctl_compat(snd_pcm_control_ioctl);
1087 snd_pcm_proc_init();
1091 static void __exit alsa_pcm_exit(void)
1093 snd_ctl_unregister_ioctl(snd_pcm_control_ioctl);
1094 snd_ctl_unregister_ioctl_compat(snd_pcm_control_ioctl);
1095 snd_pcm_proc_done();
1098 module_init(alsa_pcm_init)
1099 module_exit(alsa_pcm_exit)
1101 EXPORT_SYMBOL(snd_pcm_new);
1102 EXPORT_SYMBOL(snd_pcm_new_stream);
1103 EXPORT_SYMBOL(snd_pcm_notify);
1104 EXPORT_SYMBOL(snd_pcm_open_substream);
1105 EXPORT_SYMBOL(snd_pcm_release_substream);
1106 EXPORT_SYMBOL(snd_pcm_format_name);
1108 EXPORT_SYMBOL(snd_pcm_link_rwlock);
1110 EXPORT_SYMBOL(snd_pcm_suspend);
1111 EXPORT_SYMBOL(snd_pcm_suspend_all);
1113 EXPORT_SYMBOL(snd_pcm_kernel_playback_ioctl);
1114 EXPORT_SYMBOL(snd_pcm_kernel_capture_ioctl);
1115 EXPORT_SYMBOL(snd_pcm_kernel_ioctl);
1116 EXPORT_SYMBOL(snd_pcm_mmap_data);
1117 #if SNDRV_PCM_INFO_MMAP_IOMEM
1118 EXPORT_SYMBOL(snd_pcm_lib_mmap_iomem);
1121 EXPORT_SYMBOL(snd_pcm_format_signed);
1122 EXPORT_SYMBOL(snd_pcm_format_unsigned);
1123 EXPORT_SYMBOL(snd_pcm_format_linear);
1124 EXPORT_SYMBOL(snd_pcm_format_little_endian);
1125 EXPORT_SYMBOL(snd_pcm_format_big_endian);
1126 EXPORT_SYMBOL(snd_pcm_format_width);
1127 EXPORT_SYMBOL(snd_pcm_format_physical_width);
1128 EXPORT_SYMBOL(snd_pcm_format_size);
1129 EXPORT_SYMBOL(snd_pcm_format_silence_64);
1130 EXPORT_SYMBOL(snd_pcm_format_set_silence);
1131 EXPORT_SYMBOL(snd_pcm_build_linear_format);
1132 EXPORT_SYMBOL(snd_pcm_limit_hw_rates);