p80211hdr.h

Go to the documentation of this file.

/* src/include/wlan/p80211hdr.h
*
* Macros, types, and functions for handling 802.11 MAC headers
*
* Copyright (C) 1999 AbsoluteValue Systems, Inc.  All Rights Reserved.
* --------------------------------------------------------------------
*
* linux-wlan
*
*   The contents of this file are subject to the Mozilla Public
*   License Version 1.1 (the "License"); you may not use this file
*   except in compliance with the License. You may obtain a copy of
*   the License at http://www.mozilla.org/MPL/
*
*   Software distributed under the License is distributed on an "AS
*   IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
*   implied. See the License for the specific language governing
*   rights and limitations under the License.
*
*   Alternatively, the contents of this file may be used under the
*   terms of the GNU Public License version 2 (the "GPL"), in which
*   case the provisions of the GPL are applicable instead of the
*   above.  If you wish to allow the use of your version of this file
*   only under the terms of the GPL and not to allow others to use
*   your version of this file under the MPL, indicate your decision
*   by deleting the provisions above and replace them with the notice
*   and other provisions required by the GPL.  If you do not delete
*   the provisions above, a recipient may use your version of this
*   file under either the MPL or the GPL.
*
* --------------------------------------------------------------------
*
* Inquiries regarding the linux-wlan Open Source project can be
* made directly to:
*
* AbsoluteValue Systems Inc.
* info@linux-wlan.com
* http://www.linux-wlan.com
*
* --------------------------------------------------------------------
*
* Portions of the development of this software were funded by 
* Intersil Corporation as part of PRISM(R) chipset product development.
*
* --------------------------------------------------------------------
*
* This file declares the constants and types used in the interface
* between a wlan driver and the user mode utilities.
*
* Note: 
*  - Constant values are always in HOST byte order.  To assign
*    values to multi-byte fields they _must_ be converted to
*    ieee byte order.  To retrieve multi-byte values from incoming
*    frames, they must be converted to host order.
*
* All functions declared here are implemented in p80211.c
* --------------------------------------------------------------------
*/

#ifndef _P80211HDR_H
#define _P80211HDR_H

/*================================================================*/
/* System Includes */

/*================================================================*/
/* Project Includes */

#ifndef  _WLAN_COMPAT_H
#include <wlan/wlan_compat.h>
#endif


/*================================================================*/
/* Constants */

/*--- Sizes -----------------------------------------------*/
#define WLAN_ADDR_LEN     6
#define WLAN_CRC_LEN      4
#define WLAN_BSSID_LEN      6
#define WLAN_BSS_TS_LEN     8
#define WLAN_HDR_A3_LEN     24
#define WLAN_HDR_A4_LEN     30
#define WLAN_SSID_MAXLEN    32
#define WLAN_DATA_MAXLEN    2312
#define WLAN_A3FR_MAXLEN    (WLAN_HDR_A3_LEN + WLAN_DATA_MAXLEN + WLAN_CRC_LEN)
#define WLAN_A4FR_MAXLEN    (WLAN_HDR_A4_LEN + WLAN_DATA_MAXLEN + WLAN_CRC_LEN)
#define WLAN_BEACON_FR_MAXLEN   (WLAN_HDR_A3_LEN + 334)
#define WLAN_ATIM_FR_MAXLEN   (WLAN_HDR_A3_LEN + 0)
#define WLAN_DISASSOC_FR_MAXLEN   (WLAN_HDR_A3_LEN + 2)
#define WLAN_ASSOCREQ_FR_MAXLEN   (WLAN_HDR_A3_LEN + 48)
#define WLAN_ASSOCRESP_FR_MAXLEN  (WLAN_HDR_A3_LEN + 16)
#define WLAN_REASSOCREQ_FR_MAXLEN (WLAN_HDR_A3_LEN + 54)
#define WLAN_REASSOCRESP_FR_MAXLEN  (WLAN_HDR_A3_LEN + 16)
#define WLAN_PROBEREQ_FR_MAXLEN   (WLAN_HDR_A3_LEN + 44)
#define WLAN_PROBERESP_FR_MAXLEN  (WLAN_HDR_A3_LEN + 78)
#define WLAN_AUTHEN_FR_MAXLEN   (WLAN_HDR_A3_LEN + 261)
#define WLAN_DEAUTHEN_FR_MAXLEN   (WLAN_HDR_A3_LEN + 2)
#define WLAN_WEP_NKEYS      4
#define WLAN_WEP_MAXKEYLEN    13
#define WLAN_CHALLENGE_IE_LEN   130
#define WLAN_CHALLENGE_LEN    128
#define WLAN_WEP_IV_LEN     4
#define WLAN_WEP_ICV_LEN    4

/*--- Frame Control Field -------------------------------------*/
/* Frame Types */
#define WLAN_FTYPE_MGMT     0x00
#define WLAN_FTYPE_CTL      0x01
#define WLAN_FTYPE_DATA     0x02

/* Frame subtypes */
/* Management */
#define WLAN_FSTYPE_ASSOCREQ    0x00
#define WLAN_FSTYPE_ASSOCRESP   0x01
#define WLAN_FSTYPE_REASSOCREQ    0x02
#define WLAN_FSTYPE_REASSOCRESP   0x03
#define WLAN_FSTYPE_PROBEREQ    0x04 
#define WLAN_FSTYPE_PROBERESP   0x05
#define WLAN_FSTYPE_BEACON    0x08
#define WLAN_FSTYPE_ATIM    0x09
#define WLAN_FSTYPE_DISASSOC    0x0a
#define WLAN_FSTYPE_AUTHEN    0x0b
#define WLAN_FSTYPE_DEAUTHEN    0x0c

/* Control */
#define WLAN_FSTYPE_BLOCKACKREQ   0x8
#define WLAN_FSTYPE_BLOCKACK      0x9
#define WLAN_FSTYPE_PSPOLL    0x0a
#define WLAN_FSTYPE_RTS     0x0b
#define WLAN_FSTYPE_CTS     0x0c
#define WLAN_FSTYPE_ACK     0x0d
#define WLAN_FSTYPE_CFEND   0x0e
#define WLAN_FSTYPE_CFENDCFACK    0x0f

/* Data */
#define WLAN_FSTYPE_DATAONLY    0x00
#define WLAN_FSTYPE_DATA_CFACK    0x01
#define WLAN_FSTYPE_DATA_CFPOLL   0x02
#define WLAN_FSTYPE_DATA_CFACK_CFPOLL 0x03
#define WLAN_FSTYPE_NULL    0x04
#define WLAN_FSTYPE_CFACK   0x05
#define WLAN_FSTYPE_CFPOLL    0x06
#define WLAN_FSTYPE_CFACK_CFPOLL  0x07

/* Data with QOS */
#define WLAN_FSTYPE_QOS_MASK    0x08
#define WLAN_FSTYPE_QOS_UNMASK    0x07
#define WLAN_FSTYPE_QOS_DATAONLY    (WLAN_FSTYPE_DATAONLY + WLAN_FSTYPE_QOS_MASK)
#define WLAN_FSTYPE_QOS_DATA_CFACK    (WLAN_FSTYPE_DATA_CFACK + WLAN_FSTYPE_QOS_MASK)
#define WLAN_FSTYPE_QOS_DATA_CFPOLL   (WLAN_FSTYPE_DATA_CFPOLL + WLAN_FSTYPE_QOS_MASK)
#define WLAN_FSTYPE_QOS_DATA_CFACK_CFPOLL (WLAN_FSTYPE_DATA_CFACK_CFPOLL + WLAN_FSTYPE_QOS_MASK)
#define WLAN_FSTYPE_QOS_NULL      (WLAN_FSTYPE_NULL + WLAN_FSTYPE_QOS_MASK)
#define WLAN_FSTYPE_QOS_CFACK     (WLAN_FSTYPE_CFACK + WLAN_FSTYPE_QOS_MASK)
#define WLAN_FSTYPE_QOS_CFPOLL      (WLAN_FSTYPE_CFPOLL + WLAN_FSTYPE_QOS_MASK)
#define WLAN_FSTYPE_QOS_CFACK_CFPOLL    (WLAN_FSTYPE_CFACK_CFPOLL + WLAN_FSTYPE_QOS_MASK)


/*================================================================*/
/* Macros */

/*--- FC Macros ----------------------------------------------*/
/* Macros to get/set the bitfields of the Frame Control Field */
/*  GET_FC_??? - takes the host byte-order value of an FC     */
/*               and retrieves the value of one of the        */
/*               bitfields and moves that value so its lsb is */
/*               in bit 0.                                    */
/*  SET_FC_??? - takes a host order value for one of the FC   */
/*               bitfields and moves it to the proper bit     */
/*               location for ORing into a host order FC.     */
/*               To send the FC produced from SET_FC_???,     */
/*               one must put the bytes in IEEE order.        */
/*  e.g.                                                      */
/*     printf("the frame subtype is %x",                      */
/*                 GET_FC_FTYPE( ieee2host( rx.fc )))         */
/*                                                            */
/*     tx.fc = host2ieee( SET_FC_FTYPE(WLAN_FTYP_CTL) |       */
/*                        SET_FC_FSTYPE(WLAN_FSTYPE_RTS) );   */
/*------------------------------------------------------------*/

#define WLAN_GET_FC_PVER(n)  (((UINT16)(n)) & (BIT0 | BIT1))
#define WLAN_GET_FC_FTYPE(n)  ((((UINT16)(n)) & (BIT2 | BIT3)) >> 2)
#define WLAN_GET_FC_FSTYPE(n) ((((UINT16)(n)) & (BIT4|BIT5|BIT6|BIT7)) >> 4)
#define WLAN_GET_FC_TODS(n)   ((((UINT16)(n)) & (BIT8)) >> 8)
#define WLAN_GET_FC_FROMDS(n) ((((UINT16)(n)) & (BIT9)) >> 9)
#define WLAN_GET_FC_MOREFRAG(n) ((((UINT16)(n)) & (BIT10)) >> 10)
#define WLAN_GET_FC_RETRY(n)  ((((UINT16)(n)) & (BIT11)) >> 11)
#define WLAN_GET_FC_PWRMGT(n) ((((UINT16)(n)) & (BIT12)) >> 12)
#define WLAN_GET_FC_MOREDATA(n) ((((UINT16)(n)) & (BIT13)) >> 13)
#define WLAN_GET_FC_ISWEP(n)  ((((UINT16)(n)) & (BIT14)) >> 14)
#define WLAN_GET_FC_ORDER(n)  ((((UINT16)(n)) & (BIT15)) >> 15)

#define WLAN_SET_FC_PVER(n) ((UINT16)(n))
#define WLAN_SET_FC_FTYPE(n)  (((UINT16)(n)) << 2)
#define WLAN_SET_FC_FSTYPE(n) (((UINT16)(n)) << 4)
#define WLAN_SET_FC_TODS(n)   (((UINT16)(n)) << 8)
#define WLAN_SET_FC_FROMDS(n) (((UINT16)(n)) << 9)
#define WLAN_SET_FC_MOREFRAG(n) (((UINT16)(n)) << 10)
#define WLAN_SET_FC_RETRY(n)  (((UINT16)(n)) << 11)
#define WLAN_SET_FC_PWRMGT(n) (((UINT16)(n)) << 12)
#define WLAN_SET_FC_MOREDATA(n) (((UINT16)(n)) << 13)
#define WLAN_SET_FC_ISWEP(n)  (((UINT16)(n)) << 14)
#define WLAN_SET_FC_ORDER(n)  (((UINT16)(n)) << 15)

/*--- Duration Macros ----------------------------------------*/
/* Macros to get/set the bitfields of the Duration Field      */
/*  - the duration value is only valid when bit15 is zero     */
/*  - the firmware handles these values, so I'm not going     */
/*    these macros right now.                                 */
/*------------------------------------------------------------*/

/*--- Sequence Control  Macros -------------------------------*/
/* Macros to get/set the bitfields of the Sequence Control    */
/* Field.                                                     */
/*------------------------------------------------------------*/
#define WLAN_GET_SEQ_FRGNUM(n) (((UINT16)(n)) & (BIT0|BIT1|BIT2|BIT3))
#define WLAN_GET_SEQ_SEQNUM(n) ((((UINT16)(n)) & (~(BIT0|BIT1|BIT2|BIT3))) >> 4) 

/*--- Data ptr macro -----------------------------------------*/
/* Creates a UINT8* to the data portion of a frame            */
/* Assumes you're passing in a ptr to the beginning of the hdr*/
/*------------------------------------------------------------*/
#define WLAN_HDR_A3_DATAP(p) (((UINT8*)(p)) + WLAN_HDR_A3_LEN)
#define WLAN_HDR_A4_DATAP(p) (((UINT8*)(p)) + WLAN_HDR_A4_LEN)

#define DOT11_RATE5_ISBASIC_GET(r)     (((UINT8)(r)) & BIT7)

/*================================================================*/
/* Types */

/* BSS Timestamp */
typedef UINT8 wlan_bss_ts_t[WLAN_BSS_TS_LEN];

/* Generic 802.11 Header types */

typedef struct p80211_hdr_a3
{
  UINT16  fc;
  UINT16  dur;
  UINT8 a1[WLAN_ADDR_LEN];
  UINT8 a2[WLAN_ADDR_LEN];
  UINT8 a3[WLAN_ADDR_LEN];
  UINT16  seq;
} __WLAN_ATTRIB_PACK__ p80211_hdr_a3_t;

typedef struct p80211_hdr_a4
{
  UINT16  fc;
  UINT16  dur;
  UINT8 a1[WLAN_ADDR_LEN];
  UINT8 a2[WLAN_ADDR_LEN];
  UINT8 a3[WLAN_ADDR_LEN];
  UINT16  seq;
  UINT8 a4[WLAN_ADDR_LEN];
} __WLAN_ATTRIB_PACK__ p80211_hdr_a4_t;

typedef union p80211_hdr
{
  p80211_hdr_a3_t   a3;
  p80211_hdr_a4_t   a4;
} __WLAN_ATTRIB_PACK__ p80211_hdr_t;


/*================================================================*/
/* Extern Declarations */


/*================================================================*/
/* Function Declarations */

/* Frame and header lenght macros */

#define WLAN_CTL_FRAMELEN(fstype) (\
  (fstype) == WLAN_FSTYPE_BLOCKACKREQ ? 24 : \
  (fstype) == WLAN_FSTYPE_BLOCKACK    ? 152 : \
  (fstype) == WLAN_FSTYPE_PSPOLL    ? 20 : \
  (fstype) == WLAN_FSTYPE_RTS   ? 20 : \
  (fstype) == WLAN_FSTYPE_CTS   ? 14 : \
  (fstype) == WLAN_FSTYPE_ACK   ? 14 : \
  (fstype) == WLAN_FSTYPE_CFEND   ? 20 : \
  (fstype) == WLAN_FSTYPE_CFENDCFACK  ? 20 : 4)

#define WLAN_FCS_LEN      4

/* ftcl in HOST order */
inline static UINT16 p80211_headerlen(UINT16 fctl)
{
  UINT16 hdrlen = 0;

  switch ( WLAN_GET_FC_FTYPE(fctl) ) {
  case WLAN_FTYPE_MGMT:
    hdrlen = WLAN_HDR_A3_LEN;
    break;
  case WLAN_FTYPE_DATA:
    hdrlen = WLAN_HDR_A3_LEN;
    if ( WLAN_GET_FC_TODS(fctl) && WLAN_GET_FC_FROMDS(fctl) ) {
      hdrlen += WLAN_ADDR_LEN;
    }
    break;
  case WLAN_FTYPE_CTL:
    hdrlen = WLAN_CTL_FRAMELEN(WLAN_GET_FC_FSTYPE(fctl)) - 
      WLAN_FCS_LEN; 
    break;
  default:
    hdrlen = WLAN_HDR_A3_LEN;
  }
  
  return hdrlen;
}

#endif /* _P80211HDR_H */

---