xref: /freebsd/sys/net80211/ieee80211.h (revision 80a87461087caa71c74d891c5b7cddf0156ad58a)
1 /*-
2  * Copyright (c) 2001 Atsushi Onoe
3  * Copyright (c) 2002-2009 Sam Leffler, Errno Consulting
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  *
26  * $FreeBSD$
27  */
28 #ifndef _NET80211_IEEE80211_H_
29 #define _NET80211_IEEE80211_H_
30 
31 /*
32  * 802.11 protocol definitions.
33  */
34 
35 #define	IEEE80211_ADDR_LEN	6		/* size of 802.11 address */
36 /* is 802.11 address multicast/broadcast? */
37 #define	IEEE80211_IS_MULTICAST(_a)	(*(_a) & 0x01)
38 
39 #ifdef _KERNEL
40 extern const uint8_t ieee80211broadcastaddr[];
41 #endif
42 
43 typedef uint16_t ieee80211_seq;
44 
45 /* IEEE 802.11 PLCP header */
46 struct ieee80211_plcp_hdr {
47 	uint16_t	i_sfd;
48 	uint8_t		i_signal;
49 	uint8_t		i_service;
50 	uint16_t	i_length;
51 	uint16_t	i_crc;
52 } __packed;
53 
54 #define IEEE80211_PLCP_SFD      0xF3A0
55 #define IEEE80211_PLCP_SERVICE  0x00
56 #define IEEE80211_PLCP_SERVICE_LOCKED	0x04
57 #define IEEE80211_PLCL_SERVICE_PBCC	0x08
58 #define IEEE80211_PLCP_SERVICE_LENEXT5	0x20
59 #define IEEE80211_PLCP_SERVICE_LENEXT6	0x40
60 #define IEEE80211_PLCP_SERVICE_LENEXT7	0x80
61 
62 /*
63  * generic definitions for IEEE 802.11 frames
64  */
65 struct ieee80211_frame {
66 	uint8_t		i_fc[2];
67 	uint8_t		i_dur[2];
68 	uint8_t		i_addr1[IEEE80211_ADDR_LEN];
69 	uint8_t		i_addr2[IEEE80211_ADDR_LEN];
70 	uint8_t		i_addr3[IEEE80211_ADDR_LEN];
71 	uint8_t		i_seq[2];
72 	/* possibly followed by addr4[IEEE80211_ADDR_LEN]; */
73 	/* see below */
74 } __packed;
75 
76 struct ieee80211_qosframe {
77 	uint8_t		i_fc[2];
78 	uint8_t		i_dur[2];
79 	uint8_t		i_addr1[IEEE80211_ADDR_LEN];
80 	uint8_t		i_addr2[IEEE80211_ADDR_LEN];
81 	uint8_t		i_addr3[IEEE80211_ADDR_LEN];
82 	uint8_t		i_seq[2];
83 	uint8_t		i_qos[2];
84 	/* possibly followed by addr4[IEEE80211_ADDR_LEN]; */
85 	/* see below */
86 } __packed;
87 
88 struct ieee80211_qoscntl {
89 	uint8_t		i_qos[2];
90 };
91 
92 struct ieee80211_frame_addr4 {
93 	uint8_t		i_fc[2];
94 	uint8_t		i_dur[2];
95 	uint8_t		i_addr1[IEEE80211_ADDR_LEN];
96 	uint8_t		i_addr2[IEEE80211_ADDR_LEN];
97 	uint8_t		i_addr3[IEEE80211_ADDR_LEN];
98 	uint8_t		i_seq[2];
99 	uint8_t		i_addr4[IEEE80211_ADDR_LEN];
100 } __packed;
101 
102 
103 struct ieee80211_qosframe_addr4 {
104 	uint8_t		i_fc[2];
105 	uint8_t		i_dur[2];
106 	uint8_t		i_addr1[IEEE80211_ADDR_LEN];
107 	uint8_t		i_addr2[IEEE80211_ADDR_LEN];
108 	uint8_t		i_addr3[IEEE80211_ADDR_LEN];
109 	uint8_t		i_seq[2];
110 	uint8_t		i_addr4[IEEE80211_ADDR_LEN];
111 	uint8_t		i_qos[2];
112 } __packed;
113 
114 #define	IEEE80211_FC0_VERSION_MASK		0x03
115 #define	IEEE80211_FC0_VERSION_SHIFT		0
116 #define	IEEE80211_FC0_VERSION_0			0x00
117 #define	IEEE80211_FC0_TYPE_MASK			0x0c
118 #define	IEEE80211_FC0_TYPE_SHIFT		2
119 #define	IEEE80211_FC0_TYPE_MGT			0x00
120 #define	IEEE80211_FC0_TYPE_CTL			0x04
121 #define	IEEE80211_FC0_TYPE_DATA			0x08
122 
123 #define	IEEE80211_FC0_SUBTYPE_MASK		0xf0
124 #define	IEEE80211_FC0_SUBTYPE_SHIFT		4
125 /* for TYPE_MGT */
126 #define	IEEE80211_FC0_SUBTYPE_ASSOC_REQ		0x00
127 #define	IEEE80211_FC0_SUBTYPE_ASSOC_RESP	0x10
128 #define	IEEE80211_FC0_SUBTYPE_REASSOC_REQ	0x20
129 #define	IEEE80211_FC0_SUBTYPE_REASSOC_RESP	0x30
130 #define	IEEE80211_FC0_SUBTYPE_PROBE_REQ		0x40
131 #define	IEEE80211_FC0_SUBTYPE_PROBE_RESP	0x50
132 #define	IEEE80211_FC0_SUBTYPE_TIMING_ADV	0x60
133 #define	IEEE80211_FC0_SUBTYPE_BEACON		0x80
134 #define	IEEE80211_FC0_SUBTYPE_ATIM		0x90
135 #define	IEEE80211_FC0_SUBTYPE_DISASSOC		0xa0
136 #define	IEEE80211_FC0_SUBTYPE_AUTH		0xb0
137 #define	IEEE80211_FC0_SUBTYPE_DEAUTH		0xc0
138 #define	IEEE80211_FC0_SUBTYPE_ACTION		0xd0
139 #define	IEEE80211_FC0_SUBTYPE_ACTION_NOACK	0xe0
140 /* for TYPE_CTL */
141 #define	IEEE80211_FC0_SUBTYPE_CONTROL_WRAP	0x70
142 #define	IEEE80211_FC0_SUBTYPE_BAR		0x80
143 #define	IEEE80211_FC0_SUBTYPE_BA		0x90
144 #define	IEEE80211_FC0_SUBTYPE_PS_POLL		0xa0
145 #define	IEEE80211_FC0_SUBTYPE_RTS		0xb0
146 #define	IEEE80211_FC0_SUBTYPE_CTS		0xc0
147 #define	IEEE80211_FC0_SUBTYPE_ACK		0xd0
148 #define	IEEE80211_FC0_SUBTYPE_CF_END		0xe0
149 #define	IEEE80211_FC0_SUBTYPE_CF_END_ACK	0xf0
150 /* for TYPE_DATA (bit combination) */
151 #define	IEEE80211_FC0_SUBTYPE_DATA		0x00
152 #define	IEEE80211_FC0_SUBTYPE_CF_ACK		0x10
153 #define	IEEE80211_FC0_SUBTYPE_CF_POLL		0x20
154 #define	IEEE80211_FC0_SUBTYPE_CF_ACPL		0x30
155 #define	IEEE80211_FC0_SUBTYPE_NODATA		0x40
156 #define	IEEE80211_FC0_SUBTYPE_CFACK		0x50
157 #define	IEEE80211_FC0_SUBTYPE_CFPOLL		0x60
158 #define	IEEE80211_FC0_SUBTYPE_CF_ACK_CF_ACK	0x70
159 #define	IEEE80211_FC0_SUBTYPE_QOS		0x80
160 #define	IEEE80211_FC0_SUBTYPE_QOS_NULL		0xc0
161 
162 #define	IEEE80211_FC1_DIR_MASK			0x03
163 #define	IEEE80211_FC1_DIR_NODS			0x00	/* STA->STA */
164 #define	IEEE80211_FC1_DIR_TODS			0x01	/* STA->AP  */
165 #define	IEEE80211_FC1_DIR_FROMDS		0x02	/* AP ->STA */
166 #define	IEEE80211_FC1_DIR_DSTODS		0x03	/* AP ->AP  */
167 
168 #define	IEEE80211_IS_DSTODS(wh) \
169 	(((wh)->i_fc[1] & IEEE80211_FC1_DIR_MASK) == IEEE80211_FC1_DIR_DSTODS)
170 
171 #define	IEEE80211_FC1_MORE_FRAG			0x04
172 #define	IEEE80211_FC1_RETRY			0x08
173 #define	IEEE80211_FC1_PWR_MGT			0x10
174 #define	IEEE80211_FC1_MORE_DATA			0x20
175 #define	IEEE80211_FC1_PROTECTED			0x40
176 #define	IEEE80211_FC1_ORDER			0x80
177 
178 #define IEEE80211_HAS_SEQ(type, subtype) \
179 	((type) != IEEE80211_FC0_TYPE_CTL && \
180 	!((type) == IEEE80211_FC0_TYPE_DATA && \
181 	 ((subtype) & IEEE80211_FC0_SUBTYPE_QOS_NULL) == \
182 		      IEEE80211_FC0_SUBTYPE_QOS_NULL))
183 #define	IEEE80211_SEQ_FRAG_MASK			0x000f
184 #define	IEEE80211_SEQ_FRAG_SHIFT		0
185 #define	IEEE80211_SEQ_SEQ_MASK			0xfff0
186 #define	IEEE80211_SEQ_SEQ_SHIFT			4
187 #define	IEEE80211_SEQ_RANGE			4096
188 
189 #define	IEEE80211_SEQ_ADD(seq, incr) \
190 	(((seq) + (incr)) & (IEEE80211_SEQ_RANGE-1))
191 #define	IEEE80211_SEQ_INC(seq)	IEEE80211_SEQ_ADD(seq,1)
192 #define	IEEE80211_SEQ_SUB(a, b) \
193 	(((a) + IEEE80211_SEQ_RANGE - (b)) & (IEEE80211_SEQ_RANGE-1))
194 
195 #define	IEEE80211_SEQ_BA_RANGE			2048	/* 2^11 */
196 #define	IEEE80211_SEQ_BA_BEFORE(a, b) \
197 	(IEEE80211_SEQ_SUB(b, a+1) < IEEE80211_SEQ_BA_RANGE-1)
198 
199 #define	IEEE80211_NWID_LEN			32
200 #define	IEEE80211_MESHID_LEN			32
201 
202 #define	IEEE80211_QOS_TXOP			0x00ff
203 /* bit 8 is reserved */
204 #define	IEEE80211_QOS_AMSDU			0x80
205 #define	IEEE80211_QOS_AMSDU_S			7
206 #define	IEEE80211_QOS_ACKPOLICY			0x60
207 #define	IEEE80211_QOS_ACKPOLICY_S		5
208 #define	IEEE80211_QOS_ACKPOLICY_NOACK		0x20	/* No ACK required */
209 #define	IEEE80211_QOS_ACKPOLICY_BA		0x60	/* Block ACK */
210 #define	IEEE80211_QOS_EOSP			0x10	/* EndOfService Period*/
211 #define	IEEE80211_QOS_EOSP_S			4
212 #define	IEEE80211_QOS_TID			0x0f
213 /* qos[1] byte used for all frames sent by mesh STAs in a mesh BSS */
214 #define IEEE80211_QOS_MC			0x01	/* Mesh control */
215 /* Mesh power save level*/
216 #define IEEE80211_QOS_MESH_PSL			0x02
217 /* Mesh Receiver Service Period Initiated */
218 #define IEEE80211_QOS_RSPI			0x04
219 /* bits 11 to 15 reserved */
220 
221 /* does frame have QoS sequence control data */
222 #define	IEEE80211_QOS_HAS_SEQ(wh) \
223 	(((wh)->i_fc[0] & \
224 	  (IEEE80211_FC0_TYPE_MASK | IEEE80211_FC0_SUBTYPE_QOS)) == \
225 	  (IEEE80211_FC0_TYPE_DATA | IEEE80211_FC0_SUBTYPE_QOS))
226 
227 /*
228  * WME/802.11e information element.
229  */
230 struct ieee80211_wme_info {
231 	uint8_t		wme_id;		/* IEEE80211_ELEMID_VENDOR */
232 	uint8_t		wme_len;	/* length in bytes */
233 	uint8_t		wme_oui[3];	/* 0x00, 0x50, 0xf2 */
234 	uint8_t		wme_type;	/* OUI type */
235 	uint8_t		wme_subtype;	/* OUI subtype */
236 	uint8_t		wme_version;	/* spec revision */
237 	uint8_t		wme_info;	/* QoS info */
238 } __packed;
239 
240 /*
241  * WME/802.11e Tspec Element
242  */
243 struct ieee80211_wme_tspec {
244 	uint8_t		ts_id;
245 	uint8_t		ts_len;
246 	uint8_t		ts_oui[3];
247 	uint8_t		ts_oui_type;
248 	uint8_t		ts_oui_subtype;
249 	uint8_t		ts_version;
250 	uint8_t		ts_tsinfo[3];
251 	uint8_t		ts_nom_msdu[2];
252 	uint8_t		ts_max_msdu[2];
253 	uint8_t		ts_min_svc[4];
254 	uint8_t		ts_max_svc[4];
255 	uint8_t		ts_inactv_intv[4];
256 	uint8_t		ts_susp_intv[4];
257 	uint8_t		ts_start_svc[4];
258 	uint8_t		ts_min_rate[4];
259 	uint8_t		ts_mean_rate[4];
260 	uint8_t		ts_max_burst[4];
261 	uint8_t		ts_min_phy[4];
262 	uint8_t		ts_peak_rate[4];
263 	uint8_t		ts_delay[4];
264 	uint8_t		ts_surplus[2];
265 	uint8_t		ts_medium_time[2];
266 } __packed;
267 
268 /*
269  * WME AC parameter field
270  */
271 struct ieee80211_wme_acparams {
272 	uint8_t		acp_aci_aifsn;
273 	uint8_t		acp_logcwminmax;
274 	uint16_t	acp_txop;
275 } __packed;
276 
277 #define WME_NUM_AC		4	/* 4 AC categories */
278 #define	WME_NUM_TID		16	/* 16 tids */
279 
280 #define WME_PARAM_ACI		0x60	/* Mask for ACI field */
281 #define WME_PARAM_ACI_S		5	/* Shift for ACI field */
282 #define WME_PARAM_ACM		0x10	/* Mask for ACM bit */
283 #define WME_PARAM_ACM_S		4	/* Shift for ACM bit */
284 #define WME_PARAM_AIFSN		0x0f	/* Mask for aifsn field */
285 #define WME_PARAM_AIFSN_S	0	/* Shift for aifsn field */
286 #define WME_PARAM_LOGCWMIN	0x0f	/* Mask for CwMin field (in log) */
287 #define WME_PARAM_LOGCWMIN_S	0	/* Shift for CwMin field */
288 #define WME_PARAM_LOGCWMAX	0xf0	/* Mask for CwMax field (in log) */
289 #define WME_PARAM_LOGCWMAX_S	4	/* Shift for CwMax field */
290 
291 #define WME_AC_TO_TID(_ac) (       \
292 	((_ac) == WME_AC_VO) ? 6 : \
293 	((_ac) == WME_AC_VI) ? 5 : \
294 	((_ac) == WME_AC_BK) ? 1 : \
295 	0)
296 
297 #define TID_TO_WME_AC(_tid) (      \
298 	((_tid) == 0 || (_tid) == 3) ? WME_AC_BE : \
299 	((_tid) < 3) ? WME_AC_BK : \
300 	((_tid) < 6) ? WME_AC_VI : \
301 	WME_AC_VO)
302 
303 /*
304  * WME Parameter Element
305  */
306 struct ieee80211_wme_param {
307 	uint8_t		param_id;
308 	uint8_t		param_len;
309 	uint8_t		param_oui[3];
310 	uint8_t		param_oui_type;
311 	uint8_t		param_oui_subtype;
312 	uint8_t		param_version;
313 	uint8_t		param_qosInfo;
314 #define	WME_QOSINFO_COUNT	0x0f	/* Mask for param count field */
315 	uint8_t		param_reserved;
316 	struct ieee80211_wme_acparams	params_acParams[WME_NUM_AC];
317 } __packed;
318 
319 /*
320  * Management Notification Frame
321  */
322 struct ieee80211_mnf {
323 	uint8_t		mnf_category;
324 	uint8_t		mnf_action;
325 	uint8_t		mnf_dialog;
326 	uint8_t		mnf_status;
327 } __packed;
328 #define	MNF_SETUP_REQ	0
329 #define	MNF_SETUP_RESP	1
330 #define	MNF_TEARDOWN	2
331 
332 /*
333  * 802.11n Management Action Frames
334  */
335 /* generic frame format */
336 struct ieee80211_action {
337 	uint8_t		ia_category;
338 	uint8_t		ia_action;
339 } __packed;
340 
341 #define	IEEE80211_ACTION_CAT_SM		0	/* Spectrum Management */
342 #define	IEEE80211_ACTION_CAT_QOS	1	/* QoS */
343 #define	IEEE80211_ACTION_CAT_DLS	2	/* DLS */
344 #define	IEEE80211_ACTION_CAT_BA		3	/* BA */
345 #define	IEEE80211_ACTION_CAT_HT		7	/* HT */
346 #define	IEEE80211_ACTION_CAT_MESH	13	/* Mesh */
347 #define	IEEE80211_ACTION_CAT_SELF_PROT	15	/* Self-protected */
348 /* 16 - 125 reserved */
349 #define	IEEE80211_ACTION_CAT_VENDOR	127	/* Vendor Specific */
350 
351 #define	IEEE80211_ACTION_HT_TXCHWIDTH	0	/* recommended xmit chan width*/
352 #define	IEEE80211_ACTION_HT_MIMOPWRSAVE	1	/* MIMO power save */
353 
354 /* HT - recommended transmission channel width */
355 struct ieee80211_action_ht_txchwidth {
356 	struct ieee80211_action	at_header;
357 	uint8_t		at_chwidth;
358 } __packed;
359 
360 #define	IEEE80211_A_HT_TXCHWIDTH_20	0
361 #define	IEEE80211_A_HT_TXCHWIDTH_2040	1
362 
363 /* HT - MIMO Power Save (NB: D2.04) */
364 struct ieee80211_action_ht_mimopowersave {
365 	struct ieee80211_action am_header;
366 	uint8_t		am_control;
367 } __packed;
368 
369 #define	IEEE80211_A_HT_MIMOPWRSAVE_ENA		0x01	/* PS enabled */
370 #define	IEEE80211_A_HT_MIMOPWRSAVE_MODE		0x02
371 #define	IEEE80211_A_HT_MIMOPWRSAVE_MODE_S	1
372 #define	IEEE80211_A_HT_MIMOPWRSAVE_DYNAMIC	0x02	/* Dynamic Mode */
373 #define	IEEE80211_A_HT_MIMOPWRSAVE_STATIC	0x00	/* no SM packets */
374 /* bits 2-7 reserved */
375 
376 /* Block Ack actions */
377 #define IEEE80211_ACTION_BA_ADDBA_REQUEST       0   /* ADDBA request */
378 #define IEEE80211_ACTION_BA_ADDBA_RESPONSE      1   /* ADDBA response */
379 #define IEEE80211_ACTION_BA_DELBA	        2   /* DELBA */
380 
381 /* Block Ack Parameter Set */
382 #define	IEEE80211_BAPS_BUFSIZ	0xffc0		/* buffer size */
383 #define	IEEE80211_BAPS_BUFSIZ_S	6
384 #define	IEEE80211_BAPS_TID	0x003c		/* TID */
385 #define	IEEE80211_BAPS_TID_S	2
386 #define	IEEE80211_BAPS_POLICY	0x0002		/* block ack policy */
387 #define	IEEE80211_BAPS_POLICY_S	1
388 
389 #define	IEEE80211_BAPS_POLICY_DELAYED	(0<<IEEE80211_BAPS_POLICY_S)
390 #define	IEEE80211_BAPS_POLICY_IMMEDIATE	(1<<IEEE80211_BAPS_POLICY_S)
391 
392 /* Block Ack Sequence Control */
393 #define	IEEE80211_BASEQ_START	0xfff0		/* starting seqnum */
394 #define	IEEE80211_BASEQ_START_S	4
395 #define	IEEE80211_BASEQ_FRAG	0x000f		/* fragment number */
396 #define	IEEE80211_BASEQ_FRAG_S	0
397 
398 /* Delayed Block Ack Parameter Set */
399 #define	IEEE80211_DELBAPS_TID	0xf000		/* TID */
400 #define	IEEE80211_DELBAPS_TID_S	12
401 #define	IEEE80211_DELBAPS_INIT	0x0800		/* initiator */
402 #define	IEEE80211_DELBAPS_INIT_S 11
403 
404 /* BA - ADDBA request */
405 struct ieee80211_action_ba_addbarequest {
406 	struct ieee80211_action rq_header;
407 	uint8_t		rq_dialogtoken;
408 	uint16_t	rq_baparamset;
409 	uint16_t	rq_batimeout;		/* in TUs */
410 	uint16_t	rq_baseqctl;
411 } __packed;
412 
413 /* BA - ADDBA response */
414 struct ieee80211_action_ba_addbaresponse {
415 	struct ieee80211_action rs_header;
416 	uint8_t		rs_dialogtoken;
417 	uint16_t	rs_statuscode;
418 	uint16_t	rs_baparamset;
419 	uint16_t	rs_batimeout;		/* in TUs */
420 } __packed;
421 
422 /* BA - DELBA */
423 struct ieee80211_action_ba_delba {
424 	struct ieee80211_action dl_header;
425 	uint16_t	dl_baparamset;
426 	uint16_t	dl_reasoncode;
427 } __packed;
428 
429 /* BAR Control */
430 #define	IEEE80211_BAR_TID	0xf000		/* TID */
431 #define	IEEE80211_BAR_TID_S	12
432 #define	IEEE80211_BAR_COMP	0x0004		/* Compressed Bitmap */
433 #define	IEEE80211_BAR_MTID	0x0002		/* Multi-TID */
434 #define	IEEE80211_BAR_NOACK	0x0001		/* No-Ack policy */
435 
436 /* BAR Starting Sequence Control */
437 #define	IEEE80211_BAR_SEQ_START	0xfff0		/* starting seqnum */
438 #define	IEEE80211_BAR_SEQ_START_S	4
439 
440 struct ieee80211_ba_request {
441 	uint16_t	rq_barctl;
442 	uint16_t	rq_barseqctl;
443 } __packed;
444 
445 /*
446  * Control frames.
447  */
448 struct ieee80211_frame_min {
449 	uint8_t		i_fc[2];
450 	uint8_t		i_dur[2];
451 	uint8_t		i_addr1[IEEE80211_ADDR_LEN];
452 	uint8_t		i_addr2[IEEE80211_ADDR_LEN];
453 	/* FCS */
454 } __packed;
455 
456 struct ieee80211_frame_rts {
457 	uint8_t		i_fc[2];
458 	uint8_t		i_dur[2];
459 	uint8_t		i_ra[IEEE80211_ADDR_LEN];
460 	uint8_t		i_ta[IEEE80211_ADDR_LEN];
461 	/* FCS */
462 } __packed;
463 
464 struct ieee80211_frame_cts {
465 	uint8_t		i_fc[2];
466 	uint8_t		i_dur[2];
467 	uint8_t		i_ra[IEEE80211_ADDR_LEN];
468 	/* FCS */
469 } __packed;
470 
471 struct ieee80211_frame_ack {
472 	uint8_t		i_fc[2];
473 	uint8_t		i_dur[2];
474 	uint8_t		i_ra[IEEE80211_ADDR_LEN];
475 	/* FCS */
476 } __packed;
477 
478 struct ieee80211_frame_pspoll {
479 	uint8_t		i_fc[2];
480 	uint8_t		i_aid[2];
481 	uint8_t		i_bssid[IEEE80211_ADDR_LEN];
482 	uint8_t		i_ta[IEEE80211_ADDR_LEN];
483 	/* FCS */
484 } __packed;
485 
486 struct ieee80211_frame_cfend {		/* NB: also CF-End+CF-Ack */
487 	uint8_t		i_fc[2];
488 	uint8_t		i_dur[2];	/* should be zero */
489 	uint8_t		i_ra[IEEE80211_ADDR_LEN];
490 	uint8_t		i_bssid[IEEE80211_ADDR_LEN];
491 	/* FCS */
492 } __packed;
493 
494 struct ieee80211_frame_bar {
495 	uint8_t		i_fc[2];
496 	uint8_t		i_dur[2];
497 	uint8_t		i_ra[IEEE80211_ADDR_LEN];
498 	uint8_t		i_ta[IEEE80211_ADDR_LEN];
499 	uint16_t	i_ctl;
500 	uint16_t	i_seq;
501 	/* FCS */
502 } __packed;
503 
504 /*
505  * BEACON management packets
506  *
507  *	octet timestamp[8]
508  *	octet beacon interval[2]
509  *	octet capability information[2]
510  *	information element
511  *		octet elemid
512  *		octet length
513  *		octet information[length]
514  */
515 
516 #define	IEEE80211_BEACON_INTERVAL(beacon) \
517 	((beacon)[8] | ((beacon)[9] << 8))
518 #define	IEEE80211_BEACON_CAPABILITY(beacon) \
519 	((beacon)[10] | ((beacon)[11] << 8))
520 
521 #define	IEEE80211_CAPINFO_ESS			0x0001
522 #define	IEEE80211_CAPINFO_IBSS			0x0002
523 #define	IEEE80211_CAPINFO_CF_POLLABLE		0x0004
524 #define	IEEE80211_CAPINFO_CF_POLLREQ		0x0008
525 #define	IEEE80211_CAPINFO_PRIVACY		0x0010
526 #define	IEEE80211_CAPINFO_SHORT_PREAMBLE	0x0020
527 #define	IEEE80211_CAPINFO_PBCC			0x0040
528 #define	IEEE80211_CAPINFO_CHNL_AGILITY		0x0080
529 #define	IEEE80211_CAPINFO_SPECTRUM_MGMT		0x0100
530 /* bit 9 is reserved */
531 #define	IEEE80211_CAPINFO_SHORT_SLOTTIME	0x0400
532 #define	IEEE80211_CAPINFO_RSN			0x0800
533 /* bit 12 is reserved */
534 #define	IEEE80211_CAPINFO_DSSSOFDM		0x2000
535 /* bits 14-15 are reserved */
536 
537 #define	IEEE80211_CAPINFO_BITS \
538 	"\20\1ESS\2IBSS\3CF_POLLABLE\4CF_POLLREQ\5PRIVACY\6SHORT_PREAMBLE" \
539 	"\7PBCC\10CHNL_AGILITY\11SPECTRUM_MGMT\13SHORT_SLOTTIME\14RSN" \
540 	"\16DSSOFDM"
541 
542 /*
543  * 802.11i/WPA information element (maximally sized).
544  */
545 struct ieee80211_ie_wpa {
546 	uint8_t		wpa_id;		/* IEEE80211_ELEMID_VENDOR */
547 	uint8_t		wpa_len;	/* length in bytes */
548 	uint8_t		wpa_oui[3];	/* 0x00, 0x50, 0xf2 */
549 	uint8_t		wpa_type;	/* OUI type */
550 	uint16_t	wpa_version;	/* spec revision */
551 	uint32_t	wpa_mcipher[1];	/* multicast/group key cipher */
552 	uint16_t	wpa_uciphercnt;	/* # pairwise key ciphers */
553 	uint32_t	wpa_uciphers[8];/* ciphers */
554 	uint16_t	wpa_authselcnt;	/* authentication selector cnt*/
555 	uint32_t	wpa_authsels[8];/* selectors */
556 	uint16_t	wpa_caps;	/* 802.11i capabilities */
557 	uint16_t	wpa_pmkidcnt;	/* 802.11i pmkid count */
558 	uint16_t	wpa_pmkids[8];	/* 802.11i pmkids */
559 } __packed;
560 
561 /*
562  * 802.11n HT Capability IE
563  * NB: these reflect D1.10
564  */
565 struct ieee80211_ie_htcap {
566 	uint8_t		hc_id;			/* element ID */
567 	uint8_t		hc_len;			/* length in bytes */
568 	uint16_t	hc_cap;			/* HT caps (see below) */
569 	uint8_t		hc_param;		/* HT params (see below) */
570 	uint8_t 	hc_mcsset[16]; 		/* supported MCS set */
571 	uint16_t	hc_extcap;		/* extended HT capabilities */
572 	uint32_t	hc_txbf;		/* txbf capabilities */
573 	uint8_t		hc_antenna;		/* antenna capabilities */
574 } __packed;
575 
576 /* HT capability flags (ht_cap) */
577 #define	IEEE80211_HTCAP_LDPC		0x0001	/* LDPC supported */
578 #define	IEEE80211_HTCAP_CHWIDTH40	0x0002	/* 20/40 supported */
579 #define	IEEE80211_HTCAP_SMPS		0x000c	/* SM Power Save mode */
580 #define	IEEE80211_HTCAP_SMPS_OFF	0x000c	/* disabled */
581 #define	IEEE80211_HTCAP_SMPS_DYNAMIC	0x0004	/* send RTS first */
582 /* NB: SMPS value 2 is reserved */
583 #define	IEEE80211_HTCAP_SMPS_ENA	0x0000	/* enabled (static mode) */
584 #define	IEEE80211_HTCAP_GREENFIELD	0x0010	/* Greenfield supported */
585 #define	IEEE80211_HTCAP_SHORTGI20	0x0020	/* Short GI in 20MHz */
586 #define	IEEE80211_HTCAP_SHORTGI40	0x0040	/* Short GI in 40MHz */
587 #define	IEEE80211_HTCAP_TXSTBC		0x0080	/* STBC tx ok */
588 #define	IEEE80211_HTCAP_RXSTBC		0x0300  /* STBC rx support */
589 #define	IEEE80211_HTCAP_RXSTBC_S	8
590 #define	IEEE80211_HTCAP_RXSTBC_1STREAM	0x0100  /* 1 spatial stream */
591 #define	IEEE80211_HTCAP_RXSTBC_2STREAM	0x0200  /* 1-2 spatial streams*/
592 #define	IEEE80211_HTCAP_RXSTBC_3STREAM	0x0300  /* 1-3 spatial streams*/
593 #define	IEEE80211_HTCAP_DELBA		0x0400	/* HT DELBA supported */
594 #define	IEEE80211_HTCAP_MAXAMSDU	0x0800	/* max A-MSDU length */
595 #define	IEEE80211_HTCAP_MAXAMSDU_7935	0x0800	/* 7935 octets */
596 #define	IEEE80211_HTCAP_MAXAMSDU_3839	0x0000	/* 3839 octets */
597 #define	IEEE80211_HTCAP_DSSSCCK40	0x1000  /* DSSS/CCK in 40MHz */
598 #define	IEEE80211_HTCAP_PSMP		0x2000  /* PSMP supported */
599 #define	IEEE80211_HTCAP_40INTOLERANT	0x4000  /* 40MHz intolerant */
600 #define	IEEE80211_HTCAP_LSIGTXOPPROT	0x8000  /* L-SIG TXOP prot */
601 
602 #define	IEEE80211_HTCAP_BITS \
603 	"\20\1LDPC\2CHWIDTH40\5GREENFIELD\6SHORTGI20\7SHORTGI40\10TXSTBC" \
604 	"\13DELBA\14AMSDU(7935)\15DSSSCCK40\16PSMP\1740INTOLERANT" \
605 	"\20LSIGTXOPPROT"
606 
607 /* HT parameters (hc_param) */
608 #define	IEEE80211_HTCAP_MAXRXAMPDU	0x03	/* max rx A-MPDU factor */
609 #define	IEEE80211_HTCAP_MAXRXAMPDU_S	0
610 #define	IEEE80211_HTCAP_MAXRXAMPDU_8K	0
611 #define	IEEE80211_HTCAP_MAXRXAMPDU_16K	1
612 #define	IEEE80211_HTCAP_MAXRXAMPDU_32K	2
613 #define	IEEE80211_HTCAP_MAXRXAMPDU_64K	3
614 #define	IEEE80211_HTCAP_MPDUDENSITY	0x1c	/* min MPDU start spacing */
615 #define	IEEE80211_HTCAP_MPDUDENSITY_S	2
616 #define	IEEE80211_HTCAP_MPDUDENSITY_NA	0	/* no time restriction */
617 #define	IEEE80211_HTCAP_MPDUDENSITY_025	1	/* 1/4 us */
618 #define	IEEE80211_HTCAP_MPDUDENSITY_05	2	/* 1/2 us */
619 #define	IEEE80211_HTCAP_MPDUDENSITY_1	3	/* 1 us */
620 #define	IEEE80211_HTCAP_MPDUDENSITY_2	4	/* 2 us */
621 #define	IEEE80211_HTCAP_MPDUDENSITY_4	5	/* 4 us */
622 #define	IEEE80211_HTCAP_MPDUDENSITY_8	6	/* 8 us */
623 #define	IEEE80211_HTCAP_MPDUDENSITY_16	7	/* 16 us */
624 
625 /* HT extended capabilities (hc_extcap) */
626 #define	IEEE80211_HTCAP_PCO		0x0001	/* PCO capable */
627 #define	IEEE80211_HTCAP_PCOTRANS	0x0006	/* PCO transition time */
628 #define	IEEE80211_HTCAP_PCOTRANS_S	1
629 #define	IEEE80211_HTCAP_PCOTRANS_04	0x0002	/* 400 us */
630 #define	IEEE80211_HTCAP_PCOTRANS_15	0x0004	/* 1.5 ms */
631 #define	IEEE80211_HTCAP_PCOTRANS_5	0x0006	/* 5 ms */
632 /* bits 3-7 reserved */
633 #define	IEEE80211_HTCAP_MCSFBACK	0x0300	/* MCS feedback */
634 #define	IEEE80211_HTCAP_MCSFBACK_S	8
635 #define	IEEE80211_HTCAP_MCSFBACK_NONE	0x0000	/* nothing provided */
636 #define	IEEE80211_HTCAP_MCSFBACK_UNSOL	0x0200	/* unsolicited feedback */
637 #define	IEEE80211_HTCAP_MCSFBACK_MRQ	0x0300	/* " "+respond to MRQ */
638 #define	IEEE80211_HTCAP_HTC		0x0400	/* +HTC support */
639 #define	IEEE80211_HTCAP_RDR		0x0800	/* reverse direction responder*/
640 /* bits 12-15 reserved */
641 
642 /*
643  * 802.11n HT Information IE
644  */
645 struct ieee80211_ie_htinfo {
646 	uint8_t		hi_id;			/* element ID */
647 	uint8_t		hi_len;			/* length in bytes */
648 	uint8_t		hi_ctrlchannel;		/* primary channel */
649 	uint8_t		hi_byte1;		/* ht ie byte 1 */
650 	uint8_t		hi_byte2;		/* ht ie byte 2 */
651 	uint8_t		hi_byte3;		/* ht ie byte 3 */
652 	uint16_t	hi_byte45;		/* ht ie bytes 4+5 */
653 	uint8_t 	hi_basicmcsset[16]; 	/* basic MCS set */
654 } __packed;
655 
656 /* byte1 */
657 #define	IEEE80211_HTINFO_2NDCHAN	0x03	/* secondary/ext chan offset */
658 #define	IEEE80211_HTINFO_2NDCHAN_S	0
659 #define	IEEE80211_HTINFO_2NDCHAN_NONE	0x00	/* no secondary/ext channel */
660 #define	IEEE80211_HTINFO_2NDCHAN_ABOVE	0x01	/* above private channel */
661 /* NB: 2 is reserved */
662 #define	IEEE80211_HTINFO_2NDCHAN_BELOW	0x03	/* below primary channel */
663 #define	IEEE80211_HTINFO_TXWIDTH	0x04	/* tx channel width */
664 #define	IEEE80211_HTINFO_TXWIDTH_20	0x00	/* 20MHz width */
665 #define	IEEE80211_HTINFO_TXWIDTH_2040	0x04	/* any supported width */
666 #define	IEEE80211_HTINFO_RIFSMODE	0x08	/* Reduced IFS (RIFS) use */
667 #define	IEEE80211_HTINFO_RIFSMODE_PROH	0x00	/* RIFS use prohibited */
668 #define	IEEE80211_HTINFO_RIFSMODE_PERM	0x08	/* RIFS use permitted */
669 #define	IEEE80211_HTINFO_PMSPONLY	0x10	/* PSMP required to associate */
670 #define	IEEE80211_HTINFO_SIGRAN		0xe0	/* shortest Service Interval */
671 #define	IEEE80211_HTINFO_SIGRAN_S	5
672 #define	IEEE80211_HTINFO_SIGRAN_5	0x00	/* 5 ms */
673 /* XXX add rest */
674 
675 /* bytes 2+3 */
676 #define	IEEE80211_HTINFO_OPMODE		0x03	/* operating mode */
677 #define	IEEE80211_HTINFO_OPMODE_S	0
678 #define	IEEE80211_HTINFO_OPMODE_PURE	0x00	/* no protection */
679 #define	IEEE80211_HTINFO_OPMODE_PROTOPT	0x01	/* protection optional */
680 #define	IEEE80211_HTINFO_OPMODE_HT20PR	0x02	/* protection for HT20 sta's */
681 #define	IEEE80211_HTINFO_OPMODE_MIXED	0x03	/* protection for legacy sta's*/
682 #define	IEEE80211_HTINFO_NONGF_PRESENT	0x04	/* non-GF sta's present */
683 #define	IEEE80211_HTINFO_TXBL		0x08	/* transmit burst limit */
684 #define	IEEE80211_HTINFO_NONHT_PRESENT	0x10	/* non-HT sta's present */
685 /* bits 5-15 reserved */
686 
687 /* bytes 4+5 */
688 #define	IEEE80211_HTINFO_2NDARYBEACON	0x01
689 #define	IEEE80211_HTINFO_LSIGTXOPPROT	0x02
690 #define	IEEE80211_HTINFO_PCO_ACTIVE	0x04
691 #define	IEEE80211_HTINFO_40MHZPHASE	0x08
692 
693 /* byte5 */
694 #define	IEEE80211_HTINFO_BASIC_STBCMCS	0x7f
695 #define	IEEE80211_HTINFO_BASIC_STBCMCS_S 0
696 #define	IEEE80211_HTINFO_DUALPROTECTED	0x80
697 
698 /*
699  * Management information element payloads.
700  */
701 
702 enum {
703 	IEEE80211_ELEMID_SSID		= 0,
704 	IEEE80211_ELEMID_RATES		= 1,
705 	IEEE80211_ELEMID_FHPARMS	= 2,
706 	IEEE80211_ELEMID_DSPARMS	= 3,
707 	IEEE80211_ELEMID_CFPARMS	= 4,
708 	IEEE80211_ELEMID_TIM		= 5,
709 	IEEE80211_ELEMID_IBSSPARMS	= 6,
710 	IEEE80211_ELEMID_COUNTRY	= 7,
711 	IEEE80211_ELEMID_CHALLENGE	= 16,
712 	/* 17-31 reserved for challenge text extension */
713 	IEEE80211_ELEMID_PWRCNSTR	= 32,
714 	IEEE80211_ELEMID_PWRCAP		= 33,
715 	IEEE80211_ELEMID_TPCREQ		= 34,
716 	IEEE80211_ELEMID_TPCREP		= 35,
717 	IEEE80211_ELEMID_SUPPCHAN	= 36,
718 	IEEE80211_ELEMID_CSA		= 37,
719 	IEEE80211_ELEMID_MEASREQ	= 38,
720 	IEEE80211_ELEMID_MEASREP	= 39,
721 	IEEE80211_ELEMID_QUIET		= 40,
722 	IEEE80211_ELEMID_IBSSDFS	= 41,
723 	IEEE80211_ELEMID_ERP		= 42,
724 	IEEE80211_ELEMID_HTCAP		= 45,
725 	IEEE80211_ELEMID_QOS		= 46,
726 	IEEE80211_ELEMID_RSN		= 48,
727 	IEEE80211_ELEMID_XRATES		= 50,
728 	IEEE80211_ELEMID_HTINFO		= 61,
729 	IEEE80211_ELEMID_TPC		= 150,
730 	IEEE80211_ELEMID_CCKM		= 156,
731 	IEEE80211_ELEMID_VENDOR		= 221,	/* vendor private */
732 
733 	/*
734 	 * 802.11s IEs
735 	 * NB: On vanilla Linux still IEEE80211_ELEMID_MESHPEER = 55,
736 	 * but they defined a new with id 117 called PEER_MGMT.
737 	 * NB: complies with open80211
738 	 */
739 	IEEE80211_ELEMID_MESHCONF	= 113,
740 	IEEE80211_ELEMID_MESHID		= 114,
741 	IEEE80211_ELEMID_MESHLINK	= 115,
742 	IEEE80211_ELEMID_MESHCNGST	= 116,
743 	IEEE80211_ELEMID_MESHPEER	= 117,
744 	IEEE80211_ELEMID_MESHCSA	= 118,
745 	IEEE80211_ELEMID_MESHTIM	= 39, /* XXX: remove */
746 	IEEE80211_ELEMID_MESHAWAKEW	= 119,
747 	IEEE80211_ELEMID_MESHBEACONT	= 120,
748 	/* 121-124 MMCAOP not implemented yet */
749 	IEEE80211_ELEMID_MESHGANN	= 125,
750 	IEEE80211_ELEMID_MESHRANN	= 126,
751 	/* 127 Extended Capabilities */
752 	/* 128-129 reserved */
753 	IEEE80211_ELEMID_MESHPREQ	= 130,
754 	IEEE80211_ELEMID_MESHPREP	= 131,
755 	IEEE80211_ELEMID_MESHPERR	= 132,
756 	/* 133-136 reserved */
757 	IEEE80211_ELEMID_MESHPXU	= 137,
758 	IEEE80211_ELEMID_MESHPXUC	= 138,
759 	IEEE80211_ELEMID_MESHAH		= 60, /* XXX: remove */
760 };
761 
762 struct ieee80211_tim_ie {
763 	uint8_t		tim_ie;			/* IEEE80211_ELEMID_TIM */
764 	uint8_t		tim_len;
765 	uint8_t		tim_count;		/* DTIM count */
766 	uint8_t		tim_period;		/* DTIM period */
767 	uint8_t		tim_bitctl;		/* bitmap control */
768 	uint8_t		tim_bitmap[1];		/* variable-length bitmap */
769 } __packed;
770 
771 struct ieee80211_country_ie {
772 	uint8_t		ie;			/* IEEE80211_ELEMID_COUNTRY */
773 	uint8_t		len;
774 	uint8_t		cc[3];			/* ISO CC+(I)ndoor/(O)utdoor */
775 	struct {
776 		uint8_t schan;			/* starting channel */
777 		uint8_t nchan;			/* number channels */
778 		uint8_t maxtxpwr;		/* tx power cap */
779 	} __packed band[1];			/* sub bands (NB: var size) */
780 } __packed;
781 
782 #define	IEEE80211_COUNTRY_MAX_BANDS	84	/* max possible bands */
783 #define	IEEE80211_COUNTRY_MAX_SIZE \
784 	(sizeof(struct ieee80211_country_ie) + 3*(IEEE80211_COUNTRY_MAX_BANDS-1))
785 
786 /*
787  * 802.11h Quiet Time Element.
788  */
789 struct ieee80211_quiet_ie {
790 	uint8_t		quiet_ie;		/* IEEE80211_ELEMID_QUIET */
791 	uint8_t		len;
792 	uint8_t		tbttcount;		/* quiet start */
793 	uint8_t		period;			/* beacon intervals between quiets */
794 	uint16_t	duration;		/* TUs of each quiet*/
795 	uint16_t	offset;			/* TUs of from TBTT of quiet start */
796 } __packed;
797 
798 /*
799  * 802.11h Channel Switch Announcement (CSA).
800  */
801 struct ieee80211_csa_ie {
802 	uint8_t		csa_ie;		/* IEEE80211_ELEMID_CHANSWITCHANN */
803 	uint8_t		csa_len;
804 	uint8_t		csa_mode;		/* Channel Switch Mode */
805 	uint8_t		csa_newchan;		/* New Channel Number */
806 	uint8_t		csa_count;		/* Channel Switch Count */
807 } __packed;
808 
809 /*
810  * Note the min acceptable CSA count is used to guard against
811  * malicious CSA injection in station mode.  Defining this value
812  * as other than 0 violates the 11h spec.
813  */
814 #define	IEEE80211_CSA_COUNT_MIN	2
815 #define	IEEE80211_CSA_COUNT_MAX	255
816 
817 /* rate set entries are in .5 Mb/s units, and potentially marked as basic */
818 #define	IEEE80211_RATE_BASIC		0x80
819 #define	IEEE80211_RATE_VAL		0x7f
820 #define	IEEE80211_RV(v)			((v) & IEEE80211_RATE_VAL)
821 
822 /* ERP information element flags */
823 #define	IEEE80211_ERP_NON_ERP_PRESENT	0x01
824 #define	IEEE80211_ERP_USE_PROTECTION	0x02
825 #define	IEEE80211_ERP_LONG_PREAMBLE	0x04
826 
827 #define	IEEE80211_ERP_BITS \
828 	"\20\1NON_ERP_PRESENT\2USE_PROTECTION\3LONG_PREAMBLE"
829 
830 #define	ATH_OUI			0x7f0300	/* Atheros OUI */
831 #define	ATH_OUI_TYPE		0x01		/* Atheros protocol ie */
832 
833 /* NB: Atheros allocated the OUI for this purpose ~2005 but beware ... */
834 #define	TDMA_OUI		ATH_OUI
835 #define	TDMA_OUI_TYPE		0x02		/* TDMA protocol ie */
836 
837 #define	BCM_OUI			0x4c9000	/* Broadcom OUI */
838 #define	BCM_OUI_HTCAP		51		/* pre-draft HTCAP ie */
839 #define	BCM_OUI_HTINFO		52		/* pre-draft HTINFO ie */
840 
841 #define	WPA_OUI			0xf25000
842 #define	WPA_OUI_TYPE		0x01
843 #define	WPA_VERSION		1		/* current supported version */
844 
845 #define	WPA_CSE_NULL		0x00
846 #define	WPA_CSE_WEP40		0x01
847 #define	WPA_CSE_TKIP		0x02
848 #define	WPA_CSE_CCMP		0x04
849 #define	WPA_CSE_WEP104		0x05
850 
851 #define	WPA_ASE_NONE		0x00
852 #define	WPA_ASE_8021X_UNSPEC	0x01
853 #define	WPA_ASE_8021X_PSK	0x02
854 
855 #define	WPS_OUI_TYPE		0x04
856 
857 #define	RSN_OUI			0xac0f00
858 #define	RSN_VERSION		1		/* current supported version */
859 
860 #define	RSN_CSE_NULL		0x00
861 #define	RSN_CSE_WEP40		0x01
862 #define	RSN_CSE_TKIP		0x02
863 #define	RSN_CSE_WRAP		0x03
864 #define	RSN_CSE_CCMP		0x04
865 #define	RSN_CSE_WEP104		0x05
866 
867 #define	RSN_ASE_NONE		0x00
868 #define	RSN_ASE_8021X_UNSPEC	0x01
869 #define	RSN_ASE_8021X_PSK	0x02
870 
871 #define	RSN_CAP_PREAUTH		0x01
872 
873 #define	WME_OUI			0xf25000
874 #define	WME_OUI_TYPE		0x02
875 #define	WME_INFO_OUI_SUBTYPE	0x00
876 #define	WME_PARAM_OUI_SUBTYPE	0x01
877 #define	WME_VERSION		1
878 
879 /* WME stream classes */
880 #define	WME_AC_BE	0		/* best effort */
881 #define	WME_AC_BK	1		/* background */
882 #define	WME_AC_VI	2		/* video */
883 #define	WME_AC_VO	3		/* voice */
884 
885 /*
886  * AUTH management packets
887  *
888  *	octet algo[2]
889  *	octet seq[2]
890  *	octet status[2]
891  *	octet chal.id
892  *	octet chal.length
893  *	octet chal.text[253]		NB: 1-253 bytes
894  */
895 
896 /* challenge length for shared key auth */
897 #define IEEE80211_CHALLENGE_LEN		128
898 
899 #define	IEEE80211_AUTH_ALG_OPEN		0x0000
900 #define	IEEE80211_AUTH_ALG_SHARED	0x0001
901 #define	IEEE80211_AUTH_ALG_LEAP		0x0080
902 
903 enum {
904 	IEEE80211_AUTH_OPEN_REQUEST		= 1,
905 	IEEE80211_AUTH_OPEN_RESPONSE		= 2,
906 };
907 
908 enum {
909 	IEEE80211_AUTH_SHARED_REQUEST		= 1,
910 	IEEE80211_AUTH_SHARED_CHALLENGE		= 2,
911 	IEEE80211_AUTH_SHARED_RESPONSE		= 3,
912 	IEEE80211_AUTH_SHARED_PASS		= 4,
913 };
914 
915 /*
916  * Reason and status codes.
917  *
918  * Reason codes are used in management frames to indicate why an
919  * action took place (e.g. on disassociation).  Status codes are
920  * used in management frames to indicate the result of an operation.
921  *
922  * Unlisted codes are reserved
923  */
924 
925 enum {
926 	IEEE80211_REASON_UNSPECIFIED		= 1,
927 	IEEE80211_REASON_AUTH_EXPIRE		= 2,
928 	IEEE80211_REASON_AUTH_LEAVE		= 3,
929 	IEEE80211_REASON_ASSOC_EXPIRE		= 4,
930 	IEEE80211_REASON_ASSOC_TOOMANY		= 5,
931 	IEEE80211_REASON_NOT_AUTHED		= 6,
932 	IEEE80211_REASON_NOT_ASSOCED		= 7,
933 	IEEE80211_REASON_ASSOC_LEAVE		= 8,
934 	IEEE80211_REASON_ASSOC_NOT_AUTHED	= 9,
935 	IEEE80211_REASON_DISASSOC_PWRCAP_BAD	= 10,	/* 11h */
936 	IEEE80211_REASON_DISASSOC_SUPCHAN_BAD	= 11,	/* 11h */
937 	IEEE80211_REASON_IE_INVALID		= 13,	/* 11i */
938 	IEEE80211_REASON_MIC_FAILURE		= 14,	/* 11i */
939 	IEEE80211_REASON_4WAY_HANDSHAKE_TIMEOUT	= 15,	/* 11i */
940 	IEEE80211_REASON_GROUP_KEY_UPDATE_TIMEOUT = 16,	/* 11i */
941 	IEEE80211_REASON_IE_IN_4WAY_DIFFERS	= 17,	/* 11i */
942 	IEEE80211_REASON_GROUP_CIPHER_INVALID	= 18,	/* 11i */
943 	IEEE80211_REASON_PAIRWISE_CIPHER_INVALID= 19,	/* 11i */
944 	IEEE80211_REASON_AKMP_INVALID		= 20,	/* 11i */
945 	IEEE80211_REASON_UNSUPP_RSN_IE_VERSION	= 21,	/* 11i */
946 	IEEE80211_REASON_INVALID_RSN_IE_CAP	= 22,	/* 11i */
947 	IEEE80211_REASON_802_1X_AUTH_FAILED	= 23,	/* 11i */
948 	IEEE80211_REASON_CIPHER_SUITE_REJECTED	= 24,	/* 11i */
949 	IEEE80211_REASON_UNSPECIFIED_QOS	= 32,	/* 11e */
950 	IEEE80211_REASON_INSUFFICIENT_BW	= 33,	/* 11e */
951 	IEEE80211_REASON_TOOMANY_FRAMES		= 34,	/* 11e */
952 	IEEE80211_REASON_OUTSIDE_TXOP		= 35,	/* 11e */
953 	IEEE80211_REASON_LEAVING_QBSS		= 36,	/* 11e */
954 	IEEE80211_REASON_BAD_MECHANISM		= 37,	/* 11e */
955 	IEEE80211_REASON_SETUP_NEEDED		= 38,	/* 11e */
956 	IEEE80211_REASON_TIMEOUT		= 39,	/* 11e */
957 
958 	IEEE80211_REASON_PEER_LINK_CANCELED	= 52,	/* 11s */
959 	IEEE80211_REASON_MESH_MAX_PEERS		= 53,	/* 11s */
960 	IEEE80211_REASON_MESH_CPVIOLATION	= 54,	/* 11s */
961 	IEEE80211_REASON_MESH_CLOSE_RCVD	= 55,	/* 11s */
962 	IEEE80211_REASON_MESH_MAX_RETRIES	= 56,	/* 11s */
963 	IEEE80211_REASON_MESH_CONFIRM_TIMEOUT	= 57,	/* 11s */
964 	IEEE80211_REASON_MESH_INVALID_GTK	= 58,	/* 11s */
965 	IEEE80211_REASON_MESH_INCONS_PARAMS	= 59,	/* 11s */
966 	IEEE80211_REASON_MESH_INVALID_SECURITY	= 60,	/* 11s */
967 	IEEE80211_REASON_MESH_PERR_NO_PROXY	= 61,	/* 11s */
968 	IEEE80211_REASON_MESH_PERR_NO_FI	= 62,	/* 11s */
969 	IEEE80211_REASON_MESH_PERR_DEST_UNREACH	= 63,	/* 11s */
970 	IEEE80211_REASON_MESH_MAC_ALRDY_EXISTS_MBSS = 64, /* 11s */
971 	IEEE80211_REASON_MESH_CHAN_SWITCH_REG	= 65,	/* 11s */
972 	IEEE80211_REASON_MESH_CHAN_SWITCH_UNSPEC = 66,	/* 11s */
973 
974 	IEEE80211_STATUS_SUCCESS		= 0,
975 	IEEE80211_STATUS_UNSPECIFIED		= 1,
976 	IEEE80211_STATUS_CAPINFO		= 10,
977 	IEEE80211_STATUS_NOT_ASSOCED		= 11,
978 	IEEE80211_STATUS_OTHER			= 12,
979 	IEEE80211_STATUS_ALG			= 13,
980 	IEEE80211_STATUS_SEQUENCE		= 14,
981 	IEEE80211_STATUS_CHALLENGE		= 15,
982 	IEEE80211_STATUS_TIMEOUT		= 16,
983 	IEEE80211_STATUS_TOOMANY		= 17,
984 	IEEE80211_STATUS_BASIC_RATE		= 18,
985 	IEEE80211_STATUS_SP_REQUIRED		= 19,	/* 11b */
986 	IEEE80211_STATUS_PBCC_REQUIRED		= 20,	/* 11b */
987 	IEEE80211_STATUS_CA_REQUIRED		= 21,	/* 11b */
988 	IEEE80211_STATUS_SPECMGMT_REQUIRED	= 22,	/* 11h */
989 	IEEE80211_STATUS_PWRCAP_REQUIRED	= 23,	/* 11h */
990 	IEEE80211_STATUS_SUPCHAN_REQUIRED	= 24,	/* 11h */
991 	IEEE80211_STATUS_SHORTSLOT_REQUIRED	= 25,	/* 11g */
992 	IEEE80211_STATUS_DSSSOFDM_REQUIRED	= 26,	/* 11g */
993 	IEEE80211_STATUS_MISSING_HT_CAPS	= 27,	/* 11n D3.0 */
994 	IEEE80211_STATUS_INVALID_IE		= 40,	/* 11i */
995 	IEEE80211_STATUS_GROUP_CIPHER_INVALID	= 41,	/* 11i */
996 	IEEE80211_STATUS_PAIRWISE_CIPHER_INVALID = 42,	/* 11i */
997 	IEEE80211_STATUS_AKMP_INVALID		= 43,	/* 11i */
998 	IEEE80211_STATUS_UNSUPP_RSN_IE_VERSION	= 44,	/* 11i */
999 	IEEE80211_STATUS_INVALID_RSN_IE_CAP	= 45,	/* 11i */
1000 	IEEE80211_STATUS_CIPHER_SUITE_REJECTED	= 46,	/* 11i */
1001 };
1002 
1003 #define	IEEE80211_WEP_KEYLEN		5	/* 40bit */
1004 #define	IEEE80211_WEP_IVLEN		3	/* 24bit */
1005 #define	IEEE80211_WEP_KIDLEN		1	/* 1 octet */
1006 #define	IEEE80211_WEP_CRCLEN		4	/* CRC-32 */
1007 #define	IEEE80211_WEP_TOTLEN		(IEEE80211_WEP_IVLEN + \
1008 					 IEEE80211_WEP_KIDLEN + \
1009 					 IEEE80211_WEP_CRCLEN)
1010 #define	IEEE80211_WEP_NKID		4	/* number of key ids */
1011 
1012 /*
1013  * 802.11i defines an extended IV for use with non-WEP ciphers.
1014  * When the EXTIV bit is set in the key id byte an additional
1015  * 4 bytes immediately follow the IV for TKIP.  For CCMP the
1016  * EXTIV bit is likewise set but the 8 bytes represent the
1017  * CCMP header rather than IV+extended-IV.
1018  */
1019 #define	IEEE80211_WEP_EXTIV		0x20
1020 #define	IEEE80211_WEP_EXTIVLEN		4	/* extended IV length */
1021 #define	IEEE80211_WEP_MICLEN		8	/* trailing MIC */
1022 
1023 #define	IEEE80211_CRC_LEN		4
1024 
1025 /*
1026  * Maximum acceptable MTU is:
1027  *	IEEE80211_MAX_LEN - WEP overhead - CRC -
1028  *		QoS overhead - RSN/WPA overhead
1029  * Min is arbitrarily chosen > IEEE80211_MIN_LEN.  The default
1030  * mtu is Ethernet-compatible; it's set by ether_ifattach.
1031  */
1032 #define	IEEE80211_MTU_MAX		2290
1033 #define	IEEE80211_MTU_MIN		32
1034 
1035 #define	IEEE80211_MAX_LEN		(2300 + IEEE80211_CRC_LEN + \
1036     (IEEE80211_WEP_IVLEN + IEEE80211_WEP_KIDLEN + IEEE80211_WEP_CRCLEN))
1037 #define	IEEE80211_ACK_LEN \
1038 	(sizeof(struct ieee80211_frame_ack) + IEEE80211_CRC_LEN)
1039 #define	IEEE80211_MIN_LEN \
1040 	(sizeof(struct ieee80211_frame_min) + IEEE80211_CRC_LEN)
1041 
1042 /*
1043  * The 802.11 spec says at most 2007 stations may be
1044  * associated at once.  For most AP's this is way more
1045  * than is feasible so we use a default of IEEE80211_AID_DEF.
1046  * This number may be overridden by the driver and/or by
1047  * user configuration but may not be less than IEEE80211_AID_MIN
1048  * (see _ieee80211.h for implementation-specific settings).
1049  */
1050 #define	IEEE80211_AID_MAX		2007
1051 
1052 #define	IEEE80211_AID(b)	((b) &~ 0xc000)
1053 
1054 /*
1055  * RTS frame length parameters.  The default is specified in
1056  * the 802.11 spec as 512; we treat it as implementation-dependent
1057  * so it's defined in ieee80211_var.h.  The max may be wrong
1058  * for jumbo frames.
1059  */
1060 #define	IEEE80211_RTS_MIN		1
1061 #define	IEEE80211_RTS_MAX		2346
1062 
1063 /*
1064  * TX fragmentation parameters.  As above for RTS, we treat
1065  * default as implementation-dependent so define it elsewhere.
1066  */
1067 #define	IEEE80211_FRAG_MIN		256
1068 #define	IEEE80211_FRAG_MAX		2346
1069 
1070 /*
1071  * Beacon interval (TU's).  Min+max come from WiFi requirements.
1072  * As above, we treat default as implementation-dependent so
1073  * define it elsewhere.
1074  */
1075 #define	IEEE80211_BINTVAL_MAX	1000	/* max beacon interval (TU's) */
1076 #define	IEEE80211_BINTVAL_MIN	25	/* min beacon interval (TU's) */
1077 
1078 /*
1079  * DTIM period (beacons).  Min+max are not really defined
1080  * by the protocol but we want them publicly visible so
1081  * define them here.
1082  */
1083 #define	IEEE80211_DTIM_MAX	15	/* max DTIM period */
1084 #define	IEEE80211_DTIM_MIN	1	/* min DTIM period */
1085 
1086 /*
1087  * Beacon miss threshold (beacons).  As for DTIM, we define
1088  * them here to be publicly visible.  Note the max may be
1089  * clamped depending on device capabilities.
1090  */
1091 #define	IEEE80211_HWBMISS_MIN 	1
1092 #define	IEEE80211_HWBMISS_MAX 	255
1093 
1094 /*
1095  * 802.11 frame duration definitions.
1096  */
1097 
1098 struct ieee80211_duration {
1099 	uint16_t	d_rts_dur;
1100 	uint16_t	d_data_dur;
1101 	uint16_t	d_plcp_len;
1102 	uint8_t		d_residue;	/* unused octets in time slot */
1103 };
1104 
1105 /* One Time Unit (TU) is 1Kus = 1024 microseconds. */
1106 #define IEEE80211_DUR_TU		1024
1107 
1108 /* IEEE 802.11b durations for DSSS PHY in microseconds */
1109 #define IEEE80211_DUR_DS_LONG_PREAMBLE	144
1110 #define IEEE80211_DUR_DS_SHORT_PREAMBLE	72
1111 
1112 #define IEEE80211_DUR_DS_SLOW_PLCPHDR	48
1113 #define IEEE80211_DUR_DS_FAST_PLCPHDR	24
1114 #define IEEE80211_DUR_DS_SLOW_ACK	112
1115 #define IEEE80211_DUR_DS_FAST_ACK	56
1116 #define IEEE80211_DUR_DS_SLOW_CTS	112
1117 #define IEEE80211_DUR_DS_FAST_CTS	56
1118 
1119 #define IEEE80211_DUR_DS_SLOT		20
1120 #define IEEE80211_DUR_DS_SIFS		10
1121 #define IEEE80211_DUR_DS_PIFS	(IEEE80211_DUR_DS_SIFS + IEEE80211_DUR_DS_SLOT)
1122 #define IEEE80211_DUR_DS_DIFS	(IEEE80211_DUR_DS_SIFS + \
1123 				 2 * IEEE80211_DUR_DS_SLOT)
1124 #define IEEE80211_DUR_DS_EIFS	(IEEE80211_DUR_DS_SIFS + \
1125 				 IEEE80211_DUR_DS_SLOW_ACK + \
1126 				 IEEE80211_DUR_DS_LONG_PREAMBLE + \
1127 				 IEEE80211_DUR_DS_SLOW_PLCPHDR + \
1128 				 IEEE80211_DUR_DIFS)
1129 
1130 #endif /* _NET80211_IEEE80211_H_ */
1131