sys/netproto/802_11/ieee80211.h

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