MT6620: add the new driver JB2 V1.0
[firefly-linux-kernel-4.4.55.git] / drivers / mtk_wcn_combo / drv_wlan / mt6620 / wlan / nic / nic_tx.c
1 /*
2 ** $Id: //Department/DaVinci/BRANCHES/MT6620_WIFI_DRIVER_V2_3/nic/nic_tx.c#1 $
3 */
4
5 /*! \file   nic_tx.c
6     \brief  Functions that provide TX operation in NIC Layer.
7
8     This file provides TX functions which are responsible for both Hardware and
9     Software Resource Management and keep their Synchronization.
10 */
11
12
13
14 /*
15 ** $Log: nic_tx.c $
16  *
17  * 06 13 2012 yuche.tsai
18  * NULL
19  * Update maintrunk driver.
20  * Add support for driver compose assoc request frame.
21  *
22  * 11 18 2011 eddie.chen
23  * [WCXRP00001096] [MT6620 Wi-Fi][Driver/FW] Enhance the log function (xlog)
24  * Add log counter for tx
25  *
26  * 11 09 2011 eddie.chen
27  * [WCXRP00001096] [MT6620 Wi-Fi][Driver/FW] Enhance the log function (xlog)
28  * Add xlog for beacon timeout and sta aging timeout.
29  *
30  * 11 08 2011 eddie.chen
31  * [WCXRP00001096] [MT6620 Wi-Fi][Driver/FW] Enhance the log function (xlog)
32  * Add xlog function.
33  *
34  * 05 17 2011 cp.wu
35  * [WCXRP00000732] [MT6620 Wi-Fi][AIS] No need to switch back to IDLE state when DEAUTH frame is dropped due to bss disconnection
36  * when TX DONE status is TX_RESULT_DROPPED_IN_DRIVER, no need to switch back to IDLE state.
37  *
38  * 04 12 2011 eddie.chen
39  * [WCXRP00000617] [MT6620 Wi-Fi][DRV/FW] Fix for sigma
40  * Fix the sta index in processing security frame
41  * Simple flow control for TC4 to avoid mgt frames for PS STA to occupy the TC4
42  * Add debug message.
43  *
44  * 04 12 2011 cp.wu
45  * [WCXRP00000631] [MT6620 Wi-Fi][Driver] Add an API for QM to retrieve current TC counter value and processing frame dropping cases for TC4 path
46  * remove unused variables.
47  *
48  * 04 12 2011 cp.wu
49  * [WCXRP00000631] [MT6620 Wi-Fi][Driver] Add an API for QM to retrieve current TC counter value and processing frame dropping cases for TC4 path
50  * 1. add nicTxGetResource() API for QM to make decisions.
51  * 2. if management frames is decided by QM for dropping, the call back is invoked to indicate such a case.
52  *
53  * 03 17 2011 cp.wu
54  * [WCXRP00000562] [MT6620 Wi-Fi][Driver] I/O buffer pre-allocation to avoid physically continuous memory shortage after system running for a long period
55  * use pre-allocated buffer for storing enhanced interrupt response as well
56  *
57  * 03 15 2011 cp.wu
58  * [WCXRP00000559] [MT6620 Wi-Fi][Driver] Combine TX/RX DMA buffers into a single one to reduce physically continuous memory consumption
59  * 1. deprecate CFG_HANDLE_IST_IN_SDIO_CALLBACK
60  * 2. Use common coalescing buffer for both TX/RX directions
61  * 
62  *
63  * 02 16 2011 cp.wu
64  * [WCXRP00000449] [MT6620 Wi-Fi][Driver] Refine CMD queue handling by adding an extra API for checking availble count and modify behavior
65  * 1. add new API: nicTxGetFreeCmdCount()
66  * 2. when there is insufficient command descriptor, nicTxEnqueueMsdu() will drop command packets directly
67  *
68  * 01 24 2011 cp.wu
69  * [WCXRP00000382] [MT6620 Wi-Fi][Driver] Track forwarding packet number with notifying tx thread for serving
70  * 1. add an extra counter for tracking pending forward frames.
71  * 2. notify TX service thread as well when there is pending forward frame
72  * 3. correct build errors leaded by introduction of Wi-Fi direct separation module
73  *
74  * 01 12 2011 cp.wu
75  * [WCXRP00000356] [MT6620 Wi-Fi][Driver] fill mac header length for security frames 'cause hardware header translation needs such information
76  * fill mac header length information for 802.1x frames.
77  *
78  * 12 31 2010 cp.wu
79  * [WCXRP00000335] [MT6620 Wi-Fi][Driver] change to use milliseconds sleep instead of delay to avoid blocking to system scheduling
80  * change to use msleep() and shorten waiting interval to reduce blocking to other task while Wi-Fi driver is being loaded
81  *
82  * 11 01 2010 yarco.yang
83  * [WCXRP00000149] [MT6620 WI-Fi][Driver]Fine tune performance on MT6516 platform
84  * Add GPIO debug function
85  *
86  * 10 18 2010 cp.wu
87  * [WCXRP00000117] [MT6620 Wi-Fi][Driver] Add logic for suspending driver when MT6620 is not responding anymore
88  * 1. when wlanAdapterStop() failed to send POWER CTRL command to firmware, do not poll for ready bit dis-assertion
89  * 2. shorten polling count for shorter response time
90  * 3. if bad I/O operation is detected during TX resource polling, then further operation is aborted as well
91  *
92  * 10 06 2010 cp.wu
93  * [WCXRP00000052] [MT6620 Wi-Fi][Driver] Eliminate Linux Compile Warning
94  * code reorganization to improve isolation between GLUE and CORE layers.
95  *
96  * 09 29 2010 wh.su
97  * [WCXRP00000072] [MT6620 Wi-Fi][Driver] Fix TKIP Counter Measure EAPoL callback register issue
98  * [MT6620 Wi-Fi][Driver] Fix TKIP Counter Measure EAPoL callback register issue.
99  *
100  * 09 27 2010 wh.su
101  * NULL
102  * since the u2TxByteCount_UserPriority will or another setting, keep the overall buffer for avoid error
103  *
104  * 09 24 2010 wh.su
105  * NULL
106  * [WCXRP000000058][MT6620 Wi-Fi][Driver] Fail to handshake with WAPI AP due the 802.1x frame send to fw with extra bytes padding.
107  *
108  * 09 01 2010 cp.wu
109  * NULL
110  * HIFSYS Clock Source Workaround
111  *
112  * 08 30 2010 cp.wu
113  * NULL
114  * API added: nicTxPendingPackets(), for simplifying porting layer
115  *
116  * 08 30 2010 cp.wu
117  * NULL
118  * eliminate klockwork errors
119  *
120  * 08 20 2010 wh.su
121  * NULL
122  * adding the eapol callback setting.
123  *
124  * 08 18 2010 yarco.yang
125  * NULL
126  * 1. Fixed HW checksum offload function not work under Linux issue.
127  * 2. Add debug message.
128  *
129  * 08 05 2010 yuche.tsai
130  * NULL
131  * .
132  *
133  * 08 03 2010 cp.wu
134  * NULL
135  * surpress compilation warning.
136  *
137  * 08 02 2010 jeffrey.chang
138  * NULL
139  * 1) modify tx service thread to avoid busy looping
140  * 2) add spin lock declartion for linux build
141  *
142  * 07 29 2010 cp.wu
143  * NULL
144  * simplify post-handling after TX_DONE interrupt is handled.
145  *
146  * 07 19 2010 jeffrey.chang
147  *
148  * Linux port modification
149  *
150  * 07 13 2010 cp.wu
151  *
152  * 1) MMPDUs are now sent to MT6620 by CMD queue for keeping strict order of 1X/MMPDU/CMD packets
153  * 2) integrate with qmGetFrameAction() for deciding which MMPDU/1X could pass checking for sending
154  * 2) enhance CMD_INFO_T descriptor number from 10 to 32 to avoid descriptor underflow under concurrent network operation
155  *
156  * 07 08 2010 cp.wu
157  *
158  * [WPD00003833] [MT6620 and MT5931] Driver migration - move to new repository.
159  *
160  * 06 29 2010 yarco.yang
161  * [WPD00003837][MT6620]Data Path Refine
162  * replace g_rQM with Adpater->rQM
163  *
164  * 06 25 2010 cp.wu
165  * [WPD00003833][MT6620 and MT5931] Driver migration
166  * add API in que_mgt to retrieve sta-rec index for security frames.
167  *
168  * 06 24 2010 cp.wu
169  * [WPD00003833][MT6620 and MT5931] Driver migration
170  * 802.1x and bluetooth-over-Wi-Fi security frames are now delievered to firmware via command path instead of data path.
171  *
172  * 06 23 2010 yarco.yang
173  * [WPD00003837][MT6620]Data Path Refine
174  * Merge g_arStaRec[] into adapter->arStaRec[]
175  *
176  * 06 22 2010 cp.wu
177  * [WPD00003833][MT6620 and MT5931] Driver migration
178  * 1) add command warpper for STA-REC/BSS-INFO sync.
179  * 2) enhance command packet sending procedure for non-oid part
180  * 3) add command packet definitions for STA-REC/BSS-INFO sync.
181  *
182  * 06 21 2010 cp.wu
183  * [WPD00003833][MT6620 and MT5931] Driver migration
184  * add checking for TX descriptor poll.
185  *
186  * 06 21 2010 cp.wu
187  * [WPD00003833][MT6620 and MT5931] Driver migration
188  * TX descriptors are now allocated once for reducing allocation overhead
189  *
190  * 06 18 2010 cm.chang
191  * [WPD00003841][LITE Driver] Migrate RLM/CNM to host driver
192  * Provide cnmMgtPktAlloc() and alloc/free function of msg/buf
193  *
194  * 06 15 2010 cp.wu
195  * [WPD00003833][MT6620 and MT5931] Driver migration
196  * change zero-padding for TX port access to HAL.
197  *
198  * 06 15 2010 cp.wu
199  * [WPD00003833][MT6620 and MT5931] Driver migration
200  * .
201  *
202  * 06 15 2010 cp.wu
203  * [WPD00003833][MT6620 and MT5931] Driver migration
204  * .
205  *
206  * 06 14 2010 cp.wu
207  * [WPD00003833][MT6620 and MT5931] Driver migration
208  * fill extra information for revised HIF_TX_HEADER.
209  *
210  * 06 11 2010 cp.wu
211  * [WPD00003833][MT6620 and MT5931] Driver migration
212  * 1) migrate assoc.c.
213  * 2) add ucTxSeqNum for tracking frames which needs TX-DONE awareness
214  * 3) add configuration options for CNM_MEM and RSN modules
215  * 4) add data path for management frames
216  * 5) eliminate rPacketInfo of MSDU_INFO_T
217  *
218  * 06 10 2010 cp.wu
219  * [WPD00003833][MT6620 and MT5931] Driver migration
220  * change to enqueue TX frame infinitely.
221  *
222  * 06 09 2010 cp.wu
223  * [WPD00003833][MT6620 and MT5931] Driver migration
224  * add TX_PACKET_MGMT to indicate the frame is coming from management modules
225  *
226  * 06 06 2010 kevin.huang
227  * [WPD00003832][MT6620 5931] Create driver base
228  * [MT6620 5931] Create driver base
229  *
230  * 05 10 2010 cp.wu
231  * [WPD00003831][MT6620 Wi-Fi] Add framework for Wi-Fi Direct support
232  * fill network type field while doing frame identification.
233  *
234  * 04 23 2010 cp.wu
235  * [WPD00001943]Create WiFi test driver framework on WinXP
236  * surpress compiler warning
237  *
238  * 04 06 2010 jeffrey.chang
239  * [WPD00003826]Initial import for Linux port
240  * Tag the packet for QoS on Tx path
241  *
242  * 03 30 2010 cp.wu
243  * [WPD00001943]Create WiFi test driver framework on WinXP
244  * remove driver-land statistics.
245  *
246  * 03 29 2010 jeffrey.chang
247  * [WPD00003826]Initial import for Linux port
248  * improve none-glue code portability
249  *
250  * 03 24 2010 jeffrey.chang
251  * [WPD00003826]Initial import for Linux port
252  * initial import for Linux port
253  *
254  * 03 24 2010 cp.wu
255  * [WPD00001943]Create WiFi test driver framework on WinXP
256  * generate information for OID_GEN_RCV_OK & OID_GEN_XMIT_OK
257  *  *  *  *  *
258  *
259 * 03 10 2010 cp.wu
260  * [WPD00001943]Create WiFi test driver framework on WinXP
261  * code clean: removing unused variables and structure definitions
262  *
263  * 03 08 2010 cp.wu
264  * [WPD00001943]Create WiFi test driver framework on WinXP
265  * 1) add another spin-lock to protect MsduInfoList due to it might be accessed by different thread.
266  *  *  *  * 2) change own-back acquiring procedure to wait for up to 16.67 seconds
267  *
268  * 03 02 2010 cp.wu
269  * [WPD00001943]Create WiFi test driver framework on WinXP
270  * add mutex to avoid multiple access to qmTxQueue simultaneously.
271  *
272  * 02 26 2010 cp.wu
273  * [WPD00001943]Create WiFi test driver framework on WinXP
274  * avoid refering to NDIS-specific data structure directly from non-glue layer.
275  *
276  * 02 24 2010 cp.wu
277  * [WPD00001943]Create WiFi test driver framework on WinXP
278  * add Ethernet destination address information in packet info for TX
279  *
280  * 02 10 2010 cp.wu
281  * [WPD00001943]Create WiFi test driver framework on WinXP
282  * 1) remove unused function in nic_rx.c [which has been handled in que_mgt.c]
283  *  *  *  *  *  * 2) firmware image length is now retrieved via NdisFileOpen
284  *  *  *  *  *  * 3) firmware image is not structured by (P_IMG_SEC_HDR_T) anymore
285  *  *  *  *  *  * 4) nicRxWaitResponse() revised
286  *  *  *  *  *  * 5) another set of TQ counter default value is added for fw-download state
287  *  *  *  *  *  * 6) Wi-Fi load address is now retrieved from registry too
288  *
289  * 02 09 2010 cp.wu
290  * [WPD00001943]Create WiFi test driver framework on WinXP
291  * 1. Permanent and current MAC address are now retrieved by CMD/EVENT packets instead of hard-coded address
292  *  *  *  *  *  *  *  *  * 2. follow MSDN defined behavior when associates to another AP
293  *  *  *  *  *  *  *  *  * 3. for firmware download, packet size could be up to 2048 bytes
294  *
295  * 02 08 2010 cp.wu
296  * [WPD00001943]Create WiFi test driver framework on WinXP
297  * prepare for implementing fw download logic
298  *
299  * 01 27 2010 cp.wu
300  * [WPD00001943]Create WiFi test driver framework on WinXP
301  * 1. eliminate improper variable in rHifInfo
302  *  *  *  *  *  *  *  *  * 2. block TX/ordinary OID when RF test mode is engaged
303  *  *  *  *  *  *  *  *  * 3. wait until firmware finish operation when entering into and leaving from RF test mode
304  *  *  *  *  *  *  *  *  * 4. correct some HAL implementation
305  *
306  * 01 13 2010 tehuang.liu
307  * [WPD00001943]Create WiFi test driver framework on WinXP
308  * Enabled the Burst_End Indication mechanism
309  *
310  * 01 13 2010 cp.wu
311  * [WPD00001943]Create WiFi test driver framework on WinXP
312  * TX: fill ucWlanHeaderLength/ucPktFormtId_Flags according to info provided by prMsduInfo
313  *
314  * 12 30 2009 cp.wu
315  * [WPD00001943]Create WiFi test driver framework on WinXP
316  * 1) According to CMD/EVENT documentation v0.8,
317  *  *  *  *  *  *  *  *  *  * OID_CUSTOM_TEST_RX_STATUS & OID_CUSTOM_TEST_TX_STATUS is no longer used,
318  *  *  *  *  *  *  *  *  *  * and result is retrieved by get ATInfo instead
319  *  *  *  *  *  *  *  *  *  * 2) add 4 counter for recording aggregation statistics
320 **  \main\maintrunk.MT6620WiFiDriver_Prj\44 2009-12-10 16:52:15 GMT mtk02752
321 **  remove unused API
322 **  \main\maintrunk.MT6620WiFiDriver_Prj\43 2009-12-07 22:44:24 GMT mtk02752
323 **  correct assertion criterion
324 **  \main\maintrunk.MT6620WiFiDriver_Prj\42 2009-12-07 21:15:52 GMT mtk02752
325 **  correct trivial mistake
326 **  \main\maintrunk.MT6620WiFiDriver_Prj\41 2009-12-04 15:47:21 GMT mtk02752
327 **  + always append a dword of zero on TX path to avoid TX aggregation to triggered on uninitialized data
328 **  + add more assertion for packet size check
329 **  \main\maintrunk.MT6620WiFiDriver_Prj\40 2009-12-04 14:51:55 GMT mtk02752
330 **  nicTxMsduInfo(): save ptr for next entry before attaching to qDataPort
331 **  \main\maintrunk.MT6620WiFiDriver_Prj\39 2009-12-04 11:54:54 GMT mtk02752
332 **  add 2 assertion for size check
333 **  \main\maintrunk.MT6620WiFiDriver_Prj\38 2009-12-03 16:20:35 GMT mtk01461
334 **  Add debug message
335 **  \main\maintrunk.MT6620WiFiDriver_Prj\37 2009-11-30 10:57:10 GMT mtk02752
336 **  1st DW of WIFI_CMD_T is shared with HIF_TX_HEADER_T
337 **  \main\maintrunk.MT6620WiFiDriver_Prj\36 2009-11-30 09:20:43 GMT mtk02752
338 **  use TC4 instead of TC5 for command packet
339 **  \main\maintrunk.MT6620WiFiDriver_Prj\35 2009-11-27 11:08:11 GMT mtk02752
340 **  add flush for reset
341 **  \main\maintrunk.MT6620WiFiDriver_Prj\34 2009-11-26 20:31:22 GMT mtk02752
342 **  fill prMsduInfo->ucUserPriority
343 **  \main\maintrunk.MT6620WiFiDriver_Prj\33 2009-11-25 21:04:33 GMT mtk02752
344 **  fill u2SeqNo
345 **  \main\maintrunk.MT6620WiFiDriver_Prj\32 2009-11-24 20:52:12 GMT mtk02752
346 **  integration with SD1's data path API
347 **  \main\maintrunk.MT6620WiFiDriver_Prj\31 2009-11-24 19:54:25 GMT mtk02752
348 **  nicTxRetransmitOfOsSendQue & nicTxData but changed to use nicTxMsduInfoList
349 **  \main\maintrunk.MT6620WiFiDriver_Prj\30 2009-11-23 17:53:18 GMT mtk02752
350 **  add nicTxCmd() for SD1_SD3_DATAPATH_INTEGRATION, which will append only HIF_TX_HEADER. seqNum, WIFI_CMD_T will be created inside oid handler
351 **  \main\maintrunk.MT6620WiFiDriver_Prj\29 2009-11-20 15:10:24 GMT mtk02752
352 **  use TxAccquireResource instead of accessing TCQ directly.
353 **  \main\maintrunk.MT6620WiFiDriver_Prj\28 2009-11-17 22:40:57 GMT mtk01084
354 **  \main\maintrunk.MT6620WiFiDriver_Prj\27 2009-11-17 17:35:40 GMT mtk02752
355 **  add nicTxMsduInfoList () implementation
356 **  \main\maintrunk.MT6620WiFiDriver_Prj\26 2009-11-17 11:07:10 GMT mtk02752
357 **  add nicTxAdjustTcq() implementation
358 **  \main\maintrunk.MT6620WiFiDriver_Prj\25 2009-11-16 22:28:38 GMT mtk02752
359 **  move aucFreeBufferCount/aucMaxNumOfBuffer into another structure
360 **  \main\maintrunk.MT6620WiFiDriver_Prj\24 2009-11-16 21:45:32 GMT mtk02752
361 **  add SD1_SD3_DATAPATH_INTEGRATION data path handling
362 **  \main\maintrunk.MT6620WiFiDriver_Prj\23 2009-11-13 13:29:56 GMT mtk01084
363 **  modify TX hdr format, fix tx retransmission issue
364 **  \main\maintrunk.MT6620WiFiDriver_Prj\22 2009-11-11 10:36:21 GMT mtk01084
365 **  \main\maintrunk.MT6620WiFiDriver_Prj\21 2009-11-04 14:11:11 GMT mtk01084
366 **  modify TX SW data structure
367 **  \main\maintrunk.MT6620WiFiDriver_Prj\20 2009-10-29 19:56:17 GMT mtk01084
368 **  modify HAL part
369 **  \main\maintrunk.MT6620WiFiDriver_Prj\19 2009-10-13 21:59:23 GMT mtk01084
370 **  update for new HW design
371 **  \main\maintrunk.MT6620WiFiDriver_Prj\18 2009-10-02 14:00:18 GMT mtk01725
372 **  \main\maintrunk.MT6620WiFiDriver_Prj\17 2009-05-20 12:26:06 GMT mtk01461
373 **  Assign SeqNum to CMD Packet
374 **  \main\maintrunk.MT6620WiFiDriver_Prj\16 2009-05-19 10:54:04 GMT mtk01461
375 **  Add debug message
376 **  \main\maintrunk.MT6620WiFiDriver_Prj\15 2009-05-12 09:41:55 GMT mtk01461
377 **  Fix Query Command need resp issue
378 **  \main\maintrunk.MT6620WiFiDriver_Prj\14 2009-04-29 15:44:38 GMT mtk01461
379 **  Move OS dependent code to kalQueryTxOOBData()
380 **  \main\maintrunk.MT6620WiFiDriver_Prj\13 2009-04-28 10:40:03 GMT mtk01461
381 **  Add nicTxReleaseResource() for SDIO_STATUS_ENHANCE, and also fix the TX aggregation issue for 1x packet to TX1 port
382 **  \main\maintrunk.MT6620WiFiDriver_Prj\12 2009-04-21 09:50:47 GMT mtk01461
383 **  Update nicTxCmd() for moving wait RESP function call to wlanSendCommand()
384 **  \main\maintrunk.MT6620WiFiDriver_Prj\11 2009-04-17 19:56:32 GMT mtk01461
385 **  Move the CMD_INFO_T related function to cmd_buf.c
386 **  \main\maintrunk.MT6620WiFiDriver_Prj\10 2009-04-17 18:14:40 GMT mtk01426
387 **  Update OOB query for TX packet
388 **  \main\maintrunk.MT6620WiFiDriver_Prj\9 2009-04-14 15:51:32 GMT mtk01426
389 **  Support PKGUIO
390 **  \main\maintrunk.MT6620WiFiDriver_Prj\8 2009-04-02 17:26:40 GMT mtk01461
391 **  Add virtual OOB for HIF LOOPBACK SW PRETEST
392 **  \main\maintrunk.MT6620WiFiDriver_Prj\7 2009-04-01 10:54:43 GMT mtk01461
393 **  Add function for SDIO_TX_ENHANCE
394 **  \main\maintrunk.MT6620WiFiDriver_Prj\6 2009-03-23 21:53:47 GMT mtk01461
395 **  Add code for retransmit of rOsSendQueue, mpSendPacket(), and add code for TX Checksum offload, Loopback Test.
396 **  \main\maintrunk.MT6620WiFiDriver_Prj\5 2009-03-23 00:33:51 GMT mtk01461
397 **  Add code for TX Data & Cmd Packet
398 **  \main\maintrunk.MT6620WiFiDriver_Prj\4 2009-03-18 20:25:40 GMT mtk01461
399 **  Fix LINT warning
400 **  \main\maintrunk.MT6620WiFiDriver_Prj\3 2009-03-16 09:10:30 GMT mtk01461
401 **  Update TX PATH API
402 **  \main\maintrunk.MT6620WiFiDriver_Prj\2 2009-03-10 20:26:04 GMT mtk01426
403 **  Init for develop
404 **
405 */
406
407 /*******************************************************************************
408 *                         C O M P I L E R   F L A G S
409 ********************************************************************************
410 */
411
412 /*******************************************************************************
413 *                    E X T E R N A L   R E F E R E N C E S
414 ********************************************************************************
415 */
416 #include "precomp.h"
417
418 /*******************************************************************************
419 *                              C O N S T A N T S
420 ********************************************************************************
421 */
422
423 /*******************************************************************************
424 *                             D A T A   T Y P E S
425 ********************************************************************************
426 */
427
428 /*******************************************************************************
429 *                            P U B L I C   D A T A
430 ********************************************************************************
431 */
432
433 /*******************************************************************************
434 *                           P R I V A T E   D A T A
435 ********************************************************************************
436 */
437
438 /*******************************************************************************
439 *                                 M A C R O S
440 ********************************************************************************
441 */
442
443 /*******************************************************************************
444 *                  F U N C T I O N   D E C L A R A T I O N S
445 ********************************************************************************
446 */
447
448 /*******************************************************************************
449 *                              F U N C T I O N S
450 ********************************************************************************
451 */
452 /*----------------------------------------------------------------------------*/
453 /*!
454 * @brief This function will initial all variables in regard to SW TX Queues and
455 *        all free lists of MSDU_INFO_T and SW_TFCB_T.
456 *
457 * @param prAdapter  Pointer to the Adapter structure.
458 *
459 * @return (none)
460 */
461 /*----------------------------------------------------------------------------*/
462 VOID
463 nicTxInitialize (
464     IN P_ADAPTER_T  prAdapter
465     )
466 {
467     P_TX_CTRL_T prTxCtrl;
468     PUINT_8 pucMemHandle;
469     P_MSDU_INFO_T prMsduInfo;
470     UINT_32 i;
471     KAL_SPIN_LOCK_DECLARATION();
472
473     DEBUGFUNC("nicTxInitialize");
474
475     ASSERT(prAdapter);
476     prTxCtrl = &prAdapter->rTxCtrl;
477
478     //4 <1> Initialization of Traffic Class Queue Parameters
479     nicTxResetResource(prAdapter);
480
481 #if CFG_SDIO_TX_AGG
482     prTxCtrl->pucTxCoalescingBufPtr = prAdapter->pucCoalescingBufCached;
483 #endif /* CFG_SDIO_TX_AGG */
484
485     // allocate MSDU_INFO_T and link it into rFreeMsduInfoList
486     QUEUE_INITIALIZE(&prTxCtrl->rFreeMsduInfoList);
487
488     pucMemHandle = prTxCtrl->pucTxCached;
489     for (i = 0 ; i < CFG_TX_MAX_PKT_NUM ; i++) {
490         prMsduInfo = (P_MSDU_INFO_T)pucMemHandle;
491         kalMemZero(prMsduInfo, sizeof(MSDU_INFO_T));
492
493         KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_MSDU_INFO_LIST);
494         QUEUE_INSERT_TAIL(&prTxCtrl->rFreeMsduInfoList, (P_QUE_ENTRY_T)prMsduInfo);
495         KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_MSDU_INFO_LIST);
496
497         pucMemHandle += ALIGN_4(sizeof(MSDU_INFO_T));
498     }
499
500     ASSERT(prTxCtrl->rFreeMsduInfoList.u4NumElem == CFG_TX_MAX_PKT_NUM);
501     /* Check if the memory allocation consist with this initialization function */
502     ASSERT((UINT_32)(pucMemHandle - prTxCtrl->pucTxCached) == prTxCtrl->u4TxCachedSize);
503
504     QUEUE_INITIALIZE(&prTxCtrl->rTxMgmtTxingQueue);
505     prTxCtrl->i4TxMgmtPendingNum = 0;
506
507 #if CFG_HIF_STATISTICS
508     prTxCtrl->u4TotalTxAccessNum = 0;
509     prTxCtrl->u4TotalTxPacketNum = 0;
510 #endif
511
512     prTxCtrl->i4PendingFwdFrameCount = 0;
513
514     qmInit(prAdapter);
515
516     TX_RESET_ALL_CNTS(prTxCtrl);
517
518     return;
519 } /* end of nicTxInitialize() */
520
521
522 /*----------------------------------------------------------------------------*/
523 /*!
524 * \brief Driver maintain a variable that is synchronous with the usage of individual
525 *        TC Buffer Count. This function will check if has enough TC Buffer for incoming
526 *        packet and then update the value after promise to provide the resources.
527 *
528 * \param[in] prAdapter              Pointer to the Adapter structure.
529 * \param[in] ucTC                   Specify the resource of TC
530 *
531 * \retval WLAN_STATUS_SUCCESS   Resource is available and been assigned.
532 * \retval WLAN_STATUS_RESOURCES Resource is not available.
533 */
534 /*----------------------------------------------------------------------------*/
535 WLAN_STATUS
536 nicTxAcquireResource (
537     IN P_ADAPTER_T  prAdapter,
538     IN UINT_8       ucTC
539     )
540 {
541     P_TX_CTRL_T prTxCtrl;
542     WLAN_STATUS u4Status = WLAN_STATUS_RESOURCES;
543     KAL_SPIN_LOCK_DECLARATION();
544
545     ASSERT(prAdapter);
546     prTxCtrl = &prAdapter->rTxCtrl;
547
548
549     KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_RESOURCE);
550
551 //    DbgPrint("nicTxAcquireResource prTxCtrl->rTc.aucFreeBufferCount[%d]=%d\n", ucTC, prTxCtrl->rTc.aucFreeBufferCount[ucTC]);
552
553     if (prTxCtrl->rTc.aucFreeBufferCount[ucTC]) {
554
555         prTxCtrl->rTc.aucFreeBufferCount[ucTC]--;
556
557         DBGLOG(TX, EVENT, ("Acquire: TC = %d aucFreeBufferCount = %d\n",
558             ucTC, prTxCtrl->rTc.aucFreeBufferCount[ucTC]));
559
560         u4Status = WLAN_STATUS_SUCCESS;
561     }
562     KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_RESOURCE);
563
564     return u4Status;
565
566 }/* end of nicTxAcquireResourceAndTFCBs() */
567
568
569 /*----------------------------------------------------------------------------*/
570 /*!
571 * @brief Driver maintain a variable that is synchronous with the usage of individual
572 *        TC Buffer Count. This function will do polling if FW has return the resource.
573 *        Used when driver start up before enable interrupt.
574 *
575 * @param prAdapter      Pointer to the Adapter structure.
576 * @param ucTC           Specify the resource of TC
577 *
578 * @retval WLAN_STATUS_SUCCESS   Resource is available.
579 * @retval WLAN_STATUS_FAILURE   Resource is not available.
580 */
581 /*----------------------------------------------------------------------------*/
582 WLAN_STATUS
583 nicTxPollingResource (
584     IN P_ADAPTER_T  prAdapter,
585     IN UINT_8       ucTC
586     )
587 {
588     P_TX_CTRL_T prTxCtrl;
589     WLAN_STATUS u4Status = WLAN_STATUS_FAILURE;
590     INT_32 i = NIC_TX_RESOURCE_POLLING_TIMEOUT;
591     UINT_32 au4WTSR[2];
592
593     ASSERT(prAdapter);
594     prTxCtrl = &prAdapter->rTxCtrl;
595
596     if (ucTC >= TC_NUM) {
597         return WLAN_STATUS_FAILURE;
598     }
599
600     if (prTxCtrl->rTc.aucFreeBufferCount[ucTC] > 0) {
601         return WLAN_STATUS_SUCCESS;
602     }
603
604     while (i-- > 0) {
605         HAL_READ_TX_RELEASED_COUNT(prAdapter, au4WTSR);
606
607         if(kalIsCardRemoved(prAdapter->prGlueInfo) == TRUE
608                 || fgIsBusAccessFailed == TRUE) {
609             u4Status = WLAN_STATUS_FAILURE;
610             break;
611         }
612         else if (nicTxReleaseResource(prAdapter, (PUINT_8)au4WTSR)) {
613             if (prTxCtrl->rTc.aucFreeBufferCount[ucTC] > 0) {
614                 u4Status = WLAN_STATUS_SUCCESS;
615                 break;
616             }
617             else {
618                 kalMsleep(NIC_TX_RESOURCE_POLLING_DELAY_MSEC);
619             }
620         }
621         else {
622             kalMsleep(NIC_TX_RESOURCE_POLLING_DELAY_MSEC);
623         }
624     }
625
626 #if DBG
627     {
628         INT_32 i4Times = NIC_TX_RESOURCE_POLLING_TIMEOUT - (i+1);
629
630         if (i4Times) {
631             DBGLOG(TX, TRACE, ("Polling MCR_WTSR delay %d times, %d msec\n",
632                 i4Times, (i4Times * NIC_TX_RESOURCE_POLLING_DELAY_MSEC)));
633         }
634     }
635 #endif /* DBG */
636
637     return u4Status;
638
639 } /* end of nicTxPollingResource() */
640
641
642 /*----------------------------------------------------------------------------*/
643 /*!
644 * \brief Driver maintain a variable that is synchronous with the usage of individual
645 *        TC Buffer Count. This function will release TC Buffer count according to
646 *        the given TX_STATUS COUNTER after TX Done.
647 *
648 * \param[in] prAdapter              Pointer to the Adapter structure.
649 * \param[in] u4TxStatusCnt          Value of TX STATUS
650 *
651 * @return (none)
652 */
653 /*----------------------------------------------------------------------------*/
654 BOOLEAN
655 nicTxReleaseResource (
656     IN P_ADAPTER_T  prAdapter,
657     IN UINT_8*      aucTxRlsCnt
658     )
659 {
660     PUINT_32 pu4Tmp = (PUINT_32)aucTxRlsCnt;
661     P_TX_CTRL_T prTxCtrl;
662     BOOLEAN bStatus = FALSE;
663     UINT_32 i;
664
665     KAL_SPIN_LOCK_DECLARATION();
666
667
668     ASSERT(prAdapter);
669     prTxCtrl = &prAdapter->rTxCtrl;
670     // DBGLOG(TX, TRACE, ("\n"));
671     if (pu4Tmp[0] | pu4Tmp[1]) {
672
673         KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_RESOURCE);
674         for (i = 0; i < TC_NUM; i++) {
675             prTxCtrl->rTc.aucFreeBufferCount[i] += aucTxRlsCnt[i];
676
677             if ((i==1) || (i==5)){
678                 DBGLOG(TX, EVENT, ("Release: i = %d aucFreeBufferCount = %d\n",
679                     i, prTxCtrl->rTc.aucFreeBufferCount[i]));
680             }
681         }
682         KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_RESOURCE);
683 #if 0
684         for (i = 0; i < TC_NUM; i++) {
685             DBGLOG(INIT, TRACE, ("aucFreeBufferCount[%d]: %d, aucMaxNumOfBuffer[%d]: %d\n",
686                 i, prTxCtrl->rTc.aucFreeBufferCount[i], i, prTxCtrl->rTc.aucMaxNumOfBuffer[i]));
687         }
688         DbgPrint("prTxCtrl->rTc.aucFreeBufferCount[0]=%d\n", prTxCtrl->rTc.aucFreeBufferCount[0]);
689         DbgPrint("prTxCtrl->rTc.aucFreeBufferCount[1]=%d\n", prTxCtrl->rTc.aucFreeBufferCount[1]);
690         DbgPrint("prTxCtrl->rTc.aucFreeBufferCount[2]=%d\n", prTxCtrl->rTc.aucFreeBufferCount[2]);
691         DbgPrint("prTxCtrl->rTc.aucFreeBufferCount[3]=%d\n", prTxCtrl->rTc.aucFreeBufferCount[3]);
692         DbgPrint("prTxCtrl->rTc.aucFreeBufferCount[4]=%d\n", prTxCtrl->rTc.aucFreeBufferCount[4]);
693         DbgPrint("prTxCtrl->rTc.aucFreeBufferCount[5]=%d\n", prTxCtrl->rTc.aucFreeBufferCount[5]);
694 #endif
695         ASSERT(prTxCtrl->rTc.aucFreeBufferCount[TC0_INDEX] <= prTxCtrl->rTc.aucMaxNumOfBuffer[TC0_INDEX]);
696         ASSERT(prTxCtrl->rTc.aucFreeBufferCount[TC1_INDEX] <= prTxCtrl->rTc.aucMaxNumOfBuffer[TC1_INDEX]);
697         ASSERT(prTxCtrl->rTc.aucFreeBufferCount[TC2_INDEX] <= prTxCtrl->rTc.aucMaxNumOfBuffer[TC2_INDEX]);
698         ASSERT(prTxCtrl->rTc.aucFreeBufferCount[TC3_INDEX] <= prTxCtrl->rTc.aucMaxNumOfBuffer[TC3_INDEX]);
699         ASSERT(prTxCtrl->rTc.aucFreeBufferCount[TC4_INDEX] <= prTxCtrl->rTc.aucMaxNumOfBuffer[TC4_INDEX]);
700         ASSERT(prTxCtrl->rTc.aucFreeBufferCount[TC5_INDEX] <= prTxCtrl->rTc.aucMaxNumOfBuffer[TC5_INDEX]);
701         bStatus = TRUE;
702     }
703
704     return bStatus;
705 } /* end of nicTxReleaseResource() */
706
707
708 /*----------------------------------------------------------------------------*/
709 /*!
710 * \brief Reset TC Buffer Count to initialized value
711 *
712 * \param[in] prAdapter              Pointer to the Adapter structure.
713 *
714 * @return WLAN_STATUS_SUCCESS
715 */
716 /*----------------------------------------------------------------------------*/
717 WLAN_STATUS
718 nicTxResetResource (
719     IN P_ADAPTER_T  prAdapter
720     )
721 {
722     P_TX_CTRL_T prTxCtrl;
723
724     KAL_SPIN_LOCK_DECLARATION();
725
726     DEBUGFUNC("nicTxResetResource");
727
728     ASSERT(prAdapter);
729     prTxCtrl = &prAdapter->rTxCtrl;
730
731     KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_RESOURCE);
732
733     prTxCtrl->rTc.aucMaxNumOfBuffer[TC0_INDEX] = NIC_TX_BUFF_COUNT_TC0;
734     prTxCtrl->rTc.aucFreeBufferCount[TC0_INDEX] = NIC_TX_BUFF_COUNT_TC0;
735
736     prTxCtrl->rTc.aucMaxNumOfBuffer[TC1_INDEX] = NIC_TX_BUFF_COUNT_TC1;
737     prTxCtrl->rTc.aucFreeBufferCount[TC1_INDEX] = NIC_TX_BUFF_COUNT_TC1;
738
739     prTxCtrl->rTc.aucMaxNumOfBuffer[TC2_INDEX] = NIC_TX_BUFF_COUNT_TC2;
740     prTxCtrl->rTc.aucFreeBufferCount[TC2_INDEX] = NIC_TX_BUFF_COUNT_TC2;
741
742     prTxCtrl->rTc.aucMaxNumOfBuffer[TC3_INDEX] = NIC_TX_BUFF_COUNT_TC3;
743     prTxCtrl->rTc.aucFreeBufferCount[TC3_INDEX] = NIC_TX_BUFF_COUNT_TC3;
744
745     prTxCtrl->rTc.aucMaxNumOfBuffer[TC4_INDEX] = NIC_TX_BUFF_COUNT_TC4;
746     prTxCtrl->rTc.aucFreeBufferCount[TC4_INDEX] = NIC_TX_BUFF_COUNT_TC4;
747
748     prTxCtrl->rTc.aucMaxNumOfBuffer[TC5_INDEX] = NIC_TX_BUFF_COUNT_TC5;
749     prTxCtrl->rTc.aucFreeBufferCount[TC5_INDEX] = NIC_TX_BUFF_COUNT_TC5;
750
751     KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_RESOURCE);
752
753     return WLAN_STATUS_SUCCESS;
754 }
755
756
757 /*----------------------------------------------------------------------------*/
758 /*!
759 * @brief Driver maintain a variable that is synchronous with the usage of individual
760 *        TC Buffer Count. This function will return the value for other component
761 *        which needs this information for making decisions
762 *
763 * @param prAdapter      Pointer to the Adapter structure.
764 * @param ucTC           Specify the resource of TC
765 *
766 * @retval UINT_8        The number of corresponding TC number
767 */
768 /*----------------------------------------------------------------------------*/
769 UINT_8
770 nicTxGetResource (
771     IN P_ADAPTER_T  prAdapter,
772     IN UINT_8       ucTC
773     )
774 {
775     P_TX_CTRL_T prTxCtrl;
776
777     ASSERT(prAdapter);
778     prTxCtrl = &prAdapter->rTxCtrl;
779
780     ASSERT(prTxCtrl);
781
782     if (ucTC >= TC_NUM) {
783         return 0;
784     }
785     else {
786         return prTxCtrl->rTc.aucFreeBufferCount[ucTC];
787     }
788 }
789
790
791 /*----------------------------------------------------------------------------*/
792 /*!
793 * @brief In this function, we'll aggregate frame(PACKET_INFO_T)
794 * corresponding to HIF TX port
795 *
796 * @param prAdapter              Pointer to the Adapter structure.
797 * @param prMsduInfoListHead     a link list of P_MSDU_INFO_T
798 *
799 * @retval WLAN_STATUS_SUCCESS   Bus access ok.
800 * @retval WLAN_STATUS_FAILURE   Bus access fail.
801 */
802 /*----------------------------------------------------------------------------*/
803 WLAN_STATUS
804 nicTxMsduInfoList (
805     IN P_ADAPTER_T      prAdapter,
806     IN P_MSDU_INFO_T    prMsduInfoListHead
807     )
808 {
809     P_MSDU_INFO_T prMsduInfo, prNextMsduInfo;
810     QUE_T qDataPort0, qDataPort1;
811     WLAN_STATUS status;
812
813     ASSERT(prAdapter);
814     ASSERT(prMsduInfoListHead);
815
816     prMsduInfo = prMsduInfoListHead;
817
818     QUEUE_INITIALIZE(&qDataPort0);
819     QUEUE_INITIALIZE(&qDataPort1);
820
821     // Separate MSDU_INFO_T lists into 2 categories: for Port#0 & Port#1
822     while(prMsduInfo) {
823         prNextMsduInfo = (P_MSDU_INFO_T)QUEUE_GET_NEXT_ENTRY((P_QUE_ENTRY_T)prMsduInfo);
824 #if DBG && 0
825         LOG_FUNC("nicTxMsduInfoList Acquire TC %d net %u mac len %u len %u Type %u 1x %u 11 %u\n",
826             prMsduInfo->ucTC,
827                 prMsduInfo->ucNetworkType,
828                 prMsduInfo->ucMacHeaderLength,
829             prMsduInfo->u2FrameLength,
830             prMsduInfo->ucPacketType,
831             prMsduInfo->fgIs802_1x,
832             prMsduInfo->fgIs802_11 );
833
834         LOG_FUNC("Dest Mac: " MACSTR "\n",
835                 MAC2STR(prMsduInfo->aucEthDestAddr));
836 #endif
837
838         switch(prMsduInfo->ucTC) {
839         case TC0_INDEX:
840         case TC1_INDEX:
841         case TC2_INDEX:
842         case TC3_INDEX:
843         case TC5_INDEX: // Broadcast/multicast data packets
844             QUEUE_GET_NEXT_ENTRY((P_QUE_ENTRY_T)prMsduInfo) = NULL;
845             QUEUE_INSERT_TAIL(&qDataPort0, (P_QUE_ENTRY_T)prMsduInfo);
846             status = nicTxAcquireResource(prAdapter, prMsduInfo->ucTC);
847             ASSERT(status == WLAN_STATUS_SUCCESS)
848
849             break;
850
851         case TC4_INDEX: // Command or 802.1x packets
852             QUEUE_GET_NEXT_ENTRY((P_QUE_ENTRY_T)prMsduInfo) = NULL;
853             QUEUE_INSERT_TAIL(&qDataPort1, (P_QUE_ENTRY_T)prMsduInfo);
854
855             status = nicTxAcquireResource(prAdapter, prMsduInfo->ucTC);
856             ASSERT(status == WLAN_STATUS_SUCCESS)
857
858             break;
859
860         default:
861             ASSERT(0);
862             break;
863         }
864
865         prMsduInfo = prNextMsduInfo;
866     }
867
868     if(qDataPort0.u4NumElem > 0) {
869         nicTxMsduQueue(prAdapter, 0, &qDataPort0);
870     }
871
872     if(qDataPort1.u4NumElem > 0) {
873         nicTxMsduQueue(prAdapter, 1, &qDataPort1);
874     }
875
876     return WLAN_STATUS_SUCCESS;
877 }
878
879
880 /*----------------------------------------------------------------------------*/
881 /*!
882 * @brief In this function, we'll write frame(PACKET_INFO_T) into HIF.
883 *
884 * @param prAdapter              Pointer to the Adapter structure.
885 * @param ucPortIdx              Port Number
886 * @param prQue                  a link list of P_MSDU_INFO_T
887 *
888 * @retval WLAN_STATUS_SUCCESS   Bus access ok.
889 * @retval WLAN_STATUS_FAILURE   Bus access fail.
890 */
891 /*----------------------------------------------------------------------------*/
892 WLAN_STATUS
893 nicTxMsduQueue (
894     IN P_ADAPTER_T  prAdapter,
895     UINT_8          ucPortIdx,
896     P_QUE_T         prQue
897     )
898 {
899     P_MSDU_INFO_T prMsduInfo, prNextMsduInfo;
900     HIF_TX_HEADER_T rHwTxHeader;
901     P_NATIVE_PACKET prNativePacket;
902     UINT_16 u2OverallBufferLength;
903     UINT_8 ucEtherTypeOffsetInWord;
904     PUINT_8 pucOutputBuf = (PUINT_8)NULL; /* Pointer to Transmit Data Structure Frame */
905     UINT_32 u4TxHdrSize;
906     UINT_32 u4ValidBufSize;
907     UINT_32 u4TotalLength;
908     P_TX_CTRL_T prTxCtrl;
909     QUE_T rFreeQueue;
910 #if CFG_TCP_IP_CHKSUM_OFFLOAD
911     UINT_8 ucChksumFlag;
912 #endif
913
914     ASSERT(prAdapter);
915     ASSERT(ucPortIdx < 2);
916     ASSERT(prQue);
917
918     prTxCtrl = &prAdapter->rTxCtrl;
919     u4ValidBufSize = prAdapter->u4CoalescingBufCachedSize;
920
921 #if CFG_HIF_STATISTICS
922     prTxCtrl->u4TotalTxAccessNum++;
923     prTxCtrl->u4TotalTxPacketNum += prQue->u4NumElem;
924 #endif
925
926     QUEUE_INITIALIZE(&rFreeQueue);
927
928     if(prQue->u4NumElem > 0) {
929         prMsduInfo = (P_MSDU_INFO_T)QUEUE_GET_HEAD(prQue);
930         pucOutputBuf = prTxCtrl->pucTxCoalescingBufPtr;
931         u4TotalLength = 0;
932
933         while(prMsduInfo) {
934
935             kalMemZero(&rHwTxHeader, sizeof(rHwTxHeader));
936
937             prNativePacket = prMsduInfo->prPacket;
938
939             ASSERT(prNativePacket);
940
941             u4TxHdrSize = TX_HDR_SIZE;
942
943             u2OverallBufferLength = ((prMsduInfo->u2FrameLength + TX_HDR_SIZE) &
944                     (UINT_16)HIF_TX_HDR_TX_BYTE_COUNT_MASK);
945
946             rHwTxHeader.u2TxByteCount_UserPriority = u2OverallBufferLength;
947             rHwTxHeader.u2TxByteCount_UserPriority |=
948                 ((UINT_16)prMsduInfo->ucUserPriority << HIF_TX_HDR_USER_PRIORITY_OFFSET);
949
950             if (prMsduInfo->fgIs802_11) {
951                 ucEtherTypeOffsetInWord =
952                     (TX_HDR_SIZE + prMsduInfo->ucMacHeaderLength + prMsduInfo->ucLlcLength) >> 1;
953             }
954             else {
955                 ucEtherTypeOffsetInWord =
956                     ((ETHER_HEADER_LEN - ETHER_TYPE_LEN) + TX_HDR_SIZE) >> 1;
957             }
958
959             rHwTxHeader.ucEtherTypeOffset =
960                 ucEtherTypeOffsetInWord & HIF_TX_HDR_ETHER_TYPE_OFFSET_MASK;
961
962             rHwTxHeader.ucResource_PktType_CSflags = (prMsduInfo->ucTC) << HIF_TX_HDR_RESOURCE_OFFSET;
963             rHwTxHeader.ucResource_PktType_CSflags |=
964                 (UINT_8)(((prMsduInfo->ucPacketType) << HIF_TX_HDR_PACKET_TYPE_OFFSET) &
965                         (HIF_TX_HDR_PACKET_TYPE_MASK));
966
967 #if CFG_TCP_IP_CHKSUM_OFFLOAD
968             if (prMsduInfo->eSrc == TX_PACKET_OS
969                     || prMsduInfo->eSrc == TX_PACKET_FORWARDING) {
970                 if (prAdapter->u4CSUMFlags &
971                         (CSUM_OFFLOAD_EN_TX_TCP |
972                          CSUM_OFFLOAD_EN_TX_UDP |
973                          CSUM_OFFLOAD_EN_TX_IP)) {
974                     kalQueryTxChksumOffloadParam(prNativePacket, &ucChksumFlag);
975
976                     if (ucChksumFlag & TX_CS_IP_GEN) {
977                         rHwTxHeader.ucResource_PktType_CSflags |= (UINT_8)HIF_TX_HDR_IP_CSUM;
978                     }
979
980                     if (ucChksumFlag & TX_CS_TCP_UDP_GEN) {
981                         rHwTxHeader.ucResource_PktType_CSflags |= (UINT_8)HIF_TX_HDR_TCP_CSUM;
982                     }
983                 }
984             }
985 #endif /* CFG_TCP_IP_CHKSUM_OFFLOAD */
986
987             rHwTxHeader.u2LLH = prMsduInfo->u2PalLLH;
988             rHwTxHeader.ucStaRecIdx = prMsduInfo->ucStaRecIndex;
989             rHwTxHeader.ucForwardingType_SessionID_Reserved =
990                 (prMsduInfo->ucPsForwardingType) | ((prMsduInfo->ucPsSessionID) << HIF_TX_HDR_PS_SESSION_ID_OFFSET)
991                 | ((prMsduInfo->fgIsBurstEnd)? HIF_TX_HDR_BURST_END_MASK : 0);
992
993             rHwTxHeader.ucWlanHeaderLength = (prMsduInfo->ucMacHeaderLength & HIF_TX_HDR_WLAN_HEADER_LEN_MASK);
994             rHwTxHeader.ucPktFormtId_Flags =
995                 (prMsduInfo->ucFormatID & HIF_TX_HDR_FORMAT_ID_MASK)
996                 | ((prMsduInfo->ucNetworkType << HIF_TX_HDR_NETWORK_TYPE_OFFSET) & HIF_TX_HDR_NETWORK_TYPE_MASK)
997                 | ((prMsduInfo->fgIs802_1x << HIF_TX_HDR_FLAG_1X_FRAME_OFFSET) & HIF_TX_HDR_FLAG_1X_FRAME_MASK)
998                 | ((prMsduInfo->fgIs802_11 << HIF_TX_HDR_FLAG_802_11_FORMAT_OFFSET) & HIF_TX_HDR_FLAG_802_11_FORMAT_MASK);
999
1000             rHwTxHeader.u2SeqNo = prMsduInfo->u2AclSN;
1001
1002             if(prMsduInfo->pfTxDoneHandler) {
1003                 rHwTxHeader.ucPacketSeqNo = prMsduInfo->ucTxSeqNum;
1004                 rHwTxHeader.ucAck_BIP_BasicRate = HIF_TX_HDR_NEED_ACK;
1005             }
1006             else {
1007                 rHwTxHeader.ucPacketSeqNo = 0;
1008                 rHwTxHeader.ucAck_BIP_BasicRate = 0;
1009             }
1010
1011             if(prMsduInfo->fgIsBIP) {
1012                 rHwTxHeader.ucAck_BIP_BasicRate |= HIF_TX_HDR_BIP;
1013             }
1014
1015             if(prMsduInfo->fgIsBasicRate) {
1016                 rHwTxHeader.ucAck_BIP_BasicRate |= HIF_TX_HDR_BASIC_RATE;
1017             }
1018
1019 #if CFG_SDIO_TX_AGG
1020             // attach to coalescing buffer
1021             kalMemCopy(pucOutputBuf + u4TotalLength, &rHwTxHeader, u4TxHdrSize);
1022             u4TotalLength += u4TxHdrSize;
1023
1024             if (prMsduInfo->eSrc == TX_PACKET_OS
1025                     || prMsduInfo->eSrc == TX_PACKET_FORWARDING) {
1026                 kalCopyFrame(prAdapter->prGlueInfo,
1027                         prNativePacket,
1028                         pucOutputBuf + u4TotalLength);
1029             }
1030             else if(prMsduInfo->eSrc == TX_PACKET_MGMT) {
1031                 kalMemCopy(pucOutputBuf + u4TotalLength,
1032                         prNativePacket,
1033                         prMsduInfo->u2FrameLength);
1034             }
1035             else {
1036                 ASSERT(0);
1037             }
1038
1039             u4TotalLength += ALIGN_4(prMsduInfo->u2FrameLength);
1040
1041 #else
1042             kalMemCopy(pucOutputBuf, &rHwTxHeader, u4TxHdrSize);
1043
1044             /* Copy Frame Body */
1045             if (prMsduInfo->eSrc == TX_PACKET_OS
1046                     || prMsduInfo->eSrc == TX_PACKET_FORWARDING) {
1047                 kalCopyFrame(prAdapter->prGlueInfo,
1048                         prNativePacket,
1049                         pucOutputBuf + u4TxHdrSize);
1050             }
1051             else if(prMsduInfo->eSrc == TX_PACKET_MGMT) {
1052                 kalMemCopy(pucOutputBuf + u4TxHdrSize,
1053                         prNativePacket,
1054                         prMsduInfo->u2FrameLength);
1055             }
1056             else {
1057                 ASSERT(0);
1058             }
1059
1060             ASSERT(u2OverallBufferLength <= u4ValidBufSize);
1061
1062             HAL_WRITE_TX_PORT(prAdapter,
1063                     ucPortIdx,
1064                     (UINT_32)u2OverallBufferLength,
1065                     (PUINT_8)pucOutputBuf,
1066                     u4ValidBufSize);
1067
1068             // send immediately
1069 #endif
1070             prNextMsduInfo = (P_MSDU_INFO_T)
1071                         QUEUE_GET_NEXT_ENTRY(&prMsduInfo->rQueEntry);
1072
1073             if (prMsduInfo->eSrc == TX_PACKET_MGMT) {
1074                 GLUE_DEC_REF_CNT(prTxCtrl->i4TxMgmtPendingNum);
1075
1076                 if (prMsduInfo->pfTxDoneHandler == NULL) {
1077                     cnmMgtPktFree(prAdapter, prMsduInfo);
1078                 }
1079                 else {
1080                     KAL_SPIN_LOCK_DECLARATION();
1081                     DBGLOG(INIT, TRACE,("Wait TxSeqNum:%d\n", prMsduInfo->ucTxSeqNum));
1082                     KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_TXING_MGMT_LIST);
1083                     QUEUE_INSERT_TAIL(&(prTxCtrl->rTxMgmtTxingQueue), (P_QUE_ENTRY_T)prMsduInfo);
1084                     KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_TXING_MGMT_LIST);
1085                 }
1086             }
1087             else {
1088                 /* only free MSDU when it is not a MGMT frame */
1089                 QUEUE_INSERT_TAIL(&rFreeQueue, (P_QUE_ENTRY_T)prMsduInfo);
1090
1091                 if (prMsduInfo->eSrc == TX_PACKET_OS) {
1092                     kalSendComplete(prAdapter->prGlueInfo,
1093                             prNativePacket,
1094                             WLAN_STATUS_SUCCESS);
1095                 }
1096                 else if(prMsduInfo->eSrc == TX_PACKET_FORWARDING) {
1097                     GLUE_DEC_REF_CNT(prTxCtrl->i4PendingFwdFrameCount);
1098                 }
1099             }
1100
1101             prMsduInfo = prNextMsduInfo;
1102         }
1103
1104 #if CFG_SDIO_TX_AGG
1105         ASSERT(u4TotalLength <= u4ValidBufSize);
1106
1107     #if CFG_DBG_GPIO_PINS
1108         {
1109             /* Start port write */
1110             mtk_wcn_stp_debug_gpio_assert(IDX_TX_PORT_WRITE, DBG_TIE_LOW);
1111             kalUdelay(1);
1112             mtk_wcn_stp_debug_gpio_assert(IDX_TX_PORT_WRITE, DBG_TIE_HIGH);
1113         }
1114     #endif
1115
1116         // send coalescing buffer
1117         HAL_WRITE_TX_PORT(prAdapter,
1118                 ucPortIdx,
1119                 u4TotalLength,
1120                 (PUINT_8)pucOutputBuf,
1121                 u4ValidBufSize);
1122 #endif
1123
1124         // return
1125         nicTxReturnMsduInfo(prAdapter, (P_MSDU_INFO_T)QUEUE_GET_HEAD(&rFreeQueue));
1126     }
1127
1128     return WLAN_STATUS_SUCCESS;
1129 }
1130
1131
1132 /*----------------------------------------------------------------------------*/
1133 /*!
1134 * \brief In this function, we'll write Command(CMD_INFO_T) into HIF.
1135 *
1136 * @param prAdapter      Pointer to the Adapter structure.
1137 * @param prPacketInfo   Pointer of CMD_INFO_T
1138 * @param ucTC           Specify the resource of TC
1139 *
1140 * @retval WLAN_STATUS_SUCCESS   Bus access ok.
1141 * @retval WLAN_STATUS_FAILURE   Bus access fail.
1142 */
1143 /*----------------------------------------------------------------------------*/
1144 WLAN_STATUS
1145 nicTxCmd (
1146     IN P_ADAPTER_T      prAdapter,
1147     IN P_CMD_INFO_T     prCmdInfo,
1148     IN UINT_8           ucTC
1149     )
1150 {
1151     P_WIFI_CMD_T prWifiCmd;
1152     UINT_16 u2OverallBufferLength;
1153     PUINT_8 pucOutputBuf = (PUINT_8)NULL; /* Pointer to Transmit Data Structure Frame */
1154     UINT_8 ucPortIdx;
1155     HIF_TX_HEADER_T rHwTxHeader;
1156     P_NATIVE_PACKET prNativePacket;
1157     UINT_8 ucEtherTypeOffsetInWord;
1158     P_MSDU_INFO_T prMsduInfo;
1159     P_TX_CTRL_T prTxCtrl;
1160
1161     KAL_SPIN_LOCK_DECLARATION();
1162
1163
1164     ASSERT(prAdapter);
1165     ASSERT(prCmdInfo);
1166
1167     prTxCtrl = &prAdapter->rTxCtrl;
1168     pucOutputBuf = prTxCtrl->pucTxCoalescingBufPtr;
1169
1170     // <1> Assign Data Port
1171     if (ucTC != TC4_INDEX) {
1172         ucPortIdx = 0;
1173     }
1174     else {
1175         // Broadcast/multicast data frames, 1x frames, command packets, MMPDU
1176         ucPortIdx = 1;
1177     }
1178
1179     if(prCmdInfo->eCmdType == COMMAND_TYPE_SECURITY_FRAME) {
1180         // <2> Compose HIF_TX_HEADER
1181         kalMemZero(&rHwTxHeader, sizeof(rHwTxHeader));
1182
1183         prNativePacket = prCmdInfo->prPacket;
1184
1185         ASSERT(prNativePacket);
1186
1187         u2OverallBufferLength = TFCB_FRAME_PAD_TO_DW((prCmdInfo->u2InfoBufLen + TX_HDR_SIZE)
1188                 & (UINT_16)HIF_TX_HDR_TX_BYTE_COUNT_MASK);
1189
1190         rHwTxHeader.u2TxByteCount_UserPriority = ((prCmdInfo->u2InfoBufLen + TX_HDR_SIZE)
1191                 & (UINT_16)HIF_TX_HDR_TX_BYTE_COUNT_MASK);
1192         ucEtherTypeOffsetInWord = ((ETHER_HEADER_LEN - ETHER_TYPE_LEN) + TX_HDR_SIZE) >> 1;
1193
1194         rHwTxHeader.ucEtherTypeOffset =
1195             ucEtherTypeOffsetInWord & HIF_TX_HDR_ETHER_TYPE_OFFSET_MASK;
1196
1197         rHwTxHeader.ucResource_PktType_CSflags = (ucTC << HIF_TX_HDR_RESOURCE_OFFSET);
1198
1199         rHwTxHeader.ucStaRecIdx = prCmdInfo->ucStaRecIndex;
1200         rHwTxHeader.ucForwardingType_SessionID_Reserved = HIF_TX_HDR_BURST_END_MASK;
1201
1202         rHwTxHeader.ucWlanHeaderLength = (ETH_HLEN & HIF_TX_HDR_WLAN_HEADER_LEN_MASK);
1203         rHwTxHeader.ucPktFormtId_Flags =
1204             (((UINT_8)(prCmdInfo->eNetworkType) << HIF_TX_HDR_NETWORK_TYPE_OFFSET) & HIF_TX_HDR_NETWORK_TYPE_MASK)
1205             | ((1 << HIF_TX_HDR_FLAG_1X_FRAME_OFFSET) & HIF_TX_HDR_FLAG_1X_FRAME_MASK);
1206
1207         rHwTxHeader.u2SeqNo = 0;
1208         rHwTxHeader.ucPacketSeqNo = 0;
1209         rHwTxHeader.ucAck_BIP_BasicRate = 0;
1210
1211         // <2.3> Copy HIF TX HEADER
1212         kalMemCopy((PVOID)&pucOutputBuf[0], (PVOID)&rHwTxHeader, TX_HDR_SIZE);
1213
1214         // <3> Copy Frame Body Copy
1215         kalCopyFrame(prAdapter->prGlueInfo,
1216                 prNativePacket,
1217                 pucOutputBuf + TX_HDR_SIZE);
1218     }
1219     else if(prCmdInfo->eCmdType == COMMAND_TYPE_MANAGEMENT_FRAME) {
1220         prMsduInfo = (P_MSDU_INFO_T)prCmdInfo->prPacket;
1221
1222         ASSERT(prMsduInfo->fgIs802_11 == TRUE);
1223         ASSERT(prMsduInfo->eSrc == TX_PACKET_MGMT);
1224
1225         // <2> Compose HIF_TX_HEADER
1226         kalMemZero(&rHwTxHeader, sizeof(rHwTxHeader));
1227
1228         u2OverallBufferLength = ((prMsduInfo->u2FrameLength + TX_HDR_SIZE) &
1229                                   (UINT_16)HIF_TX_HDR_TX_BYTE_COUNT_MASK);
1230
1231         rHwTxHeader.u2TxByteCount_UserPriority = u2OverallBufferLength;
1232         rHwTxHeader.u2TxByteCount_UserPriority |=
1233                 ((UINT_16)prMsduInfo->ucUserPriority << HIF_TX_HDR_USER_PRIORITY_OFFSET);
1234
1235         ucEtherTypeOffsetInWord =
1236                 (TX_HDR_SIZE + prMsduInfo->ucMacHeaderLength + prMsduInfo->ucLlcLength) >> 1;
1237
1238         rHwTxHeader.ucEtherTypeOffset =
1239                 ucEtherTypeOffsetInWord & HIF_TX_HDR_ETHER_TYPE_OFFSET_MASK;
1240
1241         rHwTxHeader.ucResource_PktType_CSflags = (prMsduInfo->ucTC) << HIF_TX_HDR_RESOURCE_OFFSET;
1242         rHwTxHeader.ucResource_PktType_CSflags |=
1243                 (UINT_8)(((prMsduInfo->ucPacketType) << HIF_TX_HDR_PACKET_TYPE_OFFSET) &
1244                                     (HIF_TX_HDR_PACKET_TYPE_MASK));
1245
1246         rHwTxHeader.u2LLH = prMsduInfo->u2PalLLH;
1247         rHwTxHeader.ucStaRecIdx = prMsduInfo->ucStaRecIndex;
1248         rHwTxHeader.ucForwardingType_SessionID_Reserved =
1249             (prMsduInfo->ucPsForwardingType) | ((prMsduInfo->ucPsSessionID) << HIF_TX_HDR_PS_SESSION_ID_OFFSET)
1250             | ((prMsduInfo->fgIsBurstEnd)? HIF_TX_HDR_BURST_END_MASK : 0);
1251
1252         rHwTxHeader.ucWlanHeaderLength = (prMsduInfo->ucMacHeaderLength & HIF_TX_HDR_WLAN_HEADER_LEN_MASK);
1253         rHwTxHeader.ucPktFormtId_Flags =
1254             (prMsduInfo->ucFormatID & HIF_TX_HDR_FORMAT_ID_MASK)
1255             | ((prMsduInfo->ucNetworkType << HIF_TX_HDR_NETWORK_TYPE_OFFSET) & HIF_TX_HDR_NETWORK_TYPE_MASK)
1256             | ((prMsduInfo->fgIs802_1x << HIF_TX_HDR_FLAG_1X_FRAME_OFFSET) & HIF_TX_HDR_FLAG_1X_FRAME_MASK)
1257             | ((prMsduInfo->fgIs802_11 << HIF_TX_HDR_FLAG_802_11_FORMAT_OFFSET) & HIF_TX_HDR_FLAG_802_11_FORMAT_MASK);
1258
1259         rHwTxHeader.u2SeqNo = prMsduInfo->u2AclSN;
1260
1261         if(prMsduInfo->pfTxDoneHandler) {
1262             rHwTxHeader.ucPacketSeqNo = prMsduInfo->ucTxSeqNum;
1263             rHwTxHeader.ucAck_BIP_BasicRate = HIF_TX_HDR_NEED_ACK;
1264         }
1265         else {
1266             rHwTxHeader.ucPacketSeqNo = 0;
1267             rHwTxHeader.ucAck_BIP_BasicRate = 0;
1268         }
1269
1270         if(prMsduInfo->fgIsBIP) {
1271             rHwTxHeader.ucAck_BIP_BasicRate |= HIF_TX_HDR_BIP;
1272         }
1273
1274         if(prMsduInfo->fgIsBasicRate) {
1275             rHwTxHeader.ucAck_BIP_BasicRate |= HIF_TX_HDR_BASIC_RATE;
1276         }
1277
1278         // <2.3> Copy HIF TX HEADER
1279         kalMemCopy((PVOID)&pucOutputBuf[0], (PVOID)&rHwTxHeader, TX_HDR_SIZE);
1280
1281         // <3> Copy Frame Body
1282         kalMemCopy(pucOutputBuf + TX_HDR_SIZE,
1283                 prMsduInfo->prPacket,
1284                 prMsduInfo->u2FrameLength);
1285
1286         // <4> Management Frame Post-Processing
1287         GLUE_DEC_REF_CNT(prTxCtrl->i4TxMgmtPendingNum);
1288
1289         if (prMsduInfo->pfTxDoneHandler == NULL) {
1290             cnmMgtPktFree(prAdapter, prMsduInfo);
1291         }
1292         else {
1293
1294             DBGLOG(INIT, TRACE,("Wait Cmd TxSeqNum:%d\n", prMsduInfo->ucTxSeqNum));
1295
1296             KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_TXING_MGMT_LIST);
1297             QUEUE_INSERT_TAIL(&(prTxCtrl->rTxMgmtTxingQueue), (P_QUE_ENTRY_T)prMsduInfo);
1298             KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_TXING_MGMT_LIST);
1299         }
1300     }
1301     else {
1302         prWifiCmd = (P_WIFI_CMD_T)prCmdInfo->pucInfoBuffer;
1303
1304         // <2> Compose the Header of Transmit Data Structure for CMD Packet
1305         u2OverallBufferLength = TFCB_FRAME_PAD_TO_DW(
1306                (prCmdInfo->u2InfoBufLen) & (UINT_16)HIF_TX_HDR_TX_BYTE_COUNT_MASK);
1307
1308         prWifiCmd->u2TxByteCount_UserPriority = u2OverallBufferLength;
1309         prWifiCmd->ucEtherTypeOffset = 0;
1310         prWifiCmd->ucResource_PktType_CSflags = (ucTC << HIF_TX_HDR_RESOURCE_OFFSET)
1311             | (UINT_8)((HIF_TX_PKT_TYPE_CMD << HIF_TX_HDR_PACKET_TYPE_OFFSET) & (HIF_TX_HDR_PACKET_TYPE_MASK));
1312
1313
1314         // <3> Copy CMD Header to command buffer (by using pucCoalescingBufCached)
1315         kalMemCopy((PVOID)&pucOutputBuf[0],
1316                    (PVOID)prCmdInfo->pucInfoBuffer,
1317                    prCmdInfo->u2InfoBufLen);
1318
1319         ASSERT(u2OverallBufferLength <= prAdapter->u4CoalescingBufCachedSize);
1320     }
1321
1322     // <4> Write frame to data port
1323     HAL_WRITE_TX_PORT(prAdapter,
1324             ucPortIdx,
1325             (UINT_32)u2OverallBufferLength,
1326             (PUINT_8)pucOutputBuf,
1327             (UINT_32)prAdapter->u4CoalescingBufCachedSize);
1328
1329     return WLAN_STATUS_SUCCESS;
1330 } /* end of nicTxCmd() */
1331
1332
1333 /*----------------------------------------------------------------------------*/
1334 /*!
1335 * @brief This function will clean up all the pending frames in internal SW Queues
1336 *        by return the pending TX packet to the system.
1337 *
1338 * @param prAdapter  Pointer to the Adapter structure.
1339 *
1340 * @return (none)
1341 */
1342 /*----------------------------------------------------------------------------*/
1343 VOID
1344 nicTxRelease (
1345     IN P_ADAPTER_T  prAdapter
1346     )
1347 {
1348     P_TX_CTRL_T prTxCtrl;
1349     P_MSDU_INFO_T prMsduInfo;
1350
1351     KAL_SPIN_LOCK_DECLARATION();
1352
1353     ASSERT(prAdapter);
1354
1355     prTxCtrl = &prAdapter->rTxCtrl;
1356
1357     nicTxFlush(prAdapter);
1358
1359     // free MSDU_INFO_T from rTxMgmtMsduInfoList
1360     do {
1361         KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_TXING_MGMT_LIST);
1362         QUEUE_REMOVE_HEAD(&prTxCtrl->rTxMgmtTxingQueue, prMsduInfo, P_MSDU_INFO_T);
1363         KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_TXING_MGMT_LIST);
1364
1365         if(prMsduInfo) {
1366             // the packet must be mgmt frame with tx done callback
1367             ASSERT(prMsduInfo->eSrc == TX_PACKET_MGMT);
1368             ASSERT(prMsduInfo->pfTxDoneHandler != NULL);
1369
1370             // invoke done handler
1371             prMsduInfo->pfTxDoneHandler(prAdapter, prMsduInfo, TX_RESULT_LIFE_TIMEOUT);
1372
1373             cnmMgtPktFree(prAdapter, prMsduInfo);
1374         }
1375         else {
1376             break;
1377         }
1378     } while(TRUE);
1379
1380     return;
1381 } /* end of nicTxRelease() */
1382
1383
1384 /*----------------------------------------------------------------------------*/
1385 /*!
1386 * @brief Process the TX Done interrupt and pull in more pending frames in SW
1387 *        Queues for transmission.
1388 *
1389 * @param prAdapter  Pointer to the Adapter structure.
1390 *
1391 * @return (none)
1392 */
1393 /*----------------------------------------------------------------------------*/
1394 VOID
1395 nicProcessTxInterrupt(
1396     IN P_ADAPTER_T prAdapter
1397     )
1398 {
1399     P_TX_CTRL_T prTxCtrl;
1400 #if CFG_SDIO_INTR_ENHANCE
1401     P_SDIO_CTRL_T prSDIOCtrl;
1402 #else
1403     UINT_32 au4TxCount[2];
1404 #endif /* CFG_SDIO_INTR_ENHANCE */
1405
1406     ASSERT(prAdapter);
1407
1408     prTxCtrl = &prAdapter->rTxCtrl;
1409     ASSERT(prTxCtrl);
1410
1411      /* Get the TX STATUS */
1412 #if CFG_SDIO_INTR_ENHANCE
1413
1414     prSDIOCtrl = prAdapter->prSDIOCtrl;
1415     #if DBG
1416     //dumpMemory8((PUINT_8)prSDIOCtrl, sizeof(SDIO_CTRL_T));
1417     #endif
1418
1419     nicTxReleaseResource(prAdapter, (PUINT_8)&prSDIOCtrl->rTxInfo);
1420     kalMemZero(&prSDIOCtrl->rTxInfo, sizeof(prSDIOCtrl->rTxInfo));
1421
1422 #else
1423
1424     HAL_MCR_RD(prAdapter, MCR_WTSR0, &au4TxCount[0]);
1425     HAL_MCR_RD(prAdapter, MCR_WTSR1, &au4TxCount[1]);
1426     DBGLOG(EMU, TRACE, ("MCR_WTSR0: 0x%x, MCR_WTSR1: 0x%x\n", au4TxCount[0], au4TxCount[1]));
1427
1428     nicTxReleaseResource(prAdapter, (PUINT_8)au4TxCount);
1429
1430 #endif /* CFG_SDIO_INTR_ENHANCE */
1431
1432     nicTxAdjustTcq(prAdapter);
1433
1434     // Indicate Service Thread
1435     if(kalGetTxPendingCmdCount(prAdapter->prGlueInfo) > 0
1436             || wlanGetTxPendingFrameCount(prAdapter) > 0) {
1437         kalSetEvent(prAdapter->prGlueInfo);
1438     }
1439
1440     return;
1441 } /* end of nicProcessTxInterrupt() */
1442
1443
1444 /*----------------------------------------------------------------------------*/
1445 /*!
1446 * @brief this function frees packet of P_MSDU_INFO_T linked-list
1447 *
1448 * @param prAdapter              Pointer to the Adapter structure.
1449 * @param prMsduInfoList         a link list of P_MSDU_INFO_T
1450 *
1451 * @return (none)
1452 */
1453 /*----------------------------------------------------------------------------*/
1454 VOID
1455 nicTxFreeMsduInfoPacket (
1456     IN P_ADAPTER_T    prAdapter,
1457     IN P_MSDU_INFO_T  prMsduInfoListHead
1458     )
1459 {
1460     P_NATIVE_PACKET prNativePacket;
1461     P_MSDU_INFO_T prMsduInfo = prMsduInfoListHead;
1462     P_TX_CTRL_T prTxCtrl;
1463
1464
1465     ASSERT(prAdapter);
1466     ASSERT(prMsduInfoListHead);
1467
1468     prTxCtrl = &prAdapter->rTxCtrl;
1469
1470     while(prMsduInfo) {
1471         prNativePacket = prMsduInfo->prPacket;
1472
1473         if(prMsduInfo->eSrc == TX_PACKET_OS) {
1474             kalSendComplete(prAdapter->prGlueInfo,
1475                     prNativePacket,
1476                     WLAN_STATUS_FAILURE);
1477         }
1478         else if(prMsduInfo->eSrc == TX_PACKET_MGMT) {
1479             if (prMsduInfo->pfTxDoneHandler) {
1480                 prMsduInfo->pfTxDoneHandler(prAdapter, prMsduInfo, TX_RESULT_DROPPED_IN_DRIVER);
1481             }
1482             cnmMemFree(prAdapter, prNativePacket);
1483         }
1484         else if(prMsduInfo->eSrc == TX_PACKET_FORWARDING) {
1485             GLUE_DEC_REF_CNT(prTxCtrl->i4PendingFwdFrameCount);
1486         }
1487
1488         prMsduInfo = (P_MSDU_INFO_T)QUEUE_GET_NEXT_ENTRY((P_QUE_ENTRY_T)prMsduInfo);
1489     }
1490
1491     return;
1492 }
1493
1494
1495 /*----------------------------------------------------------------------------*/
1496 /*!
1497 * @brief this function returns P_MSDU_INFO_T of MsduInfoList to TxCtrl->rfreeMsduInfoList
1498 *
1499 * @param prAdapter              Pointer to the Adapter structure.
1500 * @param prMsduInfoList         a link list of P_MSDU_INFO_T
1501 *
1502 * @return (none)
1503 */
1504 /*----------------------------------------------------------------------------*/
1505 VOID
1506 nicTxReturnMsduInfo (
1507     IN P_ADAPTER_T    prAdapter,
1508     IN P_MSDU_INFO_T  prMsduInfoListHead
1509     )
1510 {
1511     P_TX_CTRL_T prTxCtrl;
1512     P_MSDU_INFO_T prMsduInfo = prMsduInfoListHead, prNextMsduInfo;
1513
1514     KAL_SPIN_LOCK_DECLARATION();
1515
1516     ASSERT(prAdapter);
1517
1518     prTxCtrl = &prAdapter->rTxCtrl;
1519     ASSERT(prTxCtrl);
1520
1521     while(prMsduInfo) {
1522         prNextMsduInfo = (P_MSDU_INFO_T)QUEUE_GET_NEXT_ENTRY((P_QUE_ENTRY_T)prMsduInfo);
1523
1524         switch(prMsduInfo->eSrc) {
1525         case TX_PACKET_FORWARDING:
1526             wlanReturnPacket(prAdapter, prMsduInfo->prPacket);
1527             break;
1528         case TX_PACKET_OS:
1529         case TX_PACKET_OS_OID:
1530         case TX_PACKET_MGMT:
1531         default:
1532             break;
1533         }
1534
1535         KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_MSDU_INFO_LIST);
1536         QUEUE_INSERT_TAIL(&prTxCtrl->rFreeMsduInfoList, (P_QUE_ENTRY_T)prMsduInfo);
1537         KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_MSDU_INFO_LIST);
1538         prMsduInfo = prNextMsduInfo;
1539     };
1540
1541     return;
1542 }
1543
1544
1545
1546 /*----------------------------------------------------------------------------*/
1547 /*!
1548 * @brief this function fills packet information to P_MSDU_INFO_T
1549 *
1550 * @param prAdapter              Pointer to the Adapter structure.
1551 * @param prMsduInfo             P_MSDU_INFO_T
1552 * @param prPacket               P_NATIVE_PACKET
1553 *
1554 * @retval TRUE      Success to extract information
1555 * @retval FALSE     Fail to extract correct information
1556 */
1557 /*----------------------------------------------------------------------------*/
1558 BOOLEAN
1559 nicTxFillMsduInfo (
1560     IN P_ADAPTER_T     prAdapter,
1561     IN P_MSDU_INFO_T   prMsduInfo,
1562     IN P_NATIVE_PACKET prPacket
1563     )
1564 {
1565     P_GLUE_INFO_T   prGlueInfo;
1566     UINT_8          ucPriorityParam;
1567     UINT_8          ucMacHeaderLen;
1568     UINT_8          aucEthDestAddr[PARAM_MAC_ADDR_LEN];
1569     BOOLEAN         fgIs1x = FALSE;
1570     BOOLEAN         fgIsPAL = FALSE;
1571     UINT_32         u4PacketLen;
1572     ULONG           u4SysTime;
1573     UINT_8          ucNetworkType;
1574
1575
1576     ASSERT(prAdapter);
1577
1578     prGlueInfo = prAdapter->prGlueInfo;
1579     ASSERT(prGlueInfo);
1580
1581     if (kalQoSFrameClassifierAndPacketInfo(prGlueInfo,
1582                 prPacket,
1583                 &ucPriorityParam,
1584                 &u4PacketLen,
1585                 aucEthDestAddr,
1586                 &fgIs1x,
1587                 &fgIsPAL,
1588                 &ucNetworkType) == FALSE) {
1589         return FALSE;
1590     }
1591
1592     /* Save the value of Priority Parameter */
1593     GLUE_SET_PKT_TID(prPacket, ucPriorityParam);
1594
1595     if (fgIs1x) {
1596         GLUE_SET_PKT_FLAG_1X(prPacket);
1597     }
1598
1599     if (fgIsPAL) {
1600         GLUE_SET_PKT_FLAG_PAL(prPacket);
1601     }
1602
1603     ucMacHeaderLen = ETH_HLEN;
1604
1605     /* Save the value of Header Length */
1606     GLUE_SET_PKT_HEADER_LEN(prPacket, ucMacHeaderLen);
1607
1608     /* Save the value of Frame Length */
1609     GLUE_SET_PKT_FRAME_LEN(prPacket, (UINT_16)u4PacketLen);
1610
1611     /* Save the value of Arrival Time*/
1612     u4SysTime = (OS_SYSTIME)kalGetTimeTick();
1613     GLUE_SET_PKT_ARRIVAL_TIME(prPacket, u4SysTime);
1614
1615     prMsduInfo->prPacket = prPacket;
1616     prMsduInfo->fgIs802_1x = fgIs1x;
1617     prMsduInfo->fgIs802_11 = FALSE;
1618     prMsduInfo->ucNetworkType = ucNetworkType;
1619     prMsduInfo->ucUserPriority = ucPriorityParam;
1620     prMsduInfo->ucMacHeaderLength = ucMacHeaderLen;
1621     prMsduInfo->u2FrameLength = (UINT_16)u4PacketLen;
1622     COPY_MAC_ADDR(prMsduInfo->aucEthDestAddr, aucEthDestAddr);
1623
1624     return TRUE;
1625 }
1626
1627
1628 /*----------------------------------------------------------------------------*/
1629 /*!
1630 * @brief this function update TCQ values by passing current status to txAdjustTcQuotas
1631 *
1632 * @param prAdapter              Pointer to the Adapter structure.
1633 *
1634 * @retval WLAN_STATUS_SUCCESS   Updated successfully
1635 */
1636 /*----------------------------------------------------------------------------*/
1637 WLAN_STATUS
1638 nicTxAdjustTcq (
1639     IN P_ADAPTER_T  prAdapter
1640     )
1641 {
1642     UINT_32 u4Num;
1643     TX_TCQ_ADJUST_T rTcqAdjust;
1644     P_TX_CTRL_T prTxCtrl;
1645     KAL_SPIN_LOCK_DECLARATION();
1646
1647     ASSERT(prAdapter);
1648
1649     prTxCtrl = &prAdapter->rTxCtrl;
1650     ASSERT(prTxCtrl);
1651
1652     qmAdjustTcQuotas(prAdapter, &rTcqAdjust, &prTxCtrl->rTc);
1653     KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_RESOURCE);
1654
1655     for (u4Num = 0 ; u4Num < TC_NUM ; u4Num++) {
1656         prTxCtrl->rTc.aucFreeBufferCount[u4Num] += rTcqAdjust.acVariation[u4Num];
1657         prTxCtrl->rTc.aucMaxNumOfBuffer[u4Num] += rTcqAdjust.acVariation[u4Num];
1658
1659         ASSERT(prTxCtrl->rTc.aucFreeBufferCount[u4Num] >= 0);
1660         ASSERT(prTxCtrl->rTc.aucMaxNumOfBuffer[u4Num] >= 0);
1661     }
1662
1663     KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_TX_RESOURCE);
1664
1665     return WLAN_STATUS_SUCCESS;
1666 }
1667
1668
1669 /*----------------------------------------------------------------------------*/
1670 /*!
1671 * @brief this function flushes all packets queued in STA/AC queue
1672 *
1673 * @param prAdapter              Pointer to the Adapter structure.
1674 *
1675 * @retval WLAN_STATUS_SUCCESS   Flushed successfully
1676 */
1677 /*----------------------------------------------------------------------------*/
1678
1679 WLAN_STATUS
1680 nicTxFlush (
1681     IN P_ADAPTER_T  prAdapter
1682     )
1683 {
1684     P_MSDU_INFO_T prMsduInfo;
1685     KAL_SPIN_LOCK_DECLARATION();
1686
1687     ASSERT(prAdapter);
1688
1689     // ask Per STA/AC queue to be fllushed and return all queued packets
1690     KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_QM_TX_QUEUE);
1691     prMsduInfo = qmFlushTxQueues(prAdapter);
1692     KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_QM_TX_QUEUE);
1693
1694     if(prMsduInfo != NULL) {
1695         nicTxFreeMsduInfoPacket(prAdapter, prMsduInfo);
1696         nicTxReturnMsduInfo(prAdapter, prMsduInfo);
1697     }
1698
1699     return WLAN_STATUS_SUCCESS;
1700 }
1701
1702
1703 #if CFG_ENABLE_FW_DOWNLOAD
1704 /*----------------------------------------------------------------------------*/
1705 /*!
1706 * \brief In this function, we'll write Command(CMD_INFO_T) into HIF.
1707 *        However this function is used for INIT_CMD.
1708 *
1709 *        In order to avoid further maintainance issues, these 2 functions are separated
1710 *
1711 * @param prAdapter      Pointer to the Adapter structure.
1712 * @param prPacketInfo   Pointer of CMD_INFO_T
1713 * @param ucTC           Specify the resource of TC
1714 *
1715 * @retval WLAN_STATUS_SUCCESS   Bus access ok.
1716 * @retval WLAN_STATUS_FAILURE   Bus access fail.
1717 */
1718 /*----------------------------------------------------------------------------*/
1719 WLAN_STATUS
1720 nicTxInitCmd (
1721     IN P_ADAPTER_T      prAdapter,
1722     IN P_CMD_INFO_T     prCmdInfo,
1723     IN UINT_8           ucTC
1724     )
1725 {
1726     P_INIT_HIF_TX_HEADER_T prInitTxHeader;
1727     UINT_16 u2OverallBufferLength;
1728     PUINT_8 pucOutputBuf = (PUINT_8)NULL; /* Pointer to Transmit Data Structure Frame */
1729     UINT_32 ucPortIdx;
1730     P_TX_CTRL_T prTxCtrl;
1731
1732     ASSERT(prAdapter);
1733     ASSERT(prCmdInfo);
1734     ASSERT(ucTC == TC0_INDEX);
1735
1736     prTxCtrl = &prAdapter->rTxCtrl;
1737     pucOutputBuf = prTxCtrl->pucTxCoalescingBufPtr;
1738     prInitTxHeader = (P_INIT_HIF_TX_HEADER_T)prCmdInfo->pucInfoBuffer;
1739
1740     // <1> Compose the Header of Transmit Data Structure for CMD Packet
1741     u2OverallBufferLength = TFCB_FRAME_PAD_TO_DW(
1742             (prCmdInfo->u2InfoBufLen) & (UINT_16)HIF_TX_HDR_TX_BYTE_COUNT_MASK);
1743
1744     prInitTxHeader->u2TxByteCount = u2OverallBufferLength;
1745     prInitTxHeader->ucEtherTypeOffset = 0;
1746     prInitTxHeader->ucCSflags = 0;
1747
1748     // <2> Assign Data Port
1749     if (ucTC != TC4_INDEX) {
1750         ucPortIdx = 0;
1751     }
1752     else { // Broadcast/multicast data packets
1753         ucPortIdx = 1;
1754     }
1755
1756     // <3> Copy CMD Header to command buffer (by using pucCoalescingBufCached)
1757     kalMemCopy((PVOID)&pucOutputBuf[0],
1758                (PVOID)prCmdInfo->pucInfoBuffer,
1759                prCmdInfo->u2InfoBufLen);
1760
1761     ASSERT(u2OverallBufferLength <= prAdapter->u4CoalescingBufCachedSize);
1762
1763     // <4> Write frame to data port
1764     HAL_WRITE_TX_PORT(prAdapter,
1765             ucPortIdx,
1766             (UINT_32)u2OverallBufferLength,
1767             (PUINT_8)pucOutputBuf,
1768             (UINT_32)prAdapter->u4CoalescingBufCachedSize);
1769
1770     return WLAN_STATUS_SUCCESS;
1771 }
1772
1773
1774 /*----------------------------------------------------------------------------*/
1775 /*!
1776 * \brief In this function, we'll reset TX resource counter to initial value used
1777 *        in F/W download state
1778 *
1779 * @param prAdapter      Pointer to the Adapter structure.
1780 *
1781 * @retval WLAN_STATUS_SUCCESS   Reset is done successfully.
1782 */
1783 /*----------------------------------------------------------------------------*/
1784 WLAN_STATUS
1785 nicTxInitResetResource (
1786     IN P_ADAPTER_T  prAdapter
1787     )
1788 {
1789     P_TX_CTRL_T prTxCtrl;
1790
1791     DEBUGFUNC("nicTxInitResetResource");
1792
1793     ASSERT(prAdapter);
1794     prTxCtrl = &prAdapter->rTxCtrl;
1795
1796     prTxCtrl->rTc.aucMaxNumOfBuffer[TC0_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC0;
1797     prTxCtrl->rTc.aucFreeBufferCount[TC0_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC0;
1798
1799     prTxCtrl->rTc.aucMaxNumOfBuffer[TC1_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC1;
1800     prTxCtrl->rTc.aucFreeBufferCount[TC1_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC1;
1801
1802     prTxCtrl->rTc.aucMaxNumOfBuffer[TC2_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC2;
1803     prTxCtrl->rTc.aucFreeBufferCount[TC2_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC2;
1804
1805     prTxCtrl->rTc.aucMaxNumOfBuffer[TC3_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC3;
1806     prTxCtrl->rTc.aucFreeBufferCount[TC3_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC3;
1807
1808     prTxCtrl->rTc.aucMaxNumOfBuffer[TC4_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC4;
1809     prTxCtrl->rTc.aucFreeBufferCount[TC4_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC4;
1810
1811     prTxCtrl->rTc.aucMaxNumOfBuffer[TC5_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC5;
1812     prTxCtrl->rTc.aucFreeBufferCount[TC5_INDEX] = NIC_TX_INIT_BUFF_COUNT_TC5;
1813
1814     return WLAN_STATUS_SUCCESS;
1815
1816 }
1817
1818 #endif
1819
1820
1821 /*----------------------------------------------------------------------------*/
1822 /*!
1823 * \brief this function enqueues MSDU_INFO_T into queue management,
1824 *        or command queue
1825 *
1826 * @param prAdapter      Pointer to the Adapter structure.
1827 *        prMsduInfo     Pointer to MSDU
1828 *
1829 * @retval WLAN_STATUS_SUCCESS   Reset is done successfully.
1830 */
1831 /*----------------------------------------------------------------------------*/
1832 WLAN_STATUS
1833 nicTxEnqueueMsdu (
1834     IN P_ADAPTER_T      prAdapter,
1835     IN P_MSDU_INFO_T    prMsduInfo
1836     )
1837 {
1838     P_TX_CTRL_T prTxCtrl;
1839     P_MSDU_INFO_T prNextMsduInfo, prRetMsduInfo, prMsduInfoHead;
1840     QUE_T qDataPort0, qDataPort1;
1841     P_CMD_INFO_T prCmdInfo;
1842     WLAN_STATUS u4Status = WLAN_STATUS_SUCCESS;
1843     KAL_SPIN_LOCK_DECLARATION();
1844
1845     ASSERT(prAdapter);
1846     ASSERT(prMsduInfo);
1847
1848     prTxCtrl = &prAdapter->rTxCtrl;
1849     ASSERT(prTxCtrl);
1850
1851     QUEUE_INITIALIZE(&qDataPort0);
1852     QUEUE_INITIALIZE(&qDataPort1);
1853
1854     /* check how many management frame are being queued */
1855     while(prMsduInfo) {
1856         prNextMsduInfo = (P_MSDU_INFO_T)QUEUE_GET_NEXT_ENTRY((P_QUE_ENTRY_T)prMsduInfo);
1857
1858         QUEUE_GET_NEXT_ENTRY((P_QUE_ENTRY_T)prMsduInfo) = NULL;
1859
1860         if(prMsduInfo->eSrc == TX_PACKET_MGMT) {
1861             // MMPDU: force stick to TC4
1862             prMsduInfo->ucTC = TC4_INDEX;
1863
1864             QUEUE_INSERT_TAIL(&qDataPort1, (P_QUE_ENTRY_T)prMsduInfo);
1865         }
1866         else {
1867             QUEUE_INSERT_TAIL(&qDataPort0, (P_QUE_ENTRY_T)prMsduInfo);
1868         }
1869
1870         prMsduInfo = prNextMsduInfo;
1871     }
1872
1873     if(qDataPort0.u4NumElem) {
1874         /* send to QM */
1875         KAL_SPIN_LOCK_DECLARATION();
1876         KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_QM_TX_QUEUE);
1877         prRetMsduInfo = qmEnqueueTxPackets(prAdapter, (P_MSDU_INFO_T)QUEUE_GET_HEAD(&qDataPort0));
1878         KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_QM_TX_QUEUE);
1879
1880         /* post-process for dropped packets */
1881         if(prRetMsduInfo != NULL) { // unable to enqueue
1882             nicTxFreeMsduInfoPacket(prAdapter, prRetMsduInfo);
1883             nicTxReturnMsduInfo(prAdapter, prRetMsduInfo);
1884         }
1885     }
1886
1887     if(qDataPort1.u4NumElem) {
1888         prMsduInfoHead = (P_MSDU_INFO_T)QUEUE_GET_HEAD(&qDataPort1);
1889
1890         if(qDataPort1.u4NumElem > nicTxGetFreeCmdCount(prAdapter)) {
1891             // not enough descriptors for sending
1892             u4Status = WLAN_STATUS_FAILURE;
1893
1894             // free all MSDUs
1895             while(prMsduInfoHead) {
1896                 prNextMsduInfo = (P_MSDU_INFO_T) QUEUE_GET_NEXT_ENTRY(&prMsduInfoHead->rQueEntry);
1897
1898                 if (prMsduInfoHead->pfTxDoneHandler != NULL) {
1899                     prMsduInfoHead->pfTxDoneHandler(prAdapter, prMsduInfoHead, TX_RESULT_DROPPED_IN_DRIVER);
1900                 }
1901
1902
1903                 cnmMgtPktFree(prAdapter, prMsduInfoHead);
1904
1905                 prMsduInfoHead = prNextMsduInfo;
1906             }
1907         }
1908         else {
1909             /* send to command queue */
1910             while(prMsduInfoHead) {
1911                 prNextMsduInfo = (P_MSDU_INFO_T) QUEUE_GET_NEXT_ENTRY(&prMsduInfoHead->rQueEntry);
1912
1913                 KAL_ACQUIRE_SPIN_LOCK(prAdapter, SPIN_LOCK_CMD_RESOURCE);
1914                 QUEUE_REMOVE_HEAD(&prAdapter->rFreeCmdList, prCmdInfo, P_CMD_INFO_T);
1915                 KAL_RELEASE_SPIN_LOCK(prAdapter, SPIN_LOCK_CMD_RESOURCE);
1916
1917                 if (prCmdInfo) {
1918                     GLUE_INC_REF_CNT(prTxCtrl->i4TxMgmtPendingNum);
1919
1920                     kalMemZero(prCmdInfo, sizeof(CMD_INFO_T));
1921
1922                     prCmdInfo->eCmdType             = COMMAND_TYPE_MANAGEMENT_FRAME;
1923                     prCmdInfo->u2InfoBufLen         = prMsduInfoHead->u2FrameLength;
1924                     prCmdInfo->pucInfoBuffer        = NULL;
1925                     prCmdInfo->prPacket             = (P_NATIVE_PACKET)prMsduInfoHead;
1926                     prCmdInfo->ucStaRecIndex        = prMsduInfoHead->ucStaRecIndex;
1927                     prCmdInfo->eNetworkType         = prMsduInfoHead->ucNetworkType;
1928                     prCmdInfo->pfCmdDoneHandler     = NULL;
1929                     prCmdInfo->pfCmdTimeoutHandler  = NULL;
1930                     prCmdInfo->fgIsOid              = FALSE;
1931                     prCmdInfo->fgSetQuery           = TRUE;
1932                     prCmdInfo->fgNeedResp           = FALSE;
1933
1934                     kalEnqueueCommand(prAdapter->prGlueInfo, (P_QUE_ENTRY_T)prCmdInfo);
1935                 }
1936                 else {
1937                     /* Cmd free count is larger than expected, but allocation fail. */
1938                     ASSERT(0);
1939
1940                     u4Status = WLAN_STATUS_FAILURE;
1941                     cnmMgtPktFree(prAdapter, prMsduInfoHead);
1942                 }
1943
1944                 prMsduInfoHead = prNextMsduInfo;
1945             }
1946         }
1947     }
1948
1949     /* indicate service thread for sending */
1950     if(prTxCtrl->i4TxMgmtPendingNum > 0
1951             || kalGetTxPendingFrameCount(prAdapter->prGlueInfo) > 0) {
1952         kalSetEvent(prAdapter->prGlueInfo);
1953     }
1954
1955     return u4Status;
1956 }
1957
1958
1959 /*----------------------------------------------------------------------------*/
1960 /*!
1961 * \brief this function returns available count in command queue
1962 *
1963 * @param prAdapter      Pointer to the Adapter structure.
1964 *
1965 * @retval
1966 */
1967 /*----------------------------------------------------------------------------*/
1968 UINT_32
1969 nicTxGetFreeCmdCount (
1970     IN P_ADAPTER_T  prAdapter
1971     )
1972 {
1973     ASSERT(prAdapter);
1974
1975     return prAdapter->rFreeCmdList.u4NumElem;
1976 }
1977