DefaultEmlsrManager is the default EMLSR manager. More...

#include "default-emlsr-manager.h"

Inheritance diagram for ns3::DefaultEmlsrManager:

Collaboration diagram for ns3::DefaultEmlsrManager:

Public Member Functions
	DefaultEmlsrManager ()

	~DefaultEmlsrManager () override

void	NotifyRtsSent (uint8_t linkId, Ptr< const WifiPsdu > rts, const WifiTxVector &txVector) override
	Notify that RTS transmission is starting on the given link.

Public Member Functions inherited from ns3::EmlsrManager
	EmlsrManager ()

	~EmlsrManager () override

void	CancelMediumSyncDelayTimer (uint8_t linkId)
	Cancel the MediumSyncDelay timer associated with the given link and take the appropriate actions.

std::pair< bool, Time >	CheckPossiblyReceivingIcf (uint8_t linkId) const
	Check whether a PPDU that may be an ICF is being received on the given link.

void	DecrementMediumSyncDelayNTxops (uint8_t linkId)
	Decrement the counter indicating the number of TXOP attempts left while the MediumSyncDelay timer is running.

bool	GetAuxPhyTxCapable () const

bool	GetCamStateReset () const

std::pair< bool, Time >	GetDelayUntilAccessRequest (uint8_t linkId, AcIndex aci)
	Notify that an UL TXOP is gained on the given link by the given AC.

std::optional< Time >	GetElapsedMediumSyncDelayTimer (uint8_t linkId) const
	Check whether the MediumSyncDelay timer is running for the STA operating on the given link.

const std::set< uint8_t > &	GetEmlsrLinks () const

bool	GetInDeviceInterference () const

uint8_t	GetMainPhyId () const

Time	GetMediumSyncDuration () const

std::optional< uint8_t >	GetMediumSyncMaxNTxops () const

int8_t	GetMediumSyncOfdmEdThreshold () const

std::optional< Time >	GetTransitionTimeout () const

bool	MediumSyncDelayNTxopsExceeded (uint8_t linkId)
	Return whether no more TXOP attempt is allowed on the given link.

void	NotifyIcfReceived (uint8_t linkId)
	Notify the reception of an initial Control frame on the given link.

virtual void	NotifyInDeviceInterferenceStart (uint8_t linkId, Time duration)
	Notify that an STA affiliated with the EMLSR client is causing in-device interference for the given amount of time.

void	NotifyMgtFrameReceived (Ptr< const WifiMpdu > mpdu, uint8_t linkId)
	Notify the reception of a management frame addressed to us.

void	NotifyProtectionCompleted (uint8_t linkId)
	Notify that protection (if required) is completed and data frame exchange can start on the given link.

void	NotifyTxopEnd (uint8_t linkId, bool ulTxopNotStarted=false, bool ongoingDlTxop=false)
	Notify the end of a TXOP on the given link.

void	NotifyUlTxopStart (uint8_t linkId)
	Notify the start of an UL TXOP on the given link.

void	ResetMediumSyncDelayNTxops (uint8_t linkId)
	Reset the counter indicating the number of TXOP attempts left while the MediumSyncDelay timer is running, so as to remove the limit on the number of attempts that can be made while the MediumSyncDelay timer is running.

void	SetAuxPhyTxCapable (bool capable)
	Set the member variable indicating whether Aux PHYs are capable of transmitting PPDUs.

void	SetCamStateReset (bool enable)
	Set the member variable indicating whether the state of the CAM should be reset when the main PHY switches channel and operates on the link associated with the CAM.

void	SetEmlsrLinks (const std::set< uint8_t > &linkIds)
	Take actions to enable EMLSR mode on the given set of links, if non-empty, or disable EMLSR mode, otherwise.

void	SetInDeviceInterference (bool enable)
	Set the member variable indicating whether in-device interference is such that a PHY cannot decode anything and cannot decrease the backoff counter when another PHY is transmitting.

void	SetMediumSyncDuration (Time duration)
	Set the duration of the MediumSyncDelay timer.

void	SetMediumSyncMaxNTxops (std::optional< uint8_t > nTxops)
	Set the maximum number of TXOPs a non-AP STA is allowed to attempt to initiate while the MediumSyncDelay timer is running.

void	SetMediumSyncOfdmEdThreshold (int8_t threshold)
	Set the Medium Synchronization OFDM ED threshold (dBm) to use while the MediumSyncDelay timer is running.

void	SetTransitionTimeout (Time timeout)
	Set the Transition Timeout advertised by the associated AP with EMLSR activated.

void	SetWifiMac (Ptr< StaWifiMac > mac)
	Set the wifi MAC.

Public Member Functions inherited from ns3::Object
	Object ()
	Constructor.

	~Object () override
	Destructor.

void	AggregateObject (Ptr< Object > other)
	Aggregate two Objects together.

void	Dispose ()
	Dispose of this Object.

AggregateIterator	GetAggregateIterator () const
	Get an iterator to the Objects aggregated to this one.

TypeId	GetInstanceTypeId () const override
	Get the most derived TypeId for this Object.

template<typename T >
Ptr< T >	GetObject () const
	Get a pointer to the requested aggregated Object.

template<>
Ptr< Object >	GetObject () const
	Specialization of () for objects of type ns3::Object.

template<typename T >
Ptr< T >	GetObject (TypeId tid) const
	Get a pointer to the requested aggregated Object by TypeId.

template<>
Ptr< Object >	GetObject (TypeId tid) const
	Specialization of (TypeId tid) for objects of type ns3::Object.

void	Initialize ()
	Invoke DoInitialize on all Objects aggregated to this one.

bool	IsInitialized () const
	Check if the object has been initialized.

void	UnidirectionalAggregateObject (Ptr< Object > other)
	Aggregate an Object to another Object.

Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
	SimpleRefCount ()
	Default constructor.

	SimpleRefCount (const SimpleRefCount &o)
	Copy constructor.

uint32_t	GetReferenceCount () const
	Get the reference count of the object.

SimpleRefCount &	operator= (const SimpleRefCount &o)
	Assignment operator.

void	Ref () const
	Increment the reference count.

void	Unref () const
	Decrement the reference count.

Public Member Functions inherited from ns3::ObjectBase
virtual	~ObjectBase ()
	Virtual destructor.

void	GetAttribute (std::string name, AttributeValue &value, bool permissive=false) const
	Get the value of an attribute, raising fatal errors if unsuccessful.

bool	GetAttributeFailSafe (std::string name, AttributeValue &value) const
	Get the value of an attribute without raising errors.

void	SetAttribute (std::string name, const AttributeValue &value)
	Set a single attribute, raising fatal errors if unsuccessful.

bool	SetAttributeFailSafe (std::string name, const AttributeValue &value)
	Set a single attribute without raising errors.

bool	TraceConnect (std::string name, std::string context, const CallbackBase &cb)
	Connect a TraceSource to a Callback with a context.

bool	TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
	Connect a TraceSource to a Callback without a context.

bool	TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
	Disconnect from a TraceSource a Callback previously connected with a context.

bool	TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
	Disconnect from a TraceSource a Callback previously connected without a context.

Static Public Member Functions
static TypeId	GetTypeId ()
	Get the type ID.

Static Public Member Functions inherited from ns3::EmlsrManager
static TypeId	GetTypeId ()
	Get the type ID.

Static Public Member Functions inherited from ns3::Object
static TypeId	GetTypeId ()
	Register this type.

Static Public Member Functions inherited from ns3::ObjectBase
static TypeId	GetTypeId ()
	Get the type ID.

Protected Member Functions
std::pair< bool, Time >	DoGetDelayUntilAccessRequest (uint8_t linkId) override
	Subclasses have to provide an implementation for this method, that is called by the base class when the EMLSR client gets channel access on the given link.

std::pair< bool, Time >	GetDelayUnlessMainPhyTakesOverUlTxop (uint8_t linkId) override
	Subclasses have to provide an implementation for this method, that is called by the base class when the EMLSR client gets channel access on the given link, on which an aux PHY that is TX capable is operating.

uint8_t	GetLinkToSendEmlOmn () override

Time	GetTimeToCtsEnd (uint8_t linkId) const
	This function is intended to be called when an aux PHY is about to transmit an RTS on the given link to calculate the time remaining to the end of the CTS reception.

Time	GetTimeToCtsEnd (uint8_t linkId, const WifiTxVector &rtsTxVector) const
	This function is intended to be called when an aux PHY is about to transmit an RTS on the given link to calculate the time remaining to the end of the CTS reception.

void	NotifyEmlsrModeChanged () override
	Notify subclass that EMLSR mode changed.

std::optional< uint8_t >	ResendNotification (Ptr< const WifiMpdu > mpdu) override
	A previous EML Operating Mode Notification frame was dropped.

void	SwitchMainPhyBackToPreferredLink (uint8_t linkId, EmlsrMainPhySwitchTrace &&traceInfo)
	This method can only be called when aux PHYs do not switch link.

void	SwitchMainPhyIfTxopGainedByAuxPhy (uint8_t linkId, AcIndex aci) override
	Subclasses have to provide an implementation for this method, that is called by the base class when the given AC of the EMLSR client gets channel access on the given link, on which an aux PHY that is not TX capable is operating.

Protected Member Functions inherited from ns3::EmlsrManager
void	CancelAllSleepEvents ()
	Cancel all pending events to put aux PHYs into sleep/awake state.

void	DoDispose () override
	Destructor implementation.

virtual void	DoSetWifiMac (Ptr< StaWifiMac > mac)
	Allow subclasses to take actions when the MAC is set.

virtual void	EmlsrLinkSwitchCallback (uint8_t linkId, Ptr< WifiPhy > phy)
	Callback connected to the EmlsrLinkSwitch trace source of StaWifiMac.

const WifiPhyOperatingChannel &	GetChannelForAuxPhy (uint8_t linkId) const

const WifiPhyOperatingChannel &	GetChannelForMainPhy (uint8_t linkId) const

Ptr< EhtFrameExchangeManager >	GetEhtFem (uint8_t linkId) const

MgtEmlOmn	GetEmlOmn ()

bool	GetExpectedAccessWithinDelay (uint8_t linkId, const Time &delay) const
	Get whether channel access is expected to be granted on the given link within the given delay to an Access Category that has traffic to send on the given link.

Ptr< StaWifiMac >	GetStaMac () const

void	SetCcaEdThresholdOnLinkSwitch (Ptr< WifiPhy > phy, uint8_t linkId)
	Set the CCA ED threshold (if needed) on the given PHY that is switching channel to operate on the given link.

void	SetSleepStateForAllAuxPhys (bool sleep)
	Set sleep state or awake state for all aux PHYs.

void	SwitchAuxPhy (Ptr< WifiPhy > auxPhy, uint8_t currLinkId, uint8_t nextLinkId)
	Switch channel on the Aux PHY operating on the given current link so that it operates on the given next link.

void	SwitchMainPhy (uint8_t linkId, bool noSwitchDelay, bool resetBackoff, bool requestAccess, EmlsrMainPhySwitchTrace &&traceInfo)
	Switch channel on the Main PHY so that it operates on the given link.

Protected Member Functions inherited from ns3::Object
	Object (const Object &o)
	Copy an Object.

virtual void	DoInitialize ()
	Initialize() implementation.

virtual void	NotifyNewAggregate ()
	Notify all Objects aggregated to this one of a new Object being aggregated.

Protected Member Functions inherited from ns3::ObjectBase
void	ConstructSelf (const AttributeConstructionList &attributes)
	Complete construction of ObjectBase; invoked by derived classes.

virtual void	NotifyConstructionCompleted ()
	Notifier called once the ObjectBase is fully constructed.

Protected Attributes
EventId	m_auxPhySwitchEvent
	event scheduled for an aux PHY to switch link

Ptr< WifiPhy >	m_auxPhyToReconnect
	Aux PHY the ChannelAccessManager of the link on which the main PHY is operating has to connect a listener to when the main PHY is back operating on its previous link.

bool	m_switchAuxPhy
	whether Aux PHY should switch channel to operate on the link on which the Main PHY was operating before moving to the link of the Aux PHY

std::map< uint8_t, Time >	m_switchMainPhyOnRtsTx
	link ID-indexed map of the time when an RTS that requires the main PHY to switch link is expected to be transmitted on the link

Protected Attributes inherited from ns3::EmlsrManager
WifiModulationClass	m_auxPhyMaxModClass
	max modulation class supported by aux PHYs

MHz_u	m_auxPhyMaxWidth
	max channel width supported by aux PHYs

bool	m_auxPhyToSleep
	whether Aux PHYs should be put into sleep mode while the Main PHY is carrying out a (DL or UL) TXOP

std::map< uint8_t, EventId >	m_auxPhyToSleepEvents
	PHY ID-indexed map of events scheduled to put an Aux PHY to sleep.

bool	m_auxPhyTxCapable
	whether Aux PHYs are capable of transmitting PPDUs

Time	m_emlsrPaddingDelay
	EMLSR Padding delay.

Time	m_emlsrTransitionDelay
	EMLSR Transition delay.

uint8_t	m_mainPhyId
	ID of main PHY (position in the vector of PHYs held by WifiNetDevice)

MainPhySwitchInfo	m_mainPhySwitchInfo
	main PHY switch info

std::map< uint8_t, Time >	m_startSleep
	PHY ID-indexed map of last time sleep mode started.

std::map< uint8_t, EventId >	m_ulMainPhySwitch
	link ID-indexed map of timers started when an aux PHY gains an UL TXOP and schedules a channel switch for the main PHY

bool	m_useNotifiedMacHdr
	whether to use the information about the MAC header of the MPDU being received (if notified by the PHY)

Private Member Functions
void	DoNotifyIcfReceived (uint8_t linkId) override
	Notify the subclass of the reception of an initial Control frame on the given link.

void	DoNotifyMgtFrameReceived (Ptr< const WifiMpdu > mpdu, uint8_t linkId) override
	Notify the subclass of the reception of a management frame addressed to us.

void	DoNotifyTxopEnd (uint8_t linkId) override
	Notify the subclass of the end of a TXOP on the given link.

void	DoNotifyUlTxopStart (uint8_t linkId) override
	Notify the subclass of the start of an UL TXOP on the given link.

void	NotifyMainPhySwitch (std::optional< uint8_t > currLinkId, uint8_t nextLinkId, Ptr< WifiPhy > auxPhy, Time duration) override
	Notify subclass that the main PHY is switching channel to operate on another link.

void	SwitchAuxPhyAfterMainPhy (Ptr< WifiPhy > auxPhy, uint8_t currLinkId, uint8_t nextLinkId, Time duration)
	This function shall be called when the main PHY starts switching to a link on which an aux PHY that is capable of switching link is operating.

Additional Inherited Members
Static Public Attributes inherited from ns3::EmlsrManager
static constexpr uint16_t	MEDIUM_SYNC_THRESHOLD_USEC = 72
	The aMediumSyncThreshold defined by Sec. 35.3.16.18.1 of 802.11be D4.0.

Static Protected Attributes inherited from ns3::EmlsrManager
static constexpr bool	DONT_REQUEST_ACCESS
	do not request channel access when PHY switch ends

static constexpr bool	DONT_RESET_BACKOFF = false
	do not reset backoff on main PHY switch

static constexpr bool	REQUEST_ACCESS = true
	request channel access when PHY switch ends

static constexpr bool	RESET_BACKOFF = true
	reset backoff on main PHY switch

Related Symbols inherited from ns3::ObjectBase
static TypeId	GetObjectIid ()
	Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly.

Detailed Description

DefaultEmlsrManager is the default EMLSR manager.

Definition at line 24 of file default-emlsr-manager.h.

Constructor & Destructor Documentation

◆ DefaultEmlsrManager()

ns3::DefaultEmlsrManager::DefaultEmlsrManager ( )

Definition at line 48 of file default-emlsr-manager.cc.

References NS_LOG_FUNCTION.

◆ ~DefaultEmlsrManager()

ns3::DefaultEmlsrManager::~DefaultEmlsrManager ( )

override

Definition at line 53 of file default-emlsr-manager.cc.

References NS_LOG_FUNCTION_NOARGS.

Member Function Documentation

◆ DoGetDelayUntilAccessRequest()

std::pair< bool, Time > ns3::DefaultEmlsrManager::DoGetDelayUntilAccessRequest ( uint8_t linkId )

overrideprotectedvirtual

Subclasses have to provide an implementation for this method, that is called by the base class when the EMLSR client gets channel access on the given link.

This method has to check possible reasons to give up the TXOP that apply to both main PHY and aux PHYs.

Parameters

linkId the ID of the given link

Returns: a pair consisting of a boolean value indicating whether the UL TXOP can be started and a Time value indicating the delay after which the EMLSR client must restart channel access (if needed) in case the UL TXOP is not started

Implements ns3::EmlsrManager.

Definition at line 189 of file default-emlsr-manager.cc.

References NS_LOG_FUNCTION.

◆ DoNotifyIcfReceived()

void ns3::DefaultEmlsrManager::DoNotifyIcfReceived ( uint8_t linkId )

overrideprivatevirtual

Notify the subclass of the reception of an initial Control frame on the given link.

Parameters

linkId the ID of the link on which the initial Control frame was received

Implements ns3::EmlsrManager.

Definition at line 196 of file default-emlsr-manager.cc.

References NS_LOG_FUNCTION.

◆ DoNotifyMgtFrameReceived()

void ns3::DefaultEmlsrManager::DoNotifyMgtFrameReceived	(	Ptr< const WifiMpdu >	mpdu,
		uint8_t	linkId )

overrideprivatevirtual

Notify the subclass of the reception of a management frame addressed to us.

Parameters

mpdu	the received MPDU
linkId	the ID of the link over which the MPDU was received

Implements ns3::EmlsrManager.

Definition at line 59 of file default-emlsr-manager.cc.

References NS_LOG_FUNCTION.

◆ DoNotifyTxopEnd()

void ns3::DefaultEmlsrManager::DoNotifyTxopEnd ( uint8_t linkId )

overrideprivatevirtual

Notify the subclass of the end of a TXOP on the given link.

Parameters

linkId the ID of the given link

Implements ns3::EmlsrManager.

Definition at line 208 of file default-emlsr-manager.cc.

References ns3::EmlsrManager::GetStaMac(), ns3::EmlsrManager::m_mainPhyId, m_switchAuxPhy, NS_LOG_FUNCTION, and SwitchMainPhyBackToPreferredLink().

Here is the call graph for this function:

◆ DoNotifyUlTxopStart()

void ns3::DefaultEmlsrManager::DoNotifyUlTxopStart ( uint8_t linkId )

overrideprivatevirtual

Notify the subclass of the start of an UL TXOP on the given link.

Parameters

linkId the ID of the given link

Implements ns3::EmlsrManager.

Definition at line 202 of file default-emlsr-manager.cc.

References NS_LOG_FUNCTION.

◆ GetDelayUnlessMainPhyTakesOverUlTxop()

std::pair< bool, Time > ns3::DefaultEmlsrManager::GetDelayUnlessMainPhyTakesOverUlTxop ( uint8_t linkId )

overrideprotectedvirtual

Subclasses have to provide an implementation for this method, that is called by the base class when the EMLSR client gets channel access on the given link, on which an aux PHY that is TX capable is operating.

This method has to request the main PHY to switch to the given link to take over the TXOP, if possible, or determine the delay after which the EMLSR client restarts channel access on the given link, otherwise.

Parameters

linkId the ID of the given link

Returns: a pair consisting of a boolean value indicating whether the UL TXOP can be started and a Time value indicating the delay after which the EMLSR client must restart channel access (if needed) in case the UL TXOP is not started

Implements ns3::EmlsrManager.

Definition at line 311 of file default-emlsr-manager.cc.

References NS_ABORT_MSG, NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by ns3::AdvancedEmlsrManager::GetDelayUnlessMainPhyTakesOverUlTxop().

Here is the caller graph for this function:

◆ GetLinkToSendEmlOmn()

uint8_t ns3::DefaultEmlsrManager::GetLinkToSendEmlOmn ( )

overrideprotectedvirtual

Returns: the ID of the link on which the EML Operating Mode Notification frame has to be sent

Implements ns3::EmlsrManager.

Definition at line 65 of file default-emlsr-manager.cc.

References ns3::EmlsrManager::GetStaMac(), ns3::EmlsrManager::m_mainPhyId, NS_ASSERT_MSG, and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ GetTimeToCtsEnd() [1/2]

Time ns3::DefaultEmlsrManager::GetTimeToCtsEnd ( uint8_t linkId ) const

protected

This function is intended to be called when an aux PHY is about to transmit an RTS on the given link to calculate the time remaining to the end of the CTS reception.

Parameters

linkId the ID of the given link

Returns: the time remaining to the end of the CTS reception

Definition at line 277 of file default-emlsr-manager.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::AdvancedEmlsrManager::GetDelayUnlessMainPhyTakesOverUlTxop().

Here is the caller graph for this function:

◆ GetTimeToCtsEnd() [2/2]

Time ns3::DefaultEmlsrManager::GetTimeToCtsEnd	(	uint8_t	linkId,
		const WifiTxVector &	rtsTxVector ) const

protected

This function is intended to be called when an aux PHY is about to transmit an RTS on the given link to calculate the time remaining to the end of the CTS reception.

Parameters

linkId	the ID of the given link
rtsTxVector	the TXVECTOR used to transmit the RTS

Returns: the time remaining to the end of the CTS reception

Definition at line 289 of file default-emlsr-manager.cc.

References ns3::GetCtsSize(), ns3::WifiTxVector::GetMode(), ns3::GetRtsSize(), ns3::MicroSeconds(), NS_ASSERT_MSG, and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ GetTypeId()

TypeId ns3::DefaultEmlsrManager::GetTypeId ( )

static

Get the type ID.

Returns: the object TypeId

Definition at line 29 of file default-emlsr-manager.cc.

References m_switchAuxPhy, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), and ns3::TypeId::SetParent().

Here is the call graph for this function:

◆ NotifyEmlsrModeChanged()

void ns3::DefaultEmlsrManager::NotifyEmlsrModeChanged ( )

overrideprotectedvirtual

Notify subclass that EMLSR mode changed.

Implements ns3::EmlsrManager.

Definition at line 83 of file default-emlsr-manager.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::AdvancedEmlsrManager::NotifyEmlsrModeChanged().

Here is the caller graph for this function:

◆ NotifyMainPhySwitch()

void ns3::DefaultEmlsrManager::NotifyMainPhySwitch	(	std::optional< uint8_t >	currLinkId,
		uint8_t	nextLinkId,
		Ptr< WifiPhy >	auxPhy,
		Time	duration )

overrideprivatevirtual

Notify subclass that the main PHY is switching channel to operate on another link.

Parameters

currLinkId	the ID of the link on which the main PHY is operating (if any)
nextLinkId	the ID of the link on which the main PHY will be operating
auxPhy	the aux PHY operating on the link on which the main PHY will be operating
duration	the channel switch duration

Implements ns3::EmlsrManager.

Definition at line 89 of file default-emlsr-manager.cc.

References ns3::Time::As(), ns3::EventId::Cancel(), ns3::EmlsrManager::MainPhySwitchInfo::from, ns3::EmlsrManager::GetMainPhyId(), ns3::EmlsrManager::GetStaMac(), m_auxPhySwitchEvent, m_auxPhyToReconnect, ns3::EmlsrManager::m_mainPhySwitchInfo, m_switchAuxPhy, NS_ASSERT_MSG, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Seconds(), ns3::EmlsrManager::SetCcaEdThresholdOnLinkSwitch(), SwitchAuxPhyAfterMainPhy(), and ns3::Time::US.

Here is the call graph for this function:

◆ NotifyRtsSent()

void ns3::DefaultEmlsrManager::NotifyRtsSent	(	uint8_t	linkId,
		Ptr< const WifiPsdu >	rts,
		const WifiTxVector &	txVector )

overridevirtual

Notify that RTS transmission is starting on the given link.

Parameters

linkId	the ID of the given link
rts	the RTS being transmitted
txVector	the TXVECTOR used to transmit the RTS

Reimplemented from ns3::EmlsrManager.

Definition at line 350 of file default-emlsr-manager.cc.

References NS_ASSERT_MSG, NS_LOG_DEBUG, and NS_LOG_FUNCTION.

◆ ResendNotification()

std::optional< uint8_t > ns3::DefaultEmlsrManager::ResendNotification ( Ptr< const WifiMpdu > mpdu )

overrideprotectedvirtual

A previous EML Operating Mode Notification frame was dropped.

Ask the subclass whether the frame needs to be re-sent on the given link (if any).

Parameters

mpdu	the dropped MPDU that includes the EML Operating Mode Notification frame

Returns: the ID of the link over which to re-send the frame, if needed

Implements ns3::EmlsrManager.

Definition at line 74 of file default-emlsr-manager.cc.

References ns3::EmlsrManager::GetStaMac(), ns3::EmlsrManager::m_mainPhyId, NS_ASSERT_MSG, and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ SwitchAuxPhyAfterMainPhy()

void ns3::DefaultEmlsrManager::SwitchAuxPhyAfterMainPhy	(	Ptr< WifiPhy >	auxPhy,
		uint8_t	currLinkId,
		uint8_t	nextLinkId,
		Time	duration )

private

This function shall be called when the main PHY starts switching to a link on which an aux PHY that is capable of switching link is operating.

This function schedules the aux PHY switch to occur when the main PHY completes the switch and, in case the connection of the main PHY to the aux PHY link is postponed because the aux PHY is receiving a PPDU, the aux PHY switch is postponed accordingly.

Parameters

auxPhy	the aux PHY that has to switch link
currLinkId	the link on which the aux PHY is operating
nextLinkId	the link to which the aux PHY will switch
duration	the remaining time until the aux PHY switch starts

Definition at line 143 of file default-emlsr-manager.cc.

References ns3::Time::As(), ns3::EmlsrManager::CheckPossiblyReceivingIcf(), ns3::EmlsrManager::GetStaMac(), ns3::Time::IsStrictlyPositive(), m_auxPhySwitchEvent, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Simulator::Schedule(), ns3::EmlsrManager::SwitchAuxPhy(), SwitchAuxPhyAfterMainPhy(), and ns3::Time::US.

Referenced by NotifyMainPhySwitch(), and SwitchAuxPhyAfterMainPhy().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SwitchMainPhyBackToPreferredLink()

void ns3::DefaultEmlsrManager::SwitchMainPhyBackToPreferredLink	(	uint8_t	linkId,
		EmlsrMainPhySwitchTrace &&	traceInfo )

protected

This method can only be called when aux PHYs do not switch link.

Switch the main PHY back to the preferred link and reconnect the aux PHY that was operating on the link left by the main PHY.

Parameters

linkId	the ID of the link that the main PHY is leaving
traceInfo	information to pass to the main PHY switch traced callback (the fromLinkId and toLinkId fields are set by SwitchMainPhy)

Definition at line 222 of file default-emlsr-manager.cc.

References ns3::EmlsrManager::DONT_RESET_BACKOFF, ns3::EmlsrManager::GetMainPhyId(), ns3::EmlsrManager::GetStaMac(), m_auxPhyToReconnect, ns3::EmlsrManager::m_mainPhyId, m_switchAuxPhy, NS_ABORT_MSG_IF, NS_LOG_FUNCTION, ns3::EmlsrManager::REQUEST_ACCESS, ns3::Simulator::Schedule(), and ns3::EmlsrManager::SwitchMainPhy().

Referenced by ns3::AdvancedEmlsrManager::CheckNavAndCcaLastPifs(), DoNotifyTxopEnd(), and ns3::AdvancedEmlsrManager::SwitchMainPhyBackDelayExpired().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SwitchMainPhyIfTxopGainedByAuxPhy()

void ns3::DefaultEmlsrManager::SwitchMainPhyIfTxopGainedByAuxPhy	(	uint8_t	linkId,
		AcIndex	aci )

overrideprotectedvirtual

Subclasses have to provide an implementation for this method, that is called by the base class when the given AC of the EMLSR client gets channel access on the given link, on which an aux PHY that is not TX capable is operating.

This method has to request the main PHY to switch to the given link to take over the TXOP, unless it is decided to give up the TXOP.

Parameters

linkId	the ID of the given link
aci	the index of the given AC

Implements ns3::EmlsrManager.

Definition at line 270 of file default-emlsr-manager.cc.

References NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Member Data Documentation

◆ m_auxPhySwitchEvent

EventId ns3::DefaultEmlsrManager::m_auxPhySwitchEvent

protected

event scheduled for an aux PHY to switch link

Definition at line 83 of file default-emlsr-manager.h.

Referenced by NotifyMainPhySwitch(), and SwitchAuxPhyAfterMainPhy().

◆ m_auxPhyToReconnect

Ptr<WifiPhy> ns3::DefaultEmlsrManager::m_auxPhyToReconnect

protected

Aux PHY the ChannelAccessManager of the link on which the main PHY is operating has to connect a listener to when the main PHY is back operating on its previous link.

Definition at line 80 of file default-emlsr-manager.h.

Referenced by ns3::AdvancedEmlsrManager::DoNotifyTxopEnd(), NotifyMainPhySwitch(), and SwitchMainPhyBackToPreferredLink().

◆ m_switchAuxPhy

bool ns3::DefaultEmlsrManager::m_switchAuxPhy

protected

whether Aux PHY should switch channel to operate on the link on which the Main PHY was operating before moving to the link of the Aux PHY

Definition at line 78 of file default-emlsr-manager.h.

Referenced by ns3::AdvancedEmlsrManager::CheckNavAndCcaLastPifs(), ns3::AdvancedEmlsrManager::DoNotifyTxopEnd(), DoNotifyTxopEnd(), GetTypeId(), NotifyMainPhySwitch(), ns3::AdvancedEmlsrManager::SwitchMainPhyBackDelayExpired(), and SwitchMainPhyBackToPreferredLink().

◆ m_switchMainPhyOnRtsTx

std::map<uint8_t, Time> ns3::DefaultEmlsrManager::m_switchMainPhyOnRtsTx

protected

link ID-indexed map of the time when an RTS that requires the main PHY to switch link is expected to be transmitted on the link

Definition at line 84 of file default-emlsr-manager.h.

Referenced by ns3::AdvancedEmlsrManager::GetDelayUnlessMainPhyTakesOverUlTxop().

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

src/wifi/model/eht/default-emlsr-manager.h
src/wifi/model/eht/default-emlsr-manager.cc

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ DefaultEmlsrManager()

◆ ~DefaultEmlsrManager()

Member Function Documentation

◆ DoGetDelayUntilAccessRequest()

◆ DoNotifyIcfReceived()

◆ DoNotifyMgtFrameReceived()

◆ DoNotifyTxopEnd()

◆ DoNotifyUlTxopStart()

◆ GetDelayUnlessMainPhyTakesOverUlTxop()

◆ GetLinkToSendEmlOmn()

◆ GetTimeToCtsEnd() [1/2]

◆ GetTimeToCtsEnd() [2/2]

◆ GetTypeId()

◆ NotifyEmlsrModeChanged()

◆ NotifyMainPhySwitch()

◆ NotifyRtsSent()

◆ ResendNotification()

◆ SwitchAuxPhyAfterMainPhy()

◆ SwitchMainPhyBackToPreferredLink()

◆ SwitchMainPhyIfTxopGainedByAuxPhy()

Member Data Documentation

◆ m_auxPhySwitchEvent

◆ m_auxPhyToReconnect

◆ m_switchAuxPhy

◆ m_switchMainPhyOnRtsTx