card.h 7.99 KB
Newer Older
1
/* SPDX-License-Identifier: GPL-2.0 */
Daniel Mack's avatar
Daniel Mack committed
2
3
4
#ifndef __USBAUDIO_CARD_H
#define __USBAUDIO_CARD_H

5
#define MAX_NR_RATES	1024
6
#define MAX_PACKS	6		/* per URB */
Daniel Mack's avatar
Daniel Mack committed
7
#define MAX_PACKS_HS	(MAX_PACKS * 8)	/* in high speed mode */
8
#define MAX_URBS	12
Daniel Mack's avatar
Daniel Mack committed
9
#define SYNC_URBS	4	/* always four urbs for sync */
10
#define MAX_QUEUE	18	/* try not to exceed this queue length, in ms */
Daniel Mack's avatar
Daniel Mack committed
11
12
13

struct audioformat {
	struct list_head list;
14
	u64 formats;			/* ALSA format bits */
Daniel Mack's avatar
Daniel Mack committed
15
16
	unsigned int channels;		/* # channels */
	unsigned int fmt_type;		/* USB audio format type (1-3) */
17
	unsigned int fmt_bits;		/* number of significant bits */
Daniel Mack's avatar
Daniel Mack committed
18
	unsigned int frame_size;	/* samples per frame for non-audio */
19
	unsigned char iface;		/* interface number */
Daniel Mack's avatar
Daniel Mack committed
20
	unsigned char altsetting;	/* corresponding alternate setting */
21
	unsigned char ep_idx;		/* endpoint array index */
22
	unsigned char altset_idx;	/* array index of alternate setting */
Daniel Mack's avatar
Daniel Mack committed
23
24
25
	unsigned char attributes;	/* corresponding attributes of cs endpoint */
	unsigned char endpoint;		/* endpoint */
	unsigned char ep_attr;		/* endpoint attributes */
26
27
28
29
	bool implicit_fb;		/* implicit feedback endpoint */
	unsigned char sync_ep;		/* sync endpoint number */
	unsigned char sync_iface;	/* sync EP interface */
	unsigned char sync_altsetting;	/* sync EP alternate setting */
30
	unsigned char sync_ep_idx;	/* sync EP array index */
Daniel Mack's avatar
Daniel Mack committed
31
	unsigned char datainterval;	/* log_2 of data packet interval */
32
	unsigned char protocol;		/* UAC_VERSION_1/2/3 */
Daniel Mack's avatar
Daniel Mack committed
33
34
35
36
37
	unsigned int maxpacksize;	/* max. packet size */
	unsigned int rates;		/* rate bitmasks */
	unsigned int rate_min, rate_max;	/* min/max rates */
	unsigned int nr_rates;		/* number of rate table entries */
	unsigned int *rate_table;	/* rate table */
38
	unsigned char clock;		/* associated clock */
39
	struct snd_pcm_chmap_elem *chmap; /* (optional) channel map */
40
	bool dsd_dop;			/* add DOP headers in case of DSD samples */
41
	bool dsd_bitrev;		/* reverse the bits of each DSD sample */
42
	bool dsd_raw;			/* altsetting is raw DSD */
Daniel Mack's avatar
Daniel Mack committed
43
44
45
};

struct snd_usb_substream;
46
struct snd_usb_iface_ref;
47
struct snd_usb_endpoint;
48
struct snd_usb_power_domain;
Daniel Mack's avatar
Daniel Mack committed
49
50
51
52
53

struct snd_urb_ctx {
	struct urb *urb;
	unsigned int buffer_size;	/* size of data buffer, if data URB */
	struct snd_usb_substream *subs;
54
	struct snd_usb_endpoint *ep;
Daniel Mack's avatar
Daniel Mack committed
55
56
	int index;	/* index for urb array */
	int packets;	/* number of packets per urb */
57
	int queued;	/* queued data bytes by this urb */
58
59
	int packet_size[MAX_PACKS_HS]; /* size of packets for next submission */
	struct list_head ready_list;
Daniel Mack's avatar
Daniel Mack committed
60
61
};

62
63
struct snd_usb_endpoint {
	struct snd_usb_audio *chip;
64
	struct snd_usb_iface_ref *iface_ref;
65

66
	int opened;		/* open refcount; protect with chip->mutex */
67
	atomic_t running;	/* running status */
68
69
	int ep_num;		/* the referenced endpoint number */
	int type;		/* SND_USB_ENDPOINT_TYPE_* */
70
71
72
73
74

	unsigned char iface;		/* interface number */
	unsigned char altsetting;	/* corresponding alternate setting */
	unsigned char ep_idx;		/* endpoint array index */

75
	atomic_t state;		/* running state */
76
77
78
79
80
81
82

	void (*prepare_data_urb) (struct snd_usb_substream *subs,
				  struct urb *urb);
	void (*retire_data_urb) (struct snd_usb_substream *subs,
				 struct urb *urb);

	struct snd_usb_substream *data_subs;
83
84
	struct snd_usb_endpoint *sync_source;
	struct snd_usb_endpoint *sync_sink;
85
86
87
88
89
90
91

	struct snd_urb_ctx urb[MAX_URBS];

	struct snd_usb_packet_info {
		uint32_t packet_size[MAX_PACKS_HS];
		int packets;
	} next_packet[MAX_URBS];
92
93
94
	unsigned int next_packet_head;	/* ring buffer offset to read */
	unsigned int next_packet_queued; /* queued items in the ring buffer */
	struct list_head ready_playback_urbs; /* playback URB FIFO for implicit fb */
95
96

	unsigned int nurbs;		/* # urbs */
97
	unsigned int nominal_queue_size; /* total buffer sizes in URBs */
98
99
100
101
102
103
	unsigned long active_mask;	/* bitmask of active urbs */
	unsigned long unlink_mask;	/* bitmask of unlinked urbs */
	char *syncbuf;			/* sync buffer for all sync URBs */
	dma_addr_t sync_dma;		/* DMA address of syncbuf */

	unsigned int pipe;		/* the data i/o pipe */
104
105
	unsigned int packsize[2];	/* small/large packet sizes in samples */
	unsigned int sample_rem;	/* remainder from division fs/pps */
106
	unsigned int sample_accum;	/* sample accumulator */
107
	unsigned int pps;		/* packets per second */
108
109
110
111
112
113
114
	unsigned int freqn;		/* nominal sampling rate in fs/fps in Q16.16 format */
	unsigned int freqm;		/* momentary sampling rate in fs/fps in Q16.16 format */
	int	   freqshift;		/* how much to shift the feedback value to get Q16.16 */
	unsigned int freqmax;		/* maximum sampling rate, used for buffer management */
	unsigned int phase;		/* phase accumulator */
	unsigned int maxpacksize;	/* max packet size in bytes */
	unsigned int maxframesize;      /* max packet size in frames */
115
	unsigned int max_urb_frames;	/* max URB size in frames */
116
117
118
119
	unsigned int curpacksize;	/* current packet size in bytes (for capture) */
	unsigned int curframesize;      /* current packet size in frames (for capture) */
	unsigned int syncmaxsize;	/* sync endpoint packet size */
	unsigned int fill_max:1;	/* fill max packet size always */
120
	unsigned int tenor_fb_quirk:1;	/* corrupted feedback data */
121
122
123
124
	unsigned int datainterval;      /* log_2 of data packet interval */
	unsigned int syncinterval;	/* P for adaptive mode, 0 otherwise */
	unsigned char silence_value;
	unsigned int stride;
125
126
	int skip_packets;		/* quirks for devices to ignore the first n packets
					   in a stream */
127
128
	bool implicit_fb_sync;		/* syncs with implicit feedback */
	bool need_setup;		/* (re-)need for configure? */
129

130
	/* for hw constraints */
131
	const struct audioformat *cur_audiofmt;
132
133
134
	unsigned int cur_rate;
	snd_pcm_format_t cur_format;
	unsigned int cur_channels;
135
	unsigned int cur_frame_bytes;
136
137
138
139
	unsigned int cur_period_frames;
	unsigned int cur_period_bytes;
	unsigned int cur_buffer_periods;

140
141
142
143
	spinlock_t lock;
	struct list_head list;
};

144
145
struct media_ctl;

Daniel Mack's avatar
Daniel Mack committed
146
147
148
149
150
151
struct snd_usb_substream {
	struct snd_usb_stream *stream;
	struct usb_device *dev;
	struct snd_pcm_substream *pcm_substream;
	int direction;	/* playback or capture */
	int endpoint;	/* assigned endpoint */
152
	const struct audioformat *cur_audiofmt;	/* current audioformat pointer (for hw_params callback) */
153
	struct snd_usb_power_domain *str_pd;	/* UAC3 Power Domain for streaming path */
154
	unsigned int channels_max;	/* max channels in the all audiofmts */
Daniel Mack's avatar
Daniel Mack committed
155
	unsigned int txfr_quirk:1;	/* allow sub-frame alignment */
156
	unsigned int tx_length_quirk:1;	/* add length specifier to transfers */
Daniel Mack's avatar
Daniel Mack committed
157
	unsigned int fmt_type;		/* USB audio format type (1-3) */
158
	unsigned int pkt_offset_adj;	/* Bytes to drop from beginning of packets (for non-compliant devices) */
159
	unsigned int stream_offset_adj;	/* Bytes to drop from beginning of stream (for non-compliant devices) */
Daniel Mack's avatar
Daniel Mack committed
160
161

	unsigned int running: 1;	/* running status */
162
	unsigned int period_elapsed_pending;	/* delay period handling */
Daniel Mack's avatar
Daniel Mack committed
163

164
	unsigned int buffer_bytes;	/* buffer size in bytes */
165
	unsigned int inflight_bytes;	/* in-flight data bytes on buffer (for playback) */
Daniel Mack's avatar
Daniel Mack committed
166
	unsigned int hwptr_done;	/* processed byte position in the buffer */
167
	unsigned int transfer_done;	/* processed frames since last period update */
168
	unsigned int frame_limit;	/* limits number of packets in URB */
Daniel Mack's avatar
Daniel Mack committed
169

170
	/* data and sync endpoints for this stream */
171
	unsigned int ep_num;		/* the endpoint number */
172
173
174
	struct snd_usb_endpoint *data_endpoint;
	struct snd_usb_endpoint *sync_endpoint;
	unsigned long flags;
175
	unsigned int speed;		/* USB_SPEED_XXX */
Daniel Mack's avatar
Daniel Mack committed
176
177
178
179
180
181

	u64 formats;			/* format bitmasks (all or'ed) */
	unsigned int num_formats;		/* number of supported audio formats (list) */
	struct list_head fmt_list;	/* format list */
	spinlock_t lock;

182
	unsigned int last_frame_number;	/* stored frame number */
183
184
185
186
187
188

	struct {
		int marker;
		int channel;
		int byte_idx;
	} dsd_dop;
189
190

	bool trigger_tstamp_pending_update; /* trigger timestamp being updated from initial estimate */
191
	bool early_playback_start;	/* early start needed for playback? */
192
	struct media_ctl *media_ctl;
Daniel Mack's avatar
Daniel Mack committed
193
194
195
196
197
198
199
200
201
202
203
204
};

struct snd_usb_stream {
	struct snd_usb_audio *chip;
	struct snd_pcm *pcm;
	int pcm_index;
	unsigned int fmt_type;		/* USB audio format type (1-3) */
	struct snd_usb_substream substream[2];
	struct list_head list;
};

#endif /* __USBAUDIO_CARD_H */