Wi-Fi AP state machine. More...
#include "ap-wifi-mac.h"
Classes | |
struct | ApLinkEntity |
Structure holding information specific to a single link. More... | |
struct | BsrType |
store value and timestamp for each Buffer Status Report More... | |
Public Types | |
using | TimeAccessParamsMap = std::map<AcIndex, std::vector<Time>> |
ACI-indexed map of access parameters of type Time (TxopLimit) | |
using | TimeAccessParamsMapValue = AttributeContainerValue<TimeAccessParamsPairValue, ';'> |
AttributeValue type of ACI-indexed map of access parameters of type Time. | |
using | TimeAccessParamsPairValue |
AttributeValue type of a pair (ACI, access parameters of type Time) | |
using | UintAccessParamsMap = std::map<AcIndex, std::vector<uint64_t>> |
ACI-indexed map of access parameters of type unsigned integer (CWmin, CWmax and AIFSN) | |
using | UintAccessParamsMapValue = AttributeContainerValue<UintAccessParamsPairValue, ';'> |
AttributeValue type of an ACI-indexed map of access parameters of type unsigned integer. | |
using | UintAccessParamsPairValue |
AttributeValue type of a pair (ACI, access parameters of type unsigned integer) | |
Public Types inherited from ns3::WifiMac | |
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 | |
ApWifiMac () | |
~ApWifiMac () override | |
int64_t | AssignStreams (int64_t stream) override |
Assign a fixed random variable stream number to the random variables used by this model. | |
bool | CanForwardPacketsTo (Mac48Address to) const override |
Return true if packets can be forwarded to the given destination, false otherwise. | |
Ptr< ApEmlsrManager > | GetApEmlsrManager () const |
uint16_t | GetAssociationId (Mac48Address addr, uint8_t linkId) const |
Time | GetBeaconInterval () const |
uint8_t | GetBufferStatus (uint8_t tid, Mac48Address address) const |
Return the value of the Queue Size subfield of the last QoS Data or QoS Null frame received from the station with the given MAC address and belonging to the given TID. | |
uint8_t | GetMaxBufferStatus (Mac48Address address) const |
Return the maximum among the values of the Queue Size subfield of the last QoS Data or QoS Null frames received from the station with the given MAC address and belonging to any TID. | |
std::optional< Mac48Address > | GetMldOrLinkAddressByAid (uint16_t aid) const |
const std::map< uint16_t, Mac48Address > & | GetStaList (uint8_t linkId) const |
Get a const reference to the map of associated stations on the given link. | |
Ptr< WifiMacQueue > | GetTxopQueue (AcIndex ac) const override |
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. | |
std::optional< uint8_t > | IsAssociated (const Mac48Address &address) const |
Get the ID of a link (if any) that has been setup with the station having the given MAC address. | |
void | SetApEmlsrManager (Ptr< ApEmlsrManager > apEmlsrManager) |
Set the AP EMLSR Manager. | |
void | SetBeaconInterval (Time interval) |
void | SetBufferStatus (uint8_t tid, Mac48Address address, uint8_t size) |
Store the value of the Queue Size subfield of the last QoS Data or QoS Null frame received from the station with the given MAC address and belonging to the given TID. | |
void | SetLinkUpCallback (Callback< void > linkUp) override |
bool | SupportsSendFrom () const override |
Public Member Functions inherited from ns3::WifiMac | |
WifiMac () | |
WifiMac (const WifiMac &)=delete | |
~WifiMac () override | |
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. | |
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) const |
RecipientAgreementOptConstRef | GetBaAgreementEstablishedAsRecipient (Mac48Address originator, uint8_t tid) 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. | |
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 | 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) |
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 Ptr< const AttributeChecker > | GetTimeAccessParamsChecker () |
Get a checker for the TxopLimitsForSta attribute, which can be used to deserialize an ACI-indexed map of access parameters of type Time (TxopLimit) from a string: | |
static TypeId | GetTypeId () |
Get the type ID. | |
template<class T > | |
static Ptr< const AttributeChecker > | GetUintAccessParamsChecker () |
Get a checker for the CwMinsForSta, CwMaxsForSta and AifsnsForSta attributes, which can be used to deserialize an ACI-indexed map of access parameters of type unsigned integer (CWmin, CWmax and AIFSN) from a string: | |
Static Public Member Functions inherited from ns3::WifiMac | |
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 | |
ApLinkEntity & | GetLink (uint8_t linkId) const |
Get a reference to the link associated with the given ID. | |
Protected Member Functions inherited from ns3::WifiMac | |
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) |
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. | |
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 | |
std::map< uint16_t, Mac48Address > | m_aidToMldOrLinkAddress |
Maps AIDs to MLD addresses (for MLDs) or link addresses (in case of single link devices) | |
Protected Attributes inherited from ns3::WifiMac | |
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(* | AssociationCallback) (uint16_t aid, Mac48Address address) |
TracedCallback signature for association/deassociation events. | |
using | LinkIdStaAddrMap = std::map<uint8_t, Mac48Address> |
Map of (link ID, remote STA address) of the links to setup. | |
Private Member Functions | |
std::unique_ptr< LinkEntity > | CreateLinkEntity () const override |
Create a LinkEntity object. | |
void | DeaggregateAmsduAndForward (Ptr< const WifiMpdu > mpdu) override |
This method is called to de-aggregate an A-MSDU and forward the constituent packets up the stack. | |
void | DoCompleteConfig () override |
Allow subclasses to complete the configuration of the MAC layer components. | |
void | DoDispose () override |
Destructor implementation. | |
Mac48Address | DoGetLocalAddress (const Mac48Address &remoteAddr) const override |
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. | |
void | DoInitialize () override |
Initialize() implementation. | |
void | Enqueue (Ptr< WifiMpdu > mpdu, Mac48Address to, Mac48Address from) override |
MgtAssocResponseHeader | GetAssocResp (Mac48Address to, uint8_t linkId) |
Get the Association Response frame to send on a given link. | |
CapabilityInformation | GetCapabilities (uint8_t linkId) const |
Return the Capability information of the current AP for the given link. | |
DsssParameterSet | GetDsssParameterSet (uint8_t linkId) const |
Return the DSSS Parameter Set that we support on the given link. | |
EdcaParameterSet | GetEdcaParameterSet (uint8_t linkId) const |
Return the EDCA Parameter Set of the current AP for the given link. | |
EhtOperation | GetEhtOperation (uint8_t linkId) const |
Return the EHT operation of the current AP for the given link. | |
ErpInformation | GetErpInformation (uint8_t linkId) const |
Return the ERP information of the current AP for the given link. | |
Ptr< WifiMpdu > | GetFilsDiscovery (uint8_t linkId) const |
Get the FILS Discovery frame to send on the given link. | |
HeOperation | GetHeOperation (uint8_t linkId) const |
Return the HE operation of the current AP for the given link. | |
HtOperation | GetHtOperation (uint8_t linkId) const |
Return the HT operation of the current AP for the given link. | |
LinkIdStaAddrMap | GetLinkIdStaAddrMap (MgtAssocResponseHeader &assoc, const Mac48Address &to, uint8_t linkId) |
Get a map of (link ID, remote STA address) of the links to setup. | |
std::optional< MuEdcaParameterSet > | GetMuEdcaParameterSet () const |
Return the MU EDCA Parameter Set of the current AP, if one needs to be advertised. | |
MultiLinkElement | GetMultiLinkElement (uint8_t linkId, WifiMacType frameType, const Mac48Address &to=Mac48Address::GetBroadcast()) |
Return the Multi-Link Element that the current AP includes in the management frames of the given type it transmits on the given link. | |
uint16_t | GetNextAssociationId () const |
std::optional< ReducedNeighborReport > | GetReducedNeighborReport (uint8_t linkId) const |
Return the Reduced Neighbor Report (RNR) element that the current AP sends on the given link, if one needs to be advertised. | |
AllSupportedRates | GetSupportedRates (uint8_t linkId) const |
Return an instance of SupportedRates that contains all rates that we support for the given link (including HT rates). | |
bool | GetUseNonErpProtection (uint8_t linkId) const |
Return whether protection for non-ERP stations is used in the BSS corresponding to the given link. | |
VhtOperation | GetVhtOperation (uint8_t linkId) const |
Return the VHT operation of the current AP for the given link. | |
void | ParseReportedStaInfo (const AssocReqRefVariant &assoc, Mac48Address from, uint8_t linkId) |
Given a (Re)Association Request frame body containing a Multi-Link Element, check if a link can be setup with each of the reported stations (STA MAC address and a (Re)Association Request frame body must be present, the Link ID identifies a valid link other than the one the frame was received on and the supported rates are compatible with our basic rate set). | |
void | ProcessPowerManagementFlag (Ptr< const WifiMpdu > mpdu, uint8_t linkId) |
Process the Power Management bit in the Frame Control field of an MPDU successfully received on the given link. | |
void | Receive (Ptr< const WifiMpdu > mpdu, uint8_t linkId) override |
This method acts as the MacRxMiddle receive callback and is invoked to notify us that a frame has been received on the given link. | |
bool | ReceiveAssocRequest (const AssocReqRefVariant &assoc, const Mac48Address &from, uint8_t linkId) |
Check whether the supported rate set included in the received (Re)Association Request frame is compatible with our Basic Rate Set. | |
void | ReceiveEmlOmn (MgtEmlOmn &frame, const Mac48Address &sender, uint8_t linkId) |
Take necessary actions upon receiving the given EML Operating Mode Notification frame from the given station on the given link. | |
void | ScheduleFilsDiscOrUnsolProbeRespFrames (uint8_t linkId) |
Schedule the transmission of FILS Discovery frames or unsolicited Probe Response frames on the given link. | |
void | SendAssocResp (Mac48Address to, bool isReassoc, uint8_t linkId) |
Forward an association or a reassociation response packet to the DCF/EDCA. | |
void | SendOneBeacon (uint8_t linkId) |
Forward a beacon packet to the beacon special DCF for transmission on the given link. | |
void | SendProbeResp (Mac48Address to, uint8_t linkId) |
Send a Probe Response in response to a Probe Request received from the STA with the given address on the given link. | |
void | SetAid (MgtAssocResponseHeader &assoc, const LinkIdStaAddrMap &linkIdStaAddrMap) |
Set the AID field of the given Association Response frame. | |
void | SetBeaconGeneration (bool enable) |
Enable or disable beacon generation of the AP. | |
void | StaSwitchingToActiveModeOrDeassociated (const Mac48Address &staAddr, uint8_t linkId) |
Perform the necessary actions when a given station deassociates or switches from powersave mode to active mode. | |
void | StaSwitchingToPsMode (const Mac48Address &staAddr, uint8_t linkId) |
Perform the necessary actions when a given station switches from active mode to powersave mode. | |
void | TxFailed (WifiMacDropReason timeoutReason, Ptr< const WifiMpdu > mpdu) |
The packet we sent was successfully received by the receiver (i.e. | |
void | TxOk (Ptr< const WifiMpdu > mpdu) |
The packet we sent was successfully received by the receiver (i.e. | |
void | UpdateShortPreambleEnabled (uint8_t linkId) |
Update whether short preamble should be enabled or not in the BSS corresponding to the given link. | |
void | UpdateShortSlotTimeEnabled (uint8_t linkId) |
Update whether short slot time should be enabled or not in the BSS corresponding to the given link. | |
Private Attributes | |
UintAccessParamsMap | m_aifsnsForSta |
Per-AC AIFS values to advertise to stations. | |
Ptr< ApEmlsrManager > | m_apEmlsrManager |
AP EMLSR Manager. | |
TracedCallback< uint16_t, Mac48Address > | m_assocLogger |
association logger | |
Time | m_beaconInterval |
Beacon interval. | |
Ptr< UniformRandomVariable > | m_beaconJitter |
UniformRandomVariable used to randomize the time of the first beacon. | |
Ptr< Txop > | m_beaconTxop |
Dedicated Txop for beacons. | |
Time | m_bsrLifetime |
Lifetime of Buffer Status Reports. | |
std::unordered_map< WifiAddressTidPair, BsrType, WifiAddressTidHash > | m_bufferStatus |
Per (MAC address, TID) buffer status reports. | |
UintAccessParamsMap | m_cwMaxsForSta |
Per-AC CW max values to advertise to stations. | |
UintAccessParamsMap | m_cwMinsForSta |
Per-AC CW min values to advertise to stations. | |
TracedCallback< uint16_t, Mac48Address > | m_deAssocLogger |
deassociation logger | |
bool | m_enableBeaconGeneration |
Flag whether beacons are being generated. | |
bool | m_enableBeaconJitter |
Flag whether the first beacon should be generated at random time. | |
bool | m_enableNonErpProtection |
Flag whether protection mechanism is used or not when non-ERP STAs are present within the BSS. | |
Time | m_fdBeaconInterval6GHz |
Time elapsing between a beacon and FILS Discovery (FD) frame or between two FD frames on 6GHz links. | |
Time | m_fdBeaconIntervalNon6GHz |
Time elapsing between a beacon and FILS Discovery (FD) frame or between two FD frames on 2.4GHz and 5GHz links. | |
bool | m_sendUnsolProbeResp |
send unsolicited Probe Response instead of FILS Discovery | |
std::map< Mac48Address, EventId > | m_transitionTimeoutEvents |
transition timeout events running for EMLSR clients | |
TimeAccessParamsMap | m_txopLimitsForSta |
Per-AC TXOP limits values to advertise to stations. | |
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. | |
Wi-Fi AP state machine.
Handle association, dis-association and authentication, of STAs within an infrastructure BSS. By default, beacons are sent with PIFS access, zero backoff, and are generated roughly every 102.4 ms by default (configurable by an attribute) and with some jitter to de-synchronize beacon transmissions in multi-BSS scenarios.
ns3::ApWifiMac is accessible through the following paths with Config::Set and Config::Connect:
ns3::Ptr<N3ns39PairValueINS_9EnumValueINS_7AcIndexEEENS_23AttributeContainerValueINS_13UintegerValueELc44ESt6vectorEEEE>
Time
-9.22337e+18ns:+9.22337e+18ns Time
-9.22337e+18ns:+9.22337e+18ns ns3::Ptr<N3ns39PairValueINS_9EnumValueINS_7AcIndexEEENS_23AttributeContainerValueINS_13UintegerValueELc44ESt6vectorEEEE>
ns3::Ptr<N3ns39PairValueINS_9EnumValueINS_7AcIndexEEENS_23AttributeContainerValueINS_13UintegerValueELc44ESt6vectorEEEE>
Time
-9.22337e+18ns:+9.22337e+18ns Time
-9.22337e+18ns:+9.22337e+18ns ns3::Ptr<N3ns39PairValueINS_9EnumValueINS_7AcIndexEEENS_23AttributeContainerValueINS_9TimeValueELc44ESt6vectorEEEE>
Ssid
Group: Wifi
Size of this type is 1240 bytes (on a 64-bit architecture).
Definition at line 62 of file ap-wifi-mac.h.
|
private |
TracedCallback signature for association/deassociation events.
aid | the AID of the station |
address | the MAC address of the station |
Definition at line 614 of file ap-wifi-mac.h.
|
private |
Map of (link ID, remote STA address) of the links to setup.
Definition at line 356 of file ap-wifi-mac.h.
using ns3::ApWifiMac::TimeAccessParamsMap = std::map<AcIndex, std::vector<Time>> |
ACI-indexed map of access parameters of type Time (TxopLimit)
Definition at line 175 of file ap-wifi-mac.h.
using ns3::ApWifiMac::TimeAccessParamsMapValue = AttributeContainerValue<TimeAccessParamsPairValue, ';'> |
AttributeValue type of ACI-indexed map of access parameters of type Time.
Definition at line 189 of file ap-wifi-mac.h.
AttributeValue type of a pair (ACI, access parameters of type Time)
Definition at line 182 of file ap-wifi-mac.h.
using ns3::ApWifiMac::UintAccessParamsMap = std::map<AcIndex, std::vector<uint64_t>> |
ACI-indexed map of access parameters of type unsigned integer (CWmin, CWmax and AIFSN)
Definition at line 172 of file ap-wifi-mac.h.
using ns3::ApWifiMac::UintAccessParamsMapValue = AttributeContainerValue<UintAccessParamsPairValue, ';'> |
AttributeValue type of an ACI-indexed map of access parameters of type unsigned integer.
Definition at line 186 of file ap-wifi-mac.h.
AttributeValue type of a pair (ACI, access parameters of type unsigned integer)
Definition at line 178 of file ap-wifi-mac.h.
ns3::ApWifiMac::ApWifiMac | ( | ) |
Definition at line 205 of file ap-wifi-mac.cc.
References ns3::AP, ns3::CreateObjectWithAttributes(), m_beaconTxop, ns3::WifiMac::m_txMiddle, NS_LOG_FUNCTION, ns3::Txop::SetTxMiddle(), and ns3::WifiMac::SetTypeOfStation().
|
override |
Definition at line 216 of file ap-wifi-mac.cc.
References NS_LOG_FUNCTION.
|
overridevirtual |
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 from ns3::WifiMac.
Definition at line 349 of file ap-wifi-mac.cc.
References ns3::Txop::AssignStreams(), ns3::WifiMac::AssignStreams(), m_beaconJitter, m_beaconTxop, and NS_LOG_FUNCTION.
|
overridevirtual |
Return true if packets can be forwarded to the given destination, false otherwise.
to | the address to which the packet should be sent |
Implements ns3::WifiMac.
Definition at line 407 of file ap-wifi-mac.cc.
References IsAssociated(), and ns3::Mac48Address::IsGroup().
|
overrideprivatevirtual |
Create a LinkEntity object.
Reimplemented from ns3::WifiMac.
Definition at line 243 of file ap-wifi-mac.cc.
|
overrideprivatevirtual |
This method is called to de-aggregate an A-MSDU and forward the constituent packets up the stack.
We override the WifiMac version here because, as an AP, we also need to think about redistributing to other associated STAs.
mpdu | the MPDU containing the A-MSDU. |
Reimplemented from ns3::WifiMac.
Definition at line 2424 of file ap-wifi-mac.cc.
References ns3::WifiMac::Enqueue(), ns3::WifiMac::ForwardUp(), IsAssociated(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::PeekPointer().
Referenced by Receive().
|
overrideprivatevirtual |
Allow subclasses to complete the configuration of the MAC layer components.
Implements ns3::WifiMac.
Definition at line 269 of file ap-wifi-mac.cc.
References ns3::WifiMac::LinkEntity::channelAccessManager, GetLink(), ns3::WifiMac::GetNLinks(), m_beaconTxop, NS_LOG_FUNCTION, ns3::Txop::SetAifsns(), ns3::Txop::SetMaxCws(), ns3::Txop::SetMinCws(), and ns3::Txop::SetWifiMac().
|
overrideprivatevirtual |
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 222 of file ap-wifi-mac.cc.
References ns3::Object::Dispose(), ns3::WifiMac::DoDispose(), m_apEmlsrManager, m_beaconTxop, m_enableBeaconGeneration, and NS_LOG_FUNCTION.
|
overrideprivatevirtual |
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 from ns3::WifiMac.
Definition at line 1747 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetFrameExchangeManager(), IsAssociated(), and NS_ASSERT_MSG.
|
overrideprivatevirtual |
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 2443 of file ap-wifi-mac.cc.
References ns3::ApWifiMac::ApLinkEntity::beaconEvent, ns3::EventId::Cancel(), ns3::WifiMac::DoInitialize(), ns3::WifiMac::GetAddress(), GetBeaconInterval(), GetLink(), ns3::Time::GetMicroSeconds(), ns3::WifiMac::GetNLinks(), ns3::Object::Initialize(), m_beaconJitter, m_beaconTxop, m_enableBeaconGeneration, m_enableBeaconJitter, ns3::MakeCallback(), ns3::MicroSeconds(), NS_ABORT_IF, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Simulator::Schedule(), SendOneBeacon(), ns3::ObjectBase::TraceConnectWithoutContext(), TxFailed(), TxOk(), UpdateShortPreambleEnabled(), and UpdateShortSlotTimeEnabled().
|
overrideprivatevirtual |
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.
Implements ns3::WifiMac.
Definition at line 413 of file ap-wifi-mac.cc.
References ns3::Create(), ns3::WifiMac::GetAddress(), ns3::WifiMac::GetFrameExchangeManager(), ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetQosTxop(), ns3::WifiMac::GetTxop(), ns3::WifiMac::GetWifiRemoteStationManager(), IsAssociated(), ns3::Mac48Address::IsGroup(), NS_ASSERT, NS_ASSERT_MSG, NS_LOG_FUNCTION, and ns3::StaticCast().
Ptr< ApEmlsrManager > ns3::ApWifiMac::GetApEmlsrManager | ( | ) | const |
Definition at line 263 of file ap-wifi-mac.cc.
References m_apEmlsrManager.
uint16_t ns3::ApWifiMac::GetAssociationId | ( | Mac48Address | addr, |
uint8_t | linkId ) const |
addr | the address of the associated station |
linkId | the ID of the link on which the station is associated |
Definition at line 2509 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetWifiRemoteStationManager().
|
private |
Get the Association Response frame to send on a given link.
The returned frame never includes a Multi-Link Element.
to | the address of the STA we are sending an association response to |
linkId | the ID of the given link |
Definition at line 1130 of file ap-wifi-mac.cc.
References ns3::MgtAssocResponseHeader::Capabilities(), GetCapabilities(), GetEdcaParameterSet(), ns3::WifiMac::GetEhtCapabilities(), GetEhtOperation(), ns3::WifiMac::GetEhtSupported(), ns3::WifiMac::GetExtendedCapabilities(), ns3::WifiMac::GetHe6GhzBandCapabilities(), ns3::WifiMac::GetHeCapabilities(), GetHeOperation(), ns3::WifiMac::GetHeSupported(), ns3::WifiMac::GetHtCapabilities(), GetHtOperation(), ns3::WifiMac::GetHtSupported(), GetMuEdcaParameterSet(), ns3::WifiMac::GetQosSupported(), GetSupportedRates(), ns3::WifiMac::GetVhtCapabilities(), GetVhtOperation(), ns3::WifiMac::GetVhtSupported(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::WifiMac::Is6GhzBand(), NS_ABORT_IF, ns3::StatusCode::SetFailure(), ns3::MgtAssocResponseHeader::SetStatusCode(), and ns3::StatusCode::SetSuccess().
Referenced by GetMultiLinkElement(), and SendAssocResp().
Time ns3::ApWifiMac::GetBeaconInterval | ( | ) | const |
Definition at line 313 of file ap-wifi-mac.cc.
References m_beaconInterval, and NS_LOG_FUNCTION.
Referenced by DoInitialize(), GetTypeId(), SendOneBeacon(), and SendProbeResp().
uint8_t ns3::ApWifiMac::GetBufferStatus | ( | uint8_t | tid, |
Mac48Address | address ) const |
Return the value of the Queue Size subfield of the last QoS Data or QoS Null frame received from the station with the given MAC address and belonging to the given TID.
The Queue Size value is the total size, rounded up to the nearest multiple of 256 octets and expressed in units of 256 octets, of all MSDUs and A-MSDUs buffered at the STA (excluding the MSDU or A-MSDU of the present QoS Data frame). A queue size value of 254 is used for all sizes greater than 64 768 octets. A queue size value of 255 is used to indicate an unspecified or unknown size. See Section 9.2.4.5.6 of 802.11-2016
tid | the given TID |
address | the given MAC address |
Definition at line 2515 of file ap-wifi-mac.cc.
References m_bsrLifetime, m_bufferStatus, and ns3::Simulator::Now().
Referenced by GetMaxBufferStatus().
|
private |
Return the Capability information of the current AP for the given link.
linkId | the ID of the given link |
Definition at line 524 of file ap-wifi-mac.cc.
References GetLink(), NS_LOG_FUNCTION, ns3::CapabilityInformation::SetEss(), ns3::CapabilityInformation::SetShortPreamble(), and ns3::CapabilityInformation::SetShortSlotTime().
Referenced by GetAssocResp(), SendOneBeacon(), and SendProbeResp().
|
private |
Return the DSSS Parameter Set that we support on the given link.
linkId | the ID of the given link |
Definition at line 514 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetDsssSupported(), ns3::WifiMac::GetWifiPhy(), NS_ASSERT, NS_LOG_FUNCTION, and ns3::DsssParameterSet::SetCurrentChannel().
Referenced by SendOneBeacon(), and SendProbeResp().
|
private |
Return the EDCA Parameter Set of the current AP for the given link.
linkId | the ID of the given link |
Definition at line 556 of file ap-wifi-mac.cc.
References ns3::AC_BE, ns3::AC_BK, ns3::AC_VI, ns3::AC_VO, ns3::Time::GetMicroSeconds(), ns3::WifiMac::GetQosSupported(), ns3::WifiMac::GetQosTxop(), m_aifsnsForSta, m_cwMaxsForSta, m_cwMinsForSta, m_txopLimitsForSta, NS_ASSERT, NS_LOG_FUNCTION, ns3::EdcaParameterSet::SetBeAci(), ns3::EdcaParameterSet::SetBeAifsn(), ns3::EdcaParameterSet::SetBeCWmax(), ns3::EdcaParameterSet::SetBeCWmin(), ns3::EdcaParameterSet::SetBeTxopLimit(), ns3::EdcaParameterSet::SetBkAci(), ns3::EdcaParameterSet::SetBkAifsn(), ns3::EdcaParameterSet::SetBkCWmax(), ns3::EdcaParameterSet::SetBkCWmin(), ns3::EdcaParameterSet::SetBkTxopLimit(), ns3::EdcaParameterSet::SetQosInfo(), ns3::EdcaParameterSet::SetViAci(), ns3::EdcaParameterSet::SetViAifsn(), ns3::EdcaParameterSet::SetViCWmax(), ns3::EdcaParameterSet::SetViCWmin(), ns3::EdcaParameterSet::SetViTxopLimit(), ns3::EdcaParameterSet::SetVoAci(), ns3::EdcaParameterSet::SetVoAifsn(), ns3::EdcaParameterSet::SetVoCWmax(), ns3::EdcaParameterSet::SetVoCWmin(), and ns3::EdcaParameterSet::SetVoTxopLimit().
Referenced by GetAssocResp(), SendOneBeacon(), and SendProbeResp().
|
private |
Return the EHT operation of the current AP for the given link.
linkId | the ID of the given link |
Definition at line 994 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetEhtSupported(), GetLink(), ns3::WifiPhy::GetMaxSupportedRxSpatialStreams(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_ASSERT, NS_LOG_FUNCTION, ns3::EhtOperation::SetMaxRxNss(), ns3::EhtOperation::SetMaxTxNss(), ns3::ApWifiMac::ApLinkEntity::staList, and ns3::WIFI_EHT_MAX_MCS_INDEX.
Referenced by GetAssocResp(), SendOneBeacon(), and SendProbeResp().
|
private |
Return the ERP information of the current AP for the given link.
linkId | the ID of the given link |
Definition at line 535 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetErpSupported(), GetLink(), GetUseNonErpProtection(), NS_ASSERT, NS_LOG_FUNCTION, ns3::ErpInformation::SetBarkerPreambleMode(), ns3::ErpInformation::SetNonErpPresent(), and ns3::ErpInformation::SetUseProtection().
Referenced by SendOneBeacon(), and SendProbeResp().
Get the FILS Discovery frame to send on the given link.
linkId | the ID of the given link |
Definition at line 1486 of file ap-wifi-mac.cc.
References ns3::Create(), ns3::WifiActionHeader::FILS_DISCOVERY, ns3::Mac48Address::GetBroadcast(), GetLink(), GetReducedNeighborReport(), ns3::WifiMac::GetSsid(), ns3::FilsDiscHeader::m_beaconInt, m_beaconInterval, ns3::FilsDiscHeader::m_fdCap, ns3::FilsDiscHeader::m_rnr, ns3::WifiActionHeader::PUBLIC, ns3::WifiActionHeader::SetAction(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetAddr2(), ns3::WifiMacHeader::SetAddr3(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::FilsDiscHeader::SetLengthSubfield(), ns3::FilsDiscHeader::SetSsid(), ns3::WIFI_MAC_MGT_ACTION, and ns3::WIFI_TU.
Referenced by ScheduleFilsDiscOrUnsolProbeRespFrames().
|
private |
Return the HE operation of the current AP for the given link.
linkId | the ID of the given link |
Definition at line 949 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetHeConfiguration(), ns3::WifiMac::GetHeSupported(), GetLink(), ns3::WifiPhy::GetMaxSupportedRxSpatialStreams(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::HeOperation::m_6GHzOpInfo, ns3::HeOperation::BssColorInfo::m_bssColor, ns3::HeOperation::m_bssColorInfo, ns3::HeOperation::OpInfo6GHz::m_chCntrFreqSeg0, ns3::HeOperation::OpInfo6GHz::m_chCntrFreqSeg1, ns3::HeOperation::OpInfo6GHz::m_chWid, ns3::HeOperation::OpInfo6GHz::m_primCh, NS_ASSERT, NS_LOG_FUNCTION, ns3::HeOperation::SetMaxHeMcsPerNss(), ns3::ApWifiMac::ApLinkEntity::staList, ns3::WIFI_PHY_BAND_6GHZ, and ns3::WIFI_STANDARD_80211ax.
Referenced by GetAssocResp(), SendOneBeacon(), and SendProbeResp().
|
private |
Return the HT operation of the current AP for the given link.
linkId | the ID of the given link |
Definition at line 793 of file ap-wifi-mac.cc.
References ns3::WifiMode::GetDataRate(), ns3::WifiMac::GetHtConfiguration(), ns3::WifiMac::GetHtSupported(), GetLink(), ns3::WifiMode::GetMcsValue(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::MIXED_MODE_PROTECTION, ns3::NanoSeconds(), ns3::NO_PROTECTION, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::HtOperation::SetDualBeacon(), ns3::HtOperation::SetDualCtsProtection(), ns3::HtOperation::SetHtProtection(), ns3::HtOperation::SetLSigTxopProtectionFullSupport(), ns3::HtOperation::SetNonGfHtStasPresent(), ns3::HtOperation::SetObssNonHtStasPresent(), ns3::HtOperation::SetPcoActive(), ns3::HtOperation::SetPhase(), ns3::HtOperation::SetPrimaryChannel(), ns3::HtOperation::SetRifsMode(), ns3::HtOperation::SetRxHighestSupportedDataRate(), ns3::HtOperation::SetRxMcsBitmask(), ns3::HtOperation::SetSecondaryChannelOffset(), ns3::HtOperation::SetStaChannelWidth(), ns3::HtOperation::SetStbcBeacon(), ns3::HtOperation::SetTxMaxNSpatialStreams(), ns3::HtOperation::SetTxMcsSetDefined(), ns3::HtOperation::SetTxRxMcsSetUnequal(), ns3::HtOperation::SetTxUnequalModulation(), ns3::ApWifiMac::ApLinkEntity::staList, and ns3::WIFI_MOD_CLASS_HT.
Referenced by GetAssocResp(), SendOneBeacon(), and SendProbeResp().
|
protected |
Get a reference to the link associated with the given ID.
linkId | the given link ID |
Definition at line 249 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetLink().
Referenced by DoCompleteConfig(), DoInitialize(), GetCapabilities(), GetEhtOperation(), GetErpInformation(), GetFilsDiscovery(), GetHeOperation(), GetHtOperation(), GetReducedNeighborReport(), GetStaList(), GetUseNonErpProtection(), GetVhtOperation(), Receive(), ReceiveEmlOmn(), ScheduleFilsDiscOrUnsolProbeRespFrames(), SendOneBeacon(), SendProbeResp(), SetAid(), SetBeaconGeneration(), TxFailed(), UpdateShortPreambleEnabled(), and UpdateShortSlotTimeEnabled().
|
private |
Get a map of (link ID, remote STA address) of the links to setup.
Information is taken from the given Association Response that is sent over the given link to the given station.
assoc | the given Association Response frame |
to | the Receiver Address (RA) of the Association Response frame |
linkId | the ID of the link on which the Association Response frame is sent |
Definition at line 1192 of file ap-wifi-mac.cc.
References ns3::MgtAssocResponseHeader::GetStatusCode(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::StatusCode::IsSuccess(), and NS_ABORT_MSG_IF.
Referenced by SendAssocResp().
uint8_t ns3::ApWifiMac::GetMaxBufferStatus | ( | Mac48Address | address | ) | const |
Return the maximum among the values of the Queue Size subfield of the last QoS Data or QoS Null frames received from the station with the given MAC address and belonging to any TID.
address | the given MAC address |
Definition at line 2540 of file ap-wifi-mac.cc.
References GetBufferStatus().
std::optional< Mac48Address > ns3::ApWifiMac::GetMldOrLinkAddressByAid | ( | uint16_t | aid | ) | const |
aid | the given AID |
Definition at line 1755 of file ap-wifi-mac.cc.
References m_aidToMldOrLinkAddress.
|
private |
Return the MU EDCA Parameter Set of the current AP, if one needs to be advertised.
Definition at line 619 of file ap-wifi-mac.cc.
References ns3::AC_BE, ns3::AC_BK, ns3::AC_VI, ns3::AC_VO, ns3::WifiMac::GetHeConfiguration(), ns3::WifiMac::GetHeSupported(), ns3::MuEdcaParameterSet::GetMuEdcaTimer(), ns3::Time::IsZero(), NS_ABORT_MSG_UNLESS, NS_ASSERT, NS_LOG_FUNCTION, ns3::MuEdcaParameterSet::SetMuAifsn(), ns3::MuEdcaParameterSet::SetMuCwMax(), ns3::MuEdcaParameterSet::SetMuCwMin(), ns3::MuEdcaParameterSet::SetMuEdcaTimer(), and ns3::MuEdcaParameterSet::SetQosInfo().
Referenced by GetAssocResp(), SendOneBeacon(), and SendProbeResp().
|
private |
Return the Multi-Link Element that the current AP includes in the management frames of the given type it transmits on the given link.
linkId | the ID of the link to send the Multi-Link Element onto |
frameType | the type of the frame containing the Multi-Link Element |
to | the Receiver Address of the frame containing the Multi-Link Element |
Definition at line 699 of file ap-wifi-mac.cc.
References ns3::MultiLinkElement::AddPerStaProfileSubelement(), ns3::MultiLinkElement::BASIC_VARIANT, ns3::WifiMac::GetAddress(), GetAssocResp(), ns3::MultiLinkElement::GetCommonInfoBasic(), ns3::WifiMac::GetEhtConfiguration(), ns3::WifiMac::GetFrameExchangeManager(), ns3::WifiMac::GetNLinks(), ns3::MultiLinkElement::GetNPerStaProfileSubelements(), ns3::MultiLinkElement::GetPerStaProfile(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::CommonInfoBasicMle::m_mldCapabilities, NS_ABORT_IF, NS_ASSERT, NS_LOG_FUNCTION, ns3::MultiLinkElement::SetBssParamsChangeCount(), ns3::MultiLinkElement::SetEmlsrSupported(), ns3::MultiLinkElement::PerStaProfileSubelement::SetLinkId(), ns3::MultiLinkElement::SetLinkIdInfo(), ns3::CommonInfoBasicMle::SetMediumSyncDelayTimer(), ns3::MultiLinkElement::SetMldMacAddress(), ns3::MultiLinkElement::SetTransitionTimeout(), ns3::WIFI_MAC_MGT_ASSOCIATION_REQUEST, ns3::WIFI_MAC_MGT_ASSOCIATION_RESPONSE, ns3::WIFI_MAC_MGT_BEACON, ns3::WIFI_MAC_MGT_PROBE_RESPONSE, ns3::WIFI_MAC_MGT_REASSOCIATION_REQUEST, and ns3::WIFI_MAC_MGT_REASSOCIATION_RESPONSE.
Referenced by SendAssocResp(), SendOneBeacon(), and SendProbeResp().
|
private |
Definition at line 2484 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetLinks(), and NS_FATAL_ERROR.
Referenced by SetAid().
|
private |
Return the Reduced Neighbor Report (RNR) element that the current AP sends on the given link, if one needs to be advertised.
linkId | the ID of the link to send the RNR element onto |
Definition at line 668 of file ap-wifi-mac.cc.
References ns3::ReducedNeighborReport::AddNbrApInfoField(), ns3::ReducedNeighborReport::AddTbttInformationField(), ns3::WifiMac::LinkEntity::feManager, ns3::WifiMac::GetEhtSupported(), GetLink(), ns3::WifiMac::GetNLinks(), ns3::ReducedNeighborReport::GetNNbrApInfoFields(), ns3::WifiPhy::GetOperatingChannel(), NS_ABORT_IF, NS_LOG_FUNCTION, ns3::WifiMac::LinkEntity::phy, ns3::ReducedNeighborReport::SetBssid(), ns3::ReducedNeighborReport::SetBssParameters(), ns3::ReducedNeighborReport::SetMldParameters(), ns3::ReducedNeighborReport::SetOperatingChannel(), ns3::ReducedNeighborReport::SetPsd20MHz(), and ns3::ReducedNeighborReport::SetShortSsid().
Referenced by GetFilsDiscovery(), SendOneBeacon(), and SendProbeResp().
const std::map< uint16_t, Mac48Address > & ns3::ApWifiMac::GetStaList | ( | uint8_t | linkId | ) | const |
Get a const reference to the map of associated stations on the given link.
Each station is specified by an (association ID, MAC address) pair. Make sure not to use the returned reference after that this object has been deallocated.
linkId | the ID of the given link |
Definition at line 2503 of file ap-wifi-mac.cc.
References GetLink(), and ns3::ApWifiMac::ApLinkEntity::staList.
|
private |
Return an instance of SupportedRates that contains all rates that we support for the given link (including HT rates).
linkId | the ID of the given link |
Definition at line 469 of file ap-wifi-mac.cc.
References ns3::AllSupportedRates::AddBssMembershipSelectorRate(), ns3::AllSupportedRates::AddSupportedRate(), ns3::WifiPhy::GetBssMembershipSelectorList(), ns3::WifiPhy::GetChannelWidth(), ns3::WifiMode::GetDataRate(), ns3::WifiMac::GetHtSupported(), ns3::WifiPhy::GetModeList(), ns3::WifiMode::GetUniqueName(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::AllSupportedRates::SetBasicRate(), and ns3::WIFI_MOD_CLASS_HR_DSSS.
Referenced by GetAssocResp(), SendOneBeacon(), and SendProbeResp().
|
static |
Get a checker for the TxopLimitsForSta attribute, which can be used to deserialize an ACI-indexed map of access parameters of type Time (TxopLimit) from a string:
The type of map
is ApWifiMac::TimeAccessParamsMapValue::result_type, which is std::list<std::pair<AcIndex, std::vector<Time>>>.
Definition at line 197 of file ap-wifi-mac.cc.
References ns3::AC_BE, ns3::AC_BK, ns3::AC_VI, ns3::AC_VO, ns3::MakeAttributeContainerChecker(), ns3::MakeEnumChecker(), ns3::MakePairChecker(), and ns3::MakeTimeChecker().
Referenced by GetTypeId().
|
overridevirtual |
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 from ns3::WifiMac.
Definition at line 284 of file ap-wifi-mac.cc.
References ns3::AC_BEACON, ns3::WifiMac::GetTxopQueue(), ns3::Txop::GetWifiMacQueue(), and m_beaconTxop.
|
static |
Get the type ID.
Definition at line 48 of file ap-wifi-mac.cc.
References GetBeaconInterval(), GetTimeAccessParamsChecker(), GetUintAccessParamsChecker(), m_aifsnsForSta, m_assocLogger, m_beaconJitter, m_bsrLifetime, m_cwMaxsForSta, m_cwMinsForSta, m_deAssocLogger, m_enableBeaconJitter, m_enableNonErpProtection, m_fdBeaconInterval6GHz, m_fdBeaconIntervalNon6GHz, m_sendUnsolProbeResp, m_txopLimitsForSta, ns3::MakeAttributeContainerAccessor(), ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakePointerAccessor(), ns3::MakePointerChecker(), ns3::MakeTimeAccessor(), ns3::MakeTimeChecker(), ns3::MakeTraceSourceAccessor(), ns3::MicroSeconds(), ns3::MilliSeconds(), SetBeaconGeneration(), SetBeaconInterval(), and ns3::TypeId::SetParent().
|
static |
Get a checker for the CwMinsForSta, CwMaxsForSta and AifsnsForSta attributes, which can be used to deserialize an ACI-indexed map of access parameters of type unsigned integer (CWmin, CWmax and AIFSN) from a string:
The type of map
is ApWifiMac::UintAccessParamsMapValue::result_type, which is std::list<std::pair<AcIndex, std::vector<uint64_t>>>.
T | [explicit] the type of the unsigned integer access parameter |
Definition at line 186 of file ap-wifi-mac.cc.
References ns3::AC_BE, ns3::AC_BK, ns3::AC_VI, ns3::AC_VO, ns3::MakeAttributeContainerChecker(), ns3::MakeEnumChecker(), ns3::MakePairChecker(), and ns3::MakeUintegerChecker().
Referenced by GetTypeId().
|
private |
Return whether protection for non-ERP stations is used in the BSS corresponding to the given link.
linkId | the ID of the given link |
Definition at line 2476 of file ap-wifi-mac.cc.
References GetLink(), ns3::WifiMac::GetWifiRemoteStationManager(), m_enableNonErpProtection, and ns3::ApWifiMac::ApLinkEntity::numNonErpStations.
Referenced by GetErpInformation().
|
private |
Return the VHT operation of the current AP for the given link.
linkId | the ID of the given link |
Definition at line 894 of file ap-wifi-mac.cc.
References ns3::CW_80_PLUS_80MHZ, GetLink(), ns3::WifiMac::GetVhtSupported(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_ASSERT, NS_LOG_FUNCTION, ns3::VhtOperation::SetChannelCenterFrequencySegment0(), ns3::VhtOperation::SetChannelCenterFrequencySegment1(), ns3::VhtOperation::SetChannelWidth(), ns3::VhtOperation::SetMaxVhtMcsPerNss(), and ns3::ApWifiMac::ApLinkEntity::staList.
Referenced by GetAssocResp(), SendOneBeacon(), and SendProbeResp().
std::optional< uint8_t > ns3::ApWifiMac::IsAssociated | ( | const Mac48Address & | address | ) | const |
Get the ID of a link (if any) that has been setup with the station having the given MAC address.
The address can be either a link address or an MLD address. In the former case, the returned ID is the ID of the link connecting the AP to the STA with the given address.
address | the given MAC address |
Definition at line 1733 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetWifiRemoteStationManager(), and NS_LOG_DEBUG.
Referenced by CanForwardPacketsTo(), DeaggregateAmsduAndForward(), DoGetLocalAddress(), Enqueue(), Receive(), and StaSwitchingToActiveModeOrDeassociated().
|
private |
Given a (Re)Association Request frame body containing a Multi-Link Element, check if a link can be setup with each of the reported stations (STA MAC address and a (Re)Association Request frame body must be present, the Link ID identifies a valid link other than the one the frame was received on and the supported rates are compatible with our basic rate set).
assoc | the frame body of the received (Re)Association Request |
from | the Transmitter Address field of the frame |
linkId | the ID of the link on which the frame was received |
Definition at line 2241 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and ReceiveAssocRequest().
Referenced by Receive().
|
private |
Process the Power Management bit in the Frame Control field of an MPDU successfully received on the given link.
mpdu | the successfully received MPDU |
linkId | the ID of the given link |
Definition at line 1683 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetWifiRemoteStationManager(), NS_LOG_FUNCTION, StaSwitchingToActiveModeOrDeassociated(), and StaSwitchingToPsMode().
Referenced by Receive().
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 from ns3::WifiMac.
Definition at line 1766 of file ap-wifi-mac.cc.
References ns3::Create(), DeaggregateAmsduAndForward(), ns3::WifiMac::Enqueue(), ns3::WifiMac::ForwardUp(), ns3::WifiMacHeader::GetAddr1(), ns3::WifiMacHeader::GetAddr2(), ns3::WifiMacHeader::GetAddr3(), ns3::WifiMac::GetAddress(), ns3::WifiMac::GetDsssSupported(), ns3::WifiMac::GetFrameExchangeManager(), ns3::WifiMac::GetHtSupported(), GetLink(), ns3::WifiMac::GetNLinks(), ns3::WifiMacHeader::GetQosTid(), ns3::WifiMac::GetSsid(), ns3::WifiMacHeader::GetType(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::WifiMacHeader::HasData(), IsAssociated(), ns3::WifiMacHeader::IsAssocReq(), ns3::Mac48Address::IsBroadcast(), ns3::WifiMacHeader::IsData(), ns3::WifiMacHeader::IsFromDs(), ns3::Mac48Address::IsGroup(), ns3::WifiMacHeader::IsMgt(), ns3::WifiMacHeader::IsProbeReq(), ns3::WifiMacHeader::IsQosAmsdu(), ns3::WifiMacHeader::IsQosData(), ns3::WifiMacHeader::IsReassocReq(), ns3::WifiMacHeader::IsToDs(), m_deAssocLogger, ns3::WifiMac::NotifyRxDrop(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::ApWifiMac::ApLinkEntity::numNonErpStations, ns3::ApWifiMac::ApLinkEntity::numNonHtStations, ParseReportedStaInfo(), ProcessPowerManagementFlag(), ns3::WifiActionHeader::PROTECTED_EHT, ns3::WifiActionHeader::PROTECTED_EHT_EML_OPERATING_MODE_NOTIFICATION, ns3::WifiMac::Receive(), ReceiveAssocRequest(), ReceiveEmlOmn(), ns3::WifiActionHeader::Remove(), SendAssocResp(), SendProbeResp(), ns3::ApWifiMac::ApLinkEntity::staList, StaSwitchingToActiveModeOrDeassociated(), UpdateShortPreambleEnabled(), UpdateShortSlotTimeEnabled(), ns3::WIFI_MAC_MGT_ACTION, ns3::WIFI_MAC_MGT_ASSOCIATION_REQUEST, ns3::WIFI_MAC_MGT_DISASSOCIATION, and ns3::WIFI_MAC_MGT_REASSOCIATION_REQUEST.
|
private |
Check whether the supported rate set included in the received (Re)Association Request frame is compatible with our Basic Rate Set.
If so, record all the station's supported modes in its associated WifiRemoteStation and return true. Otherwise, return false.
assoc | the frame body of the received (Re)Association Request |
from | the Transmitter Address field of the frame |
linkId | the ID of the link on which the frame was received |
Definition at line 1966 of file ap-wifi-mac.cc.
References ns3::BOTH_DIRECTIONS, ns3::TidToLinkMapping::Control::defaultMapping, ns3::DOWNLINK, ns3::WifiMac::GetEhtConfiguration(), ns3::WifiMac::GetEhtSupported(), ns3::WifiMac::GetErpSupported(), ns3::WifiMac::GetHeSupported(), ns3::WifiMac::GetHtSupported(), ns3::TidToLinkMapping::GetLinkMappingOfTid(), ns3::WifiMode::GetMcsValue(), ns3::WifiMac::GetVhtSupported(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::WifiMac::Is6GhzBand(), ns3::CapabilityInformation::IsShortPreamble(), ns3::CapabilityInformation::IsShortSlotTime(), ns3::TidToLinkMapping::m_control, ns3::NOT_SUPPORTED, NS_ASSERT, NS_ASSERT_MSG, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::SAME_LINK_SET, ns3::TidToLinkMappingValidForNegType1(), ns3::WifiMac::UpdateTidToLinkMapping(), ns3::UPLINK, ns3::WIFI_MOD_CLASS_EHT, ns3::WIFI_MOD_CLASS_HE, and ns3::WIFI_MOD_CLASS_VHT.
Referenced by ParseReportedStaInfo(), and Receive().
|
private |
Take necessary actions upon receiving the given EML Operating Mode Notification frame from the given station on the given link.
frame | the received EML Operating Mode Notification frame |
sender | the MAC address of the sender of the frame |
linkId | the ID of the link over which the frame was received |
After the successful transmission of the EML Operating Mode Notification frame by the non-AP STA affiliated with the non-AP MLD, the non-AP MLD shall operate in the EMLSR mode and the other non-AP STAs operating on the corresponding EMLSR links shall transition to active mode after the transition delay indicated in the Transition Timeout subfield in the EML Capabilities subfield of the Basic Multi-Link element or immediately after receiving an EML Operating Mode Notification frame from one of the APs operating on the EMLSR links and affiliated with the AP MLD (Sec. 35.3.17 of 802.11be D3.0)
After the successful transmission of the EML Operating Mode Notification frame by the non-AP STA affiliated with the non-AP MLD, the non-AP MLD shall disable the EMLSR mode and the other non-AP STAs operating on the corresponding EMLSR links shall transition to power save mode after the transition delay indicated in the Transition Timeout subfield in the EML Capabilities subfield of the Basic Multi-Link element or immediately after receiving an EML Operating Mode Notification frame from one of the APs operating on the EMLSR links and affiliated with the AP MLD. (Sec. 35.3.17 of 802.11be D3.0)
Definition at line 2291 of file ap-wifi-mac.cc.
References ns3::WifiPhy::CalculateTxDuration(), ns3::MgtEmlOmn::EmlControl::emlsrMode, ns3::MgtEmlOmn::EmlControl::emlsrParamUpdateCtrl, ns3::WifiMac::GetEhtConfiguration(), GetLink(), ns3::MgtEmlOmn::GetLinkBitmap(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::MgtEmlOmn::m_emlControl, ns3::MgtEmlOmn::m_emlsrParamUpdate, m_transitionTimeoutEvents, NS_ASSERT, NS_ASSERT_MSG, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::Simulator::Schedule().
Referenced by Receive().
|
private |
Schedule the transmission of FILS Discovery frames or unsolicited Probe Response frames on the given link.
linkId | the ID of the given link |
Definition at line 1522 of file ap-wifi-mac.cc.
References ns3::Mac48Address::GetBroadcast(), GetFilsDiscovery(), GetLink(), m_beaconInterval, m_beaconTxop, m_fdBeaconInterval6GHz, m_fdBeaconIntervalNon6GHz, m_sendUnsolProbeResp, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::WifiMac::LinkEntity::phy, ns3::Txop::Queue(), ns3::Simulator::Schedule(), SendProbeResp(), and ns3::WIFI_PHY_BAND_6GHZ.
Referenced by SendOneBeacon().
|
private |
Forward an association or a reassociation response packet to the DCF/EDCA.
to | the address of the STA we are sending an association response to |
isReassoc | indicates whether it is a reassociation response |
linkId | the ID of the link on which the association response must be sent |
Definition at line 1318 of file ap-wifi-mac.cc.
References ns3::Create(), GetAssocResp(), ns3::WifiMac::GetBEQueue(), ns3::WifiMac::GetFrameExchangeManager(), GetLinkIdStaAddrMap(), ns3::WifiMac::GetMldAddress(), GetMultiLinkElement(), ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetQosSupported(), ns3::WifiMac::GetTxop(), ns3::WifiMacHeader::GetType(), ns3::WifiMac::GetVOQueue(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_LOG_FUNCTION, ns3::Txop::Queue(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetAddr2(), ns3::WifiMacHeader::SetAddr3(), SetAid(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::WifiMacHeader::SetType(), ns3::WIFI_MAC_MGT_ASSOCIATION_RESPONSE, and ns3::WIFI_MAC_MGT_REASSOCIATION_RESPONSE.
Referenced by Receive().
|
private |
Forward a beacon packet to the beacon special DCF for transmission on the given link.
linkId | the ID of the given link |
Definition at line 1371 of file ap-wifi-mac.cc.
References ns3::MgtProbeResponseHeader::Capabilities(), ns3::Create(), GetBeaconInterval(), ns3::Mac48Address::GetBroadcast(), GetCapabilities(), GetDsssParameterSet(), ns3::WifiMac::GetDsssSupported(), GetEdcaParameterSet(), ns3::WifiMac::GetEhtCapabilities(), GetEhtOperation(), ns3::WifiMac::GetEhtSupported(), GetErpInformation(), ns3::WifiMac::GetErpSupported(), ns3::WifiMac::GetExtendedCapabilities(), ns3::WifiMac::GetHe6GhzBandCapabilities(), ns3::WifiMac::GetHeCapabilities(), GetHeOperation(), ns3::WifiMac::GetHeSupported(), ns3::WifiMac::GetHtCapabilities(), GetHtOperation(), ns3::WifiMac::GetHtSupported(), GetLink(), GetMuEdcaParameterSet(), GetMultiLinkElement(), ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetQosSupported(), GetReducedNeighborReport(), ns3::WifiMac::GetSsid(), GetSupportedRates(), ns3::WifiMac::GetVhtCapabilities(), GetVhtOperation(), ns3::WifiMac::GetVhtSupported(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::WifiMac::Is6GhzBand(), m_beaconTxop, ns3::MicroSeconds(), NS_LOG_FUNCTION, NS_LOG_INFO, ns3::Txop::Queue(), ns3::Simulator::Schedule(), ScheduleFilsDiscOrUnsolProbeRespFrames(), SendOneBeacon(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetAddr2(), ns3::WifiMacHeader::SetAddr3(), ns3::MgtProbeResponseHeader::SetBeaconIntervalUs(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::WifiPhy::SetSlot(), ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_MGT_BEACON.
Referenced by DoInitialize(), SendOneBeacon(), and SetBeaconGeneration().
|
private |
Send a Probe Response in response to a Probe Request received from the STA with the given address on the given link.
to | the address of the STA we are sending a probe response to |
linkId | the ID of the given link |
Definition at line 1018 of file ap-wifi-mac.cc.
References ns3::MgtProbeResponseHeader::Capabilities(), ns3::Create(), GetBeaconInterval(), ns3::WifiMac::GetBEQueue(), GetCapabilities(), GetDsssParameterSet(), ns3::WifiMac::GetDsssSupported(), GetEdcaParameterSet(), ns3::WifiMac::GetEhtCapabilities(), GetEhtOperation(), ns3::WifiMac::GetEhtSupported(), GetErpInformation(), ns3::WifiMac::GetErpSupported(), ns3::WifiMac::GetExtendedCapabilities(), ns3::WifiMac::GetHe6GhzBandCapabilities(), ns3::WifiMac::GetHeCapabilities(), GetHeOperation(), ns3::WifiMac::GetHeSupported(), ns3::WifiMac::GetHtCapabilities(), GetHtOperation(), ns3::WifiMac::GetHtSupported(), GetLink(), GetMuEdcaParameterSet(), GetMultiLinkElement(), ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetQosSupported(), GetReducedNeighborReport(), ns3::WifiMac::GetSsid(), GetSupportedRates(), ns3::WifiMac::GetTxop(), ns3::WifiMac::GetVhtCapabilities(), GetVhtOperation(), ns3::WifiMac::GetVhtSupported(), ns3::WifiMac::GetVOQueue(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::WifiMac::Is6GhzBand(), NS_LOG_FUNCTION, ns3::Txop::Queue(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetAddr2(), ns3::WifiMacHeader::SetAddr3(), ns3::MgtProbeResponseHeader::SetBeaconIntervalUs(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_MGT_PROBE_RESPONSE.
Referenced by Receive(), and ScheduleFilsDiscOrUnsolProbeRespFrames().
|
private |
Set the AID field of the given Association Response frame.
In case of multi-link setup, the selected AID value must be assigned to all the STAs corresponding to the setup links. The AID value is selected among the AID values that are possibly already assigned to the STAs affiliated with the non-AP MLD we are associating with. If no STA has an assigned AID value, a new AID value is selected.
assoc | the given Association Response frame |
linkIdStaAddrMap | a map of (link ID, remote STA address) of the links to setup |
Definition at line 1232 of file ap-wifi-mac.cc.
References GetLink(), ns3::WifiMac::GetLinks(), GetNextAssociationId(), ns3::MgtAssocResponseHeader::GetStatusCode(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::StatusCode::IsSuccess(), m_aidToMldOrLinkAddress, NS_ABORT_MSG_IF, ns3::MgtAssocResponseHeader::SetAssociationId(), ns3::SU_STA_ID, UpdateShortPreambleEnabled(), and UpdateShortSlotTimeEnabled().
Referenced by SendAssocResp().
void ns3::ApWifiMac::SetApEmlsrManager | ( | Ptr< ApEmlsrManager > | apEmlsrManager | ) |
Set the AP EMLSR Manager.
apEmlsrManager | the AP EMLSR Manager |
Definition at line 255 of file ap-wifi-mac.cc.
References m_apEmlsrManager, and NS_LOG_FUNCTION.
|
private |
Enable or disable beacon generation of the AP.
enable | enable or disable beacon generation |
Definition at line 294 of file ap-wifi-mac.cc.
References ns3::ApWifiMac::ApLinkEntity::beaconEvent, ns3::EventId::Cancel(), GetLink(), ns3::WifiMac::GetNLinks(), m_enableBeaconGeneration, NS_LOG_FUNCTION, ns3::Simulator::ScheduleNow(), and SendOneBeacon().
Referenced by GetTypeId().
void ns3::ApWifiMac::SetBeaconInterval | ( | Time | interval | ) |
interval | the interval between two beacon transmissions. |
Definition at line 332 of file ap-wifi-mac.cc.
References ns3::Time::GetMicroSeconds(), m_beaconInterval, NS_FATAL_ERROR, and NS_LOG_FUNCTION.
Referenced by WifiPrimaryChannelsTest::DoRun(), and GetTypeId().
void ns3::ApWifiMac::SetBufferStatus | ( | uint8_t | tid, |
Mac48Address | address, | ||
uint8_t | size ) |
Store the value of the Queue Size subfield of the last QoS Data or QoS Null frame received from the station with the given MAC address and belonging to the given TID.
tid | the given TID |
address | the given MAC address |
size | the value of the Queue Size subfield |
Definition at line 2526 of file ap-wifi-mac.cc.
References m_bufferStatus, and ns3::Simulator::Now().
|
overridevirtual |
linkUp | the callback to invoke when the link becomes up. |
Reimplemented from ns3::WifiMac.
Definition at line 320 of file ap-wifi-mac.cc.
References NS_LOG_FUNCTION, and ns3::WifiMac::SetLinkUpCallback().
|
private |
Perform the necessary actions when a given station deassociates or switches from powersave mode to active mode.
staAddr | the MAC address of the given station |
linkId | the ID of the link on which the given station is operating |
Definition at line 1716 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetWifiRemoteStationManager(), IsAssociated(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::POWER_SAVE_MODE, and ns3::WifiMac::UnblockUnicastTxOnLinks().
Referenced by ProcessPowerManagementFlag(), and Receive().
|
private |
Perform the necessary actions when a given station switches from active mode to powersave mode.
staAddr | the MAC address of the given station |
linkId | the ID of the link on which the given station is operating |
Definition at line 1703 of file ap-wifi-mac.cc.
References ns3::WifiMac::BlockUnicastTxOnLinks(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::POWER_SAVE_MODE.
Referenced by ProcessPowerManagementFlag(), and TxOk().
|
overridevirtual |
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 from ns3::WifiMac.
Definition at line 462 of file ap-wifi-mac.cc.
References NS_LOG_FUNCTION.
|
private |
The packet we sent was successfully received by the receiver (i.e.
we did not receive an Ack from the receiver). If the packet was an association response to the receiver, we record that the receiver is not associated with us yet.
timeoutReason | the reason why the TX timer was started ( |
mpdu | the MPDU that we failed to sent |
Definition at line 1633 of file ap-wifi-mac.cc.
References ns3::WifiMacHeader::GetAddr1(), ns3::WifiMacHeader::GetAddr2(), ns3::WifiMac::GetAddress(), ns3::MgtAssocResponseHeader::GetAssociationId(), ns3::WifiMac::GetFrameExchangeManager(), GetLink(), ns3::WifiMac::GetLinkIdByAddress(), ns3::WifiMac::GetLinks(), ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::WifiMacHeader::IsAssocResp(), ns3::WifiMacHeader::IsReassocResp(), m_aidToMldOrLinkAddress, NS_ABORT_MSG_IF, NS_LOG_DEBUG, and NS_LOG_FUNCTION.
Referenced by DoInitialize().
The packet we sent was successfully received by the receiver (i.e.
we received an Ack from the receiver). If the packet was an association response to the receiver, we record that the receiver is now associated with us.
mpdu | the MPDU that we successfully sent |
The STA is affiliated with an MLD. From Sec. 35.3.7.1.4 of 802.11be D3.0: When a link becomes enabled for a non-AP STA that is affiliated with a non-AP MLD after successful association with an AP MLD with (Re)Association Request/Response frames transmitted on another link [...], the power management mode of the non-AP STA, immediately after the acknowledgement of the (Re)Association Response frame [...], is power save mode, and its power state is doze.
Thus, STAs operating on all the links but the link used to establish association transition to power save mode.
Definition at line 1556 of file ap-wifi-mac.cc.
References ns3::WifiMac::ApplyTidLinkMapping(), ns3::DOWNLINK, ns3::WifiMacHeader::GetAddr1(), ns3::WifiMacHeader::GetAddr2(), ns3::WifiMac::GetAddress(), ns3::MgtAssocResponseHeader::GetAssociationId(), ns3::WifiMac::GetFrameExchangeManager(), ns3::WifiMac::GetLinkIdByAddress(), ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::WifiMacHeader::IsAction(), ns3::WifiMacHeader::IsAssocResp(), ns3::WifiMacHeader::IsReassocResp(), m_assocLogger, m_transitionTimeoutEvents, NS_ABORT_MSG_IF, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::WifiActionHeader::Peek(), ns3::WifiActionHeader::PROTECTED_EHT, ns3::WifiActionHeader::PROTECTED_EHT_EML_OPERATING_MODE_NOTIFICATION, and StaSwitchingToPsMode().
Referenced by DoInitialize().
|
private |
Update whether short preamble should be enabled or not in the BSS corresponding to the given link.
Typically, short preamble is enabled only when the AP and all associated stations support short PHY preamble. Otherwise, it is disabled.
linkId | the ID of the given link |
Definition at line 383 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetErpSupported(), GetLink(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), and NS_LOG_FUNCTION.
Referenced by DoInitialize(), Receive(), and SetAid().
|
private |
Update whether short slot time should be enabled or not in the BSS corresponding to the given link.
Typically, short slot time is enabled only when there is no non-ERP station associated to the AP, and that short slot time is supported by the AP and by all other ERP stations that are associated to the AP. Otherwise, it is disabled.
linkId | the ID of the given link |
Definition at line 360 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetErpSupported(), GetLink(), ns3::WifiMac::GetShortSlotTimeSupported(), ns3::WifiMac::GetWifiRemoteStationManager(), and NS_LOG_FUNCTION.
Referenced by DoInitialize(), Receive(), and SetAid().
|
protected |
Maps AIDs to MLD addresses (for MLDs) or link addresses (in case of single link devices)
Definition at line 261 of file ap-wifi-mac.h.
Referenced by GetMldOrLinkAddressByAid(), SetAid(), and TxFailed().
|
private |
Per-AC AIFS values to advertise to stations.
Definition at line 589 of file ap-wifi-mac.h.
Referenced by GetEdcaParameterSet(), and GetTypeId().
|
private |
AP EMLSR Manager.
Definition at line 585 of file ap-wifi-mac.h.
Referenced by DoDispose(), GetApEmlsrManager(), and SetApEmlsrManager().
|
private |
association logger
Definition at line 616 of file ap-wifi-mac.h.
Referenced by GetTypeId(), and TxOk().
|
private |
Beacon interval.
Definition at line 576 of file ap-wifi-mac.h.
Referenced by GetBeaconInterval(), GetFilsDiscovery(), ScheduleFilsDiscOrUnsolProbeRespFrames(), and SetBeaconInterval().
|
private |
UniformRandomVariable used to randomize the time of the first beacon.
Definition at line 578 of file ap-wifi-mac.h.
Referenced by AssignStreams(), DoInitialize(), and GetTypeId().
Dedicated Txop for beacons.
Definition at line 574 of file ap-wifi-mac.h.
Referenced by ApWifiMac(), AssignStreams(), DoCompleteConfig(), DoDispose(), DoInitialize(), GetTxopQueue(), ScheduleFilsDiscOrUnsolProbeRespFrames(), and SendOneBeacon().
|
private |
Lifetime of Buffer Status Reports.
Definition at line 582 of file ap-wifi-mac.h.
Referenced by GetBufferStatus(), and GetTypeId().
|
private |
Per (MAC address, TID) buffer status reports.
Definition at line 606 of file ap-wifi-mac.h.
Referenced by GetBufferStatus(), and SetBufferStatus().
|
private |
Per-AC CW max values to advertise to stations.
Definition at line 588 of file ap-wifi-mac.h.
Referenced by GetEdcaParameterSet(), and GetTypeId().
|
private |
Per-AC CW min values to advertise to stations.
Definition at line 587 of file ap-wifi-mac.h.
Referenced by GetEdcaParameterSet(), and GetTypeId().
|
private |
deassociation logger
Definition at line 617 of file ap-wifi-mac.h.
Referenced by GetTypeId(), and Receive().
|
private |
Flag whether beacons are being generated.
Definition at line 575 of file ap-wifi-mac.h.
Referenced by DoDispose(), DoInitialize(), and SetBeaconGeneration().
|
private |
Flag whether the first beacon should be generated at random time.
Definition at line 579 of file ap-wifi-mac.h.
Referenced by DoInitialize(), and GetTypeId().
|
private |
Flag whether protection mechanism is used or not when non-ERP STAs are present within the BSS.
Definition at line 580 of file ap-wifi-mac.h.
Referenced by GetTypeId(), and GetUseNonErpProtection().
|
private |
Time elapsing between a beacon and FILS Discovery (FD) frame or between two FD frames on 6GHz links.
Definition at line 592 of file ap-wifi-mac.h.
Referenced by GetTypeId(), and ScheduleFilsDiscOrUnsolProbeRespFrames().
|
private |
Time elapsing between a beacon and FILS Discovery (FD) frame or between two FD frames on 2.4GHz and 5GHz links.
Definition at line 594 of file ap-wifi-mac.h.
Referenced by GetTypeId(), and ScheduleFilsDiscOrUnsolProbeRespFrames().
|
private |
send unsolicited Probe Response instead of FILS Discovery
Definition at line 596 of file ap-wifi-mac.h.
Referenced by GetTypeId(), and ScheduleFilsDiscOrUnsolProbeRespFrames().
|
private |
transition timeout events running for EMLSR clients
Definition at line 584 of file ap-wifi-mac.h.
Referenced by ReceiveEmlOmn(), and TxOk().
|
private |
Per-AC TXOP limits values to advertise to stations.
Definition at line 590 of file ap-wifi-mac.h.
Referenced by GetEdcaParameterSet(), and GetTypeId().