sound/usb/proc.c

   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: 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
 172 static 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
 192 static 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, subs->data_endpoint, subs->sync_endpoint, buffer);
 204         } else {
 205                 snd_iprintf(buffer, "  Status: Stop\n");
 206         }
 207         mutex_unlock(&chip->mutex);
 208 }
 209
 210 static 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, &stream->substream[SNDRV_PCM_STREAM_PLAYBACK], buffer);
 220                 proc_dump_substream_formats(&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, &stream->substream[SNDRV_PCM_STREAM_CAPTURE], buffer);
 225                 proc_dump_substream_formats(&stream->substream[SNDRV_PCM_STREAM_CAPTURE], buffer);
 226         }
 227 }
 228
 229 void 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(name, "stream%d", stream->pcm_index);
 235         snd_card_ro_proc_new(card, name, stream, proc_pcm_format_read);
 236 }
 237