24#include "ns3/attribute-container.h"
25#include "ns3/eht-configuration.h"
26#include "ns3/emlsr-manager.h"
27#include "ns3/he-configuration.h"
28#include "ns3/ht-configuration.h"
30#include "ns3/packet.h"
32#include "ns3/pointer.h"
33#include "ns3/random-variable-stream.h"
34#include "ns3/simulator.h"
35#include "ns3/string.h"
56 .AddAttribute(
"ProbeRequestTimeout",
57 "The duration to actively probe the channel.",
61 .AddAttribute(
"WaitBeaconTimeout",
62 "The duration to dwell on a channel while passively scanning for beacon",
66 .AddAttribute(
"AssocRequestTimeout",
67 "The interval between two consecutive association request attempts.",
71 .AddAttribute(
"MaxMissedBeacons",
72 "Number of beacons which much be consecutively missed before "
73 "we attempt to restart association.",
79 "If true, we send probe requests. If false, we don't."
80 "NOTE: if more than one STA in your simulation is using active probing, "
81 "you should enable it at a different simulation time for each STA, "
82 "otherwise all the STAs will start sending probes at the same time resulting in "
84 "See bug 1060 for more info.",
88 .AddAttribute(
"ProbeDelay",
89 "Delay (in microseconds) to be used prior to transmitting a "
90 "Probe frame during active scanning.",
91 StringValue(
"ns3::UniformRandomVariable[Min=50.0|Max=250.0]"),
96 "Enable/disable power save mode on the given link. The power management mode is "
97 "actually changed when the AP acknowledges a frame sent with the Power Management "
98 "field set to the value corresponding to the requested mode",
104 .AddAttribute(
"PmModeSwitchTimeout",
105 "If switching to a new Power Management mode is not completed within "
106 "this amount of time, make another attempt at switching Power "
111 .AddTraceSource(
"Assoc",
112 "Associated with an access point. If this is an MLD that associated "
113 "with an AP MLD, the AP MLD address is provided.",
115 "ns3::Mac48Address::TracedCallback")
116 .AddTraceSource(
"LinkSetupCompleted",
117 "A link was setup in the context of ML setup with an AP MLD. "
118 "Provides ID of the setup link and AP MAC address",
120 "ns3::StaWifiMac::LinkSetupCallback")
121 .AddTraceSource(
"DeAssoc",
122 "Association with an access point lost. If this is an MLD "
123 "that disassociated with an AP MLD, the AP MLD address is provided.",
125 "ns3::Mac48Address::TracedCallback")
126 .AddTraceSource(
"BeaconArrival",
127 "Time of beacons arrival from associated AP",
129 "ns3::Time::TracedCallback")
130 .AddTraceSource(
"ReceivedBeaconInfo",
131 "Information about every received Beacon frame",
133 "ns3::ApInfo::TracedCallback")
134 .AddTraceSource(
"EmlsrLinkSwitch",
135 "Trace start/end of EMLSR link switch events: when a PHY operating on "
136 "a link starts switching, provides the ID of the link and a null "
137 "pointer (indicating no PHY is operating on that link); when a PHY "
138 "completes switching to a link, provides the ID of the link and a "
139 "pointer to the PHY (that is now operating on that link)",
141 "ns3::StaWifiMac::EmlsrLinkSwitchCallback");
146 : m_state(UNASSOCIATED),
148 m_assocRequestEvent()
218std::unique_ptr<WifiMac::LinkEntity>
221 return std::make_unique<StaLinkEntity>();
241 auto currentStream = stream + 1;
243 return (currentStream - stream);
282 NS_LOG_DEBUG(
"STA is still scanning, reset scanning process");
298 for (
auto& phy : phys)
300 phy->SetCapabilitiesChangedCallback(
309 const auto width = phy->GetOperatingChannel().IsOfdm() ? 20 : phy->GetChannelWidth();
310 uint8_t ch = phy->GetPrimaryChannelNumber(width);
311 return {ch, phy->GetPhyBand()};
317 std::stringstream ss;
320 std::copy(linkIds.cbegin(), linkIds.cend(), std::ostream_iterator<uint16_t>(ss,
" "));
324 for (
const auto& [linkId, lnk] :
GetLinks())
328 if (linkIds.contains(linkId))
331 link.emlsrEnabled =
true;
337 if (link.emlsrEnabled)
341 link.emlsrEnabled =
false;
390 packet->AddHeader(probe);
409std::variant<MgtAssocRequestHeader, MgtReassocRequestHeader>
414 std::variant<MgtAssocRequestHeader, MgtReassocRequestHeader> mgtFrame;
420 mgtFrame = std::move(reassoc);
428 auto fill = [&](
auto&& frame) {
429 frame.template Get<Ssid>() =
GetSsid();
431 frame.template Get<SupportedRates>() = supportedRates.rates;
432 frame.template Get<ExtendedSupportedRatesIE>() = supportedRates.extendedRates;
434 frame.SetListenInterval(0);
458 std::visit(fill, mgtFrame);
496 mldCapabilities.emplace();
497 mldCapabilities->maxNSimultaneousLinks =
GetNLinks() - 1;
498 mldCapabilities->srsSupport = 0;
503 mldCapabilities->tidToLinkMappingSupport =
504 static_cast<uint8_t
>(ehtConfiguration->m_tidLinkMappingSupport);
505 mldCapabilities->freqSepForStrApMld = 0;
506 mldCapabilities->aarSupport = 0;
512 for (
const auto& [index, link] :
GetLinks())
516 if (index != linkId && staLink.bssid.has_value())
528 perStaProfile.SetCompleteProfile();
533 perStaProfile.SetStaMacAddress(staLink.feManager->GetAddress());
538 return multiLinkElement;
541std::vector<TidToLinkMapping>
549 auto negSupport = ehtConfig->m_tidLinkMappingSupport;
552 "Cannot request TID-to-Link Mapping if negotiation is not supported");
562 "Mapping TIDs to distinct link sets is incompatible with negotiation support of 1");
571 NS_LOG_DEBUG(
"Using default mapping because AP MLD advertised negotiation support of 1");
576 std::vector<TidToLinkMapping> ret(1);
581 auto fillIe = [&ret](
const auto& mapping) {
582 ret.back().m_control.defaultMapping = mapping.empty();
584 for (
const auto& [tid, linkSet] : mapping)
590 NS_ABORT_MSG_IF(linkSet.empty(),
"Cannot map a TID to an empty link set");
591 ret.back().SetLinkMappingOfTid(tid, linkSet);
624 "No link selected to send the (Re)Association Request");
625 uint8_t linkId = it->first;
628 "No BSSID set for the link on which the (Re)Association Request is to be sent");
634 hdr.
SetAddr2(link.feManager->GetAddress());
649 auto addMle = [&](
auto&& frame) {
652 std::visit(addMle, frame);
655 if (
const auto& mldCapabilities =
658 mldCapabilities->get().tidToLinkMappingSupport)) >
661 auto addTlm = [&](
auto&& frame) {
664 std::visit(addTlm, frame);
670 packet->AddHeader(std::get<MgtAssocRequestHeader>(frame));
674 packet->AddHeader(std::get<MgtReassocRequestHeader>(frame));
750 for (
const auto& [
id, link] :
GetLinks())
778 if (!bestAp.has_value())
780 NS_LOG_DEBUG(
"Exhausted list of candidate AP; restart scanning");
785 NS_LOG_DEBUG(
"Attempting to associate with AP: " << *bestAp);
786 UpdateApInfo(bestAp->m_frame, bestAp->m_apAddr, bestAp->m_bssid, bestAp->m_linkId);
791 staLink.sendAssocReq =
false;
792 staLink.bssid = std::nullopt;
797 std::shared_ptr<CommonInfoBasicMle> mleCommonInfo;
800 std::visit([](
auto&& frame) {
return frame.template Get<MultiLinkElement>(); },
802 std::map<uint8_t, uint8_t> swapInfo;
803 for (
const auto& [localLinkId, apLinkId, bssid] : bestAp->m_setupLinks)
806 NS_LOG_DEBUG(
"Setting up link (local ID=" << +localLinkId <<
", AP ID=" << +apLinkId
811 mleCommonInfo = std::make_shared<CommonInfoBasicMle>(mle->GetCommonInfoBasic());
814 swapInfo.emplace(localLinkId, apLinkId);
820 auto getBeaconInterval = [](
auto&& frame) {
821 using T = std::decay_t<
decltype(frame)>;
822 if constexpr (std::is_same_v<T, MgtBeaconHeader> ||
823 std::is_same_v<T, MgtProbeResponseHeader>)
833 Time beaconInterval = std::visit(getBeaconInterval, bestAp->m_frame);
872 for (
const auto& [
id, link] :
GetLinks())
874 if (link->phy && link->phy->IsStateRx())
876 delay = std::max(delay, link->phy->GetDelayUntilIdle());
889 for (
const auto& [
id, link] :
GetLinks())
896 bssid = std::nullopt;
899 NS_LOG_DEBUG(
"Set state to UNASSOCIATED and start scanning");
941 std::set<uint8_t> linkIds;
942 for (
const auto& [
id, link] :
GetLinks())
955 for (
const auto& [
id, link] :
GetLinks())
960 return link->feManager->GetAddress();
986 auto& hdr = mpdu->GetHeader();
992 uint8_t linkId = *linkIds.begin();
995 hdr.SetAddr1(apMldAddr.value_or(
GetBssid(linkId)));
1031 std::stringstream ss;
1032 std::copy(linkIds.cbegin(), linkIds.cend(), std::ostream_iterator<uint16_t>(ss,
" "));
1035 const auto linkId = *linkIds.cbegin();
1036 const auto bssid =
GetBssid(linkId);
1037 const auto apAddress =
1059 const WifiMacHeader* hdr = &mpdu->GetOriginal()->GetHeader();
1079 NS_LOG_LOGIC(
"Received data frame while not associated: ignore");
1085 NS_LOG_LOGIC(
"Received data frame not from the DS: ignore");
1089 std::set<Mac48Address> apAddresses;
1094 if (!apAddresses.contains(mpdu->GetHeader().GetAddr2()))
1096 NS_LOG_LOGIC(
"Received data frame not from the BSS we are associated with: ignore");
1102 NS_LOG_LOGIC(
"Received (QoS) Null Data frame: ignore");
1110 NS_ASSERT(apAddresses.contains(mpdu->GetHeader().GetAddr3()));
1151 action.protectedEhtAction ==
1178 mpdu->GetPacket()->PeekHeader(beacon);
1187 goodBeacon = bssid.has_value() && (hdr.
GetAddr3() == *bssid);
1197 bool found = mpdu->GetPacket()->PeekPacketTag(snrTag);
1201 .m_snr = snrTag.
Get(),
1202 .m_frame = std::move(beacon),
1204 .m_linkId = linkId};
1240 mpdu->GetPacket()->PeekHeader(probeResp);
1246 bool found = mpdu->GetPacket()->PeekPacketTag(snrTag);
1250 .m_snr = snrTag.
Get(),
1251 .m_frame = std::move(probeResp),
1252 .m_channel = {GetCurrentChannel(linkId)},
1253 .m_linkId = linkId});
1268 std::optional<Mac48Address> apMldAddress;
1270 mpdu->GetPacket()->PeekHeader(assocResp);
1290 if (
const auto& mldCapabilities =
1293 mldCapabilities->get().tidToLinkMappingSupport) >
1342 std::list<uint8_t> setupLinks;
1343 for (
const auto& [
id, link] :
GetLinks())
1345 setupLinks.push_back(
id);
1349 setupLinks.remove(linkId);
1356 "The link on which the Association Response was received "
1357 "is not a link we requested to setup");
1359 "The link ID of the AP that transmitted the Association "
1360 "Response does not match the stored link ID");
1362 mle->GetMldMacAddress(),
1363 "The AP MLD MAC address in the received Multi-Link Element does not "
1364 "match the address stored in the station manager for link "
1367 for (std::size_t elem = 0; elem < mle->GetNPerStaProfileSubelements(); elem++)
1369 auto& perStaProfile = mle->GetPerStaProfile(elem);
1370 uint8_t apLinkId = perStaProfile.GetLinkId();
1371 auto it =
GetLinks().find(apLinkId);
1372 uint8_t staLinkid = 0;
1373 std::optional<Mac48Address> bssid;
1375 !(bssid =
GetLink((staLinkid = it->first)).
bssid).has_value(),
1376 "Setup for AP link ID " << apLinkId <<
" was not requested");
1378 "The BSSID in the Per-STA Profile for link ID "
1379 << +staLinkid <<
" does not match the stored BSSID");
1382 perStaProfile.GetStaMacAddress()) != mle->GetMldMacAddress(),
1383 "The AP MLD MAC address in the received Multi-Link Element does not "
1384 "match the address stored in the station manager for link "
1391 "AID should be the same for all the links");
1393 NS_LOG_DEBUG(
"Setup on link " << staLinkid <<
" completed");
1405 setupLinks.remove(staLinkid);
1409 for (
const auto&
id : setupLinks)
1424 for (
const auto& [
id, link] :
GetLinks())
1428 if (
const auto txop =
GetTxop())
1430 txop->StartAccessAfterEvent(
id,
1438 edca->StartAccessAfterEvent(
id,
1459 NS_ASSERT_MSG(psduMap.size() == 1 && psduMap.begin()->second->GetNMpdus() == 1 &&
1460 psduMap.begin()->second->GetHeader(0).IsAck(),
1461 "Expected a Normal Ack after Association Response frame");
1466 for (
const auto& [
id, lnk] :
GetLinks())
1493 std::pair<bool, uint8_t>{
true,
id});
1514 std::pair<bool, uint8_t>{
false,
id});
1524 phy->TraceConnectWithoutContext(
"PhyTxPsduBegin", cb);
1526 [=]() { phy->TraceDisconnectWithoutContext(
"PhyTxPsduBegin", cb); });
1536 auto check = [&](
auto&& mgtFrame) ->
bool {
1538 NS_ASSERT(mgtFrame.template Get<SupportedRates>());
1540 mgtFrame.template Get<ExtendedSupportedRatesIE>()};
1543 if (!rates.IsBssMembershipSelectorRate(selector))
1545 NS_LOG_DEBUG(
"Supported rates do not fit with the BSS membership selector");
1553 return std::visit(
check, frame);
1565 const std::optional<ErpInformation>* erpInformation =
nullptr;
1567 if (
const auto* beacon = std::get_if<MgtBeaconHeader>(&frame))
1571 else if (
const auto* probe = std::get_if<MgtProbeResponseHeader>(&frame))
1577 auto commonOps = [&](
auto&& frame) {
1578 const auto& capabilities = frame.Capabilities();
1579 NS_ASSERT(frame.template Get<SupportedRates>());
1581 frame.template Get<ExtendedSupportedRatesIE>()};
1584 if (rates.IsSupportedRate(mode.GetDataRate(
GetWifiPhy(linkId)->GetChannelWidth())))
1587 if (rates.IsBasicRate(mode.GetDataRate(
GetWifiPhy(linkId)->GetChannelWidth())))
1594 bool isShortPreambleEnabled = capabilities.IsShortPreamble();
1595 if (erpInformation && erpInformation->has_value() &&
GetErpSupported(linkId))
1597 isShortPreambleEnabled &= !(*erpInformation)->GetBarkerPreambleMode();
1598 if ((*erpInformation)->GetUseProtection() != 0)
1606 if (capabilities.IsShortSlotTime() ==
true)
1619 capabilities.IsShortSlotTime());
1626 bool qosSupported =
false;
1627 const auto& edcaParameters = frame.template Get<EdcaParameterSet>();
1628 if (edcaParameters.has_value())
1630 qosSupported =
true;
1634 edcaParameters->GetBeCWmin(),
1635 edcaParameters->GetBeCWmax(),
1636 edcaParameters->GetBeAifsn(),
1640 edcaParameters->GetBkCWmin(),
1641 edcaParameters->GetBkCWmax(),
1642 edcaParameters->GetBkAifsn(),
1646 edcaParameters->GetViCWmin(),
1647 edcaParameters->GetViCWmax(),
1648 edcaParameters->GetViAifsn(),
1652 edcaParameters->GetVoCWmin(),
1653 edcaParameters->GetVoCWmax(),
1654 edcaParameters->GetVoAifsn(),
1663 if (
const auto& htCapabilities = frame.template Get<HtCapabilities>();
1664 htCapabilities.has_value())
1681 const auto& vhtCapabilities = frame.template Get<VhtCapabilities>();
1684 if (vhtCapabilities.has_value() &&
1685 vhtCapabilities->GetRxHighestSupportedLgiDataRate() > 0)
1692 if (vhtCapabilities->IsSupportedRxMcs(mcs.GetMcsValue()))
1705 const auto& heCapabilities = frame.template Get<HeCapabilities>();
1706 if (heCapabilities.has_value() && heCapabilities->GetSupportedMcsAndNss() != 0)
1711 if (heCapabilities->IsSupportedRxMcs(mcs.GetMcsValue()))
1716 if (
const auto& heOperation = frame.template Get<HeOperation>();
1717 heOperation.has_value())
1723 const auto& muEdcaParameters = frame.template Get<MuEdcaParameterSet>();
1724 if (muEdcaParameters.has_value())
1727 muEdcaParameters->GetMuCwMin(
AC_BE),
1728 muEdcaParameters->GetMuCwMax(
AC_BE),
1729 muEdcaParameters->GetMuAifsn(
AC_BE),
1730 muEdcaParameters->GetMuEdcaTimer(
AC_BE)},
1733 muEdcaParameters->GetMuCwMin(
AC_BK),
1734 muEdcaParameters->GetMuCwMax(
AC_BK),
1735 muEdcaParameters->GetMuAifsn(
AC_BK),
1736 muEdcaParameters->GetMuEdcaTimer(
AC_BK)},
1739 muEdcaParameters->GetMuCwMin(
AC_VI),
1740 muEdcaParameters->GetMuCwMax(
AC_VI),
1741 muEdcaParameters->GetMuAifsn(
AC_VI),
1742 muEdcaParameters->GetMuEdcaTimer(
AC_VI)},
1745 muEdcaParameters->GetMuCwMin(
AC_VO),
1746 muEdcaParameters->GetMuCwMax(
AC_VO),
1747 muEdcaParameters->GetMuAifsn(
AC_VO),
1748 muEdcaParameters->GetMuEdcaTimer(
AC_VO)},
1754 if (
const auto& he6GhzCapabilities = frame.template Get<He6GhzBandCapabilities>())
1758 *he6GhzCapabilities);
1767 const auto& ehtCapabilities = frame.template Get<EhtCapabilities>();
1772 if (
const auto& mle = frame.template Get<MultiLinkElement>(); mle &&
m_emlsrManager)
1774 if (mle->HasEmlCapabilities())
1776 m_emlsrManager->SetTransitionTimeout(mle->GetTransitionTimeout());
1778 if (
const auto& common = mle->GetCommonInfoBasic(); common.m_mediumSyncDelayInfo)
1780 m_emlsrManager->SetMediumSyncDuration(common.GetMediumSyncDelayTimer());
1781 m_emlsrManager->SetMediumSyncOfdmEdThreshold(common.GetMediumSyncOfdmEdThreshold());
1782 m_emlsrManager->SetMediumSyncMaxNTxops(common.GetMediumSyncMaxNTxops());
1788 std::visit(commonOps, frame);
1794 const auto [enable, linkId] = enableLinkIdPair;
1801 NS_LOG_DEBUG(
"Not associated yet, record the PM mode to switch to upon association");
1808 NS_LOG_DEBUG(
"Link " << +linkId <<
" has not been setup, ignore request");
1829 NS_LOG_DEBUG(
"Next transmitted frame will be sent with PM=" << enable);
1869 auto linkIds = mpdu->GetInFlightLinkIds();
1871 "The TA of the acked MPDU (" << *mpdu
1872 <<
") is not a link "
1873 "address and the MPDU is not inflight");
1878 linkId = *linkIds.begin();
1879 mpdu =
GetTxopQueue(mpdu->GetQueueAc())->GetAlias(mpdu, *linkId);
1882 auto& link =
GetLink(*linkId);
1903 NS_LOG_DEBUG(
"Adding supported rate of " << modeDataRate);
1923 return capabilities;
1936 edca->SetMinCw(params.cwMin, linkId);
1937 edca->SetMaxCw(params.cwMax, linkId);
1938 edca->SetAifsn(params.aifsn, linkId);
1939 edca->SetTxopLimit(params.txopLimit, linkId);
1946 edca->SetMuCwMin(params.cwMin, linkId);
1947 edca->SetMuCwMax(params.cwMax, linkId);
1948 edca->SetMuAifsn(params.aifsn, linkId);
1949 edca->SetMuEdcaTimer(params.muEdcaTimer, linkId);
1958 NS_LOG_DEBUG(
"PHY capabilities changed: send reassociation request");
2018 for (
auto& [
id, link] :
GetLinks())
2020 if (link->phy == phy &&
id != linkId)
2022 link->phy =
nullptr;
2028 auto connectPhy = [=,
this]()
mutable {
2029 auto& newLink =
GetLink(linkId);
2033 newLink.channelAccessManager->SetupPhyListener(phy);
2037 newLink.channelAccessManager->ResetState();
2040 newLink.feManager->ResetPhy();
2042 newLink.feManager->SetWifiPhy(phy);
2044 newLink.stationManager->SetupPhy(phy);
2052 eventIt->second.Cancel();
2080 os <<
"BSSID=" << apInfo.
m_bssid <<
", AP addr=" << apInfo.
m_apAddr <<
", SNR=" << apInfo.
m_snr
2082 <<
"}, Link ID=" << +apInfo.
m_linkId <<
", Frame=[";
2083 std::visit([&os](
auto&& frame) { frame.Print(os); }, apInfo.
m_frame);
A container for one type of attribute.
AttributeValue implementation for Boolean.
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 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.
Introspection did not find any typical Config paths.
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.
void DoDispose() override
Destructor implementation.
void SendProbeRequest(uint8_t linkId)
Enqueue a probe request packet for transmission on the given link.
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.
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 GetMultiLinkElement(bool isReassoc, uint8_t linkId) const
Return the Multi-Link Element to include in the management frames transmitted on the given link.
EventId m_assocRequestEvent
association request event
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.
AttributeValue implementation for Time.
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 AttributeChecker > MakeBooleanChecker()
Ptr< const AttributeAccessor > MakeBooleanAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
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.
Ptr< const AttributeAccessor > MakeTimeAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
Ptr< const AttributeChecker > MakeTimeChecker()
Helper to make an unbounded Time checker.
Ptr< const AttributeChecker > MakeUintegerChecker()
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
#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_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.
std::unordered_map< uint16_t, Ptr< const WifiPsdu > > WifiConstPsduMap
Map of const PSDUs indexed by STA-ID.
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...
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.
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