1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef __USBAUDIO_CARD_H 3 #define __USBAUDIO_CARD_H 4 5 #define MAX_NR_RATES 1024 6 #define MAX_PACKS 6 /* per URB */ 7 #define MAX_PACKS_HS (MAX_PACKS * 8) /* in high speed mode */ 8 #define MAX_URBS 12 9 #define SYNC_URBS 4 /* always four urbs for sync */ 10 #define MAX_QUEUE 18 /* try not to exceed this queue length, in ms */ 11 12 struct audioformat { 13 struct list_head list; 14 u64 formats; /* ALSA format bits */ 15 unsigned int channels; /* # channels */ 16 unsigned int fmt_type; /* USB audio format type (1-3) */ 17 unsigned int frame_size; /* samples per frame for non-audio */ 18 int iface; /* interface number */ 19 unsigned char altsetting; /* corresponding alternate setting */ 20 unsigned char altset_idx; /* array index of altenate setting */ 21 unsigned char attributes; /* corresponding attributes of cs endpoint */ 22 unsigned char endpoint; /* endpoint */ 23 unsigned char ep_attr; /* endpoint attributes */ 24 unsigned char datainterval; /* log_2 of data packet interval */ 25 unsigned char protocol; /* UAC_VERSION_1/2/3 */ 26 unsigned int maxpacksize; /* max. packet size */ 27 unsigned int rates; /* rate bitmasks */ 28 unsigned int rate_min, rate_max; /* min/max rates */ 29 unsigned int nr_rates; /* number of rate table entries */ 30 unsigned int *rate_table; /* rate table */ 31 unsigned char clock; /* associated clock */ 32 struct snd_pcm_chmap_elem *chmap; /* (optional) channel map */ 33 bool dsd_dop; /* add DOP headers in case of DSD samples */ 34 bool dsd_bitrev; /* reverse the bits of each DSD sample */ 35 }; 36 37 struct snd_usb_substream; 38 struct snd_usb_endpoint; 39 40 struct snd_urb_ctx { 41 struct urb *urb; 42 unsigned int buffer_size; /* size of data buffer, if data URB */ 43 struct snd_usb_substream *subs; 44 struct snd_usb_endpoint *ep; 45 int index; /* index for urb array */ 46 int packets; /* number of packets per urb */ 47 int packet_size[MAX_PACKS_HS]; /* size of packets for next submission */ 48 struct list_head ready_list; 49 }; 50 51 struct snd_usb_endpoint { 52 struct snd_usb_audio *chip; 53 54 int use_count; 55 int ep_num; /* the referenced endpoint number */ 56 int type; /* SND_USB_ENDPOINT_TYPE_* */ 57 unsigned long flags; 58 59 void (*prepare_data_urb) (struct snd_usb_substream *subs, 60 struct urb *urb); 61 void (*retire_data_urb) (struct snd_usb_substream *subs, 62 struct urb *urb); 63 64 struct snd_usb_substream *data_subs; 65 struct snd_usb_endpoint *sync_master; 66 struct snd_usb_endpoint *sync_slave; 67 68 struct snd_urb_ctx urb[MAX_URBS]; 69 70 struct snd_usb_packet_info { 71 uint32_t packet_size[MAX_PACKS_HS]; 72 int packets; 73 } next_packet[MAX_URBS]; 74 int next_packet_read_pos, next_packet_write_pos; 75 struct list_head ready_playback_urbs; 76 77 unsigned int nurbs; /* # urbs */ 78 unsigned long active_mask; /* bitmask of active urbs */ 79 unsigned long unlink_mask; /* bitmask of unlinked urbs */ 80 char *syncbuf; /* sync buffer for all sync URBs */ 81 dma_addr_t sync_dma; /* DMA address of syncbuf */ 82 83 unsigned int pipe; /* the data i/o pipe */ 84 unsigned int freqn; /* nominal sampling rate in fs/fps in Q16.16 format */ 85 unsigned int freqm; /* momentary sampling rate in fs/fps in Q16.16 format */ 86 int freqshift; /* how much to shift the feedback value to get Q16.16 */ 87 unsigned int freqmax; /* maximum sampling rate, used for buffer management */ 88 unsigned int phase; /* phase accumulator */ 89 unsigned int maxpacksize; /* max packet size in bytes */ 90 unsigned int maxframesize; /* max packet size in frames */ 91 unsigned int max_urb_frames; /* max URB size in frames */ 92 unsigned int curpacksize; /* current packet size in bytes (for capture) */ 93 unsigned int curframesize; /* current packet size in frames (for capture) */ 94 unsigned int syncmaxsize; /* sync endpoint packet size */ 95 unsigned int fill_max:1; /* fill max packet size always */ 96 unsigned int tenor_fb_quirk:1; /* corrupted feedback data */ 97 unsigned int datainterval; /* log_2 of data packet interval */ 98 unsigned int syncinterval; /* P for adaptive mode, 0 otherwise */ 99 unsigned char silence_value; 100 unsigned int stride; 101 int iface, altsetting; 102 int skip_packets; /* quirks for devices to ignore the first n packets 103 in a stream */ 104 105 spinlock_t lock; 106 struct list_head list; 107 }; 108 109 struct snd_usb_substream { 110 struct snd_usb_stream *stream; 111 struct usb_device *dev; 112 struct snd_pcm_substream *pcm_substream; 113 int direction; /* playback or capture */ 114 int interface; /* current interface */ 115 int endpoint; /* assigned endpoint */ 116 struct audioformat *cur_audiofmt; /* current audioformat pointer (for hw_params callback) */ 117 snd_pcm_format_t pcm_format; /* current audio format (for hw_params callback) */ 118 unsigned int channels; /* current number of channels (for hw_params callback) */ 119 unsigned int channels_max; /* max channels in the all audiofmts */ 120 unsigned int cur_rate; /* current rate (for hw_params callback) */ 121 unsigned int period_bytes; /* current period bytes (for hw_params callback) */ 122 unsigned int period_frames; /* current frames per period */ 123 unsigned int buffer_periods; /* current periods per buffer */ 124 unsigned int altset_idx; /* USB data format: index of alternate setting */ 125 unsigned int txfr_quirk:1; /* allow sub-frame alignment */ 126 unsigned int tx_length_quirk:1; /* add length specifier to transfers */ 127 unsigned int fmt_type; /* USB audio format type (1-3) */ 128 unsigned int pkt_offset_adj; /* Bytes to drop from beginning of packets (for non-compliant devices) */ 129 130 unsigned int running: 1; /* running status */ 131 132 unsigned int hwptr_done; /* processed byte position in the buffer */ 133 unsigned int transfer_done; /* processed frames since last period update */ 134 unsigned int frame_limit; /* limits number of packets in URB */ 135 136 /* data and sync endpoints for this stream */ 137 unsigned int ep_num; /* the endpoint number */ 138 struct snd_usb_endpoint *data_endpoint; 139 struct snd_usb_endpoint *sync_endpoint; 140 unsigned long flags; 141 bool need_setup_ep; /* (re)configure EP at prepare? */ 142 unsigned int speed; /* USB_SPEED_XXX */ 143 144 u64 formats; /* format bitmasks (all or'ed) */ 145 unsigned int num_formats; /* number of supported audio formats (list) */ 146 struct list_head fmt_list; /* format list */ 147 struct snd_pcm_hw_constraint_list rate_list; /* limited rates */ 148 spinlock_t lock; 149 150 int last_frame_number; /* stored frame number */ 151 int last_delay; /* stored delay */ 152 153 struct { 154 int marker; 155 int channel; 156 int byte_idx; 157 } dsd_dop; 158 159 bool trigger_tstamp_pending_update; /* trigger timestamp being updated from initial estimate */ 160 }; 161 162 struct snd_usb_stream { 163 struct snd_usb_audio *chip; 164 struct snd_pcm *pcm; 165 int pcm_index; 166 unsigned int fmt_type; /* USB audio format type (1-3) */ 167 struct snd_usb_substream substream[2]; 168 struct list_head list; 169 }; 170 171 #endif /* __USBAUDIO_CARD_H */ 172