xref: /linux/sound/usb/proc.c (revision b8265621f4888af9494e1d685620871ec81bc33d)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
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"
15 #include "endpoint.h"
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;
36 	if (!atomic_read(&chip->shutdown))
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;
43 	if (!atomic_read(&chip->shutdown))
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 {
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);
55 }
56 
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 
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 {
94 	struct audioformat *fp;
95 	static const char * const sync_types[4] = {
96 		"NONE", "ASYNC", "ADAPTIVE", "SYNC"
97 	};
98 
99 	list_for_each_entry(fp, &subs->fmt_list, list) {
100 		snd_pcm_format_t fmt;
101 
102 		snd_iprintf(buffer, "  Interface %d\n", fp->iface);
103 		snd_iprintf(buffer, "    Altset %d\n", fp->altsetting);
104 		snd_iprintf(buffer, "    Format:");
105 		pcm_for_each_format(fmt)
106 			if (fp->formats & pcm_format_to_bits(fmt))
107 				snd_iprintf(buffer, " %s",
108 					    snd_pcm_format_name(fmt));
109 		snd_iprintf(buffer, "\n");
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 		}
128 		if (subs->speed != USB_SPEED_FULL)
129 			snd_iprintf(buffer, "    Data packet interval: %d us\n",
130 				    125 * (1 << fp->datainterval));
131 		snd_iprintf(buffer, "    Bits: %d\n", fp->fmt_bits);
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++) {
143 				if (map->map[c] >= ARRAY_SIZE(channel_labels) ||
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 
153 		// snd_iprintf(buffer, "    Max Packet Size = %d\n", fp->maxpacksize);
154 		// snd_iprintf(buffer, "    EP Attribute = %#x\n", fp->attributes);
155 	}
156 }
157 
158 static void proc_dump_ep_status(struct snd_usb_substream *subs,
159 				struct snd_usb_endpoint *data_ep,
160 				struct snd_usb_endpoint *sync_ep,
161 				struct snd_info_buffer *buffer)
162 {
163 	if (!data_ep)
164 		return;
165 	snd_iprintf(buffer, "    Packet Size = %d\n", data_ep->curpacksize);
166 	snd_iprintf(buffer, "    Momentary freq = %u Hz (%#x.%04x)\n",
167 		    subs->speed == USB_SPEED_FULL
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;
173 		snd_iprintf(buffer, "    Feedback Format = %d.%d\n",
174 			    (sync_ep->syncmaxsize > 3 ? 32 : 24) - res, res);
175 	}
176 }
177 
178 static void proc_dump_substream_status(struct snd_usb_substream *subs, struct snd_info_buffer *buffer)
179 {
180 	if (subs->running) {
181 		snd_iprintf(buffer, "  Status: Running\n");
182 		snd_iprintf(buffer, "    Interface = %d\n", subs->interface);
183 		snd_iprintf(buffer, "    Altset = %d\n", subs->altset_idx);
184 		proc_dump_ep_status(subs, subs->data_endpoint, subs->sync_endpoint, buffer);
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 {
210 	char name[32];
211 	struct snd_card *card = stream->chip->card;
212 
213 	sprintf(name, "stream%d", stream->pcm_index);
214 	snd_card_ro_proc_new(card, name, stream, proc_pcm_format_read);
215 }
216 
217