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 */
19static 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 */
25static 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 */
33static 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(v: &chip->shutdown))
37 snd_iprintf(buffer, "%03d/%03d\n", chip->dev->bus->busnum, chip->dev->devnum);
38}
39
40static 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(v: &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
49void snd_usb_audio_create_proc(struct snd_usb_audio *chip)
50{
51 snd_card_ro_proc_new(card: chip->card, name: "usbbus", private_data: chip,
52 read: proc_audio_usbbus_read);
53 snd_card_ro_proc_new(card: chip->card, name: "usbid", private_data: chip,
54 read: proc_audio_usbid_read);
55}
56
57static 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 */
92static 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(pcm_format: 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: 0x%02x (%d %s) (%s)\n",
112 fp->endpoint,
113 fp->endpoint & USB_ENDPOINT_NUMBER_MASK,
114 fp->endpoint & USB_DIR_IN ? "IN" : "OUT",
115 sync_types[(fp->ep_attr & USB_ENDPOINT_SYNCTYPE) >> 2]);
116 if (fp->rates & SNDRV_PCM_RATE_CONTINUOUS) {
117 snd_iprintf(buffer, " Rates: %d - %d (continuous)\n",
118 fp->rate_min, fp->rate_max);
119 } else {
120 unsigned int i;
121 snd_iprintf(buffer, " Rates: ");
122 for (i = 0; i < fp->nr_rates; i++) {
123 if (i > 0)
124 snd_iprintf(buffer, ", ");
125 snd_iprintf(buffer, "%d", fp->rate_table[i]);
126 }
127 snd_iprintf(buffer, "\n");
128 }
129 if (subs->speed != USB_SPEED_FULL)
130 snd_iprintf(buffer, " Data packet interval: %d us\n",
131 125 * (1 << fp->datainterval));
132 snd_iprintf(buffer, " Bits: %d\n", fp->fmt_bits);
133
134 if (fp->dsd_raw)
135 snd_iprintf(buffer, " DSD raw: DOP=%d, bitrev=%d\n",
136 fp->dsd_dop, fp->dsd_bitrev);
137
138 if (fp->chmap) {
139 const struct snd_pcm_chmap_elem *map = fp->chmap;
140 int c;
141
142 snd_iprintf(buffer, " Channel map:");
143 for (c = 0; c < map->channels; c++) {
144 if (map->map[c] >= ARRAY_SIZE(channel_labels) ||
145 !channel_labels[map->map[c]])
146 snd_iprintf(buffer, " --");
147 else
148 snd_iprintf(buffer, " %s",
149 channel_labels[map->map[c]]);
150 }
151 snd_iprintf(buffer, "\n");
152 }
153
154 if (fp->sync_ep) {
155 snd_iprintf(buffer, " Sync Endpoint: 0x%02x (%d %s)\n",
156 fp->sync_ep,
157 fp->sync_ep & USB_ENDPOINT_NUMBER_MASK,
158 fp->sync_ep & USB_DIR_IN ? "IN" : "OUT");
159 snd_iprintf(buffer, " Sync EP Interface: %d\n",
160 fp->sync_iface);
161 snd_iprintf(buffer, " Sync EP Altset: %d\n",
162 fp->sync_altsetting);
163 snd_iprintf(buffer, " Implicit Feedback Mode: %s\n",
164 fp->implicit_fb ? "Yes" : "No");
165 }
166
167 // snd_iprintf(buffer, " Max Packet Size = %d\n", fp->maxpacksize);
168 // snd_iprintf(buffer, " EP Attribute = %#x\n", fp->attributes);
169 }
170}
171
172static void proc_dump_ep_status(struct snd_usb_substream *subs,
173 struct snd_usb_endpoint *data_ep,
174 struct snd_usb_endpoint *sync_ep,
175 struct snd_info_buffer *buffer)
176{
177 if (!data_ep)
178 return;
179 snd_iprintf(buffer, " Packet Size = %d\n", data_ep->curpacksize);
180 snd_iprintf(buffer, " Momentary freq = %u Hz (%#x.%04x)\n",
181 subs->speed == USB_SPEED_FULL
182 ? get_full_speed_hz(data_ep->freqm)
183 : get_high_speed_hz(data_ep->freqm),
184 data_ep->freqm >> 16, data_ep->freqm & 0xffff);
185 if (sync_ep && data_ep->freqshift != INT_MIN) {
186 int res = 16 - data_ep->freqshift;
187 snd_iprintf(buffer, " Feedback Format = %d.%d\n",
188 (sync_ep->syncmaxsize > 3 ? 32 : 24) - res, res);
189 }
190}
191
192static void proc_dump_substream_status(struct snd_usb_audio *chip,
193 struct snd_usb_substream *subs,
194 struct snd_info_buffer *buffer)
195{
196 mutex_lock(&chip->mutex);
197 if (subs->running) {
198 snd_iprintf(buffer, " Status: Running\n");
199 if (subs->cur_audiofmt) {
200 snd_iprintf(buffer, " Interface = %d\n", subs->cur_audiofmt->iface);
201 snd_iprintf(buffer, " Altset = %d\n", subs->cur_audiofmt->altsetting);
202 }
203 proc_dump_ep_status(subs, data_ep: subs->data_endpoint, sync_ep: subs->sync_endpoint, buffer);
204 } else {
205 snd_iprintf(buffer, " Status: Stop\n");
206 }
207 mutex_unlock(lock: &chip->mutex);
208}
209
210static void proc_pcm_format_read(struct snd_info_entry *entry, struct snd_info_buffer *buffer)
211{
212 struct snd_usb_stream *stream = entry->private_data;
213 struct snd_usb_audio *chip = stream->chip;
214
215 snd_iprintf(buffer, "%s : %s\n", chip->card->longname, stream->pcm->name);
216
217 if (stream->substream[SNDRV_PCM_STREAM_PLAYBACK].num_formats) {
218 snd_iprintf(buffer, "\nPlayback:\n");
219 proc_dump_substream_status(chip, subs: &stream->substream[SNDRV_PCM_STREAM_PLAYBACK], buffer);
220 proc_dump_substream_formats(subs: &stream->substream[SNDRV_PCM_STREAM_PLAYBACK], buffer);
221 }
222 if (stream->substream[SNDRV_PCM_STREAM_CAPTURE].num_formats) {
223 snd_iprintf(buffer, "\nCapture:\n");
224 proc_dump_substream_status(chip, subs: &stream->substream[SNDRV_PCM_STREAM_CAPTURE], buffer);
225 proc_dump_substream_formats(subs: &stream->substream[SNDRV_PCM_STREAM_CAPTURE], buffer);
226 }
227}
228
229void snd_usb_proc_pcm_format_add(struct snd_usb_stream *stream)
230{
231 char name[32];
232 struct snd_card *card = stream->chip->card;
233
234 sprintf(buf: name, fmt: "stream%d", stream->pcm_index);
235 snd_card_ro_proc_new(card, name, private_data: stream, read: proc_pcm_format_read);
236}
237
238

source code of linux/sound/usb/proc.c