Test OFDMA acknowledgment sequences. More...
Classes | |
struct | FrameInfo |
Information about transmitted frames. More... | |
struct | MuEdcaParameterSet |
MU EDCA Parameter Set. More... | |
Public Member Functions | |
OfdmaAckSequenceTest (uint16_t width, WifiAcknowledgment::Method dlType, uint32_t maxAmpduSize, uint16_t txopLimit, uint16_t nPktsPerSta, MuEdcaParameterSet muEdcaParameterSet) | |
Constructor. More... | |
~OfdmaAckSequenceTest () override | |
void | CheckResults (Time sifs, Time slotTime, uint8_t aifsn) |
Check correctness of transmitted frames. More... | |
void | L7Receive (std::string context, Ptr< const Packet > p, const Address &addr) |
Function to trace packets received by the server application. More... | |
void | TraceCw (uint32_t staIndex, uint32_t cw, uint8_t) |
Function to trace CW value used by the given station after the MU exchange. More... | |
void | Transmit (std::string context, WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW) |
Callback invoked when FrameExchangeManager passes PSDUs to the PHY. More... | |
![]() | |
TestCase (const TestCase &)=delete | |
virtual | ~TestCase () |
Destructor. More... | |
std::string | GetName () const |
TestCase & | operator= (const TestCase &)=delete |
Private Member Functions | |
void | DoRun () override |
Implementation to actually run this TestCase. More... | |
Private Attributes | |
Ptr< WifiNetDevice > | m_apDevice |
AP's device. More... | |
uint16_t | m_channelWidth |
PHY channel bandwidth in MHz. More... | |
std::vector< uint32_t > | m_cwValues |
CW used by stations after MU exchange. More... | |
WifiAcknowledgment::Method | m_dlMuAckType |
DL MU ack sequence type. More... | |
Time | m_edcaDisabledStartTime |
time when disabling EDCA started More... | |
uint16_t | m_flushed |
number of DL packets flushed after DL MU PPDU More... | |
uint32_t | m_maxAmpduSize |
maximum A-MPDU size in bytes More... | |
MuEdcaParameterSet | m_muEdcaParameterSet |
MU EDCA Parameter Set. More... | |
uint16_t | m_nPktsPerSta |
number of packets to send to each station More... | |
uint16_t | m_nStations |
number of stations More... | |
uint16_t | m_received |
number of packets received by the stations More... | |
std::vector< PacketSocketAddress > | m_sockets |
packet socket addresses for STAs More... | |
NetDeviceContainer | m_staDevices |
stations' devices More... | |
uint16_t | m_txopLimit |
TXOP limit in microseconds. More... | |
std::vector< FrameInfo > | m_txPsdus |
transmitted PSDUs More... | |
bool | m_ulPktsGenerated |
whether UL packets for HE TB PPDUs have been generated More... | |
Static Private Attributes | |
static constexpr uint16_t | m_muTimerRes = 8192 |
MU timer resolution in usec. More... | |
Additional Inherited Members | |
![]() | |
enum | TestDuration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 } |
How long the test takes to execute. More... | |
![]() | |
TestCase (std::string name) | |
Constructor. More... | |
void | AddTestCase (TestCase *testCase, TestDuration duration=QUICK) |
Add an individual child TestCase to this test suite. More... | |
TestCase * | GetParent () const |
Get the parent of this TestCsse. More... | |
bool | IsStatusFailure () const |
Check if any tests failed. More... | |
bool | IsStatusSuccess () const |
Check if all tests passed. More... | |
void | SetDataDir (std::string directory) |
Set the data directory where reference trace files can be found. More... | |
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. More... | |
bool | MustAssertOnFailure () const |
Check if this run should assert on failure. More... | |
bool | MustContinueOnFailure () const |
Check if this run should continue on failure. More... | |
std::string | CreateDataDirFilename (std::string filename) |
Construct the full path to a file in the data directory. More... | |
std::string | CreateTempDirFilename (std::string filename) |
Construct the full path to a file in a temporary directory. More... | |
Test OFDMA acknowledgment sequences.
Run this test with:
NS_LOG="WifiMacOfdmaTestSuite=info|prefix_time|prefix_node" ./ns3 run "test-runner --suite=wifi-mac-ofdma"
to print the list of transmitted frames only, along with the TX time and the node prefix. Replace 'info' with 'debug' if you want to print the debug messages from the test multi-user scheduler only. Replace 'info' with 'level_debug' if you want to print both the transmitted frames and the debug messages.
Definition at line 348 of file wifi-mac-ofdma-test.cc.
OfdmaAckSequenceTest::OfdmaAckSequenceTest | ( | uint16_t | width, |
WifiAcknowledgment::Method | dlType, | ||
uint32_t | maxAmpduSize, | ||
uint16_t | txopLimit, | ||
uint16_t | nPktsPerSta, | ||
MuEdcaParameterSet | muEdcaParameterSet | ||
) |
Constructor.
width | the PHY channel bandwidth in MHz |
dlType | the DL MU ack sequence type |
maxAmpduSize | the maximum A-MPDU size in bytes |
txopLimit | the TXOP limit in microseconds |
nPktsPerSta | number of packets to send to/receive from each station |
muEdcaParameterSet | the MU EDCA Parameter Set |
Definition at line 443 of file wifi-mac-ofdma-test.cc.
|
override |
Definition at line 466 of file wifi-mac-ofdma-test.cc.
Check correctness of transmitted frames.
sifs | the SIFS duration |
slotTime | a slot duration |
aifsn | the AIFSN |
Definition at line 620 of file wifi-mac-ofdma-test.cc.
References ns3::NetDeviceContainer::Get(), ns3::CtrlBAckResponseHeader::GetAckType(), ns3::WifiMacHeader::GetAddr2(), ns3::WifiNetDevice::GetAddress(), ns3::Time::GetMicroSeconds(), ns3::CtrlBAckResponseHeader::GetNPerAidTidInfoSubfields(), ns3::CtrlTriggerHeader::GetNUserInfoFields(), ns3::GetPpduMaxTime(), ns3::WifiMacHeader::GetQosTid(), ns3::CtrlBAckResponseHeader::GetTidInfo(), ns3::WifiMacHeader::GetType(), ns3::CtrlTriggerHeader::IsBasic(), ns3::CtrlTriggerHeader::IsBsrp(), ns3::CtrlBAckResponseHeader::IsMultiSta(), m_apDevice, m_cwValues, m_dlMuAckType, m_edcaDisabledStartTime, m_flushed, m_maxAmpduSize, m_muEdcaParameterSet, m_muTimerRes, m_nPktsPerSta, m_nStations, m_received, m_staDevices, m_txopLimit, m_txPsdus, OfdmaAckSequenceTest::MuEdcaParameterSet::muAifsn, OfdmaAckSequenceTest::MuEdcaParameterSet::muCwMin, OfdmaAckSequenceTest::MuEdcaParameterSet::muTimer, ns3::NanoSeconds(), NS_TEST_EXPECT_MSG_EQ, NS_TEST_EXPECT_MSG_GT, NS_TEST_EXPECT_MSG_GT_OR_EQ, NS_TEST_EXPECT_MSG_LT, NS_TEST_EXPECT_MSG_LT_OR_EQ, NS_TEST_EXPECT_MSG_NE, SU_STA_ID, ns3::WIFI_MAC_QOSDATA_NULL, ns3::WIFI_PREAMBLE_HE_MU, and ns3::WIFI_PREAMBLE_HE_TB.
Referenced by DoRun().
|
overrideprivatevirtual |
Implementation to actually run this TestCase.
Subclasses should override this method to conduct their tests.
Implements ns3::TestCase.
Definition at line 1332 of file wifi-mac-ofdma-test.cc.
References ns3::AC_BE, ns3::AC_BK, ns3::AC_VI, ns3::AC_VO, CheckResults(), ns3::Config::Connect(), ns3::NetDeviceContainer::Get(), ns3::WifiNetDevice::GetAddress(), ns3::WifiNetDevice::GetIfIndex(), ns3::WifiNetDevice::GetMac(), ns3::NetDeviceContainer::GetN(), ns3::PacketSocketHelper::Install(), L7Receive(), m_apDevice, m_channelWidth, m_dlMuAckType, m_maxAmpduSize, m_muEdcaParameterSet, m_muTimerRes, m_nPktsPerSta, m_nStations, m_sockets, m_staDevices, m_txopLimit, third::mac, ns3::MakeCallback(), ns3::MicroSeconds(), ns3::MilliSeconds(), third::mobility, OfdmaAckSequenceTest::MuEdcaParameterSet::muAifsn, OfdmaAckSequenceTest::MuEdcaParameterSet::muCwMax, OfdmaAckSequenceTest::MuEdcaParameterSet::muCwMin, OfdmaAckSequenceTest::MuEdcaParameterSet::muTimer, NS_ABORT_MSG, third::phy, ns3::Seconds(), ns3::Config::SetDefault(), ns3::Config::SetGlobal(), ns3::PacketSocketAddress::SetPhysicalAddress(), ns3::PacketSocketAddress::SetProtocol(), ns3::PacketSocketAddress::SetSingleDevice(), third::ssid, Transmit(), third::wifi, ns3::WIFI_STANDARD_80211ax, third::wifiApNode, and third::wifiStaNodes.
void OfdmaAckSequenceTest::L7Receive | ( | std::string | context, |
Ptr< const Packet > | p, | ||
const Address & | addr | ||
) |
Function to trace packets received by the server application.
context | the context |
p | the packet |
addr | the address |
Definition at line 471 of file wifi-mac-ofdma-test.cc.
References ns3::Packet::GetSize(), m_received, ns3::Now(), and ns3::Seconds().
Referenced by DoRun().
Function to trace CW value used by the given station after the MU exchange.
staIndex | the index of the given station |
cw | the current Contention Window value |
Definition at line 480 of file wifi-mac-ofdma-test.cc.
References m_cwValues.
Referenced by Transmit().
void OfdmaAckSequenceTest::Transmit | ( | std::string | context, |
WifiConstPsduMap | psduMap, | ||
WifiTxVector | txVector, | ||
double | txPowerW | ||
) |
Callback invoked when FrameExchangeManager passes PSDUs to the PHY.
context | the context |
psduMap | the PSDU map |
txVector | the TX vector |
txPowerW | the tx power in Watts |
Definition at line 491 of file wifi-mac-ofdma-test.cc.
References ns3::CtrlTriggerHeader::begin(), ns3::NetDeviceContainer::Get(), ns3::WifiNetDevice::GetAddress(), ns3::WifiNetDevice::GetMac(), ns3::NetDeviceContainer::GetN(), ns3::WifiTxVector::GetPreambleType(), ns3::Txop::GetWifiMacQueue(), ns3::CtrlTriggerHeader::IsBasic(), ns3::WifiTxVector::IsMu(), ns3::CtrlBAckResponseHeader::IsMultiSta(), m_apDevice, m_edcaDisabledStartTime, m_flushed, m_muEdcaParameterSet, m_nPktsPerSta, m_nStations, m_sockets, m_staDevices, m_txPsdus, m_ulPktsGenerated, ns3::MakeCallback(), ns3::MicroSeconds(), OfdmaAckSequenceTest::MuEdcaParameterSet::muAifsn, OfdmaAckSequenceTest::MuEdcaParameterSet::muTimer, ns3::Now(), NS_LOG_INFO, ns3::Seconds(), ns3::ObjectBase::TraceConnectWithoutContext(), TraceCw(), ns3::WIFI_PHY_BAND_5GHZ, ns3::WIFI_PREAMBLE_HE_MU, and ns3::WIFI_PREAMBLE_HE_TB.
Referenced by DoRun().
|
private |
AP's device.
Definition at line 427 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), DoRun(), and Transmit().
|
private |
PHY channel bandwidth in MHz.
Definition at line 429 of file wifi-mac-ofdma-test.cc.
Referenced by DoRun().
|
private |
CW used by stations after MU exchange.
Definition at line 440 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), and TraceCw().
|
private |
DL MU ack sequence type.
Definition at line 431 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), and DoRun().
|
private |
time when disabling EDCA started
Definition at line 439 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), and Transmit().
|
private |
number of DL packets flushed after DL MU PPDU
Definition at line 438 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), and Transmit().
|
private |
maximum A-MPDU size in bytes
Definition at line 432 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), and DoRun().
|
private |
MU EDCA Parameter Set.
Definition at line 435 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), DoRun(), and Transmit().
|
staticconstexprprivate |
MU timer resolution in usec.
Definition at line 414 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), and DoRun().
|
private |
number of packets to send to each station
Definition at line 434 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), DoRun(), and Transmit().
|
private |
number of stations
Definition at line 425 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), DoRun(), and Transmit().
|
private |
number of packets received by the stations
Definition at line 437 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), and L7Receive().
|
private |
packet socket addresses for STAs
Definition at line 428 of file wifi-mac-ofdma-test.cc.
Referenced by DoRun(), and Transmit().
|
private |
stations' devices
Definition at line 426 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), DoRun(), and Transmit().
|
private |
TXOP limit in microseconds.
Definition at line 433 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), and DoRun().
|
private |
transmitted PSDUs
Definition at line 430 of file wifi-mac-ofdma-test.cc.
Referenced by CheckResults(), and Transmit().
|
private |
whether UL packets for HE TB PPDUs have been generated
Definition at line 436 of file wifi-mac-ofdma-test.cc.
Referenced by Transmit().