ns3::WifiMode Class Reference

represent a single transmission mode More...

#include "wifi-mode.h"

Collaboration diagram for ns3::WifiMode:

Public Member Functions
	WifiMode ()
	Create an invalid WifiMode. More...
	WifiMode (std::string name)
	Create a WifiMode if the given string represents a valid WifiMode name. More...
WifiCodeRate	GetCodeRate () const
uint16_t	GetConstellationSize () const
uint64_t	GetDataRate (const WifiTxVector &txVector, uint16_t staId=SU_STA_ID) const
uint64_t	GetDataRate (uint16_t channelWidth) const
uint64_t	GetDataRate (uint16_t channelWidth, uint16_t guardInterval, uint8_t nss) const
uint8_t	GetMcsValue () const
WifiModulationClass	GetModulationClass () const
uint64_t	GetNonHtReferenceRate () const
uint64_t	GetPhyRate (const WifiTxVector &txVector, uint16_t staId=SU_STA_ID) const
uint64_t	GetPhyRate (uint16_t channelWidth) const
uint64_t	GetPhyRate (uint16_t channelWidth, uint16_t guardInterval, uint8_t nss) const
uint32_t	GetUid () const
std::string	GetUniqueName () const
bool	IsAllowed (const WifiTxVector &txVector) const
bool	IsAllowed (uint16_t channelWidth, uint8_t nss) const
bool	IsHigherCodeRate (WifiMode mode) const
bool	IsHigherDataRate (WifiMode mode) const
bool	IsMandatory () const

Private Member Functions
	WifiMode (uint32_t uid)
	Create a WifiMode from a given unique ID. More...

Private Attributes
uint32_t	m_uid
	UID. More...

Friends
class	WifiModeFactory
	allow WifiModeFactory class access More...

Detailed Description

represent a single transmission mode

A WifiMode is implemented by a single integer which is used to lookup in a global array the characteristics of the associated transmission mode. It is thus extremely cheap to keep a WifiMode variable around.

See also

attribute_WifiMode

Definition at line 50 of file wifi-mode.h.

Constructor & Destructor Documentation

WifiMode() [1/3]

ns3::WifiMode::WifiMode

(

)

Create an invalid WifiMode.

Calling any method on the instance created will trigger an assert. This is useful to separate the declaration of a WifiMode variable from its initialization.

Definition at line 248 of file wifi-mode.cc.

Referenced by GetDataRate(), GetPhyRate(), and IsAllowed().

Here is the caller graph for this function:

WifiMode() [2/3]

ns3::WifiMode::WifiMode

(

std::string

name

)

Create a WifiMode if the given string represents a valid WifiMode name.

Parameters

name	std::string of a valid WifiMode name

Definition at line 258 of file wifi-mode.cc.

References ns3::WifiModeFactory::GetFactory(), and ns3::WifiModeFactory::Search().

Here is the call graph for this function:

WifiMode() [3/3]

ns3::WifiMode::WifiMode ( uint32_t  uid )

private

Create a WifiMode from a given unique ID.

Parameters

uid

unique ID

Definition at line 253 of file wifi-mode.cc.

Member Function Documentation

GetCodeRate()

WifiCodeRate ns3::WifiMode::GetCodeRate

(

)

const

Returns

the coding rate of this transmission mode

Definition at line 134 of file wifi-mode.cc.

References ns3::WifiModeFactory::Get(), ns3::WifiModeFactory::WifiModeItem::GetCodeRateCallback, ns3::WifiModeFactory::GetFactory(), and m_uid.

Referenced by ns3::NistErrorRateModel::DoGetChunkSuccessRate(), ns3::YansErrorRateModel::DoGetChunkSuccessRate(), ns3::TableBasedErrorRateModel::GetMcsForMode(), IsHigherCodeRate(), and IsHigherDataRate().

Here is the call graph for this function:

Here is the caller graph for this function:

GetConstellationSize()

uint16_t ns3::WifiMode::GetConstellationSize

(

)

const

Returns

the size of the modulation constellation.

Definition at line 141 of file wifi-mode.cc.

References ns3::WifiModeFactory::Get(), ns3::WifiModeFactory::WifiModeItem::GetConstellationSizeCallback, ns3::WifiModeFactory::GetFactory(), and m_uid.

Referenced by ns3::NistErrorRateModel::DoGetChunkSuccessRate(), ns3::YansErrorRateModel::DoGetChunkSuccessRate(), ns3::TableBasedErrorRateModel::GetMcsForMode(), and IsHigherDataRate().

Here is the call graph for this function:

Here is the caller graph for this function:

GetDataRate() [1/3]

uint64_t ns3::WifiMode::GetDataRate	(	const WifiTxVector &	txVector,
		uint16_t	staId = SU_STA_ID
	)		const

Parameters

txVector	the const WifiTxVector& of the signal
staId	the station ID for MU (unused if SU)

Returns

the data bit rate of this signal.

Definition at line 115 of file wifi-mode.cc.

References ns3::WifiModeFactory::Get(), ns3::WifiModeFactory::WifiModeItem::GetDataRateCallback, ns3::WifiModeFactory::GetFactory(), and m_uid.

Here is the call graph for this function:

GetDataRate() [2/3]

uint64_t ns3::WifiMode::GetDataRate

(

uint16_t

channelWidth

)

const

Parameters

channelWidth

the considered channel width in MHz

Returns

the data bit rate of this non-HT.

Definition at line 109 of file wifi-mode.cc.

References GetDataRate().

Here is the call graph for this function:

GetDataRate() [3/3]

uint64_t ns3::WifiMode::GetDataRate	(	uint16_t	channelWidth,
		uint16_t	guardInterval,
		uint8_t	nss
	)		const

Parameters

channelWidth	the considered channel width in MHz
guardInterval	the considered guard interval duration in nanoseconds
nss	the considered number of streams

Returns

the data bit rate of this signal in bps.

Definition at line 122 of file wifi-mode.cc.

References WifiMode(), m_uid, NS_ASSERT, ns3::WifiTxVector::SetChannelWidth(), ns3::WifiTxVector::SetGuardInterval(), ns3::WifiTxVector::SetMode(), and ns3::WifiTxVector::SetNss().

Referenced by ns3::WifiRemoteStationManager::AdjustTxVectorForIcf(), ns3::InterferenceHelper::CalculateChunkSuccessRate(), ns3::InterferenceHelper::CalculatePayloadChunkSuccessRate(), HeRuMcsDataRateTestCase::CheckDataRate(), ns3::AparfWifiManager::CheckInit(), ns3::ParfWifiManager::CheckInit(), ns3::RrpaaWifiManager::CheckInit(), EmlsrDlTxopTest::CheckInitialControlFrame(), TxDurationTest::CheckMuTxDuration(), TxDurationTest::CheckPayloadDuration(), ns3::MeshWifiInterfaceMac::CheckSupportedRates(), TxDurationTest::CheckTxDuration(), ns3::AarfWifiManager::DoGetDataTxVector(), ns3::AarfcdWifiManager::DoGetDataTxVector(), ns3::AmrrWifiManager::DoGetDataTxVector(), ns3::AparfWifiManager::DoGetDataTxVector(), ns3::ArfWifiManager::DoGetDataTxVector(), ns3::CaraWifiManager::DoGetDataTxVector(), ns3::IdealWifiManager::DoGetDataTxVector(), ns3::MinstrelHtWifiManager::DoGetDataTxVector(), ns3::OnoeWifiManager::DoGetDataTxVector(), ns3::ParfWifiManager::DoGetDataTxVector(), ns3::RraaWifiManager::DoGetDataTxVector(), ns3::RrpaaWifiManager::DoGetDataTxVector(), ns3::ThompsonSamplingWifiManager::DoGetDataTxVector(), ns3::MinstrelHtWifiManager::DoGetRtsTxVector(), ns3::ErrorRateModel::GetChunkSuccessRate(), GetDataRate(), ns3::MinstrelWifiManager::GetDataTxVector(), ns3::DsssPhy::GetHeaderDuration(), ns3::ApWifiMac::GetHtOperation(), ns3::HtPhy::GetNumberBccEncoders(), ns3::VhtPhy::GetNumberBccEncoders(), ns3::HtPhy::GetPayloadDuration(), ns3::DsssPhy::GetPayloadDuration(), ns3::OfdmPhy::GetPayloadDuration(), ns3::DsssPhy::GetPreambleDuration(), ns3::WifiPhyHelper::GetRadiotapHeader(), ns3::PhyEntity::GetReceptionStatus(), ns3::HePhy::GetSigBDuration(), ns3::MeshWifiInterfaceMac::GetSupportedRates(), ns3::ApWifiMac::GetSupportedRates(), ns3::DsssPpdu::SetDsssHeader(), ns3::OfdmPpdu::SetLSigHeader(), PowerRateAdaptationTest::TestAparf(), PowerRateAdaptationTest::TestParf(), and PowerRateAdaptationTest::TestRrpaa().

Here is the call graph for this function:

Here is the caller graph for this function:

GetMcsValue()

uint8_t ns3::WifiMode::GetMcsValue

(

)

const

Returns

the MCS value.

Definition at line 163 of file wifi-mode.cc.

References ns3::WifiModeFactory::Get(), ns3::WifiModeFactory::GetFactory(), m_uid, ns3::WifiModeFactory::WifiModeItem::mcsValue, ns3::WifiModeFactory::WifiModeItem::modClass, NS_ASSERT, and ns3::WIFI_MOD_CLASS_HT.

Referenced by ns3::WifiRemoteStationManager::AddBasicMcs(), ns3::IdealWifiManager::BuildSnrThresholds(), ns3::ConstantRateWifiManager::DoGetDataTxVector(), TableBasedErrorRateTestCase::DoRun(), ns3::HtPhy::GetDataRateFromTxVector(), ns3::VhtPhy::GetDataRateFromTxVector(), ns3::EhtPhy::GetDataRateFromTxVector(), ns3::HePhy::GetDataRateFromTxVector(), ns3::EhtPpdu::GetEhtSigContentChannels(), ns3::ApWifiMac::GetHtOperation(), ns3::TableBasedErrorRateModel::GetMcsForMode(), ns3::VhtPhy::GetNumberBccEncoders(), ns3::HtPhy::GetPhyRateFromTxVector(), ns3::VhtPhy::GetPhyRateFromTxVector(), ns3::EhtPhy::GetPhyRateFromTxVector(), ns3::HePhy::GetPhyRateFromTxVector(), ns3::WifiPhyHelper::GetRadiotapHeader(), ns3::EhtPhy::GetSigBMode(), ns3::VhtPhy::IsAllowed(), ns3::MinstrelHtWifiManager::RateInit(), ns3::ApWifiMac::ReceiveAssocRequest(), ns3::EhtPpdu::SetEhtPhyHeader(), ns3::HePpdu::SetHeSigHeader(), ns3::HtPpdu::SetHtSigHeader(), ns3::WifiTxVector::SetMode(), ns3::VhtPpdu::SetVhtSigHeader(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().

Here is the call graph for this function:

Here is the caller graph for this function:

GetModulationClass()

WifiModulationClass ns3::WifiMode::GetModulationClass

(

)

const

Returns

the Modulation Class (Section 9.7.8 "Modulation classes"; IEEE 802.11-2012) to which this WifiMode belongs.

Definition at line 185 of file wifi-mode.cc.

References ns3::WifiModeFactory::Get(), ns3::WifiModeFactory::GetFactory(), m_uid, and ns3::WifiModeFactory::WifiModeItem::modClass.

Referenced by ns3::WifiRemoteStationManager::AddBasicMode(), ns3::WifiRemoteStationManager::AddSupportedMode(), ns3::IdealWifiManager::BuildSnrThresholds(), TxDurationTest::CheckPayloadDuration(), TxDurationTest::CheckTxDuration(), ns3::ConvertGuardIntervalToNanoSeconds(), ns3::NistErrorRateModel::DoGetChunkSuccessRate(), ns3::TableBasedErrorRateModel::DoGetChunkSuccessRate(), ns3::YansErrorRateModel::DoGetChunkSuccessRate(), ns3::AarfWifiManager::DoGetDataTxVector(), ns3::AarfcdWifiManager::DoGetDataTxVector(), ns3::AmrrWifiManager::DoGetDataTxVector(), ns3::AparfWifiManager::DoGetDataTxVector(), ns3::ArfWifiManager::DoGetDataTxVector(), ns3::CaraWifiManager::DoGetDataTxVector(), ns3::ConstantRateWifiManager::DoGetDataTxVector(), ns3::IdealWifiManager::DoGetDataTxVector(), ns3::MinstrelHtWifiManager::DoGetDataTxVector(), ns3::OnoeWifiManager::DoGetDataTxVector(), ns3::ParfWifiManager::DoGetDataTxVector(), ns3::RraaWifiManager::DoGetDataTxVector(), ns3::RrpaaWifiManager::DoGetDataTxVector(), ns3::ThompsonSamplingWifiManager::DoGetDataTxVector(), ns3::AarfWifiManager::DoGetRtsTxVector(), ns3::AarfcdWifiManager::DoGetRtsTxVector(), ns3::AmrrWifiManager::DoGetRtsTxVector(), ns3::AparfWifiManager::DoGetRtsTxVector(), ns3::ArfWifiManager::DoGetRtsTxVector(), ns3::CaraWifiManager::DoGetRtsTxVector(), ns3::ConstantRateWifiManager::DoGetRtsTxVector(), ns3::IdealWifiManager::DoGetRtsTxVector(), ns3::MinstrelHtWifiManager::DoGetRtsTxVector(), ns3::OnoeWifiManager::DoGetRtsTxVector(), ns3::ParfWifiManager::DoGetRtsTxVector(), ns3::RraaWifiManager::DoGetRtsTxVector(), ns3::RrpaaWifiManager::DoGetRtsTxVector(), ns3::ThompsonSamplingWifiManager::DoGetRtsTxVector(), ns3::WifiRemoteStationManager::GetAckTxVector(), ns3::WifiRemoteStationManager::GetBlockAckTxVector(), ns3::IdealWifiManager::GetChannelWidthForNonHtMode(), ns3::ErrorRateModel::GetChunkSuccessRate(), ns3::WifiRemoteStationManager::GetControlAnswerMode(), ns3::WifiRemoteStationManager::GetCtsToSelfTxVector(), ns3::WifiRemoteStationManager::GetCtsTxVector(), ns3::DsssPhy::GetDataRateFromTxVector(), ns3::WifiRemoteStationManager::GetDataTxVector(), ns3::MinstrelWifiManager::GetDataTxVector(), ns3::ErpOfdmPhy::GetHeaderMode(), ns3::TableBasedErrorRateModel::GetMcsForMode(), ns3::ThompsonSamplingWifiManager::GetModeGuardInterval(), ns3::WifiTxVector::GetModulationClass(), ns3::WifiPhyHelper::GetRadiotapHeader(), ns3::WifiRemoteStationManager::GetRtsTxVector(), ns3::MinstrelWifiManager::GetRtsTxVector(), ns3::WifiPhy::GetTxBandwidth(), ns3::ThompsonSamplingWifiManager::InitializeStation(), IsHigherDataRate(), ns3::WifiRemoteStationManager::NeedCtsToSelf(), ns3::MinstrelHtWifiManager::RateInit(), Bug2843TestCase::StoreDistinctTuple(), and Issue169TestCase::TxCallback().

Here is the call graph for this function:

Here is the caller graph for this function:

GetNonHtReferenceRate()

uint64_t ns3::WifiMode::GetNonHtReferenceRate

(

)

const

Returns

the rate (in bps) of the non-HT Reference Rate which corresponds to the HT MCS of this WifiMode.

To convert an HT MCS to is corresponding non-HT Reference Rate use the modulation and coding rate of the HT MCS and lookup in Table 9-5 of IEEE 802.11-2012.

Definition at line 192 of file wifi-mode.cc.

References ns3::WifiModeFactory::Get(), ns3::WifiModeFactory::GetFactory(), ns3::WifiModeFactory::WifiModeItem::GetNonHtReferenceRateCallback, ns3::Callback< R, UArgs >::IsNull(), m_uid, and NS_ASSERT_MSG.

Referenced by ns3::MinstrelHtWifiManager::DoGetRtsTxVector().

Here is the call graph for this function:

Here is the caller graph for this function:

GetPhyRate() [1/3]

uint64_t ns3::WifiMode::GetPhyRate	(	const WifiTxVector &	txVector,
		uint16_t	staId = SU_STA_ID
	)		const

Parameters

txVector	the const WifiTxVector& of the signal
staId	the station ID for MU (unused if SU)

Returns

the physical bit rate of this signal in bps.

If a transmission mode uses 1/2 FEC, and if its data rate is 3.25Mbps, the PHY rate is 6.5Mbps

Definition at line 102 of file wifi-mode.cc.

References ns3::WifiModeFactory::Get(), ns3::WifiModeFactory::GetFactory(), ns3::WifiModeFactory::WifiModeItem::GetPhyRateCallback, and m_uid.

Here is the call graph for this function:

GetPhyRate() [2/3]

uint64_t ns3::WifiMode::GetPhyRate

(

uint16_t

channelWidth

)

const

Parameters

channelWidth

the considered channel width in MHz

Returns

the physical bit rate of this non-HT signal.

Definition at line 85 of file wifi-mode.cc.

References GetPhyRate().

Here is the call graph for this function:

GetPhyRate() [3/3]

uint64_t ns3::WifiMode::GetPhyRate	(	uint16_t	channelWidth,
		uint16_t	guardInterval,
		uint8_t	nss
	)		const

Parameters

channelWidth	the considered channel width in MHz
guardInterval	the considered guard interval duration in nanoseconds
nss	the considered number of streams

Returns

the physical bit rate of this signal in bps.

If a transmission mode uses 1/2 FEC, and if its data rate is 3.25Mbps, the PHY rate is 6.5Mbps

Definition at line 91 of file wifi-mode.cc.

References WifiMode(), m_uid, ns3::WifiTxVector::SetChannelWidth(), ns3::WifiTxVector::SetGuardInterval(), ns3::WifiTxVector::SetMode(), and ns3::WifiTxVector::SetNss().

Referenced by ns3::YansErrorRateModel::DoGetChunkSuccessRate(), and GetPhyRate().

Here is the call graph for this function:

Here is the caller graph for this function:

GetUid()

uint32_t ns3::WifiMode::GetUid

(

)

const

Returns

the UID associated to this wireless mode.

Each specific wireless mode should have a different UID. For example, the 802.11b 1Mbps and the 802.11b 2Mbps modes should have different UIDs.

Definition at line 179 of file wifi-mode.cc.

References m_uid.

Referenced by ns3::operator!=(), ns3::operator<(), and ns3::operator==().

Here is the caller graph for this function:

GetUniqueName()

std::string ns3::WifiMode::GetUniqueName

(

)

const

Returns

a human-readable representation of this WifiMode instance.

Definition at line 148 of file wifi-mode.cc.

References ns3::WifiModeFactory::Get(), ns3::WifiModeFactory::GetFactory(), m_uid, and ns3::WifiModeFactory::WifiModeItem::uniqueUid.

Referenced by ns3::IdealWifiManager::AddSnrThreshold(), ns3::IdealWifiManager::BuildSnrThresholds(), ns3::IdealWifiManager::DoGetDataTxVector(), ns3::IdealWifiManager::DoReportDataOk(), ns3::ThompsonSamplingWifiManager::DoReportDataOk(), ns3::IdealWifiManager::DoReportRtsOk(), ns3::ThompsonSamplingWifiManager::DoReportRtsOk(), ns3::DsssPhy::GetDataRateFromTxVector(), ns3::ErpOfdmPhy::GetDataRateFromTxVector(), ns3::OfdmPhy::GetDataRateFromTxVector(), ns3::ErpOfdmPhy::GetPhyRateFromTxVector(), ns3::OfdmPhy::GetPhyRateFromTxVector(), ns3::ApWifiMac::GetSupportedRates(), ns3::WifiTxVector::IsValid(), and ns3::operator<<().

Here is the call graph for this function:

Here is the caller graph for this function:

IsAllowed() [1/2]

bool ns3::WifiMode::IsAllowed

(

const WifiTxVector &

txVector

)

const

Returns

true if this TXVECTOR combination is allowed, false otherwise.

Parameters

txVector

the const WifiTxVector& of the signal

Definition at line 78 of file wifi-mode.cc.

References ns3::WifiModeFactory::Get(), ns3::WifiModeFactory::GetFactory(), ns3::WifiModeFactory::WifiModeItem::IsAllowedCallback, and m_uid.

Here is the call graph for this function:

IsAllowed() [2/2]

bool ns3::WifiMode::IsAllowed	(	uint16_t	channelWidth,
		uint8_t	nss
	)		const

Returns

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

Parameters

channelWidth	the considered channel width in MHz
nss	the considered number of streams

Definition at line 68 of file wifi-mode.cc.

References WifiMode(), m_uid, ns3::WifiTxVector::SetChannelWidth(), ns3::WifiTxVector::SetMode(), and ns3::WifiTxVector::SetNss().

Referenced by ns3::IdealWifiManager::BuildSnrThresholds().

Here is the call graph for this function:

Here is the caller graph for this function:

IsHigherCodeRate()

bool ns3::WifiMode::IsHigherCodeRate

(

WifiMode

mode

)

const

Parameters

mode	the WifiMode

Returns

true if this WifiMode has a a code rate strictly higher than mode.

Definition at line 201 of file wifi-mode.cc.

References GetCodeRate(), NS_ASSERT_MSG, and ns3::WIFI_CODE_RATE_UNDEFINED.

Referenced by IsHigherDataRate().

Here is the call graph for this function:

Here is the caller graph for this function:

IsHigherDataRate()

bool ns3::WifiMode::IsHigherDataRate

(

WifiMode

mode

)

const

Parameters

mode	the WifiMode

Returns

true if this WifiMode has a a rate strictly higher than mode.

Definition at line 208 of file wifi-mode.cc.

References GetCodeRate(), GetConstellationSize(), GetModulationClass(), IsHigherCodeRate(), ns3::WIFI_CODE_RATE_UNDEFINED, ns3::WIFI_MOD_CLASS_DSSS, and ns3::WIFI_MOD_CLASS_HR_DSSS.

Referenced by ns3::WifiRemoteStationManager::GetControlAnswerMode().

Here is the call graph for this function:

Here is the caller graph for this function:

IsMandatory()

bool ns3::WifiMode::IsMandatory

(

)

const

Returns

true if this mode is a mandatory mode, false otherwise.

Definition at line 156 of file wifi-mode.cc.

References ns3::WifiModeFactory::Get(), ns3::WifiModeFactory::GetFactory(), ns3::WifiModeFactory::WifiModeItem::isMandatory, and m_uid.

Here is the call graph for this function:

Friends And Related Function Documentation

WifiModeFactory

friend class WifiModeFactory

friend

allow WifiModeFactory class access

Definition at line 192 of file wifi-mode.h.

Member Data Documentation

m_uid

uint32_t ns3::WifiMode::m_uid

private

UID.

Definition at line 199 of file wifi-mode.h.

Referenced by GetCodeRate(), GetConstellationSize(), GetDataRate(), GetMcsValue(), GetModulationClass(), GetNonHtReferenceRate(), GetPhyRate(), GetUid(), GetUniqueName(), IsAllowed(), and IsMandatory().

---

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

• src/wifi/model/wifi-mode.h
• src/wifi/model/wifi-mode.cc