ieee802.h

Go to the documentation of this file.

/*NB_REVISION*/
 
/*NB_COPYRIGHT*/
 
#ifndef _IEEE802_H_
#define _IEEE802_H_
#include <nettypes.h>
 
/*
 ******************************************************************************
 *
 * All structures are in network order (big-endian)
 *
 ******************************************************************************
 */
 
/*
 ******************************************************************************
 *
 * Constant definitions
 *
 ******************************************************************************
 */
/*  Destination service access point */
#define IEEE802_DSAP_SNAP_PACKET_UNNUMBERED (0xAA)
 
/*  Source service access point */
#define IEEE802_SSAP_SNAP_PACKET_UNNUMBERED (0xAA)
 
/*  Source service access point */
#define IEEE802_CONTROL_SNAP_PACKET_UNNUMBERED (0x03)
 
/*
   OUI
      IEEE802_OUI_ETHERNET_TYPE  00-00-00
      IEEE801_OUI_DEC            00-00-F8
 
   Notes:
      Only OUI byte 3 changes so far
 
 */
#define IEEE802_OUI_ETHERNET_TYPE (0x00)
#define IEEE801_OUI_DEC (0xF8)
 
/* OUI length */
#define IEEE802_P80211_OUI_LEN (3)
 
/*
   IEEE 802.11 Control Frame
      Type
         IEEE80211_TYPE_MANAGEMENT     - Management
         IEEE80211_TYPE_CONTROL        - Control
         IEEE80211_TYPE_DATA           - Data
 
      Subtype
         IEEE80211_SUBTYPE_DATA        - Data
         IEEE80211_SUBTYPE_NULL        - No data
         IEEE80211_SUBTYPE_QOS         - QOS
 
 */
#define IEEE80211_TYPE_MANAGEMENT (0x0)
#define IEEE80211_TYPE_CONTROL (0x1)
#define IEEE80211_TYPE_DATA (0x2)
 
#define IEEE80211_SUBTYPE_DATA (0x0)
#define IEEE80211_SUBTYPE_NULL (0x4)
#define IEEE80211_SUBTYPE_QOS (0x8)
 
/*
 ******************************************************************************
 *
 * Structures
 *
 ******************************************************************************
 */
/*
   IEEE 802.3 Standard Frame Media Access Control (MAC) Header
      destination          - Destination MAC-48
      source               - Source MAC-48 address
      typeOrLength         - Type or length
 
*/
typedef struct _Ieee802_3_Header
{
    MACADDRESS_48 destination;
    MACADDRESS_48 source;
    beuint16_t typeOrLength;
 
} __attribute__((packed)) Ieee802_3_Header;
 
/*
   IEEE 802.2 Logical Link Control (LLC) +
         Subnetwork Access Protocol (SNAP) header
 
      dsap                 - Destination service access point
      ssap                 - Source service access point
      control              - Control
      oui                  - Organizationally Unique Identfier
 
 
*/
typedef struct _Ieee802_2_SnapHeader
{
    /* LLC for SNAP Header 0xAA 0xAA 0x03 */
    uint8_t dsap;
    uint8_t ssap;
    uint8_t control;
 
    /* Organizational Unique Identifier */
    uint8_t oui[IEEE802_P80211_OUI_LEN];
 
    /* Typically EtherType IPV4 (0x0800) */
    beuint16_t protocolType;
 
} __attribute__((packed)) Ieee802_2_SnapHeader;
 
/*
 ******************************************************************************
 * IEEE 802.11
 ******************************************************************************
 */
/*
   IEEE 802.11 Packet Header Frame Control Field
      order                - 1 frames strictly ordered
      wep                  - 1 yes, 0 no
      more                 - More data for destination
      power                - 1 power save, 0 no after transmit
      retry                - Retransmission of previous fragment
      fragmented           - 1 more fragment frames to follow, 0 last frame
      fromDs               - Incoming from distribution system
      toDs                 - Forward to distribution system
      subType              - Subtype
      type                 - Type
      version              - Currently 0
 
 */
typedef struct _FrameControl
{
    uint16_t order : 1;
    uint16_t wep : 1;
    uint16_t more : 1;
    uint16_t power : 1;
    uint16_t retry : 1;
    uint16_t fragmented : 1;
    uint16_t fromDs : 1;
    uint16_t toDs : 1;
    uint16_t subType : 4;
    uint16_t type : 2;
    uint16_t version : 2;
 
} __attribute__((packed)) FrameControl;
 
/*
   IEEE 802.11 Packet Header Format
      frameControl         - Frame control
      durationId           - Data frame duration, control id of transmitter
      address[1|2|3|4}     - MAC-48 address based on control frame from/to DS
      sequence             - sequence control
 
   Notes:
      Precedes data followed by 4 byte frame sequence check defined in P802.11
      Addresses
          -------------------------------------------------------------------
         |  To DS  | From DS | Address 1 | Address 2 | Address 3 | Address 4 |
          -------------------------------------------------------------------
         |    0    |    0    |    DA     |    SA     |   BSSID   |    N/A    |
         |    0    |    1    |    DA     |   BSSID   |    SA     |    N/A    |
         |    1    |    0    |   BSSID   |    SA     |    DA     |    N/A    |
         |    1    |    1    |    RA     |    TA     |    DA     |    SA     |
 
      ONLY defined for 3 addresses, the 4 address header is used AP to AP
 
 */
typedef struct _Ieee802_11_Header
{
    FrameControl frameControl;
    beuint16_t durationId;
    MACADDRESS_48 address1;
    MACADDRESS_48 address2;
    MACADDRESS_48 address3;
    beuint16_t sequence;
 
} __attribute__((packed)) Ieee802_11_Header;
 
#endif /* _IEEE802_H_ */