AdvancedEmlsrManager is an advanced EMLSR manager. More...

#include "advanced-emlsr-manager.h"

Inheritance diagram for ns3::AdvancedEmlsrManager:

Collaboration diagram for ns3::AdvancedEmlsrManager:

Public Member Functions
	AdvancedEmlsrManager ()

	~AdvancedEmlsrManager () override

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

	~DefaultEmlsrManager () override

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.

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.

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

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::DefaultEmlsrManager
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
void	CheckNavAndCcaLastPifs (Ptr< WifiPhy > phy, uint8_t linkId, Ptr< QosTxop > edca)
	Use information from NAV and CCA performed by the given PHY on the given link in the last PIFS interval to determine whether the given EDCAF can start a TXOP.

void	DoDispose () override
	Destructor implementation.

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.

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

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.

void	ReceivedMacHdr (Ptr< WifiPhy > phy, const WifiMacHeader &macHdr, const WifiTxVector &txVector, Time psduDuration)
	Possibly take actions when notified of the MAC header of the MPDU being received by the given PHY.

bool	RequestMainPhyToSwitch (uint8_t linkId, AcIndex aci)
	Determine whether the main PHY shall be requested to switch to the link of an aux PHY that has gained channel access through the given AC but it is not TX capable.

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::DefaultEmlsrManager
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.

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

void	SwitchMainPhyBackToPrimaryLink (uint8_t linkId)
	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	DoDispose () override
	Destructor implementation.

const WifiPhyOperatingChannel &	GetChannelForAuxPhy (uint8_t linkId) const

const WifiPhyOperatingChannel &	GetChannelForMainPhy (uint8_t linkId) const

Ptr< EhtFrameExchangeManager >	GetEhtFem (uint8_t linkId) const

MgtEmlOmn	GetEmlOmn ()

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

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

Private Attributes
bool	m_allowUlTxopInRx
	whether a (main or aux) PHY is allowed to start an UL TXOP if another PHY is receiving a PPDU

EventId	m_ccaLastPifs
	event scheduled in case of non-TX capable aux PHY to determine whether TX can be started based on whether the medium has been idle during the last PIFS interval

bool	m_interruptSwitching
	whether a main PHY switching can be interrupted to start switching to another link

Time	m_switchMainPhyBackDelay
	duration of the timer started in case of non-TX capable aux PHY when medium is sensed busy during the PIFS interval preceding/following the main PHY switch end

EventId	m_switchMainPhyBackEvent
	event scheduled in case of non-TX capable aux PHY when medium is sensed busy during the PIFS interval preceding/following the main PHY switch end

bool	m_useAuxPhyCca
	whether the CCA performed in the last PIFS interval by a non-TX capable aux PHY should be used when the main PHY ends switching to the aux PHY's link to determine whether TX can start or not

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

Additional Inherited Members
Protected Attributes inherited from ns3::DefaultEmlsrManager
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_auxPhyToSleep
	whether Aux PHY should be put into sleep mode while the Main PHY is operating on the same link as the Aux PHY

EventId	m_auxPhyToSleepEvent
	the event scheduled to put an Aux PHY into sleep mode

MainPhySwitchInfo	m_mainPhySwitchInfo
	main PHY switch info

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

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_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)

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

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

AdvancedEmlsrManager is an advanced EMLSR manager.

Definition at line 22 of file advanced-emlsr-manager.h.

Constructor & Destructor Documentation

◆ AdvancedEmlsrManager()

ns3::AdvancedEmlsrManager::AdvancedEmlsrManager ( )

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

References NS_LOG_FUNCTION.

◆ ~AdvancedEmlsrManager()

ns3::AdvancedEmlsrManager::~AdvancedEmlsrManager ( )

override

Definition at line 79 of file advanced-emlsr-manager.cc.

References NS_LOG_FUNCTION_NOARGS.

Member Function Documentation

◆ CheckNavAndCcaLastPifs()

void ns3::AdvancedEmlsrManager::CheckNavAndCcaLastPifs	(	Ptr< WifiPhy >	phy,
		uint8_t	linkId,
		Ptr< QosTxop >	edca )

protected

Use information from NAV and CCA performed by the given PHY on the given link in the last PIFS interval to determine whether the given EDCAF can start a TXOP.

This function is intended to be used when the main PHY switches channel to start an UL TXOP on a link where channel access was obtained by a non-TX capable aux PHY.

Parameters

phy	the PHY that performed CCA in the last PIFS interval
linkId	the ID of the given link
edca	the given EDCAF

Definition at line 340 of file advanced-emlsr-manager.cc.

References NS_LOG_DEBUG, and NS_LOG_FUNCTION.

◆ DoDispose()

void ns3::AdvancedEmlsrManager::DoDispose ( )

overrideprotectedvirtual

Destructor implementation.

This method is called by Dispose() or by the Object's destructor, whichever comes first.

Subclasses are expected to implement their real destruction code in an overridden version of this method and chain up to their parent's implementation once they are done. i.e, for simplicity, the destructor of every subclass should be empty and its content should be moved to the associated DoDispose() method.

It is safe to call GetObject() from within this method.

Reimplemented from ns3::Object.

Definition at line 85 of file advanced-emlsr-manager.cc.

References ns3::Object::DoDispose(), ns3::EmlsrManager::GetStaMac(), ns3::MakeCallback(), NS_LOG_FUNCTION, and ReceivedMacHdr().

Here is the call graph for this function:

◆ DoGetDelayUntilAccessRequest()

std::pair< bool, Time > ns3::AdvancedEmlsrManager::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 111 of file advanced-emlsr-manager.cc.

References ns3::DataRate::CalculateBytesTxTime(), ns3::CCA_BUSY, ns3::EmlsrManager::GetEhtFem(), ns3::EmlsrManager::GetMainPhyId(), ns3::WifiMacHeader::GetSerializedSize(), ns3::EmlsrManager::GetStaMac(), m_allowUlTxopInRx, m_useNotifiedMacHdr, Max, ns3::Simulator::Now(), NS_ASSERT, NS_ASSERT_MSG, NS_LOG_FUNCTION, and ns3::WIFI_MAC_QOSDATA.

Here is the call graph for this function:

◆ DoNotifyIcfReceived()

void ns3::AdvancedEmlsrManager::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 393 of file advanced-emlsr-manager.cc.

References NS_LOG_FUNCTION.

◆ DoNotifyTxopEnd()

void ns3::AdvancedEmlsrManager::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 238 of file advanced-emlsr-manager.cc.

References ns3::EventId::Cancel(), ns3::EmlsrManager::DONT_RESET_BACKOFF, ns3::DefaultEmlsrManager::MainPhySwitchInfo::end, ns3::DefaultEmlsrManager::MainPhySwitchInfo::from, ns3::EmlsrManager::GetMainPhyId(), ns3::EmlsrManager::GetStaMac(), ns3::DefaultEmlsrManager::m_auxPhyToReconnect, ns3::DefaultEmlsrManager::m_auxPhyToSleepEvent, m_interruptSwitching, ns3::EmlsrManager::m_mainPhyId, ns3::DefaultEmlsrManager::m_mainPhySwitchInfo, ns3::DefaultEmlsrManager::m_switchAuxPhy, ns3::Simulator::Now(), NS_ASSERT_MSG, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::EmlsrManager::REQUEST_ACCESS, ns3::Simulator::Schedule(), and ns3::EmlsrManager::SwitchMainPhy().

Here is the call graph for this function:

◆ DoNotifyUlTxopStart()

void ns3::AdvancedEmlsrManager::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 401 of file advanced-emlsr-manager.cc.

References NS_LOG_FUNCTION.

◆ DoSetWifiMac()

void ns3::AdvancedEmlsrManager::DoSetWifiMac ( Ptr< StaWifiMac > mac )

overrideprotectedvirtual

Allow subclasses to take actions when the MAC is set.

Parameters

mac	the wifi MAC

Reimplemented from ns3::EmlsrManager.

Definition at line 98 of file advanced-emlsr-manager.cc.

References ns3::EmlsrManager::GetStaMac(), ns3::MakeCallback(), NS_LOG_FUNCTION, and ReceivedMacHdr().

Here is the call graph for this function:

◆ GetDelayUnlessMainPhyTakesOverUlTxop()

std::pair< bool, Time > ns3::AdvancedEmlsrManager::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 294 of file advanced-emlsr-manager.cc.

References NS_ABORT_MSG_UNLESS, NS_ASSERT, NS_LOG_DEBUG, and NS_LOG_FUNCTION.

◆ GetTypeId()

TypeId ns3::AdvancedEmlsrManager::GetTypeId ( )

static

Get the type ID.

Returns: the object TypeId

Definition at line 28 of file advanced-emlsr-manager.cc.

References m_allowUlTxopInRx, m_interruptSwitching, m_switchMainPhyBackDelay, m_useAuxPhyCca, m_useNotifiedMacHdr, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakeTimeAccessor(), ns3::MakeTimeChecker(), ns3::MilliSeconds(), and ns3::TypeId::SetParent().

Here is the call graph for this function:

◆ ReceivedMacHdr()

void ns3::AdvancedEmlsrManager::ReceivedMacHdr	(	Ptr< WifiPhy >	phy,
		const WifiMacHeader &	macHdr,
		const WifiTxVector &	txVector,
		Time	psduDuration )

protected

Possibly take actions when notified of the MAC header of the MPDU being received by the given PHY.

Parameters

phy	the given PHY
macHdr	the MAC header of the MPDU being received
txVector	the TXVECTOR used to transmit the PSDU
psduDuration	the remaining duration of the PSDU

Definition at line 206 of file advanced-emlsr-manager.cc.

References ns3::Time::As(), ns3::WifiMacHeader::GetAddr1(), ns3::EmlsrManager::GetEhtFem(), ns3::EmlsrManager::GetStaMac(), ns3::Mac48Address::IsBroadcast(), ns3::WifiMacHeader::IsCts(), m_useNotifiedMacHdr, ns3::Time::MS, ns3::EmlsrManager::NotifyTxopEnd(), NS_LOG_FUNCTION, and ns3::Simulator::ScheduleNow().

Referenced by DoDispose(), and DoSetWifiMac().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RequestMainPhyToSwitch()

bool ns3::AdvancedEmlsrManager::RequestMainPhyToSwitch	(	uint8_t	linkId,
		AcIndex	aci )

protected

Determine whether the main PHY shall be requested to switch to the link of an aux PHY that has gained channel access through the given AC but it is not TX capable.

Parameters

linkId	the ID of the link on which the aux PHY is operating
aci	the index of the given AC

Returns: whether the main PHY shall be requested to switch to the link of the aux PHY

Definition at line 409 of file advanced-emlsr-manager.cc.

References NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::wifiAcList.

◆ SwitchMainPhyIfTxopGainedByAuxPhy()

void ns3::AdvancedEmlsrManager::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 508 of file advanced-emlsr-manager.cc.

References NS_ASSERT, NS_ASSERT_MSG, NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Member Data Documentation

◆ m_allowUlTxopInRx

bool ns3::AdvancedEmlsrManager::m_allowUlTxopInRx

private

whether a (main or aux) PHY is allowed to start an UL TXOP if another PHY is receiving a PPDU

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

Referenced by DoGetDelayUntilAccessRequest(), and GetTypeId().

◆ m_ccaLastPifs

EventId ns3::AdvancedEmlsrManager::m_ccaLastPifs

private

event scheduled in case of non-TX capable aux PHY to determine whether TX can be started based on whether the medium has been idle during the last PIFS interval

Definition at line 95 of file advanced-emlsr-manager.h.

◆ m_interruptSwitching

bool ns3::AdvancedEmlsrManager::m_interruptSwitching

private

whether a main PHY switching can be interrupted to start switching to another link

Definition at line 86 of file advanced-emlsr-manager.h.

Referenced by DoNotifyTxopEnd(), and GetTypeId().

◆ m_switchMainPhyBackDelay

Time ns3::AdvancedEmlsrManager::m_switchMainPhyBackDelay

private

duration of the timer started in case of non-TX capable aux PHY when medium is sensed busy during the PIFS interval preceding/following the main PHY switch end

Definition at line 92 of file advanced-emlsr-manager.h.

Referenced by GetTypeId().

◆ m_switchMainPhyBackEvent

EventId ns3::AdvancedEmlsrManager::m_switchMainPhyBackEvent

private

event scheduled in case of non-TX capable aux PHY when medium is sensed busy during the PIFS interval preceding/following the main PHY switch end

Definition at line 98 of file advanced-emlsr-manager.h.

◆ m_useAuxPhyCca

bool ns3::AdvancedEmlsrManager::m_useAuxPhyCca

private

whether the CCA performed in the last PIFS interval by a non-TX capable aux PHY should be used when the main PHY ends switching to the aux PHY's link to determine whether TX can start or not

Definition at line 88 of file advanced-emlsr-manager.h.

Referenced by GetTypeId().

◆ m_useNotifiedMacHdr

bool ns3::AdvancedEmlsrManager::m_useNotifiedMacHdr

private

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

Definition at line 82 of file advanced-emlsr-manager.h.

Referenced by DoGetDelayUntilAccessRequest(), GetTypeId(), and ReceivedMacHdr().

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

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ AdvancedEmlsrManager()

◆ ~AdvancedEmlsrManager()

Member Function Documentation

◆ CheckNavAndCcaLastPifs()

◆ DoDispose()

◆ DoGetDelayUntilAccessRequest()

◆ DoNotifyIcfReceived()

◆ DoNotifyTxopEnd()

◆ DoNotifyUlTxopStart()

◆ DoSetWifiMac()

◆ GetDelayUnlessMainPhyTakesOverUlTxop()

◆ GetTypeId()

◆ ReceivedMacHdr()

◆ RequestMainPhyToSwitch()

◆ SwitchMainPhyIfTxopGainedByAuxPhy()

Member Data Documentation

◆ m_allowUlTxopInRx

◆ m_ccaLastPifs

◆ m_interruptSwitching

◆ m_switchMainPhyBackDelay

◆ m_switchMainPhyBackEvent

◆ m_useAuxPhyCca

◆ m_useNotifiedMacHdr