27#include "ns3/ap-emlsr-manager.h"
28#include "ns3/eht-configuration.h"
29#include "ns3/eht-frame-exchange-manager.h"
30#include "ns3/he-configuration.h"
31#include "ns3/ht-configuration.h"
33#include "ns3/packet.h"
34#include "ns3/pointer.h"
35#include "ns3/random-variable-stream.h"
36#include "ns3/simulator.h"
37#include "ns3/string.h"
56 "Delay between two beacons",
60 .AddAttribute(
"BeaconJitter",
61 "A uniform random variable to cause the initial beacon starting time "
62 "(after simulation time 0) "
63 "to be distributed between 0 and the BeaconInterval.",
67 .AddAttribute(
"EnableBeaconJitter",
68 "If beacons are enabled, whether to jitter the initial send event.",
72 .AddAttribute(
"BeaconGeneration",
73 "Whether or not beacons are generated.",
77 .AddAttribute(
"FdBeaconInterval6GHz",
78 "Time between a Beacon frame and a FILS Discovery (FD) frame or between "
79 "two FD frames to be sent on a 6GHz link. A value of zero disables the "
80 "transmission of FD frames.",
84 .AddAttribute(
"FdBeaconIntervalNon6GHz",
85 "Time between a Beacon frame and a FILS Discovery (FD) frame or between "
86 "two FD frames to be sent on a non-6GHz link. A value of zero disables "
87 "the transmission of FD frames.",
91 .AddAttribute(
"SendUnsolProbeResp",
92 "Send unsolicited broadcast Probe Response instead of FILS Discovery",
96 .AddAttribute(
"EnableNonErpProtection",
97 "Whether or not protection mechanism should be used when non-ERP STAs "
98 "are present within the BSS."
99 "This parameter is only used when ERP is supported by the AP.",
103 .AddAttribute(
"BsrLifetime",
104 "Lifetime of Buffer Status Reports received from stations.",
110 "The CW min values that the AP advertises in EDCA Parameter Set elements and the "
111 "associated stations will use. The value of this attribute is an AC-indexed map "
112 "containing the CW min values for given ACs for all the links (sorted in "
113 "increasing order of link ID). If no values are provided for an AC, the same "
114 "values used by the AP are advertised. In case a string is used to set this "
115 "attribute, the string shall contain the pairs separated by a semicolon (;); "
116 "in every pair, the AC index and the list of values are separated by a blank "
117 "space, and the values of a list are separated by a comma (,) without spaces. "
118 "E.g. \"BE 31,31,31; VI 15,15,15\" defines the CW min values for AC BE and AC VI "
119 "for an AP MLD having three links.",
126 "The CW max values that the AP advertises in EDCA Parameter Set elements and the "
127 "associated stations will use. The value of this attribute is an AC-indexed map "
128 "containing the CW max values for given ACs for all the links (sorted in "
129 "increasing order of link ID). If no values are provided for an AC, the same "
130 "values used by the AP are advertised. In case a string is used to set this "
131 "attribute, the string shall contain the pairs separated by a semicolon (;); "
132 "in every pair, the AC index and the list of values are separated by a blank "
133 "space, and the values of a list are separated by a comma (,) without spaces. "
134 "E.g. \"BE 31,31,31; VI 15,15,15\" defines the CW max values for AC BE and AC VI "
135 "for an AP MLD having three links.",
142 "The AIFSN values that the AP advertises in EDCA Parameter Set elements and the "
143 "associated stations will use. The value of this attribute is an AC-indexed map "
144 "containing the AIFSN values for given ACs for all the links (sorted in "
145 "increasing order of link ID). If no values are provided for an AC, the same "
146 "values used by the AP are advertised. In case a string is used to set this "
147 "attribute, the string shall contain the pairs separated by a semicolon (;); "
148 "in every pair, the AC index and the list of values are separated by a blank "
149 "space, and the values of a list are separated by a comma (,) without spaces. "
150 "E.g. \"BE 3,3,3; VI 2,2,2\" defines the AIFSN values for AC BE and AC VI "
151 "for an AP MLD having three links.",
158 "The TXOP limit values that the AP advertises in EDCA Parameter Set elements and "
159 "the associated stations will use. The value of this attribute is an AC-indexed "
160 "map containing the TXOP limit values for given ACs for all the links (sorted in "
161 "increasing order of link ID). If no values are provided for an AC, the same "
162 "values used by the AP are advertised. In case a string is used to set this "
163 "attribute, the string shall contain the pairs separated by a semicolon (;); "
164 "in every pair, the AC index and the list of values are separated by a blank "
165 "space, and the values of a list are separated by a comma (,) without spaces. "
166 "E.g. \"BE 3200us,3200us,3200us; VI 2400us,2400us,2400us\" defines the TXOP limit "
167 "values for AC BE and AC VI for an AP MLD having three links.",
172 .AddAttribute(
"GcrManager",
173 "The GCR manager object.",
179 .AddTraceSource(
"AssociatedSta",
180 "A station associated with this access point.",
182 "ns3::ApWifiMac::AssociationCallback")
183 .AddTraceSource(
"DeAssociatedSta",
184 "A station lost association with this access point.",
186 "ns3::ApWifiMac::AssociationCallback");
212 : m_enableBeaconGeneration(false),
213 m_grpAddrBuIndicExp(0)
254std::unique_ptr<WifiMac::LinkEntity>
257 return std::make_unique<ApLinkEntity>();
342 for (uint8_t linkId = 0; linkId <
GetNLinks(); linkId++)
370 for (uint8_t linkId = 0; linkId <
GetNLinks(); ++linkId)
410 NS_FATAL_ERROR(
"beacon interval should be multiple of 1024us (802.11 time unit), see IEEE "
416 "beacon interval should be smaller then or equal to 65535 * 1024us (802.11 time unit)");
426 auto currentStream = stream + 1;
429 return (currentStream - stream);
439 for (
const auto& sta : link.staList)
443 link.shortSlotTimeEnabled =
false;
447 link.shortSlotTimeEnabled =
true;
451 link.shortSlotTimeEnabled =
false;
462 for (
const auto& sta : link.staList)
467 link.shortPreambleEnabled =
false;
471 link.shortPreambleEnabled =
true;
475 link.shortPreambleEnabled =
false;
490 std::list<Mac48Address> addr2Set;
494 for (uint8_t linkId = 0; linkId <
GetNLinks(); linkId++)
505 NS_ASSERT_MSG(linkId,
"Station " << to <<
"is not associated, cannot send it a frame");
512 for (
auto addr2 = addr2Set.cbegin(); addr2 != addr2Set.cend(); ++addr2)
514 auto& hdr = mpdu->GetHeader();
517 hdr.SetAddr2(*addr2);
527 if (std::next(addr2) != addr2Set.cend())
551 NS_LOG_DEBUG(
"Adding supported rate of " << modeDataRate);
559 NS_LOG_DEBUG(
"Adding basic mode " << mode.GetUniqueName());
593 return dsssParameters;
616 if (
GetLink(linkId).shortPreambleEnabled)
641 : edca->GetMinCw(linkId));
643 : edca->GetMaxCw(linkId));
645 : edca->GetAifsn(linkId));
647 : edca->GetTxopLimit(linkId);
653 : edca->GetMinCw(linkId));
655 : edca->GetMaxCw(linkId));
657 : edca->GetAifsn(linkId));
659 : edca->GetTxopLimit(linkId);
665 : edca->GetMinCw(linkId));
667 : edca->GetMaxCw(linkId));
669 : edca->GetAifsn(linkId));
671 : edca->GetTxopLimit(linkId);
677 : edca->GetMinCw(linkId));
679 : edca->GetMaxCw(linkId));
681 : edca->GetAifsn(linkId));
683 : edca->GetTxopLimit(linkId);
688 return edcaParameters;
691std::optional<MuEdcaParameterSet>
725 auto timerNotNull = [&muEdcaParameters](uint8_t aci) {
728 auto aci = {0, 1, 2, 3};
729 if (std::all_of(aci.begin(), aci.end(), timerNotNull))
731 return muEdcaParameters;
735 "MU EDCA Timers must be all zero if the IE is not advertised.");
740std::optional<ReducedNeighborReport>
753 for (uint8_t index = 0; index <
GetNLinks(); ++index)
775 const std::optional<MultiLinkElement>& mlProbeReqMle)
780 "ML Probe Request Multi-Link Element cannot be provided for frame type "
791 if (ehtConfiguration->m_emlsrActivated)
810 commonInfo.SetMediumSyncOfdmEdThreshold(ehtConfiguration->m_msdOfdmEdThreshold);
811 commonInfo.SetMediumSyncMaxNTxops(ehtConfiguration->m_msdMaxNTxops);
824 mldCapabilities.emplace();
825 mldCapabilities->maxNSimultaneousLinks =
GetNLinks() - 1;
826 mldCapabilities->srsSupport = 0;
827 mldCapabilities->tidToLinkMappingSupport =
828 static_cast<uint8_t
>(ehtConfiguration->m_tidLinkMappingSupport);
829 mldCapabilities->freqSepForStrApMld = 0;
830 mldCapabilities->aarSupport = 0;
838 staMldAddress.has_value())
840 for (uint8_t i = 0; i <
GetNLinks(); i++)
843 if (
auto staAddress = remoteStationManager->GetAffiliatedStaAddress(*staMldAddress);
844 i != linkId && staAddress.has_value() &&
845 (remoteStationManager->IsWaitAssocTxOk(*staAddress) ||
846 remoteStationManager->IsAssocRefused(*staAddress)))
859 perStaProfile.SetCompleteProfile();
863 perStaProfile.SetAssocResponse(
GetAssocResp(*staAddress, i));
868 if (!mlProbeReqMle.has_value())
875 "Invalid MLE variant " << reqVar);
885 auto apMldId = mlProbeReqMle->GetApMldId();
886 NS_ASSERT_MSG(apMldId.has_value(),
"AP MLD ID subfield missing");
892 NS_ASSERT_MSG(*apMldId == 0,
"AP MLD ID expected value is 0. value = " << +apMldId.value());
895 std::set<uint8_t> respLinkIds{};
896 if (
const auto nProfiles = mlProbeReqMle->GetNPerStaProfileSubelements(); nProfiles == 0)
902 for (std::size_t i = 0; i <
GetNLinks(); ++i)
906 respLinkIds.insert(i);
911 for (std::size_t i = 0; i < mlProbeReqMle->GetNPerStaProfileSubelements(); ++i)
918 const auto& perStaProfile = mlProbeReqMle->GetPerStaProfile(i);
919 auto currLinkId = perStaProfile.GetLinkId();
920 if ((currLinkId <
GetNLinks()) && (currLinkId != linkId))
922 respLinkIds.insert(currLinkId);
926 auto setPerStaProfile = [&](uint8_t id) ->
void {
933 perStaProfile.SetCompleteProfile();
936 std::for_each(respLinkIds.begin(), respLinkIds.end(), setPerStaProfile);
952 if (phy->GetChannelWidth() >
MHz_u{20})
957 if (
GetLink(linkId).numNonHtStations == 0)
965 uint64_t maxSupportedRate = 0;
968 uint8_t nss = (mcs.GetMcsValue() / 8) + 1;
971 mcs.GetDataRate(phy->GetChannelWidth(),
974 if (dataRate > maxSupportedRate)
976 maxSupportedRate = dataRate;
977 NS_LOG_DEBUG(
"Updating maxSupportedRate to " << maxSupportedRate);
980 uint8_t maxSpatialStream = phy->GetMaxSupportedTxSpatialStreams();
982 uint8_t nMcs = mcsList.size();
985 if (remoteStationManager->GetHtSupported(sta.second) ||
986 remoteStationManager->GetStationHe6GhzCapabilities(sta.second))
988 uint64_t maxSupportedRateByHtSta = 0;
989 auto itMcs = mcsList.begin();
991 j < (std::min(nMcs, remoteStationManager->GetNMcsSupported(sta.second)));
998 remoteStationManager->GetChannelWidthSupported(sta.second),
999 NanoSeconds(remoteStationManager->GetShortGuardIntervalSupported(sta.second)
1003 if (dataRate > maxSupportedRateByHtSta)
1005 maxSupportedRateByHtSta = dataRate;
1008 if (maxSupportedRateByHtSta < maxSupportedRate)
1010 maxSupportedRate = maxSupportedRateByHtSta;
1012 if (remoteStationManager->GetNMcsSupported(sta.second) < nMcs)
1014 nMcs = remoteStationManager->GetNMcsSupported(sta.second);
1016 if (remoteStationManager->GetNumberOfSupportedStreams(sta.second) < maxSpatialStream)
1018 maxSpatialStream = remoteStationManager->GetNumberOfSupportedStreams(sta.second);
1023 static_cast<uint16_t
>(maxSupportedRate / 1e6));
1050 const auto bssBandwidth = phy->GetChannelWidth();
1062 ? phy->GetPrimaryChannelNumber(
MHz_u{80})
1063 : phy->GetChannelNumber());
1070 const auto& operatingChannel = phy->GetOperatingChannel();
1071 const auto is80Plus80 =
1074 ? is80Plus80 ? operatingChannel.GetNumber(1)
1075 : phy->GetChannelNumber()
1077 uint8_t maxSpatialStream = phy->GetMaxSupportedRxSpatialStreams();
1080 if (remoteStationManager->GetVhtSupported(sta.second))
1082 if (remoteStationManager->GetNumberOfSupportedStreams(sta.second) < maxSpatialStream)
1084 maxSpatialStream = remoteStationManager->GetNumberOfSupportedStreams(sta.second);
1088 for (uint8_t nss = 1; nss <= maxSpatialStream; nss++)
1109 if (remoteStationManager->GetHeSupported(sta.second))
1111 if (remoteStationManager->GetNumberOfSupportedStreams(sta.second) < maxSpatialStream)
1113 maxSpatialStream = remoteStationManager->GetNumberOfSupportedStreams(sta.second);
1117 for (uint8_t nss = 1; nss <= maxSpatialStream; nss++)
1128 const auto bw = phy->GetChannelWidth();
1129 const auto ch = phy->GetOperatingChannel();
1136 op6Ghz.m_chCntrFreqSeg1 = (bw ==
MHz_u{160}) ? ch.GetNumber() : 0;
1155 if (remoteStationManager->GetEhtSupported(sta.second))
1157 if (remoteStationManager->GetNumberOfSupportedStreams(sta.second) < maxSpatialStream)
1159 maxSpatialStream = remoteStationManager->GetNumberOfSupportedStreams(sta.second);
1182 packet->AddHeader(probeResp);
1216 GetLink(linkId).shortPreambleEnabled);
1218 GetLink(linkId).shortSlotTimeEnabled);
1307 if (remoteStationManager->IsWaitAssocTxOk(to))
1313 NS_ABORT_IF(!remoteStationManager->IsAssocRefused(to));
1315 remoteStationManager->RecordDisassociated(to);
1373 linkIdStaAddrMap[linkId] = to;
1380 "Sending a Multi-Link Element to a single link device");
1381 for (std::size_t idx = 0; idx < mle->GetNPerStaProfileSubelements(); idx++)
1383 auto& perStaProfile = mle->GetPerStaProfile(idx);
1384 if (perStaProfile.HasAssocResponse() &&
1385 perStaProfile.GetAssocResponse().GetStatusCode().IsSuccess())
1387 uint8_t otherLinkId = perStaProfile.GetLinkId();
1389 ->GetAffiliatedStaAddress(*staMldAddress);
1391 "No STA to associate with on link " << +otherLinkId);
1392 const auto [it, inserted] = linkIdStaAddrMap.insert({otherLinkId, *staAddress});
1394 "More than one Association Response to MLD "
1395 << *staMldAddress <<
" on link ID " << +otherLinkId);
1400 return linkIdStaAddrMap;
1406 if (linkIdStaAddrMap.empty())
1412 const auto& [linkId, staAddr] = *linkIdStaAddrMap.cbegin();
1416 std::set<uint16_t> aids;
1418 for (
const auto& [
id, link] :
GetLinks())
1420 if (
const auto aid = link->stationManager->GetAssociationId(addr); aid !=
SU_STA_ID)
1426 NS_ABORT_MSG_IF(aids.size() > 1, addr <<
" cannot have more than one AID assigned");
1433 NS_ABORT_MSG_IF(!inserted,
"AID " << aid <<
" already present, cannot be assigned to " << addr);
1435 for (
const auto& [
id, staAddr] : linkIdStaAddrMap)
1439 if (
const auto [it, inserted] = link.staList.emplace(aid, staAddr); inserted)
1442 link.stationManager->SetAssociationId(staAddr, aid);
1444 if (link.stationManager->GetDsssSupported(staAddr) &&
1445 !link.stationManager->GetErpOfdmSupported(staAddr))
1447 link.numNonErpStations++;
1449 if (!link.stationManager->GetHtSupported(staAddr) &&
1450 !link.stationManager->GetStationHe6GhzCapabilities(staAddr))
1452 link.numNonHtStations++;
1461 "AID " << it->first <<
" already assigned to " << staAddr
1462 <<
", could not assign " << aid);
1477 for (std::size_t idx = 0; idx < mle->GetNPerStaProfileSubelements(); idx++)
1479 if (
const auto& perStaProfile = mle->GetPerStaProfile(idx);
1480 perStaProfile.HasAssocResponse() &&
1481 perStaProfile.GetAssocResponse().GetStatusCode().IsSuccess())
1483 perStaProfile.GetAssocResponse().SetAssociationId(aid);
1516 SetAid(assoc, linkIdStaAddrMap);
1519 packet->AddHeader(assoc);
1550 hdr.
SetAddr2(link.feManager->GetAddress());
1551 hdr.
SetAddr3(link.feManager->GetAddress());
1629 packet->AddHeader(beacon);
1631 NS_LOG_INFO(
"Generating beacon from " << link.feManager->GetAddress() <<
" linkID " << +linkId);
1644 if (link.shortSlotTimeEnabled)
1663 hdr.
SetAddr2(link.feManager->GetAddress());
1664 hdr.
SetAddr3(link.feManager->GetAddress());
1678 fils.
m_fdCap->SetOpChannelWidth(link.phy->GetChannelWidth());
1679 fils.
m_fdCap->SetMaxNss(std::min(link.phy->GetMaxSupportedTxSpatialStreams(),
1680 link.phy->GetMaxSupportedRxSpatialStreams()));
1681 fils.
m_fdCap->SetStandard(link.phy->GetStandard());
1687 packet->AddHeader(fils);
1688 packet->AddHeader(actionHdr);
1702 if (!fdBeaconInterval.IsStrictlyPositive())
1704 NS_LOG_DEBUG(
"Sending FILS Discovery/unsolicited Probe Response disabled");
1709 for (uint8_t count = 1; count < (
m_beaconInterval / fdBeaconInterval).GetHigh(); ++count)
1737 mpdu->GetPacket()->PeekHeader(assocResp);
1750 if (
auto staMldAddress =
1752 staMldAddress.has_value())
1765 for (uint8_t i = 0; i <
GetNLinks(); i++)
1768 if (
auto staAddress = stationManager->GetAffiliatedStaAddress(*staMldAddress);
1769 staAddress.has_value() && i != *linkId &&
1770 stationManager->IsWaitAssocTxOk(*staAddress))
1773 <<
" associated with STA=" << *staAddress);
1774 stationManager->RecordGotAssocTxOk(*staAddress);
1784 if (
auto extendedCapabilities =
1789 const auto isGcrCapable =
1790 extendedCapabilities && extendedCapabilities->m_robustAvStreaming;
1798 action.protectedEhtAction ==
1808 eventIt->second.PeekEventImpl()->Invoke();
1809 eventIt->second.Cancel();
1829 <<
" association failed with STA=" << hdr.
GetAddr1());
1833 if (
auto staMldAddress =
1835 staMldAddress.has_value())
1838 for (uint8_t i = 0; i <
GetNLinks(); i++)
1841 if (
auto staAddress = stationManager->GetAffiliatedStaAddress(*staMldAddress);
1842 staAddress.has_value() && i != *linkId &&
1843 stationManager->IsWaitAssocTxOk(*staAddress))
1846 <<
" association failed with STA=" << *staAddress);
1847 stationManager->RecordGotAssocTxFailed(*staAddress);
1854 mpdu->GetPacket()->PeekHeader(assocResp);
1857 for (
const auto& [
id, lnk] :
GetLinks())
1860 link.staList.erase(aid);
1873 if (!staInPsMode && mpdu->GetHeader().IsPowerManagement())
1878 else if (staInPsMode && !mpdu->GetHeader().IsPowerManagement())
1893 NS_LOG_DEBUG(
"Block destination " << staAddr <<
" on link " << +linkId);
1908 NS_LOG_DEBUG(
"Unblock destination " << staAddr <<
" on link " << +linkId);
1915std::optional<uint8_t>
1918 for (uint8_t linkId = 0; linkId <
GetNLinks(); linkId++)
1926 return std::nullopt;
1937std::optional<Mac48Address>
1943 return staIt->second;
1945 return std::nullopt;
1953 const WifiMacHeader* hdr = &mpdu->GetOriginal()->GetHeader();
1958 std::optional<uint8_t> apLinkId;
1960 (apLinkId =
IsAssociated(mpdu->GetHeader().GetAddr2())) &&
1979 <<
", size=" << packet->GetSize());
1995 NS_LOG_DEBUG(
"forwarding frame from=" << from <<
", to=" << to);
2032 else if (hdr->
IsMgt())
2055 packet->PeekHeader(probeRequestHeader);
2056 const auto& ssid = probeRequestHeader.Get<
Ssid>();
2057 if (ssid ==
GetSsid() || ssid->IsBroadcast())
2059 NS_LOG_DEBUG(
"Probe request received from " << from <<
": send probe response");
2076 <<
" request received from " << from
2077 << ((
GetNLinks() > 1) ?
" on link ID " + std::to_string(linkId) :
""));
2084 packet->PeekHeader(assocReq);
2088 packet->PeekHeader(reassocReq);
2102 for (
auto it = staList.begin(); it != staList.end(); ++it)
2104 if (it->second == from)
2132 auto pkt = mpdu->GetPacket()->Copy();
2135 action.protectedEhtAction ==
2141 pkt->RemoveHeader(frame);
2166 auto failure = [&](
const std::string& msg) ->
bool {
2167 NS_LOG_DEBUG(
"Association Request from " << from <<
" refused: " << msg);
2168 remoteStationManager->RecordAssocRefused(from);
2173 auto recvAssocRequest = [&](
auto&& frameRefWrapper) ->
bool {
2174 const auto& frame = frameRefWrapper.get();
2179 remoteStationManager->AddSupportedPhyPreamble(from, capabilities.
IsShortPreamble());
2180 NS_ASSERT(frame.template Get<SupportedRates>());
2182 frame.template Get<ExtendedSupportedRatesIE>()};
2184 if (rates.GetNRates() == 0)
2186 return failure(
"STA's supported rate set not compatible with our Basic Rate set");
2192 const auto& htCapabilities = frame.template Get<HtCapabilities>();
2193 if (htCapabilities.has_value() && htCapabilities->IsSupportedMcs(0))
2195 for (uint8_t i = 0; i < remoteStationManager->GetNBasicMcs(); i++)
2197 WifiMode mcs = remoteStationManager->GetBasicMcs(i);
2198 if (!htCapabilities->IsSupportedMcs(mcs.
GetMcsValue()))
2200 return failure(
"HT STA does not support all MCSs in Basic MCS Set");
2208 const auto& vhtCapabilities = frame.template Get<VhtCapabilities>();
2209 if (vhtCapabilities.has_value() && vhtCapabilities->GetVhtCapabilitiesInfo() != 0)
2211 for (uint8_t i = 0; i < remoteStationManager->GetNBasicMcs(); i++)
2213 WifiMode mcs = remoteStationManager->GetBasicMcs(i);
2214 if (!vhtCapabilities->IsSupportedTxMcs(mcs.
GetMcsValue()))
2216 return failure(
"VHT STA does not support all MCSs in Basic MCS Set");
2224 const auto& heCapabilities = frame.template Get<HeCapabilities>();
2225 if (heCapabilities.has_value() && heCapabilities->GetSupportedMcsAndNss() != 0)
2227 for (uint8_t i = 0; i < remoteStationManager->GetNBasicMcs(); i++)
2229 WifiMode mcs = remoteStationManager->GetBasicMcs(i);
2230 if (!heCapabilities->IsSupportedTxMcs(mcs.
GetMcsValue()))
2232 return failure(
"HE STA does not support all MCSs in Basic MCS Set");
2238 if (
const auto& he6GhzCapabilities = frame.template Get<He6GhzBandCapabilities>())
2240 remoteStationManager->AddStationHe6GhzCapabilities(from, *he6GhzCapabilities);
2250 if (
const auto& tidLinkMapping = frame.template Get<TidToLinkMapping>();
2251 !tidLinkMapping.empty())
2259 if (tidLinkMapping.size() > 2)
2261 return failure(
"More than two TID-to-Link Mapping IEs");
2266 bool bothDirIfOneTlm =
2267 tidLinkMapping.size() != 1 ||
2274 bool distinctDirsIfTwoTlms =
2275 tidLinkMapping.size() != 2 ||
2278 tidLinkMapping[0].m_control.direction !=
2279 tidLinkMapping[1].m_control.direction);
2281 if (!bothDirIfOneTlm || !distinctDirsIfTwoTlms)
2283 return failure(
"Incorrect directions in TID-to-Link Mapping IEs");
2286 if (ehtConfig->m_tidLinkMappingSupport ==
2289 return failure(
"TID-to-Link Mapping negotiation not supported");
2297 for (uint8_t tid = 0; tid < 8; tid++)
2301 mapping.emplace(tid, std::move(linkSet));
2309 switch (tidLinkMapping[0].m_control.direction)
2312 getMapping(tidLinkMapping.at(0), dlMapping);
2313 ulMapping = dlMapping;
2316 getMapping(tidLinkMapping.at(0), dlMapping);
2317 getMapping(tidLinkMapping.at(1), ulMapping);
2320 getMapping(tidLinkMapping.at(0), ulMapping);
2321 getMapping(tidLinkMapping.at(1), dlMapping);
2325 if (ehtConfig->m_tidLinkMappingSupport ==
2329 return failure(
"Mapping TIDs to distinct link sets is incompatible with "
2330 "negotiation support of 1");
2334 const auto& mle = frame.template Get<MultiLinkElement>();
2336 "Multi-Link Element not present in an Association Request including "
2337 "TID-to-Link Mapping element(s)");
2338 auto mldAddr = mle->GetMldMacAddress();
2350 for (
const auto& mode : phy->GetModeList())
2352 if (rates.IsSupportedRate(mode.GetDataRate(phy->GetChannelWidth())))
2354 remoteStationManager->AddSupportedMode(from, mode);
2357 if (
GetErpSupported(linkId) && remoteStationManager->GetErpOfdmSupported(from) &&
2360 remoteStationManager->AddSupportedErpSlotTime(from,
true);
2364 const auto& htCapabilities = frame.template Get<HtCapabilities>();
2365 if (htCapabilities.has_value())
2367 remoteStationManager->AddStationHtCapabilities(from, *htCapabilities);
2369 const auto& extendedCapabilities = frame.template Get<ExtendedCapabilities>();
2370 if (extendedCapabilities.has_value())
2372 remoteStationManager->AddStationExtendedCapabilities(from, *extendedCapabilities);
2377 const auto& vhtCapabilities = frame.template Get<VhtCapabilities>();
2380 if (vhtCapabilities.has_value() &&
2381 vhtCapabilities->GetRxHighestSupportedLgiDataRate() > 0)
2383 remoteStationManager->AddStationVhtCapabilities(from, *vhtCapabilities);
2386 if (vhtCapabilities->IsSupportedTxMcs(mcs.GetMcsValue()))
2388 remoteStationManager->AddSupportedMcs(from, mcs);
2396 const auto& heCapabilities = frame.template Get<HeCapabilities>();
2397 if (heCapabilities.has_value() && heCapabilities->GetSupportedMcsAndNss() != 0)
2399 remoteStationManager->AddStationHeCapabilities(from, *heCapabilities);
2402 if (heCapabilities->IsSupportedTxMcs(mcs.GetMcsValue()))
2404 remoteStationManager->AddSupportedMcs(from, mcs);
2412 if (
const auto& ehtCapabilities = frame.template Get<EhtCapabilities>())
2414 remoteStationManager->AddStationEhtCapabilities(from, *ehtCapabilities);
2419 remoteStationManager->AddSupportedMcs(from, mcs);
2424 NS_LOG_DEBUG(
"Association Request from " << from <<
" accepted");
2425 remoteStationManager->RecordWaitAssocTxOk(from);
2429 return std::visit(recvAssocRequest, assoc);
2438 auto recvMle = [&](
auto&& frame) {
2439 const auto& mle = frame.get().template Get<MultiLinkElement>();
2441 if (!mle.has_value())
2446 auto mleCommonInfo = std::make_shared<CommonInfoBasicMle>(mle->GetCommonInfoBasic());
2449 for (std::size_t i = 0; i < mle->GetNPerStaProfileSubelements(); i++)
2451 auto& perStaProfile = mle->GetPerStaProfile(i);
2452 if (!perStaProfile.HasStaMacAddress())
2455 <<
"] Cannot setup a link if the STA MAC address is missing");
2458 uint8_t newLinkId = perStaProfile.GetLinkId();
2459 if (newLinkId == linkId || newLinkId >=
GetNLinks())
2461 NS_LOG_DEBUG(
"[i=" << i <<
"] Link ID " << newLinkId <<
" not valid");
2464 if (!perStaProfile.HasAssocRequest() && !perStaProfile.HasReassocRequest())
2466 NS_LOG_DEBUG(
"[i=" << i <<
"] No (Re)Association Request frame body present");
2471 perStaProfile.GetStaMacAddress(),
2474 perStaProfile.GetStaMacAddress(),
2479 std::visit(recvMle, assoc);
2489 if (!ehtConfiguration || !ehtConfiguration->m_emlsrActivated)
2492 "Received an EML Operating Mode Notification frame but EMLSR is not activated");
2499 auto emlCapabilities =
2501 NS_ASSERT_MSG(emlCapabilities,
"EML Capabilities not stored for STA " << sender);
2505 emlCapabilities->get().emlsrTransitionDelay = frame.
m_emlsrParamUpdate->transitionDelay;
2509 NS_ASSERT_MSG(mldAddress,
"No MLD address stored for STA " << sender);
2520 NS_ASSERT_MSG(psduMap.size() == 1 && psduMap.begin()->second->GetNMpdus() == 1 &&
2521 psduMap.begin()->second->GetHeader(0).IsAck(),
2522 "Expected a Normal Ack after EML Notification frame");
2528 ackDuration + ehtConfiguration->m_transitionTimeout,
2530 for (uint8_t id = 0; id < GetNLinks(); id++)
2533 GetWifiRemoteStationManager(id)->GetAffiliatedStaAddress(*mldAddress);
2540 if (!emlsrLinks.empty())
2554 auto enabled = std::find(emlsrLinks.cbegin(), emlsrLinks.cend(), id) !=
2558 StaSwitchingToActiveModeOrDeassociated(*linkAddress, id);
2560 GetWifiRemoteStationManager(id)->SetEmlsrEnabled(*linkAddress, enabled);
2578 GetWifiRemoteStationManager(id)->GetEmlsrEnabled(*linkAddress))
2580 StaSwitchingToPsMode(*linkAddress, id);
2582 GetWifiRemoteStationManager(id)->SetEmlsrEnabled(*linkAddress, false);
2590 auto phy = GetLink(linkId).phy;
2591 phy->TraceConnectWithoutContext(
"PhyTxPsduBegin", cb);
2593 [=]() { phy->TraceDisconnectWithoutContext(
"PhyTxPsduBegin", cb); });
2601 frame.m_emlControl.emlsrParamUpdateCtrl = 0;
2609 frame.m_emlsrParamUpdate.reset();
2612 ehtFem->SendEmlOmn(sender, frame);
2621 auto from = i.second.GetSourceAddr();
2622 auto to = i.second.GetDestinationAddr();
2626 NS_LOG_DEBUG(
"forwarding QoS frame from=" << from <<
", to=" << to);
2627 WifiMac::Enqueue(i.first->Copy(), to, from, mpdu->GetHeader().GetQosTid());
2640 for (uint8_t linkId = 0; linkId <
GetNLinks(); ++linkId)
2650 NS_LOG_DEBUG(
"Scheduling initial beacon for access point "
2651 <<
GetAddress() <<
" at time " << jitterUs <<
"us");
2677 return useProtection;
2690 for (uint16_t nextAid = startAid; nextAid <= 2007; ++nextAid)
2692 if (std::none_of(links.cbegin(), links.cend(), [&](
auto&& idLinkPair) {
2693 return GetStaList(idLinkPair.first).contains(nextAid);
2703const std::map<uint16_t, Mac48Address>&
2723 return it->second.value;
2743 uint8_t maxSize = 0;
2746 for (uint8_t tid = 0; tid < 8; tid++)
2751 maxSize = std::max(maxSize, size);
2771 m_gcrManager->GetMemberStasForGroupAddress(groupAddress));
void SendAssocResp(Mac48Address to, bool isReassoc, uint8_t linkId)
Forward an association or a reassociation response packet to the DCF/EDCA.
uint16_t GetAssociationId(Mac48Address addr, uint8_t linkId) const
std::unique_ptr< LinkEntity > CreateLinkEntity() const override
Create a LinkEntity object.
Ptr< Txop > m_beaconTxop
Dedicated Txop for beacons.
void SetBeaconGeneration(bool enable)
Enable or disable beacon generation of the AP.
void ParseReportedStaInfo(const AssocReqRefVariant &assoc, Mac48Address from, uint8_t linkId)
Given a (Re)Association Request frame body containing a Multi-Link Element, check if a link can be se...
void UpdateShortSlotTimeEnabled(uint8_t linkId)
Update whether short slot time should be enabled or not in the BSS corresponding to the given link.
void DoCompleteConfig() override
Allow subclasses to complete the configuration of the MAC layer components.
const std::map< uint16_t, Mac48Address > & GetStaList(uint8_t linkId) const
Get a const reference to the map of associated stations on the given link.
void DoDispose() override
Destructor implementation.
void SetBeaconInterval(Time interval)
bool ReceiveAssocRequest(const AssocReqRefVariant &assoc, const Mac48Address &from, uint8_t linkId)
Check whether the supported rate set included in the received (Re)Association Request frame is compat...
std::map< uint8_t, Mac48Address > LinkIdStaAddrMap
Map of (link ID, remote STA address) of the links to setup.
std::map< Mac48Address, EventId > m_transitionTimeoutEvents
transition timeout events running for EMLSR clients
UintAccessParamsMap m_cwMaxsForSta
Per-AC CW max values to advertise to stations.
void ScheduleFilsDiscOrUnsolProbeRespFrames(uint8_t linkId)
Schedule the transmission of FILS Discovery frames or unsolicited Probe Response frames on the given ...
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...
CapabilityInformation GetCapabilities(uint8_t linkId) const
Return the Capability information of the current AP for the given link.
Ptr< ApEmlsrManager > m_apEmlsrManager
AP EMLSR Manager.
Ptr< UniformRandomVariable > m_beaconJitter
UniformRandomVariable used to randomize the time of the first beacon.
void EnqueueProbeResp(const MgtProbeResponseHeader &probeResp, Mac48Address to, uint8_t linkId)
Send a packet prepared using the given Probe Response to the given receiver on the given link.
bool CanForwardPacketsTo(Mac48Address to) const override
Return true if packets can be forwarded to the given destination, false otherwise.
bool m_enableNonErpProtection
Flag whether protection mechanism is used or not when non-ERP STAs are present within the BSS.
EdcaParameterSet GetEdcaParameterSet(uint8_t linkId) const
Return the EDCA Parameter Set of the current AP for the given link.
void StaSwitchingToActiveModeOrDeassociated(const Mac48Address &staAddr, uint8_t linkId)
Perform the necessary actions when a given station deassociates or switches from powersave mode to ac...
HtOperation GetHtOperation(uint8_t linkId) const
Return the HT operation of the current AP for the given link.
std::optional< Mac48Address > GetMldOrLinkAddressByAid(uint16_t aid) const
Ptr< GcrManager > m_gcrManager
GCR Manager.
void UpdateShortPreambleEnabled(uint8_t linkId)
Update whether short preamble should be enabled or not in the BSS corresponding to the given link.
uint16_t GetNextAssociationId() const
void TxOk(Ptr< const WifiMpdu > mpdu)
The packet we sent was successfully received by the receiver (i.e.
Time m_fdBeaconIntervalNon6GHz
Time elapsing between a beacon and FILS Discovery (FD) frame or between two FD frames on 2....
std::map< uint16_t, Mac48Address > m_aidToMldOrLinkAddress
Maps AIDs to MLD addresses (for MLDs) or link addresses (in case of single link devices)
TracedCallback< uint16_t, Mac48Address > m_deAssocLogger
deassociation logger
void Enqueue(Ptr< WifiMpdu > mpdu, Mac48Address to, Mac48Address from) override
LinkIdStaAddrMap GetLinkIdStaAddrMap(MgtAssocResponseHeader &assoc, const Mac48Address &to, uint8_t linkId)
Get a map of (link ID, remote STA address) of the links to setup.
void SetAid(MgtAssocResponseHeader &assoc, const LinkIdStaAddrMap &linkIdStaAddrMap)
Set the AID field of the given Association Response frame.
static Ptr< const AttributeChecker > GetTimeAccessParamsChecker()
Get a checker for the TxopLimitsForSta attribute, which can be used to deserialize an ACI-indexed map...
bool m_enableBeaconGeneration
Flag whether beacons are being generated.
Time m_beaconInterval
Beacon interval.
Ptr< GcrManager > GetGcrManager() const
MultiLinkElement GetMultiLinkElement(uint8_t linkId, WifiMacType frameType, const Mac48Address &to=Mac48Address::GetBroadcast(), const std::optional< MultiLinkElement > &mlProbeReqMle=std::nullopt)
Return the Multi-Link Element that the current AP includes in the management frames of the given type...
bool m_enableBeaconJitter
Flag whether the first beacon should be generated at random time.
std::unordered_map< WifiAddressTidPair, BsrType, WifiAddressTidHash > m_bufferStatus
Per (MAC address, TID) buffer status reports.
DsssParameterSet GetDsssParameterSet(uint8_t linkId) const
Return the DSSS Parameter Set that we support on the given link.
TracedCallback< uint16_t, Mac48Address > m_assocLogger
association logger
uint8_t m_grpAddrBuIndicExp
Group Addressed BU Indication Exponent of EHT Operation IE.
Time GetBeaconInterval() const
static TypeId GetTypeId()
Get the type ID.
std::optional< ReducedNeighborReport > GetReducedNeighborReport(uint8_t linkId) const
Return the Reduced Neighbor Report (RNR) element that the current AP sends on the given link,...
void ReceiveEmlOmn(MgtEmlOmn &frame, const Mac48Address &sender, uint8_t linkId)
Take necessary actions upon receiving the given EML Operating Mode Notification frame from the given ...
Ptr< ApEmlsrManager > GetApEmlsrManager() const
Time m_fdBeaconInterval6GHz
Time elapsing between a beacon and FILS Discovery (FD) frame or between two FD frames on 6GHz links.
uint8_t GetMaxBufferStatus(Mac48Address address) const
Return the maximum among the values of the Queue Size subfield of the last QoS Data or QoS Null frame...
Time m_bsrLifetime
Lifetime of Buffer Status Reports.
ApLinkEntity & GetLink(uint8_t linkId) const
Get a reference to the link associated with the given ID.
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...
uint8_t GetBufferStatus(uint8_t tid, Mac48Address address) const
Return the value of the Queue Size subfield of the last QoS Data or QoS Null frame received from the ...
EhtOperation GetEhtOperation(uint8_t linkId) const
Return the EHT operation of the current AP for the given link.
bool UseGcr(const WifiMacHeader &hdr) const
Return whether GCR is used to transmit a packet.
bool m_sendUnsolProbeResp
send unsolicited Probe Response instead of FILS Discovery
ErpInformation GetErpInformation(uint8_t linkId) const
Return the ERP information of the current AP for the given link.
void SetLinkUpCallback(Callback< void > linkUp) override
VhtOperation GetVhtOperation(uint8_t linkId) const
Return the VHT operation of the current AP for the given link.
void TxFailed(WifiMacDropReason timeoutReason, Ptr< const WifiMpdu > mpdu)
The packet we sent was successfully received by the receiver (i.e.
HeOperation GetHeOperation(uint8_t linkId) const
Return the HE operation of the current AP for the given link.
bool IsGcrBaAgreementEstablishedWithAllMembers(const Mac48Address &groupAddress, uint8_t tid) const
Check if a GCR Block Ack agreement has been successfully established with all members of its group.
void SetBufferStatus(uint8_t tid, Mac48Address address, uint8_t size)
Store the value of the Queue Size subfield of the last QoS Data or QoS Null frame received from the s...
TimeAccessParamsMap m_txopLimitsForSta
Per-AC TXOP limits values to advertise to stations.
int64_t AssignStreams(int64_t stream) override
Assign a fixed random variable stream number to the random variables used by this model.
std::optional< MuEdcaParameterSet > GetMuEdcaParameterSet() const
Return the MU EDCA Parameter Set of the current AP, if one needs to be advertised.
void ProcessPowerManagementFlag(Ptr< const WifiMpdu > mpdu, uint8_t linkId)
Process the Power Management bit in the Frame Control field of an MPDU successfully received on the g...
void DeaggregateAmsduAndForward(Ptr< const WifiMpdu > mpdu) override
This method is called to de-aggregate an A-MSDU and forward the constituent packets up the stack.
bool SupportsSendFrom() const override
MgtAssocResponseHeader GetAssocResp(Mac48Address to, uint8_t linkId)
Get the Association Response frame to send on a given link.
void SetGcrManager(Ptr< GcrManager > gcrManager)
Set the GCR Manager.
Ptr< WifiMpdu > GetFilsDiscovery(uint8_t linkId) const
Get the FILS Discovery frame to send on the given link.
static Ptr< const AttributeChecker > GetUintAccessParamsChecker()
Get a checker for the CwMinsForSta, CwMaxsForSta and AifsnsForSta attributes, which can be used to de...
void DoInitialize() override
Initialize() implementation.
std::optional< uint8_t > IsAssociated(const Mac48Address &address) const
Get the ID of a link (if any) that has been setup with the station having the given MAC address.
void SendOneBeacon(uint8_t linkId)
Forward a beacon packet to the beacon special DCF for transmission on the given link.
Ptr< WifiMacQueue > GetTxopQueue(AcIndex ac) const override
Get the wifi MAC queue of the (Qos)Txop associated with the given AC, if such (Qos)Txop is installed,...
void SetApEmlsrManager(Ptr< ApEmlsrManager > apEmlsrManager)
Set the AP EMLSR Manager.
bool GetUseNonErpProtection(uint8_t linkId) const
Return whether protection for non-ERP stations is used in the BSS corresponding to the given link.
MgtProbeResponseHeader GetProbeRespProfile(uint8_t linkId) const
Get Probe Response Per-STA Profile for the given link.
UintAccessParamsMap m_cwMinsForSta
Per-AC CW min values to advertise to stations.
UintAccessParamsMap m_aifsnsForSta
Per-AC AIFS values to advertise to stations.
MgtProbeResponseHeader GetProbeResp(uint8_t linkId, const std::optional< MultiLinkElement > &reqMle)
Get Probe Response based on the given Probe Request Multi-link Element (if any)
void StaSwitchingToPsMode(const Mac48Address &staAddr, uint8_t linkId)
Perform the necessary actions when a given station switches from active mode to powersave mode.
AllSupportedRates GetSupportedRates(uint8_t linkId) const
Return an instance of SupportedRates that contains all rates that we support for the given link (incl...
A container for one type of attribute.
AttributeValue implementation for Boolean.
Base class for Callback class.
void SetCurrentChannel(uint8_t currentChannel)
Set the Current Channel field in the DsssParameterSet information element.
void SetViTxopLimit(uint16_t txop)
Set the AC_VI TXOP Limit field in the EdcaParameterSet information element.
void SetViAifsn(uint8_t aifsn)
Set the AC_VI AIFSN field in the EdcaParameterSet information element.
void SetVoAci(uint8_t aci)
Set the AC_VO ACI field in the EdcaParameterSet information element.
void SetVoCWmax(uint32_t cwMax)
Set the AC_VO CWmax field in the EdcaParameterSet information element.
void SetViCWmin(uint32_t cwMin)
Set the AC_VI CWmin field in the EdcaParameterSet information element.
void SetVoTxopLimit(uint16_t txop)
Set the AC_VO TXOP Limit field in the EdcaParameterSet information element.
void SetVoAifsn(uint8_t aifsn)
Set the AC_VO AIFSN field in the EdcaParameterSet information element.
void SetQosInfo(uint8_t qosInfo)
Set the QoS Info field in the EdcaParameterSet information element.
void SetBkCWmin(uint32_t cwMin)
Set the AC_BK CWmin field in the EdcaParameterSet information element.
void SetViAci(uint8_t aci)
Set the AC_VI ACI field in the EdcaParameterSet information element.
void SetViCWmax(uint32_t cwMax)
Set the AC_VI CWmax field in the EdcaParameterSet information element.
void SetVoCWmin(uint32_t cwMin)
Set the AC_VO CWmin field in the EdcaParameterSet information element.
void SetBeTxopLimit(uint16_t txop)
Set the AC_BE TXOP Limit field in the EdcaParameterSet information element.
void SetBeCWmax(uint32_t cwMax)
Set the AC_BE CWmax field in the EdcaParameterSet information element.
void SetBeAci(uint8_t aci)
Set the AC_BE ACI field in the EdcaParameterSet information element.
void SetBkCWmax(uint32_t cwMax)
Set the AC_BK CWmax field in the EdcaParameterSet information element.
void SetBkTxopLimit(uint16_t txop)
Set the AC_BK TXOP Limit field in the EdcaParameterSet information element.
void SetBkAifsn(uint8_t aifsn)
Set the AC_BK AIFSN field in the EdcaParameterSet information element.
void SetBeCWmin(uint32_t cwMin)
Set the AC_BE CWmin field in the EdcaParameterSet information element.
void SetBkAci(uint8_t aci)
Set the AC_BK ACI field in the EdcaParameterSet information element.
void SetBeAifsn(uint8_t aifsn)
Set the AC_BE AIFSN field in the EdcaParameterSet information element.
The IEEE 802.11be EHT Capabilities.
EHT Operation Information Element.
void SetMaxTxNss(uint8_t maxNss, uint8_t mcsStart, uint8_t mcsEnd)
Set the max Tx NSS for input MCS index range.
void SetMaxRxNss(uint8_t maxNss, uint8_t mcsStart, uint8_t mcsEnd)
Set the max Rx NSS for input MCS index range.
EhtOpParams m_params
EHT Operation Parameters.
Hold variables of type enum.
void Cancel()
This method is syntactic sugar for the ns3::Simulator::Cancel 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 HE Operation Information Element.
OptFieldWithPresenceInd< OpInfo6GHz > m_6GHzOpInfo
6 GHz Operation Information field
void SetMaxHeMcsPerNss(uint8_t nss, uint8_t maxHeMcs)
Set the Basic HE-MCS and NSS field in the HE Operation information element by specifying the pair (ns...
BssColorInfo m_bssColorInfo
BSS Color Information field.
The HT Capabilities Information Element.
The HT Operation Information Element.
void SetObssNonHtStasPresent(uint8_t obssNonHtStasPresent)
Set the OBSS non HT STAs present.
void SetRifsMode(uint8_t rifsMode)
Set the RIFS mode.
void SetSecondaryChannelOffset(uint8_t secondaryChannelOffset)
Set the secondary channel offset.
void SetPcoActive(uint8_t pcoActive)
Set the PCO active.
void SetTxUnequalModulation(uint8_t txUnequalModulation)
Set the transmit unequal modulation.
void SetHtProtection(uint8_t htProtection)
Set the HT protection.
void SetTxMaxNSpatialStreams(uint8_t maxTxSpatialStreams)
Set the transmit maximum number spatial streams.
void SetTxRxMcsSetUnequal(uint8_t txRxMcsSetUnequal)
Set the transmit / receive MCS set unequal.
void SetDualBeacon(uint8_t dualBeacon)
Set the dual beacon.
void SetNonGfHtStasPresent(uint8_t nonGfHtStasPresent)
Set the non GF HT STAs present.
void SetTxMcsSetDefined(uint8_t txMcsSetDefined)
Set the transmit MCS set defined.
void SetLSigTxopProtectionFullSupport(uint8_t lSigTxopProtectionFullSupport)
Set the LSIG TXOP protection full support.
void SetStaChannelWidth(uint8_t staChannelWidth)
Set the STA channel width.
void SetRxHighestSupportedDataRate(uint16_t maxSupportedRate)
Set the receive highest supported data rate.
void SetRxMcsBitmask(uint8_t index)
Set the receive MCS bitmask.
void SetPrimaryChannel(uint8_t ctrl)
Set the Primary Channel field in the HT Operation information element.
void SetDualCtsProtection(uint8_t dualCtsProtection)
Set the dual CTS protection.
void SetPhase(uint8_t pcoPhase)
Set the PCO phase.
void SetStbcBeacon(uint8_t stbcBeacon)
Set the STBC beacon.
static Mac48Address GetBroadcast()
Implement the header for Action frames of type EML Operating Mode Notification.
EmlControl m_emlControl
EML Control field.
std::optional< EmlsrParamUpdate > m_emlsrParamUpdate
EMLSR Parameter Update field.
std::list< uint8_t > GetLinkBitmap() const
The MU EDCA Parameter Set.
void SetMuCwMin(uint8_t aci, uint16_t cwMin)
Set the ECWmin subfield of the ECWmin/ECWmax field in the MU AC Parameter Record field corresponding ...
void SetMuEdcaTimer(uint8_t aci, Time timer)
Set the MU EDCA Timer field in the MU AC Parameter Record field corresponding to the given AC Index (...
void SetMuAifsn(uint8_t aci, uint8_t aifsn)
Set the AIFSN subfield of the ACI/AIFSN field in the MU AC Parameter Record field corresponding to th...
void SetQosInfo(uint8_t qosInfo)
Set the QoS Info field in the MuEdcaParameterSet information element.
Time GetMuEdcaTimer(uint8_t aci) const
Get the MU EDCA Timer value encoded in the MU AC Parameter Record field corresponding to the given AC...
void SetMuCwMax(uint8_t aci, uint16_t cwMax)
Set the ECWmax subfield of the ECWmin/ECWmax field in the MU AC Parameter Record field corresponding ...
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...
void SetBssParamsChangeCount(uint8_t count)
Set the BSS Parameters Change Count subfield in the Common Info field.
void SetLinkIdInfo(uint8_t linkIdInfo)
Set the Link ID Info subfield in the Common Info field.
CommonInfoBasicMle & GetCommonInfoBasic()
PerStaProfileSubelement & GetPerStaProfile(std::size_t i)
Get a reference to the i-th Per-STA Profile Subelement in the Link Info field.
Variant GetVariant() const
Get the Multi-Link element variant.
void SetMldMacAddress(Mac48Address address)
Set the MLD MAC Address subfield in the Common Info field.
void SetTransitionTimeout(Time timeout)
Set the Transition Timeout subfield of the EML Capabilities 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.
void Initialize()
Invoke DoInitialize on all Objects aggregated to this one.
void Dispose()
Dispose of this Object.
AttributeValue implementation for Pointer.
Smart pointer class similar to boost::intrusive_ptr.
Ptr< BlockAckManager > GetBaManager()
Get the Block Ack Manager associated with this QosTxop.
The Reduced Neighbor Report element.
std::size_t GetNNbrApInfoFields() const
Get the number of Neighbor AP Information fields.
void SetShortSsid(std::size_t nbrApInfoId, std::size_t index, uint32_t shortSsid)
Set the Short SSID field of the i-th TBTT Information field of the given Neighbor AP Information fiel...
void SetBssid(std::size_t nbrApInfoId, std::size_t index, Mac48Address bssid)
Set the BSSID field of the i-th TBTT Information field of the given Neighbor AP Information field.
void SetPsd20MHz(std::size_t nbrApInfoId, std::size_t index, uint8_t psd20MHz)
Set the 20 MHz PSD field of the i-th TBTT Information field of the given Neighbor AP Information fiel...
void AddNbrApInfoField()
Add a Neighbor AP Information field.
void SetBssParameters(std::size_t nbrApInfoId, std::size_t index, uint8_t bssParameters)
Set the BSS Parameters field of the i-th TBTT Information field of the given Neighbor AP Information ...
void SetMldParameters(std::size_t nbrApInfoId, std::size_t index, const MldParameters &mldParams)
Set the MLD Parameters subfield of the i-th TBTT Information field of the given Neighbor AP Informati...
void AddTbttInformationField(std::size_t nbrApInfoId)
Add a TBTT Information fields to the TBTT Information Set field of the given Neighbor AP Information ...
void SetOperatingChannel(std::size_t nbrApInfoId, const WifiPhyOperatingChannel &channel)
Set the Operating Class and the Channel Number fields of the given Neighbor AP Information field base...
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 EventId ScheduleNow(FUNC f, Ts &&... args)
Schedule an event to expire Now.
The IEEE 802.11 SSID Information Element.
Status code for association response.
bool IsSuccess() const
Return whether the status code is success.
void SetFailure()
Set success bit to 1 (failure).
void SetSuccess()
Set success bit to 0 (success).
Hold variables of type string.
The Supported Rates Information Element.
TID-to-Link Mapping Information Element.
std::set< uint8_t > GetLinkMappingOfTid(uint8_t tid) const
Get the Link Mapping field of the given TID.
TidToLinkMapping::Control m_control
TID-to-link Mapping Control.
Simulation virtual time values and global simulation resolution.
bool IsZero() const
Exactly equivalent to t == 0.
int64_t GetMicroSeconds() const
Get an approximation of the time stored in this instance in the indicated unit.
AttributeValue implementation for Time.
int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model.
void SetMaxCws(const std::vector< uint32_t > &maxCws)
Set the maximum contention window size for each link.
void SetAifsns(const std::vector< uint8_t > &aifsns)
Set the number of slots that make up an AIFS for each link.
Ptr< WifiMacQueue > GetWifiMacQueue() const
Return the packet queue associated with this Txop.
virtual void SetWifiMac(const Ptr< WifiMac > mac)
Set the wifi MAC this Txop is associated to.
virtual void Queue(Ptr< WifiMpdu > mpdu)
void SetTxMiddle(const Ptr< MacTxMiddle > txMiddle)
Set MacTxMiddle this Txop is associated to.
void SetMinCws(const std::vector< uint32_t > &minCws)
Set the minimum contention window size for each link.
a unique identifier for an interface.
@ ATTR_GET
The attribute can be read.
@ ATTR_CONSTRUCT
The attribute can be written at construction-time.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Hold an unsigned integer type.
The IEEE 802.11ac VHT Capabilities.
The VHT Operation Information Element.
void SetMaxVhtMcsPerNss(uint8_t nss, uint8_t maxVhtMcs)
Set the Basic VHT-MCS and NSS field in the VHT Operation information element by specifying the tuple ...
void SetChannelWidth(uint8_t channelWidth)
Set the Channel Width field in the VHT Operation information element.
void SetChannelCenterFrequencySegment1(uint8_t channelCenterFrequencySegment1)
Set the Channel Center Frequency Segment 1 field in the VHT Operation information element.
void SetChannelCenterFrequencySegment0(uint8_t channelCenterFrequencySegment0)
Set the Channel Center Frequency Segment 0 field in the VHT Operation information element.
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.
std::optional< Mac48Address > GetMldAddress(const Mac48Address &remoteAddr) 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.
bool GetQosSupported() const
Return whether the device supports QoS.
uint8_t GetNLinks() const
Get the number of links (can be greater than 1 for 11be devices only).
void Enqueue(Ptr< Packet > packet, Mac48Address to)
void UnblockUnicastTxOnLinks(WifiQueueBlockedReason reason, 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...
void DoInitialize() override
Initialize() implementation.
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
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.
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.
void BlockUnicastTxOnLinks(WifiQueueBlockedReason reason, 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...
Ptr< MacTxMiddle > m_txMiddle
TX middle (aggregation etc.)
virtual int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model.
Ptr< HtConfiguration > GetHtConfiguration() const
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,...
bool GetShortSlotTimeSupported() const
void NotifyRxDrop(Ptr< const Packet > packet)
virtual void SetLinkUpCallback(Callback< void > linkUp)
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.
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.
Ptr< QosTxop > GetQosTxop(AcIndex ac) const
Accessor for a specified EDCA object.
void DoDispose() override
Destructor implementation.
bool GetDsssSupported(uint8_t linkId) const
Return whether the device supports DSSS on the given link.
represent a single transmission mode
const std::string & GetUniqueName() const
uint64_t GetDataRate(MHz_u channelWidth, Time guardInterval, uint8_t nss) const
uint8_t GetMcsValue() const
std::list< uint8_t > GetBssMembershipSelectorList() const
The WifiPhy::BssMembershipSelector() method is used (e.g., by a WifiRemoteStationManager) to determin...
uint8_t GetMaxSupportedRxSpatialStreams() const
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
std::list< WifiMode > GetModeList() const
The WifiPhy::GetModeList() method is used (e.g., by a WifiRemoteStationManager) to determine the set ...
const WifiPhyOperatingChannel & GetOperatingChannel() const
Get a const reference to the operating channel.
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< AttributeChecker > MakeAttributeContainerChecker()
Make uninitialized AttributeContainerChecker using explicit types.
Ptr< const AttributeAccessor > MakeAttributeContainerAccessor(T1 a1)
Make AttributeContainerAccessor using explicit types.
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< 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()
#define NS_ABORT_MSG_UNLESS(cond, msg)
Abnormal program termination if a condition is false, with a message.
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
#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_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_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Ptr< T > CreateObjectWithAttributes(Args... args)
Allocate an Object on the heap and initialize with a set of attributes.
#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 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.
WifiMacDropReason
The reason why an MPDU was dropped.
AcIndex
This enumeration defines the Access Categories as an enumeration with values corresponding to the AC ...
@ WIFI_PHY_BAND_6GHZ
The 6 GHz band.
@ WIFI_MOD_CLASS_HR_DSSS
HR/DSSS (Clause 16)
@ WIFI_MOD_CLASS_HT
HT (Clause 19)
@ WIFI_MOD_CLASS_EHT
EHT (Clause 36)
@ 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.
U * PeekPointer(const Ptr< U > &p)
const Time WIFI_TU
Wi-Fi Time Unit (see IEEE 802.11-2020 sec. 3.1)
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 AttributeChecker > MakeEnumChecker(T v, std::string n, Ts... args)
Make an EnumChecker pre-configured with a set of allowed values by name.
bool IsGroupcast(const Mac48Address &adr)
Check whether a MAC destination address corresponds to a groupcast transmission.
std::map< uint8_t, std::set< uint8_t > > WifiTidLinkMapping
TID-indexed map of the link set to which the TID is mapped.
constexpr uint8_t WIFI_EHT_MAX_MCS_INDEX
IEEE 802.11be D2.0 Figure 9-1002ai.
WifiMacType
Combination of valid MAC header type/subtype.
@ WIFI_MAC_MGT_ASSOCIATION_RESPONSE
@ WIFI_MAC_MGT_DISASSOCIATION
@ 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.
Ptr< T1 > StaticCast(const Ptr< T2 > &p)
Cast a Ptr.
std::pair< Mac48Address, uint8_t > WifiAddressTidPair
(MAC address, TID) pair
std::unordered_map< uint16_t, Ptr< const WifiPsdu > > WifiConstPsduMap
Map of const PSDUs indexed by STA-ID.
std::variant< std::reference_wrapper< MgtAssocRequestHeader >, std::reference_wrapper< MgtReassocRequestHeader > > AssocReqRefVariant
variant holding a reference to a (Re)Association Request
static constexpr uint16_t SU_STA_ID
STA_ID to identify a single user (SU)
Struct containing all supported rates.
void SetBasicRate(uint64_t bs)
Set the given rate to basic 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.
Structure holding information specific to a single link.
std::map< uint16_t, Mac48Address > staList
Map of all stations currently associated to the AP with their association ID.
EventId beaconEvent
Event to generate one beacon.
~ApLinkEntity() override
Destructor (a virtual method is needed to make this struct polymorphic)
uint16_t numNonHtStations
Number of non-HT stations currently associated to the AP.
uint16_t numNonErpStations
Number of non-ERP stations currently associated to the AP.
std::optional< MldCapabilities > m_mldCapabilities
MLD Capabilities.
void SetMediumSyncDelayTimer(Time delay)
Set the Medium Synchronization Duration subfield of the Medium Synchronization Delay Information in t...
uint8_t grpBuExp
Group Addressed BU Indication Exponent.
uint8_t m_bssColor
BSS Color.
6 GHz Operation Information field
uint8_t m_chCntrFreqSeg0
Channel center frequency segment 0.
uint8_t m_chWid
Channel Width.
uint8_t m_primCh
Primary Channel.
uint8_t emlsrMode
EMLSR Mode.
uint8_t emlsrParamUpdateCtrl
EMLSR Parameter Update Control.
bool defaultMapping
Default link mapping.
Ptr< WifiPhy > phy
Wifi PHY object.
Ptr< FrameExchangeManager > feManager
Frame Exchange Manager object.
Ptr< ChannelAccessManager > channelAccessManager
channel access manager object