2 * (c) Copyright 2008, RealTEK Technologies Inc. All Rights Reserved.
4 * Module: r819xusb_cmdpkt.c
5 * (RTL8190 TX/RX command packet handler Source C File)
7 * Note: The module is responsible for handling TX and RX command packet.
8 * 1.TX: Send set and query configuration command packet.
9 * 2.RX: Receive tx feedback, beacon state, query configuration, command packet.
12 #include "r819xU_cmdpkt.h"
14 bool SendTxCommandPacket(struct net_device
*dev
, void *pData
, u32 DataLen
)
17 struct r8192_priv
*priv
= ieee80211_priv(dev
);
20 unsigned char *ptr_buf
;
22 /* PlatformAcquireSpinLock(Adapter, RT_TX_SPINLOCK); */
25 * Get TCB and local buffer from common pool.
26 * (It is shared by CmdQ, MgntQ, and USB coalesce DataQ)
28 skb
= dev_alloc_skb(USB_HWDESC_HEADER_LEN
+ DataLen
+ 4);
29 memcpy((unsigned char *)(skb
->cb
), &dev
, sizeof(dev
));
30 tcb_desc
= (cb_desc
*)(skb
->cb
+ MAX_DEV_ADDR_SIZE
);
31 tcb_desc
->queue_index
= TXCMD_QUEUE
;
32 tcb_desc
->bCmdOrInit
= DESC_PACKET_TYPE_NORMAL
;
33 tcb_desc
->bLastIniPkt
= 0;
34 skb_reserve(skb
, USB_HWDESC_HEADER_LEN
);
35 ptr_buf
= skb_put(skb
, DataLen
);
36 memcpy(ptr_buf
, pData
, DataLen
);
37 tcb_desc
->txbuf_size
= (u16
)DataLen
;
39 if (!priv
->ieee80211
->check_nic_enough_desc(dev
, tcb_desc
->queue_index
) ||
40 (!skb_queue_empty(&priv
->ieee80211
->skb_waitQ
[tcb_desc
->queue_index
])) ||
41 (priv
->ieee80211
->queue_stop
)) {
42 RT_TRACE(COMP_FIRMWARE
, "NULL packet => tx full\n");
43 skb_queue_tail(&priv
->ieee80211
->skb_waitQ
[tcb_desc
->queue_index
], skb
);
45 priv
->ieee80211
->softmac_hard_start_xmit(skb
, dev
);
48 //PlatformReleaseSpinLock(Adapter, RT_TX_SPINLOCK);
53 * Function: cmpk_message_handle_tx()
55 * Overview: Driver internal module can call the API to send message to
56 * firmware side. For example, you can send a debug command packet.
57 * Or you can send a request for FW to modify RLX4181 LBUS HW bank.
58 * Otherwise, you can change MAC/PHT/RF register by firmware at
59 * run time. We do not support message more than one segment now.
67 extern bool cmpk_message_handle_tx(
68 struct net_device
*dev
,
69 u8
*codevirtualaddress
,
73 bool rt_status
= true;
78 * Function: cmpk_counttxstatistic()
81 cmpk_count_txstatistic(struct net_device
*dev
, cmpk_txfb_t
*pstx_fb
)
83 struct r8192_priv
*priv
= ieee80211_priv(dev
);
85 RT_RF_POWER_STATE rtState
;
87 pAdapter
->HalFunc
.GetHwRegHandler(pAdapter
,
92 * When RF is off, we should not count the packet for hw/sw synchronize
93 * reason, ie. there may be a duration while sw switch is changed and hw
94 * switch is being changed.
96 if (rtState
== eRfOff
)
101 if (pAdapter
->bInHctTest
)
105 * We can not know the packet length and transmit type:
106 * broadcast or uni or multicast.
107 * So the relative statistics must be collected in tx feedback info
110 priv
->stats
.txfeedbackok
++;
111 priv
->stats
.txoktotal
++;
112 priv
->stats
.txokbytestotal
+= pstx_fb
->pkt_length
;
113 priv
->stats
.txokinperiod
++;
114 /* We can not make sure broadcast/multicast or unicast mode. */
115 if (pstx_fb
->pkt_type
== PACKET_MULTICAST
) {
116 priv
->stats
.txmulticast
++;
117 priv
->stats
.txbytesmulticast
+= pstx_fb
->pkt_length
;
118 } else if (pstx_fb
->pkt_type
== PACKET_BROADCAST
) {
119 priv
->stats
.txbroadcast
++;
120 priv
->stats
.txbytesbroadcast
+= pstx_fb
->pkt_length
;
122 priv
->stats
.txunicast
++;
123 priv
->stats
.txbytesunicast
+= pstx_fb
->pkt_length
;
126 priv
->stats
.txfeedbackfail
++;
127 priv
->stats
.txerrtotal
++;
128 priv
->stats
.txerrbytestotal
+= pstx_fb
->pkt_length
;
129 /* We can not make sure broadcast/multicast or unicast mode. */
130 if (pstx_fb
->pkt_type
== PACKET_MULTICAST
)
131 priv
->stats
.txerrmulticast
++;
132 else if (pstx_fb
->pkt_type
== PACKET_BROADCAST
)
133 priv
->stats
.txerrbroadcast
++;
135 priv
->stats
.txerrunicast
++;
137 priv
->stats
.txretrycount
+= pstx_fb
->retry_cnt
;
138 priv
->stats
.txfeedbackretry
+= pstx_fb
->retry_cnt
;
142 * Function: cmpk_handle_tx_feedback()
144 * Overview: The function is responsible for extract the message inside TX
145 * feedbck message from firmware. It will contain dedicated info in
146 * ws-06-0063-rtl8190-command-packet-specification. Please
147 * refer to chapter "TX Feedback Element". We have to read 20 bytes
148 * in the command packet.
150 * Input: struct net_device * dev
151 * u8 *pmsg - Msg Ptr of the command packet.
157 static void cmpk_handle_tx_feedback(struct net_device
*dev
, u8
*pmsg
)
159 struct r8192_priv
*priv
= ieee80211_priv(dev
);
160 cmpk_txfb_t rx_tx_fb
;
162 priv
->stats
.txfeedback
++;
164 /* 1. Extract TX feedback info from RFD to temp structure buffer. */
165 memcpy((u8
*)&rx_tx_fb
, pmsg
, sizeof(cmpk_txfb_t
));
167 /* 2. Use tx feedback info to count TX statistics. */
168 cmpk_count_txstatistic(dev
, &rx_tx_fb
);
171 void cmdpkt_beacontimerinterrupt_819xusb(struct net_device
*dev
)
173 struct r8192_priv
*priv
= ieee80211_priv(dev
);
176 if (priv
->ieee80211
->current_network
.mode
== IEEE_A
||
177 priv
->ieee80211
->current_network
.mode
== IEEE_N_5G
||
178 (priv
->ieee80211
->current_network
.mode
== IEEE_N_24G
&&
179 (!priv
->ieee80211
->pHTInfo
->bCurSuppCCK
))) {
181 DMESG("send beacon frame tx rate is 6Mbpm\n");
184 DMESG("send beacon frame tx rate is 1Mbpm\n");
186 rtl819xusb_beacon_tx(dev
, tx_rate
); /* HW Beacon */
190 * Function: cmpk_handle_interrupt_status()
192 * Overview: The function is responsible for extract the message from
193 * firmware. It will contain dedicated info in
194 * ws-07-0063-v06-rtl819x-command-packet-specification-070315.doc.
195 * Please refer to chapter "Interrupt Status Element".
197 * Input: struct net_device *dev,
198 * u8* pmsg - Message Pointer of the command packet.
204 static void cmpk_handle_interrupt_status(struct net_device
*dev
, u8
*pmsg
)
206 cmpk_intr_sta_t rx_intr_status
; /* */
207 struct r8192_priv
*priv
= ieee80211_priv(dev
);
209 DMESG("---> cmpk_Handle_Interrupt_Status()\n");
211 /* 1. Extract TX feedback info from RFD to temp structure buffer. */
212 rx_intr_status
.length
= pmsg
[1];
213 if (rx_intr_status
.length
!= (sizeof(cmpk_intr_sta_t
) - 2)) {
214 DMESG("cmpk_Handle_Interrupt_Status: wrong length!\n");
217 /* Statistics of beacon for ad-hoc mode. */
218 if (priv
->ieee80211
->iw_mode
== IW_MODE_ADHOC
) {
219 //2 maybe need endian transform?
220 rx_intr_status
.interrupt_status
= *((u32
*)(pmsg
+ 4));
221 //rx_intr_status.InterruptStatus = N2H4BYTE(*((UINT32 *)(pMsg + 4)));
223 DMESG("interrupt status = 0x%x\n", rx_intr_status
.interrupt_status
);
225 if (rx_intr_status
.interrupt_status
& ISR_TxBcnOk
) {
226 priv
->ieee80211
->bibsscoordinator
= true;
227 priv
->stats
.txbeaconokint
++;
228 } else if (rx_intr_status
.interrupt_status
& ISR_TxBcnErr
) {
229 priv
->ieee80211
->bibsscoordinator
= false;
230 priv
->stats
.txbeaconerr
++;
233 if (rx_intr_status
.interrupt_status
& ISR_BcnTimerIntr
)
234 cmdpkt_beacontimerinterrupt_819xusb(dev
);
236 /* Other informations in interrupt status we need? */
237 DMESG("<---- cmpk_handle_interrupt_status()\n");
241 * Function: cmpk_handle_query_config_rx()
243 * Overview: The function is responsible for extract the message from
244 * firmware. It will contain dedicated info in
245 * ws-06-0063-rtl8190-command-packet-specification
246 * Please refer to chapter "Beacon State Element".
248 * Input: u8 * pmsg - Message Pointer of the command packet.
255 static void cmpk_handle_query_config_rx(struct net_device
*dev
, u8
*pmsg
)
257 cmpk_query_cfg_t rx_query_cfg
;
259 * Extract TX feedback info from RFD to temp structure buffer.
261 rx_query_cfg
.cfg_action
= (pmsg
[4] & 0x80000000) >> 31;
262 rx_query_cfg
.cfg_type
= (pmsg
[4] & 0x60) >> 5;
263 rx_query_cfg
.cfg_size
= (pmsg
[4] & 0x18) >> 3;
264 rx_query_cfg
.cfg_page
= (pmsg
[6] & 0x0F) >> 0;
265 rx_query_cfg
.cfg_offset
= pmsg
[7];
266 rx_query_cfg
.value
= (pmsg
[8] << 24) | (pmsg
[9] << 16) |
267 (pmsg
[10] << 8) | (pmsg
[11] << 0);
268 rx_query_cfg
.mask
= (pmsg
[12] << 24) | (pmsg
[13] << 16) |
269 (pmsg
[14] << 8) | (pmsg
[15] << 0);
273 * Function: cmpk_count_tx_status()
275 * Overview: Count aggregated tx status from firmware of one type rx command
276 * packet element id = RX_TX_STATUS.
284 static void cmpk_count_tx_status(struct net_device
*dev
,
285 cmpk_tx_status_t
*pstx_status
)
287 struct r8192_priv
*priv
= ieee80211_priv(dev
);
291 RT_RF_POWER_STATE rtstate
;
293 pAdapter
->HalFunc
.GetHwRegHandler(pAdapter
, HW_VAR_RF_STATE
, (pu1Byte
)(&rtState
));
296 * When RF is off, we should not count the packet for hw/sw synchronize
297 * reason, ie. there may be a duration while sw switch is changed and hw
298 * switch is being changed.
300 if (rtState
== eRfOff
)
304 priv
->stats
.txfeedbackok
+= pstx_status
->txok
;
305 priv
->stats
.txoktotal
+= pstx_status
->txok
;
307 priv
->stats
.txfeedbackfail
+= pstx_status
->txfail
;
308 priv
->stats
.txerrtotal
+= pstx_status
->txfail
;
310 priv
->stats
.txretrycount
+= pstx_status
->txretry
;
311 priv
->stats
.txfeedbackretry
+= pstx_status
->txretry
;
313 priv
->stats
.txmulticast
+= pstx_status
->txmcok
;
314 priv
->stats
.txbroadcast
+= pstx_status
->txbcok
;
315 priv
->stats
.txunicast
+= pstx_status
->txucok
;
317 priv
->stats
.txerrmulticast
+= pstx_status
->txmcfail
;
318 priv
->stats
.txerrbroadcast
+= pstx_status
->txbcfail
;
319 priv
->stats
.txerrunicast
+= pstx_status
->txucfail
;
321 priv
->stats
.txbytesmulticast
+= pstx_status
->txmclength
;
322 priv
->stats
.txbytesbroadcast
+= pstx_status
->txbclength
;
323 priv
->stats
.txbytesunicast
+= pstx_status
->txuclength
;
325 priv
->stats
.last_packet_rate
= pstx_status
->rate
;
329 * Function: cmpk_handle_tx_status()
331 * Overview: Firmware add a new tx feedback status to reduce rx command
332 * packet buffer operation load.
341 cmpk_handle_tx_status(struct net_device
*dev
, u8
*pmsg
)
343 cmpk_tx_status_t rx_tx_sts
;
345 memcpy((void *)&rx_tx_sts
, (void *)pmsg
, sizeof(cmpk_tx_status_t
));
346 /* 2. Use tx feedback info to count TX statistics. */
347 cmpk_count_tx_status(dev
, &rx_tx_sts
);
351 * Function: cmpk_handle_tx_rate_history()
353 * Overview: Firmware add a new tx rate history
361 static void cmpk_handle_tx_rate_history(struct net_device
*dev
, u8
*pmsg
)
363 cmpk_tx_rahis_t
*ptxrate
;
365 u16 length
= sizeof(cmpk_tx_rahis_t
);
367 struct r8192_priv
*priv
= ieee80211_priv(dev
);
370 pAdapter
->HalFunc
.GetHwRegHandler(pAdapter
,
372 (pu1Byte
)(&rtState
));
374 * When RF is off, we should not count the packet for hw/sw synchronize
375 * reason, ie. there may be a duration while sw switch is changed and hw
376 * switch is being changed.
378 if (rtState
== eRfOff
)
384 * Do endian transfer to word alignment(16 bits) for windows system.
385 * You must do different endian transfer for linux and MAC OS
387 for (i
= 0; i
< (length
/4); i
++) {
389 temp1
= ptemp
[i
] & 0x0000FFFF;
390 temp2
= ptemp
[i
] >> 16;
391 ptemp
[i
] = (temp1
<< 16) | temp2
;
394 ptxrate
= (cmpk_tx_rahis_t
*)pmsg
;
399 for (i
= 0; i
< 16; i
++) {
400 /* Collect CCK rate packet num */
402 priv
->stats
.txrate
.cck
[i
] += ptxrate
->cck
[i
];
403 /* Collect OFDM rate packet num */
405 priv
->stats
.txrate
.ofdm
[i
] += ptxrate
->ofdm
[i
];
406 for (j
= 0; j
< 4; j
++)
407 priv
->stats
.txrate
.ht_mcs
[j
][i
] += ptxrate
->ht_mcs
[j
][i
];
413 * Function: cmpk_message_handle_rx()
415 * Overview: In the function, we will capture different RX command packet
416 * info. Every RX command packet element has different message
417 * length and meaning in content. We only support three type of RX
418 * command packet now. Please refer to document
419 * ws-06-0063-rtl8190-command-packet-specification.
428 cmpk_message_handle_rx(
429 struct net_device
*dev
,
430 struct ieee80211_rx_stats
*pstats
)
432 struct r8192_priv
*priv
= ieee80211_priv(dev
);
434 u8 cmd_length
, exe_cnt
= 0;
439 * 0. Check input arguments.
440 * If is is a command queue message or pointer is null
442 if ((pstats
== NULL
))
443 return 0; /* This is not a command packet. */
445 /* 1. Read received command packet message length from RFD. */
446 total_length
= pstats
->Length
;
448 /* 2. Read virtual address from RFD. */
449 pcmd_buff
= pstats
->virtual_address
;
451 /* 3. Read command pakcet element id and length. */
452 element_id
= pcmd_buff
[0];
455 * 4. Check every received command packet conent according to different
456 * element type. Because FW may aggregate RX command packet to minimize
457 * transmit time between DRV and FW.
460 /* Add a counter to prevent to locked in the loop too long */
461 while (total_length
> 0 || exe_cnt
++ > 100) {
462 /* We support aggregation of different cmd in the same packet */
463 element_id
= pcmd_buff
[0];
464 switch (element_id
) {
466 cmpk_handle_tx_feedback(dev
, pcmd_buff
);
467 cmd_length
= CMPK_RX_TX_FB_SIZE
;
469 case RX_INTERRUPT_STATUS
:
470 cmpk_handle_interrupt_status(dev
, pcmd_buff
);
471 cmd_length
= sizeof(cmpk_intr_sta_t
);
473 case BOTH_QUERY_CONFIG
:
474 cmpk_handle_query_config_rx(dev
, pcmd_buff
);
475 cmd_length
= CMPK_BOTH_QUERY_CONFIG_SIZE
;
478 cmpk_handle_tx_status(dev
, pcmd_buff
);
479 cmd_length
= CMPK_RX_TX_STS_SIZE
;
481 case RX_TX_PER_PKT_FEEDBACK
:
482 cmd_length
= CMPK_RX_TX_FB_SIZE
;
484 case RX_TX_RATE_HISTORY
:
485 cmpk_handle_tx_rate_history(dev
, pcmd_buff
);
486 cmd_length
= CMPK_TX_RAHIS_SIZE
;
489 RT_TRACE(COMP_ERR
, "(%s): unknown CMD Element\n",
491 return 1; /* This is a command packet. */
493 priv
->stats
.rxcmdpkt
[element_id
]++;
494 total_length
-= cmd_length
;
495 pcmd_buff
+= cmd_length
;
497 return 1; /* This is a command packet. */