Test release of sequence numbers upon CTS timeout in multi-link operations. More...

Inheritance diagram for ReleaseSeqNoAfterCtsTimeoutTest:

Collaboration diagram for ReleaseSeqNoAfterCtsTimeoutTest:

Public Member Functions
	ReleaseSeqNoAfterCtsTimeoutTest ()

	~ReleaseSeqNoAfterCtsTimeoutTest () override=default

Public Member Functions inherited from MultiLinkOperationsTestBase
	MultiLinkOperationsTestBase (const std::string &name, uint8_t nStations, std::vector< std::string > staChannels, std::vector< std::string > apChannels, std::vector< uint8_t > fixedPhyBands={})
	Constructor.

	~MultiLinkOperationsTestBase () override=default

Public Member Functions inherited from ns3::TestCase
	TestCase (const TestCase &)=delete

virtual	~TestCase ()
	Destructor.

std::string	GetName () const

TestCase &	operator= (const TestCase &)=delete

Protected Member Functions
void	DoRun () override
	Implementation to actually run this TestCase.

void	DoSetup () override
	Implementation to do any local setup required for this TestCase.

void	Transmit (uint8_t linkId, std::string context, WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW) override
	Callback invoked when a FEM passes PSDUs to the PHY.

Protected Member Functions inherited from MultiLinkOperationsTestBase
void	CheckAddresses (Ptr< const WifiPsdu > psdu, std::optional< Direction > direction=std::nullopt)
	Check that the Address 1 and Address 2 fields of the given PSDU contain device MAC addresses.

void	DoSetup () override
	Implementation to do any local setup required for this TestCase.

virtual void	Transmit (uint8_t linkId, std::string context, WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW)
	Callback invoked when a FEM passes PSDUs to the PHY.

Protected Member Functions inherited from ns3::TestCase
	TestCase (std::string name)
	Constructor.

void	AddTestCase (TestCase *testCase, TestDuration 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.

Private Member Functions
Ptr< PacketSocketClient >	GetApplication () const

void	StartTraffic () override
	Start the generation of traffic (needs to be overridden)

Private Attributes
Ptr< ListErrorModel >	m_errorModel
	error rate model to corrupt first RTS frame

std::size_t	m_nQosDataFrames
	counter for transmitted QoS data frames

bool	m_rtsCorrupted
	whether the first RTS frame has been corrupted

PacketSocketAddress	m_socket
	packet socket address

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 Types inherited from MultiLinkOperationsTestBase
using	ChannelMap = std::map< FrequencyRange, Ptr< MultiModelSpectrumChannel > >
	PHY band-indexed map of spectrum channels.

enum	Direction { DL = 0 , UL }
	Uplink or Downlink direction. More...

Protected Attributes inherited from MultiLinkOperationsTestBase
const std::vector< std::string >	m_apChannels
	strings specifying channels for AP

Ptr< ApWifiMac >	m_apMac
	AP wifi MAC.

const std::vector< uint8_t >	m_fixedPhyBands
	links on non-AP MLD with fixed PHY band

uint16_t	m_lastAid
	AID of last associated station.

uint8_t	m_nStations
	number of stations to create

const std::vector< std::string >	m_staChannels
	strings specifying channels for STA

std::vector< Ptr< StaWifiMac > >	m_staMacs
	STA wifi MACs.

std::vector< FrameInfo >	m_txPsdus
	transmitted PSDUs

Detailed Description

Test release of sequence numbers upon CTS timeout in multi-link operations.

In this test, an AP MLD and a non-AP MLD setup 3 links. Usage of RTS/CTS protection is enabled for frames whose length is at least 1000 bytes. The AP MLD receives a first set of 4 packets from the upper layer and sends an RTS frame, which is corrupted at the receiver, on a first link. When the RTS frame is transmitted, the AP MLD receives another set of 4 packets, which are transmitted after a successful RTS/CTS exchange on a second link. In the meantime, a new RTS/CTS exchange is successfully carried out (on the first link or on the third link) to transmit the first set of 4 packets. When the transmission of the first set of 4 packets starts, the AP MLD receives the third set of 4 packets from the upper layer, which are transmitted after a successful RTS/CTS exchange.

This test checks that sequence numbers are correctly assigned to all the MPDUs carrying data.

Definition at line 2435 of file wifi-mlo-test.cc.

Constructor & Destructor Documentation

◆ ReleaseSeqNoAfterCtsTimeoutTest()

ReleaseSeqNoAfterCtsTimeoutTest::ReleaseSeqNoAfterCtsTimeoutTest ( )

Definition at line 2464 of file wifi-mlo-test.cc.

◆ ~ReleaseSeqNoAfterCtsTimeoutTest()

ReleaseSeqNoAfterCtsTimeoutTest::~ReleaseSeqNoAfterCtsTimeoutTest ( )

overridedefault

Member Function Documentation

◆ DoRun()

void ReleaseSeqNoAfterCtsTimeoutTest::DoRun ( )

overrideprotectedvirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Implements ns3::TestCase.

Definition at line 2565 of file wifi-mlo-test.cc.

References ns3::Simulator::Destroy(), m_nQosDataFrames, MultiLinkOperationsTestBase::m_txPsdus, NS_TEST_EXPECT_MSG_EQ, ns3::PeekPointer(), ns3::Simulator::Run(), ns3::Seconds(), and ns3::Simulator::Stop().

Here is the call graph for this function:

◆ DoSetup()

void ReleaseSeqNoAfterCtsTimeoutTest::DoSetup ( )

overrideprotectedvirtual

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 MultiLinkOperationsTestBase.

Definition at line 2477 of file wifi-mlo-test.cc.

References MultiLinkOperationsTestBase::DoSetup(), m_errorModel, MultiLinkOperationsTestBase::m_staMacs, and ns3::Config::SetDefault().

Here is the call graph for this function:

◆ GetApplication()

Ptr< PacketSocketClient > ReleaseSeqNoAfterCtsTimeoutTest::GetApplication ( ) const

private

Returns: the client application generating 4 packets addressed to the non-AP MLD

Definition at line 2492 of file wifi-mlo-test.cc.

References m_socket, ns3::MicroSeconds(), and ns3::Seconds().

Referenced by StartTraffic(), and Transmit().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ StartTraffic()

void ReleaseSeqNoAfterCtsTimeoutTest::StartTraffic ( )

overrideprivatevirtual

Start the generation of traffic (needs to be overridden)

Reimplemented from MultiLinkOperationsTestBase.

Definition at line 2508 of file wifi-mlo-test.cc.

References ns3::Node::AddApplication(), ns3::NodeList::Begin(), ns3::NodeList::End(), GetApplication(), ns3::WifiMac::GetDevice(), ns3::WifiNetDevice::GetIfIndex(), ns3::WifiNetDevice::GetNode(), ns3::PacketSocketHelper::Install(), MultiLinkOperationsTestBase::m_apMac, m_socket, MultiLinkOperationsTestBase::m_staMacs, ns3::Seconds(), ns3::PacketSocketAddress::SetPhysicalAddress(), ns3::PacketSocketAddress::SetProtocol(), and ns3::PacketSocketAddress::SetSingleDevice().

Here is the call graph for this function:

◆ Transmit()

void ReleaseSeqNoAfterCtsTimeoutTest::Transmit	(	uint8_t	linkId,
		std::string	context,
		WifiConstPsduMap	psduMap,
		WifiTxVector	txVector,
		double	txPowerW
	)

overrideprotectedvirtual

Callback invoked when a FEM passes PSDUs to the PHY.

Parameters

linkId	the ID of the link transmitting the PSDUs
context	the context
psduMap	the PSDU map
txVector	the TX vector
txPowerW	the tx power in Watts

Reimplemented from MultiLinkOperationsTestBase.

Definition at line 2535 of file wifi-mlo-test.cc.

References ns3::Node::AddApplication(), GetApplication(), ns3::WifiMac::GetDevice(), ns3::WifiNetDevice::GetNode(), MultiLinkOperationsTestBase::m_apMac, m_errorModel, m_nQosDataFrames, m_rtsCorrupted, ns3::ListErrorModel::SetList(), and MultiLinkOperationsTestBase::Transmit().

Here is the call graph for this function:

Member Data Documentation

◆ m_errorModel

Ptr<ListErrorModel> ReleaseSeqNoAfterCtsTimeoutTest::m_errorModel

private

error rate model to corrupt first RTS frame

Definition at line 2460 of file wifi-mlo-test.cc.

Referenced by DoSetup(), and Transmit().

◆ m_nQosDataFrames

std::size_t ReleaseSeqNoAfterCtsTimeoutTest::m_nQosDataFrames

private

counter for transmitted QoS data frames

Definition at line 2459 of file wifi-mlo-test.cc.

Referenced by DoRun(), and Transmit().

◆ m_rtsCorrupted

bool ReleaseSeqNoAfterCtsTimeoutTest::m_rtsCorrupted

private

whether the first RTS frame has been corrupted

Definition at line 2461 of file wifi-mlo-test.cc.

Referenced by Transmit().

◆ m_socket

PacketSocketAddress ReleaseSeqNoAfterCtsTimeoutTest::m_socket

private

packet socket address

Definition at line 2458 of file wifi-mlo-test.cc.

Referenced by GetApplication(), and StartTraffic().

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

src/wifi/test/wifi-mlo-test.cc

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ReleaseSeqNoAfterCtsTimeoutTest()

◆ ~ReleaseSeqNoAfterCtsTimeoutTest()

Member Function Documentation

◆ DoRun()

◆ DoSetup()

◆ GetApplication()

◆ StartTraffic()

◆ Transmit()

Member Data Documentation

◆ m_errorModel

◆ m_nQosDataFrames

◆ m_rtsCorrupted

◆ m_socket