11#include "ns3/config.h"
12#include "ns3/eht-configuration.h"
13#include "ns3/ht-frame-exchange-manager.h"
15#include "ns3/mgt-action-headers.h"
16#include "ns3/mgt-headers.h"
17#include "ns3/mobility-helper.h"
18#include "ns3/multi-link-element.h"
19#include "ns3/node-list.h"
20#include "ns3/packet-socket-helper.h"
21#include "ns3/packet.h"
22#include "ns3/pointer.h"
23#include "ns3/rng-seed-manager.h"
24#include "ns3/rr-multi-user-scheduler.h"
25#include "ns3/spectrum-wifi-phy.h"
26#include "ns3/string.h"
27#include "ns3/vht-configuration.h"
28#include "ns3/wifi-acknowledgment.h"
29#include "ns3/wifi-assoc-manager.h"
30#include "ns3/wifi-mac-header.h"
31#include "ns3/wifi-mac-queue.h"
32#include "ns3/wifi-net-device.h"
33#include "ns3/wifi-protection.h"
46 :
TestCase(
"Check the implementation of WifiAssocManager::GetNextAffiliatedAp()")
120 "Unexpected neighbor ID of the second reported AP");
123 "Unexpected tbtt ID of the second reported AP");
129 "Did not expect to find a third suitable reported AP");
136 auto apIt = allAps.begin();
139 "Unexpected neighbor ID of the first reported AP");
142 "Unexpected tbtt ID of the first reported AP");
147 "Unexpected neighbor ID of the second reported AP");
150 "Unexpected tbtt ID of the second reported AP");
158 .SetGroupName(
"Wifi")
164 :
TestCase(
"Test the WifiMac::SwapLinks() method")
171 const std::map<uint8_t, uint8_t>& links,
172 const std::map<uint8_t, uint8_t>& expected)
179 std::vector<Ptr<WifiPhy>> phys;
180 std::vector<Ptr<FrameExchangeManager>> feManagers;
181 std::vector<Ptr<WifiRemoteStationManager>> rsManagers;
183 for (std::size_t i = 0; i < nLinks; ++i)
187 phys.emplace_back(phy);
191 mac->SetWifiPhys(phys);
192 mac->SetFrameExchangeManagers(feManagers);
193 mac->SetWifiRemoteStationManagers(rsManagers);
194 mac->GetTxop()->SetWifiMac(mac);
197 for (std::size_t
id = 0;
id < nLinks; ++id)
199 mac->GetTxop()->SetMinCw(
id,
id);
202 mac->SwapLinks(links);
206 for (
const auto& [linkId, phyId] : expected)
210 "Link ID " << +linkId <<
" does not exist");
217 text <<
": Link " << +phyId <<
" has not been moved to link "
224 text <<
": Link ID stored by FrameExchangeManager has not been updated");
230 text <<
": Link ID stored by RemoteStationManager has not been updated");
234 text <<
": Txop Link entity " << +phyId
235 <<
" has not been moved to link " << +linkId);
244 RunOne(
"No change needed", 3, {{0, 0}, {1, 1}, {2, 2}}, {{0, 0}, {1, 1}, {2, 2}});
245 RunOne(
"Circular swapping", 3, {{0, 2}, {1, 0}, {2, 1}}, {{0, 1}, {1, 2}, {2, 0}});
246 RunOne(
"Swapping two links, one unchanged", 3, {{0, 2}, {2, 0}}, {{0, 2}, {1, 1}, {2, 0}});
247 RunOne(
"Non-circular swapping, autodetect how to close the loop",
250 {{0, 1}, {1, 2}, {2, 0}});
251 RunOne(
"A different non-circular swapping, same result",
254 {{0, 1}, {1, 2}, {2, 0}});
255 RunOne(
"One move only, autodetect how to complete the swapping",
258 {{0, 2}, {1, 1}, {2, 0}});
259 RunOne(
"Create a new link ID (2), remove the unused one (0)",
263 RunOne(
"One move only that creates a new link ID (2)", 2, {{0, 2}}, {{1, 1}, {2, 0}});
264 RunOne(
"Move all links to a new set of IDs", 2, {{0, 2}, {1, 3}}, {{2, 0}, {3, 1}});
268 :
TestCase(
"Test the assignment of AIDs"),
269 m_linkChannels({
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}",
"{2, 0, BAND_2_4GHZ, 0}"}),
280 int64_t streamNumber{1};
283 wifiApNode.Create(1);
288 wifi.SetRemoteStationManager(
"ns3::ConstantRateWifiManager",
308 mac.SetType(
"ns3::ApWifiMac",
314 auto apDevice = wifi.Install(phyHelper, mac, wifiApNode);
323 for (
const auto&
id : links)
331 mac.SetType(
"ns3::StaWifiMac",
338 auto staDevice = wifi.Install(phyHelper, mac, staNode);
339 wifiStaNodes.Add(staNode);
348 positionAlloc->Add(Vector(0.0, 0.0, 0.0));
350 mobility.SetPositionAllocator(positionAlloc);
351 mobility.SetMobilityModel(
"ns3::ConstantPositionMobilityModel");
352 mobility.Install(wifiApNode);
353 mobility.Install(wifiStaNodes);
358 mac->TraceConnectWithoutContext(
367 const auto aid = staMac->GetAssociationId();
369 std::stringstream linksStr;
370 const auto setupLinks = staMac->GetSetupLinkIds();
371 std::copy(setupLinks.cbegin(), setupLinks.cend(), std::ostream_iterator<int>(linksStr,
" "));
373 NS_LOG_INFO(
"STA " << staMac->GetAddress() <<
" associated with AID " << aid <<
" links "
383 "Unexpected set of setup links " << linksStr.str());
391 ->SetSsid(
Ssid(
"ns-3-ssid"));
411 mac->TraceDisconnectWithoutContext(
423 m_staChannels(baseParams.staChannels),
424 m_apChannels(baseParams.apChannels),
425 m_fixedPhyBands(baseParams.fixedPhyBands),
426 m_staMacs(nStations),
427 m_nStations(nStations),
429 m_rxPkts(nStations + 1)
435 std::optional<Direction> direction)
437 std::optional<Mac48Address> apAddr;
438 std::optional<Mac48Address> staAddr;
441 if (psdu->GetHeader(0).IsQosData())
443 direction = (!psdu->GetHeader(0).IsToDs() && psdu->GetHeader(0).IsFromDs()) ?
DL :
UL;
449 if (!psdu->GetAddr1().IsGroup())
451 staAddr = psdu->GetAddr1();
453 apAddr = psdu->GetAddr2();
457 if (!psdu->GetAddr1().IsGroup())
459 apAddr = psdu->GetAddr1();
461 staAddr = psdu->GetAddr2();
467 for (uint8_t linkId = 0; linkId <
m_apMac->GetNLinks(); linkId++)
469 if (
m_apMac->GetFrameExchangeManager(linkId)->GetAddress() == *apAddr)
477 "Address " << *apAddr <<
" is not an AP device address. "
478 <<
"PSDU: " << *psdu);
486 for (
const auto& linkId :
m_staMacs[i]->GetLinkIds())
488 if (
m_staMacs[i]->GetFrameExchangeManager(linkId)->GetAddress() == *staAddr)
501 "Address " << *staAddr <<
" is not a STA device address. "
502 <<
"PSDU: " << *psdu);
513 auto linkId = mac->GetLinkForPhy(phyId);
517 for (
const auto& [aid, psdu] : psduMap)
519 std::stringstream ss;
520 ss << std::setprecision(10) <<
"PSDU #" <<
m_txPsdus.size() <<
" Link ID "
521 << +linkId.value() <<
" Phy ID " << +phyId <<
" #MPDUs " << psdu->GetNMpdus();
522 for (
auto it = psdu->begin(); it != psdu->end(); ++it)
536 auto band = mac->GetDevice()->GetPhy(phyId)->GetPhyBand();
537 bool hasHtCapabilities;
538 bool hasVhtCapabilities;
539 bool hasHeCapabilities;
540 bool hasHe6GhzCapabilities;
541 bool hasEhtCapabilities;
543 auto findCapabilities = [&](
auto&& frame) {
544 hasHtCapabilities = frame.template Get<HtCapabilities>().has_value();
545 hasVhtCapabilities = frame.template Get<VhtCapabilities>().has_value();
546 hasHeCapabilities = frame.template Get<HeCapabilities>().has_value();
547 hasHe6GhzCapabilities = frame.template Get<He6GhzBandCapabilities>().has_value();
548 hasEhtCapabilities = frame.template Get<EhtCapabilities>().has_value();
551 switch (mpdu->GetHeader().GetType())
555 mpdu->GetPacket()->PeekHeader(beacon);
556 findCapabilities(beacon);
562 mpdu->GetPacket()->PeekHeader(probeReq);
563 findCapabilities(probeReq);
569 mpdu->GetPacket()->PeekHeader(probeResp);
570 findCapabilities(probeResp);
576 mpdu->GetPacket()->PeekHeader(assocReq);
577 findCapabilities(assocReq);
583 mpdu->GetPacket()->PeekHeader(assocResp);
584 findCapabilities(assocResp);
595 "HT Capabilities should not be present in a mgt frame sent in 6 GHz band");
599 "VHT Capabilities should only be present in a mgt frame sent in 5 GHz band");
602 "HE Capabilities should always be present in a mgt frame");
604 hasHe6GhzCapabilities,
606 "HE 6GHz Band Capabilities should only be present in a mgt frame sent in 6 GHz band");
609 "EHT Capabilities should always be present in a mgt frame");
615 NS_LOG_INFO(
"Packet received by NODE " << +nodeId <<
"\n");
621 const std::vector<std::string>& channels,
629 for (
const auto& str : channels)
636 for (
const auto& [band, channel] : channelMap)
647 int64_t streamNumber = 30;
650 wifiApNode.Create(1);
658 wifi.SetRemoteStationManager(
"ns3::ConstantRateWifiManager",
679 mac.SetType(
"ns3::StaWifiMac",
687 mac.SetType(
"ns3::ApWifiMac",
706 positionAlloc->Add(Vector(0.0, 0.0, 0.0));
707 positionAlloc->Add(Vector(1.0, 0.0, 0.0));
708 mobility.SetPositionAllocator(positionAlloc);
710 mobility.SetMobilityModel(
"ns3::ConstantPositionMobilityModel");
711 mobility.Install(wifiApNode);
712 mobility.Install(wifiStaNodes);
722 for (uint8_t phyId = 0; phyId <
m_apMac->GetDevice()->GetNPhys(); phyId++)
725 "/NodeList/0/DeviceList/*/$ns3::WifiNetDevice/Phys/" + std::to_string(phyId) +
731 for (uint8_t phyId = 0; phyId <
m_staMacs[i]->GetDevice()->GetNPhys(); phyId++)
734 "/DeviceList/*/$ns3::WifiNetDevice/Phys/" +
735 std::to_string(phyId) +
"/PhyTxPsduBegin",
743 packetSocket.
Install(wifiApNode);
744 packetSocket.
Install(wifiStaNodes);
756 server->SetLocal(srvAddr);
757 (*nodeIt)->AddApplication(server);
758 server->SetStartTime(
Seconds(0));
765 "/NodeList/" + std::to_string(nodeId) +
766 "/ApplicationList/*/$ns3::PacketSocketServer/Rx",
771 m_apMac->TraceConnectWithoutContext(
"AssociatedSta",
781 uint8_t priority)
const
788 client->SetRemote(sockAddr);
789 client->SetStartTime(delay);
820 const std::vector<uint8_t>& setupLinks,
822 const std::string& dlTidToLinkMapping,
823 const std::string& ulTidToLinkMapping,
824 bool support160MHzOp)
826 m_setupLinks(setupLinks),
827 m_scanType(scanType),
829 m_apNegSupport(apNegSupport),
830 m_dlTidLinkMappingStr(dlTidToLinkMapping),
831 m_ulTidLinkMappingStr(ulTidToLinkMapping),
832 m_support160MHzOp(support160MHzOp)
842 m_apMac->GetEhtConfiguration()->SetAttribute(
"TidToLinkMappingNegSupport",
846 auto staEhtConfig =
m_staMacs[0]->GetEhtConfiguration();
847 staEhtConfig->SetAttribute(
"TidToLinkMappingNegSupport",
848 EnumValue(WifiTidToLinkMappingNegSupport::ANY_LINK_SET));
859 if (
m_apNegSupport == WifiTidToLinkMappingNegSupport::NOT_SUPPORTED ||
860 (
m_apNegSupport == WifiTidToLinkMappingNegSupport::SAME_LINK_SET &&
868 using TupleRefs = std::tuple<std::reference_wrapper<const WifiTidLinkMapping>,
869 std::reference_wrapper<uint8_t>,
870 std::reference_wrapper<std::optional<uint8_t>>,
872 for (
auto& [mappingRef, tid1Ref, tid2Ref, mac] :
877 for (uint8_t tid1 = 0; tid1 < 8; tid1++)
879 if (
auto it1 = mappingRef.get().find(tid1);
880 it1 != mappingRef.get().cend() && it1->second.size() !=
m_setupLinks.size())
883 for (uint8_t tid2 = tid1 + 1; tid2 < 8; tid2++)
885 if (
auto it2 = mappingRef.get().find(tid2);
886 it2 != mappingRef.get().cend() && it2->second.size() !=
m_setupLinks.size())
888 std::list<uint8_t> intersection;
889 std::set_intersection(it1->second.cbegin(),
891 it2->second.cbegin(),
893 std::back_inserter(intersection));
894 if (intersection.empty())
897 tid2Ref.get() = tid2;
902 tid1Ref.get() = tid1;
907 std::list<uint8_t> tids = {tid1Ref.get()};
910 tids.emplace_back(*tid2Ref.get());
914 for (
auto tid : tids)
916 std::string attrName;
920 attrName =
"VI_MaxAmpduSize";
923 attrName =
"VO_MaxAmpduSize";
926 attrName =
"BE_MaxAmpduSize";
929 attrName =
"BK_MaxAmpduSize";
943 staMac->GetVhtConfiguration()->SetAttribute(
"Support160MHzOperation",
948 staMac->GetWifiPhy(linkId++)->SetAttribute(
"ChannelSettings",
StringValue(str));
963 m_apMac->GetDevice()->GetNode()->AddApplication(
967 m_apMac->GetDevice()->GetNode()->AddApplication(
979 m_staMacs[0]->GetDevice()->GetNode()->AddApplication(
983 m_staMacs[0]->GetDevice()->GetNode()->AddApplication(
1000 std::size_t index = 0;
1004 const auto& mpdu = *frameInfo.psduMap.begin()->second->begin();
1005 const auto& linkId = frameInfo.linkId;
1007 switch (mpdu->GetHeader().GetType())
1039 std::size_t expectedProbeResp = 0;
1048 if (staChannel == apChannel)
1050 expectedProbeResp++;
1062 expectedRxDlPkts *= 2;
1066 "Unexpected number of DL packets received");
1071 expectedRxUlPkts *= 2;
1075 "Unexpected number of UL packets received");
1088 mpdu->GetHeader().GetAddr2(),
1089 "TA of Beacon frame is not the address of the link it is transmitted on");
1091 mpdu->GetPacket()->PeekHeader(beacon);
1095 if (
m_apMac->GetNLinks() == 1)
1099 "RNR Element in Beacon frame from single link AP");
1102 "Multi-Link Element in Beacon frame from single link AP");
1110 static_cast<std::size_t
>(
m_apMac->GetNLinks() - 1),
1111 "Unexpected number of Neighbor AP Info fields in RNR");
1112 for (std::size_t nbrApInfoId = 0; nbrApInfoId < rnr->GetNNbrApInfoFields(); nbrApInfoId++)
1116 "MLD Parameters not present");
1119 "Expected only one TBTT Info subfield per Neighbor AP Info");
1120 uint8_t nbrLinkId = rnr->GetMldParameters(nbrApInfoId, 0).linkId;
1122 m_apMac->GetFrameExchangeManager(nbrLinkId)->GetAddress(),
1123 "BSSID advertised in Neighbor AP Info field "
1125 <<
" does not match the address configured on the link "
1126 "advertised in the same field");
1132 "Incorrect MLD address advertised in Multi-Link Element");
1135 "Incorrect Link ID advertised in Multi-Link Element");
1146 m_apMac->GetFrameExchangeManager(linkId)->GetAddress(),
1147 mpdu->GetHeader().GetAddr2(),
1148 "TA of Probe Response is not the address of the link it is transmitted on");
1150 mpdu->GetPacket()->PeekHeader(probeResp);
1154 if (
m_apMac->GetNLinks() == 1)
1158 "RNR Element in Probe Response frame from single link AP");
1161 "Multi-Link Element in Probe Response frame from single link AP");
1169 static_cast<std::size_t
>(
m_apMac->GetNLinks() - 1),
1170 "Unexpected number of Neighbor AP Info fields in RNR");
1171 for (std::size_t nbrApInfoId = 0; nbrApInfoId < rnr->GetNNbrApInfoFields(); nbrApInfoId++)
1175 "MLD Parameters not present");
1178 "Expected only one TBTT Info subfield per Neighbor AP Info");
1179 uint8_t nbrLinkId = rnr->GetMldParameters(nbrApInfoId, 0).linkId;
1181 m_apMac->GetFrameExchangeManager(nbrLinkId)->GetAddress(),
1182 "BSSID advertised in Neighbor AP Info field "
1184 <<
" does not match the address configured on the link "
1185 "advertised in the same field");
1191 "Incorrect MLD address advertised in Multi-Link Element");
1194 "Incorrect Link ID advertised in Multi-Link Element");
1205 m_staMacs[0]->GetFrameExchangeManager(linkId)->GetAddress(),
1206 mpdu->GetHeader().GetAddr2(),
1207 "TA of Assoc Request frame is not the address of the link it is transmitted on");
1209 mpdu->GetPacket()->PeekHeader(assoc);
1216 "Multi-Link Element in Assoc Request frame from single link STA");
1222 "No Multi-Link Element in Assoc Request frame");
1225 "Incorrect MLD Address advertised in Multi-Link Element");
1227 mle->GetNPerStaProfileSubelements(),
1229 "Incorrect number of Per-STA Profile subelements in Multi-Link Element");
1230 for (std::size_t i = 0; i < mle->GetNPerStaProfileSubelements(); i++)
1232 auto& perStaProfile = mle->GetPerStaProfile(i);
1235 "Per-STA Profile must contain STA MAC address");
1237 auto staLinkId =
m_staMacs[0]->GetLinkIdByAddress(perStaProfile.GetStaMacAddress());
1239 staLinkId.has_value(),
1241 "No link found with the STA MAC address advertised in Per-STA Profile");
1245 "The STA that sent the Assoc Request should not be included in a Per-STA Profile");
1249 "Not expecting to setup STA link ID " << +staLinkId.value());
1252 +perStaProfile.GetLinkId(),
1253 "Not expecting to request association to AP Link ID in Per-STA Profile");
1256 "Missing Association Request in Per-STA Profile");
1270 "Didn't expect a TID-to-Link Mapping IE in Assoc Request frame");
1278 "Unexpected number of TID-to-Link Mapping IE in Assoc Request");
1283 +
static_cast<uint8_t
>(
dir),
1284 "Unexpected direction in TID-to-Link Mapping IE " << tlmId);
1285 auto& expectedMapping =
1289 expectedMapping.empty(),
1290 "Default Link Mapping bit not set correctly");
1292 expectedMapping.size(),
1293 "Unexpected number of Link Mapping Of TID n fields");
1294 for (uint8_t tid = 0; tid < 8; tid++)
1296 if (
auto it = expectedMapping.find(tid); it != expectedMapping.cend())
1300 "Unexpected link mapping for TID "
1301 << +tid <<
" direction " <<
dir);
1307 "Expecting no Link Mapping Of TID n field for TID "
1308 << +tid <<
" direction " <<
dir);
1313 if (tlm.size() == 1)
1315 checkTlm(0, WifiDirection::BOTH_DIRECTIONS);
1319 std::size_t dlId = (tlm[0].m_control.direction == WifiDirection::DOWNLINK ? 0 : 1);
1320 std::size_t ulId = (dlId == 0 ? 1 : 0);
1322 checkTlm(dlId, WifiDirection::DOWNLINK);
1323 checkTlm(ulId, WifiDirection::UPLINK);
1336 m_apMac->GetFrameExchangeManager(linkId)->GetAddress(),
1337 mpdu->GetHeader().GetAddr2(),
1338 "TA of Assoc Response frame is not the address of the link it is transmitted on");
1340 mpdu->GetPacket()->PeekHeader(assoc);
1348 "Multi-Link Element in Assoc Response frame with single link AP or single link STA");
1355 "Incorrect MLD Address advertised in Multi-Link Element");
1358 "Incorrect number of Per-STA Profile subelements in Multi-Link Element");
1359 for (std::size_t i = 0; i < mle->GetNPerStaProfileSubelements(); i++)
1361 auto& perStaProfile = mle->GetPerStaProfile(i);
1364 "Per-STA Profile must contain STA MAC address");
1366 auto apLinkId =
m_apMac->GetLinkIdByAddress(perStaProfile.GetStaMacAddress());
1368 apLinkId.has_value(),
1370 "No link found with the STA MAC address advertised in Per-STA Profile");
1372 +perStaProfile.GetLinkId(),
1373 "Link ID and MAC address advertised in Per-STA Profile do not match");
1377 "The AP that sent the Assoc Response should not be included in a Per-STA Profile");
1381 "Not expecting to setup AP link ID " << +apLinkId.value());
1384 "Missing Association Response in Per-STA Profile");
1391 "Didn't expect to find a TID-to-Link Mapping IE in Association Response");
1407 auto staAddr =
m_staMacs[0]->GetFrameExchangeManager(staLinkId)->GetAddress();
1408 auto apAddr =
m_apMac->GetFrameExchangeManager(apLinkId)->GetAddress();
1410 auto staRemoteMgr =
m_staMacs[0]->GetWifiRemoteStationManager(staLinkId);
1411 auto apRemoteMgr =
m_apMac->GetWifiRemoteStationManager(apLinkId);
1416 "Unexpected BSSID for STA link ID " << +staLinkId);
1421 "Incorrect MLD address stored by STA on link ID " << +staLinkId);
1423 (staRemoteMgr->GetAffiliatedStaAddress(
m_apMac->GetAddress()) == apAddr),
1425 "Incorrect affiliated address stored by STA on link ID " << +staLinkId);
1431 "Expecting STA " << staAddr <<
" to be associated on link "
1436 (apRemoteMgr->GetMldAddress(staAddr) ==
m_staMacs[0]->GetAddress()),
1438 "Incorrect MLD address stored by AP on link ID " << +apLinkId);
1440 (apRemoteMgr->GetAffiliatedStaAddress(
m_staMacs[0]->GetAddress()) == staAddr),
1442 "Incorrect affiliated address stored by AP on link ID " << +apLinkId);
1444 auto aid =
m_apMac->GetAssociationId(staAddr, apLinkId);
1445 const auto& staList =
m_apMac->GetStaList(apLinkId);
1448 "STA " << staAddr <<
" not found in list of associated STAs");
1452 const auto& staChannel =
m_staMacs[0]->GetWifiPhy(staLinkId)->GetOperatingChannel();
1453 const auto& apChannel =
m_apMac->GetWifiPhy(apLinkId)->GetOperatingChannel();
1455 auto width = apChannel.GetTotalWidth();
1456 auto primary20 = apChannel.GetPrimaryChannelIndex(
MHz_u{20});
1461 primary20 -= apChannel.GetPrimaryChannelIndex(
MHz_u{80}) * 4;
1466 "Incorrect operating channel number for STA on link " << +staLinkId);
1468 apChannel.GetPrimaryChannelCenterFrequency(width),
1469 "Incorrect operating channel frequency for STA on link "
1473 "Incorrect operating channel width for STA on link " << +staLinkId);
1475 +apChannel.GetPhyBand(),
1476 "Incorrect operating PHY band for STA on link " << +staLinkId);
1479 "Incorrect operating primary channel index for STA on link "
1484 auto checkStoredMapping =
1488 "Link mapping stored by "
1489 << (mac->GetTypeOfStation() ==
AP ?
"AP" :
"non-AP")
1490 <<
" MLD for " <<
dir <<
" direction "
1491 << (present ?
"expected" :
"not expected"));
1494 const auto& mapping =
1497 (mac->GetTidToLinkMapping(dest->GetAddress(),
dir)->get() == mapping),
1499 "Incorrect link mapping stored by "
1500 << (mac->GetTypeOfStation() ==
AP ?
"AP" :
"non-AP") <<
" MLD for " <<
dir
1505 for (uint8_t tid = 0; tid < 8; ++tid)
1507 const auto& linkSet = mapping.contains(tid) ? mapping.at(tid) : setupLinks;
1509 for (
const auto linkId : setupLinks)
1512 mac->TidMappedOnLink(dest->GetAddress(),
dir, tid, linkId),
1513 linkSet.contains(linkId),
1514 "Incorrect return value on " << (mac ==
m_apMac ?
"AP" :
"STA")
1515 <<
" direction " <<
dir <<
" TID " << +tid
1516 <<
" linkID " << +linkId);
1522 auto storedMapping =
m_apMac->GetNLinks() > 1 &&
m_staMacs[0]->GetNLinks() > 1 &&
1524 checkStoredMapping(
m_apMac,
m_staMacs[0], WifiDirection::DOWNLINK, storedMapping);
1525 checkStoredMapping(
m_apMac,
m_staMacs[0], WifiDirection::UPLINK, storedMapping);
1526 checkStoredMapping(
m_staMacs[0],
m_apMac, WifiDirection::DOWNLINK, storedMapping);
1527 checkStoredMapping(
m_staMacs[0],
m_apMac, WifiDirection::UPLINK, storedMapping);
1540 for (uint8_t linkId = 0; linkId <
m_apMac->GetNLinks(); ++linkId)
1545 auto mask =
m_apMac->GetMacQueueScheduler()->GetQueueLinkMask(
AC_BE, queueId, linkId);
1548 "Unexpected presence/absence of mask on link " << +linkId);
1558 for (
const auto& linkId :
m_staMacs[0]->GetLinkIds())
1566 "Link " << +linkId <<
" has not been setup but is not disabled");
1573 "Expecting link " << +linkId <<
" to be active");
1584 const auto& hdr = mpdu->GetHeader();
1593 if (!hdr.IsToDs() && hdr.IsFromDs())
1595 dir = WifiDirection::DOWNLINK;
1596 width =
m_apMac->GetWifiPhy(linkId)->GetOperatingChannel().GetTotalWidth();
1598 else if (hdr.IsToDs() && !hdr.IsFromDs())
1600 dir = WifiDirection::UPLINK;
1601 width =
m_staMacs[0]->GetWifiPhy(linkId)->GetOperatingChannel().GetTotalWidth();
1605 NS_ABORT_MSG(
"Invalid combination for QoS data frame: ToDS(" << hdr.IsToDs() <<
") FromDS("
1606 << hdr.IsFromDs() <<
")");
1617 uint8_t tid = hdr.GetQosTid();
1620 (tid2.has_value() && tid == *tid2),
1621 "QoS frame with unexpected TID " << +tid);
1624 auto findLinkSet = [
this,
dir](uint8_t tid) -> std::set<uint8_t> {
1629 if (
auto it = mappingOptRef->get().find(tid); it != mappingOptRef->get().cend())
1631 linkSet = it->second;
1632 NS_ASSERT_MSG(!linkSet.empty(),
"TID " << +tid <<
" mapped to no link");
1638 auto linkSet = findLinkSet(tid);
1645 std::size_t nConcurFrames = std::min(qosFrames.size(), linkSet.size());
1648 for (std::size_t i = 0; i < nConcurFrames; i++)
1650 auto prev = qosFrames[i];
1660 if (qosFrames.size() < linkSet.size())
1665 "The " <<
dir <<
" QoS frame number " << qosFrames.size()
1666 <<
" was not sent concurrently with others on link "
1667 << +linkId <<
" which TID " << +tid <<
" is mapped to");
1674 "The " <<
dir <<
" QoS frame number " << qosFrames.size()
1675 <<
" was sent concurrently with others on a link "
1676 << +linkId <<
" which TID " << +tid <<
" is mapped to");
1684 "QoS frame sent on Link ID "
1685 << +linkId <<
" that does not belong to the link set of TID "
1692 auto otherTid = (tid == tid1) ? *tid2 : tid1;
1694 auto otherLinkSet = findLinkSet(otherTid);
1697 std::size_t nOtherConcurFrames = std::min(otherQosFrames.size(), otherLinkSet.size());
1700 for (std::size_t i = 0; i < nOtherConcurFrames; i++)
1702 auto prev = otherQosFrames[i];
1712 if (qosFrames.size() < linkSet.size())
1717 "The " <<
dir <<
" QoS frame number " << qosFrames.size()
1718 <<
" was not sent concurrently with others with TID "
1725 qosFrames.emplace_back(index);
1737 uint8_t nMaxInflight)
1739 std::string(
"Check data transmission between MLDs ") +
1742 ?
"with BA agreement, send BAR after BlockAck timeout"
1743 :
"with BA agreement, send Data frames after BlockAck timeout")
1744 :
"without BA agreement") +
1745 " (Traffic pattern: " +
std::to_string(static_cast<uint8_t>(trafficPattern)) +
1751 m_trafficPattern(trafficPattern),
1754 m_nMaxInflight(nMaxInflight),
1772 auto psdu = psduMap.begin()->second;
1774 switch (psdu->GetHeader(0).GetType())
1779 psdu->GetHeader(0).GetAddr2() == psdu->GetHeader(0).GetAddr3() ?
DL :
UL);
1784 m_uidList.push_front(psdu->GetPacket()->GetUid());
1792 for (
const auto& mpdu : *psdu)
1797 m_sourceMac->GetFrameExchangeManager(linkId)->GetAddress() ==
1798 mpdu->GetHeader().GetAddr2() &&
1799 !mpdu->GetHeader().GetAddr1().IsGroup())
1801 auto seqNo = mpdu->GetHeader().GetSequenceNumber();
1802 auto [it, success] =
1806 it->second = std::max(it->second, mpdu->GetInFlightLinkIds().size());
1810 for (std::size_t i = 0; i < psdu->GetNMpdus(); i++)
1816 if (psdu->GetHeader(i).GetSequenceNumber() != 1 ||
1823 auto uid = psdu->GetPayload(i)->GetUid();
1846 if (!
m_sourceMac->GetLinkIdByAddress(psdu->GetHeader(0).GetAddr1()))
1860 m_uidList.push_front(psdu->GetPacket()->GetUid());
1867 if (
m_sourceMac->GetLinkIdByAddress(psdu->GetHeader(0).GetAddr2()))
1885 "No BlockAck expected in AP to broadcast traffic pattern");
1899 auto mpdu = *psdu->begin();
1901 mpdu->GetPacket()->PeekHeader(blockAck);
1910 "MPDU 0 expected to be successfully received");
1914 "MPDU 1 expected to be received only in STA_TO_STA/STA_TO_BCAST scenarios");
1917 if (
m_staMacs[0]->GetSetupLinkIds().size() > 1)
1922 auto item = queue->PeekByTidAndAddress(0, rcvMac->GetAddress());
1923 std::size_t nQueuedPkt = 0;
1926 rcvMac->GetWifiPhy(linkId)->GetPhyBand()) +
1931 auto seqNo = item->GetHeader().GetSequenceNumber();
1934 "MPDU with seqNo=" << seqNo <<
" is not in flight");
1935 auto linkIds = item->GetInFlightLinkIds();
1938 "MPDU with seqNo=" << seqNo
1939 <<
" is in flight on multiple links");
1943 auto srcLinkId =
m_sourceMac->GetLinkIdByAddress(mpdu->GetHeader().GetAddr1());
1946 "Addr1 of BlockAck is not an originator's link address");
1949 "MPDU with seqNo=" << seqNo
1950 <<
" in flight on unexpected link");
1955 bool isQueued = (seqNo > (isMpdu1corrupted ? 0 : 1));
1959 bool isRetry = isQueued && seqNo <= 1;
1965 << item->GetHeader().GetSequenceNumber() <<
" should "
1966 << (isQueued ?
"" :
"not") <<
" be queued");
1968 item->GetHeader().IsRetry(),
1970 "Unexpected value for the Retry subfield of the MPDU with seqNo="
1971 << item->GetHeader().GetSequenceNumber());
1975 item = queue->PeekByTidAndAddress(0, rcvMac->GetAddress(), item);
1986 "Did not expect to receive a second BlockAck");
1988 std::pair<uint16_t, uint16_t> seqNos;
1993 if (
m_staMacs[0]->GetSetupLinkIds().size() > 1)
2003 "MPDU " << seqNos.first <<
" expected to be successfully received");
2006 "MPDU " << seqNos.second <<
" expected to be successfully received");
2022 mac->GetQosTxop(
AC_BE)->SetAttribute(
"UseExplicitBarAfterMissedBlockAck",
2029 for (std::size_t linkId = 0; linkId <
m_apMac->GetNLinks(); linkId++)
2033 m_apMac->GetWifiPhy(linkId)->SetPostReceptionErrorModel(errorModel);
2035 for (std::size_t i : {0, 1})
2037 for (
const auto linkId :
m_staMacs[i]->GetLinkIds())
2041 m_staMacs[i]->GetWifiPhy(linkId)->SetPostReceptionErrorModel(errorModel);
2055 destAddr =
m_staMacs[1]->GetDevice()->GetAddress();
2059 destAddr =
m_apMac->GetDevice()->GetAddress();
2063 destAddr =
m_staMacs[1]->GetDevice()->GetAddress();
2081 m_sourceMac->GetDevice()->GetNode()->AddApplication(
2088 m_sourceMac->GetDevice()->GetNode()->AddApplication(
2101 std::array<std::size_t, 3> expectedRxPkts{};
2130 "Unexpected number of packets received by the AP");
2133 "Unexpected number of packets received by STA 0");
2136 "Unexpected number of packets received by STA 1");
2141 std::size_t expectedBaCount = 0;
2142 std::size_t expectedBarCount = 0;
2149 expectedBaCount = 3;
2156 expectedBaCount = 1;
2162 "Unexpected number of BlockAck frames");
2165 "Unexpected number of BlockAckReq frames");
2176 "Did not collect number of simultaneous transmissions for all data frames");
2179 std::size_t maxCount = 0;
2185 "MPDU with seqNo=" << seqNo
2186 <<
" transmitted simultaneously more times than allowed");
2187 maxCount = std::max(maxCount, count);
2193 "Expected that at least one data frame was transmitted simultaneously a number of "
2194 "times equal to the NMaxInflights attribute");
2203 uint8_t nMaxInflight)
2205 std::string(
"Check MU data transmission between MLDs ") +
2207 ?
"(send BAR after BlockAck timeout,"
2208 :
"(send Data frames after BlockAck timeout,") +
2209 " MU Traffic pattern: " +
std::to_string(static_cast<uint8_t>(muTrafficPattern)) +
2210 ", nMaxInflight=" +
std::to_string(nMaxInflight) +
")",
2213 m_muTrafficPattern(muTrafficPattern),
2215 m_nMaxInflight(nMaxInflight),
2216 m_sockets(m_nStations),
2233 for (
const auto& [staId, psdu] : psduMap)
2235 switch (psdu->GetHeader(0).GetType())
2239 if (psdu->GetHeader(0).HasData())
2241 bool isDl = psdu->GetHeader(0).IsFromDs();
2243 isDl ? psdu->GetHeader(0).GetAddr1() : psdu->GetHeader(0).GetAddr2();
2244 auto address =
m_apMac->GetMldAddress(linkAddress).value_or(linkAddress);
2246 for (
const auto& mpdu : *psdu)
2249 auto seqNo = mpdu->GetHeader().GetSequenceNumber();
2251 {{address, seqNo}, mpdu->GetInFlightLinkIds().size()});
2254 it->second = std::max(it->second, mpdu->GetInFlightLinkIds().size());
2257 for (std::size_t i = 0; i < psdu->GetNMpdus(); i++)
2260 if (psdu->GetHeader(i).GetSequenceNumber() == 2)
2266 "MPDU " << **std::next(psdu->begin(), i)
2267 <<
" not transmitted in a TB PPDU");
2273 "MPDU " << **std::next(psdu->begin(), i)
2274 <<
" not transmitted in a DL MU PPDU");
2278 if (psdu->GetHeader(i).GetSequenceNumber() != 3)
2282 auto uid = psdu->GetPayload(i)->GetUid();
2319 m_uidList.push_front(psdu->GetPacket()->GetUid());
2325 psdu->GetPayload(0)->PeekHeader(trigger);
2334 auto band = mac->GetWifiPhy(linkId)->GetPhyBand();
2338 m_staMacs[i]->GetDevice()->GetNode()->AddApplication(
2347 muScheduler->SetAttribute(
"EnableUlOfdma",
BooleanValue(
false));
2394 auto mpdu = *psdu->begin();
2396 mpdu->GetPacket()->PeekHeader(blockAck);
2397 bool isMpdu3corrupted;
2412 auto index = indices.front();
2415 "Expected that a QoS data frame was corrupted");
2417 m_staMacs[i]->GetLinkIdByAddress(*m_dataCorruptedSta).has_value();
2420 "MPDU 2 expected to be successfully received");
2423 "Unexpected reception status for MPDU 3");
2433 "MPDU 2 expected to be successfully received");
2436 "Unexpected reception status for MPDU 3");
2440 m_staMacs[0]->GetSetupLinkIds().size() > 1)
2444 if (
m_staMacs[0]->GetFrameExchangeManager(linkId)->GetAddress() ==
2445 mpdu->GetHeader().GetAddr2())
2449 else if (
m_staMacs[1]->GetFrameExchangeManager(linkId)->GetAddress() ==
2450 mpdu->GetHeader().GetAddr2())
2456 NS_ABORT_MSG(
"BlockAck frame not sent by a station in DL scenario");
2458 auto item = queue->PeekByTidAndAddress(0, rcvMac->GetAddress());
2459 std::size_t nQueuedPkt = 0;
2462 rcvMac->GetWifiPhy(linkId)->GetPhyBand()) +
2467 auto seqNo = item->GetHeader().GetSequenceNumber();
2470 "MPDU with seqNo=" << seqNo <<
" is not in flight");
2471 auto linkIds = item->GetInFlightLinkIds();
2474 "MPDU with seqNo=" << seqNo
2475 <<
" is in flight on multiple links");
2479 auto srcLinkId =
m_apMac->GetLinkIdByAddress(mpdu->GetHeader().GetAddr1());
2482 "Addr1 of BlockAck is not an originator's link address");
2485 "MPDU with seqNo=" << seqNo
2486 <<
" in flight on unexpected link");
2491 bool isQueued = (seqNo > (isMpdu3corrupted ? 2 : 3));
2495 bool isRetry = isQueued && seqNo <= 3;
2501 << item->GetHeader().GetSequenceNumber() <<
" should "
2502 << (isQueued ?
"" :
"not") <<
" be queued");
2504 item->GetHeader().IsRetry(),
2506 "Unexpected value for the Retry subfield of the MPDU with seqNo="
2507 << item->GetHeader().GetSequenceNumber());
2511 item = queue->PeekByTidAndAddress(0, rcvMac->GetAddress(), item);
2546 mac->GetQosTxop(
AC_BE)->SetAttribute(
"UseExplicitBarAfterMissedBlockAck",
2551 mac->GetQosTxop(
AC_VI)->SetAttribute(
"UseExplicitBarAfterMissedBlockAck",
2563 m_apMac->AggregateObject(muScheduler);
2566 for (std::size_t linkId = 0; linkId <
m_apMac->GetNLinks(); linkId++)
2570 m_apMac->GetWifiPhy(linkId)->SetPostReceptionErrorModel(errorModel);
2572 for (std::size_t i : {0, 1})
2574 for (
const auto linkId :
m_staMacs[i]->GetLinkIds())
2578 m_staMacs[i]->GetWifiPhy(linkId)->SetPostReceptionErrorModel(errorModel);
2598 m_apMac->GetDevice()->GetNode()->AddApplication(
2604 m_apMac->GetDevice()->GetNode()->AddApplication(
2610 m_apMac->GetDevice()->GetNode()->AddApplication(
2628 m_staMacs[i]->GetDevice()->GetNode()->AddApplication(
2639 muScheduler->SetAttribute(
"EnableUlOfdma",
BooleanValue(
true));
2642 muScheduler->SetAccessReqInterval(
Seconds(0));
2655 std::array<std::size_t, 3> expectedRxPkts{};
2674 "Unexpected number of packets received by the AP");
2677 "Unexpected number of packets received by STA 0");
2680 "Unexpected number of packets received by STA 1");
2688 "Did not collect number of simultaneous transmissions for all data frames");
2691 std::size_t maxCount = 0;
2697 << txSeqNoPair.second
2698 <<
" transmitted simultaneously more times than allowed");
2699 maxCount = std::max(maxCount, count);
2705 "Expected that at least one data frame was transmitted simultaneously a number of "
2706 "times equal to the NMaxInflights attribute");
2713 "Check sequence numbers after CTS timeout",
2715 BaseParams{{
"{36, 0, BAND_5GHZ, 0}",
"{2, 0, BAND_2_4GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}"},
2716 {
"{36, 0, BAND_5GHZ, 0}",
"{2, 0, BAND_2_4GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}"},
2718 m_nQosDataFrames(0),
2720 m_rtsCorrupted(
false)
2733 for (
const auto linkId :
m_staMacs[0]->GetLinkIds())
2759 auto psdu = psduMap.begin()->second;
2768 else if (psdu->GetHeader(0).IsQosData())
2788 std::size_t count{};
2792 auto psdu = txPsdu.psduMap.begin()->second;
2794 if (!psdu->GetHeader(0).IsQosData())
2802 uint16_t expectedSeqNo{};
2821 "Unexpected sequence number");
2830 "Check starting sequence number update after ADDBA Response timeout",
2832 BaseParams{{
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}"},
2833 {
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}"},
2849 for (
const auto linkId :
m_staMacs[0]->GetLinkIds())
2873 auto psdu = psduMap.begin()->second;
2874 const auto& hdr = psdu->GetHeader(0);
2880 auto prevPsdu =
m_txPsdus.back().psduMap.begin()->second;
2882 if (prevPsdu->GetHeader(0).IsAction())
2885 (*prevPsdu->begin())->GetPacket()->PeekHeader(actionHdr);
2895 m_staMacs[0]->BlockUnicastTxOnLinks(WifiQueueBlockedReason::TID_NOT_MAPPED,
2908 ackDuration +
m_apMac->GetQosTxop(
AC_BE)->GetAddBaResponseTimeout(),
2910 m_apMac->BlockUnicastTxOnLinks(WifiQueueBlockedReason::TID_NOT_MAPPED,
2911 m_staMacs[0]->GetAddress(),
2914 WifiQueueBlockedReason::TID_NOT_MAPPED,
2927 (*psdu->begin())->GetPacket()->PeekHeader(actionHdr);
2931 auto band = m_staMacs[0]->GetDevice()->GetPhy(phyId)->GetPhyBand();
2937 auto mpdu = m_apMac->GetTxopQueue(
AC_BE)->Peek();
2941 "Expected a QoS data frame");
2945 "Expected the data frame to be inflight when ADDBA RESP is received");
2950 m_apMac->GetQosTxop(
AC_BE)->GetBaStartingSequence(m_staMacs[0]->GetAddress(),
2952 mpdu->GetHeader().GetSequenceNumber(),
2953 "Unexpected BA Starting Sequence Number");
2957 else if (hdr.IsQosData())
2960 if (m_nQosDataCount++ == 0)
2962 m_staErrorModel->SetList({psdu->GetPacket()->GetUid()});
2966 m_staErrorModel->SetList({});
2987 std::vector<uint8_t>,
2996 std::vector<std::set<uint8_t>>{{0, 1, 2}, {1, 2}, {0, 1}, {0, 2}, {0}, {1}, {2}}),
2997 TestCase::Duration::QUICK);
3004 {
"{42, 80, BAND_5GHZ, 2}",
"{5, 40, BAND_2_4GHZ, 0}",
"{7, 80, BAND_6GHZ, 0}"},
3005 {
"{3, 40, BAND_2_4GHZ, 0}",
"{15, 160, BAND_6GHZ, 7}",
"{50, 160, BAND_5GHZ, 2}"},
3007 WifiScanType::PASSIVE,
3009 WifiTidToLinkMappingNegSupport::ANY_LINK_SET,
3013 TestCase::Duration::QUICK);
3015 for (
const auto& [baseParams,
3022 {{
"{36, 0, BAND_5GHZ, 0}",
"{2, 0, BAND_2_4GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}"},
3023 {
"{36, 0, BAND_5GHZ, 0}",
"{2, 0, BAND_2_4GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}"},
3026 WifiTidToLinkMappingNegSupport::NOT_SUPPORTED,
3028 "0,1,2,3 0,1,2; 4,5 0,1",
3029 "0,1,2,3 1,2; 6,7 0,1"
3032 ParamsTuple({{
"{108, 0, BAND_5GHZ, 0}",
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}"},
3033 {
"{36, 0, BAND_5GHZ, 0}",
"{120, 0, BAND_5GHZ, 0}",
"{5, 0, BAND_6GHZ, 0}"},
3036 WifiTidToLinkMappingNegSupport::SAME_LINK_SET,
3038 "0,1,2,3 0,1,2; 4,5 0,1",
3041 ParamsTuple({{
"{2, 0, BAND_2_4GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}",
"{36, 0, BAND_5GHZ, 0}"},
3042 {
"{36, 0, BAND_5GHZ, 0}",
"{9, 0, BAND_6GHZ, 0}",
"{120, 0, BAND_5GHZ, 0}"},
3045 WifiTidToLinkMappingNegSupport::ANY_LINK_SET,
3046 "0,1,2,3 0; 4,5,6,7 1,2",
3047 "0,2,3 1,2; 1,4,5,6,7 0"
3052 {{
"{2, 0, BAND_2_4GHZ, 0}",
"{36, 0, BAND_5GHZ, 0}",
"{8, 20, BAND_2_4GHZ, 0}"},
3053 {
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}",
"{120, 0, BAND_5GHZ, 0}"},
3056 WifiTidToLinkMappingNegSupport::SAME_LINK_SET,
3058 "0,1,2,3,4,5,6,7 0",
3059 "0,1,2,3,4,5,6,7 0"),
3064 {{
"{2, 0, BAND_2_4GHZ, 0}",
"{36, 0, BAND_5GHZ, 0}",
"{8, 20, BAND_2_4GHZ, 0}"},
3065 {
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}",
"{120, 0, BAND_5GHZ, 0}"},
3068 WifiTidToLinkMappingNegSupport::ANY_LINK_SET,
3076 ParamsTuple({{
"{2, 0, BAND_2_4GHZ, 0}",
"{36, 0, BAND_5GHZ, 0}",
"{60, 0, BAND_5GHZ, 0}"},
3077 {
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}",
"{120, 0, BAND_5GHZ, 0}"},
3080 WifiTidToLinkMappingNegSupport::ANY_LINK_SET,
3086 ParamsTuple({{
"{2, 0, BAND_2_4GHZ, 0}",
"{120, 0, BAND_5GHZ, 0}"},
3087 {
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}",
"{120, 0, BAND_5GHZ, 0}"},
3090 WifiTidToLinkMappingNegSupport::ANY_LINK_SET,
3094 ParamsTuple({{
"{2, 0, BAND_2_4GHZ, 0}",
"{36, 0, BAND_5GHZ, 0}"},
3095 {
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}",
"{120, 0, BAND_5GHZ, 0}"},
3098 WifiTidToLinkMappingNegSupport::ANY_LINK_SET,
3102 ParamsTuple({{
"{120, 0, BAND_5GHZ, 0}"},
3103 {
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}",
"{120, 0, BAND_5GHZ, 0}"},
3106 WifiTidToLinkMappingNegSupport::ANY_LINK_SET,
3110 ParamsTuple({{
"{36, 0, BAND_5GHZ, 0}",
"{1, 0, BAND_6GHZ, 0}",
"{120, 0, BAND_5GHZ, 0}"},
3111 {
"{120, 0, BAND_5GHZ, 0}"},
3114 WifiTidToLinkMappingNegSupport::NOT_SUPPORTED,
3115 "0,1,2,3 0,1; 4,5,6,7 0,1",
3119 WifiScanType::PASSIVE,
3124 TestCase::Duration::QUICK);
3126 WifiScanType::ACTIVE,
3131 TestCase::Duration::QUICK);
3145 TestCase::Duration::QUICK);
3146 for (
const auto& useBarAfterMissedBa :
3153 useBarAfterMissedBa,
3155 TestCase::Duration::QUICK);
3160 useBarAfterMissedBa,
3162 TestCase::Duration::QUICK);
3171 for (
const auto& useBarAfterMissedBa :
3177 TestCase::Duration::QUICK);
3181 TestCase::Duration::QUICK);
Test that the AIDs that an AP MLD assigns to SLDs and MLDs are all unique.
AidAssignmentTest(const std::vector< std::set< uint8_t > > &linkIds)
Constructor.
const std::vector< std::set< uint8_t > > m_linkIds
link IDs for all non-AP STAs/MLDs
void DoSetup() override
Implementation to do any local setup required for this TestCase.
void SetSsid(Ptr< StaWifiMac > staMac, Mac48Address)
Set the SSID on the next station that needs to start the association procedure.
void DoRun() override
Implementation to actually run this TestCase.
uint16_t m_expectedAid
expected AID for current non-AP STA/MLD
const std::vector< std::string > m_linkChannels
channels for all AP links
NetDeviceContainer m_staDevices
non-AP STAs/MLDs devices
Test the implementation of WifiAssocManager::GetNextAffiliatedAp(), which searches a given RNR elemen...
GetRnrLinkInfoTest()
Constructor.
void DoRun() override
Implementation to actually run this TestCase.
Test WifiMac subclass used to access the SwapLinks method.
static TypeId GetTypeId()
Test the WifiMac::SwapLinks() method.
void DoRun() override
Implementation to actually run this TestCase.
void RunOne(std::string text, std::size_t nLinks, const std::map< uint8_t, uint8_t > &links, const std::map< uint8_t, uint8_t > &expected)
Run a single test case.
Test data transmission between MLDs using OFDMA MU transmissions.
std::optional< Mac48Address > m_dataCorruptedSta
MAC address of the station that received MPDU with SeqNo=2 corrupted.
void CheckBlockAck(Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector, uint8_t linkId)
Check the content of a received BlockAck frame when the max number of links on which an MPDU can be i...
std::vector< PacketSocketAddress > m_sockets
packet socket addresses for STAs
void Transmit(Ptr< WifiMac > mac, uint8_t phyId, WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW) override
Callback invoked when a FEM passes PSDUs to the PHY.
std::size_t m_nPackets
number of application packets to generate
void DoRun() override
Implementation to actually run this TestCase.
MultiLinkMuTxTest(const BaseParams &baseParams, WifiMuTrafficPattern muTrafficPattern, WifiUseBarAfterMissedBa useBarAfterMissedBa, uint8_t nMaxInflight)
Constructor.
std::list< uint64_t > m_uidList
list of UIDs of packets to corrupt
std::size_t m_blockAckCount
transmitted BlockAck counter
void DoSetup() override
Implementation to do any local setup required for this TestCase.
RxErrorModelMap m_errorModels
error rate models to corrupt packets
std::map< AddrSeqNoPair, std::size_t > m_inflightCount
max number of simultaneous transmissions of each data frame
void StartTraffic() override
Start the generation of traffic (needs to be overridden)
bool m_useBarAfterMissedBa
whether to send BAR after missed BlockAck
bool m_waitFirstTf
whether we are waiting for the first Basic Trigger Frame
WifiMuTrafficPattern m_muTrafficPattern
the pattern of traffic to generate
std::size_t m_tfCount
transmitted Trigger Frame counter
std::size_t m_nMaxInflight
max number of links on which an MPDU can be inflight
Base class for Multi-Link Operations tests.
virtual void Transmit(Ptr< WifiMac > mac, uint8_t phyId, WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW)
Callback invoked when a FEM passes PSDUs to the PHY.
void SetSsid(uint16_t aid, Mac48Address)
Set the SSID on the next station that needs to start the association procedure.
virtual void StartTraffic()
Start the generation of traffic (needs to be overridden)
std::vector< Ptr< StaWifiMac > > m_staMacs
STA wifi MACs.
const std::vector< std::string > m_staChannels
strings specifying channels for STA
void CheckAddresses(Ptr< const WifiPsdu > psdu, std::optional< Direction > direction=std::nullopt)
Check that the Address 1 and Address 2 fields of the given PSDU contain device MAC addresses.
virtual void L7Receive(uint8_t nodeId, Ptr< const Packet > p, const Address &addr)
Function to trace packets received by the server application.
Ptr< PacketSocketClient > GetApplication(const PacketSocketAddress &sockAddr, std::size_t count, std::size_t pktSize, Time delay=Seconds(0), uint8_t priority=0) const
void CheckCapabilities(Ptr< WifiMpdu > mpdu, Ptr< WifiMac > mac, uint8_t phyId)
Check that the expected Capabilities information elements are present in the given management frame b...
void SetChannels(SpectrumWifiPhyHelper &helper, const std::vector< std::string > &channels, const ChannelMap &channelMap)
Reset the given PHY helper, use the given strings to set the ChannelSettings attribute of the PHY obj...
const std::vector< std::string > m_apChannels
strings specifying channels for AP
uint16_t m_lastAid
AID of last associated station.
std::map< FrequencyRange, Ptr< MultiModelSpectrumChannel > > ChannelMap
PHY band-indexed map of spectrum channels.
void DoSetup() override
Implementation to do any local setup required for this TestCase.
std::vector< std::size_t > m_rxPkts
number of packets received at application layer by each node (index is node ID)
uint8_t m_nStations
number of stations to create
Time m_duration
simulation duration
const std::vector< uint8_t > m_fixedPhyBands
links on non-AP MLD with fixed PHY band
std::vector< FrameInfo > m_txPsdus
transmitted PSDUs
Ptr< ApWifiMac > m_apMac
AP wifi MAC.
MultiLinkOperationsTestBase(const std::string &name, uint8_t nStations, const BaseParams &baseParams)
Constructor.
Multi-Link Discovery & Setup test.
MultiLinkSetupTest(const BaseParams &baseParams, WifiScanType scanType, const std::vector< uint8_t > &setupLinks, WifiTidToLinkMappingNegSupport apNegSupport, const std::string &dlTidToLinkMapping, const std::string &ulTidToLinkMapping, bool support160MHzOp=true)
Constructor.
uint8_t m_dlTid1
the TID of the first set of DL QoS data frames
void CheckAssocRequest(Ptr< WifiMpdu > mpdu, uint8_t linkId)
Check correctness of the given Association Request frame.
void CheckProbeResponse(Ptr< WifiMpdu > mpdu, uint8_t linkId)
Check correctness of the given Probe Response frame.
std::optional< uint8_t > m_ulTid2
the TID of the optional set of UL QoS data frames
WifiScanType m_scanType
the scan type (active or passive)
void CheckMlSetup()
Check correctness of Multi-Link Setup procedure.
std::vector< std::size_t > m_qosFrames1
indices of QoS frames of the first set in the vector of TX PSDUs
void CheckDisabledLinks()
Check that links that are not setup on the non-AP MLD are disabled.
std::size_t m_nProbeResp
number of Probe Responses received by the non-AP MLD
std::string m_dlTidLinkMappingStr
DL TID-to-Link Mapping for non-AP MLD EHT configuration.
bool m_support160MHzOp
whether non-AP MLDs support 160 MHz operations
uint8_t m_ulTid1
the TID of the first set of UL QoS data frames
WifiTidLinkMapping m_ulTidLinkMapping
expected UL TID-to-Link Mapping requested by non-AP MLD and accepted by AP MLD
void StartTraffic() override
Start the generation of traffic (needs to be overridden)
void DoRun() override
Implementation to actually run this TestCase.
WifiTidToLinkMappingNegSupport m_apNegSupport
TID-to-Link Mapping negotiation supported by the AP MLD.
std::optional< uint8_t > m_dlTid2
the TID of the optional set of DL QoS data frames
WifiTidLinkMapping m_dlTidLinkMapping
expected DL TID-to-Link Mapping requested by non-AP MLD and accepted by AP MLD
void CheckAssocResponse(Ptr< WifiMpdu > mpdu, uint8_t linkId)
Check correctness of the given Association Response frame.
void CheckQosData(Ptr< WifiMpdu > mpdu, const WifiTxVector &txvector, uint8_t linkId, std::size_t index)
Check that QoS data frames are sent on links their TID is mapped to and with the correct TX width.
void DoSetup() override
Implementation to do any local setup required for this TestCase.
std::string m_ulTidLinkMappingStr
UL TID-to-Link Mapping for non-AP MLD EHT configuration.
void CheckBeacon(Ptr< WifiMpdu > mpdu, uint8_t linkId)
Check correctness of the given Beacon frame.
std::vector< std::size_t > m_qosFrames2
indices of QoS frames of the optional set in the vector of TX PSDUs
const std::vector< uint8_t > m_setupLinks
IDs of the expected links to setup.
Test data transmission between two MLDs.
bool m_dataCorrupted
whether second data frame has been already corrupted
RxErrorModelMap m_errorModels
error rate models to corrupt packets
void Transmit(Ptr< WifiMac > mac, uint8_t phyId, WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW) override
Callback invoked when a FEM passes PSDUs to the PHY.
std::list< uint64_t > m_uidList
list of UIDs of packets to corrupt
void DoRun() override
Implementation to actually run this TestCase.
std::size_t m_nPackets
number of application packets to generate
std::size_t m_nMaxInflight
max number of links on which an MPDU can be inflight
bool m_baEnabled
whether BA agreement is enabled or disabled
void StartTraffic() override
Start the generation of traffic (needs to be overridden)
bool m_useBarAfterMissedBa
whether to send BAR after missed BlockAck
std::size_t m_blockAckCount
transmitted BlockAck counter
WifiTrafficPattern m_trafficPattern
the pattern of traffic to generate
std::size_t m_blockAckReqCount
transmitted BlockAckReq counter
std::map< uint16_t, std::size_t > m_inflightCount
seqNo-indexed max number of simultaneous transmissions of a data frame
void DoSetup() override
Implementation to do any local setup required for this TestCase.
Ptr< WifiMac > m_sourceMac
MAC of the node sending application packets.
MultiLinkTxTest(const BaseParams &baseParams, WifiTrafficPattern trafficPattern, WifiBaEnabled baEnabled, WifiUseBarAfterMissedBa useBarAfterMissedBa, uint8_t nMaxInflight)
Constructor.
void CheckBlockAck(Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector, uint8_t linkId)
Check the content of a received BlockAck frame when the max number of links on which an MPDU can be i...
Test release of sequence numbers upon CTS timeout in multi-link operations.
ReleaseSeqNoAfterCtsTimeoutTest()
PacketSocketAddress m_sockAddr
packet socket address
Ptr< ListErrorModel > m_errorModel
error rate model to corrupt first RTS frame
std::size_t m_nQosDataFrames
counter for transmitted QoS data frames
void StartTraffic() override
Start the generation of traffic (needs to be overridden)
bool m_rtsCorrupted
whether the first RTS frame has been corrupted
void DoSetup() override
Implementation to do any local setup required for this TestCase.
void Transmit(Ptr< WifiMac > mac, uint8_t phyId, WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW) override
Callback invoked when a FEM passes PSDUs to the PHY.
void DoRun() override
Implementation to actually run this TestCase.
Test update of BA starting sequence number after ADDBA Response timeout in multi-link operations.
void DoSetup() override
Implementation to do any local setup required for this TestCase.
void DoRun() override
Implementation to actually run this TestCase.
PacketSocketAddress m_sockAddr
packet socket address
std::size_t m_nQosDataCount
counter for transmitted QoS data frames
void StartTraffic() override
Start the generation of traffic (needs to be overridden)
StartSeqNoUpdateAfterAddBaTimeoutTest()
void Transmit(Ptr< WifiMac > mac, uint8_t phyId, WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW) override
Callback invoked when a FEM passes PSDUs to the PHY.
Ptr< ListErrorModel > m_staErrorModel
error rate model to corrupt frames at the non-AP MLD
WifiMultiLinkOperationsTestSuite()
a polymophic address class
AttributeValue implementation for Boolean.
Hold variables of type enum.
void SetList(const std::list< uint64_t > &packetlist)
static Mac48Address GetBroadcast()
Helper class used to assign positions and mobility models to nodes.
MultiUserScheduler is an abstract base class defining the API that APs supporting at least VHT can us...
holds a vector of ns3::NetDevice pointers
uint32_t GetN() const
Get the number of Ptr<NetDevice> stored in this container.
void Add(NetDeviceContainer other)
Append the contents of another NetDeviceContainer to the end of this container.
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
keep track of a set of node pointers.
static uint32_t GetNNodes()
an address for a packet socket
void SetProtocol(uint16_t protocol)
Set the protocol.
void SetPhysicalAddress(const Address address)
Set the destination address.
void SetSingleDevice(uint32_t device)
Set the address to match only a specified NetDevice.
Give ns3::PacketSocket powers to ns3::Node.
void Install(Ptr< Node > node) const
Aggregate an instance of a ns3::PacketSocketFactory onto the provided node.
AttributeValue implementation for Pointer.
Smart pointer class similar to boost::intrusive_ptr.
The Reduced Neighbor Report element.
std::size_t GetNNbrApInfoFields() const
Get the number of Neighbor AP Information fields.
std::size_t GetNTbttInformationFields(std::size_t nbrApInfoId) const
Get the number of TBTT Information fields included in the TBTT Information Set field of the given Nei...
void AddNbrApInfoField()
Add a Neighbor AP Information field.
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 ...
static void SetRun(uint64_t run)
Set the run number of simulation.
static void SetSeed(uint32_t seed)
Set the seed.
static EventId Schedule(const Time &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
static void Destroy()
Execute the events scheduled with ScheduleDestroy().
static Time Now()
Return the current simulation virtual time.
static void Run()
Run the simulation.
static void Stop()
Tell the Simulator the calling event should be the last one executed.
Make it easy to create and manage PHY objects for the spectrum model.
void AddChannel(const Ptr< SpectrumChannel > channel, const FrequencyRange &freqRange=WHOLE_WIFI_SPECTRUM)
void SetChannel(const Ptr< SpectrumChannel > channel)
The IEEE 802.11 SSID Information Element.
AttributeValue implementation for Ssid.
Hold variables of type string.
void AddTestCase(TestCase *testCase, Duration duration=Duration::QUICK)
Add an individual child TestCase to this test suite.
TID-to-Link Mapping Information Element.
Simulation virtual time values and global simulation resolution.
AttributeValue implementation for Time.
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Hold an unsigned integer type.
static std::optional< WifiAssocManager::RnrLinkInfo > GetNextAffiliatedAp(const ReducedNeighborReport &rnr, std::size_t nbrApInfoId)
Search the given RNR element for APs affiliated to the same AP MLD as the reporting AP.
static std::list< WifiAssocManager::RnrLinkInfo > GetAllAffiliatedAps(const ReducedNeighborReport &rnr)
Find all the APs affiliated to the same AP MLD as the reporting AP that sent the given RNR element.
helps to create WifiNetDevice objects
static int64_t AssignStreams(NetDeviceContainer c, int64_t stream)
Assign a fixed random variable stream number to the random variables used by the PHY and MAC aspects ...
create MAC layers for a ns3::WifiNetDevice.
base class for all MAC-level wifi objects.
void SetPcapCaptureType(PcapCaptureType type)
Set the PCAP capture type to be used.
void SetPcapDataLinkType(SupportedPcapDataLinkTypes dlt)
Set the data link type of PCAP traces to be used.
void Set(std::string name, const AttributeValue &v)
@ DLT_IEEE802_11_RADIO
Include Radiotap link layer information.
static Time CalculateTxDuration(uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, uint16_t staId=SU_STA_ID)
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
const HeMuUserInfoMap & GetHeMuUserInfoMap() const
Get a const reference to the map HE MU user-specific transmission information indexed by STA-ID.
MHz_u GetChannelWidth() const
#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...
void SetDefault(std::string name, const AttributeValue &value)
void ConnectWithoutContext(std::string path, const CallbackBase &cb)
#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_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_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Ptr< T > CreateObject(Args &&... args)
Create an object by type, with varying number of constructor parameters.
Ptr< T > CreateObjectWithAttributes(Args... args)
Allocate an Object on the heap and initialize with a set of attributes.
Ptr< T > Create(Ts &&... args)
Create class instances by constructors with varying numbers of arguments and return them by Ptr.
#define NS_TEST_ASSERT_MSG_LT(actual, limit, msg)
Test that an actual value is less than a limit and report and abort if not.
#define NS_TEST_ASSERT_MSG_EQ(actual, limit, msg)
Test that an actual and expected (limit) value are equal and report and abort if not.
#define NS_TEST_EXPECT_MSG_LT_OR_EQ(actual, limit, msg)
Test that an actual value is less than or equal to a limit and report if not.
#define NS_TEST_EXPECT_MSG_LT(actual, limit, msg)
Test that an actual value is less than a limit and report if not.
#define NS_TEST_EXPECT_MSG_GT(actual, limit, msg)
Test that an actual value is greater than a limit and report if not.
#define NS_TEST_EXPECT_MSG_NE(actual, limit, msg)
Test that an actual and expected (limit) value are not equal and report if not.
#define NS_TEST_EXPECT_MSG_EQ(actual, limit, msg)
Test that an actual and expected (limit) value are equal and report if not.
#define NS_TEST_ASSERT_MSG_NE(actual, limit, msg)
Test that an actual and expected (limit) value are not equal and report and abort if not.
Time MicroSeconds(uint64_t value)
Construct a Time in the indicated unit.
Time Seconds(double value)
Construct a Time in the indicated unit.
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
WifiScanType
Scan type (active or passive)
AcIndex QosUtilsMapTidToAc(uint8_t tid)
Maps TID (Traffic ID) to Access classes.
@ WIFI_PHY_BAND_6GHZ
The 6 GHz band.
@ WIFI_PHY_BAND_5GHZ
The 5 GHz band.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
constexpr FrequencyRange WIFI_SPECTRUM_6_GHZ
Identifier for the frequency range covering the wifi spectrum in the 6 GHz band.
U * PeekPointer(const Ptr< U > &p)
std:: tuple< WifiContainerQueueType, WifiReceiverAddressType, Mac48Address, std::optional< uint8_t > > WifiContainerQueueId
Tuple (queue type, receiver address type, Address, TID) identifying a container queue.
Callback< R, Args... > MakeCallback(R(T::*memPtr)(Args...), OBJ objPtr)
Build Callbacks for class method members which take varying numbers of arguments and potentially retu...
WifiTidToLinkMappingNegSupport
TID-to-Link Mapping Negotiation Support.
Ptr< T1 > DynamicCast(const Ptr< T2 > &p)
Cast a Ptr.
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...
constexpr FrequencyRange WIFI_SPECTRUM_5_GHZ
Identifier for the frequency range covering the wifi spectrum in the 5 GHz band.
@ WIFI_MAC_MGT_PROBE_REQUEST
@ WIFI_MAC_MGT_ASSOCIATION_RESPONSE
@ WIFI_MAC_MGT_ASSOCIATION_REQUEST
@ WIFI_MAC_MGT_PROBE_RESPONSE
WifiDirection
Wifi direction.
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::unordered_map< uint16_t, Ptr< const WifiPsdu > > WifiConstPsduMap
Map of const PSDUs indexed by STA-ID.
constexpr FrequencyRange WIFI_SPECTRUM_2_4_GHZ
Identifier for the frequency range covering the wifi spectrum in the 2.4 GHz band.
Configuration parameters common to all subclasses.
uint32_t pktSize
packet size used for the simulation (in bytes)
static WifiMultiLinkOperationsTestSuite g_wifiMultiLinkOperationsTestSuite
the test suite
WifiMuTrafficPattern
Tested MU traffic patterns.
WifiTrafficPattern
Tested traffic patterns.
WifiUseBarAfterMissedBa
Whether to send a BlockAckReq after a missed BlockAck.
WifiBaEnabled
Block Ack agreement enabled/disabled.