A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
TxDurationTest Class Reference

Tx Duration Test. More...

+ Inheritance diagram for TxDurationTest:
+ Collaboration diagram for TxDurationTest:

Public Member Functions

 TxDurationTest ()
 
 ~TxDurationTest () override
 
void DoRun () override
 Implementation to actually run this TestCase.
 
- Public Member Functions inherited from ns3::TestCase
 TestCase (const TestCase &)=delete
 
virtual ~TestCase ()
 Destructor.
 
std::string GetName () const
 
TestCaseoperator= (const TestCase &)=delete
 

Private Member Functions

bool CheckPayloadDuration (uint32_t size, WifiMode payloadMode, MHz_u channelWidth, Time guardInterval, WifiPreamble preamble, Time knownDuration)
 Check if the payload tx duration returned by InterferenceHelper corresponds to a known value.
 
bool CheckTxDuration (uint32_t size, WifiMode payloadMode, MHz_u channelWidth, Time guardInterval, WifiPreamble preamble, Time knownDuration)
 Check if the overall tx duration returned by InterferenceHelper corresponds to a known value.
 

Static Private Member Functions

static Time CalculateTxDurationUsingList (std::list< uint32_t > sizes, std::list< uint16_t > staIds, WifiTxVector txVector, WifiPhyBand band)
 Calculate the overall Tx duration returned by WifiPhy for list of sizes.
 
static bool CheckMuTxDuration (std::list< uint32_t > sizes, std::list< HeMuUserInfo > userInfos, MHz_u channelWidth, Time guardInterval, WifiPreamble preamble, Time knownDuration)
 Check if the overall Tx duration returned by WifiPhy for a MU PPDU corresponds to a known value.
 

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.
 
TestCaseGetParent () 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

Tx Duration Test.

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

Constructor & Destructor Documentation

◆ TxDurationTest()

TxDurationTest::TxDurationTest ( )

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

◆ ~TxDurationTest()

TxDurationTest::~TxDurationTest ( )
override

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

Member Function Documentation

◆ CalculateTxDurationUsingList()

Time TxDurationTest::CalculateTxDurationUsingList ( std::list< uint32_t > sizes,
std::list< uint16_t > staIds,
WifiTxVector txVector,
WifiPhyBand band )
staticprivate

Calculate the overall Tx duration returned by WifiPhy for list of sizes.

A map of WifiPsdu indexed by STA-ID is built using the provided lists and handed over to the corresponding SU/MU WifiPhy Tx duration computing method. Note that provided lists should be of same size.

Parameters
sizesthe list of PSDU sizes for each station in octets
staIdsthe list of STA-IDs of each station
txVectorthe TXVECTOR used for the transmission of the PPDU
bandthe selected wifi PHY band
Returns
the overall Tx duration for the list of sizes (SU or MU PPDU)

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

References ns3::WifiPhy::CalculateTxDuration(), ns3::Create(), ns3::WifiMacHeader::GetSerializedSize(), NS_ASSERT, ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_CTL_ACK.

Referenced by CheckMuTxDuration(), and CheckTxDuration().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ CheckMuTxDuration()

bool TxDurationTest::CheckMuTxDuration ( std::list< uint32_t > sizes,
std::list< HeMuUserInfo > userInfos,
MHz_u channelWidth,
Time guardInterval,
WifiPreamble preamble,
Time knownDuration )
staticprivate

Check if the overall Tx duration returned by WifiPhy for a MU PPDU corresponds to a known value.

Parameters
sizesthe list of PSDU sizes for each station in octets
userInfosthe list of HE MU specific user transmission parameters
channelWidththe channel width used for the transmission
guardIntervalthe guard interval duration used for the transmission
preamblethe WifiPreamble used for the transmission
knownDurationthe known duration value of the transmission
Returns
true if values correspond, false otherwise

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

References CalculateTxDurationUsingList(), ns3::CreateObject(), ns3::HeRu::GetBandwidth(), ns3::WifiMode::GetDataRate(), ns3::WifiTxVector::GetMode(), ns3::WifiTxVector::GetNss(), ns3::HeRu::RuSpec::GetRuType(), ns3::VhtPhy::GetVhtMcs0(), ns3::IsEht(), ns3::MicroSeconds(), ns3::NanoSeconds(), NS_ABORT_MSG_IF, NS_ASSERT, ns3::HeMuUserInfo::ru, ns3::WifiTxVector::SetChannelWidth(), ns3::WifiTxVector::SetEhtPpduType(), ns3::WifiTxVector::SetGuardInterval(), ns3::WifiTxVector::SetHeMuUserInfo(), ns3::WifiTxVector::SetNess(), ns3::WifiTxVector::SetPreambleType(), ns3::WifiTxVector::SetRuAllocation(), ns3::WifiTxVector::SetSigBMode(), ns3::WifiTxVector::SetStbc(), ns3::WIFI_PHY_BAND_2_4GHZ, ns3::WIFI_PHY_BAND_5GHZ, and ns3::WIFI_PHY_BAND_6GHZ.

Referenced by DoRun().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ CheckPayloadDuration()

bool TxDurationTest::CheckPayloadDuration ( uint32_t size,
WifiMode payloadMode,
MHz_u channelWidth,
Time guardInterval,
WifiPreamble preamble,
Time knownDuration )
private

Check if the payload tx duration returned by InterferenceHelper corresponds to a known value.

Parameters
sizesize of payload in octets (includes everything after the PHY header)
payloadModethe WifiMode used for the transmission
channelWidththe channel width used for the transmission
guardIntervalthe guard interval duration used for the transmission
preamblethe WifiPreamble used for the transmission
knownDurationthe known duration value of the transmission
Returns
true if values correspond, false otherwise

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

References ns3::CreateObject(), ns3::WifiMode::GetDataRate(), ns3::WifiMode::GetModulationClass(), ns3::MicroSeconds(), ns3::WifiTxVector::SetChannelWidth(), ns3::WifiTxVector::SetGuardInterval(), ns3::WifiTxVector::SetMode(), ns3::WifiTxVector::SetNess(), ns3::WifiTxVector::SetNss(), ns3::WifiTxVector::SetPreambleType(), ns3::WifiTxVector::SetStbc(), ns3::WIFI_MOD_CLASS_HE, ns3::WIFI_MOD_CLASS_OFDM, ns3::WIFI_MOD_CLASS_VHT, ns3::WIFI_PHY_BAND_2_4GHZ, ns3::WIFI_PHY_BAND_5GHZ, and ns3::WIFI_PHY_BAND_6GHZ.

Referenced by DoRun().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ CheckTxDuration()

bool TxDurationTest::CheckTxDuration ( uint32_t size,
WifiMode payloadMode,
MHz_u channelWidth,
Time guardInterval,
WifiPreamble preamble,
Time knownDuration )
private

Check if the overall tx duration returned by InterferenceHelper corresponds to a known value.

Parameters
sizesize of payload in octets (includes everything after the PHY header)
payloadModethe WifiMode used for the transmission
channelWidththe channel width used for the transmission
guardIntervalthe guard interval duration used for the transmission
preamblethe WifiPreamble used for the transmission
knownDurationthe known duration value of the transmission
Returns
true if values correspond, false otherwise

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

References CalculateTxDurationUsingList(), ns3::CreateObject(), ns3::WifiMode::GetDataRate(), ns3::WifiMode::GetModulationClass(), ns3::MicroSeconds(), ns3::WifiTxVector::SetChannelWidth(), ns3::WifiTxVector::SetGuardInterval(), ns3::WifiTxVector::SetMode(), ns3::WifiTxVector::SetNess(), ns3::WifiTxVector::SetNss(), ns3::WifiTxVector::SetPreambleType(), ns3::WifiTxVector::SetStbc(), ns3::SU_STA_ID, ns3::WIFI_MOD_CLASS_HE, ns3::WIFI_MOD_CLASS_OFDM, ns3::WIFI_MOD_CLASS_VHT, ns3::WIFI_PHY_BAND_2_4GHZ, ns3::WIFI_PHY_BAND_5GHZ, and ns3::WIFI_PHY_BAND_6GHZ.

Referenced by DoRun().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ DoRun()


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