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...
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. More... | |
Public Types inherited from ns3::TestCase | |
enum | TestDuration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 } |
How long the test takes to execute. More... | |
Public Member Functions | |
TestNonHtDuplicatePhyReception (WifiStandard apStandard, uint16_t apFrequency, uint8_t apP20Index, StasParams stasParams, std::vector< bool > per20MhzInterference={}) | |
Constructor. More... | |
Public Member Functions inherited from ns3::TestCase | |
TestCase (const TestCase &)=delete | |
virtual | ~TestCase () |
Destructor. More... | |
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. More... | |
void | DoRun () override |
Implementation to actually run this TestCase. More... | |
void | DoSetup () override |
Implementation to do any local setup required for this TestCase. More... | |
void | DoTeardown () override |
Implementation to do any local setup required for this TestCase. More... | |
void | GenerateInterference (Ptr< WaveformGenerator > interferer, Ptr< SpectrumValue > interferencePsd, Time duration) |
Generate interference function. More... | |
void | ResetResults () |
Reset the results. More... | |
void | RxFailure (std::size_t index, Ptr< const WifiPsdu > psdu) |
Receive failure function. More... | |
void | RxSuccess (std::size_t index, Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, WifiTxVector txVector, std::vector< bool > statusPerMpdu) |
Receive success function. More... | |
void | SendNonHtDuplicatePpdu (uint16_t channelWidth) |
Send non-HT duplicate PPDU function. More... | |
void | StopInterference (Ptr< WaveformGenerator > interferer) |
Stop interference function. More... | |
Private Attributes | |
uint16_t | m_apFrequency |
the center frequency of the AP (in MHz) More... | |
uint8_t | m_apP20Index |
the index of the primary 20 MHz channel of the AP More... | |
WifiStandard | m_apStandard |
the standard to use for the AP More... | |
std::vector< uint32_t > | m_countRxFailureStas |
count RX failure for STAs More... | |
std::vector< uint32_t > | m_countRxSuccessStas |
count RX success for STAs More... | |
std::vector< bool > | m_per20MhzInterference |
flags per 20 MHz subchannel whether an interference should be generated on that subchannel More... | |
Ptr< SpectrumWifiPhy > | m_phyAp |
PHY of AP. More... | |
std::vector< Ptr< WaveformGenerator > > | m_phyInterferers |
PHYs of interferers (1 interferer per 20 MHz subchannel) More... | |
std::vector< Ptr< SpectrumWifiPhy > > | m_phyStas |
PHYs of STAs. More... | |
StasParams | m_stasParams |
the parameters of the STAs More... | |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::TestCase | |
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 TestCase. 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... | |
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.
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.
TestNonHtDuplicatePhyReception::TestNonHtDuplicatePhyReception | ( | WifiStandard | apStandard, |
uint16_t | apFrequency, | ||
uint8_t | apP20Index, | ||
StasParams | stasParams, | ||
std::vector< bool > | per20MhzInterference = {} |
||
) |
Constructor.
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 ( |
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.
|
private |
Check the results.
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().
|
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::BandInfo::fc, ns3::BandInfo::fh, 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::Seconds(), SendNonHtDuplicatePpdu(), ns3::WifiPhy::SetOperatingChannel(), check-style-clang-format::type, and ns3::WIFI_PHY_BAND_5GHZ.
|
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(), 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(), check-style-clang-format::type, ns3::WIFI_PHY_BAND_5GHZ, and ns3::WIFI_STANDARD_80211ax.
|
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.
|
private |
Generate interference function.
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::WaveformGenerator::SetPeriod(), ns3::WaveformGenerator::SetTxPowerSpectralDensity(), ns3::WaveformGenerator::Start(), and StopInterference().
Referenced by DoRun().
|
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().
|
private |
Receive failure function.
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().
|
private |
Receive success function.
index | index of the RX STA |
psdu | the PSDU |
rxSignalInfo | the info on the received signal ( |
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, min, NS_LOG_FUNCTION, and NS_TEST_ASSERT_MSG_EQ.
Referenced by DoSetup().
|
private |
Send non-HT duplicate PPDU function.
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::WifiPhy::GetPhyBand(), ns3::WifiPsdu::GetSize(), 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().
|
private |
Stop interference function.
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, and ns3::WaveformGenerator::Stop().
Referenced by GenerateInterference().
|
private |
the center frequency of the AP (in MHz)
Definition at line 284 of file wifi-non-ht-dup-test.cc.
|
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().
|
private |
the standard to use for the AP
Definition at line 283 of file wifi-non-ht-dup-test.cc.
|
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().
|
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().
|
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.
|
private |
PHY of AP.
Definition at line 294 of file wifi-non-ht-dup-test.cc.
Referenced by DoRun(), DoSetup(), DoTeardown(), RxSuccess(), and SendNonHtDuplicatePpdu().
|
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().
|
private |
PHYs of STAs.
Definition at line 295 of file wifi-non-ht-dup-test.cc.
Referenced by DoRun(), DoSetup(), DoTeardown(), and RxSuccess().
|
private |
the parameters of the STAs
Definition at line 286 of file wifi-non-ht-dup-test.cc.