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;
51 struct adapter *padapter;
54 #define init_h2fwcmd_w_parm_no_rsp(pcmd, pparm, code) \
56 INIT_LIST_HEAD(&pcmd->list);\
57 pcmd->cmdcode = code;\
58 pcmd->parmbuf = (u8 *)(pparm);\
59 pcmd->cmdsz = sizeof(*pparm);\
64 u32 rtw_enqueue_cmd(struct cmd_priv *pcmdpriv, struct cmd_obj *obj);
65 struct cmd_obj *rtw_dequeue_cmd(struct __queue *queue);
66 void rtw_free_cmd_obj(struct cmd_obj *pcmd);
68 int rtw_cmd_thread(void *context);
70 int rtw_init_cmd_priv(struct cmd_priv *pcmdpriv);
72 enum rtw_drvextra_cmd_id {
77 POWER_SAVING_CTRL_WK_CID,/* IPS,AUTOSuspend */
82 CHECK_HIQ_WK_CID,/* for softap mode, check hi queue if empty */
93 LPS_CTRL_DISCONNECT = 3,
94 LPS_CTRL_SPECIAL_PACKET = 4,
105 Caller Mode: Infra, Ad-HoC(C)
107 Notes: To disconnect the current associated BSS
112 struct disconnect_parm {
113 u32 deauth_timeout_ms;
116 struct setopmode_parm {
122 Caller Mode: AP, Ad-HoC, Infra
124 Notes: To ask RTL8711 performing site-survey
130 #define RTW_SSID_SCAN_AMOUNT 9 /* for WEXT_CSCAN_AMOUNT 9 */
131 #define RTW_CHANNEL_SCAN_AMOUNT (14+37)
132 struct sitesurvey_parm {
133 int scan_mode; /* active: 1, passive: 0 */
136 struct ndis_802_11_ssid ssid[RTW_SSID_SCAN_AMOUNT];
137 struct rtw_ieee80211_channel ch[RTW_CHANNEL_SCAN_AMOUNT];
143 Notes: To set the auth type of RTL8711. open/shared/802.1x
148 struct setauth_parm {
149 u8 mode; /* 0: legacy open, 1: legacy shared 2: 802.1x */
150 u8 _1x; /* 0: PSK, 1: TLS */
157 a. algorithm: wep40, wep104, tkip & aes
158 b. keytype: grp key/unicast key
161 when shared key ==> keyid is the camid
162 when 802.1x ==> keyid [0:1] ==> grp key
163 when 802.1x ==> keyid > 2 ==> unicast key
167 u8 algorithm; /* could be none, wep40, TKIP, CCMP, wep104 */
169 u8 grpkey; /* 1: this is the grpkey for 802.1x.
170 * 0: this is the unicast key for 802.1x */
171 u8 set_tx; /* 1: main tx key for wep. 0: other key. */
172 u8 key[16]; /* this could be 40 or 104 */
176 When in AP or Ad-Hoc mode, this is used to
177 allocate an sw/hw entry for a newly associated sta.
181 when shared key ==> algorithm/keyid
184 struct set_stakey_parm {
187 u8 id;/* currently for erasing cam entry if
188 * algorithm == _NO_PRIVACY_ */
192 struct set_stakey_rsp {
201 Command -Rsp(AID == CAMID) mode
203 This is to force fw to add an sta_data entry per driver's request.
205 FW will write an cam entry associated with it.
208 struct set_assocsta_parm {
212 struct set_assocsta_rsp {
222 This is to force fw to del an sta_data entry per driver's request
224 FW will invalidate the cam entry associated with it.
227 struct del_assocsta_parm {
232 Caller Mode: AP/Ad-HoC(M)
234 Notes: To notify fw that given staid has changed its power state
239 struct setstapwrstate_parm {
246 Notes: This command is used for H2C/C2H loopback testing
249 ==> CMD mode, return H2C_SUCCESS.
250 The following condition must be ture under CMD mode
251 mac[1] == mac[4], mac[2] == mac[3], mac[0]=mac[5]= 0;
252 s0 == 0x1234, s1 == 0xabcd, w0 == 0x78563412, w1 == 0x5aa5def7;
253 s2 == (b1 << 8 | b0);
256 ==> CMD_RSP mode, return H2C_SUCCESS_RSP
258 The rsp layout shall be:
275 ==> CMD_EVENT mode, return H2C_SUCCESS
276 The event layout shall be:
280 mac[2] = event's seq no, starting from 1 to parm's marc[3]
284 s0 = swap16(s0) - event.mac[2];
285 s1 = s1 + event.mac[2];
288 s2 = s0 + event.mac[2]
290 w1 = swap32(w1) - event.mac[2];
292 parm->mac[3] is the total event counts that host requested.
293 event will be the same with the cmd's param.
296 /* CMD param Format for driver extra cmd handler */
297 struct drvextra_cmd_parm {
298 int ec_id; /* extra cmd id */
299 int type_size; /* Can use this field as the type id or command size */
303 struct addBaReq_parm {
308 /*H2C Handler index: 46 */
315 /*H2C Handler index: 59 */
316 struct SetChannelPlan_param {
320 #define GEN_CMD_CODE(cmd) cmd ## _CMD_
326 0x01: success, and check Response.
327 0x02: cmd ignored due to duplicated sequcne number
328 0x03: cmd dropped due to invalid cmd code
333 #define H2C_SUCCESS 0x00
334 #define H2C_SUCCESS_RSP 0x01
335 #define H2C_DROPPED 0x03
336 #define H2C_PARAMETERS_ERROR 0x04
337 #define H2C_REJECTED 0x05
339 u8 rtw_sitesurvey_cmd(struct adapter *padapter, struct ndis_802_11_ssid *ssid,
340 int ssid_num, struct rtw_ieee80211_channel *ch,
342 u8 rtw_createbss_cmd(struct adapter *padapter);
343 u8 rtw_setstakey_cmd(struct adapter *padapter, u8 *psta, u8 unicast_key);
344 u8 rtw_clearstakey_cmd(struct adapter *padapter, u8 *psta, u8 entry,
346 u8 rtw_joinbss_cmd(struct adapter *padapter, struct wlan_network *pnetwork);
347 u8 rtw_disassoc_cmd(struct adapter *padapter, u32 deauth_timeout_ms,
349 u8 rtw_setopmode_cmd(struct adapter *padapter,
350 enum ndis_802_11_network_infra networktype);
351 u8 rtw_addbareq_cmd(struct adapter *padapter, u8 tid, u8 *addr);
353 u8 rtw_dynamic_chk_wk_cmd(struct adapter *adapter);
355 u8 rtw_lps_ctrl_wk_cmd(struct adapter *padapter, u8 lps_ctrl_type, u8 enqueue);
356 u8 rtw_rpt_timer_cfg_cmd(struct adapter *padapter, u16 minRptTime);
358 u8 rtw_antenna_select_cmd(struct adapter *padapter, u8 antenna, u8 enqueue);
359 u8 rtw_ps_cmd(struct adapter *padapter);
361 #ifdef CONFIG_88EU_AP_MODE
362 u8 rtw_chk_hi_queue_cmd(struct adapter *padapter);
365 u8 rtw_set_chplan_cmd(struct adapter *padapter, u8 chplan, u8 enqueue);
366 u8 rtw_drvextra_cmd_hdl(struct adapter *padapter, unsigned char *pbuf);
368 void rtw_survey_cmd_callback(struct adapter *padapter, struct cmd_obj *pcmd);
369 void rtw_disassoc_cmd_callback(struct adapter *padapter, struct cmd_obj *pcmd);
370 void rtw_joinbss_cmd_callback(struct adapter *padapter, struct cmd_obj *pcmd);
371 void rtw_createbss_cmd_callback(struct adapter *adapt, struct cmd_obj *pcmd);
372 void rtw_readtssi_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cmd);
374 void rtw_setstaKey_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cmd);
375 void rtw_setassocsta_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cm);
376 void rtw_getrttbl_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cmd);
378 struct _cmd_callback {
380 void (*callback)(struct adapter *padapter, struct cmd_obj *cmd);
384 GEN_CMD_CODE(_JoinBss),
385 GEN_CMD_CODE(_DisConnect),
386 GEN_CMD_CODE(_CreateBss),
387 GEN_CMD_CODE(_SetOpMode),
388 GEN_CMD_CODE(_SiteSurvey),
389 GEN_CMD_CODE(_SetAuth),
390 GEN_CMD_CODE(_SetKey),
391 GEN_CMD_CODE(_SetStaKey),
392 GEN_CMD_CODE(_SetAssocSta),
393 GEN_CMD_CODE(_AddBAReq),
394 GEN_CMD_CODE(_SetChannel),
395 GEN_CMD_CODE(_TX_Beacon),
396 GEN_CMD_CODE(_Set_MLME_EVT),
397 GEN_CMD_CODE(_Set_Drv_Extra),
398 GEN_CMD_CODE(_SetChannelPlan),
404 static struct _cmd_callback rtw_cmd_callback[] = {
405 {GEN_CMD_CODE(_JoinBss), &rtw_joinbss_cmd_callback},
406 {GEN_CMD_CODE(_DisConnect), &rtw_disassoc_cmd_callback},
407 {GEN_CMD_CODE(_CreateBss), &rtw_createbss_cmd_callback},
408 {GEN_CMD_CODE(_SetOpMode), NULL},
409 {GEN_CMD_CODE(_SiteSurvey), &rtw_survey_cmd_callback},
410 {GEN_CMD_CODE(_SetAuth), NULL},
411 {GEN_CMD_CODE(_SetKey), NULL},
412 {GEN_CMD_CODE(_SetStaKey), &rtw_setstaKey_cmdrsp_callback},
413 {GEN_CMD_CODE(_SetAssocSta), &rtw_setassocsta_cmdrsp_callback},
414 {GEN_CMD_CODE(_AddBAReq), NULL},
415 {GEN_CMD_CODE(_SetChannel), NULL},
416 {GEN_CMD_CODE(_TX_Beacon), NULL},
417 {GEN_CMD_CODE(_Set_MLME_EVT), NULL},
418 {GEN_CMD_CODE(_Set_Drv_Extra), NULL},
419 {GEN_CMD_CODE(_SetChannelPlan), NULL},