1 /* SPDX-License-Identifier: GPL-2.0 */ 1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __USBAUDIO_CARD_H 2 #ifndef __USBAUDIO_CARD_H
3 #define __USBAUDIO_CARD_H 3 #define __USBAUDIO_CARD_H
4 4
5 #define MAX_NR_RATES 1024 5 #define MAX_NR_RATES 1024
6 #define MAX_PACKS 6 /* per 6 #define MAX_PACKS 6 /* per URB */
7 #define MAX_PACKS_HS (MAX_PACKS * 8) /* in 7 #define MAX_PACKS_HS (MAX_PACKS * 8) /* in high speed mode */
8 #define MAX_URBS 12 8 #define MAX_URBS 12
9 #define SYNC_URBS 4 /* always four 9 #define SYNC_URBS 4 /* always four urbs for sync */
10 #define MAX_QUEUE 18 /* try not to 10 #define MAX_QUEUE 18 /* try not to exceed this queue length, in ms */
11 11
12 struct audioformat { 12 struct audioformat {
13 struct list_head list; 13 struct list_head list;
14 u64 formats; /* ALS 14 u64 formats; /* ALSA format bits */
15 unsigned int channels; /* # c 15 unsigned int channels; /* # channels */
16 unsigned int fmt_type; /* USB 16 unsigned int fmt_type; /* USB audio format type (1-3) */
17 unsigned int fmt_bits; /* num 17 unsigned int fmt_bits; /* number of significant bits */
18 unsigned int frame_size; /* sam 18 unsigned int frame_size; /* samples per frame for non-audio */
19 unsigned char iface; /* int 19 unsigned char iface; /* interface number */
20 unsigned char altsetting; /* cor 20 unsigned char altsetting; /* corresponding alternate setting */
21 unsigned char ep_idx; /* end 21 unsigned char ep_idx; /* endpoint array index */
22 unsigned char altset_idx; /* arr 22 unsigned char altset_idx; /* array index of alternate setting */
23 unsigned char attributes; /* cor 23 unsigned char attributes; /* corresponding attributes of cs endpoint */
24 unsigned char endpoint; /* end 24 unsigned char endpoint; /* endpoint */
25 unsigned char ep_attr; /* end 25 unsigned char ep_attr; /* endpoint attributes */
26 bool implicit_fb; /* imp 26 bool implicit_fb; /* implicit feedback endpoint */
27 unsigned char sync_ep; /* syn 27 unsigned char sync_ep; /* sync endpoint number */
28 unsigned char sync_iface; /* syn 28 unsigned char sync_iface; /* sync EP interface */
29 unsigned char sync_altsetting; /* syn 29 unsigned char sync_altsetting; /* sync EP alternate setting */
30 unsigned char sync_ep_idx; /* syn 30 unsigned char sync_ep_idx; /* sync EP array index */
31 unsigned char datainterval; /* log 31 unsigned char datainterval; /* log_2 of data packet interval */
32 unsigned char protocol; /* UAC 32 unsigned char protocol; /* UAC_VERSION_1/2/3 */
33 unsigned int maxpacksize; /* max 33 unsigned int maxpacksize; /* max. packet size */
34 unsigned int rates; /* rat 34 unsigned int rates; /* rate bitmasks */
35 unsigned int rate_min, rate_max; 35 unsigned int rate_min, rate_max; /* min/max rates */
36 unsigned int nr_rates; /* num 36 unsigned int nr_rates; /* number of rate table entries */
37 unsigned int *rate_table; /* rat 37 unsigned int *rate_table; /* rate table */
38 unsigned char clock; /* ass 38 unsigned char clock; /* associated clock */
39 struct snd_pcm_chmap_elem *chmap; /* ( 39 struct snd_pcm_chmap_elem *chmap; /* (optional) channel map */
40 bool dsd_dop; /* add 40 bool dsd_dop; /* add DOP headers in case of DSD samples */
41 bool dsd_bitrev; /* rev 41 bool dsd_bitrev; /* reverse the bits of each DSD sample */
42 bool dsd_raw; /* alt 42 bool dsd_raw; /* altsetting is raw DSD */
43 }; 43 };
44 44
45 struct snd_usb_substream; 45 struct snd_usb_substream;
46 struct snd_usb_iface_ref; 46 struct snd_usb_iface_ref;
47 struct snd_usb_clock_ref; 47 struct snd_usb_clock_ref;
48 struct snd_usb_endpoint; 48 struct snd_usb_endpoint;
49 struct snd_usb_power_domain; 49 struct snd_usb_power_domain;
50 50
51 struct snd_urb_ctx { 51 struct snd_urb_ctx {
52 struct urb *urb; 52 struct urb *urb;
53 unsigned int buffer_size; /* siz 53 unsigned int buffer_size; /* size of data buffer, if data URB */
54 struct snd_usb_substream *subs; 54 struct snd_usb_substream *subs;
55 struct snd_usb_endpoint *ep; 55 struct snd_usb_endpoint *ep;
56 int index; /* index for urb array 56 int index; /* index for urb array */
57 int packets; /* number of packets p 57 int packets; /* number of packets per urb */
58 int queued; /* queued data bytes b 58 int queued; /* queued data bytes by this urb */
59 int packet_size[MAX_PACKS_HS]; /* size 59 int packet_size[MAX_PACKS_HS]; /* size of packets for next submission */
60 struct list_head ready_list; 60 struct list_head ready_list;
61 }; 61 };
62 62
63 struct snd_usb_endpoint { 63 struct snd_usb_endpoint {
64 struct snd_usb_audio *chip; 64 struct snd_usb_audio *chip;
65 struct snd_usb_iface_ref *iface_ref; 65 struct snd_usb_iface_ref *iface_ref;
66 struct snd_usb_clock_ref *clock_ref; 66 struct snd_usb_clock_ref *clock_ref;
67 67
68 int opened; /* open refcou 68 int opened; /* open refcount; protect with chip->mutex */
69 atomic_t running; /* running sta 69 atomic_t running; /* running status */
70 int ep_num; /* the referen 70 int ep_num; /* the referenced endpoint number */
71 int type; /* SND_USB_END 71 int type; /* SND_USB_ENDPOINT_TYPE_* */
72 72
73 unsigned char iface; /* int 73 unsigned char iface; /* interface number */
74 unsigned char altsetting; /* cor 74 unsigned char altsetting; /* corresponding alternate setting */
75 unsigned char ep_idx; /* end 75 unsigned char ep_idx; /* endpoint array index */
76 76
77 atomic_t state; /* running sta 77 atomic_t state; /* running state */
78 78
79 int (*prepare_data_urb) (struct snd_us 79 int (*prepare_data_urb) (struct snd_usb_substream *subs,
80 struct urb *u 80 struct urb *urb,
81 bool in_strea 81 bool in_stream_lock);
82 void (*retire_data_urb) (struct snd_us 82 void (*retire_data_urb) (struct snd_usb_substream *subs,
83 struct urb *u 83 struct urb *urb);
84 84
85 struct snd_usb_substream *data_subs; 85 struct snd_usb_substream *data_subs;
86 struct snd_usb_endpoint *sync_source; 86 struct snd_usb_endpoint *sync_source;
87 struct snd_usb_endpoint *sync_sink; 87 struct snd_usb_endpoint *sync_sink;
88 88
89 struct snd_urb_ctx urb[MAX_URBS]; 89 struct snd_urb_ctx urb[MAX_URBS];
90 90
91 struct snd_usb_packet_info { 91 struct snd_usb_packet_info {
92 uint32_t packet_size[MAX_PACKS 92 uint32_t packet_size[MAX_PACKS_HS];
93 int packets; 93 int packets;
94 } next_packet[MAX_URBS]; 94 } next_packet[MAX_URBS];
95 unsigned int next_packet_head; /* rin 95 unsigned int next_packet_head; /* ring buffer offset to read */
96 unsigned int next_packet_queued; /* qu 96 unsigned int next_packet_queued; /* queued items in the ring buffer */
97 struct list_head ready_playback_urbs; 97 struct list_head ready_playback_urbs; /* playback URB FIFO for implicit fb */
98 98
99 unsigned int nurbs; /* # u 99 unsigned int nurbs; /* # urbs */
100 unsigned long active_mask; /* bit 100 unsigned long active_mask; /* bitmask of active urbs */
101 unsigned long unlink_mask; /* bit 101 unsigned long unlink_mask; /* bitmask of unlinked urbs */
102 atomic_t submitted_urbs; /* cur 102 atomic_t submitted_urbs; /* currently submitted urbs */
103 char *syncbuf; /* syn 103 char *syncbuf; /* sync buffer for all sync URBs */
104 dma_addr_t sync_dma; /* DMA 104 dma_addr_t sync_dma; /* DMA address of syncbuf */
105 105
106 unsigned int pipe; /* the 106 unsigned int pipe; /* the data i/o pipe */
107 unsigned int packsize[2]; /* sma 107 unsigned int packsize[2]; /* small/large packet sizes in samples */
108 unsigned int sample_rem; /* rem 108 unsigned int sample_rem; /* remainder from division fs/pps */
109 unsigned int sample_accum; /* sam 109 unsigned int sample_accum; /* sample accumulator */
110 unsigned int pps; /* pac 110 unsigned int pps; /* packets per second */
111 unsigned int freqn; /* nom 111 unsigned int freqn; /* nominal sampling rate in fs/fps in Q16.16 format */
112 unsigned int freqm; /* mom 112 unsigned int freqm; /* momentary sampling rate in fs/fps in Q16.16 format */
113 int freqshift; /* how 113 int freqshift; /* how much to shift the feedback value to get Q16.16 */
114 unsigned int freqmax; /* max 114 unsigned int freqmax; /* maximum sampling rate, used for buffer management */
115 unsigned int phase; /* pha 115 unsigned int phase; /* phase accumulator */
116 unsigned int maxpacksize; /* max 116 unsigned int maxpacksize; /* max packet size in bytes */
117 unsigned int maxframesize; /* max 117 unsigned int maxframesize; /* max packet size in frames */
118 unsigned int max_urb_frames; /* max 118 unsigned int max_urb_frames; /* max URB size in frames */
119 unsigned int curpacksize; /* cur 119 unsigned int curpacksize; /* current packet size in bytes (for capture) */
120 unsigned int curframesize; /* cur 120 unsigned int curframesize; /* current packet size in frames (for capture) */
121 unsigned int syncmaxsize; /* syn 121 unsigned int syncmaxsize; /* sync endpoint packet size */
122 unsigned int fill_max:1; /* fil 122 unsigned int fill_max:1; /* fill max packet size always */
123 unsigned int tenor_fb_quirk:1; /* cor 123 unsigned int tenor_fb_quirk:1; /* corrupted feedback data */
124 unsigned int datainterval; /* log 124 unsigned int datainterval; /* log_2 of data packet interval */
125 unsigned int syncinterval; /* P f 125 unsigned int syncinterval; /* P for adaptive mode, 0 otherwise */
126 unsigned char silence_value; 126 unsigned char silence_value;
127 unsigned int stride; 127 unsigned int stride;
128 int skip_packets; /* qui 128 int skip_packets; /* quirks for devices to ignore the first n packets
129 in 129 in a stream */
130 bool implicit_fb_sync; /* syn 130 bool implicit_fb_sync; /* syncs with implicit feedback */
131 bool lowlatency_playback; /* low 131 bool lowlatency_playback; /* low-latency playback mode */
132 bool need_setup; /* (re 132 bool need_setup; /* (re-)need for hw_params? */
133 bool need_prepare; /* (re 133 bool need_prepare; /* (re-)need for prepare? */
134 bool fixed_rate; /* ski 134 bool fixed_rate; /* skip rate setup */
135 135
136 /* for hw constraints */ 136 /* for hw constraints */
137 const struct audioformat *cur_audiofmt 137 const struct audioformat *cur_audiofmt;
138 unsigned int cur_rate; 138 unsigned int cur_rate;
139 snd_pcm_format_t cur_format; 139 snd_pcm_format_t cur_format;
140 unsigned int cur_channels; 140 unsigned int cur_channels;
141 unsigned int cur_frame_bytes; 141 unsigned int cur_frame_bytes;
142 unsigned int cur_period_frames; 142 unsigned int cur_period_frames;
143 unsigned int cur_period_bytes; 143 unsigned int cur_period_bytes;
144 unsigned int cur_buffer_periods; 144 unsigned int cur_buffer_periods;
145 145
146 spinlock_t lock; 146 spinlock_t lock;
147 struct list_head list; 147 struct list_head list;
148 }; 148 };
149 149
150 struct media_ctl; 150 struct media_ctl;
151 151
152 struct snd_usb_substream { 152 struct snd_usb_substream {
153 struct snd_usb_stream *stream; 153 struct snd_usb_stream *stream;
154 struct usb_device *dev; 154 struct usb_device *dev;
155 struct snd_pcm_substream *pcm_substrea 155 struct snd_pcm_substream *pcm_substream;
156 int direction; /* playback or capture 156 int direction; /* playback or capture */
157 int endpoint; /* assigned endpoint * 157 int endpoint; /* assigned endpoint */
158 const struct audioformat *cur_audiofmt 158 const struct audioformat *cur_audiofmt; /* current audioformat pointer (for hw_params callback) */
159 struct snd_usb_power_domain *str_pd; 159 struct snd_usb_power_domain *str_pd; /* UAC3 Power Domain for streaming path */
160 unsigned int channels_max; /* max 160 unsigned int channels_max; /* max channels in the all audiofmts */
161 unsigned int txfr_quirk:1; /* all 161 unsigned int txfr_quirk:1; /* allow sub-frame alignment */
162 unsigned int tx_length_quirk:1; /* add 162 unsigned int tx_length_quirk:1; /* add length specifier to transfers */
163 unsigned int fmt_type; /* USB 163 unsigned int fmt_type; /* USB audio format type (1-3) */
164 unsigned int pkt_offset_adj; /* Byt 164 unsigned int pkt_offset_adj; /* Bytes to drop from beginning of packets (for non-compliant devices) */
165 unsigned int stream_offset_adj; /* Byt 165 unsigned int stream_offset_adj; /* Bytes to drop from beginning of stream (for non-compliant devices) */
166 166
167 unsigned int running: 1; /* run 167 unsigned int running: 1; /* running status */
168 unsigned int period_elapsed_pending; 168 unsigned int period_elapsed_pending; /* delay period handling */
169 169
170 unsigned int buffer_bytes; /* buf 170 unsigned int buffer_bytes; /* buffer size in bytes */
171 unsigned int inflight_bytes; /* in- 171 unsigned int inflight_bytes; /* in-flight data bytes on buffer (for playback) */
172 unsigned int hwptr_done; /* pro 172 unsigned int hwptr_done; /* processed byte position in the buffer */
173 unsigned int transfer_done; /* pro 173 unsigned int transfer_done; /* processed frames since last period update */
174 unsigned int frame_limit; /* lim 174 unsigned int frame_limit; /* limits number of packets in URB */
175 175
176 /* data and sync endpoints for this st 176 /* data and sync endpoints for this stream */
177 unsigned int ep_num; /* the 177 unsigned int ep_num; /* the endpoint number */
178 struct snd_usb_endpoint *data_endpoint 178 struct snd_usb_endpoint *data_endpoint;
179 struct snd_usb_endpoint *sync_endpoint 179 struct snd_usb_endpoint *sync_endpoint;
180 unsigned long flags; 180 unsigned long flags;
181 unsigned int speed; /* USB 181 unsigned int speed; /* USB_SPEED_XXX */
182 182
183 u64 formats; /* for 183 u64 formats; /* format bitmasks (all or'ed) */
184 unsigned int num_formats; 184 unsigned int num_formats; /* number of supported audio formats (list) */
185 struct list_head fmt_list; /* for 185 struct list_head fmt_list; /* format list */
186 spinlock_t lock; 186 spinlock_t lock;
187 187
188 unsigned int last_frame_number; /* sto 188 unsigned int last_frame_number; /* stored frame number */
189 189
190 struct { 190 struct {
191 int marker; 191 int marker;
192 int channel; 192 int channel;
193 int byte_idx; 193 int byte_idx;
194 } dsd_dop; 194 } dsd_dop;
195 195
196 bool trigger_tstamp_pending_update; /* 196 bool trigger_tstamp_pending_update; /* trigger timestamp being updated from initial estimate */
197 bool lowlatency_playback; /* low 197 bool lowlatency_playback; /* low-latency playback mode */
198 struct media_ctl *media_ctl; 198 struct media_ctl *media_ctl;
199 }; 199 };
200 200
201 struct snd_usb_stream { 201 struct snd_usb_stream {
202 struct snd_usb_audio *chip; 202 struct snd_usb_audio *chip;
203 struct snd_pcm *pcm; 203 struct snd_pcm *pcm;
204 int pcm_index; 204 int pcm_index;
205 unsigned int fmt_type; /* USB 205 unsigned int fmt_type; /* USB audio format type (1-3) */
206 struct snd_usb_substream substream[2]; 206 struct snd_usb_substream substream[2];
207 struct list_head list; 207 struct list_head list;
208 }; 208 };
209 209
210 #endif /* __USBAUDIO_CARD_H */ 210 #endif /* __USBAUDIO_CARD_H */
211 211
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.