xref: /linux/drivers/net/wireless/realtek/rtl8xxxu/rtl8xxxu.h (revision f9bff0e31881d03badf191d3b0005839391f5f2b)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (c) 2014 - 2017 Jes Sorensen <Jes.Sorensen@gmail.com>
4  *
5  * Register definitions taken from original Realtek rtl8723au driver
6  */
7 
8 #include <asm/byteorder.h>
9 
10 #define RTL8XXXU_DEBUG_REG_WRITE	0x01
11 #define RTL8XXXU_DEBUG_REG_READ		0x02
12 #define RTL8XXXU_DEBUG_RFREG_WRITE	0x04
13 #define RTL8XXXU_DEBUG_RFREG_READ	0x08
14 #define RTL8XXXU_DEBUG_CHANNEL		0x10
15 #define RTL8XXXU_DEBUG_TX		0x20
16 #define RTL8XXXU_DEBUG_TX_DUMP		0x40
17 #define RTL8XXXU_DEBUG_RX		0x80
18 #define RTL8XXXU_DEBUG_RX_DUMP		0x100
19 #define RTL8XXXU_DEBUG_USB		0x200
20 #define RTL8XXXU_DEBUG_KEY		0x400
21 #define RTL8XXXU_DEBUG_H2C		0x800
22 #define RTL8XXXU_DEBUG_ACTION		0x1000
23 #define RTL8XXXU_DEBUG_EFUSE		0x2000
24 #define RTL8XXXU_DEBUG_INTERRUPT	0x4000
25 
26 #define RTW_USB_CONTROL_MSG_TIMEOUT	500
27 #define RTL8XXXU_MAX_REG_POLL		500
28 #define	USB_INTR_CONTENT_LENGTH		56
29 
30 #define RTL8XXXU_OUT_ENDPOINTS		6
31 
32 #define REALTEK_USB_READ		0xc0
33 #define REALTEK_USB_WRITE		0x40
34 #define REALTEK_USB_CMD_REQ		0x05
35 #define REALTEK_USB_CMD_IDX		0x00
36 
37 #define TX_TOTAL_PAGE_NUM		0xf8
38 #define TX_TOTAL_PAGE_NUM_8188F		0xf7
39 #define TX_TOTAL_PAGE_NUM_8188E		0xa9
40 #define TX_TOTAL_PAGE_NUM_8192E		0xf3
41 #define TX_TOTAL_PAGE_NUM_8723B		0xf7
42 #define TX_TOTAL_PAGE_NUM_8192F		0xf7
43 /* (HPQ + LPQ + NPQ + PUBQ) = TX_TOTAL_PAGE_NUM */
44 #define TX_PAGE_NUM_PUBQ		0xe7
45 #define TX_PAGE_NUM_HI_PQ		0x0c
46 #define TX_PAGE_NUM_LO_PQ		0x02
47 #define TX_PAGE_NUM_NORM_PQ		0x02
48 
49 #define TX_PAGE_NUM_PUBQ_8188F		0xe5
50 #define TX_PAGE_NUM_HI_PQ_8188F		0x0c
51 #define TX_PAGE_NUM_LO_PQ_8188F		0x02
52 #define TX_PAGE_NUM_NORM_PQ_8188F	0x02
53 
54 #define TX_PAGE_NUM_PUBQ_8188E		0x47
55 #define TX_PAGE_NUM_HI_PQ_8188E		0x29
56 #define TX_PAGE_NUM_LO_PQ_8188E		0x1c
57 #define TX_PAGE_NUM_NORM_PQ_8188E	0x1c
58 
59 #define TX_PAGE_NUM_PUBQ_8192E		0xe7
60 #define TX_PAGE_NUM_HI_PQ_8192E		0x08
61 #define TX_PAGE_NUM_LO_PQ_8192E		0x0c
62 #define TX_PAGE_NUM_NORM_PQ_8192E	0x00
63 
64 #define TX_PAGE_NUM_PUBQ_8723B		0xe7
65 #define TX_PAGE_NUM_HI_PQ_8723B		0x0c
66 #define TX_PAGE_NUM_LO_PQ_8723B		0x02
67 #define TX_PAGE_NUM_NORM_PQ_8723B	0x02
68 
69 #define TX_PAGE_NUM_PUBQ_8192F		0xde
70 #define TX_PAGE_NUM_HI_PQ_8192F		0x08
71 #define TX_PAGE_NUM_LO_PQ_8192F		0x08
72 #define TX_PAGE_NUM_NORM_PQ_8192F	0x08
73 
74 #define RTL_FW_PAGE_SIZE		4096
75 #define RTL8XXXU_FIRMWARE_POLL_MAX	1000
76 
77 #define RTL8723A_CHANNEL_GROUPS		3
78 #define RTL8723A_MAX_RF_PATHS		2
79 #define RTL8723B_CHANNEL_GROUPS		6
80 #define RTL8723B_TX_COUNT		4
81 #define RTL8723B_MAX_RF_PATHS		4
82 #define RTL8XXXU_MAX_CHANNEL_GROUPS	6
83 #define RF6052_MAX_TX_PWR		0x3f
84 
85 #define EFUSE_MAP_LEN			512
86 #define EFUSE_MAX_SECTION_8723A		64
87 #define EFUSE_REAL_CONTENT_LEN_8723A	512
88 #define EFUSE_BT_MAP_LEN_8723A		1024
89 #define EFUSE_MAX_WORD_UNIT		4
90 #define EFUSE_UNDEFINED			0xff
91 
92 enum rtl8xxxu_rtl_chip {
93 	RTL8192S = 0x81920,
94 	RTL8191S = 0x81910,
95 	RTL8192C = 0x8192c,
96 	RTL8191C = 0x8191c,
97 	RTL8188C = 0x8188c,
98 	RTL8188R = 0x81889,
99 	RTL8192D = 0x8192d,
100 	RTL8723A = 0x8723a,
101 	RTL8188E = 0x8188e,
102 	RTL8812  = 0x88120,
103 	RTL8821  = 0x88210,
104 	RTL8192E = 0x8192e,
105 	RTL8191E = 0x8191e,
106 	RTL8723B = 0x8723b,
107 	RTL8814A = 0x8814a,
108 	RTL8881A = 0x8881a,
109 	RTL8821B = 0x8821b,
110 	RTL8822B = 0x8822b,
111 	RTL8703B = 0x8703b,
112 	RTL8195A = 0x8195a,
113 	RTL8188F = 0x8188f,
114 	RTL8710B = 0x8710b,
115 	RTL8192F = 0x8192f,
116 };
117 
118 enum rtl8xxxu_rx_type {
119 	RX_TYPE_DATA_PKT = 0,
120 	RX_TYPE_C2H = 1,
121 	RX_TYPE_ERROR = -1
122 };
123 
124 struct rtl8xxxu_rxdesc16 {
125 #ifdef __LITTLE_ENDIAN
126 	u32 pktlen:14;
127 	u32 crc32:1;
128 	u32 icverr:1;
129 	u32 drvinfo_sz:4;
130 	u32 security:3;
131 	u32 qos:1;
132 	u32 shift:2;
133 	u32 phy_stats:1;
134 	u32 swdec:1;
135 	u32 ls:1;
136 	u32 fs:1;
137 	u32 eor:1;
138 	u32 own:1;
139 
140 	u32 macid:5;
141 	u32 tid:4;
142 	u32 hwrsvd:4;
143 	u32 amsdu:1;
144 	u32 paggr:1;
145 	u32 faggr:1;
146 	u32 a1fit:4;
147 	u32 a2fit:4;
148 	u32 pam:1;
149 	u32 pwr:1;
150 	u32 md:1;
151 	u32 mf:1;
152 	u32 type:2;
153 	u32 mc:1;
154 	u32 bc:1;
155 
156 	u32 seq:12;
157 	u32 frag:4;
158 	u32 pkt_cnt:8;
159 	u32 reserved:6;
160 	u32 nextind:1;
161 	u32 reserved0:1;
162 
163 	u32 rxmcs:6;
164 	u32 rxht:1;
165 	u32 gf:1;
166 	u32 splcp:1;
167 	u32 bw:1;
168 	u32 htc:1;
169 	u32 eosp:1;
170 	u32 bssidfit:2;
171 	u32 rpt_sel:2;		/* 8188e */
172 	u32 reserved1:14;
173 	u32 unicastwake:1;
174 	u32 magicwake:1;
175 
176 	u32 pattern0match:1;
177 	u32 pattern1match:1;
178 	u32 pattern2match:1;
179 	u32 pattern3match:1;
180 	u32 pattern4match:1;
181 	u32 pattern5match:1;
182 	u32 pattern6match:1;
183 	u32 pattern7match:1;
184 	u32 pattern8match:1;
185 	u32 pattern9match:1;
186 	u32 patternamatch:1;
187 	u32 patternbmatch:1;
188 	u32 patterncmatch:1;
189 	u32 reserved2:19;
190 #else
191 	u32 own:1;
192 	u32 eor:1;
193 	u32 fs:1;
194 	u32 ls:1;
195 	u32 swdec:1;
196 	u32 phy_stats:1;
197 	u32 shift:2;
198 	u32 qos:1;
199 	u32 security:3;
200 	u32 drvinfo_sz:4;
201 	u32 icverr:1;
202 	u32 crc32:1;
203 	u32 pktlen:14;
204 
205 	u32 bc:1;
206 	u32 mc:1;
207 	u32 type:2;
208 	u32 mf:1;
209 	u32 md:1;
210 	u32 pwr:1;
211 	u32 pam:1;
212 	u32 a2fit:4;
213 	u32 a1fit:4;
214 	u32 faggr:1;
215 	u32 paggr:1;
216 	u32 amsdu:1;
217 	u32 hwrsvd:4;
218 	u32 tid:4;
219 	u32 macid:5;
220 
221 	u32 reserved0:1;
222 	u32 nextind:1;
223 	u32 reserved:6;
224 	u32 pkt_cnt:8;
225 	u32 frag:4;
226 	u32 seq:12;
227 
228 	u32 magicwake:1;
229 	u32 unicastwake:1;
230 	u32 reserved1:14;
231 	u32 rpt_sel:2;		/* 8188e */
232 	u32 bssidfit:2;
233 	u32 eosp:1;
234 	u32 htc:1;
235 	u32 bw:1;
236 	u32 splcp:1;
237 	u32 gf:1;
238 	u32 rxht:1;
239 	u32 rxmcs:6;
240 
241 	u32 reserved2:19;
242 	u32 patterncmatch:1;
243 	u32 patternbmatch:1;
244 	u32 patternamatch:1;
245 	u32 pattern9match:1;
246 	u32 pattern8match:1;
247 	u32 pattern7match:1;
248 	u32 pattern6match:1;
249 	u32 pattern5match:1;
250 	u32 pattern4match:1;
251 	u32 pattern3match:1;
252 	u32 pattern2match:1;
253 	u32 pattern1match:1;
254 	u32 pattern0match:1;
255 #endif
256 	u32 tsfl;
257 #if 0
258 	u32 bassn:12;
259 	u32 bavld:1;
260 	u32 reserved3:19;
261 #endif
262 };
263 
264 struct rtl8xxxu_rxdesc24 {
265 #ifdef __LITTLE_ENDIAN
266 	u32 pktlen:14;
267 	u32 crc32:1;
268 	u32 icverr:1;
269 	u32 drvinfo_sz:4;
270 	u32 security:3;
271 	u32 qos:1;
272 	u32 shift:2;
273 	u32 phy_stats:1;
274 	u32 swdec:1;
275 	u32 ls:1;
276 	u32 fs:1;
277 	u32 eor:1;
278 	u32 own:1;
279 
280 	u32 macid:7;
281 	u32 dummy1_0:1;
282 	u32 tid:4;
283 	u32 dummy1_1:1;
284 	u32 amsdu:1;
285 	u32 rxid_match:1;
286 	u32 paggr:1;
287 	u32 a1fit:4;	/* 16 */
288 	u32 chkerr:1;
289 	u32 ipver:1;
290 	u32 tcpudp:1;
291 	u32 chkvld:1;
292 	u32 pam:1;
293 	u32 pwr:1;
294 	u32 more_data:1;
295 	u32 more_frag:1;
296 	u32 type:2;
297 	u32 mc:1;
298 	u32 bc:1;
299 
300 	u32 seq:12;
301 	u32 frag:4;
302 	u32 rx_is_qos:1;	/* 16 */
303 	u32 dummy2_0:1;
304 	u32 wlanhd_iv_len:6;
305 	u32 dummy2_1:4;
306 	u32 rpt_sel:1;
307 	u32 dummy2_2:3;
308 
309 	u32 rxmcs:7;
310 	u32 dummy3_0:3;
311 	u32 htc:1;
312 	u32 eosp:1;
313 	u32 bssidfit:2;
314 	u32 dummy3_1:2;
315 	u32 usb_agg_pktnum:8;	/* 16 */
316 	u32 dummy3_2:5;
317 	u32 pattern_match:1;
318 	u32 unicast_match:1;
319 	u32 magic_match:1;
320 
321 	u32 splcp:1;
322 	u32 ldcp:1;
323 	u32 stbc:1;
324 	u32 dummy4_0:1;
325 	u32 bw:2;
326 	u32 dummy4_1:26;
327 #else
328 	u32 own:1;
329 	u32 eor:1;
330 	u32 fs:1;
331 	u32 ls:1;
332 	u32 swdec:1;
333 	u32 phy_stats:1;
334 	u32 shift:2;
335 	u32 qos:1;
336 	u32 security:3;
337 	u32 drvinfo_sz:4;
338 	u32 icverr:1;
339 	u32 crc32:1;
340 	u32 pktlen:14;
341 
342 	u32 bc:1;
343 	u32 mc:1;
344 	u32 type:2;
345 	u32 mf:1;
346 	u32 md:1;
347 	u32 pwr:1;
348 	u32 pam:1;
349 	u32 a2fit:4;
350 	u32 a1fit:4;
351 	u32 faggr:1;
352 	u32 paggr:1;
353 	u32 amsdu:1;
354 	u32 hwrsvd:4;
355 	u32 tid:4;
356 	u32 macid:5;
357 
358 	u32 dummy2_2:3;
359 	u32 rpt_sel:1;
360 	u32 dummy2_1:4;
361 	u32 wlanhd_iv_len:6;
362 	u32 dummy2_0:1;
363 	u32 rx_is_qos:1;
364 	u32 frag:4;		/* 16 */
365 	u32 seq:12;
366 
367 	u32 magic_match:1;
368 	u32 unicast_match:1;
369 	u32 pattern_match:1;
370 	u32 dummy3_2:5;
371 	u32 usb_agg_pktnum:8;
372 	u32 dummy3_1:2;		/* 16 */
373 	u32 bssidfit:2;
374 	u32 eosp:1;
375 	u32 htc:1;
376 	u32 dummy3_0:3;
377 	u32 rxmcs:7;
378 
379 	u32 dumm4_1:26;
380 	u32 bw:2;
381 	u32 dummy4_0:1;
382 	u32 stbc:1;
383 	u32 ldcp:1;
384 	u32 splcp:1;
385 #endif
386 	u32 tsfl;
387 };
388 
389 struct rtl8xxxu_txdesc32 {
390 	__le16 pkt_size;
391 	u8 pkt_offset;
392 	u8 txdw0;
393 	__le32 txdw1;
394 	__le32 txdw2;
395 	__le32 txdw3;
396 	__le32 txdw4;
397 	__le32 txdw5;
398 	__le32 txdw6;
399 	__le16 csum;
400 	__le16 txdw7;
401 };
402 
403 struct rtl8xxxu_txdesc40 {
404 	__le16 pkt_size;
405 	u8 pkt_offset;
406 	u8 txdw0;
407 	__le32 txdw1;
408 	__le32 txdw2;
409 	__le32 txdw3;
410 	__le32 txdw4;
411 	__le32 txdw5;
412 	__le32 txdw6;
413 	__le16 csum;
414 	__le16 txdw7;
415 	__le32 txdw8;
416 	__le32 txdw9;
417 };
418 
419 /*  CCK Rates, TxHT = 0 */
420 #define DESC_RATE_1M			0x00
421 #define DESC_RATE_2M			0x01
422 #define DESC_RATE_5_5M			0x02
423 #define DESC_RATE_11M			0x03
424 
425 /*  OFDM Rates, TxHT = 0 */
426 #define DESC_RATE_6M			0x04
427 #define DESC_RATE_9M			0x05
428 #define DESC_RATE_12M			0x06
429 #define DESC_RATE_18M			0x07
430 #define DESC_RATE_24M			0x08
431 #define DESC_RATE_36M			0x09
432 #define DESC_RATE_48M			0x0a
433 #define DESC_RATE_54M			0x0b
434 
435 /*  MCS Rates, TxHT = 1 */
436 #define DESC_RATE_MCS0			0x0c
437 #define DESC_RATE_MCS1			0x0d
438 #define DESC_RATE_MCS2			0x0e
439 #define DESC_RATE_MCS3			0x0f
440 #define DESC_RATE_MCS4			0x10
441 #define DESC_RATE_MCS5			0x11
442 #define DESC_RATE_MCS6			0x12
443 #define DESC_RATE_MCS7			0x13
444 #define DESC_RATE_MCS8			0x14
445 #define DESC_RATE_MCS9			0x15
446 #define DESC_RATE_MCS10			0x16
447 #define DESC_RATE_MCS11			0x17
448 #define DESC_RATE_MCS12			0x18
449 #define DESC_RATE_MCS13			0x19
450 #define DESC_RATE_MCS14			0x1a
451 #define DESC_RATE_MCS15			0x1b
452 #define DESC_RATE_MCS15_SG		0x1c
453 #define DESC_RATE_MCS32			0x20
454 
455 #define TXDESC_OFFSET_SZ		0
456 #define TXDESC_OFFSET_SHT		16
457 #if 0
458 #define TXDESC_BMC			BIT(24)
459 #define TXDESC_LSG			BIT(26)
460 #define TXDESC_FSG			BIT(27)
461 #define TXDESC_OWN			BIT(31)
462 #else
463 #define TXDESC_BROADMULTICAST		BIT(0)
464 #define TXDESC_HTC			BIT(1)
465 #define TXDESC_LAST_SEGMENT		BIT(2)
466 #define TXDESC_FIRST_SEGMENT		BIT(3)
467 #define TXDESC_LINIP			BIT(4)
468 #define TXDESC_NO_ACM			BIT(5)
469 #define TXDESC_GF			BIT(6)
470 #define TXDESC_OWN			BIT(7)
471 #endif
472 
473 /* Word 1 */
474 /*
475  * Bits 0-7 differ dependent on chip generation. For 8723au bits 5/6 are
476  * aggregation enable and break respectively. For 8723bu, bits 0-7 are macid.
477  */
478 #define TXDESC_PKT_OFFSET_SZ		0
479 #define TXDESC32_AGG_ENABLE		BIT(5)
480 #define TXDESC32_AGG_BREAK		BIT(6)
481 #define TXDESC40_MACID_SHIFT		0
482 #define TXDESC40_MACID_MASK		0x00f0
483 #define TXDESC_QUEUE_SHIFT		8
484 #define TXDESC_QUEUE_MASK		0x1f00
485 #define TXDESC_QUEUE_BK			0x2
486 #define TXDESC_QUEUE_BE			0x0
487 #define TXDESC_QUEUE_VI			0x5
488 #define TXDESC_QUEUE_VO			0x7
489 #define TXDESC_QUEUE_BEACON		0x10
490 #define TXDESC_QUEUE_HIGH		0x11
491 #define TXDESC_QUEUE_MGNT		0x12
492 #define TXDESC_QUEUE_CMD		0x13
493 #define TXDESC_QUEUE_MAX		(TXDESC_QUEUE_CMD + 1)
494 #define TXDESC40_RDG_NAV_EXT		BIT(13)
495 #define TXDESC40_LSIG_TXOP_ENABLE	BIT(14)
496 #define TXDESC40_PIFS			BIT(15)
497 
498 #define DESC_RATE_ID_SHIFT		16
499 #define DESC_RATE_ID_MASK		0xf
500 #define TXDESC_NAVUSEHDR		BIT(20)
501 #define TXDESC_SEC_RC4			0x00400000
502 #define TXDESC_SEC_AES			0x00c00000
503 #define TXDESC_PKT_OFFSET_SHIFT		26
504 #define TXDESC_AGG_EN			BIT(29)
505 #define TXDESC_HWPC			BIT(31)
506 
507 /* Word 2 */
508 #define TXDESC40_PAID_SHIFT		0
509 #define TXDESC40_PAID_MASK		0x1ff
510 #define TXDESC40_CCA_RTS_SHIFT		10
511 #define TXDESC40_CCA_RTS_MASK		0xc00
512 #define TXDESC40_AGG_ENABLE		BIT(12)
513 #define TXDESC40_RDG_ENABLE		BIT(13)
514 #define TXDESC40_AGG_BREAK		BIT(16)
515 #define TXDESC40_MORE_FRAG		BIT(17)
516 #define TXDESC40_RAW			BIT(18)
517 #define TXDESC32_ACK_REPORT		BIT(19)
518 #define TXDESC40_SPE_RPT		BIT(19)
519 #define TXDESC_AMPDU_DENSITY_SHIFT	20
520 #define TXDESC40_BT_INT			BIT(23)
521 #define TXDESC40_GID_SHIFT		24
522 #define TXDESC_ANTENNA_SELECT_A		BIT(24)
523 #define TXDESC_ANTENNA_SELECT_B		BIT(25)
524 
525 /* Word 3 */
526 #define TXDESC40_USE_DRIVER_RATE	BIT(8)
527 #define TXDESC40_CTS_SELF_ENABLE	BIT(11)
528 #define TXDESC40_RTS_CTS_ENABLE		BIT(12)
529 #define TXDESC40_HW_RTS_ENABLE		BIT(13)
530 #define TXDESC32_SEQ_SHIFT		16
531 #define TXDESC32_SEQ_MASK		0x0fff0000
532 
533 /* Word 4 */
534 #define TXDESC32_RTS_RATE_SHIFT		0
535 #define TXDESC32_RTS_RATE_MASK		0x3f
536 #define TXDESC32_QOS			BIT(6)
537 #define TXDESC32_HW_SEQ_ENABLE		BIT(7)
538 #define TXDESC32_USE_DRIVER_RATE	BIT(8)
539 #define TXDESC_DISABLE_DATA_FB		BIT(10)
540 #define TXDESC32_CTS_SELF_ENABLE	BIT(11)
541 #define TXDESC32_RTS_CTS_ENABLE		BIT(12)
542 #define TXDESC32_HW_RTS_ENABLE		BIT(13)
543 #define TXDESC32_PT_STAGE_MASK		GENMASK(17, 15)
544 #define TXDESC_PRIME_CH_OFF_LOWER	BIT(20)
545 #define TXDESC_PRIME_CH_OFF_UPPER	BIT(21)
546 #define TXDESC32_SHORT_PREAMBLE		BIT(24)
547 #define TXDESC_DATA_BW			BIT(25)
548 #define TXDESC_RTS_DATA_BW		BIT(27)
549 #define TXDESC_RTS_PRIME_CH_OFF_LOWER	BIT(28)
550 #define TXDESC_RTS_PRIME_CH_OFF_UPPER	BIT(29)
551 #define TXDESC40_DATA_RATE_FB_SHIFT	8
552 #define TXDESC40_DATA_RATE_FB_MASK	0x00001f00
553 #define TXDESC40_RETRY_LIMIT_ENABLE	BIT(17)
554 #define TXDESC40_RETRY_LIMIT_SHIFT	18
555 #define TXDESC40_RETRY_LIMIT_MASK	0x00fc0000
556 #define TXDESC40_RTS_RATE_SHIFT		24
557 #define TXDESC40_RTS_RATE_MASK		0x3f000000
558 
559 /* Word 5 */
560 #define TXDESC40_SHORT_PREAMBLE		BIT(4)
561 #define TXDESC32_SHORT_GI		BIT(6)
562 #define TXDESC_CCX_TAG			BIT(7)
563 #define TXDESC32_RETRY_LIMIT_ENABLE	BIT(17)
564 #define TXDESC32_RETRY_LIMIT_SHIFT	18
565 #define TXDESC32_RETRY_LIMIT_MASK	0x00fc0000
566 
567 /* Word 6 */
568 #define TXDESC_MAX_AGG_SHIFT		11
569 #define TXDESC_USB_TX_AGG_SHIT		24
570 
571 /* Word 7 */
572 #define TXDESC_ANTENNA_SELECT_C		BIT(29)
573 
574 /* Word 8 */
575 #define TXDESC40_HW_SEQ_ENABLE		BIT(15)
576 
577 /* Word 9 */
578 #define TXDESC40_SEQ_SHIFT		12
579 #define TXDESC40_SEQ_MASK		0x00fff000
580 
581 struct phy_rx_agc_info {
582 #ifdef __LITTLE_ENDIAN
583 	u8	gain:7, trsw:1;
584 #else
585 	u8	trsw:1, gain:7;
586 #endif
587 };
588 
589 #define CCK_AGC_RPT_LNA_IDX_MASK	GENMASK(7, 5)
590 #define CCK_AGC_RPT_VGA_IDX_MASK	GENMASK(4, 0)
591 
592 struct rtl8723au_phy_stats {
593 	struct phy_rx_agc_info path_agc[RTL8723A_MAX_RF_PATHS];
594 	u8	ch_corr[RTL8723A_MAX_RF_PATHS];
595 	u8	cck_sig_qual_ofdm_pwdb_all;
596 	u8	cck_agc_rpt_ofdm_cfosho_a;
597 	u8	cck_rpt_b_ofdm_cfosho_b;
598 	u8	reserved_1;
599 	u8	noise_power_db_msb;
600 	s8	path_cfotail[RTL8723A_MAX_RF_PATHS];
601 	u8	pcts_mask[RTL8723A_MAX_RF_PATHS];
602 	s8	stream_rxevm[RTL8723A_MAX_RF_PATHS];
603 	u8	path_rxsnr[RTL8723A_MAX_RF_PATHS];
604 	u8	noise_power_db_lsb;
605 	u8	reserved_2[3];
606 	u8	stream_csi[RTL8723A_MAX_RF_PATHS];
607 	u8	stream_target_csi[RTL8723A_MAX_RF_PATHS];
608 	s8	sig_evm;
609 	u8	reserved_3;
610 
611 #ifdef __LITTLE_ENDIAN
612 	u8	antsel_rx_keep_2:1;	/* ex_intf_flg:1; */
613 	u8	sgi_en:1;
614 	u8	rxsc:2;
615 	u8	idle_long:1;
616 	u8	r_ant_train_en:1;
617 	u8	antenna_select_b:1;
618 	u8	antenna_select:1;
619 #else	/*  _BIG_ENDIAN_ */
620 	u8	antenna_select:1;
621 	u8	antenna_select_b:1;
622 	u8	r_ant_train_en:1;
623 	u8	idle_long:1;
624 	u8	rxsc:2;
625 	u8	sgi_en:1;
626 	u8	antsel_rx_keep_2:1;	/* ex_intf_flg:1; */
627 #endif
628 };
629 
630 struct jaguar2_phy_stats_type0 {
631 	/* DW0 */
632 	u8		page_num;
633 	u8		pwdb;
634 #ifdef __LITTLE_ENDIAN
635 	u8		gain: 6;
636 	u8		rsvd_0: 1;
637 	u8		trsw: 1;
638 #else
639 	u8		trsw: 1;
640 	u8		rsvd_0: 1;
641 	u8		gain: 6;
642 #endif
643 	u8		rsvd_1;
644 
645 	/* DW1 */
646 	u8		rsvd_2;
647 #ifdef __LITTLE_ENDIAN
648 	u8		rxsc: 4;
649 	u8		agc_table: 4;
650 #else
651 	u8		agc_table: 4;
652 	u8		rxsc: 4;
653 #endif
654 	u8		channel;
655 	u8		band;
656 
657 	/* DW2 */
658 	u16		length;
659 #ifdef __LITTLE_ENDIAN
660 	u8		antidx_a: 3;
661 	u8		antidx_b: 3;
662 	u8		rsvd_3: 2;
663 	u8		antidx_c: 3;
664 	u8		antidx_d: 3;
665 	u8		rsvd_4:2;
666 #else
667 	u8		rsvd_3: 2;
668 	u8		antidx_b: 3;
669 	u8		antidx_a: 3;
670 	u8		rsvd_4:2;
671 	u8		antidx_d: 3;
672 	u8		antidx_c: 3;
673 #endif
674 
675 	/* DW3 */
676 	u8		signal_quality;
677 #ifdef __LITTLE_ENDIAN
678 	u8		vga:5;
679 	u8		lna_l:3;
680 	u8		bb_power:6;
681 	u8		rsvd_9:1;
682 	u8		lna_h:1;
683 #else
684 	u8		lna_l:3;
685 	u8		vga:5;
686 	u8		lna_h:1;
687 	u8		rsvd_9:1;
688 	u8		bb_power:6;
689 #endif
690 	u8		rsvd_5;
691 
692 	/* DW4 */
693 	u32		rsvd_6;
694 
695 	/* DW5 */
696 	u32		rsvd_7;
697 
698 	/* DW6 */
699 	u32		rsvd_8;
700 } __packed;
701 
702 struct jaguar2_phy_stats_type1 {
703 	/* DW0 and DW1 */
704 	u8		page_num;
705 	u8		pwdb[4];
706 #ifdef __LITTLE_ENDIAN
707 	u8		l_rxsc: 4;
708 	u8		ht_rxsc: 4;
709 #else
710 	u8		ht_rxsc: 4;
711 	u8		l_rxsc: 4;
712 #endif
713 	u8		channel;
714 #ifdef __LITTLE_ENDIAN
715 	u8		band: 2;
716 	u8		rsvd_0: 1;
717 	u8		hw_antsw_occu: 1;
718 	u8		gnt_bt: 1;
719 	u8		ldpc: 1;
720 	u8		stbc: 1;
721 	u8		beamformed: 1;
722 #else
723 	u8		beamformed: 1;
724 	u8		stbc: 1;
725 	u8		ldpc: 1;
726 	u8		gnt_bt: 1;
727 	u8		hw_antsw_occu: 1;
728 	u8		rsvd_0: 1;
729 	u8		band: 2;
730 #endif
731 
732 	/* DW2 */
733 	u16		lsig_length;
734 #ifdef __LITTLE_ENDIAN
735 	u8		antidx_a: 3;
736 	u8		antidx_b: 3;
737 	u8		rsvd_1: 2;
738 	u8		antidx_c: 3;
739 	u8		antidx_d: 3;
740 	u8		rsvd_2: 2;
741 #else
742 	u8		rsvd_1: 2;
743 	u8		antidx_b: 3;
744 	u8		antidx_a: 3;
745 	u8		rsvd_2: 2;
746 	u8		antidx_d: 3;
747 	u8		antidx_c: 3;
748 #endif
749 
750 	/* DW3 */
751 	u8		paid;
752 #ifdef __LITTLE_ENDIAN
753 	u8		paid_msb: 1;
754 	u8		gid: 6;
755 	u8		rsvd_3: 1;
756 #else
757 	u8		rsvd_3: 1;
758 	u8		gid: 6;
759 	u8		paid_msb: 1;
760 #endif
761 	u8		intf_pos;
762 #ifdef __LITTLE_ENDIAN
763 	u8		intf_pos_msb: 1;
764 	u8		rsvd_4: 2;
765 	u8		nb_intf_flag: 1;
766 	u8		rf_mode: 2;
767 	u8		rsvd_5: 2;
768 #else
769 	u8		rsvd_5: 2;
770 	u8		rf_mode: 2;
771 	u8		nb_intf_flag: 1;
772 	u8		rsvd_4: 2;
773 	u8		intf_pos_msb: 1;
774 #endif
775 
776 	/* DW4 */
777 	s8		rxevm[4];			/* s(8,1) */
778 
779 	/* DW5 */
780 	s8		cfo_tail[4];			/* s(8,7) */
781 
782 	/* DW6 */
783 	s8		rxsnr[4];			/* s(8,1) */
784 } __packed;
785 
786 struct jaguar2_phy_stats_type2 {
787 	/* DW0 ane DW1 */
788 	u8		page_num;
789 	u8		pwdb[4];
790 #ifdef __LITTLE_ENDIAN
791 	u8		l_rxsc: 4;
792 	u8		ht_rxsc: 4;
793 #else
794 	u8		ht_rxsc: 4;
795 	u8		l_rxsc: 4;
796 #endif
797 	u8		channel;
798 #ifdef __LITTLE_ENDIAN
799 	u8		band: 2;
800 	u8		rsvd_0: 1;
801 	u8		hw_antsw_occu: 1;
802 	u8		gnt_bt: 1;
803 	u8		ldpc: 1;
804 	u8		stbc: 1;
805 	u8		beamformed: 1;
806 #else
807 	u8		beamformed: 1;
808 	u8		stbc: 1;
809 	u8		ldpc: 1;
810 	u8		gnt_bt: 1;
811 	u8		hw_antsw_occu: 1;
812 	u8		rsvd_0: 1;
813 	u8		band: 2;
814 #endif
815 
816 	/* DW2 */
817 #ifdef __LITTLE_ENDIAN
818 	u8		shift_l_map: 6;
819 	u8		rsvd_1: 2;
820 #else
821 	u8		rsvd_1: 2;
822 	u8		shift_l_map: 6;
823 #endif
824 	u8		cnt_pw2cca;
825 #ifdef __LITTLE_ENDIAN
826 	u8		agc_table_a: 4;
827 	u8		agc_table_b: 4;
828 	u8		agc_table_c: 4;
829 	u8		agc_table_d: 4;
830 #else
831 	u8		agc_table_b: 4;
832 	u8		agc_table_a: 4;
833 	u8		agc_table_d: 4;
834 	u8		agc_table_c: 4;
835 #endif
836 
837 	/* DW3 ~ DW6*/
838 	u8		cnt_cca2agc_rdy;
839 #ifdef __LITTLE_ENDIAN
840 	u8		gain_a: 6;
841 	u8		rsvd_2: 1;
842 	u8		trsw_a: 1;
843 	u8		gain_b: 6;
844 	u8		rsvd_3: 1;
845 	u8		trsw_b: 1;
846 	u8		gain_c: 6;
847 	u8		rsvd_4: 1;
848 	u8		trsw_c: 1;
849 	u8		gain_d: 6;
850 	u8		rsvd_5: 1;
851 	u8		trsw_d: 1;
852 	u8		aagc_step_a: 2;
853 	u8		aagc_step_b: 2;
854 	u8		aagc_step_c: 2;
855 	u8		aagc_step_d: 2;
856 #else
857 	u8		trsw_a: 1;
858 	u8		rsvd_2: 1;
859 	u8		gain_a: 6;
860 	u8		trsw_b: 1;
861 	u8		rsvd_3: 1;
862 	u8		gain_b: 6;
863 	u8		trsw_c: 1;
864 	u8		rsvd_4: 1;
865 	u8		gain_c: 6;
866 	u8		trsw_d: 1;
867 	u8		rsvd_5: 1;
868 	u8		gain_d: 6;
869 	u8		aagc_step_d: 2;
870 	u8		aagc_step_c: 2;
871 	u8		aagc_step_b: 2;
872 	u8		aagc_step_a: 2;
873 #endif
874 	u8		ht_aagc_gain[4];
875 	u8		dagc_gain[4];
876 #ifdef __LITTLE_ENDIAN
877 	u8		counter: 6;
878 	u8		rsvd_6: 2;
879 	u8		syn_count: 5;
880 	u8		rsvd_7:3;
881 #else
882 	u8		rsvd_6: 2;
883 	u8		counter: 6;
884 	u8		rsvd_7:3;
885 	u8		syn_count: 5;
886 #endif
887 } __packed;
888 
889 /*
890  * Regs to backup
891  */
892 #define RTL8XXXU_ADDA_REGS		16
893 #define RTL8XXXU_MAC_REGS		4
894 #define RTL8XXXU_BB_REGS		9
895 
896 struct rtl8xxxu_firmware_header {
897 	__le16	signature;		/*  92C0: test chip; 92C,
898 					    88C0: test chip;
899 					    88C1: MP A-cut;
900 					    92C1: MP A-cut */
901 	u8	category;		/*  AP/NIC and USB/PCI */
902 	u8	function;
903 
904 	__le16	major_version;		/*  FW Version */
905 	u8	minor_version;		/*  FW Subversion, default 0x00 */
906 	u8	reserved1;
907 
908 	u8	month;			/*  Release time Month field */
909 	u8	date;			/*  Release time Date field */
910 	u8	hour;			/*  Release time Hour field */
911 	u8	minute;			/*  Release time Minute field */
912 
913 	__le16	ramcodesize;		/*  Size of RAM code */
914 	u16	reserved2;
915 
916 	__le32	svn_idx;		/*  SVN entry index */
917 	u32	reserved3;
918 
919 	u32	reserved4;
920 	u32	reserved5;
921 
922 	u8	data[];
923 };
924 
925 /*
926  * 8723au/8192cu/8188ru required base power index offset tables.
927  */
928 struct rtl8xxxu_power_base {
929 	u32 reg_0e00;
930 	u32 reg_0e04;
931 	u32 reg_0e08;
932 	u32 reg_086c;
933 
934 	u32 reg_0e10;
935 	u32 reg_0e14;
936 	u32 reg_0e18;
937 	u32 reg_0e1c;
938 
939 	u32 reg_0830;
940 	u32 reg_0834;
941 	u32 reg_0838;
942 	u32 reg_086c_2;
943 
944 	u32 reg_083c;
945 	u32 reg_0848;
946 	u32 reg_084c;
947 	u32 reg_0868;
948 };
949 
950 /*
951  * The 8723au has 3 channel groups: 1-3, 4-9, and 10-14
952  */
953 struct rtl8723au_idx {
954 #ifdef __LITTLE_ENDIAN
955 	int	a:4;
956 	int	b:4;
957 #else
958 	int	b:4;
959 	int	a:4;
960 #endif
961 } __attribute__((packed));
962 
963 struct rtl8723au_efuse {
964 	__le16 rtl_id;
965 	u8 res0[0xe];
966 	u8 cck_tx_power_index_A[3];	/* 0x10 */
967 	u8 cck_tx_power_index_B[3];
968 	u8 ht40_1s_tx_power_index_A[3];	/* 0x16 */
969 	u8 ht40_1s_tx_power_index_B[3];
970 	/*
971 	 * The following entries are half-bytes split as:
972 	 * bits 0-3: path A, bits 4-7: path B, all values 4 bits signed
973 	 */
974 	struct rtl8723au_idx ht20_tx_power_index_diff[3];
975 	struct rtl8723au_idx ofdm_tx_power_index_diff[3];
976 	struct rtl8723au_idx ht40_max_power_offset[3];
977 	struct rtl8723au_idx ht20_max_power_offset[3];
978 	u8 channel_plan;		/* 0x28 */
979 	u8 tssi_a;
980 	u8 thermal_meter;
981 	u8 rf_regulatory;
982 	u8 rf_option_2;
983 	u8 rf_option_3;
984 	u8 rf_option_4;
985 	u8 res7;
986 	u8 version			/* 0x30 */;
987 	u8 customer_id_major;
988 	u8 customer_id_minor;
989 	u8 xtal_k;
990 	u8 chipset;			/* 0x34 */
991 	u8 res8[0x82];
992 	u8 vid;				/* 0xb7 */
993 	u8 res9;
994 	u8 pid;				/* 0xb9 */
995 	u8 res10[0x0c];
996 	u8 mac_addr[ETH_ALEN];		/* 0xc6 */
997 	u8 res11[2];
998 	u8 vendor_name[7];
999 	u8 res12[2];
1000 	u8 device_name[0x29];		/* 0xd7 */
1001 };
1002 
1003 struct rtl8192cu_efuse {
1004 	__le16 rtl_id;
1005 	__le16 hpon;
1006 	u8 res0[2];
1007 	__le16 clk;
1008 	__le16 testr;
1009 	__le16 vid;
1010 	__le16 did;
1011 	__le16 svid;
1012 	__le16 smid;						/* 0x10 */
1013 	u8 res1[4];
1014 	u8 mac_addr[ETH_ALEN];					/* 0x16 */
1015 	u8 res2[2];
1016 	u8 vendor_name[7];
1017 	u8 res3[3];
1018 	u8 device_name[0x14];					/* 0x28 */
1019 	u8 res4[0x1e];						/* 0x3c */
1020 	u8 cck_tx_power_index_A[3];				/* 0x5a */
1021 	u8 cck_tx_power_index_B[3];
1022 	u8 ht40_1s_tx_power_index_A[3];				/* 0x60 */
1023 	u8 ht40_1s_tx_power_index_B[3];
1024 	/*
1025 	 * The following entries are half-bytes split as:
1026 	 * bits 0-3: path A, bits 4-7: path B, all values 4 bits signed
1027 	 */
1028 	struct rtl8723au_idx ht40_2s_tx_power_index_diff[3];
1029 	struct rtl8723au_idx ht20_tx_power_index_diff[3];	/* 0x69 */
1030 	struct rtl8723au_idx ofdm_tx_power_index_diff[3];
1031 	struct rtl8723au_idx ht40_max_power_offset[3];		/* 0x6f */
1032 	struct rtl8723au_idx ht20_max_power_offset[3];
1033 	u8 channel_plan;					/* 0x75 */
1034 	u8 tssi_a;
1035 	u8 tssi_b;
1036 	u8 thermal_meter;	/* xtal_k */			/* 0x78 */
1037 	u8 rf_regulatory;
1038 	u8 rf_option_2;
1039 	u8 rf_option_3;
1040 	u8 rf_option_4;
1041 	u8 res5[1];						/* 0x7d */
1042 	u8 version;
1043 	u8 customer_id;
1044 };
1045 
1046 struct rtl8723bu_pwr_idx {
1047 #ifdef __LITTLE_ENDIAN
1048 	int	ht20:4;
1049 	int	ht40:4;
1050 	int	ofdm:4;
1051 	int	cck:4;
1052 #else
1053 	int	cck:4;
1054 	int	ofdm:4;
1055 	int	ht40:4;
1056 	int	ht20:4;
1057 #endif
1058 } __attribute__((packed));
1059 
1060 struct rtl8723bu_efuse_tx_power {
1061 	u8 cck_base[6];
1062 	u8 ht40_base[5];
1063 	struct rtl8723au_idx ht20_ofdm_1s_diff;
1064 	struct rtl8723bu_pwr_idx pwr_diff[3];
1065 	u8 dummy5g[24]; /* max channel group (14) + power diff offset (10) */
1066 };
1067 
1068 struct rtl8723bu_efuse {
1069 	__le16 rtl_id;
1070 	u8 res0[0x0e];
1071 	struct rtl8723bu_efuse_tx_power tx_power_index_A;	/* 0x10 */
1072 	struct rtl8723bu_efuse_tx_power tx_power_index_B;	/* 0x3a */
1073 	struct rtl8723bu_efuse_tx_power tx_power_index_C;	/* 0x64 */
1074 	struct rtl8723bu_efuse_tx_power tx_power_index_D;	/* 0x8e */
1075 	u8 channel_plan;		/* 0xb8 */
1076 	u8 xtal_k;
1077 	u8 thermal_meter;
1078 	u8 iqk_lck;
1079 	u8 pa_type;			/* 0xbc */
1080 	u8 lna_type_2g;			/* 0xbd */
1081 	u8 res2[3];
1082 	u8 rf_board_option;
1083 	u8 rf_feature_option;
1084 	u8 rf_bt_setting;
1085 	u8 eeprom_version;
1086 	u8 eeprom_customer_id;
1087 	u8 res3[2];
1088 	u8 tx_pwr_calibrate_rate;
1089 	u8 rf_antenna_option;		/* 0xc9 */
1090 	u8 rfe_option;
1091 	u8 res4[9];
1092 	u8 usb_optional_function;
1093 	u8 res5[0x1e];
1094 	u8 res6[2];
1095 	u8 serial[0x0b];		/* 0xf5 */
1096 	u8 vid;				/* 0x100 */
1097 	u8 res7;
1098 	u8 pid;
1099 	u8 res8[4];
1100 	u8 mac_addr[ETH_ALEN];		/* 0x107 */
1101 	u8 res9[2];
1102 	u8 vendor_name[0x07];
1103 	u8 res10[2];
1104 	u8 device_name[0x14];
1105 	u8 res11[0xcf];
1106 	u8 package_type;		/* 0x1fb */
1107 	u8 res12[0x4];
1108 };
1109 
1110 struct rtl8192eu_efuse_tx_power {
1111 	u8 cck_base[6];
1112 	u8 ht40_base[5];
1113 	struct rtl8723au_idx ht20_ofdm_1s_diff;
1114 	struct rtl8723bu_pwr_idx pwr_diff[3];
1115 	u8 dummy5g[24]; /* max channel group (14) + power diff offset (10) */
1116 };
1117 
1118 struct rtl8192eu_efuse {
1119 	__le16 rtl_id;
1120 	u8 res0[0x0e];
1121 	struct rtl8192eu_efuse_tx_power tx_power_index_A;	/* 0x10 */
1122 	struct rtl8192eu_efuse_tx_power tx_power_index_B;	/* 0x3a */
1123 	u8 res2[0x54];
1124 	u8 channel_plan;		/* 0xb8 */
1125 	u8 xtal_k;
1126 	u8 thermal_meter;
1127 	u8 iqk_lck;
1128 	u8 pa_type;			/* 0xbc */
1129 	u8 lna_type_2g;			/* 0xbd */
1130 	u8 res3[1];
1131 	u8 lna_type_5g;			/* 0xbf */
1132 	u8 res4[1];
1133 	u8 rf_board_option;
1134 	u8 rf_feature_option;
1135 	u8 rf_bt_setting;
1136 	u8 eeprom_version;
1137 	u8 eeprom_customer_id;
1138 	u8 res5[3];
1139 	u8 rf_antenna_option;		/* 0xc9 */
1140 	u8 res6[6];
1141 	u8 vid;				/* 0xd0 */
1142 	u8 res7[1];
1143 	u8 pid;				/* 0xd2 */
1144 	u8 res8[1];
1145 	u8 usb_optional_function;
1146 	u8 res9[2];
1147 	u8 mac_addr[ETH_ALEN];		/* 0xd7 */
1148 	u8 device_info[80];
1149 	u8 res11[3];
1150 	u8 unknown[0x0d];		/* 0x130 */
1151 	u8 res12[0xc3];
1152 };
1153 
1154 struct rtl8188fu_efuse_tx_power {
1155 	u8 cck_base[6];
1156 	u8 ht40_base[5];
1157 	/* a: ofdm; b: ht20 */
1158 	struct rtl8723au_idx ht20_ofdm_1s_diff;
1159 };
1160 
1161 struct rtl8188fu_efuse {
1162 	__le16 rtl_id;
1163 	u8 res0[0x0e];
1164 	struct rtl8188fu_efuse_tx_power tx_power_index_A;	/* 0x10 */
1165 	u8 res1[0x9c];			/* 0x1c */
1166 	u8 channel_plan;		/* 0xb8 */
1167 	u8 xtal_k;
1168 	u8 thermal_meter;
1169 	u8 iqk_lck;
1170 	u8 res2[5];
1171 	u8 rf_board_option;
1172 	u8 rf_feature_option;
1173 	u8 rf_bt_setting;
1174 	u8 eeprom_version;
1175 	u8 eeprom_customer_id;
1176 	u8 res3[2];
1177 	u8 kfree_thermal_k_on;
1178 	u8 rf_antenna_option;		/* 0xc9 */
1179 	u8 rfe_option;
1180 	u8 country_code;
1181 	u8 res4[4];
1182 	u8 vid;				/* 0xd0 */
1183 	u8 res5[1];
1184 	u8 pid;				/* 0xd2 */
1185 	u8 res6[1];
1186 	u8 usb_optional_function;
1187 	u8 res7[2];
1188 	u8 mac_addr[ETH_ALEN];		/* 0xd7 */
1189 	u8 res8[2];
1190 	u8 vendor_name[7];
1191 	u8 res9[2];
1192 	u8 device_name[7];		/* 0xe8 */
1193 	u8 res10[0x41];
1194 	u8 unknown[0x0d];		/* 0x130 */
1195 	u8 res11[0xc3];
1196 };
1197 
1198 struct rtl8188eu_efuse {
1199 	__le16 rtl_id;
1200 	u8 res0[0x0e];
1201 	struct rtl8192eu_efuse_tx_power tx_power_index_A;	/* 0x10 */
1202 	u8 res1[0x7e];			/* 0x3a */
1203 	u8 channel_plan;		/* 0xb8 */
1204 	u8 xtal_k;
1205 	u8 thermal_meter;
1206 	u8 iqk_lck;
1207 	u8 res2[5];
1208 	u8 rf_board_option;
1209 	u8 rf_feature_option;
1210 	u8 rf_bt_setting;
1211 	u8 eeprom_version;
1212 	u8 eeprom_customer_id;
1213 	u8 res3[3];
1214 	u8 rf_antenna_option;		/* 0xc9 */
1215 	u8 res4[6];
1216 	u8 vid;				/* 0xd0 */
1217 	u8 res5[1];
1218 	u8 pid;				/* 0xd2 */
1219 	u8 res6[1];
1220 	u8 usb_optional_function;
1221 	u8 res7[2];
1222 	u8 mac_addr[ETH_ALEN];		/* 0xd7 */
1223 	u8 res8[2];
1224 	u8 vendor_name[7];
1225 	u8 res9[2];
1226 	u8 device_name[0x0b];		/* 0xe8 */
1227 	u8 res10[2];
1228 	u8 serial[0x0b];		/* 0xf5 */
1229 	u8 res11[0x30];
1230 	u8 unknown[0x0d];		/* 0x130 */
1231 	u8 res12[0xc3];
1232 } __packed;
1233 
1234 struct rtl8710bu_efuse {
1235 	__le16 rtl_id;
1236 	u8 res0[0x1e];
1237 	struct rtl8188fu_efuse_tx_power tx_power_index_A;	/* 0x20 */
1238 	u8 res1[0x9c];			/* 0x2c */
1239 	u8 channel_plan;		/* 0xc8 */
1240 	u8 xtal_k;			/* 0xc9 */
1241 	u8 thermal_meter;		/* 0xca */
1242 	u8 res2[0x4f];
1243 	u8 mac_addr[ETH_ALEN];		/* 0x11a */
1244 	u8 res3[0x11];
1245 	u8 rf_board_option;		/* 0x131 */
1246 	u8 res4[2];
1247 	u8 eeprom_version;		/* 0x134 */
1248 	u8 eeprom_customer_id;		/* 0x135 */
1249 	u8 res5[5];
1250 	u8 country_code;		/* 0x13b */
1251 	u8 res6[0x84];
1252 	u8 vid[2];			/* 0x1c0 */
1253 	u8 pid[2];			/* 0x1c2 */
1254 	u8 res7[0x3c];
1255 } __packed;
1256 
1257 struct rtl8192fu_efuse {
1258 	__le16 rtl_id;
1259 	u8 res0[0x0e];
1260 	struct rtl8192eu_efuse_tx_power tx_power_index_A;	/* 0x10 */
1261 	struct rtl8192eu_efuse_tx_power tx_power_index_B;	/* 0x3a */
1262 	u8 res2[0x54];
1263 	u8 channel_plan;		/* 0xb8 */
1264 	u8 xtal_k;			/* 0xb9 */
1265 	u8 thermal_meter;		/* 0xba */
1266 	u8 iqk_lck;			/* 0xbb */
1267 	u8 pa_type;			/* 0xbc */
1268 	u8 lna_type_2g;			/* 0xbd */
1269 	u8 res3[1];
1270 	u8 lna_type_5g;			/* 0xbf */
1271 	u8 res4[1];
1272 	u8 rf_board_option;		/* 0xc1 */
1273 	u8 rf_feature_option;		/* 0xc2 */
1274 	u8 rf_bt_setting;		/* 0xc3 */
1275 	u8 eeprom_version;		/* 0xc4 */
1276 	u8 eeprom_customer_id;		/* 0xc5 */
1277 	u8 res5[3];
1278 	u8 rf_antenna_option;		/* 0xc9 */
1279 	u8 rfe_option;			/* 0xca */
1280 	u8 country_code;		/* 0xcb */
1281 	u8 res6[52];
1282 	u8 vid[2];			/* 0x100 */
1283 	u8 pid[2];			/* 0x102 */
1284 	u8 usb_optional_function;	/* 0x104 */
1285 	u8 res7[2];
1286 	u8 mac_addr[ETH_ALEN];		/* 0x107 */
1287 	u8 device_info[80];		/* 0x10d */
1288 	u8 res9[163];
1289 } __packed;
1290 
1291 struct rtl8xxxu_reg8val {
1292 	u16 reg;
1293 	u8 val;
1294 };
1295 
1296 struct rtl8xxxu_reg32val {
1297 	u16 reg;
1298 	u32 val;
1299 };
1300 
1301 struct rtl8xxxu_rfregval {
1302 	u8 reg;
1303 	u32 val;
1304 };
1305 
1306 enum rtl8xxxu_rfpath {
1307 	RF_A = 0,
1308 	RF_B = 1,
1309 };
1310 
1311 struct rtl8xxxu_rfregs {
1312 	u16 hssiparm1;
1313 	u16 hssiparm2;
1314 	u16 lssiparm;
1315 	u16 hspiread;
1316 	u16 lssiread;
1317 	u16 rf_sw_ctrl;
1318 };
1319 
1320 #define H2C_MAX_MBOX			4
1321 #define H2C_EXT				BIT(7)
1322 #define  H2C_JOIN_BSS_DISCONNECT	0
1323 #define  H2C_JOIN_BSS_CONNECT		1
1324 
1325 #define H2C_MACID_ROLE_STA		1
1326 #define H2C_MACID_ROLE_AP		2
1327 
1328 /*
1329  * H2C (firmware) commands differ between the older generation chips
1330  * 8188[cr]u, 819[12]cu, and 8723au, and the more recent chips 8723bu,
1331  * 8192[de]u, 8192eu, and 8812.
1332  */
1333 enum h2c_cmd_8723a {
1334 	H2C_SET_POWER_MODE = 1,
1335 	H2C_JOIN_BSS_REPORT = 2,
1336 	H2C_SET_RSSI = 5,
1337 	H2C_SET_RATE_MASK = (6 | H2C_EXT),
1338 };
1339 
1340 enum h2c_cmd_8723b {
1341 	/*
1342 	 * Common Class: 000
1343 	 */
1344 	H2C_8723B_RSVD_PAGE = 0x00,
1345 	H2C_8723B_MEDIA_STATUS_RPT = 0x01,
1346 	H2C_8723B_SCAN_ENABLE = 0x02,
1347 	H2C_8723B_KEEP_ALIVE = 0x03,
1348 	H2C_8723B_DISCON_DECISION = 0x04,
1349 	H2C_8723B_PSD_OFFLOAD = 0x05,
1350 	H2C_8723B_AP_OFFLOAD = 0x08,
1351 	H2C_8723B_BCN_RSVDPAGE = 0x09,
1352 	H2C_8723B_PROBERSP_RSVDPAGE = 0x0A,
1353 	H2C_8723B_FCS_RSVDPAGE = 0x10,
1354 	H2C_8723B_FCS_INFO = 0x11,
1355 	H2C_8723B_AP_WOW_GPIO_CTRL = 0x13,
1356 
1357 	/*
1358 	 * PoweSave Class: 001
1359 	 */
1360 	H2C_8723B_SET_PWR_MODE = 0x20,
1361 	H2C_8723B_PS_TUNING_PARA = 0x21,
1362 	H2C_8723B_PS_TUNING_PARA2 = 0x22,
1363 	H2C_8723B_P2P_LPS_PARAM = 0x23,
1364 	H2C_8723B_P2P_PS_OFFLOAD = 0x24,
1365 	H2C_8723B_PS_SCAN_ENABLE = 0x25,
1366 	H2C_8723B_SAP_PS_ = 0x26,
1367 	H2C_8723B_INACTIVE_PS_ = 0x27,
1368 	H2C_8723B_FWLPS_IN_IPS_ = 0x28,
1369 
1370 	/*
1371 	 * Dynamic Mechanism Class: 010
1372 	 */
1373 	H2C_8723B_MACID_CFG_RAID = 0x40,
1374 	H2C_8723B_TXBF = 0x41,
1375 	H2C_8723B_RSSI_SETTING = 0x42,
1376 	H2C_8723B_AP_REQ_TXRPT = 0x43,
1377 	H2C_8723B_INIT_RATE_COLLECT = 0x44,
1378 
1379 	/*
1380 	 * BT Class: 011
1381 	 */
1382 	H2C_8723B_B_TYPE_TDMA = 0x60,
1383 	H2C_8723B_BT_INFO = 0x61,
1384 	H2C_8723B_FORCE_BT_TXPWR = 0x62,
1385 	H2C_8723B_BT_IGNORE_WLANACT = 0x63,
1386 	H2C_8723B_DAC_SWING_VALUE = 0x64,
1387 	H2C_8723B_ANT_SEL_RSV = 0x65,
1388 	H2C_8723B_WL_OPMODE = 0x66,
1389 	H2C_8723B_BT_MP_OPER = 0x67,
1390 	H2C_8723B_BT_CONTROL = 0x68,
1391 	H2C_8723B_BT_WIFI_CTRL = 0x69,
1392 	H2C_8723B_BT_FW_PATCH = 0x6a,
1393 	H2C_8723B_BT_WLAN_CALIBRATION = 0x6d,
1394 	H2C_8723B_BT_GRANT = 0x6e,
1395 
1396 	/*
1397 	 * WOWLAN Class: 100
1398 	 */
1399 	H2C_8723B_WOWLAN = 0x80,
1400 	H2C_8723B_REMOTE_WAKE_CTRL = 0x81,
1401 	H2C_8723B_AOAC_GLOBAL_INFO = 0x82,
1402 	H2C_8723B_AOAC_RSVD_PAGE = 0x83,
1403 	H2C_8723B_AOAC_RSVD_PAGE2 = 0x84,
1404 	H2C_8723B_D0_SCAN_OFFLOAD_CTRL = 0x85,
1405 	H2C_8723B_D0_SCAN_OFFLOAD_INFO = 0x86,
1406 	H2C_8723B_CHNL_SWITCH_OFFLOAD = 0x87,
1407 
1408 	H2C_8723B_RESET_TSF = 0xC0,
1409 };
1410 
1411 
1412 struct h2c_cmd {
1413 	union {
1414 		struct {
1415 			u8 cmd;
1416 			u8 data[7];
1417 		} __packed cmd;
1418 		struct {
1419 			__le32 data;
1420 			__le16 ext;
1421 		} __packed raw;
1422 		struct {
1423 			__le32 data;
1424 			__le32 ext;
1425 		} __packed raw_wide;
1426 		struct {
1427 			u8 cmd;
1428 			u8 data;
1429 		} __packed joinbss;
1430 		struct {
1431 			u8 cmd;
1432 			__le16 mask_hi;
1433 			u8 arg;
1434 			__le16 mask_lo;
1435 		} __packed ramask;
1436 		struct {
1437 			u8 cmd;
1438 			u8 parm;
1439 			u8 macid;
1440 			u8 macid_end;
1441 		} __packed media_status_rpt;
1442 		struct {
1443 			u8 cmd;
1444 			u8 macid;
1445 			/*
1446 			 * [0:4] - RAID
1447 			 * [7]   - SGI
1448 			 */
1449 			u8 data1;
1450 			/*
1451 			 * [0:1] - Bandwidth
1452 			 * [3]   - No Update
1453 			 * [4:5] - VHT enable
1454 			 * [6]   - DISPT
1455 			 * [7]   - DISRA
1456 			 */
1457 			u8 data2;
1458 			u8 ramask0;
1459 			u8 ramask1;
1460 			u8 ramask2;
1461 			u8 ramask3;
1462 		} __packed b_macid_cfg;
1463 		struct {
1464 			u8 cmd;
1465 			u8 data1;
1466 			u8 data2;
1467 			u8 data3;
1468 			u8 data4;
1469 			u8 data5;
1470 		} __packed b_type_dma;
1471 		struct {
1472 			u8 cmd;
1473 			u8 data;
1474 		} __packed bt_info;
1475 		struct {
1476 			u8 cmd;
1477 			u8 operreq;
1478 			u8 opcode;
1479 			u8 data;
1480 			u8 addr;
1481 		} __packed bt_mp_oper;
1482 		struct {
1483 			u8 cmd;
1484 			u8 data;
1485 		} __packed bt_wlan_calibration;
1486 		struct {
1487 			u8 cmd;
1488 			u8 data;
1489 		} __packed ignore_wlan;
1490 		struct {
1491 			u8 cmd;
1492 			u8 ant_inverse;
1493 			u8 int_switch_type;
1494 		} __packed ant_sel_rsv;
1495 		struct {
1496 			u8 cmd;
1497 			u8 data;
1498 		} __packed bt_grant;
1499 		struct {
1500 			u8 cmd;
1501 			u8 macid;
1502 			u8 unknown0;
1503 			u8 rssi;
1504 			/*
1505 			 * [0]   - is_rx
1506 			 * [1]   - stbc_en
1507 			 * [2]   - noisy_decision
1508 			 * [6]   - bf_en
1509 			 */
1510 			u8 data;
1511 			/*
1512 			 * [0:6] - ra_th_offset
1513 			 * [7]   - ra_offset_direction
1514 			 */
1515 			u8 ra_th_offset;
1516 			u8 unknown1;
1517 			u8 unknown2;
1518 		} __packed rssi_report;
1519 	};
1520 };
1521 
1522 enum c2h_evt_8723b {
1523 	C2H_8723B_DEBUG = 0,
1524 	C2H_8723B_TSF = 1,
1525 	C2H_8723B_AP_RPT_RSP = 2,
1526 	C2H_8723B_CCX_TX_RPT = 3,
1527 	C2H_8723B_BT_RSSI = 4,
1528 	C2H_8723B_BT_OP_MODE = 5,
1529 	C2H_8723B_EXT_RA_RPT = 6,
1530 	C2H_8723B_BT_INFO = 9,
1531 	C2H_8723B_HW_INFO_EXCH = 0x0a,
1532 	C2H_8723B_BT_MP_INFO = 0x0b,
1533 	C2H_8723B_RA_REPORT = 0x0c,
1534 	C2H_8723B_FW_DEBUG = 0xff,
1535 };
1536 
1537 enum bt_info_src_8723b {
1538 	BT_INFO_SRC_8723B_WIFI_FW = 0x0,
1539         BT_INFO_SRC_8723B_BT_RSP = 0x1,
1540         BT_INFO_SRC_8723B_BT_ACTIVE_SEND = 0x2,
1541 };
1542 
1543 enum bt_mp_oper_opcode_8723b {
1544 	BT_MP_OP_GET_BT_VERSION	= 0x00,
1545 	BT_MP_OP_RESET = 0x01,
1546 	BT_MP_OP_TEST_CTRL = 0x02,
1547 	BT_MP_OP_SET_BT_MODE = 0x03,
1548 	BT_MP_OP_SET_CHNL_TX_GAIN = 0x04,
1549 	BT_MP_OP_SET_PKT_TYPE_LEN = 0x05,
1550 	BT_MP_OP_SET_PKT_CNT_L_PL_TYPE = 0x06,
1551 	BT_MP_OP_SET_PKT_CNT_H_PKT_INTV = 0x07,
1552 	BT_MP_OP_SET_PKT_HEADER = 0x08,
1553 	BT_MP_OP_SET_WHITENCOEFF = 0x09,
1554 	BT_MP_OP_SET_BD_ADDR_L = 0x0a,
1555 	BT_MP_OP_SET_BD_ADDR_H = 0x0b,
1556 	BT_MP_OP_WRITE_REG_ADDR = 0x0c,
1557 	BT_MP_OP_WRITE_REG_VALUE = 0x0d,
1558 	BT_MP_OP_GET_BT_STATUS = 0x0e,
1559 	BT_MP_OP_GET_BD_ADDR_L = 0x0f,
1560 	BT_MP_OP_GET_BD_ADDR_H = 0x10,
1561 	BT_MP_OP_READ_REG = 0x11,
1562 	BT_MP_OP_SET_TARGET_BD_ADDR_L = 0x12,
1563 	BT_MP_OP_SET_TARGET_BD_ADDR_H = 0x13,
1564 	BT_MP_OP_SET_TX_POWER_CALIBRATION = 0x14,
1565 	BT_MP_OP_GET_RX_PKT_CNT_L = 0x15,
1566 	BT_MP_OP_GET_RX_PKT_CNT_H = 0x16,
1567 	BT_MP_OP_GET_RX_ERROR_BITS_L = 0x17,
1568 	BT_MP_OP_GET_RX_ERROR_BITS_H = 0x18,
1569 	BT_MP_OP_GET_RSSI = 0x19,
1570 	BT_MP_OP_GET_CFO_HDR_QUALITY_L = 0x1a,
1571 	BT_MP_OP_GET_CFO_HDR_QUALITY_H = 0x1b,
1572 	BT_MP_OP_GET_TARGET_BD_ADDR_L = 0x1c,
1573 	BT_MP_OP_GET_TARGET_BD_ADDR_H = 0x1d,
1574 	BT_MP_OP_GET_AFH_MAP_L = 0x1e,
1575 	BT_MP_OP_GET_AFH_MAP_M = 0x1f,
1576 	BT_MP_OP_GET_AFH_MAP_H = 0x20,
1577 	BT_MP_OP_GET_AFH_STATUS = 0x21,
1578 	BT_MP_OP_SET_TRACKING_INTERVAL = 0x22,
1579 	BT_MP_OP_SET_THERMAL_METER = 0x23,
1580 	BT_MP_OP_ENABLE_CFO_TRACKING = 0x24,
1581 };
1582 
1583 enum rtl8xxxu_bw_mode {
1584 	RTL8XXXU_CHANNEL_WIDTH_20 = 0,
1585 	RTL8XXXU_CHANNEL_WIDTH_40 = 1,
1586 	RTL8XXXU_CHANNEL_WIDTH_80 = 2,
1587 	RTL8XXXU_CHANNEL_WIDTH_160 = 3,
1588 	RTL8XXXU_CHANNEL_WIDTH_80_80 = 4,
1589 	RTL8XXXU_CHANNEL_WIDTH_MAX = 5,
1590 };
1591 
1592 struct rtl8723bu_c2h {
1593 	u8 id;
1594 	u8 seq;
1595 	union {
1596 		struct {
1597 			u8 payload[0];
1598 		} __packed raw;
1599 		struct {
1600 			u8 ext_id;
1601 			u8 status:4;
1602 			u8 retlen:4;
1603 			u8 opcode_ver:4;
1604 			u8 req_num:4;
1605 			u8 payload[2];
1606 		} __packed bt_mp_info;
1607 		struct {
1608 			u8 response_source:4;
1609 			u8 dummy0_0:4;
1610 
1611 			u8 bt_info;
1612 
1613 			u8 retry_count:4;
1614 			u8 dummy2_0:1;
1615 			u8 bt_page:1;
1616 			u8 tx_rx_mask:1;
1617 			u8 dummy2_2:1;
1618 
1619 			u8 rssi;
1620 
1621 			u8 basic_rate:1;
1622 			u8 bt_has_reset:1;
1623 			u8 dummy4_1:1;
1624 			u8 ignore_wlan:1;
1625 			u8 auto_report:1;
1626 			u8 dummy4_2:3;
1627 
1628 			u8 a4;
1629 			u8 a5;
1630 		} __packed bt_info;
1631 		struct {
1632 			u8 rate:7;
1633 			u8 sgi:1;
1634 			u8 macid;
1635 			u8 ldpc:1;
1636 			u8 txbf:1;
1637 			u8 noisy_state:1;
1638 			u8 dummy2_0:5;
1639 			u8 dummy3_0;
1640 			u8 dummy4_0;
1641 			u8 dummy5_0;
1642 			u8 bw;
1643 		} __packed ra_report;
1644 	};
1645 } __packed;
1646 
1647 struct rtl8xxxu_fileops;
1648 
1649 /*mlme related.*/
1650 enum wireless_mode {
1651 	WIRELESS_MODE_UNKNOWN = 0,
1652 	/* Sub-Element */
1653 	WIRELESS_MODE_B = BIT(0),
1654 	WIRELESS_MODE_G = BIT(1),
1655 	WIRELESS_MODE_A = BIT(2),
1656 	WIRELESS_MODE_N_24G = BIT(3),
1657 	WIRELESS_MODE_N_5G = BIT(4),
1658 	WIRELESS_AUTO = BIT(5),
1659 	WIRELESS_MODE_AC = BIT(6),
1660 	WIRELESS_MODE_MAX = 0x7F,
1661 };
1662 
1663 /* from rtlwifi/wifi.h */
1664 enum ratr_table_mode_new {
1665 	RATEID_IDX_BGN_40M_2SS = 0,
1666 	RATEID_IDX_BGN_40M_1SS = 1,
1667 	RATEID_IDX_BGN_20M_2SS_BN = 2,
1668 	RATEID_IDX_BGN_20M_1SS_BN = 3,
1669 	RATEID_IDX_GN_N2SS = 4,
1670 	RATEID_IDX_GN_N1SS = 5,
1671 	RATEID_IDX_BG = 6,
1672 	RATEID_IDX_G = 7,
1673 	RATEID_IDX_B = 8,
1674 	RATEID_IDX_VHT_2SS = 9,
1675 	RATEID_IDX_VHT_1SS = 10,
1676 	RATEID_IDX_MIX1 = 11,
1677 	RATEID_IDX_MIX2 = 12,
1678 	RATEID_IDX_VHT_3SS = 13,
1679 	RATEID_IDX_BGN_3SS = 14,
1680 };
1681 
1682 #define BT_INFO_8723B_1ANT_B_FTP		BIT(7)
1683 #define BT_INFO_8723B_1ANT_B_A2DP		BIT(6)
1684 #define BT_INFO_8723B_1ANT_B_HID		BIT(5)
1685 #define BT_INFO_8723B_1ANT_B_SCO_BUSY		BIT(4)
1686 #define BT_INFO_8723B_1ANT_B_ACL_BUSY		BIT(3)
1687 #define BT_INFO_8723B_1ANT_B_INQ_PAGE		BIT(2)
1688 #define BT_INFO_8723B_1ANT_B_SCO_ESCO		BIT(1)
1689 #define BT_INFO_8723B_1ANT_B_CONNECTION	BIT(0)
1690 
1691 enum _BT_8723B_1ANT_STATUS {
1692 	BT_8723B_1ANT_STATUS_NON_CONNECTED_IDLE      = 0x0,
1693 	BT_8723B_1ANT_STATUS_CONNECTED_IDLE          = 0x1,
1694 	BT_8723B_1ANT_STATUS_INQ_PAGE                = 0x2,
1695 	BT_8723B_1ANT_STATUS_ACL_BUSY                = 0x3,
1696 	BT_8723B_1ANT_STATUS_SCO_BUSY                = 0x4,
1697 	BT_8723B_1ANT_STATUS_ACL_SCO_BUSY            = 0x5,
1698 	BT_8723B_1ANT_STATUS_MAX
1699 };
1700 
1701 struct rtl8xxxu_btcoex {
1702 	u8      bt_status;
1703 	bool	bt_busy;
1704 	bool	has_sco;
1705 	bool	has_a2dp;
1706 	bool    has_hid;
1707 	bool    has_pan;
1708 	bool	hid_only;
1709 	bool	a2dp_only;
1710 	bool    c2h_bt_inquiry;
1711 };
1712 
1713 #define RTL8XXXU_RATR_STA_INIT 0
1714 #define RTL8XXXU_RATR_STA_HIGH 1
1715 #define RTL8XXXU_RATR_STA_MID  2
1716 #define RTL8XXXU_RATR_STA_LOW  3
1717 
1718 #define RTL8XXXU_NOISE_FLOOR_MIN	-100
1719 #define RTL8XXXU_SNR_THRESH_HIGH	50
1720 #define RTL8XXXU_SNR_THRESH_LOW	20
1721 
1722 struct rtl8xxxu_ra_report {
1723 	struct rate_info txrate;
1724 	u32 bit_rate;
1725 	u8 desc_rate;
1726 };
1727 
1728 struct rtl8xxxu_ra_info {
1729 	u8 rate_id;
1730 	u32 rate_mask;
1731 	u32 ra_use_rate;
1732 	u8 rate_sgi;
1733 	u8 rssi_sta_ra;		/* Percentage */
1734 	u8 pre_rssi_sta_ra;
1735 	u8 sgi_enable;
1736 	u8 decision_rate;
1737 	u8 pre_rate;
1738 	u8 highest_rate;
1739 	u8 lowest_rate;
1740 	u32 nsc_up;
1741 	u32 nsc_down;
1742 	u32 total;
1743 	u16 retry[5];
1744 	u16 drop;
1745 	u16 rpt_time;
1746 	u16 pre_min_rpt_time;
1747 	u8 dynamic_tx_rpt_timing_counter;
1748 	u8 ra_waiting_counter;
1749 	u8 ra_pending_counter;
1750 	u8 ra_drop_after_down;
1751 	u8 pt_try_state;	/* 0 trying state, 1 for decision state */
1752 	u8 pt_stage;		/* 0~6 */
1753 	u8 pt_stop_count;	/* Stop PT counter */
1754 	u8 pt_pre_rate;		/* if rate change do PT */
1755 	u8 pt_pre_rssi;		/* if RSSI change 5% do PT */
1756 	u8 pt_mode_ss;		/* decide which rate should do PT */
1757 	u8 ra_stage;		/* StageRA, decide how many times RA will be done between PT */
1758 	u8 pt_smooth_factor;
1759 };
1760 
1761 #define CFO_TH_XTAL_HIGH	20 /* kHz */
1762 #define CFO_TH_XTAL_LOW	10 /* kHz */
1763 #define CFO_TH_ATC		80 /* kHz */
1764 
1765 struct rtl8xxxu_cfo_tracking {
1766 	bool adjust;
1767 	bool atc_status;
1768 	int cfo_tail[2];
1769 	u8 crystal_cap;
1770 	u32 packet_count;
1771 	u32 packet_count_pre;
1772 };
1773 
1774 #define RTL8XXXU_HW_LED_CONTROL	2
1775 #define RTL8XXXU_MAX_MAC_ID_NUM	128
1776 #define RTL8XXXU_BC_MC_MACID	0
1777 
1778 struct rtl8xxxu_priv {
1779 	struct ieee80211_hw *hw;
1780 	struct usb_device *udev;
1781 	struct rtl8xxxu_fileops *fops;
1782 
1783 	spinlock_t tx_urb_lock;
1784 	struct list_head tx_urb_free_list;
1785 	int tx_urb_free_count;
1786 	bool tx_stopped;
1787 
1788 	spinlock_t rx_urb_lock;
1789 	struct list_head rx_urb_pending_list;
1790 	int rx_urb_pending_count;
1791 	bool shutdown;
1792 	struct work_struct rx_urb_wq;
1793 
1794 	u8 mac_addr[ETH_ALEN];
1795 	char chip_name[8];
1796 	char chip_vendor[8];
1797 	u8 cck_tx_power_index_A[RTL8XXXU_MAX_CHANNEL_GROUPS];
1798 	u8 cck_tx_power_index_B[RTL8XXXU_MAX_CHANNEL_GROUPS];
1799 	u8 ht40_1s_tx_power_index_A[RTL8XXXU_MAX_CHANNEL_GROUPS];
1800 	u8 ht40_1s_tx_power_index_B[RTL8XXXU_MAX_CHANNEL_GROUPS];
1801 	/*
1802 	 * The following entries are half-bytes split as:
1803 	 * bits 0-3: path A, bits 4-7: path B, all values 4 bits signed
1804 	 */
1805 	struct rtl8723au_idx ht40_2s_tx_power_index_diff[
1806 		RTL8723A_CHANNEL_GROUPS];
1807 	struct rtl8723au_idx ht20_tx_power_index_diff[RTL8723A_CHANNEL_GROUPS];
1808 	struct rtl8723au_idx ofdm_tx_power_index_diff[RTL8723A_CHANNEL_GROUPS];
1809 	struct rtl8723au_idx ht40_max_power_offset[RTL8723A_CHANNEL_GROUPS];
1810 	struct rtl8723au_idx ht20_max_power_offset[RTL8723A_CHANNEL_GROUPS];
1811 	/*
1812 	 * Newer generation chips only keep power diffs per TX count,
1813 	 * not per channel group.
1814 	 */
1815 	struct rtl8723au_idx ofdm_tx_power_diff[RTL8723B_TX_COUNT];
1816 	struct rtl8723au_idx ht20_tx_power_diff[RTL8723B_TX_COUNT];
1817 	struct rtl8723au_idx ht40_tx_power_diff[RTL8723B_TX_COUNT];
1818 	struct rtl8xxxu_power_base *power_base;
1819 	u8 package_type;
1820 	u32 chip_cut:4;
1821 	u32 rom_rev:4;
1822 	u32 is_multi_func:1;
1823 	u32 has_wifi:1;
1824 	u32 has_bluetooth:1;
1825 	u32 enable_bluetooth:1;
1826 	u32 has_gps:1;
1827 	u32 hi_pa:1;
1828 	u32 vendor_umc:1;
1829 	u32 vendor_smic:1;
1830 	u32 has_polarity_ctrl:1;
1831 	u32 has_eeprom:1;
1832 	u32 boot_eeprom:1;
1833 	u32 usb_interrupts:1;
1834 	u32 ep_tx_high_queue:1;
1835 	u32 ep_tx_normal_queue:1;
1836 	u32 ep_tx_low_queue:1;
1837 	u32 rx_buf_aggregation:1;
1838 	u32 cck_agc_report_type:1;
1839 	u32 cck_new_agc:1;
1840 	u8 default_crystal_cap;
1841 	u8 rfe_type;
1842 	unsigned int pipe_interrupt;
1843 	unsigned int pipe_in;
1844 	unsigned int pipe_out[TXDESC_QUEUE_MAX];
1845 	u8 out_ep[RTL8XXXU_OUT_ENDPOINTS];
1846 	u8 ep_tx_count;
1847 	u8 rf_paths;
1848 	u8 rx_paths;
1849 	u8 tx_paths;
1850 	u32 rege94;
1851 	u32 rege9c;
1852 	u32 regeb4;
1853 	u32 regebc;
1854 	u32 regrcr;
1855 	int next_mbox;
1856 	int nr_out_eps;
1857 
1858 	struct mutex h2c_mutex;
1859 	/* Protect the indirect register accesses of RTL8710BU. */
1860 	struct mutex syson_indirect_access_mutex;
1861 
1862 	struct usb_anchor rx_anchor;
1863 	struct usb_anchor tx_anchor;
1864 	struct usb_anchor int_anchor;
1865 	struct rtl8xxxu_firmware_header *fw_data;
1866 	size_t fw_size;
1867 	struct mutex usb_buf_mutex;
1868 	union {
1869 		__le32 val32;
1870 		__le16 val16;
1871 		u8 val8;
1872 	} usb_buf;
1873 	union {
1874 		u8 raw[EFUSE_MAP_LEN];
1875 		struct rtl8723au_efuse efuse8723;
1876 		struct rtl8723bu_efuse efuse8723bu;
1877 		struct rtl8192cu_efuse efuse8192;
1878 		struct rtl8192eu_efuse efuse8192eu;
1879 		struct rtl8188fu_efuse efuse8188fu;
1880 		struct rtl8188eu_efuse efuse8188eu;
1881 		struct rtl8710bu_efuse efuse8710bu;
1882 		struct rtl8192fu_efuse efuse8192fu;
1883 	} efuse_wifi;
1884 	u32 adda_backup[RTL8XXXU_ADDA_REGS];
1885 	u32 mac_backup[RTL8XXXU_MAC_REGS];
1886 	u32 bb_backup[RTL8XXXU_BB_REGS];
1887 	u32 bb_recovery_backup[RTL8XXXU_BB_REGS];
1888 	enum rtl8xxxu_rtl_chip rtl_chip;
1889 	u8 pi_enabled:1;
1890 	u8 no_pape:1;
1891 	u8 int_buf[USB_INTR_CONTENT_LENGTH];
1892 	u8 rssi_level;
1893 	DECLARE_BITMAP(tx_aggr_started, IEEE80211_NUM_TIDS);
1894 	DECLARE_BITMAP(tid_tx_operational, IEEE80211_NUM_TIDS);
1895 	/*
1896 	 * Only one virtual interface permitted because only STA mode
1897 	 * is supported and no iface_combinations are provided.
1898 	 */
1899 	struct ieee80211_vif *vif;
1900 	struct delayed_work ra_watchdog;
1901 	struct work_struct c2hcmd_work;
1902 	struct sk_buff_head c2hcmd_queue;
1903 	struct work_struct update_beacon_work;
1904 	struct rtl8xxxu_btcoex bt_coex;
1905 	struct rtl8xxxu_ra_report ra_report;
1906 	struct rtl8xxxu_cfo_tracking cfo_tracking;
1907 	struct rtl8xxxu_ra_info ra_info;
1908 
1909 	bool led_registered;
1910 	char led_name[32];
1911 	struct led_classdev led_cdev;
1912 	DECLARE_BITMAP(mac_id_map, RTL8XXXU_MAX_MAC_ID_NUM);
1913 };
1914 
1915 struct rtl8xxxu_sta_info {
1916 	struct ieee80211_sta *sta;
1917 	struct ieee80211_vif *vif;
1918 
1919 	u8 macid;
1920 };
1921 
1922 struct rtl8xxxu_rx_urb {
1923 	struct urb urb;
1924 	struct ieee80211_hw *hw;
1925 	struct list_head list;
1926 };
1927 
1928 struct rtl8xxxu_tx_urb {
1929 	struct urb urb;
1930 	struct ieee80211_hw *hw;
1931 	struct list_head list;
1932 };
1933 
1934 struct rtl8xxxu_fileops {
1935 	int (*identify_chip) (struct rtl8xxxu_priv *priv);
1936 	int (*read_efuse) (struct rtl8xxxu_priv *priv);
1937 	int (*parse_efuse) (struct rtl8xxxu_priv *priv);
1938 	int (*load_firmware) (struct rtl8xxxu_priv *priv);
1939 	int (*power_on) (struct rtl8xxxu_priv *priv);
1940 	void (*power_off) (struct rtl8xxxu_priv *priv);
1941 	void (*reset_8051) (struct rtl8xxxu_priv *priv);
1942 	int (*llt_init) (struct rtl8xxxu_priv *priv);
1943 	void (*init_phy_bb) (struct rtl8xxxu_priv *priv);
1944 	int (*init_phy_rf) (struct rtl8xxxu_priv *priv);
1945 	void (*phy_init_antenna_selection) (struct rtl8xxxu_priv *priv);
1946 	void (*phy_lc_calibrate) (struct rtl8xxxu_priv *priv);
1947 	void (*phy_iq_calibrate) (struct rtl8xxxu_priv *priv);
1948 	void (*config_channel) (struct ieee80211_hw *hw);
1949 	int (*parse_rx_desc) (struct rtl8xxxu_priv *priv, struct sk_buff *skb);
1950 	void (*parse_phystats) (struct rtl8xxxu_priv *priv,
1951 				struct ieee80211_rx_status *rx_status,
1952 				struct rtl8723au_phy_stats *phy_stats,
1953 				u32 rxmcs, struct ieee80211_hdr *hdr,
1954 				bool crc_icv_err);
1955 	void (*init_aggregation) (struct rtl8xxxu_priv *priv);
1956 	void (*init_statistics) (struct rtl8xxxu_priv *priv);
1957 	void (*init_burst) (struct rtl8xxxu_priv *priv);
1958 	void (*enable_rf) (struct rtl8xxxu_priv *priv);
1959 	void (*disable_rf) (struct rtl8xxxu_priv *priv);
1960 	void (*usb_quirks) (struct rtl8xxxu_priv *priv);
1961 	void (*set_tx_power) (struct rtl8xxxu_priv *priv, int channel,
1962 			      bool ht40);
1963 	void (*update_rate_mask) (struct rtl8xxxu_priv *priv,
1964 				  u32 ramask, u8 rateid, int sgi, int txbw_40mhz,
1965 				  u8 macid);
1966 	void (*report_connect) (struct rtl8xxxu_priv *priv,
1967 				u8 macid, u8 role, bool connect);
1968 	void (*report_rssi) (struct rtl8xxxu_priv *priv, u8 macid, u8 rssi);
1969 	void (*fill_txdesc) (struct ieee80211_hw *hw, struct ieee80211_hdr *hdr,
1970 			     struct ieee80211_tx_info *tx_info,
1971 			     struct rtl8xxxu_txdesc32 *tx_desc, bool sgi,
1972 			     bool short_preamble, bool ampdu_enable,
1973 			     u32 rts_rate, u8 macid);
1974 	void (*set_crystal_cap) (struct rtl8xxxu_priv *priv, u8 crystal_cap);
1975 	s8 (*cck_rssi) (struct rtl8xxxu_priv *priv, struct rtl8723au_phy_stats *phy_stats);
1976 	int (*led_classdev_brightness_set) (struct led_classdev *led_cdev,
1977 					    enum led_brightness brightness);
1978 	int writeN_block_size;
1979 	int rx_agg_buf_size;
1980 	char tx_desc_size;
1981 	char rx_desc_size;
1982 	u8 has_s0s1:1;
1983 	u8 has_tx_report:1;
1984 	u8 gen2_thermal_meter:1;
1985 	u8 needs_full_init:1;
1986 	u8 init_reg_rxfltmap:1;
1987 	u8 init_reg_pkt_life_time:1;
1988 	u8 init_reg_hmtfr:1;
1989 	u8 ampdu_max_time;
1990 	u8 ustime_tsf_edca;
1991 	u16 max_aggr_num;
1992 	u8 supports_ap:1;
1993 	u16 max_macid_num;
1994 	u32 adda_1t_init;
1995 	u32 adda_1t_path_on;
1996 	u32 adda_2t_path_on_a;
1997 	u32 adda_2t_path_on_b;
1998 	u16 trxff_boundary;
1999 	u8 pbp_rx;
2000 	u8 pbp_tx;
2001 	const struct rtl8xxxu_reg8val *mactable;
2002 	u8 total_page_num;
2003 	u8 page_num_hi;
2004 	u8 page_num_lo;
2005 	u8 page_num_norm;
2006 	u8 last_llt_entry;
2007 };
2008 
2009 extern int rtl8xxxu_debug;
2010 
2011 extern const struct rtl8xxxu_reg8val rtl8xxxu_gen1_mac_init_table[];
2012 extern const u32 rtl8xxxu_iqk_phy_iq_bb_reg[];
2013 u8 rtl8xxxu_read8(struct rtl8xxxu_priv *priv, u16 addr);
2014 u16 rtl8xxxu_read16(struct rtl8xxxu_priv *priv, u16 addr);
2015 u32 rtl8xxxu_read32(struct rtl8xxxu_priv *priv, u16 addr);
2016 int rtl8xxxu_write8(struct rtl8xxxu_priv *priv, u16 addr, u8 val);
2017 int rtl8xxxu_write16(struct rtl8xxxu_priv *priv, u16 addr, u16 val);
2018 int rtl8xxxu_write32(struct rtl8xxxu_priv *priv, u16 addr, u32 val);
2019 int rtl8xxxu_write8_set(struct rtl8xxxu_priv *priv, u16 addr, u8 bits);
2020 int rtl8xxxu_write8_clear(struct rtl8xxxu_priv *priv, u16 addr, u8 bits);
2021 int rtl8xxxu_write16_set(struct rtl8xxxu_priv *priv, u16 addr, u16 bits);
2022 int rtl8xxxu_write16_clear(struct rtl8xxxu_priv *priv, u16 addr, u16 bits);
2023 int rtl8xxxu_write32_set(struct rtl8xxxu_priv *priv, u16 addr, u32 bits);
2024 int rtl8xxxu_write32_clear(struct rtl8xxxu_priv *priv, u16 addr, u32 bits);
2025 int rtl8xxxu_write32_mask(struct rtl8xxxu_priv *priv, u16 addr,
2026 			  u32 mask, u32 val);
2027 
2028 u32 rtl8xxxu_read_rfreg(struct rtl8xxxu_priv *priv,
2029 			enum rtl8xxxu_rfpath path, u8 reg);
2030 int rtl8xxxu_write_rfreg(struct rtl8xxxu_priv *priv,
2031 			 enum rtl8xxxu_rfpath path, u8 reg, u32 data);
2032 int rtl8xxxu_write_rfreg_mask(struct rtl8xxxu_priv *priv,
2033 			      enum rtl8xxxu_rfpath path, u8 reg,
2034 			      u32 mask, u32 val);
2035 void rtl8xxxu_save_regs(struct rtl8xxxu_priv *priv, const u32 *regs,
2036 			u32 *backup, int count);
2037 void rtl8xxxu_restore_regs(struct rtl8xxxu_priv *priv, const u32 *regs,
2038 			   u32 *backup, int count);
2039 void rtl8xxxu_save_mac_regs(struct rtl8xxxu_priv *priv,
2040 			    const u32 *reg, u32 *backup);
2041 void rtl8xxxu_restore_mac_regs(struct rtl8xxxu_priv *priv,
2042 			       const u32 *reg, u32 *backup);
2043 void rtl8xxxu_path_adda_on(struct rtl8xxxu_priv *priv, const u32 *regs,
2044 			   bool path_a_on);
2045 void rtl8xxxu_mac_calibration(struct rtl8xxxu_priv *priv,
2046 			      const u32 *regs, u32 *backup);
2047 void rtl8xxxu_fill_iqk_matrix_a(struct rtl8xxxu_priv *priv, bool iqk_ok,
2048 				int result[][8], int candidate, bool tx_only);
2049 void rtl8xxxu_fill_iqk_matrix_b(struct rtl8xxxu_priv *priv, bool iqk_ok,
2050 				int result[][8], int candidate, bool tx_only);
2051 int rtl8xxxu_init_phy_rf(struct rtl8xxxu_priv *priv,
2052 			 const struct rtl8xxxu_rfregval *table,
2053 			 enum rtl8xxxu_rfpath path);
2054 int rtl8xxxu_init_phy_regs(struct rtl8xxxu_priv *priv,
2055 			   const struct rtl8xxxu_reg32val *array);
2056 int rtl8xxxu_load_firmware(struct rtl8xxxu_priv *priv, const char *fw_name);
2057 void rtl8xxxu_firmware_self_reset(struct rtl8xxxu_priv *priv);
2058 void rtl8xxxu_power_off(struct rtl8xxxu_priv *priv);
2059 void rtl8xxxu_identify_vendor_1bit(struct rtl8xxxu_priv *priv, u32 vendor);
2060 void rtl8xxxu_identify_vendor_2bits(struct rtl8xxxu_priv *priv, u32 vendor);
2061 void rtl8xxxu_config_endpoints_sie(struct rtl8xxxu_priv *priv);
2062 int rtl8xxxu_config_endpoints_no_sie(struct rtl8xxxu_priv *priv);
2063 int rtl8xxxu_read_efuse8(struct rtl8xxxu_priv *priv, u16 offset, u8 *data);
2064 int rtl8xxxu_read_efuse(struct rtl8xxxu_priv *priv);
2065 void rtl8xxxu_reset_8051(struct rtl8xxxu_priv *priv);
2066 int rtl8xxxu_auto_llt_table(struct rtl8xxxu_priv *priv);
2067 void rtl8xxxu_gen2_prepare_calibrate(struct rtl8xxxu_priv *priv, u8 start);
2068 void rtl8723a_phy_lc_calibrate(struct rtl8xxxu_priv *priv);
2069 void rtl8188f_phy_lc_calibrate(struct rtl8xxxu_priv *priv);
2070 int rtl8xxxu_flush_fifo(struct rtl8xxxu_priv *priv);
2071 int rtl8xxxu_gen2_h2c_cmd(struct rtl8xxxu_priv *priv,
2072 			  struct h2c_cmd *h2c, int len);
2073 int rtl8xxxu_active_to_lps(struct rtl8xxxu_priv *priv);
2074 void rtl8xxxu_disabled_to_emu(struct rtl8xxxu_priv *priv);
2075 int rtl8xxxu_init_llt_table(struct rtl8xxxu_priv *priv);
2076 void rtl8xxxu_gen1_phy_iq_calibrate(struct rtl8xxxu_priv *priv);
2077 void rtl8xxxu_gen1_init_phy_bb(struct rtl8xxxu_priv *priv);
2078 void rtl8xxxu_gen1_set_tx_power(struct rtl8xxxu_priv *priv,
2079 				int channel, bool ht40);
2080 void rtl8188f_channel_to_group(int channel, int *group, int *cck_group);
2081 void rtl8188f_set_tx_power(struct rtl8xxxu_priv *priv,
2082 			   int channel, bool ht40);
2083 void rtl8xxxu_gen1_config_channel(struct ieee80211_hw *hw);
2084 void rtl8xxxu_gen2_config_channel(struct ieee80211_hw *hw);
2085 void rtl8xxxu_gen1_usb_quirks(struct rtl8xxxu_priv *priv);
2086 void rtl8xxxu_gen2_usb_quirks(struct rtl8xxxu_priv *priv);
2087 void rtl8xxxu_update_rate_mask(struct rtl8xxxu_priv *priv,
2088 			       u32 ramask, u8 rateid, int sgi, int txbw_40mhz, u8 macid);
2089 void rtl8xxxu_gen2_update_rate_mask(struct rtl8xxxu_priv *priv,
2090 				    u32 ramask, u8 rateid, int sgi, int txbw_40mhz, u8 macid);
2091 void rtl8xxxu_gen1_report_connect(struct rtl8xxxu_priv *priv,
2092 				  u8 macid, u8 role, bool connect);
2093 void rtl8xxxu_gen2_report_connect(struct rtl8xxxu_priv *priv,
2094 				  u8 macid, u8 role, bool connect);
2095 void rtl8xxxu_gen1_report_rssi(struct rtl8xxxu_priv *priv, u8 macid, u8 rssi);
2096 void rtl8xxxu_gen2_report_rssi(struct rtl8xxxu_priv *priv, u8 macid, u8 rssi);
2097 void rtl8xxxu_gen1_init_aggregation(struct rtl8xxxu_priv *priv);
2098 void rtl8xxxu_gen1_enable_rf(struct rtl8xxxu_priv *priv);
2099 void rtl8xxxu_gen1_disable_rf(struct rtl8xxxu_priv *priv);
2100 void rtl8xxxu_gen2_disable_rf(struct rtl8xxxu_priv *priv);
2101 void rtl8xxxu_init_burst(struct rtl8xxxu_priv *priv);
2102 int rtl8xxxu_parse_rxdesc16(struct rtl8xxxu_priv *priv, struct sk_buff *skb);
2103 int rtl8xxxu_parse_rxdesc24(struct rtl8xxxu_priv *priv, struct sk_buff *skb);
2104 void rtl8723au_rx_parse_phystats(struct rtl8xxxu_priv *priv,
2105 				 struct ieee80211_rx_status *rx_status,
2106 				 struct rtl8723au_phy_stats *phy_stats,
2107 				 u32 rxmcs, struct ieee80211_hdr *hdr,
2108 				 bool crc_icv_err);
2109 void jaguar2_rx_parse_phystats(struct rtl8xxxu_priv *priv,
2110 			       struct ieee80211_rx_status *rx_status,
2111 			       struct rtl8723au_phy_stats *phy_stats,
2112 			       u32 rxmcs, struct ieee80211_hdr *hdr,
2113 			       bool crc_icv_err);
2114 int rtl8xxxu_gen2_channel_to_group(int channel);
2115 bool rtl8xxxu_simularity_compare(struct rtl8xxxu_priv *priv,
2116 				 int result[][8], int c1, int c2);
2117 bool rtl8xxxu_gen2_simularity_compare(struct rtl8xxxu_priv *priv,
2118 				      int result[][8], int c1, int c2);
2119 void rtl8xxxu_fill_txdesc_v1(struct ieee80211_hw *hw, struct ieee80211_hdr *hdr,
2120 			     struct ieee80211_tx_info *tx_info,
2121 			     struct rtl8xxxu_txdesc32 *tx_desc, bool sgi,
2122 			     bool short_preamble, bool ampdu_enable,
2123 			     u32 rts_rate, u8 macid);
2124 void rtl8xxxu_fill_txdesc_v2(struct ieee80211_hw *hw, struct ieee80211_hdr *hdr,
2125 			     struct ieee80211_tx_info *tx_info,
2126 			     struct rtl8xxxu_txdesc32 *tx_desc32, bool sgi,
2127 			     bool short_preamble, bool ampdu_enable,
2128 			     u32 rts_rate, u8 macid);
2129 void rtl8xxxu_fill_txdesc_v3(struct ieee80211_hw *hw, struct ieee80211_hdr *hdr,
2130 			     struct ieee80211_tx_info *tx_info,
2131 			     struct rtl8xxxu_txdesc32 *tx_desc32, bool sgi,
2132 			     bool short_preamble, bool ampdu_enable,
2133 			     u32 rts_rate, u8 macid);
2134 void rtl8723bu_set_ps_tdma(struct rtl8xxxu_priv *priv,
2135 			   u8 arg1, u8 arg2, u8 arg3, u8 arg4, u8 arg5);
2136 void rtl8723bu_phy_init_antenna_selection(struct rtl8xxxu_priv *priv);
2137 void rtl8723a_set_crystal_cap(struct rtl8xxxu_priv *priv, u8 crystal_cap);
2138 void rtl8188f_set_crystal_cap(struct rtl8xxxu_priv *priv, u8 crystal_cap);
2139 s8 rtl8723a_cck_rssi(struct rtl8xxxu_priv *priv, struct rtl8723au_phy_stats *phy_stats);
2140 void rtl8xxxu_update_ra_report(struct rtl8xxxu_ra_report *rarpt,
2141 			       u8 rate, u8 sgi, u8 bw);
2142 void rtl8188e_ra_info_init_all(struct rtl8xxxu_ra_info *ra);
2143 void rtl8188e_handle_ra_tx_report2(struct rtl8xxxu_priv *priv, struct sk_buff *skb);
2144 
2145 extern struct rtl8xxxu_fileops rtl8192fu_fops;
2146 extern struct rtl8xxxu_fileops rtl8710bu_fops;
2147 extern struct rtl8xxxu_fileops rtl8188fu_fops;
2148 extern struct rtl8xxxu_fileops rtl8188eu_fops;
2149 extern struct rtl8xxxu_fileops rtl8192cu_fops;
2150 extern struct rtl8xxxu_fileops rtl8192eu_fops;
2151 extern struct rtl8xxxu_fileops rtl8723au_fops;
2152 extern struct rtl8xxxu_fileops rtl8723bu_fops;
2153