A Discrete-Event Network Simulator
API
StaWifiMacScanningTestCase Class Reference

Make sure that Wifi STA is correctly associating to the best AP (i.e., nearest from STA). More...

+ Inheritance diagram for StaWifiMacScanningTestCase:
+ Collaboration diagram for StaWifiMacScanningTestCase:

Public Member Functions

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

Private Member Functions

void AssocCallback (std::string context, Mac48Address bssid)
 Callback function on STA assoc event. More...
 
NodeContainer Setup (bool nearestApBeaconGeneration, bool staActiveProbe)
 Setup test. More...
 
void TurnApOff (Ptr< Node > apNode)
 Turn the AP node off. More...
 
void TurnBeaconGenerationOn (Ptr< Node > apNode)
 Turn beacon generation on the AP node. More...
 

Private Attributes

Mac48Address m_associatedApBssid
 Associated AP's bssid. More...
 

Additional Inherited Members

- Public Types inherited from ns3::TestCase
enum  TestDuration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 }
 How long the test takes to execute. More...
 
- 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...
 
TestCaseGetParent () 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...
 

Detailed Description

Make sure that Wifi STA is correctly associating to the best AP (i.e., nearest from STA).

We consider 3 AP and 1 STA. This test case consisted of three sub tests:

  • The best AP sends its beacon later than the other APs. STA is expected to associate to the best AP.
  • The STA is using active scanning instead of passive, the rest of the APs works normally. STA is expected to associate to the best AP
  • The nearest AP is turned off after sending beacon and while STA is still scanning. STA is expected to associate to the second best AP.

See Bug 2399

Todo:
Add explicit association refusal test if ns-3 implemented it.

Definition at line 1940 of file wifi-test.cc.

Constructor & Destructor Documentation

◆ StaWifiMacScanningTestCase()

StaWifiMacScanningTestCase::StaWifiMacScanningTestCase ( )

Definition at line 1975 of file wifi-test.cc.

◆ ~StaWifiMacScanningTestCase()

StaWifiMacScanningTestCase::~StaWifiMacScanningTestCase ( )
override

Definition at line 1980 of file wifi-test.cc.

Member Function Documentation

◆ AssocCallback()

void StaWifiMacScanningTestCase::AssocCallback ( std::string  context,
Mac48Address  bssid 
)
private

Callback function on STA assoc event.

Parameters
contextcontext string
bssidthe associated AP's bssid

Definition at line 1985 of file wifi-test.cc.

References m_associatedApBssid.

Referenced by Setup().

+ Here is the caller graph for this function:

◆ DoRun()

void StaWifiMacScanningTestCase::DoRun ( )
overridevirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Implements ns3::TestCase.

Definition at line 2065 of file wifi-test.cc.

References ns3::NodeContainer::Get(), ns3::Node::GetDevice(), m_associatedApBssid, nodes, NS_TEST_ASSERT_MSG_EQ, ns3::Seconds(), Setup(), TurnApOff(), and TurnBeaconGenerationOn().

+ Here is the call graph for this function:

◆ Setup()

NodeContainer StaWifiMacScanningTestCase::Setup ( bool  nearestApBeaconGeneration,
bool  staActiveProbe 
)
private

Setup test.

Parameters
nearestApBeaconGenerationset BeaconGeneration attribute of the nearest AP
staActiveProbeset ActiveProbing attribute of the STA
Returns
node container containing all nodes

Definition at line 2007 of file wifi-test.cc.

References AssocCallback(), third::channel, ns3::Config::Connect(), ns3::NodeContainer::Create(), third::mac, ns3::MakeCallback(), third::mobility, third::phy, third::wifi, and ns3::WIFI_STANDARD_80211n.

Referenced by DoRun().

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

◆ TurnApOff()

void StaWifiMacScanningTestCase::TurnApOff ( Ptr< Node apNode)
private

Turn the AP node off.

Parameters
apNodethe AP node

Definition at line 1999 of file wifi-test.cc.

References ns3::Node::GetDevice(), ns3::WifiNetDevice::GetPhy(), and third::phy.

Referenced by DoRun().

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

◆ TurnBeaconGenerationOn()

void StaWifiMacScanningTestCase::TurnBeaconGenerationOn ( Ptr< Node apNode)
private

Turn beacon generation on the AP node.

Parameters
apNodethe AP node

Definition at line 1991 of file wifi-test.cc.

References ns3::Node::GetDevice(), ns3::WifiNetDevice::GetMac(), and third::mac.

Referenced by DoRun().

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

Member Data Documentation

◆ m_associatedApBssid

Mac48Address StaWifiMacScanningTestCase::m_associatedApBssid
private

Associated AP's bssid.

Definition at line 1972 of file wifi-test.cc.

Referenced by AssocCallback(), and DoRun().


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