3  *  Digital Audio (PCM) abstract layer
16 #include <sound/pcm.h>
24 MODULE_DESCRIPTION("Midlevel PCM code for ALSA.");
33 static int snd_pcm_free(struct snd_pcm *pcm);
40 	struct snd_pcm *pcm;  in snd_pcm_get()  local
42 	list_for_each_entry(pcm, &snd_pcm_devices, list) {  in snd_pcm_get()
43 		if (pcm->card == card && pcm->device == device)  in snd_pcm_get()
44 			return pcm;  in snd_pcm_get()
51 	struct snd_pcm *pcm;  in snd_pcm_next()  local
53 	list_for_each_entry(pcm, &snd_pcm_devices, list) {  in snd_pcm_next()
54 		if (pcm->card == card && pcm->device > device)  in snd_pcm_next()
55 			return pcm->device;  in snd_pcm_next()
56 		else if (pcm->card->number > card->number)  in snd_pcm_next()
64 	struct snd_pcm *pcm;  in snd_pcm_add()  local
69 	list_for_each_entry(pcm, &snd_pcm_devices, list) {  in snd_pcm_add()
70 		if (pcm->card == newpcm->card && pcm->device == newpcm->device)  in snd_pcm_add()
72 		if (pcm->card->number > newpcm->card->number ||  in snd_pcm_add()
73 				(pcm->card == newpcm->card &&  in snd_pcm_add()
74 				pcm->device > newpcm->device)) {  in snd_pcm_add()
75 			list_add(&newpcm->list, pcm->list.prev);  in snd_pcm_add()
106 			struct snd_pcm *pcm;  in snd_pcm_control_ioctl()  local
122 			pcm = snd_pcm_get(card, device);  in snd_pcm_control_ioctl()
123 			if (pcm == NULL) {  in snd_pcm_control_ioctl()
127 			pstr = &pcm->streams[stream];  in snd_pcm_control_ioctl()
144 			mutex_lock(&pcm->open_mutex);  in snd_pcm_control_ioctl()
146 			mutex_unlock(&pcm->open_mutex);  in snd_pcm_control_ioctl()
217  * snd_pcm_format_name - Return a name string for the given PCM format
218  * @format: PCM format
384 	mutex_lock(&substream->pcm->open_mutex);  in snd_pcm_substream_proc_hw_params_read()
412 	mutex_unlock(&substream->pcm->open_mutex);  in snd_pcm_substream_proc_hw_params_read()
421 	mutex_lock(&substream->pcm->open_mutex);  in snd_pcm_substream_proc_sw_params_read()
440 	mutex_unlock(&substream->pcm->open_mutex);  in snd_pcm_substream_proc_sw_params_read()
451 	mutex_lock(&substream->pcm->open_mutex);  in snd_pcm_substream_proc_status_read()
476 	mutex_unlock(&substream->pcm->open_mutex);  in snd_pcm_substream_proc_status_read()
507 	struct snd_pcm *pcm = pstr->pcm;  in snd_pcm_stream_proc_init()  local
511 	sprintf(name, "pcm%i%c", pcm->device,   in snd_pcm_stream_proc_init()
513 	entry = snd_info_create_card_entry(pcm->card, name,  in snd_pcm_stream_proc_init()
514 					   pcm->card->proc_root);  in snd_pcm_stream_proc_init()
519 	entry = snd_info_create_card_entry(pcm->card, "info", pstr->proc_root);  in snd_pcm_stream_proc_init()
523 	entry = snd_info_create_card_entry(pcm->card, "xrun_debug",  in snd_pcm_stream_proc_init()
549 	entry = snd_info_create_card_entry(substream->pcm->card, name,  in create_substream_info_entry()
562 	card = substream->pcm->card;  in snd_pcm_substream_proc_init()
609 	if (!pstr->pcm->no_device_suspend)  in do_pcm_suspend()
610 		snd_pcm_suspend_all(pstr->pcm);  in do_pcm_suspend()
619 /* device type for PCM -- basically only for passing PM callbacks */
621 	.name = "pcm",
626  * snd_pcm_new_stream - create a new PCM stream
627  * @pcm: the pcm instance
631  * Creates a new stream for the pcm.
632  * The corresponding stream on the pcm must have been empty before
638 int snd_pcm_new_stream(struct snd_pcm *pcm, int stream, int substream_count)  in snd_pcm_new_stream()  argument
641 	struct snd_pcm_str *pstr = &pcm->streams[stream];  in snd_pcm_new_stream()
648 	pstr->pcm = pcm;  in snd_pcm_new_stream()
653 	snd_device_initialize(&pstr->dev, pcm->card);  in snd_pcm_new_stream()
656 	dev_set_name(&pstr->dev, "pcmC%iD%i%c", pcm->card->number, pcm->device,  in snd_pcm_new_stream()
659 	if (!pcm->internal) {  in snd_pcm_new_stream()
662 			pcm_err(pcm, "Error in snd_pcm_stream_proc_init\n");  in snd_pcm_new_stream()
671 		substream->pcm = pcm;  in snd_pcm_new_stream()
682 		if (!pcm->internal) {  in snd_pcm_new_stream()
685 				pcm_err(pcm,  in snd_pcm_new_stream()
709 	struct snd_pcm *pcm;  in _snd_pcm_new()  local
724 	pcm = kzalloc(sizeof(*pcm), GFP_KERNEL);  in _snd_pcm_new()
725 	if (!pcm)  in _snd_pcm_new()
727 	pcm->card = card;  in _snd_pcm_new()
728 	pcm->device = device;  in _snd_pcm_new()
729 	pcm->internal = internal;  in _snd_pcm_new()
730 	mutex_init(&pcm->open_mutex);  in _snd_pcm_new()
731 	init_waitqueue_head(&pcm->open_wait);  in _snd_pcm_new()
732 	INIT_LIST_HEAD(&pcm->list);  in _snd_pcm_new()
734 		strscpy(pcm->id, id, sizeof(pcm->id));  in _snd_pcm_new()
736 	err = snd_pcm_new_stream(pcm, SNDRV_PCM_STREAM_PLAYBACK,  in _snd_pcm_new()
741 	err = snd_pcm_new_stream(pcm, SNDRV_PCM_STREAM_CAPTURE, capture_count);  in _snd_pcm_new()
745 	err = snd_device_new(card, SNDRV_DEV_PCM, pcm,  in _snd_pcm_new()
751 		*rpcm = pcm;  in _snd_pcm_new()
755 	snd_pcm_free(pcm);  in _snd_pcm_new()
760  * snd_pcm_new - create a new PCM instance
766  * @rpcm: the pointer to store the new pcm instance
768  * Creates a new PCM instance.
770  * The pcm operators have to be set afterwards to the new instance
784  * snd_pcm_new_internal - create a new internal PCM instance
790  * @rpcm: the pointer to store the new pcm instance
792  * Creates a new internal PCM instance with no userspace device or procfs
793  * entries. This is used by ASoC Back End PCMs in order to create a PCM that
798  * The pcm operators have to be set afterwards to the new instance
815 		struct snd_card *card = pstr->pcm->card;  in free_chmap()
854 #define pcm_call_notify(pcm, call)					\  argument
858 			_notify->call(pcm);				\
861 #define pcm_call_notify(pcm, call) do {} while (0)  argument
864 static int snd_pcm_free(struct snd_pcm *pcm)  in snd_pcm_free()  argument
866 	if (!pcm)  in snd_pcm_free()
868 	if (!pcm->internal)  in snd_pcm_free()
869 		pcm_call_notify(pcm, n_unregister);  in snd_pcm_free()
870 	if (pcm->private_free)  in snd_pcm_free()
871 		pcm->private_free(pcm);  in snd_pcm_free()
872 	snd_pcm_lib_preallocate_free_for_all(pcm);  in snd_pcm_free()
873 	snd_pcm_free_stream(&pcm->streams[SNDRV_PCM_STREAM_PLAYBACK]);  in snd_pcm_free()
874 	snd_pcm_free_stream(&pcm->streams[SNDRV_PCM_STREAM_CAPTURE]);  in snd_pcm_free()
875 	kfree(pcm);  in snd_pcm_free()
881 	struct snd_pcm *pcm = device->device_data;  in snd_pcm_dev_free()  local
882 	return snd_pcm_free(pcm);  in snd_pcm_dev_free()
885 int snd_pcm_attach_substream(struct snd_pcm *pcm, int stream,  in snd_pcm_attach_substream()  argument
896 	if (snd_BUG_ON(!pcm || !rsubstream))  in snd_pcm_attach_substream()
902 	pstr = &pcm->streams[stream];  in snd_pcm_attach_substream()
906 	card = pcm->card;  in snd_pcm_attach_substream()
909 	if (pcm->info_flags & SNDRV_PCM_INFO_HALF_DUPLEX) {  in snd_pcm_attach_substream()
912 		for (substream = pcm->streams[opposite].substream; substream;  in snd_pcm_attach_substream()
978 	substream->private_data = pcm->private_data;  in snd_pcm_attach_substream()
1001 	/* Avoid concurrent access to runtime via PCM timer interface */  in snd_pcm_detach_substream()
1021 	struct snd_pcm *pcm = pstr->pcm;  in pcm_class_show()  local
1030 	if (pcm->dev_class > SNDRV_PCM_CLASS_LAST)  in pcm_class_show()
1033 		str = strs[pcm->dev_class];  in pcm_class_show()
1056 	struct snd_pcm *pcm;  in snd_pcm_dev_register()  local
1060 	pcm = device->device_data;  in snd_pcm_dev_register()
1063 	err = snd_pcm_add(pcm);  in snd_pcm_dev_register()
1068 		if (pcm->streams[cidx].substream == NULL)  in snd_pcm_dev_register()
1078 		/* register pcm */  in snd_pcm_dev_register()
1079 		err = snd_register_device(devtype, pcm->card, pcm->device,  in snd_pcm_dev_register()
1080 					  &snd_pcm_f_ops[cidx], pcm,  in snd_pcm_dev_register()
1081 					  &pcm->streams[cidx].dev);  in snd_pcm_dev_register()
1083 			list_del_init(&pcm->list);  in snd_pcm_dev_register()
1087 		for (substream = pcm->streams[cidx].substream; substream; substream = substream->next)  in snd_pcm_dev_register()
1091 	pcm_call_notify(pcm, n_register);  in snd_pcm_dev_register()
1100 	struct snd_pcm *pcm = device->device_data;  in snd_pcm_dev_disconnect()  local
1105 	mutex_lock(&pcm->open_mutex);  in snd_pcm_dev_disconnect()
1106 	wake_up(&pcm->open_wait);  in snd_pcm_dev_disconnect()
1107 	list_del_init(&pcm->list);  in snd_pcm_dev_disconnect()
1109 	for_each_pcm_substream(pcm, cidx, substream) {  in snd_pcm_dev_disconnect()
1123 	for_each_pcm_substream(pcm, cidx, substream)  in snd_pcm_dev_disconnect()
1126 	pcm_call_notify(pcm, n_disconnect);  in snd_pcm_dev_disconnect()
1128 		snd_unregister_device(&pcm->streams[cidx].dev);  in snd_pcm_dev_disconnect()
1129 		free_chmap(&pcm->streams[cidx]);  in snd_pcm_dev_disconnect()
1131 	mutex_unlock(&pcm->open_mutex);  in snd_pcm_dev_disconnect()
1139  * @notify: PCM notify list
1143  * called for each registered PCM devices.  This exists only for PCM OSS
1150 	struct snd_pcm *pcm;  in snd_pcm_notify()  local
1160 		list_for_each_entry(pcm, &snd_pcm_devices, list)  in snd_pcm_notify()
1161 			notify->n_unregister(pcm);  in snd_pcm_notify()
1164 		list_for_each_entry(pcm, &snd_pcm_devices, list)  in snd_pcm_notify()
1165 			notify->n_register(pcm);  in snd_pcm_notify()
1181 	struct snd_pcm *pcm;  in snd_pcm_proc_read()  local
1184 	list_for_each_entry(pcm, &snd_pcm_devices, list) {  in snd_pcm_proc_read()
1186 			    pcm->card->number, pcm->device, pcm->id, pcm->name);  in snd_pcm_proc_read()
1187 		if (pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream)  in snd_pcm_proc_read()
1189 				    pcm->streams[SNDRV_PCM_STREAM_PLAYBACK].substream_count);  in snd_pcm_proc_read()
1190 		if (pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream)  in snd_pcm_proc_read()
1192 				    pcm->streams[SNDRV_PCM_STREAM_CAPTURE].substream_count);  in snd_pcm_proc_read()
1204 	entry = snd_info_create_module_entry(THIS_MODULE, "pcm", NULL);  in snd_pcm_proc_init()