xref: /netbsd/sys/dev/usb/if_rumreg.h (revision 71112a2e)
1 /*	$NetBSD: if_rumreg.h,v 1.5 2016/04/23 10:15:31 skrll Exp $	 */
2 /*	$OpenBSD: if_rumreg.h,v 1.14 2009/08/10 18:04:56 damien Exp $	*/
3 
4 /*-
5  * Copyright (c) 2005, 2006 Damien Bergamini <damien.bergamini@free.fr>
6  * Copyright (c) 2006 Niall O'Higgins <niallo@openbsd.org>
7  *
8  * Permission to use, copy, modify, and distribute this software for any
9  * purpose with or without fee is hereby granted, provided that the above
10  * copyright notice and this permission notice appear in all copies.
11  *
12  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
13  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
14  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
15  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
16  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
17  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
18  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
19  */
20 
21 #define RT2573_TX_DESC_SIZE	(sizeof(struct rum_tx_desc))
22 #define RT2573_RX_DESC_SIZE	(sizeof(struct rum_rx_desc))
23 
24 #define RT2573_CONFIG_NO	1
25 #define RT2573_IFACE_INDEX	0
26 
27 #define RT2573_MCU_CNTL		0x01
28 #define RT2573_WRITE_MAC	0x02
29 #define RT2573_READ_MAC		0x03
30 #define RT2573_WRITE_MULTI_MAC	0x06
31 #define RT2573_READ_MULTI_MAC	0x07
32 #define RT2573_READ_EEPROM	0x09
33 #define RT2573_WRITE_LED	0x0a
34 
35 /*
36  * Control and status registers.
37  */
38 #define RT2573_AIFSN_CSR	0x0400
39 #define RT2573_CWMIN_CSR	0x0404
40 #define RT2573_CWMAX_CSR	0x0408
41 #define RT2573_MCU_CODE_BASE	0x0800
42 #define RT2573_HW_BEACON_BASE0	0x2400
43 #define RT2573_HW_BEACON_BASE1	0x2500
44 #define RT2573_HW_BEACON_BASE2	0x2600
45 #define RT2573_HW_BEACON_BASE3	0x2700
46 #define RT2573_MAC_CSR0		0x3000
47 #define RT2573_MAC_CSR1		0x3004
48 #define RT2573_MAC_CSR2		0x3008
49 #define RT2573_MAC_CSR3		0x300c
50 #define RT2573_MAC_CSR4		0x3010
51 #define RT2573_MAC_CSR5		0x3014
52 #define RT2573_MAC_CSR6		0x3018
53 #define RT2573_MAC_CSR7		0x301c
54 #define RT2573_MAC_CSR8		0x3020
55 #define RT2573_MAC_CSR9		0x3024
56 #define RT2573_MAC_CSR10	0x3028
57 #define RT2573_MAC_CSR11	0x302c
58 #define RT2573_MAC_CSR12	0x3030
59 #define RT2573_MAC_CSR13	0x3034
60 #define RT2573_MAC_CSR14	0x3038
61 #define RT2573_MAC_CSR15	0x303c
62 #define RT2573_TXRX_CSR0	0x3040
63 #define RT2573_TXRX_CSR1	0x3044
64 #define RT2573_TXRX_CSR2	0x3048
65 #define RT2573_TXRX_CSR3	0x304c
66 #define RT2573_TXRX_CSR4	0x3050
67 #define RT2573_TXRX_CSR5	0x3054
68 #define RT2573_TXRX_CSR6	0x3058
69 #define RT2573_TXRX_CSR7	0x305c
70 #define RT2573_TXRX_CSR8	0x3060
71 #define RT2573_TXRX_CSR9	0x3064
72 #define RT2573_TXRX_CSR10	0x3068
73 #define RT2573_TXRX_CSR11	0x306c
74 #define RT2573_TXRX_CSR12	0x3070
75 #define RT2573_TXRX_CSR13	0x3074
76 #define RT2573_TXRX_CSR14	0x3078
77 #define RT2573_TXRX_CSR15	0x307c
78 #define RT2573_PHY_CSR0		0x3080
79 #define RT2573_PHY_CSR1		0x3084
80 #define RT2573_PHY_CSR2		0x3088
81 #define RT2573_PHY_CSR3		0x308c
82 #define RT2573_PHY_CSR4		0x3090
83 #define RT2573_PHY_CSR5		0x3094
84 #define RT2573_PHY_CSR6		0x3098
85 #define RT2573_PHY_CSR7		0x309c
86 #define RT2573_SEC_CSR0		0x30a0
87 #define RT2573_SEC_CSR1		0x30a4
88 #define RT2573_SEC_CSR2		0x30a8
89 #define RT2573_SEC_CSR3		0x30ac
90 #define RT2573_SEC_CSR4		0x30b0
91 #define RT2573_SEC_CSR5		0x30b4
92 #define RT2573_STA_CSR0		0x30c0
93 #define RT2573_STA_CSR1		0x30c4
94 #define RT2573_STA_CSR2		0x30c8
95 #define RT2573_STA_CSR3		0x30cc
96 #define RT2573_STA_CSR4		0x30d0
97 #define RT2573_STA_CSR5		0x30d4
98 
99 
100 /* possible flags for register RT2573_MAC_CSR1 */
101 #define RT2573_RESET_ASIC	(1 << 0)
102 #define RT2573_RESET_BBP	(1 << 1)
103 #define RT2573_HOST_READY	(1 << 2)
104 
105 /* possible flags for register MAC_CSR5 */
106 #define RT2573_ONE_BSSID	3
107 
108 /* possible flags for register TXRX_CSR0 */
109 /* Tx filter flags are in the low 16 bits */
110 #define RT2573_AUTO_TX_SEQ		(1 << 15)
111 /* Rx filter flags are in the high 16 bits */
112 #define RT2573_DISABLE_RX		(1 << 16)
113 #define RT2573_DROP_CRC_ERROR		(1 << 17)
114 #define RT2573_DROP_PHY_ERROR		(1 << 18)
115 #define RT2573_DROP_CTL			(1 << 19)
116 #define RT2573_DROP_NOT_TO_ME		(1 << 20)
117 #define RT2573_DROP_TODS		(1 << 21)
118 #define RT2573_DROP_VER_ERROR		(1 << 22)
119 #define RT2573_DROP_MULTICAST		(1 << 23)
120 #define RT2573_DROP_BROADCAST		(1 << 24)
121 #define RT2573_DROP_ACKCTS		(1 << 25)
122 
123 /* possible flags for register TXRX_CSR4 */
124 #define RT2573_SHORT_PREAMBLE	(1 << 18)
125 #define RT2573_MRR_ENABLED	(1 << 19)
126 #define RT2573_MRR_CCK_FALLBACK	(1 << 22)
127 
128 /* possible flags for register TXRX_CSR9 */
129 #define RT2573_TSF_TICKING	(1 << 16)
130 #define RT2573_TSF_MODE(x)	(((x) & 0x3) << 17)
131 /* TBTT stands for Target Beacon Transmission Time */
132 #define RT2573_ENABLE_TBTT	(1 << 19)
133 #define RT2573_GENERATE_BEACON	(1 << 20)
134 
135 /* possible flags for register PHY_CSR0 */
136 #define RT2573_PA_PE_2GHZ	(1 << 16)
137 #define RT2573_PA_PE_5GHZ	(1 << 17)
138 
139 /* possible flags for register PHY_CSR3 */
140 #define RT2573_BBP_READ	(1 << 15)
141 #define RT2573_BBP_BUSY	(1 << 16)
142 /* possible flags for register PHY_CSR4 */
143 #define RT2573_RF_20BIT	(20 << 24)
144 #define RT2573_RF_BUSY	(1 << 31)
145 
146 /* LED values */
147 #define RT2573_LED_RADIO	(1 << 8)
148 #define RT2573_LED_G		(1 << 9)
149 #define RT2573_LED_A		(1 << 10)
150 #define RT2573_LED_ON		0x1e1e
151 #define RT2573_LED_OFF		0x0
152 
153 #define RT2573_MCU_RUN	(1 << 3)
154 
155 #define RT2573_SMART_MODE	(1 << 0)
156 
157 #define RT2573_BBPR94_DEFAULT	6
158 
159 #define RT2573_BBP_WRITE	(1 << 15)
160 
161 /* dual-band RF */
162 #define RT2573_RF_5226	1
163 #define RT2573_RF_5225	3
164 /* single-band RF */
165 #define RT2573_RF_2528	2
166 #define RT2573_RF_2527	4
167 
168 #define RT2573_BBP_VERSION	0
169 
170 struct rum_tx_desc {
171 	uint32_t	flags;
172 #define RT2573_TX_BURST			(1 << 0)
173 #define RT2573_TX_VALID			(1 << 1)
174 #define RT2573_TX_MORE_FRAG		(1 << 2)
175 #define RT2573_TX_NEED_ACK		(1 << 3)
176 #define RT2573_TX_TIMESTAMP		(1 << 4)
177 #define RT2573_TX_OFDM			(1 << 5)
178 #define RT2573_TX_IFS_SIFS		(1 << 6)
179 #define RT2573_TX_LONG_RETRY		(1 << 7)
180 
181 	uint16_t	wme;
182 #define RT2573_QID(v)		(v)
183 #define RT2573_AIFSN(v)		((v) << 4)
184 #define RT2573_LOGCWMIN(v)	((v) << 8)
185 #define RT2573_LOGCWMAX(v)	((v) << 12)
186 
187 	uint16_t	xflags;
188 #define RT2573_TX_HWSEQ		(1 << 12)
189 
190 	uint8_t		plcp_signal;
191 	uint8_t		plcp_service;
192 #define RT2573_PLCP_LENGEXT	0x80
193 
194 	uint8_t		plcp_length_lo;
195 	uint8_t		plcp_length_hi;
196 
197 	uint32_t	iv;
198 	uint32_t	eiv;
199 
200 	uint8_t		offset;
201 	uint8_t		qid;
202 	uint8_t		txpower;
203 #define RT2573_DEFAULT_TXPOWER	0
204 
205 	uint8_t		reserved;
206 } __packed;
207 
208 struct rum_rx_desc {
209 	uint32_t	flags;
210 #define RT2573_RX_BUSY		(1 << 0)
211 #define RT2573_RX_DROP		(1 << 1)
212 #define RT2573_RX_CRC_ERROR	(1 << 6)
213 #define RT2573_RX_OFDM		(1 << 7)
214 
215 	uint8_t		rate;
216 	uint8_t		rssi;
217 	uint8_t		reserved1;
218 	uint8_t		offset;
219 	uint32_t	iv;
220 	uint32_t	eiv;
221 	uint32_t	reserved2[2];
222 } __packed;
223 
224 #define RT2573_RF1	0
225 #define RT2573_RF2	2
226 #define RT2573_RF3	1
227 #define RT2573_RF4	3
228 
229 #define RT2573_EEPROM_MACBBP		0x0000
230 #define RT2573_EEPROM_ADDRESS		0x0004
231 #define RT2573_EEPROM_ANTENNA		0x0020
232 #define RT2573_EEPROM_CONFIG2		0x0022
233 #define RT2573_EEPROM_BBP_BASE		0x0026
234 #define RT2573_EEPROM_TXPOWER		0x0046
235 #define RT2573_EEPROM_FREQ_OFFSET	0x005e
236 #define RT2573_EEPROM_RSSI_2GHZ_OFFSET	0x009a
237 #define RT2573_EEPROM_RSSI_5GHZ_OFFSET	0x009c
238 
239 /*
240  * Default values for MAC registers; values taken from the reference driver.
241  */
242 #define RT2573_DEF_MAC				\
243 	{ RT2573_TXRX_CSR0,       0x025fb032 },	\
244 	{ RT2573_TXRX_CSR1,       0x9eaa9eaf },	\
245 	{ RT2573_TXRX_CSR2,       0x8a8b8c8d },	\
246 	{ RT2573_TXRX_CSR3,       0x00858687 },	\
247 	{ RT2573_TXRX_CSR7,       0x2e31353b },	\
248 	{ RT2573_TXRX_CSR8,       0x2a2a2a2c },	\
249 	{ RT2573_TXRX_CSR15,      0x0000000f },	\
250 	{ RT2573_MAC_CSR6,        0x00000fff },	\
251 	{ RT2573_MAC_CSR8,        0x016c030a },	\
252 	{ RT2573_MAC_CSR10,       0x00000718 },	\
253 	{ RT2573_MAC_CSR12,       0x00000004 },	\
254 	{ RT2573_MAC_CSR13,       0x00007f00 },	\
255 	{ RT2573_SEC_CSR0,        0x00000000 },	\
256 	{ RT2573_SEC_CSR1,        0x00000000 },	\
257 	{ RT2573_SEC_CSR5,        0x00000000 },	\
258 	{ RT2573_PHY_CSR1,        0x000023b0 },	\
259 	{ RT2573_PHY_CSR5,        0x00040a06 },	\
260 	{ RT2573_PHY_CSR6,        0x00080606 },	\
261 	{ RT2573_PHY_CSR7,        0x00000408 },	\
262 	{ RT2573_AIFSN_CSR,       0x00002273 },	\
263 	{ RT2573_CWMIN_CSR,       0x00002344 },	\
264 	{ RT2573_CWMAX_CSR,       0x000034aa },	\
265 	{ RT2573_HW_BEACON_BASE0, 0x00000000 },	\
266 	{ RT2573_HW_BEACON_BASE1, 0x00000000 },	\
267 	{ RT2573_HW_BEACON_BASE2, 0x00000000 },	\
268 	{ RT2573_HW_BEACON_BASE3, 0x00000000 }
269 
270 /*
271  * Default values for BBP registers; values taken from the reference driver.
272  */
273 #define RT2573_DEF_BBP	\
274 	{   3, 0x80 },	\
275 	{  15, 0x30 },	\
276 	{  17, 0x20 },	\
277 	{  21, 0xc8 },	\
278 	{  22, 0x38 },	\
279 	{  23, 0x06 },	\
280 	{  24, 0xfe },	\
281 	{  25, 0x0a },	\
282 	{  26, 0x0d },	\
283 	{  32, 0x0b },	\
284 	{  34, 0x12 },	\
285 	{  37, 0x07 },	\
286 	{  39, 0xf8 },	\
287 	{  41, 0x60 },	\
288 	{  53, 0x10 },	\
289 	{  54, 0x18 },	\
290 	{  60, 0x10 },	\
291 	{  61, 0x04 },	\
292 	{  62, 0x04 },	\
293 	{  75, 0xfe },	\
294 	{  86, 0xfe },	\
295 	{  88, 0xfe },	\
296 	{  90, 0x0f },	\
297 	{  99, 0x00 },	\
298 	{ 102, 0x16 },	\
299 	{ 107, 0x04 }
300 
301 /*
302  * Default settings for RF registers; values taken from the reference driver.
303  */
304 #define RT2573_RF5226					\
305 	{   1, 0x00b03, 0x001e1, 0x1a014, 0x30282 },	\
306 	{   2, 0x00b03, 0x001e1, 0x1a014, 0x30287 },	\
307 	{   3, 0x00b03, 0x001e2, 0x1a014, 0x30282 },	\
308 	{   4, 0x00b03, 0x001e2, 0x1a014, 0x30287 },	\
309 	{   5, 0x00b03, 0x001e3, 0x1a014, 0x30282 },	\
310 	{   6, 0x00b03, 0x001e3, 0x1a014, 0x30287 },	\
311 	{   7, 0x00b03, 0x001e4, 0x1a014, 0x30282 },	\
312 	{   8, 0x00b03, 0x001e4, 0x1a014, 0x30287 },	\
313 	{   9, 0x00b03, 0x001e5, 0x1a014, 0x30282 },	\
314 	{  10, 0x00b03, 0x001e5, 0x1a014, 0x30287 },	\
315 	{  11, 0x00b03, 0x001e6, 0x1a014, 0x30282 },	\
316 	{  12, 0x00b03, 0x001e6, 0x1a014, 0x30287 },	\
317 	{  13, 0x00b03, 0x001e7, 0x1a014, 0x30282 },	\
318 	{  14, 0x00b03, 0x001e8, 0x1a014, 0x30284 },	\
319 							\
320 	{  34, 0x00b03, 0x20266, 0x36014, 0x30282 },	\
321 	{  38, 0x00b03, 0x20267, 0x36014, 0x30284 },	\
322 	{  42, 0x00b03, 0x20268, 0x36014, 0x30286 },	\
323 	{  46, 0x00b03, 0x20269, 0x36014, 0x30288 },	\
324 							\
325 	{  36, 0x00b03, 0x00266, 0x26014, 0x30288 },	\
326 	{  40, 0x00b03, 0x00268, 0x26014, 0x30280 },	\
327 	{  44, 0x00b03, 0x00269, 0x26014, 0x30282 },	\
328 	{  48, 0x00b03, 0x0026a, 0x26014, 0x30284 },	\
329 	{  52, 0x00b03, 0x0026b, 0x26014, 0x30286 },	\
330 	{  56, 0x00b03, 0x0026c, 0x26014, 0x30288 },	\
331 	{  60, 0x00b03, 0x0026e, 0x26014, 0x30280 },	\
332 	{  64, 0x00b03, 0x0026f, 0x26014, 0x30282 },	\
333 							\
334 	{ 100, 0x00b03, 0x0028a, 0x2e014, 0x30280 },	\
335 	{ 104, 0x00b03, 0x0028b, 0x2e014, 0x30282 },	\
336 	{ 108, 0x00b03, 0x0028c, 0x2e014, 0x30284 },	\
337 	{ 112, 0x00b03, 0x0028d, 0x2e014, 0x30286 },	\
338 	{ 116, 0x00b03, 0x0028e, 0x2e014, 0x30288 },	\
339 	{ 120, 0x00b03, 0x002a0, 0x2e014, 0x30280 },	\
340 	{ 124, 0x00b03, 0x002a1, 0x2e014, 0x30282 },	\
341 	{ 128, 0x00b03, 0x002a2, 0x2e014, 0x30284 },	\
342 	{ 132, 0x00b03, 0x002a3, 0x2e014, 0x30286 },	\
343 	{ 136, 0x00b03, 0x002a4, 0x2e014, 0x30288 },	\
344 	{ 140, 0x00b03, 0x002a6, 0x2e014, 0x30280 },	\
345 							\
346 	{ 149, 0x00b03, 0x002a8, 0x2e014, 0x30287 },	\
347 	{ 153, 0x00b03, 0x002a9, 0x2e014, 0x30289 },	\
348 	{ 157, 0x00b03, 0x002ab, 0x2e014, 0x30281 },	\
349 	{ 161, 0x00b03, 0x002ac, 0x2e014, 0x30283 },	\
350 	{ 165, 0x00b03, 0x002ad, 0x2e014, 0x30285 }
351 
352 #define RT2573_RF5225					\
353 	{   1, 0x00b33, 0x011e1, 0x1a014, 0x30282 },	\
354 	{   2, 0x00b33, 0x011e1, 0x1a014, 0x30287 },	\
355 	{   3, 0x00b33, 0x011e2, 0x1a014, 0x30282 },	\
356 	{   4, 0x00b33, 0x011e2, 0x1a014, 0x30287 },	\
357 	{   5, 0x00b33, 0x011e3, 0x1a014, 0x30282 },	\
358 	{   6, 0x00b33, 0x011e3, 0x1a014, 0x30287 },	\
359 	{   7, 0x00b33, 0x011e4, 0x1a014, 0x30282 },	\
360 	{   8, 0x00b33, 0x011e4, 0x1a014, 0x30287 },	\
361 	{   9, 0x00b33, 0x011e5, 0x1a014, 0x30282 },	\
362 	{  10, 0x00b33, 0x011e5, 0x1a014, 0x30287 },	\
363 	{  11, 0x00b33, 0x011e6, 0x1a014, 0x30282 },	\
364 	{  12, 0x00b33, 0x011e6, 0x1a014, 0x30287 },	\
365 	{  13, 0x00b33, 0x011e7, 0x1a014, 0x30282 },	\
366 	{  14, 0x00b33, 0x011e8, 0x1a014, 0x30284 },	\
367 							\
368 	{  34, 0x00b33, 0x01266, 0x26014, 0x30282 },	\
369 	{  38, 0x00b33, 0x01267, 0x26014, 0x30284 },	\
370 	{  42, 0x00b33, 0x01268, 0x26014, 0x30286 },	\
371 	{  46, 0x00b33, 0x01269, 0x26014, 0x30288 },	\
372 							\
373 	{  36, 0x00b33, 0x01266, 0x26014, 0x30288 },	\
374 	{  40, 0x00b33, 0x01268, 0x26014, 0x30280 },	\
375 	{  44, 0x00b33, 0x01269, 0x26014, 0x30282 },	\
376 	{  48, 0x00b33, 0x0126a, 0x26014, 0x30284 },	\
377 	{  52, 0x00b33, 0x0126b, 0x26014, 0x30286 },	\
378 	{  56, 0x00b33, 0x0126c, 0x26014, 0x30288 },	\
379 	{  60, 0x00b33, 0x0126e, 0x26014, 0x30280 },	\
380 	{  64, 0x00b33, 0x0126f, 0x26014, 0x30282 },	\
381 							\
382 	{ 100, 0x00b33, 0x0128a, 0x2e014, 0x30280 },	\
383 	{ 104, 0x00b33, 0x0128b, 0x2e014, 0x30282 },	\
384 	{ 108, 0x00b33, 0x0128c, 0x2e014, 0x30284 },	\
385 	{ 112, 0x00b33, 0x0128d, 0x2e014, 0x30286 },	\
386 	{ 116, 0x00b33, 0x0128e, 0x2e014, 0x30288 },	\
387 	{ 120, 0x00b33, 0x012a0, 0x2e014, 0x30280 },	\
388 	{ 124, 0x00b33, 0x012a1, 0x2e014, 0x30282 },	\
389 	{ 128, 0x00b33, 0x012a2, 0x2e014, 0x30284 },	\
390 	{ 132, 0x00b33, 0x012a3, 0x2e014, 0x30286 },	\
391 	{ 136, 0x00b33, 0x012a4, 0x2e014, 0x30288 },	\
392 	{ 140, 0x00b33, 0x012a6, 0x2e014, 0x30280 },	\
393 							\
394 	{ 149, 0x00b33, 0x012a8, 0x2e014, 0x30287 },	\
395 	{ 153, 0x00b33, 0x012a9, 0x2e014, 0x30289 },	\
396 	{ 157, 0x00b33, 0x012ab, 0x2e014, 0x30281 },	\
397 	{ 161, 0x00b33, 0x012ac, 0x2e014, 0x30283 },	\
398 	{ 165, 0x00b33, 0x012ad, 0x2e014, 0x30285 }
399