base class for all MAC-level wifi objects. More...
#include "wifi-mac.h"
Classes | |
struct | LinkEntity |
Structure holding information specific to a single link. More... | |
Public Types | |
typedef Callback< void, Ptr< const Packet >, Mac48Address, Mac48Address > | ForwardUpCallback |
This type defines the callback of a higher layer that a WifiMac(-derived) object invokes to pass a packet up the stack. | |
using | OriginatorAgreementOptConstRef |
optional const reference to OriginatorBlockAckAgreement | |
using | RecipientAgreementOptConstRef |
optional const reference to RecipientBlockAckAgreement | |
Public Member Functions | |
WifiMac () | |
WifiMac (const WifiMac &)=delete | |
~WifiMac () override | |
virtual int64_t | AssignStreams (int64_t stream) |
Assign a fixed random variable stream number to the random variables used by this model. | |
void | BlockUnicastTxOnLinks (WifiQueueBlockedReason reason, const Mac48Address &address, const std::set< uint8_t > &linkIds) |
Block the transmission on the given links of all unicast frames addressed to the station with the given address for the given reason. | |
virtual bool | CanForwardPacketsTo (Mac48Address to) const =0 |
Return true if packets can be forwarded to the given destination, false otherwise. | |
void | Enqueue (Ptr< Packet > packet, Mac48Address to) |
void | Enqueue (Ptr< Packet > packet, Mac48Address to, Mac48Address from) |
void | Enqueue (Ptr< Packet > packet, Mac48Address to, Mac48Address from, uint8_t tid) |
Mac48Address | GetAddress () const |
OriginatorAgreementOptConstRef | GetBaAgreementEstablishedAsOriginator (Mac48Address recipient, uint8_t tid, std::optional< Mac48Address > gcrGroupAddr=std::nullopt) const |
RecipientAgreementOptConstRef | GetBaAgreementEstablishedAsRecipient (Mac48Address originator, uint8_t tid, std::optional< Mac48Address > gcrGroupAddr=std::nullopt) const |
BlockAckReqType | GetBarTypeAsOriginator (const Mac48Address &recipient, uint8_t tid) const |
BlockAckReqType | GetBarTypeAsRecipient (Mac48Address originator, uint8_t tid) const |
BlockAckType | GetBaTypeAsOriginator (const Mac48Address &recipient, uint8_t tid) const |
BlockAckType | GetBaTypeAsRecipient (Mac48Address originator, uint8_t tid) const |
Mac48Address | GetBssid (uint8_t linkId) const |
Ptr< ChannelAccessManager > | GetChannelAccessManager (uint8_t linkId=SINGLE_LINK_OP_ID) const |
Get the Channel Access Manager associated with the given link. | |
Ptr< WifiNetDevice > | GetDevice () const |
Return the device this PHY is associated with. | |
bool | GetDsssSupported (uint8_t linkId) const |
Return whether the device supports DSSS on the given link. | |
EhtCapabilities | GetEhtCapabilities (uint8_t linkId) const |
Return the EHT capabilities of the device for the given link. | |
Ptr< EhtConfiguration > | GetEhtConfiguration () const |
bool | GetEhtSupported () const |
Return whether the device supports EHT. | |
bool | GetEhtSupported (const Mac48Address &address) const |
bool | GetErpSupported (uint8_t linkId) const |
Return whether the device supports ERP on the given link. | |
ExtendedCapabilities | GetExtendedCapabilities () const |
Return the extended capabilities of the device. | |
Ptr< FrameExchangeManager > | GetFrameExchangeManager (uint8_t linkId=SINGLE_LINK_OP_ID) const |
Get the Frame Exchange Manager associated with the given link. | |
uint32_t | GetFrameRetryLimit () const |
He6GhzBandCapabilities | GetHe6GhzBandCapabilities (uint8_t linkId) const |
Return the HE 6GHz band capabilities of the device for the given 6 GHz link. | |
HeCapabilities | GetHeCapabilities (uint8_t linkId) const |
Return the HE capabilities of the device for the given link. | |
Ptr< HeConfiguration > | GetHeConfiguration () const |
bool | GetHeSupported () const |
Return whether the device supports HE. | |
bool | GetHeSupported (const Mac48Address &address) const |
HtCapabilities | GetHtCapabilities (uint8_t linkId) const |
Return the HT capabilities of the device for the given link. | |
Ptr< HtConfiguration > | GetHtConfiguration () const |
bool | GetHtSupported (const Mac48Address &address) const |
bool | GetHtSupported (uint8_t linkId) const |
Return whether the device supports HT on the given link. | |
std::optional< uint8_t > | GetLinkForPhy (Ptr< const WifiPhy > phy) const |
Get the ID of the link (if any) on which the given PHY is operating. | |
std::optional< uint8_t > | GetLinkForPhy (std::size_t phyId) const |
Get the ID of the link (if any) on which the given PHY is operating. | |
virtual std::optional< uint8_t > | GetLinkIdByAddress (const Mac48Address &address) const |
Get the ID of the link having the given MAC address, if any. | |
const std::set< uint8_t > & | GetLinkIds () const |
Mac48Address | GetLocalAddress (const Mac48Address &remoteAddr) const |
Get the local MAC address used to communicate with a remote STA. | |
Ptr< WifiMacQueueScheduler > | GetMacQueueScheduler () const |
Get the wifi MAC queue scheduler. | |
uint32_t | GetMaxAmpduSize (AcIndex ac) const |
Return the maximum A-MPDU size of the given Access Category. | |
uint16_t | GetMaxAmsduSize (AcIndex ac) const |
Return the maximum A-MSDU size of the given Access Category. | |
uint16_t | GetMaxBaBufferSize (std::optional< Mac48Address > address=std::nullopt) const |
Get the maximum Block Ack buffer size (in number of MPDUs) supported by the given device, if any, or by this device, otherwise, based on the supported standard. | |
std::optional< Mac48Address > | GetMldAddress (const Mac48Address &remoteAddr) const |
uint16_t | GetMpduBufferSize () const |
uint8_t | GetNLinks () const |
Get the number of links (can be greater than 1 for 11be devices only). | |
bool | GetQosSupported () const |
Return whether the device supports QoS. | |
Ptr< QosTxop > | GetQosTxop (AcIndex ac) const |
Accessor for a specified EDCA object. | |
Ptr< QosTxop > | GetQosTxop (uint8_t tid) const |
Accessor for a specified EDCA object. | |
Ssid | GetSsid () const |
std::optional< std::reference_wrapper< const WifiTidLinkMapping > > | GetTidToLinkMapping (Mac48Address mldAddr, WifiDirection dir) const |
Get the TID-to-Link Mapping negotiated with the given MLD (if any) for the given direction. | |
bool | GetTxBlockedOnLink (AcIndex ac, const WifiContainerQueueId &queueId, uint8_t linkId, WifiQueueBlockedReason reason=WifiQueueBlockedReason::REASONS_COUNT) const |
Check whether the transmission of the packets in the given container queue of the given Access Category are blocked on the given link for the given reason (if any). | |
Ptr< Txop > | GetTxop () const |
Accessor for the Txop object. | |
virtual Ptr< WifiMacQueue > | GetTxopQueue (AcIndex ac) const |
Get the wifi MAC queue of the (Qos)Txop associated with the given AC, if such (Qos)Txop is installed, or a null pointer, otherwise. | |
TypeOfStation | GetTypeOfStation () const |
Return the type of station. | |
VhtCapabilities | GetVhtCapabilities (uint8_t linkId) const |
Return the VHT capabilities of the device for the given link. | |
Ptr< VhtConfiguration > | GetVhtConfiguration () const |
bool | GetVhtSupported (const Mac48Address &address) const |
bool | GetVhtSupported (uint8_t linkId) const |
Return whether the device supports VHT on the given link. | |
Ptr< WifiPhy > | GetWifiPhy (uint8_t linkId=SINGLE_LINK_OP_ID) const |
Ptr< WifiRemoteStationManager > | GetWifiRemoteStationManager (uint8_t linkId=0) const |
virtual bool | HasFramesToTransmit (uint8_t linkId) |
Check if the MAC has frames to transmit over the given link. | |
bool | Is6GhzBand (uint8_t linkId) const |
Indicate if a given link is on the 6 GHz band. | |
virtual void | NotifyChannelSwitching (uint8_t linkId) |
Notify that channel on the given link has been switched. | |
void | NotifyPromiscRx (Ptr< const Packet > packet) |
void | NotifyRx (Ptr< const Packet > packet) |
void | NotifyRxDrop (Ptr< const Packet > packet) |
void | NotifyTx (Ptr< const Packet > packet) |
void | NotifyTxDrop (Ptr< const Packet > packet) |
WifiMac & | operator= (const WifiMac &)=delete |
void | ResetWifiPhys () |
Remove currently attached WifiPhy objects from this MAC. | |
virtual void | SetAddress (Mac48Address address) |
void | SetBssid (Mac48Address bssid, uint8_t linkId) |
void | SetChannelAccessManagers (const std::vector< Ptr< ChannelAccessManager > > &caManagers) |
void | SetCtsToSelfSupported (bool enable) |
Enable or disable CTS-to-self feature. | |
void | SetDevice (const Ptr< WifiNetDevice > device) |
Sets the device this PHY is associated with. | |
void | SetForwardUpCallback (ForwardUpCallback upCallback) |
void | SetFrameExchangeManagers (const std::vector< Ptr< FrameExchangeManager > > &feManagers) |
void | SetFrameRetryLimit (uint32_t limit) |
Set the frame retry limit. | |
void | SetLinkDownCallback (Callback< void > linkDown) |
virtual void | SetLinkUpCallback (Callback< void > linkUp) |
virtual void | SetMacQueueScheduler (Ptr< WifiMacQueueScheduler > scheduler) |
Set the wifi MAC queue scheduler. | |
void | SetMpduBufferSize (uint16_t size) |
void | SetPromisc () |
Sets the interface in promiscuous mode. | |
void | SetSsid (Ssid ssid) |
void | SetTypeOfStation (TypeOfStation type) |
This method is invoked by a subclass to specify what type of station it is implementing. | |
virtual void | SetWifiPhys (const std::vector< Ptr< WifiPhy > > &phys) |
void | SetWifiRemoteStationManager (Ptr< WifiRemoteStationManager > stationManager) |
void | SetWifiRemoteStationManagers (const std::vector< Ptr< WifiRemoteStationManager > > &stationManagers) |
virtual bool | SupportsSendFrom () const |
bool | TidMappedOnLink (Mac48Address mldAddr, WifiDirection dir, uint8_t tid, uint8_t linkId) const |
Check whether the given TID is mapped on the given link in the given direction for the given MLD. | |
void | UnblockUnicastTxOnLinks (WifiQueueBlockedReason reason, const Mac48Address &address, const std::set< uint8_t > &linkIds) |
Unblock the transmission on the given links of all unicast frames addressed to the station with the given address for the given reason. | |
Public Member Functions inherited from ns3::Object | |
Object () | |
Constructor. | |
~Object () override | |
Destructor. | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. | |
void | Dispose () |
Dispose of this Object. | |
AggregateIterator | GetAggregateIterator () const |
Get an iterator to the Objects aggregated to this one. | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. | |
template<typename T > | |
Ptr< T > | GetObject () const |
Get a pointer to the requested aggregated Object. | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. | |
void | Initialize () |
Invoke DoInitialize on all Objects aggregated to this one. | |
bool | IsInitialized () const |
Check if the object has been initialized. | |
void | UnidirectionalAggregateObject (Ptr< Object > other) |
Aggregate an Object to another Object. | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount () | |
Default constructor. | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment operator. | |
void | Ref () const |
Increment the reference count. | |
void | Unref () const |
Decrement the reference count. | |
Public Member Functions inherited from ns3::ObjectBase | |
virtual | ~ObjectBase () |
Virtual destructor. | |
void | GetAttribute (std::string name, AttributeValue &value, bool permissive=false) const |
Get the value of an attribute, raising fatal errors if unsuccessful. | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising errors. | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. | |
Static Public Member Functions | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId () |
Register this type. | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId () |
Get the type ID. | |
Protected Member Functions | |
void | ApplyTidLinkMapping (const Mac48Address &mldAddr, WifiDirection dir) |
Apply the TID-to-Link Mapping negotiated with the given MLD for the given direction by properly configuring the queue scheduler. | |
virtual void | ConfigureContentionWindow (uint32_t cwMin, uint32_t cwMax) |
virtual void | DeaggregateAmsduAndForward (Ptr< const WifiMpdu > mpdu) |
This method can be called to de-aggregate an A-MSDU and forward the constituent packets up the stack. | |
void | DoDispose () override |
Destructor implementation. | |
void | DoInitialize () override |
Initialize() implementation. | |
void | ForwardUp (Ptr< const Packet > packet, Mac48Address from, Mac48Address to) |
Forward the packet up to the device. | |
Ptr< QosTxop > | GetBEQueue () const |
Accessor for the AC_BE channel access function. | |
Ptr< QosTxop > | GetBKQueue () const |
Accessor for the AC_BK channel access function. | |
LinkEntity & | GetLink (uint8_t linkId) const |
Get a reference to the link associated with the given ID. | |
const std::map< uint8_t, std::unique_ptr< LinkEntity > > & | GetLinks () const |
bool | GetShortSlotTimeSupported () const |
Ptr< QosTxop > | GetVIQueue () const |
Accessor for the AC_VI channel access function. | |
Ptr< QosTxop > | GetVOQueue () const |
Accessor for the AC_VO channel access function. | |
void | NotifyConstructionCompleted () override |
Notifier called once the ObjectBase is fully constructed. | |
virtual void | Receive (Ptr< const WifiMpdu > mpdu, uint8_t linkId) |
This method acts as the MacRxMiddle receive callback and is invoked to notify us that a frame has been received on the given link. | |
void | SetShortSlotTimeSupported (bool enable) |
Enable or disable short slot time feature. | |
void | SwapLinks (std::map< uint8_t, uint8_t > links) |
Swap the links based on the information included in the given map. | |
void | UpdateTidToLinkMapping (const Mac48Address &mldAddr, WifiDirection dir, const WifiTidLinkMapping &mapping) |
Update the TID-to-Link Mappings for the given MLD in the given direction based on the given negotiated mappings. | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. | |
virtual void | NotifyNewAggregate () |
Notify all Objects aggregated to this one of a new Object being aggregated. | |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. | |
Protected Attributes | |
Callback< void > | m_linkDown |
Callback when a link is down. | |
Callback< void > | m_linkUp |
Callback when a link is up. | |
Ptr< MacRxMiddle > | m_rxMiddle |
RX middle (defragmentation etc.) | |
Ptr< WifiMacQueueScheduler > | m_scheduler |
wifi MAC queue scheduler | |
Ptr< MacTxMiddle > | m_txMiddle |
TX middle (aggregation etc.) | |
Ptr< Txop > | m_txop |
TXOP used for transmission of frames to non-QoS peers. | |
Private Types | |
typedef void(* | DroppedMpduCallback) (WifiMacDropReason reason, Ptr< const WifiMpdu > mpdu) |
TracedCallback signature for MPDU drop events. | |
typedef TracedCallback< WifiMacDropReason, Ptr< const WifiMpdu > > | DroppedMpduTracedCallback |
TracedCallback for MPDU drop events typedef. | |
typedef std::map< AcIndex, Ptr< QosTxop >, std::greater<> > | EdcaQueues |
This type defines a mapping between an Access Category index, and a pointer to the corresponding channel access function. | |
typedef void(* | IcfDropCallback) (WifiIcfDrop reason, uint8_t linkId) |
TracedCallback signature for ICF drop events. | |
using | IcfDropTracedCallback = TracedCallback<WifiIcfDrop, uint8_t> |
TracedCallback for ICF drop events typedef. | |
typedef void(* | MpduResponseTimeoutCallback) (uint8_t reason, Ptr< const WifiMpdu > mpdu, const WifiTxVector &txVector) |
TracedCallback signature for MPDU response timeout events. | |
typedef TracedCallback< uint8_t, Ptr< const WifiMpdu >, const WifiTxVector & > | MpduResponseTimeoutTracedCallback |
TracedCallback for MPDU response timeout events typedef. | |
typedef TracedCallback< Ptr< const WifiMpdu > > | MpduTracedCallback |
TracedCallback for acked/nacked MPDUs typedef. | |
typedef void(* | PsduMapResponseTimeoutCallback) (uint8_t reason, WifiPsduMap *psduMap, const std::set< Mac48Address > *missingStations, std::size_t nTotalStations) |
TracedCallback signature for PSDU map response timeout events. | |
typedef TracedCallback< uint8_t, WifiPsduMap *, const std::set< Mac48Address > *, std::size_t > | PsduMapResponseTimeoutTracedCallback |
TracedCallback for PSDU map response timeout events typedef. | |
typedef void(* | PsduResponseTimeoutCallback) (uint8_t reason, Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) |
TracedCallback signature for PSDU response timeout events. | |
typedef TracedCallback< uint8_t, Ptr< const WifiPsdu >, const WifiTxVector & > | PsduResponseTimeoutTracedCallback |
TracedCallback for PSDU response timeout events typedef. | |
Private Member Functions | |
void | CompleteConfig () |
Complete the configuration of the MAC layer components. | |
void | ConfigureDcf (Ptr< Txop > dcf, uint32_t cwmin, uint32_t cwmax, std::list< bool > isDsss, AcIndex ac) |
void | ConfigurePhyDependentParameters (uint8_t linkId) |
Configure PHY dependent parameters such as CWmin and CWmax on the given link. | |
virtual std::unique_ptr< LinkEntity > | CreateLinkEntity () const |
Create a LinkEntity object. | |
bool | CreateLinksIfNeeded (std::size_t nLinks) |
If no link has been already created, create the given number links; otherwise, do nothing. | |
virtual void | DoCompleteConfig ()=0 |
Allow subclasses to complete the configuration of the MAC layer components. | |
virtual Mac48Address | DoGetLocalAddress (const Mac48Address &remoteAddr) const |
This method is called if this device is an MLD to determine the MAC address of the affiliated STA used to communicate with the single link device having the given MAC address. | |
virtual void | Enqueue (Ptr< WifiMpdu > mpdu, Mac48Address to, Mac48Address from)=0 |
virtual void | NotifyDropPacketToEnqueue (Ptr< Packet > packet, Mac48Address to) |
Allow subclasses to take actions when a packet to enqueue has been dropped. | |
void | NotifyRsmOfExpiredMpdu (Ptr< const WifiMpdu > mpdu) |
Notify the remote station manager if the given expired (hence dropped) MPDU is a management or data frame (with a unicast receiver address) that has been already transmitted and is not in flight (otherwise, it is handled when the ack is received or the TX timeout expires). | |
void | SetBeBlockAckInactivityTimeout (uint16_t timeout) |
Set BE block ack inactivity timeout. | |
void | SetBeBlockAckThreshold (uint8_t threshold) |
Set the block ack threshold for AC_BE. | |
void | SetBeQueue (Ptr< QosTxop > edca) |
Set the AC_BE channel access function This method is private so that it is only used while constructing this object. | |
void | SetBkBlockAckInactivityTimeout (uint16_t timeout) |
Set BK block ack inactivity timeout. | |
void | SetBkBlockAckThreshold (uint8_t threshold) |
Set the block ack threshold for AC_BK. | |
void | SetBkQueue (Ptr< QosTxop > edca) |
Set the AC_BK channel access function This method is private so that it is only used while constructing this object. | |
void | SetDsssSupported (bool enable, uint8_t linkId) |
Enable or disable DSSS support for the given link. | |
void | SetErpSupported (bool enable, uint8_t linkId) |
Enable or disable ERP support for the given link. | |
void | SetQosSupported (bool enable) |
Enable or disable QoS support for the device. | |
void | SetTxop (Ptr< Txop > dcf) |
Set the Txop object. | |
void | SetupDcfQueue () |
This method is a private utility invoked to configure the channel access function for devices that do not support QoS. | |
void | SetupEdcaQueue (AcIndex ac) |
This method is a private utility invoked to configure the channel access function for the specified Access Category. | |
void | SetViBlockAckInactivityTimeout (uint16_t timeout) |
Set VI block ack inactivity timeout. | |
void | SetViBlockAckThreshold (uint8_t threshold) |
Set the block ack threshold for AC_VI. | |
void | SetViQueue (Ptr< QosTxop > edca) |
Set the AC_VI channel access function This method is private so that it is only used while constructing this object. | |
void | SetVoBlockAckInactivityTimeout (uint16_t timeout) |
Set VO block ack inactivity timeout. | |
void | SetVoBlockAckThreshold (uint8_t threshold) |
Set the block ack threshold for AC_VO. | |
void | SetVoQueue (Ptr< QosTxop > edca) |
Set the AC_VO channel access function This method is private so that it is only used while constructing this object. | |
void | UpdateLinkId (uint8_t id) |
This method is intended to be called when a link changes ID in order to update the link ID stored by the Frame Exchange Manager and the Channel Access Manager operating on that link. | |
Private Attributes | |
MpduTracedCallback | m_ackedMpduCallback |
ack'ed MPDU callback | |
Mac48Address | m_address |
MAC address of this station. | |
uint32_t | m_beMaxAmpduSize |
maximum A-MPDU size for AC_BE (in bytes) | |
uint16_t | m_beMaxAmsduSize |
maximum A-MSDU size for AC_BE (in bytes) | |
uint32_t | m_bkMaxAmpduSize |
maximum A-MPDU size for AC_BK (in bytes) | |
uint16_t | m_bkMaxAmsduSize |
maximum A-MSDU size for AC_BK (in bytes) | |
bool | m_ctsToSelfSupported |
flag indicating whether CTS-To-Self is supported | |
Ptr< WifiNetDevice > | m_device |
Pointer to the device. | |
std::unordered_map< Mac48Address, WifiTidLinkMapping, WifiAddressHash > | m_dlTidLinkMappings |
DL TID-to-Link Mapping negotiated with an MLD (identified by its MLD address) | |
DroppedMpduTracedCallback | m_droppedMpduCallback |
This trace indicates that an MPDU was dropped for the given reason. | |
EdcaQueues | m_edca |
This is a map from Access Category index to the corresponding channel access function. | |
ForwardUpCallback | m_forwardUp |
Callback to forward packet up the stack. | |
uint32_t | m_frameRetryLimit |
the frame retry limit | |
IcfDropTracedCallback | m_icfDropCallback |
traced callback for ICF drop events | |
std::set< uint8_t > | m_linkIds |
IDs of the links in use. | |
std::map< uint8_t, std::unique_ptr< LinkEntity > > | m_links |
ID-indexed map of Link objects. | |
TracedCallback< Ptr< const Packet > > | m_macPromiscRxTrace |
The trace source fired for packets successfully received by the device immediately before being forwarded up to higher layers (at the L2/L3 transition). | |
TracedCallback< Ptr< const Packet > > | m_macRxDropTrace |
The trace source fired when packets coming into the "top" of the device are dropped at the MAC layer during reception. | |
TracedCallback< Ptr< const Packet > > | m_macRxTrace |
The trace source fired for packets successfully received by the device immediately before being forwarded up to higher layers (at the L2/L3 transition). | |
TracedCallback< Ptr< const Packet > > | m_macTxDropTrace |
The trace source fired when packets coming into the "top" of the device are dropped at the MAC layer before being queued for transmission. | |
TracedCallback< Ptr< const Packet > > | m_macTxTrace |
The trace source fired when packets come into the "top" of the device at the L3/L2 transition, before being queued for transmission. | |
uint16_t | m_mpduBufferSize |
BlockAck buffer size (in number of MPDUs) | |
MpduResponseTimeoutTracedCallback | m_mpduResponseTimeoutCallback |
MPDU response timeout traced callback. | |
MpduTracedCallback | m_nackedMpduCallback |
nack'ed MPDU callback | |
PsduMapResponseTimeoutTracedCallback | m_psduMapResponseTimeoutCallback |
PSDU map response timeout traced callback. | |
PsduResponseTimeoutTracedCallback | m_psduResponseTimeoutCallback |
PSDU response timeout traced callback. | |
bool | m_qosSupported |
This Boolean is set true iff this WifiMac is to model 802.11e/WMM style Quality of Service. | |
bool | m_shortSlotTimeSupported |
flag whether short slot time is supported | |
UniformRandomBitGenerator | m_shuffleLinkIdsGen |
random number generator to shuffle link IDs | |
Ssid | m_ssid |
Service Set ID (SSID) | |
TypeOfStation | m_typeOfStation |
the type of station | |
std::unordered_map< Mac48Address, WifiTidLinkMapping, WifiAddressHash > | m_ulTidLinkMappings |
UL TID-to-Link Mapping negotiated with an MLD (identified by its MLD address) | |
uint32_t | m_viMaxAmpduSize |
maximum A-MPDU size for AC_VI (in bytes) | |
uint16_t | m_viMaxAmsduSize |
maximum A-MSDU size for AC_VI (in bytes) | |
uint32_t | m_voMaxAmpduSize |
maximum A-MPDU size for AC_VO (in bytes) | |
uint16_t | m_voMaxAmsduSize |
maximum A-MSDU size for AC_VO (in bytes) | |
Additional Inherited Members | |
Related Symbols inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
base class for all MAC-level wifi objects.
This class encapsulates all the low-level MAC functionality DCA, EDCA, etc) and all the high-level MAC functionality (association/disassociation state machines).
ns3::WifiMac is accessible through the following paths with Config::Set and Config::Connect:
Ssid
Group: Wifi
Size of this type is 768 bytes (on a 64-bit architecture).
Definition at line 89 of file wifi-mac.h.
|
private |
TracedCallback signature for MPDU drop events.
reason | the reason why the MPDU was dropped ( |
mpdu | the dropped MPDU |
Definition at line 1287 of file wifi-mac.h.
|
private |
TracedCallback for MPDU drop events typedef.
Definition at line 1290 of file wifi-mac.h.
|
private |
This type defines a mapping between an Access Category index, and a pointer to the corresponding channel access function.
Access Categories are sorted in decreasing order of priority.
Definition at line 1215 of file wifi-mac.h.
typedef Callback<void, Ptr<const Packet>, Mac48Address, Mac48Address> ns3::WifiMac::ForwardUpCallback |
This type defines the callback of a higher layer that a WifiMac(-derived) object invokes to pass a packet up the stack.
packet | the packet that has been received. |
from | the MAC address of the device that sent the packet. |
to | the MAC address of the device that the packet is destined for. |
Definition at line 464 of file wifi-mac.h.
|
private |
TracedCallback signature for ICF drop events.
reason | the reason why the ICF was dropped by the EMLSR client |
linkId | the ID of the link on which the ICF was dropped |
Definition at line 1374 of file wifi-mac.h.
|
private |
TracedCallback for ICF drop events typedef.
Definition at line 1377 of file wifi-mac.h.
|
private |
TracedCallback signature for MPDU response timeout events.
reason | the reason why the timer was started |
mpdu | the MPDU whose response was not received before the timeout |
txVector | the TXVECTOR used to transmit the MPDU |
Definition at line 1310 of file wifi-mac.h.
|
private |
TracedCallback for MPDU response timeout events typedef.
Definition at line 1316 of file wifi-mac.h.
|
private |
TracedCallback for acked/nacked MPDUs typedef.
Definition at line 1298 of file wifi-mac.h.
optional const reference to OriginatorBlockAckAgreement
Definition at line 668 of file wifi-mac.h.
|
private |
TracedCallback signature for PSDU map response timeout events.
reason | the reason why the timer was started |
psduMap | the PSDU map for which not all responses were received before the timeout |
missingStations | the MAC addresses of the stations that did not respond |
nTotalStations | the total number of stations that had to respond |
Definition at line 1353 of file wifi-mac.h.
|
private |
TracedCallback for PSDU map response timeout events typedef.
Definition at line 1360 of file wifi-mac.h.
|
private |
TracedCallback signature for PSDU response timeout events.
reason | the reason why the timer was started |
psdu | the PSDU whose response was not received before the timeout |
txVector | the TXVECTOR used to transmit the PSDU |
Definition at line 1331 of file wifi-mac.h.
|
private |
TracedCallback for PSDU response timeout events typedef.
Definition at line 1337 of file wifi-mac.h.
optional const reference to RecipientBlockAckAgreement
Definition at line 671 of file wifi-mac.h.
ns3::WifiMac::WifiMac | ( | ) |
Definition at line 46 of file wifi-mac.cc.
References ns3::Create(), m_rxMiddle, m_txMiddle, ns3::MakeCallback(), NS_LOG_FUNCTION, and Receive().
|
override |
Definition at line 57 of file wifi-mac.cc.
References NS_LOG_FUNCTION.
|
delete |
|
protected |
Apply the TID-to-Link Mapping negotiated with the given MLD for the given direction by properly configuring the queue scheduler.
mldAddr | the MLD MAC address of the given MLD |
dir | the given direction (DL or UL) |
Definition at line 1485 of file wifi-mac.cc.
References ns3::BOTH_DIRECTIONS, dir, ns3::DOWNLINK, GetAddress(), m_dlTidLinkMappings, m_links, m_scheduler, m_ulTidLinkMappings, NS_ABORT_MSG_IF, NS_LOG_FUNCTION, ns3::QosUtilsMapTidToAc(), ns3::TID_NOT_MAPPED, and ns3::WIFI_QOSDATA_QUEUE.
Referenced by ns3::StaWifiMac::ReceiveAssocResp(), and ns3::ApWifiMac::TxOk().
|
virtual |
Assign a fixed random variable stream number to the random variables used by this model.
Return the number of streams (possibly zero) that have been assigned.
stream | first stream index to use |
Reimplemented in ns3::ApWifiMac, ns3::MeshWifiInterfaceMac, and ns3::StaWifiMac.
Definition at line 382 of file wifi-mac.cc.
References GetNLinks(), ns3::UniformRandomBitGenerator::GetRv(), m_shuffleLinkIdsGen, and NS_LOG_FUNCTION.
Referenced by ns3::ApWifiMac::AssignStreams(), ns3::MeshWifiInterfaceMac::AssignStreams(), and ns3::StaWifiMac::AssignStreams().
void ns3::WifiMac::BlockUnicastTxOnLinks | ( | WifiQueueBlockedReason | reason, |
const Mac48Address & | address, | ||
const std::set< uint8_t > & | linkIds ) |
Block the transmission on the given links of all unicast frames addressed to the station with the given address for the given reason.
The given MAC address must be the MLD address in case the addressed device is multi-link.
reason | the reason for blocking transmissions |
address | the MAC address of the given device |
linkIds | the IDs of the links to block |
Definition at line 1567 of file wifi-mac.cc.
References GetAddress(), GetLink(), ns3::LOG_FUNCTION, m_scheduler, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::WIFI_CTL_QUEUE, ns3::WIFI_MGT_QUEUE, ns3::WIFI_QOSDATA_QUEUE, and ns3::wifiAcList.
Referenced by ns3::StaWifiMac::BlockTxOnLink(), and ns3::ApWifiMac::StaSwitchingToPsMode().
|
pure virtual |
Return true if packets can be forwarded to the given destination, false otherwise.
to | the address to which the packet should be sent |
Implemented in MldSwapLinksTest::TestWifiMac, ns3::AdhocWifiMac, ns3::ApWifiMac, ns3::MeshWifiInterfaceMac, and ns3::StaWifiMac.
Referenced by Enqueue().
|
private |
Complete the configuration of the MAC layer components.
Definition at line 880 of file wifi-mac.cc.
References m_links, NS_ABORT_MSG_IF, NS_ASSERT_MSG, and NS_LOG_FUNCTION.
Referenced by SetChannelAccessManagers(), SetFrameExchangeManagers(), SetWifiPhys(), and SetWifiRemoteStationManagers().
cwMin | the minimum contention window size |
cwMax | the maximum contention window size |
This method is called to set the minimum and the maximum contention window size.
Reimplemented in ns3::MeshWifiInterfaceMac.
Definition at line 768 of file wifi-mac.cc.
References ns3::AC_BE_NQOS, ConfigureDcf(), m_edca, m_links, and m_txop.
Referenced by ns3::MeshWifiInterfaceMac::ConfigureContentionWindow().
|
private |
dcf | the DCF to be configured |
cwmin | the minimum contention window for the DCF |
cwmax | the maximum contention window for the DCF |
isDsss | vector of flags to indicate whether PHY is DSSS or HR/DSSS for every link |
ac | the access category for the DCF |
Configure the DCF with appropriate values depending on the given access category.
Definition at line 791 of file wifi-mac.cc.
References ns3::AC_BE, ns3::AC_BE_NQOS, ns3::AC_BEACON, ns3::AC_BK, ns3::AC_UNDEF, ns3::AC_VI, ns3::AC_VO, m_links, ns3::MicroSeconds(), NS_FATAL_ERROR, and NS_LOG_FUNCTION.
Referenced by ConfigureContentionWindow().
|
private |
Configure PHY dependent parameters such as CWmin and CWmax on the given link.
linkId | the ID of the given link |
Definition at line 931 of file wifi-mac.cc.
Referenced by NotifyChannelSwitching().
|
privatevirtual |
Create a LinkEntity object.
Reimplemented in ns3::ApWifiMac, and ns3::StaWifiMac.
Definition at line 1078 of file wifi-mac.cc.
Referenced by CreateLinksIfNeeded().
|
private |
If no link has been already created, create the given number links; otherwise, do nothing.
nLinks | the given number of links |
Definition at line 949 of file wifi-mac.cc.
References CreateLinkEntity(), m_linkIds, and m_links.
Referenced by SetChannelAccessManagers(), SetFrameExchangeManagers(), SetWifiPhys(), and SetWifiRemoteStationManagers().
This method can be called to de-aggregate an A-MSDU and forward the constituent packets up the stack.
mpdu | the MPDU containing the A-MSDU. |
Reimplemented in ns3::ApWifiMac.
Definition at line 1839 of file wifi-mac.cc.
References ForwardUp(), NS_LOG_FUNCTION, and ns3::PeekPointer().
Referenced by ns3::AdhocWifiMac::Receive(), and ns3::StaWifiMac::Receive().
|
privatepure virtual |
Allow subclasses to complete the configuration of the MAC layer components.
Implemented in MldSwapLinksTest::TestWifiMac, ns3::AdhocWifiMac, ns3::ApWifiMac, ns3::MeshWifiInterfaceMac, and ns3::StaWifiMac.
|
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 435 of file wifi-mac.cc.
References ns3::Object::Dispose(), m_device, m_edca, m_links, m_rxMiddle, m_scheduler, m_txMiddle, m_txop, and NS_LOG_FUNCTION.
Referenced by ns3::ApWifiMac::DoDispose(), ns3::MeshWifiInterfaceMac::DoDispose(), and ns3::StaWifiMac::DoDispose().
|
privatevirtual |
This method is called if this device is an MLD to determine the MAC address of the affiliated STA used to communicate with the single link device having the given MAC address.
This method is overridden because its implementation depends on the type of station.
remoteAddr | the MAC address of the remote single link device |
Reimplemented in ns3::ApWifiMac, and ns3::StaWifiMac.
Definition at line 1892 of file wifi-mac.cc.
References m_address.
Referenced by GetLocalAddress(), and NotifyRsmOfExpiredMpdu().
|
overrideprotectedvirtual |
Initialize() implementation.
This method is called only once by Initialize(). If the user calls Initialize() multiple times, DoInitialize() is called only the first time.
Subclasses are expected to override this method and chain up to their parent's implementation once they are done. It is safe to call GetObject() and AggregateObject() from within this method.
Reimplemented from ns3::Object.
Definition at line 411 of file wifi-mac.cc.
References ns3::Object::Initialize(), m_edca, m_links, m_txop, and NS_LOG_FUNCTION.
Referenced by ns3::ApWifiMac::DoInitialize(), and ns3::StaWifiMac::DoInitialize().
void ns3::WifiMac::Enqueue | ( | Ptr< Packet > | packet, |
Mac48Address | to ) |
packet | the packet to send. |
to | the address to which the packet should be sent. |
The packet should be enqueued in a TX queue, and should be dequeued as soon as the DCF/EDCA function determines that access is granted to this MAC.
Definition at line 1726 of file wifi-mac.cc.
References Enqueue(), GetAddress(), and NS_LOG_FUNCTION.
Referenced by ns3::ApWifiMac::DeaggregateAmsduAndForward(), Enqueue(), Enqueue(), Enqueue(), and ns3::ApWifiMac::Receive().
void ns3::WifiMac::Enqueue | ( | Ptr< Packet > | packet, |
Mac48Address | to, | ||
Mac48Address | from ) |
packet | the packet to send. |
to | the address to which the packet should be sent. |
from | the address from which the packet should be sent. |
The packet should be enqueued in a TX queue, and should be dequeued as soon as the DCF/EDCA function determines that access is granted to this MAC. The extra parameter "from" allows this device to operate in a bridged mode, forwarding received frames without altering the source address.
Definition at line 1736 of file wifi-mac.cc.
References Enqueue(), ns3::SocketPriorityTag::GetPriority(), and NS_LOG_FUNCTION.
void ns3::WifiMac::Enqueue | ( | Ptr< Packet > | packet, |
Mac48Address | to, | ||
Mac48Address | from, | ||
uint8_t | tid ) |
packet | the packet to send. |
to | the address to which the packet should be sent. |
from | the address from which the packet should be sent. |
tid | the TID to use to send this packet |
The packet should be enqueued in a TX queue, and should be dequeued as soon as the DCF/EDCA function determines that access is granted to this MAC. The extra parameter "tid" allows to specify the TID to use in case QoS is supported.
Definition at line 1755 of file wifi-mac.cc.
References CanForwardPacketsTo(), ns3::Create(), Enqueue(), GetAddress(), GetQosSupported(), ns3::WifiMacHeader::NORMAL_ACK, NotifyDropPacketToEnqueue(), NotifyTxDrop(), NS_ABORT_MSG_IF, NS_LOG_FUNCTION, ns3::WifiMacHeader::SetNoOrder(), ns3::WifiMacHeader::SetQosAckPolicy(), ns3::WifiMacHeader::SetQosNoAmsdu(), ns3::WifiMacHeader::SetQosNoEosp(), ns3::WifiMacHeader::SetQosTid(), ns3::WifiMacHeader::SetType(), SupportsSendFrom(), ns3::WIFI_MAC_DATA, and ns3::WIFI_MAC_QOSDATA.
|
privatepure virtual |
mpdu | the MPDU to send. |
to | the address to which the packet should be sent. |
from | the address from which the packet should be sent. |
Subclasses need to implement this method to finalize the MAC header of the MPDU (MAC addresses and ToDS/FromDS flags) and enqueue the MPDU in a TX queue.
Implemented in MldSwapLinksTest::TestWifiMac, ns3::AdhocWifiMac, ns3::ApWifiMac, ns3::MeshWifiInterfaceMac, and ns3::StaWifiMac.
|
protected |
Forward the packet up to the device.
packet | the packet that we are forwarding up to the device |
from | the address of the source |
to | the address of the destination |
Definition at line 1802 of file wifi-mac.cc.
References m_forwardUp, and NS_LOG_FUNCTION.
Referenced by ns3::ApWifiMac::DeaggregateAmsduAndForward(), DeaggregateAmsduAndForward(), ns3::AdhocWifiMac::Receive(), ns3::ApWifiMac::Receive(), ns3::MeshWifiInterfaceMac::Receive(), and ns3::StaWifiMac::Receive().
Mac48Address ns3::WifiMac::GetAddress | ( | ) | const |
Definition at line 514 of file wifi-mac.cc.
References m_address.
Referenced by ApplyTidLinkMapping(), BlockUnicastTxOnLinks(), ns3::StaWifiMac::DoGetLocalAddress(), ns3::ApWifiMac::DoInitialize(), ns3::AdhocWifiMac::Enqueue(), ns3::ApWifiMac::Enqueue(), ns3::MeshWifiInterfaceMac::Enqueue(), ns3::StaWifiMac::Enqueue(), Enqueue(), Enqueue(), ns3::StaWifiMac::EnqueueProbeRequest(), ns3::StaWifiMac::GetBasicMultiLinkElement(), ns3::ApWifiMac::GetMultiLinkElement(), ns3::ApWifiMac::Receive(), ns3::MeshWifiInterfaceMac::Receive(), ns3::StaWifiMac::Receive(), Receive(), ns3::MeshWifiInterfaceMac::Report(), ns3::MeshWifiInterfaceMac::SendBeacon(), ns3::StaWifiMac::SetPowerSaveMode(), ns3::ApWifiMac::TxFailed(), ns3::ApWifiMac::TxOk(), and UnblockUnicastTxOnLinks().
WifiMac::OriginatorAgreementOptConstRef ns3::WifiMac::GetBaAgreementEstablishedAsOriginator | ( | Mac48Address | recipient, |
uint8_t | tid, | ||
std::optional< Mac48Address > | gcrGroupAddr = std::nullopt ) const |
recipient | (link or device) MAC address of the recipient |
tid | traffic ID |
gcrGroupAddr | the GCR Group Address (only if it is a GCR Block Ack agreement) |
Checks if an originator block ack agreement is established with station addressed by recipient for TID tid.
Definition at line 1898 of file wifi-mac.cc.
References ns3::QosTxop::GetBaManager(), GetMldAddress(), and GetQosTxop().
Referenced by GetBarTypeAsOriginator(), and GetBaTypeAsOriginator().
WifiMac::RecipientAgreementOptConstRef ns3::WifiMac::GetBaAgreementEstablishedAsRecipient | ( | Mac48Address | originator, |
uint8_t | tid, | ||
std::optional< Mac48Address > | gcrGroupAddr = std::nullopt ) const |
originator | (link or device) MAC address of the originator |
tid | traffic ID |
gcrGroupAddr | the GCR Group Address (only if it is a GCR Block Ack agreement) |
Checks if a recipient block ack agreement is established with station addressed by originator for TID tid.
Definition at line 1915 of file wifi-mac.cc.
References ns3::QosTxop::GetBaManager(), GetMldAddress(), and GetQosTxop().
Referenced by GetBarTypeAsRecipient(), and GetBaTypeAsRecipient().
BlockAckReqType ns3::WifiMac::GetBarTypeAsOriginator | ( | const Mac48Address & | recipient, |
uint8_t | tid ) const |
recipient | MAC address of recipient |
tid | traffic ID |
This function returns the type of Block Ack Requests sent to the recipient.
Definition at line 1934 of file wifi-mac.cc.
References GetBaAgreementEstablishedAsOriginator(), and NS_ABORT_MSG_IF.
BlockAckReqType ns3::WifiMac::GetBarTypeAsRecipient | ( | Mac48Address | originator, |
uint8_t | tid ) const |
originator | MAC address of originator |
tid | traffic ID |
This function returns the type of Block Ack Requests sent by the originator.
Definition at line 1952 of file wifi-mac.cc.
References GetBaAgreementEstablishedAsRecipient(), and NS_ABORT_MSG_IF.
BlockAckType ns3::WifiMac::GetBaTypeAsOriginator | ( | const Mac48Address & | recipient, |
uint8_t | tid ) const |
recipient | MAC address |
tid | traffic ID |
This function returns the type of Block Acks sent by the recipient.
Definition at line 1925 of file wifi-mac.cc.
References GetBaAgreementEstablishedAsOriginator(), and NS_ABORT_MSG_IF.
BlockAckType ns3::WifiMac::GetBaTypeAsRecipient | ( | Mac48Address | originator, |
uint8_t | tid ) const |
originator | MAC address of originator |
tid | traffic ID |
This function returns the type of Block Acks sent to the originator.
Definition at line 1943 of file wifi-mac.cc.
References GetBaAgreementEstablishedAsRecipient(), and NS_ABORT_MSG_IF.
Accessor for the AC_BE channel access function.
Definition at line 645 of file wifi-mac.cc.
References ns3::AC_BE, GetQosTxop(), and m_qosSupported.
Referenced by ns3::ApWifiMac::EnqueueProbeResp(), GetTypeId(), ns3::StaWifiMac::SendAssociationRequest(), ns3::ApWifiMac::SendAssocResp(), SetBeBlockAckInactivityTimeout(), and SetBeBlockAckThreshold().
Accessor for the AC_BK channel access function.
Definition at line 651 of file wifi-mac.cc.
References ns3::AC_BK, GetQosTxop(), and m_qosSupported.
Referenced by GetTypeId(), SetBkBlockAckInactivityTimeout(), and SetBkBlockAckThreshold().
Mac48Address ns3::WifiMac::GetBssid | ( | uint8_t | linkId | ) | const |
linkId | the ID of the given link |
Definition at line 540 of file wifi-mac.cc.
References ns3::WifiMac::LinkEntity::feManager, and GetLink().
Referenced by ns3::StaWifiMac::BlockTxOnLink(), ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::StaWifiMac::Receive(), ns3::StaWifiMac::SetPowerSaveMode(), and ns3::StaWifiMac::UnblockTxOnLink().
Ptr< ChannelAccessManager > ns3::WifiMac::GetChannelAccessManager | ( | uint8_t | linkId = SINGLE_LINK_OP_ID | ) | const |
Get the Channel Access Manager associated with the given link.
linkId | the ID of the given link |
Definition at line 1035 of file wifi-mac.cc.
References ns3::WifiMac::LinkEntity::channelAccessManager, and GetLink().
Referenced by GetTypeId().
Ptr< WifiNetDevice > ns3::WifiMac::GetDevice | ( | ) | const |
Return the device this PHY is associated with.
Definition at line 501 of file wifi-mac.cc.
References m_device.
Referenced by ns3::MeshWifiInterfaceMac::CheckSupportedRates(), GetEhtConfiguration(), GetEhtSupported(), GetHeConfiguration(), GetHeSupported(), GetHtConfiguration(), GetHtSupported(), ns3::MeshWifiInterfaceMac::GetSupportedRates(), GetVhtConfiguration(), GetVhtSupported(), ns3::MeshWifiInterfaceMac::Receive(), ns3::StaWifiMac::Receive(), and Receive().
bool ns3::WifiMac::GetDsssSupported | ( | uint8_t | linkId | ) | const |
Return whether the device supports DSSS on the given link.
linkId | the ID of the given link |
Definition at line 1432 of file wifi-mac.cc.
References ns3::WifiMac::LinkEntity::dsssSupported, and GetLink().
Referenced by ns3::ApWifiMac::GetDsssParameterSet(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::ApWifiMac::Receive(), and ns3::ApWifiMac::SendOneBeacon().
EhtCapabilities ns3::WifiMac::GetEhtCapabilities | ( | uint8_t | linkId | ) | const |
Return the EHT capabilities of the device for the given link.
linkId | the ID of the given link |
Definition at line 2424 of file wifi-mac.cc.
References ns3::EhtMcsAndNssSet::EHT_MCS_MAP_TYPE_160_MHZ, ns3::EhtMcsAndNssSet::EHT_MCS_MAP_TYPE_20_MHZ_ONLY, ns3::EhtMcsAndNssSet::EHT_MCS_MAP_TYPE_NOT_LARGER_THAN_80_MHZ, GetEhtSupported(), GetHtConfiguration(), GetLink(), GetVhtConfiguration(), m_beMaxAmpduSize, m_beMaxAmsduSize, m_bkMaxAmpduSize, m_bkMaxAmsduSize, ns3::EhtCapabilities::m_phyCapabilities, m_viMaxAmpduSize, m_viMaxAmsduSize, m_voMaxAmpduSize, m_voMaxAmsduSize, NS_ASSERT, ns3::WifiMac::LinkEntity::phy, ns3::EhtCapabilities::SetMaxAmpduLength(), ns3::EhtCapabilities::SetMaxMpduLength(), ns3::EhtCapabilities::SetSupportedRxEhtMcsAndNss(), ns3::EhtCapabilities::SetSupportedTxEhtMcsAndNss(), ns3::EhtPhyCapabilities::supportRx1024And4096QamForRuSmallerThan242Tones, ns3::EhtPhyCapabilities::supportTx1024And4096QamForRuSmallerThan242Tones, ns3::WIFI_MOD_CLASS_EHT, and ns3::WIFI_PHY_BAND_2_4GHZ.
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::AdhocWifiMac::Receive(), and ns3::ApWifiMac::SendOneBeacon().
Ptr< EhtConfiguration > ns3::WifiMac::GetEhtConfiguration | ( | ) | const |
Definition at line 1979 of file wifi-mac.cc.
References GetDevice().
Referenced by ns3::StaWifiMac::GetBasicMultiLinkElement(), GetEhtSupported(), ns3::ApWifiMac::GetMultiLinkElement(), ns3::StaWifiMac::GetTidToLinkMappingElements(), ns3::ApWifiMac::ReceiveAssocRequest(), and ns3::ApWifiMac::ReceiveEmlOmn().
bool ns3::WifiMac::GetEhtSupported | ( | ) | const |
Return whether the device supports EHT.
Definition at line 2006 of file wifi-mac.cc.
References GetDevice(), and GetEhtConfiguration().
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), GetEhtCapabilities(), ns3::ApWifiMac::GetEhtOperation(), GetMaxBaBufferSize(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::ApWifiMac::GetReducedNeighborReport(), ns3::AdhocWifiMac::Receive(), ns3::ApWifiMac::ReceiveAssocRequest(), ns3::ApWifiMac::SendOneBeacon(), and ns3::StaWifiMac::UpdateApInfo().
bool ns3::WifiMac::GetEhtSupported | ( | const Mac48Address & | address | ) | const |
address | the (link or MLD) address of a remote station |
Definition at line 2051 of file wifi-mac.cc.
References m_links.
bool ns3::WifiMac::GetErpSupported | ( | uint8_t | linkId | ) | const |
Return whether the device supports ERP on the given link.
linkId | the ID of the given link |
Definition at line 1408 of file wifi-mac.cc.
References ns3::WifiMac::LinkEntity::erpSupported, and GetLink().
Referenced by ns3::StaWifiMac::GetCapabilities(), ns3::ApWifiMac::GetErpInformation(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::ApWifiMac::ReceiveAssocRequest(), ns3::ApWifiMac::SendOneBeacon(), ns3::StaWifiMac::UpdateApInfo(), ns3::ApWifiMac::UpdateShortPreambleEnabled(), and ns3::ApWifiMac::UpdateShortSlotTimeEnabled().
ExtendedCapabilities ns3::WifiMac::GetExtendedCapabilities | ( | ) | const |
Return the extended capabilities of the device.
Definition at line 2187 of file wifi-mac.cc.
Referenced by ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), and ns3::ApWifiMac::SendOneBeacon().
Ptr< FrameExchangeManager > ns3::WifiMac::GetFrameExchangeManager | ( | uint8_t | linkId = SINGLE_LINK_OP_ID | ) | const |
Get the Frame Exchange Manager associated with the given link.
linkId | the ID of the given link |
Definition at line 1007 of file wifi-mac.cc.
References ns3::WifiMac::LinkEntity::feManager, and GetLink().
Referenced by ns3::StaWifiMac::BlockTxOnLink(), ns3::ApWifiMac::DoGetLocalAddress(), ns3::ApWifiMac::Enqueue(), ns3::StaWifiMac::Enqueue(), ns3::StaWifiMac::EnqueueProbeRequest(), ns3::ApWifiMac::GetMultiLinkElement(), GetTypeId(), ns3::ApWifiMac::Receive(), ns3::StaWifiMac::Receive(), Receive(), ns3::ApWifiMac::SendAssocResp(), ns3::StaWifiMac::SetPowerSaveMode(), ns3::ApWifiMac::TxFailed(), ns3::ApWifiMac::TxOk(), and ns3::StaWifiMac::UnblockTxOnLink().
uint32_t ns3::WifiMac::GetFrameRetryLimit | ( | ) | const |
Definition at line 2101 of file wifi-mac.cc.
References m_frameRetryLimit.
Referenced by GetTypeId().
He6GhzBandCapabilities ns3::WifiMac::GetHe6GhzBandCapabilities | ( | uint8_t | linkId | ) | const |
Return the HE 6GHz band capabilities of the device for the given 6 GHz link.
linkId | the ID of the given 6 GHz link |
Definition at line 2389 of file wifi-mac.cc.
References GetLink(), m_beMaxAmpduSize, m_beMaxAmsduSize, m_bkMaxAmpduSize, m_bkMaxAmsduSize, m_viMaxAmpduSize, m_viMaxAmsduSize, m_voMaxAmpduSize, m_voMaxAmsduSize, NS_ASSERT_MSG, ns3::WifiMac::LinkEntity::phy, ns3::He6GhzBandCapabilities::SetMaxAmpduLength(), ns3::He6GhzBandCapabilities::SetMaxMpduLength(), and ns3::WIFI_PHY_BAND_6GHZ.
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), and ns3::ApWifiMac::SendOneBeacon().
HeCapabilities ns3::WifiMac::GetHeCapabilities | ( | uint8_t | linkId | ) | const |
Return the HE capabilities of the device for the given link.
linkId | the ID of the given link |
Definition at line 2333 of file wifi-mac.cc.
References GetHeConfiguration(), GetHeSupported(), GetHtConfiguration(), GetLink(), GetVhtConfiguration(), m_beMaxAmpduSize, m_bkMaxAmpduSize, m_viMaxAmpduSize, m_voMaxAmpduSize, NS_ASSERT, ns3::WifiMac::LinkEntity::phy, ns3::HeCapabilities::SetChannelWidthSet(), ns3::HeCapabilities::SetHePpdu4xHeLtf800nsGi(), ns3::HeCapabilities::SetHeSuPpdu1xHeLtf800nsGi(), ns3::HeCapabilities::SetHighestMcsSupported(), ns3::HeCapabilities::SetHighestNssSupported(), ns3::HeCapabilities::SetLdpcCodingInPayload(), ns3::HeCapabilities::SetMaxAmpduLength(), ns3::WIFI_MOD_CLASS_HE, ns3::WIFI_PHY_BAND_2_4GHZ, ns3::WIFI_PHY_BAND_5GHZ, and ns3::WIFI_PHY_BAND_6GHZ.
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::AdhocWifiMac::Receive(), and ns3::ApWifiMac::SendOneBeacon().
Ptr< HeConfiguration > ns3::WifiMac::GetHeConfiguration | ( | ) | const |
Definition at line 1973 of file wifi-mac.cc.
References GetDevice().
Referenced by GetHeCapabilities(), ns3::ApWifiMac::GetHeOperation(), GetHeSupported(), ns3::ApWifiMac::GetMuEdcaParameterSet(), and ns3::StaWifiMac::UpdateApInfo().
bool ns3::WifiMac::GetHeSupported | ( | ) | const |
Return whether the device supports HE.
Definition at line 2000 of file wifi-mac.cc.
References GetDevice(), and GetHeConfiguration().
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), GetHeCapabilities(), ns3::ApWifiMac::GetHeOperation(), GetMaxBaBufferSize(), ns3::ApWifiMac::GetMuEdcaParameterSet(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::AdhocWifiMac::Receive(), ns3::ApWifiMac::ReceiveAssocRequest(), ns3::ApWifiMac::SendOneBeacon(), and ns3::StaWifiMac::UpdateApInfo().
bool ns3::WifiMac::GetHeSupported | ( | const Mac48Address & | address | ) | const |
address | the (link or MLD) address of a remote station |
Definition at line 2038 of file wifi-mac.cc.
References m_links.
HtCapabilities ns3::WifiMac::GetHtCapabilities | ( | uint8_t | linkId | ) | const |
Return the HT capabilities of the device for the given link.
linkId | the ID of the given link |
Definition at line 2194 of file wifi-mac.cc.
References GetHtConfiguration(), GetHtSupported(), GetWifiPhy(), m_beMaxAmpduSize, m_beMaxAmsduSize, m_bkMaxAmpduSize, m_bkMaxAmsduSize, m_viMaxAmpduSize, m_viMaxAmsduSize, m_voMaxAmpduSize, m_voMaxAmsduSize, ns3::NanoSeconds(), NS_ASSERT, NS_LOG_DEBUG, ns3::HtCapabilities::SetLdpc(), ns3::HtCapabilities::SetLSigProtectionSupport(), ns3::HtCapabilities::SetMaxAmpduLength(), ns3::HtCapabilities::SetMaxAmsduLength(), ns3::HtCapabilities::SetRxHighestSupportedDataRate(), ns3::HtCapabilities::SetRxMcsBitmask(), ns3::HtCapabilities::SetShortGuardInterval20(), ns3::HtCapabilities::SetShortGuardInterval40(), ns3::HtCapabilities::SetSupportedChannelWidth(), ns3::HtCapabilities::SetTxMaxNSpatialStreams(), ns3::HtCapabilities::SetTxMcsSetDefined(), ns3::HtCapabilities::SetTxRxMcsSetUnequal(), ns3::HtCapabilities::SetTxUnequalModulation(), and ns3::WIFI_MOD_CLASS_HT.
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::AdhocWifiMac::Receive(), and ns3::ApWifiMac::SendOneBeacon().
Ptr< HtConfiguration > ns3::WifiMac::GetHtConfiguration | ( | ) | const |
Definition at line 1961 of file wifi-mac.cc.
References GetDevice().
Referenced by GetEhtCapabilities(), GetHeCapabilities(), GetHtCapabilities(), ns3::ApWifiMac::GetHtOperation(), GetHtSupported(), GetMaxBaBufferSize(), and GetVhtCapabilities().
bool ns3::WifiMac::GetHtSupported | ( | const Mac48Address & | address | ) | const |
address | the (link or MLD) address of a remote station |
Definition at line 2012 of file wifi-mac.cc.
References m_links.
bool ns3::WifiMac::GetHtSupported | ( | uint8_t | linkId | ) | const |
Return whether the device supports HT on the given link.
linkId | the ID of the given link. |
Definition at line 1985 of file wifi-mac.cc.
References GetDevice(), GetHtConfiguration(), GetWifiPhy(), and ns3::WIFI_PHY_BAND_6GHZ.
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), GetHtCapabilities(), ns3::ApWifiMac::GetHtOperation(), GetMaxBaBufferSize(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::ApWifiMac::GetSupportedRates(), ns3::StaWifiMac::GetSupportedRates(), ns3::AdhocWifiMac::Receive(), ns3::ApWifiMac::Receive(), ns3::ApWifiMac::ReceiveAssocRequest(), ns3::ApWifiMac::SendOneBeacon(), and ns3::StaWifiMac::UpdateApInfo().
|
protected |
Get a reference to the link associated with the given ID.
linkId | the given link ID |
Definition at line 1090 of file wifi-mac.cc.
References m_links, and NS_ASSERT.
Referenced by BlockUnicastTxOnLinks(), ns3::MeshWifiInterfaceMac::ConfigureContentionWindow(), GetBssid(), GetChannelAccessManager(), GetDsssSupported(), GetEhtCapabilities(), GetErpSupported(), GetFrameExchangeManager(), GetHe6GhzBandCapabilities(), GetHeCapabilities(), ns3::ApWifiMac::GetLink(), ns3::StaWifiMac::GetLink(), GetWifiPhy(), GetWifiRemoteStationManager(), Is6GhzBand(), NotifyChannelSwitching(), NotifyRsmOfExpiredMpdu(), SetBssid(), SetDsssSupported(), SetErpSupported(), ns3::MeshWifiInterfaceMac::SwitchFrequencyChannel(), UnblockUnicastTxOnLinks(), and UpdateLinkId().
Get the ID of the link (if any) on which the given PHY is operating.
phy | the given PHY |
Definition at line 1144 of file wifi-mac.cc.
References m_links.
Referenced by ns3::StaWifiMac::DoInitialize(), and GetLinkForPhy().
std::optional< uint8_t > ns3::WifiMac::GetLinkForPhy | ( | std::size_t | phyId | ) | const |
Get the ID of the link (if any) on which the given PHY is operating.
phyId | the index of the given PHY in the vector of PHYs held by WifiNetDevice |
Definition at line 1157 of file wifi-mac.cc.
References GetLinkForPhy(), m_device, and NS_ABORT_UNLESS.
|
virtual |
Get the ID of the link having the given MAC address, if any.
address | the given MAC address |
Definition at line 1131 of file wifi-mac.cc.
References m_links.
Referenced by NotifyRsmOfExpiredMpdu(), ns3::ApWifiMac::TxFailed(), ns3::ApWifiMac::TxOk(), and ns3::StaWifiMac::TxOk().
const std::set< uint8_t > & ns3::WifiMac::GetLinkIds | ( | ) | const |
Definition at line 1105 of file wifi-mac.cc.
References m_linkIds.
|
protected |
Definition at line 1084 of file wifi-mac.cc.
References m_links.
Referenced by ns3::StaWifiMac::Disassociated(), ns3::StaWifiMac::DoGetLocalAddress(), ns3::StaWifiMac::GetBasicMultiLinkElement(), ns3::ApWifiMac::GetNextAssociationId(), ns3::StaWifiMac::GetSetupLinkIds(), ns3::StaWifiMac::MissedBeacons(), ns3::StaWifiMac::NotifyEmlsrModeChanged(), ns3::StaWifiMac::NotifySwitchingEmlsrLink(), ns3::StaWifiMac::ReceiveAssocResp(), ns3::StaWifiMac::ScanningTimeout(), ns3::StaWifiMac::SendAssociationRequest(), ns3::ApWifiMac::SetAid(), ns3::StaWifiMac::SetPmModeAfterAssociation(), ns3::StaWifiMac::StartScanning(), and ns3::ApWifiMac::TxFailed().
Mac48Address ns3::WifiMac::GetLocalAddress | ( | const Mac48Address & | remoteAddr | ) | const |
Get the local MAC address used to communicate with a remote STA.
Specifically:
remoteAddr | the MAC address of the remote device |
Definition at line 1864 of file wifi-mac.cc.
References DoGetLocalAddress(), GetNLinks(), m_address, and m_links.
Ptr< WifiMacQueueScheduler > ns3::WifiMac::GetMacQueueScheduler | ( | ) | const |
Get the wifi MAC queue scheduler.
Definition at line 688 of file wifi-mac.cc.
References m_scheduler.
Referenced by ns3::StaWifiMac::BlockTxOnLink(), and ns3::StaWifiMac::UnblockTxOnLink().
Return the maximum A-MPDU size of the given Access Category.
ac | Access Category index |
Definition at line 2516 of file wifi-mac.cc.
References ns3::AC_BE, ns3::AC_BK, ns3::AC_VI, ns3::AC_VO, m_beMaxAmpduSize, m_bkMaxAmpduSize, m_viMaxAmpduSize, m_voMaxAmpduSize, and NS_ABORT_MSG.
uint16_t ns3::WifiMac::GetMaxAmsduSize | ( | AcIndex | ac | ) | const |
Return the maximum A-MSDU size of the given Access Category.
ac | Access Category index |
Definition at line 2541 of file wifi-mac.cc.
References ns3::AC_BE, ns3::AC_BK, ns3::AC_VI, ns3::AC_VO, m_beMaxAmsduSize, m_bkMaxAmsduSize, m_viMaxAmsduSize, m_voMaxAmsduSize, and NS_ABORT_MSG.
uint16_t ns3::WifiMac::GetMaxBaBufferSize | ( | std::optional< Mac48Address > | address = std::nullopt | ) | const |
Get the maximum Block Ack buffer size (in number of MPDUs) supported by the given device, if any, or by this device, otherwise, based on the supported standard.
address | the (MLD or link) address of the given device |
Definition at line 2064 of file wifi-mac.cc.
References GetEhtSupported(), GetHeSupported(), GetHtConfiguration(), GetHtSupported(), and NS_ASSERT.
Referenced by SetDevice(), and SetMpduBufferSize().
std::optional< Mac48Address > ns3::WifiMac::GetMldAddress | ( | const Mac48Address & | remoteAddr | ) | const |
remoteAddr | the (MLD or link) address of a remote device |
Definition at line 1851 of file wifi-mac.cc.
References m_links.
Referenced by GetBaAgreementEstablishedAsOriginator(), GetBaAgreementEstablishedAsRecipient(), ns3::StaWifiMac::ReceiveAssocResp(), ns3::StaWifiMac::SendAssociationRequest(), ns3::ApWifiMac::SendAssocResp(), and TidMappedOnLink().
uint16_t ns3::WifiMac::GetMpduBufferSize | ( | ) | const |
Definition at line 2088 of file wifi-mac.cc.
References m_mpduBufferSize.
Referenced by GetTypeId().
uint8_t ns3::WifiMac::GetNLinks | ( | ) | const |
Get the number of links (can be greater than 1 for 11be devices only).
Definition at line 1099 of file wifi-mac.cc.
References m_links.
Referenced by AssignStreams(), ns3::ApWifiMac::DoCompleteConfig(), ns3::ApWifiMac::DoInitialize(), ns3::ApWifiMac::Enqueue(), ns3::StaWifiMac::GetBasicMultiLinkElement(), GetLocalAddress(), ns3::ApWifiMac::GetMultiLinkElement(), ns3::StaWifiMac::GetMultiLinkProbeRequest(), ns3::ApWifiMac::GetProbeResp(), ns3::ApWifiMac::GetReducedNeighborReport(), GetTypeId(), ns3::ApWifiMac::IsAssociated(), NotifyRsmOfExpiredMpdu(), ns3::ApWifiMac::ParseReportedStaInfo(), ns3::ApWifiMac::Receive(), ns3::StaWifiMac::ReceiveAssocResp(), ns3::StaWifiMac::SendAssociationRequest(), ns3::ApWifiMac::SendAssocResp(), ns3::ApWifiMac::SendOneBeacon(), ns3::ApWifiMac::SetBeaconGeneration(), ns3::ApWifiMac::TxFailed(), and ns3::ApWifiMac::TxOk().
bool ns3::WifiMac::GetQosSupported | ( | ) | const |
Return whether the device supports QoS.
Definition at line 1402 of file wifi-mac.cc.
References m_qosSupported.
Referenced by ns3::MeshWifiInterfaceMac::DoCompleteConfig(), Enqueue(), ns3::StaWifiMac::EnqueueProbeRequest(), ns3::ApWifiMac::EnqueueProbeResp(), ns3::ApWifiMac::GetAssocResp(), ns3::ApWifiMac::GetEdcaParameterSet(), ns3::ApWifiMac::GetProbeRespProfile(), GetTypeId(), ns3::StaWifiMac::SendAssociationRequest(), ns3::ApWifiMac::SendAssocResp(), ns3::ApWifiMac::SendOneBeacon(), ns3::StaWifiMac::SetPowerSaveMode(), and ns3::StaWifiMac::UpdateApInfo().
Accessor for a specified EDCA object.
ac | the Access Category |
Definition at line 611 of file wifi-mac.cc.
References m_edca.
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::ApWifiMac::Enqueue(), ns3::MeshWifiInterfaceMac::Enqueue(), ns3::StaWifiMac::Enqueue(), GetBaAgreementEstablishedAsOriginator(), GetBaAgreementEstablishedAsRecipient(), GetBEQueue(), GetBKQueue(), ns3::ApWifiMac::GetEdcaParameterSet(), GetQosTxop(), GetTxopQueue(), GetVIQueue(), GetVOQueue(), ns3::StaWifiMac::ReceiveAssocResp(), ns3::MeshWifiInterfaceMac::SendManagementFrame(), ns3::StaWifiMac::SetEdcaParameters(), ns3::StaWifiMac::SetMuEdcaParameters(), ns3::StaWifiMac::SetPowerSaveMode(), and UnblockUnicastTxOnLinks().
Accessor for a specified EDCA object.
tid | the Traffic ID |
Definition at line 627 of file wifi-mac.cc.
References GetQosTxop(), and ns3::QosUtilsMapTidToAc().
|
protected |
Definition at line 1452 of file wifi-mac.cc.
References m_shortSlotTimeSupported.
Referenced by ns3::StaWifiMac::GetCapabilities(), GetTypeId(), and ns3::ApWifiMac::UpdateShortSlotTimeEnabled().
Ssid ns3::WifiMac::GetSsid | ( | ) | const |
Definition at line 527 of file wifi-mac.cc.
References m_ssid.
Referenced by ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetFilsDiscovery(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), GetTypeId(), ns3::ApWifiMac::Receive(), ns3::MeshWifiInterfaceMac::Receive(), ns3::MeshWifiInterfaceMac::SendBeacon(), ns3::ApWifiMac::SendOneBeacon(), and ns3::StaWifiMac::StartScanning().
std::optional< std::reference_wrapper< const WifiTidLinkMapping > > ns3::WifiMac::GetTidToLinkMapping | ( | Mac48Address | mldAddr, |
WifiDirection | dir ) const |
Get the TID-to-Link Mapping negotiated with the given MLD (if any) for the given direction.
An empty mapping indicates the default mapping.
mldAddr | the MLD address of the given MLD |
dir | the given direction (DL or UL) |
Definition at line 1296 of file wifi-mac.cc.
References ns3::BOTH_DIRECTIONS, dir, ns3::DOWNLINK, m_dlTidLinkMappings, m_ulTidLinkMappings, and NS_ABORT_MSG_IF.
bool ns3::WifiMac::GetTxBlockedOnLink | ( | AcIndex | ac, |
const WifiContainerQueueId & | queueId, | ||
uint8_t | linkId, | ||
WifiQueueBlockedReason | reason = WifiQueueBlockedReason::REASONS_COUNT ) const |
Check whether the transmission of the packets in the given container queue of the given Access Category are blocked on the given link for the given reason (if any).
ac | the given Access Category |
queueId | the given container queue |
linkId | the ID of the given link |
reason | the reason to block transmissions (REASONS_COUNT indicate no reason) |
Definition at line 1676 of file wifi-mac.cc.
References m_scheduler, and ns3::REASONS_COUNT.
Accessor for the Txop object.
Definition at line 565 of file wifi-mac.cc.
References m_txop.
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::ApWifiMac::Enqueue(), ns3::StaWifiMac::Enqueue(), ns3::StaWifiMac::EnqueueProbeRequest(), ns3::ApWifiMac::EnqueueProbeResp(), GetTypeId(), ns3::StaWifiMac::ReceiveAssocResp(), ns3::StaWifiMac::SendAssociationRequest(), and ns3::ApWifiMac::SendAssocResp().
|
virtual |
Get the wifi MAC queue of the (Qos)Txop associated with the given AC, if such (Qos)Txop is installed, or a null pointer, otherwise.
ac | the given Access Category |
Reimplemented in ns3::ApWifiMac.
Definition at line 657 of file wifi-mac.cc.
References ns3::AC_BE_NQOS, GetQosTxop(), m_txop, and ns3::StaticCast().
Referenced by ns3::ApWifiMac::GetTxopQueue(), and ns3::StaWifiMac::TxOk().
|
static |
Get the type ID.
Definition at line 63 of file wifi-mac.cc.
References ns3::TypeId::ATTR_CONSTRUCT, ns3::TypeId::ATTR_GET, GetBEQueue(), GetBKQueue(), GetChannelAccessManager(), GetFrameExchangeManager(), GetFrameRetryLimit(), GetMpduBufferSize(), GetNLinks(), GetQosSupported(), GetShortSlotTimeSupported(), GetSsid(), GetTxop(), GetVIQueue(), GetVOQueue(), m_ackedMpduCallback, m_beMaxAmpduSize, m_beMaxAmsduSize, m_bkMaxAmpduSize, m_bkMaxAmsduSize, m_droppedMpduCallback, m_icfDropCallback, m_macPromiscRxTrace, m_macRxDropTrace, m_macRxTrace, m_macTxDropTrace, m_macTxTrace, m_mpduResponseTimeoutCallback, m_nackedMpduCallback, m_psduMapResponseTimeoutCallback, m_psduResponseTimeoutCallback, m_viMaxAmpduSize, m_viMaxAmsduSize, m_voMaxAmpduSize, m_voMaxAmsduSize, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakeObjectVectorAccessor(), ns3::MakeObjectVectorChecker(), ns3::MakePointerAccessor(), ns3::MakePointerChecker(), ns3::MakeSsidAccessor(), ns3::MakeSsidChecker(), ns3::MakeTraceSourceAccessor(), ns3::MakeUintegerAccessor(), ns3::MakeUintegerChecker(), SetBeBlockAckInactivityTimeout(), SetBeBlockAckThreshold(), SetBeQueue(), SetBkBlockAckInactivityTimeout(), SetBkBlockAckThreshold(), SetBkQueue(), SetCtsToSelfSupported(), SetFrameRetryLimit(), SetMpduBufferSize(), ns3::TypeId::SetParent(), SetQosSupported(), SetShortSlotTimeSupported(), SetSsid(), SetTxop(), SetViBlockAckInactivityTimeout(), SetViBlockAckThreshold(), SetViQueue(), SetVoBlockAckInactivityTimeout(), SetVoBlockAckThreshold(), and SetVoQueue().
TypeOfStation ns3::WifiMac::GetTypeOfStation | ( | ) | const |
Return the type of station.
Definition at line 484 of file wifi-mac.cc.
References m_typeOfStation.
VhtCapabilities ns3::WifiMac::GetVhtCapabilities | ( | uint8_t | linkId | ) | const |
Return the VHT capabilities of the device for the given link.
linkId | the ID of the given link |
Definition at line 2253 of file wifi-mac.cc.
References GetHtConfiguration(), GetVhtConfiguration(), GetVhtSupported(), GetWifiPhy(), m_beMaxAmpduSize, m_beMaxAmsduSize, m_bkMaxAmpduSize, m_bkMaxAmsduSize, m_viMaxAmpduSize, m_viMaxAmsduSize, m_voMaxAmpduSize, m_voMaxAmsduSize, NS_ABORT_MSG_IF, NS_ASSERT, NS_LOG_DEBUG, ns3::VhtCapabilities::SetMaxAmpduLength(), ns3::VhtCapabilities::SetMaxMpduLength(), ns3::VhtCapabilities::SetRxHighestSupportedLgiDataRate(), ns3::VhtCapabilities::SetRxLdpc(), ns3::VhtCapabilities::SetRxMcsMap(), ns3::VhtCapabilities::SetRxStbc(), ns3::VhtCapabilities::SetShortGuardIntervalFor160Mhz(), ns3::VhtCapabilities::SetShortGuardIntervalFor80Mhz(), ns3::VhtCapabilities::SetSupportedChannelWidthSet(), ns3::VhtCapabilities::SetTxHighestSupportedLgiDataRate(), ns3::VhtCapabilities::SetTxMcsMap(), ns3::VhtCapabilities::SetTxStbc(), and ns3::WIFI_MOD_CLASS_VHT.
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::AdhocWifiMac::Receive(), and ns3::ApWifiMac::SendOneBeacon().
Ptr< VhtConfiguration > ns3::WifiMac::GetVhtConfiguration | ( | ) | const |
Definition at line 1967 of file wifi-mac.cc.
References GetDevice().
Referenced by GetEhtCapabilities(), GetHeCapabilities(), GetVhtCapabilities(), and GetVhtSupported().
bool ns3::WifiMac::GetVhtSupported | ( | const Mac48Address & | address | ) | const |
address | the (link or MLD) address of a remote station |
Definition at line 2025 of file wifi-mac.cc.
References m_links.
bool ns3::WifiMac::GetVhtSupported | ( | uint8_t | linkId | ) | const |
Return whether the device supports VHT on the given link.
linkId | the ID of the given link. |
Definition at line 1992 of file wifi-mac.cc.
References GetDevice(), GetVhtConfiguration(), GetWifiPhy(), ns3::WIFI_PHY_BAND_2_4GHZ, and ns3::WIFI_PHY_BAND_6GHZ.
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), GetVhtCapabilities(), ns3::ApWifiMac::GetVhtOperation(), ns3::AdhocWifiMac::Receive(), ns3::ApWifiMac::ReceiveAssocRequest(), ns3::ApWifiMac::SendOneBeacon(), and ns3::StaWifiMac::UpdateApInfo().
Accessor for the AC_VI channel access function.
Definition at line 639 of file wifi-mac.cc.
References ns3::AC_VI, GetQosTxop(), and m_qosSupported.
Referenced by GetTypeId(), SetViBlockAckInactivityTimeout(), and SetViBlockAckThreshold().
Accessor for the AC_VO channel access function.
Definition at line 633 of file wifi-mac.cc.
References ns3::AC_VO, GetQosTxop(), and m_qosSupported.
Referenced by ns3::StaWifiMac::EnqueueProbeRequest(), ns3::ApWifiMac::EnqueueProbeResp(), GetTypeId(), ns3::StaWifiMac::SendAssociationRequest(), ns3::ApWifiMac::SendAssocResp(), SetVoBlockAckInactivityTimeout(), and SetVoBlockAckThreshold().
Ptr< WifiPhy > ns3::WifiMac::GetWifiPhy | ( | uint8_t | linkId = SINGLE_LINK_OP_ID | ) | const |
linkId | the index (starting at 0) of the PHY object to retrieve |
Definition at line 1370 of file wifi-mac.cc.
References GetLink(), and ns3::WifiMac::LinkEntity::phy.
Referenced by ns3::MeshWifiInterfaceMac::CheckSupportedRates(), ns3::StaWifiMac::CheckSupportedRates(), ns3::MeshWifiInterfaceMac::Enqueue(), ns3::StaWifiMac::GetCapabilities(), ns3::StaWifiMac::GetCurrentChannel(), ns3::ApWifiMac::GetDsssParameterSet(), ns3::ApWifiMac::GetEhtOperation(), ns3::MeshWifiInterfaceMac::GetFrequencyChannel(), ns3::ApWifiMac::GetHeOperation(), GetHtCapabilities(), ns3::ApWifiMac::GetHtOperation(), GetHtSupported(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetSupportedRates(), ns3::MeshWifiInterfaceMac::GetSupportedRates(), ns3::StaWifiMac::GetSupportedRates(), GetVhtCapabilities(), ns3::ApWifiMac::GetVhtOperation(), GetVhtSupported(), ns3::MeshWifiInterfaceMac::Receive(), ns3::ApWifiMac::ReceiveAssocRequest(), ns3::ApWifiMac::SendOneBeacon(), ns3::MeshWifiInterfaceMac::SwitchFrequencyChannel(), ns3::StaWifiMac::UpdateApInfo(), and ns3::ApWifiMac::UpdateShortPreambleEnabled().
Ptr< WifiRemoteStationManager > ns3::WifiMac::GetWifiRemoteStationManager | ( | uint8_t | linkId = 0 | ) | const |
linkId | the ID (starting at 0) of the link of the RemoteStationManager object to retrieve |
Definition at line 1072 of file wifi-mac.cc.
References GetLink(), and ns3::WifiMac::LinkEntity::stationManager.
Referenced by ns3::StaWifiMac::BlockTxOnLink(), ns3::MeshWifiInterfaceMac::CheckSupportedRates(), ns3::StaWifiMac::Disassociated(), ns3::AdhocWifiMac::Enqueue(), ns3::ApWifiMac::Enqueue(), ns3::MeshWifiInterfaceMac::Enqueue(), ns3::StaWifiMac::Enqueue(), ns3::ApWifiMac::EnqueueProbeResp(), ns3::ApWifiMac::GetAssociationId(), ns3::ApWifiMac::GetAssocResp(), ns3::ApWifiMac::GetEhtOperation(), ns3::ApWifiMac::GetHeOperation(), ns3::ApWifiMac::GetHtOperation(), ns3::ApWifiMac::GetLinkIdStaAddrMap(), ns3::ApWifiMac::GetMultiLinkElement(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::ApWifiMac::GetSupportedRates(), ns3::MeshWifiInterfaceMac::GetSupportedRates(), ns3::ApWifiMac::GetUseNonErpProtection(), ns3::ApWifiMac::GetVhtOperation(), ns3::ApWifiMac::IsAssociated(), ns3::ApWifiMac::ParseReportedStaInfo(), ns3::ApWifiMac::ProcessPowerManagementFlag(), ns3::AdhocWifiMac::Receive(), ns3::ApWifiMac::Receive(), ns3::MeshWifiInterfaceMac::Receive(), ns3::ApWifiMac::ReceiveAssocRequest(), ns3::StaWifiMac::ReceiveAssocResp(), ns3::ApWifiMac::ReceiveEmlOmn(), ns3::StaWifiMac::ScanningTimeout(), ns3::StaWifiMac::SendAssociationRequest(), ns3::ApWifiMac::SendAssocResp(), ns3::ApWifiMac::SendOneBeacon(), ns3::ApWifiMac::SetAid(), ns3::ApWifiMac::StaSwitchingToActiveModeOrDeassociated(), ns3::ApWifiMac::StaSwitchingToPsMode(), TidMappedOnLink(), ns3::ApWifiMac::TxFailed(), ns3::ApWifiMac::TxOk(), ns3::StaWifiMac::UnblockTxOnLink(), ns3::StaWifiMac::UpdateApInfo(), ns3::ApWifiMac::UpdateShortPreambleEnabled(), and ns3::ApWifiMac::UpdateShortSlotTimeEnabled().
|
virtual |
Check if the MAC has frames to transmit over the given link.
linkId | the ID of the given link. |
Definition at line 664 of file wifi-mac.cc.
References ns3::Txop::HasFramesToTransmit(), m_edca, and m_txop.
Referenced by ns3::StaWifiMac::SetPowerSaveMode().
bool ns3::WifiMac::Is6GhzBand | ( | uint8_t | linkId | ) | const |
Indicate if a given link is on the 6 GHz band.
linkId | the ID of the given link |
Definition at line 1254 of file wifi-mac.cc.
References GetLink(), NS_ASSERT, ns3::WifiMac::LinkEntity::phy, and ns3::WIFI_PHY_BAND_6GHZ.
Referenced by ns3::AdhocWifiMac::Enqueue(), ns3::StaWifiMac::GetAssociationRequest(), ns3::ApWifiMac::GetAssocResp(), ns3::StaWifiMac::GetProbeRequest(), ns3::ApWifiMac::GetProbeRespProfile(), ns3::ApWifiMac::ReceiveAssocRequest(), ns3::ApWifiMac::SendOneBeacon(), and ns3::StaWifiMac::UpdateApInfo().
|
virtual |
Notify that channel on the given link has been switched.
linkId | the ID of the given link |
Reimplemented in ns3::StaWifiMac.
Definition at line 694 of file wifi-mac.cc.
References ConfigurePhyDependentParameters(), GetLink(), NS_LOG_FUNCTION, and ns3::WifiMac::LinkEntity::stationManager.
Referenced by ns3::StaWifiMac::NotifyChannelSwitching(), and ns3::FrameExchangeManager::NotifySwitchingStartNow().
|
overrideprotectedvirtual |
Notifier called once the ObjectBase is fully constructed.
This method is invoked once all member attributes have been initialized. Subclasses can override this method to be notified of this event but if they do this, they must chain up to their parent's NotifyConstructionCompleted method.
Reimplemented from ns3::ObjectBase.
Definition at line 394 of file wifi-mac.cc.
References m_qosSupported, NS_LOG_FUNCTION, SetupDcfQueue(), SetupEdcaQueue(), and ns3::wifiAcList.
|
privatevirtual |
Allow subclasses to take actions when a packet to enqueue has been dropped.
packet | the dropped packet |
to | the address to which the packet should have been sent |
Reimplemented in ns3::StaWifiMac.
Definition at line 1796 of file wifi-mac.cc.
References NS_LOG_FUNCTION.
Referenced by Enqueue().
packet | the packet we received promiscuously |
Public method used to fire a MacPromiscRx trace. Implemented for encapsulation purposes.
Definition at line 725 of file wifi-mac.cc.
References m_macPromiscRxTrace.
Notify the remote station manager if the given expired (hence dropped) MPDU is a management or data frame (with a unicast receiver address) that has been already transmitted and is not in flight (otherwise, it is handled when the ack is received or the TX timeout expires).
mpdu | the expired MPDU |
Definition at line 1695 of file wifi-mac.cc.
References DoGetLocalAddress(), GetLink(), GetLinkIdByAddress(), GetNLinks(), m_address, m_links, NS_ASSERT_MSG, NS_LOG_FUNCTION, and ns3::WifiMac::LinkEntity::stationManager.
Referenced by SetupEdcaQueue().
packet | the packet we received |
Public method used to fire a MacRx trace. Implemented for encapsulation purposes.
Definition at line 719 of file wifi-mac.cc.
References m_macRxTrace.
packet | the packet we received but is not destined for us |
Public method used to fire a MacRxDrop trace. Implemented for encapsulation purposes.
Definition at line 731 of file wifi-mac.cc.
References m_macRxDropTrace.
Referenced by ns3::ApWifiMac::Receive(), and ns3::StaWifiMac::Receive().
packet | the packet being enqueued |
Public method used to fire a MacTx trace. Implemented for encapsulation purposes. Note this trace indicates that the packet was accepted by the device only. The packet may be dropped later (e.g. if the queue is full).
Definition at line 707 of file wifi-mac.cc.
References m_macTxTrace.
packet | the packet being dropped |
Public method used to fire a MacTxDrop trace. This trace indicates that the packet was dropped before it was queued for transmission (e.g. when a STA is not associated with an AP).
Definition at line 713 of file wifi-mac.cc.
References m_macTxDropTrace.
Referenced by Enqueue().
This method acts as the MacRxMiddle receive callback and is invoked to notify us that a frame has been received on the given link.
The implementation is intended to capture logic that is going to be common to all (or most) derived classes. Specifically, handling of Block Ack management frames is dealt with here.
This method will need, however, to be overridden by derived classes so that they can perform their data handling before invoking the base version.
The given link may be undefined in some cases (e.g., in case of QoS Data frames received in the context of a Block Ack agreement – because the BlockAckManager does not have to record the link each buffered MPDU has been received on); in such a cases, the value of linkId should be WIFI_LINKID_UNDEFINED.
mpdu | the MPDU that has been received. |
linkId | the ID of the given link |
Reimplemented in ns3::AdhocWifiMac, ns3::ApWifiMac, ns3::MeshWifiInterfaceMac, and ns3::StaWifiMac.
Definition at line 1809 of file wifi-mac.cc.
References ns3::Mac48Address::ConvertFrom(), GetAddress(), GetDevice(), GetFrameExchangeManager(), NS_FATAL_ERROR, and NS_LOG_FUNCTION.
Referenced by WifiMac(), ns3::AdhocWifiMac::Receive(), ns3::ApWifiMac::Receive(), and ns3::StaWifiMac::Receive().
void ns3::WifiMac::ResetWifiPhys | ( | ) |
Remove currently attached WifiPhy objects from this MAC.
Definition at line 1376 of file wifi-mac.cc.
References m_links, and NS_LOG_FUNCTION.
Referenced by SetWifiPhys().
|
virtual |
address | the current address of this MAC layer. |
Definition at line 507 of file wifi-mac.cc.
References m_address, and NS_LOG_FUNCTION.
|
private |
Set BE block ack inactivity timeout.
timeout | the BE block ack inactivity timeout. |
Definition at line 2167 of file wifi-mac.cc.
References GetBEQueue(), m_qosSupported, NS_LOG_FUNCTION, ns3::QosTxop::SetBlockAckInactivityTimeout(), and timeout.
Referenced by GetTypeId().
|
private |
Set the block ack threshold for AC_BE.
threshold | the block ack threshold for AC_BE. |
Definition at line 2127 of file wifi-mac.cc.
References GetBEQueue(), m_qosSupported, NS_LOG_FUNCTION, and ns3::QosTxop::SetBlockAckThreshold().
Referenced by GetTypeId().
Set the AC_BE channel access function This method is private so that it is only used while constructing this object.
edca | the QosTxop object for AC_BE |
Definition at line 591 of file wifi-mac.cc.
References ns3::AC_BE, m_edca, m_qosSupported, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
|
private |
Set BK block ack inactivity timeout.
timeout | the BK block ack inactivity timeout. |
Definition at line 2177 of file wifi-mac.cc.
References GetBKQueue(), m_qosSupported, NS_LOG_FUNCTION, ns3::QosTxop::SetBlockAckInactivityTimeout(), and timeout.
Referenced by GetTypeId().
|
private |
Set the block ack threshold for AC_BK.
threshold | the block ack threshold for AC_BK. |
Definition at line 2137 of file wifi-mac.cc.
References GetBKQueue(), m_qosSupported, NS_LOG_FUNCTION, and ns3::QosTxop::SetBlockAckThreshold().
Referenced by GetTypeId().
Set the AC_BK channel access function This method is private so that it is only used while constructing this object.
edca | the QosTxop object for AC_BK |
Definition at line 601 of file wifi-mac.cc.
References ns3::AC_BK, m_edca, m_qosSupported, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiMac::SetBssid | ( | Mac48Address | bssid, |
uint8_t | linkId ) |
bssid | the BSSID of the network that the given link belongs to. |
linkId | the ID of the given link |
Definition at line 533 of file wifi-mac.cc.
References ns3::WifiMac::LinkEntity::feManager, GetLink(), and NS_LOG_FUNCTION.
Referenced by ns3::StaWifiMac::ReceiveAssocResp().
void ns3::WifiMac::SetChannelAccessManagers | ( | const std::vector< Ptr< ChannelAccessManager > > & | caManagers | ) |
caManagers | the channel access managers attached to this MAC. |
Definition at line 1013 of file wifi-mac.cc.
References CompleteConfig(), CreateLinksIfNeeded(), m_links, NS_ABORT_MSG_IF, and NS_LOG_FUNCTION.
void ns3::WifiMac::SetCtsToSelfSupported | ( | bool | enable | ) |
Enable or disable CTS-to-self feature.
enable | true if CTS-to-self is to be supported, false otherwise |
Definition at line 1438 of file wifi-mac.cc.
References m_ctsToSelfSupported, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiMac::SetDevice | ( | const Ptr< WifiNetDevice > | device | ) |
Sets the device this PHY is associated with.
device | the device this PHY is associated with |
Definition at line 490 of file wifi-mac.cc.
References GetMaxBaBufferSize(), m_device, and m_mpduBufferSize.
Referenced by Bug2831TestCase::DoRun(), and DcfImmediateAccessBroadcastTestCase::DoRun().
|
private |
Enable or disable DSSS support for the given link.
enable | whether DSSS is supported |
linkId | the ID of the given link |
Definition at line 1425 of file wifi-mac.cc.
References ns3::WifiMac::LinkEntity::dsssSupported, GetLink(), and NS_LOG_FUNCTION.
Referenced by SetErpSupported().
|
private |
Enable or disable ERP support for the given link.
enable | whether ERP is supported |
linkId | the ID of the given link |
Definition at line 1414 of file wifi-mac.cc.
References ns3::WifiMac::LinkEntity::erpSupported, GetLink(), NS_LOG_FUNCTION, and SetDsssSupported().
void ns3::WifiMac::SetForwardUpCallback | ( | ForwardUpCallback | upCallback | ) |
upCallback | the callback to invoke when a packet must be forwarded up the stack. |
Definition at line 1464 of file wifi-mac.cc.
References m_forwardUp, and NS_LOG_FUNCTION.
void ns3::WifiMac::SetFrameExchangeManagers | ( | const std::vector< Ptr< FrameExchangeManager > > & | feManagers | ) |
feManagers | the frame exchange managers attached to this MAC. |
Definition at line 965 of file wifi-mac.cc.
References CompleteConfig(), CreateLinksIfNeeded(), ns3::DynamicCast(), m_ackedMpduCallback, m_droppedMpduCallback, m_icfDropCallback, m_links, m_mpduResponseTimeoutCallback, m_psduMapResponseTimeoutCallback, m_psduResponseTimeoutCallback, ns3::MakeCallback(), NS_ABORT_MSG_IF, and NS_LOG_FUNCTION.
void ns3::WifiMac::SetFrameRetryLimit | ( | uint32_t | limit | ) |
Set the frame retry limit.
limit | the frame retry limit |
Definition at line 2094 of file wifi-mac.cc.
References m_frameRetryLimit, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiMac::SetLinkDownCallback | ( | Callback< void > | linkDown | ) |
linkDown | the callback to invoke when the link becomes down. |
Definition at line 1478 of file wifi-mac.cc.
References m_linkDown, and NS_LOG_FUNCTION.
|
virtual |
linkUp | the callback to invoke when the link becomes up. |
Reimplemented in ns3::AdhocWifiMac, ns3::ApWifiMac, and ns3::MeshWifiInterfaceMac.
Definition at line 1471 of file wifi-mac.cc.
References m_linkUp, and NS_LOG_FUNCTION.
Referenced by ns3::AdhocWifiMac::SetLinkUpCallback(), ns3::ApWifiMac::SetLinkUpCallback(), and ns3::MeshWifiInterfaceMac::SetLinkUpCallback().
|
virtual |
Set the wifi MAC queue scheduler.
scheduler | the wifi MAC queue scheduler |
Definition at line 681 of file wifi-mac.cc.
References m_scheduler.
void ns3::WifiMac::SetMpduBufferSize | ( | uint16_t | size | ) |
size | the size (in number of MPDUs) of the buffer used for each BlockAck agreement in which this node is a recipient |
Definition at line 2079 of file wifi-mac.cc.
References GetMaxBaBufferSize(), m_device, m_mpduBufferSize, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiMac::SetPromisc | ( | ) |
Sets the interface in promiscuous mode.
Enables promiscuous mode on the interface. Note that any further filtering on the incoming frame path may affect the overall behavior.
Definition at line 546 of file wifi-mac.cc.
References m_links.
|
private |
Enable or disable QoS support for the device.
Construct a Txop object or QosTxop objects accordingly. This method is private so that it is only used while constructing this object.
enable | whether QoS is supported |
Definition at line 1394 of file wifi-mac.cc.
References ns3::Object::IsInitialized(), m_qosSupported, NS_ABORT_IF, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
|
protected |
Enable or disable short slot time feature.
enable | true if short slot time is to be supported, false otherwise |
Definition at line 1445 of file wifi-mac.cc.
References m_shortSlotTimeSupported, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiMac::SetSsid | ( | Ssid | ssid | ) |
ssid | the current SSID of this MAC layer. |
Definition at line 520 of file wifi-mac.cc.
References m_ssid, and NS_LOG_FUNCTION.
Referenced by TestUnsupportedModulationReception::DoRun(), WifiPrimaryChannelsTest::DoRun(), and GetTypeId().
Set the Txop object.
This method is private so that it is only used while constructing this object.
dcf | the Txop object |
Definition at line 555 of file wifi-mac.cc.
References m_qosSupported, m_txop, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiMac::SetTypeOfStation | ( | TypeOfStation | type | ) |
This method is invoked by a subclass to specify what type of station it is implementing.
This is something that the channel access functions need to know.
type | the type of station. |
Definition at line 477 of file wifi-mac.cc.
References m_typeOfStation, and NS_LOG_FUNCTION.
Referenced by ns3::AdhocWifiMac::AdhocWifiMac(), ns3::ApWifiMac::ApWifiMac(), ns3::MeshWifiInterfaceMac::MeshWifiInterfaceMac(), and ns3::StaWifiMac::StaWifiMac().
|
private |
This method is a private utility invoked to configure the channel access function for devices that do not support QoS.
Definition at line 737 of file wifi-mac.cc.
References m_droppedMpduCallback, m_txMiddle, m_txop, ns3::MakeCallback(), NS_ASSERT, NS_LOG_FUNCTION, ns3::Txop::SetDroppedMpduCallback(), and ns3::Txop::SetTxMiddle().
Referenced by NotifyConstructionCompleted().
|
private |
This method is a private utility invoked to configure the channel access function for the specified Access Category.
ac | the Access Category of the queue to initialise. |
Definition at line 748 of file wifi-mac.cc.
References m_ackedMpduCallback, m_droppedMpduCallback, m_edca, m_nackedMpduCallback, m_txMiddle, ns3::MakeCallback(), NotifyRsmOfExpiredMpdu(), NS_ASSERT, and NS_LOG_FUNCTION.
Referenced by NotifyConstructionCompleted().
|
private |
Set VI block ack inactivity timeout.
timeout | the VI block ack inactivity timeout. |
Definition at line 2157 of file wifi-mac.cc.
References GetVIQueue(), m_qosSupported, NS_LOG_FUNCTION, ns3::QosTxop::SetBlockAckInactivityTimeout(), and timeout.
Referenced by GetTypeId().
|
private |
Set the block ack threshold for AC_VI.
threshold | the block ack threshold for AC_VI. |
Definition at line 2117 of file wifi-mac.cc.
References GetVIQueue(), m_qosSupported, NS_LOG_FUNCTION, and ns3::QosTxop::SetBlockAckThreshold().
Referenced by GetTypeId().
Set the AC_VI channel access function This method is private so that it is only used while constructing this object.
edca | the QosTxop object for AC_VI |
Definition at line 581 of file wifi-mac.cc.
References ns3::AC_VI, m_edca, m_qosSupported, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
|
private |
Set VO block ack inactivity timeout.
timeout | the VO block ack inactivity timeout. |
Definition at line 2147 of file wifi-mac.cc.
References GetVOQueue(), m_qosSupported, NS_LOG_FUNCTION, ns3::QosTxop::SetBlockAckInactivityTimeout(), and timeout.
Referenced by GetTypeId().
|
private |
Set the block ack threshold for AC_VO.
threshold | the block ack threshold for AC_VO. |
Definition at line 2107 of file wifi-mac.cc.
References GetVOQueue(), m_qosSupported, NS_LOG_FUNCTION, and ns3::QosTxop::SetBlockAckThreshold().
Referenced by GetTypeId().
Set the AC_VO channel access function This method is private so that it is only used while constructing this object.
edca | the QosTxop object for AC_VO |
Definition at line 571 of file wifi-mac.cc.
References ns3::AC_VO, m_edca, m_qosSupported, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
phys | the physical layers attached to this MAC. |
Reimplemented in ns3::StaWifiMac.
Definition at line 1348 of file wifi-mac.cc.
References CompleteConfig(), CreateLinksIfNeeded(), m_links, NS_ABORT_MSG_IF, NS_LOG_FUNCTION, and ResetWifiPhys().
Referenced by ns3::StaWifiMac::SetWifiPhys().
void ns3::WifiMac::SetWifiRemoteStationManager | ( | Ptr< WifiRemoteStationManager > | stationManager | ) |
stationManager | the station manager attached to this MAC. |
Definition at line 1041 of file wifi-mac.cc.
References NS_LOG_FUNCTION, and SetWifiRemoteStationManagers().
void ns3::WifiMac::SetWifiRemoteStationManagers | ( | const std::vector< Ptr< WifiRemoteStationManager > > & | stationManagers | ) |
stationManagers | the station managers attached to this MAC. |
Definition at line 1048 of file wifi-mac.cc.
References CompleteConfig(), CreateLinksIfNeeded(), m_links, NS_ABORT_MSG_IF, and NS_LOG_FUNCTION.
Referenced by SetWifiRemoteStationManager().
|
virtual |
The interface may or may not support sending from arbitrary address. This function returns true if sending from arbitrary address is supported, false otherwise.
Reimplemented in ns3::ApWifiMac, and ns3::MeshWifiInterfaceMac.
Definition at line 1458 of file wifi-mac.cc.
Referenced by Enqueue().
|
protected |
Swap the links based on the information included in the given map.
This method is normally called by a non-AP MLD upon completing ML setup to have its link IDs match AP MLD's link IDs.
links | a set of pairs (from, to) each mapping a current link ID to the link ID it has to become (i.e., link 'from' becomes link 'to') |
Definition at line 1165 of file wifi-mac.cc.
References m_edca, m_linkIds, m_links, m_txop, NS_ASSERT, NS_ASSERT_MSG, NS_LOG_FUNCTION, ns3::Txop::SwapLinks(), and UpdateLinkId().
Referenced by ns3::StaWifiMac::ScanningTimeout().
bool ns3::WifiMac::TidMappedOnLink | ( | Mac48Address | mldAddr, |
WifiDirection | dir, | ||
uint8_t | tid, | ||
uint8_t | linkId ) const |
Check whether the given TID is mapped on the given link in the given direction for the given MLD.
mldAddr | the MLD address of the given MLD |
dir | the given direction (DL or UL) |
tid | the given TID |
linkId | the ID of the given link |
Definition at line 1312 of file wifi-mac.cc.
References ns3::BOTH_DIRECTIONS, dir, ns3::DOWNLINK, GetMldAddress(), GetWifiRemoteStationManager(), m_dlTidLinkMappings, m_ulTidLinkMappings, and NS_ABORT_MSG_IF.
void ns3::WifiMac::UnblockUnicastTxOnLinks | ( | WifiQueueBlockedReason | reason, |
const Mac48Address & | address, | ||
const std::set< uint8_t > & | linkIds ) |
Unblock the transmission on the given links of all unicast frames addressed to the station with the given address for the given reason.
The given MAC address must be the MLD address in case the addressed device is multi-link.
reason | the reason for unblocking transmissions |
address | the MAC address of the given device |
linkIds | the IDs of the links to unblock |
Definition at line 1613 of file wifi-mac.cc.
References ns3::Txop::CHECK_MEDIUM_BUSY, GetAddress(), GetLink(), GetQosTxop(), ns3::UniformRandomBitGenerator::GetRv(), ns3::QosTxop::HasFramesToTransmit(), ns3::LOG_FUNCTION, m_scheduler, m_shuffleLinkIdsGen, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Simulator::ScheduleNow(), ns3::Shuffle(), ns3::Txop::StartAccessAfterEvent(), ns3::WIFI_CTL_QUEUE, ns3::WIFI_MGT_QUEUE, ns3::WIFI_QOSDATA_QUEUE, and ns3::wifiAcList.
Referenced by ns3::ApWifiMac::StaSwitchingToActiveModeOrDeassociated(), and ns3::StaWifiMac::UnblockTxOnLink().
|
private |
This method is intended to be called when a link changes ID in order to update the link ID stored by the Frame Exchange Manager and the Channel Access Manager operating on that link.
id | the (new) ID of the link that has changed ID |
Definition at line 1111 of file wifi-mac.cc.
References GetLink(), and NS_LOG_FUNCTION.
Referenced by SwapLinks().
|
protected |
Update the TID-to-Link Mappings for the given MLD in the given direction based on the given negotiated mappings.
An empty mapping indicates the default mapping.
mldAddr | the MLD address of the given MLD |
dir | the given direction (DL or UL) |
mapping | the negotiated TID-to-Link Mapping |
Definition at line 1262 of file wifi-mac.cc.
References ns3::BOTH_DIRECTIONS, dir, ns3::DOWNLINK, m_dlTidLinkMappings, m_ulTidLinkMappings, NS_ABORT_MSG_IF, and NS_LOG_FUNCTION.
Referenced by ns3::ApWifiMac::ReceiveAssocRequest(), and ns3::StaWifiMac::ReceiveAssocResp().
|
private |
ack'ed MPDU callback
Definition at line 1300 of file wifi-mac.h.
Referenced by GetTypeId(), SetFrameExchangeManagers(), and SetupEdcaQueue().
|
private |
MAC address of this station.
Definition at line 1209 of file wifi-mac.h.
Referenced by DoGetLocalAddress(), GetAddress(), GetLocalAddress(), NotifyRsmOfExpiredMpdu(), and SetAddress().
|
private |
maximum A-MPDU size for AC_BE (in bytes)
Definition at line 1228 of file wifi-mac.h.
Referenced by GetEhtCapabilities(), GetHe6GhzBandCapabilities(), GetHeCapabilities(), GetHtCapabilities(), GetMaxAmpduSize(), GetTypeId(), and GetVhtCapabilities().
|
private |
maximum A-MSDU size for AC_BE (in bytes)
Definition at line 1223 of file wifi-mac.h.
Referenced by GetEhtCapabilities(), GetHe6GhzBandCapabilities(), GetHtCapabilities(), GetMaxAmsduSize(), GetTypeId(), and GetVhtCapabilities().
|
private |
maximum A-MPDU size for AC_BK (in bytes)
Definition at line 1229 of file wifi-mac.h.
Referenced by GetEhtCapabilities(), GetHe6GhzBandCapabilities(), GetHeCapabilities(), GetHtCapabilities(), GetMaxAmpduSize(), GetTypeId(), and GetVhtCapabilities().
|
private |
maximum A-MSDU size for AC_BK (in bytes)
Definition at line 1224 of file wifi-mac.h.
Referenced by GetEhtCapabilities(), GetHe6GhzBandCapabilities(), GetHtCapabilities(), GetMaxAmsduSize(), GetTypeId(), and GetVhtCapabilities().
|
private |
flag indicating whether CTS-To-Self is supported
Definition at line 1201 of file wifi-mac.h.
Referenced by SetCtsToSelfSupported().
|
private |
Pointer to the device.
Definition at line 1205 of file wifi-mac.h.
Referenced by DoDispose(), GetDevice(), GetLinkForPhy(), SetDevice(), and SetMpduBufferSize().
|
private |
DL TID-to-Link Mapping negotiated with an MLD (identified by its MLD address)
Definition at line 1237 of file wifi-mac.h.
Referenced by ApplyTidLinkMapping(), GetTidToLinkMapping(), TidMappedOnLink(), and UpdateTidToLinkMapping().
|
private |
This trace indicates that an MPDU was dropped for the given reason.
Definition at line 1295 of file wifi-mac.h.
Referenced by GetTypeId(), SetFrameExchangeManagers(), SetupDcfQueue(), and SetupEdcaQueue().
|
private |
This is a map from Access Category index to the corresponding channel access function.
Definition at line 1219 of file wifi-mac.h.
Referenced by ConfigureContentionWindow(), DoDispose(), DoInitialize(), GetQosTxop(), HasFramesToTransmit(), SetBeQueue(), SetBkQueue(), SetupEdcaQueue(), SetViQueue(), SetVoQueue(), and SwapLinks().
|
private |
Callback to forward packet up the stack.
Definition at line 1241 of file wifi-mac.h.
Referenced by ForwardUp(), and SetForwardUpCallback().
|
private |
the frame retry limit
Definition at line 1232 of file wifi-mac.h.
Referenced by GetFrameRetryLimit(), and SetFrameRetryLimit().
|
private |
traced callback for ICF drop events
Definition at line 1379 of file wifi-mac.h.
Referenced by GetTypeId(), and SetFrameExchangeManagers().
|
protected |
Callback when a link is down.
Definition at line 961 of file wifi-mac.h.
Referenced by SetLinkDownCallback(), and ns3::StaWifiMac::TryToEnsureAssociated().
|
private |
IDs of the links in use.
Definition at line 1207 of file wifi-mac.h.
Referenced by CreateLinksIfNeeded(), GetLinkIds(), and SwapLinks().
|
private |
ID-indexed map of Link objects.
Definition at line 1206 of file wifi-mac.h.
Referenced by ApplyTidLinkMapping(), CompleteConfig(), ConfigureContentionWindow(), ConfigureDcf(), CreateLinksIfNeeded(), DoDispose(), DoInitialize(), GetEhtSupported(), GetHeSupported(), GetHtSupported(), GetLink(), GetLinkForPhy(), GetLinkIdByAddress(), GetLinks(), GetLocalAddress(), GetMldAddress(), GetNLinks(), GetVhtSupported(), NotifyRsmOfExpiredMpdu(), ResetWifiPhys(), SetChannelAccessManagers(), SetFrameExchangeManagers(), SetPromisc(), SetWifiPhys(), SetWifiRemoteStationManagers(), and SwapLinks().
|
protected |
Callback when a link is up.
Definition at line 960 of file wifi-mac.h.
Referenced by ns3::StaWifiMac::ReceiveAssocResp(), and SetLinkUpCallback().
|
private |
The trace source fired for packets successfully received by the device immediately before being forwarded up to higher layers (at the L2/L3 transition).
This is a promiscuous trace.
Definition at line 1264 of file wifi-mac.h.
Referenced by GetTypeId(), and NotifyPromiscRx().
|
private |
The trace source fired when packets coming into the "top" of the device are dropped at the MAC layer during reception.
Definition at line 1279 of file wifi-mac.h.
Referenced by GetTypeId(), and NotifyRxDrop().
|
private |
The trace source fired for packets successfully received by the device immediately before being forwarded up to higher layers (at the L2/L3 transition).
This is a non- promiscuous trace.
Definition at line 1272 of file wifi-mac.h.
Referenced by GetTypeId(), and NotifyRx().
|
private |
The trace source fired when packets coming into the "top" of the device are dropped at the MAC layer before being queued for transmission.
Definition at line 1256 of file wifi-mac.h.
Referenced by GetTypeId(), and NotifyTxDrop().
|
private |
The trace source fired when packets come into the "top" of the device at the L3/L2 transition, before being queued for transmission.
Definition at line 1249 of file wifi-mac.h.
Referenced by GetTypeId(), and NotifyTx().
|
private |
BlockAck buffer size (in number of MPDUs)
Definition at line 1231 of file wifi-mac.h.
Referenced by GetMpduBufferSize(), SetDevice(), and SetMpduBufferSize().
|
private |
MPDU response timeout traced callback.
This trace source is fed by a WifiTxTimer object.
Definition at line 1322 of file wifi-mac.h.
Referenced by GetTypeId(), and SetFrameExchangeManagers().
|
private |
nack'ed MPDU callback
Definition at line 1301 of file wifi-mac.h.
Referenced by GetTypeId(), and SetupEdcaQueue().
|
private |
PSDU map response timeout traced callback.
This trace source is fed by a WifiTxTimer object.
Definition at line 1366 of file wifi-mac.h.
Referenced by GetTypeId(), and SetFrameExchangeManagers().
|
private |
PSDU response timeout traced callback.
This trace source is fed by a WifiTxTimer object.
Definition at line 1343 of file wifi-mac.h.
Referenced by GetTypeId(), and SetFrameExchangeManagers().
|
private |
This Boolean is set true
iff this WifiMac is to model 802.11e/WMM style Quality of Service.
It is exposed through the attribute system.
At the moment, this flag is the sole selection between QoS and non-QoS operation for the STA (whether IBSS, AP, or non-AP). Ultimately, we will want a QoS-enabled STA to be able to fall back to non-QoS operation with a non-QoS peer. This'll require further intelligence - i.e., per-association QoS state. Having a big switch seems like a good intermediate stage, however.
Definition at line 1198 of file wifi-mac.h.
Referenced by GetBEQueue(), GetBKQueue(), GetQosSupported(), GetVIQueue(), GetVOQueue(), NotifyConstructionCompleted(), SetBeBlockAckInactivityTimeout(), SetBeBlockAckThreshold(), SetBeQueue(), SetBkBlockAckInactivityTimeout(), SetBkBlockAckThreshold(), SetBkQueue(), SetQosSupported(), SetTxop(), SetViBlockAckInactivityTimeout(), SetViBlockAckThreshold(), SetViQueue(), SetVoBlockAckInactivityTimeout(), SetVoBlockAckThreshold(), and SetVoQueue().
|
protected |
RX middle (defragmentation etc.)
Definition at line 955 of file wifi-mac.h.
Referenced by WifiMac(), and DoDispose().
|
protected |
wifi MAC queue scheduler
Definition at line 958 of file wifi-mac.h.
Referenced by ApplyTidLinkMapping(), BlockUnicastTxOnLinks(), ns3::MeshWifiInterfaceMac::ConfigureContentionWindow(), DoDispose(), GetMacQueueScheduler(), GetTxBlockedOnLink(), SetMacQueueScheduler(), and UnblockUnicastTxOnLinks().
|
private |
flag whether short slot time is supported
Definition at line 1200 of file wifi-mac.h.
Referenced by GetShortSlotTimeSupported(), and SetShortSlotTimeSupported().
|
private |
random number generator to shuffle link IDs
Definition at line 1234 of file wifi-mac.h.
Referenced by AssignStreams(), and UnblockUnicastTxOnLinks().
|
private |
Service Set ID (SSID)
Definition at line 1210 of file wifi-mac.h.
|
protected |
TX middle (aggregation etc.)
Definition at line 956 of file wifi-mac.h.
Referenced by ns3::ApWifiMac::ApWifiMac(), WifiMac(), ns3::MeshWifiInterfaceMac::ConfigureContentionWindow(), DoDispose(), SetupDcfQueue(), and SetupEdcaQueue().
TXOP used for transmission of frames to non-QoS peers.
Definition at line 957 of file wifi-mac.h.
Referenced by ns3::MeshWifiInterfaceMac::ConfigureContentionWindow(), ConfigureContentionWindow(), DoDispose(), DoInitialize(), GetTxop(), GetTxopQueue(), HasFramesToTransmit(), ns3::MeshWifiInterfaceMac::SendBeacon(), ns3::StaWifiMac::SetPowerSaveMode(), SetTxop(), SetupDcfQueue(), MldSwapLinksTest::TestWifiMac::SwapLinks(), and SwapLinks().
|
private |
the type of station
Definition at line 1203 of file wifi-mac.h.
Referenced by GetTypeOfStation(), and SetTypeOfStation().
|
private |
UL TID-to-Link Mapping negotiated with an MLD (identified by its MLD address)
Definition at line 1239 of file wifi-mac.h.
Referenced by ApplyTidLinkMapping(), GetTidToLinkMapping(), TidMappedOnLink(), and UpdateTidToLinkMapping().
|
private |
maximum A-MPDU size for AC_VI (in bytes)
Definition at line 1227 of file wifi-mac.h.
Referenced by GetEhtCapabilities(), GetHe6GhzBandCapabilities(), GetHeCapabilities(), GetHtCapabilities(), GetMaxAmpduSize(), GetTypeId(), and GetVhtCapabilities().
|
private |
maximum A-MSDU size for AC_VI (in bytes)
Definition at line 1222 of file wifi-mac.h.
Referenced by GetEhtCapabilities(), GetHe6GhzBandCapabilities(), GetHtCapabilities(), GetMaxAmsduSize(), GetTypeId(), and GetVhtCapabilities().
|
private |
maximum A-MPDU size for AC_VO (in bytes)
Definition at line 1226 of file wifi-mac.h.
Referenced by GetEhtCapabilities(), GetHe6GhzBandCapabilities(), GetHeCapabilities(), GetHtCapabilities(), GetMaxAmpduSize(), GetTypeId(), and GetVhtCapabilities().
|
private |
maximum A-MSDU size for AC_VO (in bytes)
Definition at line 1221 of file wifi-mac.h.
Referenced by GetEhtCapabilities(), GetHe6GhzBandCapabilities(), GetHtCapabilities(), GetMaxAmsduSize(), GetTypeId(), and GetVhtCapabilities().