Test the transmission of UL frames from EMLSR clients. More...

#include "wifi-emlsr-test.h"

Inheritance diagram for EmlsrUlTxopTest:

Collaboration diagram for EmlsrUlTxopTest:

Classes
struct	Params
	Parameters for the EMLSR UL TXOP test. More...

Public Member Functions
	EmlsrUlTxopTest (const Params &params)
	Constructor.

	~EmlsrUlTxopTest () override=default

Public Member Functions inherited from EmlsrOperationsTestBase
	EmlsrOperationsTestBase (const std::string &name)
	Constructor.

	~EmlsrOperationsTestBase () 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	CheckBlockAck (const WifiConstPsduMap &psduMap, const WifiTxVector &txVector, uint8_t linkId)
	Check that appropriate actions are taken when an MLD transmits a PPDU containing BlockAck frames on the given link.

void	CheckCtsFrames (Ptr< const WifiMpdu > mpdu, const WifiTxVector &txVector, uint8_t linkId)
	Check that appropriate actions are taken by the EMLSR client when receiving a CTS frame on the given link.

void	CheckQosFrames (const WifiConstPsduMap &psduMap, const WifiTxVector &txVector, uint8_t linkId)
	Check that appropriate actions are taken when an MLD transmits a PPDU containing QoS data frames on the given link.

void	CheckResults ()
	Check that the simulation produced the expected results.

void	CheckRtsFrames (Ptr< const WifiMpdu > mpdu, const WifiTxVector &txVector, uint8_t linkId)
	Check that appropriate actions are taken by the EMLSR client when transmitting an RTS frame on the given link.

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

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

void	Transmit (Ptr< WifiMac > mac, uint8_t phyId, WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW) override
	Callback invoked when a FEM passes PSDUs to the PHY.

Protected Member Functions inherited from EmlsrOperationsTestBase
void	CheckAuxPhysSleepMode (Ptr< StaWifiMac > staMac, bool sleep)
	Check whether aux PHYs of the given device are in sleep mode/awake.

void	CheckBlockedLink (Ptr< WifiMac > mac, Mac48Address dest, uint8_t linkId, WifiQueueBlockedReason reason, bool blocked, std::string description, bool testUnblockedForOtherReasons=true)
	Check whether QoS data unicast transmissions addressed to the given destination on the given link are blocked or unblocked for the given reason on the given device.

void	CheckMainPhyTraceInfo (std::size_t index, std::string_view reason, const std::optional< uint8_t > &fromLinkId, uint8_t toLinkId, bool checkFromLinkId=true, bool checkToLinkId=true)
	Check information provided by the EMLSR Manager MainPhySwitch trace.

void	CheckMsdTimerRunning (Ptr< StaWifiMac > staMac, uint8_t linkId, bool isRunning, const std::string &msg)
	Check whether the MediumSyncDelay timer is running on the given link of the given device.

Ptr< PacketSocketClient >	GetApplication (TrafficDirection dir, std::size_t staId, std::size_t count, std::size_t pktSize, uint8_t priority=0) const

void	MainPhySwitchInfoCallback (std::size_t index, const EmlsrMainPhySwitchTrace &info)
	Callback connected to the EMLSR Manager MainPhySwitch trace source.

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.

Private Member Functions
void	BackoffGenerated (uint32_t backoff, uint8_t linkId)
	Callback invoked when a new backoff value is generated by the EMLSR client.

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

Private Attributes
MHz_u	m_5thQosFrameExpWidth
	expected width of the 5th QoS data frame

Time	m_5thQosFrameTxTime
	start transmission time of the 5th QoS data frame

MHz_u	m_auxPhyChannelWidth
	max width supported by aux PHYs

std::optional< Time >	m_backoffEndTime
	expected backoff end time on main PHY link

MHz_u	m_channelWidth
	width of the channels used by MLDs

bool	m_checkBackoffStarted
	whether we are checking the generated backoff values

std::optional< bool >	m_corruptCts
	whether the transmitted CTS must be corrupted

std::size_t	m_countBlockAck
	counter for BlockAck frames

std::size_t	m_countQoSframes
	counter for QoS frames

std::size_t	m_countRtsframes
	counter for RTS frames

Time	m_emlsrEnabledTime
	when EMLSR mode has been enabled on all EMLSR clients

std::set< uint8_t >	m_emlsrLinks
	IDs of the links on which EMLSR mode has to be enabled.

Ptr< ListErrorModel >	m_errorModel
	error rate model to corrupt packets

Time	m_firstUlPktsGenTime
	generation time of the first two UL packets

bool	m_genBackoffIfTxopWithoutTx
	whether the backoff should be invoked when the AC gains the right to start a TXOP but it does not transmit any frame

Time	m_lastMsdExpiryTime
	expiry time of the last MediumSyncDelay timer

Time	m_mediumSyncDuration
	duration of the MediumSyncDelay timer

uint8_t	m_msdMaxNTxops
	Max number of TXOPs that an EMLSR client is allowed to attempt to initiate while the MediumSyncDelay timer is running (zero indicates no limit)

std::optional< uint8_t >	m_nonEmlsrLink
	ID of the non-EMLSR link (if any)

uint8_t	m_nSlotsLeftAlert
	value for ChannelAccessManager NSlotsLeft attribute

bool	m_switchMainPhyBackDelayTimeout
	whether a SwitchMainPhyBackDelay timer expires after that the main PHY moved to an aux PHY link

const Time	m_unblockMainPhyLinkDelay
	delay between the time the first two UL packets are generated and the time transmissions are unblocked on the link where the main PHY is operating on

bool	m_useAuxPhyCca
	whether CCA info from aux PHY is used when aux PHY is not TX capable

Additional Inherited Members
Public Types inherited from EmlsrOperationsTestBase
enum	TrafficDirection : uint8_t { DOWNLINK = 0 , UPLINK }
	Enumeration for traffic directions. More...

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 Attributes inherited from EmlsrOperationsTestBase
Ptr< ApWifiMac >	m_apMac
	AP wifi MAC.

const std::array< std::string, 3 >	m_channelsStr
	array of strings defining the channels for the MLD links

std::vector< PacketSocketAddress >	m_dlSockets
	packet socket address for DL traffic

Time	m_duration {0}
	simulation duration

std::vector< uint8_t >	m_establishBaDl {}
	the TIDs for which BA needs to be established with the AP as originator

std::vector< uint8_t >	m_establishBaUl {}
	the TIDs for which BA needs to be established with the AP as recipient

const std::array< FrequencyRange, 3 >	m_freqRanges
	array of frequency ranges for MLD links

uint16_t	m_lastAid {0}
	AID of last associated station.

std::set< uint8_t >	m_linksToEnableEmlsrOn
	IDs of the links on which EMLSR mode has to be enabled.

uint8_t	m_mainPhyId {0}
	ID of the main PHY.

std::size_t	m_nEmlsrStations {1}
	number of stations to create that activate EMLSR

std::size_t	m_nNonEmlsrStations {0}
	number of stations to create that do not activate EMLSR

std::size_t	m_nPhysPerEmlsrDevice {3}
	number of PHYs per EMLSR client

std::vector< Time >	m_paddingDelay
	Padding Delay advertised by the non-AP MLD.

bool	m_putAuxPhyToSleep {false}
	whether aux PHYs are put to sleep during DL/UL TXOPs

std::vector< Ptr< StaWifiMac > >	m_staMacs
	MACs of the non-AP MLDs.

std::map< std::size_t, std::shared_ptr< EmlsrMainPhySwitchTrace > >	m_traceInfo
	EMLSR client ID-indexed map of trace info from last main PHY switch.

std::vector< Time >	m_transitionDelay
	Transition Delay advertised by the non-AP MLD.

Time	m_transitionTimeout {MicroSeconds(128)}
	Transition Timeout advertised by the AP MLD.

std::vector< FrameInfo >	m_txPsdus
	transmitted PSDUs

std::vector< PacketSocketAddress >	m_ulSockets
	packet socket address for UL traffic

Detailed Description

Test the transmission of UL frames from EMLSR clients.

This test considers an AP MLD and a non-AP MLD that support EMLSR. The non-AP MLD setups three links, while the set of EMLSR links is configurable. Block ack agreements (for TID 0) for both DL and UL directions are established after that the EML Operating Mode Notification frames are exchanged to enable the EMLSR mode on the EMLSR links. Aux PHYs on the EMLSR client do not switch link, hence the main PHY will switch link (if needed) when terminating a TXOP.

It is checked that:

Initially, aux PHYs are configured so that they are unable to transmit frames. Before generating the packets for the first UL data frame, transmissions on the link where the main PHY is operating and on the non-EMLSR link (if any) are blocked. Thus, the first UL data frame is held until transmissions on the link where the main PHY is operating are unblocked. The first UL data frame is sent by the main PHY without RTS protection. When the data frame exchange terminates, the MediumSyncDelay timer is started on the other EMLSR links and the CCA ED threshold is set as expected
If there is a non-EMLSR link, another data frame can be sent concurrently (without protection) on the non-EMLSR link
When the first UL data frame is transmitted, we make the aux PHYs on the EMLSR client capable of transmitting, we block transmissions on the link where the main PHY is operating and generate new UL packets, which will then be transmitted on a link where an aux PHY is operating. Thus, the aux PHY transmits an RTS frame and the main PHY will take over and transmit the second UL data frame. We check that, while the link on which the main PHY was operating is blocked because another EMLSR link is being used, new backoff values for that link are generated if and only if the QosTxop::GenerateBackoffIfTxopWithoutTx attribute is true; otherwise, a new backoff value is generated when the link is unblocked.
When the exchange of the second UL data frame terminates, we make the aux PHY unable to transmit, block transmissions on the non-EMLSR link (if any) and generate some more UL packets, which will then be transmitted by the main PHY. However, a MediumSyncDelay timer is now running on the link where the main PHY is operating, hence transmissions are protected by an RTS frame. We install a post reception error model on the AP MLD so that all RTS frames sent by the EMLSR client are not received by the AP MLD. We check that the EMLSR client makes at most the configured max number of transmission attempts and that another UL data frame is sent once the MediumSyncDelay timer is expired. We also check that the TX width of the RTS frames and the UL data frame equal the channel width used by the main PHY.
We check that no issue arises in case an aux PHY sends an RTS frame but the CTS response is not transmitted successfully. Specifically, we check that the main PHY is completing the channel switch when the (unsuccessful) reception of the CTS ends and that a new RTS/CTS exchange is carried out to protect the transmission of the last data frame.
While the main PHY is operating on the same link as an aux PHY (which does not switch channel), the aux PHY is put in sleep mode as soon as the main PHY starts operating on the link, stays in sleep mode until the TXOP ends and is resumed from sleep mode right after the end of the DL/UL TXOP.
When an aux PHY that is not TX capable gains a TXOP, it checks whether the main PHY can switch to the auxiliary link a start an UL TXOP. If the main PHY is switching, the aux PHY waits until the channel switch is completed and checks again; if the remaining backoff time on the preferred link is greater than the channel switch delay, the main PHY is requested to switch to the auxiliary link of the aux PHY. When the channel switch is completed, if the medium is idle on the auxiliary link and the backoff is zero, the main PHY starts an UL TXOP after a PIFS period; otherwise, the main PHY starts an UL TXOP when the backoff timer counts down to zero. The QoS data frame sent by the main PHY is not protected by RTS and the bandwidth it occupies is not affected by possible limitations on the aux PHY TX bandwidth capabilities.

Also, if the PutAuxPhyToSleep attribute is set to true, it is checked that aux PHYs are in sleep mode a SIFS after receiving the ICF and are still in sleep mode right before receiving a Block Ack frame, and they are resumed from sleep after receiving the Block Ack frame.

Definition at line 637 of file wifi-emlsr-test.h.

Constructor & Destructor Documentation

◆ EmlsrUlTxopTest()

EmlsrUlTxopTest::EmlsrUlTxopTest ( const Params & params )

Constructor.

Parameters

params parameters for the EMLSR UL TXOP test

Definition at line 2680 of file wifi-emlsr-test.cc.

References EmlsrOperationsTestBase::m_duration, m_emlsrLinks, EmlsrOperationsTestBase::m_establishBaDl, EmlsrOperationsTestBase::m_establishBaUl, EmlsrOperationsTestBase::m_linksToEnableEmlsrOn, EmlsrOperationsTestBase::m_mainPhyId, EmlsrOperationsTestBase::m_nEmlsrStations, EmlsrOperationsTestBase::m_nNonEmlsrStations, m_nonEmlsrLink, EmlsrOperationsTestBase::m_putAuxPhyToSleep, EmlsrOperationsTestBase::m_transitionDelay, ns3::MicroSeconds(), NS_ABORT_MSG_IF, and ns3::Seconds().

Here is the call graph for this function:

◆ ~EmlsrUlTxopTest()

EmlsrUlTxopTest::~EmlsrUlTxopTest ( )

overridedefault

Member Function Documentation

◆ BackoffGenerated()

void EmlsrUlTxopTest::BackoffGenerated	(	uint32_t	backoff,
		uint8_t	linkId )

private

Callback invoked when a new backoff value is generated by the EMLSR client.

Parameters

backoff	the generated backoff value
linkId	the ID of the link for which the backoff value has been generated

Definition at line 2785 of file wifi-emlsr-test.cc.

References ns3::AC_BE, m_backoffEndTime, m_checkBackoffStarted, m_genBackoffIfTxopWithoutTx, EmlsrOperationsTestBase::m_mainPhyId, EmlsrOperationsTestBase::m_staMacs, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_INFO, NS_TEST_EXPECT_MSG_EQ, and ns3::Time::US.

Referenced by DoSetup().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CheckBlockAck()

void EmlsrUlTxopTest::CheckBlockAck	(	const WifiConstPsduMap &	psduMap,
		const WifiTxVector &	txVector,
		uint8_t	linkId )

protected

Check that appropriate actions are taken when an MLD transmits a PPDU containing BlockAck frames on the given link.

Parameters

psduMap	the PSDU carrying BlockAck frames
txVector	the TXVECTOR used to send the PPDU
linkId	the ID of the given link

Definition at line 3078 of file wifi-emlsr-test.cc.

References ns3::AC_BE, ns3::Time::As(), ns3::WifiPhy::CalculateTxDuration(), EmlsrOperationsTestBase::CheckAuxPhysSleepMode(), EmlsrOperationsTestBase::CheckMainPhyTraceInfo(), ns3::TimeValue::Get(), EmlsrOperationsTestBase::GetApplication(), EmlsrOperationsTestBase::m_apMac, m_backoffEndTime, m_checkBackoffStarted, m_countBlockAck, m_lastMsdExpiryTime, EmlsrOperationsTestBase::m_mainPhyId, m_nonEmlsrLink, m_nSlotsLeftAlert, EmlsrOperationsTestBase::m_staMacs, m_switchMainPhyBackDelayTimeout, m_useAuxPhyCca, Max, ns3::Time::Max(), ns3::NanoSeconds(), ns3::Simulator::Now(), ns3::Time::NS, NS_LOG_INFO, NS_TEST_ASSERT_MSG_EQ, NS_TEST_EXPECT_MSG_EQ, ns3::Simulator::Schedule(), ns3::Seconds(), EmlsrOperationsTestBase::UPLINK, and ns3::WIFI_QOSDATA_QUEUE.

Referenced by Transmit().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CheckCtsFrames()

void EmlsrUlTxopTest::CheckCtsFrames	(	Ptr< const WifiMpdu >	mpdu,
		const WifiTxVector &	txVector,
		uint8_t	linkId )

protected

Check that appropriate actions are taken by the EMLSR client when receiving a CTS frame on the given link.

Parameters

mpdu	the MPDU carrying the CTS frame
txVector	the TXVECTOR used to send the PPDU
linkId	the ID of the given link

Definition at line 3468 of file wifi-emlsr-test.cc.

References ns3::WifiPhy::CalculateTxDuration(), EmlsrOperationsTestBase::CheckAuxPhysSleepMode(), EmlsrOperationsTestBase::CheckMainPhyTraceInfo(), ns3::Time::IsZero(), EmlsrOperationsTestBase::m_apMac, m_corruptCts, m_errorModel, m_firstUlPktsGenTime, EmlsrOperationsTestBase::m_mainPhyId, m_nonEmlsrLink, EmlsrOperationsTestBase::m_staMacs, EmlsrOperationsTestBase::m_traceInfo, ns3::MAX_PROPAGATION_DELAY_USEC, ns3::MicroSeconds(), NS_LOG_INFO, NS_TEST_EXPECT_MSG_EQ, NS_TEST_EXPECT_MSG_GT, ns3::Simulator::Schedule(), and ns3::ListErrorModel::SetList().

Referenced by Transmit().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CheckQosFrames()

void EmlsrUlTxopTest::CheckQosFrames	(	const WifiConstPsduMap &	psduMap,
		const WifiTxVector &	txVector,
		uint8_t	linkId )

protected

Check that appropriate actions are taken when an MLD transmits a PPDU containing QoS data frames on the given link.

Parameters

psduMap	the PSDU(s) carrying QoS data frames
txVector	the TXVECTOR used to send the PPDU
linkId	the ID of the given link

Definition at line 2926 of file wifi-emlsr-test.cc.

References ns3::AC_BE, ns3::DataRate::CalculateBytesTxTime(), ns3::WifiPhy::CalculatePhyPreambleAndHeaderDuration(), ns3::WifiPhy::CalculateTxDuration(), EmlsrOperationsTestBase::CheckBlockedLink(), EmlsrOperationsTestBase::GetApplication(), ns3::WifiMode::GetDataRate(), ns3::WifiTxVector::GetMode(), EmlsrOperationsTestBase::m_apMac, m_countQoSframes, EmlsrOperationsTestBase::m_mainPhyId, m_nonEmlsrLink, EmlsrOperationsTestBase::m_staMacs, ns3::MAX_PROPAGATION_DELAY_USEC, ns3::MicroSeconds(), NS_LOG_INFO, ns3::Simulator::Schedule(), ns3::Simulator::ScheduleNow(), ns3::SU_STA_ID, EmlsrOperationsTestBase::UPLINK, and ns3::WIFI_QOSDATA_QUEUE.

Referenced by Transmit().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CheckResults()

void EmlsrUlTxopTest::CheckResults ( )

protected

Check that the simulation produced the expected results.

EMLSR client with EMLSR mode enabled on all links (main PHY ID = 1).

main PHY│ blocked,│ aux PHYs││main PHY blocked│ cannot │ transmit│ │ ┌───┐ ┌──┐ [link 0] │CTS│ │BA│ ────────────────────────┬───┬┴───┴┬───┬───┬┴──┴───────────────────────────────────────── │RTS│ │QoS│QoS│ └───┘ │ 6 │ 7 │ └───┴───┘ gen backoff gen backoff if MediumSyncDelay ┌──┐ (also many times) not running timer expired ┌──┐ [link 1] │BA│ │ if allowed │ │ │BA│ ─────────┬───┬───┬┴──┴───────────────────────────┬───┬─────┬───┬────┬───┬───┬┴──┴─────── │QoS│QoS│ │RTS│ ... │RTS│ │QoS│QoS│ │ 4 │ 5 │ └───┘ └───┘ │ 8 │ 9 │ └───┴───┘ └───┴───┘

[link 2] ───────────────────────────────────────────────────────────────────────────

EMLSR client with EMLSR mode enabled on links 0 and 1 (main PHY ID = 1).

main PHY │ and │ non-EMLSR│ link │ blocked,│ aux PHYs││main PHY blocked│ cannot │ transmit│ │ ┌───┐ ┌──┐ [link 0] │CTS│ │BA│ ────────────────────────┬───┬┴───┴┬───┬───┬┴──┴───────────────────────────────────────── │RTS│ │QoS│QoS│ └───┘ │ 8 │ 9 │ └───┴───┘ gen backoff gen backoff if MediumSyncDelay ┌──┐ (also many times) not running timer expired ┌──┐ [link 1] │BA│ │ if allowed │ │ │BA│ ─────────┬───┬───┬┴──┴───────────────────────────┬───┬─────┬───┬────┬───┬───┬┴──┴─────── │QoS│QoS│ │RTS│ ... │RTS│ │QoS│QoS│ │ 4 │ 5 │ └───┘ └───┘ │ 10│ 11│ └───┴───┘ └───┴───┘ ┌──┐ [link 2] │BA│ ──────────┬───┬───┬┴──┴──────────────────────────────────────────────────────────── │QoS│QoS│ │ 6 │ 7 │ └───┴───┘

For both scenarios, after the last frame exchange on the main PHY link, we have the following frame exchanges on an EMLSR link where an aux PHY is operating on. After the first frame exchange, aux PHYs are configured as non-TX capable. Note that the two frame exchanges may occur on distinct auxiliary EMLSR links.

                                        | main PHY  || main PHY  |

[ link ] ┌───┐ ┌───┐ ┌──┐|switches to||switches to| ┌──┐ [0 or 2] │CTS│ │CTS│ │BA│| preferred ||auxiliary |PIFS| │BA│ ──────┬───┬┴───X────┬───┬┴───┴┬───┬───┬┴──┴──────────────────────────────┬───┬───┬┴──┴─── │RTS│ │RTS│ │QoS│QoS│ │QoS│QoS│ └───┘ └───┘ │ X │ Y │ │ Z │ W │ └───┴───┘ └───┴───┘ For all EMLSR links scenario, X=10, Y=11, Z=12, W=13 For the scenario with a non-EMLSR link, X=12, Y=13, Z=14, W=15

Definition at line 3553 of file wifi-emlsr-test.cc.

References ns3::WifiPhy::CalculateTxDuration(), ns3::CtrlTriggerHeader::IsMuRts(), m_5thQosFrameExpWidth, m_5thQosFrameTxTime, m_auxPhyChannelWidth, m_countRtsframes, m_firstUlPktsGenTime, m_genBackoffIfTxopWithoutTx, m_lastMsdExpiryTime, EmlsrOperationsTestBase::m_mainPhyId, m_msdMaxNTxops, m_nonEmlsrLink, EmlsrOperationsTestBase::m_staMacs, m_switchMainPhyBackDelayTimeout, EmlsrOperationsTestBase::m_txPsdus, m_unblockMainPhyLinkDelay, NS_TEST_ASSERT_MSG_EQ, NS_TEST_EXPECT_MSG_EQ, NS_TEST_EXPECT_MSG_GT_OR_EQ, NS_TEST_EXPECT_MSG_LT, NS_TEST_EXPECT_MSG_LT_OR_EQ, and NS_TEST_EXPECT_MSG_NE.

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CheckRtsFrames()

void EmlsrUlTxopTest::CheckRtsFrames	(	Ptr< const WifiMpdu >	mpdu,
		const WifiTxVector &	txVector,
		uint8_t	linkId )

protected

Check that appropriate actions are taken by the EMLSR client when transmitting an RTS frame on the given link.

Parameters

mpdu	the MPDU carrying the RTS frame
txVector	the TXVECTOR used to send the PPDU
linkId	the ID of the given link

Definition at line 3430 of file wifi-emlsr-test.cc.

References ns3::CreateObject(), ns3::WifiTxVector::GetChannelWidth(), ns3::Time::IsZero(), m_corruptCts, m_countRtsframes, m_errorModel, m_firstUlPktsGenTime, EmlsrOperationsTestBase::m_mainPhyId, EmlsrOperationsTestBase::m_staMacs, NS_LOG_INFO, NS_TEST_EXPECT_MSG_EQ, and ns3::ListErrorModel::SetList().

Referenced by Transmit().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DoRun()

void EmlsrUlTxopTest::DoRun ( )

overrideprotectedvirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Implements ns3::TestCase.

Definition at line 3542 of file wifi-emlsr-test.cc.

References CheckResults(), ns3::Simulator::Destroy(), EmlsrOperationsTestBase::m_duration, ns3::Simulator::Run(), and ns3::Simulator::Stop().

Here is the call graph for this function:

◆ DoSetup()

void EmlsrUlTxopTest::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 EmlsrOperationsTestBase.

Definition at line 2729 of file wifi-emlsr-test.cc.

References ns3::AC_BE, BackoffGenerated(), ns3::Count20MHzSubchannels(), ns3::CreateObject(), EmlsrOperationsTestBase::DoSetup(), EmlsrOperationsTestBase::m_apMac, m_auxPhyChannelWidth, m_channelWidth, m_errorModel, m_genBackoffIfTxopWithoutTx, EmlsrOperationsTestBase::m_mainPhyId, m_mediumSyncDuration, m_msdMaxNTxops, m_nSlotsLeftAlert, EmlsrOperationsTestBase::m_staMacs, m_switchMainPhyBackDelayTimeout, m_useAuxPhyCca, ns3::MakeCallback(), ns3::MicroSeconds(), ns3::Config::SetDefault(), ns3::WIFI_PHY_BAND_2_4GHZ, ns3::WIFI_PHY_BAND_5GHZ, and ns3::WIFI_PHY_BAND_6GHZ.

Here is the call graph for this function:

◆ StartTraffic()

void EmlsrUlTxopTest::StartTraffic ( )

overrideprivatevirtual

Start the generation of traffic (needs to be overridden)

Reimplemented from EmlsrOperationsTestBase.

Definition at line 2882 of file wifi-emlsr-test.cc.

References EmlsrOperationsTestBase::GetApplication(), EmlsrOperationsTestBase::m_apMac, m_firstUlPktsGenTime, EmlsrOperationsTestBase::m_mainPhyId, m_nonEmlsrLink, EmlsrOperationsTestBase::m_staMacs, m_unblockMainPhyLinkDelay, ns3::MilliSeconds(), ns3::Simulator::Now(), NS_LOG_INFO, ns3::Simulator::Schedule(), and EmlsrOperationsTestBase::UPLINK.

Here is the call graph for this function:

◆ Transmit()

void EmlsrUlTxopTest::Transmit	(	Ptr< WifiMac >	mac,
		uint8_t	phyId,
		WifiConstPsduMap	psduMap,
		WifiTxVector	txVector,
		double	txPowerW )

overrideprotectedvirtual

Callback invoked when a FEM passes PSDUs to the PHY.

Parameters

mac	the MAC transmitting the PSDUs
phyId	the ID of the PHY transmitting the PSDUs
psduMap	the PSDU map
txVector	the TX vector
txPowerW	the tx power in Watts

Reimplemented from EmlsrOperationsTestBase.

Definition at line 2842 of file wifi-emlsr-test.cc.

References CheckBlockAck(), CheckCtsFrames(), CheckQosFrames(), CheckRtsFrames(), EmlsrOperationsTestBase::m_mainPhyId, EmlsrOperationsTestBase::m_txPsdus, NS_ASSERT_MSG, NS_TEST_EXPECT_MSG_EQ, EmlsrOperationsTestBase::Transmit(), ns3::WIFI_MAC_CTL_BACKRESP, ns3::WIFI_MAC_CTL_CTS, ns3::WIFI_MAC_CTL_RTS, ns3::WIFI_MAC_MGT_ASSOCIATION_REQUEST, and ns3::WIFI_MAC_QOSDATA.

Here is the call graph for this function:

Member Data Documentation

◆ m_5thQosFrameExpWidth

MHz_u EmlsrUlTxopTest::m_5thQosFrameExpWidth

private

expected width of the 5th QoS data frame

Definition at line 774 of file wifi-emlsr-test.h.

Referenced by CheckResults().

◆ m_5thQosFrameTxTime

Time EmlsrUlTxopTest::m_5thQosFrameTxTime

private

start transmission time of the 5th QoS data frame

Definition at line 773 of file wifi-emlsr-test.h.

Referenced by CheckResults().

◆ m_auxPhyChannelWidth

MHz_u EmlsrUlTxopTest::m_auxPhyChannelWidth

private

max width supported by aux PHYs

Definition at line 746 of file wifi-emlsr-test.h.

Referenced by CheckResults(), and DoSetup().

◆ m_backoffEndTime

std::optional<Time> EmlsrUlTxopTest::m_backoffEndTime

private

expected backoff end time on main PHY link

Definition at line 759 of file wifi-emlsr-test.h.

Referenced by BackoffGenerated(), and CheckBlockAck().

◆ m_channelWidth

MHz_u EmlsrUlTxopTest::m_channelWidth

private

width of the channels used by MLDs

Definition at line 745 of file wifi-emlsr-test.h.

Referenced by DoSetup().

◆ m_checkBackoffStarted

bool EmlsrUlTxopTest::m_checkBackoffStarted

private

whether we are checking the generated backoff values

Definition at line 758 of file wifi-emlsr-test.h.

Referenced by BackoffGenerated(), and CheckBlockAck().

◆ m_corruptCts

std::optional<bool> EmlsrUlTxopTest::m_corruptCts

private

whether the transmitted CTS must be corrupted

Definition at line 772 of file wifi-emlsr-test.h.

Referenced by CheckCtsFrames(), and CheckRtsFrames().

◆ m_countBlockAck

std::size_t EmlsrUlTxopTest::m_countBlockAck

private

counter for BlockAck frames

Definition at line 762 of file wifi-emlsr-test.h.

Referenced by CheckBlockAck().

◆ m_countQoSframes

std::size_t EmlsrUlTxopTest::m_countQoSframes

private

counter for QoS frames

Definition at line 761 of file wifi-emlsr-test.h.

Referenced by CheckQosFrames().

◆ m_countRtsframes

std::size_t EmlsrUlTxopTest::m_countRtsframes

private

counter for RTS frames

Definition at line 763 of file wifi-emlsr-test.h.

Referenced by CheckResults(), and CheckRtsFrames().

◆ m_emlsrEnabledTime

Time EmlsrUlTxopTest::m_emlsrEnabledTime

private

when EMLSR mode has been enabled on all EMLSR clients

Definition at line 752 of file wifi-emlsr-test.h.

◆ m_emlsrLinks

std::set<uint8_t> EmlsrUlTxopTest::m_emlsrLinks

private

IDs of the links on which EMLSR mode has to be enabled.

Definition at line 744 of file wifi-emlsr-test.h.

Referenced by EmlsrUlTxopTest().

◆ m_errorModel

Ptr<ListErrorModel> EmlsrUlTxopTest::m_errorModel

private

error rate model to corrupt packets

Definition at line 760 of file wifi-emlsr-test.h.

Referenced by CheckCtsFrames(), CheckRtsFrames(), and DoSetup().

◆ m_firstUlPktsGenTime

Time EmlsrUlTxopTest::m_firstUlPktsGenTime

private

generation time of the first two UL packets

Definition at line 753 of file wifi-emlsr-test.h.

Referenced by CheckCtsFrames(), CheckResults(), CheckRtsFrames(), and StartTraffic().

◆ m_genBackoffIfTxopWithoutTx

bool EmlsrUlTxopTest::m_genBackoffIfTxopWithoutTx

private

whether the backoff should be invoked when the AC gains the right to start a TXOP but it does not transmit any frame

Definition at line 764 of file wifi-emlsr-test.h.

Referenced by BackoffGenerated(), CheckResults(), and DoSetup().

◆ m_lastMsdExpiryTime

Time EmlsrUlTxopTest::m_lastMsdExpiryTime

private

expiry time of the last MediumSyncDelay timer

Definition at line 757 of file wifi-emlsr-test.h.

Referenced by CheckBlockAck(), and CheckResults().

◆ m_mediumSyncDuration

Time EmlsrUlTxopTest::m_mediumSyncDuration

private

duration of the MediumSyncDelay timer

Definition at line 747 of file wifi-emlsr-test.h.

Referenced by DoSetup().

◆ m_msdMaxNTxops

uint8_t EmlsrUlTxopTest::m_msdMaxNTxops

private

Max number of TXOPs that an EMLSR client is allowed to attempt to initiate while the MediumSyncDelay timer is running (zero indicates no limit)

Definition at line 748 of file wifi-emlsr-test.h.

Referenced by CheckResults(), and DoSetup().

◆ m_nonEmlsrLink

std::optional<uint8_t> EmlsrUlTxopTest::m_nonEmlsrLink

private

ID of the non-EMLSR link (if any)

Definition at line 751 of file wifi-emlsr-test.h.

Referenced by EmlsrUlTxopTest(), CheckBlockAck(), CheckCtsFrames(), CheckQosFrames(), CheckResults(), and StartTraffic().

◆ m_nSlotsLeftAlert

uint8_t EmlsrUlTxopTest::m_nSlotsLeftAlert

private

value for ChannelAccessManager NSlotsLeft attribute

Definition at line 769 of file wifi-emlsr-test.h.

Referenced by CheckBlockAck(), and DoSetup().

◆ m_switchMainPhyBackDelayTimeout

bool EmlsrUlTxopTest::m_switchMainPhyBackDelayTimeout

private

whether a SwitchMainPhyBackDelay timer expires after that the main PHY moved to an aux PHY link

Definition at line 770 of file wifi-emlsr-test.h.

Referenced by CheckBlockAck(), CheckResults(), and DoSetup().

◆ m_unblockMainPhyLinkDelay

const Time EmlsrUlTxopTest::m_unblockMainPhyLinkDelay

private

delay between the time the first two UL packets are generated and the time transmissions are unblocked on the link where the main PHY is operating on

Definition at line 754 of file wifi-emlsr-test.h.

Referenced by CheckResults(), and StartTraffic().

◆ m_useAuxPhyCca

bool EmlsrUlTxopTest::m_useAuxPhyCca

private

whether CCA info from aux PHY is used when aux PHY is not TX capable

Definition at line 767 of file wifi-emlsr-test.h.

Referenced by CheckBlockAck(), and DoSetup().

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

src/wifi/test/wifi-emlsr-test.h
src/wifi/test/wifi-emlsr-test.cc

Classes

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ EmlsrUlTxopTest()

◆ ~EmlsrUlTxopTest()

Member Function Documentation

◆ BackoffGenerated()

◆ CheckBlockAck()

◆ CheckCtsFrames()

◆ CheckQosFrames()

◆ CheckResults()

◆ CheckRtsFrames()

◆ DoRun()

◆ DoSetup()

◆ StartTraffic()

◆ Transmit()

Member Data Documentation

◆ m_5thQosFrameExpWidth

◆ m_5thQosFrameTxTime

◆ m_auxPhyChannelWidth

◆ m_backoffEndTime

◆ m_channelWidth

◆ m_checkBackoffStarted

◆ m_corruptCts

◆ m_countBlockAck

◆ m_countQoSframes

◆ m_countRtsframes

◆ m_emlsrEnabledTime

◆ m_emlsrLinks

◆ m_errorModel

◆ m_firstUlPktsGenTime

◆ m_genBackoffIfTxopWithoutTx

◆ m_lastMsdExpiryTime

◆ m_mediumSyncDuration

◆ m_msdMaxNTxops

◆ m_nonEmlsrLink

◆ m_nSlotsLeftAlert

◆ m_switchMainPhyBackDelayTimeout

◆ m_unblockMainPhyLinkDelay

◆ m_useAuxPhyCca