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 /*
  58  * proc interface for list the supported pcm formats
  59  */
  60 static void proc_dump_substream_formats(struct snd_usb_substream *subs, struct snd_info_buffer *buffer)
  61 {
  62         struct audioformat *fp;
  63         static const char * const sync_types[4] = {
  64                 "NONE", "ASYNC", "ADAPTIVE", "SYNC"
  65         };
  66
  67         list_for_each_entry(fp, &subs->fmt_list, list) {
  68                 snd_pcm_format_t fmt;
  69
  70                 snd_iprintf(buffer, "  Interface %d\n", fp->iface);
  71                 snd_iprintf(buffer, "    Altset %d\n", fp->altsetting);
  72                 snd_iprintf(buffer, "    Format:");
  73                 pcm_for_each_format(fmt)
  74                         if (fp->formats & pcm_format_to_bits(fmt))
  75                                 snd_iprintf(buffer, " %s",
  76                                             snd_pcm_format_name(fmt));
  77                 snd_iprintf(buffer, "\n");
  78                 snd_iprintf(buffer, "    Channels: %d\n", fp->channels);
  79                 snd_iprintf(buffer, "    Endpoint: %d %s (%s)\n",
  80                             fp->endpoint & USB_ENDPOINT_NUMBER_MASK,
  81                             fp->endpoint & USB_DIR_IN ? "IN" : "OUT",
  82                             sync_types[(fp->ep_attr & USB_ENDPOINT_SYNCTYPE) >> 2]);
  83                 if (fp->rates & SNDRV_PCM_RATE_CONTINUOUS) {
  84                         snd_iprintf(buffer, "    Rates: %d - %d (continuous)\n",
  85                                     fp->rate_min, fp->rate_max);
  86                 } else {
  87                         unsigned int i;
  88                         snd_iprintf(buffer, "    Rates: ");
  89                         for (i = 0; i < fp->nr_rates; i++) {
  90                                 if (i > 0)
  91                                         snd_iprintf(buffer, ", ");
  92                                 snd_iprintf(buffer, "%d", fp->rate_table[i]);
  93                         }
  94                         snd_iprintf(buffer, "\n");
  95                 }
  96                 if (subs->speed != USB_SPEED_FULL)
  97                         snd_iprintf(buffer, "    Data packet interval: %d us\n",
  98                                     125 * (1 << fp->datainterval));
  99                 snd_iprintf(buffer, "    Bits: %d\n", fp->fmt_bits);
 100                 // snd_iprintf(buffer, "    Max Packet Size = %d\n", fp->maxpacksize);
 101                 // snd_iprintf(buffer, "    EP Attribute = %#x\n", fp->attributes);
 102         }
 103 }
 104
 105 static void proc_dump_ep_status(struct snd_usb_substream *subs,
 106                                 struct snd_usb_endpoint *data_ep,
 107                                 struct snd_usb_endpoint *sync_ep,
 108                                 struct snd_info_buffer *buffer)
 109 {
 110         if (!data_ep)
 111                 return;
 112         snd_iprintf(buffer, "    Packet Size = %d\n", data_ep->curpacksize);
 113         snd_iprintf(buffer, "    Momentary freq = %u Hz (%#x.%04x)\n",
 114                     subs->speed == USB_SPEED_FULL
 115                     ? get_full_speed_hz(data_ep->freqm)
 116                     : get_high_speed_hz(data_ep->freqm),
 117                     data_ep->freqm >> 16, data_ep->freqm & 0xffff);
 118         if (sync_ep && data_ep->freqshift != INT_MIN) {
 119                 int res = 16 - data_ep->freqshift;
 120                 snd_iprintf(buffer, "    Feedback Format = %d.%d\n",
 121                             (sync_ep->syncmaxsize > 3 ? 32 : 24) - res, res);
 122         }
 123 }
 124
 125 static void proc_dump_substream_status(struct snd_usb_substream *subs, struct snd_info_buffer *buffer)
 126 {
 127         if (subs->running) {
 128                 snd_iprintf(buffer, "  Status: Running\n");
 129                 snd_iprintf(buffer, "    Interface = %d\n", subs->interface);
 130                 snd_iprintf(buffer, "    Altset = %d\n", subs->altset_idx);
 131                 proc_dump_ep_status(subs, subs->data_endpoint, subs->sync_endpoint, buffer);
 132         } else {
 133                 snd_iprintf(buffer, "  Status: Stop\n");
 134         }
 135 }
 136
 137 static void proc_pcm_format_read(struct snd_info_entry *entry, struct snd_info_buffer *buffer)
 138 {
 139         struct snd_usb_stream *stream = entry->private_data;
 140
 141         snd_iprintf(buffer, "%s : %s\n", stream->chip->card->longname, stream->pcm->name);
 142
 143         if (stream->substream[SNDRV_PCM_STREAM_PLAYBACK].num_formats) {
 144                 snd_iprintf(buffer, "\nPlayback:\n");
 145                 proc_dump_substream_status(&stream->substream[SNDRV_PCM_STREAM_PLAYBACK], buffer);
 146                 proc_dump_substream_formats(&stream->substream[SNDRV_PCM_STREAM_PLAYBACK], buffer);
 147         }
 148         if (stream->substream[SNDRV_PCM_STREAM_CAPTURE].num_formats) {
 149                 snd_iprintf(buffer, "\nCapture:\n");
 150                 proc_dump_substream_status(&stream->substream[SNDRV_PCM_STREAM_CAPTURE], buffer);
 151                 proc_dump_substream_formats(&stream->substream[SNDRV_PCM_STREAM_CAPTURE], buffer);
 152         }
 153 }
 154
 155 void snd_usb_proc_pcm_format_add(struct snd_usb_stream *stream)
 156 {
 157         char name[32];
 158         struct snd_card *card = stream->chip->card;
 159
 160         sprintf(name, "stream%d", stream->pcm_index);
 161         snd_card_ro_proc_new(card, name, stream, proc_pcm_format_read);
 162 }
 163