Wifi Phy Threshold Test base class. More...

Inheritance diagram for WifiPhyThresholdsTest:

Collaboration diagram for WifiPhyThresholdsTest:

Public Member Functions
	WifiPhyThresholdsTest (std::string test_name)
	Constructor.

Public Member Functions inherited from ns3::TestCase
	TestCase (const TestCase &)=delete

virtual	~TestCase ()
	Destructor.

std::string	GetName () const

TestCase &	operator= (const TestCase &)=delete

Protected Member Functions
virtual Ptr< SpectrumSignalParameters >	MakeForeignSignal (Watt_u txPower)
	Make foreign signal function.

virtual Ptr< SpectrumSignalParameters >	MakeWifiSignal (Watt_u txPower, const WifiPhyOperatingChannel &channel)
	Make wifi signal function.

virtual void	PhyStateChanged (Time start, Time duration, WifiPhyState newState)
	PHY state changed callback function.

void	RxDropped (Ptr< const Packet > p, WifiPhyRxfailureReason reason)
	PHY dropped packet callback function.

virtual void	RxFailure (Ptr< const WifiPsdu > psdu)
	PHY receive failure callback function.

virtual void	RxSuccess (Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &statusPerMpdu)
	PHY receive success callback function.

virtual void	SendSignal (Watt_u txPower, bool wifiSignal)
	Send signal function.

Protected Member Functions inherited from ns3::TestCase
	TestCase (std::string name)
	Constructor.

void	AddTestCase (TestCase *testCase, Duration duration=Duration::QUICK)
	Add an individual child TestCase to this test suite.

TestCase *	GetParent () const
	Get the parent of this TestCase.

bool	IsStatusFailure () const
	Check if any tests failed.

bool	IsStatusSuccess () const
	Check if all tests passed.

void	SetDataDir (std::string directory)
	Set the data directory where reference trace files can be found.

void	ReportTestFailure (std::string cond, std::string actual, std::string limit, std::string message, std::string file, int32_t line)
	Log the failure of this TestCase.

bool	MustAssertOnFailure () const
	Check if this run should assert on failure.

bool	MustContinueOnFailure () const
	Check if this run should continue on failure.

std::string	CreateDataDirFilename (std::string filename)
	Construct the full path to a file in the data directory.

std::string	CreateTempDirFilename (std::string filename)
	Construct the full path to a file in a temporary directory.

Protected Attributes
uint32_t	m_ccabusyStateCount
	count number of PHY state change to CCA_BUSY state

uint32_t	m_idleStateCount
	count number of PHY state change to IDLE state

Ptr< SpectrumWifiPhy >	m_phy
	PHY object.

uint32_t	m_rxDropped
	count number of dropped packets

uint32_t	m_rxFailure
	count number of unsuccessfully received packets

uint32_t	m_rxStateCount
	count number of PHY state change to RX state

uint32_t	m_rxSuccess
	count number of successfully received packets

uint32_t	m_stateChanged
	count number of PHY state change

Private Member Functions
void	DoSetup () override
	Implementation to do any local setup required for this TestCase.

void	DoTeardown () override
	Implementation to do any local setup required for this TestCase.

Additional Inherited Members
Public Types inherited from ns3::TestCase
enum class	Duration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 }
	How long the test takes to execute. More...

Detailed Description

Wifi Phy Threshold Test base class.

Definition at line 41 of file wifi-phy-thresholds-test.cc.

Constructor & Destructor Documentation

◆ WifiPhyThresholdsTest()

WifiPhyThresholdsTest::WifiPhyThresholdsTest ( std::string test_name )

Constructor.

Parameters

test_name the test name

Definition at line 116 of file wifi-phy-thresholds-test.cc.

References ns3::TestCase::TestCase(), m_ccabusyStateCount, m_idleStateCount, m_rxDropped, m_rxFailure, m_rxStateCount, m_rxSuccess, and m_stateChanged.

Referenced by WifiPhyThresholdsStrongForeignSignalTest::WifiPhyThresholdsStrongForeignSignalTest(), WifiPhyThresholdsStrongWifiSignalTest::WifiPhyThresholdsStrongWifiSignalTest(), WifiPhyThresholdsWeakForeignSignalTest::WifiPhyThresholdsWeakForeignSignalTest(), and WifiPhyThresholdsWeakWifiSignalTest::WifiPhyThresholdsWeakWifiSignalTest().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Function Documentation

◆ DoSetup()

void WifiPhyThresholdsTest::DoSetup ( )

overrideprivatevirtual

Implementation to do any local setup required for this TestCase.

Subclasses should override this method to perform any costly per-test setup before DoRun is invoked.

Reimplemented from ns3::TestCase.

Definition at line 238 of file wifi-phy-thresholds-test.cc.

References CHANNEL_NUMBER, ns3::CreateObject(), m_phy, ns3::MakeCallback(), PhyStateChanged(), RxDropped(), RxFailure(), RxSuccess(), ns3::WIFI_PHY_BAND_5GHZ, and ns3::WIFI_STANDARD_80211ax.

Here is the call graph for this function:

◆ DoTeardown()

void WifiPhyThresholdsTest::DoTeardown ( )

overrideprivatevirtual

Implementation to do any local setup required for this TestCase.

Subclasses should override this method to perform any costly per-test teardown

Reimplemented from ns3::TestCase.

Definition at line 264 of file wifi-phy-thresholds-test.cc.

References m_phy.

◆ MakeForeignSignal()

Ptr< SpectrumSignalParameters > WifiPhyThresholdsTest::MakeForeignSignal ( Watt_u txPower )

protectedvirtual

Make foreign signal function.

Parameters

txPower the transmit power

Returns: Ptr<SpectrumSignalParameters>

Definition at line 167 of file wifi-phy-thresholds-test.cc.

References CHANNEL_WIDTH, ns3::Create(), ns3::WifiSpectrumValueHelper::CreateHeOfdmTxPowerSpectralDensity(), FREQUENCY, and ns3::Seconds().

Referenced by SendSignal().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MakeWifiSignal()

Ptr< SpectrumSignalParameters > WifiPhyThresholdsTest::MakeWifiSignal	(	Watt_u	txPower,
		const WifiPhyOperatingChannel &	channel )

protectedvirtual

Make wifi signal function.

Parameters

txPower	the transmit power
channel	the operating channel of the PHY used for the transmission

Returns: Ptr<SpectrumSignalParameters>

Definition at line 129 of file wifi-phy-thresholds-test.cc.

References ns3::WifiPhy::CalculateTxDuration(), CHANNEL_WIDTH, ns3::Create(), ns3::WifiSpectrumValueHelper::CreateHeOfdmTxPowerSpectralDensity(), ns3::OfdmPhy::GetOfdmRate6Mbps(), m_phy, ns3::NanoSeconds(), ns3::WifiMacHeader::SetQosTid(), ns3::WifiMacHeader::SetType(), ns3::WIFI_MAC_QOSDATA, and ns3::WIFI_PREAMBLE_LONG.

Referenced by SendSignal().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ PhyStateChanged()

void WifiPhyThresholdsTest::PhyStateChanged	(	Time	start,
		Time	duration,
		WifiPhyState	newState )

protectedvirtual

PHY state changed callback function.

Parameters

start	the start time of the new state
duration	the duration of the new state
newState	the new state

Definition at line 219 of file wifi-phy-thresholds-test.cc.

References ns3::CCA_BUSY, ns3::IDLE, m_ccabusyStateCount, m_idleStateCount, m_rxStateCount, m_stateChanged, NS_LOG_FUNCTION, and ns3::RX.

Referenced by DoSetup().

Here is the caller graph for this function:

◆ RxDropped()

void WifiPhyThresholdsTest::RxDropped	(	Ptr< const Packet >	p,
		WifiPhyRxfailureReason	reason )

protected

PHY dropped packet callback function.

Parameters

p	the packet
reason	the reason

Definition at line 212 of file wifi-phy-thresholds-test.cc.

References m_rxDropped, and NS_LOG_FUNCTION.

Referenced by DoSetup().

Here is the caller graph for this function:

◆ RxFailure()

void WifiPhyThresholdsTest::RxFailure ( Ptr< const WifiPsdu > psdu )

protectedvirtual

PHY receive failure callback function.

Parameters

psdu the PSDU

Definition at line 205 of file wifi-phy-thresholds-test.cc.

References m_rxFailure, and NS_LOG_FUNCTION.

Referenced by DoSetup().

Here is the caller graph for this function:

◆ RxSuccess()

void WifiPhyThresholdsTest::RxSuccess	(	Ptr< const WifiPsdu >	psdu,
		RxSignalInfo	rxSignalInfo,
		const WifiTxVector &	txVector,
		const std::vector< bool > &	statusPerMpdu )