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 Member Functions | |
ApWifiMac () | |
~ApWifiMac () override | |
int64_t | AssignStreams (int64_t stream) |
Assign a fixed random variable stream number to the random variables used by this model. More... | |
bool | CanForwardPacketsTo (Mac48Address to) const override |
Return true if packets can be forwarded to the given destination, false otherwise. More... | |
void | ConfigureStandard (WifiStandard standard) override |
void | Enqueue (Ptr< Packet > packet, Mac48Address to) override |
void | Enqueue (Ptr< Packet > packet, Mac48Address to, Mac48Address from) override |
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. More... | |
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. More... | |
const std::map< uint16_t, Mac48Address > & | GetStaList (uint8_t linkId=SINGLE_LINK_OP_ID) const |
Get a const reference to the map of associated stations on the given link. More... | |
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. More... | |
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. More... | |
void | SetLinkUpCallback (Callback< void > linkUp) override |
bool | SupportsSendFrom () const override |
![]() | |
WifiMac () | |
WifiMac (const WifiMac &)=delete | |
~WifiMac () override | |
virtual bool | CanForwardPacketsTo (Mac48Address to) const =0 |
Return true if packets can be forwarded to the given destination, false otherwise. More... | |
virtual void | ConfigureStandard (WifiStandard standard) |
virtual void | Enqueue (Ptr< Packet > packet, Mac48Address to)=0 |
virtual void | Enqueue (Ptr< Packet > packet, Mac48Address to, Mac48Address from) |
Mac48Address | GetAddress () 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. More... | |
Ptr< WifiNetDevice > | GetDevice () const |
Return the device this PHY is associated with. More... | |
bool | GetDsssSupported (uint8_t linkId) const |
Return whether the device supports DSSS on the given link. More... | |
EhtCapabilities | GetEhtCapabilities (uint8_t linkId) const |
Return the EHT capabilities of the device for the given link. More... | |
Ptr< EhtConfiguration > | GetEhtConfiguration () const |
bool | GetEhtSupported () const |
Return whether the device supports EHT. More... | |
bool | GetErpSupported (uint8_t linkId) const |
Return whether the device supports ERP on the given link. More... | |
ExtendedCapabilities | GetExtendedCapabilities () const |
Return the extended capabilities of the device. More... | |
Ptr< FrameExchangeManager > | GetFrameExchangeManager (uint8_t linkId=SINGLE_LINK_OP_ID) const |
Get the Frame Exchange Manager associated with the given link. More... | |
HeCapabilities | GetHeCapabilities (uint8_t linkId) const |
Return the HE capabilities of the device for the given link. More... | |
Ptr< HeConfiguration > | GetHeConfiguration () const |
bool | GetHeSupported () const |
Return whether the device supports HE. More... | |
HtCapabilities | GetHtCapabilities (uint8_t linkId) const |
Return the HT capabilities of the device for the given link. More... | |
Ptr< HtConfiguration > | GetHtConfiguration () const |
bool | GetHtSupported () const |
Return whether the device supports HT. More... | |
virtual std::optional< uint8_t > | GetLinkIdByAddress (const Mac48Address &address) const |
Get the ID of the link having the given MAC address, if any. More... | |
Ptr< WifiMacQueueScheduler > | GetMacQueueScheduler () const |
Get the wifi MAC queue scheduler. More... | |
uint32_t | GetMaxAmpduSize (AcIndex ac) const |
Return the maximum A-MPDU size of the given Access Category. More... | |
uint16_t | GetMaxAmsduSize (AcIndex ac) const |
Return the maximum A-MSDU size of the given Access Category. More... | |
uint8_t | GetNLinks () const |
Get the number of links (can be greater than 1 for 11be devices only). More... | |
bool | GetQosSupported () const |
Return whether the device supports QoS. More... | |
Ptr< QosTxop > | GetQosTxop (AcIndex ac) const |
Accessor for a specified EDCA object. More... | |
Ptr< QosTxop > | GetQosTxop (uint8_t tid) const |
Accessor for a specified EDCA object. More... | |
Ssid | GetSsid () const |
Ptr< Txop > | GetTxop () const |
Accessor for the Txop object. More... | |
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. More... | |
TypeOfStation | GetTypeOfStation () const |
Return the type of station. More... | |
VhtCapabilities | GetVhtCapabilities (uint8_t linkId) const |
Return the VHT capabilities of the device for the given link. More... | |
Ptr< VhtConfiguration > | GetVhtConfiguration () const |
bool | GetVhtSupported (uint8_t linkId) const |
Return whether the device supports VHT on the given link. More... | |
Ptr< WifiPhy > | GetWifiPhy (uint8_t linkId=SINGLE_LINK_OP_ID) const |
Ptr< WifiRemoteStationManager > | GetWifiRemoteStationManager (uint8_t linkId=0) const |
virtual void | NotifyChannelSwitching (uint8_t linkId) |
Notify that channel on the given link has been switched. More... | |
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. More... | |
virtual void | SetAddress (Mac48Address address) |
void | SetBssid (Mac48Address bssid, uint8_t linkId) |
void | SetCtsToSelfSupported (bool enable) |
Enable or disable CTS-to-self feature. More... | |
void | SetDevice (const Ptr< WifiNetDevice > device) |
Sets the device this PHY is associated with. More... | |
void | SetForwardUpCallback (ForwardUpCallback upCallback) |
void | SetLinkDownCallback (Callback< void > linkDown) |
virtual void | SetLinkUpCallback (Callback< void > linkUp) |
virtual void | SetMacQueueScheduler (Ptr< WifiMacQueueScheduler > scheduler) |
Set the wifi MAC queue scheduler. More... | |
void | SetPromisc () |
Sets the interface in promiscuous mode. More... | |
void | SetSsid (Ssid ssid) |
void | SetTypeOfStation (TypeOfStation type) |
This method is invoked by a subclass to specify what type of station it is implementing. More... | |
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 |
![]() | |
Object () | |
Constructor. More... | |
~Object () override | |
Destructor. More... | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. More... | |
void | Dispose () |
Dispose of this Object. More... | |
AggregateIterator | GetAggregateIterator () const |
Get an iterator to the Objects aggregated to this one. More... | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. More... | |
template<typename T > | |
Ptr< T > | GetObject () const |
Get a pointer to the requested aggregated Object. More... | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. More... | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. More... | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. More... | |
void | Initialize () |
Invoke DoInitialize on all Objects aggregated to this one. More... | |
bool | IsInitialized () const |
Check if the object has been initialized. More... | |
![]() | |
SimpleRefCount () | |
Default constructor. More... | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. More... | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. More... | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment operator. More... | |
void | Ref () const |
Increment the reference count. More... | |
void | Unref () const |
Decrement the reference count. More... | |
![]() | |
virtual | ~ObjectBase () |
Virtual destructor. More... | |
void | GetAttribute (std::string name, AttributeValue &value) const |
Get the value of an attribute, raising fatal errors if unsuccessful. More... | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising erros. More... | |
virtual TypeId | GetInstanceTypeId () const =0 |
Get the most derived TypeId for this Object. More... | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. More... | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. More... | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. More... | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. More... | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. More... | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. More... | |
Static Public Member Functions | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
![]() | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
![]() | |
static TypeId | GetTypeId () |
Register this type. More... | |
![]() | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
Protected Member Functions | |
ApLinkEntity & | GetLink (uint8_t linkId) const |
Get a reference to the link associated with the given ID. More... | |
![]() | |
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. More... | |
void | DoDispose () override |
Destructor implementation. More... | |
void | DoInitialize () override |
Initialize() implementation. More... | |
void | ForwardUp (Ptr< const Packet > packet, Mac48Address from, Mac48Address to) |
Forward the packet up to the device. More... | |
Ptr< QosTxop > | GetBEQueue () const |
Accessor for the AC_BE channel access function. More... | |
Ptr< QosTxop > | GetBKQueue () const |
Accessor for the AC_BK channel access function. More... | |
LinkEntity & | GetLink (uint8_t linkId) const |
Get a reference to the link associated with the given ID. More... | |
bool | GetShortSlotTimeSupported () const |
Ptr< QosTxop > | GetVIQueue () const |
Accessor for the AC_VI channel access function. More... | |
Ptr< QosTxop > | GetVOQueue () const |
Accessor for the AC_VO channel access function. More... | |
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. More... | |
void | SetQosSupported (bool enable) |
Enable or disable QoS support for the device. More... | |
void | SetShortSlotTimeSupported (bool enable) |
Enable or disable short slot time feature. More... | |
![]() | |
Object (const Object &o) | |
Copy an Object. More... | |
virtual void | DoDispose () |
Destructor implementation. More... | |
virtual void | DoInitialize () |
Initialize() implementation. More... | |
virtual void | NotifyNewAggregate () |
Notify all Objects aggregated to this one of a new Object being aggregated. More... | |
![]() | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. More... | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. More... | |
Private Types | |
typedef void(* | AssociationCallback) (uint16_t aid, Mac48Address address) |
TracedCallback signature for association/deassociation events. More... | |
Private Member Functions | |
std::unique_ptr< LinkEntity > | CreateLinkEntity () const override |
Create a LinkEntity object. More... | |
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. More... | |
void | DoDispose () override |
Destructor implementation. More... | |
void | DoInitialize () override |
Initialize() implementation. More... | |
void | ForwardDown (Ptr< Packet > packet, Mac48Address from, Mac48Address to) |
Forward the packet down to DCF/EDCAF (enqueue the packet). More... | |
void | ForwardDown (Ptr< Packet > packet, Mac48Address from, Mac48Address to, uint8_t tid) |
Forward the packet down to DCF/EDCAF (enqueue the packet). More... | |
MgtAssocResponseHeader | GetAssocResp (Mac48Address to, uint8_t linkId) |
Get the Association Response frame to send on a given link. More... | |
CapabilityInformation | GetCapabilities (uint8_t linkId) const |
Return the Capability information of the current AP for the given link. More... | |
DsssParameterSet | GetDsssParameterSet (uint8_t linkId) const |
Return the DSSS Parameter Set that we support on the given link. More... | |
EdcaParameterSet | GetEdcaParameterSet (uint8_t linkId) const |
Return the EDCA Parameter Set of the current AP for the given link. More... | |
ErpInformation | GetErpInformation (uint8_t linkId) const |
Return the ERP information of the current AP for the given link. More... | |
HeOperation | GetHeOperation (uint8_t linkId) const |
Return the HE operation of the current AP for the given link. More... | |
HtOperation | GetHtOperation (uint8_t linkId) const |
Return the HT operation of the current AP for the given link. More... | |
std::optional< MuEdcaParameterSet > | GetMuEdcaParameterSet () const |
Return the MU EDCA Parameter Set of the current AP, if one needs to be advertised. More... | |
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. More... | |
uint16_t | GetNextAssociationId (std::list< uint8_t > linkIds) |
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. More... | |
SupportedRates | GetSupportedRates (uint8_t linkId) const |
Return an instance of SupportedRates that contains all rates that we support for the given link (including HT rates). More... | |
bool | GetUseNonErpProtection (uint8_t linkId) const |
Return whether protection for non-ERP stations is used in the BSS corresponding to the given link. More... | |
VhtOperation | GetVhtOperation (uint8_t linkId) const |
Return the VHT operation of the current AP for the given link. More... | |
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). More... | |
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. More... | |
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. More... | |
void | SendAssocResp (Mac48Address to, bool isReassoc, uint8_t linkId) |
Forward an association or a reassociation response packet to the DCF/EDCA. More... | |
void | SendOneBeacon (uint8_t linkId) |
Forward a beacon packet to the beacon special DCF for transmission on the given link. More... | |
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. More... | |
void | SetAid (MgtAssocResponseHeader &assoc, const Mac48Address &to, uint8_t linkId) |
Set the AID field of the given Association Response frame, which is going to be sent to the STA with the given address on the given link. More... | |
void | SetBeaconGeneration (bool enable) |
Enable or disable beacon generation of the AP. More... | |
void | TxFailed (WifiMacDropReason timeoutReason, Ptr< const WifiMpdu > mpdu) |
The packet we sent was successfully received by the receiver (i.e. More... | |
void | TxOk (Ptr< const WifiMpdu > mpdu) |
The packet we sent was successfully received by the receiver (i.e. More... | |
void | UpdateShortPreambleEnabled (uint8_t linkId) |
Update whether short preamble should be enabled or not in the BSS corresponding to the given link. More... | |
void | UpdateShortSlotTimeEnabled (uint8_t linkId) |
Update whether short slot time should be enabled or not in the BSS corresponding to the given link. More... | |
Private Attributes | |
TracedCallback< uint16_t, Mac48Address > | m_assocLogger |
association logger More... | |
Time | m_beaconInterval |
Beacon interval. More... | |
Ptr< UniformRandomVariable > | m_beaconJitter |
UniformRandomVariable used to randomize the time of the first beacon. More... | |
Ptr< Txop > | m_beaconTxop |
Dedicated Txop for beacons. More... | |
Time | m_bsrLifetime |
Lifetime of Buffer Status Reports. More... | |
std::unordered_map< WifiAddressTidPair, bsrType, WifiAddressTidHash > | m_bufferStatus |
Per (MAC address, TID) buffer status reports. More... | |
TracedCallback< uint16_t, Mac48Address > | m_deAssocLogger |
deassociation logger More... | |
bool | m_enableBeaconGeneration |
Flag whether beacons are being generated. More... | |
bool | m_enableBeaconJitter |
Flag whether the first beacon should be generated at random time. More... | |
bool | m_enableNonErpProtection |
Flag whether protection mechanism is used or not when non-ERP STAs are present within the BSS. More... | |
Additional Inherited Members | |
![]() | |
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. More... | |
![]() | |
Callback< void > | m_linkDown |
Callback when a link is down. More... | |
Callback< void > | m_linkUp |
Callback when a link is up. More... | |
Ptr< MacRxMiddle > | m_rxMiddle |
RX middle (defragmentation etc.) More... | |
Ptr< WifiMacQueueScheduler > | m_scheduler |
wifi MAC queue scheduler More... | |
Ptr< MacTxMiddle > | m_txMiddle |
TX middle (aggregation etc.) More... | |
Ptr< Txop > | m_txop |
TXOP used for transmission of frames to non-QoS peers. More... | |
![]() | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More... | |
Wi-Fi AP state machine.
Handle association, dis-association and authentication, of STAs within an infrastructure BSS.
ns3::ApWifiMac is accessible through the following paths with Config::Set and Config::Connect:
Time
+9.22337e+18ns:+9.22337e+18ns Time
+9.22337e+18ns:+9.22337e+18ns Size of this type is 600 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 466 of file ap-wifi-mac.h.
ns3::ApWifiMac::ApWifiMac | ( | ) |
Definition at line 108 of file ap-wifi-mac.cc.
References ns3::AC_BEACON, ns3::AP, m_beaconTxop, ns3::WifiMac::m_txMiddle, NS_LOG_FUNCTION, ns3::Txop::SetTxMiddle(), and ns3::WifiMac::SetTypeOfStation().
|
override |
Definition at line 119 of file ap-wifi-mac.cc.
References NS_LOG_FUNCTION.
int64_t ns3::ApWifiMac::AssignStreams | ( | int64_t | stream | ) |
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 |
Definition at line 233 of file ap-wifi-mac.cc.
References m_beaconJitter, NS_LOG_FUNCTION, and ns3::RandomVariableStream::SetStream().
|
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 363 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetWifiRemoteStationManager(), and ns3::Mac48Address::IsGroup().
Referenced by Enqueue().
|
overridevirtual |
standard | the wifi standard to be configured |
This method completes the configuration process for a requested PHY standard by creating the Frame Exchange Manager and the Channel Access Manager and configuring the PHY dependent parameters. This method can only be called after a configured PHY has been set.
Reimplemented from ns3::WifiMac.
Definition at line 153 of file ap-wifi-mac.cc.
References ns3::ChannelAccessManager::Add(), ns3::WifiMac::LinkEntity::channelAccessManager, ns3::WifiMac::ConfigureStandard(), GetLink(), ns3::WifiMac::GetNLinks(), m_beaconTxop, NS_LOG_FUNCTION, ns3::Txop::SetAifsns(), ns3::Txop::SetMaxCws(), ns3::Txop::SetMinCws(), and ns3::Txop::SetWifiMac().
|
overrideprivatevirtual |
Create a LinkEntity object.
Reimplemented from ns3::WifiMac.
Definition at line 141 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 1785 of file ap-wifi-mac.cc.
References ForwardDown(), ns3::WifiMac::ForwardUp(), ns3::WifiMac::GetAddress(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::PeekPointer().
Referenced by Receive().
|
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 125 of file ap-wifi-mac.cc.
References ns3::Object::Dispose(), ns3::WifiMac::DoDispose(), m_beaconTxop, m_enableBeaconGeneration, and NS_LOG_FUNCTION.
|
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 1805 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::UniformRandomVariable::GetValue(), 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().
|
overridevirtual |
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 function determines that access it granted to this MAC.
Implements ns3::WifiMac.
Definition at line 383 of file ap-wifi-mac.cc.
References Enqueue(), ns3::WifiMac::GetAddress(), and NS_LOG_FUNCTION.
Referenced by Enqueue().
|
overridevirtual |
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 function determines that access it 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.
Reimplemented from ns3::WifiMac.
Definition at line 369 of file ap-wifi-mac.cc.
References CanForwardPacketsTo(), ForwardDown(), ns3::WifiMac::NotifyTxDrop(), and NS_LOG_FUNCTION.
|
private |
Forward the packet down to DCF/EDCAF (enqueue the packet).
This method is a wrapper for ForwardDown with traffic id.
packet | the packet we are forwarding to DCF/EDCAF |
from | the address to be used for Address 3 field in the header |
to | the address to be used for Address 1 field in the header |
Definition at line 288 of file ap-wifi-mac.cc.
References ForwardDown(), ns3::WifiMac::GetQosSupported(), NS_LOG_FUNCTION, and ns3::QosUtilsGetTidForPacket().
Referenced by DeaggregateAmsduAndForward(), Enqueue(), ForwardDown(), and Receive().
|
private |
Forward the packet down to DCF/EDCAF (enqueue the packet).
packet | the packet we are forwarding to DCF/EDCAF |
from | the address to be used for Address 3 field in the header |
to | the address to be used for Address 1 field in the header |
tid | the traffic id for the packet |
Definition at line 313 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetAddress(), ns3::WifiMac::GetQosSupported(), ns3::WifiMac::GetQosTxop(), ns3::WifiMac::GetTxop(), ns3::WifiMacHeader::NORMAL_ACK, NS_ASSERT, NS_LOG_FUNCTION, ns3::Txop::Queue(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetAddr2(), ns3::WifiMacHeader::SetAddr3(), ns3::WifiMacHeader::SetDsFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::WifiMacHeader::SetNoOrder(), ns3::WifiMacHeader::SetQosAckPolicy(), ns3::WifiMacHeader::SetQosNoAmsdu(), ns3::WifiMacHeader::SetQosNoEosp(), ns3::WifiMacHeader::SetQosTid(), ns3::WifiMacHeader::SetQosTxopLimit(), ns3::WifiMacHeader::SetType(), ns3::WIFI_MAC_DATA, and ns3::WIFI_MAC_QOSDATA.
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 1870 of file ap-wifi-mac.cc.
References ns3::WifiRemoteStationManager::GetAssociationId(), and ns3::WifiMac::GetWifiRemoteStationManager().
Referenced by MultiLinkSetupTest::CheckMlSetup(), ns3::WifiDefaultAckManager::GetAckInfoIfAggregatedMuBar(), ns3::WifiDefaultAckManager::GetAckInfoIfTfMuBar(), and ns3::HeFrameExchangeManager::SendPsduMap().
|
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 963 of file ap-wifi-mac.cc.
References GetCapabilities(), GetEdcaParameterSet(), ns3::WifiMac::GetEhtCapabilities(), ns3::WifiMac::GetEhtSupported(), GetErpInformation(), ns3::WifiMac::GetErpSupported(), ns3::WifiMac::GetExtendedCapabilities(), 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(), NS_ABORT_IF, ns3::MgtAssocResponseHeader::SetCapabilities(), ns3::MgtAssocResponseHeader::SetEdcaParameterSet(), ns3::MgtAssocResponseHeader::SetEhtCapabilities(), ns3::MgtAssocResponseHeader::SetErpInformation(), ns3::MgtAssocResponseHeader::SetExtendedCapabilities(), ns3::StatusCode::SetFailure(), ns3::MgtAssocResponseHeader::SetHeCapabilities(), ns3::MgtAssocResponseHeader::SetHeOperation(), ns3::MgtAssocResponseHeader::SetHtCapabilities(), ns3::MgtAssocResponseHeader::SetHtOperation(), ns3::MgtAssocResponseHeader::SetMuEdcaParameterSet(), ns3::MgtAssocResponseHeader::SetStatusCode(), ns3::StatusCode::SetSuccess(), ns3::MgtAssocResponseHeader::SetSupportedRates(), ns3::MgtAssocResponseHeader::SetVhtCapabilities(), and ns3::MgtAssocResponseHeader::SetVhtOperation().
Referenced by GetMultiLinkElement(), and SendAssocResp().
Time ns3::ApWifiMac::GetBeaconInterval | ( | ) | const |
Definition at line 197 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 1876 of file ap-wifi-mac.cc.
References first::address, 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 455 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 445 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 487 of file ap-wifi-mac.cc.
References ns3::AC_BE, ns3::AC_BK, ns3::AC_VI, ns3::AC_VO, ns3::QosTxop::GetAifsn(), ns3::QosTxop::GetMaxCw(), ns3::Time::GetMicroSeconds(), ns3::QosTxop::GetMinCw(), ns3::WifiMac::GetQosSupported(), ns3::WifiMac::GetQosTxop(), ns3::Txop::GetTxopLimit(), 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 ERP information of the current AP for the given link.
linkId | the ID of the given link |
Definition at line 466 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 GetAssocResp(), SendOneBeacon(), and SendProbeResp().
|
private |
Return the HE operation of the current AP for the given link.
linkId | the ID of the given link |
Definition at line 829 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetHeConfiguration(), ns3::WifiMac::GetHeSupported(), GetLink(), ns3::WifiPhy::GetMaxSupportedRxSpatialStreams(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_ASSERT, NS_LOG_FUNCTION, ns3::HeOperation::SetBssColor(), and ns3::HeOperation::SetMaxHeMcsPerNss().
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 682 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(), min, ns3::MIXED_MODE_PROTECTION, ns3::NO_PROTECTION, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, third::phy, 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(), 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 147 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetLink().
Referenced by ConfigureStandard(), DoInitialize(), GetCapabilities(), GetErpInformation(), GetHeOperation(), GetHtOperation(), GetReducedNeighborReport(), GetStaList(), GetUseNonErpProtection(), GetVhtOperation(), Receive(), SendOneBeacon(), SendProbeResp(), SetAid(), SetBeaconGeneration(), UpdateShortPreambleEnabled(), and UpdateShortSlotTimeEnabled().
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 1901 of file ap-wifi-mac.cc.
References first::address, GetBufferStatus(), and max.
Referenced by ns3::RrMultiUserScheduler::TrySendingBasicTf().
|
private |
Return the MU EDCA Parameter Set of the current AP, if one needs to be advertised.
Definition at line 534 of file ap-wifi-mac.cc.
References ns3::AC_BE, ns3::AC_BK, ns3::AC_VI, ns3::AC_VO, ns3::TimeValue::Get(), ns3::UintegerValue::Get(), 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 633 of file ap-wifi-mac.cc.
References ns3::MultiLinkElement::AddPerStaProfileSubelement(), ns3::MultiLinkElement::BASIC_VARIANT, ns3::WifiMac::GetAddress(), GetAssocResp(), ns3::WifiMac::GetFrameExchangeManager(), ns3::WifiMac::GetNLinks(), ns3::MultiLinkElement::GetNPerStaProfileSubelements(), ns3::MultiLinkElement::GetPerStaProfile(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_ABORT_IF, NS_LOG_FUNCTION, ns3::MultiLinkElement::SetBssParamsChangeCount(), ns3::MultiLinkElement::PerStaProfileSubelement::SetLinkId(), ns3::MultiLinkElement::SetLinkIdInfo(), ns3::MultiLinkElement::SetMldMacAddress(), ns3::WIFI_MAC_MGT_ASSOCIATION_RESPONSE, and ns3::WIFI_MAC_MGT_REASSOCIATION_RESPONSE.
Referenced by SendAssocResp(), SendOneBeacon(), and SendProbeResp().
|
private |
linkIds | the IDs of the links for which the next Association ID is requested |
Definition at line 1846 of file ap-wifi-mac.cc.
References 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 602 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 SendOneBeacon(), and SendProbeResp().
const std::map< uint16_t, Mac48Address > & ns3::ApWifiMac::GetStaList | ( | uint8_t | linkId = SINGLE_LINK_OP_ID | ) | 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 1864 of file ap-wifi-mac.cc.
References GetLink(), and ns3::ApWifiMac::ApLinkEntity::staList.
Referenced by MultiLinkSetupTest::CheckMlSetup(), TestMultiUserScheduler::ComputeWifiTxVector(), ns3::MultiUserScheduler::GetMaxSizeOfQosNullAmpdu(), ns3::MultiUserScheduler::GetTriggerFrame(), TestMultiUserScheduler::SelectTxFormat(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), and ns3::WifiDefaultAckManager::TryUlMuTransmission().
|
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 400 of file ap-wifi-mac.cc.
References ns3::WifiRemoteStationManager::AddBasicMode(), ns3::SupportedRates::AddBssMembershipSelectorRate(), ns3::SupportedRates::AddSupportedRate(), ns3::WifiRemoteStationManager::GetBasicMode(), ns3::WifiMode::GetDataRate(), ns3::WifiMac::GetHtSupported(), ns3::WifiRemoteStationManager::GetNBasicModes(), ns3::WifiMode::GetUniqueName(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::SupportedRates::SetBasicRate(), and ns3::WIFI_MOD_CLASS_HR_DSSS.
Referenced by GetAssocResp(), SendOneBeacon(), and SendProbeResp().
|
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 168 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 55 of file ap-wifi-mac.cc.
References GetBeaconInterval(), m_assocLogger, m_beaconJitter, m_bsrLifetime, m_deAssocLogger, m_enableBeaconJitter, m_enableNonErpProtection, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakePointerAccessor(), ns3::MakeTimeAccessor(), ns3::MakeTimeChecker(), ns3::MakeTraceSourceAccessor(), ns3::MicroSeconds(), ns3::MilliSeconds(), SetBeaconGeneration(), SetBeaconInterval(), and ns3::TypeId::SetParent().
|
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 1838 of file ap-wifi-mac.cc.
References GetLink(), ns3::WifiMac::GetWifiRemoteStationManager(), m_enableNonErpProtection, ns3::ApWifiMac::ApLinkEntity::numNonErpStations, and ns3::WifiRemoteStationManager::SetUseNonErpProtection().
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 780 of file ap-wifi-mac.cc.
References GetLink(), ns3::WifiMac::GetVhtSupported(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_ASSERT, NS_LOG_FUNCTION, third::phy, ns3::VhtOperation::SetChannelCenterFrequencySegment0(), ns3::VhtOperation::SetChannelCenterFrequencySegment1(), ns3::VhtOperation::SetChannelWidth(), ns3::VhtOperation::SetMaxVhtMcsPerNss(), and ns3::WIFI_STANDARD_80211ac.
Referenced by GetAssocResp(), SendOneBeacon(), and SendProbeResp().
|
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 1737 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetWifiRemoteStationManager(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ReceiveAssocRequest(), and ns3::WifiRemoteStationManager::SetMldAddress().
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 1406 of file ap-wifi-mac.cc.
References ns3::Packet::Copy(), DeaggregateAmsduAndForward(), ForwardDown(), 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::Packet::GetSize(), ns3::MgtProbeRequestHeader::GetSsid(), ns3::WifiMac::GetSsid(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::WifiMacHeader::HasData(), ns3::WifiMacHeader::IsAssocReq(), ns3::Mac48Address::IsBroadcast(), ns3::WifiMacHeader::IsData(), ns3::WifiMacHeader::IsDisassociation(), 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(), ns3::Packet::PeekHeader(), ns3::WifiMac::Receive(), ReceiveAssocRequest(), ns3::WifiRemoteStationManager::RecordDisassociated(), SendAssocResp(), SendProbeResp(), third::ssid, ns3::ApWifiMac::ApLinkEntity::staList, UpdateShortPreambleEnabled(), and UpdateShortSlotTimeEnabled().
|
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 1568 of file ap-wifi-mac.cc.
References ns3::WifiMac::GetEhtSupported(), ns3::WifiMac::GetErpSupported(), ns3::WifiMac::GetHeSupported(), ns3::WifiMac::GetHtSupported(), ns3::WifiMode::GetMcsValue(), ns3::SupportedRates::GetNRates(), ns3::WifiMac::GetVhtSupported(), ns3::WifiMac::GetWifiPhy(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::CapabilityInformation::IsShortPreamble(), ns3::CapabilityInformation::IsShortSlotTime(), ns3::SupportedRates::IsSupportedRate(), NS_LOG_DEBUG, NS_LOG_FUNCTION, third::phy, ns3::WIFI_MOD_CLASS_EHT, ns3::WIFI_MOD_CLASS_HE, and ns3::WIFI_MOD_CLASS_VHT.
Referenced by ParseReportedStaInfo(), and Receive().
|
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 1172 of file ap-wifi-mac.cc.
References ns3::Packet::AddHeader(), ns3::WifiMac::GetAddress(), GetAssocResp(), ns3::WifiMac::GetBEQueue(), ns3::WifiMac::GetFrameExchangeManager(), 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::MgtAssocResponseHeader::SetMultiLinkElement(), 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 1224 of file ap-wifi-mac.cc.
References ns3::Packet::AddHeader(), GetBeaconInterval(), ns3::Mac48Address::GetBroadcast(), GetCapabilities(), GetDsssParameterSet(), ns3::WifiMac::GetDsssSupported(), GetEdcaParameterSet(), ns3::WifiMac::GetEhtCapabilities(), ns3::WifiMac::GetEhtSupported(), GetErpInformation(), ns3::WifiMac::GetErpSupported(), ns3::WifiMac::GetExtendedCapabilities(), 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(), m_beaconTxop, ns3::MicroSeconds(), NS_LOG_FUNCTION, ns3::Txop::Queue(), ns3::Simulator::Schedule(), SendOneBeacon(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetAddr2(), ns3::WifiMacHeader::SetAddr3(), ns3::MgtProbeResponseHeader::SetBeaconIntervalUs(), ns3::MgtProbeResponseHeader::SetCapabilities(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::MgtProbeResponseHeader::SetDsssParameterSet(), ns3::MgtProbeResponseHeader::SetEdcaParameterSet(), ns3::MgtProbeResponseHeader::SetEhtCapabilities(), ns3::MgtProbeResponseHeader::SetErpInformation(), ns3::MgtProbeResponseHeader::SetExtendedCapabilities(), ns3::MgtProbeResponseHeader::SetHeCapabilities(), ns3::MgtProbeResponseHeader::SetHeOperation(), ns3::MgtProbeResponseHeader::SetHtCapabilities(), ns3::MgtProbeResponseHeader::SetHtOperation(), ns3::MgtProbeResponseHeader::SetMuEdcaParameterSet(), ns3::MgtProbeResponseHeader::SetMultiLinkElement(), ns3::MgtProbeResponseHeader::SetReducedNeighborReport(), ns3::WifiRemoteStationManager::SetShortPreambleEnabled(), ns3::WifiRemoteStationManager::SetShortSlotTimeEnabled(), ns3::WifiPhy::SetSlot(), ns3::MgtProbeResponseHeader::SetSsid(), ns3::MgtProbeResponseHeader::SetSupportedRates(), ns3::WifiMacHeader::SetType(), ns3::MgtProbeResponseHeader::SetVhtCapabilities(), ns3::MgtProbeResponseHeader::SetVhtOperation(), 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 859 of file ap-wifi-mac.cc.
References ns3::Packet::AddHeader(), GetBeaconInterval(), ns3::WifiMac::GetBEQueue(), GetCapabilities(), GetDsssParameterSet(), ns3::WifiMac::GetDsssSupported(), GetEdcaParameterSet(), ns3::WifiMac::GetEhtCapabilities(), ns3::WifiMac::GetEhtSupported(), GetErpInformation(), ns3::WifiMac::GetErpSupported(), ns3::WifiMac::GetExtendedCapabilities(), 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(), NS_LOG_FUNCTION, ns3::Txop::Queue(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetAddr2(), ns3::WifiMacHeader::SetAddr3(), ns3::MgtProbeResponseHeader::SetBeaconIntervalUs(), ns3::MgtProbeResponseHeader::SetCapabilities(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::MgtProbeResponseHeader::SetDsssParameterSet(), ns3::MgtProbeResponseHeader::SetEdcaParameterSet(), ns3::MgtProbeResponseHeader::SetEhtCapabilities(), ns3::MgtProbeResponseHeader::SetErpInformation(), ns3::MgtProbeResponseHeader::SetExtendedCapabilities(), ns3::MgtProbeResponseHeader::SetHeCapabilities(), ns3::MgtProbeResponseHeader::SetHeOperation(), ns3::MgtProbeResponseHeader::SetHtCapabilities(), ns3::MgtProbeResponseHeader::SetHtOperation(), ns3::MgtProbeResponseHeader::SetMuEdcaParameterSet(), ns3::MgtProbeResponseHeader::SetMultiLinkElement(), ns3::MgtProbeResponseHeader::SetReducedNeighborReport(), ns3::WifiRemoteStationManager::SetShortPreambleEnabled(), ns3::WifiRemoteStationManager::SetShortSlotTimeEnabled(), ns3::MgtProbeResponseHeader::SetSsid(), ns3::MgtProbeResponseHeader::SetSupportedRates(), ns3::WifiMacHeader::SetType(), ns3::MgtProbeResponseHeader::SetVhtCapabilities(), ns3::MgtProbeResponseHeader::SetVhtOperation(), ns3::SINGLE_LINK_OP_ID, and ns3::WIFI_MAC_MGT_PROBE_RESPONSE.
Referenced by Receive().
|
private |
Set the AID field of the given Association Response frame, which is going to be sent to the STA with the given address on the given link.
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 |
to | the address of the STA receiving the Association Response frame |
linkId | the ID of the given link |
Definition at line 1018 of file ap-wifi-mac.cc.
References ns3::WifiRemoteStationManager::GetAffiliatedStaAddress(), GetLink(), ns3::WifiRemoteStationManager::GetMldAddress(), ns3::MgtAssocResponseHeader::GetMultiLinkElement(), GetNextAssociationId(), ns3::MgtAssocResponseHeader::GetStatusCode(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::StatusCode::IsSuccess(), m_assocLogger, NS_ABORT_MSG_IF, NS_LOG_FUNCTION, UpdateShortPreambleEnabled(), and UpdateShortSlotTimeEnabled().
Referenced by SendAssocResp().
|
private |
Enable or disable beacon generation of the AP.
enable | enable or disable beacon generation |
Definition at line 178 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 216 of file ap-wifi-mac.cc.
References ns3::Time::GetMicroSeconds(), m_beaconInterval, NS_FATAL_ERROR, and NS_LOG_FUNCTION.
Referenced by 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 1887 of file ap-wifi-mac.cc.
References first::address, m_bufferStatus, and ns3::Simulator::Now().
|
overridevirtual |
linkUp | the callback to invoke when the link becomes up. |
Reimplemented from ns3::WifiMac.
Definition at line 204 of file ap-wifi-mac.cc.
References NS_LOG_FUNCTION, and ns3::WifiMac::SetLinkUpCallback().
|
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 393 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 1367 of file ap-wifi-mac.cc.
References ns3::WifiMacHeader::GetAddr1(), ns3::WifiMacHeader::GetAddr2(), ns3::WifiMac::GetAddress(), ns3::WifiMac::GetFrameExchangeManager(), ns3::WifiMac::GetLinkIdByAddress(), ns3::WifiRemoteStationManager::GetMldAddress(), ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::WifiMacHeader::IsAssocResp(), ns3::WifiMacHeader::IsReassocResp(), ns3::WifiRemoteStationManager::IsWaitAssocTxOk(), NS_ABORT_MSG_IF, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::WifiRemoteStationManager::RecordGotAssocTxFailed().
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 |
Definition at line 1329 of file ap-wifi-mac.cc.
References ns3::WifiMacHeader::GetAddr1(), ns3::WifiMacHeader::GetAddr2(), ns3::WifiMac::GetAddress(), ns3::WifiMac::GetFrameExchangeManager(), ns3::WifiMac::GetLinkIdByAddress(), ns3::WifiRemoteStationManager::GetMldAddress(), ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetWifiRemoteStationManager(), ns3::WifiMacHeader::IsAssocResp(), ns3::WifiMacHeader::IsReassocResp(), ns3::WifiRemoteStationManager::IsWaitAssocTxOk(), NS_ABORT_MSG_IF, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::WifiRemoteStationManager::RecordGotAssocTxOk().
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 264 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 241 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().
|
private |
association logger
Definition at line 468 of file ap-wifi-mac.h.
Referenced by GetTypeId(), and SetAid().
|
private |
Beacon interval.
Definition at line 442 of file ap-wifi-mac.h.
Referenced by GetBeaconInterval(), and SetBeaconInterval().
|
private |
UniformRandomVariable used to randomize the time of the first beacon.
Definition at line 444 of file ap-wifi-mac.h.
Referenced by AssignStreams(), DoInitialize(), and GetTypeId().
Dedicated Txop for beacons.
Definition at line 440 of file ap-wifi-mac.h.
Referenced by ApWifiMac(), ConfigureStandard(), DoDispose(), DoInitialize(), GetTxopQueue(), and SendOneBeacon().
|
private |
Lifetime of Buffer Status Reports.
Definition at line 448 of file ap-wifi-mac.h.
Referenced by GetBufferStatus(), and GetTypeId().
|
private |
Per (MAC address, TID) buffer status reports.
Definition at line 458 of file ap-wifi-mac.h.
Referenced by GetBufferStatus(), and SetBufferStatus().
|
private |
deassociation logger
Definition at line 469 of file ap-wifi-mac.h.
Referenced by GetTypeId(), and Receive().
|
private |
Flag whether beacons are being generated.
Definition at line 441 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 445 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 446 of file ap-wifi-mac.h.
Referenced by GetTypeId(), and GetUseNonErpProtection().