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

Private Attributes
Mac48Address	m_associatedApBssid
	Associated AP's bssid.

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.

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 1958 of file wifi-test.cc.

Constructor & Destructor Documentation

StaWifiMacScanningTestCase()

StaWifiMacScanningTestCase::StaWifiMacScanningTestCase

(

)

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

~StaWifiMacScanningTestCase()

StaWifiMacScanningTestCase::~StaWifiMacScanningTestCase ( )

override

Definition at line 1998 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

context	context string
bssid	the associated AP's bssid

Definition at line 2003 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 2083 of file wifi-test.cc.

References ns3::Simulator::Destroy(), ns3::DynamicCast(), ns3::NodeContainer::Get(), ns3::Node::GetDevice(), m_associatedApBssid, nodes, NS_TEST_ASSERT_MSG_EQ, ns3::Simulator::Run(), ns3::Simulator::Schedule(), ns3::Seconds(), Setup(), ns3::Simulator::Stop(), TurnApOff(), and TurnBeaconGenerationOn().

Here is the call graph for this function:

Setup()

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

private

Setup test.

Parameters

nearestApBeaconGeneration	set BeaconGeneration attribute of the nearest AP
staActiveProbe	set ActiveProbing attribute of the STA

Returns

node container containing all nodes

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

References ns3::WifiHelper::AssignStreams(), AssocCallback(), ns3::Config::Connect(), ns3::NodeContainer::Create(), ns3::CreateObject(), ns3::YansWifiChannelHelper::Default(), ns3::MakeCallback(), ns3::RngSeedManager::SetRun(), ns3::RngSeedManager::SetSeed(), 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

apNode

the AP node

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

References ns3::DynamicCast().

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

apNode

the AP node

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

References ns3::DynamicCast().

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 1990 of file wifi-test.cc.

Referenced by AssocCallback(), and DoRun().

---

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

• src/wifi/test/wifi-test.cc