A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
inter-bss-test-suite.cc
Go to the documentation of this file.
1/*
2 * Copyright (c) 2018 University of Washington
3 *
4 * SPDX-License-Identifier: GPL-2.0-only
5 *
6 * Authors: Sébastien Deronne <sebastien.deronne@gmail.com>
7 * Scott Carpenter <scarpenter44@windstream.net>
8 */
9
10#include "ns3/config.h"
11#include "ns3/constant-obss-pd-algorithm.h"
12#include "ns3/double.h"
13#include "ns3/he-configuration.h"
14#include "ns3/log.h"
15#include "ns3/mobility-helper.h"
16#include "ns3/multi-model-spectrum-channel.h"
17#include "ns3/pointer.h"
18#include "ns3/rng-seed-manager.h"
19#include "ns3/spectrum-wifi-helper.h"
20#include "ns3/ssid.h"
21#include "ns3/string.h"
22#include "ns3/test.h"
23#include "ns3/uinteger.h"
24#include "ns3/wifi-net-device.h"
25#include "ns3/wifi-utils.h"
26
27using namespace ns3;
28
29NS_LOG_COMPONENT_DEFINE("InterBssTestSuite");
30
31static uint32_t
32ConvertContextToNodeId(std::string context)
33{
34 std::string sub = context.substr(10);
35 uint32_t pos = sub.find("/Device");
36 uint32_t nodeId = std::stoi(sub.substr(0, pos));
37 return nodeId;
38}
39
40/**
41 * \ingroup wifi-test
42 * \ingroup tests
43 *
44 * \brief Wifi Test
45 *
46 * This test case tests the transmission of inter-BSS cases
47 * and verify behavior of 11ax OBSS_PD spatial reuse.
48 *
49 * The topology for this test case is made of three networks, each with one AP and one STA:
50 *
51 * AP --d1-- STA1 --d2-- AP2 --d3-- STA2 --d4-- AP3 --d5-- STA3
52 * TX1 RX1 TX2 RX2 TX3 RX3
53 *
54 * Main parameters:
55 * OBSS_PD level = -72dbm
56 * Received Power by TX1 from TX2 = [-62dbm, -82dbm]
57 * Received SINR by RX1 from TX1 > 3dB (enough to pass MCS0 reception)
58 * Received SINR by RX2 from TX2 > 3dB (enough to pass MCS0 reception)
59 * Received SINR by RX3 from TX3 > 3dB (enough to pass MCS0 reception)
60 * TX1/RX1 BSS Color = 1
61 * TX2/RX2 transmission PPDU BSS Color = [2 0]
62 * TX3/RX3 BSS color = 3 (BSS 3 only used to test some corner cases)
63 * PHY = 11ax, MCS 0, 80MHz
64 */
65
66class TestInterBssConstantObssPdAlgo : public TestCase
67{
68 public:
69 /**
70 * Constructor
71 *
72 * \param standard The standard to use for the test
73 */
74 TestInterBssConstantObssPdAlgo(WifiStandard standard);
75 ~TestInterBssConstantObssPdAlgo() override;
76
77 void DoRun() override;
78
79 private:
80 /**
81 * Send one packet function
82 * \param tx_dev the transmitting device
83 * \param rx_dev the receiving device
84 * \param payloadSize the payload size
85 */
86 void SendOnePacket(Ptr<WifiNetDevice> tx_dev, Ptr<WifiNetDevice> rx_dev, uint32_t payloadSize);
87
88 /**
89 * Allocate the node positions
90 * \param d1 distance d1
91 * \param d2 distance d2
92 * \param d3 distance d3
93 * \param d4 distance d4
94 * \param d5 distance d5
95 * \return the node positions
96 */
97 Ptr<ListPositionAllocator> AllocatePositions(meter_u d1,
98 meter_u d2,
99 meter_u d3,
100 meter_u d4,
101 meter_u d5);
102
103 /**
104 * Set the expected transmit power
105 * \param txPower the transmit power
106 */
107 void SetExpectedTxPower(dBm_u txPower);
108
109 /**
110 * Setup the simulation
111 */
112 void SetupSimulation();
113
114 /**
115 * Check the results
116 */
117 void CheckResults();
118
119 /**
120 * Reset the results
121 */
122 void ResetResults();
123
124 /**
125 * Clear the drop reasons
126 */
127 void ClearDropReasons();
128
129 /**
130 * Run one function
131 */
132 void RunOne();
133
134 /**
135 * Check if the Phy State for a device is an expected value
136 * \param device the device to check
137 * \param expectedState the expected PHY state
138 */
139 void CheckPhyState(Ptr<WifiNetDevice> device, WifiPhyState expectedState);
140
141 /**
142 * Check if the Phy drop reasons for a device are as expected
143 * \param device the device to check
144 * \param expectedDropReasons the expected PHY drop reasons
145 */
146 void CheckPhyDropReasons(Ptr<WifiNetDevice> device,
147 std::vector<WifiPhyRxfailureReason> expectedDropReasons);
148
149 /**
150 * Notify Phy transmit begin
151 * \param context the context
152 * \param p the packet
153 * \param txPowerW the tx power
154 */
155 void NotifyPhyTxBegin(std::string context, Ptr<const Packet> p, double txPowerW);
156
157 /**
158 * Notify Phy receive ends
159 * \param context the context
160 * \param p the packet
161 */
162 void NotifyPhyRxEnd(std::string context, Ptr<const Packet> p);
163
164 /**
165 * Notify Phy receive drops
166 * \param context the context
167 * \param p the packet
168 * \param reason the reason why it was dropped
169 */
170 void NotifyPhyRxDrop(std::string context, Ptr<const Packet> p, WifiPhyRxfailureReason reason);
171
172 unsigned int m_numSta1PacketsSent; ///< number of sent packets from STA1
173 unsigned int m_numSta2PacketsSent; ///< number of sent packets from STA2
174 unsigned int m_numAp1PacketsSent; ///< number of sent packets from AP1
175 unsigned int m_numAp2PacketsSent; ///< number of sent packets from AP2
176
177 unsigned int m_numSta1PacketsReceived; ///< number of received packets from STA1
178 unsigned int m_numSta2PacketsReceived; ///< number of received packets from STA2
179 unsigned int m_numAp1PacketsReceived; ///< number of received packets from AP1
180 unsigned int m_numAp2PacketsReceived; ///< number of received packets from AP2
181
182 std::vector<WifiPhyRxfailureReason> m_dropReasonsSta1; ///< drop reasons for STA1
183 std::vector<WifiPhyRxfailureReason> m_dropReasonsSta2; ///< drop reasons for STA2
184 std::vector<WifiPhyRxfailureReason> m_dropReasonsAp1; ///< drop reasons for AP1
185 std::vector<WifiPhyRxfailureReason> m_dropReasonsAp2; ///< drop reasons for AP2
186
187 unsigned int m_payloadSize1; ///< size in bytes of packet payload in BSS 1
188 unsigned int m_payloadSize2; ///< size in bytes of packet payload in BSS 2
189 unsigned int m_payloadSize3; ///< size in bytes of packet payload in BSS 3
190
191 NetDeviceContainer m_staDevices; ///< STA devices
192 NetDeviceContainer m_apDevices; ///< AP devices
193
194 dBm_u m_txPower; ///< configured transmit power
195 dBm_u m_obssPdLevel; ///< OBSS-PD level
196 dBm_u m_obssRxPower; ///< forced RX power for OBSS
197 dBm_u m_expectedTxPower; ///< expected transmit power
198
199 uint8_t m_bssColor1; ///< color for BSS 1
200 uint8_t m_bssColor2; ///< color for BSS 2
201 uint8_t m_bssColor3; ///< color for BSS 3
202
203 WifiStandard m_standard; ///< the standard to use for the test
204};
205
206TestInterBssConstantObssPdAlgo::TestInterBssConstantObssPdAlgo(WifiStandard standard)
207 : TestCase("InterBssConstantObssPd"),
208 m_numSta1PacketsSent(0),
209 m_numSta2PacketsSent(0),
210 m_numAp1PacketsSent(0),
211 m_numAp2PacketsSent(0),
212 m_numSta1PacketsReceived(0),
213 m_numSta2PacketsReceived(0),
214 m_numAp1PacketsReceived(0),
215 m_numAp2PacketsReceived(0),
216 m_payloadSize1(1000),
217 m_payloadSize2(1500),
218 m_payloadSize3(2000),
219 m_txPower(15),
220 m_obssPdLevel(-72),
221 m_obssRxPower(-82),
222 m_expectedTxPower(15),
223 m_bssColor1(1),
224 m_bssColor2(2),
225 m_bssColor3(3),
226 m_standard(standard)
227{
228}
229
234
235Ptr<ListPositionAllocator>
236TestInterBssConstantObssPdAlgo::AllocatePositions(meter_u d1,
237 meter_u d2,
238 meter_u d3,
239 meter_u d4,
240 meter_u d5)
241{
242 Ptr<ListPositionAllocator> positionAlloc = CreateObject<ListPositionAllocator>();
243 positionAlloc->Add(Vector(0.0, 0.0, 0.0)); // AP1
244 positionAlloc->Add(Vector(d1 + d2, 0.0, 0.0)); // AP2
245 positionAlloc->Add(Vector(d1 + d2 + d3 + d4, 0.0, 0.0)); // AP3
246 positionAlloc->Add(Vector(d1, 0.0, 0.0)); // STA1
247 positionAlloc->Add(Vector(d1 + d2 + d3, 0.0, 0.0)); // STA2
248 positionAlloc->Add(Vector(d1 + d2 + d3 + d4 + d5, 0.0, 0.0)); // STA3
249 return positionAlloc;
250}
251
252void
253TestInterBssConstantObssPdAlgo::SetupSimulation()
254{
255 Ptr<WifiNetDevice> ap_device1 = DynamicCast<WifiNetDevice>(m_apDevices.Get(0));
256 Ptr<WifiNetDevice> ap_device2 = DynamicCast<WifiNetDevice>(m_apDevices.Get(1));
257 Ptr<WifiNetDevice> ap_device3 = DynamicCast<WifiNetDevice>(m_apDevices.Get(2));
258 Ptr<WifiNetDevice> sta_device1 = DynamicCast<WifiNetDevice>(m_staDevices.Get(0));
259 Ptr<WifiNetDevice> sta_device2 = DynamicCast<WifiNetDevice>(m_staDevices.Get(1));
260 Ptr<WifiNetDevice> sta_device3 = DynamicCast<WifiNetDevice>(m_staDevices.Get(2));
261
262 bool expectFilter = (m_bssColor1 != 0) && (m_bssColor2 != 0);
263 bool expectPhyReset = expectFilter && (m_obssPdLevel >= m_obssRxPower);
264 std::vector<WifiPhyRxfailureReason> dropReasons;
265 WifiPhyState stateDuringPayloadNeighboringBss =
266 expectFilter ? WifiPhyState::CCA_BUSY : WifiPhyState::RX;
267 if (expectFilter)
268 {
269 dropReasons.push_back(FILTERED);
270 }
271 if (expectPhyReset)
272 {
273 dropReasons.push_back(OBSS_PD_CCA_RESET);
274 }
275
276 // In order to have all ADDBA handshakes established, each AP and STA sends a packet.
277
278 Simulator::Schedule(Seconds(0.25),
279 &TestInterBssConstantObssPdAlgo::SendOnePacket,
280 this,
281 ap_device1,
282 sta_device1,
283 m_payloadSize1);
284 Simulator::Schedule(Seconds(0.5),
285 &TestInterBssConstantObssPdAlgo::SendOnePacket,
286 this,
287 sta_device1,
288 ap_device1,
289 m_payloadSize1);
290 Simulator::Schedule(Seconds(0.75),
291 &TestInterBssConstantObssPdAlgo::SendOnePacket,
292 this,
293 ap_device2,
294 sta_device2,
295 m_payloadSize2);
296 Simulator::Schedule(Seconds(1),
297 &TestInterBssConstantObssPdAlgo::SendOnePacket,
298 this,
299 sta_device2,
300 ap_device2,
301 m_payloadSize2);
302 Simulator::Schedule(Seconds(1.25),
303 &TestInterBssConstantObssPdAlgo::SendOnePacket,
304 this,
305 ap_device3,
306 sta_device3,
307 m_payloadSize3);
308 Simulator::Schedule(Seconds(1.5),
309 &TestInterBssConstantObssPdAlgo::SendOnePacket,
310 this,
311 sta_device3,
312 ap_device3,
313 m_payloadSize3);
314
315 // We test PHY state and verify whether a CCA reset did occur.
316
317 // AP2 sends a packet 0.5s later.
318 Simulator::Schedule(Seconds(2.0), &TestInterBssConstantObssPdAlgo::ClearDropReasons, this);
319 Simulator::Schedule(Seconds(2.0),
320 &TestInterBssConstantObssPdAlgo::SendOnePacket,
321 this,
322 ap_device2,
323 sta_device2,
324 m_payloadSize2);
325 Simulator::Schedule(Seconds(2.0) + MicroSeconds(10),
326 &TestInterBssConstantObssPdAlgo::CheckPhyState,
327 this,
328 ap_device2,
329 WifiPhyState::TX);
330 // All other PHYs should have stay idle until 4us (preamble detection time).
331 Simulator::Schedule(Seconds(2.0) + MicroSeconds(11),
332 &TestInterBssConstantObssPdAlgo::CheckPhyState,
333 this,
334 sta_device1,
335 WifiPhyState::IDLE);
336 Simulator::Schedule(Seconds(2.0) + MicroSeconds(11),
337 &TestInterBssConstantObssPdAlgo::CheckPhyState,
338 this,
339 sta_device2,
340 WifiPhyState::IDLE);
341 Simulator::Schedule(Seconds(2.0) + MicroSeconds(11),
342 &TestInterBssConstantObssPdAlgo::CheckPhyState,
343 this,
344 ap_device1,
345 WifiPhyState::IDLE);
346 // All PHYs should be receiving the PHY header (i.e. PHY state is CCA_BUSY) if preamble has been
347 // detected (always the case in this test).
348 Simulator::Schedule(Seconds(2.0) + MicroSeconds(14),
349 &TestInterBssConstantObssPdAlgo::CheckPhyState,
350 this,
351 sta_device1,
352 WifiPhyState::CCA_BUSY);
353 Simulator::Schedule(Seconds(2.0) + MicroSeconds(14),
354 &TestInterBssConstantObssPdAlgo::CheckPhyState,
355 this,
356 sta_device2,
357 WifiPhyState::CCA_BUSY);
358 Simulator::Schedule(Seconds(2.0) + MicroSeconds(14),
359 &TestInterBssConstantObssPdAlgo::CheckPhyState,
360 this,
361 ap_device1,
362 WifiPhyState::CCA_BUSY);
363 // PHYs of AP1 and STA1 should be idle after HE-SIG-A if they were reset by OBSS_PD SR,
364 // otherwise they should be CCA_busy until beginning of payload.
365 Simulator::Schedule(Seconds(2.0) + MicroSeconds(43),
366 &TestInterBssConstantObssPdAlgo::CheckPhyDropReasons,
367 this,
368 sta_device1,
369 dropReasons);
370 Simulator::Schedule(Seconds(2.0) + MicroSeconds(43),
371 &TestInterBssConstantObssPdAlgo::CheckPhyState,
372 this,
373 sta_device1,
374 expectPhyReset ? WifiPhyState::IDLE : WifiPhyState::CCA_BUSY);
375 Simulator::Schedule(Seconds(2.0) + MicroSeconds(43),
376 &TestInterBssConstantObssPdAlgo::CheckPhyDropReasons,
377 this,
378 ap_device1,
379 dropReasons);
380 Simulator::Schedule(Seconds(2.0) + MicroSeconds(43),
381 &TestInterBssConstantObssPdAlgo::CheckPhyState,
382 this,
383 ap_device1,
384 expectPhyReset ? WifiPhyState::IDLE : WifiPhyState::CCA_BUSY);
385 // PHYs of AP1 and STA1 should be idle if they were reset by OBSS_PD SR, otherwise they should
386 // be CCA_busy/Rx (since filtered/not filtered, resp.).
387 Simulator::Schedule(Seconds(2.0) + MicroSeconds(54),
388 &TestInterBssConstantObssPdAlgo::CheckPhyState,
389 this,
390 sta_device1,
391 expectPhyReset ? WifiPhyState::IDLE : stateDuringPayloadNeighboringBss);
392 Simulator::Schedule(Seconds(2.0) + MicroSeconds(54),
393 &TestInterBssConstantObssPdAlgo::CheckPhyState,
394 this,
395 ap_device1,
396 expectPhyReset ? WifiPhyState::IDLE : stateDuringPayloadNeighboringBss);
397 // STA2 should be receiving
398 Simulator::Schedule(Seconds(2.0) + MicroSeconds(54),
399 &TestInterBssConstantObssPdAlgo::CheckPhyState,
400 this,
401 sta_device2,
402 WifiPhyState::RX);
403
404 // We test whether two networks can transmit simultaneously, and whether transmit power
405 // restrictions are applied.
406
407 // AP2 sends another packet 0.1s later.
408 Simulator::Schedule(Seconds(2.1), &TestInterBssConstantObssPdAlgo::ClearDropReasons, this);
409 Simulator::Schedule(Seconds(2.1),
410 &TestInterBssConstantObssPdAlgo::SendOnePacket,
411 this,
412 ap_device2,
413 sta_device2,
414 m_payloadSize2);
415 // STA1 sends a packet 42us later (i.e. right after HE-SIG-A of AP2). Even though AP2 is still
416 // transmitting, STA1 can transmit simultaneously if it's PHY was reset by OBSS_PD SR.
417 Simulator::Schedule(Seconds(2.1) + MicroSeconds(42),
418 &TestInterBssConstantObssPdAlgo::SendOnePacket,
419 this,
420 sta_device1,
421 ap_device1,
422 m_payloadSize1);
423 if (expectPhyReset)
424 {
425 // In this case, we check the TX power is restricted (and set the expected value slightly
426 // before transmission should occur)
427 const auto expectedTxPower = std::min(m_txPower, 21 - (m_obssPdLevel + 82));
428 Simulator::Schedule(Seconds(2.1) + MicroSeconds(41),
429 &TestInterBssConstantObssPdAlgo::SetExpectedTxPower,
430 this,
431 expectedTxPower);
432 }
433 // Check simultaneous transmissions
434 Simulator::Schedule(Seconds(2.1) + MicroSeconds(100),
435 &TestInterBssConstantObssPdAlgo::CheckPhyState,
436 this,
437 ap_device2,
438 WifiPhyState::TX);
439 Simulator::Schedule(Seconds(2.1) + MicroSeconds(100),
440 &TestInterBssConstantObssPdAlgo::CheckPhyDropReasons,
441 this,
442 sta_device1,
443 dropReasons);
444 Simulator::Schedule(Seconds(2.1) + MicroSeconds(100),
445 &TestInterBssConstantObssPdAlgo::CheckPhyState,
446 this,
447 sta_device1,
448 expectPhyReset ? WifiPhyState::TX : stateDuringPayloadNeighboringBss);
449 Simulator::Schedule(Seconds(2.1) + MicroSeconds(100),
450 &TestInterBssConstantObssPdAlgo::CheckPhyState,
451 this,
452 sta_device2,
453 WifiPhyState::RX);
454 Simulator::Schedule(Seconds(2.1) + MicroSeconds(100),
455 &TestInterBssConstantObssPdAlgo::CheckPhyDropReasons,
456 this,
457 ap_device1,
458 dropReasons);
459 Simulator::Schedule(Seconds(2.1) + MicroSeconds(100),
460 &TestInterBssConstantObssPdAlgo::CheckPhyState,
461 this,
462 ap_device1,
463 stateDuringPayloadNeighboringBss);
464 Simulator::Schedule(Seconds(2.1) + MicroSeconds(142),
465 &TestInterBssConstantObssPdAlgo::CheckPhyState,
466 this,
467 ap_device1,
468 expectPhyReset ? WifiPhyState::RX : stateDuringPayloadNeighboringBss);
469
470 // AP2 sends another packet 0.1s later, and STA1 wanting to send a packet during the payload of
471 // the former.
472 Simulator::Schedule(Seconds(2.2), &TestInterBssConstantObssPdAlgo::ClearDropReasons, this);
473 Simulator::Schedule(Seconds(2.2),
474 &TestInterBssConstantObssPdAlgo::SetExpectedTxPower,
475 this,
476 m_txPower);
477 Simulator::Schedule(Seconds(2.2),
478 &TestInterBssConstantObssPdAlgo::SendOnePacket,
479 this,
480 ap_device2,
481 sta_device2,
482 m_payloadSize2);
483 // STA1 sends a packet 90us later (i.e. during payload of AP2). Even though AP2 is still
484 // transmitting, STA1 can transmit simultaneously if it's PHY was reset by OBSS_PD SR.
485 Simulator::Schedule(Seconds(2.2) + MicroSeconds(90),
486 &TestInterBssConstantObssPdAlgo::SendOnePacket,
487 this,
488 sta_device1,
489 ap_device1,
490 m_payloadSize1);
491 if (expectPhyReset)
492 {
493 // In this case, we check the TX power is restricted (and set the expected value slightly
494 // before transmission should occur)
495 const auto expectedTxPower = std::min(m_txPower, 21 - (m_obssPdLevel + 82));
496 Simulator::Schedule(Seconds(2.2) + MicroSeconds(89),
497 &TestInterBssConstantObssPdAlgo::SetExpectedTxPower,
498 this,
499 expectedTxPower);
500 }
501 // Check simultaneous transmissions
502 Simulator::Schedule(Seconds(2.2) + MicroSeconds(105),
503 &TestInterBssConstantObssPdAlgo::CheckPhyState,
504 this,
505 ap_device2,
506 WifiPhyState::TX);
507 Simulator::Schedule(Seconds(2.2) + MicroSeconds(105),
508 &TestInterBssConstantObssPdAlgo::CheckPhyDropReasons,
509 this,
510 sta_device1,
511 dropReasons);
512 Simulator::Schedule(Seconds(2.2) + MicroSeconds(105),
513 &TestInterBssConstantObssPdAlgo::CheckPhyState,
514 this,
515 sta_device1,
516 expectPhyReset ? WifiPhyState::TX : stateDuringPayloadNeighboringBss);
517 Simulator::Schedule(Seconds(2.2) + MicroSeconds(105),
518 &TestInterBssConstantObssPdAlgo::CheckPhyState,
519 this,
520 sta_device2,
521 WifiPhyState::RX);
522 Simulator::Schedule(Seconds(2.2) + MicroSeconds(105),
523 &TestInterBssConstantObssPdAlgo::CheckPhyDropReasons,
524 this,
525 ap_device1,
526 dropReasons);
527 Simulator::Schedule(Seconds(2.2) + MicroSeconds(105),
528 &TestInterBssConstantObssPdAlgo::CheckPhyState,
529 this,
530 ap_device1,
531 stateDuringPayloadNeighboringBss);
532 Simulator::Schedule(Seconds(2.2) + MicroSeconds(195),
533 &TestInterBssConstantObssPdAlgo::CheckPhyState,
534 this,
535 ap_device1,
536 expectPhyReset ? WifiPhyState::RX : stateDuringPayloadNeighboringBss);
537
538 // Verify transmit power restrictions are not applied if access to the channel is requested
539 // after ignored OBSS transmissions.
540
541 Simulator::Schedule(Seconds(2.3),
542 &TestInterBssConstantObssPdAlgo::SetExpectedTxPower,
543 this,
544 m_txPower);
545 // AP2 sends another packet 0.1s later. Power restriction should not be applied.
546 Simulator::Schedule(Seconds(2.3),
547 &TestInterBssConstantObssPdAlgo::SendOnePacket,
548 this,
549 ap_device2,
550 sta_device2,
551 m_payloadSize2);
552 // STA1 sends a packet 0.1s later. Power restriction should not be applied.
553 Simulator::Schedule(Seconds(2.4),
554 &TestInterBssConstantObssPdAlgo::SendOnePacket,
555 this,
556 sta_device1,
557 ap_device1,
558 m_payloadSize1);
559
560 // Verify a scenario that involves 3 networks in order to verify corner cases for transmit power
561 // restrictions. First, there is a transmission on network 2 from STA to AP, followed by a
562 // response from AP to STA. During that time, the STA on network 1 has a packet to send and
563 // request access to the channel. If a CCA reset occurred, it starts deferring while
564 // transmissions are ongoing from network 2. Before its backoff expires, a transmission on
565 // network 3 occurs, also eventually triggering another CCA reset (depending on the scenario
566 // that is being run). This test checks whether this sequence preserves transmit power
567 // restrictions if CCA resets occurred, since STA 1 has been deferring during ignored OBSS
568 // transmissions.
569
570 Simulator::Schedule(Seconds(2.5),
571 &TestInterBssConstantObssPdAlgo::SendOnePacket,
572 this,
573 sta_device2,
574 ap_device2,
575 m_payloadSize2 / 10);
576 Simulator::Schedule(Seconds(2.5) + MicroSeconds(15),
577 &TestInterBssConstantObssPdAlgo::SendOnePacket,
578 this,
579 ap_device2,
580 sta_device2,
581 m_payloadSize2 / 10);
582 Simulator::Schedule(Seconds(2.5) + MicroSeconds(270),
583 &TestInterBssConstantObssPdAlgo::SendOnePacket,
584 this,
585 ap_device1,
586 sta_device1,
587 m_payloadSize1 / 10);
588 Simulator::Schedule(Seconds(2.5) + MicroSeconds(300),
589 &TestInterBssConstantObssPdAlgo::SendOnePacket,
590 this,
591 ap_device3,
592 sta_device3,
593 m_payloadSize3 / 10);
594 if (expectPhyReset)
595 {
596 // In this case, we check the TX power is restricted (and set the expected value slightly
597 // before transmission should occur)
598 const auto expectedTxPower = std::min(m_txPower, 21 - (m_obssPdLevel + 82));
599 Simulator::Schedule(Seconds(2.5) + MicroSeconds(338),
600 &TestInterBssConstantObssPdAlgo::SetExpectedTxPower,
601 this,
602 expectedTxPower);
603 }
604
605 Simulator::Stop(Seconds(2.6));
606}
607
608void
622
623void
631
632void
633TestInterBssConstantObssPdAlgo::CheckResults()
634{
635 NS_TEST_ASSERT_MSG_EQ(m_numSta1PacketsSent,
636 4,
637 "The number of packets sent by STA1 is not correct!");
638 NS_TEST_ASSERT_MSG_EQ(m_numSta2PacketsSent,
639 2,
640 "The number of packets sent by STA2 is not correct!");
641 NS_TEST_ASSERT_MSG_EQ(m_numAp1PacketsSent,
642 2,
643 "The number of packets sent by AP1 is not correct!");
644 NS_TEST_ASSERT_MSG_EQ(m_numAp2PacketsSent,
645 6,
646 "The number of packets sent by AP2 is not correct!");
647 NS_TEST_ASSERT_MSG_EQ(m_numSta1PacketsReceived,
648 2,
649 "The number of packets received by STA1 is not correct!");
650 NS_TEST_ASSERT_MSG_EQ(m_numSta2PacketsReceived,
651 6,
652 "The number of packets received by STA2 is not correct!");
653 NS_TEST_ASSERT_MSG_EQ(m_numAp1PacketsReceived,
654 4,
655 "The number of packets received by AP1 is not correct!");
656 NS_TEST_ASSERT_MSG_EQ(m_numAp2PacketsReceived,
657 2,
658 "The number of packets received by AP2 is not correct!");
659}
660
661void
662TestInterBssConstantObssPdAlgo::NotifyPhyTxBegin(std::string context,
663 Ptr<const Packet> p,
664 double txPowerW)
665{
666 uint32_t idx = ConvertContextToNodeId(context);
667 uint32_t pktSize = p->GetSize() - 38;
668 if ((idx == 0) && ((pktSize == m_payloadSize1) || (pktSize == (m_payloadSize1 / 10))))
669 {
670 m_numSta1PacketsSent++;
671 NS_TEST_EXPECT_MSG_EQ(TestDoubleIsEqual(WToDbm(txPowerW), m_expectedTxPower, 1e-12),
672 true,
673 "Tx power is not correct!");
674 }
675 else if ((idx == 1) && ((pktSize == m_payloadSize2) || (pktSize == (m_payloadSize2 / 10))))
676 {
677 m_numSta2PacketsSent++;
678 NS_TEST_EXPECT_MSG_EQ(TestDoubleIsEqual(WToDbm(txPowerW), m_expectedTxPower, 1e-12),
679 true,
680 "Tx power is not correct!");
681 }
682 else if ((idx == 3) && ((pktSize == m_payloadSize1) || (pktSize == (m_payloadSize1 / 10))))
683 {
684 m_numAp1PacketsSent++;
685 NS_TEST_EXPECT_MSG_EQ(TestDoubleIsEqual(WToDbm(txPowerW), m_expectedTxPower, 1e-12),
686 true,
687 "Tx power is not correct!");
688 }
689 else if ((idx == 4) && ((pktSize == m_payloadSize2) || (pktSize == (m_payloadSize2 / 10))))
690 {
691 m_numAp2PacketsSent++;
692 NS_TEST_EXPECT_MSG_EQ(TestDoubleIsEqual(WToDbm(txPowerW), m_expectedTxPower, 1e-12),
693 true,
694 "Tx power is not correct!");
695 }
696}
697
698void
699TestInterBssConstantObssPdAlgo::NotifyPhyRxEnd(std::string context, Ptr<const Packet> p)
700{
701 uint32_t idx = ConvertContextToNodeId(context);
702 uint32_t pktSize = p->GetSize() - 38;
703 if ((idx == 0) && ((pktSize == m_payloadSize1) || (pktSize == (m_payloadSize1 / 10))))
704 {
705 m_numSta1PacketsReceived++;
706 }
707 else if ((idx == 1) && ((pktSize == m_payloadSize2) || (pktSize == (m_payloadSize2 / 10))))
708 {
709 m_numSta2PacketsReceived++;
710 }
711 else if ((idx == 3) && ((pktSize == m_payloadSize1) || (pktSize == (m_payloadSize1 / 10))))
712 {
713 m_numAp1PacketsReceived++;
714 }
715 else if ((idx == 4) && ((pktSize == m_payloadSize2) || (pktSize == (m_payloadSize2 / 10))))
716 {
717 m_numAp2PacketsReceived++;
718 }
719}
720
721void
722TestInterBssConstantObssPdAlgo::NotifyPhyRxDrop(std::string context,
723 Ptr<const Packet> p,
724 WifiPhyRxfailureReason reason)
725{
726 uint32_t idx = ConvertContextToNodeId(context);
727 uint32_t pktSize = p->GetSize() - 38;
728 if ((idx == 0) && ((pktSize != m_payloadSize1) && (pktSize != (m_payloadSize1 / 10))))
729 {
730 m_dropReasonsSta1.push_back(reason);
731 }
732 else if ((idx == 1) && ((pktSize != m_payloadSize2) && (pktSize != (m_payloadSize2 / 10))))
733 {
734 m_dropReasonsSta2.push_back(reason);
735 }
736 else if ((idx == 3) && ((pktSize != m_payloadSize1) && (pktSize != (m_payloadSize1 / 10))))
737 {
738 m_dropReasonsAp1.push_back(reason);
739 }
740 else if ((idx == 4) && ((pktSize != m_payloadSize2) && (pktSize != (m_payloadSize2 / 10))))
741 {
742 m_dropReasonsAp2.push_back(reason);
743 }
744}
745
746void
747TestInterBssConstantObssPdAlgo::SendOnePacket(Ptr<WifiNetDevice> tx_dev,
748 Ptr<WifiNetDevice> rx_dev,
749 uint32_t payloadSize)
750{
751 Ptr<Packet> p = Create<Packet>(payloadSize);
752 tx_dev->Send(p, rx_dev->GetAddress(), 1);
753}
754
755void
760
761void
762TestInterBssConstantObssPdAlgo::CheckPhyState(Ptr<WifiNetDevice> device, WifiPhyState expectedState)
763{
764 WifiPhyState currentState;
765 PointerValue ptr;
766 Ptr<WifiPhy> phy = DynamicCast<WifiPhy>(device->GetPhy());
767 phy->GetAttribute("State", ptr);
768 Ptr<WifiPhyStateHelper> state = DynamicCast<WifiPhyStateHelper>(ptr.Get<WifiPhyStateHelper>());
769 currentState = state->GetState();
770 NS_TEST_ASSERT_MSG_EQ(currentState,
771 expectedState,
772 "PHY State " << currentState << " does not match expected state "
773 << expectedState << " at " << Simulator::Now());
774}
775
776void
777TestInterBssConstantObssPdAlgo::CheckPhyDropReasons(
778 Ptr<WifiNetDevice> device,
779 std::vector<WifiPhyRxfailureReason> expectedDropReasons)
780{
781 std::vector<WifiPhyRxfailureReason> currentDropReasons;
782 uint32_t nodeId = device->GetNode()->GetId();
783 switch (nodeId)
784 {
785 case 0: // STA1
786 currentDropReasons = m_dropReasonsSta1;
787 break;
788 case 1: // STA2
789 currentDropReasons = m_dropReasonsSta2;
790 break;
791 case 3: // AP1
792 currentDropReasons = m_dropReasonsAp1;
793 break;
794 case 4: // AP2
795 currentDropReasons = m_dropReasonsAp2;
796 break;
797 default: // others, no attribute
798 return;
799 }
800 NS_TEST_ASSERT_MSG_EQ(currentDropReasons.size(),
801 expectedDropReasons.size(),
802 "Number of drop reasons "
803 << currentDropReasons.size() << " does not match expected one "
804 << expectedDropReasons.size() << " at " << Simulator::Now());
805 for (std::size_t i = 0; i < currentDropReasons.size(); ++i)
806 {
807 NS_TEST_ASSERT_MSG_EQ(currentDropReasons[i],
808 expectedDropReasons[i],
809 "Drop reason " << i << ": " << currentDropReasons[i]
810 << " does not match expected reason "
811 << expectedDropReasons[i] << " at "
812 << Simulator::Now());
813 }
814}
815
816void
817TestInterBssConstantObssPdAlgo::RunOne()
818{
819 RngSeedManager::SetSeed(1);
820 RngSeedManager::SetRun(3);
821 int64_t streamNumber = 50;
822
823 Config::Set("/NodeList/*/DeviceList/*/$ns3::WifiNetDevice/Mac/BE_MaxAmpduSize",
824 UintegerValue(0));
825
826 ResetResults();
827
828 NodeContainer wifiStaNodes;
829 wifiStaNodes.Create(3);
830
831 NodeContainer wifiApNodes;
832 wifiApNodes.Create(3);
833
834 Ptr<MatrixPropagationLossModel> lossModel = CreateObject<MatrixPropagationLossModel>();
835 lossModel->SetDefaultLoss(m_txPower -
836 m_obssRxPower); // Force received RSSI to be equal to m_obssRxPower
837
838 SpectrumWifiPhyHelper phy;
839 phy.DisablePreambleDetectionModel();
840 phy.SetFrameCaptureModel("ns3::SimpleFrameCaptureModel");
841 Ptr<MultiModelSpectrumChannel> channel = CreateObject<MultiModelSpectrumChannel>();
842 channel->SetPropagationDelayModel(CreateObject<ConstantSpeedPropagationDelayModel>());
843 channel->AddPropagationLossModel(lossModel);
844 phy.SetChannel(channel);
845 phy.Set("TxPowerStart", DoubleValue(m_txPower));
846 phy.Set("TxPowerEnd", DoubleValue(m_txPower));
847 phy.Set("ChannelSettings", StringValue("{36, 20, BAND_5GHZ, 0}"));
848
849 WifiHelper wifi;
850 wifi.SetStandard(m_standard);
851 wifi.SetRemoteStationManager("ns3::ConstantRateWifiManager",
852 "DataMode",
853 StringValue("HeMcs5"),
854 "ControlMode",
855 StringValue("HeMcs0"));
856
857 wifi.SetObssPdAlgorithm("ns3::ConstantObssPdAlgorithm",
858 "ObssPdLevel",
859 DoubleValue(m_obssPdLevel));
860
861 WifiMacHelper mac;
862 Ssid ssid = Ssid("ns-3-ssid");
863 mac.SetType("ns3::StaWifiMac", "Ssid", SsidValue(ssid));
864 m_staDevices = wifi.Install(phy, mac, wifiStaNodes);
865
866 // Assign fixed streams to random variables in use
867 WifiHelper::AssignStreams(m_staDevices, streamNumber);
868
869 mac.SetType("ns3::ApWifiMac", "Ssid", SsidValue(ssid));
870 m_apDevices = wifi.Install(phy, mac, wifiApNodes);
871
872 // Assign fixed streams to random variables in use
873 WifiHelper::AssignStreams(m_apDevices, streamNumber);
874
875 for (uint32_t i = 0; i < m_apDevices.GetN(); i++)
876 {
877 Ptr<WifiNetDevice> device = DynamicCast<WifiNetDevice>(m_apDevices.Get(i));
878 Ptr<HeConfiguration> heConfiguration = device->GetHeConfiguration();
879 if (i == 0)
880 {
881 heConfiguration->SetAttribute("BssColor", UintegerValue(m_bssColor1));
882 }
883 else if (i == 1)
884 {
885 heConfiguration->SetAttribute("BssColor", UintegerValue(m_bssColor2));
886 }
887 else
888 {
889 heConfiguration->SetAttribute("BssColor", UintegerValue(m_bssColor3));
890 }
891 }
892
893 MobilityHelper mobility;
894 Ptr<ListPositionAllocator> positionAlloc = AllocatePositions(
895 10,
896 50,
897 10,
898 50,
899 10); // distances do not really matter since we set RSSI per TX-RX pair to have full control
900 mobility.SetPositionAllocator(positionAlloc);
901 mobility.SetMobilityModel("ns3::ConstantPositionMobilityModel");
902 mobility.Install(wifiApNodes);
903 mobility.Install(wifiStaNodes);
904
905 lossModel->SetLoss(wifiStaNodes.Get(0)->GetObject<MobilityModel>(),
906 wifiApNodes.Get(0)->GetObject<MobilityModel>(),
907 m_txPower +
908 static_cast<dB_u>(30.0)); // Low attenuation for IBSS transmissions
909 lossModel->SetLoss(wifiStaNodes.Get(1)->GetObject<MobilityModel>(),
910 wifiApNodes.Get(1)->GetObject<MobilityModel>(),
911 m_txPower +
912 static_cast<dB_u>(30.0)); // Low attenuation for IBSS transmissions
913 lossModel->SetLoss(wifiStaNodes.Get(2)->GetObject<MobilityModel>(),
914 wifiApNodes.Get(2)->GetObject<MobilityModel>(),
915 m_txPower +
916 static_cast<dB_u>(30.0)); // Low attenuation for IBSS transmissions
917
918 Config::Connect("/NodeList/*/DeviceList/*/$ns3::WifiNetDevice/Phy/PhyTxBegin",
919 MakeCallback(&TestInterBssConstantObssPdAlgo::NotifyPhyTxBegin, this));
920 Config::Connect("/NodeList/*/DeviceList/*/$ns3::WifiNetDevice/Phy/PhyRxEnd",
921 MakeCallback(&TestInterBssConstantObssPdAlgo::NotifyPhyRxEnd, this));
922 Config::Connect("/NodeList/*/DeviceList/*/$ns3::WifiNetDevice/Phy/PhyRxDrop",
923 MakeCallback(&TestInterBssConstantObssPdAlgo::NotifyPhyRxDrop, this));
924
925 SetupSimulation();
926
927 Simulator::Run();
928 Simulator::Destroy();
929
930 CheckResults();
931}
932
933void
934TestInterBssConstantObssPdAlgo::DoRun()
935{
936 // Test case 1: CCA CS Threshold = m_obssRxPower < m_obssPdLevel
937 m_obssPdLevel = -72;
938 m_obssRxPower = -82;
939 m_bssColor1 = 1;
940 m_bssColor2 = 2;
941 m_bssColor3 = 3;
942 RunOne();
943
944 // Test case 2: CCA CS Threshold < m_obssPdLevel < m_obssRxPower
945 m_obssPdLevel = -72;
946 m_obssRxPower = -62;
947 m_bssColor1 = 1;
948 m_bssColor2 = 2;
949 m_bssColor3 = 3;
950 RunOne();
951
952 // Test case 3: CCA CS Threshold < m_obssPdLevel = m_obssRxPower
953 m_obssPdLevel = -72;
954 m_obssRxPower = -72;
955 m_bssColor1 = 1;
956 m_bssColor2 = 2;
957 m_bssColor3 = 3;
958 RunOne();
959
960 // Test case 4: CCA CS Threshold = m_obssRxPower < m_obssPdLevel with BSS color 2 and 3
961 // set to 0
962 m_obssPdLevel = -72;
963 m_obssRxPower = -82;
964 m_bssColor1 = 1;
965 m_bssColor2 = 0;
966 m_bssColor3 = 0;
967 RunOne();
968
969 // Test case 5: CCA CS Threshold = m_obssRxPower < m_obssPdLevel with BSS color 1 set to 0
970 m_obssPdLevel = -72;
971 m_obssRxPower = -82;
972 m_bssColor1 = 0;
973 m_bssColor2 = 2;
974 m_bssColor3 = 3;
975 RunOne();
976}
977
978/**
979 * \ingroup wifi-test
980 * \ingroup tests
981 *
982 * \brief Inter BSS Test Suite
983 */
984
985class InterBssTestSuite : public TestSuite
986{
987 public:
988 InterBssTestSuite();
989};
990
991InterBssTestSuite::InterBssTestSuite()
992 : TestSuite("wifi-inter-bss", Type::UNIT)
993{
994 AddTestCase(new TestInterBssConstantObssPdAlgo(WIFI_STANDARD_80211ax),
995 TestCase::Duration::QUICK);
996 AddTestCase(new TestInterBssConstantObssPdAlgo(WIFI_STANDARD_80211be),
997 TestCase::Duration::QUICK);
998}
999
1000// Do not forget to allocate an instance of this TestSuite
1001static InterBssTestSuite interBssTestSuite;
InterBssTestSuite
Inter BSS Test Suite.
Definition inter-bss-test-suite.cc:986
TestInterBssConstantObssPdAlgo::m_numSta2PacketsSent
unsigned int m_numSta2PacketsSent
number of sent packets from STA2
Definition inter-bss-test-suite.cc:173
TestInterBssConstantObssPdAlgo::m_numAp2PacketsReceived
unsigned int m_numAp2PacketsReceived
number of received packets from AP2
Definition inter-bss-test-suite.cc:180
TestInterBssConstantObssPdAlgo::m_numSta1PacketsSent
unsigned int m_numSta1PacketsSent
number of sent packets from STA1
Definition inter-bss-test-suite.cc:172
TestInterBssConstantObssPdAlgo::m_payloadSize2
unsigned int m_payloadSize2
size in bytes of packet payload in BSS 2
Definition inter-bss-test-suite.cc:188
TestInterBssConstantObssPdAlgo::ClearDropReasons
void ClearDropReasons()
Clear the drop reasons.
Definition inter-bss-test-suite.cc:624
TestInterBssConstantObssPdAlgo::m_dropReasonsAp2
std::vector< WifiPhyRxfailureReason > m_dropReasonsAp2
drop reasons for AP2
Definition inter-bss-test-suite.cc:185
TestInterBssConstantObssPdAlgo::SetupSimulation
void SetupSimulation()
Setup the simulation.
Definition inter-bss-test-suite.cc:253
TestInterBssConstantObssPdAlgo::CheckPhyDropReasons
void CheckPhyDropReasons(Ptr< WifiNetDevice > device, std::vector< WifiPhyRxfailureReason > expectedDropReasons)
Check if the Phy drop reasons for a device are as expected.
Definition inter-bss-test-suite.cc:777
TestInterBssConstantObssPdAlgo::m_payloadSize3
unsigned int m_payloadSize3
size in bytes of packet payload in BSS 3
Definition inter-bss-test-suite.cc:189
TestInterBssConstantObssPdAlgo::NotifyPhyTxBegin
void NotifyPhyTxBegin(std::string context, Ptr< const Packet > p, double txPowerW)
Notify Phy transmit begin.
Definition inter-bss-test-suite.cc:662
TestInterBssConstantObssPdAlgo::m_txPower
dBm_u m_txPower
configured transmit power
Definition inter-bss-test-suite.cc:194
TestInterBssConstantObssPdAlgo::m_payloadSize1
unsigned int m_payloadSize1
size in bytes of packet payload in BSS 1
Definition inter-bss-test-suite.cc:187
TestInterBssConstantObssPdAlgo::ResetResults
void ResetResults()
Reset the results.
Definition inter-bss-test-suite.cc:609
TestInterBssConstantObssPdAlgo::m_numSta2PacketsReceived
unsigned int m_numSta2PacketsReceived
number of received packets from STA2
Definition inter-bss-test-suite.cc:178
TestInterBssConstantObssPdAlgo::m_numAp2PacketsSent
unsigned int m_numAp2PacketsSent
number of sent packets from AP2
Definition inter-bss-test-suite.cc:175
TestInterBssConstantObssPdAlgo::CheckPhyState
void CheckPhyState(Ptr< WifiNetDevice > device, WifiPhyState expectedState)
Check if the Phy State for a device is an expected value.
Definition inter-bss-test-suite.cc:762
TestInterBssConstantObssPdAlgo::CheckResults
void CheckResults()
Check the results.
Definition inter-bss-test-suite.cc:633
TestInterBssConstantObssPdAlgo::NotifyPhyRxDrop
void NotifyPhyRxDrop(std::string context, Ptr< const Packet > p, WifiPhyRxfailureReason reason)
Notify Phy receive drops.
Definition inter-bss-test-suite.cc:722
TestInterBssConstantObssPdAlgo::m_obssRxPower
dBm_u m_obssRxPower
forced RX power for OBSS
Definition inter-bss-test-suite.cc:196
TestInterBssConstantObssPdAlgo::SetExpectedTxPower
void SetExpectedTxPower(dBm_u txPower)
Set the expected transmit power.
Definition inter-bss-test-suite.cc:756
TestInterBssConstantObssPdAlgo::m_staDevices
NetDeviceContainer m_staDevices
STA devices.
Definition inter-bss-test-suite.cc:191
TestInterBssConstantObssPdAlgo::m_dropReasonsSta1
std::vector< WifiPhyRxfailureReason > m_dropReasonsSta1
drop reasons for STA1
Definition inter-bss-test-suite.cc:182
TestInterBssConstantObssPdAlgo::NotifyPhyRxEnd
void NotifyPhyRxEnd(std::string context, Ptr< const Packet > p)
Notify Phy receive ends.
Definition inter-bss-test-suite.cc:699
TestInterBssConstantObssPdAlgo::SendOnePacket
void SendOnePacket(Ptr< WifiNetDevice > tx_dev, Ptr< WifiNetDevice > rx_dev, uint32_t payloadSize)
Send one packet function.
Definition inter-bss-test-suite.cc:747
TestInterBssConstantObssPdAlgo::DoRun
void DoRun() override
Implementation to actually run this TestCase.
Definition inter-bss-test-suite.cc:934
TestInterBssConstantObssPdAlgo::TestInterBssConstantObssPdAlgo
TestInterBssConstantObssPdAlgo(WifiStandard standard)
Constructor.
Definition inter-bss-test-suite.cc:206
TestInterBssConstantObssPdAlgo::m_dropReasonsSta2
std::vector< WifiPhyRxfailureReason > m_dropReasonsSta2
drop reasons for STA2
Definition inter-bss-test-suite.cc:183
TestInterBssConstantObssPdAlgo::m_apDevices
NetDeviceContainer m_apDevices
AP devices.
Definition inter-bss-test-suite.cc:192
TestInterBssConstantObssPdAlgo::m_numAp1PacketsSent
unsigned int m_numAp1PacketsSent
number of sent packets from AP1
Definition inter-bss-test-suite.cc:174
TestInterBssConstantObssPdAlgo::m_dropReasonsAp1
std::vector< WifiPhyRxfailureReason > m_dropReasonsAp1
drop reasons for AP1
Definition inter-bss-test-suite.cc:184
TestInterBssConstantObssPdAlgo::AllocatePositions
Ptr< ListPositionAllocator > AllocatePositions(meter_u d1, meter_u d2, meter_u d3, meter_u d4, meter_u d5)
Allocate the node positions.
Definition inter-bss-test-suite.cc:236
TestInterBssConstantObssPdAlgo::m_numSta1PacketsReceived
unsigned int m_numSta1PacketsReceived
number of received packets from STA1
Definition inter-bss-test-suite.cc:177
TestInterBssConstantObssPdAlgo::m_numAp1PacketsReceived
unsigned int m_numAp1PacketsReceived
number of received packets from AP1
Definition inter-bss-test-suite.cc:179
TestInterBssConstantObssPdAlgo::m_standard
WifiStandard m_standard
the standard to use for the test
Definition inter-bss-test-suite.cc:203
TestInterBssConstantObssPdAlgo::m_expectedTxPower
dBm_u m_expectedTxPower
expected transmit power
Definition inter-bss-test-suite.cc:197
ns3::DoubleValue
This class can be used to hold variables of floating point type such as 'double' or 'float'.
Definition double.h:31
ns3::MobilityHelper
Helper class used to assign positions and mobility models to nodes.
Definition mobility-helper.h:33
ns3::MobilityModel
Keep track of the current position and velocity of an object.
Definition mobility-model.h:29
ns3::NetDeviceContainer
holds a vector of ns3::NetDevice pointers
Definition net-device-container.h:32
ns3::NetDeviceContainer::GetN
uint32_t GetN() const
Get the number of Ptr<NetDevice> stored in this container.
Definition net-device-container.cc:50
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:56
ns3::NodeContainer
keep track of a set of node pointers.
Definition node-container.h:29
ns3::NodeContainer::Create
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
Definition node-container.cc:73
ns3::NodeContainer::Get
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
Definition node-container.cc:67
ns3::Object::GetObject
Ptr< T > GetObject() const
Get a pointer to the requested aggregated Object.
Definition object.h:511
ns3::PointerValue
AttributeValue implementation for Pointer.
ns3::PointerValue::Get
Ptr< T > Get() const
Definition pointer.h:223
ns3::Ptr
Smart pointer class similar to boost::intrusive_ptr.
Definition mpi-test-fixtures.h:37
ns3::RngSeedManager::SetRun
static void SetRun(uint64_t run)
Set the run number of simulation.
Definition rng-seed-manager.cc:79
ns3::RngSeedManager::SetSeed
static void SetSeed(uint32_t seed)
Set the seed.
Definition rng-seed-manager.cc:72
ns3::Simulator::Schedule
static EventId Schedule(const Time &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
Definition simulator.h:560
ns3::Simulator::Destroy
static void Destroy()
Execute the events scheduled with ScheduleDestroy().
Definition simulator.cc:131
ns3::Simulator::Now
static Time Now()
Return the current simulation virtual time.
Definition simulator.cc:197
ns3::Simulator::Run
static void Run()
Run the simulation.
Definition simulator.cc:167
ns3::Simulator::Stop
static void Stop()
Tell the Simulator the calling event should be the last one executed.
Definition simulator.cc:175
ns3::SpectrumWifiPhyHelper
Make it easy to create and manage PHY objects for the spectrum model.
Definition spectrum-wifi-helper.h:34
ns3::Ssid
The IEEE 802.11 SSID Information Element.
Definition ssid.h:25
ns3::StringValue
Hold variables of type string.
Definition string.h:45
ns3::TestCase
encapsulates test code
Definition test.h:1050
ns3::TestCase::AddTestCase
void AddTestCase(TestCase *testCase, Duration duration=Duration::QUICK)
Add an individual child TestCase to this test suite.
Definition test.cc:292
ns3::TestSuite
A suite of tests to run.
Definition test.h:1267
ns3::TestSuite::Type
Type
Type of test.
Definition test.h:1274
ns3::UintegerValue
Hold an unsigned integer type.
Definition uinteger.h:34
ns3::WifiHelper
helps to create WifiNetDevice objects
Definition wifi-helper.h:392
ns3::WifiHelper::AssignStreams
static int64_t AssignStreams(NetDeviceContainer c, int64_t stream)
Assign a fixed random variable stream number to the random variables used by the PHY and MAC aspects ...
Definition wifi-helper.cc:1086
ns3::WifiMacHelper
create MAC layers for a ns3::WifiNetDevice.
Definition wifi-mac-helper.h:40
ns3::WifiPhyStateHelper
This objects implements the PHY state machine of the Wifi device.
Definition wifi-phy-state-helper.h:62
uint32_t
ns3::Config::Connect
void Connect(std::string path, const CallbackBase &cb)
Definition config.cc:967
ns3::Config::Set
void Set(std::string path, const AttributeValue &value)
Definition config.cc:869
NS_LOG_COMPONENT_DEFINE
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition log.h:191
ns3::CreateObject
Ptr< T > CreateObject(Args &&... args)
Create an object by type, with varying number of constructor parameters.
Definition object.h:619
ns3::Create
Ptr< T > Create(Ts &&... args)
Create class instances by constructors with varying numbers of arguments and return them by Ptr.
Definition ptr.h:436
ns3::TestDoubleIsEqual
bool TestDoubleIsEqual(const double x1, const double x2, const double epsilon)
Compare two double precision floating point numbers and declare them equal if they are within some ep...
Definition test.cc:36
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:134
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:241
ns3::MicroSeconds
Time MicroSeconds(uint64_t value)
Construct a Time in the indicated unit.
Definition nstime.h:1332
ns3::Seconds
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition nstime.h:1308
ns3::WifiStandard
WifiStandard
Identifies the IEEE 802.11 specifications that a Wifi device can be configured to use.
Definition wifi-standards.h:29
ns3::WifiPhyRxfailureReason
WifiPhyRxfailureReason
Enumeration of the possible reception failure reasons.
Definition wifi-phy-common.h:413
ns3::WIFI_STANDARD_80211be
@ WIFI_STANDARD_80211be
Definition wifi-standards.h:39
ns3::WIFI_STANDARD_80211ax
@ WIFI_STANDARD_80211ax
Definition wifi-standards.h:38
ns3::OBSS_PD_CCA_RESET
@ OBSS_PD_CCA_RESET
Definition wifi-phy-common.h:433
ns3::FILTERED
@ FILTERED
Definition wifi-phy-common.h:435
ConvertContextToNodeId
static uint32_t ConvertContextToNodeId(std::string context)
Definition inter-bss-test-suite.cc:32
interBssTestSuite
static InterBssTestSuite interBssTestSuite
Definition inter-bss-test-suite.cc:1001
ns3
Every class exported by the ns3 library is enclosed in the ns3 namespace.
ns3::WifiPhyState
WifiPhyState
The state of the PHY layer.
Definition wifi-phy-state.h:24
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:684
ns3::WToDbm
dBm_u WToDbm(Watt_u val)
Convert from Watts to dBm.
Definition wifi-utils.cc:37
ns3::DynamicCast
Ptr< T1 > DynamicCast(const Ptr< T2 > &p)
Cast a Ptr.
Definition ptr.h:580
pktSize
uint32_t pktSize
packet size used for the simulation (in bytes)
Definition wifi-bianchi.cc:105