Test 80+80MHz transmission. More...

Inheritance diagram for SpectrumWifiPhy80Plus80Test:

Collaboration diagram for SpectrumWifiPhy80Plus80Test:

Public Member Functions
	SpectrumWifiPhy80Plus80Test ()

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

virtual	~TestCase ()
	Destructor.

std::string	GetName () const

TestCase &	operator= (const TestCase &)=delete

Private Member Functions
void	CheckResults (bool expectSuccess)
	Verify results.

void	DoRun () override
	Implementation to actually run this TestCase.

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.

void	GenerateInterference (Ptr< SpectrumValue > interferencePsd, Time duration)
	Generate interference function.

void	RunOne (const std::vector< uint8_t > &channelNumbers, MHz_u interferenceCenterFrequency, MHz_u interferenceBandWidth, bool expectSuccess)
	Run one function.

void	RxFailureSta (Ptr< const WifiPsdu > psdu)
	Receive failure function for STA.

void	RxSuccessSta (Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, WifiTxVector txVector, std::vector< bool > statusPerMpdu)
	Receive success function for STA.

void	Send160MhzPpdu ()
	Send 160MHz PPDU function.

void	StopInterference ()
	Stop interference function.

void	SwitchChannel (const std::vector< uint8_t > &channelNumbers)
	Switch channel function.

Private Attributes
uint32_t	m_countRxFailureSta
	count RX failure for STA

uint32_t	m_countRxSuccessSta
	count RX success for STA

Ptr< SpectrumWifiPhy >	m_phyAp
	PHY of AP.

Ptr< WaveformGenerator >	m_phyInterferer
	PHY of interferer.

Ptr< SpectrumWifiPhy >	m_phySta
	PHY of STA.

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...

Static Public Attributes inherited from ns3::TestCase
static constexpr auto	QUICK = Duration::QUICK
	Deprecated test duration simple enums.

static constexpr auto	EXTENSIVE = Duration::EXTENSIVE

static constexpr auto	TAKES_FOREVER = Duration::TAKES_FOREVER

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.

Detailed Description

Test 80+80MHz transmission.

The test verifies that two non-contiguous segments are handled by the spectrum PHY to transmit 160 MHz PPDUs when the operating channel is configured as 80+80MHz.

The test first considers a contiguous 160 MHz segment and generate interference on the second 80 MHz band to verify reception fails in this scenario. Then, a similar interference is generated when a 80+80MHz operating channel is configured, where the first frequency segment occupies the first 80 MHz band of the previous 160 MHz operating channel. The reception should succeed in that scenario, which demonstrates the second 80 MHz band of the operating channel is no longer occupying that spectrum portion (the interference is hence is the gap between the two frequency segments). Finally, the test also generates interference on each of the frequency segments when the operating channel is 80+80MHz, to demonstrate the frequency segments are positioned as expected.

Definition at line 1229 of file spectrum-wifi-phy-test.cc.

Constructor & Destructor Documentation

◆ SpectrumWifiPhy80Plus80Test()

SpectrumWifiPhy80Plus80Test::SpectrumWifiPhy80Plus80Test ( )

Definition at line 1310 of file spectrum-wifi-phy-test.cc.

Member Function Documentation

◆ CheckResults()

void SpectrumWifiPhy80Plus80Test::CheckResults ( bool expectSuccess )

private

Verify results.

Parameters

expectSuccess flag to indicate whether reception is expected to be successful

Definition at line 1393 of file spectrum-wifi-phy-test.cc.

References m_countRxFailureSta, m_countRxSuccessSta, NS_LOG_FUNCTION, and NS_TEST_ASSERT_MSG_EQ.

Referenced by RunOne().

Here is the caller graph for this function:

◆ DoRun()

void SpectrumWifiPhy80Plus80Test::DoRun ( )

overrideprivatevirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Implements ns3::TestCase.

Definition at line 1510 of file spectrum-wifi-phy-test.cc.

References ns3::Simulator::Destroy(), and RunOne().

Here is the call graph for this function:

◆ DoSetup()

void SpectrumWifiPhy80Plus80Test::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 1403 of file spectrum-wifi-phy-test.cc.

References ns3::CreateObject(), m_phyAp, m_phyInterferer, m_phySta, ns3::MakeCallback(), RxFailureSta(), RxSuccessSta(), and ns3::WIFI_STANDARD_80211ax.

Here is the call graph for this function:

◆ DoTeardown()

void SpectrumWifiPhy80Plus80Test::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 1459 of file spectrum-wifi-phy-test.cc.

References m_phyAp, m_phyInterferer, and m_phySta.

◆ GenerateInterference()

void SpectrumWifiPhy80Plus80Test::GenerateInterference	(	Ptr< SpectrumValue >	interferencePsd,
		Time	duration )

private

Generate interference function.

Parameters

interferencePsd	the PSD of the interference to be generated
duration	the duration of the interference

Definition at line 1361 of file spectrum-wifi-phy-test.cc.

References m_phyInterferer, ns3::Simulator::Schedule(), and StopInterference().

Referenced by RunOne().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RunOne()

void SpectrumWifiPhy80Plus80Test::RunOne	(	const std::vector< uint8_t > &	channelNumbers,
		MHz_u	interferenceCenterFrequency,
		MHz_u	interferenceBandWidth,
		bool	expectSuccess )

private

Run one function.

Parameters

channelNumbers	the channel number for each segment of the operating channel
interferenceCenterFrequency	the center frequency of the interference signal to generate
interferenceBandWidth	the band width of the interference signal to generate
expectSuccess	flag to indicate whether reception is expected to be successful

Definition at line 1470 of file spectrum-wifi-phy-test.cc.

References CheckResults(), ns3::Create(), ns3::BandInfo::fl, GenerateInterference(), m_countRxFailureSta, m_countRxSuccessSta, ns3::MilliSeconds(), ns3::Simulator::Run(), ns3::Simulator::Schedule(), ns3::Seconds(), Send160MhzPpdu(), and SwitchChannel().

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RxFailureSta()

void SpectrumWifiPhy80Plus80Test::RxFailureSta ( Ptr< const WifiPsdu > psdu )

private

Receive failure function for STA.

Parameters

psdu the PSDU

Definition at line 1386 of file spectrum-wifi-phy-test.cc.

References m_countRxFailureSta, and NS_LOG_FUNCTION.

Referenced by DoSetup().

Here is the caller graph for this function:

◆ RxSuccessSta()

void SpectrumWifiPhy80Plus80Test::RxSuccessSta	(	Ptr< const WifiPsdu >	psdu,
		RxSignalInfo	rxSignalInfo,
		WifiTxVector	txVector,
		std::vector< bool >	statusPerMpdu )