HE-SIG-B duration test. More...

Inheritance diagram for HeSigBDurationTest:

Collaboration diagram for HeSigBDurationTest:

Public Types
enum	MuType { OFDMA = 0 , MU_MIMO }
	OFDMA or MU-MIMO. More...

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

Public Member Functions
	HeSigBDurationTest (const std::list< HeMuUserInfo > &userInfos, const WifiMode &sigBMode, MHz_u channelWidth, uint8_t p20Index, MuType expectedMuType, const RuAllocation &expectedRuAllocation, const std::pair< std::size_t, std::size_t > &expectedNumUsersPerCc, Time expectedSigBDuration)
	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
WifiTxVector	BuildTxVector () const
	Build a TXVECTOR for HE MU.

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

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

Private Attributes
MHz_u	m_channelWidth
	Channel width.

MuType	m_expectedMuType
	Expected MU type (OFDMA or MU-MIMO)

std::pair< std::size_t, std::size_t >	m_expectedNumUsersPerCc
	Expected number of users per content channel.

RuAllocation	m_expectedRuAllocation
	Expected RuType::RU_ALLOCATION.

Time	m_expectedSigBDuration
	Expected duration of the HE-SIG-B header.

uint8_t	m_p20Index
	index of the primary20 channel

Ptr< YansWifiPhy >	m_phy
	the PHY under test

WifiMode	m_sigBMode
	Mode used to transmit HE-SIG-B.

std::list< HeMuUserInfo >	m_userInfos
	HE MU specific per-user information.

Additional Inherited Members
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

HE-SIG-B duration test.

Definition at line 1447 of file tx-duration-test.cc.

Member Enumeration Documentation

◆ MuType

enum HeSigBDurationTest::MuType

OFDMA or MU-MIMO.

Enumerator
OFDMA
MU_MIMO

Definition at line 1453 of file tx-duration-test.cc.

Constructor & Destructor Documentation

◆ HeSigBDurationTest()

HeSigBDurationTest::HeSigBDurationTest	(	const std::list< HeMuUserInfo > &	userInfos,
		const WifiMode &	sigBMode,
		MHz_u	channelWidth,
		uint8_t	p20Index,
		MuType	expectedMuType,
		const RuAllocation &	expectedRuAllocation,
		const std::pair< std::size_t, std::size_t > &	expectedNumUsersPerCc,
		Time	expectedSigBDuration )

Constructor.

Parameters

userInfos	the HE MU specific per-user information to use for the test
sigBMode	the mode to transmit HE-SIG-B for the test
channelWidth	the channel width to select for the test
p20Index	the index of the primary20 channel
expectedMuType	the expected MU type (OFDMA or MU-MIMO)
expectedRuAllocation	the expected RuType::RU_ALLOCATION
expectedNumUsersPerCc	the expected number of users per content channel
expectedSigBDuration	the expected duration of the HE-SIG-B header

Definition at line 1504 of file tx-duration-test.cc.

Member Function Documentation

◆ BuildTxVector()

WifiTxVector HeSigBDurationTest::BuildTxVector ( ) const

private

Build a TXVECTOR for HE MU.

Returns: the configured HE MU TXVECTOR

Definition at line 1526 of file tx-duration-test.cc.

References ns3::WifiTxVector::IsDlMuMimo(), ns3::WifiTxVector::IsDlOfdma(), m_channelWidth, m_expectedMuType, m_sigBMode, m_userInfos, ns3::NanoSeconds(), NS_ASSERT, OFDMA, ns3::WifiTxVector::SetChannelWidth(), ns3::WifiTxVector::SetGuardInterval(), ns3::WifiTxVector::SetHeMuUserInfo(), ns3::WifiTxVector::SetNess(), ns3::WifiTxVector::SetPreambleType(), ns3::WifiTxVector::SetSigBMode(), ns3::WifiTxVector::SetStbc(), and ns3::WIFI_PREAMBLE_HE_MU.

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DoRun()

void HeSigBDurationTest::DoRun ( )

overrideprivatevirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Implements ns3::TestCase.

Definition at line 1547 of file tx-duration-test.cc.

References BuildTxVector(), ns3::WifiPhy::CalculateTxDuration(), ns3::WifiPhy::ConfigureStandard(), ns3::Create(), ns3::CreateObject(), ns3::Simulator::Destroy(), ns3::WifiPhyOperatingChannel::FindFirst(), ns3::HePpdu::GetHeSigBContentChannels(), ns3::HePpdu::GetNumRusPerHeSigBContentChannel(), ns3::WifiPhy::GetPhyBand(), ns3::WifiPhy::GetPhyEntity(), m_expectedNumUsersPerCc, m_expectedRuAllocation, m_expectedSigBDuration, m_p20Index, m_phy, m_sigBMode, m_userInfos, NS_TEST_EXPECT_MSG_EQ, ns3::WifiPhy::SetOperatingChannel(), ns3::WIFI_MOD_CLASS_HE, ns3::WIFI_PHY_BAND_6GHZ, ns3::WIFI_PPDU_FIELD_SIG_B, and ns3::WIFI_STANDARD_80211ax.

Here is the call graph for this function:

◆ DoTeardown()

void HeSigBDurationTest::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 1622 of file tx-duration-test.cc.

References ns3::Object::Dispose(), and m_phy.

Here is the call graph for this function:

Member Data Documentation

◆ m_channelWidth

MHz_u HeSigBDurationTest::m_channelWidth

private

Channel width.

Definition at line 1495 of file tx-duration-test.cc.

Referenced by BuildTxVector().

◆ m_expectedMuType

MuType HeSigBDurationTest::m_expectedMuType

private

Expected MU type (OFDMA or MU-MIMO)

Definition at line 1497 of file tx-duration-test.cc.

Referenced by BuildTxVector().

◆ m_expectedNumUsersPerCc

std::pair<std::size_t, std::size_t> HeSigBDurationTest::m_expectedNumUsersPerCc

private

Expected number of users per content channel.

Definition at line 1500 of file tx-duration-test.cc.

Referenced by DoRun().

◆ m_expectedRuAllocation

RuAllocation HeSigBDurationTest::m_expectedRuAllocation

private

Expected RuType::RU_ALLOCATION.

Definition at line 1498 of file tx-duration-test.cc.

Referenced by DoRun().

◆ m_expectedSigBDuration

Time HeSigBDurationTest::m_expectedSigBDuration

private

Expected duration of the HE-SIG-B header.

Definition at line 1501 of file tx-duration-test.cc.

Referenced by DoRun().

◆ m_p20Index

uint8_t HeSigBDurationTest::m_p20Index

private

index of the primary20 channel

Definition at line 1496 of file tx-duration-test.cc.

Referenced by DoRun().

◆ m_phy

Ptr<YansWifiPhy> HeSigBDurationTest::m_phy

private

the PHY under test

Definition at line 1491 of file tx-duration-test.cc.

Referenced by DoRun(), and DoTeardown().

◆ m_sigBMode

WifiMode HeSigBDurationTest::m_sigBMode

private

Mode used to transmit HE-SIG-B.

Definition at line 1494 of file tx-duration-test.cc.

Referenced by BuildTxVector(), and DoRun().

◆ m_userInfos

std::list<HeMuUserInfo> HeSigBDurationTest::m_userInfos

private

HE MU specific per-user information.

Definition at line 1493 of file tx-duration-test.cc.

Referenced by BuildTxVector(), and DoRun().

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

src/wifi/test/tx-duration-test.cc

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ MuType

Constructor & Destructor Documentation

◆ HeSigBDurationTest()

Member Function Documentation

◆ BuildTxVector()

◆ DoRun()

◆ DoTeardown()

Member Data Documentation

◆ m_channelWidth

◆ m_expectedMuType

◆ m_expectedNumUsersPerCc

◆ m_expectedRuAllocation

◆ m_expectedSigBDuration

◆ m_p20Index

◆ m_phy

◆ m_sigBMode

◆ m_userInfos