[linux-block.git] / sound / usb / proc.c

// SPDX-License-Identifier: GPL-2.0-or-later
/*
 */

#include <linux/init.h>
#include <linux/usb.h>

#include <sound/core.h>
#include <sound/info.h>
#include <sound/pcm.h>

#include "usbaudio.h"
#include "helper.h"
#include "card.h"
#include "endpoint.h"
#include "proc.h"

/* convert our full speed USB rate into sampling rate in Hz */
static inline unsigned get_full_speed_hz(unsigned int usb_rate)
{
	return (usb_rate * 125 + (1 << 12)) >> 13;
}

/* convert our high speed USB rate into sampling rate in Hz */
static inline unsigned get_high_speed_hz(unsigned int usb_rate)
{
	return (usb_rate * 125 + (1 << 9)) >> 10;
}

/*
 * common proc files to show the usb device info
 */
static void proc_audio_usbbus_read(struct snd_info_entry *entry, struct snd_info_buffer *buffer)
{
	struct snd_usb_audio *chip = entry->private_data;
	if (!atomic_read(&chip->shutdown))
		snd_iprintf(buffer, "%03d/%03d\n", chip->dev->bus->busnum, chip->dev->devnum);
}

static void proc_audio_usbid_read(struct snd_info_entry *entry, struct snd_info_buffer *buffer)
{
	struct snd_usb_audio *chip = entry->private_data;
	if (!atomic_read(&chip->shutdown))
		snd_iprintf(buffer, "%04x:%04x\n", 
			    USB_ID_VENDOR(chip->usb_id),
			    USB_ID_PRODUCT(chip->usb_id));
}

void snd_usb_audio_create_proc(struct snd_usb_audio *chip)
{
	snd_card_ro_proc_new(chip->card, "usbbus", chip,
			     proc_audio_usbbus_read);
	snd_card_ro_proc_new(chip->card, "usbid", chip,
			     proc_audio_usbid_read);
}

static const char * const channel_labels[] = {
	[SNDRV_CHMAP_NA]	= "N/A",
	[SNDRV_CHMAP_MONO]	= "MONO",
	[SNDRV_CHMAP_FL]	= "FL",
	[SNDRV_CHMAP_FR]	= "FR",
	[SNDRV_CHMAP_FC]	= "FC",
	[SNDRV_CHMAP_LFE]	= "LFE",
	[SNDRV_CHMAP_RL]	= "RL",
	[SNDRV_CHMAP_RR]	= "RR",
	[SNDRV_CHMAP_FLC]	= "FLC",
	[SNDRV_CHMAP_FRC]	= "FRC",
	[SNDRV_CHMAP_RC]	= "RC",
	[SNDRV_CHMAP_SL]	= "SL",
	[SNDRV_CHMAP_SR]	= "SR",
	[SNDRV_CHMAP_TC]	= "TC",
	[SNDRV_CHMAP_TFL]	= "TFL",
	[SNDRV_CHMAP_TFC]	= "TFC",
	[SNDRV_CHMAP_TFR]	= "TFR",
	[SNDRV_CHMAP_TRL]	= "TRL",
	[SNDRV_CHMAP_TRC]	= "TRC",
	[SNDRV_CHMAP_TRR]	= "TRR",
	[SNDRV_CHMAP_TFLC]	= "TFLC",
	[SNDRV_CHMAP_TFRC]	= "TFRC",
	[SNDRV_CHMAP_LLFE]	= "LLFE",
	[SNDRV_CHMAP_RLFE]	= "RLFE",
	[SNDRV_CHMAP_TSL]	= "TSL",
	[SNDRV_CHMAP_TSR]	= "TSR",
	[SNDRV_CHMAP_BC]	= "BC",
	[SNDRV_CHMAP_RLC]	= "RLC",
	[SNDRV_CHMAP_RRC]	= "RRC",
};

/*
 * proc interface for list the supported pcm formats
 */
static void proc_dump_substream_formats(struct snd_usb_substream *subs, struct snd_info_buffer *buffer)
{
	struct audioformat *fp;
	static const char * const sync_types[4] = {
		"NONE", "ASYNC", "ADAPTIVE", "SYNC"
	};

	list_for_each_entry(fp, &subs->fmt_list, list) {
		snd_pcm_format_t fmt;

		snd_iprintf(buffer, "  Interface %d\n", fp->iface);
		snd_iprintf(buffer, "    Altset %d\n", fp->altsetting);
		snd_iprintf(buffer, "    Format:");
		pcm_for_each_format(fmt)
			if (fp->formats & pcm_format_to_bits(fmt))
				snd_iprintf(buffer, " %s",
					    snd_pcm_format_name(fmt));
		snd_iprintf(buffer, "\n");
		snd_iprintf(buffer, "    Channels: %d\n", fp->channels);
		snd_iprintf(buffer, "    Endpoint: %d %s (%s)\n",
			    fp->endpoint & USB_ENDPOINT_NUMBER_MASK,
			    fp->endpoint & USB_DIR_IN ? "IN" : "OUT",
			    sync_types[(fp->ep_attr & USB_ENDPOINT_SYNCTYPE) >> 2]);
		if (fp->rates & SNDRV_PCM_RATE_CONTINUOUS) {
			snd_iprintf(buffer, "    Rates: %d - %d (continuous)\n",
				    fp->rate_min, fp->rate_max);
		} else {
			unsigned int i;
			snd_iprintf(buffer, "    Rates: ");
			for (i = 0; i < fp->nr_rates; i++) {
				if (i > 0)
					snd_iprintf(buffer, ", ");
				snd_iprintf(buffer, "%d", fp->rate_table[i]);
			}
			snd_iprintf(buffer, "\n");
		}
		if (subs->speed != USB_SPEED_FULL)
			snd_iprintf(buffer, "    Data packet interval: %d us\n",
				    125 * (1 << fp->datainterval));
		snd_iprintf(buffer, "    Bits: %d\n", fp->fmt_bits);

		if (fp->dsd_raw)
			snd_iprintf(buffer, "    DSD raw: DOP=%d, bitrev=%d\n",
				    fp->dsd_dop, fp->dsd_bitrev);

		if (fp->chmap) {
			const struct snd_pcm_chmap_elem *map = fp->chmap;
			int c;

			snd_iprintf(buffer, "    Channel map:");
			for (c = 0; c < map->channels; c++) {
				if (map->map[c] >= ARRAY_SIZE(channel_labels) ||
				    !channel_labels[map->map[c]])
					snd_iprintf(buffer, " --");
				else
					snd_iprintf(buffer, " %s",
						    channel_labels[map->map[c]]);
			}
			snd_iprintf(buffer, "\n");
		}

		// snd_iprintf(buffer, "    Max Packet Size = %d\n", fp->maxpacksize);
		// snd_iprintf(buffer, "    EP Attribute = %#x\n", fp->attributes);
	}
}

static void proc_dump_ep_status(struct snd_usb_substream *subs,
				struct snd_usb_endpoint *data_ep,
				struct snd_usb_endpoint *sync_ep,
				struct snd_info_buffer *buffer)
{
	if (!data_ep)
		return;
	snd_iprintf(buffer, "    Packet Size = %d\n", data_ep->curpacksize);
	snd_iprintf(buffer, "    Momentary freq = %u Hz (%#x.%04x)\n",
		    subs->speed == USB_SPEED_FULL
		    ? get_full_speed_hz(data_ep->freqm)
		    : get_high_speed_hz(data_ep->freqm),
		    data_ep->freqm >> 16, data_ep->freqm & 0xffff);
	if (sync_ep && data_ep->freqshift != INT_MIN) {
		int res = 16 - data_ep->freqshift;
		snd_iprintf(buffer, "    Feedback Format = %d.%d\n",
			    (sync_ep->syncmaxsize > 3 ? 32 : 24) - res, res);
	}
}

static void proc_dump_substream_status(struct snd_usb_substream *subs, struct snd_info_buffer *buffer)
{
	if (subs->running) {
		snd_iprintf(buffer, "  Status: Running\n");
		snd_iprintf(buffer, "    Interface = %d\n", subs->interface);
		snd_iprintf(buffer, "    Altset = %d\n", subs->altset_idx);
		proc_dump_ep_status(subs, subs->data_endpoint, subs->sync_endpoint, buffer);
	} else {
		snd_iprintf(buffer, "  Status: Stop\n");
	}
}

static void proc_pcm_format_read(struct snd_info_entry *entry, struct snd_info_buffer *buffer)
{
	struct snd_usb_stream *stream = entry->private_data;

	snd_iprintf(buffer, "%s : %s\n", stream->chip->card->longname, stream->pcm->name);

	if (stream->substream[SNDRV_PCM_STREAM_PLAYBACK].num_formats) {
		snd_iprintf(buffer, "\nPlayback:\n");
		proc_dump_substream_status(&stream->substream[SNDRV_PCM_STREAM_PLAYBACK], buffer);
		proc_dump_substream_formats(&stream->substream[SNDRV_PCM_STREAM_PLAYBACK], buffer);
	}
	if (stream->substream[SNDRV_PCM_STREAM_CAPTURE].num_formats) {
		snd_iprintf(buffer, "\nCapture:\n");
		proc_dump_substream_status(&stream->substream[SNDRV_PCM_STREAM_CAPTURE], buffer);
		proc_dump_substream_formats(&stream->substream[SNDRV_PCM_STREAM_CAPTURE], buffer);
	}
}

void snd_usb_proc_pcm_format_add(struct snd_usb_stream *stream)
{
	char name[32];
	struct snd_card *card = stream->chip->card;

	sprintf(name, "stream%d", stream->pcm_index);
	snd_card_ro_proc_new(card, name, stream, proc_pcm_format_read);
}
Commit	Line	Data
1a59d1b8	1	// SPDX-License-Identifier: GPL-2.0-or-later
e5779998	2	/*
e5779998 DM	3	*/
	4
	5	#include <linux/init.h>
	6	#include <linux/usb.h>
	7
	8	#include <sound/core.h>
	9	#include <sound/info.h>
	10	#include <sound/pcm.h>
	11
	12	#include "usbaudio.h"
	13	#include "helper.h"
	14	#include "card.h"
c89a5d9c	15	#include "endpoint.h"
e5779998 DM	16	#include "proc.h"
	17
	18	/* convert our full speed USB rate into sampling rate in Hz */
	19	static inline unsigned get_full_speed_hz(unsigned int usb_rate)
	20	{
	21	return (usb_rate * 125 + (1 << 12)) >> 13;
	22	}
	23
	24	/* convert our high speed USB rate into sampling rate in Hz */
	25	static inline unsigned get_high_speed_hz(unsigned int usb_rate)
	26	{
	27	return (usb_rate * 125 + (1 << 9)) >> 10;
	28	}
	29
	30	/*
	31	* common proc files to show the usb device info
	32	*/
	33	static void proc_audio_usbbus_read(struct snd_info_entry entry, struct snd_info_buffer buffer)
	34	{
	35	struct snd_usb_audio *chip = entry->private_data;
47ab1545	36	if (!atomic_read(&chip->shutdown))
e5779998 DM	37	snd_iprintf(buffer, "%03d/%03d\n", chip->dev->bus->busnum, chip->dev->devnum);
	38	}
	39
	40	static void proc_audio_usbid_read(struct snd_info_entry entry, struct snd_info_buffer buffer)
	41	{
	42	struct snd_usb_audio *chip = entry->private_data;
47ab1545	43	if (!atomic_read(&chip->shutdown))
e5779998 DM	44	snd_iprintf(buffer, "%04x:%04x\n",
	45	USB_ID_VENDOR(chip->usb_id),
	46	USB_ID_PRODUCT(chip->usb_id));
	47	}
	48
	49	void snd_usb_audio_create_proc(struct snd_usb_audio *chip)
	50	{
7449054a TI	51	snd_card_ro_proc_new(chip->card, "usbbus", chip,
	52	proc_audio_usbbus_read);
	53	snd_card_ro_proc_new(chip->card, "usbid", chip,
	54	proc_audio_usbid_read);
e5779998 DM	55	}
e5779998 DM	56
093b8494 TI	57	static const char * const channel_labels[] = {
	58	[SNDRV_CHMAP_NA] = "N/A",
	59	[SNDRV_CHMAP_MONO] = "MONO",
	60	[SNDRV_CHMAP_FL] = "FL",
	61	[SNDRV_CHMAP_FR] = "FR",
	62	[SNDRV_CHMAP_FC] = "FC",
	63	[SNDRV_CHMAP_LFE] = "LFE",
	64	[SNDRV_CHMAP_RL] = "RL",
	65	[SNDRV_CHMAP_RR] = "RR",
	66	[SNDRV_CHMAP_FLC] = "FLC",
	67	[SNDRV_CHMAP_FRC] = "FRC",
	68	[SNDRV_CHMAP_RC] = "RC",
	69	[SNDRV_CHMAP_SL] = "SL",
	70	[SNDRV_CHMAP_SR] = "SR",
	71	[SNDRV_CHMAP_TC] = "TC",
	72	[SNDRV_CHMAP_TFL] = "TFL",
	73	[SNDRV_CHMAP_TFC] = "TFC",
	74	[SNDRV_CHMAP_TFR] = "TFR",
	75	[SNDRV_CHMAP_TRL] = "TRL",
	76	[SNDRV_CHMAP_TRC] = "TRC",
	77	[SNDRV_CHMAP_TRR] = "TRR",
	78	[SNDRV_CHMAP_TFLC] = "TFLC",
	79	[SNDRV_CHMAP_TFRC] = "TFRC",
	80	[SNDRV_CHMAP_LLFE] = "LLFE",
	81	[SNDRV_CHMAP_RLFE] = "RLFE",
	82	[SNDRV_CHMAP_TSL] = "TSL",
	83	[SNDRV_CHMAP_TSR] = "TSR",
	84	[SNDRV_CHMAP_BC] = "BC",
	85	[SNDRV_CHMAP_RLC] = "RLC",
	86	[SNDRV_CHMAP_RRC] = "RRC",
	87	};
	88
e5779998 DM	89	/*
	90	* proc interface for list the supported pcm formats
	91	*/
	92	static void proc_dump_substream_formats(struct snd_usb_substream subs, struct snd_info_buffer buffer)
	93	{
88766f04	94	struct audioformat *fp;
a01df925	95	static const char * const sync_types[4] = {
e5779998 DM	96	"NONE", "ASYNC", "ADAPTIVE", "SYNC"
	97	};
	98
88766f04	99	list_for_each_entry(fp, &subs->fmt_list, list) {
015eb0b0	100	snd_pcm_format_t fmt;
88766f04	101
e5779998 DM	102	snd_iprintf(buffer, " Interface %d\n", fp->iface);
e5779998 DM	103	snd_iprintf(buffer, " Altset %d\n", fp->altsetting);
015eb0b0	104	snd_iprintf(buffer, " Format:");
5b29f053	105	pcm_for_each_format(fmt)
74c34ca1	106	if (fp->formats & pcm_format_to_bits(fmt))
015eb0b0 CL	107	snd_iprintf(buffer, " %s",
	108	snd_pcm_format_name(fmt));
	109	snd_iprintf(buffer, "\n");
e5779998 DM	110	snd_iprintf(buffer, " Channels: %d\n", fp->channels);
	111	snd_iprintf(buffer, " Endpoint: %d %s (%s)\n",
	112	fp->endpoint & USB_ENDPOINT_NUMBER_MASK,
	113	fp->endpoint & USB_DIR_IN ? "IN" : "OUT",
	114	sync_types[(fp->ep_attr & USB_ENDPOINT_SYNCTYPE) >> 2]);
	115	if (fp->rates & SNDRV_PCM_RATE_CONTINUOUS) {
	116	snd_iprintf(buffer, " Rates: %d - %d (continuous)\n",
	117	fp->rate_min, fp->rate_max);
	118	} else {
	119	unsigned int i;
	120	snd_iprintf(buffer, " Rates: ");
	121	for (i = 0; i < fp->nr_rates; i++) {
	122	if (i > 0)
	123	snd_iprintf(buffer, ", ");
	124	snd_iprintf(buffer, "%d", fp->rate_table[i]);
	125	}
	126	snd_iprintf(buffer, "\n");
	127	}
978520b7	128	if (subs->speed != USB_SPEED_FULL)
e5779998 DM	129	snd_iprintf(buffer, " Data packet interval: %d us\n",
e5779998 DM	130	125 * (1 << fp->datainterval));
c7a13264	131	snd_iprintf(buffer, " Bits: %d\n", fp->fmt_bits);
093b8494 TI	132
	133	if (fp->dsd_raw)
	134	snd_iprintf(buffer, " DSD raw: DOP=%d, bitrev=%d\n",
	135	fp->dsd_dop, fp->dsd_bitrev);
	136
	137	if (fp->chmap) {
	138	const struct snd_pcm_chmap_elem *map = fp->chmap;
	139	int c;
	140
	141	snd_iprintf(buffer, " Channel map:");
	142	for (c = 0; c < map->channels; c++) {
8137d276	143	if (map->map[c] >= ARRAY_SIZE(channel_labels) \|\|
093b8494 TI	144	!channel_labels[map->map[c]])
	145	snd_iprintf(buffer, " --");
	146	else
	147	snd_iprintf(buffer, " %s",
	148	channel_labels[map->map[c]]);
	149	}
	150	snd_iprintf(buffer, "\n");
	151	}
	152
e5779998 DM	153	// snd_iprintf(buffer, " Max Packet Size = %d\n", fp->maxpacksize);
	154	// snd_iprintf(buffer, " EP Attribute = %#x\n", fp->attributes);
	155	}
	156	}
	157
22026c1a	158	static void proc_dump_ep_status(struct snd_usb_substream *subs,
e6135fe9 TH	159	struct snd_usb_endpoint *data_ep,
e6135fe9 TH	160	struct snd_usb_endpoint *sync_ep,
22026c1a TI	161	struct snd_info_buffer *buffer)
22026c1a TI	162	{
e6135fe9	163	if (!data_ep)
22026c1a	164	return;
e6135fe9	165	snd_iprintf(buffer, " Packet Size = %d\n", data_ep->curpacksize);
22026c1a	166	snd_iprintf(buffer, " Momentary freq = %u Hz (%#x.%04x)\n",
978520b7	167	subs->speed == USB_SPEED_FULL
e6135fe9 TH	168	? get_full_speed_hz(data_ep->freqm)
	169	: get_high_speed_hz(data_ep->freqm),
	170	data_ep->freqm >> 16, data_ep->freqm & 0xffff);
	171	if (sync_ep && data_ep->freqshift != INT_MIN) {
	172	int res = 16 - data_ep->freqshift;
22026c1a	173	snd_iprintf(buffer, " Feedback Format = %d.%d\n",
e6135fe9	174	(sync_ep->syncmaxsize > 3 ? 32 : 24) - res, res);
22026c1a TI	175	}
	176	}
	177
e5779998 DM	178	static void proc_dump_substream_status(struct snd_usb_substream subs, struct snd_info_buffer buffer)
	179	{
	180	if (subs->running) {
e5779998 DM	181	snd_iprintf(buffer, " Status: Running\n");
e5779998 DM	182	snd_iprintf(buffer, " Interface = %d\n", subs->interface);
e11b4e0e	183	snd_iprintf(buffer, " Altset = %d\n", subs->altset_idx);
e6135fe9	184	proc_dump_ep_status(subs, subs->data_endpoint, subs->sync_endpoint, buffer);
e5779998 DM	185	} else {
	186	snd_iprintf(buffer, " Status: Stop\n");
	187	}
	188	}
	189
	190	static void proc_pcm_format_read(struct snd_info_entry entry, struct snd_info_buffer buffer)
	191	{
	192	struct snd_usb_stream *stream = entry->private_data;
	193
	194	snd_iprintf(buffer, "%s : %s\n", stream->chip->card->longname, stream->pcm->name);
	195
	196	if (stream->substream[SNDRV_PCM_STREAM_PLAYBACK].num_formats) {
	197	snd_iprintf(buffer, "\nPlayback:\n");
	198	proc_dump_substream_status(&stream->substream[SNDRV_PCM_STREAM_PLAYBACK], buffer);
	199	proc_dump_substream_formats(&stream->substream[SNDRV_PCM_STREAM_PLAYBACK], buffer);
	200	}
	201	if (stream->substream[SNDRV_PCM_STREAM_CAPTURE].num_formats) {
	202	snd_iprintf(buffer, "\nCapture:\n");
	203	proc_dump_substream_status(&stream->substream[SNDRV_PCM_STREAM_CAPTURE], buffer);
	204	proc_dump_substream_formats(&stream->substream[SNDRV_PCM_STREAM_CAPTURE], buffer);
	205	}
	206	}
	207
	208	void snd_usb_proc_pcm_format_add(struct snd_usb_stream *stream)
	209	{
e5779998 DM	210	char name[32];
	211	struct snd_card *card = stream->chip->card;
	212
	213	sprintf(name, "stream%d", stream->pcm_index);
7449054a	214	snd_card_ro_proc_new(card, name, stream, proc_pcm_format_read);
e5779998 DM	215	}
e5779998 DM	216