xref: /OK3568_Linux_fs/kernel/drivers/net/wireless/marvell/mwifiex/decl.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun  * NXP Wireless LAN device driver: generic data structures and APIs
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * Copyright 2011-2020 NXP
5*4882a593Smuzhiyun  *
6*4882a593Smuzhiyun  * This software file (the "File") is distributed by NXP
7*4882a593Smuzhiyun  * under the terms of the GNU General Public License Version 2, June 1991
8*4882a593Smuzhiyun  * (the "License").  You may use, redistribute and/or modify this File in
9*4882a593Smuzhiyun  * accordance with the terms and conditions of the License, a copy of which
10*4882a593Smuzhiyun  * is available by writing to the Free Software Foundation, Inc.,
11*4882a593Smuzhiyun  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or on the
12*4882a593Smuzhiyun  * worldwide web at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.
13*4882a593Smuzhiyun  *
14*4882a593Smuzhiyun  * THE FILE IS DISTRIBUTED AS-IS, WITHOUT WARRANTY OF ANY KIND, AND THE
15*4882a593Smuzhiyun  * IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
16*4882a593Smuzhiyun  * ARE EXPRESSLY DISCLAIMED.  The License provides additional details about
17*4882a593Smuzhiyun  * this warranty disclaimer.
18*4882a593Smuzhiyun  */
19*4882a593Smuzhiyun 
20*4882a593Smuzhiyun #ifndef _MWIFIEX_DECL_H_
21*4882a593Smuzhiyun #define _MWIFIEX_DECL_H_
22*4882a593Smuzhiyun 
23*4882a593Smuzhiyun #undef pr_fmt
24*4882a593Smuzhiyun #define pr_fmt(fmt)	KBUILD_MODNAME ": " fmt
25*4882a593Smuzhiyun 
26*4882a593Smuzhiyun #include <linux/wait.h>
27*4882a593Smuzhiyun #include <linux/timer.h>
28*4882a593Smuzhiyun #include <linux/ieee80211.h>
29*4882a593Smuzhiyun #include <uapi/linux/if_arp.h>
30*4882a593Smuzhiyun #include <net/cfg80211.h>
31*4882a593Smuzhiyun 
32*4882a593Smuzhiyun #define MWIFIEX_BSS_COEX_COUNT	     2
33*4882a593Smuzhiyun #define MWIFIEX_MAX_BSS_NUM         (3)
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun #define MWIFIEX_DMA_ALIGN_SZ	    64
36*4882a593Smuzhiyun #define MWIFIEX_RX_HEADROOM	    64
37*4882a593Smuzhiyun #define MAX_TXPD_SZ		    32
38*4882a593Smuzhiyun #define INTF_HDR_ALIGN		     4
39*4882a593Smuzhiyun 
40*4882a593Smuzhiyun #define MWIFIEX_MIN_DATA_HEADER_LEN (MWIFIEX_DMA_ALIGN_SZ + INTF_HDR_ALIGN + \
41*4882a593Smuzhiyun 				     MAX_TXPD_SZ)
42*4882a593Smuzhiyun #define MWIFIEX_MGMT_FRAME_HEADER_SIZE	8	/* sizeof(pkt_type)
43*4882a593Smuzhiyun 						 *   + sizeof(tx_control)
44*4882a593Smuzhiyun 						 */
45*4882a593Smuzhiyun 
46*4882a593Smuzhiyun #define MWIFIEX_MAX_TX_BASTREAM_SUPPORTED	2
47*4882a593Smuzhiyun #define MWIFIEX_MAX_RX_BASTREAM_SUPPORTED	16
48*4882a593Smuzhiyun #define MWIFIEX_MAX_TDLS_PEER_SUPPORTED 8
49*4882a593Smuzhiyun 
50*4882a593Smuzhiyun #define MWIFIEX_STA_AMPDU_DEF_TXWINSIZE        64
51*4882a593Smuzhiyun #define MWIFIEX_STA_AMPDU_DEF_RXWINSIZE        64
52*4882a593Smuzhiyun #define MWIFIEX_STA_COEX_AMPDU_DEF_RXWINSIZE   16
53*4882a593Smuzhiyun 
54*4882a593Smuzhiyun #define MWIFIEX_UAP_AMPDU_DEF_TXWINSIZE        32
55*4882a593Smuzhiyun 
56*4882a593Smuzhiyun #define MWIFIEX_UAP_COEX_AMPDU_DEF_RXWINSIZE   16
57*4882a593Smuzhiyun 
58*4882a593Smuzhiyun #define MWIFIEX_UAP_AMPDU_DEF_RXWINSIZE        16
59*4882a593Smuzhiyun #define MWIFIEX_11AC_STA_AMPDU_DEF_TXWINSIZE   64
60*4882a593Smuzhiyun #define MWIFIEX_11AC_STA_AMPDU_DEF_RXWINSIZE   64
61*4882a593Smuzhiyun #define MWIFIEX_11AC_UAP_AMPDU_DEF_TXWINSIZE   64
62*4882a593Smuzhiyun #define MWIFIEX_11AC_UAP_AMPDU_DEF_RXWINSIZE   64
63*4882a593Smuzhiyun 
64*4882a593Smuzhiyun #define MWIFIEX_DEFAULT_BLOCK_ACK_TIMEOUT  0xffff
65*4882a593Smuzhiyun 
66*4882a593Smuzhiyun #define MWIFIEX_RATE_BITMAP_MCS0   32
67*4882a593Smuzhiyun 
68*4882a593Smuzhiyun #define MWIFIEX_RX_DATA_BUF_SIZE     (4 * 1024)
69*4882a593Smuzhiyun #define MWIFIEX_RX_CMD_BUF_SIZE	     (2 * 1024)
70*4882a593Smuzhiyun 
71*4882a593Smuzhiyun #define MAX_BEACON_PERIOD                  (4000)
72*4882a593Smuzhiyun #define MIN_BEACON_PERIOD                  (50)
73*4882a593Smuzhiyun #define MAX_DTIM_PERIOD                    (100)
74*4882a593Smuzhiyun #define MIN_DTIM_PERIOD                    (1)
75*4882a593Smuzhiyun 
76*4882a593Smuzhiyun #define MWIFIEX_RTS_MIN_VALUE              (0)
77*4882a593Smuzhiyun #define MWIFIEX_RTS_MAX_VALUE              (2347)
78*4882a593Smuzhiyun #define MWIFIEX_FRAG_MIN_VALUE             (256)
79*4882a593Smuzhiyun #define MWIFIEX_FRAG_MAX_VALUE             (2346)
80*4882a593Smuzhiyun #define MWIFIEX_WMM_VERSION                0x01
81*4882a593Smuzhiyun #define MWIFIEX_WMM_SUBTYPE                0x01
82*4882a593Smuzhiyun 
83*4882a593Smuzhiyun #define MWIFIEX_RETRY_LIMIT                14
84*4882a593Smuzhiyun #define MWIFIEX_SDIO_BLOCK_SIZE            256
85*4882a593Smuzhiyun 
86*4882a593Smuzhiyun #define MWIFIEX_BUF_FLAG_REQUEUED_PKT      BIT(0)
87*4882a593Smuzhiyun #define MWIFIEX_BUF_FLAG_BRIDGED_PKT	   BIT(1)
88*4882a593Smuzhiyun #define MWIFIEX_BUF_FLAG_TDLS_PKT	   BIT(2)
89*4882a593Smuzhiyun #define MWIFIEX_BUF_FLAG_EAPOL_TX_STATUS   BIT(3)
90*4882a593Smuzhiyun #define MWIFIEX_BUF_FLAG_ACTION_TX_STATUS  BIT(4)
91*4882a593Smuzhiyun #define MWIFIEX_BUF_FLAG_AGGR_PKT          BIT(5)
92*4882a593Smuzhiyun 
93*4882a593Smuzhiyun #define MWIFIEX_BRIDGED_PKTS_THR_HIGH      1024
94*4882a593Smuzhiyun #define MWIFIEX_BRIDGED_PKTS_THR_LOW        128
95*4882a593Smuzhiyun 
96*4882a593Smuzhiyun #define MWIFIEX_TDLS_DISABLE_LINK             0x00
97*4882a593Smuzhiyun #define MWIFIEX_TDLS_ENABLE_LINK              0x01
98*4882a593Smuzhiyun #define MWIFIEX_TDLS_CREATE_LINK              0x02
99*4882a593Smuzhiyun #define MWIFIEX_TDLS_CONFIG_LINK              0x03
100*4882a593Smuzhiyun 
101*4882a593Smuzhiyun #define MWIFIEX_TDLS_RSSI_HIGH		50
102*4882a593Smuzhiyun #define MWIFIEX_TDLS_RSSI_LOW		55
103*4882a593Smuzhiyun #define MWIFIEX_TDLS_MAX_FAIL_COUNT      4
104*4882a593Smuzhiyun #define MWIFIEX_AUTO_TDLS_IDLE_TIME     10
105*4882a593Smuzhiyun 
106*4882a593Smuzhiyun /* 54M rates, index from 0 to 11 */
107*4882a593Smuzhiyun #define MWIFIEX_RATE_INDEX_MCS0 12
108*4882a593Smuzhiyun /* 12-27=MCS0-15(BW20) */
109*4882a593Smuzhiyun #define MWIFIEX_BW20_MCS_NUM 15
110*4882a593Smuzhiyun 
111*4882a593Smuzhiyun /* Rate index for OFDM 0 */
112*4882a593Smuzhiyun #define MWIFIEX_RATE_INDEX_OFDM0   4
113*4882a593Smuzhiyun 
114*4882a593Smuzhiyun #define MWIFIEX_MAX_STA_NUM		3
115*4882a593Smuzhiyun #define MWIFIEX_MAX_UAP_NUM		3
116*4882a593Smuzhiyun #define MWIFIEX_MAX_P2P_NUM		3
117*4882a593Smuzhiyun 
118*4882a593Smuzhiyun #define MWIFIEX_A_BAND_START_FREQ	5000
119*4882a593Smuzhiyun 
120*4882a593Smuzhiyun /* SDIO Aggr data packet special info */
121*4882a593Smuzhiyun #define SDIO_MAX_AGGR_BUF_SIZE		(256 * 255)
122*4882a593Smuzhiyun #define BLOCK_NUMBER_OFFSET		15
123*4882a593Smuzhiyun #define SDIO_HEADER_OFFSET		28
124*4882a593Smuzhiyun 
125*4882a593Smuzhiyun #define MWIFIEX_SIZE_4K 0x4000
126*4882a593Smuzhiyun 
127*4882a593Smuzhiyun enum mwifiex_bss_type {
128*4882a593Smuzhiyun 	MWIFIEX_BSS_TYPE_STA = 0,
129*4882a593Smuzhiyun 	MWIFIEX_BSS_TYPE_UAP = 1,
130*4882a593Smuzhiyun 	MWIFIEX_BSS_TYPE_P2P = 2,
131*4882a593Smuzhiyun 	MWIFIEX_BSS_TYPE_ANY = 0xff,
132*4882a593Smuzhiyun };
133*4882a593Smuzhiyun 
134*4882a593Smuzhiyun enum mwifiex_bss_role {
135*4882a593Smuzhiyun 	MWIFIEX_BSS_ROLE_STA = 0,
136*4882a593Smuzhiyun 	MWIFIEX_BSS_ROLE_UAP = 1,
137*4882a593Smuzhiyun 	MWIFIEX_BSS_ROLE_ANY = 0xff,
138*4882a593Smuzhiyun };
139*4882a593Smuzhiyun 
140*4882a593Smuzhiyun enum mwifiex_tdls_status {
141*4882a593Smuzhiyun 	TDLS_NOT_SETUP = 0,
142*4882a593Smuzhiyun 	TDLS_SETUP_INPROGRESS,
143*4882a593Smuzhiyun 	TDLS_SETUP_COMPLETE,
144*4882a593Smuzhiyun 	TDLS_SETUP_FAILURE,
145*4882a593Smuzhiyun 	TDLS_LINK_TEARDOWN,
146*4882a593Smuzhiyun 	TDLS_CHAN_SWITCHING,
147*4882a593Smuzhiyun 	TDLS_IN_BASE_CHAN,
148*4882a593Smuzhiyun 	TDLS_IN_OFF_CHAN,
149*4882a593Smuzhiyun };
150*4882a593Smuzhiyun 
151*4882a593Smuzhiyun enum mwifiex_tdls_error_code {
152*4882a593Smuzhiyun 	TDLS_ERR_NO_ERROR = 0,
153*4882a593Smuzhiyun 	TDLS_ERR_INTERNAL_ERROR,
154*4882a593Smuzhiyun 	TDLS_ERR_MAX_LINKS_EST,
155*4882a593Smuzhiyun 	TDLS_ERR_LINK_EXISTS,
156*4882a593Smuzhiyun 	TDLS_ERR_LINK_NONEXISTENT,
157*4882a593Smuzhiyun 	TDLS_ERR_PEER_STA_UNREACHABLE = 25,
158*4882a593Smuzhiyun };
159*4882a593Smuzhiyun 
160*4882a593Smuzhiyun #define BSS_ROLE_BIT_MASK    BIT(0)
161*4882a593Smuzhiyun 
162*4882a593Smuzhiyun #define GET_BSS_ROLE(priv)   ((priv)->bss_role & BSS_ROLE_BIT_MASK)
163*4882a593Smuzhiyun 
164*4882a593Smuzhiyun enum mwifiex_data_frame_type {
165*4882a593Smuzhiyun 	MWIFIEX_DATA_FRAME_TYPE_ETH_II = 0,
166*4882a593Smuzhiyun 	MWIFIEX_DATA_FRAME_TYPE_802_11,
167*4882a593Smuzhiyun };
168*4882a593Smuzhiyun 
169*4882a593Smuzhiyun struct mwifiex_fw_image {
170*4882a593Smuzhiyun 	u8 *helper_buf;
171*4882a593Smuzhiyun 	u32 helper_len;
172*4882a593Smuzhiyun 	u8 *fw_buf;
173*4882a593Smuzhiyun 	u32 fw_len;
174*4882a593Smuzhiyun };
175*4882a593Smuzhiyun 
176*4882a593Smuzhiyun struct mwifiex_802_11_ssid {
177*4882a593Smuzhiyun 	u32 ssid_len;
178*4882a593Smuzhiyun 	u8 ssid[IEEE80211_MAX_SSID_LEN];
179*4882a593Smuzhiyun };
180*4882a593Smuzhiyun 
181*4882a593Smuzhiyun struct mwifiex_wait_queue {
182*4882a593Smuzhiyun 	wait_queue_head_t wait;
183*4882a593Smuzhiyun 	int status;
184*4882a593Smuzhiyun };
185*4882a593Smuzhiyun 
186*4882a593Smuzhiyun struct mwifiex_rxinfo {
187*4882a593Smuzhiyun 	struct sk_buff *parent;
188*4882a593Smuzhiyun 	u8 bss_num;
189*4882a593Smuzhiyun 	u8 bss_type;
190*4882a593Smuzhiyun 	u8 use_count;
191*4882a593Smuzhiyun 	u8 buf_type;
192*4882a593Smuzhiyun };
193*4882a593Smuzhiyun 
194*4882a593Smuzhiyun struct mwifiex_txinfo {
195*4882a593Smuzhiyun 	u32 status_code;
196*4882a593Smuzhiyun 	u8 flags;
197*4882a593Smuzhiyun 	u8 bss_num;
198*4882a593Smuzhiyun 	u8 bss_type;
199*4882a593Smuzhiyun 	u8 aggr_num;
200*4882a593Smuzhiyun 	u32 pkt_len;
201*4882a593Smuzhiyun 	u8 ack_frame_id;
202*4882a593Smuzhiyun 	u64 cookie;
203*4882a593Smuzhiyun };
204*4882a593Smuzhiyun 
205*4882a593Smuzhiyun enum mwifiex_wmm_ac_e {
206*4882a593Smuzhiyun 	WMM_AC_BK,
207*4882a593Smuzhiyun 	WMM_AC_BE,
208*4882a593Smuzhiyun 	WMM_AC_VI,
209*4882a593Smuzhiyun 	WMM_AC_VO
210*4882a593Smuzhiyun } __packed;
211*4882a593Smuzhiyun 
212*4882a593Smuzhiyun struct ieee_types_wmm_ac_parameters {
213*4882a593Smuzhiyun 	u8 aci_aifsn_bitmap;
214*4882a593Smuzhiyun 	u8 ecw_bitmap;
215*4882a593Smuzhiyun 	__le16 tx_op_limit;
216*4882a593Smuzhiyun } __packed;
217*4882a593Smuzhiyun 
218*4882a593Smuzhiyun struct mwifiex_types_wmm_info {
219*4882a593Smuzhiyun 	u8 oui[4];
220*4882a593Smuzhiyun 	u8 subtype;
221*4882a593Smuzhiyun 	u8 version;
222*4882a593Smuzhiyun 	u8 qos_info;
223*4882a593Smuzhiyun 	u8 reserved;
224*4882a593Smuzhiyun 	struct ieee_types_wmm_ac_parameters ac_params[IEEE80211_NUM_ACS];
225*4882a593Smuzhiyun } __packed;
226*4882a593Smuzhiyun 
227*4882a593Smuzhiyun struct mwifiex_arp_eth_header {
228*4882a593Smuzhiyun 	struct arphdr hdr;
229*4882a593Smuzhiyun 	u8 ar_sha[ETH_ALEN];
230*4882a593Smuzhiyun 	u8 ar_sip[4];
231*4882a593Smuzhiyun 	u8 ar_tha[ETH_ALEN];
232*4882a593Smuzhiyun 	u8 ar_tip[4];
233*4882a593Smuzhiyun } __packed;
234*4882a593Smuzhiyun 
235*4882a593Smuzhiyun struct mwifiex_chan_stats {
236*4882a593Smuzhiyun 	u8 chan_num;
237*4882a593Smuzhiyun 	u8 bandcfg;
238*4882a593Smuzhiyun 	u8 flags;
239*4882a593Smuzhiyun 	s8 noise;
240*4882a593Smuzhiyun 	u16 total_bss;
241*4882a593Smuzhiyun 	u16 cca_scan_dur;
242*4882a593Smuzhiyun 	u16 cca_busy_dur;
243*4882a593Smuzhiyun } __packed;
244*4882a593Smuzhiyun 
245*4882a593Smuzhiyun #define MWIFIEX_HIST_MAX_SAMPLES	1048576
246*4882a593Smuzhiyun #define MWIFIEX_MAX_RX_RATES		     44
247*4882a593Smuzhiyun #define MWIFIEX_MAX_AC_RX_RATES		     74
248*4882a593Smuzhiyun #define MWIFIEX_MAX_SNR			    256
249*4882a593Smuzhiyun #define MWIFIEX_MAX_NOISE_FLR		    256
250*4882a593Smuzhiyun #define MWIFIEX_MAX_SIG_STRENGTH	    256
251*4882a593Smuzhiyun 
252*4882a593Smuzhiyun struct mwifiex_histogram_data {
253*4882a593Smuzhiyun 	atomic_t rx_rate[MWIFIEX_MAX_AC_RX_RATES];
254*4882a593Smuzhiyun 	atomic_t snr[MWIFIEX_MAX_SNR];
255*4882a593Smuzhiyun 	atomic_t noise_flr[MWIFIEX_MAX_NOISE_FLR];
256*4882a593Smuzhiyun 	atomic_t sig_str[MWIFIEX_MAX_SIG_STRENGTH];
257*4882a593Smuzhiyun 	atomic_t num_samples;
258*4882a593Smuzhiyun };
259*4882a593Smuzhiyun 
260*4882a593Smuzhiyun struct mwifiex_iface_comb {
261*4882a593Smuzhiyun 	u8 sta_intf;
262*4882a593Smuzhiyun 	u8 uap_intf;
263*4882a593Smuzhiyun 	u8 p2p_intf;
264*4882a593Smuzhiyun };
265*4882a593Smuzhiyun 
266*4882a593Smuzhiyun struct mwifiex_radar_params {
267*4882a593Smuzhiyun 	struct cfg80211_chan_def *chandef;
268*4882a593Smuzhiyun 	u32 cac_time_ms;
269*4882a593Smuzhiyun } __packed;
270*4882a593Smuzhiyun 
271*4882a593Smuzhiyun struct mwifiex_11h_intf_state {
272*4882a593Smuzhiyun 	bool is_11h_enabled;
273*4882a593Smuzhiyun 	bool is_11h_active;
274*4882a593Smuzhiyun } __packed;
275*4882a593Smuzhiyun 
276*4882a593Smuzhiyun #define MWIFIEX_FW_DUMP_IDX		0xff
277*4882a593Smuzhiyun #define MWIFIEX_FW_DUMP_MAX_MEMSIZE     0x160000
278*4882a593Smuzhiyun #define MWIFIEX_DRV_INFO_IDX		20
279*4882a593Smuzhiyun #define FW_DUMP_MAX_NAME_LEN		8
280*4882a593Smuzhiyun #define FW_DUMP_HOST_READY      0xEE
281*4882a593Smuzhiyun #define FW_DUMP_DONE			0xFF
282*4882a593Smuzhiyun #define FW_DUMP_READ_DONE		0xFE
283*4882a593Smuzhiyun 
284*4882a593Smuzhiyun struct memory_type_mapping {
285*4882a593Smuzhiyun 	u8 mem_name[FW_DUMP_MAX_NAME_LEN];
286*4882a593Smuzhiyun 	u8 *mem_ptr;
287*4882a593Smuzhiyun 	u32 mem_size;
288*4882a593Smuzhiyun 	u8 done_flag;
289*4882a593Smuzhiyun };
290*4882a593Smuzhiyun 
291*4882a593Smuzhiyun enum rdwr_status {
292*4882a593Smuzhiyun 	RDWR_STATUS_SUCCESS = 0,
293*4882a593Smuzhiyun 	RDWR_STATUS_FAILURE = 1,
294*4882a593Smuzhiyun 	RDWR_STATUS_DONE = 2
295*4882a593Smuzhiyun };
296*4882a593Smuzhiyun 
297*4882a593Smuzhiyun enum mwifiex_chan_width {
298*4882a593Smuzhiyun 	CHAN_BW_20MHZ = 0,
299*4882a593Smuzhiyun 	CHAN_BW_10MHZ,
300*4882a593Smuzhiyun 	CHAN_BW_40MHZ,
301*4882a593Smuzhiyun 	CHAN_BW_80MHZ,
302*4882a593Smuzhiyun 	CHAN_BW_8080MHZ,
303*4882a593Smuzhiyun 	CHAN_BW_160MHZ,
304*4882a593Smuzhiyun 	CHAN_BW_5MHZ,
305*4882a593Smuzhiyun };
306*4882a593Smuzhiyun 
307*4882a593Smuzhiyun enum mwifiex_chan_offset {
308*4882a593Smuzhiyun 	SEC_CHAN_NONE = 0,
309*4882a593Smuzhiyun 	SEC_CHAN_ABOVE = 1,
310*4882a593Smuzhiyun 	SEC_CHAN_5MHZ = 2,
311*4882a593Smuzhiyun 	SEC_CHAN_BELOW = 3
312*4882a593Smuzhiyun };
313*4882a593Smuzhiyun 
314*4882a593Smuzhiyun #endif /* !_MWIFIEX_DECL_H_ */
315