PHY CCA thresholds test. More...
Public Member Functions | |
WifiPhyCcaThresholdsTest () | |
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 | |
Ptr< HePpdu > | CreateDummyHePpdu (MHz_u bandwidth, const WifiPhyOperatingChannel &channel) |
Create a HE PPDU. | |
Ptr< HtPpdu > | CreateDummyHtPpdu (MHz_u bandwidth, const WifiPhyOperatingChannel &channel) |
Create a HT PPDU. | |
Ptr< OfdmPpdu > | CreateDummyNonHtPpdu (const WifiPhyOperatingChannel &channel) |
Create a non-HT PPDU. | |
Ptr< WifiPsdu > | CreateDummyPsdu () |
Create a dummy PSDU whose payload is 1000 bytes. | |
Ptr< VhtPpdu > | CreateDummyVhtPpdu (MHz_u bandwidth, const WifiPhyOperatingChannel &channel) |
Create a VHT PPDU. | |
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 | RunOne () |
Run tests for given CCA attributes. | |
void | VerifyCcaThreshold (const Ptr< PhyEntity > phy, const Ptr< const WifiPpdu > ppdu, WifiChannelListType channelType, dBm_u expectedCcaThreshold) |
Function to verify the CCA threshold that is being reported by a given PHY entity upon reception of a signal or a PPDU. | |
Private Attributes | |
dBm_u | m_CcaEdThreshold |
The current CCA-ED threshold for a 20 MHz subchannel. | |
dBm_u | m_CcaSensitivity |
The current CCA sensitivity threshold for signals that occupy the primary 20 MHz channel. | |
Ptr< WifiNetDevice > | m_device |
The WifiNetDevice. | |
Ptr< ObssPdAlgorithm > | m_obssPdAlgorithm |
The OBSS-PD algorithm. | |
dBm_u | m_obssPdLevel |
The current OBSS-PD level. | |
Ptr< SpectrumWifiPhy > | m_phy |
The spectrum PHY. | |
VhtConfiguration::SecondaryCcaSensitivityThresholds | m_secondaryCcaSensitivityThresholds |
The current CCA sensitivity thresholds for signals that do not occupy the primary 20 MHz channel. | |
Ptr< VhtConfiguration > | m_vhtConfiguration |
The VHT configuration. | |
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. | |
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. | |
PHY CCA thresholds test.
Definition at line 64 of file wifi-phy-cca-test.cc.
WifiPhyCcaThresholdsTest::WifiPhyCcaThresholdsTest | ( | ) |
Definition at line 142 of file wifi-phy-cca-test.cc.
|
private |
Create a HE PPDU.
bandwidth | the bandwidth used for the transmission the PPDU |
channel | the operating channel of the PHY used for the transmission |
Definition at line 211 of file wifi-phy-cca-test.cc.
References ns3::Create(), CreateDummyPsdu(), ns3::HePhy::GetHeMcs0(), ns3::MicroSeconds(), ns3::NanoSeconds(), and ns3::WIFI_PREAMBLE_HE_SU.
Referenced by RunOne().
|
private |
Create a HT PPDU.
bandwidth | the bandwidth used for the transmission the PPDU |
channel | the operating channel of the PHY used for the transmission |
Definition at line 178 of file wifi-phy-cca-test.cc.
References ns3::Create(), CreateDummyPsdu(), ns3::HtPhy::GetHtMcs0(), ns3::MicroSeconds(), ns3::NanoSeconds(), and ns3::WIFI_PREAMBLE_HT_MF.
Referenced by RunOne().
|
private |
Create a non-HT PPDU.
channel | the operating channel of the PHY used for the transmission |
Definition at line 162 of file wifi-phy-cca-test.cc.
References ns3::Create(), CreateDummyPsdu(), ns3::OfdmPhy::GetOfdmRate6Mbps(), ns3::NanoSeconds(), and ns3::WIFI_PREAMBLE_LONG.
Referenced by RunOne().
Create a dummy PSDU whose payload is 1000 bytes.
Definition at line 152 of file wifi-phy-cca-test.cc.
References ns3::Create(), ns3::WifiMacHeader::SetQosTid(), ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_QOSDATA.
Referenced by CreateDummyHePpdu(), CreateDummyHtPpdu(), CreateDummyNonHtPpdu(), and CreateDummyVhtPpdu().
|
private |
Create a VHT PPDU.
bandwidth | the bandwidth used for the transmission the PPDU |
channel | the operating channel of the PHY used for the transmission |
Definition at line 194 of file wifi-phy-cca-test.cc.
References ns3::Create(), CreateDummyPsdu(), ns3::VhtPhy::GetVhtMcs0(), ns3::MicroSeconds(), ns3::NanoSeconds(), and ns3::WIFI_PREAMBLE_VHT_SU.
Referenced by RunOne().
|
overrideprivatevirtual |
Implementation to actually run this TestCase.
Subclasses should override this method to conduct their tests.
Implements ns3::TestCase.
Definition at line 545 of file wifi-phy-cca-test.cc.
References ns3::Simulator::Destroy(), m_CcaEdThreshold, m_CcaSensitivity, m_obssPdLevel, m_secondaryCcaSensitivityThresholds, and RunOne().
|
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 247 of file wifi-phy-cca-test.cc.
References ns3::CreateObject(), ns3::WifiPhyOperatingChannel::FindFirst(), m_device, m_obssPdAlgorithm, m_phy, m_vhtConfiguration, 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 275 of file wifi-phy-cca-test.cc.
References m_device.
|
private |
Run tests for given CCA attributes.
Definition at line 282 of file wifi-phy-cca-test.cc.
References CreateDummyHePpdu(), CreateDummyHtPpdu(), CreateDummyNonHtPpdu(), CreateDummyVhtPpdu(), m_CcaEdThreshold, m_CcaSensitivity, m_obssPdAlgorithm, m_obssPdLevel, m_phy, m_secondaryCcaSensitivityThresholds, m_vhtConfiguration, VerifyCcaThreshold(), ns3::WIFI_CHANLIST_PRIMARY, ns3::WIFI_CHANLIST_SECONDARY, ns3::WIFI_CHANLIST_SECONDARY40, ns3::WIFI_CHANLIST_SECONDARY80, ns3::WIFI_MOD_CLASS_HE, ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_MOD_CLASS_OFDM, and ns3::WIFI_MOD_CLASS_VHT.
Referenced by DoRun().
|
private |
Function to verify the CCA threshold that is being reported by a given PHY entity upon reception of a signal or a PPDU.
phy | the PHY entity to verify |
ppdu | the incoming PPDU or signal (if nullptr) |
channelType | the channel list type that indicates which channel the PPDU or the signal occupies |
expectedCcaThreshold | the CCA threshold that is expected to be reported |
Definition at line 227 of file wifi-phy-cca-test.cc.
References NS_LOG_FUNCTION, NS_LOG_INFO, and NS_TEST_EXPECT_MSG_EQ_TOL.
Referenced by RunOne().
|
private |
The current CCA-ED threshold for a 20 MHz subchannel.
Definition at line 131 of file wifi-phy-cca-test.cc.
|
private |
The current CCA sensitivity threshold for signals that occupy the primary 20 MHz channel.
Definition at line 132 of file wifi-phy-cca-test.cc.
|
private |
The WifiNetDevice.
Definition at line 126 of file wifi-phy-cca-test.cc.
Referenced by DoSetup(), and DoTeardown().
|
private |
The OBSS-PD algorithm.
Definition at line 128 of file wifi-phy-cca-test.cc.
|
private |
The current OBSS-PD level.
Definition at line 139 of file wifi-phy-cca-test.cc.
|
private |
The spectrum PHY.
Definition at line 127 of file wifi-phy-cca-test.cc.
|
private |
The current CCA sensitivity thresholds for signals that do not occupy the primary 20 MHz channel.
Definition at line 136 of file wifi-phy-cca-test.cc.
|
private |
The VHT configuration.
Definition at line 129 of file wifi-phy-cca-test.cc.