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