24 #include "ns3/packet.h" 25 #include "ns3/simulator.h" 31 #include "ns3/ht-configuration.h" 32 #include "ns3/he-configuration.h" 45 .SetGroupName (
"Wifi")
47 .AddAttribute (
"ProbeRequestTimeout",
"The duration to actively probe the channel.",
51 .AddAttribute (
"WaitBeaconTimeout",
"The duration to dwell on a channel while passively scanning for beacon",
55 .AddAttribute (
"AssocRequestTimeout",
"The interval between two consecutive association request attempts.",
59 .AddAttribute (
"MaxMissedBeacons",
60 "Number of beacons which much be consecutively missed before " 61 "we attempt to restart association.",
64 MakeUintegerChecker<uint32_t> ())
65 .AddAttribute (
"ActiveProbing",
66 "If true, we send probe requests. If false, we don't." 67 "NOTE: if more than one STA in your simulation is using active probing, " 68 "you should enable it at a different simulation time for each STA, " 69 "otherwise all the STAs will start sending probes at the same time resulting in collisions. " 70 "See bug 1060 for more info.",
74 .AddTraceSource (
"Assoc",
"Associated with an access point.",
76 "ns3::Mac48Address::TracedCallback")
77 .AddTraceSource (
"DeAssoc",
"Association with an access point lost.",
79 "ns3::Mac48Address::TracedCallback")
80 .AddTraceSource (
"BeaconArrival",
81 "Time of beacons arrival from associated AP",
83 "ns3::Time::TracedCallback")
89 : m_state (UNASSOCIATED),
92 m_probeRequestEvent (),
93 m_assocRequestEvent (),
94 m_beaconWatchdogEnd (
Seconds (0))
129 NS_LOG_DEBUG (
"STA is still scanning, reset scanning process");
360 NS_LOG_DEBUG (
"Exhausted list of candidate AP; restart scanning");
518 NS_LOG_LOGIC (
"Received data frame while not associated: ignore");
524 NS_LOG_LOGIC (
"Received data frame not from the DS: ignore");
530 NS_LOG_LOGIC (
"Received data frame not from the BSS we are associated with: ignore");
569 bool goodBeacon =
false;
577 bool bssMembershipSelectorMatch =
false;
579 for (
const auto & selector : selectorList)
583 NS_LOG_LOGIC (
"Beacon is matched to our BSS membership selector");
584 bssMembershipSelectorMatch =
true;
587 if (selectorList.size () > 0 && bssMembershipSelectorMatch ==
false)
614 apInfo.
m_snr = snrTag.Get ();
628 if (!probeResp.GetSsid ().IsEqual (
GetSsid ()))
703 if (newApInfo.
m_bssid == (*i).m_bssid)
712 if (newApInfo.
m_snr > (*i).m_snr)
762 bool qosSupported =
false;
839 NS_LOG_DEBUG (
"Supported rates do not fit with the BSS membership selector");
858 bool isErpAllowed =
false;
904 bool isErpAllowed =
false;
940 bool qosSupported =
false;
1046 NS_LOG_DEBUG (
"Adding supported rate of " << modeDataRate);
1065 return capabilities;
1100 NS_LOG_DEBUG (
"PHY capabilities changed: send reassociation request");
static Time GetDelayLeft(const EventId &id)
Get the remaining time until this event will execute.
uint32_t RemoveHeader(Header &header)
Deserialize and remove the header from the internal buffer.
bool IsSuccess(void) const
Return whether the status code is success.
static EventId Schedule(Time const &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
bool m_activeProbing
Flag whether active probing is used or not.
TracedCallback< Mac48Address > m_deAssocLogger
disassociation logger
double m_snr
SNR in linear scale.
Ptr< HeConfiguration > GetHeConfiguration(void) const
Simulation virtual time values and global simulation resolution.
Time m_assocRequestTimeout
association request timeout
void AddSupportedMcs(Mac48Address address, WifiMode mcs)
Record the MCS index supported by the station.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
bool GetActiveProbing(void) const
Return whether active probing is enabled.
bool IsBssMembershipSelectorRate(uint64_t bs) const
Check if the given rate is a BSS membership selector value.
AttributeValue implementation for Boolean.
bool GetHeSupported() const
Return whether the device supports HE.
Ptr< Txop > m_txop
This holds a pointer to the TXOP instance for this WifiMac - used for transmission of frames to non-Q...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
bool IsSupportedRxMcs(uint8_t mcs) const
Is RX MCS supported.
AcIndex
This enumeration defines the Access Categories as an enumeration with values corresponding to the AC ...
void SetEdcaParameters(AcIndex ac, uint32_t cwMin, uint32_t cwMax, uint8_t aifsn, Time txopLimit)
Set the EDCA parameters.
virtual void DeaggregateAmsduAndForward(Ptr< WifiMacQueueItem > mpdu)
This method can be called to de-aggregate an A-MSDU and forward the constituent packets up the stack...
bool GetQosSupported() const
Return whether the device supports QoS.
uint16_t GetVoTxopLimit(void) const
Return the AC_VO TXOP Limit field in the EdcaParameterSet information element.
bool IsSupportedRate(uint64_t bs) const
Check if the given rate is supported.
void SetState(MacState value)
Set the current MAC state.
std::vector< ApInfo > m_candidateAps
list of candidate APs to associate to
void AssocRequestTimeout(void)
This method is called after the association timeout occurred.
uint16_t GetSupportedMcsAndNss() const
Return the MCS and NSS field in the HE Capabilities information element.
Ptr< const AttributeAccessor > MakeBooleanAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
Time m_probeRequestTimeout
probe request timeout
EdcaQueues m_edca
This is a map from Access Category index to the corresponding channel access function.
void AddStationVhtCapabilities(Mac48Address from, VhtCapabilities vhtCapabilities)
Records VHT capabilities of the remote station.
void StartScanning(void)
Start the scanning process which trigger active or passive scanning based on the active probing flag...
std::list< WifiMode > GetModeList(void) const
The WifiPhy::GetModeList() method is used (e.g., by a WifiRemoteStationManager) to determine the set ...
ExtendedCapabilities GetExtendedCapabilities(void) const
Return the extended capabilities of the device.
The Extended Capabilities Information ElementThis class knows how to serialise and deserialise the Ex...
The VHT Operation Information ElementThis class knows how to serialise and deserialise the VHT Operat...
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
Struct to hold information regarding observed AP through active/passive scanning. ...
Callback< void > m_linkUp
Callback when a link is up.
void ConfigureContentionWindow(uint32_t cwMin, uint32_t cwMax)
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
void SetSlot(Time slot)
Set the slot duration for this PHY.
The HT Capabilities Information ElementThis class knows how to serialise and deserialise the HT Capab...
void UpdateCandidateApList(ApInfo newApInfo)
Update list of candidate AP to associate.
uint32_t GetBeCWmin(void) const
Return the AC_BE CWmin field in the EdcaParameterSet information element.
void NotifyRxDrop(Ptr< const Packet > packet)
Mac48Address m_bssid
BSSID.
TracedCallback< Mac48Address > m_assocLogger
association logger
bool IsBasicRate(uint64_t bs) const
Check if the given rate is a basic rate.
EventId m_assocRequestEvent
association request event
Ptr< WifiPhy > m_phy
Wifi PHY.
Time m_waitBeaconTimeout
wait beacon timeout
std::list< WifiMode > GetMcsList(void) const
The WifiPhy::GetMcsList() method is used (e.g., by a WifiRemoteStationManager) to determine the set o...
The Supported Rates Information ElementThis class knows how to serialise and deserialise the Supporte...
uint16_t GetViTxopLimit(void) const
Return the AC_VI TXOP Limit field in the EdcaParameterSet information element.
uint16_t GetRxHighestSupportedLgiDataRate() const
Get the receive highest supported LGI data rate.
virtual void Receive(Ptr< WifiMacQueueItem > mpdu)
This method acts as the MacRxMiddle receive callback and is invoked to notify us that a frame has bee...
void SetWifiPhy(const Ptr< WifiPhy > phy) override
bool IsExpired(void) const
This method is syntactic sugar for the ns3::Simulator::IsExpired method.
bool GetShortSlotTimeSupported(void) const override
void AddSupportedRate(uint64_t bs)
Add the given rate to the supported rates.
double Get(void) const
Return the SNR value.
uint32_t GetBeCWmax(void) const
Return the AC_BE CWmax field in the EdcaParameterSet information element.
uint8_t QosUtilsGetTidForPacket(Ptr< const Packet > packet)
If a QoS tag is attached to the packet, returns a value < 8.
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
MacState
The current MAC state of the STA.
uint16_t GetChannelWidth(void) const
void SetShortSlotTimeEnabled(bool enable)
Enable or disable short slot time.
void SetBssid(Mac48Address bssid)
void SendProbeRequest(void)
Forward a probe request packet to the DCF.
CapabilityInformation GetCapabilities(void) const
Return the Capability information of the current STA.
void UpdateApInfoFromBeacon(MgtBeaconHeader beacon, Mac48Address apAddr, Mac48Address bssid)
Update associated AP's information from beacon.
base class for all MAC-level wifi objects.
const WifiMacHeader & GetHeader(void) const
Get the header stored in this item.
bool GetErpSupported() const
Return whether the device supports ERP.
bool IsSupportedMcs(uint8_t mcs) const
Return the is MCS supported flag.
SupportedRates GetSupportedRates(void) const
Return an instance of SupportedRates that contains all rates that we support including HT rates...
Mac48Address m_apAddr
AP MAC address.
AttributeValue implementation for Time.
bool GetVhtSupported() const
Return whether the device supports VHT.
The IEEE 802.11ac VHT Capabilities.
MacState m_state
MAC state.
void AddStationHtCapabilities(Mac48Address from, HtCapabilities htCapabilities)
Records HT capabilities of the remote station.
void NotifyTxDrop(Ptr< const Packet > packet)
Hold an unsigned integer type.
void MissedBeacons(void)
This method is called after we have not received a beacon from the AP.
uint8_t GetBkAifsn(void) const
Return the AC_BK AIFSN field in the EdcaParameterSet information element.
MgtProbeResponseHeader m_probeResp
Probe Response header.
AcIndex QosUtilsMapTidToAc(uint8_t tid)
Maps TID (Traffic ID) to Access classes.
void AddStationHeCapabilities(Mac48Address from, HeCapabilities heCapabilities)
Records HE capabilities of the remote station.
Time GetDelayUntilIdle(void)
static Mac48Address GetBroadcast(void)
uint32_t PeekHeader(Header &header) const
Deserialize but does not remove the header from the internal buffer.
std::list< uint8_t > GetBssMembershipSelectorList(void) const
The WifiPhy::BssMembershipSelector() method is used (e.g., by a WifiRemoteStationManager) to determin...
void ScanningTimeout(void)
This method is called after wait beacon timeout or wait probe request timeout has occurred...
HeCapabilities GetHeCapabilities(void) const
Return the HE capabilities of the device.
void SetCapabilitiesChangedCallback(Callback< void > callback)
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
void SetQosSupport(Mac48Address from, bool qosSupported)
Records QoS support of the remote station.
uint32_t GetBkCWmin(void) const
Return the AC_BK CWmin field in the EdcaParameterSet information element.
Callback< void > m_linkDown
Callback when a link is down.
uint32_t m_maxMissedBeacons
maximum missed beacons
Ptr< const Packet > GetPacket(void) const
Get the packet stored in this item.
bool GetShortSlotTimeEnabled(void) const
Return whether the device uses short slot time.
EventId m_beaconWatchdog
beacon watchdog
void UpdateApInfoFromProbeResp(MgtProbeResponseHeader probeResp, Mac48Address apAddr, Mac48Address bssid)
Update AP's information from probe response.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
uint32_t GetVoCWmin(void) const
Return the AC_VO CWmin field in the EdcaParameterSet information element.
void PhyCapabilitiesChanged(void)
Indicate that PHY capabilities have changed.
The EDCA Parameter SetThis class knows how to serialise and deserialise the EDCA Parameter Set...
void AddSupportedMode(Mac48Address address, WifiMode mode)
Invoked in a STA or AP to store the set of modes supported by a destination which is also supported l...
static TypeId GetTypeId(void)
Get the type ID.
void AddBssMembershipSelectorRate(uint64_t bs)
Add a special value to the supported rate set, corresponding to a BSS membership selector.
void AddBasicMode(WifiMode mode)
Invoked in a STA upon association to store the set of rates which belong to the BSSBasicRateSet of th...
Ptr< Packet > Copy(void) const
performs a COW copy of the packet.
Mac48Address GetBssid(void) const override
void SetUseNonErpProtection(bool enable)
Enable or disable protection for non-ERP stations.
void SetWifiPhy(const Ptr< WifiPhy > phy) override
uint8_t GetBeAifsn(void) const
Return the AC_BE AIFSN field in the EdcaParameterSet information element.
bool GetShortPhyPreambleSupported(void) const
Return whether short PHY preamble is supported.
void RestartBeaconWatchdog(Time delay)
Restarts the beacon timer.
void TryToEnsureAssociated(void)
Try to ensure that we are associated with an AP by taking an appropriate action depending on the curr...
void SetTypeOfStation(TypeOfStation type) override
This method is invoked by a subclass to specify what type of station it is implementing.
Ptr< const AttributeAccessor > MakeTimeAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
static Time Now(void)
Return the current simulation virtual time.
MgtBeaconHeader m_beacon
Beacon header.
void Receive(Ptr< WifiMacQueueItem > mpdu) override
Handle a received packet.
EventId m_waitBeaconEvent
wait beacon event
void Enqueue(Ptr< Packet > packet, Mac48Address to) override
uint32_t GetVoCWmax(void) const
Return the AC_VO CWmax field in the EdcaParameterSet information element.
void SetActiveProbing(bool enable)
Enable or disable active probing.
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
void UpdateApInfoFromAssocResp(MgtAssocResponseHeader assocResp, Mac48Address apAddr)
Update AP's information from association response.
uint16_t GetBkTxopLimit(void) const
Return the AC_BK TXOP Limit field in the EdcaParameterSet information element.
uint8_t GetVoAifsn(void) const
Return the AC_VO AIFSN field in the EdcaParameterSet information element.
uint16_t GetBeTxopLimit(void) const
Return the AC_BE TXOP Limit field in the EdcaParameterSet information element.
bool IsSupportedRxMcs(uint8_t mcs) const
Returns true if receive MCS is supported.
void SetMinCw(uint32_t minCw)
Set the minimum contention window size.
void SetMaxCw(uint32_t maxCw)
Set the maximum contention window size.
void SetTxopLimit(Time txopLimit)
Set the TXOP limit.
bool GetHtSupported() const
Return whether the device supports HT.
bool RemovePacketTag(Tag &tag)
Remove a packet tag.
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Time Seconds(double value)
Construct a Time in the indicated unit.
Ssid GetSsid(void) const override
Ptr< const AttributeChecker > MakeBooleanChecker(void)
bool IsRunning(void) const
This method is syntactic sugar for !IsExpired().
void Cancel(void)
This method is syntactic sugar for the ns3::Simulator::Cancel method.
bool IsEqual(const Ssid &o) const
Check if the two SSIDs are equal.
Ptr< const AttributeChecker > MakeTimeChecker(const Time min, const Time max)
Helper to make a Time checker with bounded range.
uint8_t GetBssColor(void) const
Get the BSS color.
void ForwardUp(Ptr< const Packet > packet, Mac48Address from, Mac48Address to)
Forward the packet up to the device.
Mac48Address GetAddress(void) const override
void DoInitialize(void) override
Initialize() implementation.
uint32_t GetBkCWmax(void) const
Return the AC_BK CWmax field in the EdcaParameterSet information element.
Time MicroSeconds(uint64_t value)
Construct a Time in the indicated unit.
uint16_t m_aid
Association AID.
uint32_t GetViCWmax(void) const
Return the AC_VI CWmax field in the EdcaParameterSet information element.
void SetAifsn(uint8_t aifsn)
Set the number of slots that make up an AIFS.
uint16_t GetAssociationId(void) const
Return the association ID.
uint32_t GetViCWmin(void) const
Return the AC_VI CWmin field in the EdcaParameterSet information element.
bool IsWaitAssocResp(void) const
Return whether we are waiting for an association response from an AP.
Time m_beaconWatchdogEnd
beacon watchdog end
bool m_activeProbing
active probing
EventId m_probeRequestEvent
probe request event
void SetShortPreambleEnabled(bool enable)
Enable or disable short PHY preambles.
The HE Operation Information ElementThis class knows how to serialise and deserialise the HE Operatio...
Ptr< WifiRemoteStationManager > m_stationManager
Remote station manager (rate control, RTS/CTS/fragmentation thresholds etc.)
bool IsNull(void) const
Check for null implementation.
VhtCapabilities GetVhtCapabilities(void) const
Return the VHT capabilities of the device.
bool IsBroadcast(void) const
Check if the SSID is broadcast.
The IEEE 802.11ax HE Capabilities.
virtual void Queue(Ptr< Packet > packet, const WifiMacHeader &hdr)
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
a unique identifier for an interface.
void RemoveAllSupportedMcs(Mac48Address address)
Invoked in a STA or AP to delete all of the supported MCS by a destination.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
uint8_t GetViAifsn(void) const
Return the AC_VI AIFSN field in the EdcaParameterSet information element.
uint8_t IsQosSupported(void) const
Is QOS supported function.
bool IsStateRx(void) const
Callback< R, Ts... > MakeCallback(R(T::*memPtr)(Ts...), OBJ objPtr)
Build Callbacks for class method members which take varying numbers of arguments and potentially retu...
Introspection did not find any typical Config paths.
void AddHeader(const Header &header)
Add header to this packet.
HtCapabilities GetHtCapabilities(void) const
Return the HT capabilities of the device.
void SendAssociationRequest(bool isReassoc)
Forward an association or reassociation request packet to the DCF.
bool IsAssociated(void) const
Return whether we are associated with an AP.
TracedCallback< Time > m_beaconArrival
beacon arrival logger
The Wifi MAC high model for a non-AP STA in a BSS.