blob: 814cb357ff88235dd87f37425985602867e3f5d5 [file] [log] [blame]
Daniel Macke5779992010-03-04 19:46:13 +01001#ifndef __USBAUDIO_CARD_H
2#define __USBAUDIO_CARD_H
3
Xi Wang8866f402012-02-14 05:18:48 -05004#define MAX_NR_RATES 1024
Daniel Macke5779992010-03-04 19:46:13 +01005#define MAX_PACKS 20
6#define MAX_PACKS_HS (MAX_PACKS * 8) /* in high speed mode */
7#define MAX_URBS 8
8#define SYNC_URBS 4 /* always four urbs for sync */
9#define MAX_QUEUE 24 /* try not to exceed this queue length, in ms */
10
11struct audioformat {
12 struct list_head list;
Clemens Ladisch015eb0b2010-03-04 19:46:15 +010013 u64 formats; /* ALSA format bits */
Daniel Macke5779992010-03-04 19:46:13 +010014 unsigned int channels; /* # channels */
15 unsigned int fmt_type; /* USB audio format type (1-3) */
16 unsigned int frame_size; /* samples per frame for non-audio */
17 int iface; /* interface number */
18 unsigned char altsetting; /* corresponding alternate setting */
19 unsigned char altset_idx; /* array index of altenate setting */
20 unsigned char attributes; /* corresponding attributes of cs endpoint */
21 unsigned char endpoint; /* endpoint */
22 unsigned char ep_attr; /* endpoint attributes */
23 unsigned char datainterval; /* log_2 of data packet interval */
24 unsigned int maxpacksize; /* max. packet size */
25 unsigned int rates; /* rate bitmasks */
26 unsigned int rate_min, rate_max; /* min/max rates */
27 unsigned int nr_rates; /* number of rate table entries */
28 unsigned int *rate_table; /* rate table */
Daniel Mack79f920f2010-05-31 14:51:31 +020029 unsigned char clock; /* associated clock */
Daniel Macke5779992010-03-04 19:46:13 +010030};
31
32struct snd_usb_substream;
Daniel Mack8fdff6a2012-04-12 13:51:11 +020033struct snd_usb_endpoint;
Daniel Macke5779992010-03-04 19:46:13 +010034
35struct snd_urb_ctx {
36 struct urb *urb;
37 unsigned int buffer_size; /* size of data buffer, if data URB */
38 struct snd_usb_substream *subs;
Daniel Mack8fdff6a2012-04-12 13:51:11 +020039 struct snd_usb_endpoint *ep;
Daniel Macke5779992010-03-04 19:46:13 +010040 int index; /* index for urb array */
41 int packets; /* number of packets per urb */
Daniel Mack8fdff6a2012-04-12 13:51:11 +020042 int packet_size[MAX_PACKS_HS]; /* size of packets for next submission */
43 struct list_head ready_list;
Daniel Macke5779992010-03-04 19:46:13 +010044};
45
Daniel Mack8fdff6a2012-04-12 13:51:11 +020046struct snd_usb_endpoint {
47 struct snd_usb_audio *chip;
48
49 int use_count;
50 int ep_num; /* the referenced endpoint number */
51 int type; /* SND_USB_ENDPOINT_TYPE_* */
52 unsigned long flags;
53
54 void (*prepare_data_urb) (struct snd_usb_substream *subs,
55 struct urb *urb);
56 void (*retire_data_urb) (struct snd_usb_substream *subs,
57 struct urb *urb);
58
59 struct snd_usb_substream *data_subs;
60 struct snd_usb_endpoint *sync_master;
61 struct snd_usb_endpoint *sync_slave;
62
63 struct snd_urb_ctx urb[MAX_URBS];
64
65 struct snd_usb_packet_info {
66 uint32_t packet_size[MAX_PACKS_HS];
67 int packets;
68 } next_packet[MAX_URBS];
69 int next_packet_read_pos, next_packet_write_pos;
70 struct list_head ready_playback_urbs;
71
72 unsigned int nurbs; /* # urbs */
73 unsigned long active_mask; /* bitmask of active urbs */
74 unsigned long unlink_mask; /* bitmask of unlinked urbs */
75 char *syncbuf; /* sync buffer for all sync URBs */
76 dma_addr_t sync_dma; /* DMA address of syncbuf */
77
78 unsigned int pipe; /* the data i/o pipe */
79 unsigned int freqn; /* nominal sampling rate in fs/fps in Q16.16 format */
80 unsigned int freqm; /* momentary sampling rate in fs/fps in Q16.16 format */
81 int freqshift; /* how much to shift the feedback value to get Q16.16 */
82 unsigned int freqmax; /* maximum sampling rate, used for buffer management */
83 unsigned int phase; /* phase accumulator */
84 unsigned int maxpacksize; /* max packet size in bytes */
85 unsigned int maxframesize; /* max packet size in frames */
86 unsigned int curpacksize; /* current packet size in bytes (for capture) */
87 unsigned int curframesize; /* current packet size in frames (for capture) */
88 unsigned int syncmaxsize; /* sync endpoint packet size */
89 unsigned int fill_max:1; /* fill max packet size always */
90 unsigned int datainterval; /* log_2 of data packet interval */
91 unsigned int syncinterval; /* P for adaptive mode, 0 otherwise */
92 unsigned char silence_value;
93 unsigned int stride;
94 int iface, alt_idx;
Daniel Mack2b58fd52012-09-04 10:23:07 +020095 int skip_packets; /* quirks for devices to ignore the first n packets
96 in a stream */
Daniel Mack8fdff6a2012-04-12 13:51:11 +020097
98 spinlock_t lock;
99 struct list_head list;
100};
101
Daniel Macke5779992010-03-04 19:46:13 +0100102struct snd_usb_substream {
103 struct snd_usb_stream *stream;
104 struct usb_device *dev;
105 struct snd_pcm_substream *pcm_substream;
106 int direction; /* playback or capture */
107 int interface; /* current interface */
108 int endpoint; /* assigned endpoint */
109 struct audioformat *cur_audiofmt; /* current audioformat pointer (for hw_params callback) */
Dylan Reid61a70952012-09-18 09:49:48 -0700110 snd_pcm_format_t pcm_format; /* current audio format (for hw_params callback) */
111 unsigned int channels; /* current number of channels (for hw_params callback) */
Daniel Macke5779992010-03-04 19:46:13 +0100112 unsigned int cur_rate; /* current rate (for hw_params callback) */
113 unsigned int period_bytes; /* current period bytes (for hw_params callback) */
Clemens Ladische11b4e02010-03-04 19:46:14 +0100114 unsigned int altset_idx; /* USB data format: index of alternate setting */
Daniel Macke5779992010-03-04 19:46:13 +0100115 unsigned int txfr_quirk:1; /* allow sub-frame alignment */
116 unsigned int fmt_type; /* USB audio format type (1-3) */
117
118 unsigned int running: 1; /* running status */
119
120 unsigned int hwptr_done; /* processed byte position in the buffer */
121 unsigned int transfer_done; /* processed frames since last period update */
Daniel Macke5779992010-03-04 19:46:13 +0100122
Daniel Mackedcd3632012-04-12 13:51:12 +0200123 /* data and sync endpoints for this stream */
Takashi Iwai8260ef02012-06-08 09:01:37 +0200124 unsigned int ep_num; /* the endpoint number */
Daniel Mackedcd3632012-04-12 13:51:12 +0200125 struct snd_usb_endpoint *data_endpoint;
126 struct snd_usb_endpoint *sync_endpoint;
127 unsigned long flags;
Takashi Iwai384dc0852012-09-18 14:49:31 +0200128 bool need_setup_ep; /* (re)configure EP at prepare? */
Takashi Iwai978520b2012-10-12 15:12:55 +0200129 unsigned int speed; /* USB_SPEED_XXX */
Daniel Macke5779992010-03-04 19:46:13 +0100130
131 u64 formats; /* format bitmasks (all or'ed) */
132 unsigned int num_formats; /* number of supported audio formats (list) */
133 struct list_head fmt_list; /* format list */
134 struct snd_pcm_hw_constraint_list rate_list; /* limited rates */
135 spinlock_t lock;
136
Pierre-Louis Bossart294c4fb2011-09-06 19:15:34 -0500137 int last_frame_number; /* stored frame number */
138 int last_delay; /* stored delay */
Daniel Macke5779992010-03-04 19:46:13 +0100139};
140
141struct snd_usb_stream {
142 struct snd_usb_audio *chip;
143 struct snd_pcm *pcm;
144 int pcm_index;
145 unsigned int fmt_type; /* USB audio format type (1-3) */
146 struct snd_usb_substream substream[2];
147 struct list_head list;
148};
149
150#endif /* __USBAUDIO_CARD_H */