xref: /OK3568_Linux_fs/kernel/drivers/net/wireless/rockchip_wlan/rtl8723bs/include/rtw_xmit.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1 /******************************************************************************
2  *
3  * Copyright(c) 2007 - 2017 Realtek Corporation.
4  *
5  * This program is free software; you can redistribute it and/or modify it
6  * under the terms of version 2 of the GNU General Public License as
7  * published by the Free Software Foundation.
8  *
9  * This program is distributed in the hope that it will be useful, but WITHOUT
10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
12  * more details.
13  *
14  *****************************************************************************/
15 #ifndef _RTW_XMIT_H_
16 #define _RTW_XMIT_H_
17 
18 
19 #if defined(CONFIG_SDIO_HCI) || defined(CONFIG_GSPI_HCI)
20 	#ifdef CONFIG_TX_AGGREGATION
21 		#define MAX_XMITBUF_SZ	(20480)	/* 20k */
22 		/* #define SDIO_TX_AGG_MAX	5 */
23 	#else
24 		#define MAX_XMITBUF_SZ (1664)
25 		#define SDIO_TX_AGG_MAX	1
26 	#endif
27 
28 	#if defined CONFIG_SDIO_HCI
29 		#define NR_XMITBUFF	(16)
30 	#endif
31 	#if defined(CONFIG_GSPI_HCI)
32 		#define NR_XMITBUFF	(128)
33 	#endif
34 
35 #elif defined (CONFIG_USB_HCI)
36 
37 	#ifdef CONFIG_USB_TX_AGGREGATION
38 		#if defined(CONFIG_PLATFORM_ARM_SUNxI) || defined(CONFIG_PLATFORM_ARM_SUN6I) || defined(CONFIG_PLATFORM_ARM_SUN7I) || defined(CONFIG_PLATFORM_ARM_SUN8I) || defined(CONFIG_PLATFORM_ARM_SUN50IW1P1)
39 			#define MAX_XMITBUF_SZ (12288)  /* 12k 1536*8 */
40 		#elif defined (CONFIG_PLATFORM_MSTAR)
41 			#define MAX_XMITBUF_SZ	7680	/* 7.5k */
42 		#else
43 			#define MAX_XMITBUF_SZ	(20480)	/* 20k */
44 		#endif
45 	#else
46 		#define MAX_XMITBUF_SZ	(2048)
47 	#endif
48 
49 	#ifdef CONFIG_SINGLE_XMIT_BUF
50 		#define NR_XMITBUFF	(1)
51 	#else
52 		#define NR_XMITBUFF	(4)
53 	#endif /* CONFIG_SINGLE_XMIT_BUF */
54 #elif defined (CONFIG_PCI_HCI)
55 #ifdef CONFIG_TX_AMSDU
56 	#define MAX_XMITBUF_SZ	(3500)
57 #else
58 	#define MAX_XMITBUF_SZ	(1664)
59 #endif
60 	#define NR_XMITBUFF	(128)
61 #endif
62 
63 #ifdef PLATFORM_OS_CE
64 	#define XMITBUF_ALIGN_SZ 4
65 #else
66 	#ifdef CONFIG_PCI_HCI
67 		#define XMITBUF_ALIGN_SZ 4
68 	#else
69 		#ifdef USB_XMITBUF_ALIGN_SZ
70 			#define XMITBUF_ALIGN_SZ (USB_XMITBUF_ALIGN_SZ)
71 		#else
72 			#define XMITBUF_ALIGN_SZ 512
73 		#endif
74 	#endif
75 #endif
76 
77 /* xmit extension buff defination */
78 #define MAX_XMIT_EXTBUF_SZ	(1536)
79 
80 #ifdef CONFIG_SINGLE_XMIT_BUF
81 	#define NR_XMIT_EXTBUFF	(1)
82 #else
83 	#define NR_XMIT_EXTBUFF	(32)
84 #endif
85 
86 #ifdef CONFIG_RTL8812A
87 	#define MAX_CMDBUF_SZ	(512 * 17)
88 #elif defined(CONFIG_RTL8723D) && defined(CONFIG_LPS_POFF)
89 	#define MAX_CMDBUF_SZ	(128*70) /*(8960)*/
90 #else
91 	#define MAX_CMDBUF_SZ	(5120)	/* (4096) */
92 #endif
93 
94 #define MAX_NUMBLKS		(1)
95 
96 #define XMIT_VO_QUEUE (0)
97 #define XMIT_VI_QUEUE (1)
98 #define XMIT_BE_QUEUE (2)
99 #define XMIT_BK_QUEUE (3)
100 
101 #define VO_QUEUE_INX		0
102 #define VI_QUEUE_INX		1
103 #define BE_QUEUE_INX		2
104 #define BK_QUEUE_INX		3
105 #define BCN_QUEUE_INX		4
106 #define MGT_QUEUE_INX		5
107 #define HIGH_QUEUE_INX		6
108 #define TXCMD_QUEUE_INX	7
109 
110 #define HW_QUEUE_ENTRY	8
111 
112 #ifdef CONFIG_PCI_HCI
113 	#ifdef CONFIG_TRX_BD_ARCH
114 		#define TX_BD_NUM			(128+1)	/* +1 result from ring buffer */
115 	#else
116 		#define TXDESC_NUM			128
117 	#endif
118 #endif
119 
120 #define WEP_IV(pattrib_iv, dot11txpn, keyidx)\
121 	do {\
122 		pattrib_iv[0] = dot11txpn._byte_.TSC0;\
123 		pattrib_iv[1] = dot11txpn._byte_.TSC1;\
124 		pattrib_iv[2] = dot11txpn._byte_.TSC2;\
125 		pattrib_iv[3] = ((keyidx & 0x3)<<6);\
126 		dot11txpn.val = (dot11txpn.val == 0xffffff) ? 0 : (dot11txpn.val+1);\
127 	} while (0)
128 
129 
130 #define TKIP_IV(pattrib_iv, dot11txpn, keyidx)\
131 	do {\
132 		pattrib_iv[0] = dot11txpn._byte_.TSC1;\
133 		pattrib_iv[1] = (dot11txpn._byte_.TSC1 | 0x20) & 0x7f;\
134 		pattrib_iv[2] = dot11txpn._byte_.TSC0;\
135 		pattrib_iv[3] = BIT(5) | ((keyidx & 0x3)<<6);\
136 		pattrib_iv[4] = dot11txpn._byte_.TSC2;\
137 		pattrib_iv[5] = dot11txpn._byte_.TSC3;\
138 		pattrib_iv[6] = dot11txpn._byte_.TSC4;\
139 		pattrib_iv[7] = dot11txpn._byte_.TSC5;\
140 		dot11txpn.val = dot11txpn.val == 0xffffffffffffULL ? 0 : (dot11txpn.val+1);\
141 	} while (0)
142 
143 #define AES_IV(pattrib_iv, dot11txpn, keyidx)\
144 	do {\
145 		pattrib_iv[0] = dot11txpn._byte_.TSC0;\
146 		pattrib_iv[1] = dot11txpn._byte_.TSC1;\
147 		pattrib_iv[2] = 0;\
148 		pattrib_iv[3] = BIT(5) | ((keyidx & 0x3)<<6);\
149 		pattrib_iv[4] = dot11txpn._byte_.TSC2;\
150 		pattrib_iv[5] = dot11txpn._byte_.TSC3;\
151 		pattrib_iv[6] = dot11txpn._byte_.TSC4;\
152 		pattrib_iv[7] = dot11txpn._byte_.TSC5;\
153 		dot11txpn.val = dot11txpn.val == 0xffffffffffffULL ? 0 : (dot11txpn.val+1);\
154 	} while (0)
155 
156 /* Check if AMPDU Tx is supported or not. If it is supported,
157 * it need to check "amsdu in ampdu" is supported or not.
158 * (ampdu_en, amsdu_ampdu_en) =
159 * (0, x) : AMPDU is not enable, but AMSDU is valid to send.
160 * (1, 0) : AMPDU is enable, AMSDU in AMPDU is not enable. So, AMSDU is not valid to send.
161 * (1, 1) : AMPDU and AMSDU in AMPDU are enable. So, AMSDU is valid to send.
162 */
163 #define IS_AMSDU_AMPDU_NOT_VALID(pattrib)\
164 	 ((pattrib->ampdu_en == _TRUE) && (pattrib->amsdu_ampdu_en == _FALSE))
165 
166 #define IS_AMSDU_AMPDU_VALID(pattrib)\
167 	 !((pattrib->ampdu_en == _TRUE) && (pattrib->amsdu_ampdu_en == _FALSE))
168 
169 #define HWXMIT_ENTRY	4
170 
171 /* For Buffer Descriptor ring architecture */
172 #if defined(BUF_DESC_ARCH) || defined(CONFIG_TRX_BD_ARCH)
173 	#if defined(CONFIG_RTL8192E)
174 		#define TX_BUFFER_SEG_NUM	1 /* 0:2 seg, 1: 4 seg, 2: 8 seg. */
175 	#elif defined(CONFIG_RTL8814A)
176 		#define TX_BUFFER_SEG_NUM	1 /* 0:2 seg, 1: 4 seg, 2: 8 seg. */
177 	#else
178 		#define TX_BUFFER_SEG_NUM	1 /* 0:2 seg, 1: 4 seg, 2: 8 seg. */
179 	#endif
180 #endif
181 
182 #if defined(CONFIG_RTL8812A) || defined(CONFIG_RTL8821A) ||\
183 	defined(CONFIG_RTL8723B) || defined(CONFIG_RTL8192E) ||\
184 	defined(CONFIG_RTL8814A) || defined(CONFIG_RTL8703B) ||\
185 	defined(CONFIG_RTL8188F) || defined(CONFIG_RTL8723D)
186 	#define TXDESC_SIZE 40
187 #elif defined(CONFIG_RTL8822B)
188 	#define TXDESC_SIZE 48		/* HALMAC_TX_DESC_SIZE_8822B */
189 #elif defined(CONFIG_RTL8821C)
190 	#define TXDESC_SIZE 48		/* HALMAC_TX_DESC_SIZE_8821C */
191 #else
192 	#define TXDESC_SIZE 32 /* old IC (ex: 8188E) */
193 #endif
194 
195 #ifdef CONFIG_TX_EARLY_MODE
196 	#define EARLY_MODE_INFO_SIZE	8
197 #endif
198 
199 
200 #if defined(CONFIG_SDIO_HCI) || defined(CONFIG_GSPI_HCI)
201 	#define TXDESC_OFFSET TXDESC_SIZE
202 #endif
203 
204 #ifdef CONFIG_USB_HCI
205 	#ifdef USB_PACKET_OFFSET_SZ
206 		#define PACKET_OFFSET_SZ (USB_PACKET_OFFSET_SZ)
207 	#else
208 		#define PACKET_OFFSET_SZ (8)
209 	#endif
210 	#define TXDESC_OFFSET (TXDESC_SIZE + PACKET_OFFSET_SZ)
211 #endif
212 
213 #ifdef CONFIG_PCI_HCI
214 	#if defined(CONFIG_RTL8192E) || defined(CONFIG_RTL8814A) || defined(CONFIG_RTL8822B) || defined(CONFIG_RTL8821C) || defined(CONFIG_TRX_BD_ARCH)
215 		/* this section is defined for buffer descriptor ring architecture */
216 		#define TX_WIFI_INFO_SIZE (TXDESC_SIZE) /* it may add 802.11 hdr or others... */
217 		/* tx desc and payload are in the same buf */
218 		#define TXDESC_OFFSET (TX_WIFI_INFO_SIZE)
219 	#else
220 		/* tx desc and payload are NOT in the same buf */
221 		#define TXDESC_OFFSET (0)
222 		/* 8188ee/8723be/8812ae/8821ae has extra PCI DMA info in tx desc */
223 		#define TX_DESC_NEXT_DESC_OFFSET	(TXDESC_SIZE + 8)
224 	#endif
225 #endif /* CONFIG_PCI_HCI */
226 
227 enum TXDESC_SC {
228 	SC_DONT_CARE = 0x00,
229 	SC_UPPER = 0x01,
230 	SC_LOWER = 0x02,
231 	SC_DUPLICATE = 0x03
232 };
233 
234 #ifdef CONFIG_PCI_HCI
235 	#ifndef CONFIG_TRX_BD_ARCH	/* CONFIG_TRX_BD_ARCH doesn't need this */
236 		#define TXDESC_64_BYTES
237 	#endif
238 #elif defined(CONFIG_RTL8812A) || defined(CONFIG_RTL8821A) || defined(CONFIG_RTL8723B) \
239 	|| defined(CONFIG_RTL8188F) || defined(CONFIG_RTL8723D)
240 	#define TXDESC_40_BYTES
241 #endif
242 
243 #ifdef CONFIG_TRX_BD_ARCH
244 struct tx_buf_desc {
245 #ifdef CONFIG_64BIT_DMA
246 #define TX_BUFFER_SEG_SIZE	4	/* in unit of DWORD */
247 #else
248 #define TX_BUFFER_SEG_SIZE	2	/* in unit of DWORD */
249 #endif
250 	unsigned int dword[TX_BUFFER_SEG_SIZE * (2 << TX_BUFFER_SEG_NUM)];
251 } __packed;
252 #elif (defined(CONFIG_RTL8192E) || defined(CONFIG_RTL8814A) || defined(CONFIG_RTL8822B)) && defined(CONFIG_PCI_HCI) /* 8192ee or 8814ae */
253 /* 8192EE_TODO */
254 struct tx_desc {
255 	unsigned int txdw0;
256 	unsigned int txdw1;
257 	unsigned int txdw2;
258 	unsigned int txdw3;
259 	unsigned int txdw4;
260 	unsigned int txdw5;
261 	unsigned int txdw6;
262 	unsigned int txdw7;
263 };
264 #else
265 struct tx_desc {
266 	unsigned int txdw0;
267 	unsigned int txdw1;
268 	unsigned int txdw2;
269 	unsigned int txdw3;
270 	unsigned int txdw4;
271 	unsigned int txdw5;
272 	unsigned int txdw6;
273 	unsigned int txdw7;
274 
275 #if defined(TXDESC_40_BYTES) || defined(TXDESC_64_BYTES)
276 	unsigned int txdw8;
277 	unsigned int txdw9;
278 #endif /* TXDESC_40_BYTES */
279 
280 #ifdef TXDESC_64_BYTES
281 	unsigned int txdw10;
282 	unsigned int txdw11;
283 
284 	/* 2008/05/15 MH Because PCIE HW memory R/W 4K limit. And now,  our descriptor */
285 	/* size is 40 bytes. If you use more than 102 descriptor( 103*40>4096), HW will execute */
286 	/* memoryR/W CRC error. And then all DMA fetch will fail. We must decrease descriptor */
287 	/* number or enlarge descriptor size as 64 bytes. */
288 	unsigned int txdw12;
289 	unsigned int txdw13;
290 	unsigned int txdw14;
291 	unsigned int txdw15;
292 #endif
293 };
294 #endif
295 
296 #ifndef CONFIG_TRX_BD_ARCH
297 union txdesc {
298 	struct tx_desc txdesc;
299 	unsigned int value[TXDESC_SIZE >> 2];
300 };
301 #endif
302 
303 #ifdef CONFIG_PCI_HCI
304 #define PCI_MAX_TX_QUEUE_COUNT	8	/* == HW_QUEUE_ENTRY */
305 
306 struct rtw_tx_ring {
307 	unsigned char	qid;
308 #ifdef CONFIG_TRX_BD_ARCH
309 	struct tx_buf_desc	*buf_desc;
310 #else
311 	struct tx_desc	*desc;
312 #endif
313 	dma_addr_t	dma;
314 	unsigned int	idx;
315 	unsigned int	entries;
316 	_queue		queue;
317 	u32		qlen;
318 #ifdef CONFIG_TRX_BD_ARCH
319 	u16		hw_rp_cache;
320 #endif
321 };
322 
323 #ifdef DBG_TXBD_DESC_DUMP
324 
325 #define TX_BAK_FRMAE_CNT	10
326 #define TX_BAK_DESC_LEN	48	/* byte */
327 #define TX_BAK_DATA_LEN		30	/* byte */
328 
329 struct rtw_tx_desc_backup {
330 	int tx_bak_rp;
331 	int tx_bak_wp;
332 	u8 tx_bak_desc[TX_BAK_DESC_LEN];
333 	u8 tx_bak_data_hdr[TX_BAK_DATA_LEN];
334 	u8 tx_desc_size;
335 };
336 #endif
337 #endif
338 
339 struct	hw_xmit	{
340 	/* _lock xmit_lock; */
341 	/* _list	pending; */
342 	_queue *sta_queue;
343 	/* struct hw_txqueue *phwtxqueue; */
344 	/* sint	txcmdcnt; */
345 	int	accnt;
346 };
347 
348 #if 0
349 struct pkt_attrib {
350 	u8	type;
351 	u8	subtype;
352 	u8	bswenc;
353 	u8	dhcp_pkt;
354 	u16	ether_type;
355 	int	pktlen;		/* the original 802.3 pkt raw_data len (not include ether_hdr data) */
356 	int	pkt_hdrlen;	/* the original 802.3 pkt header len */
357 	int	hdrlen;		/* the WLAN Header Len */
358 	int	nr_frags;
359 	int	last_txcmdsz;
360 	int	encrypt;	/* when 0 indicate no encrypt. when non-zero, indicate the encrypt algorith */
361 	u8	iv[8];
362 	int	iv_len;
363 	u8	icv[8];
364 	int	icv_len;
365 	int	priority;
366 	int	ack_policy;
367 	int	mac_id;
368 	int	vcs_mode;	/* virtual carrier sense method */
369 
370 	u8	dst[ETH_ALEN];
371 	u8	src[ETH_ALEN];
372 	u8	ta[ETH_ALEN];
373 	u8	ra[ETH_ALEN];
374 
375 	u8	key_idx;
376 
377 	u8	qos_en;
378 	u8	ht_en;
379 	u8	raid;/* rate adpative id */
380 	u8	bwmode;
381 	u8	ch_offset;/* PRIME_CHNL_OFFSET */
382 	u8	sgi;/* short GI */
383 	u8	ampdu_en;/* tx ampdu enable */
384 	u8	mdata;/* more data bit */
385 	u8	eosp;
386 
387 	u8	triggered;/* for ap mode handling Power Saving sta */
388 
389 	u32	qsel;
390 	u16	seqnum;
391 
392 	struct sta_info *psta;
393 #ifdef CONFIG_TCP_CSUM_OFFLOAD_TX
394 	u8	hw_tcp_csum;
395 #endif
396 };
397 #else
398 /* reduce size */
399 struct pkt_attrib {
400 	u8	type;
401 	u8	subtype;
402 	u8	bswenc;
403 	u8	dhcp_pkt;
404 	u16	ether_type;
405 	u16	seqnum;
406 	u8	hw_ssn_sel;	/* for HW_SEQ0,1,2,3 */
407 	u16	pkt_hdrlen;	/* the original 802.3 pkt header len */
408 	u16	hdrlen;		/* the WLAN Header Len */
409 	u32	pktlen;		/* the original 802.3 pkt raw_data len (not include ether_hdr data) */
410 	u32	last_txcmdsz;
411 	u8	nr_frags;
412 	u8	encrypt;	/* when 0 indicate no encrypt. when non-zero, indicate the encrypt algorith */
413 #if defined(CONFIG_CONCURRENT_MODE)
414 	u8	bmc_camid;
415 #endif
416 	u8	iv_len;
417 	u8	icv_len;
418 	u8	iv[18];
419 	u8	icv[16];
420 	u8	priority;
421 	u8	ack_policy;
422 	u8	mac_id;
423 	u8	vcs_mode;	/* virtual carrier sense method */
424 	u8	dst[ETH_ALEN];
425 	u8	src[ETH_ALEN];
426 	u8	ta[ETH_ALEN];
427 	u8	ra[ETH_ALEN];
428 	u8	key_idx;
429 	u8	qos_en;
430 	u8	ht_en;
431 	u8	raid;/* rate adpative id */
432 	u8	bwmode;
433 	u8	ch_offset;/* PRIME_CHNL_OFFSET */
434 	u8	sgi;/* short GI */
435 	u8	ampdu_en;/* tx ampdu enable */
436 	u8	ampdu_spacing; /* ampdu_min_spacing for peer sta's rx */
437 	u8	amsdu;
438 	u8	amsdu_ampdu_en;/* tx amsdu in ampdu enable */
439 	u8	mdata;/* more data bit */
440 	u8	pctrl;/* per packet txdesc control enable */
441 	u8	triggered;/* for ap mode handling Power Saving sta */
442 	u8	qsel;
443 	u8	order;/* order bit */
444 	u8	eosp;
445 	u8	rate;
446 	u8	intel_proxim;
447 	u8	retry_ctrl;
448 	u8   mbssid;
449 	u8	ldpc;
450 	u8	stbc;
451 #ifdef CONFIG_WMMPS_STA
452 	u8	trigger_frame;
453 #endif /* CONFIG_WMMPS_STA */
454 
455 	struct sta_info *psta;
456 #ifdef CONFIG_TCP_CSUM_OFFLOAD_TX
457 	u8	hw_tcp_csum;
458 #endif
459 
460 	u8 rtsen;
461 	u8 cts2self;
462 	union Keytype	dot11tkiptxmickey;
463 	/* union Keytype	dot11tkiprxmickey; */
464 	union Keytype	dot118021x_UncstKey;
465 
466 #ifdef CONFIG_TDLS
467 	u8 direct_link;
468 	struct sta_info *ptdls_sta;
469 #endif /* CONFIG_TDLS */
470 	u8 key_type;
471 
472 	u8 icmp_pkt;
473 
474 #ifdef CONFIG_BEAMFORMING
475 	u16 txbf_p_aid;/*beamforming Partial_AID*/
476 	u16 txbf_g_id;/*beamforming Group ID*/
477 
478 	/*
479 	 * 2'b00: Unicast NDPA
480 	 * 2'b01: Broadcast NDPA
481 	 * 2'b10: Beamforming Report Poll
482 	 * 2'b11: Final Beamforming Report Poll
483 	 */
484 	u8 bf_pkt_type;
485 #endif
486 
487 };
488 #endif
489 
490 #ifdef CONFIG_TX_AMSDU
491 enum {
492 	RTW_AMSDU_TIMER_UNSET = 0,
493 	RTW_AMSDU_TIMER_SETTING,
494 	RTW_AMSDU_TIMER_TIMEOUT,
495 };
496 #endif
497 
498 #define WLANHDR_OFFSET	64
499 
500 #define NULL_FRAMETAG		(0x0)
501 #define DATA_FRAMETAG		0x01
502 #define L2_FRAMETAG		0x02
503 #define MGNT_FRAMETAG		0x03
504 #define AMSDU_FRAMETAG	0x04
505 
506 #define EII_FRAMETAG		0x05
507 #define IEEE8023_FRAMETAG  0x06
508 
509 #define MP_FRAMETAG		0x07
510 
511 #define TXAGG_FRAMETAG	0x08
512 
513 enum {
514 	XMITBUF_DATA = 0,
515 	XMITBUF_MGNT = 1,
516 	XMITBUF_CMD = 2,
517 };
518 
519 bool rtw_xmit_ac_blocked(_adapter *adapter);
520 
521 struct  submit_ctx {
522 	systime submit_time; /* */
523 	u32 timeout_ms; /* <0: not synchronous, 0: wait forever, >0: up to ms waiting */
524 	int status; /* status for operation */
525 #ifdef PLATFORM_LINUX
526 	struct completion done;
527 #endif
528 };
529 
530 enum {
531 	RTW_SCTX_SUBMITTED = -1,
532 	RTW_SCTX_DONE_SUCCESS = 0,
533 	RTW_SCTX_DONE_UNKNOWN,
534 	RTW_SCTX_DONE_TIMEOUT,
535 	RTW_SCTX_DONE_BUF_ALLOC,
536 	RTW_SCTX_DONE_BUF_FREE,
537 	RTW_SCTX_DONE_WRITE_PORT_ERR,
538 	RTW_SCTX_DONE_TX_DESC_NA,
539 	RTW_SCTX_DONE_TX_DENY,
540 	RTW_SCTX_DONE_CCX_PKT_FAIL,
541 	RTW_SCTX_DONE_DRV_STOP,
542 	RTW_SCTX_DONE_DEV_REMOVE,
543 	RTW_SCTX_DONE_CMD_ERROR,
544 	RTW_SCTX_DONE_CMD_DROP,
545 	RTX_SCTX_CSTR_WAIT_RPT2,
546 };
547 
548 
549 void rtw_sctx_init(struct submit_ctx *sctx, int timeout_ms);
550 int rtw_sctx_wait(struct submit_ctx *sctx, const char *msg);
551 void rtw_sctx_done_err(struct submit_ctx **sctx, int status);
552 void rtw_sctx_done(struct submit_ctx **sctx);
553 
554 struct xmit_buf {
555 	_list	list;
556 
557 	_adapter *padapter;
558 
559 	u8 *pallocated_buf;
560 
561 	u8 *pbuf;
562 
563 	void *priv_data;
564 
565 	u16 buf_tag; /* 0: Normal xmitbuf, 1: extension xmitbuf, 2:cmd xmitbuf */
566 	u16 flags;
567 	u32 alloc_sz;
568 
569 	u32  len;
570 
571 	struct submit_ctx *sctx;
572 
573 #ifdef CONFIG_USB_HCI
574 
575 	/* u32 sz[8]; */
576 	u32	ff_hwaddr;
577 #ifdef RTW_HALMAC
578 	u8 bulkout_id; /* for halmac */
579 #endif /* RTW_HALMAC */
580 
581 #if defined(PLATFORM_OS_XP) || defined(PLATFORM_LINUX) || defined(PLATFORM_FREEBSD)
582 	PURB	pxmit_urb[8];
583 	dma_addr_t dma_transfer_addr;	/* (in) dma addr for transfer_buffer */
584 #endif
585 
586 #ifdef PLATFORM_OS_XP
587 	PIRP		pxmit_irp[8];
588 #endif
589 
590 #ifdef PLATFORM_OS_CE
591 	USB_TRANSFER	usb_transfer_write_port;
592 #endif
593 
594 	u8 bpending[8];
595 
596 	sint last[8];
597 
598 #endif
599 
600 #if defined(CONFIG_SDIO_HCI) || defined(CONFIG_GSPI_HCI)
601 	u8 *phead;
602 	u8 *pdata;
603 	u8 *ptail;
604 	u8 *pend;
605 	u32 ff_hwaddr;
606 	u8	pg_num;
607 	u8	agg_num;
608 #ifdef PLATFORM_OS_XP
609 	PMDL pxmitbuf_mdl;
610 	PIRP  pxmitbuf_irp;
611 	PSDBUS_REQUEST_PACKET pxmitbuf_sdrp;
612 #endif
613 #endif
614 
615 #ifdef CONFIG_PCI_HCI
616 #ifdef CONFIG_TRX_BD_ARCH
617 	/*struct tx_buf_desc *buf_desc;*/
618 #else
619 	struct tx_desc *desc;
620 #endif
621 #endif
622 
623 #if defined(DBG_XMIT_BUF) || defined(DBG_XMIT_BUF_EXT)
624 	u8 no;
625 #endif
626 
627 };
628 
629 
630 struct xmit_frame {
631 	_list	list;
632 
633 	struct pkt_attrib attrib;
634 
635 	_pkt *pkt;
636 
637 	int	frame_tag;
638 
639 	_adapter *padapter;
640 
641 	u8	*buf_addr;
642 
643 	struct xmit_buf *pxmitbuf;
644 
645 #if defined(CONFIG_SDIO_HCI) || defined(CONFIG_GSPI_HCI)
646 	u8	pg_num;
647 	u8	agg_num;
648 #endif
649 
650 #ifdef CONFIG_USB_HCI
651 #ifdef CONFIG_USB_TX_AGGREGATION
652 	u8	agg_num;
653 #endif
654 	s8	pkt_offset;
655 #endif
656 
657 #ifdef CONFIG_XMIT_ACK
658 	u8 ack_report;
659 #endif
660 
661 	u8 *alloc_addr; /* the actual address this xmitframe allocated */
662 	u8 ext_tag; /* 0:data, 1:mgmt */
663 
664 };
665 
666 struct tx_servq {
667 	_list	tx_pending;
668 	_queue	sta_pending;
669 	int qcnt;
670 };
671 
672 
673 struct sta_xmit_priv {
674 	_lock	lock;
675 	sint	option;
676 	sint	apsd_setting;	/* When bit mask is on, the associated edca queue supports APSD. */
677 
678 
679 	/* struct tx_servq blk_q[MAX_NUMBLKS]; */
680 	struct tx_servq	be_q;			/* priority == 0,3 */
681 	struct tx_servq	bk_q;			/* priority == 1,2 */
682 	struct tx_servq	vi_q;			/* priority == 4,5 */
683 	struct tx_servq	vo_q;			/* priority == 6,7 */
684 	_list	legacy_dz;
685 	_list  apsd;
686 
687 	u16 txseq_tid[16];
688 
689 	/* uint	sta_tx_bytes; */
690 	/* u64	sta_tx_pkts; */
691 	/* uint	sta_tx_fail; */
692 
693 
694 };
695 
696 
697 struct	hw_txqueue	{
698 	volatile sint	head;
699 	volatile sint	tail;
700 	volatile sint 	free_sz;	/* in units of 64 bytes */
701 	volatile sint      free_cmdsz;
702 	volatile sint	 txsz[8];
703 	uint	ff_hwaddr;
704 	uint	cmd_hwaddr;
705 	sint	ac_tag;
706 };
707 
708 struct agg_pkt_info {
709 	u16 offset;
710 	u16 pkt_len;
711 };
712 
713 enum cmdbuf_type {
714 	CMDBUF_BEACON = 0x00,
715 	CMDBUF_RSVD,
716 	CMDBUF_MAX
717 };
718 
719 u8 rtw_get_hwseq_no(_adapter *padapter);
720 
721 struct	xmit_priv	{
722 
723 	_lock	lock;
724 
725 	_sema	xmit_sema;
726 
727 	/* _queue	blk_strms[MAX_NUMBLKS]; */
728 	_queue	be_pending;
729 	_queue	bk_pending;
730 	_queue	vi_pending;
731 	_queue	vo_pending;
732 	_queue	bm_pending;
733 
734 	/* _queue	legacy_dz_queue; */
735 	/* _queue	apsd_queue; */
736 
737 	u8 *pallocated_frame_buf;
738 	u8 *pxmit_frame_buf;
739 	uint free_xmitframe_cnt;
740 	_queue	free_xmit_queue;
741 
742 	/* uint mapping_addr; */
743 	/* uint pkt_sz; */
744 
745 	u8 *xframe_ext_alloc_addr;
746 	u8 *xframe_ext;
747 	uint free_xframe_ext_cnt;
748 	_queue free_xframe_ext_queue;
749 
750 	/* struct	hw_txqueue	be_txqueue; */
751 	/* struct	hw_txqueue	bk_txqueue; */
752 	/* struct	hw_txqueue	vi_txqueue; */
753 	/* struct	hw_txqueue	vo_txqueue; */
754 	/* struct	hw_txqueue	bmc_txqueue; */
755 
756 	uint	frag_len;
757 
758 	_adapter	*adapter;
759 
760 	u8   vcs_setting;
761 	u8	vcs;
762 	u8	vcs_type;
763 	/* u16  rts_thresh; */
764 
765 	u64	tx_bytes;
766 	u64	tx_pkts;
767 	u64	tx_drop;
768 	u64	last_tx_pkts;
769 
770 	struct hw_xmit *hwxmits;
771 	u8	hwxmit_entry;
772 
773 	u8	wmm_para_seq[4];/* sequence for wmm ac parameter strength from large to small. it's value is 0->vo, 1->vi, 2->be, 3->bk. */
774 
775 #ifdef CONFIG_USB_HCI
776 	_sema	tx_retevt;/* all tx return event; */
777 	u8		txirp_cnt;
778 
779 #ifdef PLATFORM_OS_CE
780 	USB_TRANSFER	usb_transfer_write_port;
781 	/*	USB_TRANSFER	usb_transfer_write_mem; */
782 #endif
783 #ifdef PLATFORM_LINUX
784 	struct tasklet_struct xmit_tasklet;
785 #endif
786 #ifdef PLATFORM_FREEBSD
787 	struct task xmit_tasklet;
788 #endif
789 	/* per AC pending irp */
790 	int beq_cnt;
791 	int bkq_cnt;
792 	int viq_cnt;
793 	int voq_cnt;
794 
795 #endif
796 
797 #ifdef CONFIG_PCI_HCI
798 	/* Tx */
799 	struct rtw_tx_ring	tx_ring[PCI_MAX_TX_QUEUE_COUNT];
800 	int	txringcount[PCI_MAX_TX_QUEUE_COUNT];
801 	u8 	beaconDMAing;		/* flag of indicating beacon is transmiting to HW by DMA */
802 #ifdef PLATFORM_LINUX
803 	struct tasklet_struct xmit_tasklet;
804 #endif
805 #endif
806 
807 #if defined(CONFIG_SDIO_HCI) || defined(CONFIG_GSPI_HCI)
808 #ifdef CONFIG_SDIO_TX_TASKLET
809 #ifdef PLATFORM_LINUX
810 	struct tasklet_struct xmit_tasklet;
811 #endif /* PLATFORM_LINUX */
812 #else
813 	_thread_hdl_	SdioXmitThread;
814 	_sema		SdioXmitSema;
815 #endif /* CONFIG_SDIO_TX_TASKLET */
816 #endif /* CONFIG_SDIO_HCI */
817 
818 	_queue free_xmitbuf_queue;
819 	_queue pending_xmitbuf_queue;
820 	u8 *pallocated_xmitbuf;
821 	u8 *pxmitbuf;
822 	uint free_xmitbuf_cnt;
823 
824 	_queue free_xmit_extbuf_queue;
825 	u8 *pallocated_xmit_extbuf;
826 	u8 *pxmit_extbuf;
827 	uint free_xmit_extbuf_cnt;
828 
829 	struct xmit_buf	pcmd_xmitbuf[CMDBUF_MAX];
830 	u8   hw_ssn_seq_no;/* mapping to REG_HW_SEQ 0,1,2,3 */
831 	u16	nqos_ssn;
832 #ifdef CONFIG_TX_EARLY_MODE
833 
834 #ifdef CONFIG_SDIO_HCI
835 #define MAX_AGG_PKT_NUM 20
836 #else
837 #define MAX_AGG_PKT_NUM 256 /* Max tx ampdu coounts		 */
838 #endif
839 
840 	struct agg_pkt_info agg_pkt[MAX_AGG_PKT_NUM];
841 #endif
842 
843 #ifdef CONFIG_XMIT_ACK
844 	int	ack_tx;
845 	_mutex ack_tx_mutex;
846 	struct submit_ctx ack_tx_ops;
847 	u8 seq_no;
848 #endif
849 
850 #ifdef CONFIG_TX_AMSDU
851 	_timer amsdu_vo_timer;
852 	u8 amsdu_vo_timeout;
853 
854 	_timer amsdu_vi_timer;
855 	u8 amsdu_vi_timeout;
856 
857 	_timer amsdu_be_timer;
858 	u8 amsdu_be_timeout;
859 
860 	_timer amsdu_bk_timer;
861 	u8 amsdu_bk_timeout;
862 
863 	u32 amsdu_debug_set_timer;
864 	u32 amsdu_debug_timeout;
865 	u32 amsdu_debug_coalesce_one;
866 	u32 amsdu_debug_coalesce_two;
867 
868 #endif
869 #ifdef DBG_TXBD_DESC_DUMP
870 	BOOLEAN	 dump_txbd_desc;
871 #endif
872 	_lock lock_sctx;
873 
874 };
875 
876 extern struct xmit_frame *__rtw_alloc_cmdxmitframe(struct xmit_priv *pxmitpriv,
877 		enum cmdbuf_type buf_type);
878 #define rtw_alloc_cmdxmitframe(p) __rtw_alloc_cmdxmitframe(p, CMDBUF_RSVD)
879 #if defined(CONFIG_RTL8192E) && defined(CONFIG_PCI_HCI)
880 extern struct xmit_frame *__rtw_alloc_cmdxmitframe_8192ee(struct xmit_priv *pxmitpriv,
881 		enum cmdbuf_type buf_type);
882 #define rtw_alloc_bcnxmitframe(p) __rtw_alloc_cmdxmitframe_8192ee(p, CMDBUF_BEACON)
883 #elif defined(CONFIG_RTL8822B) && defined(CONFIG_PCI_HCI)
884 extern struct xmit_frame *__rtw_alloc_cmdxmitframe_8822be(struct xmit_priv *pxmitpriv,
885 		enum cmdbuf_type buf_type);
886 #define rtw_alloc_bcnxmitframe(p) __rtw_alloc_cmdxmitframe_8822be(p, CMDBUF_BEACON)
887 #elif defined(CONFIG_RTL8821C) && defined(CONFIG_PCI_HCI)
888 extern struct xmit_frame *__rtw_alloc_cmdxmitframe_8821ce(struct xmit_priv *pxmitpriv,
889 		enum cmdbuf_type buf_type);
890 #define rtw_alloc_bcnxmitframe(p) __rtw_alloc_cmdxmitframe_8821ce(p, CMDBUF_BEACON)
891 #else
892 #define rtw_alloc_bcnxmitframe(p) __rtw_alloc_cmdxmitframe(p, CMDBUF_BEACON)
893 #endif
894 
895 extern struct xmit_buf *rtw_alloc_xmitbuf_ext(struct xmit_priv *pxmitpriv);
896 extern s32 rtw_free_xmitbuf_ext(struct xmit_priv *pxmitpriv, struct xmit_buf *pxmitbuf);
897 
898 extern struct xmit_buf *rtw_alloc_xmitbuf(struct xmit_priv *pxmitpriv);
899 extern s32 rtw_free_xmitbuf(struct xmit_priv *pxmitpriv, struct xmit_buf *pxmitbuf);
900 
901 void rtw_count_tx_stats(_adapter *padapter, struct xmit_frame *pxmitframe, int sz);
902 extern void rtw_update_protection(_adapter *padapter, u8 *ie, uint ie_len);
903 static s32 update_attrib_sec_info(_adapter *padapter, struct pkt_attrib *pattrib, struct sta_info *psta);
904 static void update_attrib_phy_info(_adapter *padapter, struct pkt_attrib *pattrib, struct sta_info *psta);
905 
906 #ifdef CONFIG_WMMPS_STA
907 static void update_attrib_trigger_frame_info(_adapter *padapter, struct pkt_attrib *pattrib);
908 #endif /* CONFIG_WMMPS_STA */
909 
910 extern s32 rtw_make_wlanhdr(_adapter *padapter, u8 *hdr, struct pkt_attrib *pattrib);
911 extern s32 rtw_put_snap(u8 *data, u16 h_proto);
912 
913 extern struct xmit_frame *rtw_alloc_xmitframe(struct xmit_priv *pxmitpriv);
914 struct xmit_frame *rtw_alloc_xmitframe_ext(struct xmit_priv *pxmitpriv);
915 struct xmit_frame *rtw_alloc_xmitframe_once(struct xmit_priv *pxmitpriv);
916 extern s32 rtw_free_xmitframe(struct xmit_priv *pxmitpriv, struct xmit_frame *pxmitframe);
917 extern void rtw_free_xmitframe_queue(struct xmit_priv *pxmitpriv, _queue *pframequeue);
918 struct tx_servq *rtw_get_sta_pending(_adapter *padapter, struct sta_info *psta, sint up, u8 *ac);
919 extern s32 rtw_xmitframe_enqueue(_adapter *padapter, struct xmit_frame *pxmitframe);
920 extern struct xmit_frame *rtw_dequeue_xframe(struct xmit_priv *pxmitpriv, struct hw_xmit *phwxmit_i, sint entry);
921 
922 extern s32 rtw_xmit_classifier(_adapter *padapter, struct xmit_frame *pxmitframe);
923 extern u32 rtw_calculate_wlan_pkt_size_by_attribue(struct pkt_attrib *pattrib);
924 #define rtw_wlan_pkt_size(f) rtw_calculate_wlan_pkt_size_by_attribue(&f->attrib)
925 extern s32 rtw_xmitframe_coalesce(_adapter *padapter, _pkt *pkt, struct xmit_frame *pxmitframe);
926 #ifdef CONFIG_IEEE80211W
927 extern s32 rtw_mgmt_xmitframe_coalesce(_adapter *padapter, _pkt *pkt, struct xmit_frame *pxmitframe);
928 #endif /* CONFIG_IEEE80211W */
929 #ifdef CONFIG_TDLS
930 extern struct tdls_txmgmt *ptxmgmt;
931 s32 rtw_xmit_tdls_coalesce(_adapter *padapter, struct xmit_frame *pxmitframe, struct tdls_txmgmt *ptxmgmt);
932 s32 update_tdls_attrib(_adapter *padapter, struct pkt_attrib *pattrib);
933 #endif
934 s32 _rtw_init_hw_txqueue(struct hw_txqueue *phw_txqueue, u8 ac_tag);
935 void _rtw_init_sta_xmit_priv(struct sta_xmit_priv *psta_xmitpriv);
936 
937 
938 s32 rtw_txframes_pending(_adapter *padapter);
939 s32 rtw_txframes_sta_ac_pending(_adapter *padapter, struct pkt_attrib *pattrib);
940 void rtw_init_hwxmits(struct hw_xmit *phwxmit, sint entry);
941 
942 
943 s32 _rtw_init_xmit_priv(struct xmit_priv *pxmitpriv, _adapter *padapter);
944 void _rtw_free_xmit_priv(struct xmit_priv *pxmitpriv);
945 
946 
947 void rtw_alloc_hwxmits(_adapter *padapter);
948 void rtw_free_hwxmits(_adapter *padapter);
949 #if (LINUX_VERSION_CODE >= KERNEL_VERSION(2, 6, 24))
950 s32 rtw_monitor_xmit_entry(struct sk_buff *skb, struct net_device *ndev);
951 #endif
952 s32 rtw_xmit(_adapter *padapter, _pkt **pkt);
953 bool xmitframe_hiq_filter(struct xmit_frame *xmitframe);
954 #if defined(CONFIG_AP_MODE) || defined(CONFIG_TDLS)
955 sint xmitframe_enqueue_for_sleeping_sta(_adapter *padapter, struct xmit_frame *pxmitframe);
956 void stop_sta_xmit(_adapter *padapter, struct sta_info *psta);
957 void wakeup_sta_to_xmit(_adapter *padapter, struct sta_info *psta);
958 void xmit_delivery_enabled_frames(_adapter *padapter, struct sta_info *psta);
959 #endif
960 
961 u8 rtw_get_tx_bw_mode(_adapter *adapter, struct sta_info *sta);
962 
963 void rtw_get_adapter_tx_rate_bmp_by_bw(_adapter *adapter, u8 bw, u16 *r_bmp_cck_ofdm, u32 *r_bmp_ht, u32 *r_bmp_vht);
964 void rtw_update_tx_rate_bmp(struct dvobj_priv *dvobj);
965 u16 rtw_get_tx_rate_bmp_cck_ofdm(struct dvobj_priv *dvobj);
966 u32 rtw_get_tx_rate_bmp_ht_by_bw(struct dvobj_priv *dvobj, u8 bw);
967 u32 rtw_get_tx_rate_bmp_vht_by_bw(struct dvobj_priv *dvobj, u8 bw);
968 u8 rtw_get_tx_bw_bmp_of_ht_rate(struct dvobj_priv *dvobj, u8 rate, u8 max_bw);
969 u8 rtw_get_tx_bw_bmp_of_vht_rate(struct dvobj_priv *dvobj, u8 rate, u8 max_bw);
970 
971 u8 query_ra_short_GI(struct sta_info *psta, u8 bw);
972 
973 u8	qos_acm(u8 acm_mask, u8 priority);
974 
975 #ifdef CONFIG_XMIT_THREAD_MODE
976 void	enqueue_pending_xmitbuf(struct xmit_priv *pxmitpriv, struct xmit_buf *pxmitbuf);
977 void enqueue_pending_xmitbuf_to_head(struct xmit_priv *pxmitpriv, struct xmit_buf *pxmitbuf);
978 struct xmit_buf	*dequeue_pending_xmitbuf(struct xmit_priv *pxmitpriv);
979 struct xmit_buf	*select_and_dequeue_pending_xmitbuf(_adapter *padapter);
980 sint	check_pending_xmitbuf(struct xmit_priv *pxmitpriv);
981 thread_return	rtw_xmit_thread(thread_context context);
982 #endif
983 
984 #ifdef CONFIG_TX_AMSDU
985 extern void rtw_amsdu_vo_timeout_handler(void *FunctionContext);
986 extern void rtw_amsdu_vi_timeout_handler(void *FunctionContext);
987 extern void rtw_amsdu_be_timeout_handler(void *FunctionContext);
988 extern void rtw_amsdu_bk_timeout_handler(void *FunctionContext);
989 
990 extern u8 rtw_amsdu_get_timer_status(_adapter *padapter, u8 priority);
991 extern void rtw_amsdu_set_timer_status(_adapter *padapter, u8 priority, u8 status);
992 extern void rtw_amsdu_set_timer(_adapter *padapter, u8 priority);
993 extern void rtw_amsdu_cancel_timer(_adapter *padapter, u8 priority);
994 
995 extern s32 rtw_xmitframe_coalesce_amsdu(_adapter *padapter, struct xmit_frame *pxmitframe, struct xmit_frame *pxmitframe_queue);
996 extern s32 check_amsdu(struct xmit_frame *pxmitframe);
997 extern s32 check_amsdu_tx_support(_adapter *padapter);
998 extern struct xmit_frame *rtw_get_xframe(struct xmit_priv *pxmitpriv, int *num_frame);
999 #endif
1000 
1001 #ifdef DBG_TXBD_DESC_DUMP
1002 void rtw_tx_desc_backup(_adapter *padapter, struct xmit_frame *pxmitframe, u8 desc_size, u8 hwq);
1003 void rtw_tx_desc_backup_reset(void);
1004 u8 rtw_get_tx_desc_backup(_adapter *padapter, u8 hwq, struct rtw_tx_desc_backup **pbak);
1005 #endif
1006 
1007 static void do_queue_select(_adapter *padapter, struct pkt_attrib *pattrib);
1008 u32	rtw_get_ff_hwaddr(struct xmit_frame	*pxmitframe);
1009 
1010 #ifdef CONFIG_XMIT_ACK
1011 int rtw_ack_tx_wait(struct xmit_priv *pxmitpriv, u32 timeout_ms);
1012 void rtw_ack_tx_done(struct xmit_priv *pxmitpriv, int status);
1013 #endif /* CONFIG_XMIT_ACK */
1014 
1015 enum XMIT_BLOCK_REASON {
1016 	XMIT_BLOCK_NONE = 0,
1017 	XMIT_BLOCK_REDLMEM = BIT0, /*LPS-PG*/
1018 	XMIT_BLOCK_SUSPEND = BIT1, /*WOW*/
1019 	XMIT_BLOCK_MAX = 0xFF,
1020 };
1021 void rtw_init_xmit_block(_adapter *padapter);
1022 void rtw_deinit_xmit_block(_adapter *padapter);
1023 
1024 #ifdef DBG_XMIT_BLOCK
1025 void dump_xmit_block(void *sel, _adapter *padapter);
1026 #endif
1027 void rtw_set_xmit_block(_adapter *padapter, enum XMIT_BLOCK_REASON reason);
1028 void rtw_clr_xmit_block(_adapter *padapter, enum XMIT_BLOCK_REASON reason);
1029 bool rtw_is_xmit_blocked(_adapter *padapter);
1030 
1031 /* include after declaring struct xmit_buf, in order to avoid warning */
1032 #include <xmit_osdep.h>
1033 
1034 #endif /* _RTL871X_XMIT_H_ */
1035