non-HT duplicate PHY reception test The test consists in an AP sending a single non-HT duplicate PPDU of a given channel width (multiple of 20 MHz) over a spectrum channel and it checks whether the STAs attached to the channel receive the PPDU. More...

Inheritance diagram for TestNonHtDuplicatePhyReception:

Collaboration diagram for TestNonHtDuplicatePhyReception:

Public Types
using	StasParams = std::vector< std::tuple< WifiStandard, uint16_t, uint8_t > >
	A vector containing parameters per STA: the standard, the center frequency and the P20 index.

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

using	instead = Duration

Public Member Functions
	TestNonHtDuplicatePhyReception (WifiStandard apStandard, uint16_t apFrequency, uint8_t apP20Index, StasParams stasParams, std::vector< bool > per20MhzInterference={})
	Constructor.

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 (std::size_t index, uint32_t expectedRxSuccess, uint32_t expectedRxFailure)
	Check the 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< WaveformGenerator > interferer, Ptr< SpectrumValue > interferencePsd, Time duration)
	Generate interference function.

void	ResetResults ()
	Reset the results.

void	RxFailure (std::size_t index, Ptr< const WifiPsdu > psdu)
	Receive failure function.

void	RxSuccess (std::size_t index, Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, WifiTxVector txVector, std::vector< bool > statusPerMpdu)
	Receive success function.

void	SendNonHtDuplicatePpdu (uint16_t channelWidth)
	Send non-HT duplicate PPDU function.

void	StopInterference (Ptr< WaveformGenerator > interferer)
	Stop interference function.

Private Attributes
uint16_t	m_apFrequency
	the center frequency of the AP (in MHz)

uint8_t	m_apP20Index
	the index of the primary 20 MHz channel of the AP

WifiStandard	m_apStandard
	the standard to use for the AP

std::vector< uint32_t >	m_countRxFailureStas
	count RX failure for STAs

std::vector< uint32_t >	m_countRxSuccessStas
	count RX success for STAs

std::vector< bool >	m_per20MhzInterference
	flags per 20 MHz subchannel whether an interference should be generated on that subchannel

Ptr< SpectrumWifiPhy >	m_phyAp
	PHY of AP.

std::vector< Ptr< WaveformGenerator > >	m_phyInterferers
	PHYs of interferers (1 interferer per 20 MHz subchannel)

std::vector< Ptr< SpectrumWifiPhy > >	m_phyStas
	PHYs of STAs.

StasParams	m_stasParams
	the parameters of the STAs

Additional Inherited Members
Static Public Attributes inherited from ns3::TestCase
static constexpr auto	EXTENSIVE = Duration::EXTENSIVE

static constexpr auto	QUICK = Duration::QUICK

static constexpr auto	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

non-HT duplicate PHY reception test The test consists in an AP sending a single non-HT duplicate PPDU of a given channel width (multiple of 20 MHz) over a spectrum channel and it checks whether the STAs attached to the channel receive the PPDU.

If an interference is injected on a given 20 MHz subchannel, the payload reception should fail, otherwise it should succeed.

Definition at line 201 of file wifi-non-ht-dup-test.cc.

Member Typedef Documentation

◆ StasParams

using TestNonHtDuplicatePhyReception::StasParams = std::vector<std::tuple<WifiStandard, uint16_t, uint8_t> >

A vector containing parameters per STA: the standard, the center frequency and the P20 index.

Definition at line 205 of file wifi-non-ht-dup-test.cc.

Constructor & Destructor Documentation

◆ TestNonHtDuplicatePhyReception()

TestNonHtDuplicatePhyReception::TestNonHtDuplicatePhyReception	(	WifiStandard	apStandard,
		uint16_t	apFrequency,
		uint8_t	apP20Index,
		StasParams	stasParams,
		std::vector< bool >	per20MhzInterference = `{}`
	)

Constructor.

Parameters

apStandard	the standard to use for the AP
apFrequency	the center frequency of the AP (in MHz)
apP20Index	the index of the primary 20 MHz channel of the AP
stasParams	the parameters of the STAs (

See also: StasParams)

Parameters

per20MhzInterference flags per 20 MHz subchannel whether an interference should be generated on that subchannel. An empty vector means that the test will not generate any interference.

Definition at line 301 of file wifi-non-ht-dup-test.cc.

Member Function Documentation

◆ CheckResults()

void TestNonHtDuplicatePhyReception::CheckResults	(	std::size_t	index,
		uint32_t	expectedRxSuccess,
		uint32_t	expectedRxFailure
	)

private

Check the results.

Parameters

index	index of the RX STA
expectedRxSuccess	the expected number of RX success
expectedRxFailure	the expected number of RX failures

Definition at line 405 of file wifi-non-ht-dup-test.cc.

References m_countRxFailureStas, m_countRxSuccessStas, NS_LOG_FUNCTION, and NS_TEST_ASSERT_MSG_EQ.

Referenced by DoRun().

Here is the caller graph for this function:

◆ DoRun()

void TestNonHtDuplicatePhyReception::DoRun ( )

overrideprivatevirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Implements ns3::TestCase.

Definition at line 513 of file wifi-non-ht-dup-test.cc.

References ns3::WifiPhy::AssignStreams(), CheckResults(), ns3::Simulator::Destroy(), ns3::BandInfo::fc, ns3::BandInfo::fh, ns3::WifiPhyOperatingChannel::FindFirst(), ns3::BandInfo::fl, GenerateInterference(), ns3::WifiPhy::GetChannelWidth(), ns3::WifiPhy::GetFrequency(), ns3::WifiPhy::GetOperatingChannel(), ns3::WifiPhyOperatingChannel::GetPrimaryChannelCenterFrequency(), m_apFrequency, m_apP20Index, m_apStandard, m_per20MhzInterference, m_phyAp, m_phyInterferers, m_phyStas, m_stasParams, ResetResults(), ns3::Simulator::Run(), ns3::Simulator::Schedule(), ns3::Seconds(), SendNonHtDuplicatePpdu(), ns3::WifiPhy::SetOperatingChannel(), ns3::RngSeedManager::SetRun(), ns3::RngSeedManager::SetSeed(), and ns3::WIFI_PHY_BAND_5GHZ.

Here is the call graph for this function:

◆ DoSetup()

void TestNonHtDuplicatePhyReception::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 421 of file wifi-non-ht-dup-test.cc.

References ns3::SpectrumWifiPhy::AddChannel(), ns3::WifiPhy::ConfigureStandard(), ns3::WifiPhyOperatingChannel::FindFirst(), m_apFrequency, m_apStandard, m_countRxFailureStas, m_countRxSuccessStas, m_per20MhzInterference, m_phyAp, m_phyInterferers, m_phyStas, m_stasParams, ns3::MakeCallback(), NS_ASSERT, RxFailure(), RxSuccess(), ns3::SpectrumWifiPhy::SetDevice(), ns3::WifiPhy::SetErrorRateModel(), ns3::WifiPhy::SetInterferenceHelper(), ns3::WifiPhy::SetMobility(), ns3::WIFI_PHY_BAND_5GHZ, and ns3::WIFI_STANDARD_80211ax.

Here is the call graph for this function:

◆ DoTeardown()

void TestNonHtDuplicatePhyReception::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 496 of file wifi-non-ht-dup-test.cc.

References ns3::Object::Dispose(), m_phyAp, m_phyInterferers, and m_phyStas.

Here is the call graph for this function:

◆ GenerateInterference()

void TestNonHtDuplicatePhyReception::GenerateInterference	(	Ptr< WaveformGenerator >	interferer,
		Ptr< SpectrumValue >	interferencePsd,
		Time	duration
	)

private

Generate interference function.

Parameters

interferer	the PHY of the interferer to use to generate the signal
interferencePsd	the PSD of the interference to be generated
duration	the duration of the interference

Definition at line 360 of file wifi-non-ht-dup-test.cc.

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

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ResetResults()

void TestNonHtDuplicatePhyReception::ResetResults ( )

private

Reset the results.

Definition at line 320 of file wifi-non-ht-dup-test.cc.

References m_countRxFailureStas, and m_countRxSuccessStas.

Referenced by DoRun().

Here is the caller graph for this function:

◆ RxFailure()

void TestNonHtDuplicatePhyReception::RxFailure	(	std::size_t	index,
		Ptr< const WifiPsdu >	psdu
	)

private

Receive failure function.

Parameters

index	index of the RX STA
psdu	the PSDU

Definition at line 398 of file wifi-non-ht-dup-test.cc.

References m_countRxFailureStas, and NS_LOG_FUNCTION.

Referenced by DoSetup().

Here is the caller graph for this function:

◆ RxSuccess()

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

private

Receive success function.

Parameters

index	index of the RX STA
psdu	the PSDU
rxSignalInfo	the info on the received signal (

See also: RxSignalInfo)

Parameters

txVector	the transmit vector
statusPerMpdu	reception status per MPDU

Definition at line 382 of file wifi-non-ht-dup-test.cc.

References ns3::WifiPhy::GetChannelWidth(), ns3::WifiTxVector::GetChannelWidth(), m_countRxSuccessStas, m_phyAp, m_phyStas, NS_LOG_FUNCTION, and NS_TEST_ASSERT_MSG_EQ.

Referenced by DoSetup().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SendNonHtDuplicatePpdu()

void TestNonHtDuplicatePhyReception::SendNonHtDuplicatePpdu ( uint16_t channelWidth )

private

Send non-HT duplicate PPDU function.

Parameters

channelWidth the channel width to use to transmit the non-HT PPDU (in MHz)

Definition at line 333 of file wifi-non-ht-dup-test.cc.

References ns3::WifiPhy::CalculateTxDuration(), ns3::OfdmPhy::GetOfdmRate24Mbps(), ns3::WifiPhy::GetPhyBand(), m_phyAp, NS_LOG_FUNCTION, ns3::WifiPhy::Send(), ns3::WifiMacHeader::SetQosTid(), ns3::WifiMacHeader::SetType(), ns3::SU_STA_ID, ns3::WIFI_MAC_QOSDATA, and ns3::WIFI_PREAMBLE_LONG.

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ StopInterference()

void TestNonHtDuplicatePhyReception::StopInterference ( Ptr< WaveformGenerator > interferer )

private

Stop interference function.

Parameters

interferer the PHY of the interferer that was used to generate the signal

Definition at line 375 of file wifi-non-ht-dup-test.cc.

References NS_LOG_FUNCTION.

Referenced by GenerateInterference().

Here is the caller graph for this function:

Member Data Documentation

◆ m_apFrequency

uint16_t TestNonHtDuplicatePhyReception::m_apFrequency

private

the center frequency of the AP (in MHz)

Definition at line 284 of file wifi-non-ht-dup-test.cc.

Referenced by DoRun(), and DoSetup().

◆ m_apP20Index

uint8_t TestNonHtDuplicatePhyReception::m_apP20Index

private

the index of the primary 20 MHz channel of the AP

Definition at line 285 of file wifi-non-ht-dup-test.cc.

Referenced by DoRun().

◆ m_apStandard

WifiStandard TestNonHtDuplicatePhyReception::m_apStandard

private

the standard to use for the AP

Definition at line 283 of file wifi-non-ht-dup-test.cc.

Referenced by DoRun(), and DoSetup().

◆ m_countRxFailureStas

std::vector<uint32_t> TestNonHtDuplicatePhyReception::m_countRxFailureStas

private

count RX failure for STAs

Definition at line 292 of file wifi-non-ht-dup-test.cc.

Referenced by CheckResults(), DoSetup(), ResetResults(), and RxFailure().

◆ m_countRxSuccessStas

std::vector<uint32_t> TestNonHtDuplicatePhyReception::m_countRxSuccessStas

private

count RX success for STAs

Definition at line 291 of file wifi-non-ht-dup-test.cc.

Referenced by CheckResults(), DoSetup(), ResetResults(), and RxSuccess().

◆ m_per20MhzInterference

std::vector<bool> TestNonHtDuplicatePhyReception::m_per20MhzInterference

private

flags per 20 MHz subchannel whether an interference should be generated on that subchannel

Definition at line 288 of file wifi-non-ht-dup-test.cc.

Referenced by DoRun(), and DoSetup().

◆ m_phyAp

Ptr<SpectrumWifiPhy> TestNonHtDuplicatePhyReception::m_phyAp

private

PHY of AP.

Definition at line 294 of file wifi-non-ht-dup-test.cc.

Referenced by DoRun(), DoSetup(), DoTeardown(), RxSuccess(), and SendNonHtDuplicatePpdu().

◆ m_phyInterferers

std::vector<Ptr<WaveformGenerator> > TestNonHtDuplicatePhyReception::m_phyInterferers

private

PHYs of interferers (1 interferer per 20 MHz subchannel)

Definition at line 298 of file wifi-non-ht-dup-test.cc.

Referenced by DoRun(), DoSetup(), and DoTeardown().

◆ m_phyStas

std::vector<Ptr<SpectrumWifiPhy> > TestNonHtDuplicatePhyReception::m_phyStas

private

PHYs of STAs.

Definition at line 295 of file wifi-non-ht-dup-test.cc.

Referenced by DoRun(), DoSetup(), DoTeardown(), and RxSuccess().

◆ m_stasParams

StasParams TestNonHtDuplicatePhyReception::m_stasParams

private

the parameters of the STAs

Definition at line 286 of file wifi-non-ht-dup-test.cc.

Referenced by DoRun(), and DoSetup().

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

src/wifi/test/wifi-non-ht-dup-test.cc

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ StasParams

Constructor & Destructor Documentation

◆ TestNonHtDuplicatePhyReception()

Member Function Documentation

◆ CheckResults()

◆ DoRun()

◆ DoSetup()

◆ DoTeardown()

◆ GenerateInterference()

◆ ResetResults()

◆ RxFailure()

◆ RxSuccess()

◆ SendNonHtDuplicatePpdu()

◆ StopInterference()

Member Data Documentation

◆ m_apFrequency

◆ m_apP20Index

◆ m_apStandard

◆ m_countRxFailureStas

◆ m_countRxSuccessStas

◆ m_per20MhzInterference

◆ m_phyAp

◆ m_phyInterferers

◆ m_phyStas

◆ m_stasParams