1 /******************************************************************************
3 * Copyright(c) 2007 - 2011 Realtek Corporation. All rights reserved.
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms of version 2 of the GNU General Public License as
7 * published by the Free Software Foundation.
9 * This program is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
14 * You should have received a copy of the GNU General Public License along with
15 * this program; if not, write to the Free Software Foundation, Inc.,
16 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
19 ******************************************************************************/
23 #include <wlan_bssdef.h>
27 #include <osdep_service.h>
28 #include <ieee80211.h> /* <ieee80211/ieee80211.h> */
30 #define MAX_CMDSZ 1024
33 #define CMDBUFF_ALIGN_SZ 512
36 struct adapter *padapter;
43 struct list_head list;
47 struct semaphore cmd_queue_sema;
48 struct semaphore terminate_cmdthread_sema;
49 struct __queue cmd_queue;
52 struct adapter *padapter;
55 #define init_h2fwcmd_w_parm_no_rsp(pcmd, pparm, code) \
57 INIT_LIST_HEAD(&pcmd->list);\
58 pcmd->cmdcode = code;\
59 pcmd->parmbuf = (u8 *)(pparm);\
60 pcmd->cmdsz = sizeof(*pparm);\
65 u32 rtw_enqueue_cmd(struct cmd_priv *pcmdpriv, struct cmd_obj *obj);
66 struct cmd_obj *rtw_dequeue_cmd(struct __queue *queue);
67 void rtw_free_cmd_obj(struct cmd_obj *pcmd);
69 int rtw_cmd_thread(void *context);
71 int rtw_init_cmd_priv(struct cmd_priv *pcmdpriv);
72 void rtw_free_cmd_priv(struct cmd_priv *pcmdpriv);
74 enum rtw_drvextra_cmd_id {
79 POWER_SAVING_CTRL_WK_CID,/* IPS,AUTOSuspend */
84 CHECK_HIQ_WK_CID,/* for softap mode, check hi queue if empty */
95 LPS_CTRL_DISCONNECT = 3,
96 LPS_CTRL_SPECIAL_PACKET = 4,
107 Caller Mode: Infra, Ad-HoC(C)
109 Notes: To disconnect the current associated BSS
114 struct disconnect_parm {
115 u32 deauth_timeout_ms;
118 struct setopmode_parm {
124 Caller Mode: AP, Ad-HoC, Infra
126 Notes: To ask RTL8711 performing site-survey
132 #define RTW_SSID_SCAN_AMOUNT 9 /* for WEXT_CSCAN_AMOUNT 9 */
133 #define RTW_CHANNEL_SCAN_AMOUNT (14+37)
134 struct sitesurvey_parm {
135 int scan_mode; /* active: 1, passive: 0 */
138 struct ndis_802_11_ssid ssid[RTW_SSID_SCAN_AMOUNT];
139 struct rtw_ieee80211_channel ch[RTW_CHANNEL_SCAN_AMOUNT];
145 Notes: To set the auth type of RTL8711. open/shared/802.1x
150 struct setauth_parm {
151 u8 mode; /* 0: legacy open, 1: legacy shared 2: 802.1x */
152 u8 _1x; /* 0: PSK, 1: TLS */
159 a. algorithm: wep40, wep104, tkip & aes
160 b. keytype: grp key/unicast key
163 when shared key ==> keyid is the camid
164 when 802.1x ==> keyid [0:1] ==> grp key
165 when 802.1x ==> keyid > 2 ==> unicast key
169 u8 algorithm; /* could be none, wep40, TKIP, CCMP, wep104 */
171 u8 grpkey; /* 1: this is the grpkey for 802.1x.
172 * 0: this is the unicast key for 802.1x */
173 u8 set_tx; /* 1: main tx key for wep. 0: other key. */
174 u8 key[16]; /* this could be 40 or 104 */
178 When in AP or Ad-Hoc mode, this is used to
179 allocate an sw/hw entry for a newly associated sta.
183 when shared key ==> algorithm/keyid
186 struct set_stakey_parm {
189 u8 id;/* currently for erasing cam entry if
190 * algorithm == _NO_PRIVACY_ */
194 struct set_stakey_rsp {
203 Command -Rsp(AID == CAMID) mode
205 This is to force fw to add an sta_data entry per driver's request.
207 FW will write an cam entry associated with it.
210 struct set_assocsta_parm {
214 struct set_assocsta_rsp {
224 This is to force fw to del an sta_data entry per driver's request
226 FW will invalidate the cam entry associated with it.
229 struct del_assocsta_parm {
234 Caller Mode: AP/Ad-HoC(M)
236 Notes: To notify fw that given staid has changed its power state
241 struct setstapwrstate_parm {
250 Notes: To setup the basic rate of RTL8711
255 struct setbasicrate_parm {
256 u8 basicrates[NumRates];
262 Notes: To read the current basic rate
267 struct getbasicrate_parm {
274 Notes: To setup the data rate of RTL8711
279 struct setdatarate_parm {
281 u8 datarates[NumRates];
287 Notes: To read the current data rate
292 struct getdatarate_parm {
296 struct getdatarate_rsp {
297 u8 datarates[NumRates];
302 AP: AP can use the info for the contents of beacon frame
303 Infra: STA can use the info when sitesurveying
307 Notes: To set the phy capability of the NIC
313 struct setphyinfo_parm {
314 struct regulatory_class class_sets[NUM_REGULATORYS];
318 struct getphyinfo_parm {
325 Notes: To set the channel/modem/band
326 This command will be used when channel/modem/band is changed.
339 Notes: To get the current setting of channel/modem/band
350 Notes: This command is used for H2C/C2H loopback testing
353 ==> CMD mode, return H2C_SUCCESS.
354 The following condition must be ture under CMD mode
355 mac[1] == mac[4], mac[2] == mac[3], mac[0]=mac[5]= 0;
356 s0 == 0x1234, s1 == 0xabcd, w0 == 0x78563412, w1 == 0x5aa5def7;
357 s2 == (b1 << 8 | b0);
360 ==> CMD_RSP mode, return H2C_SUCCESS_RSP
362 The rsp layout shall be:
379 ==> CMD_EVENT mode, return H2C_SUCCESS
380 The event layout shall be:
384 mac[2] = event's seq no, starting from 1 to parm's marc[3]
388 s0 = swap16(s0) - event.mac[2];
389 s1 = s1 + event.mac[2];
392 s2 = s0 + event.mac[2]
394 w1 = swap32(w1) - event.mac[2];
396 parm->mac[3] is the total event counts that host requested.
397 event will be the same with the cmd's param.
400 /* CMD param Format for driver extra cmd handler */
401 struct drvextra_cmd_parm {
402 int ec_id; /* extra cmd id */
403 int type_size; /* Can use this field as the type id or command size */
407 struct addBaReq_parm {
412 /*H2C Handler index: 46 */
419 /*H2C Handler index: 59 */
420 struct SetChannelPlan_param {
424 /*H2C Handler index: 60 */
425 struct LedBlink_param {
426 struct LED_871x *pLed;
429 /*H2C Handler index: 61 */
430 struct SetChannelSwitch_param {
434 /*H2C Handler index: 62 */
435 struct TDLSoption_param {
440 #define GEN_CMD_CODE(cmd) cmd ## _CMD_
446 0x01: success, and check Response.
447 0x02: cmd ignored due to duplicated sequcne number
448 0x03: cmd dropped due to invalid cmd code
453 #define H2C_SUCCESS 0x00
454 #define H2C_SUCCESS_RSP 0x01
455 #define H2C_DROPPED 0x03
456 #define H2C_PARAMETERS_ERROR 0x04
457 #define H2C_REJECTED 0x05
459 u8 rtw_sitesurvey_cmd(struct adapter *padapter, struct ndis_802_11_ssid *ssid,
460 int ssid_num, struct rtw_ieee80211_channel *ch,
462 u8 rtw_createbss_cmd(struct adapter *padapter);
463 u8 rtw_setstakey_cmd(struct adapter *padapter, u8 *psta, u8 unicast_key);
464 u8 rtw_clearstakey_cmd(struct adapter *padapter, u8 *psta, u8 entry,
466 u8 rtw_joinbss_cmd(struct adapter *padapter, struct wlan_network *pnetwork);
467 u8 rtw_disassoc_cmd(struct adapter *padapter, u32 deauth_timeout_ms,
469 u8 rtw_setopmode_cmd(struct adapter *padapter,
470 enum ndis_802_11_network_infra networktype);
471 u8 rtw_setdatarate_cmd(struct adapter *padapter, u8 *rateset);
473 u8 rtw_addbareq_cmd(struct adapter *padapter, u8 tid, u8 *addr);
475 u8 rtw_dynamic_chk_wk_cmd(struct adapter *adapter);
477 u8 rtw_lps_ctrl_wk_cmd(struct adapter *padapter, u8 lps_ctrl_type, u8 enqueue);
478 u8 rtw_rpt_timer_cfg_cmd(struct adapter *padapter, u16 minRptTime);
480 u8 rtw_antenna_select_cmd(struct adapter *padapter, u8 antenna, u8 enqueue);
481 u8 rtw_ps_cmd(struct adapter *padapter);
483 #ifdef CONFIG_88EU_AP_MODE
484 u8 rtw_chk_hi_queue_cmd(struct adapter *padapter);
487 u8 rtw_set_chplan_cmd(struct adapter *padapter, u8 chplan, u8 enqueue);
488 u8 rtw_drvextra_cmd_hdl(struct adapter *padapter, unsigned char *pbuf);
490 void rtw_survey_cmd_callback(struct adapter *padapter, struct cmd_obj *pcmd);
491 void rtw_disassoc_cmd_callback(struct adapter *padapter, struct cmd_obj *pcmd);
492 void rtw_joinbss_cmd_callback(struct adapter *padapter, struct cmd_obj *pcmd);
493 void rtw_createbss_cmd_callback(struct adapter *adapt, struct cmd_obj *pcmd);
494 void rtw_readtssi_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cmd);
496 void rtw_setstaKey_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cmd);
497 void rtw_setassocsta_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cm);
498 void rtw_getrttbl_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cmd);
500 struct _cmd_callback {
502 void (*callback)(struct adapter *padapter, struct cmd_obj *cmd);
506 GEN_CMD_CODE(_Read_MACREG), /*0*/
507 GEN_CMD_CODE(_Write_MACREG),
508 GEN_CMD_CODE(_Read_BBREG),
509 GEN_CMD_CODE(_Write_BBREG),
510 GEN_CMD_CODE(_Read_RFREG),
511 GEN_CMD_CODE(_Write_RFREG), /*5*/
512 GEN_CMD_CODE(_Read_EEPROM),
513 GEN_CMD_CODE(_Write_EEPROM),
514 GEN_CMD_CODE(_Read_EFUSE),
515 GEN_CMD_CODE(_Write_EFUSE),
517 GEN_CMD_CODE(_Read_CAM), /*10*/
518 GEN_CMD_CODE(_Write_CAM),
519 GEN_CMD_CODE(_setBCNITV),
520 GEN_CMD_CODE(_setMBIDCFG),
521 GEN_CMD_CODE(_JoinBss), /*14*/
522 GEN_CMD_CODE(_DisConnect), /*15*/
523 GEN_CMD_CODE(_CreateBss),
524 GEN_CMD_CODE(_SetOpMode),
525 GEN_CMD_CODE(_SiteSurvey), /*18*/
526 GEN_CMD_CODE(_SetAuth),
528 GEN_CMD_CODE(_SetKey), /*20*/
529 GEN_CMD_CODE(_SetStaKey),
530 GEN_CMD_CODE(_SetAssocSta),
531 GEN_CMD_CODE(_DelAssocSta),
532 GEN_CMD_CODE(_SetStaPwrState),
533 GEN_CMD_CODE(_SetBasicRate), /*25*/
534 GEN_CMD_CODE(_GetBasicRate),
535 GEN_CMD_CODE(_SetDataRate),
536 GEN_CMD_CODE(_GetDataRate),
537 GEN_CMD_CODE(_SetPhyInfo),
539 GEN_CMD_CODE(_GetPhyInfo), /*30*/
540 GEN_CMD_CODE(_SetPhy),
541 GEN_CMD_CODE(_GetPhy),
542 GEN_CMD_CODE(_readRssi),
543 GEN_CMD_CODE(_readGain),
544 GEN_CMD_CODE(_SetAtim), /*35*/
545 GEN_CMD_CODE(_SetPwrMode),
546 GEN_CMD_CODE(_JoinbssRpt),
547 GEN_CMD_CODE(_SetRaTable),
548 GEN_CMD_CODE(_GetRaTable),
550 GEN_CMD_CODE(_GetCCXReport), /*40*/
551 GEN_CMD_CODE(_GetDTMReport),
552 GEN_CMD_CODE(_GetTXRateStatistics),
553 GEN_CMD_CODE(_SetUsbSuspend),
554 GEN_CMD_CODE(_SetH2cLbk),
555 GEN_CMD_CODE(_AddBAReq), /*45*/
556 GEN_CMD_CODE(_SetChannel), /*46*/
557 GEN_CMD_CODE(_SetTxPower),
558 GEN_CMD_CODE(_SwitchAntenna),
559 GEN_CMD_CODE(_SetCrystalCap),
560 GEN_CMD_CODE(_SetSingleCarrierTx), /*50*/
562 GEN_CMD_CODE(_SetSingleToneTx),/*51*/
563 GEN_CMD_CODE(_SetCarrierSuppressionTx),
564 GEN_CMD_CODE(_SetContinuousTx),
565 GEN_CMD_CODE(_SwitchBandwidth), /*54*/
566 GEN_CMD_CODE(_TX_Beacon), /*55*/
568 GEN_CMD_CODE(_Set_MLME_EVT), /*56*/
569 GEN_CMD_CODE(_Set_Drv_Extra), /*57*/
570 GEN_CMD_CODE(_Set_H2C_MSG), /*58*/
572 GEN_CMD_CODE(_SetChannelPlan), /*59*/
573 GEN_CMD_CODE(_LedBlink), /*60*/
575 GEN_CMD_CODE(_SetChannelSwitch), /*61*/
576 GEN_CMD_CODE(_TDLS), /*62*/
582 static struct _cmd_callback rtw_cmd_callback[] = {
583 {GEN_CMD_CODE(_Read_MACREG), NULL}, /*0*/
584 {GEN_CMD_CODE(_Write_MACREG), NULL},
585 {GEN_CMD_CODE(_Read_BBREG), NULL},
586 {GEN_CMD_CODE(_Write_BBREG), NULL},
587 {GEN_CMD_CODE(_Read_RFREG), NULL},
588 {GEN_CMD_CODE(_Write_RFREG), NULL}, /*5*/
589 {GEN_CMD_CODE(_Read_EEPROM), NULL},
590 {GEN_CMD_CODE(_Write_EEPROM), NULL},
591 {GEN_CMD_CODE(_Read_EFUSE), NULL},
592 {GEN_CMD_CODE(_Write_EFUSE), NULL},
594 {GEN_CMD_CODE(_Read_CAM), NULL}, /*10*/
595 {GEN_CMD_CODE(_Write_CAM), NULL},
596 {GEN_CMD_CODE(_setBCNITV), NULL},
597 {GEN_CMD_CODE(_setMBIDCFG), NULL},
598 {GEN_CMD_CODE(_JoinBss), &rtw_joinbss_cmd_callback}, /*14*/
599 {GEN_CMD_CODE(_DisConnect), &rtw_disassoc_cmd_callback}, /*15*/
600 {GEN_CMD_CODE(_CreateBss), &rtw_createbss_cmd_callback},
601 {GEN_CMD_CODE(_SetOpMode), NULL},
602 {GEN_CMD_CODE(_SiteSurvey), &rtw_survey_cmd_callback}, /*18*/
603 {GEN_CMD_CODE(_SetAuth), NULL},
605 {GEN_CMD_CODE(_SetKey), NULL}, /*20*/
606 {GEN_CMD_CODE(_SetStaKey), &rtw_setstaKey_cmdrsp_callback},
607 {GEN_CMD_CODE(_SetAssocSta), &rtw_setassocsta_cmdrsp_callback},
608 {GEN_CMD_CODE(_DelAssocSta), NULL},
609 {GEN_CMD_CODE(_SetStaPwrState), NULL},
610 {GEN_CMD_CODE(_SetBasicRate), NULL}, /*25*/
611 {GEN_CMD_CODE(_GetBasicRate), NULL},
612 {GEN_CMD_CODE(_SetDataRate), NULL},
613 {GEN_CMD_CODE(_GetDataRate), NULL},
614 {GEN_CMD_CODE(_SetPhyInfo), NULL},
616 {GEN_CMD_CODE(_GetPhyInfo), NULL}, /*30*/
617 {GEN_CMD_CODE(_SetPhy), NULL},
618 {GEN_CMD_CODE(_GetPhy), NULL},
619 {GEN_CMD_CODE(_readRssi), NULL},
620 {GEN_CMD_CODE(_readGain), NULL},
621 {GEN_CMD_CODE(_SetAtim), NULL}, /*35*/
622 {GEN_CMD_CODE(_SetPwrMode), NULL},
623 {GEN_CMD_CODE(_JoinbssRpt), NULL},
624 {GEN_CMD_CODE(_SetRaTable), NULL},
625 {GEN_CMD_CODE(_GetRaTable), NULL},
627 {GEN_CMD_CODE(_GetCCXReport), NULL}, /*40*/
628 {GEN_CMD_CODE(_GetDTMReport), NULL},
629 {GEN_CMD_CODE(_GetTXRateStatistics), NULL},
630 {GEN_CMD_CODE(_SetUsbSuspend), NULL},
631 {GEN_CMD_CODE(_SetH2cLbk), NULL},
632 {GEN_CMD_CODE(_AddBAReq), NULL}, /*45*/
633 {GEN_CMD_CODE(_SetChannel), NULL}, /*46*/
634 {GEN_CMD_CODE(_SetTxPower), NULL},
635 {GEN_CMD_CODE(_SwitchAntenna), NULL},
636 {GEN_CMD_CODE(_SetCrystalCap), NULL},
637 {GEN_CMD_CODE(_SetSingleCarrierTx), NULL}, /*50*/
639 {GEN_CMD_CODE(_SetSingleToneTx), NULL}, /*51*/
640 {GEN_CMD_CODE(_SetCarrierSuppressionTx), NULL},
641 {GEN_CMD_CODE(_SetContinuousTx), NULL},
642 {GEN_CMD_CODE(_SwitchBandwidth), NULL}, /*54*/
643 {GEN_CMD_CODE(_TX_Beacon), NULL},/*55*/
645 {GEN_CMD_CODE(_Set_MLME_EVT), NULL},/*56*/
646 {GEN_CMD_CODE(_Set_Drv_Extra), NULL},/*57*/
647 {GEN_CMD_CODE(_Set_H2C_MSG), NULL},/*58*/
648 {GEN_CMD_CODE(_SetChannelPlan), NULL},/*59*/
649 {GEN_CMD_CODE(_LedBlink), NULL},/*60*/
651 {GEN_CMD_CODE(_SetChannelSwitch), NULL},/*61*/
652 {GEN_CMD_CODE(_TDLS), NULL},/*62*/