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