wifi-types.h

Go to the documentation of this file.

/*
 * Copyright (c) 2023 DERONNE SOFTWARE ENGINEERING
 *
 * SPDX-License-Identifier: GPL-2.0-only
 *
 * Author: Sébastien Deronne <sebastien.deronne@gmail.com>
 */
 
#ifndef WIFI_TYPES_H
#define WIFI_TYPES_H
 
#include "wifi-phy-band.h"
#include "wifi-standards.h"
#include "wifi-units.h"
 
#include "ns3/fatal-error.h"
 
#include <compare>
#include <list>
#include <map>
#include <ostream>
#include <tuple>
#include <vector>
 
namespace ns3
{
 
/**
 * @ingroup wifi
 * Enumeration of the possible channel widths
 */
enum class WifiChannelWidthType : uint8_t
{
    UNKNOWN = 0,
    CW_20MHZ,
    CW_22MHZ,
    CW_5MHZ,
    CW_10MHZ,
    CW_40MHZ,
    CW_80MHZ,
    CW_160MHZ,
    CW_80_PLUS_80MHZ,
    CW_320MHZ,
    CW_2160MHZ,
    MAX,
};
 
/**
 * @ingroup wifi
 * The type of an MPDU.
 */
enum MpduType
{
    /** The MPDU is not part of an A-MPDU */
    NORMAL_MPDU,
    /** The MPDU is a single MPDU */
    SINGLE_MPDU,
    /** The MPDU is the first aggregate in an A-MPDU with multiple MPDUs, but is not the last
     * aggregate */
    FIRST_MPDU_IN_AGGREGATE,
    /** The MPDU is part of an A-MPDU with multiple MPDUs, but is neither the first nor the last
     * aggregate */
    MIDDLE_MPDU_IN_AGGREGATE,
    /** The MPDU is the last aggregate in an A-MPDU with multiple MPDUs */
    LAST_MPDU_IN_AGGREGATE
};
 
/// SignalNoiseDbm structure
struct SignalNoiseDbm
{
    dBm_u signal; ///< signal strength
    dBm_u noise;  ///< noise power
};
 
/// MpduInfo structure
struct MpduInfo
{
    MpduType type;          ///< type of MPDU
    uint32_t mpduRefNumber; ///< MPDU ref number
};
 
/// RxSignalInfo structure containing info on the received signal
struct RxSignalInfo
{
    double snr; ///< SNR in linear scale
    dBm_u rssi; ///< RSSI
};
 
/**
 * Struct defining the configuration of a wifi channel, which can be made of one or multiple
 * channel segments.
 */
struct WifiChannelConfig
{
    /// a channel segment, as a struct without units for channel width (to be deprecated when using
    /// strong types)
    struct SegmentWithoutUnits
    {
        uint8_t number{};                            ///< channel number
        double width{};                              ///< channel width in MHz
        WifiPhyBand band{WIFI_PHY_BAND_UNSPECIFIED}; ///< PHY band
        uint8_t p20Index{};                          ///< primary20 index
 
        /**
         * Constructor.
         *
         * @param n the channel number
         * @param w the channel width
         * @param b the PHY band
         * @param i the primary20 index
         */
        SegmentWithoutUnits(uint8_t n, double w, WifiPhyBand b, uint8_t i)
            : number(n),
              width(w),
              band(b),
              p20Index(i)
        {
        }
    };
 
    /// a channel segment, as a struct with units for channel width
    struct Segment
    {
        uint8_t number{};                            ///< channel number
        MHz_u width{};                               ///< channel width
        WifiPhyBand band{WIFI_PHY_BAND_UNSPECIFIED}; ///< PHY band
        uint8_t p20Index{};                          ///< primary20 index
 
        /**
         * Constructor.
         *
         * @param n the channel number
         * @param w the channel width
         * @param b the PHY band
         * @param i the primary20 index
         */
        Segment(uint8_t n, MHz_u w, WifiPhyBand b, uint8_t i)
            : number(n),
              width(w),
              band(b),
              p20Index(i)
        {
        }
 
        /**
         * Converting constructor (to be deprecated when using strong types)
         *
         * @param s a channel segment as a struct without units for channel width
         */
        Segment(const SegmentWithoutUnits& s)
            : number(s.number),
              width(MHz_u{s.width}),
              band(s.band),
              p20Index(s.p20Index)
        {
        }
 
        /**
         * Three-way comparison operator
         *
         * @param rhs right hand side
         * @return deduced comparison type
         */
        auto operator<=>(const Segment& rhs) const = default;
    };
 
    std::vector<Segment> segments; ///< channel config
 
    WifiChannelConfig() = default;
 
    /**
     * Construct a channel config from a channel segment
     *
     * @param segment the channel segment
     */
    WifiChannelConfig(const Segment& segment)
        : segments(std::vector<Segment>{segment})
    {
    }
 
    /**
     * Construct a channel config from a segment without units for channel width
     *
     * @param s the segment without units for channel width
     */
    WifiChannelConfig(const SegmentWithoutUnits& s)
        : WifiChannelConfig(Segment(s))
    {
    }
 
    /// a channel segment, as a tuple without units for channel width (to be deprecated when using
    /// strong types)
    using TupleWithoutUnits = std::tuple<uint64_t /* channel number */,
                                         uint64_t /* channel width in MHz */,
                                         WifiPhyBand /* PHY band */,
                                         uint64_t /* primary20 index*/>;
 
    /**
     * Construct a channel config from a list of tuples without units for channel width
     *
     * @param tuples the list of tuples without units for channel width
     */
    WifiChannelConfig(const std::list<TupleWithoutUnits>& tuples);
 
    /**
     * Get the wifi channel config from a WifiPhy::ChannelSettings string
     *
     * @param settings the WifiPhy::ChannelSettings string
     * @param standard the Wi-Fi standard
     * @return the wifi channel config object
     */
    static WifiChannelConfig FromString(const std::string& settings,
                                        WifiStandard standard = WIFI_STANDARD_UNSPECIFIED);
 
    /// @return a const reference to the first channel segment
    const Segment& front() const
    {
        return segments.front();
    }
 
    /// @return a reference to the first channel segment
    Segment& front()
    {
        return segments.front();
    }
 
    /**
     * Three-way comparison operator
     *
     * @param rhs right hand side
     * @return deduced comparison type
     */
    auto operator<=>(const WifiChannelConfig& rhs) const = default;
};
 
/**
 * The different Resource Unit (RU) types.
 */
enum class RuType : uint8_t
{
    RU_26_TONE = 0,
    RU_52_TONE,
    RU_106_TONE,
    RU_242_TONE,
    RU_484_TONE,
    RU_996_TONE,
    RU_2x996_TONE,
    RU_4x996_TONE,
    RU_TYPE_MAX
};
 
/**
 * @brief Stream insertion operator.
 *
 * @param os the stream
 * @param ruType the RU type
 * @returns a reference to the stream
 */
inline std::ostream&
operator<<(std::ostream& os, const RuType& ruType)
{
    switch (ruType)
    {
    case RuType::RU_26_TONE:
        os << "26-tones";
        break;
    case RuType::RU_52_TONE:
        os << "52-tones";
        break;
    case RuType::RU_106_TONE:
        os << "106-tones";
        break;
    case RuType::RU_242_TONE:
        os << "242-tones";
        break;
    case RuType::RU_484_TONE:
        os << "484-tones";
        break;
    case RuType::RU_996_TONE:
        os << "996-tones";
        break;
    case RuType::RU_2x996_TONE:
        os << "2x996-tones";
        break;
    case RuType::RU_4x996_TONE:
        os << "4x996-tones";
        break;
    default:
        NS_FATAL_ERROR("Unknown RU type");
    }
    return os;
}
 
/// (lowest index, highest index) pair defining a subcarrier range
using SubcarrierRange = std::pair<int16_t, int16_t>;
 
/// a vector of subcarrier ranges defining a subcarrier group
using SubcarrierGroup = std::vector<SubcarrierRange>;
 
/// (bandwidth, number of tones) pair
using BwTonesPair = std::pair<MHz_u, RuType>;
 
/// map (bandwidth, number of tones) pairs to the group of subcarrier ranges
using SubcarrierGroups = std::map<BwTonesPair, std::vector<SubcarrierGroup>>;
 
} // namespace ns3
 
#endif /* WIFI_TYPES_H */