xref: /linux-6.15/include/linux/ieee80211.h (revision e11da5b4)
1 /*
2  * IEEE 802.11 defines
3  *
4  * Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen
5  * <[email protected]>
6  * Copyright (c) 2002-2003, Jouni Malinen <[email protected]>
7  * Copyright (c) 2005, Devicescape Software, Inc.
8  * Copyright (c) 2006, Michael Wu <[email protected]>
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License version 2 as
12  * published by the Free Software Foundation.
13  */
14 
15 #ifndef LINUX_IEEE80211_H
16 #define LINUX_IEEE80211_H
17 
18 #include <linux/types.h>
19 #include <asm/byteorder.h>
20 
21 /*
22  * DS bit usage
23  *
24  * TA = transmitter address
25  * RA = receiver address
26  * DA = destination address
27  * SA = source address
28  *
29  * ToDS    FromDS  A1(RA)  A2(TA)  A3      A4      Use
30  * -----------------------------------------------------------------
31  *  0       0       DA      SA      BSSID   -       IBSS/DLS
32  *  0       1       DA      BSSID   SA      -       AP -> STA
33  *  1       0       BSSID   SA      DA      -       AP <- STA
34  *  1       1       RA      TA      DA      SA      unspecified (WDS)
35  */
36 
37 #define FCS_LEN 4
38 
39 #define IEEE80211_FCTL_VERS		0x0003
40 #define IEEE80211_FCTL_FTYPE		0x000c
41 #define IEEE80211_FCTL_STYPE		0x00f0
42 #define IEEE80211_FCTL_TODS		0x0100
43 #define IEEE80211_FCTL_FROMDS		0x0200
44 #define IEEE80211_FCTL_MOREFRAGS	0x0400
45 #define IEEE80211_FCTL_RETRY		0x0800
46 #define IEEE80211_FCTL_PM		0x1000
47 #define IEEE80211_FCTL_MOREDATA		0x2000
48 #define IEEE80211_FCTL_PROTECTED	0x4000
49 #define IEEE80211_FCTL_ORDER		0x8000
50 
51 #define IEEE80211_SCTL_FRAG		0x000F
52 #define IEEE80211_SCTL_SEQ		0xFFF0
53 
54 #define IEEE80211_FTYPE_MGMT		0x0000
55 #define IEEE80211_FTYPE_CTL		0x0004
56 #define IEEE80211_FTYPE_DATA		0x0008
57 
58 /* management */
59 #define IEEE80211_STYPE_ASSOC_REQ	0x0000
60 #define IEEE80211_STYPE_ASSOC_RESP	0x0010
61 #define IEEE80211_STYPE_REASSOC_REQ	0x0020
62 #define IEEE80211_STYPE_REASSOC_RESP	0x0030
63 #define IEEE80211_STYPE_PROBE_REQ	0x0040
64 #define IEEE80211_STYPE_PROBE_RESP	0x0050
65 #define IEEE80211_STYPE_BEACON		0x0080
66 #define IEEE80211_STYPE_ATIM		0x0090
67 #define IEEE80211_STYPE_DISASSOC	0x00A0
68 #define IEEE80211_STYPE_AUTH		0x00B0
69 #define IEEE80211_STYPE_DEAUTH		0x00C0
70 #define IEEE80211_STYPE_ACTION		0x00D0
71 
72 /* control */
73 #define IEEE80211_STYPE_BACK_REQ	0x0080
74 #define IEEE80211_STYPE_BACK		0x0090
75 #define IEEE80211_STYPE_PSPOLL		0x00A0
76 #define IEEE80211_STYPE_RTS		0x00B0
77 #define IEEE80211_STYPE_CTS		0x00C0
78 #define IEEE80211_STYPE_ACK		0x00D0
79 #define IEEE80211_STYPE_CFEND		0x00E0
80 #define IEEE80211_STYPE_CFENDACK	0x00F0
81 
82 /* data */
83 #define IEEE80211_STYPE_DATA			0x0000
84 #define IEEE80211_STYPE_DATA_CFACK		0x0010
85 #define IEEE80211_STYPE_DATA_CFPOLL		0x0020
86 #define IEEE80211_STYPE_DATA_CFACKPOLL		0x0030
87 #define IEEE80211_STYPE_NULLFUNC		0x0040
88 #define IEEE80211_STYPE_CFACK			0x0050
89 #define IEEE80211_STYPE_CFPOLL			0x0060
90 #define IEEE80211_STYPE_CFACKPOLL		0x0070
91 #define IEEE80211_STYPE_QOS_DATA		0x0080
92 #define IEEE80211_STYPE_QOS_DATA_CFACK		0x0090
93 #define IEEE80211_STYPE_QOS_DATA_CFPOLL		0x00A0
94 #define IEEE80211_STYPE_QOS_DATA_CFACKPOLL	0x00B0
95 #define IEEE80211_STYPE_QOS_NULLFUNC		0x00C0
96 #define IEEE80211_STYPE_QOS_CFACK		0x00D0
97 #define IEEE80211_STYPE_QOS_CFPOLL		0x00E0
98 #define IEEE80211_STYPE_QOS_CFACKPOLL		0x00F0
99 
100 
101 /* miscellaneous IEEE 802.11 constants */
102 #define IEEE80211_MAX_FRAG_THRESHOLD	2352
103 #define IEEE80211_MAX_RTS_THRESHOLD	2353
104 #define IEEE80211_MAX_AID		2007
105 #define IEEE80211_MAX_TIM_LEN		251
106 /* Maximum size for the MA-UNITDATA primitive, 802.11 standard section
107    6.2.1.1.2.
108 
109    802.11e clarifies the figure in section 7.1.2. The frame body is
110    up to 2304 octets long (maximum MSDU size) plus any crypt overhead. */
111 #define IEEE80211_MAX_DATA_LEN		2304
112 /* 30 byte 4 addr hdr, 2 byte QoS, 2304 byte MSDU, 12 byte crypt, 4 byte FCS */
113 #define IEEE80211_MAX_FRAME_LEN		2352
114 
115 #define IEEE80211_MAX_SSID_LEN		32
116 
117 #define IEEE80211_MAX_MESH_ID_LEN	32
118 
119 #define IEEE80211_QOS_CTL_LEN		2
120 #define IEEE80211_QOS_CTL_TID_MASK	0x000F
121 #define IEEE80211_QOS_CTL_TAG1D_MASK	0x0007
122 
123 /* U-APSD queue for WMM IEs sent by AP */
124 #define IEEE80211_WMM_IE_AP_QOSINFO_UAPSD	(1<<7)
125 
126 /* U-APSD queues for WMM IEs sent by STA */
127 #define IEEE80211_WMM_IE_STA_QOSINFO_AC_VO	(1<<0)
128 #define IEEE80211_WMM_IE_STA_QOSINFO_AC_VI	(1<<1)
129 #define IEEE80211_WMM_IE_STA_QOSINFO_AC_BK	(1<<2)
130 #define IEEE80211_WMM_IE_STA_QOSINFO_AC_BE	(1<<3)
131 #define IEEE80211_WMM_IE_STA_QOSINFO_AC_MASK	0x0f
132 
133 /* U-APSD max SP length for WMM IEs sent by STA */
134 #define IEEE80211_WMM_IE_STA_QOSINFO_SP_ALL	0x00
135 #define IEEE80211_WMM_IE_STA_QOSINFO_SP_2	0x01
136 #define IEEE80211_WMM_IE_STA_QOSINFO_SP_4	0x02
137 #define IEEE80211_WMM_IE_STA_QOSINFO_SP_6	0x03
138 #define IEEE80211_WMM_IE_STA_QOSINFO_SP_MASK	0x03
139 #define IEEE80211_WMM_IE_STA_QOSINFO_SP_SHIFT	5
140 
141 #define IEEE80211_HT_CTL_LEN		4
142 
143 struct ieee80211_hdr {
144 	__le16 frame_control;
145 	__le16 duration_id;
146 	u8 addr1[6];
147 	u8 addr2[6];
148 	u8 addr3[6];
149 	__le16 seq_ctrl;
150 	u8 addr4[6];
151 } __attribute__ ((packed));
152 
153 struct ieee80211_hdr_3addr {
154 	__le16 frame_control;
155 	__le16 duration_id;
156 	u8 addr1[6];
157 	u8 addr2[6];
158 	u8 addr3[6];
159 	__le16 seq_ctrl;
160 } __attribute__ ((packed));
161 
162 struct ieee80211_qos_hdr {
163 	__le16 frame_control;
164 	__le16 duration_id;
165 	u8 addr1[6];
166 	u8 addr2[6];
167 	u8 addr3[6];
168 	__le16 seq_ctrl;
169 	__le16 qos_ctrl;
170 } __attribute__ ((packed));
171 
172 /**
173  * ieee80211_has_tods - check if IEEE80211_FCTL_TODS is set
174  * @fc: frame control bytes in little-endian byteorder
175  */
176 static inline int ieee80211_has_tods(__le16 fc)
177 {
178 	return (fc & cpu_to_le16(IEEE80211_FCTL_TODS)) != 0;
179 }
180 
181 /**
182  * ieee80211_has_fromds - check if IEEE80211_FCTL_FROMDS is set
183  * @fc: frame control bytes in little-endian byteorder
184  */
185 static inline int ieee80211_has_fromds(__le16 fc)
186 {
187 	return (fc & cpu_to_le16(IEEE80211_FCTL_FROMDS)) != 0;
188 }
189 
190 /**
191  * ieee80211_has_a4 - check if IEEE80211_FCTL_TODS and IEEE80211_FCTL_FROMDS are set
192  * @fc: frame control bytes in little-endian byteorder
193  */
194 static inline int ieee80211_has_a4(__le16 fc)
195 {
196 	__le16 tmp = cpu_to_le16(IEEE80211_FCTL_TODS | IEEE80211_FCTL_FROMDS);
197 	return (fc & tmp) == tmp;
198 }
199 
200 /**
201  * ieee80211_has_morefrags - check if IEEE80211_FCTL_MOREFRAGS is set
202  * @fc: frame control bytes in little-endian byteorder
203  */
204 static inline int ieee80211_has_morefrags(__le16 fc)
205 {
206 	return (fc & cpu_to_le16(IEEE80211_FCTL_MOREFRAGS)) != 0;
207 }
208 
209 /**
210  * ieee80211_has_retry - check if IEEE80211_FCTL_RETRY is set
211  * @fc: frame control bytes in little-endian byteorder
212  */
213 static inline int ieee80211_has_retry(__le16 fc)
214 {
215 	return (fc & cpu_to_le16(IEEE80211_FCTL_RETRY)) != 0;
216 }
217 
218 /**
219  * ieee80211_has_pm - check if IEEE80211_FCTL_PM is set
220  * @fc: frame control bytes in little-endian byteorder
221  */
222 static inline int ieee80211_has_pm(__le16 fc)
223 {
224 	return (fc & cpu_to_le16(IEEE80211_FCTL_PM)) != 0;
225 }
226 
227 /**
228  * ieee80211_has_moredata - check if IEEE80211_FCTL_MOREDATA is set
229  * @fc: frame control bytes in little-endian byteorder
230  */
231 static inline int ieee80211_has_moredata(__le16 fc)
232 {
233 	return (fc & cpu_to_le16(IEEE80211_FCTL_MOREDATA)) != 0;
234 }
235 
236 /**
237  * ieee80211_has_protected - check if IEEE80211_FCTL_PROTECTED is set
238  * @fc: frame control bytes in little-endian byteorder
239  */
240 static inline int ieee80211_has_protected(__le16 fc)
241 {
242 	return (fc & cpu_to_le16(IEEE80211_FCTL_PROTECTED)) != 0;
243 }
244 
245 /**
246  * ieee80211_has_order - check if IEEE80211_FCTL_ORDER is set
247  * @fc: frame control bytes in little-endian byteorder
248  */
249 static inline int ieee80211_has_order(__le16 fc)
250 {
251 	return (fc & cpu_to_le16(IEEE80211_FCTL_ORDER)) != 0;
252 }
253 
254 /**
255  * ieee80211_is_mgmt - check if type is IEEE80211_FTYPE_MGMT
256  * @fc: frame control bytes in little-endian byteorder
257  */
258 static inline int ieee80211_is_mgmt(__le16 fc)
259 {
260 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE)) ==
261 	       cpu_to_le16(IEEE80211_FTYPE_MGMT);
262 }
263 
264 /**
265  * ieee80211_is_ctl - check if type is IEEE80211_FTYPE_CTL
266  * @fc: frame control bytes in little-endian byteorder
267  */
268 static inline int ieee80211_is_ctl(__le16 fc)
269 {
270 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE)) ==
271 	       cpu_to_le16(IEEE80211_FTYPE_CTL);
272 }
273 
274 /**
275  * ieee80211_is_data - check if type is IEEE80211_FTYPE_DATA
276  * @fc: frame control bytes in little-endian byteorder
277  */
278 static inline int ieee80211_is_data(__le16 fc)
279 {
280 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE)) ==
281 	       cpu_to_le16(IEEE80211_FTYPE_DATA);
282 }
283 
284 /**
285  * ieee80211_is_data_qos - check if type is IEEE80211_FTYPE_DATA and IEEE80211_STYPE_QOS_DATA is set
286  * @fc: frame control bytes in little-endian byteorder
287  */
288 static inline int ieee80211_is_data_qos(__le16 fc)
289 {
290 	/*
291 	 * mask with QOS_DATA rather than IEEE80211_FCTL_STYPE as we just need
292 	 * to check the one bit
293 	 */
294 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_STYPE_QOS_DATA)) ==
295 	       cpu_to_le16(IEEE80211_FTYPE_DATA | IEEE80211_STYPE_QOS_DATA);
296 }
297 
298 /**
299  * ieee80211_is_data_present - check if type is IEEE80211_FTYPE_DATA and has data
300  * @fc: frame control bytes in little-endian byteorder
301  */
302 static inline int ieee80211_is_data_present(__le16 fc)
303 {
304 	/*
305 	 * mask with 0x40 and test that that bit is clear to only return true
306 	 * for the data-containing substypes.
307 	 */
308 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | 0x40)) ==
309 	       cpu_to_le16(IEEE80211_FTYPE_DATA);
310 }
311 
312 /**
313  * ieee80211_is_assoc_req - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_ASSOC_REQ
314  * @fc: frame control bytes in little-endian byteorder
315  */
316 static inline int ieee80211_is_assoc_req(__le16 fc)
317 {
318 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
319 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_ASSOC_REQ);
320 }
321 
322 /**
323  * ieee80211_is_assoc_resp - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_ASSOC_RESP
324  * @fc: frame control bytes in little-endian byteorder
325  */
326 static inline int ieee80211_is_assoc_resp(__le16 fc)
327 {
328 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
329 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_ASSOC_RESP);
330 }
331 
332 /**
333  * ieee80211_is_reassoc_req - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_REASSOC_REQ
334  * @fc: frame control bytes in little-endian byteorder
335  */
336 static inline int ieee80211_is_reassoc_req(__le16 fc)
337 {
338 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
339 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_REASSOC_REQ);
340 }
341 
342 /**
343  * ieee80211_is_reassoc_resp - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_REASSOC_RESP
344  * @fc: frame control bytes in little-endian byteorder
345  */
346 static inline int ieee80211_is_reassoc_resp(__le16 fc)
347 {
348 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
349 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_REASSOC_RESP);
350 }
351 
352 /**
353  * ieee80211_is_probe_req - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_PROBE_REQ
354  * @fc: frame control bytes in little-endian byteorder
355  */
356 static inline int ieee80211_is_probe_req(__le16 fc)
357 {
358 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
359 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_PROBE_REQ);
360 }
361 
362 /**
363  * ieee80211_is_probe_resp - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_PROBE_RESP
364  * @fc: frame control bytes in little-endian byteorder
365  */
366 static inline int ieee80211_is_probe_resp(__le16 fc)
367 {
368 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
369 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_PROBE_RESP);
370 }
371 
372 /**
373  * ieee80211_is_beacon - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_BEACON
374  * @fc: frame control bytes in little-endian byteorder
375  */
376 static inline int ieee80211_is_beacon(__le16 fc)
377 {
378 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
379 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_BEACON);
380 }
381 
382 /**
383  * ieee80211_is_atim - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_ATIM
384  * @fc: frame control bytes in little-endian byteorder
385  */
386 static inline int ieee80211_is_atim(__le16 fc)
387 {
388 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
389 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_ATIM);
390 }
391 
392 /**
393  * ieee80211_is_disassoc - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_DISASSOC
394  * @fc: frame control bytes in little-endian byteorder
395  */
396 static inline int ieee80211_is_disassoc(__le16 fc)
397 {
398 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
399 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_DISASSOC);
400 }
401 
402 /**
403  * ieee80211_is_auth - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_AUTH
404  * @fc: frame control bytes in little-endian byteorder
405  */
406 static inline int ieee80211_is_auth(__le16 fc)
407 {
408 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
409 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_AUTH);
410 }
411 
412 /**
413  * ieee80211_is_deauth - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_DEAUTH
414  * @fc: frame control bytes in little-endian byteorder
415  */
416 static inline int ieee80211_is_deauth(__le16 fc)
417 {
418 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
419 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_DEAUTH);
420 }
421 
422 /**
423  * ieee80211_is_action - check if IEEE80211_FTYPE_MGMT && IEEE80211_STYPE_ACTION
424  * @fc: frame control bytes in little-endian byteorder
425  */
426 static inline int ieee80211_is_action(__le16 fc)
427 {
428 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
429 	       cpu_to_le16(IEEE80211_FTYPE_MGMT | IEEE80211_STYPE_ACTION);
430 }
431 
432 /**
433  * ieee80211_is_back_req - check if IEEE80211_FTYPE_CTL && IEEE80211_STYPE_BACK_REQ
434  * @fc: frame control bytes in little-endian byteorder
435  */
436 static inline int ieee80211_is_back_req(__le16 fc)
437 {
438 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
439 	       cpu_to_le16(IEEE80211_FTYPE_CTL | IEEE80211_STYPE_BACK_REQ);
440 }
441 
442 /**
443  * ieee80211_is_back - check if IEEE80211_FTYPE_CTL && IEEE80211_STYPE_BACK
444  * @fc: frame control bytes in little-endian byteorder
445  */
446 static inline int ieee80211_is_back(__le16 fc)
447 {
448 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
449 	       cpu_to_le16(IEEE80211_FTYPE_CTL | IEEE80211_STYPE_BACK);
450 }
451 
452 /**
453  * ieee80211_is_pspoll - check if IEEE80211_FTYPE_CTL && IEEE80211_STYPE_PSPOLL
454  * @fc: frame control bytes in little-endian byteorder
455  */
456 static inline int ieee80211_is_pspoll(__le16 fc)
457 {
458 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
459 	       cpu_to_le16(IEEE80211_FTYPE_CTL | IEEE80211_STYPE_PSPOLL);
460 }
461 
462 /**
463  * ieee80211_is_rts - check if IEEE80211_FTYPE_CTL && IEEE80211_STYPE_RTS
464  * @fc: frame control bytes in little-endian byteorder
465  */
466 static inline int ieee80211_is_rts(__le16 fc)
467 {
468 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
469 	       cpu_to_le16(IEEE80211_FTYPE_CTL | IEEE80211_STYPE_RTS);
470 }
471 
472 /**
473  * ieee80211_is_cts - check if IEEE80211_FTYPE_CTL && IEEE80211_STYPE_CTS
474  * @fc: frame control bytes in little-endian byteorder
475  */
476 static inline int ieee80211_is_cts(__le16 fc)
477 {
478 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
479 	       cpu_to_le16(IEEE80211_FTYPE_CTL | IEEE80211_STYPE_CTS);
480 }
481 
482 /**
483  * ieee80211_is_ack - check if IEEE80211_FTYPE_CTL && IEEE80211_STYPE_ACK
484  * @fc: frame control bytes in little-endian byteorder
485  */
486 static inline int ieee80211_is_ack(__le16 fc)
487 {
488 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
489 	       cpu_to_le16(IEEE80211_FTYPE_CTL | IEEE80211_STYPE_ACK);
490 }
491 
492 /**
493  * ieee80211_is_cfend - check if IEEE80211_FTYPE_CTL && IEEE80211_STYPE_CFEND
494  * @fc: frame control bytes in little-endian byteorder
495  */
496 static inline int ieee80211_is_cfend(__le16 fc)
497 {
498 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
499 	       cpu_to_le16(IEEE80211_FTYPE_CTL | IEEE80211_STYPE_CFEND);
500 }
501 
502 /**
503  * ieee80211_is_cfendack - check if IEEE80211_FTYPE_CTL && IEEE80211_STYPE_CFENDACK
504  * @fc: frame control bytes in little-endian byteorder
505  */
506 static inline int ieee80211_is_cfendack(__le16 fc)
507 {
508 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
509 	       cpu_to_le16(IEEE80211_FTYPE_CTL | IEEE80211_STYPE_CFENDACK);
510 }
511 
512 /**
513  * ieee80211_is_nullfunc - check if frame is a regular (non-QoS) nullfunc frame
514  * @fc: frame control bytes in little-endian byteorder
515  */
516 static inline int ieee80211_is_nullfunc(__le16 fc)
517 {
518 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
519 	       cpu_to_le16(IEEE80211_FTYPE_DATA | IEEE80211_STYPE_NULLFUNC);
520 }
521 
522 /**
523  * ieee80211_is_qos_nullfunc - check if frame is a QoS nullfunc frame
524  * @fc: frame control bytes in little-endian byteorder
525  */
526 static inline int ieee80211_is_qos_nullfunc(__le16 fc)
527 {
528 	return (fc & cpu_to_le16(IEEE80211_FCTL_FTYPE | IEEE80211_FCTL_STYPE)) ==
529 	       cpu_to_le16(IEEE80211_FTYPE_DATA | IEEE80211_STYPE_QOS_NULLFUNC);
530 }
531 
532 struct ieee80211s_hdr {
533 	u8 flags;
534 	u8 ttl;
535 	__le32 seqnum;
536 	u8 eaddr1[6];
537 	u8 eaddr2[6];
538 	u8 eaddr3[6];
539 } __attribute__ ((packed));
540 
541 /* Mesh flags */
542 #define MESH_FLAGS_AE_A4 	0x1
543 #define MESH_FLAGS_AE_A5_A6	0x2
544 #define MESH_FLAGS_AE		0x3
545 #define MESH_FLAGS_PS_DEEP	0x4
546 
547 /**
548  * struct ieee80211_quiet_ie
549  *
550  * This structure refers to "Quiet information element"
551  */
552 struct ieee80211_quiet_ie {
553 	u8 count;
554 	u8 period;
555 	__le16 duration;
556 	__le16 offset;
557 } __attribute__ ((packed));
558 
559 /**
560  * struct ieee80211_msrment_ie
561  *
562  * This structure refers to "Measurement Request/Report information element"
563  */
564 struct ieee80211_msrment_ie {
565 	u8 token;
566 	u8 mode;
567 	u8 type;
568 	u8 request[0];
569 } __attribute__ ((packed));
570 
571 /**
572  * struct ieee80211_channel_sw_ie
573  *
574  * This structure refers to "Channel Switch Announcement information element"
575  */
576 struct ieee80211_channel_sw_ie {
577 	u8 mode;
578 	u8 new_ch_num;
579 	u8 count;
580 } __attribute__ ((packed));
581 
582 /**
583  * struct ieee80211_tim
584  *
585  * This structure refers to "Traffic Indication Map information element"
586  */
587 struct ieee80211_tim_ie {
588 	u8 dtim_count;
589 	u8 dtim_period;
590 	u8 bitmap_ctrl;
591 	/* variable size: 1 - 251 bytes */
592 	u8 virtual_map[1];
593 } __attribute__ ((packed));
594 
595 /**
596  * struct ieee80211_meshconf_ie
597  *
598  * This structure refers to "Mesh Configuration information element"
599  */
600 struct ieee80211_meshconf_ie {
601 	u8 meshconf_psel;
602 	u8 meshconf_pmetric;
603 	u8 meshconf_congest;
604 	u8 meshconf_synch;
605 	u8 meshconf_auth;
606 	u8 meshconf_form;
607 	u8 meshconf_cap;
608 } __attribute__ ((packed));
609 
610 /**
611  * struct ieee80211_rann_ie
612  *
613  * This structure refers to "Root Announcement information element"
614  */
615 struct ieee80211_rann_ie {
616 	u8 rann_flags;
617 	u8 rann_hopcount;
618 	u8 rann_ttl;
619 	u8 rann_addr[6];
620 	u32 rann_seq;
621 	u32 rann_metric;
622 } __attribute__ ((packed));
623 
624 #define WLAN_SA_QUERY_TR_ID_LEN 2
625 
626 struct ieee80211_mgmt {
627 	__le16 frame_control;
628 	__le16 duration;
629 	u8 da[6];
630 	u8 sa[6];
631 	u8 bssid[6];
632 	__le16 seq_ctrl;
633 	union {
634 		struct {
635 			__le16 auth_alg;
636 			__le16 auth_transaction;
637 			__le16 status_code;
638 			/* possibly followed by Challenge text */
639 			u8 variable[0];
640 		} __attribute__ ((packed)) auth;
641 		struct {
642 			__le16 reason_code;
643 		} __attribute__ ((packed)) deauth;
644 		struct {
645 			__le16 capab_info;
646 			__le16 listen_interval;
647 			/* followed by SSID and Supported rates */
648 			u8 variable[0];
649 		} __attribute__ ((packed)) assoc_req;
650 		struct {
651 			__le16 capab_info;
652 			__le16 status_code;
653 			__le16 aid;
654 			/* followed by Supported rates */
655 			u8 variable[0];
656 		} __attribute__ ((packed)) assoc_resp, reassoc_resp;
657 		struct {
658 			__le16 capab_info;
659 			__le16 listen_interval;
660 			u8 current_ap[6];
661 			/* followed by SSID and Supported rates */
662 			u8 variable[0];
663 		} __attribute__ ((packed)) reassoc_req;
664 		struct {
665 			__le16 reason_code;
666 		} __attribute__ ((packed)) disassoc;
667 		struct {
668 			__le64 timestamp;
669 			__le16 beacon_int;
670 			__le16 capab_info;
671 			/* followed by some of SSID, Supported rates,
672 			 * FH Params, DS Params, CF Params, IBSS Params, TIM */
673 			u8 variable[0];
674 		} __attribute__ ((packed)) beacon;
675 		struct {
676 			/* only variable items: SSID, Supported rates */
677 			u8 variable[0];
678 		} __attribute__ ((packed)) probe_req;
679 		struct {
680 			__le64 timestamp;
681 			__le16 beacon_int;
682 			__le16 capab_info;
683 			/* followed by some of SSID, Supported rates,
684 			 * FH Params, DS Params, CF Params, IBSS Params */
685 			u8 variable[0];
686 		} __attribute__ ((packed)) probe_resp;
687 		struct {
688 			u8 category;
689 			union {
690 				struct {
691 					u8 action_code;
692 					u8 dialog_token;
693 					u8 status_code;
694 					u8 variable[0];
695 				} __attribute__ ((packed)) wme_action;
696 				struct{
697 					u8 action_code;
698 					u8 element_id;
699 					u8 length;
700 					struct ieee80211_channel_sw_ie sw_elem;
701 				} __attribute__((packed)) chan_switch;
702 				struct{
703 					u8 action_code;
704 					u8 dialog_token;
705 					u8 element_id;
706 					u8 length;
707 					struct ieee80211_msrment_ie msr_elem;
708 				} __attribute__((packed)) measurement;
709 				struct{
710 					u8 action_code;
711 					u8 dialog_token;
712 					__le16 capab;
713 					__le16 timeout;
714 					__le16 start_seq_num;
715 				} __attribute__((packed)) addba_req;
716 				struct{
717 					u8 action_code;
718 					u8 dialog_token;
719 					__le16 status;
720 					__le16 capab;
721 					__le16 timeout;
722 				} __attribute__((packed)) addba_resp;
723 				struct{
724 					u8 action_code;
725 					__le16 params;
726 					__le16 reason_code;
727 				} __attribute__((packed)) delba;
728 				struct{
729 					u8 action_code;
730 					/* capab_info for open and confirm,
731 					 * reason for close
732 					 */
733 					__le16 aux;
734 					/* Followed in plink_confirm by status
735 					 * code, AID and supported rates,
736 					 * and directly by supported rates in
737 					 * plink_open and plink_close
738 					 */
739 					u8 variable[0];
740 				} __attribute__((packed)) plink_action;
741 				struct{
742 					u8 action_code;
743 					u8 variable[0];
744 				} __attribute__((packed)) mesh_action;
745 				struct {
746 					u8 action;
747 					u8 trans_id[WLAN_SA_QUERY_TR_ID_LEN];
748 				} __attribute__ ((packed)) sa_query;
749 				struct {
750 					u8 action;
751 					u8 smps_control;
752 				} __attribute__ ((packed)) ht_smps;
753 			} u;
754 		} __attribute__ ((packed)) action;
755 	} u;
756 } __attribute__ ((packed));
757 
758 /* mgmt header + 1 byte category code */
759 #define IEEE80211_MIN_ACTION_SIZE offsetof(struct ieee80211_mgmt, u.action.u)
760 
761 
762 /* Management MIC information element (IEEE 802.11w) */
763 struct ieee80211_mmie {
764 	u8 element_id;
765 	u8 length;
766 	__le16 key_id;
767 	u8 sequence_number[6];
768 	u8 mic[8];
769 } __attribute__ ((packed));
770 
771 /* Control frames */
772 struct ieee80211_rts {
773 	__le16 frame_control;
774 	__le16 duration;
775 	u8 ra[6];
776 	u8 ta[6];
777 } __attribute__ ((packed));
778 
779 struct ieee80211_cts {
780 	__le16 frame_control;
781 	__le16 duration;
782 	u8 ra[6];
783 } __attribute__ ((packed));
784 
785 struct ieee80211_pspoll {
786 	__le16 frame_control;
787 	__le16 aid;
788 	u8 bssid[6];
789 	u8 ta[6];
790 } __attribute__ ((packed));
791 
792 /**
793  * struct ieee80211_bar - HT Block Ack Request
794  *
795  * This structure refers to "HT BlockAckReq" as
796  * described in 802.11n draft section 7.2.1.7.1
797  */
798 struct ieee80211_bar {
799 	__le16 frame_control;
800 	__le16 duration;
801 	__u8 ra[6];
802 	__u8 ta[6];
803 	__le16 control;
804 	__le16 start_seq_num;
805 } __attribute__((packed));
806 
807 /* 802.11 BAR control masks */
808 #define IEEE80211_BAR_CTRL_ACK_POLICY_NORMAL     0x0000
809 #define IEEE80211_BAR_CTRL_CBMTID_COMPRESSED_BA  0x0004
810 
811 
812 #define IEEE80211_HT_MCS_MASK_LEN		10
813 
814 /**
815  * struct ieee80211_mcs_info - MCS information
816  * @rx_mask: RX mask
817  * @rx_highest: highest supported RX rate. If set represents
818  *	the highest supported RX data rate in units of 1 Mbps.
819  *	If this field is 0 this value should not be used to
820  *	consider the highest RX data rate supported.
821  * @tx_params: TX parameters
822  */
823 struct ieee80211_mcs_info {
824 	u8 rx_mask[IEEE80211_HT_MCS_MASK_LEN];
825 	__le16 rx_highest;
826 	u8 tx_params;
827 	u8 reserved[3];
828 } __attribute__((packed));
829 
830 /* 802.11n HT capability MSC set */
831 #define IEEE80211_HT_MCS_RX_HIGHEST_MASK	0x3ff
832 #define IEEE80211_HT_MCS_TX_DEFINED		0x01
833 #define IEEE80211_HT_MCS_TX_RX_DIFF		0x02
834 /* value 0 == 1 stream etc */
835 #define IEEE80211_HT_MCS_TX_MAX_STREAMS_MASK	0x0C
836 #define IEEE80211_HT_MCS_TX_MAX_STREAMS_SHIFT	2
837 #define		IEEE80211_HT_MCS_TX_MAX_STREAMS	4
838 #define IEEE80211_HT_MCS_TX_UNEQUAL_MODULATION	0x10
839 
840 /*
841  * 802.11n D5.0 20.3.5 / 20.6 says:
842  * - indices 0 to 7 and 32 are single spatial stream
843  * - 8 to 31 are multiple spatial streams using equal modulation
844  *   [8..15 for two streams, 16..23 for three and 24..31 for four]
845  * - remainder are multiple spatial streams using unequal modulation
846  */
847 #define IEEE80211_HT_MCS_UNEQUAL_MODULATION_START 33
848 #define IEEE80211_HT_MCS_UNEQUAL_MODULATION_START_BYTE \
849 	(IEEE80211_HT_MCS_UNEQUAL_MODULATION_START / 8)
850 
851 /**
852  * struct ieee80211_ht_cap - HT capabilities
853  *
854  * This structure is the "HT capabilities element" as
855  * described in 802.11n D5.0 7.3.2.57
856  */
857 struct ieee80211_ht_cap {
858 	__le16 cap_info;
859 	u8 ampdu_params_info;
860 
861 	/* 16 bytes MCS information */
862 	struct ieee80211_mcs_info mcs;
863 
864 	__le16 extended_ht_cap_info;
865 	__le32 tx_BF_cap_info;
866 	u8 antenna_selection_info;
867 } __attribute__ ((packed));
868 
869 /* 802.11n HT capabilities masks (for cap_info) */
870 #define IEEE80211_HT_CAP_LDPC_CODING		0x0001
871 #define IEEE80211_HT_CAP_SUP_WIDTH_20_40	0x0002
872 #define IEEE80211_HT_CAP_SM_PS			0x000C
873 #define		IEEE80211_HT_CAP_SM_PS_SHIFT	2
874 #define IEEE80211_HT_CAP_GRN_FLD		0x0010
875 #define IEEE80211_HT_CAP_SGI_20			0x0020
876 #define IEEE80211_HT_CAP_SGI_40			0x0040
877 #define IEEE80211_HT_CAP_TX_STBC		0x0080
878 #define IEEE80211_HT_CAP_RX_STBC		0x0300
879 #define		IEEE80211_HT_CAP_RX_STBC_SHIFT	8
880 #define IEEE80211_HT_CAP_DELAY_BA		0x0400
881 #define IEEE80211_HT_CAP_MAX_AMSDU		0x0800
882 #define IEEE80211_HT_CAP_DSSSCCK40		0x1000
883 #define IEEE80211_HT_CAP_RESERVED		0x2000
884 #define IEEE80211_HT_CAP_40MHZ_INTOLERANT	0x4000
885 #define IEEE80211_HT_CAP_LSIG_TXOP_PROT		0x8000
886 
887 /* 802.11n HT capability AMPDU settings (for ampdu_params_info) */
888 #define IEEE80211_HT_AMPDU_PARM_FACTOR		0x03
889 #define IEEE80211_HT_AMPDU_PARM_DENSITY		0x1C
890 #define		IEEE80211_HT_AMPDU_PARM_DENSITY_SHIFT	2
891 
892 /*
893  * Maximum length of AMPDU that the STA can receive.
894  * Length = 2 ^ (13 + max_ampdu_length_exp) - 1 (octets)
895  */
896 enum ieee80211_max_ampdu_length_exp {
897 	IEEE80211_HT_MAX_AMPDU_8K = 0,
898 	IEEE80211_HT_MAX_AMPDU_16K = 1,
899 	IEEE80211_HT_MAX_AMPDU_32K = 2,
900 	IEEE80211_HT_MAX_AMPDU_64K = 3
901 };
902 
903 #define IEEE80211_HT_MAX_AMPDU_FACTOR 13
904 
905 /* Minimum MPDU start spacing */
906 enum ieee80211_min_mpdu_spacing {
907 	IEEE80211_HT_MPDU_DENSITY_NONE = 0,	/* No restriction */
908 	IEEE80211_HT_MPDU_DENSITY_0_25 = 1,	/* 1/4 usec */
909 	IEEE80211_HT_MPDU_DENSITY_0_5 = 2,	/* 1/2 usec */
910 	IEEE80211_HT_MPDU_DENSITY_1 = 3,	/* 1 usec */
911 	IEEE80211_HT_MPDU_DENSITY_2 = 4,	/* 2 usec */
912 	IEEE80211_HT_MPDU_DENSITY_4 = 5,	/* 4 usec */
913 	IEEE80211_HT_MPDU_DENSITY_8 = 6,	/* 8 usec */
914 	IEEE80211_HT_MPDU_DENSITY_16 = 7	/* 16 usec */
915 };
916 
917 /**
918  * struct ieee80211_ht_info - HT information
919  *
920  * This structure is the "HT information element" as
921  * described in 802.11n D5.0 7.3.2.58
922  */
923 struct ieee80211_ht_info {
924 	u8 control_chan;
925 	u8 ht_param;
926 	__le16 operation_mode;
927 	__le16 stbc_param;
928 	u8 basic_set[16];
929 } __attribute__ ((packed));
930 
931 /* for ht_param */
932 #define IEEE80211_HT_PARAM_CHA_SEC_OFFSET		0x03
933 #define		IEEE80211_HT_PARAM_CHA_SEC_NONE		0x00
934 #define		IEEE80211_HT_PARAM_CHA_SEC_ABOVE	0x01
935 #define		IEEE80211_HT_PARAM_CHA_SEC_BELOW	0x03
936 #define IEEE80211_HT_PARAM_CHAN_WIDTH_ANY		0x04
937 #define IEEE80211_HT_PARAM_RIFS_MODE			0x08
938 #define IEEE80211_HT_PARAM_SPSMP_SUPPORT		0x10
939 #define IEEE80211_HT_PARAM_SERV_INTERVAL_GRAN		0xE0
940 
941 /* for operation_mode */
942 #define IEEE80211_HT_OP_MODE_PROTECTION			0x0003
943 #define		IEEE80211_HT_OP_MODE_PROTECTION_NONE		0
944 #define		IEEE80211_HT_OP_MODE_PROTECTION_NONMEMBER	1
945 #define		IEEE80211_HT_OP_MODE_PROTECTION_20MHZ		2
946 #define		IEEE80211_HT_OP_MODE_PROTECTION_NONHT_MIXED	3
947 #define IEEE80211_HT_OP_MODE_NON_GF_STA_PRSNT		0x0004
948 #define IEEE80211_HT_OP_MODE_NON_HT_STA_PRSNT		0x0010
949 
950 /* for stbc_param */
951 #define IEEE80211_HT_STBC_PARAM_DUAL_BEACON		0x0040
952 #define IEEE80211_HT_STBC_PARAM_DUAL_CTS_PROT		0x0080
953 #define IEEE80211_HT_STBC_PARAM_STBC_BEACON		0x0100
954 #define IEEE80211_HT_STBC_PARAM_LSIG_TXOP_FULLPROT	0x0200
955 #define IEEE80211_HT_STBC_PARAM_PCO_ACTIVE		0x0400
956 #define IEEE80211_HT_STBC_PARAM_PCO_PHASE		0x0800
957 
958 
959 /* block-ack parameters */
960 #define IEEE80211_ADDBA_PARAM_POLICY_MASK 0x0002
961 #define IEEE80211_ADDBA_PARAM_TID_MASK 0x003C
962 #define IEEE80211_ADDBA_PARAM_BUF_SIZE_MASK 0xFFA0
963 #define IEEE80211_DELBA_PARAM_TID_MASK 0xF000
964 #define IEEE80211_DELBA_PARAM_INITIATOR_MASK 0x0800
965 
966 /*
967  * A-PMDU buffer sizes
968  * According to IEEE802.11n spec size varies from 8K to 64K (in powers of 2)
969  */
970 #define IEEE80211_MIN_AMPDU_BUF 0x8
971 #define IEEE80211_MAX_AMPDU_BUF 0x40
972 
973 
974 /* Spatial Multiplexing Power Save Modes (for capability) */
975 #define WLAN_HT_CAP_SM_PS_STATIC	0
976 #define WLAN_HT_CAP_SM_PS_DYNAMIC	1
977 #define WLAN_HT_CAP_SM_PS_INVALID	2
978 #define WLAN_HT_CAP_SM_PS_DISABLED	3
979 
980 /* for SM power control field lower two bits */
981 #define WLAN_HT_SMPS_CONTROL_DISABLED	0
982 #define WLAN_HT_SMPS_CONTROL_STATIC	1
983 #define WLAN_HT_SMPS_CONTROL_DYNAMIC	3
984 
985 /* Authentication algorithms */
986 #define WLAN_AUTH_OPEN 0
987 #define WLAN_AUTH_SHARED_KEY 1
988 #define WLAN_AUTH_FT 2
989 #define WLAN_AUTH_SAE 3
990 #define WLAN_AUTH_LEAP 128
991 
992 #define WLAN_AUTH_CHALLENGE_LEN 128
993 
994 #define WLAN_CAPABILITY_ESS		(1<<0)
995 #define WLAN_CAPABILITY_IBSS		(1<<1)
996 #define WLAN_CAPABILITY_CF_POLLABLE	(1<<2)
997 #define WLAN_CAPABILITY_CF_POLL_REQUEST	(1<<3)
998 #define WLAN_CAPABILITY_PRIVACY		(1<<4)
999 #define WLAN_CAPABILITY_SHORT_PREAMBLE	(1<<5)
1000 #define WLAN_CAPABILITY_PBCC		(1<<6)
1001 #define WLAN_CAPABILITY_CHANNEL_AGILITY	(1<<7)
1002 
1003 /* 802.11h */
1004 #define WLAN_CAPABILITY_SPECTRUM_MGMT	(1<<8)
1005 #define WLAN_CAPABILITY_QOS		(1<<9)
1006 #define WLAN_CAPABILITY_SHORT_SLOT_TIME	(1<<10)
1007 #define WLAN_CAPABILITY_DSSS_OFDM	(1<<13)
1008 /* measurement */
1009 #define IEEE80211_SPCT_MSR_RPRT_MODE_LATE	(1<<0)
1010 #define IEEE80211_SPCT_MSR_RPRT_MODE_INCAPABLE	(1<<1)
1011 #define IEEE80211_SPCT_MSR_RPRT_MODE_REFUSED	(1<<2)
1012 
1013 #define IEEE80211_SPCT_MSR_RPRT_TYPE_BASIC	0
1014 #define IEEE80211_SPCT_MSR_RPRT_TYPE_CCA	1
1015 #define IEEE80211_SPCT_MSR_RPRT_TYPE_RPI	2
1016 
1017 
1018 /* 802.11g ERP information element */
1019 #define WLAN_ERP_NON_ERP_PRESENT (1<<0)
1020 #define WLAN_ERP_USE_PROTECTION (1<<1)
1021 #define WLAN_ERP_BARKER_PREAMBLE (1<<2)
1022 
1023 /* WLAN_ERP_BARKER_PREAMBLE values */
1024 enum {
1025 	WLAN_ERP_PREAMBLE_SHORT = 0,
1026 	WLAN_ERP_PREAMBLE_LONG = 1,
1027 };
1028 
1029 /* Status codes */
1030 enum ieee80211_statuscode {
1031 	WLAN_STATUS_SUCCESS = 0,
1032 	WLAN_STATUS_UNSPECIFIED_FAILURE = 1,
1033 	WLAN_STATUS_CAPS_UNSUPPORTED = 10,
1034 	WLAN_STATUS_REASSOC_NO_ASSOC = 11,
1035 	WLAN_STATUS_ASSOC_DENIED_UNSPEC = 12,
1036 	WLAN_STATUS_NOT_SUPPORTED_AUTH_ALG = 13,
1037 	WLAN_STATUS_UNKNOWN_AUTH_TRANSACTION = 14,
1038 	WLAN_STATUS_CHALLENGE_FAIL = 15,
1039 	WLAN_STATUS_AUTH_TIMEOUT = 16,
1040 	WLAN_STATUS_AP_UNABLE_TO_HANDLE_NEW_STA = 17,
1041 	WLAN_STATUS_ASSOC_DENIED_RATES = 18,
1042 	/* 802.11b */
1043 	WLAN_STATUS_ASSOC_DENIED_NOSHORTPREAMBLE = 19,
1044 	WLAN_STATUS_ASSOC_DENIED_NOPBCC = 20,
1045 	WLAN_STATUS_ASSOC_DENIED_NOAGILITY = 21,
1046 	/* 802.11h */
1047 	WLAN_STATUS_ASSOC_DENIED_NOSPECTRUM = 22,
1048 	WLAN_STATUS_ASSOC_REJECTED_BAD_POWER = 23,
1049 	WLAN_STATUS_ASSOC_REJECTED_BAD_SUPP_CHAN = 24,
1050 	/* 802.11g */
1051 	WLAN_STATUS_ASSOC_DENIED_NOSHORTTIME = 25,
1052 	WLAN_STATUS_ASSOC_DENIED_NODSSSOFDM = 26,
1053 	/* 802.11w */
1054 	WLAN_STATUS_ASSOC_REJECTED_TEMPORARILY = 30,
1055 	WLAN_STATUS_ROBUST_MGMT_FRAME_POLICY_VIOLATION = 31,
1056 	/* 802.11i */
1057 	WLAN_STATUS_INVALID_IE = 40,
1058 	WLAN_STATUS_INVALID_GROUP_CIPHER = 41,
1059 	WLAN_STATUS_INVALID_PAIRWISE_CIPHER = 42,
1060 	WLAN_STATUS_INVALID_AKMP = 43,
1061 	WLAN_STATUS_UNSUPP_RSN_VERSION = 44,
1062 	WLAN_STATUS_INVALID_RSN_IE_CAP = 45,
1063 	WLAN_STATUS_CIPHER_SUITE_REJECTED = 46,
1064 	/* 802.11e */
1065 	WLAN_STATUS_UNSPECIFIED_QOS = 32,
1066 	WLAN_STATUS_ASSOC_DENIED_NOBANDWIDTH = 33,
1067 	WLAN_STATUS_ASSOC_DENIED_LOWACK = 34,
1068 	WLAN_STATUS_ASSOC_DENIED_UNSUPP_QOS = 35,
1069 	WLAN_STATUS_REQUEST_DECLINED = 37,
1070 	WLAN_STATUS_INVALID_QOS_PARAM = 38,
1071 	WLAN_STATUS_CHANGE_TSPEC = 39,
1072 	WLAN_STATUS_WAIT_TS_DELAY = 47,
1073 	WLAN_STATUS_NO_DIRECT_LINK = 48,
1074 	WLAN_STATUS_STA_NOT_PRESENT = 49,
1075 	WLAN_STATUS_STA_NOT_QSTA = 50,
1076 	/* 802.11s */
1077 	WLAN_STATUS_ANTI_CLOG_REQUIRED = 76,
1078 	WLAN_STATUS_FCG_NOT_SUPP = 78,
1079 	WLAN_STATUS_STA_NO_TBTT = 78,
1080 };
1081 
1082 
1083 /* Reason codes */
1084 enum ieee80211_reasoncode {
1085 	WLAN_REASON_UNSPECIFIED = 1,
1086 	WLAN_REASON_PREV_AUTH_NOT_VALID = 2,
1087 	WLAN_REASON_DEAUTH_LEAVING = 3,
1088 	WLAN_REASON_DISASSOC_DUE_TO_INACTIVITY = 4,
1089 	WLAN_REASON_DISASSOC_AP_BUSY = 5,
1090 	WLAN_REASON_CLASS2_FRAME_FROM_NONAUTH_STA = 6,
1091 	WLAN_REASON_CLASS3_FRAME_FROM_NONASSOC_STA = 7,
1092 	WLAN_REASON_DISASSOC_STA_HAS_LEFT = 8,
1093 	WLAN_REASON_STA_REQ_ASSOC_WITHOUT_AUTH = 9,
1094 	/* 802.11h */
1095 	WLAN_REASON_DISASSOC_BAD_POWER = 10,
1096 	WLAN_REASON_DISASSOC_BAD_SUPP_CHAN = 11,
1097 	/* 802.11i */
1098 	WLAN_REASON_INVALID_IE = 13,
1099 	WLAN_REASON_MIC_FAILURE = 14,
1100 	WLAN_REASON_4WAY_HANDSHAKE_TIMEOUT = 15,
1101 	WLAN_REASON_GROUP_KEY_HANDSHAKE_TIMEOUT = 16,
1102 	WLAN_REASON_IE_DIFFERENT = 17,
1103 	WLAN_REASON_INVALID_GROUP_CIPHER = 18,
1104 	WLAN_REASON_INVALID_PAIRWISE_CIPHER = 19,
1105 	WLAN_REASON_INVALID_AKMP = 20,
1106 	WLAN_REASON_UNSUPP_RSN_VERSION = 21,
1107 	WLAN_REASON_INVALID_RSN_IE_CAP = 22,
1108 	WLAN_REASON_IEEE8021X_FAILED = 23,
1109 	WLAN_REASON_CIPHER_SUITE_REJECTED = 24,
1110 	/* 802.11e */
1111 	WLAN_REASON_DISASSOC_UNSPECIFIED_QOS = 32,
1112 	WLAN_REASON_DISASSOC_QAP_NO_BANDWIDTH = 33,
1113 	WLAN_REASON_DISASSOC_LOW_ACK = 34,
1114 	WLAN_REASON_DISASSOC_QAP_EXCEED_TXOP = 35,
1115 	WLAN_REASON_QSTA_LEAVE_QBSS = 36,
1116 	WLAN_REASON_QSTA_NOT_USE = 37,
1117 	WLAN_REASON_QSTA_REQUIRE_SETUP = 38,
1118 	WLAN_REASON_QSTA_TIMEOUT = 39,
1119 	WLAN_REASON_QSTA_CIPHER_NOT_SUPP = 45,
1120 	/* 802.11s */
1121 	WLAN_REASON_MESH_PEER_CANCELED = 52,
1122 	WLAN_REASON_MESH_MAX_PEERS = 53,
1123 	WLAN_REASON_MESH_CONFIG = 54,
1124 	WLAN_REASON_MESH_CLOSE = 55,
1125 	WLAN_REASON_MESH_MAX_RETRIES = 56,
1126 	WLAN_REASON_MESH_CONFIRM_TIMEOUT = 57,
1127 	WLAN_REASON_MESH_INVALID_GTK = 58,
1128 	WLAN_REASON_MESH_INCONSISTENT_PARAM = 59,
1129 	WLAN_REASON_MESH_INVALID_SECURITY = 60,
1130 	WLAN_REASON_MESH_PATH_ERROR = 61,
1131 	WLAN_REASON_MESH_PATH_NOFORWARD = 62,
1132 	WLAN_REASON_MESH_PATH_DEST_UNREACHABLE = 63,
1133 	WLAN_REASON_MAC_EXISTS_IN_MBSS = 64,
1134 	WLAN_REASON_MESH_CHAN_REGULATORY = 65,
1135 	WLAN_REASON_MESH_CHAN = 66,
1136 };
1137 
1138 
1139 /* Information Element IDs */
1140 enum ieee80211_eid {
1141 	WLAN_EID_SSID = 0,
1142 	WLAN_EID_SUPP_RATES = 1,
1143 	WLAN_EID_FH_PARAMS = 2,
1144 	WLAN_EID_DS_PARAMS = 3,
1145 	WLAN_EID_CF_PARAMS = 4,
1146 	WLAN_EID_TIM = 5,
1147 	WLAN_EID_IBSS_PARAMS = 6,
1148 	WLAN_EID_CHALLENGE = 16,
1149 
1150 	WLAN_EID_COUNTRY = 7,
1151 	WLAN_EID_HP_PARAMS = 8,
1152 	WLAN_EID_HP_TABLE = 9,
1153 	WLAN_EID_REQUEST = 10,
1154 
1155 	WLAN_EID_QBSS_LOAD = 11,
1156 	WLAN_EID_EDCA_PARAM_SET = 12,
1157 	WLAN_EID_TSPEC = 13,
1158 	WLAN_EID_TCLAS = 14,
1159 	WLAN_EID_SCHEDULE = 15,
1160 	WLAN_EID_TS_DELAY = 43,
1161 	WLAN_EID_TCLAS_PROCESSING = 44,
1162 	WLAN_EID_QOS_CAPA = 46,
1163 	/* 802.11s */
1164 	WLAN_EID_MESH_CONFIG = 113,
1165 	WLAN_EID_MESH_ID = 114,
1166 	WLAN_EID_LINK_METRIC_REPORT = 115,
1167 	WLAN_EID_CONGESTION_NOTIFICATION = 116,
1168 	/* Note that the Peer Link IE has been replaced with the similar
1169 	 * Peer Management IE.  We will keep the former definition until mesh
1170 	 * code is changed to comply with latest 802.11s drafts.
1171 	 */
1172 	WLAN_EID_PEER_LINK = 55,  /* no longer in 802.11s drafts */
1173 	WLAN_EID_PEER_MGMT = 117,
1174 	WLAN_EID_CHAN_SWITCH_PARAM = 118,
1175 	WLAN_EID_MESH_AWAKE_WINDOW = 119,
1176 	WLAN_EID_BEACON_TIMING = 120,
1177 	WLAN_EID_MCCAOP_SETUP_REQ = 121,
1178 	WLAN_EID_MCCAOP_SETUP_RESP = 122,
1179 	WLAN_EID_MCCAOP_ADVERT = 123,
1180 	WLAN_EID_MCCAOP_TEARDOWN = 124,
1181 	WLAN_EID_GANN = 125,
1182 	WLAN_EID_RANN = 126,
1183 	WLAN_EID_PREQ = 130,
1184 	WLAN_EID_PREP = 131,
1185 	WLAN_EID_PERR = 132,
1186 	WLAN_EID_PXU = 137,
1187 	WLAN_EID_PXUC = 138,
1188 	WLAN_EID_AUTH_MESH_PEER_EXCH = 139,
1189 	WLAN_EID_MIC = 140,
1190 
1191 	WLAN_EID_PWR_CONSTRAINT = 32,
1192 	WLAN_EID_PWR_CAPABILITY = 33,
1193 	WLAN_EID_TPC_REQUEST = 34,
1194 	WLAN_EID_TPC_REPORT = 35,
1195 	WLAN_EID_SUPPORTED_CHANNELS = 36,
1196 	WLAN_EID_CHANNEL_SWITCH = 37,
1197 	WLAN_EID_MEASURE_REQUEST = 38,
1198 	WLAN_EID_MEASURE_REPORT = 39,
1199 	WLAN_EID_QUIET = 40,
1200 	WLAN_EID_IBSS_DFS = 41,
1201 
1202 	WLAN_EID_ERP_INFO = 42,
1203 	WLAN_EID_EXT_SUPP_RATES = 50,
1204 
1205 	WLAN_EID_HT_CAPABILITY = 45,
1206 	WLAN_EID_HT_INFORMATION = 61,
1207 
1208 	WLAN_EID_RSN = 48,
1209 	WLAN_EID_MMIE = 76,
1210 	WLAN_EID_WPA = 221,
1211 	WLAN_EID_GENERIC = 221,
1212 	WLAN_EID_VENDOR_SPECIFIC = 221,
1213 	WLAN_EID_QOS_PARAMETER = 222,
1214 
1215 	WLAN_EID_AP_CHAN_REPORT = 51,
1216 	WLAN_EID_NEIGHBOR_REPORT = 52,
1217 	WLAN_EID_RCPI = 53,
1218 	WLAN_EID_BSS_AVG_ACCESS_DELAY = 63,
1219 	WLAN_EID_ANTENNA_INFO = 64,
1220 	WLAN_EID_RSNI = 65,
1221 	WLAN_EID_MEASUREMENT_PILOT_TX_INFO = 66,
1222 	WLAN_EID_BSS_AVAILABLE_CAPACITY = 67,
1223 	WLAN_EID_BSS_AC_ACCESS_DELAY = 68,
1224 	WLAN_EID_RRM_ENABLED_CAPABILITIES = 70,
1225 	WLAN_EID_MULTIPLE_BSSID = 71,
1226 
1227 	WLAN_EID_MOBILITY_DOMAIN = 54,
1228 	WLAN_EID_FAST_BSS_TRANSITION = 55,
1229 	WLAN_EID_TIMEOUT_INTERVAL = 56,
1230 	WLAN_EID_RIC_DATA = 57,
1231 	WLAN_EID_RIC_DESCRIPTOR = 75,
1232 
1233 	WLAN_EID_DSE_REGISTERED_LOCATION = 58,
1234 	WLAN_EID_SUPPORTED_REGULATORY_CLASSES = 59,
1235 	WLAN_EID_EXT_CHANSWITCH_ANN = 60,
1236 };
1237 
1238 /* Action category code */
1239 enum ieee80211_category {
1240 	WLAN_CATEGORY_SPECTRUM_MGMT = 0,
1241 	WLAN_CATEGORY_QOS = 1,
1242 	WLAN_CATEGORY_DLS = 2,
1243 	WLAN_CATEGORY_BACK = 3,
1244 	WLAN_CATEGORY_PUBLIC = 4,
1245 	WLAN_CATEGORY_HT = 7,
1246 	WLAN_CATEGORY_SA_QUERY = 8,
1247 	WLAN_CATEGORY_PROTECTED_DUAL_OF_ACTION = 9,
1248 	WLAN_CATEGORY_MESH_ACTION = 13,
1249 	WLAN_CATEGORY_MULTIHOP_ACTION = 14,
1250 	WLAN_CATEGORY_SELF_PROTECTED = 15,
1251 	WLAN_CATEGORY_WMM = 17,
1252 	/* TODO: remove MESH_PLINK and MESH_PATH_SEL after */
1253 	/*       mesh is updated to current 802.11s draft  */
1254 	WLAN_CATEGORY_MESH_PLINK = 30,
1255 	WLAN_CATEGORY_MESH_PATH_SEL = 32,
1256 	WLAN_CATEGORY_VENDOR_SPECIFIC_PROTECTED = 126,
1257 	WLAN_CATEGORY_VENDOR_SPECIFIC = 127,
1258 };
1259 
1260 /* SPECTRUM_MGMT action code */
1261 enum ieee80211_spectrum_mgmt_actioncode {
1262 	WLAN_ACTION_SPCT_MSR_REQ = 0,
1263 	WLAN_ACTION_SPCT_MSR_RPRT = 1,
1264 	WLAN_ACTION_SPCT_TPC_REQ = 2,
1265 	WLAN_ACTION_SPCT_TPC_RPRT = 3,
1266 	WLAN_ACTION_SPCT_CHL_SWITCH = 4,
1267 };
1268 
1269 /* HT action codes */
1270 enum ieee80211_ht_actioncode {
1271 	WLAN_HT_ACTION_NOTIFY_CHANWIDTH = 0,
1272 	WLAN_HT_ACTION_SMPS = 1,
1273 	WLAN_HT_ACTION_PSMP = 2,
1274 	WLAN_HT_ACTION_PCO_PHASE = 3,
1275 	WLAN_HT_ACTION_CSI = 4,
1276 	WLAN_HT_ACTION_NONCOMPRESSED_BF = 5,
1277 	WLAN_HT_ACTION_COMPRESSED_BF = 6,
1278 	WLAN_HT_ACTION_ASEL_IDX_FEEDBACK = 7,
1279 };
1280 
1281 /* Security key length */
1282 enum ieee80211_key_len {
1283 	WLAN_KEY_LEN_WEP40 = 5,
1284 	WLAN_KEY_LEN_WEP104 = 13,
1285 	WLAN_KEY_LEN_CCMP = 16,
1286 	WLAN_KEY_LEN_TKIP = 32,
1287 	WLAN_KEY_LEN_AES_CMAC = 16,
1288 };
1289 
1290 /*
1291  * IEEE 802.11-2007 7.3.2.9 Country information element
1292  *
1293  * Minimum length is 8 octets, ie len must be evenly
1294  * divisible by 2
1295  */
1296 
1297 /* Although the spec says 8 I'm seeing 6 in practice */
1298 #define IEEE80211_COUNTRY_IE_MIN_LEN	6
1299 
1300 /*
1301  * For regulatory extension stuff see IEEE 802.11-2007
1302  * Annex I (page 1141) and Annex J (page 1147). Also
1303  * review 7.3.2.9.
1304  *
1305  * When dot11RegulatoryClassesRequired is true and the
1306  * first_channel/reg_extension_id is >= 201 then the IE
1307  * compromises of the 'ext' struct represented below:
1308  *
1309  *  - Regulatory extension ID - when generating IE this just needs
1310  *    to be monotonically increasing for each triplet passed in
1311  *    the IE
1312  *  - Regulatory class - index into set of rules
1313  *  - Coverage class - index into air propagation time (Table 7-27),
1314  *    in microseconds, you can compute the air propagation time from
1315  *    the index by multiplying by 3, so index 10 yields a propagation
1316  *    of 10 us. Valid values are 0-31, values 32-255 are not defined
1317  *    yet. A value of 0 inicates air propagation of <= 1 us.
1318  *
1319  *  See also Table I.2 for Emission limit sets and table
1320  *  I.3 for Behavior limit sets. Table J.1 indicates how to map
1321  *  a reg_class to an emission limit set and behavior limit set.
1322  */
1323 #define IEEE80211_COUNTRY_EXTENSION_ID 201
1324 
1325 /*
1326  *  Channels numbers in the IE must be monotonically increasing
1327  *  if dot11RegulatoryClassesRequired is not true.
1328  *
1329  *  If dot11RegulatoryClassesRequired is true consecutive
1330  *  subband triplets following a regulatory triplet shall
1331  *  have monotonically increasing first_channel number fields.
1332  *
1333  *  Channel numbers shall not overlap.
1334  *
1335  *  Note that max_power is signed.
1336  */
1337 struct ieee80211_country_ie_triplet {
1338 	union {
1339 		struct {
1340 			u8 first_channel;
1341 			u8 num_channels;
1342 			s8 max_power;
1343 		} __attribute__ ((packed)) chans;
1344 		struct {
1345 			u8 reg_extension_id;
1346 			u8 reg_class;
1347 			u8 coverage_class;
1348 		} __attribute__ ((packed)) ext;
1349 	};
1350 } __attribute__ ((packed));
1351 
1352 enum ieee80211_timeout_interval_type {
1353 	WLAN_TIMEOUT_REASSOC_DEADLINE = 1 /* 802.11r */,
1354 	WLAN_TIMEOUT_KEY_LIFETIME = 2 /* 802.11r */,
1355 	WLAN_TIMEOUT_ASSOC_COMEBACK = 3 /* 802.11w */,
1356 };
1357 
1358 /* BACK action code */
1359 enum ieee80211_back_actioncode {
1360 	WLAN_ACTION_ADDBA_REQ = 0,
1361 	WLAN_ACTION_ADDBA_RESP = 1,
1362 	WLAN_ACTION_DELBA = 2,
1363 };
1364 
1365 /* BACK (block-ack) parties */
1366 enum ieee80211_back_parties {
1367 	WLAN_BACK_RECIPIENT = 0,
1368 	WLAN_BACK_INITIATOR = 1,
1369 };
1370 
1371 /* SA Query action */
1372 enum ieee80211_sa_query_action {
1373 	WLAN_ACTION_SA_QUERY_REQUEST = 0,
1374 	WLAN_ACTION_SA_QUERY_RESPONSE = 1,
1375 };
1376 
1377 
1378 /* A-MSDU 802.11n */
1379 #define IEEE80211_QOS_CONTROL_A_MSDU_PRESENT 0x0080
1380 
1381 /* cipher suite selectors */
1382 #define WLAN_CIPHER_SUITE_USE_GROUP	0x000FAC00
1383 #define WLAN_CIPHER_SUITE_WEP40		0x000FAC01
1384 #define WLAN_CIPHER_SUITE_TKIP		0x000FAC02
1385 /* reserved: 				0x000FAC03 */
1386 #define WLAN_CIPHER_SUITE_CCMP		0x000FAC04
1387 #define WLAN_CIPHER_SUITE_WEP104	0x000FAC05
1388 #define WLAN_CIPHER_SUITE_AES_CMAC	0x000FAC06
1389 
1390 /* AKM suite selectors */
1391 #define WLAN_AKM_SUITE_8021X		0x000FAC01
1392 #define WLAN_AKM_SUITE_PSK		0x000FAC02
1393 #define WLAN_AKM_SUITE_SAE			0x000FAC08
1394 #define WLAN_AKM_SUITE_FT_OVER_SAE	0x000FAC09
1395 
1396 #define WLAN_MAX_KEY_LEN		32
1397 
1398 #define WLAN_PMKID_LEN			16
1399 
1400 /**
1401  * ieee80211_get_qos_ctl - get pointer to qos control bytes
1402  * @hdr: the frame
1403  *
1404  * The qos ctrl bytes come after the frame_control, duration, seq_num
1405  * and 3 or 4 addresses of length ETH_ALEN.
1406  * 3 addr: 2 + 2 + 2 + 3*6 = 24
1407  * 4 addr: 2 + 2 + 2 + 4*6 = 30
1408  */
1409 static inline u8 *ieee80211_get_qos_ctl(struct ieee80211_hdr *hdr)
1410 {
1411 	if (ieee80211_has_a4(hdr->frame_control))
1412 		return (u8 *)hdr + 30;
1413 	else
1414 		return (u8 *)hdr + 24;
1415 }
1416 
1417 /**
1418  * ieee80211_get_SA - get pointer to SA
1419  * @hdr: the frame
1420  *
1421  * Given an 802.11 frame, this function returns the offset
1422  * to the source address (SA). It does not verify that the
1423  * header is long enough to contain the address, and the
1424  * header must be long enough to contain the frame control
1425  * field.
1426  */
1427 static inline u8 *ieee80211_get_SA(struct ieee80211_hdr *hdr)
1428 {
1429 	if (ieee80211_has_a4(hdr->frame_control))
1430 		return hdr->addr4;
1431 	if (ieee80211_has_fromds(hdr->frame_control))
1432 		return hdr->addr3;
1433 	return hdr->addr2;
1434 }
1435 
1436 /**
1437  * ieee80211_get_DA - get pointer to DA
1438  * @hdr: the frame
1439  *
1440  * Given an 802.11 frame, this function returns the offset
1441  * to the destination address (DA). It does not verify that
1442  * the header is long enough to contain the address, and the
1443  * header must be long enough to contain the frame control
1444  * field.
1445  */
1446 static inline u8 *ieee80211_get_DA(struct ieee80211_hdr *hdr)
1447 {
1448 	if (ieee80211_has_tods(hdr->frame_control))
1449 		return hdr->addr3;
1450 	else
1451 		return hdr->addr1;
1452 }
1453 
1454 /**
1455  * ieee80211_is_robust_mgmt_frame - check if frame is a robust management frame
1456  * @hdr: the frame (buffer must include at least the first octet of payload)
1457  */
1458 static inline bool ieee80211_is_robust_mgmt_frame(struct ieee80211_hdr *hdr)
1459 {
1460 	if (ieee80211_is_disassoc(hdr->frame_control) ||
1461 	    ieee80211_is_deauth(hdr->frame_control))
1462 		return true;
1463 
1464 	if (ieee80211_is_action(hdr->frame_control)) {
1465 		u8 *category;
1466 
1467 		/*
1468 		 * Action frames, excluding Public Action frames, are Robust
1469 		 * Management Frames. However, if we are looking at a Protected
1470 		 * frame, skip the check since the data may be encrypted and
1471 		 * the frame has already been found to be a Robust Management
1472 		 * Frame (by the other end).
1473 		 */
1474 		if (ieee80211_has_protected(hdr->frame_control))
1475 			return true;
1476 		category = ((u8 *) hdr) + 24;
1477 		return *category != WLAN_CATEGORY_PUBLIC &&
1478 			*category != WLAN_CATEGORY_HT &&
1479 			*category != WLAN_CATEGORY_VENDOR_SPECIFIC;
1480 	}
1481 
1482 	return false;
1483 }
1484 
1485 /**
1486  * ieee80211_fhss_chan_to_freq - get channel frequency
1487  * @channel: the FHSS channel
1488  *
1489  * Convert IEEE802.11 FHSS channel to frequency (MHz)
1490  * Ref IEEE 802.11-2007 section 14.6
1491  */
1492 static inline int ieee80211_fhss_chan_to_freq(int channel)
1493 {
1494 	if ((channel > 1) && (channel < 96))
1495 		return channel + 2400;
1496 	else
1497 		return -1;
1498 }
1499 
1500 /**
1501  * ieee80211_freq_to_fhss_chan - get channel
1502  * @freq: the channels frequency
1503  *
1504  * Convert frequency (MHz) to IEEE802.11 FHSS channel
1505  * Ref IEEE 802.11-2007 section 14.6
1506  */
1507 static inline int ieee80211_freq_to_fhss_chan(int freq)
1508 {
1509 	if ((freq > 2401) && (freq < 2496))
1510 		return freq - 2400;
1511 	else
1512 		return -1;
1513 }
1514 
1515 /**
1516  * ieee80211_dsss_chan_to_freq - get channel center frequency
1517  * @channel: the DSSS channel
1518  *
1519  * Convert IEEE802.11 DSSS channel to the center frequency (MHz).
1520  * Ref IEEE 802.11-2007 section 15.6
1521  */
1522 static inline int ieee80211_dsss_chan_to_freq(int channel)
1523 {
1524 	if ((channel > 0) && (channel < 14))
1525 		return 2407 + (channel * 5);
1526 	else if (channel == 14)
1527 		return 2484;
1528 	else
1529 		return -1;
1530 }
1531 
1532 /**
1533  * ieee80211_freq_to_dsss_chan - get channel
1534  * @freq: the frequency
1535  *
1536  * Convert frequency (MHz) to IEEE802.11 DSSS channel
1537  * Ref IEEE 802.11-2007 section 15.6
1538  *
1539  * This routine selects the channel with the closest center frequency.
1540  */
1541 static inline int ieee80211_freq_to_dsss_chan(int freq)
1542 {
1543 	if ((freq >= 2410) && (freq < 2475))
1544 		return (freq - 2405) / 5;
1545 	else if ((freq >= 2482) && (freq < 2487))
1546 		return 14;
1547 	else
1548 		return -1;
1549 }
1550 
1551 /* Convert IEEE802.11 HR DSSS channel to frequency (MHz) and back
1552  * Ref IEEE 802.11-2007 section 18.4.6.2
1553  *
1554  * The channels and frequencies are the same as those defined for DSSS
1555  */
1556 #define ieee80211_hr_chan_to_freq(chan) ieee80211_dsss_chan_to_freq(chan)
1557 #define ieee80211_freq_to_hr_chan(freq) ieee80211_freq_to_dsss_chan(freq)
1558 
1559 /* Convert IEEE802.11 ERP channel to frequency (MHz) and back
1560  * Ref IEEE 802.11-2007 section 19.4.2
1561  */
1562 #define ieee80211_erp_chan_to_freq(chan) ieee80211_hr_chan_to_freq(chan)
1563 #define ieee80211_freq_to_erp_chan(freq) ieee80211_freq_to_hr_chan(freq)
1564 
1565 /**
1566  * ieee80211_ofdm_chan_to_freq - get channel center frequency
1567  * @s_freq: starting frequency == (dotChannelStartingFactor/2) MHz
1568  * @channel: the OFDM channel
1569  *
1570  * Convert IEEE802.11 OFDM channel to center frequency (MHz)
1571  * Ref IEEE 802.11-2007 section 17.3.8.3.2
1572  */
1573 static inline int ieee80211_ofdm_chan_to_freq(int s_freq, int channel)
1574 {
1575 	if ((channel > 0) && (channel <= 200) &&
1576 	    (s_freq >= 4000))
1577 		return s_freq + (channel * 5);
1578 	else
1579 		return -1;
1580 }
1581 
1582 /**
1583  * ieee80211_freq_to_ofdm_channel - get channel
1584  * @s_freq: starting frequency == (dotChannelStartingFactor/2) MHz
1585  * @freq: the frequency
1586  *
1587  * Convert frequency (MHz) to IEEE802.11 OFDM channel
1588  * Ref IEEE 802.11-2007 section 17.3.8.3.2
1589  *
1590  * This routine selects the channel with the closest center frequency.
1591  */
1592 static inline int ieee80211_freq_to_ofdm_chan(int s_freq, int freq)
1593 {
1594 	if ((freq > (s_freq + 2)) && (freq <= (s_freq + 1202)) &&
1595 	    (s_freq >= 4000))
1596 		return (freq + 2 - s_freq) / 5;
1597 	else
1598 		return -1;
1599 }
1600 
1601 /**
1602  * ieee80211_tu_to_usec - convert time units (TU) to microseconds
1603  * @tu: the TUs
1604  */
1605 static inline unsigned long ieee80211_tu_to_usec(unsigned long tu)
1606 {
1607 	return 1024 * tu;
1608 }
1609 
1610 /**
1611  * ieee80211_check_tim - check if AID bit is set in TIM
1612  * @tim: the TIM IE
1613  * @tim_len: length of the TIM IE
1614  * @aid: the AID to look for
1615  */
1616 static inline bool ieee80211_check_tim(struct ieee80211_tim_ie *tim,
1617 				       u8 tim_len, u16 aid)
1618 {
1619 	u8 mask;
1620 	u8 index, indexn1, indexn2;
1621 
1622 	if (unlikely(!tim || tim_len < sizeof(*tim)))
1623 		return false;
1624 
1625 	aid &= 0x3fff;
1626 	index = aid / 8;
1627 	mask  = 1 << (aid & 7);
1628 
1629 	indexn1 = tim->bitmap_ctrl & 0xfe;
1630 	indexn2 = tim_len + indexn1 - 4;
1631 
1632 	if (index < indexn1 || index > indexn2)
1633 		return false;
1634 
1635 	index -= indexn1;
1636 
1637 	return !!(tim->virtual_map[index] & mask);
1638 }
1639 
1640 #endif /* LINUX_IEEE80211_H */
1641