23#include "ns3/attribute-container.h"
24#include "ns3/eht-configuration.h"
25#include "ns3/emlsr-manager.h"
26#include "ns3/he-configuration.h"
27#include "ns3/ht-configuration.h"
29#include "ns3/packet.h"
31#include "ns3/pointer.h"
32#include "ns3/random-variable-stream.h"
33#include "ns3/simulator.h"
34#include "ns3/string.h"
55 .AddAttribute(
"ProbeRequestTimeout",
56 "The duration to actively probe the channel.",
60 .AddAttribute(
"WaitBeaconTimeout",
61 "The duration to dwell on a channel while passively scanning for beacon",
65 .AddAttribute(
"AssocRequestTimeout",
66 "The interval between two consecutive association request attempts.",
70 .AddAttribute(
"MaxMissedBeacons",
71 "Number of beacons which much be consecutively missed before "
72 "we attempt to restart association.",
78 "If true, we send probe requests. If false, we don't."
79 "NOTE: if more than one STA in your simulation is using active probing, "
80 "you should enable it at a different simulation time for each STA, "
81 "otherwise all the STAs will start sending probes at the same time resulting in "
83 "See bug 1060 for more info.",
87 .AddAttribute(
"ProbeDelay",
88 "Delay (in microseconds) to be used prior to transmitting a "
89 "Probe frame during active scanning.",
90 StringValue(
"ns3::UniformRandomVariable[Min=50.0|Max=250.0]"),
95 "Enable/disable power save mode on the given link. The power management mode is "
96 "actually changed when the AP acknowledges a frame sent with the Power Management "
97 "field set to the value corresponding to the requested mode",
103 .AddAttribute(
"PmModeSwitchTimeout",
104 "If switching to a new Power Management mode is not completed within "
105 "this amount of time, make another attempt at switching Power "
110 .AddTraceSource(
"Assoc",
111 "Associated with an access point. If this is an MLD that associated "
112 "with an AP MLD, the AP MLD address is provided.",
114 "ns3::Mac48Address::TracedCallback")
115 .AddTraceSource(
"LinkSetupCompleted",
116 "A link was setup in the context of ML setup with an AP MLD. "
117 "Provides ID of the setup link and AP MAC address",
119 "ns3::StaWifiMac::LinkSetupCallback")
120 .AddTraceSource(
"DeAssoc",
121 "Association with an access point lost. If this is an MLD "
122 "that disassociated with an AP MLD, the AP MLD address is provided.",
124 "ns3::Mac48Address::TracedCallback")
125 .AddTraceSource(
"BeaconArrival",
126 "Time of beacons arrival from associated AP",
128 "ns3::Time::TracedCallback")
129 .AddTraceSource(
"ReceivedBeaconInfo",
130 "Information about every received Beacon frame",
132 "ns3::ApInfo::TracedCallback")
133 .AddTraceSource(
"EmlsrLinkSwitch",
134 "Trace start/end of EMLSR link switch events: when a PHY operating on "
135 "a link starts switching, provides the ID of the link and a null "
136 "pointer (indicating no PHY is operating on that link); when a PHY "
137 "completes switching to a link, provides the ID of the link and a "
138 "pointer to the PHY (that is now operating on that link)",
140 "ns3::StaWifiMac::EmlsrLinkSwitchCallback");
145 : m_state(UNASSOCIATED),
147 m_assocRequestEvent()
217std::unique_ptr<WifiMac::LinkEntity>
220 return std::make_unique<StaLinkEntity>();
240 auto currentStream = stream + 1;
242 return (currentStream - stream);
281 NS_LOG_DEBUG(
"STA is still scanning, reset scanning process");
297 for (
auto& phy : phys)
299 phy->SetCapabilitiesChangedCallback(
308 const auto width = phy->GetOperatingChannel().IsOfdm() ?
MHz_u{20} : phy->GetChannelWidth();
309 uint8_t ch = phy->GetPrimaryChannelNumber(width);
310 return {ch, phy->GetPhyBand()};
316 std::stringstream ss;
319 std::copy(linkIds.cbegin(), linkIds.cend(), std::ostream_iterator<uint16_t>(ss,
" "));
323 for (
const auto& [linkId, lnk] :
GetLinks())
327 if (linkIds.contains(linkId))
330 link.emlsrEnabled =
true;
336 if (link.emlsrEnabled)
340 link.emlsrEnabled =
false;
362 params.SetCurrentChannel(
GetWifiPhy(linkId)->GetChannelNumber());
391 const std::vector<uint8_t>& apLinkIds,
392 std::optional<uint8_t> apMldId)
const
400 NS_LOG_DEBUG(
"Single link device does not support Multi-link operation, not including "
401 "Multi-link Element");
424 packet->AddHeader(probeReq);
443std::variant<MgtAssocRequestHeader, MgtReassocRequestHeader>
448 std::variant<MgtAssocRequestHeader, MgtReassocRequestHeader> mgtFrame;
454 mgtFrame = std::move(reassoc);
462 auto fill = [&](
auto&& frame) {
463 frame.template Get<Ssid>() =
GetSsid();
465 frame.template Get<SupportedRates>() = supportedRates.rates;
466 frame.template Get<ExtendedSupportedRatesIE>() = supportedRates.extendedRates;
468 frame.SetListenInterval(0);
492 std::visit(fill, mgtFrame);
530 mldCapabilities.emplace();
531 mldCapabilities->maxNSimultaneousLinks =
GetNLinks() - 1;
532 mldCapabilities->srsSupport = 0;
537 mldCapabilities->tidToLinkMappingSupport =
538 static_cast<uint8_t
>(ehtConfiguration->m_tidLinkMappingSupport);
539 mldCapabilities->freqSepForStrApMld = 0;
540 mldCapabilities->aarSupport = 0;
546 for (
const auto& [index, link] :
GetLinks())
550 if (index != linkId && staLink.bssid.has_value())
562 perStaProfile.SetCompleteProfile();
567 perStaProfile.SetStaMacAddress(staLink.feManager->GetAddress());
572 return multiLinkElement;
577 std::optional<uint8_t> apMldId)
const
581 if (apMldId.has_value())
586 for (
const auto apLinkId : apLinkIds)
593 perStaProfile.SetCompleteProfile();
599std::vector<TidToLinkMapping>
607 auto negSupport = ehtConfig->m_tidLinkMappingSupport;
610 "Cannot request TID-to-Link Mapping if negotiation is not supported");
620 "Mapping TIDs to distinct link sets is incompatible with negotiation support of 1");
629 NS_LOG_DEBUG(
"Using default mapping because AP MLD advertised negotiation support of 1");
634 std::vector<TidToLinkMapping> ret(1);
639 auto fillIe = [&ret](
const auto& mapping) {
640 ret.back().m_control.defaultMapping = mapping.empty();
642 for (
const auto& [tid, linkSet] : mapping)
648 NS_ABORT_MSG_IF(linkSet.empty(),
"Cannot map a TID to an empty link set");
649 ret.back().SetLinkMappingOfTid(tid, linkSet);
682 "No link selected to send the (Re)Association Request");
683 uint8_t linkId = it->first;
686 "No BSSID set for the link on which the (Re)Association Request is to be sent");
692 hdr.
SetAddr2(link.feManager->GetAddress());
707 auto addMle = [&](
auto&& frame) {
710 std::visit(addMle, frame);
713 if (
const auto& mldCapabilities =
716 mldCapabilities->get().tidToLinkMappingSupport)) >
719 auto addTlm = [&](
auto&& frame) {
722 std::visit(addTlm, frame);
728 packet->AddHeader(std::get<MgtAssocRequestHeader>(frame));
732 packet->AddHeader(std::get<MgtReassocRequestHeader>(frame));
808 for (
const auto& [
id, link] :
GetLinks())
836 if (!bestAp.has_value())
838 NS_LOG_DEBUG(
"Exhausted list of candidate AP; restart scanning");
843 NS_LOG_DEBUG(
"Attempting to associate with AP: " << *bestAp);
844 UpdateApInfo(bestAp->m_frame, bestAp->m_apAddr, bestAp->m_bssid, bestAp->m_linkId);
849 staLink.sendAssocReq =
false;
850 staLink.bssid = std::nullopt;
855 std::shared_ptr<CommonInfoBasicMle> mleCommonInfo;
858 std::visit([](
auto&& frame) {
return frame.template Get<MultiLinkElement>(); },
860 std::map<uint8_t, uint8_t> swapInfo;
861 for (
const auto& [localLinkId, apLinkId, bssid] : bestAp->m_setupLinks)
864 NS_LOG_DEBUG(
"Setting up link (local ID=" << +localLinkId <<
", AP ID=" << +apLinkId
869 mleCommonInfo = std::make_shared<CommonInfoBasicMle>(mle->GetCommonInfoBasic());
872 swapInfo.emplace(localLinkId, apLinkId);
878 auto getBeaconInterval = [](
auto&& frame) {
879 using T = std::decay_t<
decltype(frame)>;
880 if constexpr (std::is_same_v<T, MgtBeaconHeader> ||
881 std::is_same_v<T, MgtProbeResponseHeader>)
891 Time beaconInterval = std::visit(getBeaconInterval, bestAp->m_frame);
930 for (
const auto& [
id, link] :
GetLinks())
932 if (link->phy && link->phy->IsStateRx())
934 delay = std::max(delay, link->phy->GetDelayUntilIdle());
947 for (
const auto& [
id, link] :
GetLinks())
954 bssid = std::nullopt;
957 NS_LOG_DEBUG(
"Set state to UNASSOCIATED and start scanning");
999 std::set<uint8_t> linkIds;
1000 for (
const auto& [
id, link] :
GetLinks())
1013 for (
const auto& [
id, link] :
GetLinks())
1018 return link->feManager->GetAddress();
1044 auto& hdr = mpdu->GetHeader();
1050 uint8_t linkId = *linkIds.begin();
1053 hdr.SetAddr1(apMldAddr.value_or(
GetBssid(linkId)));
1089 std::stringstream ss;
1090 std::copy(linkIds.cbegin(), linkIds.cend(), std::ostream_iterator<uint16_t>(ss,
" "));
1093 const auto linkId = *linkIds.cbegin();
1094 const auto bssid =
GetBssid(linkId);
1095 const auto apAddress =
1117 const WifiMacHeader* hdr = &mpdu->GetOriginal()->GetHeader();
1137 NS_LOG_LOGIC(
"Received data frame while not associated: ignore");
1143 NS_LOG_LOGIC(
"Received data frame not from the DS: ignore");
1147 std::set<Mac48Address> apAddresses;
1152 if (!apAddresses.contains(mpdu->GetHeader().GetAddr2()))
1154 NS_LOG_LOGIC(
"Received data frame not from the BSS we are associated with: ignore");
1160 NS_LOG_LOGIC(
"Received (QoS) Null Data frame: ignore");
1168 NS_ASSERT(apAddresses.contains(mpdu->GetHeader().GetAddr3()));
1209 action.protectedEhtAction ==
1236 mpdu->GetPacket()->PeekHeader(beacon);
1245 goodBeacon = bssid.has_value() && (hdr.
GetAddr3() == *bssid);
1255 bool found = mpdu->GetPacket()->PeekPacketTag(snrTag);
1259 .m_snr = snrTag.
Get(),
1260 .m_frame = std::move(beacon),
1262 .m_linkId = linkId};
1298 mpdu->GetPacket()->PeekHeader(probeResp);
1304 bool found = mpdu->GetPacket()->PeekPacketTag(snrTag);
1308 .m_snr = snrTag.
Get(),
1309 .m_frame = std::move(probeResp),
1310 .m_channel = {GetCurrentChannel(linkId)},
1311 .m_linkId = linkId});
1326 std::optional<Mac48Address> apMldAddress;
1328 mpdu->GetPacket()->PeekHeader(assocResp);
1348 if (
const auto& mldCapabilities =
1351 mldCapabilities->get().tidToLinkMappingSupport) >
1400 std::list<uint8_t> setupLinks;
1401 for (
const auto& [
id, link] :
GetLinks())
1403 setupLinks.push_back(
id);
1407 setupLinks.remove(linkId);
1414 "The link on which the Association Response was received "
1415 "is not a link we requested to setup");
1417 "The link ID of the AP that transmitted the Association "
1418 "Response does not match the stored link ID");
1420 mle->GetMldMacAddress(),
1421 "The AP MLD MAC address in the received Multi-Link Element does not "
1422 "match the address stored in the station manager for link "
1425 for (std::size_t elem = 0; elem < mle->GetNPerStaProfileSubelements(); elem++)
1427 auto& perStaProfile = mle->GetPerStaProfile(elem);
1428 uint8_t apLinkId = perStaProfile.GetLinkId();
1429 auto it =
GetLinks().find(apLinkId);
1430 uint8_t staLinkid = 0;
1431 std::optional<Mac48Address> bssid;
1433 !(bssid =
GetLink((staLinkid = it->first)).
bssid).has_value(),
1434 "Setup for AP link ID " << apLinkId <<
" was not requested");
1436 "The BSSID in the Per-STA Profile for link ID "
1437 << +staLinkid <<
" does not match the stored BSSID");
1440 perStaProfile.GetStaMacAddress()) != mle->GetMldMacAddress(),
1441 "The AP MLD MAC address in the received Multi-Link Element does not "
1442 "match the address stored in the station manager for link "
1449 "AID should be the same for all the links");
1451 NS_LOG_DEBUG(
"Setup on link " << staLinkid <<
" completed");
1463 setupLinks.remove(staLinkid);
1467 for (
const auto&
id : setupLinks)
1482 for (
const auto& [
id, link] :
GetLinks())
1486 if (
const auto txop =
GetTxop())
1488 txop->StartAccessAfterEvent(
id,
1496 edca->StartAccessAfterEvent(
id,
1517 NS_ASSERT_MSG(psduMap.size() == 1 && psduMap.begin()->second->GetNMpdus() == 1 &&
1518 psduMap.begin()->second->GetHeader(0).IsAck(),
1519 "Expected a Normal Ack after Association Response frame");
1524 for (
const auto& [
id, lnk] :
GetLinks())
1551 std::pair<bool, uint8_t>{
true,
id});
1572 std::pair<bool, uint8_t>{
false,
id});
1582 phy->TraceConnectWithoutContext(
"PhyTxPsduBegin", cb);
1584 [=]() { phy->TraceDisconnectWithoutContext(
"PhyTxPsduBegin", cb); });
1594 auto check = [&](
auto&& mgtFrame) ->
bool {
1596 NS_ASSERT(mgtFrame.template Get<SupportedRates>());
1598 mgtFrame.template Get<ExtendedSupportedRatesIE>()};
1601 if (!rates.IsBssMembershipSelectorRate(selector))
1603 NS_LOG_DEBUG(
"Supported rates do not fit with the BSS membership selector");
1611 return std::visit(
check, frame);
1623 const std::optional<ErpInformation>* erpInformation =
nullptr;
1625 if (
const auto* beacon = std::get_if<MgtBeaconHeader>(&frame))
1629 else if (
const auto* probe = std::get_if<MgtProbeResponseHeader>(&frame))
1635 auto commonOps = [&](
auto&& frame) {
1636 const auto& capabilities = frame.Capabilities();
1637 NS_ASSERT(frame.template Get<SupportedRates>());
1639 frame.template Get<ExtendedSupportedRatesIE>()};
1642 if (rates.IsSupportedRate(mode.GetDataRate(
GetWifiPhy(linkId)->GetChannelWidth())))
1645 if (rates.IsBasicRate(mode.GetDataRate(
GetWifiPhy(linkId)->GetChannelWidth())))
1652 bool isShortPreambleEnabled = capabilities.IsShortPreamble();
1653 if (erpInformation && erpInformation->has_value() &&
GetErpSupported(linkId))
1655 isShortPreambleEnabled &= !(*erpInformation)->GetBarkerPreambleMode();
1656 if ((*erpInformation)->GetUseProtection() != 0)
1664 if (capabilities.IsShortSlotTime() ==
true)
1677 capabilities.IsShortSlotTime());
1684 bool qosSupported =
false;
1685 const auto& edcaParameters = frame.template Get<EdcaParameterSet>();
1686 if (edcaParameters.has_value())
1688 qosSupported =
true;
1692 edcaParameters->GetBeCWmin(),
1693 edcaParameters->GetBeCWmax(),
1694 edcaParameters->GetBeAifsn(),
1698 edcaParameters->GetBkCWmin(),
1699 edcaParameters->GetBkCWmax(),
1700 edcaParameters->GetBkAifsn(),
1704 edcaParameters->GetViCWmin(),
1705 edcaParameters->GetViCWmax(),
1706 edcaParameters->GetViAifsn(),
1710 edcaParameters->GetVoCWmin(),
1711 edcaParameters->GetVoCWmax(),
1712 edcaParameters->GetVoAifsn(),
1721 if (
const auto& htCapabilities = frame.template Get<HtCapabilities>();
1722 htCapabilities.has_value())
1739 const auto& vhtCapabilities = frame.template Get<VhtCapabilities>();
1742 if (vhtCapabilities.has_value() &&
1743 vhtCapabilities->GetRxHighestSupportedLgiDataRate() > 0)
1750 if (vhtCapabilities->IsSupportedRxMcs(mcs.GetMcsValue()))
1763 const auto& heCapabilities = frame.template Get<HeCapabilities>();
1764 if (heCapabilities.has_value() && heCapabilities->GetSupportedMcsAndNss() != 0)
1769 if (heCapabilities->IsSupportedRxMcs(mcs.GetMcsValue()))
1774 if (
const auto& heOperation = frame.template Get<HeOperation>();
1775 heOperation.has_value())
1781 const auto& muEdcaParameters = frame.template Get<MuEdcaParameterSet>();
1782 if (muEdcaParameters.has_value())
1785 muEdcaParameters->GetMuCwMin(
AC_BE),
1786 muEdcaParameters->GetMuCwMax(
AC_BE),
1787 muEdcaParameters->GetMuAifsn(
AC_BE),
1788 muEdcaParameters->GetMuEdcaTimer(
AC_BE)},
1791 muEdcaParameters->GetMuCwMin(
AC_BK),
1792 muEdcaParameters->GetMuCwMax(
AC_BK),
1793 muEdcaParameters->GetMuAifsn(
AC_BK),
1794 muEdcaParameters->GetMuEdcaTimer(
AC_BK)},
1797 muEdcaParameters->GetMuCwMin(
AC_VI),
1798 muEdcaParameters->GetMuCwMax(
AC_VI),
1799 muEdcaParameters->GetMuAifsn(
AC_VI),
1800 muEdcaParameters->GetMuEdcaTimer(
AC_VI)},
1803 muEdcaParameters->GetMuCwMin(
AC_VO),
1804 muEdcaParameters->GetMuCwMax(
AC_VO),
1805 muEdcaParameters->GetMuAifsn(
AC_VO),
1806 muEdcaParameters->GetMuEdcaTimer(
AC_VO)},
1812 if (
const auto& he6GhzCapabilities = frame.template Get<He6GhzBandCapabilities>())
1816 *he6GhzCapabilities);
1825 const auto& ehtCapabilities = frame.template Get<EhtCapabilities>();
1830 if (
const auto& mle = frame.template Get<MultiLinkElement>(); mle &&
m_emlsrManager)
1832 if (mle->HasEmlCapabilities())
1834 m_emlsrManager->SetTransitionTimeout(mle->GetTransitionTimeout());
1836 if (
const auto& common = mle->GetCommonInfoBasic(); common.m_mediumSyncDelayInfo)
1838 m_emlsrManager->SetMediumSyncDuration(common.GetMediumSyncDelayTimer());
1839 m_emlsrManager->SetMediumSyncOfdmEdThreshold(common.GetMediumSyncOfdmEdThreshold());
1840 m_emlsrManager->SetMediumSyncMaxNTxops(common.GetMediumSyncMaxNTxops());
1846 std::visit(commonOps, frame);
1852 const auto [enable, linkId] = enableLinkIdPair;
1859 NS_LOG_DEBUG(
"Not associated yet, record the PM mode to switch to upon association");
1866 NS_LOG_DEBUG(
"Link " << +linkId <<
" has not been setup, ignore request");
1887 NS_LOG_DEBUG(
"Next transmitted frame will be sent with PM=" << enable);
1927 auto linkIds = mpdu->GetInFlightLinkIds();
1929 "The TA of the acked MPDU (" << *mpdu
1930 <<
") is not a link "
1931 "address and the MPDU is not inflight");
1936 linkId = *linkIds.begin();
1937 mpdu =
GetTxopQueue(mpdu->GetQueueAc())->GetAlias(mpdu, *linkId);
1940 auto& link =
GetLink(*linkId);
1961 NS_LOG_DEBUG(
"Adding supported rate of " << modeDataRate);
1981 return capabilities;
1994 edca->SetMinCw(params.cwMin, linkId);
1995 edca->SetMaxCw(params.cwMax, linkId);
1996 edca->SetAifsn(params.aifsn, linkId);
1997 edca->SetTxopLimit(params.txopLimit, linkId);
2004 edca->SetMuCwMin(params.cwMin, linkId);
2005 edca->SetMuCwMax(params.cwMax, linkId);
2006 edca->SetMuAifsn(params.aifsn, linkId);
2007 edca->SetMuEdcaTimer(params.muEdcaTimer, linkId);
2016 NS_LOG_DEBUG(
"PHY capabilities changed: send reassociation request");
2076 for (
auto& [
id, link] :
GetLinks())
2078 if (link->phy == phy &&
id != linkId)
2080 link->phy =
nullptr;
2086 auto connectPhy = [=,
this]()
mutable {
2087 auto& newLink =
GetLink(linkId);
2091 newLink.channelAccessManager->SetupPhyListener(phy);
2095 newLink.channelAccessManager->ResetState();
2098 newLink.feManager->ResetPhy();
2100 newLink.feManager->SetWifiPhy(phy);
2102 newLink.stationManager->SetupPhy(phy);
2115 auto lambda = [=,
this]()
mutable {
2116 const auto [maybeIcf, extension] =
m_emlsrManager->CheckPossiblyReceivingIcf(linkId);
2117 if (maybeIcf && extension.IsStrictlyPositive())
2120 "Only the main PHY is expected to move to a link on which another "
2121 "PHY is operating. PHY ID="
2122 << +phy->GetPhyId());
2123 NS_LOG_DEBUG(
"Connecting main PHY to link " << +linkId <<
" is postponed by "
2147 eventIt->second.Cancel();
2171 os <<
"BSSID=" << apInfo.
m_bssid <<
", AP addr=" << apInfo.
m_apAddr <<
", SNR=" << apInfo.
m_snr
2173 <<
"}, Link ID=" << +apInfo.
m_linkId <<
", Frame=[";
2174 std::visit([&os](
auto&& frame) { frame.Print(os); }, apInfo.
m_frame);
A container for one type of attribute.
Base class for Callback class.
bool IsNull() const
Check for null implementation.
The IEEE 802.11be EHT Capabilities.
void Cancel()
This method is syntactic sugar for the ns3::Simulator::Cancel method.
bool IsPending() const
This method is syntactic sugar for !IsExpired().
bool IsExpired() const
This method is syntactic sugar for the ns3::Simulator::IsExpired method.
The Extended Capabilities Information Element.
The Extended Supported Rates Information Element.
The HE 6 GHz Band Capabilities (IEEE 802.11ax-2021 9.4.2.263)
The IEEE 802.11ax HE Capabilities.
The HT Capabilities Information Element.
static Mac48Address ConvertFrom(const Address &address)
static Mac48Address GetBroadcast()
void SetLinkId(uint8_t linkId)
Set the Link ID subfield in the STA Control field.
void AddPerStaProfileSubelement()
Add a Per-STA Profile Subelement in the Link Info field.
void SetEmlsrSupported(bool supported)
Set the EMLSR Support subfield of the EML Capabilities subfield in the Common Info field to 1 if EMLS...
CommonInfoBasicMle & GetCommonInfoBasic()
void SetEmlsrTransitionDelay(Time delay)
Set the EMLSR Transition Delay subfield of the EML Capabilities subfield in the Common Info field.
PerStaProfileSubelement & GetPerStaProfile(std::size_t i)
Get a reference to the i-th Per-STA Profile Subelement in the Link Info field.
void SetEmlsrPaddingDelay(Time delay)
Set the EMLSR Padding Delay subfield of the EML Capabilities subfield in the Common Info field.
void SetApMldId(uint8_t id)
Set the AP MLD ID subfield of Common Info field.
void SetMldMacAddress(Mac48Address address)
Set the MLD MAC Address subfield in the Common Info field.
std::size_t GetNPerStaProfileSubelements() const
Return the number of Per-STA Profile Subelement in the Link Info field.
bool TraceConnectWithoutContext(std::string name, const CallbackBase &cb)
Connect a TraceSource to a Callback without a context.
bool IsInitialized() const
Check if the object has been initialized.
AttributeValue implementation for Pair.
Smart pointer class similar to boost::intrusive_ptr.
virtual double GetValue()=0
Get the next random value drawn from the distribution.
void SetStream(int64_t stream)
Specifies the stream number for the RngStream.
static EventId Schedule(const Time &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
static Time Now()
Return the current simulation virtual time.
static Time GetDelayLeft(const EventId &id)
Get the remaining time until this event will execute.
double Get() const
Return the SNR value.
The IEEE 802.11 SSID Information Element.
The Wifi MAC high model for a non-AP STA in a BSS.
std::set< uint8_t > GetSetupLinkIds() const
Get the IDs of the setup links (if any).
void ScanningTimeout(const std::optional< ApInfo > &bestAp)
This method is called after wait beacon timeout or wait probe request timeout has occurred.
Time m_waitBeaconTimeout
wait beacon timeout
int64_t AssignStreams(int64_t stream) override
Assign a fixed random variable stream number to the random variables used by this model.
void SetPowerSaveMode(const std::pair< bool, uint8_t > &enableLinkIdPair)
Enable or disable Power Save mode on the given link.
Ptr< WifiAssocManager > m_assocManager
Association Manager.
void DoCompleteConfig() override
Allow subclasses to complete the configuration of the MAC layer components.
bool m_activeProbing
active probing
void DoInitialize() override
Initialize() implementation.
void SetAssocManager(Ptr< WifiAssocManager > assocManager)
Set the Association Manager.
TracedCallback< uint8_t, Ptr< WifiPhy > > m_emlsrLinkSwitchLogger
EMLSR link switch logger.
bool CanForwardPacketsTo(Mac48Address to) const override
Return true if packets can be forwarded to the given destination, false otherwise.
std::unique_ptr< LinkEntity > CreateLinkEntity() const override
Create a LinkEntity object.
void SetState(MacState value)
Set the current MAC state.
Time m_beaconWatchdogEnd
beacon watchdog end
AllSupportedRates GetSupportedRates(uint8_t linkId) const
Return an instance of SupportedRates that contains all rates that we support including HT rates.
void SetEdcaParameters(const EdcaParams ¶ms, uint8_t linkId)
Set the EDCA parameters for the given link.
TracedCallback< Mac48Address > m_deAssocLogger
disassociation logger
MacState
The current MAC state of the STA.
void NotifyChannelSwitching(uint8_t linkId) override
Notify that channel on the given link has been switched.
bool GetActiveProbing() const
Return whether active probing is enabled.
EventId m_beaconWatchdog
beacon watchdog
void PhyCapabilitiesChanged()
Indicate that PHY capabilities have changed.
StaLinkEntity & GetStaLink(const std::unique_ptr< WifiMac::LinkEntity > &link) const
Cast the given LinkEntity object to StaLinkEntity.
void ReceiveProbeResp(Ptr< const WifiMpdu > mpdu, uint8_t linkId)
Process the Probe Response frame received on the given link.
void SetPmModeAfterAssociation(uint8_t linkId)
Set the Power Management mode of the setup links after association.
WifiScanParams::Channel GetCurrentChannel(uint8_t linkId) const
Get the current primary20 channel used on the given link as a (channel number, PHY band) pair.
uint16_t GetAssociationId() const
Return the association ID.
void TryToEnsureAssociated()
Try to ensure that we are associated with an AP by taking an appropriate action depending on the curr...
void ReceiveAssocResp(Ptr< const WifiMpdu > mpdu, uint8_t linkId)
Process the (Re)Association Response frame received on the given link.
void NotifySwitchingEmlsrLink(Ptr< WifiPhy > phy, uint8_t linkId, Time delay)
Notify that the given PHY switched channel to operate on another EMLSR link.
std::variant< MgtAssocRequestHeader, MgtReassocRequestHeader > GetAssociationRequest(bool isReassoc, uint8_t linkId) const
Get the (Re)Association Request frame to send on a given link.
static TypeId GetTypeId()
Get the type ID.
MultiLinkElement GetBasicMultiLinkElement(bool isReassoc, uint8_t linkId) const
Return the Basic Multi-Link Element to include in the management frames transmitted on the given link...
void CancelEmlsrPhyConnectEvent(uint8_t phyId)
Cancel any scheduled event for connecting the given PHY to an EMLSR link.
void DoDispose() override
Destructor implementation.
void BlockTxOnLink(uint8_t linkId, WifiQueueBlockedReason reason)
Block transmissions on the given link for the given reason.
std::map< uint8_t, EventId > m_emlsrLinkSwitch
maps PHY ID to the event scheduled to switch the corresponding PHY to a new EMLSR link
StaLinkEntity & GetLink(uint8_t linkId) const
Get a reference to the link associated with the given ID.
uint32_t m_maxMissedBeacons
maximum missed beacons
TracedCallback< uint8_t, Mac48Address > m_setupCompleted
link setup completed logger
TracedCallback< Mac48Address > m_assocLogger
association logger
void SetWifiPhys(const std::vector< Ptr< WifiPhy > > &phys) override
void SetMuEdcaParameters(const MuEdcaParams ¶ms, uint8_t linkId)
Set the MU EDCA parameters for the given link.
void NotifyEmlsrModeChanged(const std::set< uint8_t > &linkIds)
Notify the MAC that EMLSR mode has changed on the given set of links.
bool CheckSupportedRates(std::variant< MgtBeaconHeader, MgtProbeResponseHeader > frame, uint8_t linkId)
Determine whether the supported rates indicated in a given Beacon frame or Probe Response frame fit w...
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 use...
void RestartBeaconWatchdog(Time delay)
Restarts the beacon timer.
void SetEmlsrManager(Ptr< EmlsrManager > emlsrManager)
Set the EMLSR Manager.
void NotifyDropPacketToEnqueue(Ptr< Packet > packet, Mac48Address to) override
Allow subclasses to take actions when a packet to enqueue has been dropped.
Time m_pmModeSwitchTimeout
PM mode switch timeout.
void Disassociated()
Set the state to unassociated and try to associate again.
Ptr< EmlsrManager > GetEmlsrManager() const
void TxOk(Ptr< const WifiMpdu > mpdu)
Notify that the MPDU we sent was successfully received by the receiver (i.e.
MgtProbeRequestHeader GetProbeRequest(uint8_t linkId) const
Get the frame body of the Probe Request to transmit on the given link.
MgtProbeRequestHeader GetMultiLinkProbeRequest(uint8_t linkId, const std::vector< uint8_t > &apLinkIds, std::optional< uint8_t > apMldId) const
Get the frame body of the Multi-Link Probe Request to transmit 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 bee...
WifiTidLinkMapping m_ulTidLinkMappingInAssocReq
store the UL TID-to-Link Mapping included in the Association Request frame
WifiPowerManagementMode GetPmMode(uint8_t linkId) const
Ptr< RandomVariableStream > m_probeDelay
RandomVariable used to randomize the time of the first Probe Response on each channel.
TracedCallback< ApInfo > m_beaconInfo
beacon info logger
void MissedBeacons()
This method is called after we have not received a beacon from the AP on any link.
uint16_t m_aid
Association AID.
MacState m_state
MAC state.
bool IsEmlsrLink(uint8_t linkId) const
void StartScanning()
Start the scanning process which trigger active or passive scanning based on the active probing flag.
std::vector< TidToLinkMapping > GetTidToLinkMappingElements(WifiTidToLinkMappingNegSupport apNegSupport)
TracedCallback< Time > m_beaconArrival
beacon arrival logger
void UnblockTxOnLink(std::set< uint8_t > linkIds, WifiQueueBlockedReason reason)
Unblock transmissions on the given links for the given reason.
void AssocRequestTimeout()
This method is called after the association timeout occurred.
void Enqueue(Ptr< WifiMpdu > mpdu, Mac48Address to, Mac48Address from) override
Ptr< EmlsrManager > m_emlsrManager
EMLSR Manager.
void UpdateApInfo(const MgtFrameType &frame, const Mac48Address &apAddr, const Mac48Address &bssid, uint8_t linkId)
Update associated AP's information from the given management frame (Beacon, Probe Response or Associa...
Time m_assocRequestTimeout
association request timeout
void ReceiveBeacon(Ptr< const WifiMpdu > mpdu, uint8_t linkId)
Process the Beacon frame received on the given link.
Time m_probeRequestTimeout
probe request timeout
void SetActiveProbing(bool enable)
Enable or disable active probing.
std::variant< MgtBeaconHeader, MgtProbeResponseHeader, MgtAssocResponseHeader > MgtFrameType
type of the management frames used to get info about APs
CapabilityInformation GetCapabilities(uint8_t linkId) const
Return the Capability information for the given link.
bool IsAssociated() const
Return whether we are associated with an AP.
bool IsWaitAssocResp() const
Return whether we are waiting for an association response from an AP.
MultiLinkElement GetProbeReqMultiLinkElement(const std::vector< uint8_t > &apLinkIds, std::optional< uint8_t > apMldId) const
Return the Probe Request Multi-Link Element to include in the management frames to transmit.
EventId m_assocRequestEvent
association request event
void EnqueueProbeRequest(const MgtProbeRequestHeader &probeReq, uint8_t linkId, const Mac48Address &addr1=Mac48Address::GetBroadcast(), const Mac48Address &addr3=Mac48Address::GetBroadcast())
Enqueue the given probe request packet for transmission on the given link.
void SendAssociationRequest(bool isReassoc)
Forward an association or reassociation request packet to the DCF.
WifiTidLinkMapping m_dlTidLinkMappingInAssocReq
store the DL TID-to-Link Mapping included in the Association Request frame
bool IsSuccess() const
Return whether the status code is success.
Hold variables of type string.
The Supported Rates Information Element.
TID-to-Link Mapping Information Element.
Simulation virtual time values and global simulation resolution.
TimeWithUnit As(const Unit unit=Time::AUTO) const
Attach a unit to a Time, to facilitate output in a specific unit.
bool IsStrictlyPositive() const
Exactly equivalent to t > 0.
static constexpr bool DIDNT_HAVE_FRAMES_TO_TRANSMIT
no packet available for transmission was in the queue
virtual void Queue(Ptr< WifiMpdu > mpdu)
static constexpr bool CHECK_MEDIUM_BUSY
generation of backoff (also) depends on the busy/idle state of the medium
a unique identifier for an interface.
@ ATTR_GET
The attribute can be read.
@ ATTR_SET
The attribute can be written.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Hold an unsigned integer type.
The IEEE 802.11ac VHT Capabilities.
base class for all MAC-level wifi objects.
Ptr< FrameExchangeManager > GetFrameExchangeManager(uint8_t linkId=SINGLE_LINK_OP_ID) const
Get the Frame Exchange Manager associated with the given link.
Ptr< QosTxop > GetBEQueue() const
Accessor for the AC_BE channel access function.
virtual void NotifyChannelSwitching(uint8_t linkId)
Notify that channel on the given link has been switched.
std::optional< Mac48Address > GetMldAddress(const Mac48Address &remoteAddr) const
Mac48Address GetBssid(uint8_t linkId) const
Ptr< HeConfiguration > GetHeConfiguration() const
const std::map< uint8_t, std::unique_ptr< LinkEntity > > & GetLinks() const
Ptr< Txop > GetTxop() const
Accessor for the Txop object.
VhtCapabilities GetVhtCapabilities(uint8_t linkId) const
Return the VHT capabilities of the device for the given link.
Callback< void > m_linkDown
Callback when a link is down.
bool GetQosSupported() const
Return whether the device supports QoS.
Ptr< Txop > m_txop
TXOP used for transmission of frames to non-QoS peers.
Ptr< WifiMacQueueScheduler > GetMacQueueScheduler() const
Get the wifi MAC queue scheduler.
uint8_t GetNLinks() const
Get the number of links (can be greater than 1 for 11be devices only).
void SwapLinks(std::map< uint8_t, uint8_t > links)
Swap the links based on the information included in the given map.
void DoInitialize() override
Initialize() implementation.
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 g...
bool GetErpSupported(uint8_t linkId) const
Return whether the device supports ERP on the given link.
Ptr< QosTxop > GetVOQueue() const
Accessor for the AC_VO channel access function.
void SetTypeOfStation(TypeOfStation type)
This method is invoked by a subclass to specify what type of station it is implementing.
Ptr< WifiPhy > GetWifiPhy(uint8_t linkId=SINGLE_LINK_OP_ID) const
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 giv...
bool GetEhtSupported() const
Return whether the device supports EHT.
bool GetHeSupported() const
Return whether the device supports HE.
HtCapabilities GetHtCapabilities(uint8_t linkId) const
Return the HT capabilities of the device for the given link.
virtual std::optional< uint8_t > GetLinkIdByAddress(const Mac48Address &address) const
Get the ID of the link having the given MAC address, if any.
virtual bool HasFramesToTransmit(uint8_t linkId)
Check if the MAC has frames to transmit over the given link.
void ApplyTidLinkMapping(const Mac48Address &mldAddr, WifiDirection dir)
Apply the TID-to-Link Mapping negotiated with the given MLD for the given direction by properly confi...
Ptr< EhtConfiguration > GetEhtConfiguration() const
bool GetVhtSupported(uint8_t linkId) const
Return whether the device supports VHT on the given link.
virtual int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model.
virtual void DeaggregateAmsduAndForward(Ptr< const WifiMpdu > mpdu)
This method can be called to de-aggregate an A-MSDU and forward the constituent packets up the stack.
void SetBssid(Mac48Address bssid, uint8_t linkId)
Ptr< WifiNetDevice > GetDevice() const
Return the device this PHY is associated with.
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 negotiate...
ExtendedCapabilities GetExtendedCapabilities() const
Return the extended capabilities of the device.
He6GhzBandCapabilities GetHe6GhzBandCapabilities(uint8_t linkId) const
Return the HE 6GHz band capabilities of the device for the given 6 GHz link.
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,...
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.
bool GetShortSlotTimeSupported() const
void NotifyRxDrop(Ptr< const Packet > packet)
Ptr< WifiRemoteStationManager > GetWifiRemoteStationManager(uint8_t linkId=0) const
bool GetHtSupported(uint8_t linkId) const
Return whether the device supports HT on the given link.
void ForwardUp(Ptr< const Packet > packet, Mac48Address from, Mac48Address to)
Forward the packet up to the device.
bool Is6GhzBand(uint8_t linkId) const
Indicate if a given link is on the 6 GHz band.
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 bee...
Mac48Address GetAddress() const
EhtCapabilities GetEhtCapabilities(uint8_t linkId) const
Return the EHT capabilities of the device for the given link.
Callback< void > m_linkUp
Callback when a link is up.
LinkEntity & GetLink(uint8_t linkId) const
Get a reference to the link associated with the given ID.
HeCapabilities GetHeCapabilities(uint8_t linkId) const
Return the HE capabilities of the device for the given link.
virtual void SetWifiPhys(const std::vector< Ptr< WifiPhy > > &phys)
Ptr< QosTxop > GetQosTxop(AcIndex ac) const
Accessor for a specified EDCA object.
void DoDispose() override
Destructor implementation.
std::list< uint8_t > GetBssMembershipSelectorList() const
The WifiPhy::BssMembershipSelector() method is used (e.g., by a WifiRemoteStationManager) to determin...
static Time CalculateTxDuration(uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, uint16_t staId=SU_STA_ID)
void SetSlot(Time slot)
Set the slot duration for this PHY.
MHz_u GetChannelWidth() const
void SetOffMode()
Put in off mode.
std::list< WifiMode > GetMcsList() const
The WifiPhy::GetMcsList() method is used (e.g., by a WifiRemoteStationManager) to determine the set o...
std::list< WifiMode > GetModeList() const
The WifiPhy::GetModeList() method is used (e.g., by a WifiRemoteStationManager) to determine the set ...
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Ptr< const AttributeAccessor > MakePairAccessor(T1 a1)
Create an AttributeAccessor for std::pair<>.
Ptr< AttributeChecker > MakePairChecker()
Make a PairChecker without abscissa and ordinate AttributeCheckers.
Ptr< const AttributeAccessor > MakePointerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
Ptr< AttributeChecker > MakePointerChecker()
Create a PointerChecker for a type.
#define NS_ABORT_MSG(msg)
Unconditional abnormal program termination with a message.
#define NS_ABORT_MSG_IF(cond, msg)
Abnormal program termination if a condition is true, with a message.
#define NS_ABORT_IF(cond)
Abnormal program termination if a condition is true.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
#define NS_LOG_FUNCTION_NOARGS()
Output the name of the function.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Ptr< T > Create(Ts &&... args)
Create class instances by constructors with varying numbers of arguments and return them by Ptr.
Time MicroSeconds(uint64_t value)
Construct a Time in the indicated unit.
Time NanoSeconds(uint64_t value)
Construct a Time in the indicated unit.
Time Seconds(double value)
Construct a Time in the indicated unit.
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
WifiPowerManagementMode
Enumeration for power management modes.
WifiQueueBlockedReason
Enumeration of the reasons to block container queues.
@ WIFI_PM_SWITCHING_TO_ACTIVE
@ WIFI_PM_SWITCHING_TO_PS
@ WIFI_PHY_BAND_UNSPECIFIED
Unspecified.
@ WIFI_PHY_BAND_2_4GHZ
The 2.4 GHz band.
@ WIFI_MOD_CLASS_VHT
VHT (Clause 22)
@ WIFI_MOD_CLASS_HE
HE (Clause 27)
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Ptr< const AttributeChecker > MakeBooleanChecker()
Ptr< const AttributeChecker > MakeUintegerChecker()
Ptr< const AttributeAccessor > MakeTimeAccessor(T1 a1)
Callback< R, Args... > MakeCallback(R(T::*memPtr)(Args...), OBJ objPtr)
Build Callbacks for class method members which take varying numbers of arguments and potentially retu...
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
WifiTidToLinkMappingNegSupport
TID-to-Link Mapping Negotiation Support.
std::ostream & operator<<(std::ostream &os, const Angles &a)
const std::map< AcIndex, WifiAc > wifiAcList
Map containing the four ACs in increasing order of priority (according to Table 10-1 "UP-to-AC Mappin...
@ WIFI_MAC_MGT_PROBE_REQUEST
@ WIFI_MAC_MGT_ASSOCIATION_RESPONSE
@ WIFI_MAC_MGT_ASSOCIATION_REQUEST
@ WIFI_MAC_MGT_REASSOCIATION_REQUEST
@ WIFI_MAC_MGT_PROBE_RESPONSE
@ WIFI_MAC_MGT_REASSOCIATION_RESPONSE
bool TidToLinkMappingValidForNegType1(const WifiTidLinkMapping &dlLinkMapping, const WifiTidLinkMapping &ulLinkMapping)
Check if the given TID-to-Link Mappings are valid for a negotiation type of 1.
@ LOG_FUNCTION
Function tracing for non-trivial function calls.
Ptr< T1 > StaticCast(const Ptr< T2 > &p)
Cast a Ptr.
Ptr< const AttributeAccessor > MakeBooleanAccessor(T1 a1)
std::unordered_map< uint16_t, Ptr< const WifiPsdu > > WifiConstPsduMap
Map of const PSDUs indexed by STA-ID.
Ptr< const AttributeChecker > MakeTimeChecker()
Helper to make an unbounded Time checker.
Struct containing all supported rates.
void AddBssMembershipSelectorRate(uint64_t bs)
Add a special value to the supported rate set, corresponding to a BSS membership selector.
void AddSupportedRate(uint64_t bs)
Add the given rate to the supported rates.
std::optional< MldCapabilities > m_mldCapabilities
MLD Capabilities.
Struct to hold information regarding observed AP through active/passive scanning.
MgtFrameType m_frame
The body of the management frame used to update AP info.
WifiScanParams::Channel m_channel
The channel the management frame was received on.
Mac48Address m_apAddr
AP MAC address.
uint8_t m_linkId
ID of the link used to communicate with the AP.
Mac48Address m_bssid
BSSID.
double m_snr
SNR in linear scale.
Structure holding information specific to a single link.
bool sendAssocReq
whether this link is used to send the Association Request frame
std::optional< Mac48Address > bssid
BSSID of the AP to associate with over this link.
bool emlsrEnabled
whether EMLSR mode is enabled on this link
WifiPowerManagementMode pmMode
the current PM mode, if the STA is associated, or the PM mode to switch to upon association,...
~StaLinkEntity() override
Destructor (a virtual method is needed to make this struct polymorphic)
Ptr< WifiPhy > phy
Wifi PHY object.
Struct identifying a channel to scan.
WifiPhyBand band
PHY band.
uint16_t number
channel number
Structure holding scan parameters.
std::list< Channel > ChannelList
typedef for a list of channels
std::vector< ChannelList > channelList
list of channels to scan, for each link
Time probeDelay
delay prior to transmitting a Probe Request
WifiScanType type
indicates either active or passive scanning
Time maxChannelTime
maximum time to spend on each channel
Ssid ssid
desired SSID or wildcard SSID
Time minChannelTime
minimum time to spend on each channel