cregit-Linux how code gets into the kernel

Release 4.7 drivers/staging/rtl8188eu/include/rtw_cmd.h

/******************************************************************************
 *
 * Copyright(c) 2007 - 2011 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.
 *
 ******************************************************************************/
#ifndef __RTW_CMD_H_

#define __RTW_CMD_H_

#include <wlan_bssdef.h>
#include <rtw_rf.h>
#include <rtw_led.h>

#include <osdep_service.h>
#include <ieee80211.h> /*  <ieee80211/ieee80211.h> */


#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 semaphore cmd_queue_sema;
	
struct semaphore terminate_cmdthread_sema;
	
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];
};

/*
        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];
};

/*
        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 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;
};


#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_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 CONFIG_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 {
	
GEN_CMD_CODE(_JoinBss),
	
GEN_CMD_CODE(_DisConnect),
	
GEN_CMD_CODE(_CreateBss),
	
GEN_CMD_CODE(_SetOpMode),
	
GEN_CMD_CODE(_SiteSurvey),
	
GEN_CMD_CODE(_SetAuth),
	
GEN_CMD_CODE(_SetKey),
	
GEN_CMD_CODE(_SetStaKey),
	
GEN_CMD_CODE(_SetAssocSta),
	
GEN_CMD_CODE(_AddBAReq),
	
GEN_CMD_CODE(_SetChannel),
	
GEN_CMD_CODE(_TX_Beacon),
	
GEN_CMD_CODE(_Set_MLME_EVT),
	
GEN_CMD_CODE(_Set_Drv_Extra),
	
GEN_CMD_CODE(_SetChannelPlan),

	
MAX_H2CCMD
};

#ifdef _RTW_CMD_C_

static struct _cmd_callback	rtw_cmd_callback[] = {
	{GEN_CMD_CODE(_JoinBss), &rtw_joinbss_cmd_callback},
	{GEN_CMD_CODE(_DisConnect), &rtw_disassoc_cmd_callback},
	{GEN_CMD_CODE(_CreateBss), &rtw_createbss_cmd_callback},
	{GEN_CMD_CODE(_SetOpMode), NULL},
	{GEN_CMD_CODE(_SiteSurvey), &rtw_survey_cmd_callback},
	{GEN_CMD_CODE(_SetAuth), NULL},
	{GEN_CMD_CODE(_SetKey), NULL},
	{GEN_CMD_CODE(_SetStaKey), &rtw_setstaKey_cmdrsp_callback},
	{GEN_CMD_CODE(_SetAssocSta), &rtw_setassocsta_cmdrsp_callback},
	{GEN_CMD_CODE(_AddBAReq), NULL},
	{GEN_CMD_CODE(_SetChannel), NULL},
	{GEN_CMD_CODE(_TX_Beacon), NULL},
	{GEN_CMD_CODE(_Set_MLME_EVT), NULL},
	{GEN_CMD_CODE(_Set_Drv_Extra), NULL},
	{GEN_CMD_CODE(_SetChannelPlan), NULL},
};
#endif

#endif /*  _CMD_H_ */

Overall Contributors

PersonTokensPropCommitsCommitProp
larry fingerlarry finger109697.08%114.29%
navin patidarnavin patidar312.75%457.14%
masanari iidamasanari iida10.09%114.29%
kyle kuffermannkyle kuffermann10.09%114.29%
Total1129100.00%7100.00%
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
{% endraw %}