blob: d32ea411545a2ccccccfe100bdebb801c2fa1979 [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 */
Takashi Iwai04324cc2012-11-26 16:24:02 +010030 struct snd_pcm_chmap_elem *chmap; /* (optional) channel map */
Daniel Macke5779992010-03-04 19:46:13 +010031};
32
33struct snd_usb_substream;
Daniel Mack8fdff6a2012-04-12 13:51:11 +020034struct snd_usb_endpoint;
Daniel Macke5779992010-03-04 19:46:13 +010035
36struct snd_urb_ctx {
37 struct urb *urb;
38 unsigned int buffer_size; /* size of data buffer, if data URB */
39 struct snd_usb_substream *subs;
Daniel Mack8fdff6a2012-04-12 13:51:11 +020040 struct snd_usb_endpoint *ep;
Daniel Macke5779992010-03-04 19:46:13 +010041 int index; /* index for urb array */
42 int packets; /* number of packets per urb */
Daniel Mack8fdff6a2012-04-12 13:51:11 +020043 int packet_size[MAX_PACKS_HS]; /* size of packets for next submission */
44 struct list_head ready_list;
Daniel Macke5779992010-03-04 19:46:13 +010045};
46
Daniel Mack8fdff6a2012-04-12 13:51:11 +020047struct snd_usb_endpoint {
48 struct snd_usb_audio *chip;
49
50 int use_count;
51 int ep_num; /* the referenced endpoint number */
52 int type; /* SND_USB_ENDPOINT_TYPE_* */
53 unsigned long flags;
54
55 void (*prepare_data_urb) (struct snd_usb_substream *subs,
56 struct urb *urb);
57 void (*retire_data_urb) (struct snd_usb_substream *subs,
58 struct urb *urb);
59
60 struct snd_usb_substream *data_subs;
61 struct snd_usb_endpoint *sync_master;
62 struct snd_usb_endpoint *sync_slave;
63
64 struct snd_urb_ctx urb[MAX_URBS];
65
66 struct snd_usb_packet_info {
67 uint32_t packet_size[MAX_PACKS_HS];
68 int packets;
69 } next_packet[MAX_URBS];
70 int next_packet_read_pos, next_packet_write_pos;
71 struct list_head ready_playback_urbs;
72
73 unsigned int nurbs; /* # urbs */
74 unsigned long active_mask; /* bitmask of active urbs */
75 unsigned long unlink_mask; /* bitmask of unlinked urbs */
76 char *syncbuf; /* sync buffer for all sync URBs */
77 dma_addr_t sync_dma; /* DMA address of syncbuf */
78
79 unsigned int pipe; /* the data i/o pipe */
80 unsigned int freqn; /* nominal sampling rate in fs/fps in Q16.16 format */
81 unsigned int freqm; /* momentary sampling rate in fs/fps in Q16.16 format */
82 int freqshift; /* how much to shift the feedback value to get Q16.16 */
83 unsigned int freqmax; /* maximum sampling rate, used for buffer management */
84 unsigned int phase; /* phase accumulator */
85 unsigned int maxpacksize; /* max packet size in bytes */
86 unsigned int maxframesize; /* max packet size in frames */
87 unsigned int curpacksize; /* current packet size in bytes (for capture) */
88 unsigned int curframesize; /* current packet size in frames (for capture) */
89 unsigned int syncmaxsize; /* sync endpoint packet size */
90 unsigned int fill_max:1; /* fill max packet size always */
91 unsigned int datainterval; /* log_2 of data packet interval */
92 unsigned int syncinterval; /* P for adaptive mode, 0 otherwise */
93 unsigned char silence_value;
94 unsigned int stride;
95 int iface, alt_idx;
Daniel Mack2b58fd52012-09-04 10:23:07 +020096 int skip_packets; /* quirks for devices to ignore the first n packets
97 in a stream */
Daniel Mack8fdff6a2012-04-12 13:51:11 +020098
99 spinlock_t lock;
100 struct list_head list;
101};
102
Daniel Macke5779992010-03-04 19:46:13 +0100103struct snd_usb_substream {
104 struct snd_usb_stream *stream;
105 struct usb_device *dev;
106 struct snd_pcm_substream *pcm_substream;
107 int direction; /* playback or capture */
108 int interface; /* current interface */
109 int endpoint; /* assigned endpoint */
110 struct audioformat *cur_audiofmt; /* current audioformat pointer (for hw_params callback) */
Dylan Reid61a70952012-09-18 09:49:48 -0700111 snd_pcm_format_t pcm_format; /* current audio format (for hw_params callback) */
112 unsigned int channels; /* current number of channels (for hw_params callback) */
Takashi Iwai04324cc2012-11-26 16:24:02 +0100113 unsigned int channels_max; /* max channels in the all audiofmts */
Daniel Macke5779992010-03-04 19:46:13 +0100114 unsigned int cur_rate; /* current rate (for hw_params callback) */
115 unsigned int period_bytes; /* current period bytes (for hw_params callback) */
Clemens Ladische11b4e02010-03-04 19:46:14 +0100116 unsigned int altset_idx; /* USB data format: index of alternate setting */
Daniel Macke5779992010-03-04 19:46:13 +0100117 unsigned int txfr_quirk:1; /* allow sub-frame alignment */
118 unsigned int fmt_type; /* USB audio format type (1-3) */
Calvin Owens1539d4f2013-04-12 22:33:59 -0500119 unsigned int pkt_offset_adj; /* Bytes to drop from beginning of packets (for non-compliant devices) */
Daniel Macke5779992010-03-04 19:46:13 +0100120
121 unsigned int running: 1; /* running status */
122
123 unsigned int hwptr_done; /* processed byte position in the buffer */
124 unsigned int transfer_done; /* processed frames since last period update */
Daniel Macke5779992010-03-04 19:46:13 +0100125
Daniel Mackedcd3632012-04-12 13:51:12 +0200126 /* data and sync endpoints for this stream */
Takashi Iwai8260ef02012-06-08 09:01:37 +0200127 unsigned int ep_num; /* the endpoint number */
Daniel Mackedcd3632012-04-12 13:51:12 +0200128 struct snd_usb_endpoint *data_endpoint;
129 struct snd_usb_endpoint *sync_endpoint;
130 unsigned long flags;
Takashi Iwai384dc0852012-09-18 14:49:31 +0200131 bool need_setup_ep; /* (re)configure EP at prepare? */
Takashi Iwai978520b2012-10-12 15:12:55 +0200132 unsigned int speed; /* USB_SPEED_XXX */
Daniel Macke5779992010-03-04 19:46:13 +0100133
134 u64 formats; /* format bitmasks (all or'ed) */
135 unsigned int num_formats; /* number of supported audio formats (list) */
136 struct list_head fmt_list; /* format list */
137 struct snd_pcm_hw_constraint_list rate_list; /* limited rates */
138 spinlock_t lock;
139
Pierre-Louis Bossart294c4fb2011-09-06 19:15:34 -0500140 int last_frame_number; /* stored frame number */
141 int last_delay; /* stored delay */
Daniel Macke5779992010-03-04 19:46:13 +0100142};
143
144struct snd_usb_stream {
145 struct snd_usb_audio *chip;
146 struct snd_pcm *pcm;
147 int pcm_index;
148 unsigned int fmt_type; /* USB audio format type (1-3) */
149 struct snd_usb_substream substream[2];
150 struct list_head list;
151};
152
153#endif /* __USBAUDIO_CARD_H */