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