9#include "ns3/ap-wifi-mac.h"
10#include "ns3/boolean.h"
11#include "ns3/constant-position-mobility-model.h"
12#include "ns3/ctrl-headers.h"
13#include "ns3/double.h"
14#include "ns3/he-configuration.h"
15#include "ns3/he-phy.h"
16#include "ns3/he-ppdu.h"
17#include "ns3/interference-helper.h"
19#include "ns3/mobility-helper.h"
20#include "ns3/multi-model-spectrum-channel.h"
21#include "ns3/nist-error-rate-model.h"
23#include "ns3/non-communicating-net-device.h"
24#include "ns3/pointer.h"
25#include "ns3/rng-seed-manager.h"
26#include "ns3/simulator.h"
27#include "ns3/spectrum-wifi-helper.h"
28#include "ns3/spectrum-wifi-phy.h"
29#include "ns3/sta-wifi-mac.h"
30#include "ns3/string.h"
32#include "ns3/threshold-preamble-detection-model.h"
34#include "ns3/waveform-generator.h"
35#include "ns3/wifi-mac-header.h"
36#include "ns3/wifi-net-device.h"
37#include "ns3/wifi-phy-listener.h"
38#include "ns3/wifi-psdu.h"
39#include "ns3/wifi-spectrum-phy-interface.h"
40#include "ns3/wifi-spectrum-signal-parameters.h"
41#include "ns3/wifi-spectrum-value-helper.h"
42#include "ns3/wifi-utils.h"
208 TypeId(
"ns3::OfdmaSpectrumWifiPhy")
210 .SetGroupName(
"Wifi")
211 .AddTraceSource(
"TxPpduUid",
212 "UID of the PPDU to be transmitted",
214 "ns3::OfdmaSpectrumWifiPhy::TxPpduUidCallback");
264std::map<std::pair<uint64_t, WifiPreamble>,
Ptr<Event>>&
303 void DoRun()
override;
315 const std::vector<bool>& statusPerMpdu);
326 const std::vector<bool>& statusPerMpdu);
337 const std::vector<bool>& statusPerMpdu);
393 void SendMuPpdu(uint16_t rxStaId1, uint16_t rxStaId2);
447 m_countRxSuccessSta1(0),
448 m_countRxSuccessSta2(0),
449 m_countRxSuccessSta3(0),
450 m_countRxFailureSta1(0),
451 m_countRxFailureSta2(0),
452 m_countRxFailureSta3(0),
453 m_countRxBytesSta1(0),
454 m_countRxBytesSta2(0),
455 m_countRxBytesSta3(0),
495 txVector.SetRuAllocation({96}, 0);
500 txVector.SetRuAllocation({192, 192}, 0);
505 txVector.SetRuAllocation({200, 200, 200, 200}, 0);
510 txVector.SetRuAllocation({208, 208, 208, 208, 208, 208, 208, 208}, 0);
520 txVector.SetRu(ru1, rxStaId1);
522 txVector.SetNss(1, rxStaId1);
525 txVector.SetRu(ru2, rxStaId2);
527 txVector.SetNss(1, rxStaId2);
536 psdus.insert(std::make_pair(rxStaId1, psdu1));
545 psdus.insert(std::make_pair(rxStaId2, psdu2));
547 m_phyAp->Send(psdus, txVector);
573 const std::vector<bool>& )
584 const std::vector<bool>& )
595 const std::vector<bool>& )
630 "The number of successfully received packets by STA 1 is not correct!");
633 "The number of unsuccessfuly received packets by STA 1 is not correct!");
636 "The number of bytes received by STA 1 is not correct!");
646 "The number of successfully received packets by STA 2 is not correct!");
649 "The number of unsuccessfuly received packets by STA 2 is not correct!");
652 "The number of bytes received by STA 2 is not correct!");
662 "The number of successfully received packets by STA 3 is not correct!");
665 "The number of unsuccessfuly received packets by STA 3 is not correct!");
668 "The number of bytes received by STA 3 is not correct!");
685 phy->GetAttribute(
"State", ptr);
687 currentState = state->GetState();
691 "PHY State " << currentState <<
" does not match expected state "
701 spectrumChannel->AddPropagationLossModel(lossModel);
704 spectrumChannel->SetPropagationDelayModel(delayModel);
710 m_phyAp->SetInterferenceHelper(apInterferenceHelper);
712 m_phyAp->SetErrorRateModel(apErrorModel);
714 m_phyAp->AddChannel(spectrumChannel);
717 m_phyAp->SetMobility(apMobility);
719 apNode->AggregateObject(apMobility);
720 apNode->AddDevice(apDev);
738 sta1Node->AggregateObject(sta1Mobility);
739 sta1Node->AddDevice(sta1Dev);
757 sta2Node->AggregateObject(sta2Mobility);
758 sta2Node->AddDevice(sta2Dev);
776 sta3Node->AggregateObject(sta3Mobility);
777 sta3Node->AddDevice(sta3Dev);
785 interfererNode->AddDevice(interfererDev);
808 int64_t streamNumber = 0;
809 m_phyAp->AssignStreams(streamNumber);
853 WifiPhyState::CCA_BUSY);
906 WifiPhyState::CCA_BUSY);
956 bands.push_back(bandInfo);
960 Watt_u interferencePower{0.1};
986 WifiPhyState::CCA_BUSY);
991 WifiPhyState::CCA_BUSY);
996 WifiPhyState::CCA_BUSY);
1001 WifiPhyState::CCA_BUSY);
1026 bands.push_back(bandInfo);
1055 WifiPhyState::CCA_BUSY);
1061 : WifiPhyState::CCA_BUSY);
1067 : WifiPhyState::CCA_BUSY);
1073 : WifiPhyState::CCA_BUSY);
1098 bands.push_back(bandInfo);
1127 WifiPhyState::CCA_BUSY);
1132 WifiPhyState::CCA_BUSY);
1137 WifiPhyState::CCA_BUSY);
1142 WifiPhyState::CCA_BUSY);
1198 void DoRun()
override;
1210 const std::vector<bool>& statusPerMpdu);
1222 const std::vector<bool>& statusPerMpdu);
1270 const std::vector<bool>& puncturedSubchannels);
1326 :
TestCase(
"DL-OFDMA PHY puncturing test"),
1327 m_countRxSuccessSta1(0),
1328 m_countRxSuccessSta2(0),
1329 m_countRxFailureSta1(0),
1330 m_countRxFailureSta2(0),
1331 m_countRxBytesSta1(0),
1332 m_countRxBytesSta2(0),
1333 m_frequency(
MHz_u{5210}),
1334 m_channelWidth(
MHz_u{80}),
1335 m_indexSubchannel(0),
1355 const std::vector<bool>& puncturedSubchannels)
1371 puncturedSubchannels.empty()
1375 txVector.SetRu(ru1, rxStaId1);
1377 txVector.SetNss(1, rxStaId1);
1379 ruType = puncturedSubchannels.empty()
1385 txVector.SetRu(ru2, rxStaId2);
1387 txVector.SetNss(1, rxStaId2);
1390 if (puncturedSubchannels.empty())
1392 std::fill_n(std::back_inserter(ruAlloc), 4, 200);
1396 ruAlloc.push_back(puncturedSubchannels.at(1) ? 192 : 200);
1397 ruAlloc.push_back(puncturedSubchannels.at(1) ? 113 : 200);
1398 ruAlloc.push_back(puncturedSubchannels.at(2) ? 113
1399 : (puncturedSubchannels.at(3) ? 192 : 200));
1400 ruAlloc.push_back(puncturedSubchannels.at(2) ? 192
1401 : (puncturedSubchannels.at(3) ? 113 : 200));
1404 txVector.SetRuAllocation(ruAlloc, 0);
1414 psdus.insert(std::make_pair(rxStaId1, psdu1));
1423 psdus.insert(std::make_pair(rxStaId2, psdu2));
1425 if (!puncturedSubchannels.empty())
1427 txVector.SetInactiveSubchannels(puncturedSubchannels);
1430 m_phyAp->Send(psdus, txVector);
1454 const std::vector<bool>& )
1465 const std::vector<bool>& )
1493 "The number of successfully received packets by STA 1 is not correct!");
1496 "The number of unsuccessfuly received packets by STA 1 is not correct!");
1499 "The number of bytes received by STA 1 is not correct!");
1509 "The number of successfully received packets by STA 2 is not correct!");
1512 "The number of unsuccessfuly received packets by STA 2 is not correct!");
1515 "The number of bytes received by STA 2 is not correct!");
1531 phy->GetAttribute(
"State", ptr);
1533 currentState = state->GetState();
1537 "PHY State " << currentState <<
" does not match expected state "
1547 spectrumChannel->AddPropagationLossModel(lossModel);
1550 spectrumChannel->SetPropagationDelayModel(delayModel);
1556 m_phyAp->SetInterferenceHelper(apInterferenceHelper);
1558 m_phyAp->SetErrorRateModel(apErrorModel);
1560 m_phyAp->AddChannel(spectrumChannel);
1563 m_phyAp->SetMobility(apMobility);
1565 apNode->AggregateObject(apMobility);
1566 apNode->AddDevice(apDev);
1584 sta1Node->AggregateObject(sta1Mobility);
1585 sta1Node->AddDevice(sta1Dev);
1603 sta2Node->AggregateObject(sta2Mobility);
1604 sta2Node->AddDevice(sta2Dev);
1612 interfererNode->AddDevice(interfererDev);
1633 int64_t streamNumber = 0;
1634 m_phyAp->AssignStreams(streamNumber);
1661 bands.push_back(bandInfo);
1665 Watt_u interferencePower{0.1};
1666 *interferencePsd = interferencePower / 10e6;
1681 std::vector<bool>{});
1699 WifiPhyState::IDLE);
1704 WifiPhyState::IDLE);
1746 std::vector<bool> puncturedSubchannels;
1748 for (std::size_t i = 0; i < num20MhzSubchannels; ++i)
1752 puncturedSubchannels.push_back(
true);
1756 puncturedSubchannels.push_back(
false);
1764 puncturedSubchannels);
1782 WifiPhyState::IDLE);
1787 WifiPhyState::IDLE);
1814 for (
auto index : {1, 2, 3})
1837 void DoRun()
override;
1878 void CheckUid(uint16_t staId, uint64_t expectedUid);
1890 :
TestCase(
"UL-OFDMA PPDU UID attribution test"),
1891 m_ppduUidAp(UINT64_MAX),
1892 m_ppduUidSta1(UINT64_MAX),
1893 m_ppduUidSta2(UINT64_MAX)
1907 spectrumChannel->AddPropagationLossModel(lossModel);
1910 spectrumChannel->SetPropagationDelayModel(delayModel);
1935 apNode->AggregateObject(apMobility);
1936 apNode->AddDevice(apDev);
1957 sta1Node->AggregateObject(sta1Mobility);
1958 sta1Node->AddDevice(sta1Dev);
1977 sta2Node->AggregateObject(sta2Mobility);
1978 sta2Node->AddDevice(sta2Dev);
2016 "UID " << uid <<
" does not match expected one " << expectedUid <<
" for "
2063 uint16_t rxStaId1 = 1;
2065 txVector.SetRu(ru1, rxStaId1);
2067 txVector.SetNss(1, rxStaId1);
2069 uint16_t rxStaId2 = 2;
2071 txVector.SetRu(ru2, rxStaId2);
2073 txVector.SetNss(1, rxStaId2);
2075 txVector.SetRuAllocation({96}, 0);
2084 psdus.insert(std::make_pair(rxStaId1, psdu1));
2093 psdus.insert(std::make_pair(rxStaId2, psdu2));
2117 uint16_t rxStaId1 = 1;
2119 txVector1.SetRu(ru1, rxStaId1);
2121 txVector1.SetNss(1, rxStaId1);
2122 trigVector.SetRu(ru1, rxStaId1);
2124 trigVector.SetNss(1, rxStaId1);
2133 psdus1.insert(std::make_pair(rxStaId1, psdu1));
2135 uint16_t rxStaId2 = 2;
2137 txVector2.SetRu(ru2, rxStaId2);
2139 txVector2.SetNss(1, rxStaId2);
2140 trigVector.SetRu(ru2, rxStaId2);
2142 trigVector.SetNss(1, rxStaId2);
2151 psdus2.insert(std::make_pair(rxStaId2, psdu2));
2161 const auto txDuration = std::max(txDuration1, txDuration2);
2163 txVector1.SetLength(
2166 txVector2.SetLength(
2171 hePhyAp->SetTrigVector(trigVector, txDuration);
2199 psdus.insert(std::make_pair(
SU_STA_ID, psdu));
2222 int64_t streamNumber = 0;
2272 void DoRun()
override;
2283 void RxHeTbPpdu(uint64_t uid, uint16_t staId,
Watt_u txPower,
size_t payloadSize);
2332 :
TestCase(
"UL-OFDMA multiple RX events test"),
2333 m_totalBytesDropped(0),
2334 m_trigVector(
HePhy::GetHeMcs7(),
2373 for (
const auto& uid : uids)
2376 auto it = events.find(pair);
2377 bool found = (it != events.end());
2380 "HE TB PPDU with UID " << uid <<
" has not been received!");
2388 expectedBytesDropped,
2389 "The number of dropped bytes is not correct!");
2411 txVector.SetRu(ru, staId);
2413 txVector.SetNss(1, staId);
2424 psdus.insert(std::make_pair(staId, psdu));
2438 const auto nonOfdmaDuration =
m_phy->
GetHePhy()->CalculateNonHeDurationForHeTb(txVector);
2439 const auto centerFrequency =
2440 m_phy->
GetHePhy()->GetCenterFrequenciesForNonHePart(ppdu, staId).front();
2449 rxParams->psd = rxPsd;
2450 rxParams->txPhy =
nullptr;
2451 rxParams->duration = nonOfdmaDuration;
2452 rxParams->ppdu = ppdu;
2455 std::tie(length, ppduDuration) =
2457 txVector.SetLength(length);
2461 ppdu->ResetTxVector();
2467 const auto band =
m_phy->
GetHePhy()->GetRuBandForRx(txVector, staId);
2475 rxParamsOfdma->psd = rxPsd;
2476 rxParamsOfdma->txPhy =
nullptr;
2477 rxParamsOfdma->duration = ppduDuration - nonOfdmaDuration;
2478 rxParamsOfdma->ppdu = ppduOfdma;
2513 mac->SetAttribute(
"BeaconGeneration",
BooleanValue(
false));
2528 preambleDetectionModel->SetAttribute(
"Threshold",
DoubleValue(4));
2529 preambleDetectionModel->SetAttribute(
"MinimumRssi",
DoubleValue(-82));
2532 heConfiguration->m_maxTbPpduDelay =
NanoSeconds(400);
2533 dev->SetHeConfiguration(heConfiguration);
2535 node->AddDevice(dev);
2550 int64_t streamNumber = 0;
2557 std::vector<uint64_t> uids{0};
2585 std::vector<uint64_t> uids{1, 2};
2629 std::vector<uint64_t> uids{3, 4};
2673 std::vector<uint64_t> uids{5, 6};
2708 std::vector<uint64_t>{uids[0]});
2721 std::vector<uint64_t> uids{7, 8};
2756 std::vector<uint64_t>{uids[0]});
2769 std::vector<uint64_t> uids{9};
2847 const std::vector<Time>& )
override
2963 void DoRun()
override;
2974 uint8_t bssColor)
const;
2993 std::size_t payloadSize,
3005 void SendHeSuPpdu(uint16_t txStaId, std::size_t payloadSize, uint64_t uid, uint8_t bssColor);
3105 Time expectedLastNotification,
3106 bool expectedSuccess);
3123 const std::vector<bool>& statusPerMpdu);
3160 bool scheduleTxSta1 =
true,
3162 WifiPhyState expectedStateBeforeEnd = WifiPhyState::RX,
3175 Watt_u rxPowerNonOfdmaRu1,
3176 Watt_u rxPowerNonOfdmaRu2,
3191 std::shared_ptr<OfdmaTestPhyListener>
3210 m_countRxSuccessFromSta1(0),
3211 m_countRxSuccessFromSta2(0),
3212 m_countRxFailureFromSta1(0),
3213 m_countRxFailureFromSta2(0),
3214 m_countRxBytesFromSta1(0),
3215 m_countRxBytesFromSta2(0),
3224 std::size_t payloadSize,
3249 std::ostringstream addr;
3250 addr <<
"00:00:00:00:00:0" << txStaId;
3254 psdus.insert(std::make_pair(
SU_STA_ID, psdu));
3261 else if (txStaId == 2)
3265 else if (txStaId == 3)
3269 else if (txStaId == 0)
3273 phy->SetPpduUid(uid);
3274 phy->Send(psdus, txVector);
3280 uint8_t bssColor)
const
3317 auto primary80MHz =
true;
3320 primary80MHz =
false;
3324 txVector.SetRu(ru, txStaId);
3326 txVector.SetNss(1, txStaId);
3336 channelWidth = (channelWidth ==
MHz_u{160} ?
MHz_u{20} : channelWidth * 2);
3353 if (channelWidth ==
MHz_u{20})
3357 else if (channelWidth ==
MHz_u{40})
3361 else if (channelWidth ==
MHz_u{80})
3365 else if (channelWidth ==
MHz_u{160})
3374 uint16_t aid1 = (error ==
AID ? 3 : 1);
3375 uint16_t aid2 = (error ==
AID ? 4 : 2);
3378 txVector.
SetRu(ru1, aid1);
3380 txVector.
SetNss(1, aid1);
3383 txVector.
SetRu(ru2, aid2);
3385 txVector.
SetNss(1, aid2);
3404 std::size_t payloadSize,
3409 NS_LOG_FUNCTION(
this << txStaId << index << payloadSize << uid << +bssColor << (incrementUid));
3423 std::ostringstream addr;
3424 addr <<
"00:00:00:00:00:0" << txStaId;
3428 psdus.insert(std::make_pair(txStaId, psdu));
3435 else if (txStaId == 2)
3439 else if (txStaId == 3)
3451 phy->SetPpduUid(uid);
3452 phy->Send(psdus, txVector);
3479 const std::vector<bool>& )
3481 NS_LOG_FUNCTION(
this << *psdu << psdu->GetAddr2() << rxSignalInfo << txVector);
3482 if (psdu->GetAddr2() ==
Mac48Address(
"00:00:00:00:00:01"))
3487 else if (psdu->GetAddr2() ==
Mac48Address(
"00:00:00:00:00:02"))
3498 if (psdu->GetAddr2() ==
Mac48Address(
"00:00:00:00:00:01"))
3502 else if (psdu->GetAddr2() ==
Mac48Address(
"00:00:00:00:00:02"))
3515 "The number of successfully received packets from STA 1 is not correct!");
3519 "The number of unsuccessfuly received packets from STA 1 is not correct!");
3522 "The number of bytes received from STA 1 is not correct!");
3532 "The number of successfully received packets from STA 2 is not correct!");
3536 "The number of unsuccessfuly received packets from STA 2 is not correct!");
3539 "The number of bytes received from STA 2 is not correct!");
3547 auto event = phy->GetCurrentEvent();
3549 auto rxPower =
event->GetRxPower(band);
3555 "RX power " << rxPower <<
" over (" << band
3556 <<
") does not match expected power " << expectedRxPower
3572 if (expectedRxPower >
Watt_u{0.0})
3575 phy->GetEnergyDuration(expectedRxPower - step, band).IsStrictlyPositive(),
3577 "At least " << expectedRxPower <<
" W expected for OFDMA part over (" << band <<
") at "
3580 phy->GetEnergyDuration(expectedRxPower + step, band).IsStrictlyPositive(),
3582 "At most " << expectedRxPower <<
" W expected for OFDMA part over (" << band <<
") at "
3588 phy->GetEnergyDuration(expectedRxPower + step, band).IsStrictlyPositive(),
3590 "At most " << expectedRxPower <<
" W expected for OFDMA part over (" << band <<
") at "
3600 "m_currentEvent for AP was not cleared");
3603 "m_currentEvent for STA 1 was not cleared");
3606 "m_currentEvent for STA 2 was not cleared");
3623 phy->GetAttribute(
"State", ptr);
3625 currentState = state->GetState();
3629 "PHY State " << currentState <<
" does not match expected state "
3635 Time expectedLastNotification)
3638 expectedNotifications,
3639 "Number of RX start notifications "
3641 <<
" does not match expected count " << expectedNotifications
3644 expectedLastNotification,
3645 "Last time RX start notification has been received "
3647 <<
" does not match expected time " << expectedLastNotification
3653 Time expectedLastNotification,
3654 bool expectedSuccess)
3657 expectedNotifications,
3658 "Number of RX end notifications "
3660 <<
" does not match expected count " << expectedNotifications
3663 expectedLastNotification,
3664 "Last time RX end notification has been received "
3666 <<
" does not match expected time " << expectedLastNotification
3670 "Last time RX end notification indicated a "
3672 <<
" but expected a " << (expectedSuccess ?
"success" :
"failure")
3697 heConfiguration->SetAttribute(
"BssColor",
UintegerValue(bssColor));
3704 phy->SetAttribute(
"PowerDensityLimit",
DoubleValue(psdLimit));
3713 spectrumChannel->AddPropagationLossModel(lossModel);
3716 spectrumChannel->SetPropagationDelayModel(delayModel);
3720 preambleDetectionModel->SetAttribute(
3724 preambleDetectionModel->SetAttribute(
"Threshold",
DoubleValue(-100));
3732 apMac->SetAttribute(
"BeaconGeneration",
BooleanValue(
false));
3733 apDev->SetMac(apMac);
3736 apDev->SetHeConfiguration(heConfiguration);
3752 apMac->SetWifiPhys({
m_phyAp});
3753 apNode->AggregateObject(apMobility);
3754 apNode->AddDevice(apDev);
3772 sta1Node->AggregateObject(sta1Mobility);
3773 sta1Node->AddDevice(sta1Dev);
3791 sta2Node->AggregateObject(sta2Mobility);
3792 sta2Node->AddDevice(sta2Dev);
3810 sta3Node->AggregateObject(sta3Mobility);
3811 sta3Node->AddDevice(sta3Dev);
3819 interfererNode->AddDevice(interfererDev);
3823 for (
auto& phy : phys)
3826 phy->SetAttribute(
"TxPowerStart",
DoubleValue(16.0));
3827 phy->SetAttribute(
"TxPowerEnd",
DoubleValue(16.0));
3828 phy->SetAttribute(
"PowerDensityLimit",
DoubleValue(100.0));
3831 phy->SetAttribute(
"TxMaskInnerBandMinimumRejection",
DoubleValue(-100.0));
3832 phy->SetAttribute(
"TxMaskOuterBandMinimumRejection",
DoubleValue(-100.0));
3833 phy->SetAttribute(
"TxMaskOuterBandMaximumRejection",
DoubleValue(-100.0));
3868 bool scheduleTxSta1,
3869 Time ulTimeDifference,
3873 static uint64_t uid = 0;
3923 expectedStateBeforeEnd);
3928 expectedStateAtEnd);
3931 if (expectedSuccessFromSta1 + expectedFailuresFromSta1 + expectedSuccessFromSta2 +
3932 expectedFailuresFromSta2 >
3936 const bool isSuccess = (expectedSuccessFromSta1 > 0) || (expectedSuccessFromSta2 > 0);
3966 expectedSuccessFromSta1,
3967 expectedFailuresFromSta1,
3968 expectedBytesFromSta1);
3973 expectedSuccessFromSta2,
3974 expectedFailuresFromSta2,
3975 expectedBytesFromSta2);
3985 Watt_u rxPowerNonOfdmaRu1,
3986 Watt_u rxPowerNonOfdmaRu2,
3994 const auto nonOfdmaDuration = hePhy->CalculateNonHeDurationForHeTb(txVectorSta2);
3995 NS_ASSERT(nonOfdmaDuration == hePhy->CalculateNonHeDurationForHeTb(txVectorSta1));
3997 std::vector<Watt_u> rxPowerNonOfdma{rxPowerNonOfdmaRu1, rxPowerNonOfdmaRu2};
3998 std::vector<WifiSpectrumBandInfo> nonOfdmaBand{hePhy->GetNonOfdmaBand(txVectorSta1, 1),
3999 hePhy->GetNonOfdmaBand(txVectorSta2, 2)};
4000 std::vector<Watt_u> rxPowerOfdma{rxPowerOfdmaRu1, rxPowerOfdmaRu2};
4001 std::vector<WifiSpectrumBandInfo> ofdmaBand{hePhy->GetRuBandForRx(txVectorSta1, 1),
4002 hePhy->GetRuBandForRx(txVectorSta2, 2)};
4004 for (uint8_t i = 0; i < 2; ++i)
4011 delay + detectionDuration +
4017 rxPowerNonOfdma[i]);
4023 rxPowerNonOfdma[i]);
4047 delay + detectionDuration +
4053 rxPowerNonOfdma[i]);
4059 rxPowerNonOfdma[i]);
4077 if (rxPowerOfdmaRu1 !=
Watt_u{0.0})
4084 const auto rxPowerNonOfdmaSta1Only =
4086 ? rxPowerNonOfdma[0]
4087 : rxPowerNonOfdma[0] / 2;
4090 delay + detectionDuration +
4096 rxPowerNonOfdmaSta1Only);
4102 rxPowerNonOfdmaSta1Only);
4126 int64_t streamNumber = 0;
4165 "Reception of solicited HE TB PPDUs");
4184 "Reception of solicited HE TB PPDUs with delay (< 400ns) between the two signals");
4203 "Dropping of unsolicited HE TB PPDUs");
4215 WifiPhyState::CCA_BUSY);
4223 "Dropping of HE TB PPDUs with channel width differing from TRIGVECTOR");
4235 WifiPhyState::CCA_BUSY,
4244 "Dropping of HE TB PPDUs with UL Length differing from TRIGVECTOR");
4256 WifiPhyState::CCA_BUSY,
4265 "Dropping of HE TB PPDUs with AIDs differing from TRIGVECTOR");
4277 WifiPhyState::CCA_BUSY,
4288 "Reception of solicited HE TB PPDUs with interference on RU 1 during PSDU reception");
4295 bands.push_back(bandInfo);
4299 Watt_u interferencePower{0.1};
4310 WifiPhyState::CCA_BUSY,
4327 "Reception of solicited HE TB PPDUs with interference on RU 2 during PSDU reception");
4333 bands.push_back(bandInfo);
4347 ? WifiPhyState::IDLE
4348 : WifiPhyState::CCA_BUSY,
4365 "Reception of solicited HE TB PPDUs with interference on the full band "
4366 "during PSDU reception");
4372 bands.push_back(bandInfo);
4386 WifiPhyState::CCA_BUSY,
4404 "Reception of solicited HE TB PPDUs with another HE TB PPDU arriving on RU "
4405 "1 during PSDU reception");
4438 WifiPhyState::CCA_BUSY,
4456 "Reception of solicited HE TB PPDUs with another HE TB PPDU arriving on RU "
4457 "2 during PSDU reception");
4488 ? WifiPhyState::IDLE
4489 : WifiPhyState::CCA_BUSY,
4507 "Reception of solicited HE TB PPDUs with an HE SU PPDU arriving during the 400 ns window");
4534 "Reception of solicited HE TB PPDU only on RU 2");
4542 ? WifiPhyState::IDLE
4543 : WifiPhyState::CCA_BUSY);
4564 "Measure power for reception of HE TB PPDU only on RU 2");
4593 "Measure power for reception of HE TB PPDU only on RU 2 with PSD limitation");
4606 auto rxPowerOfdma = rxPower;
4645 "Measure power for reception of HE TB PPDU on both RUs");
4648 const auto rxPowerNonOfdma =
4670 "Reception of an HE TB PPDU from another BSS");
4698 "Reception of solicited HE TB PPDUs with delay (< 400ns) between the two signals and "
4699 "reception of an HE TB PPDU from another BSS between the ends of the two HE TB PPDUs");
4712 WifiPhyState::CCA_BUSY,
4771 void DoRun()
override;
4782 std::size_t payloadSize,
4856 const std::vector<bool>& statusPerMpdu);
4879 :
TestCase(
"PHY padding exclusion test"),
4880 m_countRxSuccessFromSta1(0),
4881 m_countRxSuccessFromSta2(0),
4882 m_countRxFailureFromSta1(0),
4883 m_countRxFailureFromSta2(0),
4884 m_countRxBytesFromSta1(0),
4885 m_countRxBytesFromSta2(0)
4892 std::size_t payloadSize,
4910 txVector.SetRu(ru, txStaId);
4912 txVector.SetNss(1, txStaId);
4919 std::ostringstream addr;
4920 addr <<
"00:00:00:00:00:0" << txStaId;
4924 psdus.insert(std::make_pair(txStaId, psdu));
4931 else if (txStaId == 2)
4940 phy->Send(psdus, txVector);
4966 const std::vector<bool>& )
4968 NS_LOG_FUNCTION(
this << *psdu << psdu->GetAddr2() << rxSignalInfo << txVector);
4969 if (psdu->GetAddr2() ==
Mac48Address(
"00:00:00:00:00:01"))
4974 else if (psdu->GetAddr2() ==
Mac48Address(
"00:00:00:00:00:02"))
4985 if (psdu->GetAddr2() ==
Mac48Address(
"00:00:00:00:00:01"))
4989 else if (psdu->GetAddr2() ==
Mac48Address(
"00:00:00:00:00:02"))
5002 "The number of successfully received packets from STA 1 is not correct!");
5006 "The number of unsuccessfuly received packets from STA 1 is not correct!");
5009 "The number of bytes received from STA 1 is not correct!");
5019 "The number of successfully received packets from STA 2 is not correct!");
5023 "The number of unsuccessfuly received packets from STA 2 is not correct!");
5026 "The number of bytes received from STA 2 is not correct!");
5034 "m_currentEvent for AP was not cleared");
5037 "m_currentEvent for STA 1 was not cleared");
5040 "m_currentEvent for STA 2 was not cleared");
5054 WifiPhyState currentState = phy->GetState()->GetState();
5058 "PHY State " << currentState <<
" does not match expected state "
5081 int64_t streamNumber = 0;
5086 spectrumChannel->AddPropagationLossModel(lossModel);
5089 spectrumChannel->SetPropagationDelayModel(delayModel);
5096 apMac->SetAttribute(
"BeaconGeneration",
BooleanValue(
false));
5097 apDev->SetMac(apMac);
5100 apDev->SetHeConfiguration(heConfiguration);
5125 apMac->SetWifiPhys({
m_phyAp});
5126 apNode->AggregateObject(apMobility);
5127 apNode->AddDevice(apDev);
5147 sta1Node->AggregateObject(sta1Mobility);
5148 sta1Node->AddDevice(sta1Dev);
5168 sta2Node->AggregateObject(sta2Mobility);
5169 sta2Node->AddDevice(sta2Dev);
5177 interfererNode->AddDevice(interfererDev);
5209 trigVector.SetNss(1, 1);
5212 trigVector.SetNss(1, 2);
5214 std::tie(length, ppduDuration) =
5216 trigVector.SetLength(length);
5218 hePhyAp->SetTrigVector(trigVector, ppduDuration);
5225 Time ppduWithPaddingDuration =
5226 expectedPpduDuration + 10 *
NanoSeconds(12800 + 1600 );
5237 ppduWithPaddingDuration);
5244 ppduWithPaddingDuration);
5250 ppduWithPaddingDuration);
5262 WifiPhyState::IDLE);
5280 ppduWithPaddingDuration);
5287 ppduWithPaddingDuration);
5293 ppduWithPaddingDuration);
5301 bands.push_back(bandInfo);
5305 Watt_u interferencePower{0.1};
5325 WifiPhyState::CCA_BUSY);
5357 void DoRun()
override;
5364 void SendMuBar(std::vector<uint16_t> staIds);
5380 void RunOne(
bool setupBa);
5400 const std::vector<bool>& statusPerMpdu);
5425 :
TestCase(
"UL-OFDMA power control test"),
5427 m_txPowerAp(
dBm_u{0}),
5428 m_txPowerStart(
dBm_u{0}),
5429 m_txPowerEnd(
dBm_u{0}),
5431 m_requestedRssiSta1(
dBm_u{0}),
5432 m_requestedRssiSta2(
dBm_u{0}),
5433 m_rssiSta1(
dBm_u{0}),
5434 m_rssiSta2(
dBm_u{0}),
5452 m_apDev->Send(pkt, destination, 0);
5458 NS_ASSERT(!staIds.empty() && staIds.size() <= 2);
5462 muBar.
SetType(TriggerFrameType::MU_BAR_TRIGGER);
5471 std::size_t index = 1;
5472 int8_t ulTargetRssi = -40;
5473 for (
const auto& staId : staIds)
5486 else if (staId == 2)
5526 bar->AddHeader(muBar);
5529 if (staIds.size() == 1)
5532 if (staIds.front() == aidSta1)
5555 auto nav =
m_apDev->GetPhy()->GetSifs();
5556 const auto staId = staIds.front();
5561 psdu->SetDuration(nav);
5562 psdus.insert(std::make_pair(
SU_STA_ID, psdu));
5564 m_phyAp->Send(psdus, txVector);
5571 const std::vector<bool>& )
5574 const auto rssi = rxSignalInfo.
rssi;
5576 const auto& hdr = psdu->GetHeader(0);
5578 if (hdr.GetAddr2() ==
m_sta1Dev->GetAddress())
5584 "The obtained RSSI from STA 1 at AP is different from the expected one ("
5585 << rssi <<
" vs " <<
m_rssiSta1 <<
", with tolerance of " <<
m_tol <<
")");
5587 else if (psdu->GetAddr2() ==
m_sta2Dev->GetAddress())
5593 "The obtained RSSI from STA 2 at AP is different from the expected one ("
5594 << rssi <<
" vs " <<
m_rssiSta2 <<
", with tolerance of " <<
m_tol <<
")");
5606 m_phyAp->SetReceiveOkCallback(
5619 spectrumChannel->AddPropagationLossModel(lossModel);
5621 spectrumChannel->SetPropagationDelayModel(delayModel);
5626 spectrumPhy.
Set(
"ChannelSettings",
StringValue(
"{0, 0, BAND_5GHZ, 0}"));
5630 wifi.SetRemoteStationManager(
"ns3::ConstantRateWifiManager",
5637 mac.SetType(
"ns3::StaWifiMac");
5638 auto staDevs = wifi.Install(spectrumPhy, mac, staNodes);
5648 mac.SetType(
"ns3::ApWifiMac",
5662 mobility.SetMobilityModel(
"ns3::ConstantPositionMobilityModel");
5664 positionAlloc->Add(Vector(0.0, 0.0, 0.0));
5665 positionAlloc->Add(Vector(1.0, 0.0, 0.0));
5667 Vector(2.0, 0.0, 0.0));
5668 mobility.SetPositionAllocator(positionAlloc);
5670 mobility.Install(apNode);
5671 mobility.Install(staNodes);
5673 lossModel->SetDefaultLoss(50.0);
5698 int64_t streamNumber = 0;
5703 m_phyAp->AssignStreams(streamNumber);
5704 phySta1->AssignStreams(streamNumber);
5705 phySta2->AssignStreams(streamNumber);
5719 Time relativeStart{};
5738 apMac->SetAttribute(
"BeaconGeneration",
BooleanValue(
false));
5747 std::vector<uint16_t> staIds{1};
5753 std::vector<uint16_t> staIds{2};
5762 std::vector<uint16_t> staIds{1, 2};
SpectrumWifiPhy used for testing OFDMA.
void SetTriggerFrameUid(uint64_t uid)
Since we assume trigger frame was previously received from AP, this is used to set its UID.
Ptr< const HePhy > GetHePhy() const
void(* TxPpduUidCallback)(uint64_t uid)
TracedCallback signature for UID of transmitted PPDU.
void SetPpduUid(uint64_t uid)
Set the global PPDU UID counter.
~OfdmaSpectrumWifiPhy() override
static TypeId GetTypeId()
Get the type ID.
std::map< std::pair< uint64_t, WifiPreamble >, Ptr< Event > > & GetCurrentPreambleEvents()
Ptr< OfdmaTestHePhy > m_ofdmTestHePhy
Pointer to HE PHY instance used for OFDMA test.
Ptr< Event > GetCurrentEvent()
void StartTx(Ptr< const WifiPpdu > ppdu) override
void DoDispose() override
Destructor implementation.
OfdmaSpectrumWifiPhy(uint16_t staId)
Constructor.
void Reset()
Reset data upon end of TX or RX.
TracedCallback< uint64_t > m_phyTxPpduUidTrace
Callback providing UID of the PPDU that is about to be transmitted.
void DoInitialize() override
Initialize() implementation.
Time GetEnergyDuration(Watt_u energy, WifiSpectrumBandInfo band)
Wrapper to InterferenceHelper method.
HE PHY slightly modified so as to return a given STA-ID in case of DL MU for OfdmaSpectrumWifiPhy.
OfdmaTestHePhy(uint16_t staId)
Constructor.
~OfdmaTestHePhy() override
void SetGlobalPpduUid(uint64_t uid)
Set the global PPDU UID counter.
uint16_t GetStaId(const Ptr< const WifiPpdu > ppdu) const override
Return the STA ID that has been assigned to the station this PHY belongs to.
uint16_t m_staId
ID of the STA to which this PHY belongs to.
PHY listener for OFDMA tests.
OfdmaTestPhyListener()=default
void NotifyRxEndError() override
We have received the last bit of a packet for which NotifyRxStart was invoked first and,...
bool m_lastRxSuccess
flag whether last RX has been successful
void NotifyRxStart(Time duration) override
Time GetLastRxStartNotification() const
Return the time at which the last RX start notification has been received.
void NotifySwitchingStart(Time duration) override
void NotifyWakeup() override
Notify listeners that we woke up.
uint32_t m_notifyRxStart
count number of RX start notifications
void Reset()
Reset function.
Time m_lastRxEnd
last time a RX end notification has been received
Time m_lastRxStart
last time a RX start notification has been received
Time GetLastRxEndNotification() const
Return the time at which the last RX end notification has been received.
void NotifyCcaBusyStart(Time duration, WifiChannelListType channelType, const std::vector< Time > &) override
uint32_t m_notifyRxEnd
count number of RX end notifications
bool IsLastRxSuccess() const
Return whether last RX has been successful.
void NotifySleep() override
Notify listeners that we went to sleep.
uint32_t GetNumRxEndNotifications() const
Return the number of RX end notifications that has been received since the last reset.
void NotifyRxEndOk() override
We have received the last bit of a packet for which NotifyRxStart was invoked first and,...
void NotifyTxStart(Time duration, dBm_u txPower) override
uint32_t GetNumRxStartNotifications() const
Return the number of RX start notifications that has been received since the last reset.
void NotifyOff() override
Notify listeners that we went to switch off.
void NotifyOn() override
Notify listeners that we went to switch on.
DL-OFDMA PHY puncturing test.
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
uint32_t m_countRxBytesSta1
count RX bytes for STA 1
uint32_t m_countRxBytesSta2
count RX bytes for STA 2
Ptr< SpectrumWifiPhy > m_phyAp
PHY of AP.
void DoRun() override
Implementation to actually run this TestCase.
TestDlOfdmaPhyPuncturing()
Time m_expectedPpduDuration20Mhz
expected duration to send MU PPDU on 20 MHz RU
void CheckResultsSta1(uint32_t expectedRxSuccess, uint32_t expectedRxFailure, uint32_t expectedRxBytes)
Check the results for STA 1.
void ResetResults()
Reset the results.
uint32_t m_countRxSuccessSta2
count RX success for STA 2
void RunOne()
Run one function.
Ptr< OfdmaSpectrumWifiPhy > m_phySta1
PHY of STA 1.
void RxFailureSta1(Ptr< const WifiPsdu > psdu)
Receive failure function for STA 1.
uint32_t m_countRxFailureSta2
count RX failure for STA 2
void DoSetup() override
Implementation to do any local setup required for this TestCase.
void SendMuPpdu(uint16_t rxStaId1, uint16_t rxStaId2, const std::vector< bool > &puncturedSubchannels)
Send MU-PPDU function.
uint32_t m_countRxFailureSta1
count RX failure for STA 1
void RxSuccessSta2(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &statusPerMpdu)
Receive success function for STA 2.
Time m_expectedPpduDuration40Mhz
expected duration to send MU PPDU on 40 MHz RU
void CheckResultsSta2(uint32_t expectedRxSuccess, uint32_t expectedRxFailure, uint32_t expectedRxBytes)
Check the results for STA 2.
void DoCheckPhyState(Ptr< OfdmaSpectrumWifiPhy > phy, WifiPhyState expectedState)
Check the PHY state now.
MHz_u m_frequency
frequency
MHz_u m_channelWidth
channel width
void RxFailureSta2(Ptr< const WifiPsdu > psdu)
Receive failure function for STA 2.
Ptr< WaveformGenerator > m_phyInterferer
PHY of interferer.
void StopInterference()
Stop interference function.
void RxSuccessSta1(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &statusPerMpdu)
Receive success function for STA 1.
void CheckPhyState(Ptr< OfdmaSpectrumWifiPhy > phy, WifiPhyState expectedState)
Schedule now to check the PHY state.
uint8_t m_indexSubchannel
Index of the subchannel (starting from 0) that should contain an interference and be punctured during...
uint32_t m_countRxSuccessSta1
count RX success for STA 1
Ptr< OfdmaSpectrumWifiPhy > m_phySta2
PHY of STA 2.
void GenerateInterference(Ptr< SpectrumValue > interferencePsd, Time duration)
Generate interference function.
void RxSuccessSta2(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &statusPerMpdu)
Receive success function for STA 2.
void DoSetup() override
Implementation to do any local setup required for this TestCase.
uint32_t m_countRxFailureSta2
count RX failure for STA 2
void RxFailureSta2(Ptr< const WifiPsdu > psdu)
Receive failure function for STA 2.
void RunOne()
Run one function.
void RxSuccessSta1(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &statusPerMpdu)
Receive success function for STA 1.
uint32_t m_countRxBytesSta2
count RX bytes for STA 2
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
Time m_expectedPpduDuration
expected duration to send MU PPDU
void GenerateInterference(Ptr< SpectrumValue > interferencePsd, Time duration)
Generate interference function.
MHz_u m_channelWidth
channel width
Ptr< WaveformGenerator > m_phyInterferer
PHY of interferer.
uint32_t m_countRxFailureSta3
count RX failure for STA 3
uint32_t m_countRxBytesSta1
count RX bytes for STA 1
TestDlOfdmaPhyTransmission()
Ptr< OfdmaSpectrumWifiPhy > m_phySta2
PHY of STA 2.
void RxSuccessSta3(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &statusPerMpdu)
Receive success function for STA 3.
void DoRun() override
Implementation to actually run this TestCase.
Ptr< SpectrumWifiPhy > m_phyAp
PHY of AP.
Ptr< OfdmaSpectrumWifiPhy > m_phySta1
PHY of STA 1.
void CheckResultsSta2(uint32_t expectedRxSuccess, uint32_t expectedRxFailure, uint32_t expectedRxBytes)
Check the results for STA 2.
void CheckPhyState(Ptr< OfdmaSpectrumWifiPhy > phy, WifiPhyState expectedState)
Schedule now to check the PHY state.
uint32_t m_countRxSuccessSta2
count RX success for STA 2
uint32_t m_countRxFailureSta1
count RX failure for STA 1
void CheckResultsSta1(uint32_t expectedRxSuccess, uint32_t expectedRxFailure, uint32_t expectedRxBytes)
Check the results for STA 1.
Ptr< OfdmaSpectrumWifiPhy > m_phySta3
PHY of STA 3.
uint32_t m_countRxSuccessSta3
count RX success for STA 3
void DoCheckPhyState(Ptr< OfdmaSpectrumWifiPhy > phy, WifiPhyState expectedState)
Check the PHY state now.
uint32_t m_countRxBytesSta3
count RX bytes for STA 3
void RxFailureSta3(Ptr< const WifiPsdu > psdu)
Receive failure function for STA 3.
void StopInterference()
Stop interference function.
void ResetResults()
Reset the results.
MHz_u m_frequency
frequency
void RxFailureSta1(Ptr< const WifiPsdu > psdu)
Receive failure function for STA 1.
uint32_t m_countRxSuccessSta1
count RX success for STA 1
void CheckResultsSta3(uint32_t expectedRxSuccess, uint32_t expectedRxFailure, uint32_t expectedRxBytes)
Check the results for STA 3.
~TestDlOfdmaPhyTransmission() override
void SendMuPpdu(uint16_t rxStaId1, uint16_t rxStaId2)
Send MU-PPDU function.
UL-OFDMA multiple RX events test.
WifiTxVector m_trigVector
TRIGVECTOR.
void RxHeTbPpdu(uint64_t uid, uint16_t staId, Watt_u txPower, size_t payloadSize)
Receive HE TB PPDU function.
Ptr< OfdmaSpectrumWifiPhy > m_phy
Phy.
void Reset()
Reset function.
~TestMultipleHeTbPreambles() override
void RxHeTbPpduOfdmaPart(Ptr< WifiSpectrumSignalParameters > rxParamsOfdma)
Receive OFDMA part of HE TB PPDU function.
void CheckHeTbPreambles(size_t nEvents, std::vector< uint64_t > uids)
Check the received HE TB preambles.
TestMultipleHeTbPreambles()
uint64_t m_totalBytesDropped
total number of dropped bytes
void CheckBytesDropped(size_t expectedBytesDropped)
Check the number of bytes dropped.
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
void DoRun() override
Implementation to actually run this TestCase.
void RxDropped(Ptr< const Packet > p, WifiPhyRxfailureReason reason)
RX dropped function.
void DoRxHeTbPpduOfdmaPart(Ptr< WifiSpectrumSignalParameters > rxParamsOfdma)
Receive OFDMA part of HE TB PPDU function.
void DoSetup() override
Implementation to do any local setup required for this TestCase.
PHY padding exclusion test.
void DoSetup() override
Implementation to do any local setup required for this TestCase.
void CheckRxFromSta1(uint32_t expectedSuccess, uint32_t expectedFailures, uint32_t expectedBytes)
Check the received PSDUs from STA1.
Ptr< OfdmaSpectrumWifiPhy > m_phySta2
PHY of STA 2.
void VerifyEventsCleared()
Verify all events are cleared at end of TX or RX.
TestPhyPaddingExclusion()
void DoCheckPhyState(Ptr< OfdmaSpectrumWifiPhy > phy, WifiPhyState expectedState)
Check the PHY state.
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
~TestPhyPaddingExclusion() override
void GenerateInterference(Ptr< SpectrumValue > interferencePsd, Time duration)
Generate interference function.
Ptr< WaveformGenerator > m_phyInterferer
PHY of interferer.
uint32_t m_countRxSuccessFromSta2
count RX success from STA 2
void DoRun() override
Implementation to actually run this TestCase.
void RxFailure(Ptr< const WifiPsdu > psdu)
Receive failure function.
uint32_t m_countRxBytesFromSta1
count RX bytes from STA 1
Ptr< OfdmaSpectrumWifiPhy > m_phyAp
PHY of AP.
Ptr< OfdmaSpectrumWifiPhy > m_phySta1
PHY of STA 1.
void RxSuccess(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &statusPerMpdu)
Receive success function.
void SendHeTbPpdu(uint16_t txStaId, std::size_t index, std::size_t payloadSize, Time txDuration)
Send HE TB PPDU function.
void SetTrigVector(Time ppduDuration)
Set TRIGVECTOR for HE TB PPDU.
void Reset()
Reset function.
uint32_t m_countRxFailureFromSta1
count RX failure from STA 1
uint32_t m_countRxSuccessFromSta1
count RX success from STA 1
void StopInterference()
Stop interference function.
void RunOne()
Run one function.
void CheckRxFromSta2(uint32_t expectedSuccess, uint32_t expectedFailures, uint32_t expectedBytes)
Check the received PSDUs from STA2.
uint32_t m_countRxFailureFromSta2
count RX failure from STA 2
uint32_t m_countRxBytesFromSta2
count RX bytes from STA 2
void CheckPhyState(Ptr< OfdmaSpectrumWifiPhy > phy, WifiPhyState expectedState)
Check the PHY state.
void ScheduleTest(Time delay, bool solicited, WifiPhyState expectedStateAtEnd, uint32_t expectedSuccessFromSta1, uint32_t expectedFailuresFromSta1, uint32_t expectedBytesFromSta1, uint32_t expectedSuccessFromSta2, uint32_t expectedFailuresFromSta2, uint32_t expectedBytesFromSta2, bool scheduleTxSta1=true, Time ulTimeDifference=Seconds(0), WifiPhyState expectedStateBeforeEnd=WifiPhyState::RX, TrigVectorInfo error=NONE)
Schedule test to perform.
MHz_u m_channelWidth
channel width
std::shared_ptr< OfdmaTestPhyListener > m_apPhyStateListener
listener for AP PHY state transitions
void GenerateInterference(Ptr< SpectrumValue > interferencePsd, Time duration)
Generate interference function.
WifiTxVector GetTxVectorForHeTbPpdu(uint16_t txStaId, std::size_t index, uint8_t bssColor) const
Get TXVECTOR for HE TB PPDU.
uint32_t m_countRxFailureFromSta1
count RX failure from STA 1
void RxSuccess(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &statusPerMpdu)
Receive success function.
void DoCheckPhyState(Ptr< OfdmaSpectrumWifiPhy > phy, WifiPhyState expectedState)
Check the PHY state.
uint32_t m_countRxBytesFromSta1
count RX bytes from STA 1
void RxFailure(Ptr< const WifiPsdu > psdu)
Receive failure function.
void CheckApRxStart(uint32_t expectedNotifications, Time expectedLastNotification)
Check the the number of RX start notifications at the AP as well as the last time a RX start has been...
TrigVectorInfo
Erroneous info included in a TRIGVECTOR.
void SetBssColor(Ptr< WifiPhy > phy, uint8_t bssColor)
Set the BSS color.
Ptr< OfdmaSpectrumWifiPhy > m_phySta2
PHY of STA 2.
void LogScenario(std::string log) const
Log scenario description.
void CheckRxFromSta2(uint32_t expectedSuccess, uint32_t expectedFailures, uint32_t expectedBytes)
Check the received PSDUs from STA2.
void SendHeTbPpdu(uint16_t txStaId, std::size_t index, std::size_t payloadSize, uint64_t uid, uint8_t bssColor, bool incrementUid)
Send HE TB PPDU function.
void DoRun() override
Implementation to actually run this TestCase.
void DoSetup() override
Implementation to do any local setup required for this TestCase.
void StopInterference()
Stop interference function.
void CheckOfdmaRxPower(Ptr< OfdmaSpectrumWifiPhy > phy, WifiSpectrumBandInfo band, Watt_u expectedRxPower)
Check the received power for the OFDMA part of the HE TB PPDUs over the given band.
uint32_t m_countRxBytesFromSta2
count RX bytes from STA 2
void Reset()
Reset function.
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
void CheckPhyState(Ptr< OfdmaSpectrumWifiPhy > phy, WifiPhyState expectedState)
Check the PHY state.
void SetPsdLimit(Ptr< WifiPhy > phy, dBm_per_MHz_u psdLimit)
Set the PSD limit.
Ptr< OfdmaSpectrumWifiPhy > m_phySta1
PHY of STA 1.
~TestUlOfdmaPhyTransmission() override
TestUlOfdmaPhyTransmission()
void CheckRxFromSta1(uint32_t expectedSuccess, uint32_t expectedFailures, uint32_t expectedBytes)
Check the received PSDUs from STA1.
void RunOne()
Run one function.
uint32_t m_countRxSuccessFromSta2
count RX success from STA 2
Ptr< WaveformGenerator > m_phyInterferer
PHY of interferer.
void CheckApRxEnd(uint32_t expectedNotifications, Time expectedLastNotification, bool expectedSuccess)
Check the the number of RX end notifications at the AP as well as the last time a RX end has been not...
Ptr< OfdmaSpectrumWifiPhy > m_phySta3
PHY of STA 3.
void CheckNonOfdmaRxPower(Ptr< OfdmaSpectrumWifiPhy > phy, WifiSpectrumBandInfo band, Watt_u expectedRxPower)
Check the received power for the non-OFDMA of the HE TB PPDUs over the given band.
void SendHeSuPpdu(uint16_t txStaId, std::size_t payloadSize, uint64_t uid, uint8_t bssColor)
Send HE SU PPDU function.
uint32_t m_countRxFailureFromSta2
count RX failure from STA 2
void VerifyEventsCleared()
Verify all events are cleared at end of TX or RX.
void SetTrigVector(uint8_t bssColor, TrigVectorInfo error)
Set TRIGVECTOR for HE TB PPDU.
void SchedulePowerMeasurementChecks(Time delay, Watt_u rxPowerNonOfdmaRu1, Watt_u rxPowerNonOfdmaRu2, Watt_u rxPowerOfdmaRu1, Watt_u rxPowerOfdmaRu2)
Schedule power measurement related checks.
Time m_expectedPpduDuration
expected duration to send MU PPDU
uint32_t m_countRxSuccessFromSta1
count RX success from STA 1
Ptr< OfdmaSpectrumWifiPhy > m_phyAp
PHY of AP.
MHz_u m_frequency
frequency
UL-OFDMA power control test.
dBm_u m_requestedRssiSta2
requested RSSI from STA 2 at AP for HE TB PPDUs
void DoRun() override
Implementation to actually run this TestCase.
Ptr< WifiNetDevice > m_sta2Dev
network device of STA 2
dBm_u m_rssiSta2
expected RSSI from STA 2 at AP for HE TB PPDUs
dBm_u m_txPowerEnd
maximum transmission power for STAs
dBm_u m_txPowerStart
minimum transmission power for STAs
void SetupBa(Address destination)
Send a QoS Data packet to the destination station in order to set up a block Ack session (so that the...
Ptr< WifiNetDevice > m_sta1Dev
network device of STA 1
dBm_u m_rssiSta1
expected RSSI from STA 1 at AP for HE TB PPDUs
Ptr< WifiNetDevice > m_apDev
network device of AP
dBm_u m_requestedRssiSta1
requested RSSI from STA 1 at AP for HE TB PPDUs
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
uint8_t m_bssColor
BSS color.
void ReplaceReceiveOkCallbackOfAp()
Replace the AP's callback on its PHY's ReceiveOkCallback by the ReceiveOkCallbackAtAp method.
dBm_u m_txPowerAp
transmit power of AP
uint8_t m_txPowerLevels
number of transmission power levels for STAs
dB_u m_tol
tolerance between received and expected RSSIs
TestUlOfdmaPowerControl()
void RunOne(bool setupBa)
Run one simulation with an optional BA session set up phase.
void DoSetup() override
Implementation to do any local setup required for this TestCase.
Ptr< SpectrumWifiPhy > m_phyAp
PHY of AP.
void ReceiveOkCallbackAtAp(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &statusPerMpdu)
Receive OK callback function at AP.
~TestUlOfdmaPowerControl() override
void SendMuBar(std::vector< uint16_t > staIds)
Send a MU BAR through the AP to the STAs listed in the provided vector.
UL-OFDMA PPDU UID attribution test.
~TestUlOfdmaPpduUid() override
void TxPpduSta1(uint64_t uid)
Transmitted PPDU information function for STA 1.
void ResetPpduUid()
Reset the global PPDU UID counter in WifiPhy.
void CheckUid(uint16_t staId, uint64_t expectedUid)
Check the UID of the transmitted PPDU.
void TxPpduAp(uint64_t uid)
Transmitted PPDU information function for AP.
void TxPpduSta2(uint64_t uid)
Transmitted PPDU information function for STA 2.
Ptr< OfdmaSpectrumWifiPhy > m_phySta2
PHY of STA 2.
uint64_t m_ppduUidAp
UID of PPDU transmitted by AP.
uint64_t m_ppduUidSta1
UID of PPDU transmitted by STA1.
uint64_t m_ppduUidSta2
UID of PPDU transmitted by STA2.
void DoRun() override
Implementation to actually run this TestCase.
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
void SendMuPpdu()
Send MU-PPDU toward both STAs.
Ptr< OfdmaSpectrumWifiPhy > m_phySta1
PHY of STA 1.
void DoSetup() override
Implementation to do any local setup required for this TestCase.
void SendTbPpdu()
Send TB-PPDU from both STAs.
Ptr< OfdmaSpectrumWifiPhy > m_phyAp
PHY of AP.
void SendSuPpdu(uint16_t txStaId)
Send SU-PPDU function.
wifi PHY OFDMA Test Suite
a polymophic address class
AttributeValue implementation for Boolean.
User Info field of Trigger frames.
void SetAid12(uint16_t aid)
Set the AID12 subfield, which carries the 12 LSBs of the AID of the station for which this User Info ...
void SetUlFecCodingType(bool ldpc)
Set the UL FEC Coding Type subfield, which indicates whether BCC or LDPC is used.
void SetUlMcs(uint8_t mcs)
Set the UL MCS subfield, which indicates the MCS of the solicited HE TB PPDU.
void SetMuBarTriggerDepUserInfo(const CtrlBAckRequestHeader &bar)
Set the Trigger Dependent User Info subfield for the MU-BAR variant of Trigger frames,...
void SetUlDcm(bool dcm)
Set the UL DCM subfield, which indicates whether or not DCM is used.
void SetSsAllocation(uint8_t startingSs, uint8_t nSs)
Set the SS Allocation subfield, which is present when the AID12 subfield is neither 0 nor 2045.
void SetUlTargetRssi(int8_t dBm)
Set the UL Target RSSI subfield to indicate the expected receive signal power in dBm.
void SetRuAllocation(HeRu::RuSpec ru)
Set the RU Allocation subfield according to the specified RU.
This class can be used to hold variables of floating point type such as 'double' or 'float'.
static WifiMode GetHeMcs9()
Return MCS 9 from HE MCS values.
static WifiMode GetHeMcs7()
Return MCS 7 from HE MCS values.
uint16_t GetStaId(const Ptr< const WifiPpdu > ppdu) const override
Return the STA ID that has been assigned to the station this PHY belongs to.
static std::pair< uint16_t, Time > ConvertHeTbPpduDurationToLSigLength(Time ppduDuration, const WifiTxVector &txVector, WifiPhyBand band)
Compute the L-SIG length value corresponding to the given HE TB PPDU duration.
@ PSD_HE_PORTION
HE portion of an HE PPDU.
@ PSD_NON_HE_PORTION
Non-HE portion of an HE PPDU.
static MHz_u GetBandwidth(RuType ruType)
Get the approximate bandwidth occupied by a RU.
RuType
The different HE Resource Unit (RU) types.
static Mac48Address ConvertFrom(const Address &address)
static Mac48Address GetBroadcast()
Helper class used to assign positions and mobility models to nodes.
Keep track of the current position and velocity of an object.
keep track of a set of node pointers.
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
bool TraceConnectWithoutContext(std::string name, const CallbackBase &cb)
Connect a TraceSource to a Callback without a context.
Ptr< T > GetObject() const
Get a pointer to the requested aggregated Object.
void Dispose()
Dispose of this Object.
void SetOwner(Ptr< WifiPhy > wifiPhy)
Set the WifiPhy owning this PHY entity.
static uint64_t m_globalPpduUid
Global counter of the PPDU UID.
AttributeValue implementation for Pointer.
Smart pointer class similar to boost::intrusive_ptr.
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 EventId ScheduleNow(FUNC f, Ts &&... args)
Schedule an event to expire Now.
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 SetChannel(const Ptr< SpectrumChannel > channel)
void SetDevice(const Ptr< WifiNetDevice > device) override
Sets the device this PHY is associated with.
void StartRx(Ptr< SpectrumSignalParameters > rxParams, Ptr< const WifiSpectrumPhyInterface > interface)
Input method for delivering a signal from the spectrum channel and low-level PHY interface to this Sp...
void DoInitialize() override
Initialize() implementation.
MHz_u GetGuardBandwidth(MHz_u currentChannelWidth) const override
void AddChannel(const Ptr< SpectrumChannel > channel, const FrequencyRange &freqRange=WHOLE_WIFI_SPECTRUM)
Attach a SpectrumChannel to use for a given frequency range.
void DoDispose() override
Destructor implementation.
void StartTx(Ptr< const WifiPpdu > ppdu) override
Hold variables of type string.
void AddTestCase(TestCase *testCase, Duration duration=Duration::QUICK)
Add an individual child TestCase to this test suite.
Simulation virtual time values and global simulation resolution.
AttributeValue implementation for Time.
Forward calls to a chain of Callback.
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Hold an unsigned integer type.
static WifiMode GetVhtMcs5()
Return MCS 5 from VHT MCS values.
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.
void Set(std::string name, const AttributeValue &v)
void SetErrorRateModel(std::string type, Args &&... args)
Helper function used to set the error rate model.
virtual void SetInterferenceHelper(const Ptr< InterferenceHelper > helper)
Sets the interference helper.
void Send(Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector)
This function is a wrapper for the Send variant that accepts a WifiConstPsduMap as first argument.
void SetErrorRateModel(const Ptr< ErrorRateModel > model)
Sets the error rate model.
std::map< std::pair< uint64_t, WifiPreamble >, Ptr< Event > > m_currentPreambleEvents
store event associated to a PPDU (that has a unique ID and preamble combination) whose preamble is be...
std::tuple< uint8_t, MHz_u, WifiPhyBand, uint8_t > ChannelTuple
Tuple identifying a segment of an operating channel.
static Time GetPreambleDetectionDuration()
void SetReceiveErrorCallback(RxErrorCallback callback)
virtual void ConfigureStandard(WifiStandard standard)
Configure the PHY-level parameters for different Wi-Fi standard.
static Time CalculateTxDuration(uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, uint16_t staId=SU_STA_ID)
std::map< WifiModulationClass, Ptr< PhyEntity > > m_phyEntities
This map holds the supported PHY entities.
void RegisterListener(const std::shared_ptr< WifiPhyListener > &listener)
WifiPhyBand GetPhyBand() const
Get the configured Wi-Fi band.
Ptr< Event > m_currentEvent
Hold the current event.
Ptr< PhyEntity > GetPhyEntity(WifiModulationClass modulation) const
Get the supported PHY entity corresponding to the modulation class.
uint64_t m_previouslyRxPpduUid
UID of the previously received PPDU, reset to UINT64_MAX upon transmission.
void SetOperatingChannel(const WifiPhyOperatingChannel &channel)
If the standard for this object has not been set yet, store the channel settings corresponding to the...
void SetPreambleDetectionModel(const Ptr< PreambleDetectionModel > preambleDetectionModel)
Sets the preamble detection model.
void SetMobility(const Ptr< MobilityModel > mobility)
assign a mobility model to this device
Ptr< InterferenceHelper > m_interference
Pointer to a helper responsible for interference computations.
void SetReceiveOkCallback(RxOkCallback callback)
void Reset()
Reset data upon end of TX or RX.
const WifiPhyOperatingChannel & GetOperatingChannel() const
Get a const reference to the operating channel.
Ptr< PhyEntity > GetLatestPhyEntity() const
Get the latest PHY entity supported by this PHY instance.
virtual int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model.
receive notifications about PHY events.
static ConstIterator FindFirst(uint8_t number, MHz_u frequency, MHz_u width, WifiStandard standard, WifiPhyBand band, ConstIterator start=m_frequencyChannels.begin())
Find the first frequency segment matching the specified parameters.
This objects implements the PHY state machine of the Wifi device.
static Ptr< SpectrumValue > CreateHeMuOfdmTxPowerSpectralDensity(const std::vector< MHz_u > ¢erFrequencies, MHz_u channelWidth, Watt_u txPower, MHz_u guardBandwidth, const std::vector< WifiSpectrumBandIndices > &ru)
Create a transmit power spectral density corresponding to the OFDMA part of HE TB PPDUs for a given R...
static Ptr< SpectrumValue > CreateHeOfdmTxPowerSpectralDensity(MHz_u centerFrequency, MHz_u channelWidth, Watt_u txPower, MHz_u guardBandwidth, dBr_u minInnerBand=dBr_u{-20}, dBr_u minOuterband=dBr_u{-28}, dBr_u lowestPoint=dBr_u{-40}, const std::vector< bool > &puncturedSubchannels={})
Create a transmit power spectral density corresponding to OFDM High Efficiency (HE) (802....
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
void SetHeMuUserInfo(uint16_t staId, HeMuUserInfo userInfo)
Set the HE MU user-specific transmission information for the given STA-ID.
WifiPreamble GetPreambleType() const
const HeMuUserInfoMap & GetHeMuUserInfoMap() const
Get a const reference to the map HE MU user-specific transmission information indexed by STA-ID.
void SetRu(HeRu::RuSpec ru, uint16_t staId)
Set the RU specification for the STA-ID.
void SetLength(uint16_t length)
Set the LENGTH field of the L-SIG.
void SetMode(WifiMode mode)
Sets the selected payload transmission mode.
void SetNss(uint8_t nss)
Sets the number of Nss.
#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...
#define NS_ABORT_MSG(msg)
Unconditional abnormal program termination with a message.
#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_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_EQ(actual, limit, msg)
Test that an actual and expected (limit) value are equal and report and abort if not.
#define NS_TEST_ASSERT_MSG_EQ_TOL(actual, limit, tol, msg)
Test that actual and expected (limit) values are equal to plus or minus some tolerance and report and...
Time MicroSeconds(uint64_t value)
Construct a Time in the indicated unit.
Time NanoSeconds(uint64_t value)
Construct a Time in the indicated unit.
Time Seconds(double value)
Construct a Time in the indicated unit.
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
WifiPhyRxfailureReason
Enumeration of the possible reception failure reasons.
WifiPhyBand
Identifies the PHY band.
WifiChannelListType
Enumeration of the possible channel-list parameter elements defined in Table 8-5 of IEEE 802....
@ WIFI_PHY_BAND_5GHZ
The 5 GHz band.
@ WIFI_MOD_CLASS_HE
HE (Clause 27)
Every class exported by the ns3 library is enclosed in the ns3 namespace.
WifiPhyState
The state of the PHY layer.
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...
std::vector< BandInfo > Bands
Container of BandInfo.
Ptr< T1 > DynamicCast(const Ptr< T2 > &p)
Cast a Ptr.
std::size_t Count20MHzSubchannels(MHz_u channelWidth)
Return the number of 20 MHz subchannels covering the channel width.
Watt_u DbmToW(dBm_u val)
Convert from dBm to Watts.
uint32_t GetBlockAckSize(BlockAckType type)
Return the total BlockAck size (including FCS trailer).
Hz_u MHzToHz(MHz_u val)
Convert from MHz to Hz.
std::unordered_map< uint16_t, Ptr< const WifiPsdu > > WifiConstPsduMap
Map of const PSDUs indexed by STA-ID.
static constexpr uint16_t SU_STA_ID
STA_ID to identify a single user (SU)
std::vector< uint16_t > RuAllocation
9 bits RU_ALLOCATION per 20 MHz
The building block of a SpectrumModel.
double fc
center frequency
double fl
lower limit of subband
double fh
upper limit of subband
RxSignalInfo structure containing info on the received signal.
WifiSpectrumBandInfo structure containing info about a spectrum band.
static const MHz_u DEFAULT_FREQUENCY
static WifiPhyOfdmaTestSuite wifiPhyOfdmaTestSuite
the test suite
static const uint8_t DEFAULT_CHANNEL_NUMBER
static const WifiPhyBand DEFAULT_WIFI_BAND
static const MHz_u DEFAULT_CHANNEL_WIDTH
static const MHz_u DEFAULT_GUARD_WIDTH