wifi-mac-header.h

Go to the documentation of this file.

/*
 * Copyright (c) 2006, 2009 INRIA
 * Copyright (c) 2009 MIRKO BANCHI
 *
 * SPDX-License-Identifier: GPL-2.0-only
 *
 * 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;
 
/**
 * Combination of valid MAC header type/subtype.
 */
enum WifiMacType
{
    WIFI_MAC_CTL_TRIGGER = 0,
    WIFI_MAC_CTL_CTLWRAPPER,
    WIFI_MAC_CTL_PSPOLL,
    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_CTL_DMG_POLL,
    WIFI_MAC_CTL_DMG_SPR,
    WIFI_MAC_CTL_DMG_GRANT,
    WIFI_MAC_CTL_DMG_CTS,
    WIFI_MAC_CTL_DMG_DTS,
    WIFI_MAC_CTL_DMG_SSW,
    WIFI_MAC_CTL_DMG_SSW_FBCK,
    WIFI_MAC_CTL_DMG_SSW_ACK,
    WIFI_MAC_CTL_DMG_GRANT_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,
 
    WIFI_MAC_EXTENSION_DMG_BEACON,
};
 
/**
 * \ingroup wifi
 *
 * Implements the IEEE 802.11 MAC header
 */
class WifiMacHeader : public Header
{
  public:
    /**
     * Ack policy for QoS frames.
     */
    enum QosAckPolicy
    {
        NORMAL_ACK = 0,
        NO_ACK = 1,
        NO_EXPLICIT_ACK = 2,
        BLOCK_ACK = 3,
    };
 
    /**
     * Address types.
     */
    enum AddressType
    {
        ADDR1,
        ADDR2,
        ADDR3,
        ADDR4
    };
 
    WifiMacHeader() = default;
    /**
     * Construct a MAC header of the given type
     *
     * \param type the MAC header type
     */
    WifiMacHeader(WifiMacType type);
 
    /**
     * \brief Get the type ID.
     * \return the object TypeId
     */
    static TypeId GetTypeId();
 
    TypeId GetInstanceTypeId() const override;
    void Print(std::ostream& os) const override;
    uint32_t GetSerializedSize() const override;
    void Serialize(Buffer::Iterator start) const override;
    uint32_t Deserialize(Buffer::Iterator start) override;
 
    /**
     * Set the From DS bit in the Frame Control field.
     */
    void SetDsFrom();
    /**
     * Un-set the From DS bit in the Frame Control field.
     */
    void SetDsNotFrom();
    /**
     * Set the To DS bit in the Frame Control field.
     */
    void SetDsTo();
    /**
     * Un-set the To DS bit in the Frame Control field.
     */
    void SetDsNotTo();
    /**
     * Fill the Address 1 field with the given address.
     *
     * \param address the address to be used in the Address 1 field
     */
    void SetAddr1(Mac48Address address);
    /**
     * Fill the Address 2 field with the given address.
     *
     * \param address the address to be used in the Address 2 field
     */
    void SetAddr2(Mac48Address address);
    /**
     * Fill the Address 3 field with the given address.
     *
     * \param address the address to be used in the Address 3 field
     */
    void SetAddr3(Mac48Address address);
    /**
     * Fill the Address 4 field with the given address.
     *
     * \param address the address to be used in the Address 4 field
     */
    void SetAddr4(Mac48Address address);
    /**
     * Set Type/Subtype values with the correct values depending
     * on the given type.
     *
     * \param type the WifiMacType for the header
     * \param resetToDsFromDs whether the ToDs and FromDs flags
     *        should be reset.
     */
    virtual void SetType(WifiMacType type, bool resetToDsFromDs = true);
    /**
     * Set the Duration/ID field with the given raw uint16_t value.
     *
     * \param duration the raw duration in uint16_t
     */
    void SetRawDuration(uint16_t duration);
    /**
     * Set the Duration/ID field with the given duration (Time object).
     * The method converts the given time to microseconds.
     *
     * \param duration the duration (Time object)
     */
    void SetDuration(Time duration);
    /**
     * Set the Duration/ID field with the given ID.
     *
     * \param id the ID
     */
    void SetId(uint16_t id);
    /**
     * Set the sequence number of the header.
     *
     * \param seq the given sequence number
     */
    void SetSequenceNumber(uint16_t seq);
    /**
     * Set the fragment number of the header.
     *
     * \param frag the given fragment number
     */
    void SetFragmentNumber(uint8_t frag);
    /**
     * Un-set the More Fragment bit in the Frame Control Field
     */
    void SetNoMoreFragments();
    /**
     * Set the More Fragment bit in the Frame Control field
     */
    void SetMoreFragments();
    /**
     * Set the Retry bit in the Frame Control field.
     */
    void SetRetry();
    /**
     * Un-set the Retry bit in the Frame Control field.
     */
    void SetNoRetry();
    /**
     * Set the Power Management bit in the Frame Control field.
     */
    void SetPowerManagement();
    /**
     * Un-set the Power Management bit in the Frame Control field.
     */
    void SetNoPowerManagement();
    /**
     * Set the TID for the QoS header.
     *
     * \param tid the TID for the QoS header
     */
    void SetQosTid(uint8_t tid);
    /**
     * Set the end of service period (EOSP) bit in the QoS control field.
     */
    void SetQosEosp();
    /**
     * Un-set the end of service period (EOSP) bit in the QoS control field.
     */
    void SetQosNoEosp();
    /**
     * Set the QoS Ack policy in the QoS control field.
     *
     * \param policy the Qos Ack policy
     */
    void SetQosAckPolicy(QosAckPolicy policy);
    /**
     * Set that A-MSDU is present.
     */
    void SetQosAmsdu();
    /**
     * Set that A-MSDU is not present.
     */
    void SetQosNoAmsdu();
    /**
     * Set TXOP limit in the QoS control field.
     *
     * \param txop the TXOP limit
     */
    void SetQosTxopLimit(uint8_t txop);
    /**
     * Set the Queue Size subfield in the QoS control field.
     *
     * \param size the value for the Queue Size subfield
     */
    void SetQosQueueSize(uint8_t size);
    /**
     * Set the Mesh Control Present flag for the QoS header.
     */
    void SetQosMeshControlPresent();
    /**
     * Clear the Mesh Control Present flag for the QoS header.
     */
    void SetQosNoMeshControlPresent();
    /**
     * Set order bit in the frame control field.
     */
    void SetOrder();
    /**
     * Unset order bit in the frame control field.
     */
    void SetNoOrder();
 
    /**
     * Return the address in the Address 1 field.
     *
     * \return the address in the Address 1 field
     */
    Mac48Address GetAddr1() const;
    /**
     * Return the address in the Address 2 field.
     *
     * \return the address in the Address 2 field
     */
    Mac48Address GetAddr2() const;
    /**
     * Return the address in the Address 3 field.
     *
     * \return the address in the Address 3 field
     */
    Mac48Address GetAddr3() const;
    /**
     * Return the address in the Address 4 field.
     *
     * \return the address in the Address 4 field
     */
    Mac48Address GetAddr4() const;
    /**
     * Return the type (WifiMacType)
     *
     * \return the type (WifiMacType)
     */
    virtual WifiMacType GetType() const;
    /**
     * \return true if From DS bit is set, false otherwise
     */
    bool IsFromDs() const;
    /**
     * \return true if To DS bit is set, false otherwise
     */
    bool IsToDs() const;
    /**
     * Return true if the Type is DATA.  The method does
     * not check the Subtype field. (e.g. the header may be
     * Data with QoS)
     *
     * \return true if Type is DATA, false otherwise
     */
    bool IsData() const;
    /**
     * Return true if the Type is DATA and Subtype is one of the
     * possible values for QoS Data.
     *
     * \return true if Type is QoS DATA, false otherwise
     */
    bool IsQosData() const;
    /**
     * Return true if the header type is DATA and is not DATA_NULL.
     *
     * \return true if the header type is DATA and is not DATA_NULL,
     *         false otherwise
     */
    bool HasData() const;
    /**
     * Return true if the Type is Control.
     *
     * \return true if Type is Control, false otherwise
     */
    bool IsCtl() const;
    /**
     * Return true if the Type is Management.
     *
     * \return true if Type is Management, false otherwise
     */
    bool IsMgt() const;
    /**
     * Return true if the Type/Subtype is one of the possible CF-Poll headers.
     *
     * \return true if the Type/Subtype is one of the possible CF-Poll headers, false otherwise
     */
    bool IsCfPoll() const;
    /**
     * Return true if the header is a CF-Ack header.
     *
     * \return true if the header is a CF-Ack header, false otherwise
     */
    bool IsCfAck() const;
    /**
     * Return true if the header is a CF-End header.
     *
     * \return true if the header is a CF-End header, false otherwise
     */
    bool IsCfEnd() const;
    /**
     * Return true if the header is a PS-POLL header.
     *
     * \return true if the header is a PS-POLL header, false otherwise
     */
    bool IsPsPoll() const;
    /**
     * Return true if the header is a RTS header.
     *
     * \return true if the header is a RTS header, false otherwise
     */
    bool IsRts() const;
    /**
     * Return true if the header is a CTS header.
     *
     * \return true if the header is a CTS header, false otherwise
     */
    bool IsCts() const;
    /**
     * Return true if the header is an Ack header.
     *
     * \return true if the header is an Ack header, false otherwise
     */
    bool IsAck() const;
    /**
     * Return true if the header is a BlockAckRequest header.
     *
     * \return true if the header is a BlockAckRequest header, false otherwise
     */
    bool IsBlockAckReq() const;
    /**
     * Return true if the header is a BlockAck header.
     *
     * \return true if the header is a BlockAck header, false otherwise
     */
    bool IsBlockAck() const;
    /**
     * Return true if the header is a Trigger header.
     *
     * \return true if the header is a Trigger header, false otherwise
     */
    bool IsTrigger() const;
    /**
     * Return true if the header is an Association Request header.
     *
     * \return true if the header is an Association Request header, false otherwise
     */
    bool IsAssocReq() const;
    /**
     * Return true if the header is an Association Response header.
     *
     * \return true if the header is an Association Response header, false otherwise
     */
    bool IsAssocResp() const;
    /**
     * Return true if the header is a Reassociation Request header.
     *
     * \return true if the header is a Reassociation Request header, false otherwise
     */
    bool IsReassocReq() const;
    /**
     * Return true if the header is a Reassociation Response header.
     *
     * \return true if the header is a Reassociation Response header, false otherwise
     */
    bool IsReassocResp() const;
    /**
     * Return true if the header is a Probe Request header.
     *
     * \return true if the header is a Probe Request header, false otherwise
     */
    bool IsProbeReq() const;
    /**
     * Return true if the header is a Probe Response header.
     *
     * \return true if the header is a Probe Response header, false otherwise
     */
    bool IsProbeResp() const;
    /**
     * Return true if the header is a Beacon header.
     *
     * \return true if the header is a Beacon header, false otherwise
     */
    bool IsBeacon() const;
    /**
     * Return true if the header is a Disassociation header.
     *
     * \return true if the header is a Disassociation header, false otherwise
     */
    bool IsDisassociation() const;
    /**
     * Return true if the header is an Authentication header.
     *
     * \return true if the header is an Authentication header, false otherwise
     */
    bool IsAuthentication() const;
    /**
     * Return true if the header is a Deauthentication header.
     *
     * \return true if the header is a Deauthentication header, false otherwise
     */
    bool IsDeauthentication() const;
    /**
     * Return true if the header is an Action header.
     *
     * \return true if the header is an Action header, false otherwise
     */
    bool IsAction() const;
    /**
     * Return true if the header is an Action No Ack header.
     *
     * \return true if the header is an Action No Ack header, false otherwise
     */
    bool IsActionNoAck() const;
    /**
     * Check if the header is a Multihop action header.
     *
     * \return true if the header is a Multihop action header,
     *         false otherwise
     */
    bool IsMultihopAction() const;
    /**
     * Return the raw duration from the Duration/ID field.
     *
     * \return the raw duration from the Duration/ID field
     */
    uint16_t GetRawDuration() const;
    /**
     * Return the duration from the Duration/ID field (Time object).
     *
     * \return the duration from the Duration/ID field (Time object)
     */
    Time GetDuration() const;
    /**
     * Return the raw Sequence Control field.
     *
     * \return the raw Sequence Control field
     */
    uint16_t GetSequenceControl() const;
    /**
     * Return the sequence number of the header.
     *
     * \return the sequence number of the header
     */
    uint16_t GetSequenceNumber() const;
    /**
     * Return the fragment number of the header.
     *
     * \return the fragment number of the header
     */
    uint8_t GetFragmentNumber() const;
    /**
     * Return if the Retry bit is set.
     *
     * \return true if the Retry bit is set, false otherwise
     */
    bool IsRetry() const;
    /**
     * Return if the Power Management bit is set.
     *
     * \return true if the Power Management bit is set, false otherwise
     */
    bool IsPowerManagement() const;
    /**
     * Return if the More Data bit is set.
     *
     * \return true if the More Data bit is set, false otherwise
     */
    bool IsMoreData() const;
    /**
     * Return if the More Fragment bit is set.
     *
     * \return true if the More Fragment bit is set, false otherwise
     */
    bool IsMoreFragments() const;
    /**
     * Return if the QoS Ack policy is Block Ack.
     *
     * \return true if the QoS Ack policy is Block Ack, false otherwise
     */
    bool IsQosBlockAck() const;
    /**
     * Return if the QoS Ack policy is No Ack.
     *
     * \return true if the QoS Ack policy is No Ack, false otherwise
     */
    bool IsQosNoAck() const;
    /**
     * Return if the QoS Ack policy is Normal Ack.
     *
     * \return true if the QoS Ack policy is No Ack, false otherwise
     */
    bool IsQosAck() const;
    /**
     * Return if the end of service period (EOSP) is set.
     *
     * \return true if the end of service period (EOSP) is set, false otherwise
     */
    bool IsQosEosp() const;
    /**
     * Check if the A-MSDU present bit is set in the QoS control field.
     *
     * \return true if the A-MSDU present bit is set,
     *         false otherwise
     */
    bool IsQosAmsdu() const;
    /**
     * Return the Traffic ID of a QoS header.
     *
     * \return the Traffic ID of a QoS header
     */
    uint8_t GetQosTid() const;
    /**
     * Return the QoS Ack policy in the QoS control field.
     *
     * \return the QoS Ack policy in the QoS control field
     */
    QosAckPolicy GetQosAckPolicy() const;
    /**
     * Get the Queue Size subfield in the QoS control field.
     *
     * \return the value of the Queue Size subfield
     */
    uint8_t GetQosQueueSize() const;
    /**
     * Return the size of the WifiMacHeader in octets.
     * GetSerializedSize calls this function.
     *
     * \return the size of the WifiMacHeader in octets
     */
    virtual uint32_t GetSize() const;
    /**
     * Return a string corresponds to the header type.
     *
     * \returns a string corresponds to the header type.
     */
    virtual const char* GetTypeString() const;
 
    /**
     * TracedCallback signature for WifiMacHeader
     *
     * \param [in] header The header
     */
    typedef void (*TracedCallback)(const WifiMacHeader& header);
 
  protected:
    /**
     * Return the raw Frame Control field.
     *
     * \return the raw Frame Control field
     */
    virtual uint16_t GetFrameControl() const;
    /**
     * Return the raw QoS Control field.
     *
     * \return the raw QoS Control field
     */
    virtual uint16_t GetQosControl() const;
    /**
     * Set the Frame Control field with the given raw value.
     *
     * \param control the raw Frame Control field value
     */
    virtual void SetFrameControl(uint16_t control);
    /**
     * Set the Sequence Control field with the given raw value.
     *
     * \param seq the raw Sequence Control field value
     */
    void SetSequenceControl(uint16_t seq);
    /**
     * Set the QoS Control field with the given raw value.
     *
     * \param qos the raw QoS Control field value
     */
    virtual void SetQosControl(uint16_t qos);
    /**
     * Print the Frame Control field to the output stream.
     *
     * \param os the output stream to print to
     */
    void PrintFrameControl(std::ostream& os) const;
 
    uint8_t m_ctrlType{0};            ///< control type
    uint8_t m_ctrlSubtype{0};         ///< control subtype
    uint8_t m_ctrlToDs{0};            ///< control to DS
    uint8_t m_ctrlFromDs{0};          ///< control from DS
    uint8_t m_ctrlMoreFrag{0};        ///< control more fragments
    uint8_t m_ctrlRetry{0};           ///< control retry
    uint8_t m_ctrlPowerManagement{0}; ///< control power management
    uint8_t m_ctrlMoreData{0};        ///< control more data
    uint8_t m_ctrlWep{0};             ///< control WEP
    uint8_t m_ctrlOrder{0}; ///< control order (set to 1 for QoS Data and Management frames to
                            ///< signify that HT/VHT/HE control field is present, knowing that the
                            ///< latter are not implemented yet)
    uint16_t m_duration{0}; ///< duration
    Mac48Address m_addr1{}; ///< address 1
    Mac48Address m_addr2{}; ///< address 2
    Mac48Address m_addr3{}; ///< address 3
    uint8_t m_seqFrag{0};   ///< sequence fragment
    uint16_t m_seqSeq{0};   ///< sequence sequence
    Mac48Address m_addr4{}; ///< address 4
    uint8_t m_qosTid{0};    ///< QoS TID
    uint8_t m_qosEosp{0};   ///< QoS EOSP
    uint8_t m_qosAckPolicy{0}; ///< QoS Ack policy
    uint8_t m_amsduPresent{0}; ///< A-MSDU present
    uint8_t m_qosStuff{0};     ///< QoS stuff
};
 
} // namespace ns3
 
#endif /* WIFI_MAC_HEADER_H */