/* SPDX-License-Identifier: GPL-2.0 */ /****************************************************************************** * * Copyright(c) 2007 - 2011 Realtek Corporation. All rights reserved. * ******************************************************************************/ #ifndef __RTW_CMD_H_ #define __RTW_CMD_H_ #include #include #include #include #include /* */ #define MAX_CMDSZ 1024 #define MAX_RSPSZ 512 #define CMDBUFF_ALIGN_SZ 512 struct cmd_obj { struct adapter *padapter; u16 cmdcode; u8 res; u8 *parmbuf; u32 cmdsz; u8 *rsp; u32 rspsz; struct list_head list; }; struct cmd_priv { struct completion cmd_queue_comp; struct completion terminate_cmdthread_comp; struct __queue cmd_queue; u8 cmdthd_running; struct adapter *padapter; }; #define init_h2fwcmd_w_parm_no_rsp(pcmd, pparm, code) \ do {\ INIT_LIST_HEAD(&pcmd->list);\ pcmd->cmdcode = code;\ pcmd->parmbuf = (u8 *)(pparm);\ pcmd->cmdsz = sizeof(*pparm);\ pcmd->rsp = NULL;\ pcmd->rspsz = 0;\ } while (0) u32 rtw_enqueue_cmd(struct cmd_priv *pcmdpriv, struct cmd_obj *obj); struct cmd_obj *rtw_dequeue_cmd(struct __queue *queue); void rtw_free_cmd_obj(struct cmd_obj *pcmd); int rtw_cmd_thread(void *context); int rtw_init_cmd_priv(struct cmd_priv *pcmdpriv); enum rtw_drvextra_cmd_id { NONE_WK_CID, DYNAMIC_CHK_WK_CID, DM_CTRL_WK_CID, PBC_POLLING_WK_CID, POWER_SAVING_CTRL_WK_CID,/* IPS,AUTOSuspend */ LPS_CTRL_WK_CID, ANT_SELECT_WK_CID, P2P_PS_WK_CID, P2P_PROTO_WK_CID, CHECK_HIQ_WK_CID,/* for softap mode, check hi queue if empty */ INTEl_WIDI_WK_CID, C2H_WK_CID, RTP_TIMER_CFG_WK_CID, MAX_WK_CID }; enum LPS_CTRL_TYPE { LPS_CTRL_SCAN = 0, LPS_CTRL_JOINBSS = 1, LPS_CTRL_CONNECT = 2, LPS_CTRL_DISCONNECT = 3, LPS_CTRL_SPECIAL_PACKET = 4, LPS_CTRL_LEAVE = 5, }; enum RFINTFS { SWSI, HWSI, HWPI, }; /* * Caller Mode: Infra, Ad-HoC(C) * * Notes: To disconnect the current associated BSS * * Command Mode * */ struct disconnect_parm { u32 deauth_timeout_ms; }; struct setopmode_parm { u8 mode; u8 rsvd[3]; }; /* * Caller Mode: AP, Ad-HoC, Infra * * Notes: To ask RTL8711 performing site-survey * * Command-Event Mode * */ #define RTW_SSID_SCAN_AMOUNT 9 /* for WEXT_CSCAN_AMOUNT 9 */ #define RTW_CHANNEL_SCAN_AMOUNT (14+37) struct sitesurvey_parm { int scan_mode; /* active: 1, passive: 0 */ u8 ssid_num; u8 ch_num; struct ndis_802_11_ssid ssid[RTW_SSID_SCAN_AMOUNT]; struct rtw_ieee80211_channel ch[RTW_CHANNEL_SCAN_AMOUNT]; }; /* * Caller Mode: Any * * Notes: To set the auth type of RTL8711. open/shared/802.1x * * Command Mode * */ struct setauth_parm { u8 mode; /* 0: legacy open, 1: legacy shared 2: 802.1x */ u8 _1x; /* 0: PSK, 1: TLS */ u8 rsvd[2]; }; /* * Caller Mode: Infra * * a. algorithm: wep40, wep104, tkip & aes * b. keytype: grp key/unicast key * c. key contents * * when shared key ==> keyid is the camid * when 802.1x ==> keyid [0:1] ==> grp key * when 802.1x ==> keyid > 2 ==> unicast key * */ struct setkey_parm { u8 algorithm; /* could be none, wep40, TKIP, CCMP, wep104 */ u8 keyid; u8 grpkey; /* 1: this is the grpkey for 802.1x. * 0: this is the unicast key for 802.1x */ u8 set_tx; /* 1: main tx key for wep. 0: other key. */ u8 key[16]; /* this could be 40 or 104 */ }; /* * When in AP or Ad-Hoc mode, this is used to * allocate an sw/hw entry for a newly associated sta. * * Command * * when shared key ==> algorithm/keyid * */ struct set_stakey_parm { u8 addr[ETH_ALEN]; u8 algorithm; u8 id;/* currently for erasing cam entry if * algorithm == _NO_PRIVACY_ */ u8 key[16]; }; struct set_stakey_rsp { u8 addr[ETH_ALEN]; u8 keyid; u8 rsvd; }; /* * Caller Ad-Hoc/AP * * Command -Rsp(AID == CAMID) mode * * This is to force fw to add an sta_data entry per driver's request. * * FW will write an cam entry associated with it. * */ struct set_assocsta_parm { u8 addr[ETH_ALEN]; }; struct set_assocsta_rsp { u8 cam_id; u8 rsvd[3]; }; /* * Notes: This command is used for H2C/C2H loopback testing * * mac[0] == 0 * ==> CMD mode, return H2C_SUCCESS. * The following condition must be true under CMD mode * mac[1] == mac[4], mac[2] == mac[3], mac[0]=mac[5]= 0; * s0 == 0x1234, s1 == 0xabcd, w0 == 0x78563412, w1 == 0x5aa5def7; * s2 == (b1 << 8 | b0); * * mac[0] == 1 * ==> CMD_RSP mode, return H2C_SUCCESS_RSP * * The rsp layout shall be: * rsp: parm: * mac[0] = mac[5]; * mac[1] = mac[4]; * mac[2] = mac[3]; * mac[3] = mac[2]; * mac[4] = mac[1]; * mac[5] = mac[0]; * s0 = s1; * s1 = swap16(s0); * w0 = swap32(w1); * b0 = b1 * s2 = s0 + s1 * b1 = b0 * w1 = w0 * * mac[0] == 2 * ==> CMD_EVENT mode, return H2C_SUCCESS * The event layout shall be: * event: parm: * mac[0] = mac[5]; * mac[1] = mac[4]; * mac[2] = event's seq no, starting from 1 to parm's marc[3] * mac[2] = event's seq no, starting from 1 to parm's marc[3] * mac[2] = event's seq no, starting from 1 to parm's marc[3] * mac[3] = mac[2]; * mac[4] = mac[1]; * mac[5] = mac[0]; * s0 = swap16(s0) - event.mac[2]; * s1 = s1 + event.mac[2]; * w0 = swap32(w0); * b0 = b1 * s2 = s0 + event.mac[2] * b1 = b0 * w1 = swap32(w1) - event.mac[2]; * * parm->mac[3] is the total event counts that host requested. * event will be the same with the cmd's param. */ /* CMD param Format for driver extra cmd handler */ struct drvextra_cmd_parm { int ec_id; /* extra cmd id */ int type_size; /* Can use this field as the type id or command size */ unsigned char *pbuf; }; struct addBaReq_parm { unsigned int tid; u8 addr[ETH_ALEN]; }; /*H2C Handler index: 46 */ struct set_ch_parm { u8 ch; u8 bw; u8 ch_offset; }; /*H2C Handler index: 59 */ struct SetChannelPlan_param { u8 channel_plan; }; /* * * Result: * 0x00: success * 0x01: success, and check Response. * 0x02: cmd ignored due to duplicated sequcne number * 0x03: cmd dropped due to invalid cmd code * 0x04: reserved. * */ #define H2C_SUCCESS 0x00 #define H2C_SUCCESS_RSP 0x01 #define H2C_DROPPED 0x03 #define H2C_PARAMETERS_ERROR 0x04 #define H2C_REJECTED 0x05 u8 rtw_sitesurvey_cmd(struct adapter *padapter, struct ndis_802_11_ssid *ssid, int ssid_num, struct rtw_ieee80211_channel *ch, int ch_num); u8 rtw_createbss_cmd(struct adapter *padapter); u8 rtw_setstakey_cmd(struct adapter *padapter, u8 *psta, u8 unicast_key); u8 rtw_clearstakey_cmd(struct adapter *padapter, u8 *psta, u8 entry, u8 enqueue); u8 rtw_joinbss_cmd(struct adapter *padapter, struct wlan_network *pnetwork); u8 rtw_disassoc_cmd(struct adapter *padapter, u32 deauth_timeout_ms, bool enqueue); u8 rtw_setopmode_cmd(struct adapter *padapter, enum ndis_802_11_network_infra networktype); u8 rtw_addbareq_cmd(struct adapter *padapter, u8 tid, u8 *addr); u8 rtw_dynamic_chk_wk_cmd(struct adapter *adapter); u8 rtw_lps_ctrl_wk_cmd(struct adapter *padapter, u8 lps_ctrl_type, u8 enqueue); u8 rtw_rpt_timer_cfg_cmd(struct adapter *padapter, u16 minRptTime); u8 rtw_antenna_select_cmd(struct adapter *padapter, u8 antenna, u8 enqueue); u8 rtw_ps_cmd(struct adapter *padapter); #ifdef CPTCFG_88EU_AP_MODE u8 rtw_chk_hi_queue_cmd(struct adapter *padapter); #endif u8 rtw_set_chplan_cmd(struct adapter *padapter, u8 chplan, u8 enqueue); u8 rtw_drvextra_cmd_hdl(struct adapter *padapter, unsigned char *pbuf); void rtw_survey_cmd_callback(struct adapter *padapter, struct cmd_obj *pcmd); void rtw_disassoc_cmd_callback(struct adapter *padapter, struct cmd_obj *pcmd); void rtw_joinbss_cmd_callback(struct adapter *padapter, struct cmd_obj *pcmd); void rtw_createbss_cmd_callback(struct adapter *adapt, struct cmd_obj *pcmd); void rtw_readtssi_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cmd); void rtw_setstaKey_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cmd); void rtw_setassocsta_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cm); void rtw_getrttbl_cmdrsp_callback(struct adapter *adapt, struct cmd_obj *cmd); struct _cmd_callback { u32 cmd_code; void (*callback)(struct adapter *padapter, struct cmd_obj *cmd); }; enum rtw_h2c_cmd { _JoinBss_CMD_, _DisConnect_CMD_, _CreateBss_CMD_, _SetOpMode_CMD_, _SiteSurvey_CMD_, _SetAuth_CMD_, _SetKey_CMD_, _SetStaKey_CMD_, _SetAssocSta_CMD_, _AddBAReq_CMD_, _SetChannel_CMD_, _TX_Beacon_CMD_, _Set_MLME_EVT_CMD_, _Set_Drv_Extra_CMD_, _SetChannelPlan_CMD_, MAX_H2CCMD }; #ifdef _RTW_CMD_C_ static struct _cmd_callback rtw_cmd_callback[] = { {_JoinBss_CMD_, &rtw_joinbss_cmd_callback}, {_DisConnect_CMD_, &rtw_disassoc_cmd_callback}, {_CreateBss_CMD_, &rtw_createbss_cmd_callback}, {_SetOpMode_CMD_, NULL}, {_SiteSurvey_CMD_, &rtw_survey_cmd_callback}, {_SetAuth_CMD_, NULL}, {_SetKey_CMD_, NULL}, {_SetStaKey_CMD_, &rtw_setstaKey_cmdrsp_callback}, {_SetAssocSta_CMD_, &rtw_setassocsta_cmdrsp_callback}, {_AddBAReq_CMD_, NULL}, {_SetChannel_CMD_, NULL}, {_TX_Beacon_CMD_, NULL}, {_Set_MLME_EVT_CMD_, NULL}, {_Set_Drv_Extra_CMD_, NULL}, {_SetChannelPlan_CMD_, NULL}, }; #endif #endif /* _CMD_H_ */