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

bool	GetBaAgreementEstablished (Mac48Address address, uint8_t tid) const

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

BlockAckReqType	GetBlockAckReqType (Mac48Address recipient, uint8_t tid) const

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

BlockAckType	GetBlockAckType (Mac48Address recipient, uint8_t tid) const

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

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

virtual bool	IsTxopStarted (uint8_t linkId) const
	Return true if a TXOP has started on the given link. 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...

Ptr< WifiMpdu >	PeekNextMpdu (uint8_t linkId, uint8_t tid=8, Mac48Address recipient=Mac48Address::GetBroadcast(), Ptr< WifiMpdu > item=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...

Ptr< const WifiMpdu >	PrepareBlockAckRequest (Mac48Address recipient, uint8_t tid) const

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

void	ScheduleBar (Ptr< const WifiMpdu > bar, bool skipIfNoDataQueued=false)

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

virtual uint8_t	GetAifsn (uint8_t linkId) const
	Return the number of slots that make up an AIFS for the given link. 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...

virtual uint32_t	GetMaxCw (uint8_t linkId) const
	Return the maximum contention window size for the given link. 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...

virtual uint32_t	GetMinCw (uint8_t linkId) const
	Return the minimum contention window size for the given link. 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 bool	IsQosTxop () const
	Check for QoS TXOP. More...

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

virtual void	NotifyChannelReleased (uint8_t linkId)
	Called by the FrameExchangeManager to notify the completion of the transmissions. 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...

virtual void	SetDroppedMpduCallback (DroppedMpdu callback)

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	StartBackoffNow (uint32_t nSlots, uint8_t linkId)

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)
	Copy constructor. More...

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

SimpleRefCount &	operator= (const SimpleRefCount &o)
	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 erros. More...

virtual TypeId	GetInstanceTypeId () const =0
	Get the most derived TypeId for this Object. 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...

uint8_t	GetNLinks () const
	Get the number of links. More...

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

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

virtual void	StartAccessIfNeeded (uint8_t linkId)
	Request access from Txop on the given link if needed. 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	DoDispose ()
	Destructor implementation. More...

virtual void	DoInitialize ()
	Initialize() implementation. 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...

Ptr< QosBlockedDestinations >	m_qosBlockedDestinations
	the QoS blocked destinations 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...

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.

Config Paths

ns3::QosTxop is accessible through the following paths with Config::Set and Config::Connect:

"/NodeList/[i]/DeviceList/[i]/$ns3::WifiNetDevice/Mac/Txop/$ns3::QosTxop"
"/NodeList/[i]/DeviceList/[i]/$ns3::WifiNetDevice/Mac/VO_Txop"
"/NodeList/[i]/DeviceList/[i]/$ns3::WifiNetDevice/Mac/VI_Txop"
"/NodeList/[i]/DeviceList/[i]/$ns3::WifiNetDevice/Mac/BE_Txop"
"/NodeList/[i]/DeviceList/[i]/$ns3::WifiNetDevice/Mac/BK_Txop"

Attributes

UseExplicitBarAfterMissedBlockAck: Specify whether explicit BlockAckRequest should be sent upon missed BlockAck Response.
- Set with class: BooleanValue
- Underlying type: bool
- Initial value: true
- Flags: constructwriteread
AddBaResponseTimeout: The timeout to wait for ADDBA response after the Ack to ADDBA request is received.
- Set with class: ns3::TimeValue
- Underlying type: Time +9.22337e+18ns:+9.22337e+18ns
- Initial value: +1e+06ns
- Flags: constructwriteread
FailedAddBaTimeout: The timeout after a failed BA agreement. During this timeout, the originator resumes sending packets using normal MPDU. After that, BA agreement is reset and the originator will retry BA negotiation.
- Set with class: ns3::TimeValue
- Underlying type: Time +9.22337e+18ns:+9.22337e+18ns
- Initial value: +2e+08ns
- Flags: constructwriteread
BlockAckManager: The BlockAckManager object.
- Set with class: ns3::PointerValue
- Underlying type: ns3::Ptr< ns3::BlockAckManager>
- Initial value: 0
- Flags: constructwriteread

Attributes defined in parent class ns3::Txop

MinCw: The minimum value of the contention window (just for the first link, in case of 11be multi-link devices).
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Flags: writeread
MinCws: The minimum values of the contention window for all the links
- Set with class: ns3::AttributeContainerValue<N3ns313UintegerValueE, St4listIN3ns33PtrINS0_13UintegerValueEEESaIS3_EE>
- Underlying type: ns3::Ptr<N3ns313UintegerValueE>
- Flags: writeread
MaxCw: The maximum value of the contention window (just for the first link, in case of 11be multi-link devices).
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Flags: writeread
MaxCws: The maximum values of the contention window for all the links
- Set with class: ns3::AttributeContainerValue<N3ns313UintegerValueE, St4listIN3ns33PtrINS0_13UintegerValueEEESaIS3_EE>
- Underlying type: ns3::Ptr<N3ns313UintegerValueE>
- Flags: writeread
Aifsn: The AIFSN: the default value conforms to non-QOS (just for the first link, in case of 11be multi-link devices).
- Set with class: ns3::UintegerValue
- Underlying type: uint8_t 0:255
- Flags: writeread
Aifsns: The values of AIFSN for all the links
- Set with class: ns3::AttributeContainerValue<N3ns313UintegerValueE, St4listIN3ns33PtrINS0_13UintegerValueEEESaIS3_EE>
- Underlying type: ns3::Ptr<N3ns313UintegerValueE>
- Flags: writeread
TxopLimit: The TXOP limit: the default value conforms to non-QoS (just for the first link, in case of 11be multi-link devices).
- Set with class: ns3::TimeValue
- Underlying type: Time +9.22337e+18ns:+9.22337e+18ns
- Flags: writeread
TxopLimits: The values of TXOP limit for all the links
- Set with class: ns3::AttributeContainerValue<N3ns39TimeValueE, St4listIN3ns33PtrINS0_9TimeValueEEESaIS3_EE>
- Underlying type: ns3::Ptr<N3ns39TimeValueE>
- Flags: writeread
Queue: The WifiMacQueue object
- Set with class: ns3::PointerValue
- Underlying type: ns3::Ptr< ns3::WifiMacQueue>
- Flags: read

TraceSources

TxopTrace: Trace source for TXOP start and duration times
Callback signature: ns3::QosTxop::TxopTracedCallback

TraceSources defined in parent class ns3::Txop

BackoffTrace: Trace source for backoff values
Callback signature: ns3::Txop::BackoffValueTracedCallback
CwTrace: Trace source for contention window values
Callback signature: ns3::Txop::CwValueTracedCallback

Size of this type is 200 bytes (on a 64-bit architecture).

Definition at line 72 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 511 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 100 of file qos-txop.cc.

References ns3::QosBlockedDestinations::Block(), m_baManager, m_qosBlockedDestinations, ns3::Txop::m_queue, ns3::MakeCallback(), ns3::BlockAckManager::NotifyDiscardedMpdu(), NS_LOG_FUNCTION, and ns3::QosBlockedDestinations::Unblock().

Here is the call graph for this function:

◆ ~QosTxop()

ns3::QosTxop::~QosTxop ( )

override

Definition at line 117 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 680 of file qos-txop.cc.

References ns3::Txop::GenerateBackoff(), GetLink(), HasFramesToTransmit(), m_baManager, m_failedAddBaTimeout, ns3::Txop::m_mac, ns3::Txop::NOT_REQUESTED, NS_LOG_FUNCTION, ns3::OriginatorBlockAckAgreement::PENDING, ResetBa(), ns3::Simulator::Schedule(), and ns3::SINGLE_LINK_OP_ID.

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

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

References GetBaAgreementEstablished(), m_baManager, 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 136 of file qos-txop.cc.

◆ DoDispose()

void ns3::QosTxop::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 123 of file qos-txop.cc.

References ns3::Txop::DoDispose(), m_baManager, m_qosBlockedDestinations, 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 217 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 747 of file qos-txop.cc.

References m_ac.

Referenced by 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 722 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 245 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:

◆ GetBaAgreementEstablished()

bool ns3::QosTxop::GetBaAgreementEstablished	(	Mac48Address	address,
		uint8_t	tid
	)		const

Parameters

address	recipient address of the peer station
tid	traffic ID.

Returns: true if a block ack agreement is established, false otherwise.

Checks if a block ack agreement is established with station addressed by recipient for TID tid.

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

References first::address, ns3::OriginatorBlockAckAgreement::ESTABLISHED, and m_baManager.

Referenced by CompleteMpduTx(), ns3::WifiDefaultAckManager::GetMaxDistFromStartingSeq(), ns3::MpduAggregator::GetNextAmpdu(), GetNextMpdu(), IsQosOldPacket(), ns3::HtFrameExchangeManager::NotifyReceivedNormalAck(), PeekNextMpdu(), ns3::HeFrameExchangeManager::ReceiveBasicTrigger(), ns3::HtFrameExchangeManager::ReleaseSequenceNumber(), ns3::HtFrameExchangeManager::RetransmitMpduAfterMissedAck(), ns3::HeFrameExchangeManager::StartFrameExchange(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().

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

References m_baManager.

Referenced by AmpduAggregationTest::DoRun(), TwoLevelAggregationTest::DoRun(), HeAggregationTest::DoRunSubTest(), ns3::WifiDefaultAckManager::GetAckInfoIfAggregatedMuBar(), ns3::WifiDefaultAckManager::GetAckInfoIfBarBaSequence(), ns3::WifiDefaultAckManager::GetAckInfoIfTfMuBar(), ns3::WifiDefaultAckManager::IsResponseNeeded(), ns3::HtFrameExchangeManager::NeedSetupBlockAck(), ns3::HtFrameExchangeManager::NotifyReceivedNormalAck(), ns3::WifiMac::Receive(), ns3::HeFrameExchangeManager::ReceiveBasicTrigger(), ns3::HtFrameExchangeManager::RetransmitMpduAfterMissedAck(), ns3::HtFrameExchangeManager::SendMpduFromBaManager(), ns3::HeFrameExchangeManager::SendMpduFromBaManager(), ns3::WifiMac::SetQosSupported(), ns3::WifiMac::SetupEdcaQueue(), ns3::HeFrameExchangeManager::StartFrameExchange(), and ns3::HtFrameExchangeManager::TransmissionSucceeded().

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

References first::address, and m_baManager.

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

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

References m_blockAckInactivityTimeout.

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

Here is the caller graph for this function:

◆ GetBlockAckReqType()

BlockAckReqType ns3::QosTxop::GetBlockAckReqType	(	Mac48Address	recipient,
		uint8_t	tid
	)		const

Parameters

recipient	MAC address of recipient
tid	traffic ID

Returns: the type of Block Ack Requests sent to the recipient

This function returns the type of Block Ack Requests sent to the recipient.

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

References m_baManager.

Referenced by ns3::WifiDefaultAckManager::GetAckInfoIfAggregatedMuBar(), ns3::WifiDefaultAckManager::GetAckInfoIfBarBaSequence(), and ns3::WifiDefaultAckManager::GetAckInfoIfTfMuBar().

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 667 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:

◆ GetBlockAckType()

BlockAckType ns3::QosTxop::GetBlockAckType	(	Mac48Address	recipient,
		uint8_t	tid
	)		const

Parameters

recipient	MAC address
tid	traffic ID

Returns: the type of Block Acks sent by the recipient

This function returns the type of Block Acks sent by the recipient.

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

References m_baManager.

Referenced by ns3::WifiDefaultAckManager::GetAckInfoIfAggregatedMuBar(), ns3::WifiDefaultAckManager::GetAckInfoIfBarBaSequence(), and ns3::WifiDefaultAckManager::GetAckInfoIfTfMuBar().

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

References ns3::Txop::GetLink().

Referenced by AddBaResponseTimeout(), EdcaDisabled(), GetAifsn(), GetMaxCw(), GetMinCw(), GetRemainingTxop(), GotAddBaResponse(), IsTxopStarted(), 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 234 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 223 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 454 of file qos-txop.cc.

References AssignSequenceNumber(), GetBaAgreementEstablished(), GetBaBufferSize(), GetBaStartingSequence(), 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::DoRunSubTest(), 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 330 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 148 of file qos-txop.cc.

References ns3::Txop::m_queue, min, NS_LOG_DEBUG, and ns3::WIFI_QOSDATA_UNICAST_QUEUE.

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

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

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

Referenced by ns3::QosFrameExchangeManager::GetCtsToSelfDurationId(), ns3::QosFrameExchangeManager::GetFrameDurationId(), 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:

◆ GetTypeId()

TypeId ns3::QosTxop::GetTypeId ( )

static

Get the type ID.

Returns: the object TypeId

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

References GetAddBaResponseTimeout(), GetFailedAddBaTimeout(), m_baManager, m_txopTrace, m_useExplicitBarAfterMissedBlockAck, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakePointerAccessor(), ns3::MakeTimeAccessor(), ns3::MakeTimeChecker(), ns3::MakeTraceSourceAccessor(), 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 597 of file qos-txop.cc.

References GetLink(), ns3::MgtAddBaResponseHeader::GetStatusCode(), ns3::MgtAddBaResponseHeader::GetTid(), HasFramesToTransmit(), ns3::StatusCode::IsSuccess(), m_baManager, ns3::Txop::m_mac, ns3::Txop::m_queue, ns3::Txop::m_txMiddle, ns3::Txop::NOT_REQUESTED, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::SINGLE_LINK_OP_ID.

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

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

Referenced by AddBaResponseTimeout(), and GotAddBaResponse().

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

References GetBaAgreementEstablished(), GetBaStartingSequence(), 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 741 of file qos-txop.cc.

◆ IsTxopStarted()

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

virtual

Return true if a TXOP has started on the given link.

Parameters

linkId the ID of the given link

Returns: true if a TXOP has started, false otherwise.

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

References GetLink(), 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:

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

References GetLink(), 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 547 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 566 of file qos-txop.cc.

References GetLink(), m_txopTrace, ns3::Txop::NotifyChannelReleased(), ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::Seconds().

Referenced by ns3::QosFrameExchangeManager::CancelPifsRecovery(), ns3::QosFrameExchangeManager::PifsRecovery(), ns3::QosFrameExchangeManager::SendCfEndIfNeeded(), ns3::QosFrameExchangeManager::StartTransmission(), ns3::QosFrameExchangeManager::TransmissionFailed(), and ns3::QosFrameExchangeManager::TransmissionSucceeded().

Here is the call graph for this function:

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< WifiMpdu >	item = `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 item is not a null pointer, the search starts from the packet following item 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.
item	the item after which the search starts from

Returns: the peeked frame.

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

References ns3::WifiMacHeader::GetAddr1(), GetBaAgreementEstablished(), GetBaBufferSize(), GetBaStartingSequence(), ns3::WifiMacHeader::GetQosTid(), ns3::WifiMacHeader::GetSequenceNumber(), ns3::Mac48Address::IsBroadcast(), ns3::IsInWindow(), ns3::Callback< R, UArgs >::IsNull(), ns3::WifiMacHeader::IsQosData(), IsQosOldPacket(), ns3::WifiMacHeader::IsRetry(), ns3::Txop::m_droppedMpduCallback, ns3::Txop::m_mac, m_qosBlockedDestinations, ns3::Txop::m_queue, ns3::Txop::m_txMiddle, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::WifiMacHeader::SetSequenceNumber(), and ns3::WIFI_MAC_DROP_QOS_OLD_PACKET.

Referenced by AmpduAggregationTest::DoRun(), TwoLevelAggregationTest::DoRun(), HeAggregationTest::DoRunSubTest(), 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 336 of file qos-txop.cc.

References ns3::Txop::m_txMiddle.

◆ PrepareBlockAckRequest()

Ptr< const WifiMpdu > ns3::QosTxop::PrepareBlockAckRequest	(	Mac48Address	recipient,
		uint8_t	tid
	)		const

Parameters

recipient	Address of recipient.
tid	traffic ID.

Returns: the BlockAckRequest to send

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

References ns3::Packet::AddHeader(), 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::MissedBlockAck(), and ns3::HtFrameExchangeManager::SendPsdu().

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

References ns3::OriginatorBlockAckAgreement::ESTABLISHED, m_baManager, and NS_LOG_FUNCTION.

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

Here is the caller graph for this function:

◆ ScheduleBar()

void ns3::QosTxop::ScheduleBar	(	Ptr< const WifiMpdu >	bar,
		bool	skipIfNoDataQueued = `false`
	)

Parameters

bar	the BlockAckRequest to schedule
skipIfNoDataQueued	do not send if there is no data queued

Request the block ack manager to schedule the transmission of the given BlockAckRequest.

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

References m_baManager.

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

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 715 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 660 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 652 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 159 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 728 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 181 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 174 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 167 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 188 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 195 of file qos-txop.cc.

References EdcaDisabled(), GetLink(), 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 309 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 481 of file qos-txop.h.

Member Data Documentation

◆ m_ac

AcIndex ns3::QosTxop::m_ac

private

the access category

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

Referenced by GetAccessCategory(), and PrepareBlockAckRequest().

◆ m_addBaResponseTimeout

Time ns3::QosTxop::m_addBaResponseTimeout

private

timeout for ADDBA response

Definition at line 504 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 497 of file qos-txop.h.

Referenced by QosTxop(), AddBaResponseTimeout(), CompleteMpduTx(), DoDispose(), GetBaAgreementEstablished(), GetBaBufferSize(), GetBaManager(), GetBaStartingSequence(), GetBlockAckReqType(), GetBlockAckType(), GetTypeId(), GotAddBaResponse(), GotDelBaFrame(), HasFramesToTransmit(), PrepareBlockAckRequest(), ResetBa(), ScheduleBar(), 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 502 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 498 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 505 of file qos-txop.h.

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

◆ m_qosBlockedDestinations

Ptr<QosBlockedDestinations> ns3::QosTxop::m_qosBlockedDestinations

private

the QoS blocked destinations

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

Referenced by QosTxop(), DoDispose(), HasFramesToTransmit(), and PeekNextMpdu().

◆ m_txopTrace

TxopTracedCallback ns3::QosTxop::m_txopTrace

private

TXOP trace callback.

Definition at line 513 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 506 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

Config Paths

Attributes

Attributes defined in parent class ns3::Txop

TraceSources

TraceSources defined in parent class ns3::Txop

Member Typedef Documentation

◆ TxopTracedCallback

Constructor & Destructor Documentation

◆ QosTxop()

◆ ~QosTxop()

Member Function Documentation

◆ AddBaResponseTimeout()

◆ AssignSequenceNumber()

◆ CompleteMpduTx()

◆ CreateLinkEntity()

◆ DoDispose()

◆ EdcaDisabled()

◆ GetAccessCategory()

◆ GetAddBaResponseTimeout()

◆ GetAifsn()

◆ GetBaAgreementEstablished()

◆ GetBaBufferSize()

◆ GetBaManager()

◆ GetBaStartingSequence()

◆ GetBlockAckInactivityTimeout()

◆ GetBlockAckReqType()

◆ GetBlockAckThreshold()

◆ GetBlockAckType()

◆ GetFailedAddBaTimeout()

◆ GetLink()

◆ GetMaxCw()

◆ GetMinCw()

◆ GetNextMpdu()

◆ GetNextSequenceNumberFor()

◆ GetQosQueueSize()

◆ GetRemainingTxop()

◆ GetTypeId()

◆ GotAddBaResponse()

◆ GotDelBaFrame()

◆ HasFramesToTransmit()

◆ IsQosOldPacket()

◆ IsQosTxop()

◆ IsTxopStarted()

◆ MuEdcaTimerRunning()

◆ NotifyChannelAccessed()

◆ NotifyChannelReleased()

◆ PeekNextMpdu()

◆ PeekNextSequenceNumberFor()

◆ PrepareBlockAckRequest()

◆ ResetBa()

◆ ScheduleBar()

◆ 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