32#include "ns3/eht-configuration.h"
33#include "ns3/eht-frame-exchange-manager.h"
34#include "ns3/he-configuration.h"
35#include "ns3/ht-configuration.h"
37#include "ns3/packet.h"
38#include "ns3/pointer.h"
39#include "ns3/shuffle.h"
40#include "ns3/string.h"
41#include "ns3/vht-configuration.h"
56 : m_qosSupported(false)
79 "The ssid we want to belong to.",
83 .AddAttribute(
"QosSupported",
84 "This Boolean attribute is set to enable 802.11e/WMM-style QoS support "
91 .AddAttribute(
"CtsToSelfSupported",
92 "Use CTS to Self when using a rate that is not in the basic rate set.",
97 "ShortSlotTimeSupported",
98 "Whether or not short slot time is supported (only used by ERP APs or STAs).",
103 .AddAttribute(
"Txop",
109 MakePointerChecker<Txop>())
110 .AddAttribute(
"VO_Txop",
111 "Queue that manages packets belonging to AC_VO access class.",
116 MakePointerChecker<QosTxop>())
117 .AddAttribute(
"VI_Txop",
118 "Queue that manages packets belonging to AC_VI access class.",
123 MakePointerChecker<QosTxop>())
124 .AddAttribute(
"BE_Txop",
125 "Queue that manages packets belonging to AC_BE access class.",
130 MakePointerChecker<QosTxop>())
131 .AddAttribute(
"BK_Txop",
132 "Queue that manages packets belonging to AC_BK access class.",
137 MakePointerChecker<QosTxop>())
140 "The size (in number of MPDUs) of the buffer used for each BlockAck "
141 "agreement in which this node is a recipient. The provided value is "
142 "capped to the maximum allowed value based on the supported standard.",
145 MakeUintegerChecker<uint16_t>(1, 1024))
146 .AddAttribute(
"VO_MaxAmsduSize",
147 "Maximum length in bytes of an A-MSDU for AC_VO access class "
148 "(capped to 7935 for HT PPDUs and 11398 for VHT/HE/EHT PPDUs). "
149 "Value 0 means A-MSDU aggregation is disabled for that AC.",
152 MakeUintegerChecker<uint16_t>(0, 11398))
153 .AddAttribute(
"VI_MaxAmsduSize",
154 "Maximum length in bytes of an A-MSDU for AC_VI access class "
155 "(capped to 7935 for HT PPDUs and 11398 for VHT/HE/EHT PPDUs). "
156 "Value 0 means A-MSDU aggregation is disabled for that AC.",
159 MakeUintegerChecker<uint16_t>(0, 11398))
160 .AddAttribute(
"BE_MaxAmsduSize",
161 "Maximum length in bytes of an A-MSDU for AC_BE access class "
162 "(capped to 7935 for HT PPDUs and 11398 for VHT/HE/EHT PPDUs). "
163 "Value 0 means A-MSDU aggregation is disabled for that AC.",
166 MakeUintegerChecker<uint16_t>(0, 11398))
167 .AddAttribute(
"BK_MaxAmsduSize",
168 "Maximum length in bytes of an A-MSDU for AC_BK access class "
169 "(capped to 7935 for HT PPDUs and 11398 for VHT/HE/EHT PPDUs). "
170 "Value 0 means A-MSDU aggregation is disabled for that AC.",
173 MakeUintegerChecker<uint16_t>(0, 11398))
176 "Maximum length in bytes of an A-MPDU for AC_VO access class "
177 "(capped to 65535 for HT PPDUs, 1048575 for VHT PPDUs, 6500631 for HE PPDUs "
178 "and 15523200 for EHT PPDUs). "
179 "Value 0 means A-MPDU aggregation is disabled for that AC.",
182 MakeUintegerChecker<uint32_t>(0, 15523200))
185 "Maximum length in bytes of an A-MPDU for AC_VI access class "
186 "(capped to 65535 for HT PPDUs, 1048575 for VHT PPDUs, 6500631 for HE PPDUs "
187 "and 15523200 for EHT PPDUs). "
188 "Value 0 means A-MPDU aggregation is disabled for that AC.",
191 MakeUintegerChecker<uint32_t>(0, 15523200))
194 "Maximum length in bytes of an A-MPDU for AC_BE access class "
195 "(capped to 65535 for HT PPDUs, 1048575 for VHT PPDUs, 6500631 for HE PPDUs "
196 "and 15523200 for EHT PPDUs). "
197 "Value 0 means A-MPDU aggregation is disabled for that AC.",
200 MakeUintegerChecker<uint32_t>(0, 15523200))
203 "Maximum length in bytes of an A-MPDU for AC_BK access class "
204 "(capped to 65535 for HT PPDUs, 1048575 for VHT PPDUs, 6500631 for HE PPDUs "
205 "and 15523200 for EHT PPDUs). "
206 "Value 0 means A-MPDU aggregation is disabled for that AC.",
209 MakeUintegerChecker<uint32_t>(0, 15523200))
211 "VO_BlockAckThreshold",
212 "If number of packets in VO queue reaches this value, "
213 "block ack mechanism is used. If this value is 0, block ack is never used."
214 "When A-MPDU is enabled, block ack mechanism is used regardless of this value.",
217 MakeUintegerChecker<uint8_t>(0, 64))
219 "VI_BlockAckThreshold",
220 "If number of packets in VI queue reaches this value, "
221 "block ack mechanism is used. If this value is 0, block ack is never used."
222 "When A-MPDU is enabled, block ack mechanism is used regardless of this value.",
225 MakeUintegerChecker<uint8_t>(0, 64))
227 "BE_BlockAckThreshold",
228 "If number of packets in BE queue reaches this value, "
229 "block ack mechanism is used. If this value is 0, block ack is never used."
230 "When A-MPDU is enabled, block ack mechanism is used regardless of this value.",
233 MakeUintegerChecker<uint8_t>(0, 64))
235 "BK_BlockAckThreshold",
236 "If number of packets in BK queue reaches this value, "
237 "block ack mechanism is used. If this value is 0, block ack is never used."
238 "When A-MPDU is enabled, block ack mechanism is used regardless of this value.",
241 MakeUintegerChecker<uint8_t>(0, 64))
243 "VO_BlockAckInactivityTimeout",
244 "Represents max time (blocks of 1024 microseconds) allowed for block ack"
245 "inactivity for AC_VO. If this value isn't equal to 0 a timer start after that a"
246 "block ack setup is completed and will be reset every time that a block ack"
247 "frame is received. If this value is 0, block ack inactivity timeout won't be "
251 MakeUintegerChecker<uint16_t>())
253 "VI_BlockAckInactivityTimeout",
254 "Represents max time (blocks of 1024 microseconds) allowed for block ack"
255 "inactivity for AC_VI. If this value isn't equal to 0 a timer start after that a"
256 "block ack setup is completed and will be reset every time that a block ack"
257 "frame is received. If this value is 0, block ack inactivity timeout won't be "
261 MakeUintegerChecker<uint16_t>())
263 "BE_BlockAckInactivityTimeout",
264 "Represents max time (blocks of 1024 microseconds) allowed for block ack"
265 "inactivity for AC_BE. If this value isn't equal to 0 a timer start after that a"
266 "block ack setup is completed and will be reset every time that a block ack"
267 "frame is received. If this value is 0, block ack inactivity timeout won't be "
271 MakeUintegerChecker<uint16_t>())
273 "BK_BlockAckInactivityTimeout",
274 "Represents max time (blocks of 1024 microseconds) allowed for block ack"
275 "inactivity for AC_BK. If this value isn't equal to 0 a timer start after that a"
276 "block ack setup is completed and will be reset every time that a block ack"
277 "frame is received. If this value is 0, block ack inactivity timeout won't be "
281 MakeUintegerChecker<uint16_t>())
282 .AddTraceSource(
"MacTx",
283 "A packet has been received from higher layers and is being processed "
284 "in preparation for "
285 "queueing for transmission.",
287 "ns3::Packet::TracedCallback")
290 "A packet has been dropped in the MAC layer before being queued for transmission. "
291 "This trace source is fired, e.g., when an AP's MAC receives from the upper layer "
292 "a packet destined to a station that is not associated with the AP or a STA's MAC "
293 "receives a packet from the upper layer while it is not associated with any AP.",
295 "ns3::Packet::TracedCallback")
298 "A packet has been received by this device, has been passed up from the physical "
300 "and is being forwarded up the local protocol stack. This is a promiscuous trace.",
302 "ns3::Packet::TracedCallback")
303 .AddTraceSource(
"MacRx",
304 "A packet has been received by this device, has been passed up from "
305 "the physical layer "
306 "and is being forwarded up the local protocol stack. This is a "
307 "non-promiscuous trace.",
309 "ns3::Packet::TracedCallback")
310 .AddTraceSource(
"MacRxDrop",
311 "A packet has been dropped in the MAC layer after it has been passed "
312 "up from the physical layer.",
314 "ns3::Packet::TracedCallback")
315 .AddTraceSource(
"AckedMpdu",
316 "An MPDU that was successfully acknowledged, via either a "
317 "Normal Ack or a Block Ack.",
319 "ns3::WifiMpdu::TracedCallback")
320 .AddTraceSource(
"NAckedMpdu",
321 "An MPDU that was negatively acknowledged via a Block Ack.",
323 "ns3::WifiMpdu::TracedCallback")
326 "An MPDU that was dropped for the given reason (see WifiMacDropReason).",
328 "ns3::WifiMac::DroppedMpduCallback")
330 "MpduResponseTimeout",
331 "An MPDU whose response was not received before the timeout, along with "
332 "an identifier of the type of timeout (see WifiTxTimer::Reason) and the "
333 "TXVECTOR used to transmit the MPDU. This trace source is fired when a "
334 "CTS is missing after an RTS, when all CTS frames are missing after an MU-RTS, "
335 "or when a Normal Ack is missing after an MPDU or after a DL MU PPDU "
336 "acknowledged in SU format.",
338 "ns3::WifiMac::MpduResponseTimeoutCallback")
340 "PsduResponseTimeout",
341 "A PSDU whose response was not received before the timeout, along with "
342 "an identifier of the type of timeout (see WifiTxTimer::Reason) and the "
343 "TXVECTOR used to transmit the PSDU. This trace source is fired when a "
344 "BlockAck is missing after an A-MPDU, a BlockAckReq (possibly in the "
345 "context of the acknowledgment of a DL MU PPDU in SU format) or a TB PPDU "
346 "(in the latter case the missing BlockAck is a Multi-STA BlockAck).",
348 "ns3::WifiMac::PsduResponseTimeoutCallback")
350 "PsduMapResponseTimeout",
351 "A PSDU map for which not all the responses were received before the timeout, "
352 "along with an identifier of the type of timeout (see WifiTxTimer::Reason), "
353 "the set of MAC addresses of the stations that did not respond and the total "
354 "number of stations that had to respond. This trace source is fired when not "
355 "all the addressed stations responded to an MU-BAR Trigger frame (either sent as "
356 "a SU frame or aggregated to PSDUs in the DL MU PPDU), a Basic Trigger Frame or "
357 "a BSRP Trigger Frame.",
359 "ns3::WifiMac::PsduMapResponseTimeoutCallback");
402 for (
auto it =
m_edca.begin(); it !=
m_edca.end(); ++it)
404 it->second->Initialize();
407 for (
const auto& [
id, link] :
m_links)
409 if (
auto cam = link->channelAccessManager)
431 for (
auto it =
m_edca.begin(); it !=
m_edca.end(); ++it)
434 it->second =
nullptr;
475 if (device->GetHtConfiguration())
530 for (
auto& [
id, link] :
m_links)
532 link->feManager->SetPromisc();
602 const auto it = std::find_if(
m_edca.cbegin(),
m_edca.cend(), [ac](
const auto& pair) {
603 return pair.first == ac;
605 return (it ==
m_edca.cend() ?
nullptr : it->second);
642 return (txop ? txop->GetWifiMacQueue() :
nullptr);
652 for (
const auto& [aci, qosTxop] :
m_edca)
654 if (qosTxop->HasFramesToTransmit(linkId))
734 auto edcaIt =
m_edca.find(ac);
738 edcaIt->second->GetBaManager()->SetTxOkCallback(
740 edcaIt->second->GetBaManager()->SetTxFailedCallback(
742 edcaIt->second->SetDroppedMpduCallback(
749 std::list<bool> isDsssOnly;
750 for (
const auto& [
id, link] :
m_links)
752 isDsssOnly.push_back(link->dsssSupported && !link->erpSupported);
763 for (
auto it =
m_edca.begin(); it !=
m_edca.end(); ++it)
765 ConfigureDcf(it->second, cwMin, cwMax, isDsssOnly, it->first);
773 std::list<bool> isDsss,
780 uint8_t aifsnValue = 0;
781 Time txopLimitDsss(0);
782 Time txopLimitNoDsss(0);
788 cwMinValue = (cwmin + 1) / 4 - 1;
789 cwMaxValue = (cwmin + 1) / 2 - 1;
795 cwMinValue = (cwmin + 1) / 2 - 1;
829 const auto& userDefinedParams = dcf->GetUserAccessParams();
831 dcf->SetMinCws(!userDefinedParams.cwMins.empty()
832 ? userDefinedParams.cwMins
833 : std::vector<uint32_t>(
m_links.size(), cwMinValue));
834 dcf->SetMaxCws(!userDefinedParams.cwMaxs.empty()
835 ? userDefinedParams.cwMaxs
836 : std::vector<uint32_t>(
m_links.size(), cwMaxValue));
837 dcf->SetAifsns(!userDefinedParams.aifsns.empty()
838 ? userDefinedParams.aifsns
839 : std::vector<uint8_t>(
m_links.size(), aifsnValue));
841 if (!userDefinedParams.txopLimits.empty())
843 dcf->SetTxopLimits(userDefinedParams.txopLimits);
847 std::vector<Time> txopLimitValues(
m_links.size());
848 std::transform(isDsss.begin(),
850 txopLimitValues.begin(),
851 [&txopLimitDsss, &txopLimitNoDsss](
bool dsss) {
852 return (dsss ? txopLimitDsss : txopLimitNoDsss);
854 dcf->SetTxopLimits(txopLimitValues);
863 const auto& link = *
m_links.cbegin()->second;
865 if (!link.phy || !link.stationManager || !link.channelAccessManager || !link.feManager)
872 for (
auto& [
id, link] :
m_links)
875 !link->phy || !link->phy->GetOperatingChannel().IsSet(),
877 <<
"] PHY must have been set and an operating channel must have been set");
880 "[LinkID " << +
id <<
"] A channel access manager must have been set");
883 "[LinkID " << +
id <<
"] A frame exchange manager must have been set");
885 link->channelAccessManager->SetupPhyListener(link->phy);
886 link->channelAccessManager->SetupFrameExchangeManager(link->feManager);
888 link->feManager->SetWifiPhy(link->phy);
895 link->channelAccessManager->Add(
m_txop);
897 for (
auto it =
m_edca.begin(); it !=
m_edca.end(); ++it)
899 it->second->SetWifiMac(
this);
900 link->channelAccessManager->Add(it->second);
935 for (std::size_t i = 0; i < nLinks; i++)
951 "The number of provided Frame Exchange Manager objects ("
952 << feManagers.size() <<
") must match the number of existing links ("
956 for (
auto managerIt = feManagers.cbegin();
auto& [
id, link] :
m_links)
958 link->feManager = *managerIt++;
959 link->feManager->SetWifiMac(
this);
960 link->feManager->SetLinkId(
id);
962 link->feManager->GetWifiTxTimer().SetMpduResponseTimeoutCallback(
963 MakeCallback(&MpduResponseTimeoutTracedCallback::operator(),
965 link->feManager->GetWifiTxTimer().SetPsduResponseTimeoutCallback(
966 MakeCallback(&PsduResponseTimeoutTracedCallback::operator(),
968 link->feManager->GetWifiTxTimer().SetPsduMapResponseTimeoutCallback(
969 MakeCallback(&PsduMapResponseTimeoutTracedCallback::operator(),
971 link->feManager->SetDroppedMpduCallback(
973 link->feManager->SetAckedMpduCallback(
994 "The number of provided Channel Access Manager objects ("
995 << caManagers.size() <<
") must match the number of existing links ("
999 for (
auto managerIt = caManagers.cbegin();
auto& [
id, link] :
m_links)
1001 link->channelAccessManager = *managerIt++;
1002 link->channelAccessManager->SetLinkId(
id);
1030 "The number of provided Remote Manager objects ("
1031 << stationManagers.size()
1032 <<
") must match the number of existing links (" <<
m_links.size()
1036 for (
auto managerIt = stationManagers.cbegin();
auto& [
id, link] :
m_links)
1038 link->stationManager = *managerIt++;
1050std::unique_ptr<WifiMac::LinkEntity>
1053 return std::make_unique<LinkEntity>();
1056const std::map<uint8_t, std::unique_ptr<WifiMac::LinkEntity>>&
1065 auto it =
m_links.find(linkId);
1077const std::set<uint8_t>&
1091 link.feManager->SetLinkId(
id);
1093 if (link.channelAccessManager)
1095 link.channelAccessManager->SetLinkId(
id);
1099std::optional<uint8_t>
1102 for (
const auto& [
id, link] :
m_links)
1104 if (link->feManager->GetAddress() == address)
1109 return std::nullopt;
1112std::optional<uint8_t>
1115 for (
const auto& [
id, link] :
m_links)
1117 if (link->phy == phy)
1122 return std::nullopt;
1125std::optional<uint8_t>
1138 std::map<uint8_t, uint8_t> actualPairs;
1140 while (!links.empty())
1142 auto from = links.cbegin()->first;
1143 auto to = links.cbegin()->second;
1148 links.erase(links.cbegin());
1152 std::unique_ptr<LinkEntity> linkToMove;
1154 linkToMove.swap(
m_links.at(from));
1159 auto [it, inserted] =
1162 actualPairs.emplace(from, to);
1174 auto nextTo = links.find(to);
1175 if (nextTo == links.cend())
1178 m_links[empty].swap(linkToMove);
1179 actualPairs.emplace(to, empty);
1184 to = nextTo->second;
1189 for (
const auto& [
id, link] :
m_links)
1198 for (
auto& [ac, edca] :
m_edca)
1200 edca->SwapLinks(actualPairs);
1220 "DL and UL directions for TID-to-Link mapping must be set separately");
1224 auto [it, inserted] = mappings.emplace(mldAddr, mapping);
1233 if (mapping.empty())
1240 for (
const auto& [tid, linkSet] : mapping)
1242 it->second[tid] = linkSet;
1246std::optional<std::reference_wrapper<const WifiTidLinkMapping>>
1250 "Cannot request TID-to-Link mapping for both directions");
1252 const auto& mappings =
1255 if (
const auto it = mappings.find(mldAddr); it != mappings.cend())
1259 return std::nullopt;
1266 "Cannot request TID-to-Link mapping for both directions");
1268 const auto& mappings =
1271 const auto it = mappings.find(mldAddr);
1273 if (it == mappings.cend())
1279 auto linkSetIt = it->second.find(tid);
1281 if (linkSetIt == it->second.cend())
1288 return std::find(linkSetIt->second.cbegin(), linkSetIt->second.cend(), linkId) !=
1289 linkSetIt->second.cend();
1301 "The number of provided PHY objects ("
1302 << phys.size() <<
") must match the number of existing links ("
1306 for (
auto phyIt = phys.cbegin();
auto& [
id, link] :
m_links)
1308 link->phy = *phyIt++;
1324 for (
auto& [
id, link] :
m_links)
1326 if (link->feManager)
1328 link->feManager->ResetPhy();
1330 if (link->channelAccessManager)
1332 link->channelAccessManager->RemovePhyListener(link->phy);
1334 link->phy =
nullptr;
1436 "This method can be used to enforce TID-to-Link mapping for one direction at a time");
1438 const auto& mappings =
1441 auto it = mappings.find(mldAddr);
1443 if (it == mappings.cend())
1449 std::set<uint8_t> setupLinks;
1452 for (
const auto& [
id, link] :
m_links)
1454 if (link->stationManager->GetMldAddress(mldAddr))
1456 setupLinks.insert(
id);
1460 auto linkMapping = it->second;
1462 if (linkMapping.empty())
1465 for (uint8_t tid = 0; tid < 8; tid++)
1467 linkMapping.emplace(tid, setupLinks);
1471 for (
const auto& [tid, linkSet] : linkMapping)
1473 decltype(setupLinks) mappedLinks;
1474 auto notMappedLinks = setupLinks;
1476 for (
const auto id : linkSet)
1478 if (setupLinks.find(
id) != setupLinks.cend())
1481 mappedLinks.insert(
id);
1482 notMappedLinks.erase(
id);
1487 NS_ABORT_MSG_IF(mappedLinks.empty(),
"Every TID must be mapped to at least a link");
1498 if (!notMappedLinks.empty())
1514 const std::set<uint8_t>& linkIds)
1516 std::stringstream ss;
1519 std::copy(linkIds.cbegin(), linkIds.cend(), std::ostream_iterator<uint16_t>(ss,
" "));
1524 for (
const auto linkId : linkIds)
1527 auto linkAddr = link.stationManager->GetAffiliatedStaAddress(address).value_or(address);
1529 if (link.stationManager->GetMldAddress(address) == address && linkAddr == address)
1531 NS_LOG_DEBUG(
"Link " << +linkId <<
" has not been setup with the MLD, skip");
1543 {ac.GetLowTid(), ac.GetHighTid()},
1550 link.feManager->GetAddress(),
1560 const std::set<uint8_t>& linkIds)
1565 std::vector<uint8_t> shuffledLinkIds(linkIds.cbegin(), linkIds.cend());
1568 std::stringstream ss;
1571 std::copy(shuffledLinkIds.cbegin(),
1572 shuffledLinkIds.cend(),
1573 std::ostream_iterator<uint16_t>(ss,
" "));
1577 for (
const auto linkId : shuffledLinkIds)
1580 auto linkAddr = link.stationManager->GetAffiliatedStaAddress(address).value_or(address);
1582 if (link.stationManager->GetMldAddress(address) == address && linkAddr == address)
1584 NS_LOG_DEBUG(
"Link " << +linkId <<
" has not been setup with the MLD, skip");
1599 {ac.GetLowTid(), ac.GetHighTid()},
1606 link.feManager->GetAddress(),
1614 hasFramesToTransmit,
1628 <<
") does not support Enqueue() with from address");
1643 const WifiMacHeader* hdr = &mpdu->GetOriginal()->GetHeader();
1675 packet->RemoveHeader(actionHdr);
1685 packet->RemoveHeader(reqHdr);
1691 auto htFem = DynamicCast<HtFrameExchangeManager>(link.feManager);
1694 htFem->SendAddBaResponse(&reqHdr, from);
1701 packet->RemoveHeader(respHdr);
1709 auto recipientMld = link.stationManager->GetMldAddress(from);
1710 auto recipient = (recipientMld ? *recipientMld : from);
1712 auto htFem = DynamicCast<HtFrameExchangeManager>(link.feManager);
1717 ->SetBlockAckInactivityCallback(
1725 packet->RemoveHeader(delBaHdr);
1726 auto recipientMld = link.stationManager->GetMldAddress(from);
1727 auto recipient = (recipientMld ? *recipientMld : from);
1737 ->DestroyRecipientAgreement(recipient, delBaHdr.
GetTid());
1750 NS_FATAL_ERROR(
"Unsupported Action field in Block Ack Action frame");
1768 msduPair.second.GetSourceAddr(),
1769 msduPair.second.GetDestinationAddr());
1773std::optional<Mac48Address>
1776 for (
const auto& [
id, link] :
m_links)
1778 if (
auto mldAddress = link->stationManager->GetMldAddress(remoteAddr))
1783 return std::nullopt;
1789 for (
const auto& [
id, link] :
m_links)
1791 if (
auto mldAddress = link->stationManager->GetMldAddress(remoteAddr))
1794 if (mldAddress != remoteAddr)
1797 return link->feManager->GetAddress();
1827 if (!agreement || !agreement->get().IsEstablished())
1829 return std::nullopt;
1838 originator =
GetMldAddress(originator).value_or(originator);
1847 "No existing Block Ack agreement with " << recipient <<
" TID: " << +tid);
1848 return agreement->get().GetBlockAckType();
1856 "No existing Block Ack agreement with " << recipient <<
" TID: " << +tid);
1857 return agreement->get().GetBlockAckReqType();
1865 "No existing Block Ack agreement with " << originator <<
" TID: " << +tid);
1866 return agreement->get().GetBlockAckType();
1874 "No existing Block Ack agreement with " << originator <<
" TID: " << +tid);
1875 return agreement->get().GetBlockAckReqType();
1932 for (
const auto& [
id, link] :
m_links)
1934 if (link->stationManager->GetHtSupported(address))
1945 for (
const auto& [
id, link] :
m_links)
1947 if (link->stationManager->GetVhtSupported(address))
1958 for (
const auto& [
id, link] :
m_links)
1960 if (link->stationManager->GetHeSupported(address))
1971 for (
const auto& [
id, link] :
m_links)
1973 if (link->stationManager->GetEhtSupported(address))
2099 return capabilities;
2111 bool sgiSupported = htConfiguration->GetShortGuardIntervalSupported();
2112 capabilities.
SetLdpc(htConfiguration->GetLdpcSupported());
2117 uint16_t maxAmsduSize =
2119 if (maxAmsduSize <= 3839)
2130 maxAmpduLength = (1UL <<
static_cast<uint32_t>(std::ceil(std::log2(maxAmpduLength + 1)))) - 1;
2132 capabilities.
SetMaxAmpduLength(std::min(std::max(maxAmpduLength, 8191U), 65535U));
2135 uint64_t maxSupportedRate = 0;
2139 uint8_t nss = (mcs.GetMcsValue() / 8) + 1;
2141 uint64_t dataRate = mcs.GetDataRate(htConfiguration->Get40MHzOperationSupported() ? 40 : 20,
2142 sgiSupported ? 400 : 800,
2144 if (dataRate > maxSupportedRate)
2146 maxSupportedRate = dataRate;
2147 NS_LOG_DEBUG(
"Updating maxSupportedRate to " << maxSupportedRate);
2151 static_cast<uint16_t
>(maxSupportedRate / 1e6));
2158 return capabilities;
2171 "VHT stations have to support 40 MHz operation");
2173 bool sgiSupported = htConfiguration->GetShortGuardIntervalSupported();
2177 uint16_t maxAmsduSize =
2179 if (maxAmsduSize <= 3839)
2183 else if (maxAmsduSize <= 7935)
2194 maxAmpduLength = (1UL <<
static_cast<uint32_t>(std::ceil(std::log2(maxAmpduLength + 1)))) - 1;
2196 capabilities.
SetMaxAmpduLength(std::min(std::max(maxAmpduLength, 8191U), 1048575U));
2198 capabilities.
SetRxLdpc(htConfiguration->GetLdpcSupported());
2204 if (mcs.GetMcsValue() > maxMcs)
2206 maxMcs = mcs.GetMcsValue();
2210 for (uint8_t nss = 1; nss <= phy->GetMaxSupportedRxSpatialStreams(); nss++)
2214 for (uint8_t nss = 1; nss <= phy->GetMaxSupportedTxSpatialStreams(); nss++)
2218 uint64_t maxSupportedRateLGI = 0;
2219 uint16_t maxWidth = vhtConfiguration->Get160MHzOperationSupported() ? 160 : 80;
2222 if (!mcs.IsAllowed(maxWidth, 1))
2226 if (mcs.GetDataRate(maxWidth) > maxSupportedRateLGI)
2228 maxSupportedRateLGI = mcs.GetDataRate(maxWidth);
2229 NS_LOG_DEBUG(
"Updating maxSupportedRateLGI to " << maxSupportedRateLGI);
2233 static_cast<uint16_t
>(maxSupportedRateLGI / 1e6));
2235 static_cast<uint16_t
>(maxSupportedRateLGI / 1e6));
2240 return capabilities;
2254 uint8_t channelWidthSet = 0;
2255 if ((htConfiguration->Get40MHzOperationSupported()) &&
2258 channelWidthSet |= 0x01;
2263 channelWidthSet |= 0x02;
2265 if ((vhtConfiguration->Get160MHzOperationSupported()) &&
2268 channelWidthSet |= 0x04;
2272 if (heConfiguration->GetGuardInterval() ==
NanoSeconds(800))
2283 maxAmpduLength = (1UL <<
static_cast<uint32_t>(std::ceil(std::log2(maxAmpduLength + 1)))) - 1;
2285 capabilities.
SetMaxAmpduLength(std::min(std::max(maxAmpduLength, 1048575U), 8388607U));
2290 if (mcs.GetMcsValue() > maxMcs)
2292 maxMcs = mcs.GetMcsValue();
2298 return capabilities;
2306 "Getting HE 6 GHz band capabilities on band different than 6 GHz");
2311 const auto maxAmsduSize =
2313 if (maxAmsduSize <= 3839)
2317 else if (maxAmsduSize <= 7935)
2326 auto maxAmpduLength =
2329 maxAmpduLength = (1UL <<
static_cast<uint32_t>(std::ceil(std::log2(maxAmpduLength + 1)))) - 1;
2331 capabilities.
SetMaxAmpduLength(std::min(std::max(maxAmpduLength, 8191U), 1048575U));
2333 return capabilities;
2348 uint16_t maxAmsduSize =
2351 if (maxAmsduSize <= 3839)
2355 else if (maxAmsduSize <= 7935)
2369 maxAmpduLength = (1UL <<
static_cast<uint32_t>(std::ceil(std::log2(maxAmpduLength + 1)))) - 1;
2371 capabilities.
SetMaxAmpduLength(std::min(std::max(maxAmpduLength, 8388607U), 16777215U));
2376 support4096Qam ? 1 : 0;
2378 support4096Qam ? 1 : 0;
2380 const uint8_t maxTxNss = phy->GetMaxSupportedTxSpatialStreams();
2381 const uint8_t maxRxNss = phy->GetMaxSupportedRxSpatialStreams();
2384 for (
auto maxMcs : {7, 9, 11, 13})
2398 for (
auto maxMcs : {9, 11, 13})
2412 for (
auto maxMcs : {9, 11, 13})
2426 return capabilities;
2457 uint16_t maxSize = 0;
AttributeValue implementation for Boolean.
The IEEE 802.11be EHT Capabilities.
void SetMaxMpduLength(uint16_t length)
Set the maximum MPDU length.
void SetSupportedTxEhtMcsAndNss(EhtMcsAndNssSet::EhtMcsMapType mapType, uint8_t upperMcs, uint8_t maxNss)
Set a subfield of the Supported EHT-MCS And NSS Set.
EhtPhyCapabilities m_phyCapabilities
EHT PHY Capabilities Info subfield.
void SetMaxAmpduLength(uint32_t maxAmpduLength)
Set the maximum A-MPDU length.
void SetSupportedRxEhtMcsAndNss(EhtMcsAndNssSet::EhtMcsMapType mapType, uint8_t upperMcs, uint8_t maxNss)
Set a subfield of the Supported EHT-MCS And NSS Set.
The Extended Capabilities Information Element.
void SetHtSupported(uint8_t htSupported)
Set the HT Supported flag.
void SetVhtSupported(uint8_t vhtSupported)
Set the VHT Supported flag.
The HE 6 GHz Band Capabilities (IEEE 802.11ax-2021 9.4.2.263)
void SetMaxAmpduLength(uint32_t maxAmpduLength)
Set the maximum AMPDU length.
void SetMaxMpduLength(uint16_t length)
Set the maximum MPDU length.
The IEEE 802.11ax HE Capabilities.
void SetHeSuPpdu1xHeLtf800nsGi(bool heSuPpdu1xHeLtf800nsGi)
Set 1xHE-LTF and 800ns GI in HE SU PPDU reception support.
void SetLdpcCodingInPayload(uint8_t ldpcCodingInPayload)
Set indication whether the transmission and reception of LDPC encoded packets is supported.
void SetHePpdu4xHeLtf800nsGi(bool heSuPpdu4xHeLtf800nsGi)
Set 4xHE-LTF and 800ns GI in HE SU PPDU and HE MU PPDU reception support.
void SetHighestNssSupported(uint8_t nss)
Set highest NSS supported.
void SetMaxAmpduLength(uint32_t maxAmpduLength)
Set the maximum AMPDU length.
void SetChannelWidthSet(uint8_t channelWidthSet)
Set channel width set.
void SetHighestMcsSupported(uint8_t mcs)
Set highest MCS supported.
The HT Capabilities Information Element.
void SetLdpc(uint8_t ldpc)
Set the LDPC field.
void SetTxRxMcsSetUnequal(uint8_t txRxMcsSetUnequal)
Set the transmit / receive MCS set unequal.
void SetRxHighestSupportedDataRate(uint16_t maxSupportedRate)
Set the receive highest supported data rate.
void SetLSigProtectionSupport(uint8_t lSigProtection)
Set the LSIG protection support.
void SetMaxAmsduLength(uint16_t maxAmsduLength)
Set the maximum AMSDU length.
void SetTxMaxNSpatialStreams(uint8_t maxTxSpatialStreams)
Set the transmit maximum N spatial streams.
void SetShortGuardInterval20(uint8_t shortGuardInterval)
Set the short guard interval 20 field.
void SetTxUnequalModulation(uint8_t txUnequalModulation)
Set the transmit unequal modulation.
void SetTxMcsSetDefined(uint8_t txMcsSetDefined)
Set the transmit MCS set defined.
void SetRxMcsBitmask(uint8_t index)
Set the receive MCS bitmask.
void SetSupportedChannelWidth(uint8_t supportedChannelWidth)
Set the supported channel width field.
void SetMaxAmpduLength(uint32_t maxAmpduLength)
Set the maximum AMPDU length.
void SetShortGuardInterval40(uint8_t shortGuardInterval)
Set the short guard interval 40 field.
void SendDelbaFrame(Mac48Address addr, uint8_t tid, bool byOriginator)
Sends DELBA frame to cancel a block ack agreement with STA addressed by addr for TID tid.
static Mac48Address ConvertFrom(const Address &address)
A base class which provides memory management and object aggregation.
void Initialize()
Invoke DoInitialize on all Objects aggregated to this one.
void Dispose()
Dispose of this Object.
bool IsInitialized() const
Check if the object has been initialized.
AttributeValue implementation for Pointer.
Smart pointer class similar to boost::intrusive_ptr.
Ptr< BlockAckManager > GetBaManager()
Get the Block Ack Manager associated with this QosTxop.
void GotAddBaResponse(const MgtAddBaResponseHeader &respHdr, Mac48Address recipient)
Event handler when an ADDBA response is received.
void SetBlockAckThreshold(uint8_t threshold)
Set threshold for block ack mechanism.
void GotDelBaFrame(const MgtDelBaHeader *delBaHdr, Mac48Address recipient)
Event handler when a DELBA frame is received.
void SetBlockAckInactivityTimeout(uint16_t timeout)
Set the BlockAck inactivity timeout.
bool HasFramesToTransmit(uint8_t linkId) override
Check if the Txop has frames to transmit over the given link.
void SetStream(int64_t stream)
Specifies the stream number for the RngStream.
static EventId ScheduleNow(FUNC f, Ts &&... args)
Schedule an event to expire Now.
The IEEE 802.11 SSID Information Element.
AttributeValue implementation for Ssid.
Simulation virtual time values and global simulation resolution.
void StartAccessAfterEvent(uint8_t linkId, bool hadFramesToTransmit, bool checkMediumBusy)
Request channel access on the given link after the occurrence of an event that possibly requires to g...
virtual bool HasFramesToTransmit(uint8_t linkId)
Check if the Txop has frames to transmit over the given link.
virtual void SetWifiMac(const Ptr< WifiMac > mac)
Set the wifi MAC this Txop is associated to.
void SwapLinks(std::map< uint8_t, uint8_t > links)
Swap the links based on the information included in the given map.
void SetTxMiddle(const Ptr< MacTxMiddle > txMiddle)
Set MacTxMiddle this Txop is associated to.
virtual void SetDroppedMpduCallback(DroppedMpdu callback)
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_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.
void SetRxHighestSupportedLgiDataRate(uint16_t supportedDatarate)
Set the receive highest supported LGI data rate.
void SetSupportedChannelWidthSet(uint8_t channelWidthSet)
Set the supported channel width set.
void SetMaxMpduLength(uint16_t length)
Set the maximum MPDU length.
void SetRxLdpc(uint8_t rxLdpc)
Set the receive LDPC.
void SetTxStbc(uint8_t txStbc)
Set the transmit STBC.
void SetTxMcsMap(uint8_t mcs, uint8_t nss)
void SetShortGuardIntervalFor80Mhz(uint8_t shortGuardInterval)
Set the short guard interval 80 MHz.
void SetTxHighestSupportedLgiDataRate(uint16_t supportedDatarate)
Set the transmit highest supported LGI data rate.
void SetShortGuardIntervalFor160Mhz(uint8_t shortGuardInterval)
Set the short guard interval 160 MHz.
void SetMaxAmpduLength(uint32_t maxAmpduLength)
Set the maximum AMPDU length.
void SetRxMcsMap(uint8_t mcs, uint8_t nss)
void SetRxStbc(uint8_t rxStbc)
Set the receive STBC.
bool Get160MHzOperationSupported() const
virtual void DoCompleteConfig()=0
Allow subclasses to complete the configuration of the MAC layer components.
uint16_t GetMaxAmsduSize(AcIndex ac) const
Return the maximum A-MSDU size of the given Access Category.
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
virtual void SetMacQueueScheduler(Ptr< WifiMacQueueScheduler > scheduler)
Set the wifi MAC queue scheduler.
Mac48Address GetBssid(uint8_t linkId) const
uint16_t m_viMaxAmsduSize
maximum A-MSDU size for AC_VI (in bytes)
bool m_shortSlotTimeSupported
flag whether short slot time is supported
void ConfigurePhyDependentParameters(uint8_t linkId)
Configure PHY dependent parameters such as CWmin and CWmax on the given link.
Ptr< HeConfiguration > GetHeConfiguration() const
DroppedMpduTracedCallback m_droppedMpduCallback
This trace indicates that an MPDU was dropped for the given reason.
TypeOfStation GetTypeOfStation() const
Return the type of station.
bool m_qosSupported
This Boolean is set true iff this WifiMac is to model 802.11e/WMM style Quality of Service.
void SetBkQueue(Ptr< QosTxop > edca)
Set the AC_BK channel access function This method is private so that it is only used while constructi...
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.
std::optional< std::reference_wrapper< const RecipientBlockAckAgreement > > RecipientAgreementOptConstRef
optional const reference to RecipientBlockAckAgreement
virtual void SetAddress(Mac48Address address)
void SetFrameExchangeManagers(const std::vector< Ptr< FrameExchangeManager > > &feManagers)
bool CreateLinksIfNeeded(std::size_t nLinks)
If no link has been already created, create the given number links; otherwise, do nothing.
Ptr< Txop > m_txop
TXOP used for transmission of frames to non-QoS peers.
void SetQosSupported(bool enable)
Enable or disable QoS support for the device.
Mac48Address m_address
MAC address of this station.
std::set< uint8_t > m_linkIds
IDs of the links in use.
Ptr< WifiMacQueueScheduler > GetMacQueueScheduler() const
Get the wifi MAC queue scheduler.
uint16_t GetMpduBufferSize() const
uint8_t GetNLinks() const
Get the number of links (can be greater than 1 for 11be devices only).
BlockAckType GetBaTypeAsRecipient(Mac48Address originator, uint8_t tid) const
void SwapLinks(std::map< uint8_t, uint8_t > links)
Swap the links based on the information included in the given map.
uint16_t m_voMaxAmsduSize
maximum A-MSDU size for AC_VO (in bytes)
Ptr< MacRxMiddle > m_rxMiddle
RX middle (defragmentation etc.)
Ptr< WifiMacQueueScheduler > m_scheduler
wifi MAC queue scheduler
void DoInitialize() override
Initialize() implementation.
TypeOfStation m_typeOfStation
the type of station
uint16_t m_mpduBufferSize
BlockAck buffer size (in number of MPDUs)
uint32_t m_beMaxAmpduSize
maximum A-MPDU size for AC_BE (in bytes)
void SetChannelAccessManagers(const std::vector< Ptr< ChannelAccessManager > > &caManagers)
bool TidMappedOnLink(Mac48Address mldAddr, WifiDirection dir, uint8_t tid, uint8_t linkId) const
Check whether the given TID is mapped on the given link in the given direction for the given MLD.
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...
void SetWifiRemoteStationManagers(const std::vector< Ptr< WifiRemoteStationManager > > &stationManagers)
void SetBeBlockAckThreshold(uint8_t threshold)
Set the block ack threshold for AC_BE.
bool GetErpSupported(uint8_t linkId) const
Return whether the device supports ERP on the given link.
void ResetWifiPhys()
Remove currently attached WifiPhy objects from this MAC.
TracedCallback< Ptr< const Packet > > m_macTxTrace
The trace source fired when packets come into the "top" of the device at the L3/L2 transition,...
void SetErpSupported(bool enable, uint8_t linkId)
Enable or disable ERP support for the given link.
uint32_t m_voMaxAmpduSize
maximum A-MPDU size for AC_VO (in bytes)
void ConfigureDcf(Ptr< Txop > dcf, uint32_t cwmin, uint32_t cwmax, std::list< bool > isDsss, AcIndex ac)
Ptr< WifiNetDevice > m_device
Pointer to the device.
void UpdateLinkId(uint8_t id)
This method is intended to be called when a link changes ID in order to update the link ID stored by ...
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.
MpduTracedCallback m_ackedMpduCallback
ack'ed MPDU callback
Ptr< WifiPhy > GetWifiPhy(uint8_t linkId=SINGLE_LINK_OP_ID) const
void SetMpduBufferSize(uint16_t size)
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...
MpduTracedCallback m_nackedMpduCallback
nack'ed MPDU callback
bool GetEhtSupported() const
Return whether the device supports EHT.
void SetTxop(Ptr< Txop > dcf)
Set the Txop object.
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.
void SetBkBlockAckThreshold(uint8_t threshold)
Set the block ack threshold for AC_BK.
void SetVoBlockAckThreshold(uint8_t threshold)
Set the block ack threshold for AC_VO.
virtual std::optional< uint8_t > GetLinkIdByAddress(const Mac48Address &address) const
Get the ID of the link having the given MAC address, if any.
void NotifyPromiscRx(Ptr< const Packet > packet)
std::unordered_map< Mac48Address, WifiTidLinkMapping, WifiAddressHash > m_dlTidLinkMappings
DL TID-to-Link Mapping negotiated with an MLD (identified by its MLD address)
void SetVoQueue(Ptr< QosTxop > edca)
Set the AC_VO channel access function This method is private so that it is only used while constructi...
virtual bool HasFramesToTransmit(uint8_t linkId)
Check if the MAC has frames to transmit over the given link.
void SetWifiRemoteStationManager(Ptr< WifiRemoteStationManager > stationManager)
UniformRandomBitGenerator m_shuffleLinkIdsGen
random number generator to shuffle link IDs
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...
void CompleteConfig()
Complete the configuration of the MAC layer components.
RecipientAgreementOptConstRef GetBaAgreementEstablishedAsRecipient(Mac48Address originator, uint8_t tid) const
void SetBeBlockAckInactivityTimeout(uint16_t timeout)
Set BE block ack inactivity timeout.
Ptr< EhtConfiguration > GetEhtConfiguration() const
TracedCallback< Ptr< const Packet > > m_macRxTrace
The trace source fired for packets successfully received by the device immediately before being forwa...
bool GetVhtSupported(uint8_t linkId) const
Return whether the device supports VHT on the given link.
void SetDsssSupported(bool enable, uint8_t linkId)
Enable or disable DSSS support for the given link.
TracedCallback< Ptr< const Packet > > m_macTxDropTrace
The trace source fired when packets coming into the "top" of the device are dropped at the MAC layer ...
Ptr< MacTxMiddle > m_txMiddle
TX middle (aggregation etc.)
void NotifyTx(Ptr< const Packet > packet)
virtual int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model.
static TypeId GetTypeId()
Get the type ID.
Ptr< HtConfiguration > GetHtConfiguration() const
std::optional< std::reference_wrapper< const WifiTidLinkMapping > > GetTidToLinkMapping(Mac48Address mldAddr, WifiDirection dir) const
Get the TID-to-Link Mapping negotiated with the given MLD (if any) for the given direction.
uint32_t GetMaxAmpduSize(AcIndex ac) const
Return the maximum A-MPDU size of the given Access Category.
BlockAckReqType GetBarTypeAsRecipient(Mac48Address originator, uint8_t tid) const
Ssid m_ssid
Service Set ID (SSID)
std::map< uint8_t, std::unique_ptr< LinkEntity > > m_links
ID-indexed map of Link objects.
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.
Ptr< QosTxop > GetVIQueue() const
Accessor for the AC_VI channel access function.
void SetBssid(Mac48Address bssid, uint8_t linkId)
Ptr< WifiNetDevice > GetDevice() const
Return the device this PHY is associated with.
virtual void Enqueue(Ptr< Packet > packet, Mac48Address to, Mac48Address from)
void NotifyRx(Ptr< const Packet > packet)
TracedCallback< Ptr< const Packet > > m_macRxDropTrace
The trace source fired when packets coming into the "top" of the device are dropped at the MAC layer ...
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...
BlockAckType GetBaTypeAsOriginator(const Mac48Address &recipient, uint8_t tid) const
MpduResponseTimeoutTracedCallback m_mpduResponseTimeoutCallback
MPDU response timeout traced callback.
void SetForwardUpCallback(ForwardUpCallback upCallback)
PsduMapResponseTimeoutTracedCallback m_psduMapResponseTimeoutCallback
PSDU map response timeout traced callback.
ExtendedCapabilities GetExtendedCapabilities() const
Return the extended capabilities of the device.
TracedCallback< Ptr< const Packet > > m_macPromiscRxTrace
The trace source fired for packets successfully received by the device immediately before being forwa...
uint16_t m_bkMaxAmsduSize
maximum A-MSDU size for AC_BK (in bytes)
void SetBkBlockAckInactivityTimeout(uint16_t timeout)
Set BK block ack inactivity timeout.
std::optional< std::reference_wrapper< const OriginatorBlockAckAgreement > > OriginatorAgreementOptConstRef
optional const reference to OriginatorBlockAckAgreement
std::unordered_map< Mac48Address, WifiTidLinkMapping, WifiAddressHash > m_ulTidLinkMappings
UL TID-to-Link Mapping negotiated with an MLD (identified by its MLD address)
virtual bool SupportsSendFrom() const
He6GhzBandCapabilities GetHe6GhzBandCapabilities(uint8_t linkId) const
Return the HE 6GHz band capabilities of the device for the given 6 GHz link.
uint16_t GetMaxBaBufferSize(std::optional< Mac48Address > address=std::nullopt) const
Get the maximum Block Ack buffer size (in number of MPDUs) supported by the given device,...
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.
void SetViBlockAckThreshold(uint8_t threshold)
Set the block ack threshold for AC_VI.
void SetViBlockAckInactivityTimeout(uint16_t timeout)
Set VI block ack inactivity timeout.
bool GetShortSlotTimeSupported() const
BlockAckReqType GetBarTypeAsOriginator(const Mac48Address &recipient, uint8_t tid) const
void NotifyConstructionCompleted() override
Notifier called once the ObjectBase is fully constructed.
void SetupEdcaQueue(AcIndex ac)
This method is a private utility invoked to configure the channel access function for the specified A...
void SetLinkDownCallback(Callback< void > linkDown)
Ptr< QosTxop > GetBKQueue() const
Accessor for the AC_BK channel access function.
void SetPromisc()
Sets the interface in promiscuous mode.
Ptr< VhtConfiguration > GetVhtConfiguration() const
void NotifyRxDrop(Ptr< const Packet > packet)
virtual void SetLinkUpCallback(Callback< void > linkUp)
Ptr< WifiRemoteStationManager > GetWifiRemoteStationManager(uint8_t linkId=0) const
const std::set< uint8_t > & GetLinkIds() const
void SetDevice(const Ptr< WifiNetDevice > device)
Sets the device this PHY is associated with.
void SetCtsToSelfSupported(bool enable)
Enable or disable CTS-to-self feature.
Mac48Address GetLocalAddress(const Mac48Address &remoteAddr) const
Get the local MAC address used to communicate with a remote STA.
EdcaQueues m_edca
This is a map from Access Category index to the corresponding channel access function.
uint32_t m_bkMaxAmpduSize
maximum A-MPDU size for AC_BK (in bytes)
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.
virtual void ConfigureContentionWindow(uint32_t cwMin, uint32_t cwMax)
bool Is6GhzBand(uint8_t linkId) const
Indicate if a given link is on the 6 GHz band.
OriginatorAgreementOptConstRef GetBaAgreementEstablishedAsOriginator(Mac48Address recipient, uint8_t tid) const
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
ForwardUpCallback m_forwardUp
Callback to forward packet up the stack.
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.
void SetupDcfQueue()
This method is a private utility invoked to configure the channel access function for devices that do...
void SetBeQueue(Ptr< QosTxop > edca)
Set the AC_BE channel access function This method is private so that it is only used while constructi...
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)
PsduResponseTimeoutTracedCallback m_psduResponseTimeoutCallback
PSDU response timeout traced callback.
Ptr< QosTxop > GetQosTxop(AcIndex ac) const
Accessor for a specified EDCA object.
void NotifyTxDrop(Ptr< const Packet > packet)
void DoDispose() override
Destructor implementation.
bool GetDsssSupported(uint8_t linkId) const
Return whether the device supports DSSS on the given link.
Ptr< ChannelAccessManager > GetChannelAccessManager(uint8_t linkId=SINGLE_LINK_OP_ID) const
Get the Channel Access Manager associated with the given link.
void SetVoBlockAckInactivityTimeout(uint16_t timeout)
Set VO block ack inactivity timeout.
virtual std::unique_ptr< LinkEntity > CreateLinkEntity() const
Create a LinkEntity object.
void SetViQueue(Ptr< QosTxop > edca)
Set the AC_VI channel access function This method is private so that it is only used while constructi...
void SetShortSlotTimeSupported(bool enable)
Enable or disable short slot time feature.
bool m_ctsToSelfSupported
flag indicating whether CTS-To-Self is supported
uint16_t m_beMaxAmsduSize
maximum A-MSDU size for AC_BE (in bytes)
virtual Mac48Address DoGetLocalAddress(const Mac48Address &remoteAddr) const
This method is called if this device is an MLD to determine the MAC address of the affiliated STA use...
uint32_t m_viMaxAmpduSize
maximum A-MPDU size for AC_VI (in bytes)
Ptr< VhtConfiguration > GetVhtConfiguration() const
Ptr< EhtConfiguration > GetEhtConfiguration() const
Ptr< HtConfiguration > GetHtConfiguration() const
Ptr< HeConfiguration > GetHeConfiguration() const
Ptr< WifiPhy > GetPhy() const
WifiStandard GetStandard() const
Get the configured Wi-Fi standard.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Ptr< const AttributeAccessor > MakeBooleanAccessor(T1 a1)
Ptr< const AttributeChecker > MakeBooleanChecker()
Ptr< const AttributeAccessor > MakePointerAccessor(T1 a1)
Ptr< const AttributeAccessor > MakeSsidAccessor(T1 a1)
Ptr< const AttributeChecker > MakeSsidChecker()
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
#define NS_ABORT_MSG(msg)
Unconditional abnormal program termination with a message.
#define NS_ABORT_UNLESS(cond)
Abnormal program termination if a condition is false.
#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(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.
Time MicroSeconds(uint64_t value)
Construct a Time in the indicated unit.
Time NanoSeconds(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.
TypeOfStation
Enumeration for type of WiFi station.
WifiStandard
Identifies the IEEE 802.11 specifications that a Wifi device can be configured to use.
AcIndex QosUtilsMapTidToAc(uint8_t tid)
Maps TID (Traffic ID) to Access classes.
WifiQueueBlockedReason
Enumeration of the reasons to block container queues.
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_PHY_BAND_2_4GHZ
The 2.4 GHz band.
@ WIFI_PHY_BAND_5GHZ
The 5 GHz band.
@ 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)
@ AC_UNDEF
Total number of ACs.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
U * PeekPointer(const Ptr< U > &p)
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...
void Shuffle(RND_ACCESS_ITER first, RND_ACCESS_ITER last, Ptr< UniformRandomVariable > rv)
Shuffle the elements in the range first to last.
static constexpr uint8_t SINGLE_LINK_OP_ID
Link ID for single link operations (helps tracking places where correct link ID is to be used to supp...
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...
WifiDirection
Wifi direction.
@ LOG_FUNCTION
Function tracing for non-trivial function calls.
std::map< uint8_t, std::set< uint8_t > > WifiTidLinkMapping
TID-indexed map of the link set to which the TID is mapped.
The different BlockAckRequest variants.
The different BlockAck variants.
@ EHT_MCS_MAP_TYPE_20_MHZ_ONLY
@ EHT_MCS_MAP_TYPE_NOT_LARGER_THAN_80_MHZ
@ EHT_MCS_MAP_TYPE_160_MHZ
uint8_t supportTx1024And4096QamForRuSmallerThan242Tones
Tx 1024-QAM And 4096-QAM < 242-tone RU Support.
uint8_t supportRx1024And4096QamForRuSmallerThan242Tones
Rx 1024-QAM And 4096-QAM < 242-tone RU Support.
Structure holding information specific to a single link.
Ptr< WifiRemoteStationManager > stationManager
Remote station manager (rate control, RTS/CTS/fragmentation thresholds etc.)
Ptr< WifiPhy > phy
Wifi PHY object.
virtual ~LinkEntity()
Destructor (a virtual method is needed to make this struct polymorphic)
bool dsssSupported
set to true iff this WifiMac is to model 802.11b
bool erpSupported
set to true iff this WifiMac is to model 802.11g
Ptr< FrameExchangeManager > feManager
Frame Exchange Manager object.
Ptr< ChannelAccessManager > channelAccessManager
channel access manager object