ieee80211.h revision 1.27 1 /* $NetBSD: ieee80211.h,v 1.27 2016/04/27 20:17:00 christos Exp $ */
2 /*-
3 * Copyright (c) 2001 Atsushi Onoe
4 * Copyright (c) 2002-2005 Sam Leffler, Errno Consulting
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
17 *
18 * Alternatively, this software may be distributed under the terms of the
19 * GNU General Public License ("GPL") version 2 as published by the Free
20 * Software Foundation.
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
23 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
26 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
27 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
31 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 *
33 * $FreeBSD: src/sys/net80211/ieee80211.h,v 1.10 2005/07/22 16:55:27 sam Exp $
34 */
35 #ifndef _NET80211_IEEE80211_H_
36 #define _NET80211_IEEE80211_H_
37
38 /*
39 * 802.11 protocol definitions.
40 */
41
42 #define IEEE80211_ADDR_LEN 6 /* size of 802.11 address */
43 /* is 802.11 address multicast/broadcast? */
44 #define IEEE80211_IS_MULTICAST(_a) (*(_a) & 0x01)
45
46 /* IEEE 802.11 PLCP header */
47 struct ieee80211_plcp_hdr {
48 u_int16_t i_sfd;
49 u_int8_t i_signal;
50 u_int8_t i_service;
51 u_int16_t i_length;
52 u_int16_t i_crc;
53 } __packed;
54
55 #define IEEE80211_PLCP_SFD 0xF3A0
56 #define IEEE80211_PLCP_SERVICE 0x00
57
58 /*
59 * generic definitions for IEEE 802.11 frames
60 */
61 struct ieee80211_frame {
62 u_int8_t i_fc[2];
63 u_int8_t i_dur[2];
64 u_int8_t i_addr1[IEEE80211_ADDR_LEN];
65 u_int8_t i_addr2[IEEE80211_ADDR_LEN];
66 u_int8_t i_addr3[IEEE80211_ADDR_LEN];
67 u_int8_t i_seq[2];
68 /* possibly followed by addr4[IEEE80211_ADDR_LEN]; */
69 /* see below */
70 } __packed;
71
72 struct ieee80211_qosframe {
73 u_int8_t i_fc[2];
74 u_int8_t i_dur[2];
75 u_int8_t i_addr1[IEEE80211_ADDR_LEN];
76 u_int8_t i_addr2[IEEE80211_ADDR_LEN];
77 u_int8_t i_addr3[IEEE80211_ADDR_LEN];
78 u_int8_t i_seq[2];
79 u_int8_t i_qos[2];
80 /* possibly followed by addr4[IEEE80211_ADDR_LEN]; */
81 /* see below */
82 } __packed;
83
84 struct ieee80211_htframe { /* 11n */
85 u_int8_t i_fc[2];
86 u_int8_t i_dur[2];
87 u_int8_t i_addr1[IEEE80211_ADDR_LEN];
88 u_int8_t i_addr2[IEEE80211_ADDR_LEN];
89 u_int8_t i_addr3[IEEE80211_ADDR_LEN];
90 u_int8_t i_seq[2];
91 u_int8_t i_qos[2];
92 u_int8_t i_ht[4];
93 } __packed;
94
95 struct ieee80211_qoscntl {
96 u_int8_t i_qos[2];
97 };
98
99 struct ieee80211_frame_addr4 {
100 u_int8_t i_fc[2];
101 u_int8_t i_dur[2];
102 u_int8_t i_addr1[IEEE80211_ADDR_LEN];
103 u_int8_t i_addr2[IEEE80211_ADDR_LEN];
104 u_int8_t i_addr3[IEEE80211_ADDR_LEN];
105 u_int8_t i_seq[2];
106 u_int8_t i_addr4[IEEE80211_ADDR_LEN];
107 } __packed;
108
109
110 struct ieee80211_qosframe_addr4 {
111 u_int8_t i_fc[2];
112 u_int8_t i_dur[2];
113 u_int8_t i_addr1[IEEE80211_ADDR_LEN];
114 u_int8_t i_addr2[IEEE80211_ADDR_LEN];
115 u_int8_t i_addr3[IEEE80211_ADDR_LEN];
116 u_int8_t i_seq[2];
117 u_int8_t i_addr4[IEEE80211_ADDR_LEN];
118 u_int8_t i_qos[2];
119 } __packed;
120
121 #define IEEE80211_FC0_VERSION_MASK 0x03
122 #define IEEE80211_FC0_VERSION_SHIFT 0
123 #define IEEE80211_FC0_VERSION_0 0x00
124 #define IEEE80211_FC0_TYPE_MASK 0x0c
125 #define IEEE80211_FC0_TYPE_SHIFT 2
126 #define IEEE80211_FC0_TYPE_MGT 0x00
127 #define IEEE80211_FC0_TYPE_CTL 0x04
128 #define IEEE80211_FC0_TYPE_DATA 0x08
129
130 #define IEEE80211_FC0_SUBTYPE_MASK 0xf0
131 #define IEEE80211_FC0_SUBTYPE_SHIFT 4
132 /* for TYPE_MGT */
133 #define IEEE80211_FC0_SUBTYPE_ASSOC_REQ 0x00
134 #define IEEE80211_FC0_SUBTYPE_ASSOC_RESP 0x10
135 #define IEEE80211_FC0_SUBTYPE_REASSOC_REQ 0x20
136 #define IEEE80211_FC0_SUBTYPE_REASSOC_RESP 0x30
137 #define IEEE80211_FC0_SUBTYPE_PROBE_REQ 0x40
138 #define IEEE80211_FC0_SUBTYPE_PROBE_RESP 0x50
139 #define IEEE80211_FC0_SUBTYPE_BEACON 0x80
140 #define IEEE80211_FC0_SUBTYPE_ATIM 0x90
141 #define IEEE80211_FC0_SUBTYPE_DISASSOC 0xa0
142 #define IEEE80211_FC0_SUBTYPE_AUTH 0xb0
143 #define IEEE80211_FC0_SUBTYPE_DEAUTH 0xc0
144 /* for TYPE_CTL */
145 #define IEEE80211_FC0_SUBTYPE_PS_POLL 0xa0
146 #define IEEE80211_FC0_SUBTYPE_RTS 0xb0
147 #define IEEE80211_FC0_SUBTYPE_CTS 0xc0
148 #define IEEE80211_FC0_SUBTYPE_ACK 0xd0
149 #define IEEE80211_FC0_SUBTYPE_CF_END 0xe0
150 #define IEEE80211_FC0_SUBTYPE_CF_END_ACK 0xf0
151 /* for TYPE_DATA (bit combination) */
152 #define IEEE80211_FC0_SUBTYPE_DATA 0x00
153 #define IEEE80211_FC0_SUBTYPE_CF_ACK 0x10
154 #define IEEE80211_FC0_SUBTYPE_CF_POLL 0x20
155 #define IEEE80211_FC0_SUBTYPE_CF_ACPL 0x30
156 #define IEEE80211_FC0_SUBTYPE_NODATA 0x40
157 #define IEEE80211_FC0_SUBTYPE_CFACK 0x50
158 #define IEEE80211_FC0_SUBTYPE_CFPOLL 0x60
159 #define IEEE80211_FC0_SUBTYPE_CF_ACK_CF_ACK 0x70
160 #define IEEE80211_FC0_SUBTYPE_QOS 0x80
161 #define IEEE80211_FC0_SUBTYPE_QOS_NULL 0xc0
162
163 /*
164 * DS bit usage
165 *
166 * TA = transmitter address
167 * RA = receiver address
168 * DA = destination address
169 * SA = source address
170 *
171 * ToDS FromDS A1(RA) A2(TA) A3 A4 Use
172 * -----------------------------------------------------------------
173 * 0 0 DA SA BSSID - IBSS/DLS
174 * 0 1 DA BSSID SA - AP -> STA
175 * 1 0 BSSID SA DA - AP <- STA
176 * 1 1 RA TA DA SA unspecified (WDS)
177 */
178 #define IEEE80211_FC1_DIR_MASK 0x03
179 #define IEEE80211_FC1_DIR_NODS 0x00 /* STA->STA */
180 #define IEEE80211_FC1_DIR_TODS 0x01 /* STA->AP */
181 #define IEEE80211_FC1_DIR_FROMDS 0x02 /* AP ->STA */
182 #define IEEE80211_FC1_DIR_DSTODS 0x03 /* AP ->AP */
183
184 #define IEEE80211_FC1_MORE_FRAG 0x04
185 #define IEEE80211_FC1_RETRY 0x08
186 #define IEEE80211_FC1_PWR_MGT 0x10
187 #define IEEE80211_FC1_MORE_DATA 0x20
188 #define IEEE80211_FC1_PROTECTED 0x40
189 #define IEEE80211_FC1_WEP 0x40 /* pre-RSNA compat */
190 #define IEEE80211_FC1_ORDER 0x80
191
192 #define IEEE80211_SEQ_FRAG_MASK 0x000f
193 #define IEEE80211_SEQ_FRAG_SHIFT 0
194 #define IEEE80211_SEQ_SEQ_MASK 0xfff0
195 #define IEEE80211_SEQ_SEQ_SHIFT 4
196
197 #define IEEE80211_NWID_LEN 32
198
199 /*
200 * QoS Control field (see 7.1.3.5).
201 */
202 /* bit 8 is reserved */
203 #define IEEE80211_QOS_TXOP 0xff00
204 #define IEEE80211_QOS_AMSDU 0x0080 /* 11n */
205 #define IEEE80211_QOS_ACKPOLICY_NORMAL 0x0000
206 #define IEEE80211_QOS_ACKPOLICY_NOACK 0x0020
207 #define IEEE80211_QOS_ACKPOLICY_NOEXPLACK 0x0040
208 #define IEEE80211_QOS_ACKPOLICY 0x0060
209 #define IEEE80211_QOS_ACKPOLICY_S 5
210 #define IEEE80211_QOS_ACKPOLICY_MASK 0x0060
211 #define IEEE80211_QOS_ACKPOLICY_BA 0x0060
212 #define IEEE80211_QOS_ESOP 0x0010
213 #define IEEE80211_QOS_ESOP_S 4
214 #define IEEE80211_QOS_TID 0x000f
215
216 /*
217 * WME/802.11e information element.
218 */
219 struct ieee80211_wme_info {
220 u_int8_t wme_id; /* IEEE80211_ELEMID_VENDOR */
221 u_int8_t wme_len; /* length in bytes */
222 u_int8_t wme_oui[3]; /* 0x00, 0x50, 0xf2 */
223 u_int8_t wme_type; /* OUI type */
224 u_int8_t wme_subtype; /* OUI subtype */
225 u_int8_t wme_version; /* spec revision */
226 u_int8_t wme_info; /* QoS info */
227 } __packed;
228
229 /*
230 * WME/802.11e Tspec Element
231 */
232 struct ieee80211_wme_tspec {
233 u_int8_t ts_id;
234 u_int8_t ts_len;
235 u_int8_t ts_oui[3];
236 u_int8_t ts_oui_type;
237 u_int8_t ts_oui_subtype;
238 u_int8_t ts_version;
239 u_int8_t ts_tsinfo[3];
240 u_int8_t ts_nom_msdu[2];
241 u_int8_t ts_max_msdu[2];
242 u_int8_t ts_min_svc[4];
243 u_int8_t ts_max_svc[4];
244 u_int8_t ts_inactv_intv[4];
245 u_int8_t ts_susp_intv[4];
246 u_int8_t ts_start_svc[4];
247 u_int8_t ts_min_rate[4];
248 u_int8_t ts_mean_rate[4];
249 u_int8_t ts_max_burst[4];
250 u_int8_t ts_min_phy[4];
251 u_int8_t ts_peak_rate[4];
252 u_int8_t ts_delay[4];
253 u_int8_t ts_surplus[2];
254 u_int8_t ts_medium_time[2];
255 } __packed;
256
257 /*
258 * WME AC parameter field
259 */
260 struct ieee80211_wme_acparams {
261 u_int8_t acp_aci_aifsn;
262 u_int8_t acp_logcwminmax;
263 u_int16_t acp_txop;
264 } __packed;
265
266 /* WME stream classes */
267 enum ieee80211_wme_ac {
268 WME_AC_BE = 0, /* best effort */
269 WME_AC_BK = 1, /* background */
270 WME_AC_VI = 2, /* video */
271 WME_AC_VO = 3, /* voice */
272 };
273 #define WME_NUM_AC 4 /* 4 AC categories */
274
275 #define WME_PARAM_ACI 0x60 /* Mask for ACI field */
276 #define WME_PARAM_ACI_S 5 /* Shift for ACI field */
277 #define WME_PARAM_ACM 0x10 /* Mask for ACM bit */
278 #define WME_PARAM_ACM_S 4 /* Shift for ACM bit */
279 #define WME_PARAM_AIFSN 0x0f /* Mask for aifsn field */
280 #define WME_PARAM_AIFSN_S 0 /* Shift for aifsn field */
281 #define WME_PARAM_LOGCWMIN 0x0f /* Mask for CwMin field (in log) */
282 #define WME_PARAM_LOGCWMIN_S 0 /* Shift for CwMin field */
283 #define WME_PARAM_LOGCWMAX 0xf0 /* Mask for CwMax field (in log) */
284 #define WME_PARAM_LOGCWMAX_S 4 /* Shift for CwMax field */
285
286 #define WME_AC_TO_TID(_ac) ( \
287 ((_ac) == WME_AC_VO) ? 6 : \
288 ((_ac) == WME_AC_VI) ? 5 : \
289 ((_ac) == WME_AC_BK) ? 1 : \
290 0)
291
292 #define TID_TO_WME_AC(_tid) ( \
293 ((_tid) < 1) ? WME_AC_BE : \
294 ((_tid) < 3) ? WME_AC_BK : \
295 ((_tid) < 6) ? WME_AC_VI : \
296 WME_AC_VO)
297
298 /*
299 * WME Parameter Element
300 */
301 struct ieee80211_wme_param {
302 u_int8_t param_id;
303 u_int8_t param_len;
304 u_int8_t param_oui[3];
305 u_int8_t param_oui_type;
306 u_int8_t param_oui_sybtype;
307 u_int8_t param_version;
308 u_int8_t param_qosInfo;
309 #define WME_QOSINFO_COUNT 0x0f /* Mask for param count field */
310 u_int8_t param_reserved;
311 struct ieee80211_wme_acparams params_acParams[WME_NUM_AC];
312 } __packed;
313
314 /*
315 * Management Notification Frame
316 */
317 struct ieee80211_mnf {
318 u_int8_t mnf_category;
319 u_int8_t mnf_action;
320 u_int8_t mnf_dialog;
321 u_int8_t mnf_status;
322 } __packed;
323 #define MNF_SETUP_REQ 0
324 #define MNF_SETUP_RESP 1
325 #define MNF_TEARDOWN 2
326
327 /*
328 * Control frames.
329 */
330 struct ieee80211_frame_min {
331 u_int8_t i_fc[2];
332 u_int8_t i_dur[2];
333 u_int8_t i_addr1[IEEE80211_ADDR_LEN];
334 u_int8_t i_addr2[IEEE80211_ADDR_LEN];
335 /* FCS */
336 } __packed;
337
338 struct ieee80211_frame_rts {
339 u_int8_t i_fc[2];
340 u_int8_t i_dur[2];
341 u_int8_t i_ra[IEEE80211_ADDR_LEN];
342 u_int8_t i_ta[IEEE80211_ADDR_LEN];
343 /* FCS */
344 } __packed;
345
346 struct ieee80211_frame_cts {
347 u_int8_t i_fc[2];
348 u_int8_t i_dur[2];
349 u_int8_t i_ra[IEEE80211_ADDR_LEN];
350 /* FCS */
351 } __packed;
352
353 struct ieee80211_frame_ack {
354 u_int8_t i_fc[2];
355 u_int8_t i_dur[2];
356 u_int8_t i_ra[IEEE80211_ADDR_LEN];
357 /* FCS */
358 } __packed;
359
360 struct ieee80211_frame_pspoll {
361 u_int8_t i_fc[2];
362 u_int8_t i_aid[2];
363 u_int8_t i_bssid[IEEE80211_ADDR_LEN];
364 u_int8_t i_ta[IEEE80211_ADDR_LEN];
365 /* FCS */
366 } __packed;
367
368 struct ieee80211_frame_cfend { /* NB: also CF-End+CF-Ack */
369 u_int8_t i_fc[2];
370 u_int8_t i_dur[2]; /* should be zero */
371 u_int8_t i_ra[IEEE80211_ADDR_LEN];
372 u_int8_t i_bssid[IEEE80211_ADDR_LEN];
373 /* FCS */
374 } __packed;
375
376 static __inline int
377 ieee80211_has_seq(const struct ieee80211_frame *wh)
378 {
379 return (wh->i_fc[0] & IEEE80211_FC0_TYPE_MASK) !=
380 IEEE80211_FC0_TYPE_CTL;
381 }
382
383 static __inline int
384 ieee80211_has_addr4(const struct ieee80211_frame *wh)
385 {
386 return (wh->i_fc[1] & IEEE80211_FC1_DIR_MASK) ==
387 IEEE80211_FC1_DIR_DSTODS;
388 }
389
390 static __inline int
391 ieee80211_has_qos(const struct ieee80211_frame *wh)
392 {
393 return (wh->i_fc[0] &
394 (IEEE80211_FC0_TYPE_MASK | IEEE80211_FC0_SUBTYPE_QOS)) ==
395 (IEEE80211_FC0_TYPE_DATA | IEEE80211_FC0_SUBTYPE_QOS);
396 }
397
398 static __inline int
399 ieee80211_has_htc(const struct ieee80211_frame *wh)
400 {
401 return (wh->i_fc[1] & IEEE80211_FC1_ORDER) &&
402 (ieee80211_has_qos(wh) ||
403 (wh->i_fc[0] & IEEE80211_FC0_TYPE_MASK) ==
404 IEEE80211_FC0_TYPE_MGT);
405 }
406
407 static __inline u_int16_t
408 ieee80211_get_qos(const struct ieee80211_frame *wh)
409 {
410 const u_int8_t *frm;
411
412 if (ieee80211_has_addr4(wh))
413 frm = ((const struct ieee80211_qosframe_addr4 *)wh)->i_qos;
414 else
415 frm = ((const struct ieee80211_qosframe *)wh)->i_qos;
416
417 return le16toh(*(const u_int16_t *)frm);
418 }
419
420 /*
421 * BEACON management packets
422 *
423 * octet timestamp[8]
424 * octet beacon interval[2]
425 * octet capability information[2]
426 * information element
427 * octet elemid
428 * octet length
429 * octet information[length]
430 */
431
432 typedef u_int8_t *ieee80211_mgt_beacon_t;
433
434 #define IEEE80211_BEACON_INTERVAL(beacon) \
435 ((beacon)[8] | ((beacon)[9] << 8))
436 #define IEEE80211_BEACON_CAPABILITY(beacon) \
437 ((beacon)[10] | ((beacon)[11] << 8))
438
439 #define IEEE80211_CAPINFO_ESS 0x0001
440 #define IEEE80211_CAPINFO_IBSS 0x0002
441 #define IEEE80211_CAPINFO_CF_POLLABLE 0x0004
442 #define IEEE80211_CAPINFO_CF_POLLREQ 0x0008
443 #define IEEE80211_CAPINFO_PRIVACY 0x0010
444 #define IEEE80211_CAPINFO_SHORT_PREAMBLE 0x0020
445 #define IEEE80211_CAPINFO_PBCC 0x0040
446 #define IEEE80211_CAPINFO_CHNL_AGILITY 0x0080
447 /* bits 8-9 are reserved */
448 #define IEEE80211_CAPINFO_SHORT_SLOTTIME 0x0400
449 #define IEEE80211_CAPINFO_RSN 0x0800
450 /* bit 12 is reserved */
451 #define IEEE80211_CAPINFO_DSSSOFDM 0x2000
452 /* bits 14-15 are reserved */
453
454 /*
455 * 802.11i/WPA information element (maximally sized).
456 */
457 struct ieee80211_ie_wpa {
458 u_int8_t wpa_id; /* IEEE80211_ELEMID_VENDOR */
459 u_int8_t wpa_len; /* length in bytes */
460 u_int8_t wpa_oui[3]; /* 0x00, 0x50, 0xf2 */
461 u_int8_t wpa_type; /* OUI type */
462 u_int16_t wpa_version; /* spec revision */
463 u_int32_t wpa_mcipher[1]; /* multicast/group key cipher */
464 u_int16_t wpa_uciphercnt; /* # pairwise key ciphers */
465 u_int32_t wpa_uciphers[8];/* ciphers */
466 u_int16_t wpa_authselcnt; /* authentication selector cnt*/
467 u_int32_t wpa_authsels[8];/* selectors */
468 u_int16_t wpa_caps; /* 802.11i capabilities */
469 u_int16_t wpa_pmkidcnt; /* 802.11i pmkid count */
470 u_int16_t wpa_pmkids[8]; /* 802.11i pmkids */
471 } __packed;
472
473 /*
474 * Management information element payloads.
475 */
476
477 enum {
478 IEEE80211_ELEMID_SSID = 0,
479 IEEE80211_ELEMID_RATES = 1,
480 IEEE80211_ELEMID_FHPARMS = 2,
481 IEEE80211_ELEMID_DSPARMS = 3,
482 IEEE80211_ELEMID_CFPARMS = 4,
483 IEEE80211_ELEMID_TIM = 5,
484 IEEE80211_ELEMID_IBSSPARMS = 6,
485 IEEE80211_ELEMID_COUNTRY = 7,
486 IEEE80211_ELEMID_EDCAPARMS = 12,
487 IEEE80211_ELEMID_CHALLENGE = 16,
488 /* 17-31 reserved for challenge text extension */
489 IEEE80211_ELEMID_PWRCNSTR = 32,
490 IEEE80211_ELEMID_PWRCAP = 33,
491 IEEE80211_ELEMID_TPCREQ = 34,
492 IEEE80211_ELEMID_TPCREP = 35,
493 IEEE80211_ELEMID_SUPPCHAN = 36,
494 IEEE80211_ELEMID_CHANSWITCHANN = 37,
495 IEEE80211_ELEMID_MEASREQ = 38,
496 IEEE80211_ELEMID_MEASREP = 39,
497 IEEE80211_ELEMID_QUIET = 40,
498 IEEE80211_ELEMID_IBSSDFS = 41,
499 IEEE80211_ELEMID_ERP = 42,
500 IEEE80211_ELEMID_HTCAP = 45, /* 11n */
501 IEEE80211_ELEMID_QOS_CAP = 46,
502 IEEE80211_ELEMID_RSN = 48,
503 IEEE80211_ELEMID_XRATES = 50,
504 IEEE80211_ELEMID_TIE = 56, /* 11r */
505 IEEE80211_ELEMID_HTINFO = 61, /* 11n */
506 IEEE80211_ELEMID_MMIE = 76, /* 11w */
507 IEEE80211_ELEMID_TPC = 150,
508 IEEE80211_ELEMID_CCKM = 156,
509 IEEE80211_ELEMID_VENDOR = 221 /* vendor private */
510 };
511
512 struct ieee80211_tim_ie {
513 u_int8_t tim_ie; /* IEEE80211_ELEMID_TIM */
514 u_int8_t tim_len;
515 u_int8_t tim_count; /* DTIM count */
516 u_int8_t tim_period; /* DTIM period */
517 u_int8_t tim_bitctl; /* bitmap control */
518 u_int8_t tim_bitmap[1]; /* variable-length bitmap */
519 } __packed;
520
521 struct ieee80211_band {
522 u_int8_t schan; /* starting channel */
523 u_int8_t nchan; /* number channels */
524 u_int8_t maxtxpwr; /* tx power cap */
525 } __packed;
526
527 struct ieee80211_country_ie {
528 u_int8_t ie; /* IEEE80211_ELEMID_COUNTRY */
529 u_int8_t len;
530 u_int8_t cc[3]; /* ISO CC+(I)ndoor/(O)utdoor */
531 struct ieee80211_band band[4]; /* up to 4 sub bands */
532 } __packed;
533
534 #define IEEE80211_CHALLENGE_LEN 128
535
536 #define IEEE80211_RATE_BASIC 0x80
537 #define IEEE80211_RATE_VAL 0x7f
538
539 /* EPR information element flags */
540 #define IEEE80211_ERP_NON_ERP_PRESENT 0x01
541 #define IEEE80211_ERP_USE_PROTECTION 0x02
542 #define IEEE80211_ERP_LONG_PREAMBLE 0x04
543
544 /* Atheros private advanced capabilities info */
545 #define ATHEROS_CAP_TURBO_PRIME 0x01
546 #define ATHEROS_CAP_COMPRESSION 0x02
547 #define ATHEROS_CAP_FAST_FRAME 0x04
548 /* bits 3-6 reserved */
549 #define ATHEROS_CAP_BOOST 0x80
550
551 #define ATH_OUI 0x7f0300 /* Atheros OUI */
552 #define ATH_OUI_TYPE 0x01
553 #define ATH_OUI_VERSION 0x01
554
555 #define WPA_OUI 0xf25000
556 #define WPA_OUI_TYPE 0x01
557 #define WPA_VERSION 1 /* current supported version */
558
559 #define WPA_CSE_NULL 0x00
560 #define WPA_CSE_WEP40 0x01
561 #define WPA_CSE_TKIP 0x02
562 #define WPA_CSE_CCMP 0x04
563 #define WPA_CSE_WEP104 0x05
564
565 #define WPA_ASE_NONE 0x00
566 #define WPA_ASE_8021X_UNSPEC 0x01
567 #define WPA_ASE_8021X_PSK 0x02
568
569 #define RSN_OUI 0xac0f00
570 #define RSN_VERSION 1 /* current supported version */
571
572 #define RSN_CSE_NULL 0x00
573 #define RSN_CSE_WEP40 0x01
574 #define RSN_CSE_TKIP 0x02
575 #define RSN_CSE_WRAP 0x03
576 #define RSN_CSE_CCMP 0x04
577 #define RSN_CSE_WEP104 0x05
578
579 #define RSN_ASE_NONE 0x00
580 #define RSN_ASE_8021X_UNSPEC 0x01
581 #define RSN_ASE_8021X_PSK 0x02
582
583 #define RSN_CAP_PREAUTH 0x01
584
585 #define WME_OUI 0xf25000
586 #define WME_OUI_TYPE 0x02
587 #define WME_INFO_OUI_SUBTYPE 0x00
588 #define WME_PARAM_OUI_SUBTYPE 0x01
589 #define WME_VERSION 1
590
591 /*
592 * AUTH management packets
593 *
594 * octet algo[2]
595 * octet seq[2]
596 * octet status[2]
597 * octet chal.id
598 * octet chal.length
599 * octet chal.text[253]
600 */
601
602 typedef u_int8_t *ieee80211_mgt_auth_t;
603
604 #define IEEE80211_AUTH_ALGORITHM(auth) \
605 ((auth)[0] | ((auth)[1] << 8))
606 #define IEEE80211_AUTH_TRANSACTION(auth) \
607 ((auth)[2] | ((auth)[3] << 8))
608 #define IEEE80211_AUTH_STATUS(auth) \
609 ((auth)[4] | ((auth)[5] << 8))
610
611 #define IEEE80211_AUTH_ALG_OPEN 0x0000
612 #define IEEE80211_AUTH_ALG_SHARED 0x0001
613 #define IEEE80211_AUTH_ALG_LEAP 0x0080
614
615 enum {
616 IEEE80211_AUTH_OPEN_REQUEST = 1,
617 IEEE80211_AUTH_OPEN_RESPONSE = 2
618 };
619
620 enum {
621 IEEE80211_AUTH_SHARED_REQUEST = 1,
622 IEEE80211_AUTH_SHARED_CHALLENGE = 2,
623 IEEE80211_AUTH_SHARED_RESPONSE = 3,
624 IEEE80211_AUTH_SHARED_PASS = 4
625 };
626
627 /*
628 * Reason codes
629 *
630 * Unlisted codes are reserved
631 */
632
633 enum {
634 IEEE80211_REASON_UNSPECIFIED = 1,
635 IEEE80211_REASON_AUTH_EXPIRE = 2,
636 IEEE80211_REASON_AUTH_LEAVE = 3,
637 IEEE80211_REASON_ASSOC_EXPIRE = 4,
638 IEEE80211_REASON_ASSOC_TOOMANY = 5,
639 IEEE80211_REASON_NOT_AUTHED = 6,
640 IEEE80211_REASON_NOT_ASSOCED = 7,
641 IEEE80211_REASON_ASSOC_LEAVE = 8,
642 IEEE80211_REASON_ASSOC_NOT_AUTHED = 9,
643
644 IEEE80211_REASON_RSN_REQUIRED = 11,
645 IEEE80211_REASON_RSN_INCONSISTENT = 12,
646 IEEE80211_REASON_IE_INVALID = 13,
647 IEEE80211_REASON_MIC_FAILURE = 14,
648
649 IEEE80211_STATUS_SUCCESS = 0,
650 IEEE80211_STATUS_UNSPECIFIED = 1,
651 IEEE80211_STATUS_CAPINFO = 10,
652 IEEE80211_STATUS_NOT_ASSOCED = 11,
653 IEEE80211_STATUS_OTHER = 12,
654 IEEE80211_STATUS_ALG = 13,
655 IEEE80211_STATUS_SEQUENCE = 14,
656 IEEE80211_STATUS_CHALLENGE = 15,
657 IEEE80211_STATUS_TIMEOUT = 16,
658 IEEE80211_STATUS_TOOMANY = 17,
659 IEEE80211_STATUS_BASIC_RATE = 18,
660 IEEE80211_STATUS_SP_REQUIRED = 19,
661 IEEE80211_STATUS_PBCC_REQUIRED = 20,
662 IEEE80211_STATUS_CA_REQUIRED = 21,
663 IEEE80211_STATUS_TOO_MANY_STATIONS = 22,
664 IEEE80211_STATUS_RATES = 23,
665 IEEE80211_STATUS_SHORTSLOT_REQUIRED = 25,
666 IEEE80211_STATUS_DSSSOFDM_REQUIRED = 26
667 };
668
669 #define IEEE80211_WEP_KEYLEN 5 /* 40bit */
670 #define IEEE80211_WEP_IVLEN 3 /* 24bit */
671 #define IEEE80211_WEP_KIDLEN 1 /* 1 octet */
672 #define IEEE80211_WEP_CRCLEN 4 /* CRC-32 */
673 #define IEEE80211_WEP_TOTLEN (IEEE80211_WEP_IVLEN + \
674 IEEE80211_WEP_KIDLEN + \
675 IEEE80211_WEP_CRCLEN)
676 #define IEEE80211_WEP_NKID 4 /* number of key ids */
677
678 /*
679 * 802.11i defines an extended IV for use with non-WEP ciphers.
680 * When the EXTIV bit is set in the key id byte an additional
681 * 4 bytes immediately follow the IV for TKIP. For CCMP the
682 * EXTIV bit is likewise set but the 8 bytes represent the
683 * CCMP header rather than IV+extended-IV.
684 */
685 #define IEEE80211_WEP_EXTIV 0x20
686 #define IEEE80211_WEP_EXTIVLEN 4 /* extended IV length */
687 #define IEEE80211_WEP_MICLEN 8 /* trailing MIC */
688
689 #define IEEE80211_CRC_LEN 4
690
691 /*
692 * Maximum acceptable MTU is:
693 * IEEE80211_MAX_LEN - WEP overhead - CRC -
694 * QoS overhead - RSN/WPA overhead
695 * Min is arbitrarily chosen > IEEE80211_MIN_LEN. The default
696 * mtu is Ethernet-compatible; it's set by ether_ifattach.
697 */
698 #define IEEE80211_MTU_MAX 2290
699 #define IEEE80211_MTU_MIN 32
700
701 #define IEEE80211_MAX_LEN (2300 + IEEE80211_CRC_LEN + \
702 (IEEE80211_WEP_IVLEN + IEEE80211_WEP_KIDLEN + IEEE80211_WEP_CRCLEN))
703 #define IEEE80211_ACK_LEN \
704 (sizeof(struct ieee80211_frame_ack) + IEEE80211_CRC_LEN)
705 #define IEEE80211_MIN_LEN \
706 (sizeof(struct ieee80211_frame_min) + IEEE80211_CRC_LEN)
707
708 /*
709 * The 802.11 spec says at most 2007 stations may be
710 * associated at once. For most AP's this is way more
711 * than is feasible so we use a default of 128. This
712 * number may be overridden by the driver and/or by
713 * user configuration.
714 */
715 #define IEEE80211_AID_MAX 2007
716 #define IEEE80211_AID_DEF 128
717
718 #define IEEE80211_AID(b) ((b) &~ 0xc000)
719
720 /*
721 * RTS frame length parameters. The default is specified in
722 * the 802.11 spec as 512; we treat it as implementation-dependent
723 * so it's defined in ieee80211_var.h. The max may be wrong
724 * for jumbo frames.
725 */
726 #define IEEE80211_RTS_MIN 1
727 #define IEEE80211_RTS_MAX 2346
728
729 /*
730 * TX fragmentation parameters. As above for RTS, we treat
731 * default as implementation-dependent so define it elsewhere.
732 */
733 #define IEEE80211_FRAG_MIN 256
734 #define IEEE80211_FRAG_MAX 2346
735
736 /*
737 * 802.11 frame duration definitions.
738 */
739
740 struct ieee80211_duration {
741 uint16_t d_rts_dur;
742 uint16_t d_data_dur;
743 uint16_t d_plcp_len;
744 uint8_t d_residue; /* unused octets in time slot */
745 };
746
747 /* One Time Unit (TU) is 1Kus = 1024 microseconds. */
748 #define IEEE80211_DUR_TU 1024
749
750 /* IEEE 802.11b durations for DSSS PHY in microseconds */
751 #define IEEE80211_DUR_DS_LONG_PREAMBLE 144
752 #define IEEE80211_DUR_DS_SHORT_PREAMBLE 72
753
754 #define IEEE80211_DUR_DS_SLOW_PLCPHDR 48
755 #define IEEE80211_DUR_DS_FAST_PLCPHDR 24
756 #define IEEE80211_DUR_DS_SLOW_ACK 112
757 #define IEEE80211_DUR_DS_FAST_ACK 56
758 #define IEEE80211_DUR_DS_SLOW_CTS 112
759 #define IEEE80211_DUR_DS_FAST_CTS 56
760
761 #define IEEE80211_DUR_DS_SLOT 20
762 #define IEEE80211_DUR_DS_SIFS 10
763 #define IEEE80211_DUR_DS_PIFS (IEEE80211_DUR_DS_SIFS + IEEE80211_DUR_DS_SLOT)
764 #define IEEE80211_DUR_DS_DIFS (IEEE80211_DUR_DS_SIFS + \
765 2 * IEEE80211_DUR_DS_SLOT)
766 #define IEEE80211_DUR_DS_EIFS (IEEE80211_DUR_DS_SIFS + \
767 IEEE80211_DUR_DS_SLOW_ACK + \
768 IEEE80211_DUR_DS_LONG_PREAMBLE + \
769 IEEE80211_DUR_DS_SLOW_PLCPHDR + \
770 IEEE80211_DUR_DS_DIFS)
771
772
773 #endif /* !_NET80211_IEEE80211_H_ */
774