PHY entity for VHT (11ac) More...

#include "vht-phy.h"

Inheritance diagram for ns3::VhtPhy:

Collaboration diagram for ns3::VhtPhy:

Public Member Functions
	VhtPhy (bool buildModeList=true)
	Constructor for VHT PHY. More...

virtual	~VhtPhy ()
	Destructor for VHT PHY. More...

Ptr< WifiPpdu >	BuildPpdu (const WifiConstPsduMap &psdus, const WifiTxVector &txVector, Time ppduDuration) override
	Build amendment-specific PPDU. More...

Time	GetDuration (WifiPpduField field, const WifiTxVector &txVector) const override
	Get the duration of the PPDU field (or group of fields) used by this entity for the given transmission parameters. More...

Time	GetLSigDuration (WifiPreamble preamble) const override

const PpduFormats &	GetPpduFormats (void) const override
	Return the PPDU formats of the PHY. More...

virtual Time	GetSigADuration (WifiPreamble preamble) const

virtual WifiMode	GetSigAMode (void) const

virtual Time	GetSigBDuration (const WifiTxVector &txVector) const

virtual WifiMode	GetSigBMode (const WifiTxVector &txVector) const

WifiMode	GetSigMode (WifiPpduField field, const WifiTxVector &txVector) const override
	Get the WifiMode for the SIG field specified by the PPDU field. More...

Time	GetTrainingDuration (const WifiTxVector &txVector, uint8_t nDataLtf, uint8_t nExtensionLtf=0) const override

Public Member Functions inherited from ns3::HtPhy
	HtPhy (uint8_t maxNss=1, bool buildModeList=true)
	Constructor for HT PHY. More...

virtual	~HtPhy ()
	Destructor for HT PHY. More...

uint8_t	GetBssMembershipSelector (void) const

uint8_t	GetMaxSupportedMcsIndexPerSs (void) const
	Set the maximum supported MCS index per spatial stream. More...

WifiMode	GetMcs (uint8_t index) const override
	Get the WifiMode corresponding to the given MCS index. More...

Time	GetPayloadDuration (uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, MpduType mpdutype, bool incFlag, uint32_t &totalAmpduSize, double &totalAmpduNumSymbols, uint16_t staId) const override

bool	HandlesMcsModes (void) const override
	Check if the WifiModes handled by this PHY are MCSs. More...

bool	IsMcsSupported (uint8_t index) const override
	Check if the WifiMode corresponding to the given MCS index is supported. More...

void	SetMaxSupportedMcsIndexPerSs (uint8_t maxIndex)
	Set the maximum supported MCS index per spatial stream. More...

void	SetMaxSupportedNss (uint8_t maxNss)
	Configure the maximum number of spatial streams supported by this HT PHY. More...

Public Member Functions inherited from ns3::OfdmPhy
	OfdmPhy (OfdmPhyVariant variant=OFDM_PHY_DEFAULT, bool buildModeList=true)
	Constructor for OFDM PHY. More...

virtual	~OfdmPhy ()
	Destructor for OFDM PHY. More...

Time	GetPayloadDuration (uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, MpduType mpdutype, bool incFlag, uint32_t &totalAmpduSize, double &totalAmpduNumSymbols, uint16_t staId) const override

Public Member Functions inherited from ns3::PhyEntity
virtual	~PhyEntity ()
	Destructor for PHY entity. More...

std::list< WifiMode >::const_iterator	begin (void) const
	Return a const iterator to the first WifiMode. More...

Time	CalculatePhyPreambleAndHeaderDuration (const WifiTxVector &txVector) const

virtual Time	CalculateTxDuration (WifiConstPsduMap psduMap, const WifiTxVector &txVector, WifiPhyBand band) const

virtual void	CancelAllEvents (void)
	Cancel and clear all running events. More...

void	CancelRunningEndPreambleDetectionEvents (bool clear=false)
	Cancel and eventually clear all end preamble detection events. More...

std::list< WifiMode >::const_iterator	end (void) const
	Return a const iterator to past-the-last WifiMode. More...

void	EndReceiveField (WifiPpduField field, Ptr< Event > event)
	End receiving a given field. More...

void	EndReceivePayload (Ptr< Event > event)
	The last symbol of the PPDU has arrived. More...

virtual Ptr< const WifiPsdu >	GetAddressedPsduInPpdu (Ptr< const WifiPpdu > ppdu) const
	Get the PSDU addressed to that PHY in a PPDU (useful for MU PPDU). More...

Time	GetDurationUpToField (WifiPpduField field, const WifiTxVector &txVector) const
	Get the duration of the PPDU up to (but excluding) the given field. More...

virtual uint16_t	GetMeasurementChannelWidth (const Ptr< const WifiPpdu > ppdu) const
	Return the channel width used to measure the RSSI. More...

WifiPpduField	GetNextField (WifiPpduField currentField, WifiPreamble preamble) const
	Return the field following the provided one. More...

virtual uint8_t	GetNumModes (void) const

PhyHeaderSections	GetPhyHeaderSections (const WifiTxVector &txVector, Time ppduStart) const
	Return a map of PHY header chunk information per PPDU field. More...

Time	GetRemainingDurationAfterField (Ptr< const WifiPpdu > ppdu, WifiPpduField field) const
	Get the remaining duration of the PPDU after the end of the given field. More...

virtual uint16_t	GetRxChannelWidth (const WifiTxVector &txVector) const
	Return the channel width used in the reception spectrum model. More...

virtual uint16_t	GetStaId (const Ptr< const WifiPpdu > ppdu) const
	Return the STA ID that has been assigned to the station this PHY belongs to. More...

virtual WifiConstPsduMap	GetWifiConstPsduMap (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) const
	Get a WifiConstPsduMap from a PSDU and the TXVECTOR to use to send the PSDU. More...

virtual bool	IsModeSupported (WifiMode mode) const
	Check if the WifiMode is supported. More...

bool	NoEndPreambleDetectionEvents (void) const

void	ResetReceive (Ptr< Event > event)
	Reset PHY at the end of the PPDU under reception after it has failed the PHY header. More...

void	SetOwner (Ptr< WifiPhy > wifiPhy)
	Set the WifiPhy owning this PHY entity. More...

void	StartReceiveField (WifiPpduField field, Ptr< Event > event)
	Start receiving a given field. More...

virtual void	StartReceivePreamble (Ptr< WifiPpdu > ppdu, RxPowerWattPerChannelBand &rxPowersW, Time rxDuration)
	Start receiving the PHY preamble of a PPDU (i.e. More...

virtual void	StartTx (Ptr< WifiPpdu > ppdu)
	This function is called by SpectrumWifiPhy to send the PPDU while performing amendment-specific actions. More...

void	Transmit (Time txDuration, Ptr< WifiPpdu > ppdu, std::string type)
	This function prepares most of the WifiSpectrumSignalParameters parameters and invokes SpectrumWifiPhy's Transmit method. More...

Public Member Functions inherited from ns3::SimpleRefCount< PhyEntity >
	SimpleRefCount ()
	Default constructor. More...

	SimpleRefCount (const SimpleRefCount &o[[maybe_unused]])
	Copy constructor. More...

uint32_t	GetReferenceCount (void) const
	Get the reference count of the object. More...

SimpleRefCount &	operator= ([[maybe_unused]] const SimpleRefCount &o)
	Assignment operator. More...

void	Ref (void) const
	Increment the reference count. More...

void	Unref (void) const
	Decrement the reference count. More...

Static Public Member Functions
static WifiCodeRate	GetCodeRate (uint8_t mcsValue)
	Return the coding rate corresponding to the supplied VHT MCS index. More...

static uint16_t	GetConstellationSize (uint8_t mcsValue)
	Return the constellation size corresponding to the supplied VHT MCS index. More...

static uint64_t	GetDataRate (uint8_t mcsValue, uint16_t channelWidth, uint16_t guardInterval, uint8_t nss)
	Return the data rate corresponding to the supplied VHT MCS index, channel width, guard interval, and number of spatial streams. More...

static uint64_t	GetDataRateFromTxVector (const WifiTxVector &txVector, uint16_t staId)
	Return the data rate corresponding to the supplied TXVECTOR. More...

static uint64_t	GetNonHtReferenceRate (uint8_t mcsValue)
	Calculate the rate in bps of the non-HT Reference Rate corresponding to the supplied VHT MCS index. More...

static uint64_t	GetPhyRate (uint8_t mcsValue, uint16_t channelWidth, uint16_t guardInterval, uint8_t nss)
	Return the PHY rate corresponding to the supplied VHT MCS index, channel width, guard interval, and number of spatial stream. More...

static uint64_t	GetPhyRateFromTxVector (const WifiTxVector &txVector, uint16_t staId)
	Return the PHY rate corresponding to the supplied TXVECTOR. More...

static WifiMode	GetVhtMcs (uint8_t index)
	Return the VHT MCS corresponding to the provided index. More...

static WifiMode	GetVhtMcs0 (void)
	Return MCS 0 from VHT MCS values. More...

static WifiMode	GetVhtMcs1 (void)
	Return MCS 1 from VHT MCS values. More...

static WifiMode	GetVhtMcs2 (void)
	Return MCS 2 from VHT MCS values. More...

static WifiMode	GetVhtMcs3 (void)
	Return MCS 3 from VHT MCS values. More...

static WifiMode	GetVhtMcs4 (void)
	Return MCS 4 from VHT MCS values. More...

static WifiMode	GetVhtMcs5 (void)
	Return MCS 5 from VHT MCS values. More...

static WifiMode	GetVhtMcs6 (void)
	Return MCS 6 from VHT MCS values. More...

static WifiMode	GetVhtMcs7 (void)
	Return MCS 7 from VHT MCS values. More...

static WifiMode	GetVhtMcs8 (void)
	Return MCS 8 from VHT MCS values. More...

static WifiMode	GetVhtMcs9 (void)
	Return MCS 9 from VHT MCS values. More...

static void	InitializeModes (void)
	Initialize all VHT modes. More...

static bool	IsAllowed (const WifiTxVector &txVector)
	Check whether the combination in TXVECTOR is allowed. More...

static bool	IsCombinationAllowed (uint8_t mcsValue, uint16_t channelWidth, uint8_t nss)
	Check whether the combination of <MCS, channel width, NSS> is allowed. More...

Static Public Member Functions inherited from ns3::HtPhy
static WifiCodeRate	GetCodeRate (uint8_t mcsValue)
	Return the coding rate corresponding to the supplied HT MCS index between 0 and 7, since HT MCS index > 8 is used for higher NSS. More...

static uint16_t	GetConstellationSize (uint8_t mcsValue)
	Return the constellation size corresponding to the supplied HT MCS index between 0 and 7, since HT MCS index > 8 is used for higher NSS. More...

static uint64_t	GetDataRate (uint8_t mcsValue, uint16_t channelWidth, uint16_t guardInterval, uint8_t nss)
	Return the data rate corresponding to the supplied HT MCS index, channel width, guard interval, and number of spatial streams. More...

static uint64_t	GetDataRateFromTxVector (const WifiTxVector &txVector, uint16_t staId)
	Return the data rate corresponding to the supplied TXVECTOR. More...

static WifiCodeRate	GetHtCodeRate (uint8_t mcsValue)
	Return the coding rate corresponding to the supplied HT MCS index. More...

static uint16_t	GetHtConstellationSize (uint8_t mcsValue)
	Return the constellation size corresponding to the supplied HT MCS index. More...

static WifiMode	GetHtMcs (uint8_t index)
	Return the HT MCS corresponding to the provided index. More...

static WifiMode	GetHtMcs0 (void)
	Return MCS 0 from HT MCS values. More...

static WifiMode	GetHtMcs1 (void)
	Return MCS 1 from HT MCS values. More...

static WifiMode	GetHtMcs10 (void)
	Return MCS 10 from HT MCS values. More...

static WifiMode	GetHtMcs11 (void)
	Return MCS 11 from HT MCS values. More...

static WifiMode	GetHtMcs12 (void)
	Return MCS 12 from HT MCS values. More...

static WifiMode	GetHtMcs13 (void)
	Return MCS 13 from HT MCS values. More...

static WifiMode	GetHtMcs14 (void)
	Return MCS 14 from HT MCS values. More...

static WifiMode	GetHtMcs15 (void)
	Return MCS 15 from HT MCS values. More...

static WifiMode	GetHtMcs16 (void)
	Return MCS 16 from HT MCS values. More...

static WifiMode	GetHtMcs17 (void)
	Return MCS 17 from HT MCS values. More...

static WifiMode	GetHtMcs18 (void)
	Return MCS 18 from HT MCS values. More...

static WifiMode	GetHtMcs19 (void)
	Return MCS 19 from HT MCS values. More...

static WifiMode	GetHtMcs2 (void)
	Return MCS 2 from HT MCS values. More...

static WifiMode	GetHtMcs20 (void)
	Return MCS 20 from HT MCS values. More...

static WifiMode	GetHtMcs21 (void)
	Return MCS 21 from HT MCS values. More...

static WifiMode	GetHtMcs22 (void)
	Return MCS 22 from HT MCS values. More...

static WifiMode	GetHtMcs23 (void)
	Return MCS 23 from HT MCS values. More...

static WifiMode	GetHtMcs24 (void)
	Return MCS 24 from HT MCS values. More...

static WifiMode	GetHtMcs25 (void)
	Return MCS 25 from HT MCS values. More...

static WifiMode	GetHtMcs26 (void)
	Return MCS 26 from HT MCS values. More...

static WifiMode	GetHtMcs27 (void)
	Return MCS 27 from HT MCS values. More...

static WifiMode	GetHtMcs28 (void)
	Return MCS 28 from HT MCS values. More...

static WifiMode	GetHtMcs29 (void)
	Return MCS 29 from HT MCS values. More...

static WifiMode	GetHtMcs3 (void)
	Return MCS 3 from HT MCS values. More...

static WifiMode	GetHtMcs30 (void)
	Return MCS 30 from HT MCS values. More...

static WifiMode	GetHtMcs31 (void)
	Return MCS 31 from HT MCS values. More...

static WifiMode	GetHtMcs4 (void)
	Return MCS 4 from HT MCS values. More...

static WifiMode	GetHtMcs5 (void)
	Return MCS 5 from HT MCS values. More...

static WifiMode	GetHtMcs6 (void)
	Return MCS 6 from HT MCS values. More...

static WifiMode	GetHtMcs7 (void)
	Return MCS 7 from HT MCS values. More...

static WifiMode	GetHtMcs8 (void)
	Return MCS 8 from HT MCS values. More...

static WifiMode	GetHtMcs9 (void)
	Return MCS 9 from HT MCS values. More...

static WifiMode	GetLSigMode (void)

static uint64_t	GetNonHtReferenceRate (uint8_t mcsValue)
	Calculate the rate in bps of the non-HT Reference Rate corresponding to the supplied HT MCS index. More...

static uint64_t	GetPhyRate (uint8_t mcsValue, uint16_t channelWidth, uint16_t guardInterval, uint8_t nss)
	Return the PHY rate corresponding to the supplied HT MCS index, channel width, guard interval, and number of spatial stream. More...

static uint64_t	GetPhyRateFromTxVector (const WifiTxVector &txVector, uint16_t staId)
	Return the PHY rate corresponding to the supplied TXVECTOR. More...

static void	InitializeModes (void)
	Initialize all HT modes. More...

static bool	IsAllowed (const WifiTxVector &txVector)
	Check whether the combination in TXVECTOR is allowed. More...

Static Public Member Functions inherited from ns3::OfdmPhy
static WifiCodeRate	GetCodeRate (const std::string &name)
	Return the WifiCodeRate from the OFDM mode's unique name using ModulationLookupTable. More...

static uint16_t	GetConstellationSize (const std::string &name)
	Return the constellation size from the OFDM mode's unique name using ModulationLookupTable. More...

static uint64_t	GetDataRate (const std::string &name, uint16_t channelWidth)
	Return the data rate from the OFDM mode's unique name and the supplied parameters. More...

static uint64_t	GetDataRateFromTxVector (const WifiTxVector &txVector, uint16_t staId)
	Return the data rate corresponding to the supplied TXVECTOR. More...

static WifiMode	GetOfdmRate (uint64_t rate, uint16_t bw=20)
	Return a WifiMode for OFDM corresponding to the provided rate and the channel bandwidth (20, 10, or 5 MHz). More...

static WifiMode	GetOfdmRate12Mbps (void)
	Return a WifiMode for OFDM at 12Mbps. More...

static WifiMode	GetOfdmRate12MbpsBW10MHz (void)
	Return a WifiMode for OFDM at 12 Mbps with 10 MHz channel spacing. More...

static WifiMode	GetOfdmRate12MbpsBW5MHz (void)
	Return a WifiMode for OFDM at 12 Mbps with 5 MHz channel spacing. More...

static WifiMode	GetOfdmRate13_5MbpsBW5MHz (void)
	Return a WifiMode for OFDM at 13.5 Mbps with 5 MHz channel spacing. More...

static WifiMode	GetOfdmRate18Mbps (void)
	Return a WifiMode for OFDM at 18 Mbps. More...

static WifiMode	GetOfdmRate18MbpsBW10MHz (void)
	Return a WifiMode for OFDM at 18 Mbps with 10 MHz channel spacing. More...

static WifiMode	GetOfdmRate1_5MbpsBW5MHz (void)
	Return a WifiMode for OFDM at 1.5 Mbps with 5 MHz channel spacing. More...

static WifiMode	GetOfdmRate24Mbps (void)
	Return a WifiMode for OFDM at 24 Mbps. More...

static WifiMode	GetOfdmRate24MbpsBW10MHz (void)
	Return a WifiMode for OFDM at 24 Mbps with 10 MHz channel spacing. More...

static WifiMode	GetOfdmRate27MbpsBW10MHz (void)
	Return a WifiMode for OFDM at 27 Mbps with 10 MHz channel spacing. More...

static WifiMode	GetOfdmRate2_25MbpsBW5MHz (void)
	Return a WifiMode for OFDM at 2.25 Mbps with 5 MHz channel spacing. More...

static WifiMode	GetOfdmRate36Mbps (void)
	Return a WifiMode for OFDM at 36 Mbps. More...

static WifiMode	GetOfdmRate3MbpsBW10MHz (void)
	Return a WifiMode for OFDM at 3 Mbps with 10 MHz channel spacing. More...

static WifiMode	GetOfdmRate3MbpsBW5MHz (void)
	Return a WifiMode for OFDM at 3 Mbps with 5 MHz channel spacing. More...

static WifiMode	GetOfdmRate48Mbps (void)
	Return a WifiMode for OFDM at 48 Mbps. More...

static WifiMode	GetOfdmRate4_5MbpsBW10MHz (void)
	Return a WifiMode for OFDM at 4.5 Mbps with 10 MHz channel spacing. More...

static WifiMode	GetOfdmRate4_5MbpsBW5MHz (void)
	Return a WifiMode for OFDM at 4.5 Mbps with 5 MHz channel spacing. More...

static WifiMode	GetOfdmRate54Mbps (void)
	Return a WifiMode for OFDM at 54 Mbps. More...

static WifiMode	GetOfdmRate6Mbps (void)
	Return a WifiMode for OFDM at 6 Mbps. More...

static WifiMode	GetOfdmRate6MbpsBW10MHz (void)
	Return a WifiMode for OFDM at 6 Mbps with 10 MHz channel spacing. More...

static WifiMode	GetOfdmRate6MbpsBW5MHz (void)
	Return a WifiMode for OFDM at 6 Mbps with 5 MHz channel spacing. More...

static WifiMode	GetOfdmRate9Mbps (void)
	Return a WifiMode for OFDM at 9 Mbps. More...

static WifiMode	GetOfdmRate9MbpsBW10MHz (void)
	Return a WifiMode for OFDM at 9 Mbps with 10 MHz channel spacing. More...

static WifiMode	GetOfdmRate9MbpsBW5MHz (void)
	Return a WifiMode for OFDM at 9 Mbps with 5 MHz channel spacing. More...

static uint64_t	GetPhyRate (const std::string &name, uint16_t channelWidth)
	Return the PHY rate from the OFDM mode's unique name and the supplied parameters. More...

static uint64_t	GetPhyRateFromTxVector (const WifiTxVector &txVector, uint16_t staId)
	Return the PHY rate corresponding to the supplied TXVECTOR. More...

static void	InitializeModes (void)
	Initialize all OFDM modes (for all variants). More...

static bool	IsAllowed (const WifiTxVector &txVector)
	Check whether the combination in TXVECTOR is allowed. More...

Protected Member Functions
PhyFieldRxStatus	DoEndReceiveField (WifiPpduField field, Ptr< Event > event) override
	End receiving a given field, perform amendment-specific actions, and provide the status of the reception. More...

PhyFieldRxStatus	EndReceiveSigA (Ptr< Event > event)
	End receiving the SIG-A, perform VHT-specific actions, and provide the status of the reception. More...

PhyFieldRxStatus	EndReceiveSigB (Ptr< Event > event)
	End receiving the SIG-B, perform VHT-specific actions, and provide the status of the reception. More...

Time	GetHtSigDuration (void) const override

WifiMode	GetHtSigMode (void) const override

uint32_t	GetMaxPsduSize (void) const override
	Get the maximum PSDU size in bytes. More...

uint8_t	GetNumberBccEncoders (const WifiTxVector &txVector) const override

bool	IsAllConfigSupported (WifiPpduField field, Ptr< const WifiPpdu > ppdu) const override
	Checks if the signaled configuration (including bandwidth) is supported by the PHY. More...

virtual PhyFieldRxStatus	ProcessSigA (Ptr< Event > event, PhyFieldRxStatus status)
	Process SIG-A, perform amendment-specific actions, and provide an updated status of the reception. More...

virtual PhyFieldRxStatus	ProcessSigB (Ptr< Event > event, PhyFieldRxStatus status)
	Process SIG-B, perform amendment-specific actions, and provide an updated status of the reception. More...

Protected Member Functions inherited from ns3::HtPhy
virtual Time	GetSymbolDuration (const WifiTxVector &txVector) const

Ptr< SpectrumValue >	GetTxPowerSpectralDensity (double txPowerW, Ptr< const WifiPpdu > ppdu) const override

bool	IsConfigSupported (Ptr< const WifiPpdu > ppdu) const override
	Checks if the signaled configuration (excluding bandwidth) is supported by the PHY. More...

Protected Member Functions inherited from ns3::OfdmPhy
PhyFieldRxStatus	EndReceiveHeader (Ptr< Event > event)
	End receiving the header, perform OFDM-specific actions, and provide the status of the reception. More...

virtual Time	GetHeaderDuration (const WifiTxVector &txVector) const

virtual WifiMode	GetHeaderMode (const WifiTxVector &txVector) const

uint8_t	GetNumberServiceBits (void) const

virtual Time	GetPreambleDuration (const WifiTxVector &txVector) const

Time	GetSignalExtension (WifiPhyBand band) const

Ptr< SpectrumValue >	GetTxPowerSpectralDensity (double txPowerW, Ptr< const WifiPpdu > ppdu) const override

virtual bool	IsChannelWidthSupported (Ptr< const WifiPpdu > ppdu) const
	Checks if the PPDU's bandwidth is supported by the PHY. More...

Protected Member Functions inherited from ns3::PhyEntity
void	AbortCurrentReception (WifiPhyRxfailureReason reason)
	Abort the current reception. More...

void	AddPreambleEvent (Ptr< Event > event)
	Add an entry to the map of current preamble events (stored in WifiPhy). More...

Ptr< Event >	CreateInterferenceEvent (Ptr< const WifiPpdu > ppdu, const WifiTxVector &txVector, Time duration, RxPowerWattPerChannelBand &rxPower, bool isStartOfdmaRxing=false)
	Create an event using WifiPhy's InterferenceHelper class. More...

virtual void	DoAbortCurrentReception (WifiPhyRxfailureReason reason)
	Perform amendment-specific actions before aborting the current reception. More...

virtual void	DoEndReceivePayload (Ptr< const WifiPpdu > ppdu)
	Perform amendment-specific actions at the end of the reception of the payload. More...

virtual PhyFieldRxStatus	DoEndReceivePreamble (Ptr< Event > event)
	End receiving the preamble, perform amendment-specific actions, and provide the status of the reception. More...

virtual Ptr< Event >	DoGetEvent (Ptr< const WifiPpdu > ppdu, RxPowerWattPerChannelBand &rxPowersW)
	Get the event corresponding to the incoming PPDU. More...

virtual void	DoResetReceive (Ptr< Event > event)
	Perform amendment-specific actions before resetting PHY at the end of the PPDU under reception after it has failed the PHY header. More...

virtual bool	DoStartReceiveField (WifiPpduField field, Ptr< Event > event)
	Start receiving a given field, perform amendment-specific actions, and signify if it is supported. More...

virtual void	DoStartReceivePayload (Ptr< Event > event)
	Start receiving the PSDU (i.e. More...

void	DropPreambleEvent (Ptr< const WifiPpdu > ppdu, WifiPhyRxfailureReason reason, Time endRx, uint16_t measurementChannelWidth)
	Drop the PPDU and the corresponding preamble detection event, but keep CCA busy state after the completion of the currently processed event. More...

void	EndOfMpdu (Ptr< Event > event, Ptr< const WifiPsdu > psdu, size_t mpduIndex, Time relativeStart, Time mpduDuration)
	The last symbol of an MPDU in an A-MPDU has arrived. More...

void	EndPreambleDetectionPeriod (Ptr< Event > event)
	End the preamble detection period. More...

void	ErasePreambleEvent (Ptr< const WifiPpdu > ppdu, Time rxDuration)
	Erase the event corresponding to the PPDU from the list of preamble events, but consider it as noise after the completion of the current event. More...

uint16_t	GetCenterFrequencyForChannelWidth (const WifiTxVector &txVector) const
	Get the center frequency of the channel corresponding the current TxVector rather than that of the supported channel width. More...

virtual std::pair< uint16_t, WifiSpectrumBand >	GetChannelWidthAndBand (const WifiTxVector &txVector, uint16_t staId) const
	Get the channel width and band to use (will be overloaded by child classes). More...

Ptr< const Event >	GetCurrentEvent (void) const
	Get the pointer to the current event (stored in WifiPhy). More...

const std::map< std::pair< uint64_t, WifiPreamble >, Ptr< Event > > &	GetCurrentPreambleEvents (void) const
	Get the map of current preamble events (stored in WifiPhy). More...

uint16_t	GetGuardBandwidth (uint16_t currentChannelWidth) const

SnrPer	GetPhyHeaderSnrPer (WifiPpduField field, Ptr< Event > event) const
	Obtain the SNR and PER of the PPDU field from the WifiPhy's InterferenceHelper class. More...

double	GetRandomValue (void) const
	Obtain a random value from the WifiPhy's generator. More...

std::pair< bool, SignalNoiseDbm >	GetReceptionStatus (Ptr< const WifiPsdu > psdu, Ptr< Event > event, uint16_t staId, Time relativeMpduStart, Time mpduDuration)
	Get the reception status for the provided MPDU and notify. More...

double	GetRxPowerWForPpdu (Ptr< Event > event) const
	Obtain the received power (W) for a given band. More...

std::tuple< double, double, double >	GetTxMaskRejectionParams (void) const

void	NotifyInterferenceRxEndAndClear (bool reset)
	Notify WifiPhy's InterferenceHelper of the end of the reception, clear maps and end of MPDU event, and eventually reset WifiPhy. More...

void	NotifyPayloadBegin (const WifiTxVector &txVector, const Time &payloadDuration)
	Fire the trace indicating that the PHY is starting to receive the payload of a PPDU. More...

virtual uint64_t	ObtainNextUid (const WifiTxVector &txVector)
	Obtain the next UID for the PPDU to transmit. More...

void	ScheduleEndOfMpdus (Ptr< Event > event)
	Schedule end of MPDUs events. More...

void	StartPreambleDetectionPeriod (Ptr< Event > event)
	Start the preamble detection period. More...

void	StartReceivePayload (Ptr< Event > event)
	Start receiving the PSDU (i.e. More...

void	UpdateInterferenceEvent (Ptr< Event > event, const RxPowerWattPerChannelBand &rxPower)
	Update an event in WifiPhy's InterferenceHelper class. More...

Static Protected Member Functions
static uint64_t	CalculateNonHtReferenceRate (WifiCodeRate codeRate, uint16_t constellationSize)
	Return the rate (in bps) of the non-HT Reference Rate which corresponds to the supplied code rate and constellation size. More...

static uint16_t	GetUsableSubcarriers (uint16_t channelWidth)

Static Protected Member Functions inherited from ns3::HtPhy
static uint64_t	CalculateDataRate (double symbolDuration, uint16_t guardInterval, uint16_t usableSubCarriers, uint16_t numberOfBitsPerSubcarrier, double codingRate, uint8_t nss)
	Calculates data rate from the supplied parameters. More...

static uint64_t	CalculateNonHtReferenceRate (WifiCodeRate codeRate, uint16_t constellationSize)
	Return the rate (in bps) of the non-HT Reference Rate which corresponds to the supplied code rate and constellation size. More...

static uint64_t	CalculatePhyRate (WifiCodeRate codeRate, uint64_t dataRate)
	Return the PHY rate corresponding to the supplied code rate and data rate. More...

static double	GetCodeRatio (WifiCodeRate codeRate)
	Convert WifiCodeRate to a ratio, e.g., code ratio of WIFI_CODE_RATE_1_2 is 0.5. More...

static uint16_t	GetUsableSubcarriers (uint16_t channelWidth)

Static Protected Member Functions inherited from ns3::OfdmPhy
static uint64_t	CalculateDataRate (double symbolDuration, uint16_t guardInterval, uint16_t usableSubCarriers, uint16_t numberOfBitsPerSubcarrier, double codingRate)
	Calculates data rate from the supplied parameters. More...

static uint64_t	CalculateDataRate (WifiCodeRate codeRate, uint16_t constellationSize, uint16_t channelWidth)
	Calculates data rate from the supplied parameters. More...

static uint64_t	CalculatePhyRate (WifiCodeRate codeRate, uint64_t dataRate)
	Calculate the PHY rate in bps from code rate and data rate. More...

static double	GetCodeRatio (WifiCodeRate codeRate)
	Convert WifiCodeRate to a ratio, e.g., code ratio of WIFI_CODE_RATE_1_2 is 0.5. More...

Private Types
typedef std::map< std::tuple< uint16_t, uint8_t, uint8_t >, uint8_t >	NesExceptionMap
	Typedef for storing exceptions in the number of BCC encoders for VHT MCSs. More...

Private Member Functions
void	BuildModeList (void) override
	Build mode list. More...

Static Private Member Functions
static WifiMode	CreateVhtMcs (uint8_t index)
	Return the VHT MCS corresponding to the provided index. More...

Static Private Attributes
static const NesExceptionMap	m_exceptionsMap
	exception map for number of BCC encoders (extracted from VHT-MCS tables) More...

static const PpduFormats	m_vhtPpduFormats
	VHT PPDU formats. More...

Additional Inherited Members
Public Types inherited from ns3::PhyEntity
typedef std::pair< std::pair< Time, Time >, WifiMode >	PhyHeaderChunkInfo
	A pair containing information on the PHY header chunk, namely the start and stop times of the chunk and the WifiMode used. More...

typedef std::map< WifiPpduField, PhyHeaderChunkInfo >	PhyHeaderSections
	A map of PhyHeaderChunkInfo elements per PPDU field. More...

enum	PhyRxFailureAction { DROP = 0 , ABORT , IGNORE }
	Action to perform in case of RX failure. More...

Protected Types inherited from ns3::PhyEntity
typedef std::pair< WifiCodeRate, uint16_t >	CodeRateConstellationSizePair
	A pair to hold modulation information: code rate and constellation size. More...

typedef std::map< std::string, CodeRateConstellationSizePair >	ModulationLookupTable
	A modulation lookup table using unique name of modulation as key. More...

typedef std::map< WifiPreamble, std::vector< WifiPpduField > >	PpduFormats
	A map of PPDU field elements per preamble type. More...

typedef std::pair< uint64_t, uint16_t >	UidStaIdPair
	A pair of a UID and STA_ID. More...

Protected Attributes inherited from ns3::HtPhy
uint8_t	m_bssMembershipSelector
	the BSS membership selector More...

uint8_t	m_maxMcsIndexPerSs
	the maximum MCS index per spatial stream as defined by the standard More...

uint8_t	m_maxSupportedMcsIndexPerSs
	the maximum supported MCS index per spatial stream More...

Protected Attributes inherited from ns3::PhyEntity
std::vector< EventId >	m_endOfMpduEvents
	the end of MPDU events (only used for A-MPDUs) More...

std::vector< EventId >	m_endPreambleDetectionEvents
	the end of preamble detection events More...

std::vector< EventId >	m_endRxPayloadEvents
	the end of receive events (only one unless UL MU reception) More...

std::list< WifiMode >	m_modeList
	the list of supported modes More...

std::map< UidStaIdPair, SignalNoiseDbm >	m_signalNoiseMap
	Map of the latest signal power and noise power in dBm (noise power includes the noise figure) More...

Ptr< WifiPhyStateHelper >	m_state
	Pointer to WifiPhyStateHelper of the WifiPhy (to make it reachable for child classes) More...

std::map< UidStaIdPair, std::vector< bool > >	m_statusPerMpduMap
	Map of the current reception status per MPDU that is filled in as long as MPDUs are being processed by the PHY in case of an A-MPDU. More...

Ptr< WifiPhy >	m_wifiPhy
	Pointer to the owning WifiPhy. More...

Static Protected Attributes inherited from ns3::PhyEntity
static uint64_t	m_globalPpduUid = 0
	Global counter of the PPDU UID. More...

Detailed Description

PHY entity for VHT (11ac)

VHT PHY is based on HT PHY.

Refer to IEEE 802.11-2016, clause 21.

Definition at line 48 of file vht-phy.h.

Member Typedef Documentation

◆ NesExceptionMap

typedef std::map< std::tuple<uint16_t , uint8_t , uint8_t >, uint8_t > ns3::VhtPhy::NesExceptionMap

private

Typedef for storing exceptions in the number of BCC encoders for VHT MCSs.

Definition at line 354 of file vht-phy.h.

Constructor & Destructor Documentation

◆ VhtPhy()

ns3::VhtPhy::VhtPhy ( bool buildModeList = true )

Constructor for VHT PHY.

Parameters

buildModeList flag used to add VHT modes to list (disabled by child classes to only add child classes' modes)

Definition at line 72 of file vht-phy.cc.

References BuildModeList(), ns3::HtPhy::m_bssMembershipSelector, ns3::HtPhy::m_maxMcsIndexPerSs, ns3::HtPhy::m_maxSupportedMcsIndexPerSs, NS_LOG_FUNCTION, and VHT_PHY.

Here is the call graph for this function:

◆ ~VhtPhy()

ns3::VhtPhy::~VhtPhy ( )

virtual

Destructor for VHT PHY.

Definition at line 85 of file vht-phy.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ BuildModeList()

void ns3::VhtPhy::BuildModeList ( void )

overrideprivatevirtual

Build mode list.

Should be redone whenever the maximum MCS index per spatial stream ,or any other important parameter having an impact on the MCS index (e.g. number of spatial streams for HT), changes.

Reimplemented from ns3::HtPhy.

Definition at line 91 of file vht-phy.cc.

References CreateVhtMcs(), ns3::HtPhy::m_bssMembershipSelector, ns3::HtPhy::m_maxSupportedMcsIndexPerSs, ns3::PhyEntity::m_modeList, NS_ASSERT, NS_LOG_FUNCTION, NS_LOG_LOGIC, and VHT_PHY.

Referenced by VhtPhy().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ BuildPpdu()

Ptr< WifiPpdu > ns3::VhtPhy::BuildPpdu	(	const WifiConstPsduMap &	psdus,
		const WifiTxVector &	txVector,
		Time	ppduDuration
	)

overridevirtual

Build amendment-specific PPDU.

Parameters

psdus	the PHY payloads (PSDUs)
txVector	the TXVECTOR that was used for the PPDU
ppduDuration	the transmission duration of the PPDU

Returns: the amendment-specific WifiPpdu

Reimplemented from ns3::HtPhy.

Definition at line 219 of file vht-phy.cc.

References ns3::WifiPhy::GetPhyBand(), ns3::PhyEntity::m_wifiPhy, NS_LOG_FUNCTION, and ns3::PhyEntity::ObtainNextUid().

Here is the call graph for this function:

◆ CalculateNonHtReferenceRate()

uint64_t ns3::VhtPhy::CalculateNonHtReferenceRate	(	WifiCodeRate	codeRate,
		uint16_t	constellationSize
	)

staticprotected

Return the rate (in bps) of the non-HT Reference Rate which corresponds to the supplied code rate and constellation size.

Parameters

codeRate	the convolutional coding rate
constellationSize	the size of modulation constellation

Returns: the rate in bps.

To convert an VHT MCS to its corresponding non-HT Reference Rate use the modulation and coding rate of the HT MCS and lookup in Table 10-7 of IEEE 802.11-2016.

Definition at line 478 of file vht-phy.cc.

References ns3::HtPhy::CalculateNonHtReferenceRate(), NS_FATAL_ERROR, ns3::WIFI_CODE_RATE_3_4, and ns3::WIFI_CODE_RATE_5_6.

Referenced by ns3::HePhy::CalculateNonHtReferenceRate(), and GetNonHtReferenceRate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CreateVhtMcs()

WifiMode ns3::VhtPhy::CreateVhtMcs ( uint8_t index )

staticprivate

Return the VHT MCS corresponding to the provided index.

This method binds all the callbacks used by WifiMode.

Parameters

index the index of the MCS

Returns: a VHT MCS

Definition at line 375 of file vht-phy.cc.

References ns3::WifiModeFactory::CreateWifiMcs(), GetCodeRate(), GetConstellationSize(), GetDataRateFromTxVector(), GetNonHtReferenceRate(), GetPhyRateFromTxVector(), IsAllowed(), ns3::MakeBoundCallback(), ns3::MakeCallback(), NS_ASSERT_MSG, nlohmann::to_string(), and ns3::WIFI_MOD_CLASS_VHT.

Referenced by BuildModeList().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DoEndReceiveField()

PhyEntity::PhyFieldRxStatus ns3::VhtPhy::DoEndReceiveField	(	WifiPpduField	field,
		Ptr< Event >	event
	)

overrideprotectedvirtual

End receiving a given field, perform amendment-specific actions, and provide the status of the reception.

Parameters

field	the ending PPDU field
event	the event holding incoming PPDU's information

Returns: status of the reception of the PPDU field

Reimplemented from ns3::HtPhy.

Definition at line 227 of file vht-phy.cc.

References ns3::HtPhy::DoEndReceiveField(), EndReceiveSigA(), EndReceiveSigB(), NS_LOG_FUNCTION, ns3::WIFI_PPDU_FIELD_SIG_A, and ns3::WIFI_PPDU_FIELD_SIG_B.

Here is the call graph for this function:

◆ EndReceiveSigA()

PhyEntity::PhyFieldRxStatus ns3::VhtPhy::EndReceiveSigA ( Ptr< Event > event )

protected

End receiving the SIG-A, perform VHT-specific actions, and provide the status of the reception.

Child classes can perform amendment-specific actions by specializing

See also: ProcessSigA.

Parameters

event the event holding incoming PPDU's information

Returns: status of the reception of the SIG-A

Definition at line 242 of file vht-phy.cc.

References ns3::PhyEntity::PhyFieldRxStatus::actionIfFailure, ns3::PhyEntity::DROP, ns3::PhyEntity::GetPhyHeaderSnrPer(), ns3::PhyEntity::GetRandomValue(), IsAllConfigSupported(), ns3::PhyEntity::PhyFieldRxStatus::isSuccess, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::PhyEntity::SnrPer::per, ProcessSigA(), ns3::RatioToDb(), ns3::PhyEntity::PhyFieldRxStatus::reason, ns3::SIG_A_FAILURE, ns3::PhyEntity::SnrPer::snr, ns3::UNSUPPORTED_SETTINGS, ns3::WIFI_PPDU_FIELD_SIG_A, and ns3::WIFI_PREAMBLE_VHT_SU.

Referenced by DoEndReceiveField().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ EndReceiveSigB()

PhyEntity::PhyFieldRxStatus ns3::VhtPhy::EndReceiveSigB ( Ptr< Event > event )

protected

End receiving the SIG-B, perform VHT-specific actions, and provide the status of the reception.

Child classes can perform amendment-specific actions by specializing

See also: ProcessSigB.

Parameters

event the event holding incoming PPDU's information

Returns: status of the reception of the SIG-B

Definition at line 276 of file vht-phy.cc.

References ns3::PhyEntity::PhyFieldRxStatus::actionIfFailure, ns3::PhyEntity::DROP, ns3::PhyEntity::GetPhyHeaderSnrPer(), ns3::PhyEntity::GetRandomValue(), IsAllConfigSupported(), ns3::PhyEntity::PhyFieldRxStatus::isSuccess, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::PhyEntity::SnrPer::per, ProcessSigB(), ns3::RatioToDb(), ns3::PhyEntity::PhyFieldRxStatus::reason, ns3::SIG_B_FAILURE, ns3::PhyEntity::SnrPer::snr, ns3::UNSUPPORTED_SETTINGS, ns3::WIFI_PPDU_FIELD_SIG_A, ns3::WIFI_PPDU_FIELD_SIG_B, and ns3::WIFI_PPDU_TYPE_DL_MU.

Referenced by DoEndReceiveField().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetCodeRate()

WifiCodeRate ns3::VhtPhy::GetCodeRate ( uint8_t mcsValue )

static

Return the coding rate corresponding to the supplied VHT MCS index.

This function is reused by child classes and is used as a callback for WifiMode operation.

Parameters

mcsValue the MCS index

Returns: the coding rate.

Definition at line 391 of file vht-phy.cc.

References ns3::HtPhy::GetCodeRate(), ns3::WIFI_CODE_RATE_3_4, and ns3::WIFI_CODE_RATE_5_6.

Referenced by CreateVhtMcs(), ns3::HePhy::GetCodeRate(), GetDataRate(), GetNonHtReferenceRate(), and GetPhyRate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetConstellationSize()

uint16_t ns3::VhtPhy::GetConstellationSize ( uint8_t mcsValue )

static

Return the constellation size corresponding to the supplied VHT MCS index.

This function is reused by child classes and is used as a callback for WifiMode operation.

Parameters

mcsValue the MCS index

Returns: the size of modulation constellation.

Definition at line 405 of file vht-phy.cc.

References ns3::HtPhy::GetConstellationSize().

Referenced by CreateVhtMcs(), ns3::HePhy::GetConstellationSize(), GetDataRate(), and GetNonHtReferenceRate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetDataRate()

uint64_t ns3::VhtPhy::GetDataRate	(	uint8_t	mcsValue,
		uint16_t	channelWidth,
		uint16_t	guardInterval,
		uint8_t	nss
	)

static

Return the data rate corresponding to the supplied VHT MCS index, channel width, guard interval, and number of spatial streams.

Parameters

mcsValue	the MCS index
channelWidth	the channel width in MHz
guardInterval	the guard interval duration in nanoseconds
nss	the number of spatial streams

Returns: the data bit rate in bps.

Definition at line 444 of file vht-phy.cc.

References ns3::HtPhy::CalculateDataRate(), GetCodeRate(), ns3::HtPhy::GetCodeRatio(), GetConstellationSize(), GetUsableSubcarriers(), IsCombinationAllowed(), NS_ASSERT, and NS_ASSERT_MSG.

Referenced by GetDataRateFromTxVector(), and GetPhyRate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetDataRateFromTxVector()

uint64_t ns3::VhtPhy::GetDataRateFromTxVector	(	const WifiTxVector &	txVector,
		uint16_t	staId
	)

static

Return the data rate corresponding to the supplied TXVECTOR.

This function is mainly used as a callback for WifiMode operation.

Parameters

txVector	the TXVECTOR used for the transmission
staId	the station ID (only here to have a common signature for all callbacks)

Returns: the data bit rate in bps.

Definition at line 435 of file vht-phy.cc.

References ns3::WifiTxVector::GetChannelWidth(), GetDataRate(), ns3::WifiTxVector::GetGuardInterval(), ns3::WifiMode::GetMcsValue(), ns3::WifiTxVector::GetMode(), and ns3::WifiTxVector::GetNss().

Referenced by CreateVhtMcs().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetDuration()

Time ns3::VhtPhy::GetDuration	(	WifiPpduField	field,
		const WifiTxVector &	txVector
	)		const

overridevirtual

Get the duration of the PPDU field (or group of fields) used by this entity for the given transmission parameters.

Parameters

field	the PPDU field (or group of fields)
txVector	the transmission parameters

Returns: the duration of the PPDU field

Reimplemented from ns3::HtPhy.

Definition at line 146 of file vht-phy.cc.

References ns3::HtPhy::GetDuration(), ns3::WifiTxVector::GetPreambleType(), GetSigADuration(), GetSigBDuration(), ns3::WIFI_PPDU_FIELD_SIG_A, and ns3::WIFI_PPDU_FIELD_SIG_B.

Referenced by ns3::HePhy::CalculateNonOfdmaDurationForHeTb(), and ns3::HePhy::StartReceivePreamble().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetHtSigDuration()

Time ns3::VhtPhy::GetHtSigDuration ( void ) const

overrideprotectedvirtual

Returns: the duration of the HT-SIG field

Reimplemented from ns3::HtPhy.

Definition at line 166 of file vht-phy.cc.

References ns3::MicroSeconds().

Here is the call graph for this function:

◆ GetHtSigMode()

WifiMode ns3::VhtPhy::GetHtSigMode ( void ) const

overrideprotectedvirtual

Returns: the WifiMode used for the HT-SIG field

Reimplemented from ns3::HtPhy.

Definition at line 125 of file vht-phy.cc.

References HT_PHY, ns3::HtPhy::m_bssMembershipSelector, NS_ASSERT, and NS_FATAL_ERROR.

◆ GetLSigDuration()

Time ns3::VhtPhy::GetLSigDuration ( WifiPreamble preamble ) const

overridevirtual

Parameters

preamble the type of preamble

Returns: the duration of the L-SIG (non-HT header) field

See also: WIFI_PPDU_FIELD_NON_HT_HEADER

Reimplemented from ns3::HtPhy.

Definition at line 160 of file vht-phy.cc.

References ns3::MicroSeconds().

Here is the call graph for this function:

◆ GetMaxPsduSize()

uint32_t ns3::VhtPhy::GetMaxPsduSize ( void ) const

overrideprotectedvirtual

Get the maximum PSDU size in bytes.

Returns: the maximum PSDU size in bytes

Reimplemented from ns3::HtPhy.

Definition at line 522 of file vht-phy.cc.

◆ GetNonHtReferenceRate()

uint64_t ns3::VhtPhy::GetNonHtReferenceRate ( uint8_t mcsValue )

static

Calculate the rate in bps of the non-HT Reference Rate corresponding to the supplied VHT MCS index.

This function calls CalculateNonHtReferenceRate and is used as a callback for WifiMode operation.

Parameters

mcsValue the VHT MCS index

Returns: the rate in bps of the non-HT Reference Rate.

Definition at line 470 of file vht-phy.cc.

References CalculateNonHtReferenceRate(), GetCodeRate(), and GetConstellationSize().

Referenced by CreateVhtMcs().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetNumberBccEncoders()

uint8_t ns3::VhtPhy::GetNumberBccEncoders ( const WifiTxVector & txVector ) const

overrideprotectedvirtual

Parameters

txVector the transmission parameters

Returns: the number of BCC encoders used for data encoding

General rule: add an encoder when crossing maxRatePerCoder frontier

The value of 540 Mbps and 600 Mbps for normal GI and short GI (resp.) were obtained by observing the rates for which Nes was incremented in tables 21-30 to 21-61 of IEEE 802.11-2016. These values are the last values before changing encoders.

Add an encoder when crossing maxRatePerCoder frontier.

The value of 320 Mbps and 350 Mbps for normal GI and short GI (resp.) were obtained by observing the rates for which Nes was incremented in tables 19-27 to 19-41 of IEEE 802.11-2016.

Reimplemented from ns3::HtPhy.

Definition at line 193 of file vht-phy.cc.

References ns3::WifiTxVector::GetChannelWidth(), ns3::WifiMode::GetDataRate(), ns3::WifiTxVector::GetGuardInterval(), ns3::WifiMode::GetMcsValue(), ns3::WifiTxVector::GetMode(), ns3::WifiTxVector::GetNss(), and m_exceptionsMap.

Here is the call graph for this function:

◆ GetPhyRate()

uint64_t ns3::VhtPhy::GetPhyRate	(	uint8_t	mcsValue,
		uint16_t	channelWidth,
		uint16_t	guardInterval,
		uint8_t	nss
	)

static

Return the PHY rate corresponding to the supplied VHT MCS index, channel width, guard interval, and number of spatial stream.

This function calls HtPhy::CalculatePhyRate and is mainly used as a callback for WifiMode operation.

Parameters

mcsValue	the VHT MCS index
channelWidth	the considered channel width in MHz
guardInterval	the considered guard interval duration in nanoseconds
nss	the considered number of stream

Returns: the physical bit rate of this signal in bps.

Definition at line 418 of file vht-phy.cc.

References ns3::HtPhy::CalculatePhyRate(), GetCodeRate(), and GetDataRate().

Referenced by GetPhyRateFromTxVector().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetPhyRateFromTxVector()

uint64_t ns3::VhtPhy::GetPhyRateFromTxVector	(	const WifiTxVector &	txVector,
		uint16_t	staId
	)

static

Return the PHY rate corresponding to the supplied TXVECTOR.

This function is mainly used as a callback for WifiMode operation.

Parameters

txVector	the TXVECTOR used for the transmission
staId	the station ID (only here to have a common signature for all callbacks)

Returns: the physical bit rate of this signal in bps.

Definition at line 426 of file vht-phy.cc.

References ns3::WifiTxVector::GetChannelWidth(), ns3::WifiTxVector::GetGuardInterval(), ns3::WifiMode::GetMcsValue(), ns3::WifiTxVector::GetMode(), ns3::WifiTxVector::GetNss(), and GetPhyRate().

Referenced by CreateVhtMcs().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetPpduFormats()

const PhyEntity::PpduFormats & ns3::VhtPhy::GetPpduFormats ( void ) const

overridevirtual

Return the PPDU formats of the PHY.

Returns: the PPDU formats of the PHY

Reimplemented from ns3::HtPhy.

Definition at line 104 of file vht-phy.cc.

References m_vhtPpduFormats.

◆ GetSigADuration()

Time ns3::VhtPhy::GetSigADuration ( WifiPreamble preamble ) const

virtual

Parameters

preamble the type of preamble

Returns: the duration of the SIG-A field

Reimplemented in ns3::HePhy.

Definition at line 181 of file vht-phy.cc.

References ns3::MicroSeconds().

Referenced by GetDuration().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetSigAMode()

WifiMode ns3::VhtPhy::GetSigAMode ( void ) const

virtual

Returns: the WifiMode used for the SIG-A field

Reimplemented in ns3::HePhy.

Definition at line 133 of file vht-phy.cc.

References ns3::HtPhy::GetLSigMode().

Referenced by GetSigMode().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetSigBDuration()

Time ns3::VhtPhy::GetSigBDuration ( const WifiTxVector & txVector ) const

virtual

Parameters

txVector the transmission parameters

Returns: the duration of the SIG-B field

Reimplemented in ns3::HePhy.

Definition at line 187 of file vht-phy.cc.

References ns3::WifiTxVector::GetPreambleType(), ns3::MicroSeconds(), and ns3::WIFI_PREAMBLE_VHT_MU.

Referenced by GetDuration().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetSigBMode()

WifiMode ns3::VhtPhy::GetSigBMode ( const WifiTxVector & txVector ) const

virtual

Parameters

txVector the transmission parameters

Returns: the WifiMode used for the SIG-B field

Reimplemented in ns3::HePhy.

Definition at line 139 of file vht-phy.cc.

References ns3::WifiTxVector::GetPreambleType(), GetVhtMcs0(), NS_ABORT_MSG_IF, and ns3::WIFI_PREAMBLE_VHT_MU.

Referenced by GetSigMode().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetSigMode()

WifiMode ns3::VhtPhy::GetSigMode	(	WifiPpduField	field,
		const WifiTxVector &	txVector
	)		const

overridevirtual

Get the WifiMode for the SIG field specified by the PPDU field.

Parameters

field	the PPDU field
txVector	the transmission parameters

Returns: the WifiMode used for the SIG field

Reimplemented from ns3::HtPhy.

Definition at line 110 of file vht-phy.cc.

References GetSigAMode(), GetSigBMode(), ns3::HtPhy::GetSigMode(), ns3::WIFI_PPDU_FIELD_SIG_A, ns3::WIFI_PPDU_FIELD_SIG_B, and ns3::WIFI_PPDU_FIELD_TRAINING.

Referenced by ns3::HePhy::GetSigMode().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetTrainingDuration()

Time ns3::VhtPhy::GetTrainingDuration	(	const WifiTxVector &	txVector,
		uint8_t	nDataLtf,
		uint8_t	nExtensionLtf = `0`
	)		const

overridevirtual

Parameters

txVector	the transmission parameters
nDataLtf	the number of data LTF fields (excluding those in preamble)
nExtensionLtf	the number of extension LTF fields

Returns: the duration of the training field

See also: WIFI_PPDU_FIELD_TRAINING

Reimplemented from ns3::HtPhy.

Definition at line 172 of file vht-phy.cc.

References ns3::MicroSeconds(), and NS_ABORT_MSG_IF.

Here is the call graph for this function:

◆ GetUsableSubcarriers()

uint16_t ns3::VhtPhy::GetUsableSubcarriers ( uint16_t channelWidth )

staticprotected

Parameters

channelWidth the channel width in MHz

Returns: he number of usable subcarriers for data

Definition at line 456 of file vht-phy.cc.

References ns3::HtPhy::GetUsableSubcarriers().

Referenced by GetDataRate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetVhtMcs()

WifiMode ns3::VhtPhy::GetVhtMcs ( uint8_t index )

static

Return the VHT MCS corresponding to the provided index.

Parameters

index the index of the MCS

Returns: an VHT MCS

Definition at line 329 of file vht-phy.cc.

References CASE, and NS_ABORT_MSG.

Referenced by ns3::VhtPpdu::DoGetTxVector(), and InitializeModes().

Here is the caller graph for this function:

◆ GetVhtMcs0()

static WifiMode ns3::VhtPhy::GetVhtMcs0 ( void )

static

Return MCS 0 from VHT MCS values.

Returns: MCS 0 from VHT MCS values

Referenced by ns3::HePhy::GetSigAMode(), GetSigBMode(), and ns3::HePhy::GetSigBMode().

Here is the caller graph for this function:

◆ GetVhtMcs1()

static WifiMode ns3::VhtPhy::GetVhtMcs1 ( void )

static

Return MCS 1 from VHT MCS values.

Returns: MCS 1 from VHT MCS values

Referenced by ns3::HePhy::GetSigBMode().

Here is the caller graph for this function:

◆ GetVhtMcs2()

static WifiMode ns3::VhtPhy::GetVhtMcs2 ( void )

static

Return MCS 2 from VHT MCS values.

Returns: MCS 2 from VHT MCS values

Referenced by ns3::HePhy::GetSigBMode().

Here is the caller graph for this function:

◆ GetVhtMcs3()

static WifiMode ns3::VhtPhy::GetVhtMcs3 ( void )

static

Return MCS 3 from VHT MCS values.

Returns: MCS 3 from VHT MCS values

Referenced by ns3::HePhy::GetSigBMode().

Here is the caller graph for this function:

◆ GetVhtMcs4()

static WifiMode ns3::VhtPhy::GetVhtMcs4 ( void )

static

Return MCS 4 from VHT MCS values.

Returns: MCS 4 from VHT MCS values

Referenced by ns3::HePhy::GetSigBMode().

Here is the caller graph for this function:

◆ GetVhtMcs5()

static WifiMode ns3::VhtPhy::GetVhtMcs5 ( void )

static

Return MCS 5 from VHT MCS values.

Returns: MCS 5 from VHT MCS values

Referenced by ns3::HePhy::GetSigBMode().

Here is the caller graph for this function:

◆ GetVhtMcs6()

static WifiMode ns3::VhtPhy::GetVhtMcs6 ( void )

static

Return MCS 6 from VHT MCS values.

Returns: MCS 6 from VHT MCS values

◆ GetVhtMcs7()

static WifiMode ns3::VhtPhy::GetVhtMcs7 ( void )

static

Return MCS 7 from VHT MCS values.

Returns: MCS 7 from VHT MCS values

◆ GetVhtMcs8()

static WifiMode ns3::VhtPhy::GetVhtMcs8 ( void )

static

Return MCS 8 from VHT MCS values.

Returns: MCS 8 from VHT MCS values

◆ GetVhtMcs9()

static WifiMode ns3::VhtPhy::GetVhtMcs9 ( void )

static

Return MCS 9 from VHT MCS values.

Returns: MCS 9 from VHT MCS values

◆ InitializeModes()

void ns3::VhtPhy::InitializeModes ( void )

static

Initialize all VHT modes.

Definition at line 320 of file vht-phy.cc.

References GetVhtMcs().

Referenced by anonymous_namespace{vht-phy.cc}::ConstructorVht::ConstructorVht().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsAllConfigSupported()

bool ns3::VhtPhy::IsAllConfigSupported	(	WifiPpduField	field,
		Ptr< const WifiPpdu >	ppdu
	)		const

overrideprotectedvirtual

Checks if the signaled configuration (including bandwidth) is supported by the PHY.

Parameters

field	the current PPDU field (SIG used for checking config)
ppdu	the received PPDU

Returns: true if supported, false otherwise

Reimplemented from ns3::HtPhy.

Definition at line 310 of file vht-phy.cc.

References ns3::HtPhy::IsAllConfigSupported(), ns3::OfdmPhy::IsChannelWidthSupported(), ns3::WIFI_PPDU_FIELD_SIG_A, and ns3::WIFI_PPDU_TYPE_DL_MU.

Referenced by EndReceiveSigA(), and EndReceiveSigB().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsAllowed()

bool ns3::VhtPhy::IsAllowed ( const WifiTxVector & txVector )

static

Check whether the combination in TXVECTOR is allowed.

This function is used as a callback for WifiMode operation.

Parameters

txVector the TXVECTOR

Returns: true if this combination is allowed, false otherwise.

Definition at line 500 of file vht-phy.cc.

References ns3::WifiTxVector::GetChannelWidth(), ns3::WifiMode::GetMcsValue(), ns3::WifiTxVector::GetMode(), ns3::WifiTxVector::GetNss(), and IsCombinationAllowed().

Referenced by CreateVhtMcs().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsCombinationAllowed()

bool ns3::VhtPhy::IsCombinationAllowed	(	uint8_t	mcsValue,
		uint16_t	channelWidth,
		uint8_t	nss
	)

static

Check whether the combination of <MCS, channel width, NSS> is allowed.

This function is used as a callback for WifiMode operation.

Parameters

mcsValue	the considered MCS index
channelWidth	the considered channel width in MHz
nss	the considered number of streams

Returns: true if this <MCS, channel width, NSS> combination is allowed, false otherwise.

Definition at line 508 of file vht-phy.cc.

Referenced by GetDataRate(), and IsAllowed().

Here is the caller graph for this function:

◆ ProcessSigA()

PhyEntity::PhyFieldRxStatus ns3::VhtPhy::ProcessSigA	(	Ptr< Event >	event,
		PhyFieldRxStatus	status
	)

protectedvirtual

Process SIG-A, perform amendment-specific actions, and provide an updated status of the reception.

Parameters

event	the event holding incoming PPDU's information
status	the status of the reception of the correctly received SIG-A after the configuration support check

Returns: the updated status of the reception of the SIG-A

Reimplemented in ns3::HePhy.

Definition at line 268 of file vht-phy.cc.

References NS_LOG_FUNCTION.

Referenced by EndReceiveSigA().

Here is the caller graph for this function:

◆ ProcessSigB()

PhyEntity::PhyFieldRxStatus ns3::VhtPhy::ProcessSigB	(	Ptr< Event >	event,
		PhyFieldRxStatus	status
	)

protectedvirtual

Process SIG-B, perform amendment-specific actions, and provide an updated status of the reception.

Parameters

event	the event holding incoming PPDU's information
status	the status of the reception of the correctly received SIG-B after the configuration support check

Returns: the updated status of the reception of the SIG-B

Reimplemented in ns3::HePhy.

Definition at line 302 of file vht-phy.cc.

References NS_LOG_FUNCTION.

Referenced by EndReceiveSigB().

Here is the caller graph for this function:

Member Data Documentation

◆ m_exceptionsMap

const VhtPhy::NesExceptionMap ns3::VhtPhy::m_exceptionsMap

staticprivate

Initial value:

{
                 
  { std::make_tuple ( 80, 7, 2),  3 },   
  { std::make_tuple ( 80, 7, 7),  6 },   
  { std::make_tuple ( 80, 7, 8),  6 },   
  { std::make_tuple ( 80, 8, 7),  6 },   
  { std::make_tuple (160, 4, 7),  6 },   
  { std::make_tuple (160, 5, 8),  8 },   
  { std::make_tuple (160, 6, 7),  8 },   
  { std::make_tuple (160, 7, 3),  4 },   
  { std::make_tuple (160, 7, 4),  6 },   
  { std::make_tuple (160, 7, 5),  7 },   
  { std::make_tuple (160, 7, 7),  9 },   
  { std::make_tuple (160, 7, 8), 12 },   
  { std::make_tuple (160, 7, 9), 12 }    
}

exception map for number of BCC encoders (extracted from VHT-MCS tables)

Definition at line 355 of file vht-phy.h.

Referenced by GetNumberBccEncoders().

◆ m_vhtPpduFormats

const PhyEntity::PpduFormats ns3::VhtPhy::m_vhtPpduFormats

staticprivate

Initial value:

{
  { WIFI_PREAMBLE_VHT_SU, { WIFI_PPDU_FIELD_PREAMBLE,      
                            WIFI_PPDU_FIELD_NON_HT_HEADER, 
                            WIFI_PPDU_FIELD_SIG_A,         
                            WIFI_PPDU_FIELD_TRAINING,      
                            WIFI_PPDU_FIELD_DATA } },
  { WIFI_PREAMBLE_VHT_MU, { WIFI_PPDU_FIELD_PREAMBLE,      
                            WIFI_PPDU_FIELD_NON_HT_HEADER, 
                            WIFI_PPDU_FIELD_SIG_A,         
                            WIFI_PPDU_FIELD_TRAINING,      
                            WIFI_PPDU_FIELD_SIG_B,         
                            WIFI_PPDU_FIELD_DATA } }
}

VHT PPDU formats.

Definition at line 356 of file vht-phy.h.

Referenced by GetPpduFormats().

The documentation for this class was generated from the following files:

src/wifi/model/vht/vht-phy.h
src/wifi/model/vht/vht-phy.cc

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Private Types

Private Member Functions

Static Private Member Functions

Static Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ NesExceptionMap

Constructor & Destructor Documentation

◆ VhtPhy()

◆ ~VhtPhy()

Member Function Documentation

◆ BuildModeList()

◆ BuildPpdu()

◆ CalculateNonHtReferenceRate()

◆ CreateVhtMcs()

◆ DoEndReceiveField()

◆ EndReceiveSigA()

◆ EndReceiveSigB()

◆ GetCodeRate()

◆ GetConstellationSize()

◆ GetDataRate()

◆ GetDataRateFromTxVector()

◆ GetDuration()

◆ GetHtSigDuration()

◆ GetHtSigMode()

◆ GetLSigDuration()

◆ GetMaxPsduSize()

◆ GetNonHtReferenceRate()

◆ GetNumberBccEncoders()

◆ GetPhyRate()

◆ GetPhyRateFromTxVector()

◆ GetPpduFormats()

◆ GetSigADuration()

◆ GetSigAMode()

◆ GetSigBDuration()

◆ GetSigBMode()

◆ GetSigMode()

◆ GetTrainingDuration()

◆ GetUsableSubcarriers()

◆ GetVhtMcs()

◆ GetVhtMcs0()

◆ GetVhtMcs1()

◆ GetVhtMcs2()

◆ GetVhtMcs3()

◆ GetVhtMcs4()

◆ GetVhtMcs5()

◆ GetVhtMcs6()

◆ GetVhtMcs7()

◆ GetVhtMcs8()

◆ GetVhtMcs9()

◆ InitializeModes()

◆ IsAllConfigSupported()

◆ IsAllowed()

◆ IsCombinationAllowed()

◆ ProcessSigA()

◆ ProcessSigB()

Member Data Documentation

◆ m_exceptionsMap

◆ m_vhtPpduFormats