lr-wpan-mac-header.h

Go to the documentation of this file.

/* -*-  Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
/*
 * Copyright (c) 2011 The Boeing Company
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation;
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 *  Author: kwong yin <kwong-sang.yin@boeing.com>
 */
 
/*
 * the following classes implements the 802.15.4 Mac Header
 * There are 4 types of 802.15.4 Mac Headers Frames, and they have these fields
 *
 *    Headers Frames  : Fields
 *    -------------------------------------------------------------------------------------------
 *    Beacon          : Frame Control, Sequence Number, Address Fields+, Auxiliary Security Header++.
 *    Data            : Frame Control, Sequence Number, Address Fields++, Auxiliary Security Header++.
 *    Acknowledgment  : Frame Control, Sequence Number.
 *    Command         : Frame Control, Sequence Number, Address Fields++, Auxiliary Security Header++.
 *
 *    + - The Address fields in Beacon frame is made up of the Source PAN Id and address only and size
 *        is  4 or 8 octets whereas the other frames may contain the Destination PAN Id and address as
 *        well. (see specs).
 *    ++ - These fields are optional and of variable size
 */
 
#ifndef LR_WPAN_MAC_HEADER_H
#define LR_WPAN_MAC_HEADER_H
 
#include <ns3/header.h>
#include <ns3/mac16-address.h>
#include <ns3/mac64-address.h>
 
 
namespace ns3 {
 
 
class LrWpanMacHeader : public Header
{
 
public:
  enum LrWpanMacType
  {
    LRWPAN_MAC_BEACON = 0,         
    LRWPAN_MAC_DATA = 1,           
    LRWPAN_MAC_ACKNOWLEDGMENT = 2, 
    LRWPAN_MAC_COMMAND = 3,        
    LRWPAN_MAC_RESERVED            
  };
 
  enum AddrModeType
  {
    NOADDR = 0,
    RESADDR = 1,
    SHORTADDR = 2,
    EXTADDR = 3
  };
 
  enum KeyIdModeType
  {
    IMPLICIT = 0,
    NOKEYSOURCE = 1,
    SHORTKEYSOURCE = 2,
    LONGKEYSOURCE = 3
  };
 
  LrWpanMacHeader (void);
 
  LrWpanMacHeader (enum LrWpanMacType wpanMacType,      // Data, ACK, Control MAC Header must have
                   uint8_t seqNum);                     // frame control and sequence number.
                                                        // Beacon MAC Header must have frame control,
                                                        // sequence number, source PAN Id, source address.
 
  ~LrWpanMacHeader (void);
 
  enum LrWpanMacType GetType (void) const;
  uint16_t GetFrameControl (void) const;
  bool IsSecEnable (void) const;
  bool IsFrmPend (void) const;
  bool IsAckReq (void) const;
  bool IsPanIdComp (void) const;
  uint8_t GetFrmCtrlRes (void) const;
  uint8_t GetDstAddrMode (void) const;
  uint8_t GetFrameVer (void) const;
  uint8_t GetSrcAddrMode (void) const;
  uint8_t GetSeqNum (void) const;
  uint16_t GetDstPanId (void) const;
  Mac16Address GetShortDstAddr (void) const;
  Mac64Address GetExtDstAddr (void) const;
  uint16_t GetSrcPanId (void) const;
  Mac16Address GetShortSrcAddr (void) const;
  Mac64Address GetExtSrcAddr (void) const;
  uint8_t GetSecControl (void) const;
  uint32_t GetFrmCounter (void) const;
 
  uint8_t GetSecLevel (void) const;
  uint8_t GetKeyIdMode (void) const;
  uint8_t GetSecCtrlReserved (void) const;
  uint32_t GetKeyIdSrc32 (void) const;
  uint64_t GetKeyIdSrc64 (void) const;
  uint8_t GetKeyIdIndex (void) const;
  bool IsBeacon (void) const;
  bool IsData (void) const;
  bool IsAcknowledgment (void) const;
  bool IsCommand (void) const;
  void SetType (enum LrWpanMacType wpanMacType);
  void SetFrameControl (uint16_t frameControl);
  void SetSecEnable (void);
  void SetSecDisable (void);
  void SetFrmPend (void);
  void SetNoFrmPend (void);
  void SetAckReq (void);
  void SetNoAckReq (void);
  void SetPanIdComp (void);
  void SetNoPanIdComp (void);
  void SetFrmCtrlRes (uint8_t res);
  void SetDstAddrMode (uint8_t addrMode);
  void SetFrameVer (uint8_t ver);
  void SetSrcAddrMode (uint8_t addrMode);
  void SetSeqNum (uint8_t seqNum);
  /* The Source/Destination Addressing fields are only set if SrcAddrMode/DstAddrMode are set */
  void SetSrcAddrFields (uint16_t panId, Mac16Address addr);
  void SetSrcAddrFields (uint16_t panId, Mac64Address addr);
  void SetDstAddrFields (uint16_t panId, Mac16Address addr);
  void SetDstAddrFields (uint16_t panId, Mac64Address addr);
 
  /* Auxiliary Security Header is only set if Sec Enable (SecU) field is set to 1 */
  void SetSecControl (uint8_t secLevel);
  void SetFrmCounter (uint32_t frmCntr);
  void SetSecLevel (uint8_t secLevel);
  void SetKeyIdMode (uint8_t keyIdMode);
  void SetSecCtrlReserved (uint8_t res);
  /* Variable length will be dependent on Key Id Mode*/
  void SetKeyId (uint8_t keyIndex);
  void SetKeyId (uint32_t keySrc, uint8_t keyIndex);
  void SetKeyId (uint64_t keySrc, uint8_t keyIndex);
  static TypeId GetTypeId (void);
  virtual TypeId GetInstanceTypeId (void) const;
 
  void Print (std::ostream &os) const;
  uint32_t GetSerializedSize (void) const;
  void Serialize (Buffer::Iterator start) const;
  uint32_t Deserialize (Buffer::Iterator start);
 
 
private:
  /* Frame Control 2 Octets */
  /* Frame Control field - see 7.2.1.1 */
  uint8_t m_fctrlFrmType;               
  uint8_t m_fctrlSecU;                  
  uint8_t m_fctrlFrmPending;            
  uint8_t m_fctrlAckReq;                
  uint8_t m_fctrlPanIdComp;             
  uint8_t m_fctrlReserved;              
  uint8_t m_fctrlDstAddrMode;           
  uint8_t m_fctrlFrmVer;                
  uint8_t m_fctrlSrcAddrMode;           
 
  /* Sequence Number */
  uint8_t m_SeqNum;                     
 
  /* Addressing fields */
  uint16_t m_addrDstPanId;              
  Mac16Address m_addrShortDstAddr;      
  Mac64Address m_addrExtDstAddr;        
  uint16_t m_addrSrcPanId;              
  Mac16Address m_addrShortSrcAddr;      
  Mac64Address m_addrExtSrcAddr;        
 
  /* Auxiliary Security Header - See 7.6.2 - 0, 5, 6, 10 or 14 Octets */
  // uint8_t m_auxSecCtrl;              // 1 Octet see below
  uint32_t m_auxFrmCntr;                
 
  /* Security Control fields - See 7.6.2.2 */
  uint8_t m_secctrlSecLevel;            
  uint8_t m_secctrlKeyIdMode;           
                                        // = 0 - Key is determined implicitly
                                        //       from originator and recipient
                                        // = 1 - 1 Octet Key Index
                                        // = 2 - 1 Octet Key Index and 4 oct Key src
                                        // = 3 - 1 Octet Key Index and 8 oct Key src
 
  uint8_t m_secctrlReserved;            
 
  union
  {
    uint32_t m_auxKeyIdKeySrc32;        
    uint64_t m_auxKeyIdKeySrc64;        
  }; 
 
  uint8_t m_auxKeyIdKeyIndex;           
 
}; //LrWpanMacHeader
 
}; // namespace ns-3
 
#endif /* LR_WPAN_MAC_HEADER_H */