3.35/doxygen/wifi-mac-header_8h_source.html

/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */

/*

 * Copyright (c) 2006, 2009 INRIA

 * Copyright (c) 2009 MIRKO BANCHI

 *

 * 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: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>

 * Author: Mirko Banchi <mk.banchi@gmail.com>

 */


#ifndef WIFI_MAC_HEADER_H

#define WIFI_MAC_HEADER_H


#include "ns3/header.h"

#include "ns3/mac48-address.h"


namespace ns3 {


class Time;


enum WifiMacType

{

  WIFI_MAC_CTL_TRIGGER = 0,

  WIFI_MAC_CTL_CTLWRAPPER,

  WIFI_MAC_CTL_RTS,

  WIFI_MAC_CTL_CTS,

  WIFI_MAC_CTL_ACK,

  WIFI_MAC_CTL_BACKREQ,

  WIFI_MAC_CTL_BACKRESP,

  WIFI_MAC_CTL_END,

  WIFI_MAC_CTL_END_ACK,


  WIFI_MAC_MGT_BEACON,

  WIFI_MAC_MGT_ASSOCIATION_REQUEST,

  WIFI_MAC_MGT_ASSOCIATION_RESPONSE,

  WIFI_MAC_MGT_DISASSOCIATION,

  WIFI_MAC_MGT_REASSOCIATION_REQUEST,

  WIFI_MAC_MGT_REASSOCIATION_RESPONSE,

  WIFI_MAC_MGT_PROBE_REQUEST,

  WIFI_MAC_MGT_PROBE_RESPONSE,

  WIFI_MAC_MGT_AUTHENTICATION,

  WIFI_MAC_MGT_DEAUTHENTICATION,

  WIFI_MAC_MGT_ACTION,

  WIFI_MAC_MGT_ACTION_NO_ACK,

  WIFI_MAC_MGT_MULTIHOP_ACTION,


  WIFI_MAC_DATA,

  WIFI_MAC_DATA_CFACK,

  WIFI_MAC_DATA_CFPOLL,

  WIFI_MAC_DATA_CFACK_CFPOLL,

  WIFI_MAC_DATA_NULL,

  WIFI_MAC_DATA_NULL_CFACK,

  WIFI_MAC_DATA_NULL_CFPOLL,

  WIFI_MAC_DATA_NULL_CFACK_CFPOLL,

  WIFI_MAC_QOSDATA,

  WIFI_MAC_QOSDATA_CFACK,

  WIFI_MAC_QOSDATA_CFPOLL,

  WIFI_MAC_QOSDATA_CFACK_CFPOLL,

  WIFI_MAC_QOSDATA_NULL,

  WIFI_MAC_QOSDATA_NULL_CFPOLL,

  WIFI_MAC_QOSDATA_NULL_CFACK_CFPOLL,

};


class WifiMacHeader : public Header

{

public:

  enum QosAckPolicy

  {

    NORMAL_ACK = 0,

    NO_ACK = 1,

    NO_EXPLICIT_ACK = 2,

    BLOCK_ACK = 3,

  };


  enum AddressType

  {

    ADDR1,

    ADDR2,

    ADDR3,

    ADDR4

  };


  WifiMacHeader ();

  WifiMacHeader (WifiMacType type);

  virtual ~WifiMacHeader ();


  static TypeId GetTypeId (void);


  TypeId GetInstanceTypeId (void) const override;

  void Print (std::ostream &os) const override;

  uint32_t GetSerializedSize (void) const override;

  void Serialize (Buffer::Iterator start) const override;

  uint32_t Deserialize (Buffer::Iterator start) override;


  void SetDsFrom (void);

  void SetDsNotFrom (void);

  void SetDsTo (void);

  void SetDsNotTo (void);

  void SetAddr1 (Mac48Address address);

  void SetAddr2 (Mac48Address address);

  void SetAddr3 (Mac48Address address);

  void SetAddr4 (Mac48Address address);

  void SetType (WifiMacType type, bool resetToDsFromDs = true);

  void SetRawDuration (uint16_t duration);

  void SetDuration (Time duration);

  void SetId (uint16_t id);

  void SetSequenceNumber (uint16_t seq);

  void SetFragmentNumber (uint8_t frag);

  void SetNoMoreFragments (void);

  void SetMoreFragments (void);

  void SetRetry (void);

  void SetNoRetry (void);

  void SetQosTid (uint8_t tid);

  void SetQosEosp ();

  void SetQosNoEosp ();

  void SetQosAckPolicy (QosAckPolicy policy);

  void SetQosAmsdu (void);

  void SetQosNoAmsdu (void);

  void SetQosTxopLimit (uint8_t txop);

  void SetQosQueueSize (uint8_t size);

  void SetQosMeshControlPresent ();

  void SetQosNoMeshControlPresent ();

  void SetOrder (void);

  void SetNoOrder (void);


  Mac48Address GetAddr1 (void) const;

  Mac48Address GetAddr2 (void) const;

  Mac48Address GetAddr3 (void) const;

  Mac48Address GetAddr4 (void) const;

  WifiMacType GetType (void) const;

  bool IsFromDs (void) const;

  bool IsToDs (void) const;

  bool IsData (void) const;

  bool IsQosData (void) const;

  bool HasData (void) const;

  bool IsCtl (void) const;

  bool IsMgt (void) const;

  bool IsCfPoll (void) const;

  bool IsCfAck (void) const;

  bool IsCfEnd (void) const;

  bool IsRts (void) const;

  bool IsCts (void) const;

  bool IsAck (void) const;

  bool IsBlockAckReq (void) const;

  bool IsBlockAck (void) const;

  bool IsTrigger (void) const;

  bool IsAssocReq (void) const;

  bool IsAssocResp (void) const;

  bool IsReassocReq (void) const;

  bool IsReassocResp (void) const;

  bool IsProbeReq (void) const;

  bool IsProbeResp (void) const;

  bool IsBeacon (void) const;

  bool IsDisassociation (void) const;

  bool IsAuthentication (void) const;

  bool IsDeauthentication (void) const;

  bool IsAction (void) const;

  bool IsMultihopAction (void) const;

  uint16_t GetRawDuration (void) const;

  Time GetDuration (void) const;

  uint16_t GetSequenceControl (void) const;

  uint16_t GetSequenceNumber (void) const;

  uint8_t GetFragmentNumber (void) const;

  bool IsRetry (void) const;

  bool IsMoreFragments (void) const;

  bool IsQosBlockAck (void) const;

  bool IsQosNoAck (void) const;

  bool IsQosAck (void) const;

  bool IsQosEosp (void) const;

  bool IsQosAmsdu (void) const;

  uint8_t GetQosTid (void) const;

  QosAckPolicy GetQosAckPolicy (void) const;

  uint8_t GetQosQueueSize (void) const;

  uint32_t GetSize (void) const;

  const char * GetTypeString (void) const;


  typedef void (* TracedCallback)(const WifiMacHeader &header);


private:

  uint16_t GetFrameControl (void) const;

  uint16_t GetQosControl (void) const;

  void SetFrameControl (uint16_t control);

  void SetSequenceControl (uint16_t seq);

  void SetQosControl (uint16_t qos);

  void PrintFrameControl (std::ostream &os) const;


  uint8_t m_ctrlType;

  uint8_t m_ctrlSubtype;

  uint8_t m_ctrlToDs;

  uint8_t m_ctrlFromDs;

  uint8_t m_ctrlMoreFrag;

  uint8_t m_ctrlRetry;

  uint8_t m_ctrlMoreData;

  uint8_t m_ctrlWep;

  uint8_t m_ctrlOrder;

  uint16_t m_duration;

  Mac48Address m_addr1;

  Mac48Address m_addr2;

  Mac48Address m_addr3;

  uint8_t m_seqFrag;

  uint16_t m_seqSeq;

  Mac48Address m_addr4;

  uint8_t m_qosTid;

  uint8_t m_qosEosp;

  uint8_t m_qosAckPolicy;

  uint8_t m_amsduPresent;

  uint8_t m_qosStuff;

};


} //namespace ns3


#endif /* WIFI_MAC_HEADER_H */