handle RTS/CTS/DATA/ACK transactions. More...

#include <mac-low.h>

Inheritance diagram for ns3::MacLow:

Collaboration diagram for ns3::MacLow:

Public Types
typedef Callback< void, Ptr < Packet >, const WifiMacHeader * >	MacLowRxCallback
	typedef for a callback for MacLowRx More...

Public Member Functions
	MacLow ()

virtual	~MacLow ()

Time	CalculateTransmissionTime (Ptr< const Packet > packet, const WifiMacHeader *hdr, const MacLowTransmissionParameters &parameters) const

void	CreateBlockAckAgreement (const MgtAddBaResponseHeader *respHdr, Mac48Address originator, uint16_t startingSeq)

void	DestroyBlockAckAgreement (Mac48Address originator, uint8_t tid)

Time	GetAckTimeout (void) const
	Return ACK timeout of this MacLow. More...

Mac48Address	GetAddress (void) const
	Return the MAC address of this MacLow. More...

Time	GetBasicBlockAckTimeout () const
	Return Basic Block ACK timeout of this MacLow. More...

Mac48Address	GetBssid (void) const
	Return the Basic Service Set Identification. More...

Time	GetCompressedBlockAckTimeout () const
	Return Compressed Block ACK timeout of this MacLow. More...

Time	GetCtsTimeout (void) const
	Return CTS timeout of this MacLow. More...

bool	GetCtsToSelfSupported () const
	Return whether CTS-to-self capability is supported. More...

Time	GetPifs (void) const
	Return PCF Interframe Space (PIFS) of this MacLow. More...

Time	GetRifs (void) const
	Return Reduced Interframe Space (RIFS) of this MacLow. More...

Time	GetSifs (void) const
	Return Short Interframe Space (SIFS) of this MacLow. More...

Time	GetSlotTime (void) const
	Return slot duration of this MacLow. More...

bool	IsPromisc (void) const
	Check if MacLow is operating in promiscuous mode. More...

void	NotifySwitchingStartNow (Time duration)

void	ReceiveError (Ptr< const Packet > packet, double rxSnr)

void	ReceiveOk (Ptr< Packet > packet, double rxSnr, WifiMode txMode, WifiPreamble preamble)

void	RegisterBlockAckListenerForAc (enum AcIndex ac, MacLowBlockAckEventListener *listener)

void	RegisterDcfListener (MacLowDcfListener *listener)

void	SetAckTimeout (Time ackTimeout)
	Set ACK timeout of this MacLow. More...

void	SetAddress (Mac48Address ad)
	Set MAC address of this MacLow. More...

void	SetBasicBlockAckTimeout (Time blockAckTimeout)
	Set Basic Block ACK timeout of this MacLow. More...

void	SetBssid (Mac48Address ad)
	Set the Basic Service Set Identification. More...

void	SetCompressedBlockAckTimeout (Time blockAckTimeout)
	Set Compressed Block ACK timeout of this MacLow. More...

void	SetCtsTimeout (Time ctsTimeout)
	Set CTS timeout of this MacLow. More...

void	SetCtsToSelfSupported (bool enable)
	Enable or disable CTS-to-self capability. More...

void	SetPhy (Ptr< WifiPhy > phy)
	Set up WifiPhy associated with this MacLow. More...

void	SetPifs (Time pifs)
	Set PCF Interframe Space (PIFS) of this MacLow. More...

void	SetPromisc (void)
	Enable promiscuous mode. More...

void	SetRifs (Time rifs)
	Set Reduced Interframe Space (RIFS) of this MacLow. More...

void	SetRxCallback (Callback< void, Ptr< Packet >, const WifiMacHeader * > callback)

void	SetSifs (Time sifs)
	Set Short Interframe Space (SIFS) of this MacLow. More...

void	SetSlotTime (Time slotTime)
	Set slot duration of this MacLow. More...

void	SetWifiRemoteStationManager (Ptr< WifiRemoteStationManager > manager)
	Set up WifiRemoteStationManager associated with this MacLow. More...

void	StartTransmission (Ptr< const Packet > packet, const WifiMacHeader hdr, MacLowTransmissionParameters parameters, MacLowTransmissionListener listener)

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

virtual	~Object ()

void	AggregateObject (Ptr< Object > other)

void	Dispose (void)
	Run the DoDispose methods of this object and all the objects aggregated to it. More...

AggregateIterator	GetAggregateIterator (void) const

virtual TypeId	GetInstanceTypeId (void) const

template<typename T >
Ptr< T >	GetObject (void) const

template<typename T >
Ptr< T >	GetObject (TypeId tid) const

void	Initialize (void)
	This method calls the virtual DoInitialize method on all the objects aggregated to this object. More...

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

	SimpleRefCount (const SimpleRefCount &o)
	Copy constructor. More...

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

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

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

void	Unref (void) 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

bool	GetAttributeFailSafe (std::string name, AttributeValue &attribute) const

void	SetAttribute (std::string name, const AttributeValue &value)

bool	SetAttributeFailSafe (std::string name, const AttributeValue &value)

bool	TraceConnect (std::string name, std::string context, const CallbackBase &cb)

bool	TraceConnectWithoutContext (std::string name, const CallbackBase &cb)

bool	TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)

bool	TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)

Protected Member Functions
virtual WifiTxVector	GetDataTxVector (Ptr< const Packet > packet, const WifiMacHeader *hdr) const
	Return a TXVECTOR for the DATA frame given the destination. More...

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

virtual void	DoInitialize (void)
	This method is called only once by Object::Initialize. More...

virtual void	NotifyNewAggregate (void)
	This method is invoked whenever two sets of objects are aggregated together. More...

Protected Member Functions inherited from ns3::ObjectBase
void	ConstructSelf (const AttributeConstructionList &attributes)

virtual void	NotifyConstructionCompleted (void)
	This method is invoked once all member attributes have been initialized. More...

Private Types
typedef std::pair < Mac48Address, uint8_t >	AgreementKey

typedef std::map< AgreementKey, AgreementValue >	Agreements

typedef std::map< AgreementKey, AgreementValue >::iterator	AgreementsI

typedef std::pair < BlockAckAgreement, std::list < BufferedPacket > >	AgreementValue

typedef std::map< AgreementKey, BlockAckCache >	BlockAckCaches

typedef std::map< AgreementKey, BlockAckCache >::iterator	BlockAckCachesI

typedef std::pair< Ptr< Packet > , WifiMacHeader >	BufferedPacket

typedef std::list < BufferedPacket >::iterator	BufferedPacketI

typedef std::vector < MacLowDcfListener * >	DcfListeners
	typedef for a list of MacLowDcfListener. More...

typedef std::vector < MacLowDcfListener * > ::const_iterator	DcfListenersCI
	typedef for an iterator for a list of MacLowDcfListener. More...

typedef std::map< AcIndex, MacLowBlockAckEventListener * >	QueueListeners

Private Member Functions
void	BlockAckTimeout (void)
	Event handler when block ACK timeout occurs. More...

Time	CalculateOverallTxTime (Ptr< const Packet > packet, const WifiMacHeader *hdr, const MacLowTransmissionParameters &params) const

void	CancelAllEvents (void)
	Cancel all scheduled events. More...

void	CtsTimeout (void)
	Event handler when CTS timeout occurs. More...

virtual void	DoDispose (void)
	This method is called by Object::Dispose or by the object's destructor, whichever comes first. More...

void	DoNavResetNow (Time duration)
	Reset NAV with the given duration. More...

bool	DoNavStartNow (Time duration)
	Start NAV with the given duration. More...

void	EndTxNoAck (void)
	A transmission that does not require an ACK has completed. More...

void	FastAckFailedTimeout (void)
	Event handler when fast ACK timeout occurs (busy). More...

void	FastAckTimeout (void)
	Event handler when fast ACK timeout occurs (idle). More...

void	ForwardDown (Ptr< const Packet > packet, const WifiMacHeader *hdr, WifiTxVector txVector, WifiPreamble preamble)
	Forward the packet down to WifiPhy for transmission. More...

Time	GetAckDuration (WifiTxVector ackTxVector) const
	Return the time required to transmit the ACK (including preamble and FCS). More...

Time	GetAckDuration (Mac48Address to, WifiTxVector dataTxVector) const
	Return the time required to transmit the ACK to the specified address given the TXVECTOR of the DATA (including preamble and FCS). More...

uint32_t	GetAckSize (void) const
	Return the total ACK size (including FCS trailer). More...

WifiTxVector	GetAckTxVector (Mac48Address to, WifiMode dataTxMode) const
	Return a TXVECTOR for the ACK frame given the destination and the mode of the DATA used by the sender. More...

WifiTxVector	GetAckTxVectorForData (Mac48Address to, WifiMode dataTxMode) const
	Return a TXVECTOR for the Block ACK frame given the destination and the mode of the DATA used by the sender. More...

Time	GetBlockAckDuration (Mac48Address to, WifiTxVector blockAckReqTxVector, enum BlockAckType type) const

uint32_t	GetBlockAckSize (enum BlockAckType type) const
	Return the total Block ACK size (including FCS trailer). More...

WifiTxVector	GetBlockAckTxVector (Mac48Address to, WifiMode dataTxMode) const
	Return a TXVECTOR for the Block ACK frame given the destination and the mode of the DATA used by the sender. More...

Time	GetCtsDuration (WifiTxVector ctsTxVector) const
	Return the time required to transmit the CTS (including preamble and FCS). More...

Time	GetCtsDuration (Mac48Address to, WifiTxVector rtsTxVector) const
	Return the time required to transmit the CTS to the specified address given the TXVECTOR of the RTS (including preamble and FCS). More...

uint32_t	GetCtsSize (void) const
	Return the total CTS size (including FCS trailer). More...

WifiTxVector	GetCtsToSelfTxVector (Ptr< const Packet > packet, const WifiMacHeader *hdr) const
	Return a TXVECTOR for the CTS-to-self frame. More...

WifiTxVector	GetCtsTxVector (Mac48Address to, WifiMode rtsTxMode) const
	Return a TXVECTOR for the CTS frame given the destination and the mode of the RTS used by the sender. More...

WifiTxVector	GetCtsTxVectorForRts (Mac48Address to, WifiMode rtsTxMode) const
	Return a TXVECTOR for the CTS frame given the destination and the mode of the RTS used by the sender. More...

uint32_t	GetRtsSize (void) const
	Return the total RTS size (including FCS trailer). More...

WifiTxVector	GetRtsTxVector (Ptr< const Packet > packet, const WifiMacHeader *hdr) const
	Return a TXVECTOR for the RTS frame given the destination. More...

uint32_t	GetSize (Ptr< const Packet > packet, const WifiMacHeader *hdr) const
	Return the total size of the packet after WifiMacHeader and FCS trailer have been added. More...

bool	IsNavZero (void) const
	Check if NAV is zero. More...

void	NavCounterResetCtsMissed (Time rtsEndRxTime)
	Reset NAV after CTS was missed when the NAV was setted with RTS. More...

bool	NeedCtsToSelf (void)
	Check if CTS-to-self mechanism should be used for the current packet. More...

void	NormalAckTimeout (void)
	Event handler when normal ACK timeout occurs. More...

void	NotifyAckTimeoutResetNow ()
	Notify DcfManager (via DcfListener) that ACK timer should be resetted. More...

void	NotifyAckTimeoutStartNow (Time duration)
	Notify DcfManager (via DcfListener) that ACK timer should be started for the given duration. More...

void	NotifyCtsTimeoutResetNow ()
	Notify DcfManager (via DcfListener) that CTS timer should be resetted. More...

void	NotifyCtsTimeoutStartNow (Time duration)
	Notify DcfManager (via DcfListener) that CTS timer should be started for the given duration. More...

void	NotifyNav (Ptr< const Packet > packet, const WifiMacHeader &hdr, WifiMode txMode, WifiPreamble preamble)

void	ResetBlockAckInactivityTimerIfNeeded (BlockAckAgreement &agreement)
	Every time that a block ack request or a packet with ack policy equals to block ack are received, if a relative block ack agreement exists and the value of inactivity timeout is not 0, the timer is reset. More...

void	RxCompleteBufferedPacketsUntilFirstLost (Mac48Address originator, uint8_t tid)

void	RxCompleteBufferedPacketsWithSmallerSequence (uint16_t seq, Mac48Address originator, uint8_t tid)

void	SendAckAfterData (Mac48Address source, Time duration, WifiMode dataTxMode, double dataSnr)
	Send ACK after receiving DATA. More...

void	SendBlockAckAfterBlockAckRequest (const CtrlBAckRequestHeader reqHdr, Mac48Address originator, Time duration, WifiMode blockAckReqTxMode)
	Invoked after that a block ack request has been received. More...

void	SendBlockAckResponse (const CtrlBAckResponseHeader *blockAck, Mac48Address originator, bool immediate, Time duration, WifiMode blockAckReqTxMode)
	This method creates block ack frame with header equals to blockAck and start its transmission. More...

void	SendCtsAfterRts (Mac48Address source, Time duration, WifiMode txMode, double rtsSnr)
	Send CTS after receiving RTS. More...

void	SendCtsToSelf (void)
	Send CTS for a CTS-to-self mechanism. More...

void	SendDataAfterCts (Mac48Address source, Time duration, WifiMode txMode)
	Send DATA after receiving CTS. More...

void	SendDataPacket (void)
	Send DATA packet, which can be DATA-ACK or RTS-CTS-DATA-ACK transaction. More...

void	SendRtsForPacket (void)
	Send RTS to begin RTS-CTS-DATA-ACK transaction. More...

void	SetupPhyMacLowListener (Ptr< WifiPhy > phy)
	Set up WifiPhy listener for this MacLow. More...

void	StartDataTxTimers (WifiTxVector dataTxVector)
	Start a DATA timer by scheduling appropriate ACK timeout. More...

bool	StoreMpduIfNeeded (Ptr< Packet > packet, WifiMacHeader hdr)

void	SuperFastAckTimeout (void)
	Event handler when super fast ACK timeout occurs. More...

void	WaitSifsAfterEndTx (void)
	Event handler that is usually scheduled to fired at the appropriate time after completing transmissions. More...

Private Attributes
Time	m_ackTimeout
	ACK timeout duration. More...

Agreements	m_bAckAgreements

BlockAckCaches	m_bAckCaches

Time	m_basicBlockAckTimeout
	Basic block ACK timeout duration. More...

EventId	m_blockAckTimeoutEvent
	Block ACK timeout event. More...

Mac48Address	m_bssid
	BSSID address (Mac48Address) More...

Time	m_compressedBlockAckTimeout
	Compressed block ACK timeout duration. More...

Time	m_ctsTimeout
	CTS timeout duration. More...

EventId	m_ctsTimeoutEvent
	CTS timeout event. More...

bool	m_ctsToSelfSupported

WifiMacHeader	m_currentHdr
	Header of the current packet. More...

Ptr< Packet >	m_currentPacket
	Current packet transmitted/to be transmitted. More...

DcfListeners	m_dcfListeners
	List of MacLowDcfListener (pass events to Dcf) More...

QueueListeners	m_edcaListeners

EventId	m_endTxNoAckEvent
	Event for finishing transmission that does not require ACK. More...

EventId	m_fastAckFailedTimeoutEvent
	Fast ACK failed timeout event. More...

EventId	m_fastAckTimeoutEvent
	Fast ACK timeout event. More...

Time	m_lastNavDuration
	The duration of the latest NAV. More...

Time	m_lastNavStart
	The time when the latest NAV started. More...

MacLowTransmissionListener *	m_listener
	Transmission listener for the current packet. More...

EventId	m_navCounterResetCtsMissed
	Event to reset NAV when CTS is not received. More...

EventId	m_normalAckTimeoutEvent
	Normal ACK timeout event. More...

Ptr< WifiPhy >	m_phy
	Pointer to WifiPhy (actually send/receives frames) More...

class PhyMacLowListener *	m_phyMacLowListener
	Listerner needed to monitor when a channel switching occurs. More...

Time	m_pifs
	PCF Interframe Space (PIFS) duration. More...

bool	m_promisc
	Flag if the device is operating in promiscuous mode. More...

Time	m_rifs
	Reduced Interframe Space (RIFS) duration. More...

MacLowRxCallback	m_rxCallback
	Callback to pass packet up. More...

Mac48Address	m_self
	Address of this MacLow (Mac48Address) More...

EventId	m_sendAckEvent
	Event to send ACK. More...

EventId	m_sendCtsEvent
	Event to send CTS. More...

EventId	m_sendDataEvent
	Event to send DATA. More...

Time	m_sifs
	Short Interframe Space (SIFS) duration. More...

Time	m_slotTime
	Slot duration. More...

Ptr< WifiRemoteStationManager >	m_stationManager
	Pointer to WifiRemoteStationManager (rate control) More...

EventId	m_superFastAckTimeoutEvent
	Super fast ACK timeout event. More...

MacLowTransmissionParameters	m_txParams
	Transmission parameters of the current packet. More...

EventId	m_waitRifsEvent
	Wait for RIFS event. More...

EventId	m_waitSifsEvent
	Wait for SIFS event. More...

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

Static Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
static void	Cleanup (void)
	Noop. More...

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

Detailed Description

handle RTS/CTS/DATA/ACK transactions.

Definition at line 411 of file mac-low.h.

Member Typedef Documentation

typedef std::pair<Mac48Address, uint8_t> ns3::MacLow::AgreementKey

private

Definition at line 1125 of file mac-low.h.

typedef std::map<AgreementKey, AgreementValue> ns3::MacLow::Agreements

private

Definition at line 1128 of file mac-low.h.

typedef std::map<AgreementKey, AgreementValue>::iterator ns3::MacLow::AgreementsI

private

Definition at line 1129 of file mac-low.h.

typedef std::pair<BlockAckAgreement, std::list<BufferedPacket> > ns3::MacLow::AgreementValue

private

Definition at line 1126 of file mac-low.h.

typedef std::map<AgreementKey, BlockAckCache> ns3::MacLow::BlockAckCaches

private

Definition at line 1131 of file mac-low.h.

typedef std::map<AgreementKey, BlockAckCache>::iterator ns3::MacLow::BlockAckCachesI

private

Definition at line 1132 of file mac-low.h.

typedef std::pair<Ptr<Packet>, WifiMacHeader> ns3::MacLow::BufferedPacket

private

Definition at line 1122 of file mac-low.h.

typedef std::list<BufferedPacket>::iterator ns3::MacLow::BufferedPacketI

private

Definition at line 1123 of file mac-low.h.

typedef std::vector<MacLowDcfListener *> ns3::MacLow::DcfListeners

private

typedef for a list of MacLowDcfListener.

Definition at line 1080 of file mac-low.h.

typedef std::vector<MacLowDcfListener *>::const_iterator ns3::MacLow::DcfListenersCI

private

typedef for an iterator for a list of MacLowDcfListener.

Definition at line 1076 of file mac-low.h.

typedef Callback<void, Ptr<Packet>, const WifiMacHeader*> ns3::MacLow::MacLowRxCallback

typedef for a callback for MacLowRx

Definition at line 417 of file mac-low.h.

typedef std::map<AcIndex, MacLowBlockAckEventListener*> ns3::MacLow::QueueListeners

private

Definition at line 1137 of file mac-low.h.

Constructor & Destructor Documentation

ns3::MacLow::MacLow ( )

Definition at line 288 of file mac-low.cc.

References m_lastNavDuration, m_lastNavStart, m_promisc, and NS_LOG_FUNCTION.

ns3::MacLow::~MacLow ( )

virtual

Definition at line 311 of file mac-low.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

void ns3::MacLow::BlockAckTimeout ( void )

private

Event handler when block ACK timeout occurs.

Definition at line 1300 of file mac-low.cc.

References ns3::WifiMacHeader::GetAddr1(), m_currentHdr, m_listener, m_stationManager, ns3::MacLowTransmissionListener::MissedBlockAck(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by StartDataTxTimers().

Here is the call graph for this function:

Here is the caller graph for this function:

Time ns3::MacLow::CalculateOverallTxTime	(	Ptr< const Packet >	packet,
		const WifiMacHeader *	hdr,
		const MacLowTransmissionParameters &	params
	)		const

private

Definition at line 1063 of file mac-low.cc.

References ns3::WifiPhy::CalculateTxDuration(), GetAckDuration(), ns3::WifiMacHeader::GetAddr1(), GetCtsDuration(), GetDataTxVector(), ns3::WifiPhy::GetGreenfield(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), GetRtsSize(), GetRtsTxVector(), GetSifs(), GetSize(), m_currentHdr, m_phy, m_stationManager, ns3::MacLowTransmissionParameters::MustSendRts(), ns3::MacLowTransmissionParameters::MustWaitAck(), ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_PREAMBLE_HT_GF, ns3::WIFI_PREAMBLE_HT_MF, and ns3::WIFI_PREAMBLE_LONG.

Referenced by CalculateTransmissionTime().

Here is the call graph for this function:

Here is the caller graph for this function:

Time ns3::MacLow::CalculateTransmissionTime	(	Ptr< const Packet >	packet,
		const WifiMacHeader *	hdr,
		const MacLowTransmissionParameters &	parameters
	)		const

Parameters

packet	to send (does not include the 802.11 MAC header and checksum)
hdr	header associated to the packet to send.
parameters	transmission parameters of packet.

Returns: the transmission time that includes the time for the next packet transmission

This transmission time includes the time required for the next packet transmission if one was selected.

Definition at line 1108 of file mac-low.cc.

References CalculateOverallTxTime(), ns3::WifiPhy::CalculateTxDuration(), ns3::WifiMacHeader::GetAddr1(), GetDataTxVector(), ns3::WifiPhy::GetGreenfield(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), ns3::MacLowTransmissionParameters::GetNextPacketSize(), GetSifs(), ns3::MacLowTransmissionParameters::HasNextPacket(), m_currentHdr, m_phy, m_stationManager, ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_PREAMBLE_HT_GF, ns3::WIFI_PREAMBLE_HT_MF, and ns3::WIFI_PREAMBLE_LONG.

Here is the call graph for this function:

void ns3::MacLow::CancelAllEvents ( void )

private

Cancel all scheduled events.

Called before beginning a transmission or switching channel.

Definition at line 350 of file mac-low.cc.

References ns3::EventId::Cancel(), ns3::MacLowTransmissionListener::Cancel(), ns3::EventId::IsRunning(), m_blockAckTimeoutEvent, m_ctsTimeoutEvent, m_endTxNoAckEvent, m_fastAckFailedTimeoutEvent, m_fastAckTimeoutEvent, m_listener, m_normalAckTimeoutEvent, m_sendAckEvent, m_sendCtsEvent, m_sendDataEvent, m_superFastAckTimeoutEvent, m_waitRifsEvent, m_waitSifsEvent, and NS_LOG_FUNCTION.

Referenced by NotifySwitchingStartNow(), and StartTransmission().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::CreateBlockAckAgreement	(	const MgtAddBaResponseHeader *	respHdr,
		Mac48Address	originator,
		uint16_t	startingSeq
	)

Parameters

respHdr	Add block ack response from originator (action frame).
originator	Address of peer station involved in block ack mechanism.
startingSeq	Sequence number of the first MPDU of all packets for which block ack was negotiated.

This function is typically invoked only by ns3::RegularWifiMac when the STA (which may be non-AP in ESS, or in an IBSS) has received an ADDBA Request frame and is transmitting an ADDBA Response frame. At this point MacLow must allocate buffers to collect all correctly received packets belonging to the category for which Block Ack was negotiated.

Definition at line 1785 of file mac-low.cc.

Here is the call graph for this function:

void ns3::MacLow::CtsTimeout ( void )

private

Event handler when CTS timeout occurs.

Todo:: should check that there was no rx start before now. we should restart a new cts timeout now until the expected end of rx if there was a rx start before now.

Definition at line 1256 of file mac-low.cc.

References ns3::WifiMacHeader::GetAddr1(), m_currentHdr, m_currentPacket, m_listener, m_stationManager, ns3::MacLowTransmissionListener::MissedCts(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by SendRtsForPacket().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::DestroyBlockAckAgreement	(	Mac48Address	originator,
		uint8_t	tid
	)

Parameters

originator	Address of peer participating in Block Ack mechanism.
tid	TID for which Block Ack was created.

Checks if exists an established block ack agreement with originator for tid tid. If the agreement exists, tears down it. This function is typically invoked when a DELBA frame is received from originator.

Definition at line 1827 of file mac-low.cc.

References m_bAckAgreements, m_bAckCaches, NS_ASSERT, RxCompleteBufferedPacketsUntilFirstLost(), and RxCompleteBufferedPacketsWithSmallerSequence().

Here is the call graph for this function:

void ns3::MacLow::DoDispose ( void )

privatevirtual

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

Subclasses are expected to implement their real destruction code in an overriden 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 325 of file mac-low.cc.

References ns3::EventId::Cancel(), m_blockAckTimeoutEvent, m_ctsTimeoutEvent, m_endTxNoAckEvent, m_fastAckFailedTimeoutEvent, m_fastAckTimeoutEvent, m_normalAckTimeoutEvent, m_phy, m_phyMacLowListener, m_sendAckEvent, m_sendCtsEvent, m_sendDataEvent, m_stationManager, m_superFastAckTimeoutEvent, m_waitRifsEvent, m_waitSifsEvent, and NS_LOG_FUNCTION.

Here is the call graph for this function:

void ns3::MacLow::DoNavResetNow ( Time duration )

private

Reset NAV with the given duration.

Parameters

duration

Definition at line 1182 of file mac-low.cc.

References m_dcfListeners, m_lastNavStart, and ns3::Simulator::Now().

Referenced by NavCounterResetCtsMissed(), and NotifyNav().

Here is the call graph for this function:

Here is the caller graph for this function:

bool ns3::MacLow::DoNavStartNow ( Time duration )

private

Start NAV with the given duration.

Parameters

duration

Returns: true if NAV is resetted

Definition at line 1192 of file mac-low.cc.

References m_dcfListeners, m_lastNavDuration, m_lastNavStart, and ns3::Simulator::Now().

Referenced by NotifyNav().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::EndTxNoAck ( void )

private

A transmission that does not require an ACK has completed.

Definition at line 1698 of file mac-low.cc.

References ns3::MacLowTransmissionListener::EndTxNoAck(), and m_listener.

Referenced by StartDataTxTimers().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::FastAckFailedTimeout ( void )

private

Event handler when fast ACK timeout occurs (busy).

Definition at line 1706 of file mac-low.cc.

References m_listener, ns3::MacLowTransmissionListener::MissedAck(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by ReceiveError().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::FastAckTimeout ( void )

private

Event handler when fast ACK timeout occurs (idle).

Definition at line 1283 of file mac-low.cc.

References ns3::WifiMacHeader::GetAddr1(), ns3::WifiPhy::IsStateIdle(), m_currentHdr, m_listener, m_phy, m_stationManager, ns3::MacLowTransmissionListener::MissedAck(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by StartDataTxTimers().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::ForwardDown	(	Ptr< const Packet >	packet,
		const WifiMacHeader *	hdr,
		WifiTxVector	txVector,
		WifiPreamble	preamble
	)

private

Forward the packet down to WifiPhy for transmission.

Parameters

packet
hdr
txVector
preamble

Definition at line 1242 of file mac-low.cc.

References ns3::WifiMacHeader::GetAddr1(), ns3::WifiMacHeader::GetDuration(), ns3::WifiTxVector::GetMode(), ns3::WifiMacHeader::GetSequenceControl(), ns3::Packet::GetSize(), ns3::WifiMacHeader::GetTypeString(), m_currentHdr, m_phy, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::WifiPhy::SendPacket().

Referenced by SendAckAfterData(), SendBlockAckResponse(), SendCtsAfterRts(), SendCtsToSelf(), SendDataAfterCts(), SendDataPacket(), and SendRtsForPacket().

Here is the call graph for this function:

Here is the caller graph for this function:

Time ns3::MacLow::GetAckDuration ( WifiTxVector ackTxVector ) const

private

Return the time required to transmit the ACK (including preamble and FCS).

Parameters

ackTxVector

Returns: the time required to transmit the ACK (including preamble and FCS)

Definition at line 955 of file mac-low.cc.

References ns3::WifiPhy::CalculateTxDuration(), GetAckSize(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), m_phy, ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_PREAMBLE_HT_MF, and ns3::WIFI_PREAMBLE_LONG.

Referenced by CalculateOverallTxTime(), GetAckDuration(), SendAckAfterData(), SendBlockAckResponse(), SendCtsToSelf(), SendDataAfterCts(), SendDataPacket(), and SendRtsForPacket().

Here is the call graph for this function:

Here is the caller graph for this function:

Time ns3::MacLow::GetAckDuration	(	Mac48Address	to,
		WifiTxVector	dataTxVector
	)		const

private

Return the time required to transmit the ACK to the specified address given the TXVECTOR of the DATA (including preamble and FCS).

Parameters

to
dataTxVector

Returns: the time required to transmit the ACK (including preamble and FCS)

Definition at line 949 of file mac-low.cc.

References GetAckDuration(), GetAckTxVectorForData(), and ns3::WifiTxVector::GetMode().

Here is the call graph for this function:

uint32_t ns3::MacLow::GetAckSize ( void ) const

private

Return the total ACK size (including FCS trailer).

Returns: the total ACK size

Definition at line 914 of file mac-low.cc.

References ns3::WifiMacHeader::GetSize(), ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_CTL_ACK.

Referenced by GetAckDuration().

Here is the call graph for this function:

Here is the caller graph for this function:

Time ns3::MacLow::GetAckTimeout ( void ) const

Return ACK timeout of this MacLow.

Returns: ACK timeout

Definition at line 506 of file mac-low.cc.

References m_ackTimeout.

Referenced by StartDataTxTimers().

Here is the caller graph for this function:

WifiTxVector ns3::MacLow::GetAckTxVector	(	Mac48Address	to,
		WifiMode	dataTxMode
	)		const

private

Return a TXVECTOR for the ACK frame given the destination and the mode of the DATA used by the sender.

The function consults WifiRemoteStationManager, which controls the rate to different destinations.

Parameters

to	the MAC address of the ACK receiver
dataTxMode	the mode of the DATA used by the sender

Returns: TXVECTOR for the ACK

Definition at line 1040 of file mac-low.cc.

References m_stationManager.

Referenced by GetAckTxVectorForData(), and SendAckAfterData().

Here is the caller graph for this function:

WifiTxVector ns3::MacLow::GetAckTxVectorForData	(	Mac48Address	to,
		WifiMode	dataTxMode
	)		const

private

Return a TXVECTOR for the Block ACK frame given the destination and the mode of the DATA used by the sender.

The function consults WifiRemoteStationManager, which controls the rate to different destinations.

Parameters

to	the MAC address of the Block ACK receiver
dataTxMode	the mode of the DATA used by the sender

Returns: TXVECTOR for the Block ACK

Definition at line 1056 of file mac-low.cc.

References GetAckTxVector().

Referenced by GetAckDuration().

Here is the call graph for this function:

Here is the caller graph for this function:

Mac48Address ns3::MacLow::GetAddress ( void ) const

Return the MAC address of this MacLow.

Returns: Mac48Address of this MacLow

Definition at line 501 of file mac-low.cc.

References m_self.

Referenced by SendBlockAckResponse().

Here is the caller graph for this function:

Time ns3::MacLow::GetBasicBlockAckTimeout ( ) const

Return Basic Block ACK timeout of this MacLow.

Returns: Basic Block ACK timeout

Definition at line 511 of file mac-low.cc.

References m_basicBlockAckTimeout.

Referenced by StartDataTxTimers().

Here is the caller graph for this function:

Time ns3::MacLow::GetBlockAckDuration	(	Mac48Address	to,
		WifiTxVector	blockAckReqTxVector,
		enum BlockAckType	type
	)		const

private

Definition at line 965 of file mac-low.cc.

References ns3::WifiPhy::CalculateTxDuration(), GetBlockAckSize(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), m_phy, ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_PREAMBLE_HT_MF, and ns3::WIFI_PREAMBLE_LONG.

Referenced by SendBlockAckResponse(), SendCtsToSelf(), and SendDataPacket().

Here is the call graph for this function:

Here is the caller graph for this function:

uint32_t ns3::MacLow::GetBlockAckSize ( enum BlockAckType type ) const

private

Return the total Block ACK size (including FCS trailer).

Parameters

type	the Block ACK type

Returns: the total Block ACK size

Definition at line 921 of file mac-low.cc.

References ns3::BASIC_BLOCK_ACK, ns3::COMPRESSED_BLOCK_ACK, ns3::CtrlBAckResponseHeader::GetSerializedSize(), ns3::WifiMacHeader::GetSize(), ns3::MULTI_TID_BLOCK_ACK, NS_ASSERT, ns3::WifiMacHeader::SetType(), ns3::CtrlBAckResponseHeader::SetType(), and ns3::WIFI_MAC_CTL_BACKRESP.

Referenced by GetBlockAckDuration().

Here is the call graph for this function:

Here is the caller graph for this function:

WifiTxVector ns3::MacLow::GetBlockAckTxVector	(	Mac48Address	to,
		WifiMode	dataTxMode
	)		const

private

Return a TXVECTOR for the Block ACK frame given the destination and the mode of the DATA used by the sender.

The function consults WifiRemoteStationManager, which controls the rate to different destinations.

Parameters

to	the MAC address of the Block ACK receiver
dataTxMode	the mode of the DATA used by the sender

Returns: TXVECTOR for the Block ACK

Definition at line 1045 of file mac-low.cc.

References m_stationManager.

Referenced by SendBlockAckResponse().

Here is the caller graph for this function:

Mac48Address ns3::MacLow::GetBssid ( void ) const

Return the Basic Service Set Identification.

Returns: BSSID

Definition at line 546 of file mac-low.cc.

References m_bssid.

Time ns3::MacLow::GetCompressedBlockAckTimeout ( ) const

Return Compressed Block ACK timeout of this MacLow.

Returns: Compressed Block ACK timeout

Definition at line 516 of file mac-low.cc.

References m_compressedBlockAckTimeout.

Referenced by StartDataTxTimers().

Here is the caller graph for this function:

Time ns3::MacLow::GetCtsDuration ( WifiTxVector ctsTxVector ) const

private

Return the time required to transmit the CTS (including preamble and FCS).

Parameters

ctsTxVector

Returns: the time required to transmit the CTS (including preamble and FCS)

Definition at line 990 of file mac-low.cc.

References ns3::WifiPhy::CalculateTxDuration(), GetCtsSize(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), m_phy, ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_PREAMBLE_HT_MF, and ns3::WIFI_PREAMBLE_LONG.

Referenced by CalculateOverallTxTime(), GetCtsDuration(), SendCtsAfterRts(), and SendRtsForPacket().

Here is the call graph for this function:

Here is the caller graph for this function:

Time ns3::MacLow::GetCtsDuration	(	Mac48Address	to,
		WifiTxVector	rtsTxVector
	)		const

private

Return the time required to transmit the CTS to the specified address given the TXVECTOR of the RTS (including preamble and FCS).

Parameters

to
rtsTxVector

Returns: the time required to transmit the CTS (including preamble and FCS)

Definition at line 983 of file mac-low.cc.

References GetCtsDuration(), GetCtsTxVectorForRts(), and ns3::WifiTxVector::GetMode().

Here is the call graph for this function:

uint32_t ns3::MacLow::GetCtsSize ( void ) const

private

Return the total CTS size (including FCS trailer).

Returns: the total CTS size

Definition at line 1000 of file mac-low.cc.

References ns3::WifiMacHeader::GetSize(), ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_CTL_CTS.

Referenced by GetCtsDuration(), and SendCtsToSelf().

Here is the call graph for this function:

Here is the caller graph for this function:

Time ns3::MacLow::GetCtsTimeout ( void ) const

Return CTS timeout of this MacLow.

Returns: CTS timeout

Definition at line 521 of file mac-low.cc.

References m_ctsTimeout.

Referenced by SendRtsForPacket().

Here is the caller graph for this function:

bool ns3::MacLow::GetCtsToSelfSupported ( ) const

Return whether CTS-to-self capability is supported.

Returns: true if CTS-to-self is supported, false otherwise

Definition at line 461 of file mac-low.cc.

References m_ctsToSelfSupported.

WifiTxVector ns3::MacLow::GetCtsToSelfTxVector	(	Ptr< const Packet >	packet,
		const WifiMacHeader *	hdr
	)		const

private

Return a TXVECTOR for the CTS-to-self frame.

The function consults WifiRemoteStationManager, which controls the rate to different destinations.

Parameters

packet	the packet that requires CTS-to-self
hdr	the Wifi header of the packet

Returns: TXVECTOR for the CTS-to-self operation

Definition at line 1014 of file mac-low.cc.

References m_stationManager.

Referenced by SendCtsToSelf().

Here is the caller graph for this function:

WifiTxVector ns3::MacLow::GetCtsTxVector	(	Mac48Address	to,
		WifiMode	rtsTxMode
	)		const

private

Return a TXVECTOR for the CTS frame given the destination and the mode of the RTS used by the sender.

The function consults WifiRemoteStationManager, which controls the rate to different destinations.

Parameters

to	the MAC address of the CTS receiver
rtsTxMode	the mode of the RTS used by the sender

Returns: TXVECTOR for the CTS

Definition at line 1035 of file mac-low.cc.

References m_stationManager.

Referenced by GetCtsTxVectorForRts(), and SendCtsAfterRts().

Here is the caller graph for this function:

WifiTxVector ns3::MacLow::GetCtsTxVectorForRts	(	Mac48Address	to,
		WifiMode	rtsTxMode
	)		const

private

Return a TXVECTOR for the CTS frame given the destination and the mode of the RTS used by the sender.

The function consults WifiRemoteStationManager, which controls the rate to different destinations.

Parameters

to	the MAC address of the CTS receiver
rtsTxMode	the mode of the RTS used by the sender

Returns: TXVECTOR for the CTS

Definition at line 1051 of file mac-low.cc.

References GetCtsTxVector().

Referenced by GetCtsDuration().

Here is the call graph for this function:

Here is the caller graph for this function:

WifiTxVector ns3::MacLow::GetDataTxVector	(	Ptr< const Packet >	packet,
		const WifiMacHeader *	hdr
	)		const

protectedvirtual

Return a TXVECTOR for the DATA frame given the destination.

The function consults WifiRemoteStationManager, which controls the rate to different destinations.

Parameters

packet	the packet being asked for TXVECTOR
hdr	the WifiMacHeader

Returns: TXVECTOR for the given packet

Reimplemented in ns3::WaveMacLow.

Definition at line 1026 of file mac-low.cc.

References ns3::WifiMacHeader::GetAddr1(), ns3::WifiMacTrailer::GetSerializedSize(), ns3::Packet::GetSize(), ns3::WifiMacHeader::GetSize(), and m_stationManager.

Referenced by CalculateOverallTxTime(), CalculateTransmissionTime(), ns3::WaveMacLow::GetDataTxVector(), NeedCtsToSelf(), SendCtsToSelf(), SendDataAfterCts(), SendDataPacket(), and SendRtsForPacket().

Here is the call graph for this function:

Here is the caller graph for this function:

Time ns3::MacLow::GetPifs ( void ) const

Return PCF Interframe Space (PIFS) of this MacLow.

Returns: PIFS

Definition at line 541 of file mac-low.cc.

References m_pifs.

Referenced by StartDataTxTimers().

Here is the caller graph for this function:

Time ns3::MacLow::GetRifs ( void ) const

Return Reduced Interframe Space (RIFS) of this MacLow.

Returns: RIFS

Definition at line 531 of file mac-low.cc.

References m_rifs.

Referenced by StartDataTxTimers().

Here is the caller graph for this function:

uint32_t ns3::MacLow::GetRtsSize ( void ) const

private

Return the total RTS size (including FCS trailer).

Returns: the total RTS size

Definition at line 942 of file mac-low.cc.

References ns3::WifiMacHeader::GetSize(), ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_CTL_RTS.

Referenced by CalculateOverallTxTime(), and SendRtsForPacket().

Here is the call graph for this function:

Here is the caller graph for this function:

WifiTxVector ns3::MacLow::GetRtsTxVector	(	Ptr< const Packet >	packet,
		const WifiMacHeader *	hdr
	)		const

private

Return a TXVECTOR for the RTS frame given the destination.

The function consults WifiRemoteStationManager, which controls the rate to different destinations.

Parameters

packet	the packet being asked for RTS TXVECTOR
hdr	the WifiMacHeader

Returns: TXVECTOR for the RTS of the given packet

Definition at line 1020 of file mac-low.cc.

References ns3::WifiMacHeader::GetAddr1(), and m_stationManager.

Referenced by CalculateOverallTxTime(), NotifyNav(), and SendRtsForPacket().

Here is the call graph for this function:

Here is the caller graph for this function:

Time ns3::MacLow::GetSifs ( void ) const

Return Short Interframe Space (SIFS) of this MacLow.

Returns: SIFS

Definition at line 526 of file mac-low.cc.

References m_sifs.

Referenced by CalculateOverallTxTime(), CalculateTransmissionTime(), NotifyNav(), ReceiveError(), ReceiveOk(), SendAckAfterData(), SendBlockAckResponse(), SendCtsAfterRts(), SendCtsToSelf(), SendDataAfterCts(), SendDataPacket(), SendRtsForPacket(), and StartDataTxTimers().

Here is the caller graph for this function:

uint32_t ns3::MacLow::GetSize	(	Ptr< const Packet >	packet,
		const WifiMacHeader *	hdr
	)		const

private

Return the total size of the packet after WifiMacHeader and FCS trailer have been added.

Parameters

packet	the packet to be encapsulated with WifiMacHeader and FCS trailer
hdr	the WifiMacHeader

Returns: the total packet size

Definition at line 1007 of file mac-low.cc.

References ns3::WifiMacTrailer::GetSerializedSize(), ns3::Packet::GetSize(), and ns3::WifiMacHeader::GetSize().

Referenced by CalculateOverallTxTime(), SendCtsToSelf(), SendDataAfterCts(), SendRtsForPacket(), StartDataTxTimers(), and StartTransmission().

Here is the call graph for this function:

Here is the caller graph for this function:

Time ns3::MacLow::GetSlotTime ( void ) const

Return slot duration of this MacLow.

Returns: slot duration

Definition at line 536 of file mac-low.cc.

References m_slotTime.

Referenced by NotifyNav().

Here is the caller graph for this function:

bool ns3::MacLow::IsNavZero ( void ) const

private

Check if NAV is zero.

Returns: true if NAV is zero, false otherwise

Definition at line 1519 of file mac-low.cc.

References m_lastNavDuration, m_lastNavStart, and ns3::Simulator::Now().

Referenced by ReceiveOk().

Here is the call graph for this function:

Here is the caller graph for this function:

bool ns3::MacLow::IsPromisc ( void ) const

Check if MacLow is operating in promiscuous mode.

Returns: true if MacLow is operating in promiscuous mode, false otherwise

Definition at line 551 of file mac-low.cc.

References m_promisc.

void ns3::MacLow::NavCounterResetCtsMissed ( Time rtsEndRxTime )

private

Reset NAV after CTS was missed when the NAV was setted with RTS.

Parameters

rtsEndRxTime

Definition at line 1173 of file mac-low.cc.

References DoNavResetNow(), ns3::WifiPhy::GetLastRxStartTime(), and m_phy.

Referenced by NotifyNav().

Here is the call graph for this function:

Here is the caller graph for this function:

bool ns3::MacLow::NeedCtsToSelf ( void )

private

Check if CTS-to-self mechanism should be used for the current packet.

Returns: true if CTS-to-self mechanism should be used for the current packet, false otherwise

Definition at line 620 of file mac-low.cc.

References GetDataTxVector(), m_currentHdr, m_currentPacket, and m_stationManager.

Referenced by StartTransmission().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::NormalAckTimeout ( void )

private

Event handler when normal ACK timeout occurs.

Todo:: should check that there was no rx start before now. we should restart a new ack timeout now until the expected end of rx if there was a rx start before now.

Definition at line 1270 of file mac-low.cc.

References ns3::WifiMacHeader::GetAddr1(), m_currentHdr, m_listener, m_stationManager, ns3::MacLowTransmissionListener::MissedAck(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by StartDataTxTimers().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::NotifyAckTimeoutResetNow ( )

private

Notify DcfManager (via DcfListener) that ACK timer should be resetted.

Definition at line 1217 of file mac-low.cc.

References m_dcfListeners.

Referenced by ReceiveOk().

Here is the caller graph for this function:

void ns3::MacLow::NotifyAckTimeoutStartNow ( Time duration )

private

Notify DcfManager (via DcfListener) that ACK timer should be started for the given duration.

Parameters

duration

Definition at line 1209 of file mac-low.cc.

References m_dcfListeners.

Referenced by StartDataTxTimers().

Here is the caller graph for this function:

void ns3::MacLow::NotifyCtsTimeoutResetNow ( )

private

Notify DcfManager (via DcfListener) that CTS timer should be resetted.

Definition at line 1233 of file mac-low.cc.

References m_dcfListeners.

Referenced by ReceiveOk().

Here is the caller graph for this function:

void ns3::MacLow::NotifyCtsTimeoutStartNow ( Time duration )

private

Notify DcfManager (via DcfListener) that CTS timer should be started for the given duration.

Parameters

duration

Definition at line 1225 of file mac-low.cc.

References m_dcfListeners.

Referenced by SendRtsForPacket().

Here is the caller graph for this function:

void ns3::MacLow::NotifyNav	(	Ptr< const Packet >	packet,
		const WifiMacHeader &	hdr,
		WifiMode	txMode,
		WifiPreamble	preamble
	)

private

Todo:: We should also handle CF_END specially here but we don't for now because we do not generate them.

A STA that used information from an RTS frame as the most recent basis to update its NAV setting is permitted to reset its NAV if no PHY-RXSTART.indication is detected from the PHY during a period with a duration of (2 * aSIFSTime) + (CTS_Time) + (2 * aSlotTime) starting at the PHY-RXEND.indication corresponding to the detection of the RTS frame. The “CTS_Time” shall be calculated using the length of the CTS frame and the data rate at which the RTS frame used for the most recent NAV update was received.

Definition at line 1131 of file mac-low.cc.

References ns3::WifiPhy::CalculateTxDuration(), DoNavResetNow(), DoNavStartNow(), ns3::WifiMacHeader::GetAddr1(), ns3::WifiMacHeader::GetAddr2(), ns3::WifiMacHeader::GetDuration(), GetRtsTxVector(), ns3::WifiMacHeader::GetSerializedSize(), GetSifs(), GetSlotTime(), ns3::WifiMacHeader::IsCfpoll(), ns3::WifiMacHeader::IsRts(), m_bssid, m_lastNavStart, m_navCounterResetCtsMissed, m_phy, m_self, NavCounterResetCtsMissed(), ns3::Simulator::Now(), NS_ASSERT, ns3::Simulator::Schedule(), ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_CTL_CTS.

Referenced by ReceiveOk().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::NotifySwitchingStartNow ( Time duration )

Parameters

duration switching delay duration.

This method is typically invoked by the PhyMacLowListener to notify the MAC layer that a channel switching occured. When a channel switching occurs, pending MAC transmissions (RTS, CTS, DATA and ACK) are cancelled.

Definition at line 640 of file mac-low.cc.

References ns3::EventId::Cancel(), CancelAllEvents(), ns3::EventId::IsRunning(), m_currentPacket, m_lastNavDuration, m_lastNavStart, m_listener, m_navCounterResetCtsMissed, m_stationManager, ns3::Simulator::Now(), and NS_LOG_DEBUG.

Referenced by ns3::PhyMacLowListener::NotifySwitchingStart().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::ReceiveError	(	Ptr< const Packet >	packet,
		double	rxSnr
	)

Parameters

packet	packet received.
rxSnr	snr of packet received.

This method is typically invoked by the lower PHY layer to notify the MAC layer that a packet was unsuccessfully received.

Definition at line 626 of file mac-low.cc.

References FastAckFailedTimeout(), GetSifs(), ns3::EventId::IsExpired(), m_fastAckFailedTimeoutEvent, m_txParams, ns3::MacLowTransmissionParameters::MustWaitFastAck(), NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::Simulator::Schedule().

Referenced by SetPhy().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::ReceiveOk	(	Ptr< Packet >	packet,
		double	rxSnr,
		WifiMode	txMode,
		WifiPreamble	preamble
	)

Parameters

packet	packet received
rxSnr	snr of packet received
txMode	transmission mode of packet received
preamble	type of preamble used for the packet received

This method is typically invoked by the lower PHY layer to notify the MAC layer that a packet was successfully received.

Definition at line 656 of file mac-low.cc.

Referenced by SetPhy().

Here is the caller graph for this function:

void ns3::MacLow::RegisterBlockAckListenerForAc	(	enum AcIndex	ac,
		MacLowBlockAckEventListener *	listener
	)

Parameters

ac	Access class managed by the queue.
listener	The listener for the queue.

The lifetime of the registered listener is typically equal to the lifetime of the queue associated to this AC.

Definition at line 2074 of file mac-low.cc.

References m_edcaListeners.

void ns3::MacLow::RegisterDcfListener ( MacLowDcfListener * listener )

Parameters

listener listen to NAV events for every incoming and outgoing packet.

Definition at line 562 of file mac-low.cc.

References m_dcfListeners.

void ns3::MacLow::ResetBlockAckInactivityTimerIfNeeded ( BlockAckAgreement & agreement )

private

Every time that a block ack request or a packet with ack policy equals to block ack are received, if a relative block ack agreement exists and the value of inactivity timeout is not 0, the timer is reset.

see section 11.5.3 in IEEE802.11e for more details.

Parameters

agreement

Definition at line 2053 of file mac-low.cc.

References ns3::MacLowBlockAckEventListener::BlockAckInactivityTimeout(), ns3::EventId::Cancel(), ns3::BlockAckAgreement::GetPeer(), ns3::BlockAckAgreement::GetTid(), ns3::BlockAckAgreement::GetTimeout(), ns3::EventId::IsRunning(), m_edcaListeners, ns3::BlockAckAgreement::m_inactivityEvent, NS_ASSERT, ns3::QosUtilsMapTidToAc(), ns3::Simulator::Schedule(), and timeout.

Referenced by ReceiveOk().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::RxCompleteBufferedPacketsUntilFirstLost	(	Mac48Address	originator,
		uint8_t	tid
	)

private

Parameters

originator	Address of peer participating in Block Ack mechanism.
tid	TID for which Block Ack was created.

This method is typically invoked when a MPDU with ack policy subfield set to Normal Ack is received and a block ack agreement for that packet exists. This happens when the originator of block ack has only few MPDUs to send. All completed MSDUs starting with starting sequence number of block ack agreement are forward up to WifiMac until there is an incomplete or missing MSDU. See section 9.10.4 in IEEE802.11 standard for more details.

Definition at line 1903 of file mac-low.cc.

References m_bAckAgreements, and m_rxCallback.

Referenced by DestroyBlockAckAgreement(), ReceiveOk(), and SendBlockAckAfterBlockAckRequest().

Here is the caller graph for this function:

void ns3::MacLow::RxCompleteBufferedPacketsWithSmallerSequence	(	uint16_t	seq,
		Mac48Address	originator,
		uint8_t	tid
	)

private

Parameters

originator	Address of peer participating in Block Ack mechanism.
tid	TID for which Block Ack was created.
seq	Starting sequence

This function forward up all completed "old" packets with sequence number smaller than seq. All comparison are performed circularly mod 4096.

Definition at line 1843 of file mac-low.cc.

References m_bAckAgreements, m_rxCallback, and ns3::QosUtilsMapSeqControlToUniqueInteger().

Referenced by DestroyBlockAckAgreement(), ReceiveOk(), and SendBlockAckAfterBlockAckRequest().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::SendAckAfterData	(	Mac48Address	source,
		Time	duration,
		WifiMode	dataTxMode,
		double	dataSnr
	)

private

Send ACK after receiving DATA.

Parameters

source
duration
dataTxMode
dataSnr

Definition at line 1716 of file mac-low.cc.

References ns3::Packet::AddHeader(), ns3::Packet::AddPacketTag(), ns3::Packet::AddTrailer(), ForwardDown(), GetAckDuration(), GetAckTxVector(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), GetSifs(), NS_ASSERT, NS_LOG_FUNCTION, ns3::SnrTag::Set(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::WifiMacHeader::SetDuration(), ns3::WifiMacHeader::SetNoMoreFragments(), ns3::WifiMacHeader::SetNoRetry(), ns3::WifiMacHeader::SetType(), ns3::WIFI_MAC_CTL_ACK, ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_PREAMBLE_HT_MF, and ns3::WIFI_PREAMBLE_LONG.

Referenced by ReceiveOk().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::SendBlockAckAfterBlockAckRequest	(	const CtrlBAckRequestHeader	reqHdr,
		Mac48Address	originator,
		Time	duration,
		WifiMode	blockAckReqTxMode
	)

private

Invoked after that a block ack request has been received.

Looks for corresponding block ack agreement and creates block ack bitmap on a received packets basis.

Parameters

reqHdr
originator
duration
blockAckReqTxMode

Definition at line 2005 of file mac-low.cc.

References ns3::BASIC_BLOCK_ACK, ns3::COMPRESSED_BLOCK_ACK, ns3::CtrlBAckRequestHeader::GetStartingSequence(), ns3::CtrlBAckRequestHeader::GetTidInfo(), ns3::CtrlBAckRequestHeader::IsBasic(), ns3::CtrlBAckRequestHeader::IsCompressed(), ns3::CtrlBAckRequestHeader::IsMultiTid(), m_bAckAgreements, m_bAckCaches, NS_ASSERT, NS_FATAL_ERROR, NS_LOG_DEBUG, NS_LOG_FUNCTION, RxCompleteBufferedPacketsUntilFirstLost(), RxCompleteBufferedPacketsWithSmallerSequence(), SendBlockAckResponse(), ns3::CtrlBAckResponseHeader::SetStartingSequence(), ns3::CtrlBAckResponseHeader::SetTidInfo(), and ns3::CtrlBAckResponseHeader::SetType().

Referenced by ReceiveOk().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::SendBlockAckResponse	(	const CtrlBAckResponseHeader *	blockAck,
		Mac48Address	originator,
		bool	immediate,
		Time	duration,
		WifiMode	blockAckReqTxMode
	)

private

This method creates block ack frame with header equals to blockAck and start its transmission.

Parameters

blockAck
originator
immediate
duration
blockAckReqTxMode

Definition at line 1935 of file mac-low.cc.

Referenced by SendBlockAckAfterBlockAckRequest().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::SendCtsAfterRts	(	Mac48Address	source,
		Time	duration,
		WifiMode	txMode,
		double	rtsSnr
	)

private

Send CTS after receiving RTS.

Parameters

source
duration
txMode
rtsSnr

Definition at line 1615 of file mac-low.cc.

References ns3::Packet::AddHeader(), ns3::Packet::AddPacketTag(), ns3::Packet::AddTrailer(), ForwardDown(), GetCtsDuration(), GetCtsTxVector(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), GetSifs(), NS_ASSERT, NS_LOG_FUNCTION, ns3::SnrTag::Set(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::WifiMacHeader::SetDuration(), ns3::WifiMacHeader::SetNoMoreFragments(), ns3::WifiMacHeader::SetNoRetry(), ns3::WifiMacHeader::SetType(), ns3::WIFI_MAC_CTL_CTS, ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_PREAMBLE_HT_MF, and ns3::WIFI_PREAMBLE_LONG.

Referenced by ReceiveOk().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::SendCtsToSelf ( void )

private

Send CTS for a CTS-to-self mechanism.

Definition at line 1531 of file mac-low.cc.

Referenced by StartTransmission().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::SendDataAfterCts	(	Mac48Address	source,
		Time	duration,
		WifiMode	txMode
	)

private

Send DATA after receiving CTS.

Parameters

source
duration
txMode

Definition at line 1652 of file mac-low.cc.

References ns3::Packet::AddHeader(), ns3::Packet::AddTrailer(), ns3::WifiPhy::CalculateTxDuration(), ForwardDown(), GetAckDuration(), ns3::WifiMacHeader::GetAddr1(), GetDataTxVector(), ns3::WifiPhy::GetGreenfield(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), GetSifs(), GetSize(), m_currentHdr, m_currentPacket, m_phy, m_stationManager, NS_ASSERT, NS_LOG_FUNCTION, ns3::WifiMacHeader::SetDuration(), StartDataTxTimers(), ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_PREAMBLE_HT_GF, ns3::WIFI_PREAMBLE_HT_MF, and ns3::WIFI_PREAMBLE_LONG.

Referenced by ReceiveOk(), and SendCtsToSelf().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::SendDataPacket ( void )

private

Send DATA packet, which can be DATA-ACK or RTS-CTS-DATA-ACK transaction.

Definition at line 1457 of file mac-low.cc.

References ns3::Packet::AddHeader(), ns3::Packet::AddTrailer(), ns3::BASIC_BLOCK_ACK, ns3::WifiPhy::CalculateTxDuration(), ns3::COMPRESSED_BLOCK_ACK, ForwardDown(), GetAckDuration(), ns3::WifiMacHeader::GetAddr1(), GetBlockAckDuration(), GetDataTxVector(), ns3::MacLowTransmissionParameters::GetDurationId(), ns3::WifiPhy::GetGreenfield(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), ns3::MacLowTransmissionParameters::GetNextPacketSize(), GetSifs(), ns3::MacLowTransmissionParameters::HasDurationId(), ns3::MacLowTransmissionParameters::HasNextPacket(), m_currentHdr, m_currentPacket, m_phy, m_stationManager, m_txParams, ns3::MacLowTransmissionParameters::MustWaitAck(), ns3::MacLowTransmissionParameters::MustWaitBasicBlockAck(), ns3::MacLowTransmissionParameters::MustWaitCompressedBlockAck(), NS_LOG_FUNCTION, ns3::WifiMacHeader::SetDuration(), StartDataTxTimers(), ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_PREAMBLE_HT_GF, ns3::WIFI_PREAMBLE_HT_MF, and ns3::WIFI_PREAMBLE_LONG.

Referenced by StartTransmission().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::SendRtsForPacket ( void )

private

Send RTS to begin RTS-CTS-DATA-ACK transaction.

Definition at line 1330 of file mac-low.cc.

Referenced by StartTransmission().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::SetAckTimeout ( Time ackTimeout )

Set ACK timeout of this MacLow.

Parameters

ackTimeout ACK timeout of this MacLow

Definition at line 441 of file mac-low.cc.

References m_ackTimeout.

void ns3::MacLow::SetAddress ( Mac48Address ad )

Set MAC address of this MacLow.

Parameters

ad	Mac48Address of this MacLow

Definition at line 436 of file mac-low.cc.

References m_self.

void ns3::MacLow::SetBasicBlockAckTimeout ( Time blockAckTimeout )

Set Basic Block ACK timeout of this MacLow.

Parameters

blockAckTimeout Basic Block ACK timeout of this MacLow

Definition at line 446 of file mac-low.cc.

References m_basicBlockAckTimeout.

void ns3::MacLow::SetBssid ( Mac48Address ad )

Set the Basic Service Set Identification.

Parameters

ad the BSSID

Definition at line 491 of file mac-low.cc.

References m_bssid.

void ns3::MacLow::SetCompressedBlockAckTimeout ( Time blockAckTimeout )

Set Compressed Block ACK timeout of this MacLow.

Parameters

blockAckTimeout Compressed Block ACK timeout of this MacLow

Definition at line 451 of file mac-low.cc.

References m_compressedBlockAckTimeout.

void ns3::MacLow::SetCtsTimeout ( Time ctsTimeout )

Set CTS timeout of this MacLow.

Parameters

ctsTimeout CTS timeout of this MacLow

Definition at line 466 of file mac-low.cc.

References m_ctsTimeout.

void ns3::MacLow::SetCtsToSelfSupported ( bool enable )

Enable or disable CTS-to-self capability.

Parameters

enable Enable or disable CTS-to-self capability

Definition at line 456 of file mac-low.cc.

References m_ctsToSelfSupported.

void ns3::MacLow::SetPhy ( Ptr< WifiPhy > phy )

Set up WifiPhy associated with this MacLow.

Parameters

phy	WifiPhy associated with this MacLow

Definition at line 422 of file mac-low.cc.

References m_phy, ns3::MakeCallback(), ReceiveError(), ReceiveOk(), ns3::WifiPhy::SetReceiveErrorCallback(), ns3::WifiPhy::SetReceiveOkCallback(), and SetupPhyMacLowListener().

Here is the call graph for this function:

void ns3::MacLow::SetPifs ( Time pifs )

Set PCF Interframe Space (PIFS) of this MacLow.

Parameters

pifs	PIFS of this MacLow

Definition at line 481 of file mac-low.cc.

References m_pifs.

void ns3::MacLow::SetPromisc ( void )

Enable promiscuous mode.

Definition at line 496 of file mac-low.cc.

References m_promisc.

void ns3::MacLow::SetRifs ( Time rifs )

Set Reduced Interframe Space (RIFS) of this MacLow.

Parameters

rifs	RIFS of this MacLow

Definition at line 486 of file mac-low.cc.

References m_rifs.

void ns3::MacLow::SetRxCallback ( Callback< void, Ptr< Packet >, const WifiMacHeader * > callback )

Parameters

callback the callback which receives every incoming packet.

This callback typically forwards incoming packets to an instance of ns3::MacRxMiddle.

Definition at line 557 of file mac-low.cc.

References m_rxCallback.

void ns3::MacLow::SetSifs ( Time sifs )

Set Short Interframe Space (SIFS) of this MacLow.

Parameters

sifs	SIFS of this MacLow

Definition at line 471 of file mac-low.cc.

References m_sifs.

void ns3::MacLow::SetSlotTime ( Time slotTime )

Set slot duration of this MacLow.

Parameters

slotTime slot duration of this MacLow

Definition at line 476 of file mac-low.cc.

References m_slotTime.

void ns3::MacLow::SetupPhyMacLowListener ( Ptr< WifiPhy > phy )

private

Set up WifiPhy listener for this MacLow.

Parameters

phy	the WifiPhy this MacLow is connected to

Definition at line 317 of file mac-low.cc.

References m_phyMacLowListener, and ns3::WifiPhy::RegisterListener().

Referenced by SetPhy().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::SetWifiRemoteStationManager ( Ptr< WifiRemoteStationManager > manager )

Set up WifiRemoteStationManager associated with this MacLow.

Parameters

manager WifiRemoteStationManager associated with this MacLow

Definition at line 430 of file mac-low.cc.

References m_stationManager.

void ns3::MacLow::StartDataTxTimers ( WifiTxVector dataTxVector )

private

Start a DATA timer by scheduling appropriate ACK timeout.

Parameters

dataTxVector

Definition at line 1387 of file mac-low.cc.

References BlockAckTimeout(), ns3::WifiPhy::CalculateTxDuration(), EndTxNoAck(), FastAckTimeout(), GetAckTimeout(), ns3::WifiMacHeader::GetAddr1(), GetBasicBlockAckTimeout(), GetCompressedBlockAckTimeout(), ns3::WifiPhy::GetGreenfield(), ns3::WifiTxVector::GetMode(), ns3::WifiMode::GetModulationClass(), GetPifs(), GetRifs(), GetSifs(), GetSize(), ns3::MacLowTransmissionParameters::HasNextPacket(), ns3::EventId::IsExpired(), m_blockAckTimeoutEvent, m_currentHdr, m_currentPacket, m_fastAckTimeoutEvent, m_normalAckTimeoutEvent, m_phy, m_stationManager, m_superFastAckTimeoutEvent, m_txParams, m_waitRifsEvent, m_waitSifsEvent, ns3::MacLowTransmissionParameters::MustWaitBasicBlockAck(), ns3::MacLowTransmissionParameters::MustWaitCompressedBlockAck(), ns3::MacLowTransmissionParameters::MustWaitFastAck(), ns3::MacLowTransmissionParameters::MustWaitNormalAck(), ns3::MacLowTransmissionParameters::MustWaitSuperFastAck(), NormalAckTimeout(), NotifyAckTimeoutStartNow(), NS_ASSERT, ns3::Simulator::Schedule(), SuperFastAckTimeout(), WaitSifsAfterEndTx(), ns3::WIFI_MOD_CLASS_HT, ns3::WIFI_PREAMBLE_HT_GF, ns3::WIFI_PREAMBLE_HT_MF, and ns3::WIFI_PREAMBLE_LONG.

Referenced by SendBlockAckResponse(), SendDataAfterCts(), and SendDataPacket().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MacLow::StartTransmission	(	Ptr< const Packet >	packet,
		const WifiMacHeader *	hdr,
		MacLowTransmissionParameters	parameters,
		MacLowTransmissionListener *	listener
	)

Parameters

packet	packet to send
hdr	802.11 header for packet to send
parameters	the transmission parameters to use for this packet.
listener	listen to transmission events.

Start the transmission of the input packet and notify the listener of transmission events.

Definition at line 569 of file mac-low.cc.

References CancelAllEvents(), ns3::Packet::Copy(), ns3::WifiMacHeader::GetAddr1(), GetSize(), ns3::WifiPhy::IsStateTx(), m_ctsToSelfSupported, m_currentHdr, m_currentPacket, m_listener, m_phy, m_txParams, ns3::MacLowTransmissionParameters::MustSendRts(), NeedCtsToSelf(), NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, SendCtsToSelf(), SendDataPacket(), and SendRtsForPacket().