| /****************************************************************************** |
| * |
| * Copyright(c) 2007 - 2010 Realtek Corporation. All rights reserved. |
| * |
| * This program is free software; you can redistribute it and/or modify it |
| * under the terms of version 2 of the GNU General Public License as |
| * published by the Free Software Foundation. |
| * |
| * This program is distributed in the hope that it will be useful, but WITHOUT |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for |
| * more details. |
| * |
| * You should have received a copy of the GNU General Public License along with |
| * this program; if not, write to the Free Software Foundation, Inc., |
| * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA |
| * |
| * Modifications for inclusion into the Linux staging tree are |
| * Copyright(c) 2010 Larry Finger. All rights reserved. |
| * |
| * Contact information: |
| * WLAN FAE <wlanfae@realtek.com> |
| * Larry Finger <Larry.Finger@lwfinger.net> |
| * |
| ******************************************************************************/ |
| #ifndef __RTL871X_CMD_H_ |
| #define __RTL871X_CMD_H_ |
| |
| #include "wlan_bssdef.h" |
| #include "rtl871x_rf.h" |
| #define C2H_MEM_SZ (16*1024) |
| |
| #include "osdep_service.h" |
| #include "ieee80211.h" |
| |
| #define FREE_CMDOBJ_SZ 128 |
| #define MAX_CMDSZ 512 |
| #define MAX_RSPSZ 512 |
| #define MAX_EVTSZ 1024 |
| #define CMDBUFF_ALIGN_SZ 512 |
| |
| struct cmd_obj { |
| u16 cmdcode; |
| u8 res; |
| u8 *parmbuf; |
| u32 cmdsz; |
| u8 *rsp; |
| u32 rspsz; |
| struct list_head list; |
| }; |
| |
| struct cmd_priv { |
| struct semaphore cmd_queue_sema; |
| struct semaphore terminate_cmdthread_sema; |
| struct __queue cmd_queue; |
| u8 cmd_seq; |
| u8 *cmd_buf; /*shall be non-paged, and 4 bytes aligned*/ |
| u8 *cmd_allocated_buf; |
| u8 *rsp_buf; /*shall be non-paged, and 4 bytes aligned*/ |
| u8 *rsp_allocated_buf; |
| u32 cmd_issued_cnt; |
| u32 cmd_done_cnt; |
| u32 rsp_cnt; |
| struct _adapter *padapter; |
| }; |
| |
| struct evt_obj { |
| u16 evtcode; |
| u8 res; |
| u8 *parmbuf; |
| u32 evtsz; |
| struct list_head list; |
| }; |
| |
| struct evt_priv { |
| struct __queue evt_queue; |
| u8 event_seq; |
| u8 *evt_buf; /*shall be non-paged, and 4 bytes aligned*/ |
| u8 *evt_allocated_buf; |
| u32 evt_done_cnt; |
| struct tasklet_struct event_tasklet; |
| }; |
| |
| #define init_h2fwcmd_w_parm_no_rsp(pcmd, pparm, code) \ |
| do {\ |
| _init_listhead(&pcmd->list);\ |
| pcmd->cmdcode = code;\ |
| pcmd->parmbuf = (u8 *)(pparm);\ |
| pcmd->cmdsz = sizeof(*pparm);\ |
| pcmd->rsp = NULL;\ |
| pcmd->rspsz = 0;\ |
| } while (0) |
| |
| u32 r8712_enqueue_cmd(struct cmd_priv *pcmdpriv, struct cmd_obj *obj); |
| u32 r8712_enqueue_cmd_ex(struct cmd_priv *pcmdpriv, struct cmd_obj *obj); |
| struct cmd_obj *r8712_dequeue_cmd(struct __queue *queue); |
| void r8712_free_cmd_obj(struct cmd_obj *pcmd); |
| int r8712_cmd_thread(void *context); |
| u32 r8712_init_cmd_priv(struct cmd_priv *pcmdpriv); |
| void r8712_free_cmd_priv(struct cmd_priv *pcmdpriv); |
| u32 r8712_init_evt_priv(struct evt_priv *pevtpriv); |
| void r8712_free_evt_priv(struct evt_priv *pevtpriv); |
| |
| enum rtl871x_drvint_cid { |
| NONE_WK_CID, |
| WDG_WK_CID, |
| MAX_WK_CID |
| }; |
| |
| enum RFINTFS { |
| SWSI, |
| HWSI, |
| HWPI, |
| }; |
| |
| /* |
| * Caller Mode: Infra, Ad-HoC(C) |
| * Notes: To enter USB suspend mode |
| * Command Mode |
| */ |
| struct usb_suspend_parm { |
| u32 action; /* 1: sleep, 0:resume */ |
| }; |
| |
| /* |
| * Caller Mode: Infra, Ad-Hoc |
| * Notes: To join the specified bss |
| * Command Event Mode |
| */ |
| struct joinbss_parm { |
| struct ndis_wlan_bssid_ex network; |
| }; |
| |
| /* |
| * Caller Mode: Infra, Ad-HoC(C) |
| * Notes: To disconnect the current associated BSS |
| * Command Mode |
| */ |
| struct disconnect_parm { |
| u32 rsvd; |
| }; |
| |
| /* |
| * Caller Mode: AP, Ad-HoC(M) |
| * Notes: To create a BSS |
| * Command Mode |
| */ |
| struct createbss_parm { |
| struct ndis_wlan_bssid_ex network; |
| }; |
| |
| /* |
| * Caller Mode: AP, Ad-HoC, Infra |
| * Notes: To set the NIC mode of RTL8711 |
| * Command Mode |
| * The definition of mode: |
| * |
| * #define IW_MODE_AUTO 0 // Let the driver decides which AP to join |
| * #define IW_MODE_ADHOC 1 // Single cell network (Ad-Hoc Clients) |
| * #define IW_MODE_INFRA 2 // Multi cell network, roaming, .. |
| * #define IW_MODE_MASTER 3 // Synchronisation master or AP |
| * #define IW_MODE_REPEAT 4 // Wireless Repeater (forwarder) |
| * #define IW_MODE_SECOND 5 // Secondary master/repeater (backup) |
| * #define IW_MODE_MONITOR 6 // Passive monitor (listen only) |
| */ |
| struct setopmode_parm { |
| u8 mode; |
| u8 rsvd[3]; |
| }; |
| |
| /* |
| * Caller Mode: AP, Ad-HoC, Infra |
| * Notes: To ask RTL8711 performing site-survey |
| * Command-Event Mode |
| */ |
| struct sitesurvey_parm { |
| sint passive_mode; /*active: 1, passive: 0 */ |
| sint bsslimit; /* 1 ~ 48 */ |
| sint ss_ssidlen; |
| u8 ss_ssid[IW_ESSID_MAX_SIZE + 1]; |
| }; |
| |
| /* |
| * 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; /* encryption 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 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 key[16]; |
| }; |
| |
| struct set_stakey_rsp { |
| u8 addr[ETH_ALEN]; |
| u8 keyid; |
| u8 rsvd; |
| }; |
| |
| struct SetMacAddr_param { |
| u8 MacAddr[ETH_ALEN]; |
| }; |
| |
| /* |
| 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]; |
| }; |
| |
| /* |
| Caller Ad-Hoc/AP |
| |
| Command mode |
| |
| This is to force fw to del an sta_data entry per driver's request |
| |
| FW will invalidate the cam entry associated with it. |
| |
| */ |
| struct del_assocsta_parm { |
| u8 addr[ETH_ALEN]; |
| }; |
| |
| /* |
| Caller Mode: AP/Ad-HoC(M) |
| |
| Notes: To notify fw that given staid has changed its power state |
| |
| Command Mode |
| |
| */ |
| struct setstapwrstate_parm { |
| u8 staid; |
| u8 status; |
| u8 hwaddr[6]; |
| }; |
| |
| /* |
| Caller Mode: Any |
| |
| Notes: To setup the basic rate of RTL8711 |
| |
| Command Mode |
| |
| */ |
| struct setbasicrate_parm { |
| u8 basicrates[NumRates]; |
| }; |
| |
| /* |
| Caller Mode: Any |
| |
| Notes: To read the current basic rate |
| |
| Command-Rsp Mode |
| |
| */ |
| struct getbasicrate_parm { |
| u32 rsvd; |
| }; |
| |
| struct getbasicrate_rsp { |
| u8 basicrates[NumRates]; |
| }; |
| |
| /* |
| Caller Mode: Any |
| |
| Notes: To setup the data rate of RTL8711 |
| |
| Command Mode |
| |
| */ |
| struct setdatarate_parm { |
| u8 mac_id; |
| u8 datarates[NumRates]; |
| }; |
| |
| /* |
| Caller Mode: Any |
| |
| Notes: To read the current data rate |
| |
| Command-Rsp Mode |
| |
| */ |
| struct getdatarate_parm { |
| u32 rsvd; |
| |
| }; |
| struct getdatarate_rsp { |
| u8 datarates[NumRates]; |
| }; |
| |
| |
| /* |
| Caller Mode: Any |
| AP: AP can use the info for the contents of beacon frame |
| Infra: STA can use the info when sitesurveying |
| Ad-HoC(M): Like AP |
| Ad-HoC(C): Like STA |
| |
| |
| Notes: To set the phy capability of the NIC |
| |
| Command Mode |
| |
| */ |
| |
| /* |
| Caller Mode: Any |
| |
| Notes: To set the channel/modem/band |
| This command will be used when channel/modem/band is changed. |
| |
| Command Mode |
| |
| */ |
| /* |
| Caller Mode: Any |
| |
| Notes: To get the current setting of channel/modem/band |
| |
| Command-Rsp Mode |
| |
| */ |
| struct getphy_rsp { |
| u8 rfchannel; |
| u8 modem; |
| }; |
| |
| struct readBB_parm { |
| u8 offset; |
| }; |
| struct readBB_rsp { |
| u8 value; |
| }; |
| |
| struct readTSSI_parm { |
| u8 offset; |
| }; |
| struct readTSSI_rsp { |
| u8 value; |
| }; |
| |
| struct writeBB_parm { |
| u8 offset; |
| u8 value; |
| }; |
| |
| struct readRF_parm { |
| u8 offset; |
| }; |
| struct readRF_rsp { |
| u32 value; |
| }; |
| |
| struct writeRF_parm { |
| u32 offset; |
| u32 value; |
| }; |
| |
| struct setrfintfs_parm { |
| u8 rfintfs; |
| }; |
| |
| struct getrfintfs_parm { |
| u8 rfintfs; |
| }; |
| |
| /* |
| Notes: This command is used for H2C/C2H loopback testing |
| |
| mac[0] == 0 |
| ==> CMD mode, return H2C_SUCCESS. |
| The following condition must be ture 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 sequence number, 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 Formart for DRV INTERNAL CMD HDL*/ |
| struct drvint_cmd_parm { |
| int i_cid; /*internal cmd id*/ |
| int sz; /* buf sz*/ |
| unsigned char *pbuf; |
| }; |
| |
| /*------------------- Below are used for RF/BB tunning ---------------------*/ |
| |
| struct setantenna_parm { |
| u8 tx_antset; |
| u8 rx_antset; |
| u8 tx_antenna; |
| u8 rx_antenna; |
| }; |
| |
| struct enrateadaptive_parm { |
| u32 en; |
| }; |
| |
| struct settxagctbl_parm { |
| u32 txagc[MAX_RATES_LENGTH]; |
| }; |
| |
| struct gettxagctbl_parm { |
| u32 rsvd; |
| }; |
| struct gettxagctbl_rsp { |
| u32 txagc[MAX_RATES_LENGTH]; |
| }; |
| |
| struct setagcctrl_parm { |
| u32 agcctrl; /* 0: pure hw, 1: fw */ |
| }; |
| |
| struct setssup_parm { |
| u32 ss_ForceUp[MAX_RATES_LENGTH]; |
| }; |
| |
| struct getssup_parm { |
| u32 rsvd; |
| }; |
| struct getssup_rsp { |
| u8 ss_ForceUp[MAX_RATES_LENGTH]; |
| }; |
| |
| struct setssdlevel_parm { |
| u8 ss_DLevel[MAX_RATES_LENGTH]; |
| }; |
| |
| struct getssdlevel_parm { |
| u32 rsvd; |
| }; |
| struct getssdlevel_rsp { |
| u8 ss_DLevel[MAX_RATES_LENGTH]; |
| }; |
| |
| struct setssulevel_parm { |
| u8 ss_ULevel[MAX_RATES_LENGTH]; |
| }; |
| |
| struct getssulevel_parm { |
| u32 rsvd; |
| }; |
| struct getssulevel_rsp { |
| u8 ss_ULevel[MAX_RATES_LENGTH]; |
| }; |
| |
| struct setcountjudge_parm { |
| u8 count_judge[MAX_RATES_LENGTH]; |
| }; |
| |
| struct getcountjudge_parm { |
| u32 rsvd; |
| }; |
| |
| struct getcountjudge_rsp { |
| u8 count_judge[MAX_RATES_LENGTH]; |
| }; |
| |
| struct setpwrmode_parm { |
| u8 mode; |
| u8 flag_low_traffic_en; |
| u8 flag_lpnav_en; |
| u8 flag_rf_low_snr_en; |
| u8 flag_dps_en; /* 1: dps, 0: 32k */ |
| u8 bcn_rx_en; |
| u8 bcn_pass_cnt; /* fw report one beacon information to |
| * driver when it receives bcn_pass_cnt |
| * beacons. */ |
| u8 bcn_to; /* beacon TO (ms). ¡§=0¡¨ no limit.*/ |
| u16 bcn_itv; |
| u8 app_itv; /* only for VOIP mode. */ |
| u8 awake_bcn_itv; |
| u8 smart_ps; |
| u8 bcn_pass_time; /* unit: 100ms */ |
| }; |
| |
| struct setatim_parm { |
| u8 op; /*0: add, 1:del*/ |
| u8 txid; /* id of dest station.*/ |
| }; |
| |
| struct setratable_parm { |
| u8 ss_ForceUp[NumRates]; |
| u8 ss_ULevel[NumRates]; |
| u8 ss_DLevel[NumRates]; |
| u8 count_judge[NumRates]; |
| }; |
| |
| struct getratable_parm { |
| uint rsvd; |
| }; |
| struct getratable_rsp { |
| u8 ss_ForceUp[NumRates]; |
| u8 ss_ULevel[NumRates]; |
| u8 ss_DLevel[NumRates]; |
| u8 count_judge[NumRates]; |
| }; |
| |
| /*to get TX,RX retry count*/ |
| struct gettxretrycnt_parm { |
| unsigned int rsvd; |
| }; |
| |
| struct gettxretrycnt_rsp { |
| unsigned long tx_retrycnt; |
| }; |
| |
| struct getrxretrycnt_parm { |
| unsigned int rsvd; |
| }; |
| |
| struct getrxretrycnt_rsp { |
| unsigned long rx_retrycnt; |
| }; |
| |
| /*to get BCNOK,BCNERR count*/ |
| struct getbcnokcnt_parm { |
| unsigned int rsvd; |
| }; |
| |
| struct getbcnokcnt_rsp { |
| unsigned long bcnokcnt; |
| }; |
| |
| struct getbcnerrcnt_parm { |
| unsigned int rsvd; |
| }; |
| struct getbcnerrcnt_rsp { |
| unsigned long bcnerrcnt; |
| }; |
| |
| /* to get current TX power level*/ |
| struct getcurtxpwrlevel_parm { |
| unsigned int rsvd; |
| }; |
| |
| struct getcurtxpwrlevel_rsp { |
| unsigned short tx_power; |
| }; |
| |
| /*dynamic on/off DIG*/ |
| struct setdig_parm { |
| unsigned char dig_on; /* 1:on , 0:off */ |
| }; |
| |
| /*dynamic on/off RA*/ |
| struct setra_parm { |
| unsigned char ra_on; /* 1:on , 0:off */ |
| }; |
| |
| struct setprobereqextraie_parm { |
| unsigned char e_id; |
| unsigned char ie_len; |
| unsigned char ie[0]; |
| }; |
| |
| struct setassocreqextraie_parm { |
| unsigned char e_id; |
| unsigned char ie_len; |
| unsigned char ie[0]; |
| }; |
| |
| struct setproberspextraie_parm { |
| unsigned char e_id; |
| unsigned char ie_len; |
| unsigned char ie[0]; |
| }; |
| |
| struct setassocrspextraie_parm { |
| unsigned char e_id; |
| unsigned char ie_len; |
| unsigned char ie[0]; |
| }; |
| |
| struct addBaReq_parm { |
| unsigned int tid; |
| }; |
| |
| /*H2C Handler index: 46 */ |
| struct SetChannel_parm { |
| u32 curr_ch; |
| }; |
| |
| /*H2C Handler index: 56 */ |
| struct PT_param { |
| u8 PT_En; |
| }; |
| |
| #define GEN_CMD_CODE(cmd) cmd ## _CMD_ |
| |
| /* |
| * 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_RSP_OFFSET 512 |
| #define H2C_SUCCESS 0x00 |
| #define H2C_SUCCESS_RSP 0x01 |
| #define H2C_DUPLICATED 0x02 |
| #define H2C_DROPPED 0x03 |
| #define H2C_PARAMETERS_ERROR 0x04 |
| #define H2C_REJECTED 0x05 |
| #define H2C_CMD_OVERFLOW 0x06 |
| #define H2C_RESERVED 0x07 |
| |
| u8 r8712_setMacAddr_cmd(struct _adapter *padapter, u8 *mac_addr); |
| u8 r8712_setassocsta_cmd(struct _adapter *padapter, u8 *mac_addr); |
| u8 r8712_sitesurvey_cmd(struct _adapter *padapter, |
| struct ndis_802_11_ssid *pssid); |
| u8 r8712_createbss_cmd(struct _adapter *padapter); |
| u8 r8712_setstakey_cmd(struct _adapter *padapter, u8 *psta, u8 unicast_key); |
| u8 r8712_joinbss_cmd(struct _adapter *padapter, |
| struct wlan_network *pnetwork); |
| u8 r8712_disassoc_cmd(struct _adapter *padapter); |
| u8 r8712_setopmode_cmd(struct _adapter *padapter, |
| enum NDIS_802_11_NETWORK_INFRASTRUCTURE networktype); |
| u8 r8712_setdatarate_cmd(struct _adapter *padapter, u8 *rateset); |
| u8 r8712_setbasicrate_cmd(struct _adapter *padapter, u8 *rateset); |
| u8 r8712_getrfreg_cmd(struct _adapter *padapter, u8 offset, u8 * pval); |
| u8 r8712_setrfintfs_cmd(struct _adapter *padapter, u8 mode); |
| u8 r8712_setrfreg_cmd(struct _adapter *padapter, u8 offset, u32 val); |
| u8 r8712_setrttbl_cmd(struct _adapter *padapter, |
| struct setratable_parm *prate_table); |
| u8 r8712_setptm_cmd(struct _adapter *padapter, u8 type); |
| u8 r8712_addbareq_cmd(struct _adapter *padapter, u8 tid); |
| u8 r8712_wdg_wk_cmd(struct _adapter *padapter); |
| void r8712_survey_cmd_callback(struct _adapter *padapter, |
| struct cmd_obj *pcmd); |
| void r8712_disassoc_cmd_callback(struct _adapter *padapter, |
| struct cmd_obj *pcmd); |
| void r8712_joinbss_cmd_callback(struct _adapter *padapter, |
| struct cmd_obj *pcmd); |
| void r8712_createbss_cmd_callback(struct _adapter *padapter, |
| struct cmd_obj *pcmd); |
| void r8712_getbbrfreg_cmdrsp_callback(struct _adapter *padapter, |
| struct cmd_obj *pcmd); |
| void r8712_setstaKey_cmdrsp_callback(struct _adapter *padapter, |
| struct cmd_obj *pcmd); |
| void r8712_setassocsta_cmdrsp_callback(struct _adapter *padapter, |
| struct cmd_obj *pcmd); |
| |
| struct _cmd_callback { |
| u32 cmd_code; |
| void (*callback)(struct _adapter *padapter, struct cmd_obj *cmd); |
| }; |
| |
| #include "rtl8712_cmd.h" |
| |
| #endif /* _CMD_H_ */ |
| |