• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /******************************************************************************
2  *
3  * Copyright(c) 2007 - 2011 Realtek Corporation. All rights reserved.
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 #include <osdep_service.h>
19 #include <drv_types.h>
20 
21 #define MAX_XMITBUF_SZ		2048
22 #define NR_XMITBUFF		4
23 
24 #define XMITBUF_ALIGN_SZ	512
25 
26 /*  xmit extension buff defination */
27 #define MAX_XMIT_EXTBUF_SZ	1536
28 #define NR_XMIT_EXTBUFF		32
29 
30 #define MAX_NUMBLKS		1
31 
32 #define XMIT_VO_QUEUE		0
33 #define XMIT_VI_QUEUE		1
34 #define XMIT_BE_QUEUE		2
35 #define XMIT_BK_QUEUE		3
36 
37 #define VO_QUEUE_INX		0
38 #define VI_QUEUE_INX		1
39 #define BE_QUEUE_INX		2
40 #define BK_QUEUE_INX		3
41 #define BCN_QUEUE_INX		4
42 #define MGT_QUEUE_INX		5
43 #define HIGH_QUEUE_INX		6
44 #define TXCMD_QUEUE_INX		7
45 
46 #define HW_QUEUE_ENTRY		8
47 
48 #define WEP_IV(pattrib_iv, dot11txpn, keyidx)				\
49 do {									\
50 	pattrib_iv[0] = dot11txpn._byte_.TSC0;				\
51 	pattrib_iv[1] = dot11txpn._byte_.TSC1;				\
52 	pattrib_iv[2] = dot11txpn._byte_.TSC2;				\
53 	pattrib_iv[3] = ((keyidx & 0x3) << 6);				\
54 	dot11txpn.val = (dot11txpn.val == 0xffffff) ? 0 :		\
55 			 (dot11txpn.val+1);				\
56 } while (0)
57 
58 #define TKIP_IV(pattrib_iv, dot11txpn, keyidx)				\
59 do {									\
60 	pattrib_iv[0] = dot11txpn._byte_.TSC1;				\
61 	pattrib_iv[1] = (dot11txpn._byte_.TSC1 | 0x20) & 0x7f;		\
62 	pattrib_iv[2] = dot11txpn._byte_.TSC0;				\
63 	pattrib_iv[3] = BIT(5) | ((keyidx & 0x3)<<6);			\
64 	pattrib_iv[4] = dot11txpn._byte_.TSC2;				\
65 	pattrib_iv[5] = dot11txpn._byte_.TSC3;				\
66 	pattrib_iv[6] = dot11txpn._byte_.TSC4;				\
67 	pattrib_iv[7] = dot11txpn._byte_.TSC5;				\
68 	dot11txpn.val = dot11txpn.val == 0xffffffffffffULL ? 0 :	\
69 					 (dot11txpn.val+1);		\
70 } while (0)
71 
72 #define AES_IV(pattrib_iv, dot11txpn, keyidx)\
73 do {									\
74 	pattrib_iv[0] = dot11txpn._byte_.TSC0;				\
75 	pattrib_iv[1] = dot11txpn._byte_.TSC1;				\
76 	pattrib_iv[2] = 0;						\
77 	pattrib_iv[3] = BIT(5) | ((keyidx & 0x3) << 6);			\
78 	pattrib_iv[4] = dot11txpn._byte_.TSC2;				\
79 	pattrib_iv[5] = dot11txpn._byte_.TSC3;				\
80 	pattrib_iv[6] = dot11txpn._byte_.TSC4;				\
81 	pattrib_iv[7] = dot11txpn._byte_.TSC5;				\
82 	dot11txpn.val = dot11txpn.val == 0xffffffffffffULL ? 0 :	\
83 					 (dot11txpn.val+1);		\
84 } while (0)
85 
86 #define HWXMIT_ENTRY	4
87 
88 #define TXDESC_SIZE 32
89 
90 #define PACKET_OFFSET_SZ 8
91 #define TXDESC_OFFSET (TXDESC_SIZE + PACKET_OFFSET_SZ)
92 
93 struct tx_desc {
94 	/* DWORD 0 */
95 	__le32 txdw0;
96 	__le32 txdw1;
97 	__le32 txdw2;
98 	__le32 txdw3;
99 	__le32 txdw4;
100 	__le32 txdw5;
101 	__le32 txdw6;
102 	__le32 txdw7;
103 };
104 
105 union txdesc {
106 	struct tx_desc txdesc;
107 	unsigned int value[TXDESC_SIZE>>2];
108 };
109 
110 struct	hw_xmit	{
111 	struct rtw_queue *sta_queue;
112 	int	accnt;
113 };
114 
115 /* reduce size */
116 struct pkt_attrib {
117 	u16	type;
118 	u8	bswenc;
119 	u8	dhcp_pkt;
120 	u16	ether_type;
121 	u16	seqnum;
122 	u16	pkt_hdrlen;	/* the original 802.3 pkt header len */
123 	u16	hdrlen;		/* the WLAN Header Len */
124 	u32	pktlen;		/* the original 802.3 pkt raw_data len */
125 	u32	last_txcmdsz;
126 	u32	encrypt;	/* when 0 indicate no encrypt. */
127 	u8	nr_frags;
128 	u8	iv_len;
129 	u8	icv_len;
130 	u8	iv[18];
131 	u8	icv[16];
132 	u8	priority;
133 	u8	ack_policy;
134 	u8	mac_id;
135 	u8	vcs_mode;	/* virtual carrier sense method */
136 	u8	dst[ETH_ALEN];
137 	u8	src[ETH_ALEN];
138 	u8	ta[ETH_ALEN];
139 	u8	ra[ETH_ALEN];
140 	u8	key_idx;
141 	u8	qos_en;
142 	u8	ht_en;
143 	u8	raid;/* rate adpative id */
144 	u8	bwmode;
145 	u8	ch_offset;/* PRIME_CHNL_OFFSET */
146 	u8	sgi;/* short GI */
147 	u8	ampdu_en;/* tx ampdu enable */
148 	u8	mdata;/* more data bit */
149 	u8	pctrl;/* per packet txdesc control enable */
150 	u8	triggered;/* for ap mode handling Power Saving sta */
151 	u8	qsel;
152 	u8	eosp;
153 	u8	rate;
154 	u8	retry_ctrl;
155 	struct sta_info *psta;
156 };
157 
158 #define WLANHDR_OFFSET		64
159 
160 #define NULL_FRAMETAG		0x0
161 #define DATA_FRAMETAG		0x01
162 #define L2_FRAMETAG		0x02
163 #define MGNT_FRAMETAG		0x03
164 #define AMSDU_FRAMETAG		0x04
165 
166 #define EII_FRAMETAG		0x05
167 #define IEEE8023_FRAMETAG 	0x06
168 
169 #define MP_FRAMETAG		0x07
170 
171 #define TXAGG_FRAMETAG		0x08
172 
173 struct  submit_ctx {
174 	u32 timeout_ms; /* <0: not synchronous, 0: wait forever,
175 			 * >0: up to ms waiting
176 			 */
177 	int status; /* status for operation */
178 	struct completion done;
179 };
180 
181 enum {
182 	RTW_SCTX_SUBMITTED = -1,
183 	RTW_SCTX_DONE_SUCCESS = 0,
184 	RTW_SCTX_DONE_UNKNOWN,
185 	RTW_SCTX_DONE_TIMEOUT,
186 	RTW_SCTX_DONE_BUF_ALLOC,
187 	RTW_SCTX_DONE_BUF_FREE,
188 	RTW_SCTX_DONE_WRITE_PORT_ERR,
189 	RTW_SCTX_DONE_TX_DESC_NA,
190 	RTW_SCTX_DONE_TX_DENY,
191 	RTW_SCTX_DONE_CCX_PKT_FAIL,
192 	RTW_SCTX_DONE_DRV_STOP,
193 	RTW_SCTX_DONE_DEV_REMOVE,
194 };
195 
196 void rtw_sctx_init23a(struct submit_ctx *sctx, int timeout_ms);
197 int rtw_sctx_wait23a(struct submit_ctx *sctx);
198 void rtw23a_sctx_done_err(struct submit_ctx **sctx, int status);
199 void rtw_sctx_done23a(struct submit_ctx **sctx);
200 
201 struct xmit_buf {
202 	struct list_head list, list2;
203 	struct rtw_adapter *padapter;
204 
205 	u8 *pallocated_buf;
206 	u8 *pbuf;
207 	void *priv_data;
208 
209 	u16 ext_tag; /*  0: Normal xmitbuf, 1: extension xmitbuf. */
210 	u16 flags;
211 	u32 alloc_sz;
212 	u32  len;
213 	struct submit_ctx *sctx;
214 	u32	ff_hwaddr;
215 	struct urb *pxmit_urb[8];
216 	u8 bpending[8];
217 	int last[8];
218 #if defined(DBG_XMIT_BUF) || defined(DBG_XMIT_BUF_EXT)
219 	u8 no;
220 #endif
221 };
222 
223 struct xmit_frame {
224 	struct list_head	list;
225 	struct pkt_attrib attrib;
226 	struct sk_buff *pkt;
227 	int	frame_tag;
228 	struct rtw_adapter *padapter;
229 	u8	*buf_addr;
230 	struct xmit_buf *pxmitbuf;
231 
232 	s8	pkt_offset;
233 
234 	u8 ack_report;
235 
236 	u8 ext_tag; /* 0:data, 1:mgmt */
237 };
238 
239 struct tx_servq {
240 	struct list_head	tx_pending;
241 	struct rtw_queue	sta_pending;
242 	int qcnt;
243 };
244 
245 struct sta_xmit_priv {
246 	spinlock_t	lock;
247 	int	option;
248 	int	apsd_setting;	/* When bit mask is on, the associated edca
249 				 * queue supports APSD.
250 				 */
251 	struct tx_servq	be_q;			/* priority == 0,3 */
252 	struct tx_servq	bk_q;			/* priority == 1,2 */
253 	struct tx_servq	vi_q;			/* priority == 4,5 */
254 	struct tx_servq	vo_q;			/* priority == 6,7 */
255 	struct list_head legacy_dz;
256 	struct list_head apsd;
257 	u16 txseq_tid[16];
258 };
259 
260 struct	hw_txqueue {
261 	volatile int head;
262 	volatile int tail;
263 	volatile int free_sz;	/* in units of 64 bytes */
264 	volatile int free_cmdsz;
265 	volatile int txsz[8];
266 	uint	ff_hwaddr;
267 	uint	cmd_hwaddr;
268 	int	ac_tag;
269 };
270 
271 struct agg_pkt_info {
272 	u16 offset;
273 	u16 pkt_len;
274 };
275 
276 struct	xmit_priv {
277 	spinlock_t	lock;
278 
279 	struct semaphore	xmit_sema;
280 	struct semaphore	terminate_xmitthread_sema;
281 
282 	struct rtw_queue	be_pending;
283 	struct rtw_queue	bk_pending;
284 	struct rtw_queue	vi_pending;
285 	struct rtw_queue	vo_pending;
286 	struct rtw_queue	bm_pending;
287 
288 	int free_xmitframe_cnt;
289 	struct rtw_queue	free_xmit_queue;
290 
291 	int free_xframe_ext_cnt;
292 	struct rtw_queue free_xframe_ext_queue;
293 
294 	uint	frag_len;
295 
296 	struct rtw_adapter	*adapter;
297 
298 	u8   vcs_setting;
299 	u8	vcs;
300 	u8	vcs_type;
301 
302 	u64	tx_bytes;
303 	u64	tx_pkts;
304 	u64	tx_drop;
305 	u64	last_tx_bytes;
306 	u64	last_tx_pkts;
307 
308 	struct hw_xmit *hwxmits;
309 	u8	hwxmit_entry;
310 
311 	u8	wmm_para_seq[4];/* sequence for wmm ac parameter strength from
312 				 * large to small. it's value is 0->vo, 1->vi,
313 				 * 2->be, 3->bk.
314 				 */
315 
316 	struct semaphore	tx_retevt;/* all tx return event; */
317 	u8		txirp_cnt;/*  */
318 
319 	struct tasklet_struct xmit_tasklet;
320 	/* per AC pending irp */
321 	int beq_cnt;
322 	int bkq_cnt;
323 	int viq_cnt;
324 	int voq_cnt;
325 
326 	struct rtw_queue free_xmitbuf_queue;
327 	struct list_head xmitbuf_list;		/* track buffers for cleanup */
328 	struct rtw_queue pending_xmitbuf_queue;
329 	uint free_xmitbuf_cnt;
330 
331 	struct rtw_queue free_xmit_extbuf_queue;
332 	struct list_head xmitextbuf_list;	/* track buffers for cleanup */
333 	uint free_xmit_extbuf_cnt;
334 
335 	u16	nqos_ssn;
336 	int	ack_tx;
337 	struct mutex ack_tx_mutex;
338 	struct submit_ctx ack_tx_ops;
339 	spinlock_t lock_sctx;
340 };
341 
342 struct xmit_buf *rtw_alloc_xmitbuf23a_ext(struct xmit_priv *pxmitpriv);
343 s32 rtw_free_xmitbuf_ext23a(struct xmit_priv *pxmitpriv,
344 			 struct xmit_buf *pxmitbuf);
345 
346 struct xmit_buf *rtw_alloc_xmitbuf23a(struct xmit_priv *pxmitpriv);
347 s32 rtw_free_xmitbuf23a(struct xmit_priv *pxmitpriv, struct xmit_buf *pxmitbuf);
348 
349 void rtw_count_tx_stats23a(struct rtw_adapter *padapter,
350 			struct xmit_frame *pxmitframe, int sz);
351 void rtw_update_protection23a(struct rtw_adapter *padapter, u8 *ie, uint ie_len);
352 s32 rtw_put_snap23a(u8 *data, u16 h_proto);
353 struct xmit_frame *rtw_alloc_xmitframe23a_ext(struct xmit_priv *pxmitpriv);
354 struct xmit_frame *rtw_alloc_xmitframe23a_once(struct xmit_priv *pxmitpriv);
355 s32 rtw_free_xmitframe23a(struct xmit_priv *pxmitpriv,
356 		       struct xmit_frame *pxmitframe);
357 void rtw_free_xmitframe_queue23a(struct xmit_priv *pxmitpriv, struct rtw_queue *pframequeue);
358 struct tx_servq *rtw_get_sta_pending23a(struct rtw_adapter *padapter,
359 				     struct sta_info *psta, int up, u8 *ac);
360 s32 rtw_xmitframe_enqueue23a(struct rtw_adapter *padapter,
361 			     struct xmit_frame *pxmitframe);
362 struct xmit_frame *rtw_dequeue_xframe23a(struct xmit_priv *pxmitpriv,
363 				      struct hw_xmit *phwxmit_i, int entry);
364 s32 rtw_xmit23a_classifier(struct rtw_adapter *padapter,
365 			struct xmit_frame *pxmitframe);
366 u32 rtw_calculate_wlan_pkt_size_by_attribue23a(struct pkt_attrib *pattrib);
367 #define rtw_wlan_pkt_size(f) rtw_calculate_wlan_pkt_size_by_attribue23a(&f->attrib)
368 s32 rtw_xmitframe_coalesce23a(struct rtw_adapter *padapter, struct sk_buff *pkt,
369 			      struct xmit_frame *pxmitframe);
370 s32 _rtw_init_hw_txqueue(struct hw_txqueue *phw_txqueue, u8 ac_tag);
371 void _rtw_init_sta_xmit_priv23a(struct sta_xmit_priv *psta_xmitpriv);
372 
373 s32 rtw_txframes_pending23a(struct rtw_adapter *padapter);
374 s32 rtw_txframes_sta_ac_pending23a(struct rtw_adapter *padapter,
375 				struct pkt_attrib *pattrib);
376 void rtw_init_hwxmits23a(struct hw_xmit *phwxmit, int entry);
377 int _rtw_init_xmit_priv23a(struct xmit_priv *pxmitpriv,
378 			struct rtw_adapter *padapter);
379 void _rtw_free_xmit_priv23a(struct xmit_priv *pxmitpriv);
380 void rtw_alloc_hwxmits23a(struct rtw_adapter *padapter);
381 void rtw_free_hwxmits23a(struct rtw_adapter *padapter);
382 int rtw_xmit23a(struct rtw_adapter *padapter, struct sk_buff *pkt);
383 #if defined(CONFIG_8723AU_AP_MODE)
384 int xmitframe_enqueue_for_sleeping_sta23a(struct rtw_adapter *padapter,
385 				       struct xmit_frame *pxmitframe);
386 void stop_sta_xmit23a(struct rtw_adapter *padapter, struct sta_info *psta);
387 void wakeup_sta_to_xmit23a(struct rtw_adapter *padapter, struct sta_info *psta);
388 void xmit_delivery_enabled_frames23a(struct rtw_adapter *padapter,
389 				  struct sta_info *psta);
390 #endif
391 u8	qos_acm23a(u8 acm_mask, u8 priority);
392 u32	rtw_get_ff_hwaddr23a(struct xmit_frame	*pxmitframe);
393 int rtw_ack_tx_wait23a(struct xmit_priv *pxmitpriv, u32 timeout_ms);
394 void rtw_ack_tx_done23a(struct xmit_priv *pxmitpriv, int status);
395 
396 /* include after declaring struct xmit_buf, in order to avoid warning */
397 #include <xmit_osdep.h>
398 
399 #endif	/* _RTL871X_XMIT_H_ */
400