A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
wifi-phy-reception-test.cc
Go to the documentation of this file.
1/*
2 * Copyright (c) 2018 University of Washington
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License version 2 as
6 * published by the Free Software Foundation;
7 *
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
12 *
13 * You should have received a copy of the GNU General Public License
14 * along with this program; if not, write to the Free Software
15 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16 *
17 * Author: Sébastien Deronne <sebastien.deronne@gmail.com>
18 */
19
20#include "ns3/ampdu-tag.h"
21#include "ns3/ap-wifi-mac.h"
22#include "ns3/boolean.h"
23#include "ns3/config.h"
24#include "ns3/double.h"
25#include "ns3/he-phy.h"
26#include "ns3/he-ppdu.h"
27#include "ns3/interference-helper.h"
28#include "ns3/log.h"
29#include "ns3/mobility-helper.h"
30#include "ns3/mpdu-aggregator.h"
31#include "ns3/multi-model-spectrum-channel.h"
32#include "ns3/nist-error-rate-model.h"
33#include "ns3/packet-socket-address.h"
34#include "ns3/packet-socket-client.h"
35#include "ns3/packet-socket-helper.h"
36#include "ns3/packet-socket-server.h"
37#include "ns3/pointer.h"
38#include "ns3/rng-seed-manager.h"
39#include "ns3/simple-frame-capture-model.h"
40#include "ns3/single-model-spectrum-channel.h"
41#include "ns3/spectrum-wifi-helper.h"
42#include "ns3/spectrum-wifi-phy.h"
43#include "ns3/test.h"
44#include "ns3/threshold-preamble-detection-model.h"
45#include "ns3/wifi-bandwidth-filter.h"
46#include "ns3/wifi-mac-header.h"
47#include "ns3/wifi-mpdu.h"
48#include "ns3/wifi-net-device.h"
49#include "ns3/wifi-psdu.h"
50#include "ns3/wifi-spectrum-phy-interface.h"
51#include "ns3/wifi-spectrum-signal-parameters.h"
52#include "ns3/wifi-spectrum-value-helper.h"
53#include "ns3/wifi-utils.h"
54
55#include <optional>
56
57using namespace ns3;
58
59NS_LOG_COMPONENT_DEFINE("WifiPhyReceptionTest");
60
61static const uint8_t CHANNEL_NUMBER = 36;
62static const uint32_t FREQUENCY = 5180; // MHz
63static const uint16_t CHANNEL_WIDTH = 20; // MHz
64static const uint16_t GUARD_WIDTH =
65 CHANNEL_WIDTH; // MHz (expanded to channel width to model spectrum mask)
66
73class WifiPhyReceptionTest : public TestCase
74{
75 public:
81 WifiPhyReceptionTest(std::string test_name);
85 ~WifiPhyReceptionTest() override = default;
86
87 protected:
88 void DoSetup() override;
89 void DoTeardown() override;
90
97 void SendPacket(double rxPowerDbm, uint32_t packetSize, uint8_t mcs);
98
103 void CheckPhyState(WifiPhyState expectedState);
108 void DoCheckPhyState(WifiPhyState expectedState);
109
110 Ptr<SpectrumWifiPhy> m_phy;
111 uint64_t m_uid{0};
112};
113
114WifiPhyReceptionTest::WifiPhyReceptionTest(std::string test_name)
115 : TestCase{test_name}
116{
117}
118
119void
120WifiPhyReceptionTest::SendPacket(double rxPowerDbm, uint32_t packetSize, uint8_t mcs)
121{
122 WifiTxVector txVector =
123 WifiTxVector(HePhy::GetHeMcs(mcs), 0, WIFI_PREAMBLE_HE_SU, 800, 1, 1, 0, 20, false);
124
125 Ptr<Packet> pkt = Create<Packet>(packetSize);
126 WifiMacHeader hdr;
127
128 hdr.SetType(WIFI_MAC_QOSDATA);
129 hdr.SetQosTid(0);
130
131 Ptr<WifiPsdu> psdu = Create<WifiPsdu>(pkt, hdr);
132 Time txDuration = m_phy->CalculateTxDuration(psdu->GetSize(), txVector, m_phy->GetPhyBand());
133
134 Ptr<WifiPpdu> ppdu =
135 Create<HePpdu>(psdu, txVector, m_phy->GetOperatingChannel(), txDuration, m_uid++);
136
137 Ptr<SpectrumValue> txPowerSpectrum =
138 WifiSpectrumValueHelper::CreateHeOfdmTxPowerSpectralDensity(FREQUENCY,
139 CHANNEL_WIDTH,
140 DbmToW(rxPowerDbm),
141 GUARD_WIDTH);
142
143 Ptr<WifiSpectrumSignalParameters> txParams = Create<WifiSpectrumSignalParameters>();
144 txParams->psd = txPowerSpectrum;
145 txParams->txPhy = nullptr;
146 txParams->duration = txDuration;
147 txParams->ppdu = ppdu;
148 txParams->txWidth = CHANNEL_WIDTH;
149
150 m_phy->StartRx(txParams, nullptr);
151}
152
153void
154WifiPhyReceptionTest::CheckPhyState(WifiPhyState expectedState)
155{
156 // This is needed to make sure PHY state will be checked as the last event if a state change
157 // occurred at the exact same time as the check
158 Simulator::ScheduleNow(&WifiPhyReceptionTest::DoCheckPhyState, this, expectedState);
159}
160
161void
162WifiPhyReceptionTest::DoCheckPhyState(WifiPhyState expectedState)
163{
164 WifiPhyState currentState;
165 PointerValue ptr;
166 m_phy->GetAttribute("State", ptr);
167 Ptr<WifiPhyStateHelper> state = DynamicCast<WifiPhyStateHelper>(ptr.Get<WifiPhyStateHelper>());
168 currentState = state->GetState();
169 NS_LOG_FUNCTION(this << currentState);
170 NS_TEST_ASSERT_MSG_EQ(currentState,
171 expectedState,
172 "PHY State " << currentState << " does not match expected state "
173 << expectedState << " at " << Simulator::Now());
174}
175
176void
177WifiPhyReceptionTest::DoSetup()
178{
179 Ptr<MultiModelSpectrumChannel> spectrumChannel = CreateObject<MultiModelSpectrumChannel>();
180 Ptr<Node> node = CreateObject<Node>();
181 Ptr<WifiNetDevice> dev = CreateObject<WifiNetDevice>();
182 m_phy = CreateObject<SpectrumWifiPhy>();
183 Ptr<InterferenceHelper> interferenceHelper = CreateObject<InterferenceHelper>();
184 m_phy->SetInterferenceHelper(interferenceHelper);
185 Ptr<ErrorRateModel> error = CreateObject<NistErrorRateModel>();
186 m_phy->SetErrorRateModel(error);
187 m_phy->SetDevice(dev);
188 m_phy->AddChannel(spectrumChannel);
189 m_phy->SetOperatingChannel(WifiPhy::ChannelTuple{CHANNEL_NUMBER, 0, WIFI_PHY_BAND_5GHZ, 0});
190 m_phy->ConfigureStandard(WIFI_STANDARD_80211ax);
191 dev->SetPhy(m_phy);
192 node->AddDevice(dev);
193}
194
195void
196WifiPhyReceptionTest::DoTeardown()
197{
198 m_phy->Dispose();
199 m_phy = nullptr;
200}
201
208class TestThresholdPreambleDetectionWithoutFrameCapture : public WifiPhyReceptionTest
209{
210 public:
211 TestThresholdPreambleDetectionWithoutFrameCapture();
212
213 protected:
214 void DoSetup() override;
215
223 void RxSuccess(Ptr<const WifiPsdu> psdu,
224 RxSignalInfo rxSignalInfo,
225 WifiTxVector txVector,
226 std::vector<bool> statusPerMpdu);
231 void RxFailure(Ptr<const WifiPsdu> psdu);
232 uint32_t m_countRxSuccess{0};
233 uint32_t m_countRxFailure{0};
234
235 private:
236 void DoRun() override;
237
243 void CheckRxPacketCount(uint32_t expectedSuccessCount, uint32_t expectedFailureCount);
244};
245
246TestThresholdPreambleDetectionWithoutFrameCapture::
247 TestThresholdPreambleDetectionWithoutFrameCapture()
248 : WifiPhyReceptionTest(
249 "Threshold preamble detection model test when no frame capture model is applied")
250{
251}
252
253void
254TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount(uint32_t expectedSuccessCount,
255 uint32_t expectedFailureCount)
256{
257 NS_TEST_ASSERT_MSG_EQ(m_countRxSuccess,
258 expectedSuccessCount,
259 "Didn't receive right number of successful packets");
260 NS_TEST_ASSERT_MSG_EQ(m_countRxFailure,
261 expectedFailureCount,
262 "Didn't receive right number of unsuccessful packets");
263}
264
265void
266TestThresholdPreambleDetectionWithoutFrameCapture::RxSuccess(Ptr<const WifiPsdu> psdu,
267 RxSignalInfo rxSignalInfo,
268 WifiTxVector txVector,
269 std::vector<bool> statusPerMpdu)
270{
271 NS_LOG_FUNCTION(this << *psdu << rxSignalInfo << txVector);
272 m_countRxSuccess++;
273}
274
275void
276TestThresholdPreambleDetectionWithoutFrameCapture::RxFailure(Ptr<const WifiPsdu> psdu)
277{
278 NS_LOG_FUNCTION(this << *psdu);
279 m_countRxFailure++;
280}
281
282void
283TestThresholdPreambleDetectionWithoutFrameCapture::DoSetup()
284{
285 WifiPhyReceptionTest::DoSetup();
286
287 m_phy->SetReceiveOkCallback(
288 MakeCallback(&TestThresholdPreambleDetectionWithoutFrameCapture::RxSuccess, this));
289 m_phy->SetReceiveErrorCallback(
290 MakeCallback(&TestThresholdPreambleDetectionWithoutFrameCapture::RxFailure, this));
291
292 Ptr<ThresholdPreambleDetectionModel> preambleDetectionModel =
293 CreateObject<ThresholdPreambleDetectionModel>();
294 preambleDetectionModel->SetAttribute("Threshold", DoubleValue(4));
295 preambleDetectionModel->SetAttribute("MinimumRssi", DoubleValue(-82));
296 m_phy->SetPreambleDetectionModel(preambleDetectionModel);
297}
298
299void
300TestThresholdPreambleDetectionWithoutFrameCapture::DoRun()
301{
302 RngSeedManager::SetSeed(1);
303 RngSeedManager::SetRun(1);
304 int64_t streamNumber = 0;
305 m_phy->AssignStreams(streamNumber);
306
307 // RX power > CCA-ED > CCA-PD
308 double rxPowerDbm = -50;
309
310 // CASE 1: send one packet and check PHY state:
311 // All reception stages should succeed and PHY state should be RX for the duration of the packet
312 // minus the time to detect the preamble, otherwise it should be IDLE.
313
314 Simulator::Schedule(Seconds(1.0),
315 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
316 this,
317 rxPowerDbm,
318 1000,
319 7);
320 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
321 // CCA_BUSY
322 Simulator::Schedule(Seconds(1.0) + NanoSeconds(3999),
323 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
324 this,
325 WifiPhyState::IDLE);
326 Simulator::Schedule(Seconds(1.0) + NanoSeconds(4000),
327 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
328 this,
329 WifiPhyState::CCA_BUSY);
330 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
331 // CCA_BUSY to RX
332 Simulator::Schedule(Seconds(1.0) + NanoSeconds(43999),
333 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
334 this,
335 WifiPhyState::CCA_BUSY);
336 Simulator::Schedule(Seconds(1.0) + NanoSeconds(44000),
337 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
338 this,
339 WifiPhyState::RX);
340 // Since it takes 152.8us to transmit the packet, PHY should be back to IDLE at time 152.8us
341 Simulator::Schedule(Seconds(1.0) + NanoSeconds(152799),
342 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
343 this,
344 WifiPhyState::RX);
345 Simulator::Schedule(Seconds(1.0) + NanoSeconds(152800),
346 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
347 this,
348 WifiPhyState::IDLE);
349 // Packet should have been successfully received
350 Simulator::Schedule(Seconds(1.1),
351 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount,
352 this,
353 1,
354 0);
355
356 // CASE 2: send two packets with same power within the 4us window and check PHY state:
357 // PHY preamble detection should fail because SNR is too low (around 0 dB, which is lower than
358 // the threshold of 4 dB), and PHY state should be CCA_BUSY since the total energy is above
359 // CCA-ED (-62 dBm). CCA_BUSY state should last for the duration of the two packets minus the
360 // time to detect the preamble.
361
362 Simulator::Schedule(Seconds(2.0),
363 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
364 this,
365 rxPowerDbm,
366 1000,
367 7);
368 Simulator::Schedule(Seconds(2.0) + MicroSeconds(2.0),
369 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
370 this,
371 rxPowerDbm,
372 1000,
373 7);
374 // At 4us, no preamble is successfully detected and STA PHY STATE should move from IDLE to
375 // CCA_BUSY
376 Simulator::Schedule(Seconds(2.0) + NanoSeconds(3999),
377 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
378 this,
379 WifiPhyState::IDLE);
380 Simulator::Schedule(Seconds(2.0) + NanoSeconds(4000),
381 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
382 this,
383 WifiPhyState::CCA_BUSY);
384 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 + 2
385 // = 154.8us
386 Simulator::Schedule(Seconds(2.0) + NanoSeconds(154799),
387 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
388 this,
389 WifiPhyState::CCA_BUSY);
390 Simulator::Schedule(Seconds(2.0) + NanoSeconds(154800),
391 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
392 this,
393 WifiPhyState::IDLE);
394 // No more packet should have been successfully received, and since preamble detection did not
395 // pass, the packet should not have been counted as a failure
396 Simulator::Schedule(Seconds(2.1),
397 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount,
398 this,
399 1,
400 0);
401
402 // CASE 3: send two packets with second one 3 dB weaker within the 4us window and check PHY
403 // state: PHY preamble detection should fail because SNR is too low (around 3 dB, which is lower
404 // than the threshold of 4 dB), and PHY state should be CCA_BUSY since the total energy is above
405 // CCA-ED (-62 dBm). CCA_BUSY state should last for the duration of the two packets minus the
406 // time to detect the preamble.
407
408 Simulator::Schedule(Seconds(3.0),
409 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
410 this,
411 rxPowerDbm,
412 1000,
413 7);
414 Simulator::Schedule(Seconds(3.0) + MicroSeconds(2.0),
415 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
416 this,
417 rxPowerDbm - 3,
418 1000,
419 7);
420 // At 4us, no preamble is successfully detected, hence STA PHY STATE should move from IDLE to
421 // CCA_BUSY
422 Simulator::Schedule(Seconds(3.0) + NanoSeconds(3999),
423 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
424 this,
425 WifiPhyState::IDLE);
426 Simulator::Schedule(Seconds(3.0) + NanoSeconds(4000),
427 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
428 this,
429 WifiPhyState::CCA_BUSY);
430 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 + 2
431 // = 154.8us
432 Simulator::Schedule(Seconds(3.0) + NanoSeconds(154799),
433 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
434 this,
435 WifiPhyState::CCA_BUSY);
436 Simulator::Schedule(Seconds(3.0) + NanoSeconds(154800),
437 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
438 this,
439 WifiPhyState::IDLE);
440 // No more packet should have been successfully received, and since preamble detection did not
441 // pass the packet should not have been counted as a failure
442 Simulator::Schedule(Seconds(3.1),
443 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount,
444 this,
445 1,
446 0);
447
448 // CASE 4: send two packets with second one 6 dB weaker within the 4us window and check PHY
449 // state: PHY preamble detection should succeed because SNR is high enough (around 6 dB, which
450 // is higher than the threshold of 4 dB), but payload reception should fail (SNR too low to
451 // decode the modulation).
452
453 Simulator::Schedule(Seconds(4.0),
454 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
455 this,
456 rxPowerDbm,
457 1000,
458 7);
459 Simulator::Schedule(Seconds(4.0) + MicroSeconds(2.0),
460 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
461 this,
462 rxPowerDbm - 6,
463 1000,
464 7);
465 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
466 // CCA_BUSY
467 Simulator::Schedule(Seconds(4.0) + NanoSeconds(3999),
468 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
469 this,
470 WifiPhyState::IDLE);
471 Simulator::Schedule(Seconds(4.0) + NanoSeconds(4000),
472 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
473 this,
474 WifiPhyState::CCA_BUSY);
475 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
476 // CCA_BUSY to RX
477 Simulator::Schedule(Seconds(4.0) + NanoSeconds(43999),
478 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
479 this,
480 WifiPhyState::CCA_BUSY);
481 Simulator::Schedule(Seconds(4.0) + NanoSeconds(44000),
482 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
483 this,
484 WifiPhyState::RX);
485 // Since it takes 152.8us to transmit the packet, PHY should be back to IDLE at time 152.8us.
486 // However, since there is a second packet transmitted with a power above CCA-ED (-62 dBm), PHY
487 // should first be seen as CCA_BUSY for 2us.
488 Simulator::Schedule(Seconds(4.0) + NanoSeconds(152799),
489 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
490 this,
491 WifiPhyState::RX);
492 Simulator::Schedule(Seconds(4.0) + NanoSeconds(152800),
493 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
494 this,
495 WifiPhyState::CCA_BUSY);
496 Simulator::Schedule(Seconds(4.0) + NanoSeconds(154799),
497 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
498 this,
499 WifiPhyState::CCA_BUSY);
500 Simulator::Schedule(Seconds(4.0) + NanoSeconds(154800),
501 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
502 this,
503 WifiPhyState::IDLE);
504 // In this case, the first packet should be marked as a failure
505 Simulator::Schedule(Seconds(4.1),
506 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount,
507 this,
508 1,
509 1);
510
511 // CASE 5: send two packets with second one 3 dB higher within the 4us window and check PHY
512 // state: PHY preamble detection should fail because SNR is too low (around -3 dB, which is
513 // lower than the threshold of 4 dB), and PHY state should be CCA_BUSY since the total energy is
514 // above CCA-ED (-62 dBm). CCA_BUSY state should last for the duration of the two packets minus
515 // the time to detect the preamble.
516
517 Simulator::Schedule(Seconds(5.0),
518 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
519 this,
520 rxPowerDbm,
521 1000,
522 7);
523 Simulator::Schedule(Seconds(5.0) + MicroSeconds(2.0),
524 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
525 this,
526 rxPowerDbm + 3,
527 1000,
528 7);
529 // At 6us (hence 4us after the last signal is received), no preamble is successfully detected,
530 // hence STA PHY STATE should move from IDLE to CCA_BUSY
531 Simulator::Schedule(Seconds(5.0) + NanoSeconds(5999),
532 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
533 this,
534 WifiPhyState::IDLE);
535 Simulator::Schedule(Seconds(5.0) + NanoSeconds(6000),
536 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
537 this,
538 WifiPhyState::CCA_BUSY);
539 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 + 2
540 // = 154.8us
541 Simulator::Schedule(Seconds(5.0) + NanoSeconds(154799),
542 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
543 this,
544 WifiPhyState::CCA_BUSY);
545 Simulator::Schedule(Seconds(5.0) + NanoSeconds(154800),
546 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
547 this,
548 WifiPhyState::IDLE);
549 // No more packet should have been successfully received, and since preamble detection did not
550 // pass the packet should not have been counted as a failure
551 Simulator::Schedule(Seconds(5.1),
552 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount,
553 this,
554 1,
555 1);
556
557 // CCA-PD < RX power < CCA-ED
558 rxPowerDbm = -70;
559
560 // CASE 6: send one packet and check PHY state:
561 // All reception stages should succeed and PHY state should be RX for the duration of the packet
562 // minus the time to detect the preamble, otherwise it should be IDLE.
563
564 Simulator::Schedule(Seconds(6.0),
565 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
566 this,
567 rxPowerDbm,
568 1000,
569 7);
570 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
571 // CCA_BUSY
572 Simulator::Schedule(Seconds(6.0) + NanoSeconds(3999),
573 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
574 this,
575 WifiPhyState::IDLE);
576 Simulator::Schedule(Seconds(6.0) + NanoSeconds(4000),
577 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
578 this,
579 WifiPhyState::CCA_BUSY);
580 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
581 // CCA_BUSY to RX
582 Simulator::Schedule(Seconds(6.0) + NanoSeconds(43999),
583 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
584 this,
585 WifiPhyState::CCA_BUSY);
586 Simulator::Schedule(Seconds(6.0) + NanoSeconds(44000),
587 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
588 this,
589 WifiPhyState::RX);
590 // Since it takes 152.8us to transmit the packet, PHY should be back to IDLE at time 152.8us
591 Simulator::Schedule(Seconds(6.0) + NanoSeconds(152799),
592 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
593 this,
594 WifiPhyState::RX);
595 Simulator::Schedule(Seconds(6.0) + NanoSeconds(152800),
596 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
597 this,
598 WifiPhyState::IDLE);
599 // Packet should have been successfully received
600 Simulator::Schedule(Seconds(6.1),
601 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount,
602 this,
603 2,
604 1);
605
606 // CASE 7: send two packets with same power within the 4us window and check PHY state:
607 // PHY preamble detection should fail because SNR is too low (around 0 dB, which is lower than
608 // the threshold of 4 dB), and PHY state should be CCA_BUSY since it should detect the start of
609 // a valid OFDM transmission at a receive level greater than or equal to the minimum modulation
610 // and coding rate sensitivity (–82 dBm for 20 MHz channel spacing).
611
612 Simulator::Schedule(Seconds(7.0),
613 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
614 this,
615 rxPowerDbm,
616 1000,
617 7);
618 Simulator::Schedule(Seconds(7.0) + MicroSeconds(2.0),
619 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
620 this,
621 rxPowerDbm,
622 1000,
623 7);
624 // At 4us, STA PHY STATE should stay IDLE
625 Simulator::Schedule(Seconds(7.0) + MicroSeconds(4.0),
626 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
627 this,
628 WifiPhyState::CCA_BUSY);
629 // No more packet should have been successfully received, and since preamble detection did not
630 // pass the packet should not have been counted as a failure
631 Simulator::Schedule(Seconds(7.1),
632 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount,
633 this,
634 2,
635 1);
636
637 // CASE 8: send two packets with second one 3 dB weaker within the 4us window and check PHY
638 // state: PHY preamble detection should fail PHY preamble detection should fail because SNR is
639 // too low (around 3 dB, which is lower than the threshold of 4 dB), and PHY state should be
640 // CCA_BUSY since it should detect the start of a valid OFDM transmission at a receive level
641 // greater than or equal to the minimum modulation and coding rate sensitivity (–82 dBm for 20
642 // MHz channel spacing).
643
644 Simulator::Schedule(Seconds(8.0),
645 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
646 this,
647 rxPowerDbm,
648 1000,
649 7);
650 Simulator::Schedule(Seconds(8.0) + MicroSeconds(2.0),
651 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
652 this,
653 rxPowerDbm - 3,
654 1000,
655 7);
656 // At 4us, STA PHY STATE should stay IDLE
657 Simulator::Schedule(Seconds(8.0) + MicroSeconds(4.0),
658 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
659 this,
660 WifiPhyState::CCA_BUSY);
661 // No more packet should have been successfully received, and since preamble detection did not
662 // pass the packet should not have been counted as a failure
663 Simulator::Schedule(Seconds(8.1),
664 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount,
665 this,
666 2,
667 1);
668
669 // CASE 9: send two packets with second one 6 dB weaker within the 4us window and check PHY
670 // state: PHY preamble detection should succeed because SNR is high enough (around 6 dB, which
671 // is higher than the threshold of 4 dB), but payload reception should fail (SNR too low to
672 // decode the modulation).
673
674 Simulator::Schedule(Seconds(9.0),
675 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
676 this,
677 rxPowerDbm,
678 1000,
679 7);
680 Simulator::Schedule(Seconds(9.0) + MicroSeconds(2.0),
681 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
682 this,
683 rxPowerDbm - 6,
684 1000,
685 7);
686 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
687 // CCA_BUSY
688 Simulator::Schedule(Seconds(9.0) + NanoSeconds(3999),
689 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
690 this,
691 WifiPhyState::IDLE);
692 Simulator::Schedule(Seconds(9.0) + NanoSeconds(4000),
693 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
694 this,
695 WifiPhyState::CCA_BUSY);
696 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
697 // CCA_BUSY to RX
698 Simulator::Schedule(Seconds(9.0) + NanoSeconds(43999),
699 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
700 this,
701 WifiPhyState::CCA_BUSY);
702 Simulator::Schedule(Seconds(9.0) + NanoSeconds(44000),
703 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
704 this,
705 WifiPhyState::RX);
706 // Since it takes 152.8us to transmit the packet, PHY should be back to CCA_BUSY at time
707 // 152.8us.
708 Simulator::Schedule(Seconds(9.0) + NanoSeconds(152799),
709 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
710 this,
711 WifiPhyState::RX);
712 Simulator::Schedule(Seconds(9.0) + NanoSeconds(152800),
713 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
714 this,
715 WifiPhyState::CCA_BUSY);
716 // In this case, the first packet should be marked as a failure
717 Simulator::Schedule(Seconds(9.1),
718 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount,
719 this,
720 2,
721 2);
722
723 // CASE 10: send two packets with second one 3 dB higher within the 4us window and check PHY
724 // state: PHY preamble detection should fail because SNR is too low (around -3 dB, which is
725 // lower than the threshold of 4 dB), and PHY state should stay IDLE since the total energy is
726 // below CCA-ED (-62 dBm).
727
728 Simulator::Schedule(Seconds(10.0),
729 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
730 this,
731 rxPowerDbm,
732 1000,
733 7);
734 Simulator::Schedule(Seconds(10.0) + MicroSeconds(2.0),
735 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
736 this,
737 rxPowerDbm + 3,
738 1000,
739 7);
740 // At 4us, STA PHY STATE should stay IDLE
741 Simulator::Schedule(Seconds(10.0) + MicroSeconds(4.0),
742 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
743 this,
744 WifiPhyState::IDLE);
745 // No more packet should have been successfully received, and since preamble detection did not
746 // pass the packet should not have been counted as a failure
747 Simulator::Schedule(Seconds(10.1),
748 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount,
749 this,
750 2,
751 2);
752
753 // CASE 11: send one packet with a power slightly above the minimum RSSI needed for the preamble
754 // detection (-82 dBm) and check PHY state: preamble detection should succeed and PHY state
755 // should move to RX.
756
757 rxPowerDbm = -81;
758
759 Simulator::Schedule(Seconds(11.0),
760 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
761 this,
762 rxPowerDbm,
763 1000,
764 7);
765 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
766 // CCA_BUSY
767 Simulator::Schedule(Seconds(11.0) + NanoSeconds(3999),
768 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
769 this,
770 WifiPhyState::IDLE);
771 Simulator::Schedule(Seconds(11.0) + NanoSeconds(4000),
772 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
773 this,
774 WifiPhyState::CCA_BUSY);
775 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
776 // CCA_BUSY to RX
777 Simulator::Schedule(Seconds(11.0) + NanoSeconds(43999),
778 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
779 this,
780 WifiPhyState::CCA_BUSY);
781 Simulator::Schedule(Seconds(11.0) + NanoSeconds(44000),
782 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
783 this,
784 WifiPhyState::RX);
785 // Since it takes 152.8us to transmit the packet, PHY should be back to IDLE at time 152.8us.
786 Simulator::Schedule(Seconds(11.0) + NanoSeconds(152799),
787 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
788 this,
789 WifiPhyState::RX);
790 Simulator::Schedule(Seconds(11.0) + NanoSeconds(152800),
791 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
792 this,
793 WifiPhyState::IDLE);
794
795 // RX power < CCA-PD < CCA-ED
796 rxPowerDbm = -83;
797
798 // CASE 12: send one packet with a power slightly below the minimum RSSI needed for the preamble
799 // detection (-82 dBm) and check PHY state: preamble detection should fail and PHY should be
800 // kept in IDLE state.
801
802 Simulator::Schedule(Seconds(12.0),
803 &TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket,
804 this,
805 rxPowerDbm,
806 1000,
807 7);
808 // At 4us, STA PHY state should be IDLE
809 Simulator::Schedule(Seconds(12.0) + MicroSeconds(4.0),
810 &TestThresholdPreambleDetectionWithoutFrameCapture::CheckPhyState,
811 this,
812 WifiPhyState::IDLE);
813
814 Simulator::Run();
815 Simulator::Destroy();
816}
817
824class TestThresholdPreambleDetectionWithFrameCapture : public WifiPhyReceptionTest
825{
826 public:
827 TestThresholdPreambleDetectionWithFrameCapture();
828
829 protected:
830 void DoSetup() override;
831
839 void RxSuccess(Ptr<const WifiPsdu> psdu,
840 RxSignalInfo rxSignalInfo,
841 WifiTxVector txVector,
842 std::vector<bool> statusPerMpdu);
847 void RxFailure(Ptr<const WifiPsdu> psdu);
848 uint32_t m_countRxSuccess{0};
849 uint32_t m_countRxFailure{0};
850
851 private:
852 void DoRun() override;
853
859 void CheckRxPacketCount(uint32_t expectedSuccessCount, uint32_t expectedFailureCount);
860};
861
862TestThresholdPreambleDetectionWithFrameCapture::TestThresholdPreambleDetectionWithFrameCapture()
863 : WifiPhyReceptionTest(
864 "Threshold preamble detection model test when simple frame capture model is applied")
865{
866}
867
868void
869TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount(uint32_t expectedSuccessCount,
870 uint32_t expectedFailureCount)
871{
872 NS_TEST_ASSERT_MSG_EQ(m_countRxSuccess,
873 expectedSuccessCount,
874 "Didn't receive right number of successful packets");
875 NS_TEST_ASSERT_MSG_EQ(m_countRxFailure,
876 expectedFailureCount,
877 "Didn't receive right number of unsuccessful packets");
878}
879
880void
881TestThresholdPreambleDetectionWithFrameCapture::RxSuccess(Ptr<const WifiPsdu> psdu,
882 RxSignalInfo rxSignalInfo,
883 WifiTxVector txVector,
884 std::vector<bool> statusPerMpdu)
885{
886 NS_LOG_FUNCTION(this << *psdu << txVector);
887 m_countRxSuccess++;
888}
889
890void
891TestThresholdPreambleDetectionWithFrameCapture::RxFailure(Ptr<const WifiPsdu> psdu)
892{
893 NS_LOG_FUNCTION(this << *psdu);
894 m_countRxFailure++;
895}
896
897void
898TestThresholdPreambleDetectionWithFrameCapture::DoSetup()
899{
900 WifiPhyReceptionTest::DoSetup();
901
902 m_phy->SetReceiveOkCallback(
903 MakeCallback(&TestThresholdPreambleDetectionWithFrameCapture::RxSuccess, this));
904 m_phy->SetReceiveErrorCallback(
905 MakeCallback(&TestThresholdPreambleDetectionWithFrameCapture::RxFailure, this));
906
907 Ptr<ThresholdPreambleDetectionModel> preambleDetectionModel =
908 CreateObject<ThresholdPreambleDetectionModel>();
909 preambleDetectionModel->SetAttribute("Threshold", DoubleValue(4));
910 preambleDetectionModel->SetAttribute("MinimumRssi", DoubleValue(-82));
911 m_phy->SetPreambleDetectionModel(preambleDetectionModel);
912
913 Ptr<SimpleFrameCaptureModel> frameCaptureModel = CreateObject<SimpleFrameCaptureModel>();
914 frameCaptureModel->SetAttribute("Margin", DoubleValue(5));
915 frameCaptureModel->SetAttribute("CaptureWindow", TimeValue(MicroSeconds(16)));
916 m_phy->SetFrameCaptureModel(frameCaptureModel);
917}
918
919void
920TestThresholdPreambleDetectionWithFrameCapture::DoRun()
921{
922 RngSeedManager::SetSeed(1);
923 RngSeedManager::SetRun(1);
924 int64_t streamNumber = 1;
925 m_phy->AssignStreams(streamNumber);
926
927 // RX power > CCA-ED > CCA-PD
928 double rxPowerDbm = -50;
929
930 // CASE 1: send one packet and check PHY state:
931 // All reception stages should succeed and PHY state should be RX for the duration of the packet
932 // minus the time to detect the preamble, otherwise it should be IDLE.
933
934 Simulator::Schedule(Seconds(1.0),
935 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
936 this,
937 rxPowerDbm,
938 1000,
939 7);
940 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
941 // CCA_BUSY
942 Simulator::Schedule(Seconds(1.0) + NanoSeconds(3999),
943 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
944 this,
945 WifiPhyState::IDLE);
946 Simulator::Schedule(Seconds(1.0) + NanoSeconds(4000),
947 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
948 this,
949 WifiPhyState::CCA_BUSY);
950 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
951 // CCA_BUSY to RX
952 Simulator::Schedule(Seconds(1.0) + NanoSeconds(43999),
953 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
954 this,
955 WifiPhyState::CCA_BUSY);
956 Simulator::Schedule(Seconds(1.0) + NanoSeconds(44000),
957 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
958 this,
959 WifiPhyState::RX);
960 // Since it takes 152.8us to transmit the packet, PHY should be back to IDLE at time 152.8us
961 Simulator::Schedule(Seconds(1.0) + NanoSeconds(152799),
962 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
963 this,
964 WifiPhyState::RX);
965 Simulator::Schedule(Seconds(1.0) + NanoSeconds(152800),
966 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
967 this,
968 WifiPhyState::IDLE);
969 // Packet should have been successfully received
970 Simulator::Schedule(Seconds(1.1),
971 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
972 this,
973 1,
974 0);
975
976 // CASE 2: send two packets with same power within the 4us window and check PHY state:
977 // PHY preamble detection should fail because SNR is too low (around 0 dB, which is lower than
978 // the threshold of 4 dB), and PHY state should be CCA_BUSY since the total energy is above
979 // CCA-ED (-62 dBm). CCA_BUSY state should last for the duration of the two packets minus the
980 // time to detect the preamble.
981
982 Simulator::Schedule(Seconds(2.0),
983 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
984 this,
985 rxPowerDbm,
986 1000,
987 7);
988 Simulator::Schedule(Seconds(2.0) + MicroSeconds(2.0),
989 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
990 this,
991 rxPowerDbm,
992 1000,
993 7);
994 // At 4us, no preamble is successfully detected, hence STA PHY STATE should move from IDLE to
995 // CCA_BUSY
996 Simulator::Schedule(Seconds(2.0) + NanoSeconds(3999),
997 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
998 this,
999 WifiPhyState::IDLE);
1000 Simulator::Schedule(Seconds(2.0) + NanoSeconds(4000),
1001 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1002 this,
1003 WifiPhyState::CCA_BUSY);
1004 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 + 2
1005 // = 154.8us
1006 Simulator::Schedule(Seconds(2.0) + NanoSeconds(154799),
1007 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1008 this,
1009 WifiPhyState::CCA_BUSY);
1010 Simulator::Schedule(Seconds(2.0) + NanoSeconds(154800),
1011 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1012 this,
1013 WifiPhyState::IDLE);
1014 // No more packet should have been successfully received, and since preamble detection did not
1015 // pass the packet should not have been counted as a failure
1016 Simulator::Schedule(Seconds(2.1),
1017 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1018 this,
1019 1,
1020 0);
1021
1022 // CASE 3: send two packets with second one 3 dB weaker within the 4us window and check PHY
1023 // state: PHY preamble detection should fail because SNR is too low (around 3 dB, which is lower
1024 // than the threshold of 4 dB), and PHY state should be CCA_BUSY since the total energy is above
1025 // CCA-ED (-62 dBm). CCA_BUSY state should last for the duration of the two packets minus the
1026 // time to detect the preamble.
1027
1028 Simulator::Schedule(Seconds(3.0),
1029 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1030 this,
1031 rxPowerDbm,
1032 1000,
1033 7);
1034 Simulator::Schedule(Seconds(3.0) + MicroSeconds(2.0),
1035 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1036 this,
1037 rxPowerDbm - 3,
1038 1000,
1039 7);
1040 // At 4us, no preamble is successfully detected, hence STA PHY STATE should move from IDLE to
1041 // CCA_BUSY
1042 Simulator::Schedule(Seconds(3.0) + NanoSeconds(3999),
1043 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1044 this,
1045 WifiPhyState::IDLE);
1046 Simulator::Schedule(Seconds(3.0) + NanoSeconds(4000),
1047 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1048 this,
1049 WifiPhyState::CCA_BUSY);
1050 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 + 2
1051 // = 154.8us
1052 Simulator::Schedule(Seconds(3.0) + NanoSeconds(154799),
1053 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1054 this,
1055 WifiPhyState::CCA_BUSY);
1056 Simulator::Schedule(Seconds(3.0) + NanoSeconds(154800),
1057 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1058 this,
1059 WifiPhyState::IDLE);
1060 // No more packet should have been successfully received, and since preamble detection did not
1061 // pass the packet should not have been counted as a failure
1062 Simulator::Schedule(Seconds(3.1),
1063 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1064 this,
1065 1,
1066 0);
1067
1068 // CASE 4: send two packets with second one 6 dB weaker within the 4us window and check PHY
1069 // state: PHY preamble detection should succeed because SNR is high enough (around 6 dB, which
1070 // is higher than the threshold of 4 dB), but payload reception should fail (SNR too low to
1071 // decode the modulation).
1072
1073 Simulator::Schedule(Seconds(4.0),
1074 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1075 this,
1076 rxPowerDbm,
1077 1000,
1078 7);
1079 Simulator::Schedule(Seconds(4.0) + MicroSeconds(2.0),
1080 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1081 this,
1082 rxPowerDbm - 6,
1083 1000,
1084 7);
1085 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
1086 // CCA_BUSY
1087 Simulator::Schedule(Seconds(4.0) + NanoSeconds(3999),
1088 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1089 this,
1090 WifiPhyState::IDLE);
1091 Simulator::Schedule(Seconds(4.0) + NanoSeconds(4000),
1092 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1093 this,
1094 WifiPhyState::CCA_BUSY);
1095 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
1096 // CCA_BUSY to RX
1097 Simulator::Schedule(Seconds(4.0) + NanoSeconds(43999),
1098 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1099 this,
1100 WifiPhyState::CCA_BUSY);
1101 Simulator::Schedule(Seconds(4.0) + NanoSeconds(44000),
1102 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1103 this,
1104 WifiPhyState::RX);
1105 // Since it takes 152.8us to transmit the packet, PHY should be back to IDLE at time 152.8us.
1106 // However, since there is a second packet transmitted with a power above CCA-ED (-62 dBm), PHY
1107 // should first be seen as CCA_BUSY for 2us.
1108 Simulator::Schedule(Seconds(4.0) + NanoSeconds(152799),
1109 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1110 this,
1111 WifiPhyState::RX);
1112 Simulator::Schedule(Seconds(4.0) + NanoSeconds(152800),
1113 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1114 this,
1115 WifiPhyState::CCA_BUSY);
1116 Simulator::Schedule(Seconds(4.0) + NanoSeconds(154799),
1117 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1118 this,
1119 WifiPhyState::CCA_BUSY);
1120 Simulator::Schedule(Seconds(4.0) + NanoSeconds(154800),
1121 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1122 this,
1123 WifiPhyState::IDLE);
1124 // In this case, the first packet should be marked as a failure
1125 Simulator::Schedule(Seconds(4.1),
1126 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1127 this,
1128 1,
1129 1);
1130
1131 // CASE 5: send two packets with second one 3 dB higher within the 4us window and check PHY
1132 // state: PHY preamble detection should switch because a higher packet is received within the
1133 // 4us window, but preamble detection should fail because SNR is too low (around 3 dB, which is
1134 // lower than the threshold of 4 dB), PHY state should be CCA_BUSY since the total energy is
1135 // above CCA-ED (-62 dBm).
1136
1137 Simulator::Schedule(Seconds(5.0),
1138 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1139 this,
1140 rxPowerDbm,
1141 1000,
1142 7);
1143 Simulator::Schedule(Seconds(5.0) + MicroSeconds(2.0),
1144 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1145 this,
1146 rxPowerDbm + 3,
1147 1000,
1148 7);
1149 // At 4us, STA PHY STATE should stay IDLE
1150 Simulator::Schedule(Seconds(5.0) + MicroSeconds(4.0),
1151 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1152 this,
1153 WifiPhyState::IDLE);
1154 // At 6us, STA PHY STATE should move from IDLE to CCA_BUSY
1155 Simulator::Schedule(Seconds(5.0) + NanoSeconds(5999),
1156 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1157 this,
1158 WifiPhyState::IDLE);
1159 Simulator::Schedule(Seconds(5.0) + NanoSeconds(6000),
1160 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1161 this,
1162 WifiPhyState::CCA_BUSY);
1163 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 + 2
1164 // = 154.8us
1165 Simulator::Schedule(Seconds(5.0) + NanoSeconds(154799),
1166 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1167 this,
1168 WifiPhyState::CCA_BUSY);
1169 Simulator::Schedule(Seconds(5.0) + NanoSeconds(154800),
1170 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1171 this,
1172 WifiPhyState::IDLE);
1173 // No more packet should have been successfully received, and since preamble detection did not
1174 // pass the packet should not have been counted as a failure
1175 Simulator::Schedule(Seconds(5.1),
1176 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1177 this,
1178 1,
1179 1);
1180
1181 // CASE 6: send two packets with second one 6 dB higher within the 4us window and check PHY
1182 // state: PHY preamble detection should switch because a higher packet is received within the
1183 // 4us window, and preamble detection should succeed because SNR is high enough (around 6 dB,
1184 // which is higher than the threshold of 4 dB), Payload reception should fail (SNR too low to
1185 // decode the modulation).
1186
1187 Simulator::Schedule(Seconds(6.0),
1188 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1189 this,
1190 rxPowerDbm,
1191 1000,
1192 7);
1193 Simulator::Schedule(Seconds(6.0) + MicroSeconds(2.0),
1194 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1195 this,
1196 rxPowerDbm + 6,
1197 1000,
1198 7);
1199 // At 4us, STA PHY STATE should stay IDLE
1200 Simulator::Schedule(Seconds(6.0) + MicroSeconds(4.0),
1201 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1202 this,
1203 WifiPhyState::IDLE);
1204 // At 6us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
1205 // CCA_BUSY
1206 Simulator::Schedule(Seconds(6.0) + NanoSeconds(5999),
1207 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1208 this,
1209 WifiPhyState::IDLE);
1210 Simulator::Schedule(Seconds(6.0) + NanoSeconds(6000),
1211 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1212 this,
1213 WifiPhyState::CCA_BUSY);
1214 // At 46us, PHY header should be successfully received and STA PHY STATE should move from
1215 // CCA_BUSY to RX
1216 Simulator::Schedule(Seconds(6.0) + NanoSeconds(45999),
1217 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1218 this,
1219 WifiPhyState::CCA_BUSY);
1220 Simulator::Schedule(Seconds(6.0) + NanoSeconds(46000),
1221 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1222 this,
1223 WifiPhyState::RX);
1224 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 + 2
1225 // = 154.8us
1226 Simulator::Schedule(Seconds(6.0) + NanoSeconds(154799),
1227 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1228 this,
1229 WifiPhyState::RX);
1230 Simulator::Schedule(Seconds(6.0) + NanoSeconds(154800),
1231 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1232 this,
1233 WifiPhyState::IDLE);
1234 // In this case, the second packet should be marked as a failure
1235 Simulator::Schedule(Seconds(6.1),
1236 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1237 this,
1238 1,
1239 2);
1240
1241 // CASE 7: send two packets with same power at the exact same time and check PHY state:
1242 // PHY preamble detection should fail because SNR is too low (around 0 dB, which is lower than
1243 // the threshold of 4 dB), and PHY state should be CCA_BUSY since the total energy is above
1244 // CCA-ED (-62 dBm). CCA_BUSY state should last for the duration of the two packets minus the
1245 // time to detect the preamble.
1246
1247 Simulator::Schedule(Seconds(7.0),
1248 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1249 this,
1250 rxPowerDbm,
1251 1000,
1252 7);
1253 Simulator::Schedule(Seconds(7.0),
1254 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1255 this,
1256 rxPowerDbm,
1257 1000,
1258 7);
1259 // At 4us, no preamble is successfully detected, hence STA PHY STATE should move from IDLE to
1260 // CCA_BUSY
1261 Simulator::Schedule(Seconds(7.0) + NanoSeconds(3999),
1262 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1263 this,
1264 WifiPhyState::IDLE);
1265 Simulator::Schedule(Seconds(7.0) + NanoSeconds(4000),
1266 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1267 this,
1268 WifiPhyState::CCA_BUSY);
1269 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 + 2
1270 // = 154.8us
1271 Simulator::Schedule(Seconds(7.0) + NanoSeconds(152799),
1272 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1273 this,
1274 WifiPhyState::CCA_BUSY);
1275 Simulator::Schedule(Seconds(7.0) + NanoSeconds(152800),
1276 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1277 this,
1278 WifiPhyState::IDLE);
1279 // No more packet should have been successfully received, and since preamble detection did not
1280 // pass the packet should not have been counted as a failure
1281 Simulator::Schedule(Seconds(7.1),
1282 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1283 this,
1284 1,
1285 2);
1286
1287 // CASE 8: send two packets with second one 3 dB weaker at the exact same time and check PHY
1288 // state: PHY preamble detection should fail because SNR is too low (around 3 dB, which is lower
1289 // than the threshold of 4 dB), and PHY state should be CCA_BUSY since the total energy is above
1290 // CCA-ED (-62 dBm). CCA_BUSY state should last for the duration of the two packets minus the
1291 // time to detect the preamble.
1292
1293 Simulator::Schedule(Seconds(8.0),
1294 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1295 this,
1296 rxPowerDbm,
1297 1000,
1298 7);
1299 Simulator::Schedule(Seconds(8.0),
1300 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1301 this,
1302 rxPowerDbm - 3,
1303 1000,
1304 7);
1305 // At 4us, no preamble is successfully detected, hence STA PHY STATE should move from IDLE to
1306 // CCA_BUSY
1307 Simulator::Schedule(Seconds(8.0) + NanoSeconds(3999),
1308 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1309 this,
1310 WifiPhyState::IDLE);
1311 Simulator::Schedule(Seconds(8.0) + NanoSeconds(4000),
1312 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1313 this,
1314 WifiPhyState::CCA_BUSY);
1315 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 us
1316 Simulator::Schedule(Seconds(8.0) + NanoSeconds(152799),
1317 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1318 this,
1319 WifiPhyState::CCA_BUSY);
1320 Simulator::Schedule(Seconds(8.0) + NanoSeconds(152800),
1321 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1322 this,
1323 WifiPhyState::IDLE);
1324 // No more packet should have been successfully received, and since preamble detection did not
1325 // pass the packet should not have been counted as a failure
1326 Simulator::Schedule(Seconds(8.1),
1327 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1328 this,
1329 1,
1330 2);
1331
1332 // CASE 9: send two packets with second one 6 dB weaker at the exact same time and check PHY
1333 // state: PHY preamble detection should succeed because SNR is high enough (around 6 dB, which
1334 // is higher than the threshold of 4 dB), but payload reception should fail (SNR too low to
1335 // decode the modulation).
1336
1337 Simulator::Schedule(Seconds(9.0),
1338 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1339 this,
1340 rxPowerDbm,
1341 1000,
1342 7);
1343 Simulator::Schedule(Seconds(9.0),
1344 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1345 this,
1346 rxPowerDbm - 6,
1347 1000,
1348 7);
1349 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
1350 // CCA_BUSY
1351 Simulator::Schedule(Seconds(9.0) + NanoSeconds(3999),
1352 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1353 this,
1354 WifiPhyState::IDLE);
1355 Simulator::Schedule(Seconds(9.0) + NanoSeconds(4000),
1356 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1357 this,
1358 WifiPhyState::CCA_BUSY);
1359 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
1360 // CCA_BUSY to RX
1361 Simulator::Schedule(Seconds(9.0) + NanoSeconds(43999),
1362 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1363 this,
1364 WifiPhyState::CCA_BUSY);
1365 Simulator::Schedule(Seconds(9.0) + NanoSeconds(44000),
1366 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1367 this,
1368 WifiPhyState::RX);
1369 // Since it takes 152.8us to transmit the packets, PHY should be back to IDLE at time 152.8us.
1370 Simulator::Schedule(Seconds(9.0) + NanoSeconds(152799),
1371 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1372 this,
1373 WifiPhyState::RX);
1374 Simulator::Schedule(Seconds(9.0) + NanoSeconds(152800),
1375 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1376 this,
1377 WifiPhyState::IDLE);
1378 // In this case, the first packet should be marked as a failure
1379 Simulator::Schedule(Seconds(9.1),
1380 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1381 this,
1382 1,
1383 3);
1384
1385 // CASE 10: send two packets with second one 3 dB higher at the exact same time and check PHY
1386 // state: PHY preamble detection should switch because a higher packet is received within the
1387 // 4us window, but preamble detection should fail because SNR is too low (around 3 dB, which is
1388 // lower than the threshold of 4 dB), PHY state should be CCA_BUSY since the total energy is
1389 // above CCA-ED (-62 dBm).
1390
1391 Simulator::Schedule(Seconds(10.0),
1392 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1393 this,
1394 rxPowerDbm,
1395 1000,
1396 7);
1397 Simulator::Schedule(Seconds(10.0),
1398 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1399 this,
1400 rxPowerDbm + 3,
1401 1000,
1402 7);
1403 // At 4us, no preamble is successfully detected, hence STA PHY STATE should move from IDLE to
1404 // CCA_BUSY
1405 Simulator::Schedule(Seconds(10.0) + NanoSeconds(3999),
1406 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1407 this,
1408 WifiPhyState::IDLE);
1409 Simulator::Schedule(Seconds(10.0) + NanoSeconds(4000),
1410 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1411 this,
1412 WifiPhyState::CCA_BUSY);
1413 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 us
1414 Simulator::Schedule(Seconds(10.0) + NanoSeconds(152799),
1415 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1416 this,
1417 WifiPhyState::CCA_BUSY);
1418 Simulator::Schedule(Seconds(10.0) + NanoSeconds(152800),
1419 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1420 this,
1421 WifiPhyState::IDLE);
1422 // No more packet should have been successfully received, and since preamble detection did not
1423 // pass the packet should not have been counted as a failure
1424 Simulator::Schedule(Seconds(10.1),
1425 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1426 this,
1427 1,
1428 3);
1429
1430 // CASE 11: send two packets with second one 6 dB higher at the exact same time and check PHY
1431 // state: PHY preamble detection should switch because a higher packet is received within the
1432 // 4us window, and preamble detection should succeed because SNR is high enough (around 6 dB,
1433 // which is higher than the threshold of 4 dB), Payload reception should fail (SNR too low to
1434 // decode the modulation).
1435
1436 Simulator::Schedule(Seconds(11.0),
1437 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1438 this,
1439 rxPowerDbm,
1440 1000,
1441 7);
1442 Simulator::Schedule(Seconds(11.0),
1443 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1444 this,
1445 rxPowerDbm + 6,
1446 1000,
1447 7);
1448 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
1449 // CCA_BUSY
1450 Simulator::Schedule(Seconds(11.0) + NanoSeconds(3999),
1451 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1452 this,
1453 WifiPhyState::IDLE);
1454 Simulator::Schedule(Seconds(11.0) + NanoSeconds(4000),
1455 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1456 this,
1457 WifiPhyState::CCA_BUSY);
1458 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
1459 // CCA_BUSY to RX
1460 Simulator::Schedule(Seconds(11.0) + NanoSeconds(43999),
1461 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1462 this,
1463 WifiPhyState::CCA_BUSY);
1464 Simulator::Schedule(Seconds(11.0) + NanoSeconds(44000),
1465 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1466 this,
1467 WifiPhyState::RX);
1468 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 us
1469 Simulator::Schedule(Seconds(11.0) + NanoSeconds(152799),
1470 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1471 this,
1472 WifiPhyState::RX);
1473 Simulator::Schedule(Seconds(11.0) + NanoSeconds(152800),
1474 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1475 this,
1476 WifiPhyState::IDLE);
1477 // In this case, the second packet should be marked as a failure
1478 Simulator::Schedule(Seconds(11.1),
1479 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1480 this,
1481 1,
1482 4);
1483
1484 // CCA-PD < RX power < CCA-ED
1485 rxPowerDbm = -70;
1486
1487 // CASE 12: send one packet and check PHY state:
1488 // All reception stages should succeed and PHY state should be RX for the duration of the packet
1489 // minus the time to detect the preamble, otherwise it should be IDLE.
1490
1491 Simulator::Schedule(Seconds(12.0),
1492 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1493 this,
1494 rxPowerDbm,
1495 1000,
1496 7);
1497 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
1498 // CCA_BUSY
1499 Simulator::Schedule(Seconds(12.0) + NanoSeconds(3999),
1500 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1501 this,
1502 WifiPhyState::IDLE);
1503 Simulator::Schedule(Seconds(12.0) + NanoSeconds(4000),
1504 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1505 this,
1506 WifiPhyState::CCA_BUSY);
1507 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
1508 // CCA_BUSY to RX
1509 Simulator::Schedule(Seconds(12.0) + NanoSeconds(43999),
1510 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1511 this,
1512 WifiPhyState::CCA_BUSY);
1513 Simulator::Schedule(Seconds(12.0) + NanoSeconds(44000),
1514 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1515 this,
1516 WifiPhyState::RX);
1517 // Since it takes 152.8us to transmit the packet, PHY should be back to IDLE at time 152.8us
1518 Simulator::Schedule(Seconds(12.0) + NanoSeconds(152799),
1519 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1520 this,
1521 WifiPhyState::RX);
1522 Simulator::Schedule(Seconds(12.0) + NanoSeconds(152800),
1523 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1524 this,
1525 WifiPhyState::IDLE);
1526 // Packet should have been successfully received
1527 Simulator::Schedule(Seconds(12.1),
1528 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1529 this,
1530 2,
1531 4);
1532
1533 // CASE 13: send two packets with same power within the 4us window and check PHY state:
1534 // PHY preamble detection should fail because SNR is too low (around 0 dB, which is lower than
1535 // the threshold of 4 dB), and PHY state should be CCA_BUSY since it should detect the start of
1536 // a valid OFDM transmission at a receive level greater than or equal to the minimum modulation
1537 // and coding rate sensitivity (–82 dBm for 20 MHz channel spacing).
1538
1539 Simulator::Schedule(Seconds(13.0),
1540 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1541 this,
1542 rxPowerDbm,
1543 1000,
1544 7);
1545 Simulator::Schedule(Seconds(13.0) + MicroSeconds(2.0),
1546 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1547 this,
1548 rxPowerDbm,
1549 1000,
1550 7);
1551 // At 4us, STA PHY STATE should stay IDLE
1552 Simulator::Schedule(Seconds(13.0) + MicroSeconds(4.0),
1553 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1554 this,
1555 WifiPhyState::CCA_BUSY);
1556 // No more packet should have been successfully received, and since preamble detection did not
1557 // pass the packet should not have been counted as a failure
1558 Simulator::Schedule(Seconds(13.1),
1559 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1560 this,
1561 2,
1562 4);
1563
1564 // CASE 14: send two packets with second one 3 dB weaker within the 4us window and check PHY
1565 // state: PHY preamble detection should fail PHY preamble detection should fail because SNR is
1566 // too low (around 3 dB, which is lower than the threshold of 4 dB), and PHY state should be
1567 // CCA_BUSY since it should detect the start of a valid OFDM transmission at a receive level
1568 // greater than or equal to the minimum modulation and coding rate sensitivity (–82 dBm for 20
1569 // MHz channel spacing).
1570
1571 Simulator::Schedule(Seconds(14.0),
1572 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1573 this,
1574 rxPowerDbm,
1575 1000,
1576 7);
1577 Simulator::Schedule(Seconds(14.0) + MicroSeconds(2.0),
1578 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1579 this,
1580 rxPowerDbm - 3,
1581 1000,
1582 7);
1583 // At 4us, STA PHY STATE should stay IDLE
1584 Simulator::Schedule(Seconds(14.0) + MicroSeconds(4.0),
1585 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1586 this,
1587 WifiPhyState::CCA_BUSY);
1588 // No more packet should have been successfully received, and since preamble detection did not
1589 // pass the packet should not have been counted as a failure
1590 Simulator::Schedule(Seconds(14.1),
1591 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1592 this,
1593 2,
1594 4);
1595
1596 // CASE 15: send two packets with second one 6 dB weaker within the 4us window and check PHY
1597 // state: PHY preamble detection should succeed because SNR is high enough (around 6 dB, which
1598 // is higher than the threshold of 4 dB), but payload reception should fail (SNR too low to
1599 // decode the modulation).
1600
1601 Simulator::Schedule(Seconds(15.0),
1602 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1603 this,
1604 rxPowerDbm,
1605 1000,
1606 7);
1607 Simulator::Schedule(Seconds(15.0) + MicroSeconds(2.0),
1608 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1609 this,
1610 rxPowerDbm - 6,
1611 1000,
1612 7);
1613 // At 4us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
1614 // CCA_BUSY
1615 Simulator::Schedule(Seconds(15.0) + NanoSeconds(3999),
1616 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1617 this,
1618 WifiPhyState::IDLE);
1619 Simulator::Schedule(Seconds(15.0) + NanoSeconds(4000),
1620 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1621 this,
1622 WifiPhyState::CCA_BUSY);
1623 // At 44us, PHY header should be successfully received and STA PHY STATE should move from
1624 // CCA_BUSY to RX
1625 Simulator::Schedule(Seconds(15.0) + NanoSeconds(43999),
1626 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1627 this,
1628 WifiPhyState::CCA_BUSY);
1629 Simulator::Schedule(Seconds(15.0) + NanoSeconds(44000),
1630 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1631 this,
1632 WifiPhyState::RX);
1633 // Since it takes 152.8us to transmit the packet, PHY should be back to CCA_BUSY at time
1634 // 152.8us.
1635 Simulator::Schedule(Seconds(15.0) + NanoSeconds(152799),
1636 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1637 this,
1638 WifiPhyState::RX);
1639 Simulator::Schedule(Seconds(15.0) + NanoSeconds(152800),
1640 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1641 this,
1642 WifiPhyState::CCA_BUSY);
1643 // In this case, the first packet should be marked as a failure
1644 Simulator::Schedule(Seconds(15.1),
1645 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1646 this,
1647 2,
1648 5);
1649
1650 // CASE 16: send two packets with second one 3 dB higher within the 4us window and check PHY
1651 // state: PHY preamble detection should switch because a higher packet is received within the
1652 // 4us window, but preamble detection should fail because SNR is too low (around 3 dB, which is
1653 // lower than the threshold of 4 dB). and PHY state should be CCA_BUSY since it should detect
1654 // the start of a valid OFDM transmission at a receive level greater than or equal to the
1655 // minimum modulation and coding rate sensitivity (–82 dBm for 20 MHz channel spacing).
1656
1657 Simulator::Schedule(Seconds(16.0),
1658 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1659 this,
1660 rxPowerDbm,
1661 1000,
1662 7);
1663 Simulator::Schedule(Seconds(16.0) + MicroSeconds(2.0),
1664 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1665 this,
1666 rxPowerDbm + 3,
1667 1000,
1668 7);
1669 // At 4us, STA PHY STATE should stay IDLE
1670 Simulator::Schedule(Seconds(16.0) + MicroSeconds(4.0),
1671 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1672 this,
1673 WifiPhyState::IDLE);
1674 // At 6us, STA PHY STATE should be CCA_BUSY
1675 Simulator::Schedule(Seconds(16.0) + MicroSeconds(6.0),
1676 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1677 this,
1678 WifiPhyState::CCA_BUSY);
1679 // No more packet should have been successfully received, and since preamble detection did not
1680 // pass the packet should not have been counted as a failure
1681 Simulator::Schedule(Seconds(16.1),
1682 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1683 this,
1684 2,
1685 5);
1686
1687 // CASE 17: send two packets with second one 6 dB higher within the 4us window and check PHY
1688 // state: PHY preamble detection should switch because a higher packet is received within the
1689 // 4us window, and preamble detection should succeed because SNR is high enough (around 6 dB,
1690 // which is higher than the threshold of 4 dB), Payload reception should fail (SNR too low to
1691 // decode the modulation).
1692
1693 Simulator::Schedule(Seconds(17.0),
1694 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1695 this,
1696 rxPowerDbm,
1697 1000,
1698 7);
1699 Simulator::Schedule(Seconds(17.0) + MicroSeconds(2.0),
1700 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1701 this,
1702 rxPowerDbm + 6,
1703 1000,
1704 7);
1705 // At 4us, STA PHY STATE should stay IDLE
1706 Simulator::Schedule(Seconds(17.0) + MicroSeconds(4.0),
1707 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1708 this,
1709 WifiPhyState::IDLE);
1710 // At 6us, preamble should be successfully detected and STA PHY STATE should move from IDLE to
1711 // CCA_BUSY
1712 Simulator::Schedule(Seconds(17.0) + NanoSeconds(5999),
1713 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1714 this,
1715 WifiPhyState::IDLE);
1716 Simulator::Schedule(Seconds(17.0) + NanoSeconds(6000),
1717 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1718 this,
1719 WifiPhyState::CCA_BUSY);
1720 // At 46us, PHY header should be successfully received and STA PHY STATE should move from
1721 // CCA_BUSY to RX
1722 Simulator::Schedule(Seconds(17.0) + NanoSeconds(45999),
1723 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1724 this,
1725 WifiPhyState::CCA_BUSY);
1726 Simulator::Schedule(Seconds(17.0) + NanoSeconds(46000),
1727 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1728 this,
1729 WifiPhyState::RX);
1730 // Since it takes 152.8us to transmit each packet, PHY should be back to IDLE at time 152.8 + 2
1731 // = 154.8us
1732 Simulator::Schedule(Seconds(17.0) + NanoSeconds(154799),
1733 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1734 this,
1735 WifiPhyState::RX);
1736 Simulator::Schedule(Seconds(17.0) + NanoSeconds(154800),
1737 &TestThresholdPreambleDetectionWithFrameCapture::CheckPhyState,
1738 this,
1739 WifiPhyState::IDLE);
1740 // In this case, the second packet should be marked as a failure
1741 Simulator::Schedule(Seconds(17.1),
1742 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1743 this,
1744 2,
1745 6);
1746
1747 rxPowerDbm = -50;
1748 // CASE 18: send two packets with second one 50 dB higher within the 4us window
1749
1750 Simulator::Schedule(Seconds(18.0),
1751 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1752 this,
1753 rxPowerDbm,
1754 1000,
1755 7);
1756 Simulator::Schedule(Seconds(18.0) + MicroSeconds(2.0),
1757 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1758 this,
1759 rxPowerDbm + 50,
1760 1000,
1761 7);
1762 // The second packet should be received successfully
1763 Simulator::Schedule(Seconds(18.1),
1764 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1765 this,
1766 3,
1767 6);
1768
1769 // CASE 19: send two packets with second one 10 dB higher within the 4us window
1770
1771 Simulator::Schedule(Seconds(19.0),
1772 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1773 this,
1774 rxPowerDbm,
1775 1000,
1776 7);
1777 Simulator::Schedule(Seconds(19.0) + MicroSeconds(2.0),
1778 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1779 this,
1780 rxPowerDbm + 10,
1781 1000,
1782 7);
1783 // The second packet should be captured, but not decoded since SNR to low for used MCS
1784 Simulator::Schedule(Seconds(19.1),
1785 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1786 this,
1787 3,
1788 7);
1789
1790 // CASE 20: send two packets with second one 50 dB higher in the same time
1791
1792 Simulator::Schedule(Seconds(20.0),
1793 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1794 this,
1795 rxPowerDbm,
1796 1000,
1797 7);
1798 Simulator::Schedule(Seconds(20.0),
1799 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1800 this,
1801 rxPowerDbm + 50,
1802 1000,
1803 7);
1804 // The second packet should be received successfully, same as in CASE 13
1805 Simulator::Schedule(Seconds(20.1),
1806 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1807 this,
1808 4,
1809 7);
1810
1811 // CASE 21: send two packets with second one 10 dB higher in the same time
1812
1813 Simulator::Schedule(Seconds(21.0),
1814 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1815 this,
1816 rxPowerDbm,
1817 1000,
1818 7);
1819 Simulator::Schedule(Seconds(21.0),
1820 &TestThresholdPreambleDetectionWithFrameCapture::SendPacket,
1821 this,
1822 rxPowerDbm + 10,
1823 1000,
1824 7);
1825 // The second packet should be captured, but not decoded since SNR to low for used MCS, same as
1826 // in CASE 19
1827 Simulator::Schedule(Seconds(21.1),
1828 &TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount,
1829 this,
1830 4,
1831 8);
1832
1833 Simulator::Run();
1834 Simulator::Destroy();
1835}
1836
1843class TestSimpleFrameCaptureModel : public WifiPhyReceptionTest
1844{
1845 public:
1846 TestSimpleFrameCaptureModel();
1847
1848 private:
1849 void DoSetup() override;
1850 void DoRun() override;
1851
1855 void Reset();
1863 void RxSuccess(Ptr<const WifiPsdu> psdu,
1864 RxSignalInfo rxSignalInfo,
1865 WifiTxVector txVector,
1866 std::vector<bool> statusPerMpdu);
1872 void RxDropped(Ptr<const Packet> p, WifiPhyRxfailureReason reason);
1873
1877 void Expect1000BPacketReceived();
1881 void Expect1500BPacketReceived();
1885 void Expect1000BPacketDropped();
1889 void Expect1500BPacketDropped();
1890
1891 bool m_rxSuccess1000B{false};
1892 bool m_rxSuccess1500B{false};
1893 bool m_rxDropped1000B{false};
1894 bool m_rxDropped1500B{false};
1895};
1896
1897TestSimpleFrameCaptureModel::TestSimpleFrameCaptureModel()
1898 : WifiPhyReceptionTest("Simple frame capture model test")
1899{
1900}
1901
1902void
1903TestSimpleFrameCaptureModel::RxSuccess(Ptr<const WifiPsdu> psdu,
1904 RxSignalInfo rxSignalInfo,
1905 WifiTxVector txVector,
1906 std::vector<bool> statusPerMpdu)
1907{
1908 NS_LOG_FUNCTION(this << *psdu << rxSignalInfo << txVector);
1909 NS_ASSERT(!psdu->IsAggregate() || psdu->IsSingle());
1910 if (psdu->GetSize() == 1030)
1911 {
1912 m_rxSuccess1000B = true;
1913 }
1914 else if (psdu->GetSize() == 1530)
1915 {
1916 m_rxSuccess1500B = true;
1917 }
1918}
1919
1920void
1921TestSimpleFrameCaptureModel::RxDropped(Ptr<const Packet> p, WifiPhyRxfailureReason reason)
1922{
1923 NS_LOG_FUNCTION(this << p << reason);
1924 if (p->GetSize() == 1030)
1925 {
1926 m_rxDropped1000B = true;
1927 }
1928 else if (p->GetSize() == 1530)
1929 {
1930 m_rxDropped1500B = true;
1931 }
1932}
1933
1934void
1935TestSimpleFrameCaptureModel::Reset()
1936{
1937 m_rxSuccess1000B = false;
1938 m_rxSuccess1500B = false;
1939 m_rxDropped1000B = false;
1940 m_rxDropped1500B = false;
1941}
1942
1943void
1944TestSimpleFrameCaptureModel::Expect1000BPacketReceived()
1945{
1946 NS_TEST_ASSERT_MSG_EQ(m_rxSuccess1000B, true, "Didn't receive 1000B packet");
1947}
1948
1949void
1950TestSimpleFrameCaptureModel::Expect1500BPacketReceived()
1951{
1952 NS_TEST_ASSERT_MSG_EQ(m_rxSuccess1500B, true, "Didn't receive 1500B packet");
1953}
1954
1955void
1956TestSimpleFrameCaptureModel::Expect1000BPacketDropped()
1957{
1958 NS_TEST_ASSERT_MSG_EQ(m_rxDropped1000B, true, "Didn't drop 1000B packet");
1959}
1960
1961void
1962TestSimpleFrameCaptureModel::Expect1500BPacketDropped()
1963{
1964 NS_TEST_ASSERT_MSG_EQ(m_rxDropped1500B, true, "Didn't drop 1500B packet");
1965}
1966
1967void
1968TestSimpleFrameCaptureModel::DoSetup()
1969{
1970 WifiPhyReceptionTest::DoSetup();
1971
1972 m_phy->SetReceiveOkCallback(MakeCallback(&TestSimpleFrameCaptureModel::RxSuccess, this));
1973 m_phy->TraceConnectWithoutContext("PhyRxDrop",
1974 MakeCallback(&TestSimpleFrameCaptureModel::RxDropped, this));
1975
1976 Ptr<ThresholdPreambleDetectionModel> preambleDetectionModel =
1977 CreateObject<ThresholdPreambleDetectionModel>();
1978 preambleDetectionModel->SetAttribute("Threshold", DoubleValue(2));
1979 m_phy->SetPreambleDetectionModel(preambleDetectionModel);
1980
1981 Ptr<SimpleFrameCaptureModel> frameCaptureModel = CreateObject<SimpleFrameCaptureModel>();
1982 frameCaptureModel->SetAttribute("Margin", DoubleValue(5));
1983 frameCaptureModel->SetAttribute("CaptureWindow", TimeValue(MicroSeconds(16)));
1984 m_phy->SetFrameCaptureModel(frameCaptureModel);
1985}
1986
1987void
1988TestSimpleFrameCaptureModel::DoRun()
1989{
1990 RngSeedManager::SetSeed(1);
1991 RngSeedManager::SetRun(1);
1992 int64_t streamNumber = 2;
1993 double rxPowerDbm = -30;
1994 m_phy->AssignStreams(streamNumber);
1995
1996 // CASE 1: send two packets with same power within the capture window:
1997 // PHY should not switch reception because they have same power.
1998
1999 Simulator::Schedule(Seconds(1.0),
2000 &TestSimpleFrameCaptureModel::SendPacket,
2001 this,
2002 rxPowerDbm,
2003 1000,
2004 0);
2005 Simulator::Schedule(Seconds(1.0) + MicroSeconds(10.0),
2006 &TestSimpleFrameCaptureModel::SendPacket,
2007 this,
2008 rxPowerDbm,
2009 1500,
2010 0);
2011 Simulator::Schedule(Seconds(1.1), &TestSimpleFrameCaptureModel::Expect1500BPacketDropped, this);
2012 Simulator::Schedule(Seconds(1.2), &TestSimpleFrameCaptureModel::Reset, this);
2013
2014 // CASE 2: send two packets with second one 6 dB weaker within the capture window:
2015 // PHY should not switch reception because first one has higher power.
2016
2017 Simulator::Schedule(Seconds(2.0),
2018 &TestSimpleFrameCaptureModel::SendPacket,
2019 this,
2020 rxPowerDbm,
2021 1000,
2022 0);
2023 Simulator::Schedule(Seconds(2.0) + MicroSeconds(10.0),
2024 &TestSimpleFrameCaptureModel::SendPacket,
2025 this,
2026 rxPowerDbm - 6,
2027 1500,
2028 0);
2029 Simulator::Schedule(Seconds(2.1),
2030 &TestSimpleFrameCaptureModel::Expect1000BPacketReceived,
2031 this);
2032 Simulator::Schedule(Seconds(2.1), &TestSimpleFrameCaptureModel::Expect1500BPacketDropped, this);
2033 Simulator::Schedule(Seconds(2.2), &TestSimpleFrameCaptureModel::Reset, this);
2034
2035 // CASE 3: send two packets with second one 6 dB higher within the capture window:
2036 // PHY should switch reception because the second one has a higher power.
2037
2038 Simulator::Schedule(Seconds(3.0),
2039 &TestSimpleFrameCaptureModel::SendPacket,
2040 this,
2041 rxPowerDbm,
2042 1000,
2043 0);
2044 Simulator::Schedule(Seconds(3.0) + MicroSeconds(10.0),
2045 &TestSimpleFrameCaptureModel::SendPacket,
2046 this,
2047 rxPowerDbm + 6,
2048 1500,
2049 0);
2050 Simulator::Schedule(Seconds(3.1), &TestSimpleFrameCaptureModel::Expect1000BPacketDropped, this);
2051 Simulator::Schedule(Seconds(3.1),
2052 &TestSimpleFrameCaptureModel::Expect1500BPacketReceived,
2053 this);
2054 Simulator::Schedule(Seconds(3.2), &TestSimpleFrameCaptureModel::Reset, this);
2055
2056 // CASE 4: send two packets with second one 6 dB higher after the capture window:
2057 // PHY should not switch reception because capture window duration has elapsed when the second
2058 // packet arrives.
2059
2060 Simulator::Schedule(Seconds(4.0),
2061 &TestSimpleFrameCaptureModel::SendPacket,
2062 this,
2063 rxPowerDbm,
2064 1000,
2065 0);
2066 Simulator::Schedule(Seconds(4.0) + MicroSeconds(25.0),
2067 &TestSimpleFrameCaptureModel::SendPacket,
2068 this,
2069 rxPowerDbm + 6,
2070 1500,
2071 0);
2072 Simulator::Schedule(Seconds(4.1), &TestSimpleFrameCaptureModel::Expect1500BPacketDropped, this);
2073 Simulator::Schedule(Seconds(4.2), &TestSimpleFrameCaptureModel::Reset, this);
2074
2075 Simulator::Run();
2076 Simulator::Destroy();
2077}
2078
2085class TestPhyHeadersReception : public WifiPhyReceptionTest
2086{
2087 public:
2088 TestPhyHeadersReception();
2089
2090 private:
2091 void DoRun() override;
2092};
2093
2094TestPhyHeadersReception::TestPhyHeadersReception()
2095 : WifiPhyReceptionTest("PHY headers reception test")
2096{
2097}
2098
2099void
2100TestPhyHeadersReception::DoRun()
2101{
2102 RngSeedManager::SetSeed(1);
2103 RngSeedManager::SetRun(1);
2104 int64_t streamNumber = 0;
2105 m_phy->AssignStreams(streamNumber);
2106
2107 // RX power > CCA-ED
2108 double rxPowerDbm = -50;
2109
2110 // CASE 1: send one packet followed by a second one with same power between the end of the 4us
2111 // preamble detection window and the start of L-SIG of the first packet: reception should be
2112 // aborted since L-SIG cannot be decoded (SNR too low).
2113
2114 Simulator::Schedule(Seconds(1.0),
2115 &TestPhyHeadersReception::SendPacket,
2116 this,
2117 rxPowerDbm,
2118 1000,
2119 7);
2120 Simulator::Schedule(Seconds(1.0) + MicroSeconds(10),
2121 &TestPhyHeadersReception::SendPacket,
2122 this,
2123 rxPowerDbm,
2124 1000,
2125 7);
2126 // At 10 us, STA PHY STATE should be CCA_BUSY.
2127 Simulator::Schedule(Seconds(1.0) + MicroSeconds(10.0),
2128 &TestPhyHeadersReception::CheckPhyState,
2129 this,
2130 WifiPhyState::CCA_BUSY);
2131 // At 44us (end of PHY header), STA PHY STATE should not have moved to RX and be kept to
2132 // CCA_BUSY.
2133 Simulator::Schedule(Seconds(1.0) + NanoSeconds(44000),
2134 &TestPhyHeadersReception::CheckPhyState,
2135 this,
2136 WifiPhyState::CCA_BUSY);
2137 // Since it takes 152.8us to transmit the packet, PHY should be back to IDLE at time 152.8 + 10
2138 // = 162.8us.
2139 Simulator::Schedule(Seconds(1.0) + NanoSeconds(162799),
2140 &TestPhyHeadersReception::CheckPhyState,
2141 this,
2142 WifiPhyState::CCA_BUSY);
2143 Simulator::Schedule(Seconds(1.0) + NanoSeconds(162800),
2144 &TestPhyHeadersReception::CheckPhyState,
2145 this,
2146 WifiPhyState::IDLE);
2147
2148 // CASE 2: send one packet followed by a second one 3 dB weaker between the end of the 4us
2149 // preamble detection window and the start of L-SIG of the first packet: reception should not be
2150 // aborted since L-SIG can be decoded (SNR high enough).
2151
2152 Simulator::Schedule(Seconds(2.0),
2153 &TestPhyHeadersReception::SendPacket,
2154 this,
2155 rxPowerDbm,
2156 1000,
2157 7);
2158 Simulator::Schedule(Seconds(2.0) + MicroSeconds(10),
2159 &TestPhyHeadersReception::SendPacket,
2160 this,
2161 rxPowerDbm - 3,
2162 1000,
2163 7);
2164 // At 10 us, STA PHY STATE should be CCA_BUSY.
2165 Simulator::Schedule(Seconds(2.0) + MicroSeconds(10.0),
2166 &TestPhyHeadersReception::CheckPhyState,
2167 this,
2168 WifiPhyState::CCA_BUSY);
2169 // At 44us (end of PHY header), STA PHY STATE should have moved to RX since PHY header reception
2170 // should have succeeded.
2171 Simulator::Schedule(Seconds(2.0) + NanoSeconds(43999),
2172 &TestPhyHeadersReception::CheckPhyState,
2173 this,
2174 WifiPhyState::CCA_BUSY);
2175 Simulator::Schedule(Seconds(2.0) + NanoSeconds(44000),
2176 &TestPhyHeadersReception::CheckPhyState,
2177 this,
2178 WifiPhyState::RX);
2179 // Since it takes 152.8us to transmit the packet, PHY should be back to IDLE at time 152.8us.
2180 // However, since there is a second packet transmitted with a power above CCA-ED (-62 dBm), PHY
2181 // should first be seen as CCA_BUSY for 10us.
2182 Simulator::Schedule(Seconds(2.0) + NanoSeconds(152799),
2183 &TestPhyHeadersReception::CheckPhyState,
2184 this,
2185 WifiPhyState::RX);
2186 Simulator::Schedule(Seconds(2.0) + NanoSeconds(152800),
2187 &TestPhyHeadersReception::CheckPhyState,
2188 this,
2189 WifiPhyState::CCA_BUSY);
2190 Simulator::Schedule(Seconds(2.0) + NanoSeconds(162799),
2191 &TestPhyHeadersReception::CheckPhyState,
2192 this,
2193 WifiPhyState::CCA_BUSY);
2194 Simulator::Schedule(Seconds(2.0) + NanoSeconds(162800),
2195 &TestPhyHeadersReception::CheckPhyState,
2196 this,
2197 WifiPhyState::IDLE);
2198
2199 // CASE 3: send one packet followed by a second one with same power between the end of L-SIG and
2200 // the start of HE-SIG of the first packet: PHY header reception should not succeed but PHY
2201 // should stay in RX state for the duration estimated from L-SIG.
2202
2203 Simulator::Schedule(Seconds(3.0),
2204 &TestPhyHeadersReception::SendPacket,
2205 this,
2206 rxPowerDbm,
2207 1000,
2208 7);
2209 Simulator::Schedule(Seconds(3.0) + MicroSeconds(25),
2210 &TestPhyHeadersReception::SendPacket,
2211 this,
2212 rxPowerDbm,
2213 1000,
2214 7);
2215 // At 44us (end of PHY header), STA PHY STATE should not have moved to RX (HE-SIG failed) and be
2216 // kept to CCA_BUSY.
2217 Simulator::Schedule(Seconds(3.0) + MicroSeconds(44.0),
2218 &TestPhyHeadersReception::CheckPhyState,
2219 this,
2220 WifiPhyState::CCA_BUSY);
2221 // STA PHY STATE should move back to IDLE once the duration estimated from L-SIG has elapsed,
2222 // i.e. at 152.8us. However, since there is a second packet transmitted with a power above
2223 // CCA-ED (-62 dBm), PHY should first be seen as CCA_BUSY for 25us.
2224 Simulator::Schedule(Seconds(3.0) + NanoSeconds(152799),
2225 &TestPhyHeadersReception::CheckPhyState,
2226 this,
2227 WifiPhyState::CCA_BUSY);
2228 Simulator::Schedule(Seconds(3.0) + NanoSeconds(152800),
2229 &TestPhyHeadersReception::CheckPhyState,
2230 this,
2231 WifiPhyState::CCA_BUSY);
2232 Simulator::Schedule(Seconds(3.0) + NanoSeconds(177799),
2233 &TestPhyHeadersReception::CheckPhyState,
2234 this,
2235 WifiPhyState::CCA_BUSY);
2236 Simulator::Schedule(Seconds(3.0) + NanoSeconds(177800),
2237 &TestPhyHeadersReception::CheckPhyState,
2238 this,
2239 WifiPhyState::IDLE);
2240
2241 // CASE 4: send one packet followed by a second one 3 dB weaker between the end of L-SIG and the
2242 // start of HE-SIG of the first packet: PHY header reception should succeed.
2243
2244 Simulator::Schedule(Seconds(4.0),
2245 &TestPhyHeadersReception::SendPacket,
2246 this,
2247 rxPowerDbm,
2248 1000,
2249 7);
2250 Simulator::Schedule(Seconds(4.0) + MicroSeconds(25),
2251 &TestPhyHeadersReception::SendPacket,
2252 this,
2253 rxPowerDbm - 3,
2254 1000,
2255 7);
2256 // At 10 us, STA PHY STATE should be CCA_BUSY.
2257 Simulator::Schedule(Seconds(4.0) + MicroSeconds(10.0),
2258 &TestPhyHeadersReception::CheckPhyState,
2259 this,
2260 WifiPhyState::CCA_BUSY);
2261 // At 44 us (end of HE-SIG), STA PHY STATE should move to RX since the PHY header reception
2262 // should have succeeded.
2263 Simulator::Schedule(Seconds(4.0) + NanoSeconds(43999),
2264 &TestPhyHeadersReception::CheckPhyState,
2265 this,
2266 WifiPhyState::CCA_BUSY);
2267 Simulator::Schedule(Seconds(4.0) + NanoSeconds(44000),
2268 &TestPhyHeadersReception::CheckPhyState,
2269 this,
2270 WifiPhyState::RX);
2271 // STA PHY STATE should move back to IDLE once the duration estimated from L-SIG has elapsed,
2272 // i.e. at 152.8us. However, since there is a second packet transmitted with a power above
2273 // CCA-ED (-62 dBm), PHY should first be seen as CCA_BUSY for 25us.
2274 Simulator::Schedule(Seconds(4.0) + NanoSeconds(152799),
2275 &TestPhyHeadersReception::CheckPhyState,
2276 this,
2277 WifiPhyState::RX);
2278 Simulator::Schedule(Seconds(4.0) + NanoSeconds(152800),
2279 &TestPhyHeadersReception::CheckPhyState,
2280 this,
2281 WifiPhyState::CCA_BUSY);
2282 Simulator::Schedule(Seconds(4.0) + NanoSeconds(177799),
2283 &TestPhyHeadersReception::CheckPhyState,
2284 this,
2285 WifiPhyState::CCA_BUSY);
2286 Simulator::Schedule(Seconds(4.0) + NanoSeconds(177800),
2287 &TestPhyHeadersReception::CheckPhyState,
2288 this,
2289 WifiPhyState::IDLE);
2290
2291 // RX power < CCA-ED
2292 rxPowerDbm = -70;
2293
2294 // CASE 5: send one packet followed by a second one with same power between the end of the 4us
2295 // preamble detection window and the start of L-SIG of the first packet: reception should be
2296 // aborted since L-SIG cannot be decoded (SNR too low).
2297
2298 Simulator::Schedule(Seconds(5.0),
2299 &TestPhyHeadersReception::SendPacket,
2300 this,
2301 rxPowerDbm,
2302 1000,
2303 7);
2304 Simulator::Schedule(Seconds(5.0) + MicroSeconds(10),
2305 &TestPhyHeadersReception::SendPacket,
2306 this,
2307 rxPowerDbm,
2308 1000,
2309 7);
2310 // At 10 us, STA PHY STATE should be CCA_BUSY.
2311 Simulator::Schedule(Seconds(5.0) + MicroSeconds(10.0),
2312 &TestPhyHeadersReception::CheckPhyState,
2313 this,
2314 WifiPhyState::CCA_BUSY);
2315 // At 24us (end of L-SIG), STA PHY STATE stay CCA_BUSY because L-SIG reception failed and the
2316 // start of a valid OFDM transmission has been detected
2317 Simulator::Schedule(Seconds(5.0) + NanoSeconds(24000),
2318 &TestPhyHeadersReception::CheckPhyState,
2319 this,
2320 WifiPhyState::CCA_BUSY);
2321
2322 // CASE 6: send one packet followed by a second one 3 dB weaker between the end of the 4us
2323 // preamble detection window and the start of L-SIG of the first packet: reception should not be
2324 // aborted since L-SIG can be decoded (SNR high enough).
2325
2326 Simulator::Schedule(Seconds(6.0),
2327 &TestPhyHeadersReception::SendPacket,
2328 this,
2329 rxPowerDbm,
2330 1000,
2331 7);
2332 Simulator::Schedule(Seconds(6.0) + MicroSeconds(10),
2333 &TestPhyHeadersReception::SendPacket,
2334 this,
2335 rxPowerDbm - 3,
2336 1000,
2337 7);
2338 // At 10 us, STA PHY STATE should be CCA_BUSY.
2339 Simulator::Schedule(Seconds(6.0) + MicroSeconds(10.0),
2340 &TestPhyHeadersReception::CheckPhyState,
2341 this,
2342 WifiPhyState::CCA_BUSY);
2343 // At 24us (end of L-SIG), STA PHY STATE should be unchanged because L-SIG reception should have
2344 // succeeded.
2345 Simulator::Schedule(Seconds(6.0) + MicroSeconds(24.0),
2346 &TestPhyHeadersReception::CheckPhyState,
2347 this,
2348 WifiPhyState::CCA_BUSY);
2349 // At 44 us (end of HE-SIG), STA PHY STATE should move to RX since the PHY header reception
2350 // should have succeeded.
2351 Simulator::Schedule(Seconds(6.0) + NanoSeconds(43999),
2352 &TestPhyHeadersReception::CheckPhyState,
2353 this,
2354 WifiPhyState::CCA_BUSY);
2355 Simulator::Schedule(Seconds(6.0) + NanoSeconds(44000),
2356 &TestPhyHeadersReception::CheckPhyState,
2357 this,
2358 WifiPhyState::RX);
2359 // Since it takes 152.8us to transmit the packet, PHY should be back to CCA_BUSY at time
2360 // 152.8us.
2361 Simulator::Schedule(Seconds(6.0) + NanoSeconds(152799),
2362 &TestPhyHeadersReception::CheckPhyState,
2363 this,
2364 WifiPhyState::RX);
2365 Simulator::Schedule(Seconds(6.0) + NanoSeconds(152800),
2366 &TestPhyHeadersReception::CheckPhyState,
2367 this,
2368 WifiPhyState::CCA_BUSY);
2369
2370 // CASE 7: send one packet followed by a second one with same power between the end of L-SIG and
2371 // the start of HE-SIG of the first packet: PHY header reception should not succeed but PHY
2372 // should stay in RX state for the duration estimated from L-SIG.
2373
2374 Simulator::Schedule(Seconds(7.0),
2375 &TestPhyHeadersReception::SendPacket,
2376 this,
2377 rxPowerDbm,
2378 1000,
2379 7);
2380 Simulator::Schedule(Seconds(7.0) + MicroSeconds(25),
2381 &TestPhyHeadersReception::SendPacket,
2382 this,
2383 rxPowerDbm,
2384 1000,
2385 7);
2386 // At 10 us, STA PHY STATE should be CCA_BUSY.
2387 Simulator::Schedule(Seconds(7.0) + MicroSeconds(10.0),
2388 &TestPhyHeadersReception::CheckPhyState,
2389 this,
2390 WifiPhyState::CCA_BUSY);
2391 // At 24us (end of L-SIG), STA PHY STATE should be unchanged because L-SIG reception should have
2392 // succeeded.
2393 Simulator::Schedule(Seconds(7.0) + MicroSeconds(24.0),
2394 &TestPhyHeadersReception::CheckPhyState,
2395 this,
2396 WifiPhyState::CCA_BUSY);
2397 // At 44 us (end of HE-SIG), STA PHY STATE should be not have moved to RX since reception of
2398 // HE-SIG should have failed.
2399 Simulator::Schedule(Seconds(7.0) + MicroSeconds(44.0),
2400 &TestPhyHeadersReception::CheckPhyState,
2401 this,
2402 WifiPhyState::CCA_BUSY);
2403 // STA PHY STATE should keep CCA_BUSY once the duration estimated from L-SIG has elapsed, i.e.
2404 // at 152.8us.
2405 Simulator::Schedule(Seconds(7.0) + NanoSeconds(152800),
2406 &TestPhyHeadersReception::CheckPhyState,
2407 this,
2408 WifiPhyState::CCA_BUSY);
2409
2410 // CASE 8: send one packet followed by a second one 3 dB weaker between the end of L-SIG and the
2411 // start of HE-SIG of the first packet: PHY header reception should succeed.
2412
2413 Simulator::Schedule(Seconds(8.0),
2414 &TestPhyHeadersReception::SendPacket,
2415 this,
2416 rxPowerDbm,
2417 1000,
2418 7);
2419 Simulator::Schedule(Seconds(8.0) + MicroSeconds(25),
2420 &TestPhyHeadersReception::SendPacket,
2421 this,
2422 rxPowerDbm - 3,
2423 1000,
2424 7);
2425 // At 10 us, STA PHY STATE should be CCA_BUSY.
2426 Simulator::Schedule(Seconds(8.0) + MicroSeconds(10.0),
2427 &TestPhyHeadersReception::CheckPhyState,
2428 this,
2429 WifiPhyState::CCA_BUSY);
2430 // At 24us (end of L-SIG), STA PHY STATE should be unchanged because L-SIG reception should have
2431 // succeeded.
2432 Simulator::Schedule(Seconds(8.0) + MicroSeconds(24.0),
2433 &TestPhyHeadersReception::CheckPhyState,
2434 this,
2435 WifiPhyState::CCA_BUSY);
2436 // At 44 us (end of HE-SIG), STA PHY STATE should move to RX since the PHY header reception
2437 // should have succeeded.
2438 Simulator::Schedule(Seconds(8.0) + NanoSeconds(43999),
2439 &TestPhyHeadersReception::CheckPhyState,
2440 this,
2441 WifiPhyState::CCA_BUSY);
2442 Simulator::Schedule(Seconds(8.0) + NanoSeconds(44000),
2443 &TestPhyHeadersReception::CheckPhyState,
2444 this,
2445 WifiPhyState::RX);
2446 // STA PHY STATE should move back to CCA_BUSY once the duration estimated from L-SIG has
2447 // elapsed, i.e. at 152.8us.
2448 Simulator::Schedule(Seconds(8.0) + NanoSeconds(152799),
2449 &TestPhyHeadersReception::CheckPhyState,
2450 this,
2451 WifiPhyState::RX);
2452 Simulator::Schedule(Seconds(8.0) + NanoSeconds(152800),
2453 &TestPhyHeadersReception::CheckPhyState,
2454 this,
2455 WifiPhyState::CCA_BUSY);
2456
2457 Simulator::Run();
2458 Simulator::Destroy();
2459}
2460
2467class TestAmpduReception : public WifiPhyReceptionTest
2468{
2469 public:
2470 TestAmpduReception();
2471
2472 private:
2473 void DoSetup() override;
2474 void DoRun() override;
2475
2483 void RxSuccess(Ptr<const WifiPsdu> psdu,
2484 RxSignalInfo rxSignalInfo,
2485 WifiTxVector txVector,
2486 std::vector<bool> statusPerMpdu);
2491 void RxFailure(Ptr<const WifiPsdu> psdu);
2497 void RxDropped(Ptr<const Packet> p, WifiPhyRxfailureReason reason);
2502 void IncrementSuccessBitmap(uint32_t size);
2507 void IncrementFailureBitmap(uint32_t size);
2508
2512 void ResetBitmaps();
2513
2521 void SendAmpduWithThreeMpdus(double rxPowerDbm, uint32_t referencePacketSize);
2522
2527 void CheckRxSuccessBitmapAmpdu1(uint8_t expected);
2532 void CheckRxSuccessBitmapAmpdu2(uint8_t expected);
2537 void CheckRxFailureBitmapAmpdu1(uint8_t expected);
2542 void CheckRxFailureBitmapAmpdu2(uint8_t expected);
2547 void CheckRxDroppedBitmapAmpdu1(uint8_t expected);
2552 void CheckRxDroppedBitmapAmpdu2(uint8_t expected);
2553
2558 void CheckPhyState(WifiPhyState expectedState);
2559
2560 uint8_t m_rxSuccessBitmapAmpdu1{0};
2561 uint8_t m_rxSuccessBitmapAmpdu2{0};
2562
2563 uint8_t m_rxFailureBitmapAmpdu1{0};
2564 uint8_t m_rxFailureBitmapAmpdu2{0};
2565
2566 uint8_t m_rxDroppedBitmapAmpdu1{0};
2567 uint8_t m_rxDroppedBitmapAmpdu2{0};
2568};
2569
2570TestAmpduReception::TestAmpduReception()
2571 : WifiPhyReceptionTest("A-MPDU reception test")
2572{
2573}
2574
2575void
2576TestAmpduReception::ResetBitmaps()
2577{
2578 m_rxSuccessBitmapAmpdu1 = 0;
2579 m_rxSuccessBitmapAmpdu2 = 0;
2580 m_rxFailureBitmapAmpdu1 = 0;
2581 m_rxFailureBitmapAmpdu2 = 0;
2582 m_rxDroppedBitmapAmpdu1 = 0;
2583 m_rxDroppedBitmapAmpdu2 = 0;
2584}
2585
2586void
2587TestAmpduReception::RxSuccess(Ptr<const WifiPsdu> psdu,
2588 RxSignalInfo rxSignalInfo,
2589 WifiTxVector txVector,
2590 std::vector<bool> statusPerMpdu)
2591{
2592 NS_LOG_FUNCTION(this << *psdu << rxSignalInfo << txVector);
2593 if (statusPerMpdu.empty()) // wait for the whole A-MPDU
2594 {
2595 return;
2596 }
2597 NS_ABORT_MSG_IF(psdu->GetNMpdus() != statusPerMpdu.size(),
2598 "Should have one receive status per MPDU");
2599 auto rxOkForMpdu = statusPerMpdu.begin();
2600 for (auto mpdu = psdu->begin(); mpdu != psdu->end(); ++mpdu)
2601 {
2602 if (*rxOkForMpdu)
2603 {
2604 IncrementSuccessBitmap((*mpdu)->GetSize());
2605 }
2606 else
2607 {
2608 IncrementFailureBitmap((*mpdu)->GetSize());
2609 }
2610 ++rxOkForMpdu;
2611 }
2612}
2613
2614void
2615TestAmpduReception::IncrementSuccessBitmap(uint32_t size)
2616{
2617 if (size == 1030) // A-MPDU 1 - MPDU #1
2618 {
2619 m_rxSuccessBitmapAmpdu1 |= 1;
2620 }
2621 else if (size == 1130) // A-MPDU 1 - MPDU #2
2622 {
2623 m_rxSuccessBitmapAmpdu1 |= (1 << 1);
2624 }
2625 else if (size == 1230) // A-MPDU 1 - MPDU #3
2626 {
2627 m_rxSuccessBitmapAmpdu1 |= (1 << 2);
2628 }
2629 else if (size == 1330) // A-MPDU 2 - MPDU #1
2630 {
2631 m_rxSuccessBitmapAmpdu2 |= 1;
2632 }
2633 else if (size == 1430) // A-MPDU 2 - MPDU #2
2634 {
2635 m_rxSuccessBitmapAmpdu2 |= (1 << 1);
2636 }
2637 else if (size == 1530) // A-MPDU 2 - MPDU #3
2638 {
2639 m_rxSuccessBitmapAmpdu2 |= (1 << 2);
2640 }
2641}
2642
2643void
2644TestAmpduReception::RxFailure(Ptr<const WifiPsdu> psdu)
2645{
2646 NS_LOG_FUNCTION(this << *psdu);
2647 for (auto mpdu = psdu->begin(); mpdu != psdu->end(); ++mpdu)
2648 {
2649 IncrementFailureBitmap((*mpdu)->GetSize());
2650 }
2651}
2652
2653void
2654TestAmpduReception::IncrementFailureBitmap(uint32_t size)
2655{
2656 if (size == 1030) // A-MPDU 1 - MPDU #1
2657 {
2658 m_rxFailureBitmapAmpdu1 |= 1;
2659 }
2660 else if (size == 1130) // A-MPDU 1 - MPDU #2
2661 {
2662 m_rxFailureBitmapAmpdu1 |= (1 << 1);
2663 }
2664 else if (size == 1230) // A-MPDU 1 - MPDU #3
2665 {
2666 m_rxFailureBitmapAmpdu1 |= (1 << 2);
2667 }
2668 else if (size == 1330) // A-MPDU 2 - MPDU #1
2669 {
2670 m_rxFailureBitmapAmpdu2 |= 1;
2671 }
2672 else if (size == 1430) // A-MPDU 2 - MPDU #2
2673 {
2674 m_rxFailureBitmapAmpdu2 |= (1 << 1);
2675 }
2676 else if (size == 1530) // A-MPDU 2 - MPDU #3
2677 {
2678 m_rxFailureBitmapAmpdu2 |= (1 << 2);
2679 }
2680}
2681
2682void
2683TestAmpduReception::RxDropped(Ptr<const Packet> p, WifiPhyRxfailureReason reason)
2684{
2685 NS_LOG_FUNCTION(this << p << reason);
2686 if (p->GetSize() == 1030) // A-MPDU 1 - MPDU #1
2687 {
2688 m_rxDroppedBitmapAmpdu1 |= 1;
2689 }
2690 else if (p->GetSize() == 1130) // A-MPDU 1 - MPDU #2
2691 {
2692 m_rxDroppedBitmapAmpdu1 |= (1 << 1);
2693 }
2694 else if (p->GetSize() == 1230) // A-MPDU 1 - MPDU #3
2695 {
2696 m_rxDroppedBitmapAmpdu1 |= (1 << 2);
2697 }
2698 else if (p->GetSize() == 1330) // A-MPDU 2 - MPDU #1
2699 {
2700 m_rxDroppedBitmapAmpdu2 |= 1;
2701 }
2702 else if (p->GetSize() == 1430) // A-MPDU 2 - MPDU #2
2703 {
2704 m_rxDroppedBitmapAmpdu2 |= (1 << 1);
2705 }
2706 else if (p->GetSize() == 1530) // A-MPDU 2 - MPDU #3
2707 {
2708 m_rxDroppedBitmapAmpdu2 |= (1 << 2);
2709 }
2710}
2711
2712void
2713TestAmpduReception::CheckRxSuccessBitmapAmpdu1(uint8_t expected)
2714{
2715 NS_TEST_ASSERT_MSG_EQ(m_rxSuccessBitmapAmpdu1,
2716 expected,
2717 "RX success bitmap for A-MPDU 1 is not as expected");
2718}
2719
2720void
2721TestAmpduReception::CheckRxSuccessBitmapAmpdu2(uint8_t expected)
2722{
2723 NS_TEST_ASSERT_MSG_EQ(m_rxSuccessBitmapAmpdu2,
2724 expected,
2725 "RX success bitmap for A-MPDU 2 is not as expected");
2726}
2727
2728void
2729TestAmpduReception::CheckRxFailureBitmapAmpdu1(uint8_t expected)
2730{
2731 NS_TEST_ASSERT_MSG_EQ(m_rxFailureBitmapAmpdu1,
2732 expected,
2733 "RX failure bitmap for A-MPDU 1 is not as expected");
2734}
2735
2736void
2737TestAmpduReception::CheckRxFailureBitmapAmpdu2(uint8_t expected)
2738{
2739 NS_TEST_ASSERT_MSG_EQ(m_rxFailureBitmapAmpdu2,
2740 expected,
2741 "RX failure bitmap for A-MPDU 2 is not as expected");
2742}
2743
2744void
2745TestAmpduReception::CheckRxDroppedBitmapAmpdu1(uint8_t expected)
2746{
2747 NS_TEST_ASSERT_MSG_EQ(m_rxDroppedBitmapAmpdu1,
2748 expected,
2749 "RX dropped bitmap for A-MPDU 1 is not as expected");
2750}
2751
2752void
2753TestAmpduReception::CheckRxDroppedBitmapAmpdu2(uint8_t expected)
2754{
2755 NS_TEST_ASSERT_MSG_EQ(m_rxDroppedBitmapAmpdu2,
2756 expected,
2757 "RX dropped bitmap for A-MPDU 2 is not as expected");
2758}
2759
2760void
2761TestAmpduReception::CheckPhyState(WifiPhyState expectedState)
2762{
2763 WifiPhyState currentState;
2764 PointerValue ptr;
2765 m_phy->GetAttribute("State", ptr);
2766 Ptr<WifiPhyStateHelper> state = DynamicCast<WifiPhyStateHelper>(ptr.Get<WifiPhyStateHelper>());
2767 currentState = state->GetState();
2768 NS_TEST_ASSERT_MSG_EQ(currentState,
2769 expectedState,
2770 "PHY State " << currentState << " does not match expected state "
2771 << expectedState << " at " << Simulator::Now());
2772}
2773
2774void
2775TestAmpduReception::SendAmpduWithThreeMpdus(double rxPowerDbm, uint32_t referencePacketSize)
2776{
2777 WifiTxVector txVector =
2778 WifiTxVector(HePhy::GetHeMcs0(), 0, WIFI_PREAMBLE_HE_SU, 800, 1, 1, 0, 20, true);
2779
2780 WifiMacHeader hdr;
2781 hdr.SetType(WIFI_MAC_QOSDATA);
2782 hdr.SetQosTid(0);
2783
2784 std::vector<Ptr<WifiMpdu>> mpduList;
2785 for (size_t i = 0; i < 3; ++i)
2786 {
2787 Ptr<Packet> p = Create<Packet>(referencePacketSize + i * 100);
2788 mpduList.push_back(Create<WifiMpdu>(p, hdr));
2789 }
2790 Ptr<WifiPsdu> psdu = Create<WifiPsdu>(mpduList);
2791
2792 Time txDuration = m_phy->CalculateTxDuration(psdu->GetSize(), txVector, m_phy->GetPhyBand());
2793
2794 Ptr<WifiPpdu> ppdu =
2795 Create<HePpdu>(psdu, txVector, m_phy->GetOperatingChannel(), txDuration, m_uid++);
2796
2797 Ptr<SpectrumValue> txPowerSpectrum =
2798 WifiSpectrumValueHelper::CreateHeOfdmTxPowerSpectralDensity(FREQUENCY,
2799 CHANNEL_WIDTH,
2800 DbmToW(rxPowerDbm),
2801 GUARD_WIDTH);
2802
2803 Ptr<WifiSpectrumSignalParameters> txParams = Create<WifiSpectrumSignalParameters>();
2804 txParams->psd = txPowerSpectrum;
2805 txParams->txPhy = nullptr;
2806 txParams->duration = txDuration;
2807 txParams->ppdu = ppdu;
2808 txParams->txWidth = CHANNEL_WIDTH;
2809
2810 m_phy->StartRx(txParams, nullptr);
2811}
2812
2813void
2814TestAmpduReception::DoSetup()
2815{
2816 WifiPhyReceptionTest::DoSetup();
2817
2818 m_phy->SetReceiveOkCallback(MakeCallback(&TestAmpduReception::RxSuccess, this));
2819 m_phy->SetReceiveErrorCallback(MakeCallback(&TestAmpduReception::RxFailure, this));
2820 m_phy->TraceConnectWithoutContext("PhyRxDrop",
2821 MakeCallback(&TestAmpduReception::RxDropped, this));
2822
2823 Ptr<ThresholdPreambleDetectionModel> preambleDetectionModel =
2824 CreateObject<ThresholdPreambleDetectionModel>();
2825 preambleDetectionModel->SetAttribute("Threshold", DoubleValue(2));
2826 m_phy->SetPreambleDetectionModel(preambleDetectionModel);
2827
2828 Ptr<SimpleFrameCaptureModel> frameCaptureModel = CreateObject<SimpleFrameCaptureModel>();
2829 frameCaptureModel->SetAttribute("Margin", DoubleValue(5));
2830 frameCaptureModel->SetAttribute("CaptureWindow", TimeValue(MicroSeconds(16)));
2831 m_phy->SetFrameCaptureModel(frameCaptureModel);
2832}
2833
2834void
2835TestAmpduReception::DoRun()
2836{
2837 RngSeedManager::SetSeed(1);
2838 RngSeedManager::SetRun(2);
2839 int64_t streamNumber = 1;
2840 double rxPowerDbm = -30;
2841 m_phy->AssignStreams(streamNumber);
2842
2844 // CASE 1: receive two A-MPDUs (containing each 3 MPDUs) where the first A-MPDU is received with
2845 // power under RX sensitivity. The second A-MPDU is received 2 microseconds after the first
2846 // A-MPDU (i.e. during preamble detection).
2848
2849 // A-MPDU 1
2850 Simulator::Schedule(Seconds(1.0),
2851 &TestAmpduReception::SendAmpduWithThreeMpdus,
2852 this,
2853 rxPowerDbm - 100,
2854 1000);
2855
2856 // A-MPDU 2
2857 Simulator::Schedule(Seconds(1.0) + MicroSeconds(2),
2858 &TestAmpduReception::SendAmpduWithThreeMpdus,
2859 this,
2860 rxPowerDbm,
2861 1300);
2862
2863 // All MPDUs of A-MPDU 1 should have been ignored.
2864 Simulator::Schedule(Seconds(1.1),
2865 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
2866 this,
2867 0b00000000);
2868 Simulator::Schedule(Seconds(1.1),
2869 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
2870 this,
2871 0b00000000);
2872 Simulator::Schedule(Seconds(1.1),
2873 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
2874 this,
2875 0b00000000);
2876
2877 // All MPDUs of A-MPDU 2 should have been successfully received.
2878 Simulator::Schedule(Seconds(1.1),
2879 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
2880 this,
2881 0b00000111);
2882 Simulator::Schedule(Seconds(1.1),
2883 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
2884 this,
2885 0b00000000);
2886 Simulator::Schedule(Seconds(1.1),
2887 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
2888 this,
2889 0b00000000);
2890
2891 Simulator::Schedule(Seconds(1.2), &TestAmpduReception::ResetBitmaps, this);
2892
2894 // CASE 2: receive two A-MPDUs (containing each 3 MPDUs) where the second A-MPDU is received
2895 // with power under RX sensitivity. The second A-MPDU is received 2 microseconds after the first
2896 // A-MPDU (i.e. during preamble detection).
2898
2899 // A-MPDU 1
2900 Simulator::Schedule(Seconds(2.0),
2901 &TestAmpduReception::SendAmpduWithThreeMpdus,
2902 this,
2903 rxPowerDbm,
2904 1000);
2905
2906 // A-MPDU 2
2907 Simulator::Schedule(Seconds(2.0) + MicroSeconds(2),
2908 &TestAmpduReception::SendAmpduWithThreeMpdus,
2909 this,
2910 rxPowerDbm - 100,
2911 1300);
2912
2913 // All MPDUs of A-MPDU 1 should have been received.
2914 Simulator::Schedule(Seconds(2.1),
2915 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
2916 this,
2917 0b00000111);
2918 Simulator::Schedule(Seconds(2.1),
2919 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
2920 this,
2921 0b00000000);
2922 Simulator::Schedule(Seconds(2.1),
2923 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
2924 this,
2925 0b00000000);
2926
2927 // All MPDUs of A-MPDU 2 should have been ignored.
2928 Simulator::Schedule(Seconds(2.1),
2929 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
2930 this,
2931 0b00000000);
2932 Simulator::Schedule(Seconds(2.1),
2933 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
2934 this,
2935 0b00000000);
2936 Simulator::Schedule(Seconds(2.1),
2937 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
2938 this,
2939 0b00000000);
2940
2941 Simulator::Schedule(Seconds(2.2), &TestAmpduReception::ResetBitmaps, this);
2942
2944 // CASE 3: receive two A-MPDUs (containing each 3 MPDUs) where the first A-MPDU is received with
2945 // power under RX sensitivity. The second A-MPDU is received 10 microseconds after the first
2946 // A-MPDU (i.e. during the frame capture window).
2948
2949 // A-MPDU 1
2950 Simulator::Schedule(Seconds(3.0),
2951 &TestAmpduReception::SendAmpduWithThreeMpdus,
2952 this,
2953 rxPowerDbm - 100,
2954 1000);
2955
2956 // A-MPDU 2
2957 Simulator::Schedule(Seconds(3.0) + MicroSeconds(10),
2958 &TestAmpduReception::SendAmpduWithThreeMpdus,
2959 this,
2960 rxPowerDbm,
2961 1300);
2962
2963 // All MPDUs of A-MPDU 1 should have been ignored.
2964 Simulator::Schedule(Seconds(3.1),
2965 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
2966 this,
2967 0b00000000);
2968 Simulator::Schedule(Seconds(3.1),
2969 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
2970 this,
2971 0b00000000);
2972 Simulator::Schedule(Seconds(3.1),
2973 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
2974 this,
2975 0b00000000);
2976
2977 // All MPDUs of A-MPDU 2 should have been successfully received.
2978 Simulator::Schedule(Seconds(3.1),
2979 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
2980 this,
2981 0b00000111);
2982 Simulator::Schedule(Seconds(3.1),
2983 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
2984 this,
2985 0b00000000);
2986 Simulator::Schedule(Seconds(3.1),
2987 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
2988 this,
2989 0b00000000);
2990
2991 Simulator::Schedule(Seconds(3.2), &TestAmpduReception::ResetBitmaps, this);
2992
2994 // CASE 4: receive two A-MPDUs (containing each 3 MPDUs) where the second A-MPDU is received
2995 // with power under RX sensitivity. The second A-MPDU is received 10 microseconds after the
2996 // first A-MPDU (i.e. during the frame capture window).
2998
2999 // A-MPDU 1
3000 Simulator::Schedule(Seconds(4.0),
3001 &TestAmpduReception::SendAmpduWithThreeMpdus,
3002 this,
3003 rxPowerDbm,
3004 1000);
3005
3006 // A-MPDU 2
3007 Simulator::Schedule(Seconds(4.0) + MicroSeconds(10),
3008 &TestAmpduReception::SendAmpduWithThreeMpdus,
3009 this,
3010 rxPowerDbm - 100,
3011 1300);
3012
3013 // All MPDUs of A-MPDU 1 should have been received.
3014 Simulator::Schedule(Seconds(4.1),
3015 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3016 this,
3017 0b00000111);
3018 Simulator::Schedule(Seconds(4.1),
3019 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3020 this,
3021 0b00000000);
3022 Simulator::Schedule(Seconds(4.1),
3023 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3024 this,
3025 0b00000000);
3026
3027 // All MPDUs of A-MPDU 2 should have been ignored.
3028 Simulator::Schedule(Seconds(4.1),
3029 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3030 this,
3031 0b00000000);
3032 Simulator::Schedule(Seconds(4.1),
3033 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3034 this,
3035 0b00000000);
3036 Simulator::Schedule(Seconds(4.1),
3037 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3038 this,
3039 0b00000000);
3040
3041 Simulator::Schedule(Seconds(4.2), &TestAmpduReception::ResetBitmaps, this);
3042
3044 // CASE 5: receive two A-MPDUs (containing each 3 MPDUs) where the first A-MPDU is received with
3045 // power under RX sensitivity. The second A-MPDU is received 100 microseconds after the first
3046 // A-MPDU (i.e. after the frame capture window, during the payload of MPDU #1).
3048
3049 // A-MPDU 1
3050 Simulator::Schedule(Seconds(5.0),
3051 &TestAmpduReception::SendAmpduWithThreeMpdus,
3052 this,
3053 rxPowerDbm - 100,
3054 1000);
3055
3056 // A-MPDU 2
3057 Simulator::Schedule(Seconds(5.0) + MicroSeconds(100),
3058 &TestAmpduReception::SendAmpduWithThreeMpdus,
3059 this,
3060 rxPowerDbm,
3061 1300);
3062
3063 // All MPDUs of A-MPDU 1 should have been ignored.
3064 Simulator::Schedule(Seconds(5.1),
3065 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3066 this,
3067 0b00000000);
3068 Simulator::Schedule(Seconds(5.1),
3069 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3070 this,
3071 0b00000000);
3072 Simulator::Schedule(Seconds(5.1),
3073 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3074 this,
3075 0b00000000);
3076
3077 // All MPDUs of A-MPDU 2 should have been successfully received.
3078 Simulator::Schedule(Seconds(5.1),
3079 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3080 this,
3081 0b00000111);
3082 Simulator::Schedule(Seconds(5.1),
3083 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3084 this,
3085 0b00000000);
3086 Simulator::Schedule(Seconds(5.1),
3087 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3088 this,
3089 0b00000000);
3090
3091 Simulator::Schedule(Seconds(5.2), &TestAmpduReception::ResetBitmaps, this);
3092
3094 // CASE 6: receive two A-MPDUs (containing each 3 MPDUs) where the second A-MPDU is received
3095 // with power under RX sensitivity. The second A-MPDU is received 100 microseconds after the
3096 // first A-MPDU (i.e. after the frame capture window, during the payload of MPDU #1).
3098
3099 // A-MPDU 1
3100 Simulator::Schedule(Seconds(6.0),
3101 &TestAmpduReception::SendAmpduWithThreeMpdus,
3102 this,
3103 rxPowerDbm,
3104 1000);
3105
3106 // A-MPDU 2
3107 Simulator::Schedule(Seconds(6.0) + MicroSeconds(100),
3108 &TestAmpduReception::SendAmpduWithThreeMpdus,
3109 this,
3110 rxPowerDbm - 100,
3111 1300);
3112
3113 // All MPDUs of A-MPDU 1 should have been received.
3114 Simulator::Schedule(Seconds(6.1),
3115 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3116 this,
3117 0b00000111);
3118 Simulator::Schedule(Seconds(6.1),
3119 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3120 this,
3121 0b00000000);
3122 Simulator::Schedule(Seconds(6.1),
3123 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3124 this,
3125 0b00000000);
3126
3127 // All MPDUs of A-MPDU 2 should have been ignored.
3128 Simulator::Schedule(Seconds(6.1),
3129 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3130 this,
3131 0b00000000);
3132 Simulator::Schedule(Seconds(6.1),
3133 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3134 this,
3135 0b00000000);
3136 Simulator::Schedule(Seconds(6.1),
3137 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3138 this,
3139 0b00000000);
3140
3141 Simulator::Schedule(Seconds(6.2), &TestAmpduReception::ResetBitmaps, this);
3142
3144 // CASE 7: receive two A-MPDUs (containing each 3 MPDUs) where the first A-MPDU is received with
3145 // power under RX sensitivity. The second A-MPDU is received during the payload of MPDU #2.
3147
3148 // A-MPDU 1
3149 Simulator::Schedule(Seconds(7.0),
3150 &TestAmpduReception::SendAmpduWithThreeMpdus,
3151 this,
3152 rxPowerDbm - 100,
3153 1000);
3154
3155 // A-MPDU 2
3156 Simulator::Schedule(Seconds(7.0) + NanoSeconds(1100000),
3157 &TestAmpduReception::SendAmpduWithThreeMpdus,
3158 this,
3159 rxPowerDbm,
3160 1300);
3161
3162 // All MPDUs of A-MPDU 1 should have been ignored.
3163 Simulator::Schedule(Seconds(7.1),
3164 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3165 this,
3166 0b00000000);
3167 Simulator::Schedule(Seconds(7.1),
3168 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3169 this,
3170 0b00000000);
3171 Simulator::Schedule(Seconds(7.1),
3172 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3173 this,
3174 0b00000000);
3175
3176 // All MPDUs of A-MPDU 2 should have been successfully received.
3177 Simulator::Schedule(Seconds(7.1),
3178 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3179 this,
3180 0b00000111);
3181 Simulator::Schedule(Seconds(7.1),
3182 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3183 this,
3184 0b00000000);
3185 Simulator::Schedule(Seconds(7.1),
3186 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3187 this,
3188 0b00000000);
3189
3190 Simulator::Schedule(Seconds(7.2), &TestAmpduReception::ResetBitmaps, this);
3191
3193 // CASE 8: receive two A-MPDUs (containing each 3 MPDUs) where the second A-MPDU is received
3194 // with power under RX sensitivity. The second A-MPDU is received during the payload of MPDU #2.
3196
3197 // A-MPDU 1
3198 Simulator::Schedule(Seconds(8.0),
3199 &TestAmpduReception::SendAmpduWithThreeMpdus,
3200 this,
3201 rxPowerDbm,
3202 1000);
3203
3204 // A-MPDU 2
3205 Simulator::Schedule(Seconds(8.0) + NanoSeconds(1100000),
3206 &TestAmpduReception::SendAmpduWithThreeMpdus,
3207 this,
3208 rxPowerDbm - 100,
3209 1300);
3210
3211 // All MPDUs of A-MPDU 1 should have been received.
3212 Simulator::Schedule(Seconds(8.1),
3213 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3214 this,
3215 0b00000111);
3216 Simulator::Schedule(Seconds(8.1),
3217 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3218 this,
3219 0b00000000);
3220 Simulator::Schedule(Seconds(8.1),
3221 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3222 this,
3223 0b00000000);
3224
3225 // All MPDUs of A-MPDU 2 should have been ignored.
3226 Simulator::Schedule(Seconds(8.1),
3227 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3228 this,
3229 0b00000000);
3230 Simulator::Schedule(Seconds(8.1),
3231 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3232 this,
3233 0b00000000);
3234 Simulator::Schedule(Seconds(8.1),
3235 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3236 this,
3237 0b00000000);
3238
3239 Simulator::Schedule(Seconds(8.2), &TestAmpduReception::ResetBitmaps, this);
3240
3242 // CASE 9: receive two A-MPDUs (containing each 3 MPDUs) with the second A-MPDU having a power 3
3243 // dB higher. The second A-MPDU is received 2 microseconds after the first A-MPDU (i.e. during
3244 // preamble detection).
3246
3247 // A-MPDU 1
3248 Simulator::Schedule(Seconds(9.0),
3249 &TestAmpduReception::SendAmpduWithThreeMpdus,
3250 this,
3251 rxPowerDbm,
3252 1000);
3253
3254 // A-MPDU 2
3255 Simulator::Schedule(Seconds(9.0) + MicroSeconds(2),
3256 &TestAmpduReception::SendAmpduWithThreeMpdus,
3257 this,
3258 rxPowerDbm + 3,
3259 1300);
3260
3261 // All MPDUs of A-MPDU 1 should have been dropped.
3262 Simulator::Schedule(Seconds(9.1),
3263 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3264 this,
3265 0b00000000);
3266 Simulator::Schedule(Seconds(9.1),
3267 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3268 this,
3269 0b00000000);
3270 Simulator::Schedule(Seconds(9.1),
3271 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3272 this,
3273 0b00000111);
3274
3275 // All MPDUs of A-MPDU 2 should have been received with errors.
3276 Simulator::Schedule(Seconds(9.1),
3277 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3278 this,
3279 0b00000000);
3280 Simulator::Schedule(Seconds(9.1),
3281 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3282 this,
3283 0b00000111);
3284 Simulator::Schedule(Seconds(9.1),
3285 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3286 this,
3287 0b00000000);
3288
3289 Simulator::Schedule(Seconds(9.2), &TestAmpduReception::ResetBitmaps, this);
3290
3292 // CASE 10: receive two A-MPDUs (containing each 3 MPDUs) with the same power.
3293 // The second A-MPDU is received 2 microseconds after the first A-MPDU (i.e. during preamble
3294 // detection).
3296
3297 // A-MPDU 1
3298 Simulator::Schedule(Seconds(10.0),
3299 &TestAmpduReception::SendAmpduWithThreeMpdus,
3300 this,
3301 rxPowerDbm,
3302 1000);
3303
3304 // A-MPDU 2
3305 Simulator::Schedule(Seconds(10.0) + MicroSeconds(2),
3306 &TestAmpduReception::SendAmpduWithThreeMpdus,
3307 this,
3308 rxPowerDbm,
3309 1300);
3310
3311 // All MPDUs of A-MPDU 1 should have been dropped (preamble detection failed).
3312 Simulator::Schedule(Seconds(10.1),
3313 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3314 this,
3315 0b00000000);
3316 Simulator::Schedule(Seconds(10.1),
3317 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3318 this,
3319 0b00000000);
3320 Simulator::Schedule(Seconds(10.1),
3321 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3322 this,
3323 0b00000111);
3324
3325 // All MPDUs of A-MPDU 2 should have been dropped as well.
3326 Simulator::Schedule(Seconds(10.1),
3327 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3328 this,
3329 0b00000000);
3330 Simulator::Schedule(Seconds(10.1),
3331 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3332 this,
3333 0b00000000);
3334 Simulator::Schedule(Seconds(10.1),
3335 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3336 this,
3337 0b00000111);
3338
3339 Simulator::Schedule(Seconds(10.2), &TestAmpduReception::ResetBitmaps, this);
3340
3342 // CASE 11: receive two A-MPDUs (containing each 3 MPDUs) with the first A-MPDU having a power 3
3343 // dB higher. The second A-MPDU is received 2 microseconds after the first A-MPDU (i.e. during
3344 // preamble detection).
3346
3347 // A-MPDU 1
3348 Simulator::Schedule(Seconds(11.0),
3349 &TestAmpduReception::SendAmpduWithThreeMpdus,
3350 this,
3351 rxPowerDbm + 3,
3352 1000);
3353
3354 // A-MPDU 2
3355 Simulator::Schedule(Seconds(11.0) + MicroSeconds(2),
3356 &TestAmpduReception::SendAmpduWithThreeMpdus,
3357 this,
3358 rxPowerDbm,
3359 1300);
3360
3361 // All MPDUs of A-MPDU 1 should have been received with errors.
3362 Simulator::Schedule(Seconds(11.1),
3363 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3364 this,
3365 0b00000000);
3366 Simulator::Schedule(Seconds(11.1),
3367 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3368 this,
3369 0b00000111);
3370 Simulator::Schedule(Seconds(11.1),
3371 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3372 this,
3373 0b00000000);
3374
3375 // All MPDUs of A-MPDU 2 should have been dropped.
3376 Simulator::Schedule(Seconds(11.1),
3377 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3378 this,
3379 0b00000000);
3380 Simulator::Schedule(Seconds(11.1),
3381 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3382 this,
3383 0b00000000);
3384 Simulator::Schedule(Seconds(11.1),
3385 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3386 this,
3387 0b00000111);
3388
3389 Simulator::Schedule(Seconds(11.2), &TestAmpduReception::ResetBitmaps, this);
3390
3392 // CASE 12: receive two A-MPDUs (containing each 3 MPDUs) with the second A-MPDU having a power
3393 // 3 dB higher. The second A-MPDU is received 10 microseconds after the first A-MPDU (i.e.
3394 // during the frame capture window).
3396
3397 // A-MPDU 1
3398 Simulator::Schedule(Seconds(12.0),
3399 &TestAmpduReception::SendAmpduWithThreeMpdus,
3400 this,
3401 rxPowerDbm,
3402 1000);
3403
3404 // A-MPDU 2
3405 Simulator::Schedule(Seconds(12.0) + MicroSeconds(10),
3406 &TestAmpduReception::SendAmpduWithThreeMpdus,
3407 this,
3408 rxPowerDbm + 3,
3409 1300);
3410
3411 // All MPDUs of A-MPDU 1 should have been received with errors (PHY header reception failed and
3412 // thus incorrect decoding of payload).
3413 Simulator::Schedule(Seconds(12.1),
3414 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3415 this,
3416 0b00000000);
3417 Simulator::Schedule(Seconds(12.1),
3418 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3419 this,
3420 0b00000000);
3421 Simulator::Schedule(Seconds(12.1),
3422 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3423 this,
3424 0b00000111);
3425
3426 // All MPDUs of A-MPDU 2 should have been dropped (even though TX power is higher, it is not
3427 // high enough to get the PHY reception switched)
3428 Simulator::Schedule(Seconds(12.1),
3429 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3430 this,
3431 0b00000000);
3432 Simulator::Schedule(Seconds(12.1),
3433 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3434 this,
3435 0b00000000);
3436 Simulator::Schedule(Seconds(12.1),
3437 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3438 this,
3439 0b00000111);
3440
3441 Simulator::Schedule(Seconds(12.2), &TestAmpduReception::ResetBitmaps, this);
3442
3444 // CASE 13: receive two A-MPDUs (containing each 3 MPDUs) with the same power.
3445 // The second A-MPDU is received 10 microseconds after the first A-MPDU (i.e. during the frame
3446 // capture window).
3448
3449 // A-MPDU 1
3450 Simulator::Schedule(Seconds(13.0),
3451 &TestAmpduReception::SendAmpduWithThreeMpdus,
3452 this,
3453 rxPowerDbm,
3454 1000);
3455
3456 // A-MPDU 2
3457 Simulator::Schedule(Seconds(13.0) + MicroSeconds(10),
3458 &TestAmpduReception::SendAmpduWithThreeMpdus,
3459 this,
3460 rxPowerDbm,
3461 1300);
3462
3463 // All MPDUs of A-MPDU 1 should have been received with errors (PHY header reception failed and
3464 // thus incorrect decoding of payload).
3465 Simulator::Schedule(Seconds(13.1),
3466 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3467 this,
3468 0b00000000);
3469 Simulator::Schedule(Seconds(13.1),
3470 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3471 this,
3472 0b00000000);
3473 Simulator::Schedule(Seconds(13.1),
3474 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3475 this,
3476 0b00000111);
3477
3478 // All MPDUs of A-MPDU 2 should have been dropped as well.
3479 Simulator::Schedule(Seconds(13.1),
3480 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3481 this,
3482 0b00000000);
3483 Simulator::Schedule(Seconds(13.1),
3484 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3485 this,
3486 0b00000000);
3487 Simulator::Schedule(Seconds(13.1),
3488 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3489 this,
3490 0b00000111);
3491
3492 Simulator::Schedule(Seconds(13.2), &TestAmpduReception::ResetBitmaps, this);
3493
3495 // CASE 14: receive two A-MPDUs (containing each 3 MPDUs) with the first A-MPDU having a power 3
3496 // dB higher. The second A-MPDU is received 10 microseconds after the first A-MPDU (i.e. during
3497 // the frame capture window).
3499
3500 // A-MPDU 1
3501 Simulator::Schedule(Seconds(14.0),
3502 &TestAmpduReception::SendAmpduWithThreeMpdus,
3503 this,
3504 rxPowerDbm + 3,
3505 1000);
3506
3507 // A-MPDU 2
3508 Simulator::Schedule(Seconds(14.0) + MicroSeconds(10),
3509 &TestAmpduReception::SendAmpduWithThreeMpdus,
3510 this,
3511 rxPowerDbm,
3512 1300);
3513
3514 // All MPDUs of A-MPDU 1 should have been received with errors.
3515 Simulator::Schedule(Seconds(14.1),
3516 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3517 this,
3518 0b00000000);
3519 Simulator::Schedule(Seconds(14.1),
3520 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3521 this,
3522 0b00000111);
3523 Simulator::Schedule(Seconds(14.1),
3524 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3525 this,
3526 0b00000000);
3527
3528 // All MPDUs of A-MPDU 2 should have been dropped.
3529 Simulator::Schedule(Seconds(14.1),
3530 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3531 this,
3532 0b00000000);
3533 Simulator::Schedule(Seconds(14.1),
3534 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3535 this,
3536 0b00000000);
3537 Simulator::Schedule(Seconds(14.1),
3538 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3539 this,
3540 0b00000111);
3541
3542 Simulator::Schedule(Seconds(14.2), &TestAmpduReception::ResetBitmaps, this);
3543
3545 // CASE 15: receive two A-MPDUs (containing each 3 MPDUs) with the second A-MPDU having a power
3546 // 6 dB higher. The second A-MPDU is received 10 microseconds after the first A-MPDU (i.e.
3547 // during the frame capture window).
3549
3550 // A-MPDU 1
3551 Simulator::Schedule(Seconds(15.0),
3552 &TestAmpduReception::SendAmpduWithThreeMpdus,
3553 this,
3554 rxPowerDbm,
3555 1000);
3556
3557 // A-MPDU 2
3558 Simulator::Schedule(Seconds(15.0) + MicroSeconds(10),
3559 &TestAmpduReception::SendAmpduWithThreeMpdus,
3560 this,
3561 rxPowerDbm + 6,
3562 1300);
3563
3564 // All MPDUs of A-MPDU 1 should have been dropped because PHY reception switched to A-MPDU 2.
3565 Simulator::Schedule(Seconds(15.1),
3566 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3567 this,
3568 0b00000000);
3569 Simulator::Schedule(Seconds(15.1),
3570 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3571 this,
3572 0b00000000);
3573 Simulator::Schedule(Seconds(15.1),
3574 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3575 this,
3576 0b00000111);
3577
3578 // All MPDUs of A-MPDU 2 should have been successfully received
3579 Simulator::Schedule(Seconds(15.1),
3580 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3581 this,
3582 0b00000111);
3583 Simulator::Schedule(Seconds(15.1),
3584 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3585 this,
3586 0b00000000);
3587 Simulator::Schedule(Seconds(15.1),
3588 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3589 this,
3590 0b00000000);
3591
3592 Simulator::Schedule(Seconds(15.2), &TestAmpduReception::ResetBitmaps, this);
3593
3595 // CASE 16: receive two A-MPDUs (containing each 3 MPDUs) with the first A-MPDU having a power 6
3596 // dB higher. The second A-MPDU is received 10 microseconds after the first A-MPDU (i.e. during
3597 // the frame capture window).
3599
3600 // A-MPDU 1
3601 Simulator::Schedule(Seconds(16.0),
3602 &TestAmpduReception::SendAmpduWithThreeMpdus,
3603 this,
3604 rxPowerDbm + 6,
3605 1000);
3606
3607 // A-MPDU 2
3608 Simulator::Schedule(Seconds(16.0) + MicroSeconds(10),
3609 &TestAmpduReception::SendAmpduWithThreeMpdus,
3610 this,
3611 rxPowerDbm,
3612 1300);
3613
3614 // All MPDUs of A-MPDU 1 should have been successfully received.
3615 Simulator::Schedule(Seconds(16.1),
3616 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3617 this,
3618 0b00000111);
3619 Simulator::Schedule(Seconds(16.1),
3620 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3621 this,
3622 0b00000000);
3623 Simulator::Schedule(Seconds(16.1),
3624 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3625 this,
3626 0b00000000);
3627
3628 // All MPDUs of A-MPDU 2 should have been dropped.
3629 Simulator::Schedule(Seconds(16.1),
3630 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3631 this,
3632 0b00000000);
3633 Simulator::Schedule(Seconds(16.1),
3634 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3635 this,
3636 0b00000000);
3637 Simulator::Schedule(Seconds(16.1),
3638 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3639 this,
3640 0b00000111);
3641
3642 Simulator::Schedule(Seconds(16.2), &TestAmpduReception::ResetBitmaps, this);
3643
3645 // CASE 17: receive two A-MPDUs (containing each 3 MPDUs) with the second A-MPDU having a power
3646 // 6 dB higher. The second A-MPDU is received 25 microseconds after the first A-MPDU (i.e. after
3647 // the frame capture window, but still during PHY header).
3649
3650 // A-MPDU 1
3651 Simulator::Schedule(Seconds(17.0),
3652 &TestAmpduReception::SendAmpduWithThreeMpdus,
3653 this,
3654 rxPowerDbm,
3655 1000);
3656
3657 // A-MPDU 2
3658 Simulator::Schedule(Seconds(17.0) + MicroSeconds(25),
3659 &TestAmpduReception::SendAmpduWithThreeMpdus,
3660 this,
3661 rxPowerDbm + 6,
3662 1300);
3663
3664 // All MPDUs of A-MPDU 1 should have been received with errors.
3665 Simulator::Schedule(Seconds(17.1),
3666 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3667 this,
3668 0b00000000);
3669 Simulator::Schedule(Seconds(17.1),
3670 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3671 this,
3672 0b00000000);
3673 Simulator::Schedule(Seconds(17.1),
3674 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3675 this,
3676 0b00000111);
3677
3678 // All MPDUs of A-MPDU 2 should have been dropped (no reception switch, MPDUs dropped because
3679 // PHY is already in RX state).
3680 Simulator::Schedule(Seconds(17.1),
3681 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3682 this,
3683 0b00000000);
3684 Simulator::Schedule(Seconds(17.1),
3685 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3686 this,
3687 0b00000000);
3688 Simulator::Schedule(Seconds(17.1),
3689 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3690 this,
3691 0b00000111);
3692
3693 Simulator::Schedule(Seconds(17.2), &TestAmpduReception::ResetBitmaps, this);
3694
3696 // CASE 18: receive two A-MPDUs (containing each 3 MPDUs) with the first A-MPDU having a power 6
3697 // dB higher. The second A-MPDU is received 25 microseconds after the first A-MPDU (i.e. after
3698 // the frame capture window, but still during PHY header).
3700
3701 // A-MPDU 1
3702 Simulator::Schedule(Seconds(18.0),
3703 &TestAmpduReception::SendAmpduWithThreeMpdus,
3704 this,
3705 rxPowerDbm + 6,
3706 1000);
3707
3708 // A-MPDU 2
3709 Simulator::Schedule(Seconds(18.0) + MicroSeconds(25),
3710 &TestAmpduReception::SendAmpduWithThreeMpdus,
3711 this,
3712 rxPowerDbm,
3713 1300);
3714
3715 // All MPDUs of A-MPDU 1 should have been successfully received.
3716 Simulator::Schedule(Seconds(18.1),
3717 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3718 this,
3719 0b00000111);
3720 Simulator::Schedule(Seconds(18.1),
3721 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3722 this,
3723 0b00000000);
3724 Simulator::Schedule(Seconds(18.1),
3725 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3726 this,
3727 0b00000000);
3728
3729 // All MPDUs of A-MPDU 2 should have been dropped.
3730 Simulator::Schedule(Seconds(18.1),
3731 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3732 this,
3733 0b00000000);
3734 Simulator::Schedule(Seconds(18.1),
3735 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3736 this,
3737 0b00000000);
3738 Simulator::Schedule(Seconds(18.1),
3739 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3740 this,
3741 0b00000111);
3742
3743 Simulator::Schedule(Seconds(18.2), &TestAmpduReception::ResetBitmaps, this);
3744
3746 // CASE 19: receive two A-MPDUs (containing each 3 MPDUs) with the same power.
3747 // The second A-MPDU is received 25 microseconds after the first A-MPDU (i.e. after the frame
3748 // capture window, but still during PHY header).
3750
3751 // A-MPDU 1
3752 Simulator::Schedule(Seconds(19.0),
3753 &TestAmpduReception::SendAmpduWithThreeMpdus,
3754 this,
3755 rxPowerDbm,
3756 1000);
3757
3758 // A-MPDU 2
3759 Simulator::Schedule(Seconds(19.0) + MicroSeconds(25),
3760 &TestAmpduReception::SendAmpduWithThreeMpdus,
3761 this,
3762 rxPowerDbm,
3763 1300);
3764
3765 // All MPDUs of A-MPDU 1 should have been received with errors.
3766 Simulator::Schedule(Seconds(19.1),
3767 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3768 this,
3769 0b00000000);
3770 Simulator::Schedule(Seconds(19.1),
3771 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3772 this,
3773 0b00000000);
3774 Simulator::Schedule(Seconds(19.1),
3775 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3776 this,
3777 0b00000111);
3778
3779 // All MPDUs of A-MPDU 2 should have been dropped.
3780 Simulator::Schedule(Seconds(19.1),
3781 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3782 this,
3783 0b00000000);
3784 Simulator::Schedule(Seconds(19.1),
3785 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3786 this,
3787 0b00000000);
3788 Simulator::Schedule(Seconds(19.1),
3789 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3790 this,
3791 0b00000111);
3792
3793 Simulator::Schedule(Seconds(19.2), &TestAmpduReception::ResetBitmaps, this);
3794
3796 // CASE 20: receive two A-MPDUs (containing each 3 MPDUs) with the second A-MPDU having a power
3797 // 6 dB higher. The second A-MPDU is received 100 microseconds after the first A-MPDU (i.e.
3798 // during the payload of MPDU #1).
3800
3801 // A-MPDU 1
3802 Simulator::Schedule(Seconds(20.0),
3803 &TestAmpduReception::SendAmpduWithThreeMpdus,
3804 this,
3805 rxPowerDbm,
3806 1000);
3807
3808 // A-MPDU 2
3809 Simulator::Schedule(Seconds(20.0) + MicroSeconds(100),
3810 &TestAmpduReception::SendAmpduWithThreeMpdus,
3811 this,
3812 rxPowerDbm + 6,
3813 1300);
3814
3815 // All MPDUs of A-MPDU 1 should have been received with errors.
3816 Simulator::Schedule(Seconds(20.1),
3817 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3818 this,
3819 0b00000000);
3820 Simulator::Schedule(Seconds(20.1),
3821 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3822 this,
3823 0b00000111);
3824 Simulator::Schedule(Seconds(20.1),
3825 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3826 this,
3827 0b00000000);
3828
3829 // All MPDUs of A-MPDU 2 should have been dropped (no reception switch, MPDUs dropped because
3830 // PHY is already in RX state).
3831 Simulator::Schedule(Seconds(20.1),
3832 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3833 this,
3834 0b00000000);
3835 Simulator::Schedule(Seconds(20.1),
3836 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3837 this,
3838 0b00000000);
3839 Simulator::Schedule(Seconds(20.1),
3840 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3841 this,
3842 0b00000111);
3843
3844 Simulator::Schedule(Seconds(20.2), &TestAmpduReception::ResetBitmaps, this);
3845
3847 // CASE 21: receive two A-MPDUs (containing each 3 MPDUs) with the first A-MPDU having a power 6
3848 // dB higher. The second A-MPDU is received 100 microseconds after the first A-MPDU (i.e. during
3849 // the payload of MPDU #1).
3851
3852 // A-MPDU 1
3853 Simulator::Schedule(Seconds(21.0),
3854 &TestAmpduReception::SendAmpduWithThreeMpdus,
3855 this,
3856 rxPowerDbm + 6,
3857 1000);
3858
3859 // A-MPDU 2
3860 Simulator::Schedule(Seconds(21.0) + MicroSeconds(100),
3861 &TestAmpduReception::SendAmpduWithThreeMpdus,
3862 this,
3863 rxPowerDbm,
3864 1300);
3865
3866 // All MPDUs of A-MPDU 1 should have been successfully received.
3867 Simulator::Schedule(Seconds(21.1),
3868 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3869 this,
3870 0b00000111);
3871 Simulator::Schedule(Seconds(21.1),
3872 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3873 this,
3874 0b00000000);
3875 Simulator::Schedule(Seconds(21.1),
3876 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3877 this,
3878 0b00000000);
3879
3880 // All MPDUs of A-MPDU 2 should have been dropped.
3881 Simulator::Schedule(Seconds(21.1),
3882 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3883 this,
3884 0b00000000);
3885 Simulator::Schedule(Seconds(21.1),
3886 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3887 this,
3888 0b00000000);
3889 Simulator::Schedule(Seconds(21.1),
3890 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3891 this,
3892 0b00000111);
3893
3894 Simulator::Schedule(Seconds(21.2), &TestAmpduReception::ResetBitmaps, this);
3895
3897 // CASE 22: receive two A-MPDUs (containing each 3 MPDUs) with the same power.
3898 // The second A-MPDU is received 100 microseconds after the first A-MPDU (i.e. during the
3899 // payload of MPDU #1).
3901
3902 // A-MPDU 1
3903 Simulator::Schedule(Seconds(22.0),
3904 &TestAmpduReception::SendAmpduWithThreeMpdus,
3905 this,
3906 rxPowerDbm,
3907 1000);
3908
3909 // A-MPDU 2
3910 Simulator::Schedule(Seconds(22.0) + MicroSeconds(100),
3911 &TestAmpduReception::SendAmpduWithThreeMpdus,
3912 this,
3913 rxPowerDbm,
3914 1300);
3915
3916 // All MPDUs of A-MPDU 1 should have been received with errors.
3917 Simulator::Schedule(Seconds(22.1),
3918 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3919 this,
3920 0b00000000);
3921 Simulator::Schedule(Seconds(22.1),
3922 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3923 this,
3924 0b00000111);
3925 Simulator::Schedule(Seconds(22.1),
3926 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3927 this,
3928 0b00000000);
3929
3930 // All MPDUs of A-MPDU 2 should have been dropped.
3931 Simulator::Schedule(Seconds(22.1),
3932 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3933 this,
3934 0b00000000);
3935 Simulator::Schedule(Seconds(22.1),
3936 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3937 this,
3938 0b00000000);
3939 Simulator::Schedule(Seconds(22.1),
3940 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3941 this,
3942 0b00000111);
3943
3944 Simulator::Schedule(Seconds(22.2), &TestAmpduReception::ResetBitmaps, this);
3945
3947 // CASE 23: receive two A-MPDUs (containing each 3 MPDUs) with the same power.
3948 // The second A-MPDU is received during the payload of MPDU #2.
3950
3951 // A-MPDU 1
3952 Simulator::Schedule(Seconds(23.0),
3953 &TestAmpduReception::SendAmpduWithThreeMpdus,
3954 this,
3955 rxPowerDbm,
3956 1000);
3957
3958 // A-MPDU 2
3959 Simulator::Schedule(Seconds(23.0) + NanoSeconds(1100000),
3960 &TestAmpduReception::SendAmpduWithThreeMpdus,
3961 this,
3962 rxPowerDbm,
3963 1300);
3964
3965 // The first MPDU of A-MPDU 1 should have been successfully received (no interference).
3966 // The two other MPDUs failed due to interference and are marked as failure (and dropped).
3967 Simulator::Schedule(Seconds(23.1),
3968 &TestAmpduReception::CheckRxSuccessBitmapAmpdu1,
3969 this,
3970 0b00000001);
3971 Simulator::Schedule(Seconds(23.1),
3972 &TestAmpduReception::CheckRxFailureBitmapAmpdu1,
3973 this,
3974 0b00000110);
3975 Simulator::Schedule(Seconds(23.1),
3976 &TestAmpduReception::CheckRxDroppedBitmapAmpdu1,
3977 this,
3978 0b00000000);
3979
3980 // The two first MPDUs of A-MPDU 2 are dropped because PHY is already in RX state (receiving
3981 // A-MPDU 1). The last MPDU of A-MPDU 2 is interference free (A-MPDU 1 transmission is finished)
3982 // but is dropped because its PHY preamble and header were not received.
3983 Simulator::Schedule(Seconds(23.1),
3984 &TestAmpduReception::CheckRxSuccessBitmapAmpdu2,
3985 this,
3986 0b00000000);
3987 Simulator::Schedule(Seconds(23.1),
3988 &TestAmpduReception::CheckRxFailureBitmapAmpdu2,
3989 this,
3990 0b00000000);
3991 Simulator::Schedule(Seconds(23.1),
3992 &TestAmpduReception::CheckRxDroppedBitmapAmpdu2,
3993 this,
3994 0b00000111);
3995
3996 Simulator::Schedule(Seconds(23.2), &TestAmpduReception::ResetBitmaps, this);
3997
3998 Simulator::Run();
3999 Simulator::Destroy();
4000}
4001
4022class TestUnsupportedModulationReception : public TestCase
4023{
4024 public:
4025 TestUnsupportedModulationReception();
4026 ~TestUnsupportedModulationReception() override = default;
4027
4028 private:
4029 void DoRun() override;
4030
4037 void Dropped(std::string context, Ptr<const Packet> packet, WifiPhyRxfailureReason reason);
4041 void CheckResults();
4042
4043 uint16_t m_dropped{0};
4044};
4045
4046TestUnsupportedModulationReception::TestUnsupportedModulationReception()
4047 : TestCase("Check correct behavior when a STA is receiving a transmission using an unsupported "
4048 "modulation")
4049{
4050}
4051
4052void
4053TestUnsupportedModulationReception::Dropped(std::string context,
4054 Ptr<const Packet> packet,
4055 WifiPhyRxfailureReason reason)
4056{
4057 // Print if the test is executed through test-runner
4058 if (reason == RXING)
4059 {
4060 std::cout << "Dropped a packet because already receiving" << std::endl;
4061 m_dropped++;
4062 }
4063}
4064
4065void
4066TestUnsupportedModulationReception::DoRun()
4067{
4068 uint16_t m_nStations = 2;
4069 NetDeviceContainer m_staDevices;
4070 NetDeviceContainer m_apDevices;
4071
4072 int64_t streamNumber = 100;
4073
4074 NodeContainer wifiApNode;
4075 wifiApNode.Create(1);
4076
4077 NodeContainer wifiStaNodes;
4078 wifiStaNodes.Create(m_nStations);
4079
4080 Ptr<MultiModelSpectrumChannel> spectrumChannel = CreateObject<MultiModelSpectrumChannel>();
4081 Ptr<FriisPropagationLossModel> lossModel = CreateObject<FriisPropagationLossModel>();
4082 spectrumChannel->AddPropagationLossModel(lossModel);
4083 Ptr<ConstantSpeedPropagationDelayModel> delayModel =
4084 CreateObject<ConstantSpeedPropagationDelayModel>();
4085 spectrumChannel->SetPropagationDelayModel(delayModel);
4086
4087 SpectrumWifiPhyHelper phy;
4088 phy.SetChannel(spectrumChannel);
4089
4090 Config::SetDefault("ns3::WifiRemoteStationManager::RtsCtsThreshold", UintegerValue(65535));
4091
4092 WifiHelper wifi;
4093 wifi.SetRemoteStationManager("ns3::IdealWifiManager");
4094
4095 WifiMacHelper mac;
4096 mac.SetType("ns3::StaWifiMac",
4097 "QosSupported",
4098 BooleanValue(true),
4099 "Ssid",
4100 SsidValue(Ssid("non-existent-ssid")));
4101
4102 wifi.SetStandard(WIFI_STANDARD_80211ax);
4103 m_staDevices.Add(wifi.Install(phy, mac, wifiStaNodes.Get(0)));
4104 wifi.SetStandard(WIFI_STANDARD_80211ac);
4105 m_staDevices.Add(wifi.Install(phy, mac, wifiStaNodes.Get(1)));
4106
4107 wifi.SetStandard(WIFI_STANDARD_80211ax);
4108 mac.SetType("ns3::ApWifiMac",
4109 "QosSupported",
4110 BooleanValue(true),
4111 "Ssid",
4112 SsidValue(Ssid("wifi-backoff-ssid")),
4113 "BeaconInterval",
4114 TimeValue(MicroSeconds(102400)),
4115 "EnableBeaconJitter",
4116 BooleanValue(false));
4117
4118 m_apDevices = wifi.Install(phy, mac, wifiApNode);
4119
4120 // schedule association requests at different times
4121 Time init = MilliSeconds(100);
4122 Ptr<WifiNetDevice> dev;
4123
4124 for (uint16_t i = 0; i < m_nStations; i++)
4125 {
4126 dev = DynamicCast<WifiNetDevice>(m_staDevices.Get(i));
4127 Simulator::Schedule(init + i * MicroSeconds(102400),
4128 &WifiMac::SetSsid,
4129 dev->GetMac(),
4130 Ssid("wifi-backoff-ssid"));
4131 }
4132
4133 // Assign fixed streams to random variables in use
4134 wifi.AssignStreams(m_apDevices, streamNumber);
4135
4136 MobilityHelper mobility;
4137 Ptr<ListPositionAllocator> positionAlloc = CreateObject<ListPositionAllocator>();
4138
4139 positionAlloc->Add(Vector(0.0, 0.0, 0.0));
4140 positionAlloc->Add(Vector(1.0, 0.0, 0.0));
4141 positionAlloc->Add(Vector(0.0, 1.0, 0.0));
4142 positionAlloc->Add(Vector(-1.0, 0.0, 0.0));
4143 mobility.SetPositionAllocator(positionAlloc);
4144
4145 mobility.SetMobilityModel("ns3::ConstantPositionMobilityModel");
4146 mobility.Install(wifiApNode);
4147 mobility.Install(wifiStaNodes);
4148
4149 // set the TXOP limit on BE AC
4150 dev = DynamicCast<WifiNetDevice>(m_apDevices.Get(0));
4151 PointerValue ptr;
4152 dev->GetMac()->GetAttribute("BE_Txop", ptr);
4153
4154 PacketSocketHelper packetSocket;
4155 packetSocket.Install(wifiApNode);
4156 packetSocket.Install(wifiStaNodes);
4157
4158 // UL Traffic
4159 for (uint16_t i = 0; i < m_nStations; i++)
4160 {
4161 PacketSocketAddress socket;
4162 socket.SetSingleDevice(m_staDevices.Get(0)->GetIfIndex());
4163 socket.SetPhysicalAddress(m_apDevices.Get(0)->GetAddress());
4164 socket.SetProtocol(1);
4165 Ptr<PacketSocketClient> client = CreateObject<PacketSocketClient>();
4166 client->SetAttribute("PacketSize", UintegerValue(1500));
4167 client->SetAttribute("MaxPackets", UintegerValue(200));
4168 client->SetAttribute("Interval", TimeValue(MicroSeconds(0)));
4169 client->SetRemote(socket);
4170 wifiStaNodes.Get(i)->AddApplication(client);
4171 client->SetStartTime(MicroSeconds(400000));
4172 client->SetStopTime(Seconds(1.0));
4173 Ptr<PacketSocketClient> legacyStaClient = CreateObject<PacketSocketClient>();
4174 legacyStaClient->SetAttribute("PacketSize", UintegerValue(1500));
4175 legacyStaClient->SetAttribute("MaxPackets", UintegerValue(200));
4176 legacyStaClient->SetAttribute("Interval", TimeValue(MicroSeconds(0)));
4177 legacyStaClient->SetRemote(socket);
4178 wifiStaNodes.Get(i)->AddApplication(legacyStaClient);
4179 legacyStaClient->SetStartTime(MicroSeconds(400000));
4180 legacyStaClient->SetStopTime(Seconds(1.0));
4181 Ptr<PacketSocketServer> server = CreateObject<PacketSocketServer>();
4182 server->SetLocal(socket);
4183 wifiApNode.Get(0)->AddApplication(server);
4184 server->SetStartTime(Seconds(0.0));
4185 server->SetStopTime(Seconds(1.0));
4186 }
4187
4188 // Trace dropped packets
4189 Config::Connect("/NodeList/*/DeviceList/*/$ns3::WifiNetDevice/Phy/PhyRxDrop",
4190 MakeCallback(&TestUnsupportedModulationReception::Dropped, this));
4191
4192 Simulator::Stop(Seconds(1));
4193 Simulator::Run();
4194
4195 CheckResults();
4196
4197 Simulator::Destroy();
4198}
4199
4200void
4201TestUnsupportedModulationReception::CheckResults()
4202{
4203 NS_TEST_EXPECT_MSG_EQ(m_dropped, 0, "Dropped some packets unexpectedly");
4204}
4205
4217class TestUnsupportedBandwidthReception : public TestCase
4218{
4219 public:
4220 TestUnsupportedBandwidthReception();
4221
4222 private:
4223 void DoSetup() override;
4224 void DoTeardown() override;
4225 void DoRun() override;
4226
4233 void SendPpdu(uint16_t centerFreqMhz, uint16_t bandwidthMhz);
4234
4242 void RxSuccess(Ptr<const WifiPsdu> psdu,
4243 RxSignalInfo rxSignalInfo,
4244 WifiTxVector txVector,
4245 std::vector<bool> statusPerMpdu);
4246
4251 void RxFailure(Ptr<const WifiPsdu> psdu);
4252
4258 void RxDropped(Ptr<const Packet> packet, WifiPhyRxfailureReason reason);
4259
4271 void CheckRx(uint32_t expectedCountRxSuccess,
4272 uint32_t expectedCountRxFailure,
4273 uint32_t expectedCountRxDropped,
4274 std::optional<Time> expectedLastRxSucceeded,
4275 std::optional<Time> expectedLastRxFailed,
4276 std::optional<Time> expectedLastRxDropped);
4277
4278 uint32_t m_countRxSuccess;
4279 uint32_t m_countRxFailure;
4280 uint32_t m_countRxDropped;
4281
4282 std::optional<Time> m_lastRxSucceeded;
4283 std::optional<Time> m_lastRxFailed;
4284 std::optional<Time> m_lastRxDropped;
4285
4286 Ptr<SpectrumWifiPhy> m_rxPhy;
4287 Ptr<SpectrumWifiPhy> m_txPhy;
4288};
4289
4290TestUnsupportedBandwidthReception::TestUnsupportedBandwidthReception()
4291 : TestCase("Check correct behavior when a STA is receiving a transmission using an unsupported "
4292 "bandwidth"),
4293 m_countRxSuccess(0),
4294 m_countRxFailure(0),
4295 m_countRxDropped(0),
4296 m_lastRxSucceeded(std::nullopt),
4297 m_lastRxFailed(std::nullopt),
4298 m_lastRxDropped(std::nullopt)
4299{
4300}
4301
4302void
4303TestUnsupportedBandwidthReception::SendPpdu(uint16_t centerFreqMhz, uint16_t bandwidthMhz)
4304{
4305 auto txVector =
4306 WifiTxVector(HePhy::GetHeMcs0(), 0, WIFI_PREAMBLE_HE_SU, 800, 1, 1, 0, bandwidthMhz, false);
4307
4308 auto pkt = Create<Packet>(1000);
4309 WifiMacHeader hdr;
4310
4311 hdr.SetType(WIFI_MAC_QOSDATA);
4312 hdr.SetQosTid(0);
4313
4314 Ptr<WifiPsdu> psdu = Create<WifiPsdu>(pkt, hdr);
4315 Time txDuration =
4316 m_rxPhy->CalculateTxDuration(psdu->GetSize(), txVector, m_rxPhy->GetPhyBand());
4317
4318 auto ppdu = Create<HePpdu>(psdu, txVector, m_txPhy->GetOperatingChannel(), txDuration, 0);
4319
4320 auto txPowerSpectrum =
4321 WifiSpectrumValueHelper::CreateHeOfdmTxPowerSpectralDensity(centerFreqMhz,
4322 bandwidthMhz,
4323 DbmToW(-50),
4324 bandwidthMhz);
4325
4326 auto txParams = Create<WifiSpectrumSignalParameters>();
4327 txParams->psd = txPowerSpectrum;
4328 txParams->txPhy = nullptr;
4329 txParams->duration = txDuration;
4330 txParams->ppdu = ppdu;
4331 txParams->txWidth = bandwidthMhz;
4332
4333 m_rxPhy->StartRx(txParams, nullptr);
4334}
4335
4336void
4337TestUnsupportedBandwidthReception::RxSuccess(Ptr<const WifiPsdu> psdu,
4338 RxSignalInfo rxSignalInfo,
4339 WifiTxVector txVector,
4340 std::vector<bool> statusPerMpdu)
4341{
4342 NS_LOG_FUNCTION(this << *psdu << rxSignalInfo << txVector);
4343 m_countRxSuccess++;
4344 m_lastRxSucceeded = Simulator::Now();
4345}
4346
4347void
4348TestUnsupportedBandwidthReception::RxFailure(Ptr<const WifiPsdu> psdu)
4349{
4350 NS_LOG_FUNCTION(this << *psdu);
4351 m_countRxFailure++;
4352 m_lastRxFailed = Simulator::Now();
4353}
4354
4355void
4356TestUnsupportedBandwidthReception::RxDropped(Ptr<const Packet> p, WifiPhyRxfailureReason reason)
4357{
4358 NS_LOG_FUNCTION(this << p << reason);
4359 NS_ASSERT(reason == UNSUPPORTED_SETTINGS);
4360 m_countRxDropped++;
4361 m_lastRxDropped = Simulator::Now();
4362}
4363
4364void
4365TestUnsupportedBandwidthReception::CheckRx(uint32_t expectedCountRxSuccess,
4366 uint32_t expectedCountRxFailure,
4367 uint32_t expectedCountRxDropped,
4368 std::optional<Time> expectedLastRxSucceeded,
4369 std::optional<Time> expectedLastRxFailed,
4370 std::optional<Time> expectedLastRxDropped)
4371{
4372 NS_TEST_ASSERT_MSG_EQ(m_countRxSuccess,
4373 expectedCountRxSuccess,
4374 "Didn't receive right number of successful packets");
4375
4376 NS_TEST_ASSERT_MSG_EQ(m_countRxFailure,
4377 expectedCountRxFailure,
4378 "Didn't receive right number of unsuccessful packets");
4379
4380 NS_TEST_ASSERT_MSG_EQ(m_countRxDropped,
4381 expectedCountRxDropped,
4382 "Didn't receive right number of dropped packets");
4383
4384 if (expectedCountRxSuccess > 0)
4385 {
4386 NS_ASSERT(m_lastRxSucceeded.has_value());
4387 NS_ASSERT(expectedLastRxSucceeded.has_value());
4388 NS_TEST_ASSERT_MSG_EQ(m_lastRxSucceeded.value(),
4389 expectedLastRxSucceeded.value(),
4390 "Didn't receive the last successful packet at the expected time");
4391 }
4392
4393 if (expectedCountRxFailure > 0)
4394 {
4395 NS_ASSERT(m_lastRxFailed.has_value());
4396 NS_ASSERT(expectedLastRxFailed.has_value());
4397 NS_TEST_ASSERT_MSG_EQ(m_lastRxFailed.value(),
4398 expectedLastRxFailed.value(),
4399 "Didn't receive the last unsuccessful packet at the expected time");
4400 }
4401
4402 if (expectedCountRxDropped > 0)
4403 {
4404 NS_ASSERT(m_lastRxDropped.has_value());
4405 NS_ASSERT(expectedLastRxDropped.has_value());
4406 NS_TEST_ASSERT_MSG_EQ(m_lastRxDropped.value(),
4407 expectedLastRxDropped.value(),
4408 "Didn't drop the last filtered packet at the expected time");
4409 }
4410}
4411
4412void
4413TestUnsupportedBandwidthReception::DoSetup()
4414{
4415 Ptr<MultiModelSpectrumChannel> spectrumChannel = CreateObject<MultiModelSpectrumChannel>();
4416 Ptr<Node> node = CreateObject<Node>();
4417 Ptr<WifiNetDevice> dev = CreateObject<WifiNetDevice>();
4418 m_rxPhy = CreateObject<SpectrumWifiPhy>();
4419 auto rxInterferenceHelper = CreateObject<InterferenceHelper>();
4420 m_rxPhy->SetInterferenceHelper(rxInterferenceHelper);
4421 auto rxErrorRateModel = CreateObject<NistErrorRateModel>();
4422 m_rxPhy->SetErrorRateModel(rxErrorRateModel);
4423 m_rxPhy->SetDevice(dev);
4424 m_rxPhy->AddChannel(spectrumChannel);
4425 m_rxPhy->ConfigureStandard(WIFI_STANDARD_80211ax);
4426 dev->SetPhy(m_rxPhy);
4427 node->AddDevice(dev);
4428
4429 m_rxPhy->SetReceiveOkCallback(
4430 MakeCallback(&TestUnsupportedBandwidthReception::RxSuccess, this));
4431 m_rxPhy->SetReceiveErrorCallback(
4432 MakeCallback(&TestUnsupportedBandwidthReception::RxFailure, this));
4433 m_rxPhy->TraceConnectWithoutContext(
4434 "PhyRxDrop",
4435 MakeCallback(&TestUnsupportedBandwidthReception::RxDropped, this));
4436
4437 m_txPhy = CreateObject<SpectrumWifiPhy>();
4438 auto txInterferenceHelper = CreateObject<InterferenceHelper>();
4439 m_txPhy->SetInterferenceHelper(txInterferenceHelper);
4440 auto txErrorRateModel = CreateObject<NistErrorRateModel>();
4441 m_txPhy->SetErrorRateModel(txErrorRateModel);
4442 m_txPhy->AddChannel(spectrumChannel);
4443 m_txPhy->ConfigureStandard(WIFI_STANDARD_80211ax);
4444}
4445
4446void
4447TestUnsupportedBandwidthReception::DoTeardown()
4448{
4449 m_rxPhy->Dispose();
4450 m_rxPhy = nullptr;
4451
4452 m_txPhy->Dispose();
4453 m_txPhy = nullptr;
4454}
4455
4456void
4457TestUnsupportedBandwidthReception::DoRun()
4458{
4459 RngSeedManager::SetSeed(1);
4460 RngSeedManager::SetRun(1);
4461
4462 int64_t streamNumber = 0;
4463 m_rxPhy->AssignStreams(streamNumber);
4464
4465 // Case 1: the PHY is operating on channel 36 (20 MHz) and receives a 40 MHz PPDU (channel 38).
4466 // The PPDU should be dropped once HE-SIG-A is successfully received, since it contains
4467 // indication about the BW used for the transmission and the PHY shall detect it is larger than
4468 // its operating BW.
4469 m_txPhy->SetOperatingChannel(WifiPhy::ChannelTuple{38, 40, WIFI_PHY_BAND_5GHZ, 0});
4470 m_rxPhy->SetOperatingChannel(WifiPhy::ChannelTuple{36, 20, WIFI_PHY_BAND_5GHZ, 0});
4471
4472 Simulator::Schedule(Seconds(1.0), &TestUnsupportedBandwidthReception::SendPpdu, this, 5190, 40);
4473
4474 auto heSigAExpectedRxTime = Seconds(1.0) + MicroSeconds(32);
4475 Simulator::Schedule(Seconds(1.5),
4476 &TestUnsupportedBandwidthReception::CheckRx,
4477 this,
4478 0,
4479 0,
4480 1,
4481 std::nullopt,
4482 std::nullopt,
4483 heSigAExpectedRxTime);
4484
4485 // TODO: this test can be extended with other scenarios
4486
4487 Simulator::Run();
4488 Simulator::Destroy();
4489}
4490
4499class TestPrimary20CoveredByPpdu : public TestCase
4500{
4501 public:
4502 TestPrimary20CoveredByPpdu();
4503
4504 private:
4505 void DoSetup() override;
4506 void DoRun() override;
4507 void DoTeardown() override;
4508
4515 Ptr<HePpdu> CreatePpdu(uint16_t ppduCenterFreqMhz);
4516
4529 void RunOne(WifiPhyBand band,
4530 uint16_t phyCenterFreqMhz,
4531 uint8_t p20Index,
4532 uint16_t ppduCenterFreqMhz,
4533 bool expectedP20Overlap,
4534 bool expectedP20Covered);
4535
4536 Ptr<SpectrumWifiPhy> m_rxPhy;
4537 Ptr<SpectrumWifiPhy> m_txPhy;
4538};
4539
4540TestPrimary20CoveredByPpdu::TestPrimary20CoveredByPpdu()
4541 : TestCase("Check correct detection of whether P20 is fully covered (hence it can be received) "
4542 "or overlaps with the bandwidth of an incoming PPDU")
4543{
4544}
4545
4546Ptr<HePpdu>
4547TestPrimary20CoveredByPpdu::CreatePpdu(uint16_t ppduCenterFreqMhz)
4548{
4549 [[maybe_unused]] auto [channelNumber, centerFreq, channelWidth, type, phyBand] =
4550 (*WifiPhyOperatingChannel::FindFirst(0,
4551 ppduCenterFreqMhz,
4552 0,
4553 WIFI_STANDARD_80211ax,
4554 m_rxPhy->GetPhyBand()));
4555 m_txPhy->SetOperatingChannel(WifiPhy::ChannelTuple{channelNumber, channelWidth, phyBand, 0});
4556 auto txVector =
4557 WifiTxVector(HePhy::GetHeMcs7(), 0, WIFI_PREAMBLE_HE_SU, 800, 1, 1, 0, channelWidth, false);
4558
4559 auto pkt = Create<Packet>(1000);
4560 WifiMacHeader hdr(WIFI_MAC_QOSDATA);
4561
4562 auto psdu = Create<WifiPsdu>(pkt, hdr);
4563 auto txDuration = m_txPhy->CalculateTxDuration(psdu->GetSize(), txVector, phyBand);
4564
4565 return Create<HePpdu>(psdu, txVector, m_txPhy->GetOperatingChannel(), txDuration, 0);
4566}
4567
4568void
4569TestPrimary20CoveredByPpdu::DoSetup()
4570{
4571 m_rxPhy = CreateObject<SpectrumWifiPhy>();
4572 auto rxInterferenceHelper = CreateObject<InterferenceHelper>();
4573 m_rxPhy->SetInterferenceHelper(rxInterferenceHelper);
4574 auto rxErrorRateModel = CreateObject<NistErrorRateModel>();
4575 m_rxPhy->SetErrorRateModel(rxErrorRateModel);
4576 m_rxPhy->AddChannel(CreateObject<MultiModelSpectrumChannel>());
4577 m_rxPhy->ConfigureStandard(WIFI_STANDARD_80211ax);
4578
4579 m_txPhy = CreateObject<SpectrumWifiPhy>();
4580 auto txInterferenceHelper = CreateObject<InterferenceHelper>();
4581 m_txPhy->SetInterferenceHelper(txInterferenceHelper);
4582 auto txErrorRateModel = CreateObject<NistErrorRateModel>();
4583 m_txPhy->SetErrorRateModel(txErrorRateModel);
4584 m_txPhy->AddChannel(CreateObject<MultiModelSpectrumChannel>());
4585 m_txPhy->ConfigureStandard(WIFI_STANDARD_80211ax);
4586}
4587
4588void
4589TestPrimary20CoveredByPpdu::DoTeardown()
4590{
4591 m_rxPhy->Dispose();
4592 m_rxPhy = nullptr;
4593 m_txPhy->Dispose();
4594 m_txPhy = nullptr;
4595}
4596
4597void
4598TestPrimary20CoveredByPpdu::RunOne(WifiPhyBand band,
4599 uint16_t phyCenterFreqMhz,
4600 uint8_t p20Index,
4601 uint16_t ppduCenterFreqMhz,
4602 bool expectedP20Overlap,
4603 bool expectedP20Covered)
4604{
4605 [[maybe_unused]] const auto [channelNumber, centerFreq, channelWidth, type, phyBand] =
4606 (*WifiPhyOperatingChannel::FindFirst(0, phyCenterFreqMhz, 0, WIFI_STANDARD_80211ax, band));
4607
4608 m_rxPhy->SetOperatingChannel(
4609 WifiPhy::ChannelTuple{channelNumber, channelWidth, band, p20Index});
4610 auto p20CenterFreq = m_rxPhy->GetOperatingChannel().GetPrimaryChannelCenterFrequency(20);
4611 auto p20MinFreq = p20CenterFreq - 10;
4612 auto p20MaxFreq = p20CenterFreq + 10;
4613
4614 auto ppdu = CreatePpdu(ppduCenterFreqMhz);
4615
4616 auto p20Overlap = ppdu->DoesOverlapChannel(p20MinFreq, p20MaxFreq);
4617 NS_TEST_ASSERT_MSG_EQ(p20Overlap,
4618 expectedP20Overlap,
4619 "PPDU is " << (expectedP20Overlap ? "expected" : "not expected")
4620 << " to overlap with the P20");
4621
4622 auto p20Covered =
4623 m_rxPhy->GetPhyEntity(WIFI_STANDARD_80211ax)
4624 ->CanStartRx(
4625 ppdu,
4626 ppdu->GetTxVector()
4627 .GetChannelWidth()); // CanStartRx returns true is the P20 is fully covered
4628 NS_TEST_ASSERT_MSG_EQ(p20Covered,
4629 expectedP20Covered,
4630 "PPDU is " << (expectedP20Covered ? "expected" : "not expected")
4631 << " to cover the whole P20");
4632}
4633
4634void
4635TestPrimary20CoveredByPpdu::DoRun()
4636{
4637 /*
4638 * Receiver PHY Operating Channel: 2.4 GHz Channel 4 (2417 MHz – 2437 MHz)
4639 * Transmitted 20 MHz PPDU: 2.4 GHz Channel 4 (2417 MHz – 2437 MHz)
4640 * Overlap with primary 20 MHz: yes
4641 * Primary 20 MHz fully covered: yes
4642 */
4643 RunOne(WIFI_PHY_BAND_2_4GHZ, 2427, 0, 2427, true, true);
4644
4645 /*
4646 * Receiver PHY Operating Channel: 2.4 GHz Channel 4 (2417 MHz – 2437 MHz)
4647 * Transmitted 20 MHz PPDU: 2.4 GHz Channel 6 (2427 MHz – 2447 MHz)
4648 * Overlap with primary 20 MHz: yes
4649 * Primary 20 MHz fully covered: no
4650 */
4651 RunOne(WIFI_PHY_BAND_2_4GHZ, 2427, 0, 2437, true, false);
4652
4653 /*
4654 * Receiver PHY Operating Channel: 5 GHz Channel 36 (5170 MHz – 5190 MHz)
4655 * Transmitted 40 MHz PPDU: 5 GHz Channel 38 (5170 MHz – 5210 MHz)
4656 * Overlap with primary 20 MHz: yes
4657 * Primary 20 MHz fully covered: yes
4658 */
4659 RunOne(WIFI_PHY_BAND_5GHZ, 5180, 0, 5190, true, true);
4660
4661 /*
4662 * Receiver PHY Operating Channel: 5 GHz Channel 36 (5170 MHz–5190 MHz)
4663 * Transmitted 20 MHz PPDU: 5 GHz Channel 40 (5190 MHz – 5210 MHz)
4664 * Overlap with primary 20 MHz: no
4665 * Primary 20 MHz fully covered: no
4666 */
4667 RunOne(WIFI_PHY_BAND_5GHZ, 5180, 0, 5200, false, false);
4668
4669 /*
4670 * Receiver PHY Operating Channel: 5 GHz Channel 38 (5170 MHz – 5210 MHz) with P20 index 0
4671 * Transmitted 20 MHz PPDU: 5 GHz Channel 36 (5170 MHz – 5190 MHz)
4672 * Overlap with primary 20 MHz: yes
4673 * Primary 20 MHz fully covered: yes
4674 */
4675 RunOne(WIFI_PHY_BAND_5GHZ, 5190, 0, 5180, true, true);
4676
4677 /*
4678 * Receiver PHY Operating Channel: 5 GHz Channel 38 (5170 MHz – 5210 MHz) with P20 index 1
4679 * Transmitted 20 MHz PPDU: 5 GHz Channel 36 (5170 MHz – 5190 MHz)
4680 * Overlap with primary 20 MHz: no
4681 * Primary 20 MHz fully covered: no
4682 */
4683 RunOne(WIFI_PHY_BAND_5GHZ, 5190, 1, 5180, false, false);
4684
4685 Simulator::Destroy();
4686}
4687
4697class TestSpectrumChannelWithBandwidthFilter : public TestCase
4698{
4699 public:
4706 TestSpectrumChannelWithBandwidthFilter(uint16_t channel, uint16_t expectedValue);
4707
4708 protected:
4709 void DoSetup() override;
4710 void DoTeardown() override;
4711
4712 private:
4721 void RxBegin(bool signalType, uint32_t senderNodeId, double rxPower, Time duration);
4722
4726 void Send() const;
4727
4733 void CheckRxPacketCount(uint16_t expectedValue);
4734
4735 void DoRun() override;
4736
4737 Ptr<SpectrumWifiPhy> m_tx{nullptr};
4738 Ptr<SpectrumWifiPhy> m_rx{nullptr};
4739 uint32_t m_countRxBegin{0};
4740 uint16_t m_channel{36};
4741 uint16_t m_expectedValue{0};
4742};
4743
4744TestSpectrumChannelWithBandwidthFilter::TestSpectrumChannelWithBandwidthFilter(
4745 uint16_t channel,
4746 uint16_t expectedValue)
4747 : TestCase("Test for early discard of signal in single-model-spectrum-channel::StartTx()"),
4748 m_channel(channel),
4749 m_expectedValue(expectedValue)
4750{
4751}
4752
4753void
4754TestSpectrumChannelWithBandwidthFilter::Send() const
4755{
4756 WifiTxVector txVector =
4757 WifiTxVector(HePhy::GetHeMcs7(), 0, WIFI_PREAMBLE_HE_SU, 800, 1, 1, 0, 20, false);
4758
4759 Ptr<Packet> pkt = Create<Packet>(1000);
4760 WifiMacHeader hdr;
4761
4762 hdr.SetType(WIFI_MAC_QOSDATA);
4763 hdr.SetQosTid(0);
4764
4765 Ptr<WifiPsdu> psdu = Create<WifiPsdu>(pkt, hdr);
4766 m_tx->Send(psdu, txVector);
4767}
4768
4769void
4770TestSpectrumChannelWithBandwidthFilter::CheckRxPacketCount(uint16_t expectedValue)
4771{
4772 NS_TEST_ASSERT_MSG_EQ(m_countRxBegin,
4773 expectedValue,
4774 "Received a different amount of packets than expected.");
4775}
4776
4777void
4778TestSpectrumChannelWithBandwidthFilter::RxBegin(bool signalType [[maybe_unused]],
4779 uint32_t senderNodeId [[maybe_unused]],
4780 double rxPower [[maybe_unused]],
4781 Time duration [[maybe_unused]])
4782{
4783 NS_LOG_FUNCTION(this << signalType << senderNodeId << rxPower << duration);
4784 m_countRxBegin++;
4785}
4786
4787void
4788TestSpectrumChannelWithBandwidthFilter::DoSetup()
4789{
4790 NS_LOG_FUNCTION(this);
4791 Ptr<SingleModelSpectrumChannel> channel = CreateObject<SingleModelSpectrumChannel>();
4792
4793 Ptr<WifiBandwidthFilter> wifiFilter = CreateObject<WifiBandwidthFilter>();
4794 channel->AddSpectrumTransmitFilter(wifiFilter);
4795
4796 Ptr<Node> node = CreateObject<Node>();
4797 Ptr<WifiNetDevice> dev = CreateObject<WifiNetDevice>();
4798 m_tx = CreateObject<SpectrumWifiPhy>();
4799 m_tx->SetDevice(dev);
4800 m_tx->SetTxPowerStart(20);
4801 m_tx->SetTxPowerEnd(20);
4802
4803 Ptr<Node> nodeRx = CreateObject<Node>();
4804 Ptr<WifiNetDevice> devRx = CreateObject<WifiNetDevice>();
4805 m_rx = CreateObject<SpectrumWifiPhy>();
4806 m_rx->SetDevice(devRx);
4807
4808 Ptr<InterferenceHelper> interferenceTx = CreateObject<InterferenceHelper>();
4809 m_tx->SetInterferenceHelper(interferenceTx);
4810 Ptr<ErrorRateModel> errorTx = CreateObject<NistErrorRateModel>();
4811 m_tx->SetErrorRateModel(errorTx);
4812
4813 Ptr<InterferenceHelper> interferenceRx = CreateObject<InterferenceHelper>();
4814 m_rx->SetInterferenceHelper(interferenceRx);
4815 Ptr<ErrorRateModel> errorRx = CreateObject<NistErrorRateModel>();
4816 m_rx->SetErrorRateModel(errorRx);
4817
4818 m_tx->AddChannel(channel);
4819 m_rx->AddChannel(channel);
4820
4821 m_tx->ConfigureStandard(WIFI_STANDARD_80211ax);
4822 m_rx->ConfigureStandard(WIFI_STANDARD_80211ax);
4823
4824 dev->SetPhy(m_tx);
4825 node->AddDevice(dev);
4826 devRx->SetPhy(m_rx);
4827 nodeRx->AddDevice(devRx);
4828
4829 m_rx->TraceConnectWithoutContext(
4830 "SignalArrival",
4831 MakeCallback(&TestSpectrumChannelWithBandwidthFilter::RxBegin, this));
4832}
4833
4834void
4835TestSpectrumChannelWithBandwidthFilter::DoTeardown()
4836{
4837 m_tx->Dispose();
4838 m_rx->Dispose();
4839}
4840
4841void
4842TestSpectrumChannelWithBandwidthFilter::DoRun()
4843{
4844 NS_LOG_FUNCTION(this);
4845 m_tx->SetOperatingChannel(WifiPhy::ChannelTuple{m_channel, 0, WIFI_PHY_BAND_5GHZ, 0});
4846 m_rx->SetOperatingChannel(WifiPhy::ChannelTuple{36, 0, WIFI_PHY_BAND_5GHZ, 0});
4847
4848 Simulator::Schedule(MilliSeconds(100), &TestSpectrumChannelWithBandwidthFilter::Send, this);
4849 Simulator::Schedule(MilliSeconds(101),
4850 &TestSpectrumChannelWithBandwidthFilter::CheckRxPacketCount,
4851 this,
4852 m_expectedValue);
4853
4854 Simulator::Run();
4855 Simulator::Destroy();
4856}
4857
4864class WifiPhyReceptionTestSuite : public TestSuite
4865{
4866 public:
4867 WifiPhyReceptionTestSuite();
4868};
4869
4870WifiPhyReceptionTestSuite::WifiPhyReceptionTestSuite()
4871 : TestSuite("wifi-phy-reception", UNIT)
4872{
4873 AddTestCase(new TestThresholdPreambleDetectionWithoutFrameCapture, TestCase::QUICK);
4874 AddTestCase(new TestThresholdPreambleDetectionWithFrameCapture, TestCase::QUICK);
4875 AddTestCase(new TestSimpleFrameCaptureModel, TestCase::QUICK);
4876 AddTestCase(new TestPhyHeadersReception, TestCase::QUICK);
4877 AddTestCase(new TestAmpduReception, TestCase::QUICK);
4878 AddTestCase(new TestUnsupportedModulationReception(), TestCase::QUICK);
4879 AddTestCase(new TestUnsupportedBandwidthReception(), TestCase::QUICK);
4880 AddTestCase(new TestPrimary20CoveredByPpdu(), TestCase::QUICK);
4881 // The below three test cases are related. The test involves a receiver tuned to
4882 // channel 36 and a transmitter sending on channels 36, 40, and 44, respectively.
4883 // The second argument corresponds to the number of signals expected to be received.
4884 // Signals on channel 36 and 40 will fall within the receiver bandwidth, while
4885 // a signal on channel 44 will fall completely outside and will be filtered.
4886 AddTestCase(new TestSpectrumChannelWithBandwidthFilter(36, 1), TestCase::QUICK);
4887 AddTestCase(new TestSpectrumChannelWithBandwidthFilter(40, 1), TestCase::QUICK);
4888 AddTestCase(new TestSpectrumChannelWithBandwidthFilter(44, 0), TestCase::QUICK);
4889}
4890
4891static WifiPhyReceptionTestSuite wifiPhyReceptionTestSuite;
TestAmpduReception
A-MPDU reception test.
Definition: wifi-phy-reception-test.cc:2468
TestAmpduReception::RxSuccess
void RxSuccess(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, WifiTxVector txVector, std::vector< bool > statusPerMpdu)
RX success function.
Definition: wifi-phy-reception-test.cc:2587
TestAmpduReception::IncrementSuccessBitmap
void IncrementSuccessBitmap(uint32_t size)
Increment reception success bitmap.
Definition: wifi-phy-reception-test.cc:2615
TestAmpduReception::m_rxDroppedBitmapAmpdu2
uint8_t m_rxDroppedBitmapAmpdu2
bitmap of dropped MPDUs in A-MPDU #2
Definition: wifi-phy-reception-test.cc:2567
TestAmpduReception::CheckRxSuccessBitmapAmpdu2
void CheckRxSuccessBitmapAmpdu2(uint8_t expected)
Check the RX success bitmap for A-MPDU 2.
Definition: wifi-phy-reception-test.cc:2721
TestAmpduReception::DoRun
void DoRun() override
Implementation to actually run this TestCase.
Definition: wifi-phy-reception-test.cc:2835
TestAmpduReception::CheckRxDroppedBitmapAmpdu1
void CheckRxDroppedBitmapAmpdu1(uint8_t expected)
Check the RX dropped bitmap for A-MPDU 1.
Definition: wifi-phy-reception-test.cc:2745
TestAmpduReception::m_rxSuccessBitmapAmpdu1
uint8_t m_rxSuccessBitmapAmpdu1
bitmap of successfully received MPDUs in A-MPDU #1
Definition: wifi-phy-reception-test.cc:2560
TestAmpduReception::m_rxFailureBitmapAmpdu1
uint8_t m_rxFailureBitmapAmpdu1
bitmap of unsuccessfully received MPDUs in A-MPDU #1
Definition: wifi-phy-reception-test.cc:2563
TestAmpduReception::m_rxFailureBitmapAmpdu2
uint8_t m_rxFailureBitmapAmpdu2
bitmap of unsuccessfully received MPDUs in A-MPDU #2
Definition: wifi-phy-reception-test.cc:2564
TestAmpduReception::RxDropped
void RxDropped(Ptr< const Packet > p, WifiPhyRxfailureReason reason)
RX dropped function.
Definition: wifi-phy-reception-test.cc:2683
TestAmpduReception::SendAmpduWithThreeMpdus
void SendAmpduWithThreeMpdus(double rxPowerDbm, uint32_t referencePacketSize)
Send A-MPDU with 3 MPDUs of different size (i-th MSDU will have 100 bytes more than (i-1)-th).
Definition: wifi-phy-reception-test.cc:2775
TestAmpduReception::RxFailure
void RxFailure(Ptr< const WifiPsdu > psdu)
RX failure function.
Definition: wifi-phy-reception-test.cc:2644
TestAmpduReception::CheckRxFailureBitmapAmpdu2
void CheckRxFailureBitmapAmpdu2(uint8_t expected)
Check the RX failure bitmap for A-MPDU 2.
Definition: wifi-phy-reception-test.cc:2737
TestAmpduReception::m_rxDroppedBitmapAmpdu1
uint8_t m_rxDroppedBitmapAmpdu1
bitmap of dropped MPDUs in A-MPDU #1
Definition: wifi-phy-reception-test.cc:2566
TestAmpduReception::IncrementFailureBitmap
void IncrementFailureBitmap(uint32_t size)
Increment reception failure bitmap.
Definition: wifi-phy-reception-test.cc:2654
TestAmpduReception::DoSetup
void DoSetup() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:2814
TestAmpduReception::ResetBitmaps
void ResetBitmaps()
Reset bitmaps function.
Definition: wifi-phy-reception-test.cc:2576
TestAmpduReception::CheckPhyState
void CheckPhyState(WifiPhyState expectedState)
Check the PHY state.
Definition: wifi-phy-reception-test.cc:2761
TestAmpduReception::CheckRxSuccessBitmapAmpdu1
void CheckRxSuccessBitmapAmpdu1(uint8_t expected)
Check the RX success bitmap for A-MPDU 1.
Definition: wifi-phy-reception-test.cc:2713
TestAmpduReception::CheckRxFailureBitmapAmpdu1
void CheckRxFailureBitmapAmpdu1(uint8_t expected)
Check the RX failure bitmap for A-MPDU 1.
Definition: wifi-phy-reception-test.cc:2729
TestAmpduReception::m_rxSuccessBitmapAmpdu2
uint8_t m_rxSuccessBitmapAmpdu2
bitmap of successfully received MPDUs in A-MPDU #2
Definition: wifi-phy-reception-test.cc:2561
TestAmpduReception::CheckRxDroppedBitmapAmpdu2
void CheckRxDroppedBitmapAmpdu2(uint8_t expected)
Check the RX dropped bitmap for A-MPDU 2.
Definition: wifi-phy-reception-test.cc:2753
TestPhyHeadersReception
Test PHY state upon success or failure of L-SIG and SIG-A.
Definition: wifi-phy-reception-test.cc:2086
TestPhyHeadersReception::DoRun
void DoRun() override
Implementation to actually run this TestCase.
Definition: wifi-phy-reception-test.cc:2100
TestPrimary20CoveredByPpdu
Primary 20 MHz Covered By Ppdu Test This test checks whether the functions WifiPpdu::DoesOverlapChann...
Definition: wifi-phy-reception-test.cc:4500
TestPrimary20CoveredByPpdu::m_rxPhy
Ptr< SpectrumWifiPhy > m_rxPhy
RX PHY.
Definition: wifi-phy-reception-test.cc:4536
TestPrimary20CoveredByPpdu::RunOne
void RunOne(WifiPhyBand band, uint16_t phyCenterFreqMhz, uint8_t p20Index, uint16_t ppduCenterFreqMhz, bool expectedP20Overlap, bool expectedP20Covered)
Run one function.
Definition: wifi-phy-reception-test.cc:4598
TestPrimary20CoveredByPpdu::CreatePpdu
Ptr< HePpdu > CreatePpdu(uint16_t ppduCenterFreqMhz)
Function to create a PPDU.
Definition: wifi-phy-reception-test.cc:4547
TestPrimary20CoveredByPpdu::DoSetup
void DoSetup() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:4569
TestPrimary20CoveredByPpdu::DoRun
void DoRun() override
Implementation to actually run this TestCase.
Definition: wifi-phy-reception-test.cc:4635
TestPrimary20CoveredByPpdu::DoTeardown
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:4589
TestPrimary20CoveredByPpdu::m_txPhy
Ptr< SpectrumWifiPhy > m_txPhy
TX PHY.
Definition: wifi-phy-reception-test.cc:4537
TestSimpleFrameCaptureModel
Simple frame capture model test.
Definition: wifi-phy-reception-test.cc:1844
TestSimpleFrameCaptureModel::Expect1000BPacketReceived
void Expect1000BPacketReceived()
Verify whether 1000 bytes packet has been received.
Definition: wifi-phy-reception-test.cc:1944
TestSimpleFrameCaptureModel::m_rxDropped1500B
bool m_rxDropped1500B
count dropped packets with 1500B payload
Definition: wifi-phy-reception-test.cc:1894
TestSimpleFrameCaptureModel::DoSetup
void DoSetup() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:1968
TestSimpleFrameCaptureModel::Expect1500BPacketDropped
void Expect1500BPacketDropped()
Verify whether 1500 bytes packet has been dropped.
Definition: wifi-phy-reception-test.cc:1962
TestSimpleFrameCaptureModel::Expect1000BPacketDropped
void Expect1000BPacketDropped()
Verify whether 1000 bytes packet has been dropped.
Definition: wifi-phy-reception-test.cc:1956
TestSimpleFrameCaptureModel::RxSuccess
void RxSuccess(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, WifiTxVector txVector, std::vector< bool > statusPerMpdu)
Spectrum wifi receive success function.
Definition: wifi-phy-reception-test.cc:1903
TestSimpleFrameCaptureModel::RxDropped
void RxDropped(Ptr< const Packet > p, WifiPhyRxfailureReason reason)
RX dropped function.
Definition: wifi-phy-reception-test.cc:1921
TestSimpleFrameCaptureModel::DoRun
void DoRun() override
Implementation to actually run this TestCase.
Definition: wifi-phy-reception-test.cc:1988
TestSimpleFrameCaptureModel::m_rxSuccess1000B
bool m_rxSuccess1000B
count received packets with 1000B payload
Definition: wifi-phy-reception-test.cc:1891
TestSimpleFrameCaptureModel::m_rxSuccess1500B
bool m_rxSuccess1500B
count received packets with 1500B payload
Definition: wifi-phy-reception-test.cc:1892
TestSimpleFrameCaptureModel::Expect1500BPacketReceived
void Expect1500BPacketReceived()
Verify whether 1500 bytes packet has been received.
Definition: wifi-phy-reception-test.cc:1950
TestSimpleFrameCaptureModel::m_rxDropped1000B
bool m_rxDropped1000B
count dropped packets with 1000B payload
Definition: wifi-phy-reception-test.cc:1893
TestSpectrumChannelWithBandwidthFilter
This test verifies the correct function of the WifiBandwidthFilter.
Definition: wifi-phy-reception-test.cc:4698
TestSpectrumChannelWithBandwidthFilter::DoSetup
void DoSetup() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:4788
TestSpectrumChannelWithBandwidthFilter::m_expectedValue
uint16_t m_expectedValue
expected count of receive events
Definition: wifi-phy-reception-test.cc:4741
TestSpectrumChannelWithBandwidthFilter::Send
void Send() const
Send function (sends a single packet)
Definition: wifi-phy-reception-test.cc:4754
TestSpectrumChannelWithBandwidthFilter::TestSpectrumChannelWithBandwidthFilter
TestSpectrumChannelWithBandwidthFilter(uint16_t channel, uint16_t expectedValue)
Constructor.
Definition: wifi-phy-reception-test.cc:4744
TestSpectrumChannelWithBandwidthFilter::m_tx
Ptr< SpectrumWifiPhy > m_tx
transmit function
Definition: wifi-phy-reception-test.cc:4737
TestSpectrumChannelWithBandwidthFilter::m_rx
Ptr< SpectrumWifiPhy > m_rx
receive function
Definition: wifi-phy-reception-test.cc:4738
TestSpectrumChannelWithBandwidthFilter::RxBegin
void RxBegin(bool signalType, uint32_t senderNodeId, double rxPower, Time duration)
Callback invoked when the PHY model starts to process a signal.
Definition: wifi-phy-reception-test.cc:4778
TestSpectrumChannelWithBandwidthFilter::DoRun
void DoRun() override
Implementation to actually run this TestCase.
Definition: wifi-phy-reception-test.cc:4842
TestSpectrumChannelWithBandwidthFilter::CheckRxPacketCount
void CheckRxPacketCount(uint16_t expectedValue)
Event scheduled at end of simulation for validation.
Definition: wifi-phy-reception-test.cc:4770
TestSpectrumChannelWithBandwidthFilter::DoTeardown
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:4835
TestSpectrumChannelWithBandwidthFilter::m_channel
uint16_t m_channel
channel for packet transmission
Definition: wifi-phy-reception-test.cc:4740
TestSpectrumChannelWithBandwidthFilter::m_countRxBegin
uint32_t m_countRxBegin
count of receive events
Definition: wifi-phy-reception-test.cc:4739
TestThresholdPreambleDetectionWithFrameCapture
Preamble detection test w/o frame capture.
Definition: wifi-phy-reception-test.cc:825
TestThresholdPreambleDetectionWithFrameCapture::RxFailure
void RxFailure(Ptr< const WifiPsdu > psdu)
Spectrum wifi receive failure function.
Definition: wifi-phy-reception-test.cc:891
TestThresholdPreambleDetectionWithFrameCapture::DoSetup
void DoSetup() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:898
TestThresholdPreambleDetectionWithFrameCapture::RxSuccess
void RxSuccess(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, WifiTxVector txVector, std::vector< bool > statusPerMpdu)
Spectrum wifi receive success function.
Definition: wifi-phy-reception-test.cc:881
TestThresholdPreambleDetectionWithFrameCapture::DoRun
void DoRun() override
Implementation to actually run this TestCase.
Definition: wifi-phy-reception-test.cc:920
TestThresholdPreambleDetectionWithFrameCapture::CheckRxPacketCount
void CheckRxPacketCount(uint32_t expectedSuccessCount, uint32_t expectedFailureCount)
Check the number of received packets.
Definition: wifi-phy-reception-test.cc:869
TestThresholdPreambleDetectionWithoutFrameCapture
Preamble detection test w/o frame capture.
Definition: wifi-phy-reception-test.cc:209
TestThresholdPreambleDetectionWithoutFrameCapture::DoRun
void DoRun() override
Implementation to actually run this TestCase.
Definition: wifi-phy-reception-test.cc:300
TestThresholdPreambleDetectionWithoutFrameCapture::RxSuccess
void RxSuccess(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, WifiTxVector txVector, std::vector< bool > statusPerMpdu)
Spectrum wifi receive success function.
Definition: wifi-phy-reception-test.cc:266
TestThresholdPreambleDetectionWithoutFrameCapture::CheckRxPacketCount
void CheckRxPacketCount(uint32_t expectedSuccessCount, uint32_t expectedFailureCount)
Check the number of received packets.
Definition: wifi-phy-reception-test.cc:254
TestThresholdPreambleDetectionWithoutFrameCapture::DoSetup
void DoSetup() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:283
TestThresholdPreambleDetectionWithoutFrameCapture::RxFailure
void RxFailure(Ptr< const WifiPsdu > psdu)
Spectrum wifi receive failure function.
Definition: wifi-phy-reception-test.cc:276
TestUnsupportedBandwidthReception
Unsupported Bandwidth Reception Test This test checks whether a PHY receiving a PPDU sent over a chan...
Definition: wifi-phy-reception-test.cc:4218
TestUnsupportedBandwidthReception::DoSetup
void DoSetup() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:4413
TestUnsupportedBandwidthReception::m_rxPhy
Ptr< SpectrumWifiPhy > m_rxPhy
RX PHY.
Definition: wifi-phy-reception-test.cc:4286
TestUnsupportedBandwidthReception::m_lastRxDropped
std::optional< Time > m_lastRxDropped
time of last RX drop, if any
Definition: wifi-phy-reception-test.cc:4284
TestUnsupportedBandwidthReception::m_txPhy
Ptr< SpectrumWifiPhy > m_txPhy
TX PHY.
Definition: wifi-phy-reception-test.cc:4287
TestUnsupportedBandwidthReception::m_lastRxSucceeded
std::optional< Time > m_lastRxSucceeded
time of last RX success, if any
Definition: wifi-phy-reception-test.cc:4282
TestUnsupportedBandwidthReception::DoTeardown
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:4447
TestUnsupportedBandwidthReception::SendPpdu
void SendPpdu(uint16_t centerFreqMhz, uint16_t bandwidthMhz)
Function to create a PPDU.
Definition: wifi-phy-reception-test.cc:4303
TestUnsupportedBandwidthReception::CheckRx
void CheckRx(uint32_t expectedCountRxSuccess, uint32_t expectedCountRxFailure, uint32_t expectedCountRxDropped, std::optional< Time > expectedLastRxSucceeded, std::optional< Time > expectedLastRxFailed, std::optional< Time > expectedLastRxDropped)
Check the reception results.
Definition: wifi-phy-reception-test.cc:4365
TestUnsupportedBandwidthReception::RxFailure
void RxFailure(Ptr< const WifiPsdu > psdu)
Function called upon a PSDU received unsuccessfuly.
Definition: wifi-phy-reception-test.cc:4348
TestUnsupportedBandwidthReception::RxSuccess
void RxSuccess(Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, WifiTxVector txVector, std::vector< bool > statusPerMpdu)
Function called upon a PSDU received successfully.
Definition: wifi-phy-reception-test.cc:4337
TestUnsupportedBandwidthReception::DoRun
void DoRun() override
Implementation to actually run this TestCase.
Definition: wifi-phy-reception-test.cc:4457
TestUnsupportedBandwidthReception::m_lastRxFailed
std::optional< Time > m_lastRxFailed
time of last RX failure, if any
Definition: wifi-phy-reception-test.cc:4283
TestUnsupportedBandwidthReception::RxDropped
void RxDropped(Ptr< const Packet > packet, WifiPhyRxfailureReason reason)
Function called upon a PSDU dropped by the PHY.
Definition: wifi-phy-reception-test.cc:4356
TestUnsupportedModulationReception
Unsupported Modulation Reception Test This test creates a mixed network, in which an HE STA and a VHT...
Definition: wifi-phy-reception-test.cc:4023
TestUnsupportedModulationReception::DoRun
void DoRun() override
Implementation to actually run this TestCase.
Definition: wifi-phy-reception-test.cc:4066
TestUnsupportedModulationReception::CheckResults
void CheckResults()
Check correctness of transmitted frames.
Definition: wifi-phy-reception-test.cc:4201
TestUnsupportedModulationReception::Dropped
void Dropped(std::string context, Ptr< const Packet > packet, WifiPhyRxfailureReason reason)
Callback invoked when PHY drops an incoming packet.
Definition: wifi-phy-reception-test.cc:4053
TestUnsupportedModulationReception::~TestUnsupportedModulationReception
~TestUnsupportedModulationReception() override=default
TestUnsupportedModulationReception::m_dropped
uint16_t m_dropped
number of packets dropped by the AP because it was already receiving
Definition: wifi-phy-reception-test.cc:4043
WifiPhyReceptionTest
Wifi Phy Reception Test base class.
Definition: wifi-phy-reception-test.cc:74
WifiPhyReceptionTest::WifiPhyReceptionTest
WifiPhyReceptionTest(std::string test_name)
Constructor.
Definition: wifi-phy-reception-test.cc:114
WifiPhyReceptionTest::DoTeardown
void DoTeardown() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:196
WifiPhyReceptionTest::~WifiPhyReceptionTest
~WifiPhyReceptionTest() override=default
Destructor.
WifiPhyReceptionTest::DoCheckPhyState
void DoCheckPhyState(WifiPhyState expectedState)
Check the PHY state now.
Definition: wifi-phy-reception-test.cc:162
WifiPhyReceptionTest::CheckPhyState
void CheckPhyState(WifiPhyState expectedState)
Schedule now to check the PHY state.
Definition: wifi-phy-reception-test.cc:154
WifiPhyReceptionTest::m_uid
uint64_t m_uid
the UID to use for the PPDU
Definition: wifi-phy-reception-test.cc:111
WifiPhyReceptionTest::SendPacket
void SendPacket(double rxPowerDbm, uint32_t packetSize, uint8_t mcs)
Send packet function.
Definition: wifi-phy-reception-test.cc:120
WifiPhyReceptionTest::m_phy
Ptr< SpectrumWifiPhy > m_phy
the PHY
Definition: wifi-phy-reception-test.cc:110
WifiPhyReceptionTest::DoSetup
void DoSetup() override
Implementation to do any local setup required for this TestCase.
Definition: wifi-phy-reception-test.cc:177
WifiPhyReceptionTestSuite
wifi PHY reception Test Suite
Definition: wifi-phy-reception-test.cc:4865
ns3::BooleanValue
AttributeValue implementation for Boolean.
Definition: boolean.h:37
ns3::DoubleValue
This class can be used to hold variables of floating point type such as 'double' or 'float'.
Definition: double.h:42
ns3::HePhy::GetHeMcs
static WifiMode GetHeMcs(uint8_t index)
Return the HE MCS corresponding to the provided index.
Definition: he-phy.cc:1562
ns3::HePhy::GetHeMcs0
static WifiMode GetHeMcs0()
Return MCS 0 from HE MCS values.
ns3::HePhy::GetHeMcs7
static WifiMode GetHeMcs7()
Return MCS 7 from HE MCS values.
ns3::MobilityHelper
Helper class used to assign positions and mobility models to nodes.
Definition: mobility-helper.h:44
ns3::NetDeviceContainer
holds a vector of ns3::NetDevice pointers
Definition: net-device-container.h:43
ns3::NetDeviceContainer::Add
void Add(NetDeviceContainer other)
Append the contents of another NetDeviceContainer to the end of this container.
Definition: net-device-container.cc:73
ns3::NetDeviceContainer::Get
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
Definition: net-device-container.cc:67
ns3::NodeContainer
keep track of a set of node pointers.
Definition: node-container.h:40
ns3::ObjectBase::TraceConnectWithoutContext
bool TraceConnectWithoutContext(std::string name, const CallbackBase &cb)
Connect a TraceSource to a Callback without a context.
Definition: object-base.cc:311
ns3::ObjectBase::GetAttribute
void GetAttribute(std::string name, AttributeValue &value) const
Get the value of an attribute, raising fatal errors if unsuccessful.
Definition: object-base.cc:240
ns3::Object::Dispose
void Dispose()
Dispose of this Object.
Definition: object.cc:219
ns3::PacketSocketAddress
an address for a packet socket
Definition: packet-socket-address.h:40
ns3::PacketSocketAddress::SetProtocol
void SetProtocol(uint16_t protocol)
Set the protocol.
Definition: packet-socket-address.cc:35
ns3::PacketSocketAddress::SetPhysicalAddress
void SetPhysicalAddress(const Address address)
Set the destination address.
Definition: packet-socket-address.cc:58
ns3::PacketSocketAddress::SetSingleDevice
void SetSingleDevice(uint32_t device)
Set the address to match only a specified NetDevice.
Definition: packet-socket-address.cc:50
ns3::PacketSocketHelper
Give ns3::PacketSocket powers to ns3::Node.
Definition: packet-socket-helper.h:32
ns3::PacketSocketHelper::Install
void Install(Ptr< Node > node) const
Aggregate an instance of a ns3::PacketSocketFactory onto the provided node.
Definition: packet-socket-helper.cc:38
ns3::PointerValue
Hold objects of type Ptr<T>.
Definition: pointer.h:37
ns3::PointerValue::Get
Ptr< T > Get() const
Definition: pointer.h:202
ns3::Ptr
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:78
ns3::RngSeedManager::SetRun
static void SetRun(uint64_t run)
Set the run number of simulation.
Definition: rng-seed-manager.cc:90
ns3::RngSeedManager::SetSeed
static void SetSeed(uint32_t seed)
Set the seed.
Definition: rng-seed-manager.cc:83
ns3::Simulator::Schedule
static EventId Schedule(const Time &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
Definition: simulator.h:568
ns3::Simulator::Destroy
static void Destroy()
Execute the events scheduled with ScheduleDestroy().
Definition: simulator.cc:140
ns3::Simulator::Now
static Time Now()
Return the current simulation virtual time.
Definition: simulator.cc:199
ns3::Simulator::Run
static void Run()
Run the simulation.
Definition: simulator.cc:176
ns3::Simulator::ScheduleNow
static EventId ScheduleNow(FUNC f, Ts &&... args)
Schedule an event to expire Now.
Definition: simulator.h:606
ns3::Simulator::Stop
static void Stop()
Tell the Simulator the calling event should be the last one executed.
Definition: simulator.cc:184
ns3::SpectrumWifiPhyHelper
Make it easy to create and manage PHY objects for the spectrum model.
Definition: spectrum-wifi-helper.h:41
ns3::SpectrumWifiPhy::SetDevice
void SetDevice(const Ptr< WifiNetDevice > device) override
Sets the device this PHY is associated with.
Definition: spectrum-wifi-phy.cc:454
ns3::SpectrumWifiPhy::StartRx
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...
Definition: spectrum-wifi-phy.cc:300
ns3::SpectrumWifiPhy::AddChannel
void AddChannel(const Ptr< SpectrumChannel > channel, const FrequencyRange &freqRange=WHOLE_WIFI_SPECTRUM)
Attach a SpectrumChannel to use for a given frequency range.
Definition: spectrum-wifi-phy.cc:179
ns3::Ssid
The IEEE 802.11 SSID Information Element.
Definition: ssid.h:36
SsidValue
AttributeValue implementation for Ssid.
ns3::TestCase
encapsulates test code
Definition: test.h:1060
ns3::TestCase::QUICK
@ QUICK
Fast test.
Definition: test.h:1065
ns3::TestCase::AddTestCase
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite.
Definition: test.cc:301
ns3::TestSuite
A suite of tests to run.
Definition: test.h:1256
ns3::Time
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
ns3::TimeValue
AttributeValue implementation for Time.
Definition: nstime.h:1423
ns3::UintegerValue
Hold an unsigned integer type.
Definition: uinteger.h:45
ns3::WifiHelper
helps to create WifiNetDevice objects
Definition: wifi-helper.h:324
ns3::WifiMacHeader
Implements the IEEE 802.11 MAC header.
Definition: wifi-mac-header.h:98
ns3::WifiMacHeader::SetType
void SetType(WifiMacType type, bool resetToDsFromDs=true)
Set Type/Subtype values with the correct values depending on the given type.
Definition: wifi-mac-header.cc:135
ns3::WifiMacHeader::SetQosTid
void SetQosTid(uint8_t tid)
Set the TID for the QoS header.
Definition: wifi-mac-header.cc:372
ns3::WifiMacHelper
create MAC layers for a ns3::WifiNetDevice.
Definition: wifi-mac-helper.h:48
ns3::WifiMac::SetSsid
void SetSsid(Ssid ssid)
Definition: wifi-mac.cc:456
ns3::WifiPhy::SetInterferenceHelper
virtual void SetInterferenceHelper(const Ptr< InterferenceHelper > helper)
Sets the interference helper.
Definition: wifi-phy.cc:633
ns3::WifiPhy::Send
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.
Definition: wifi-phy.cc:1709
ns3::WifiPhy::SetErrorRateModel
void SetErrorRateModel(const Ptr< ErrorRateModel > model)
Sets the error rate model.
Definition: wifi-phy.cc:641
ns3::WifiPhy::SetReceiveErrorCallback
void SetReceiveErrorCallback(RxErrorCallback callback)
Definition: wifi-phy.cc:457
ns3::WifiPhy::ConfigureStandard
virtual void ConfigureStandard(WifiStandard standard)
Configure the PHY-level parameters for different Wi-Fi standard.
Definition: wifi-phy.cc:950
ns3::WifiPhy::CalculateTxDuration
static Time CalculateTxDuration(uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, uint16_t staId=SU_STA_ID)
Definition: wifi-phy.cc:1496
ns3::WifiPhy::SetOperatingChannel
void SetOperatingChannel(const ChannelTuple &channelTuple)
If the standard for this object has not been set yet, store the given channel settings.
Definition: wifi-phy.cc:1082
ns3::WifiPhy::GetPhyBand
WifiPhyBand GetPhyBand() const
Get the configured Wi-Fi band.
Definition: wifi-phy.cc:1005
ns3::WifiPhy::GetPhyEntity
Ptr< PhyEntity > GetPhyEntity(WifiModulationClass modulation) const
Get the supported PHY entity corresponding to the modulation class.
Definition: wifi-phy.cc:713
ns3::WifiPhy::SetTxPowerEnd
void SetTxPowerEnd(double end)
Sets the maximum available transmission power level (dBm).
Definition: wifi-phy.cc:544
ns3::WifiPhy::SetPreambleDetectionModel
void SetPreambleDetectionModel(const Ptr< PreambleDetectionModel > preambleDetectionModel)
Sets the preamble detection model.
Definition: wifi-phy.cc:661
ns3::WifiPhy::SetReceiveOkCallback
void SetReceiveOkCallback(RxOkCallback callback)
Definition: wifi-phy.cc:451
ns3::WifiPhy::SetFrameCaptureModel
void SetFrameCaptureModel(const Ptr< FrameCaptureModel > frameCaptureModel)
Sets the frame capture model.
Definition: wifi-phy.cc:655
ns3::WifiPhy::ChannelTuple
std::tuple< uint8_t, uint16_t, int, uint8_t > ChannelTuple
Tuple identifying an operating channel.
Definition: wifi-phy.h:872
ns3::WifiPhy::GetOperatingChannel
const WifiPhyOperatingChannel & GetOperatingChannel() const
Get a const reference to the operating channel.
Definition: wifi-phy.cc:1017
ns3::WifiPhy::SetTxPowerStart
void SetTxPowerStart(double start)
Sets the minimum available transmission power level (dBm).
Definition: wifi-phy.cc:531
ns3::WifiPhy::AssignStreams
virtual int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model.
Definition: wifi-phy.cc:2180
ns3::WifiPhyOperatingChannel::FindFirst
static ConstIterator FindFirst(uint8_t number, uint16_t frequency, uint16_t width, WifiStandard standard, WifiPhyBand band, ConstIterator start=m_frequencyChannels.begin())
Find the first channel matching the specified parameters.
Definition: wifi-phy-operating-channel.cc:347
ns3::WifiPhyOperatingChannel::GetPrimaryChannelCenterFrequency
uint16_t GetPrimaryChannelCenterFrequency(uint16_t primaryChannelWidth) const
Get the center frequency of the primary channel of the given width.
Definition: wifi-phy-operating-channel.cc:492
ns3::WifiPhyStateHelper
This objects implements the PHY state machine of the Wifi device.
Definition: wifi-phy-state-helper.h:69
ns3::WifiSpectrumValueHelper::CreateHeOfdmTxPowerSpectralDensity
static Ptr< SpectrumValue > CreateHeOfdmTxPowerSpectralDensity(uint32_t centerFrequency, uint16_t channelWidth, double txPowerW, uint16_t guardBandwidth, double minInnerBandDbr=-20, double minOuterbandDbr=-28, double lowestPointDbr=-40, const std::vector< bool > &puncturedSubchannels=std::vector< bool >{})
Create a transmit power spectral density corresponding to OFDM High Efficiency (HE) (802....
Definition: wifi-spectrum-value-helper.cc:371
ns3::WifiTxVector
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
Definition: wifi-tx-vector.h:109
uint32_t
NS_ASSERT
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
Definition: assert.h:66
ns3::Config::SetDefault
void SetDefault(std::string name, const AttributeValue &value)
Definition: config.cc:891
ns3::Config::Connect
void Connect(std::string path, const CallbackBase &cb)
Definition: config.cc:975
NS_ABORT_MSG_IF
#define NS_ABORT_MSG_IF(cond, msg)
Abnormal program termination if a condition is true, with a message.
Definition: abort.h:108
NS_LOG_COMPONENT_DEFINE
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:202
NS_LOG_FUNCTION
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
Definition: log-macros-enabled.h:238
NS_TEST_ASSERT_MSG_EQ
#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.
Definition: test.h:144
NS_TEST_EXPECT_MSG_EQ
#define NS_TEST_EXPECT_MSG_EQ(actual, limit, msg)
Test that an actual and expected (limit) value are equal and report if not.
Definition: test.h:251
ns3::MicroSeconds
Time MicroSeconds(uint64_t value)
Construct a Time in the indicated unit.
Definition: nstime.h:1360
ns3::NanoSeconds
Time NanoSeconds(uint64_t value)
Construct a Time in the indicated unit.
Definition: nstime.h:1372
ns3::Seconds
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1336
ns3::MilliSeconds
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
Definition: nstime.h:1348
ns3::WifiPhyRxfailureReason
WifiPhyRxfailureReason
Enumeration of the possible reception failure reasons.
Definition: wifi-phy-common.h:401
ns3::WifiPhyBand
WifiPhyBand
Identifies the PHY band.
Definition: wifi-phy-band.h:33
ns3::WIFI_STANDARD_80211ax
@ WIFI_STANDARD_80211ax
Definition: wifi-standards.h:47
ns3::WIFI_STANDARD_80211ac
@ WIFI_STANDARD_80211ac
Definition: wifi-standards.h:45
ns3::UNSUPPORTED_SETTINGS
@ UNSUPPORTED_SETTINGS
Definition: wifi-phy-common.h:403
ns3::RXING
@ RXING
Definition: wifi-phy-common.h:405
ns3::WIFI_PREAMBLE_HE_SU
@ WIFI_PREAMBLE_HE_SU
Definition: wifi-phy-common.h:175
ns3::WIFI_PHY_BAND_2_4GHZ
@ WIFI_PHY_BAND_2_4GHZ
The 2.4 GHz band.
Definition: wifi-phy-band.h:35
ns3::WIFI_PHY_BAND_5GHZ
@ WIFI_PHY_BAND_5GHZ
The 5 GHz band.
Definition: wifi-phy-band.h:37
ns3
Every class exported by the ns3 library is enclosed in the ns3 namespace.
ns3::MakeCallback
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...
Definition: callback.h:702
ns3::DbmToW
double DbmToW(double dBm)
Convert from dBm to Watts.
Definition: wifi-utils.cc:40
ns3::WIFI_MAC_QOSDATA
@ WIFI_MAC_QOSDATA
Definition: wifi-mac-header.h:81
std
STL namespace.
ns3::RxSignalInfo
RxSignalInfo structure containing info on the received signal.
Definition: phy-entity.h:70
CHANNEL_NUMBER
static const uint8_t CHANNEL_NUMBER
Definition: wifi-phy-reception-test.cc:61
GUARD_WIDTH
static const uint16_t GUARD_WIDTH
Definition: wifi-phy-reception-test.cc:64
CHANNEL_WIDTH
static const uint16_t CHANNEL_WIDTH
Definition: wifi-phy-reception-test.cc:63
wifiPhyReceptionTestSuite
static WifiPhyReceptionTestSuite wifiPhyReceptionTestSuite
the test suite
Definition: wifi-phy-reception-test.cc:4891
FREQUENCY
static const uint32_t FREQUENCY
Definition: wifi-phy-reception-test.cc:62
WifiPhyState
WifiPhyState
The state of the PHY layer.
Definition: wifi-phy-state.h:31
packetSize
static const uint32_t packetSize
Packet size generated at the AP.
Definition: wifi-power-adaptation-distance.cc:111