mgt-headers.h

Go to the documentation of this file.

/*
 * Copyright (c) 2006 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
 *
 * Authors: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
 *          Mirko Banchi <mk.banchi@gmail.com>
 */
 
#ifndef MGT_HEADERS_H
#define MGT_HEADERS_H
 
#include "capability-information.h"
#include "edca-parameter-set.h"
#include "extended-capabilities.h"
#include "reduced-neighbor-report.h"
#include "ssid.h"
#include "status-code.h"
#include "supported-rates.h"
#include "wifi-mgt-header.h"
 
#include "ns3/dsss-parameter-set.h"
#include "ns3/eht-capabilities.h"
#include "ns3/eht-operation.h"
#include "ns3/erp-information.h"
#include "ns3/he-capabilities.h"
#include "ns3/he-operation.h"
#include "ns3/ht-capabilities.h"
#include "ns3/ht-operation.h"
#include "ns3/mac48-address.h"
#include "ns3/mu-edca-parameter-set.h"
#include "ns3/multi-link-element.h"
#include "ns3/tid-to-link-mapping-element.h"
#include "ns3/vht-capabilities.h"
#include "ns3/vht-operation.h"
 
namespace ns3
{
 
template <>
struct CanBeInPerStaProfile<ReducedNeighborReport> : std::false_type
{
};
 
template <>
struct CanBeInPerStaProfile<TidToLinkMapping> : std::false_type
{
};
 
template <>
struct CanBeInPerStaProfile<MultiLinkElement> : std::false_type
{
};
 
template <>
struct CanBeInPerStaProfile<Ssid> : std::false_type
{
};
 
using ProbeRequestElems = std::tuple<Ssid,
                                     SupportedRates,
                                     std::optional<ExtendedSupportedRatesIE>,
                                     std::optional<HtCapabilities>,
                                     std::optional<ExtendedCapabilities>,
                                     std::optional<VhtCapabilities>,
                                     std::optional<HeCapabilities>,
                                     std::optional<EhtCapabilities>>;
 
using ProbeResponseElems = std::tuple<Ssid,
                                      SupportedRates,
                                      std::optional<DsssParameterSet>,
                                      std::optional<ErpInformation>,
                                      std::optional<ExtendedSupportedRatesIE>,
                                      std::optional<EdcaParameterSet>,
                                      std::optional<HtCapabilities>,
                                      std::optional<HtOperation>,
                                      std::optional<ExtendedCapabilities>,
                                      std::optional<VhtCapabilities>,
                                      std::optional<VhtOperation>,
                                      std::optional<ReducedNeighborReport>,
                                      std::optional<HeCapabilities>,
                                      std::optional<HeOperation>,
                                      std::optional<MuEdcaParameterSet>,
                                      std::optional<MultiLinkElement>,
                                      std::optional<EhtCapabilities>,
                                      std::optional<EhtOperation>,
                                      std::vector<TidToLinkMapping>>;
 
using AssocRequestElems = std::tuple<Ssid,
                                     SupportedRates,
                                     std::optional<ExtendedSupportedRatesIE>,
                                     std::optional<HtCapabilities>,
                                     std::optional<ExtendedCapabilities>,
                                     std::optional<VhtCapabilities>,
                                     std::optional<HeCapabilities>,
                                     std::optional<MultiLinkElement>,
                                     std::optional<EhtCapabilities>,
                                     std::vector<TidToLinkMapping>>;
 
using AssocResponseElems = std::tuple<SupportedRates,
                                      std::optional<ExtendedSupportedRatesIE>,
                                      std::optional<EdcaParameterSet>,
                                      std::optional<HtCapabilities>,
                                      std::optional<HtOperation>,
                                      std::optional<ExtendedCapabilities>,
                                      std::optional<VhtCapabilities>,
                                      std::optional<VhtOperation>,
                                      std::optional<HeCapabilities>,
                                      std::optional<HeOperation>,
                                      std::optional<MuEdcaParameterSet>,
                                      std::optional<MultiLinkElement>,
                                      std::optional<EhtCapabilities>,
                                      std::optional<EhtOperation>,
                                      std::vector<TidToLinkMapping>>;
 
class MgtAssocRequestHeader
    : public MgtHeaderInPerStaProfile<MgtAssocRequestHeader, AssocRequestElems>
{
    friend class WifiMgtHeader<MgtAssocRequestHeader, AssocRequestElems>;
    friend class MgtHeaderInPerStaProfile<MgtAssocRequestHeader, AssocRequestElems>;
 
  public:
    ~MgtAssocRequestHeader() override = default;
 
    static TypeId GetTypeId();
 
    TypeId GetInstanceTypeId() const override;
 
    void SetListenInterval(uint16_t interval);
    uint16_t GetListenInterval() const;
    CapabilityInformation& Capabilities();
    const CapabilityInformation& Capabilities() const;
 
  protected:
    uint32_t GetSerializedSizeImpl() const;
    void SerializeImpl(Buffer::Iterator start) const;
    uint32_t DeserializeImpl(Buffer::Iterator start);
 
    uint32_t GetSerializedSizeInPerStaProfileImpl(const MgtAssocRequestHeader& frame) const;
 
    void SerializeInPerStaProfileImpl(Buffer::Iterator start,
                                      const MgtAssocRequestHeader& frame) const;
 
    uint32_t DeserializeFromPerStaProfileImpl(Buffer::Iterator start,
                                              uint16_t length,
                                              const MgtAssocRequestHeader& frame);
 
  private:
    CapabilityInformation m_capability; 
    uint16_t m_listenInterval{0};       
};
 
class MgtReassocRequestHeader
    : public MgtHeaderInPerStaProfile<MgtReassocRequestHeader, AssocRequestElems>
{
    friend class WifiMgtHeader<MgtReassocRequestHeader, AssocRequestElems>;
    friend class MgtHeaderInPerStaProfile<MgtReassocRequestHeader, AssocRequestElems>;
 
  public:
    ~MgtReassocRequestHeader() override = default;
 
    static TypeId GetTypeId();
 
    TypeId GetInstanceTypeId() const override;
 
    void SetListenInterval(uint16_t interval);
    uint16_t GetListenInterval() const;
    CapabilityInformation& Capabilities();
    const CapabilityInformation& Capabilities() const;
    void SetCurrentApAddress(Mac48Address currentApAddr);
 
  protected:
    uint32_t GetSerializedSizeImpl() const;
    void SerializeImpl(Buffer::Iterator start) const;
    uint32_t DeserializeImpl(Buffer::Iterator start);
    void PrintImpl(std::ostream& os) const;
 
    uint32_t GetSerializedSizeInPerStaProfileImpl(const MgtReassocRequestHeader& frame) const;
 
    void SerializeInPerStaProfileImpl(Buffer::Iterator start,
                                      const MgtReassocRequestHeader& frame) const;
 
    uint32_t DeserializeFromPerStaProfileImpl(Buffer::Iterator start,
                                              uint16_t length,
                                              const MgtReassocRequestHeader& frame);
 
  private:
    Mac48Address m_currentApAddr;       
    CapabilityInformation m_capability; 
    uint16_t m_listenInterval{0};       
};
 
class MgtAssocResponseHeader
    : public MgtHeaderInPerStaProfile<MgtAssocResponseHeader, AssocResponseElems>
{
    friend class WifiMgtHeader<MgtAssocResponseHeader, AssocResponseElems>;
    friend class MgtHeaderInPerStaProfile<MgtAssocResponseHeader, AssocResponseElems>;
 
  public:
    ~MgtAssocResponseHeader() override = default;
 
    static TypeId GetTypeId();
 
    TypeId GetInstanceTypeId() const override;
 
    StatusCode GetStatusCode();
    void SetStatusCode(StatusCode code);
    CapabilityInformation& Capabilities();
    const CapabilityInformation& Capabilities() const;
    uint16_t GetAssociationId() const;
    void SetAssociationId(uint16_t aid);
 
  protected:
    uint32_t GetSerializedSizeImpl() const;
    void SerializeImpl(Buffer::Iterator start) const;
    uint32_t DeserializeImpl(Buffer::Iterator start);
    void PrintImpl(std::ostream& os) const;
 
    uint32_t GetSerializedSizeInPerStaProfileImpl(const MgtAssocResponseHeader& frame) const;
 
    void SerializeInPerStaProfileImpl(Buffer::Iterator start,
                                      const MgtAssocResponseHeader& frame) const;
 
    uint32_t DeserializeFromPerStaProfileImpl(Buffer::Iterator start,
                                              uint16_t length,
                                              const MgtAssocResponseHeader& frame);
 
  private:
    CapabilityInformation m_capability; 
    StatusCode m_code;                  
    uint16_t m_aid{0};                  
};
 
class MgtProbeRequestHeader : public WifiMgtHeader<MgtProbeRequestHeader, ProbeRequestElems>
{
  public:
    ~MgtProbeRequestHeader() override = default;
 
    static TypeId GetTypeId();
 
    TypeId GetInstanceTypeId() const override;
};
 
class MgtProbeResponseHeader : public WifiMgtHeader<MgtProbeResponseHeader, ProbeResponseElems>
{
    friend class WifiMgtHeader<MgtProbeResponseHeader, ProbeResponseElems>;
 
  public:
    ~MgtProbeResponseHeader() override = default;
 
    static TypeId GetTypeId();
 
    TypeId GetInstanceTypeId() const override;
 
    uint64_t GetBeaconIntervalUs() const;
    void SetBeaconIntervalUs(uint64_t us);
    CapabilityInformation& Capabilities();
    const CapabilityInformation& Capabilities() const;
    uint64_t GetTimestamp() const;
 
  protected:
    uint32_t GetSerializedSizeImpl() const;
    void SerializeImpl(Buffer::Iterator start) const;
    uint32_t DeserializeImpl(Buffer::Iterator start);
 
  private:
    uint64_t m_timestamp;               
    uint64_t m_beaconInterval;          
    CapabilityInformation m_capability; 
};
 
class MgtBeaconHeader : public MgtProbeResponseHeader
{
  public:
    ~MgtBeaconHeader() override = default;
 
    static TypeId GetTypeId();
};
 
} // namespace ns3
 
#endif /* MGT_HEADERS_H */