Handle packet fragmentation and retransmissions for QoS data frames as well as MSDU aggregation (A-MSDU) and block ack sessions, for a given access class. More...

#include "qos-txop.h"

Inheritance diagram for ns3::QosTxop:

Collaboration diagram for ns3::QosTxop:

Classes
struct	QosLinkEntity
	Structure holding information specific to a single link. More...

Public Member Functions
	QosTxop (AcIndex ac=AC_UNDEF)
	Constructor. More...

	~QosTxop () override

void	AddBaResponseTimeout (Mac48Address recipient, uint8_t tid)
	Callback when ADDBA response is not received after timeout. More...

void	AssignSequenceNumber (Ptr< WifiMpdu > mpdu) const
	Assign a sequence number to the given MPDU, if it is not a fragment and it is not a retransmitted frame. More...

void	CompleteMpduTx (Ptr< WifiMpdu > mpdu)
	Stores an MPDU (part of an A-MPDU) in block ack agreement (i.e. More...

bool	EdcaDisabled (uint8_t linkId) const
	Return true if the EDCA is disabled (the MU EDCA Timer is running and the MU AIFSN is zero) for the given link, false otherwise. More...

AcIndex	GetAccessCategory () const
	Get the access category of this object. More...

Time	GetAddBaResponseTimeout () const
	Get the timeout for ADDBA response. More...

uint8_t	GetAifsn (uint8_t linkId) const override
	For the given link, return the number of slots that make up an AIFS according to the EDCA Parameter Set or the MU EDCA Parameter Set, depending on whether the MU EDCA Timer is running or not. More...

uint16_t	GetBaBufferSize (Mac48Address address, uint8_t tid) const

Ptr< BlockAckManager >	GetBaManager ()
	Get the Block Ack Manager associated with this QosTxop. More...

uint16_t	GetBaStartingSequence (Mac48Address address, uint8_t tid) const

uint16_t	GetBlockAckInactivityTimeout () const
	Get the BlockAck inactivity timeout. More...

uint8_t	GetBlockAckThreshold () const
	Return the current threshold for block ack mechanism. More...

Time	GetFailedAddBaTimeout () const
	Get the timeout for failed BA agreement. More...

uint32_t	GetMaxCw (uint8_t linkId) const override
	For the given link, return the maximum contention window size from the EDCA Parameter Set or the MU EDCA Parameter Set, depending on whether the MU EDCA Timer is running or not. More...

uint32_t	GetMinCw (uint8_t linkId) const override
	For the given link, return the minimum contention window size from the EDCA Parameter Set or the MU EDCA Parameter Set, depending on whether the MU EDCA Timer is running or not. More...

Ptr< WifiMpdu >	GetNextMpdu (uint8_t linkId, Ptr< WifiMpdu > peekedItem, WifiTxParameters &txParams, Time availableTime, bool initialFrame)
	Prepare the frame to transmit on the given link starting from the MPDU that has been previously peeked by calling PeekNextMpdu. More...

uint16_t	GetNextSequenceNumberFor (const WifiMacHeader *hdr)
	Return the next sequence number for the given header. More...

uint8_t	GetQosQueueSize (uint8_t tid, Mac48Address receiver) const
	Get the value for the Queue Size subfield of the QoS Control field of a QoS data frame of the given TID and addressed to the given receiver. More...

virtual Time	GetRemainingTxop (uint8_t linkId) const
	Return the remaining duration in the current TXOP on the given link. More...

virtual std::optional< Time >	GetTxopStartTime (uint8_t linkId) const

void	GotAddBaResponse (const MgtAddBaResponseHeader &respHdr, Mac48Address recipient)
	Event handler when an ADDBA response is received. More...

void	GotDelBaFrame (const MgtDelBaHeader *delBaHdr, Mac48Address recipient)
	Event handler when a DELBA frame is received. More...

bool	HasFramesToTransmit (uint8_t linkId) override
	Check if the Txop has frames to transmit over the given link. More...

bool	IsQosTxop () const override
	Check for QoS TXOP. More...

bool	MuEdcaTimerRunning (uint8_t linkId) const
	Return true if the MU EDCA Timer is running for the given link, false otherwise. More...

void	NotifyChannelAccessed (uint8_t linkId, Time txopDuration) override
	Called by the FrameExchangeManager to notify that channel access has been granted on the given link for the given amount of time. More...

void	NotifyChannelReleased (uint8_t linkId) override
	Called by the FrameExchangeManager to notify the completion of the transmissions. More...

void	NotifyOriginatorAgreementNoReply (const Mac48Address &recipient, uint8_t tid)
	Take action upon notification of ADDBA_REQUEST frame being discarded (likely due to exceeded max retry limit). More...

Ptr< WifiMpdu >	PeekNextMpdu (uint8_t linkId, uint8_t tid=8, Mac48Address recipient=Mac48Address::GetBroadcast(), Ptr< const WifiMpdu > mpdu=nullptr)
	Peek the next frame to transmit on the given link to the given receiver and of the given TID from the EDCA queue. More...

uint16_t	PeekNextSequenceNumberFor (const WifiMacHeader *hdr)
	Return the next sequence number for the Traffic ID and destination, but do not pick it (i.e. More...

std::pair< CtrlBAckRequestHeader, WifiMacHeader >	PrepareBlockAckRequest (Mac48Address recipient, uint8_t tid) const

void	ResetBa (Mac48Address recipient, uint8_t tid)
	Reset BA agreement after BA negotiation failed. More...

void	SetAddBaResponseTimeout (Time addBaResponseTimeout)
	Set the timeout to wait for ADDBA response. More...

void	SetBlockAckInactivityTimeout (uint16_t timeout)
	Set the BlockAck inactivity timeout. More...

void	SetBlockAckThreshold (uint8_t threshold)
	Set threshold for block ack mechanism. More...

void	SetDroppedMpduCallback (DroppedMpdu callback) override

void	SetFailedAddBaTimeout (Time failedAddBaTimeout)
	Set the timeout for failed BA agreement. More...

void	SetMuAifsn (uint8_t aifsn, uint8_t linkId)
	Set the number of slots that make up an AIFS while the MU EDCA Timer is running for the given link. More...

void	SetMuCwMax (uint16_t cwMax, uint8_t linkId)
	Set the maximum contention window size to use while the MU EDCA Timer is running for the given link. More...

void	SetMuCwMin (uint16_t cwMin, uint8_t linkId)
	Set the minimum contention window size to use while the MU EDCA Timer is running for the given link. More...

void	SetMuEdcaTimer (Time timer, uint8_t linkId)
	Set the MU EDCA Timer for the given link. More...

void	StartMuEdcaTimerNow (uint8_t linkId)
	Start the MU EDCA Timer for the given link. More...

bool	UseExplicitBarAfterMissedBlockAck () const
	Return true if an explicit BlockAckRequest is sent after a missed BlockAck. More...

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

	Txop (Ptr< WifiMacQueue > queue)
	Constructor. More...

	~Txop () override

int64_t	AssignStreams (int64_t stream)
	Assign a fixed random variable stream number to the random variables used by this model. More...

virtual ChannelAccessStatus	GetAccessStatus (uint8_t linkId) const

uint8_t	GetAifsn () const
	Return the number of slots that make up an AIFS. More...

std::vector< uint8_t >	GetAifsns () const
	Return the number of slots that make up an AIFS for each link. More...

uint32_t	GetMaxCw () const
	Return the maximum contention window size. More...

std::vector< uint32_t >	GetMaxCws () const
	Return the maximum contention window size for each link. More...

uint32_t	GetMinCw () const
	Return the minimum contention window size. More...

std::vector< uint32_t >	GetMinCws () const
	Return the minimum contention window size for each link. More...

Time	GetTxopLimit () const
	Return the TXOP limit. More...

Time	GetTxopLimit (uint8_t linkId) const
	Return the TXOP limit for the given link. More...

std::vector< Time >	GetTxopLimits () const
	Return the TXOP limit for each link. More...

Ptr< WifiMacQueue >	GetWifiMacQueue () const
	Return the packet queue associated with this Txop. More...

virtual void	NotifyOff ()
	When off operation occurs, the queue gets cleaned up. More...

virtual void	NotifyOn ()
	When on operation occurs, channel access will be started. More...

virtual void	NotifySleep (uint8_t linkId)
	Notify that the given link switched to sleep mode. More...

virtual void	NotifyWakeUp (uint8_t linkId)
	When wake up operation occurs on a link, channel access on that link will be restarted. More...

virtual void	Queue (Ptr< Packet > packet, const WifiMacHeader &hdr)

virtual void	Queue (Ptr< WifiMpdu > mpdu)

void	ResetCw (uint8_t linkId)
	Update the value of the CW variable for the given link to take into account a transmission success or a transmission abort (stop transmission of a packet after the maximum number of retransmissions has been reached). More...

void	SetAifsn (uint8_t aifsn)
	Set the number of slots that make up an AIFS. More...

void	SetAifsn (uint8_t aifsn, uint8_t linkId)
	Set the number of slots that make up an AIFS for the given link. More...

void	SetAifsns (std::vector< uint8_t > aifsns)
	Set the number of slots that make up an AIFS for each link. More...

void	SetMaxCw (uint32_t maxCw)
	Set the maximum contention window size. More...

void	SetMaxCw (uint32_t maxCw, uint8_t linkId)
	Set the maximum contention window size for the given link. More...

void	SetMaxCws (std::vector< uint32_t > maxCws)
	Set the maximum contention window size for each link. More...

void	SetMinCw (uint32_t minCw)
	Set the minimum contention window size. More...

void	SetMinCw (uint32_t minCw, uint8_t linkId)
	Set the minimum contention window size for the given link. More...

void	SetMinCws (std::vector< uint32_t > minCws)
	Set the minimum contention window size for each link. More...

void	SetTxMiddle (const Ptr< MacTxMiddle > txMiddle)
	Set MacTxMiddle this Txop is associated to. More...

void	SetTxopLimit (Time txopLimit)
	Set the TXOP limit. More...

void	SetTxopLimit (Time txopLimit, uint8_t linkId)
	Set the TXOP limit for the given link. More...

void	SetTxopLimits (const std::vector< Time > &txopLimits)
	Set the TXOP limit for each link. More...

virtual void	SetWifiMac (const Ptr< WifiMac > mac)
	Set the wifi MAC this Txop is associated to. More...

void	StartAccessAfterEvent (uint8_t linkId, bool hadFramesToTransmit, bool checkMediumBusy)
	Request channel access on the given link after the occurrence of an event that possibly requires to generate a new backoff value. More...

void	StartBackoffNow (uint32_t nSlots, uint8_t linkId)

void	SwapLinks (std::map< uint8_t, uint8_t > links)
	Swap the links based on the information included in the given map. More...

void	UpdateFailedCw (uint8_t linkId)
	Update the value of the CW variable for the given link to take into account a transmission failure. More...

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

	~Object () override
	Destructor. More...

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

void	Dispose ()
	Dispose of this Object. More...

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

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

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

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

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

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

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

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

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

	SimpleRefCount (const SimpleRefCount &o[[maybe_unused]])
	Copy constructor. More...

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

SimpleRefCount &	operator= (const SimpleRefCount &o[[maybe_unused]])
	Assignment operator. More...

void	Ref () const
	Increment the reference count. More...

void	Unref () const
	Decrement the reference count. More...

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

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

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

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

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

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

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

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

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

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

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

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

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

Protected Member Functions
void	DoDispose () override
	Destructor implementation. More...

QosLinkEntity &	GetLink (uint8_t linkId) const
	Get a reference to the link associated with the given ID. More...

Protected Member Functions inherited from ns3::Txop
void	DoDispose () override
	Destructor implementation. More...

void	DoInitialize () override
	Initialize() implementation. More...

virtual void	GenerateBackoff (uint8_t linkId)
	Generate a new backoff for the given link now. More...

uint32_t	GetBackoffSlots (uint8_t linkId) const
	Return the current number of backoff slots on the given link. More...

Time	GetBackoffStart (uint8_t linkId) const
	Return the time when the backoff procedure started on the given link. More...

uint32_t	GetCw (uint8_t linkId) const
	Get the current value of the CW variable for the given link. More...

LinkEntity &	GetLink (uint8_t linkId) const
	Get a reference to the link associated with the given ID. More...

const std::map< uint8_t, std::unique_ptr< LinkEntity > > &	GetLinks () const

virtual void	NotifyAccessRequested (uint8_t linkId)
	Notify that access request has been received for the given link. More...

void	RequestAccess (uint8_t linkId)
	Request access to the ChannelAccessManager associated with the given link. More...

void	UpdateBackoffSlotsNow (uint32_t nSlots, Time backoffUpdateBound, uint8_t linkId)
	Update backoff slots for the given link that nSlots has passed. More...

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

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

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

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

Private Types
typedef TracedCallback< Time, Time, uint8_t >	TxopTracedCallback
	TracedCallback for TXOP trace typedef. More...

Private Member Functions
std::unique_ptr< LinkEntity >	CreateLinkEntity () const override
	Create a LinkEntity object. More...

bool	IsQosOldPacket (Ptr< const WifiMpdu > mpdu)
	Check if the given MPDU is to be considered old according to the current starting sequence number of the transmit window, provided that a block ack agreement has been established with the recipient for the given TID. More...

Private Attributes
AcIndex	m_ac
	the access category More...

Time	m_addBaResponseTimeout
	timeout for ADDBA response More...

Ptr< BlockAckManager >	m_baManager
	the block ack manager More...

uint16_t	m_blockAckInactivityTimeout
	the BlockAck inactivity timeout value (in TUs, i.e. More...

uint8_t	m_blockAckThreshold
	the block ack threshold (use BA mechanism if number of packets in queue reaches this value. More...

Time	m_failedAddBaTimeout
	timeout after failed BA agreement More...

uint8_t	m_nMaxInflights
	the maximum number of links on which an MPDU can be in-flight at the same time More...

TxopTracedCallback	m_txopTrace
	TXOP trace callback. More...

bool	m_useExplicitBarAfterMissedBlockAck
	flag whether explicit BlockAckRequest should be sent upon missed BlockAck Response More...

Friends
class	AggregationCapableTransmissionListener
	allow AggregationCapableTransmissionListener class access More...

Additional Inherited Members
Public Types inherited from ns3::Txop
enum	ChannelAccessStatus { NOT_REQUESTED = 0 , REQUESTED , GRANTED }
	Enumeration for channel access status. More...

typedef Callback< void, WifiMacDropReason, Ptr< const WifiMpdu > >	DroppedMpdu
	typedef for a callback to invoke when an MPDU is dropped. More...

Static Public Attributes inherited from ns3::Txop
static constexpr bool	CHECK_MEDIUM_BUSY
	generation of backoff (also) depends on the busy/idle state of the medium More...

static constexpr bool	DIDNT_HAVE_FRAMES_TO_TRANSMIT
	no packet available for transmission was in the queue More...

static constexpr bool	DONT_CHECK_MEDIUM_BUSY
	generation of backoff is independent of the busy/idle state of the medium More...

static constexpr bool	HAD_FRAMES_TO_TRANSMIT
	packets available for transmission were in the queue More...

Protected Types inherited from ns3::Txop
typedef TracedCallback< uint32_t, uint8_t >	BackoffValueTracedCallback
	TracedCallback for backoff trace value typedef. More...

typedef TracedCallback< uint32_t, uint8_t >	CwValueTracedCallback
	TracedCallback for CW trace value typedef. More...

Protected Attributes inherited from ns3::Txop
BackoffValueTracedCallback	m_backoffTrace
	backoff trace value More...

CwValueTracedCallback	m_cwTrace
	CW trace value. More...

DroppedMpdu	m_droppedMpduCallback
	the dropped MPDU callback More...

Ptr< WifiMac >	m_mac
	the wifi MAC More...

Ptr< WifiMacQueue >	m_queue
	the wifi MAC queue More...

Ptr< UniformRandomVariable >	m_rng
	the random stream More...

Ptr< MacTxMiddle >	m_txMiddle
	the MacTxMiddle More...

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

Detailed Description

Handle packet fragmentation and retransmissions for QoS data frames as well as MSDU aggregation (A-MSDU) and block ack sessions, for a given access class.

This class implements the packet fragmentation and retransmission policy for QoS data frames. It uses the ns3::ChannelAccessManager helper class to decide when to send a packet. Packets are stored in a ns3::WifiMacQueue until they can be sent.

This queue contains packets for a particular access class. Possibles access classes are:

AC_VO : voice, TID = 6,7
AC_VI : video, TID = 4,5
AC_BE : best-effort, TID = 0,3
AC_BK : background, TID = 1,2

This class also implements block ack sessions and MSDU aggregation (A-MSDU).

The fragmentation policy currently implemented uses a simple threshold: any packet bigger than this threshold is fragmented in fragments whose size is smaller than the threshold.

The retransmission policy is also very simple: every packet is retransmitted until it is either successfully transmitted or it has been retransmitted up until the SSRC or SLRC thresholds.

The RTS/CTS policy is similar to the fragmentation policy: when a packet is bigger than a threshold, the RTS/CTS protocol is used.

Definition at line 73 of file qos-txop.h.

Member Typedef Documentation

◆ TxopTracedCallback

typedef TracedCallback<Time , Time , uint8_t > ns3::QosTxop::TxopTracedCallback

private

TracedCallback for TXOP trace typedef.

Definition at line 485 of file qos-txop.h.

Constructor & Destructor Documentation

◆ QosTxop()

ns3::QosTxop::QosTxop ( AcIndex ac = AC_UNDEF )

Constructor.

Parameters

ac	the Access Category

Definition at line 106 of file qos-txop.cc.

References ns3::Txop::CHECK_MEDIUM_BUSY, ns3::Txop::GetLinks(), ns3::WifiMac::GetLocalAddress(), ns3::WifiMac::GetMacQueueScheduler(), HasFramesToTransmit(), openflow-switch::link, m_ac, m_baManager, ns3::Txop::m_mac, ns3::Txop::m_queue, ns3::MakeCallback(), ns3::BlockAckManager::NotifyDiscardedMpdu(), NS_LOG_FUNCTION, ns3::Txop::StartAccessAfterEvent(), ns3::WAITING_ADDBA_RESP, and ns3::WIFI_QOSDATA_QUEUE.

Here is the call graph for this function:

◆ ~QosTxop()

ns3::QosTxop::~QosTxop ( )

override

Definition at line 149 of file qos-txop.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ AddBaResponseTimeout()

void ns3::QosTxop::AddBaResponseTimeout	(	Mac48Address	recipient,
		uint8_t	tid
	)

Callback when ADDBA response is not received after timeout.

Parameters

recipient	MAC address of recipient
tid	traffic ID

Definition at line 740 of file qos-txop.cc.

References m_baManager, m_failedAddBaTimeout, NotifyOriginatorAgreementNoReply(), NS_LOG_FUNCTION, ResetBa(), and ns3::Simulator::Schedule().

Referenced by ns3::HtFrameExchangeManager::NotifyReceivedNormalAck().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ AssignSequenceNumber()

void ns3::QosTxop::AssignSequenceNumber ( Ptr< WifiMpdu > mpdu ) const

Assign a sequence number to the given MPDU, if it is not a fragment and it is not a retransmitted frame.

Parameters

mpdu the MPDU

Definition at line 566 of file qos-txop.cc.

References ns3::Txop::m_queue, ns3::Txop::m_txMiddle, and NS_LOG_FUNCTION.

Referenced by GetNextMpdu().

Here is the caller graph for this function:

◆ CompleteMpduTx()

void ns3::QosTxop::CompleteMpduTx ( Ptr< WifiMpdu > mpdu )

Stores an MPDU (part of an A-MPDU) in block ack agreement (i.e.

the sender is waiting for a BlockAck containing the sequence number of this MPDU).

Parameters

mpdu	received MPDU.

Definition at line 698 of file qos-txop.cc.

References ns3::WifiMac::GetBaAgreementEstablishedAsOriginator(), m_baManager, ns3::Txop::m_mac, ns3::Txop::m_queue, and NS_ASSERT.

Referenced by ns3::HtFrameExchangeManager::NotifyTxToEdca().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CreateLinkEntity()

std::unique_ptr< Txop::LinkEntity > ns3::QosTxop::CreateLinkEntity ( ) const

overrideprivatevirtual

Create a LinkEntity object.

Returns: a unique pointer to the created LinkEntity object

Reimplemented from ns3::Txop.

Definition at line 167 of file qos-txop.cc.

◆ DoDispose()

void ns3::QosTxop::DoDispose ( void )

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 155 of file qos-txop.cc.

References ns3::Txop::DoDispose(), m_baManager, and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ EdcaDisabled()

bool ns3::QosTxop::EdcaDisabled ( uint8_t linkId ) const

Return true if the EDCA is disabled (the MU EDCA Timer is running and the MU AIFSN is zero) for the given link, false otherwise.

Parameters

linkId the ID of the given link

Returns: whether the EDCA is disabled

Definition at line 248 of file qos-txop.cc.

References GetLink(), and MuEdcaTimerRunning().

Referenced by GetMaxCw(), GetMinCw(), and StartMuEdcaTimerNow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetAccessCategory()

AcIndex ns3::QosTxop::GetAccessCategory ( ) const

Get the access category of this object.

Returns: the access category.

Definition at line 800 of file qos-txop.cc.

References m_ac.

Referenced by ns3::HeFrameExchangeManager::ReceiveBasicTrigger(), ns3::HeFrameExchangeManager::StartFrameExchange(), ns3::HtFrameExchangeManager::StartFrameExchange(), ns3::HtFrameExchangeManager::TransmissionSucceeded(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().

Here is the caller graph for this function:

◆ GetAddBaResponseTimeout()

Time ns3::QosTxop::GetAddBaResponseTimeout ( ) const

Get the timeout for ADDBA response.

Returns: the timeout to wait for ADDBA response

Definition at line 775 of file qos-txop.cc.

References m_addBaResponseTimeout.

Referenced by GetTypeId(), and ns3::HtFrameExchangeManager::NotifyReceivedNormalAck().

Here is the caller graph for this function:

◆ GetAifsn()

uint8_t ns3::QosTxop::GetAifsn ( uint8_t linkId ) const

overridevirtual

For the given link, return the number of slots that make up an AIFS according to the EDCA Parameter Set or the MU EDCA Parameter Set, depending on whether the MU EDCA Timer is running or not.

Parameters

linkId the ID of the given link

Returns: the number of slots that currently make up an AIFS.

Reimplemented from ns3::Txop.

Definition at line 276 of file qos-txop.cc.

References ns3::Txop::LinkEntity::aifsn, GetLink(), ns3::QosTxop::QosLinkEntity::muAifsn, and MuEdcaTimerRunning().

Referenced by ns3::ApWifiMac::GetEdcaParameterSet().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetBaBufferSize()

uint16_t ns3::QosTxop::GetBaBufferSize	(	Mac48Address	address,
		uint8_t	tid
	)		const

Parameters

address	recipient address of the peer station
tid	traffic ID.

Returns: the negotiated buffer size during ADDBA handshake.

Returns the negotiated buffer size during ADDBA handshake with station addressed by recipient for TID tid.

Definition at line 292 of file qos-txop.cc.

References first::address, and m_baManager.

Referenced by ns3::MpduAggregator::GetNextAmpdu(), GetNextMpdu(), ns3::WifiDefaultAckManager::IsResponseNeeded(), and PeekNextMpdu().

Here is the caller graph for this function:

◆ GetBaManager()

Ptr< BlockAckManager > ns3::QosTxop::GetBaManager ( )

Get the Block Ack Manager associated with this QosTxop.

Returns: the Block Ack Manager

Definition at line 286 of file qos-txop.cc.

References m_baManager.

Referenced by AmpduAggregationTest::EstablishAgreement(), ns3::WifiDefaultAckManager::GetAckInfoIfAggregatedMuBar(), ns3::WifiDefaultAckManager::GetAckInfoIfTfMuBar(), ns3::WifiMac::GetBaAgreementEstablishedAsOriginator(), ns3::WifiMac::GetBaAgreementEstablishedAsRecipient(), ns3::HtFrameExchangeManager::GetBaManager(), ns3::HtFrameExchangeManager::GetBar(), ns3::WifiDefaultAckManager::IsResponseNeeded(), ns3::HtFrameExchangeManager::NeedSetupBlockAck(), ns3::HtFrameExchangeManager::NotifyReceivedNormalAck(), ns3::WifiMac::Receive(), ns3::HtFrameExchangeManager::RetransmitMpduAfterMissedAck(), ns3::HeFrameExchangeManager::SendPsduMap(), and ns3::WifiMac::SetupEdcaQueue().

Here is the caller graph for this function:

◆ GetBaStartingSequence()

uint16_t ns3::QosTxop::GetBaStartingSequence	(	Mac48Address	address,
		uint8_t	tid
	)		const

Parameters

address	recipient address of the peer station
tid	traffic ID.

Returns: the starting sequence number of the originator transmit window.

Returns the current starting sequence number of the transmit window on the originator (WinStartO) of the block ack agreement established with the given recipient for the given TID.

Definition at line 298 of file qos-txop.cc.

References first::address, and m_baManager.

Referenced by ns3::WifiDefaultAckManager::GetMaxDistFromStartingSeq(), ns3::MpduAggregator::GetNextAmpdu(), GetNextMpdu(), IsQosOldPacket(), and PeekNextMpdu().

Here is the caller graph for this function:

◆ GetBlockAckInactivityTimeout()

uint16_t ns3::QosTxop::GetBlockAckInactivityTimeout ( ) const

Get the BlockAck inactivity timeout.

Returns: the BlockAck inactivity timeout.

Definition at line 734 of file qos-txop.cc.

References m_blockAckInactivityTimeout.

Referenced by ns3::HtFrameExchangeManager::StartFrameExchange().

Here is the caller graph for this function:

◆ GetBlockAckThreshold()

uint8_t ns3::QosTxop::GetBlockAckThreshold ( ) const

Return the current threshold for block ack mechanism.

Returns: the current threshold for block ack mechanism.

Definition at line 727 of file qos-txop.cc.

References m_blockAckThreshold, and NS_LOG_FUNCTION.

Referenced by ns3::HtFrameExchangeManager::NeedSetupBlockAck().

Here is the caller graph for this function:

◆ GetFailedAddBaTimeout()

Time ns3::QosTxop::GetFailedAddBaTimeout ( ) const

Get the timeout for failed BA agreement.

Returns: the timeout for failed BA agreement

Definition at line 788 of file qos-txop.cc.

References m_failedAddBaTimeout.

Referenced by GetTypeId(), and ns3::HtFrameExchangeManager::NotifyPacketDiscarded().

Here is the caller graph for this function:

◆ GetLink()

QosTxop::QosLinkEntity & ns3::QosTxop::GetLink ( uint8_t linkId ) const

protected

Get a reference to the link associated with the given ID.

Parameters

linkId the given link ID

Returns: a reference to the link associated with the given ID

Definition at line 173 of file qos-txop.cc.

References ns3::Txop::GetLink().

Referenced by EdcaDisabled(), GetAifsn(), GetMaxCw(), GetMinCw(), GetRemainingTxop(), GetTxopStartTime(), MuEdcaTimerRunning(), NotifyChannelAccessed(), NotifyChannelReleased(), SetMuAifsn(), SetMuCwMax(), SetMuCwMin(), SetMuEdcaTimer(), and StartMuEdcaTimerNow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetMaxCw()

uint32_t ns3::QosTxop::GetMaxCw ( uint8_t linkId ) const

overridevirtual

For the given link, return the maximum contention window size from the EDCA Parameter Set or the MU EDCA Parameter Set, depending on whether the MU EDCA Timer is running or not.

Parameters

linkId the ID of the given link

Returns: the currently used maximum contention window size.

Reimplemented from ns3::Txop.

Definition at line 265 of file qos-txop.cc.

References ns3::Txop::LinkEntity::cwMax, EdcaDisabled(), GetLink(), ns3::QosTxop::QosLinkEntity::muCwMax, MuEdcaTimerRunning(), and NS_ASSERT.

Referenced by ns3::ApWifiMac::GetEdcaParameterSet().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetMinCw()

uint32_t ns3::QosTxop::GetMinCw ( uint8_t linkId ) const

overridevirtual

For the given link, return the minimum contention window size from the EDCA Parameter Set or the MU EDCA Parameter Set, depending on whether the MU EDCA Timer is running or not.

Parameters

linkId the ID of the given link

Returns: the currently used minimum contention window size.

Reimplemented from ns3::Txop.

Definition at line 254 of file qos-txop.cc.

References ns3::Txop::LinkEntity::cwMin, EdcaDisabled(), GetLink(), ns3::QosTxop::QosLinkEntity::muCwMin, MuEdcaTimerRunning(), and NS_ASSERT.

Referenced by ns3::ApWifiMac::GetEdcaParameterSet().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetNextMpdu()

Ptr< WifiMpdu > ns3::QosTxop::GetNextMpdu	(	uint8_t	linkId,
		Ptr< WifiMpdu >	peekedItem,
		WifiTxParameters &	txParams,
		Time	availableTime,
		bool	initialFrame
	)

Prepare the frame to transmit on the given link starting from the MPDU that has been previously peeked by calling PeekNextMpdu.

A frame is only returned if it meets the constraint on the maximum A-MPDU size (by assuming that the frame has to be aggregated to an existing A-MPDU as specified by the TX parameters) and its transmission time does not exceed the given PPDU duration limit (if distinct from Time::Min ()). If the peeked MPDU is a unicast QoS Data frame stored in the EDCA queue, attempt to perform A-MSDU aggregation (while meeting the constraints mentioned above) and assign a sequence number to the dequeued frame.

Parameters

linkId	the ID of the given link
peekedItem	the peeked frame.
txParams	the TX parameters for the frame
availableTime	the time available for the transmission of the frame (including protection and acknowledgment); a value of Time::Min() indicates no time constraint
initialFrame	true if the frame is the initial PPDU of a TXOP

Returns: the frame to transmit or a null pointer if no frame meets the time constraints

Definition at line 495 of file qos-txop.cc.

References AssignSequenceNumber(), ns3::WifiMac::GetBaAgreementEstablishedAsOriginator(), GetBaBufferSize(), GetBaStartingSequence(), ns3::WifiMac::GetFrameExchangeManager(), ns3::WifiMac::GetHtSupported(), ns3::WifiTxParameters::GetSize(), ns3::Mac48Address::IsBroadcast(), ns3::IsInWindow(), ns3::Txop::m_mac, ns3::Time::Min(), NS_ASSERT, NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by AmpduAggregationTest::DoRun(), TwoLevelAggregationTest::DoRun(), HeAggregationTest::DoRun(), EhtAggregationTest::DoRun(), ns3::MpduAggregator::GetNextAmpdu(), ns3::HeFrameExchangeManager::ReceiveBasicTrigger(), TestMultiUserScheduler::SelectTxFormat(), ns3::HtFrameExchangeManager::SendDataFrame(), and ns3::QosFrameExchangeManager::StartFrameExchange().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetNextSequenceNumberFor()

uint16_t ns3::QosTxop::GetNextSequenceNumberFor ( const WifiMacHeader * hdr )

Return the next sequence number for the given header.

Parameters

hdr	Wi-Fi header.

Returns: the next sequence number.

Definition at line 344 of file qos-txop.cc.

References ns3::Txop::m_txMiddle.

◆ GetQosQueueSize()

uint8_t ns3::QosTxop::GetQosQueueSize	(	uint8_t	tid,
		Mac48Address	receiver
	)		const

Get the value for the Queue Size subfield of the QoS Control field of a QoS data frame of the given TID and addressed to the given receiver.

Parameters

tid	the Traffic ID
receiver	the address of the given receiver

Returns: the value for the Queue Size subfield

Definition at line 179 of file qos-txop.cc.

References ns3::Txop::m_queue, min, NS_LOG_DEBUG, queueSize, ns3::WIFI_QOSDATA_QUEUE, and ns3::WIFI_UNICAST.

Referenced by ns3::HtFrameExchangeManager::FinalizeMacHeader(), and ns3::QosFrameExchangeManager::ForwardMpduDown().

Here is the caller graph for this function:

◆ GetRemainingTxop()

Time ns3::QosTxop::GetRemainingTxop ( uint8_t linkId ) const

virtual

Return the remaining duration in the current TXOP on the given link.

Parameters

linkId the ID of the given link

Returns: the remaining duration in the current TXOP.

Definition at line 636 of file qos-txop.cc.

References GetLink(), ns3::Time::IsStrictlyNegative(), openflow-switch::link, ns3::Simulator::Now(), NS_ASSERT, NS_LOG_FUNCTION, and ns3::Seconds().

Referenced by ns3::QosFrameExchangeManager::GetCtsToSelfDurationId(), ns3::QosFrameExchangeManager::GetFrameDurationId(), ns3::HeFrameExchangeManager::GetMuRtsDurationId(), ns3::HtFrameExchangeManager::GetPsduDurationId(), ns3::QosFrameExchangeManager::GetRtsDurationId(), ns3::WifiDefaultAckManager::IsResponseNeeded(), ns3::QosFrameExchangeManager::SendCfEndIfNeeded(), ns3::QosFrameExchangeManager::StartTransmission(), and ns3::QosFrameExchangeManager::TransmissionSucceeded().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetTxopStartTime()

std::optional< Time > ns3::QosTxop::GetTxopStartTime ( uint8_t linkId ) const

virtual

Parameters

linkId the ID of the given link

Returns: the TXOP start time, if a TXOP is ongoing on the given link

Definition at line 591 of file qos-txop.cc.

References GetLink(), openflow-switch::link, and NS_LOG_FUNCTION.

Referenced by ns3::QosFrameExchangeManager::PifsRecovery(), and ns3::QosFrameExchangeManager::StartTransmission().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetTypeId()

TypeId ns3::QosTxop::GetTypeId ( void )

static

Get the type ID.

Returns: the object TypeId

Definition at line 59 of file qos-txop.cc.

References GetAddBaResponseTimeout(), GetFailedAddBaTimeout(), m_baManager, m_nMaxInflights, m_txopTrace, m_useExplicitBarAfterMissedBlockAck, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakePointerAccessor(), ns3::MakeTimeAccessor(), ns3::MakeTimeChecker(), ns3::MakeTraceSourceAccessor(), ns3::MakeUintegerAccessor(), ns3::MilliSeconds(), SetAddBaResponseTimeout(), SetFailedAddBaTimeout(), and ns3::TypeId::SetParent().

Here is the call graph for this function:

◆ GotAddBaResponse()

void ns3::QosTxop::GotAddBaResponse	(	const MgtAddBaResponseHeader &	respHdr,
		Mac48Address	recipient
	)

Event handler when an ADDBA response is received.

Parameters

respHdr	ADDBA response header.
recipient	address of the recipient.

Definition at line 652 of file qos-txop.cc.

References ns3::MgtAddBaResponseHeader::GetStatusCode(), ns3::MgtAddBaResponseHeader::GetTid(), ns3::StatusCode::IsSuccess(), m_baManager, ns3::Txop::m_queue, ns3::Txop::m_txMiddle, NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by ns3::WifiMac::Receive().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GotDelBaFrame()

void ns3::QosTxop::GotDelBaFrame	(	const MgtDelBaHeader *	delBaHdr,
		Mac48Address	recipient
	)

Event handler when a DELBA frame is received.

Parameters

delBaHdr	DELBA header.
recipient	address of the recipient.

Definition at line 683 of file qos-txop.cc.

References ns3::MgtDelBaHeader::GetTid(), m_baManager, NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by ns3::WifiMac::Receive().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HasFramesToTransmit()

bool ns3::QosTxop::HasFramesToTransmit ( uint8_t linkId )

overridevirtual

Check if the Txop has frames to transmit over the given link.

Parameters

linkId the ID of the given link.

Returns: true if the Txop has frames to transmit.

Reimplemented from ns3::Txop.

Definition at line 333 of file qos-txop.cc.

References ns3::Txop::m_queue, and NS_LOG_FUNCTION.

Referenced by QosTxop(), and ns3::WifiMac::UnblockUnicastTxOnLinks().

Here is the caller graph for this function:

◆ IsQosOldPacket()

bool ns3::QosTxop::IsQosOldPacket ( Ptr< const WifiMpdu > mpdu )

private

Check if the given MPDU is to be considered old according to the current starting sequence number of the transmit window, provided that a block ack agreement has been established with the recipient for the given TID.

Parameters

mpdu	the given MPDU

Returns: true if the MPDU is to be considered old, false otherwise

Definition at line 356 of file qos-txop.cc.

References ns3::WifiMac::GetBaAgreementEstablishedAsOriginator(), GetBaStartingSequence(), ns3::Txop::m_mac, NS_LOG_FUNCTION, and ns3::QosUtilsIsOldPacket().

Referenced by PeekNextMpdu().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ IsQosTxop()

bool ns3::QosTxop::IsQosTxop ( ) const

overridevirtual

Check for QoS TXOP.

Returns: true if QoS TXOP.

Reimplemented from ns3::Txop.

Definition at line 794 of file qos-txop.cc.

◆ MuEdcaTimerRunning()

bool ns3::QosTxop::MuEdcaTimerRunning ( uint8_t linkId ) const

Return true if the MU EDCA Timer is running for the given link, false otherwise.

Parameters

linkId the ID of the given link

Returns: whether the MU EDCA Timer is running

Definition at line 239 of file qos-txop.cc.

References GetLink(), openflow-switch::link, and ns3::Simulator::Now().

Referenced by EdcaDisabled(), GetAifsn(), GetMaxCw(), and GetMinCw().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ NotifyChannelAccessed()

void ns3::QosTxop::NotifyChannelAccessed	(	uint8_t	linkId,
		Time	txopDuration
	)

overridevirtual

Called by the FrameExchangeManager to notify that channel access has been granted on the given link for the given amount of time.

Parameters

linkId	the ID of the given link
txopDuration	the duration of the TXOP gained (zero for DCF)

Reimplemented from ns3::Txop.

Definition at line 580 of file qos-txop.cc.

References GetLink(), ns3::Time::Min(), ns3::Txop::NotifyChannelAccessed(), ns3::Simulator::Now(), NS_ASSERT, NS_LOG_FUNCTION, ns3::QosTxop::QosLinkEntity::startTxop, and ns3::QosTxop::QosLinkEntity::txopDuration.

Referenced by ns3::QosFrameExchangeManager::StartTransmission().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ NotifyChannelReleased()

void ns3::QosTxop::NotifyChannelReleased ( uint8_t linkId )

overridevirtual

Called by the FrameExchangeManager to notify the completion of the transmissions.

This method generates a new backoff and restarts access if needed.

Parameters

linkId the ID of the link the FrameExchangeManager is operating on

Reimplemented from ns3::Txop.

Definition at line 599 of file qos-txop.cc.

References ns3::Txop::LinkEntity::access, ns3::Txop::GenerateBackoff(), ns3::WifiMac::GetChannelAccessManager(), ns3::ChannelAccessManager::GetGenerateBackoffOnNoTx(), GetLink(), openflow-switch::link, ns3::Txop::m_mac, ns3::Txop::m_queue, m_txopTrace, ns3::Txop::NOT_REQUESTED, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Txop::RequestAccess(), and ns3::Simulator::ScheduleNow().

Here is the call graph for this function:

◆ NotifyOriginatorAgreementNoReply()

void ns3::QosTxop::NotifyOriginatorAgreementNoReply	(	const Mac48Address &	recipient,
		uint8_t	tid
	)

Take action upon notification of ADDBA_REQUEST frame being discarded (likely due to exceeded max retry limit).

Parameters

recipient	the intended recipient of the ADDBA_REQUEST frame
tid	the TID

Definition at line 691 of file qos-txop.cc.

References m_baManager, and NS_LOG_FUNCTION.

Referenced by AddBaResponseTimeout(), and ns3::HtFrameExchangeManager::NotifyPacketDiscarded().

Here is the caller graph for this function:

◆ PeekNextMpdu()

Ptr< WifiMpdu > ns3::QosTxop::PeekNextMpdu	(	uint8_t	linkId,
		uint8_t	tid = `8`,
		Mac48Address	recipient = `Mac48Address::GetBroadcast()`,
		Ptr< const WifiMpdu >	mpdu = `nullptr`
	)

Peek the next frame to transmit on the given link to the given receiver and of the given TID from the EDCA queue.

If tid is equal to 8 (invalid value) and recipient is the broadcast address, the first available frame is returned. If mpdu is not a null pointer, the search starts from the MPDU following mpdu in the queue; otherwise, the search starts from the head of the queue. Note that A-MSDU aggregation is never attempted. If the frame has never been transmitted, it is assigned a sequence number peeked from MacTxMiddle. Also note that multiple links are only available since 802.11be.

Parameters

linkId	the ID of the given link
tid	traffic ID.
recipient	the receiver station address.
mpdu	the MPDU after which the search starts from

Returns: the peeked frame.

Definition at line 378 of file qos-txop.cc.

References ns3::WifiMac::CanForwardPacketsTo(), ns3::WifiMacHeader::GetAddr1(), ns3::WifiMac::GetBaAgreementEstablishedAsOriginator(), GetBaBufferSize(), GetBaStartingSequence(), ns3::WifiMac::GetMacQueueScheduler(), ns3::WifiMacHeader::GetQosTid(), ns3::WifiMacHeader::GetSequenceNumber(), ns3::Mac48Address::IsBroadcast(), ns3::IsInWindow(), ns3::Callback< R, UArgs >::IsNull(), ns3::WifiMacHeader::IsQosData(), IsQosOldPacket(), m_ac, ns3::Txop::m_droppedMpduCallback, ns3::Txop::m_mac, m_nMaxInflights, ns3::Txop::m_queue, ns3::Txop::m_txMiddle, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::WifiMacHeader::SetSequenceNumber(), ns3::WIFI_MAC_DROP_QOS_OLD_PACKET, ns3::WIFI_QOSDATA_QUEUE, and ns3::WIFI_UNICAST.

Referenced by AmpduAggregationTest::DoRun(), TwoLevelAggregationTest::DoRun(), HeAggregationTest::DoRun(), EhtAggregationTest::DoRun(), ns3::MpduAggregator::GetNextAmpdu(), ns3::FrameExchangeManager::NotifyInternalCollision(), ns3::HeFrameExchangeManager::ReceiveBasicTrigger(), ns3::RrMultiUserScheduler::SelectTxFormat(), TestMultiUserScheduler::SelectTxFormat(), ns3::QosFrameExchangeManager::StartFrameExchange(), ns3::HeFrameExchangeManager::StartFrameExchange(), ns3::HtFrameExchangeManager::StartFrameExchange(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ PeekNextSequenceNumberFor()

uint16_t ns3::QosTxop::PeekNextSequenceNumberFor ( const WifiMacHeader * hdr )

Return the next sequence number for the Traffic ID and destination, but do not pick it (i.e.

the current sequence number remains unchanged).

Parameters

hdr	Wi-Fi header.

Returns: the next sequence number.

Definition at line 350 of file qos-txop.cc.

References ns3::Txop::m_txMiddle.

◆ PrepareBlockAckRequest()

std::pair< CtrlBAckRequestHeader, WifiMacHeader > ns3::QosTxop::PrepareBlockAckRequest	(	Mac48Address	recipient,
		uint8_t	tid
	)		const

Parameters

recipient	Address of recipient.
tid	traffic ID.

Returns: the BlockAckRequest header and the MAC header for the BlockAckReq

Prepare a BlockAckRequest to be sent to recipient for Traffic ID tid. The header for the BlockAckRequest is requested to the QosTxop corresponding to the given TID. A block ack agreement with the given recipient for the given TID must have been established by such QosTxop.

Definition at line 304 of file qos-txop.cc.

References ns3::WifiMac::GetLocalAddress(), ns3::WifiMac::GetMldAddress(), m_ac, m_baManager, ns3::Txop::m_mac, NS_ASSERT, NS_LOG_FUNCTION, ns3::QosUtilsMapTidToAc(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetAddr2(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::WifiMacHeader::SetNoMoreFragments(), ns3::WifiMacHeader::SetNoRetry(), ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_CTL_BACKREQ.

Referenced by ns3::HtFrameExchangeManager::GetBar(), ns3::HtFrameExchangeManager::MissedBlockAck(), ns3::HtFrameExchangeManager::SendPsdu(), and ns3::HeFrameExchangeManager::SendPsduMap().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ResetBa()

void ns3::QosTxop::ResetBa	(	Mac48Address	recipient,
		uint8_t	tid
	)

Reset BA agreement after BA negotiation failed.

Parameters

recipient	MAC address of recipient
tid	traffic ID

Definition at line 753 of file qos-txop.cc.

References m_baManager, and NS_LOG_FUNCTION.

Referenced by AddBaResponseTimeout(), and ns3::HtFrameExchangeManager::NotifyPacketDiscarded().

Here is the caller graph for this function:

◆ SetAddBaResponseTimeout()

void ns3::QosTxop::SetAddBaResponseTimeout ( Time addBaResponseTimeout )

Set the timeout to wait for ADDBA response.

Parameters

addBaResponseTimeout the timeout to wait for ADDBA response

Definition at line 768 of file qos-txop.cc.

References m_addBaResponseTimeout, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

Here is the caller graph for this function:

◆ SetBlockAckInactivityTimeout()

void ns3::QosTxop::SetBlockAckInactivityTimeout ( uint16_t timeout )

Set the BlockAck inactivity timeout.

Parameters

timeout the BlockAck inactivity timeout.

Definition at line 720 of file qos-txop.cc.

References m_blockAckInactivityTimeout, NS_LOG_FUNCTION, and timeout.

Referenced by ns3::WifiMac::SetBeBlockAckInactivityTimeout(), ns3::WifiMac::SetBkBlockAckInactivityTimeout(), ns3::WifiMac::SetViBlockAckInactivityTimeout(), and ns3::WifiMac::SetVoBlockAckInactivityTimeout().

Here is the caller graph for this function:

◆ SetBlockAckThreshold()

void ns3::QosTxop::SetBlockAckThreshold ( uint8_t threshold )

Set threshold for block ack mechanism.

If number of packets in the queue reaches the threshold, block ack mechanism is used.

Parameters

threshold block ack threshold value.

Definition at line 712 of file qos-txop.cc.

References m_baManager, m_blockAckThreshold, and NS_LOG_FUNCTION.

Referenced by ns3::WifiMac::SetBeBlockAckThreshold(), ns3::WifiMac::SetBkBlockAckThreshold(), ns3::WifiMac::SetViBlockAckThreshold(), and ns3::WifiMac::SetVoBlockAckThreshold().

Here is the caller graph for this function:

◆ SetDroppedMpduCallback()

void ns3::QosTxop::SetDroppedMpduCallback ( DroppedMpdu callback )

overridevirtual

Parameters

callback the callback to invoke when an MPDU is dropped

Reimplemented from ns3::Txop.

Definition at line 190 of file qos-txop.cc.

References ns3::Callback< R, UArgs >::Bind(), m_baManager, NS_LOG_FUNCTION, ns3::Txop::SetDroppedMpduCallback(), and ns3::WIFI_MAC_DROP_QOS_OLD_PACKET.

Referenced by ns3::WifiMac::SetupEdcaQueue().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetFailedAddBaTimeout()

void ns3::QosTxop::SetFailedAddBaTimeout ( Time failedAddBaTimeout )

Set the timeout for failed BA agreement.

During the timeout period, all packets will be transmitted using normal MPDU.

Parameters

failedAddBaTimeout the timeout for failed BA agreement

Definition at line 781 of file qos-txop.cc.

References m_failedAddBaTimeout, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

Here is the caller graph for this function:

◆ SetMuAifsn()

void ns3::QosTxop::SetMuAifsn	(	uint8_t	aifsn,
		uint8_t	linkId
	)

Set the number of slots that make up an AIFS while the MU EDCA Timer is running for the given link.

Parameters

aifsn	the number of slots that make up an AIFS.
linkId	the ID of the given link

Definition at line 212 of file qos-txop.cc.

References GetLink(), ns3::QosTxop::QosLinkEntity::muAifsn, and NS_LOG_FUNCTION.

Referenced by ns3::StaWifiMac::SetMuEdcaParameters().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetMuCwMax()

void ns3::QosTxop::SetMuCwMax	(	uint16_t	cwMax,
		uint8_t	linkId
	)

Set the maximum contention window size to use while the MU EDCA Timer is running for the given link.

Parameters

cwMax	the maximum contention window size.
linkId	the ID of the given link

Definition at line 205 of file qos-txop.cc.

References GetLink(), ns3::QosTxop::QosLinkEntity::muCwMax, and NS_LOG_FUNCTION.

Referenced by ns3::StaWifiMac::SetMuEdcaParameters().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetMuCwMin()

void ns3::QosTxop::SetMuCwMin	(	uint16_t	cwMin,
		uint8_t	linkId
	)

Set the minimum contention window size to use while the MU EDCA Timer is running for the given link.

Parameters

cwMin	the minimum contention window size.
linkId	the ID of the given link

Definition at line 198 of file qos-txop.cc.

References GetLink(), ns3::QosTxop::QosLinkEntity::muCwMin, and NS_LOG_FUNCTION.

Referenced by ns3::StaWifiMac::SetMuEdcaParameters().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetMuEdcaTimer()

void ns3::QosTxop::SetMuEdcaTimer	(	Time	timer,
		uint8_t	linkId
	)

Set the MU EDCA Timer for the given link.

Parameters

timer	the timer duration.
linkId	the ID of the given link

Definition at line 219 of file qos-txop.cc.

References GetLink(), ns3::QosTxop::QosLinkEntity::muEdcaTimer, and NS_LOG_FUNCTION.

Referenced by ns3::StaWifiMac::SetMuEdcaParameters().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ StartMuEdcaTimerNow()

void ns3::QosTxop::StartMuEdcaTimerNow ( uint8_t linkId )

Start the MU EDCA Timer for the given link.

Parameters

linkId the ID of the given link

Definition at line 226 of file qos-txop.cc.

References ns3::ChannelAccessManager::DisableEdcaFor(), EdcaDisabled(), ns3::WifiMac::GetChannelAccessManager(), GetLink(), openflow-switch::link, ns3::Txop::m_mac, ns3::Time::MS, ns3::Simulator::Now(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ UseExplicitBarAfterMissedBlockAck()

bool ns3::QosTxop::UseExplicitBarAfterMissedBlockAck ( ) const

Return true if an explicit BlockAckRequest is sent after a missed BlockAck.

Returns: true if an explicit BlockAckRequest is sent after a missed BlockAck

Definition at line 327 of file qos-txop.cc.

References m_useExplicitBarAfterMissedBlockAck.

Referenced by ns3::HtFrameExchangeManager::MissedBlockAck().

Here is the caller graph for this function:

Friends And Related Function Documentation

◆ AggregationCapableTransmissionListener

friend class AggregationCapableTransmissionListener

friend

allow AggregationCapableTransmissionListener class access

Definition at line 453 of file qos-txop.h.

Member Data Documentation

◆ m_ac

AcIndex ns3::QosTxop::m_ac

private

the access category

Definition at line 467 of file qos-txop.h.

Referenced by QosTxop(), GetAccessCategory(), PeekNextMpdu(), and PrepareBlockAckRequest().

◆ m_addBaResponseTimeout

Time ns3::QosTxop::m_addBaResponseTimeout

private

timeout for ADDBA response

Definition at line 475 of file qos-txop.h.

Referenced by GetAddBaResponseTimeout(), and SetAddBaResponseTimeout().

◆ m_baManager

Ptr<BlockAckManager> ns3::QosTxop::m_baManager

private

the block ack manager

Definition at line 468 of file qos-txop.h.

Referenced by QosTxop(), AddBaResponseTimeout(), CompleteMpduTx(), DoDispose(), GetBaBufferSize(), GetBaManager(), GetBaStartingSequence(), GetTypeId(), GotAddBaResponse(), GotDelBaFrame(), NotifyOriginatorAgreementNoReply(), PrepareBlockAckRequest(), ResetBa(), SetBlockAckThreshold(), and SetDroppedMpduCallback().

◆ m_blockAckInactivityTimeout

uint16_t ns3::QosTxop::m_blockAckInactivityTimeout

private

the BlockAck inactivity timeout value (in TUs, i.e.

blocks of 1024 microseconds)

Definition at line 473 of file qos-txop.h.

Referenced by GetBlockAckInactivityTimeout(), and SetBlockAckInactivityTimeout().

◆ m_blockAckThreshold

uint8_t ns3::QosTxop::m_blockAckThreshold

private

the block ack threshold (use BA mechanism if number of packets in queue reaches this value.

If this value is 0, block ack is never used. When A-MPDU is enabled, block ack mechanism is used regardless of this value)

Definition at line 469 of file qos-txop.h.

Referenced by GetBlockAckThreshold(), and SetBlockAckThreshold().

◆ m_failedAddBaTimeout

Time ns3::QosTxop::m_failedAddBaTimeout

private

timeout after failed BA agreement

Definition at line 476 of file qos-txop.h.

Referenced by AddBaResponseTimeout(), GetFailedAddBaTimeout(), and SetFailedAddBaTimeout().

◆ m_nMaxInflights

uint8_t ns3::QosTxop::m_nMaxInflights

private

the maximum number of links on which an MPDU can be in-flight at the same time

Definition at line 479 of file qos-txop.h.

Referenced by GetTypeId(), and PeekNextMpdu().

◆ m_txopTrace

TxopTracedCallback ns3::QosTxop::m_txopTrace

private

TXOP trace callback.

Definition at line 487 of file qos-txop.h.

Referenced by GetTypeId(), and NotifyChannelReleased().

◆ m_useExplicitBarAfterMissedBlockAck

bool ns3::QosTxop::m_useExplicitBarAfterMissedBlockAck

private

flag whether explicit BlockAckRequest should be sent upon missed BlockAck Response

Definition at line 477 of file qos-txop.h.

Referenced by GetTypeId(), and UseExplicitBarAfterMissedBlockAck().

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

src/wifi/model/qos-txop.h
src/wifi/model/qos-txop.cc

Classes

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Types

Private Member Functions

Private Attributes

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ TxopTracedCallback

Constructor & Destructor Documentation

◆ QosTxop()

◆ ~QosTxop()

Member Function Documentation

◆ AddBaResponseTimeout()

◆ AssignSequenceNumber()

◆ CompleteMpduTx()

◆ CreateLinkEntity()

◆ DoDispose()

◆ EdcaDisabled()

◆ GetAccessCategory()

◆ GetAddBaResponseTimeout()

◆ GetAifsn()

◆ GetBaBufferSize()

◆ GetBaManager()

◆ GetBaStartingSequence()

◆ GetBlockAckInactivityTimeout()

◆ GetBlockAckThreshold()

◆ GetFailedAddBaTimeout()

◆ GetLink()

◆ GetMaxCw()

◆ GetMinCw()

◆ GetNextMpdu()

◆ GetNextSequenceNumberFor()

◆ GetQosQueueSize()

◆ GetRemainingTxop()

◆ GetTxopStartTime()

◆ GetTypeId()

◆ GotAddBaResponse()

◆ GotDelBaFrame()

◆ HasFramesToTransmit()

◆ IsQosOldPacket()

◆ IsQosTxop()

◆ MuEdcaTimerRunning()

◆ NotifyChannelAccessed()

◆ NotifyChannelReleased()

◆ NotifyOriginatorAgreementNoReply()

◆ PeekNextMpdu()

◆ PeekNextSequenceNumberFor()

◆ PrepareBlockAckRequest()

◆ ResetBa()

◆ SetAddBaResponseTimeout()

◆ SetBlockAckInactivityTimeout()

◆ SetBlockAckThreshold()

◆ SetDroppedMpduCallback()

◆ SetFailedAddBaTimeout()

◆ SetMuAifsn()

◆ SetMuCwMax()

◆ SetMuCwMin()

◆ SetMuEdcaTimer()

◆ StartMuEdcaTimerNow()

◆ UseExplicitBarAfterMissedBlockAck()

Friends And Related Function Documentation

◆ AggregationCapableTransmissionListener

Member Data Documentation

◆ m_ac

◆ m_addBaResponseTimeout

◆ m_baManager

◆ m_blockAckInactivityTimeout

◆ m_blockAckThreshold

◆ m_failedAddBaTimeout

◆ m_nMaxInflights

◆ m_txopTrace

◆ m_useExplicitBarAfterMissedBlockAck