A Discrete-Event Network Simulator
API
ofdm-phy.cc
Go to the documentation of this file.
1/*
2 * Copyright (c) 2020 Orange Labs
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 * Authors: Rediet <getachew.redieteab@orange.com>
18 * Sébastien Deronne <sebastien.deronne@gmail.com> (for logic ported from wifi-phy)
19 * Mathieu Lacage <mathieu.lacage@sophia.inria.fr> (for logic ported from wifi-phy)
20 */
21
22#include "ofdm-phy.h"
23
24#include "ofdm-ppdu.h"
25
26#include "ns3/interference-helper.h"
27#include "ns3/log.h"
28#include "ns3/simulator.h"
29#include "ns3/wifi-phy.h"
30#include "ns3/wifi-psdu.h"
31#include "ns3/wifi-utils.h"
32
33#include <array>
34
35namespace ns3
36{
37
39
40/*******************************************************
41 * OFDM PHY (IEEE 802.11-2016, clause 17)
42 *******************************************************/
43
44// clang-format off
45
50};
51
53 // Unique name Code rate Constellation size
54 { "OfdmRate6Mbps", { WIFI_CODE_RATE_1_2, 2 } }, // 20 MHz
55 { "OfdmRate9Mbps", { WIFI_CODE_RATE_3_4, 2 } }, // |
56 { "OfdmRate12Mbps", { WIFI_CODE_RATE_1_2, 4 } }, // V
57 { "OfdmRate18Mbps", { WIFI_CODE_RATE_3_4, 4 } },
58 { "OfdmRate24Mbps", { WIFI_CODE_RATE_1_2, 16 } },
59 { "OfdmRate36Mbps", { WIFI_CODE_RATE_3_4, 16 } },
60 { "OfdmRate48Mbps", { WIFI_CODE_RATE_2_3, 64 } },
61 { "OfdmRate54Mbps", { WIFI_CODE_RATE_3_4, 64 } },
62 { "OfdmRate3MbpsBW10MHz", { WIFI_CODE_RATE_1_2, 2 } }, // 10 MHz
63 { "OfdmRate4_5MbpsBW10MHz", { WIFI_CODE_RATE_3_4, 2 } }, // |
64 { "OfdmRate6MbpsBW10MHz", { WIFI_CODE_RATE_1_2, 4 } }, // V
65 { "OfdmRate9MbpsBW10MHz", { WIFI_CODE_RATE_3_4, 4 } },
66 { "OfdmRate12MbpsBW10MHz", { WIFI_CODE_RATE_1_2, 16 } },
67 { "OfdmRate18MbpsBW10MHz", { WIFI_CODE_RATE_3_4, 16 } },
68 { "OfdmRate24MbpsBW10MHz", { WIFI_CODE_RATE_2_3, 64 } },
69 { "OfdmRate27MbpsBW10MHz", { WIFI_CODE_RATE_3_4, 64 } },
70 { "OfdmRate1_5MbpsBW5MHz", { WIFI_CODE_RATE_1_2, 2 } }, // 5 MHz
71 { "OfdmRate2_25MbpsBW5MHz", { WIFI_CODE_RATE_3_4, 2 } }, // |
72 { "OfdmRate3MbpsBW5MHz", { WIFI_CODE_RATE_1_2, 4 } }, // V
73 { "OfdmRate4_5MbpsBW5MHz", { WIFI_CODE_RATE_3_4, 4 } },
74 { "OfdmRate6MbpsBW5MHz", { WIFI_CODE_RATE_1_2, 16 } },
75 { "OfdmRate9MbpsBW5MHz", { WIFI_CODE_RATE_3_4, 16 } },
76 { "OfdmRate12MbpsBW5MHz", { WIFI_CODE_RATE_2_3, 64 } },
77 { "OfdmRate13_5MbpsBW5MHz", { WIFI_CODE_RATE_3_4, 64 } }
78};
79
81const std::map<uint16_t, std::array<uint64_t, 8> > s_ofdmRatesBpsList =
82 {{ 20, // MHz
83 { 6000000, 9000000, 12000000, 18000000,
84 24000000, 36000000, 48000000, 54000000 }},
85 { 10, // MHz
86 { 3000000, 4500000, 6000000, 9000000,
87 12000000, 18000000, 24000000, 27000000 }},
88 { 5, // MHz
89 { 1500000, 2250000, 3000000, 4500000,
90 6000000, 9000000, 12000000, 13500000 }}};
91
92// clang-format on
93
99const std::map<uint16_t, std::array<uint64_t, 8>>&
101{
102 return s_ofdmRatesBpsList;
103};
104
105OfdmPhy::OfdmPhy(OfdmPhyVariant variant /* = OFDM_PHY_DEFAULT */, bool buildModeList /* = true */)
106{
107 NS_LOG_FUNCTION(this << variant << buildModeList);
108
109 if (buildModeList)
110 {
111 auto bwRatesMap = GetOfdmRatesBpsList();
112
113 switch (variant)
114 {
115 case OFDM_PHY_DEFAULT:
116 for (const auto& rate : bwRatesMap.at(20))
117 {
118 WifiMode mode = GetOfdmRate(rate, 20);
119 NS_LOG_LOGIC("Add " << mode << " to list");
120 m_modeList.emplace_back(mode);
121 }
122 break;
123 case OFDM_PHY_10_MHZ:
124 for (const auto& rate : bwRatesMap.at(10))
125 {
126 WifiMode mode = GetOfdmRate(rate, 10);
127 NS_LOG_LOGIC("Add " << mode << " to list");
128 m_modeList.emplace_back(mode);
129 }
130 break;
131 case OFDM_PHY_5_MHZ:
132 for (const auto& rate : bwRatesMap.at(5))
133 {
134 WifiMode mode = GetOfdmRate(rate, 5);
135 NS_LOG_LOGIC("Add " << mode << " to list");
136 m_modeList.emplace_back(mode);
137 }
138 break;
139 default:
140 NS_ABORT_MSG("Unsupported 11a OFDM variant");
141 }
142 }
143}
144
146{
147 NS_LOG_FUNCTION(this);
148}
149
151OfdmPhy::GetSigMode(WifiPpduField field, const WifiTxVector& txVector) const
152{
153 switch (field)
154 {
155 case WIFI_PPDU_FIELD_PREAMBLE: // consider header mode for preamble (useful for
156 // InterferenceHelper)
158 return GetHeaderMode(txVector);
159 default:
160 return PhyEntity::GetSigMode(field, txVector);
161 }
162}
163
166{
167 switch (txVector.GetChannelWidth())
168 {
169 case 5:
171 case 10:
173 case 20:
174 default:
175 // Section 17.3.2 "PPDU frame format"; IEEE Std 802.11-2016.
176 // Actually this is only the first part of the PhyHeader,
177 // because the last 16 bits of the PhyHeader are using the
178 // same mode of the payload
179 return GetOfdmRate6Mbps();
180 }
181}
182
185{
186 return m_ofdmPpduFormats;
187}
188
189Time
191{
192 switch (field)
193 {
195 return GetPreambleDuration(txVector); // L-STF + L-LTF
197 return GetHeaderDuration(txVector); // L-SIG
198 default:
199 return PhyEntity::GetDuration(field, txVector);
200 }
201}
202
203Time
205{
206 switch (txVector.GetChannelWidth())
207 {
208 case 20:
209 default:
210 // Section 17.3.3 "PHY preamble (SYNC)" Figure 17-4 "OFDM training structure"
211 // also Section 17.3.2.3 "Modulation-dependent parameters" Table 17-4 "Modulation-dependent
212 // parameters"; IEEE Std 802.11-2016
213 return MicroSeconds(16);
214 case 10:
215 // Section 17.3.3 "PHY preamble (SYNC)" Figure 17-4 "OFDM training structure"
216 // also Section 17.3.2.3 "Modulation-dependent parameters" Table 17-4 "Modulation-dependent
217 // parameters"; IEEE Std 802.11-2016
218 return MicroSeconds(32);
219 case 5:
220 // Section 17.3.3 "PHY preamble (SYNC)" Figure 17-4 "OFDM training structure"
221 // also Section 17.3.2.3 "Modulation-dependent parameters" Table 17-4 "Modulation-dependent
222 // parameters"; IEEE Std 802.11-2016
223 return MicroSeconds(64);
224 }
225}
226
227Time
229{
230 switch (txVector.GetChannelWidth())
231 {
232 case 20:
233 default:
234 // Section 17.3.3 "PHY preamble (SYNC)" and Figure 17-4 "OFDM training structure"; IEEE Std
235 // 802.11-2016 also Section 17.3.2.4 "Timing related parameters" Table 17-5 "Timing-related
236 // parameters"; IEEE Std 802.11-2016 We return the duration of the SIGNAL field only, since
237 // the SERVICE field (which strictly speaking belongs to the PHY header, see Section 17.3.2
238 // and Figure 17-1) is sent using the payload mode.
239 return MicroSeconds(4);
240 case 10:
241 // Section 17.3.2.4 "Timing related parameters" Table 17-5 "Timing-related parameters"; IEEE
242 // Std 802.11-2016
243 return MicroSeconds(8);
244 case 5:
245 // Section 17.3.2.4 "Timing related parameters" Table 17-5 "Timing-related parameters"; IEEE
246 // Std 802.11-2016
247 return MicroSeconds(16);
248 }
249}
250
251Time
253 const WifiTxVector& txVector,
254 WifiPhyBand band,
255 MpduType /* mpdutype */,
256 bool /* incFlag */,
257 uint32_t& /* totalAmpduSize */,
258 double& /* totalAmpduNumSymbols */,
259 uint16_t /* staId */) const
260{
261 //(Section 17.3.2.4 "Timing related parameters" Table 17-5 "Timing-related parameters"; IEEE Std
262 // 802.11-2016 corresponds to T_{SYM} in the table)
263 Time symbolDuration = MicroSeconds(4);
264
265 double numDataBitsPerSymbol =
266 txVector.GetMode().GetDataRate(txVector) * symbolDuration.GetNanoSeconds() / 1e9;
267
268 // The number of OFDM symbols in the data field when BCC encoding
269 // is used is given in equation 19-32 of the IEEE 802.11-2016 standard.
270 double numSymbols =
271 lrint(ceil((GetNumberServiceBits() + size * 8.0 + 6.0) / (numDataBitsPerSymbol)));
272
273 Time payloadDuration =
274 FemtoSeconds(static_cast<uint64_t>(numSymbols * symbolDuration.GetFemtoSeconds()));
275 payloadDuration += GetSignalExtension(band);
276 return payloadDuration;
277}
278
279uint8_t
281{
282 return 16;
283}
284
285Time
287{
288 return (band == WIFI_PHY_BAND_2_4GHZ) ? MicroSeconds(6) : MicroSeconds(0);
289}
290
293 const WifiTxVector& txVector,
294 Time /* ppduDuration */)
295{
296 NS_LOG_FUNCTION(this << psdus << txVector);
297 return Create<OfdmPpdu>(psdus.begin()->second,
298 txVector,
300 txVector.GetChannelWidth()),
302 ObtainNextUid(txVector));
303}
304
307{
308 NS_LOG_FUNCTION(this << field << *event);
310 {
311 return EndReceiveHeader(event); // L-SIG
312 }
313 return PhyEntity::DoEndReceiveField(field, event);
314}
315
318{
319 NS_LOG_FUNCTION(this << *event);
321 NS_LOG_DEBUG("L-SIG: SNR(dB)=" << RatioToDb(snrPer.snr) << ", PER=" << snrPer.per);
322 PhyFieldRxStatus status(GetRandomValue() > snrPer.per);
323 if (status.isSuccess)
324 {
325 NS_LOG_DEBUG("Received non-HT PHY header");
327 {
329 }
330 }
331 else
332 {
333 NS_LOG_DEBUG("Abort reception because non-HT PHY header reception failed");
334 status.reason = L_SIG_FAILURE;
335 status.actionIfFailure = ABORT;
336 }
337 return status;
338}
339
340bool
342{
343 uint16_t channelWidth = ppdu->GetTxVector().GetChannelWidth();
344 if ((channelWidth >= 40) && (channelWidth > m_wifiPhy->GetChannelWidth()))
345 {
346 NS_LOG_DEBUG("Packet reception could not be started because not enough channel width ("
347 << channelWidth << " vs " << m_wifiPhy->GetChannelWidth() << ")");
348 return false;
349 }
350 return true;
351}
352
353bool
355{
356 if (!IsChannelWidthSupported(ppdu))
357 {
358 return false;
359 }
360 return IsConfigSupported(ppdu);
361}
362
365 Ptr<const WifiPpdu> /* ppdu */,
366 const WifiTxVector& txVector) const
367{
368 uint16_t centerFrequency = GetCenterFrequencyForChannelWidth(txVector);
369 uint16_t channelWidth = txVector.GetChannelWidth();
370 NS_LOG_FUNCTION(this << centerFrequency << channelWidth << txPowerW);
371 const auto& txMaskRejectionParams = GetTxMaskRejectionParams();
373 centerFrequency,
374 channelWidth,
375 txPowerW,
376 GetGuardBandwidth(channelWidth),
377 std::get<0>(txMaskRejectionParams),
378 std::get<1>(txMaskRejectionParams),
379 std::get<2>(txMaskRejectionParams));
380 return v;
381}
382
383void
385{
386 for (const auto& ratesPerBw : GetOfdmRatesBpsList())
387 {
388 for (const auto& rate : ratesPerBw.second)
389 {
390 GetOfdmRate(rate, ratesPerBw.first);
391 }
392 }
393}
394
396OfdmPhy::GetOfdmRate(uint64_t rate, uint16_t bw)
397{
398 switch (bw)
399 {
400 case 20:
401 switch (rate)
402 {
403 case 6000000:
404 return GetOfdmRate6Mbps();
405 case 9000000:
406 return GetOfdmRate9Mbps();
407 case 12000000:
408 return GetOfdmRate12Mbps();
409 case 18000000:
410 return GetOfdmRate18Mbps();
411 case 24000000:
412 return GetOfdmRate24Mbps();
413 case 36000000:
414 return GetOfdmRate36Mbps();
415 case 48000000:
416 return GetOfdmRate48Mbps();
417 case 54000000:
418 return GetOfdmRate54Mbps();
419 default:
420 NS_ABORT_MSG("Inexistent rate (" << rate << " bps) requested for 11a OFDM (default)");
421 return WifiMode();
422 }
423 break;
424 case 10:
425 switch (rate)
426 {
427 case 3000000:
429 case 4500000:
431 case 6000000:
433 case 9000000:
435 case 12000000:
437 case 18000000:
439 case 24000000:
441 case 27000000:
443 default:
444 NS_ABORT_MSG("Inexistent rate (" << rate << " bps) requested for 11a OFDM (10 MHz)");
445 return WifiMode();
446 }
447 break;
448 case 5:
449 switch (rate)
450 {
451 case 1500000:
453 case 2250000:
455 case 3000000:
456 return GetOfdmRate3MbpsBW5MHz();
457 case 4500000:
459 case 6000000:
460 return GetOfdmRate6MbpsBW5MHz();
461 case 9000000:
462 return GetOfdmRate9MbpsBW5MHz();
463 case 12000000:
465 case 13500000:
467 default:
468 NS_ABORT_MSG("Inexistent rate (" << rate << " bps) requested for 11a OFDM (5 MHz)");
469 return WifiMode();
470 }
471 break;
472 default:
473 NS_ABORT_MSG("Inexistent bandwidth (" << +bw << " MHz) requested for 11a OFDM");
474 return WifiMode();
475 }
476}
477
478#define GET_OFDM_MODE(x, f) \
479 WifiMode OfdmPhy::Get##x() \
480 { \
481 static WifiMode mode = CreateOfdmMode(#x, f); \
482 return mode; \
483 };
484
485// 20 MHz channel rates (default)
486GET_OFDM_MODE(OfdmRate6Mbps, true)
487GET_OFDM_MODE(OfdmRate9Mbps, false)
488GET_OFDM_MODE(OfdmRate12Mbps, true)
489GET_OFDM_MODE(OfdmRate18Mbps, false)
490GET_OFDM_MODE(OfdmRate24Mbps, true)
491GET_OFDM_MODE(OfdmRate36Mbps, false)
492GET_OFDM_MODE(OfdmRate48Mbps, false)
493GET_OFDM_MODE(OfdmRate54Mbps, false)
494// 10 MHz channel rates
495GET_OFDM_MODE(OfdmRate3MbpsBW10MHz, true)
496GET_OFDM_MODE(OfdmRate4_5MbpsBW10MHz, false)
497GET_OFDM_MODE(OfdmRate6MbpsBW10MHz, true)
498GET_OFDM_MODE(OfdmRate9MbpsBW10MHz, false)
499GET_OFDM_MODE(OfdmRate12MbpsBW10MHz, true)
500GET_OFDM_MODE(OfdmRate18MbpsBW10MHz, false)
501GET_OFDM_MODE(OfdmRate24MbpsBW10MHz, false)
502GET_OFDM_MODE(OfdmRate27MbpsBW10MHz, false)
503// 5 MHz channel rates
504GET_OFDM_MODE(OfdmRate1_5MbpsBW5MHz, true)
505GET_OFDM_MODE(OfdmRate2_25MbpsBW5MHz, false)
506GET_OFDM_MODE(OfdmRate3MbpsBW5MHz, true)
507GET_OFDM_MODE(OfdmRate4_5MbpsBW5MHz, false)
508GET_OFDM_MODE(OfdmRate6MbpsBW5MHz, true)
509GET_OFDM_MODE(OfdmRate9MbpsBW5MHz, false)
510GET_OFDM_MODE(OfdmRate12MbpsBW5MHz, false)
511GET_OFDM_MODE(OfdmRate13_5MbpsBW5MHz, false)
512#undef GET_OFDM_MODE
513
514WifiMode
515OfdmPhy::CreateOfdmMode(std::string uniqueName, bool isMandatory)
516{
517 // Check whether uniqueName is in lookup table
518 const auto it = m_ofdmModulationLookupTable.find(uniqueName);
520 "OFDM mode cannot be created because it is not in the lookup table!");
521
522 return WifiModeFactory::CreateWifiMode(uniqueName,
524 isMandatory,
525 MakeBoundCallback(&GetCodeRate, uniqueName),
530}
531
533OfdmPhy::GetCodeRate(const std::string& name)
534{
535 return m_ofdmModulationLookupTable.at(name).first;
536}
537
538uint16_t
539OfdmPhy::GetConstellationSize(const std::string& name)
540{
541 return m_ofdmModulationLookupTable.at(name).second;
542}
543
544uint64_t
545OfdmPhy::GetPhyRate(const std::string& name, uint16_t channelWidth)
546{
547 WifiCodeRate codeRate = GetCodeRate(name);
548 uint64_t dataRate = GetDataRate(name, channelWidth);
549 return CalculatePhyRate(codeRate, dataRate);
550}
551
552uint64_t
553OfdmPhy::CalculatePhyRate(WifiCodeRate codeRate, uint64_t dataRate)
554{
555 return (dataRate / GetCodeRatio(codeRate));
556}
557
558uint64_t
559OfdmPhy::GetPhyRateFromTxVector(const WifiTxVector& txVector, uint16_t /* staId */)
560{
561 return GetPhyRate(txVector.GetMode().GetUniqueName(), txVector.GetChannelWidth());
562}
563
564double
566{
567 switch (codeRate)
568 {
570 return (3.0 / 4.0);
572 return (2.0 / 3.0);
574 return (1.0 / 2.0);
576 default:
577 NS_FATAL_ERROR("trying to get code ratio for undefined coding rate");
578 return 0;
579 }
580}
581
582uint64_t
583OfdmPhy::GetDataRateFromTxVector(const WifiTxVector& txVector, uint16_t /* staId */)
584{
585 return GetDataRate(txVector.GetMode().GetUniqueName(), txVector.GetChannelWidth());
586}
587
588uint64_t
589OfdmPhy::GetDataRate(const std::string& name, uint16_t channelWidth)
590{
591 WifiCodeRate codeRate = GetCodeRate(name);
592 uint16_t constellationSize = GetConstellationSize(name);
593 return CalculateDataRate(codeRate, constellationSize, channelWidth);
594}
595
596uint64_t
597OfdmPhy::CalculateDataRate(WifiCodeRate codeRate, uint16_t constellationSize, uint16_t channelWidth)
598{
599 return CalculateDataRate(GetSymbolDuration(channelWidth),
601 static_cast<uint16_t>(log2(constellationSize)),
602 GetCodeRatio(codeRate));
603}
604
605uint64_t
607 uint16_t usableSubCarriers,
608 uint16_t numberOfBitsPerSubcarrier,
609 double codingRate)
610{
611 double symbolRate = (1e9 / static_cast<double>(symbolDuration.GetNanoSeconds()));
612 return lrint(ceil(symbolRate * usableSubCarriers * numberOfBitsPerSubcarrier * codingRate));
613}
614
615uint16_t
617{
618 return 48;
619}
620
621Time
622OfdmPhy::GetSymbolDuration(uint16_t channelWidth)
623{
624 Time symbolDuration = MicroSeconds(4);
625 uint8_t bwFactor = 1;
626 if (channelWidth == 10)
627 {
628 bwFactor = 2;
629 }
630 else if (channelWidth == 5)
631 {
632 bwFactor = 4;
633 }
634 return bwFactor * symbolDuration;
635}
636
637bool
639{
640 return true;
641}
642
645{
646 return 4095;
647}
648
649uint16_t
651{
652 if (!ppdu)
653 {
654 return 20;
655 }
656 return GetRxChannelWidth(ppdu->GetTxVector());
657}
658
659double
661{
662 if (ppdu && ppdu->GetTxVector().GetChannelWidth() < 20)
663 {
664 // scale CCA sensitivity threshold for BW of 5 and 10 MHz
665 uint16_t bw = GetRxChannelWidth(ppdu->GetTxVector());
666 double thresholdW = DbmToW(m_wifiPhy->GetCcaSensitivityThreshold()) * (bw / 20.0);
667 return WToDbm(thresholdW);
668 }
669 return PhyEntity::GetCcaThreshold(ppdu, channelType);
670}
671
672} // namespace ns3
673
674namespace
675{
676
681{
682 public:
684 {
687 ns3::Create<ns3::OfdmPhy>()); // default variant will do
688 }
690
691} // namespace
Constructor class for OFDM modes.
Definition: ofdm-phy.cc:681
static WifiMode GetOfdmRate6Mbps()
Return a WifiMode for OFDM at 6 Mbps.
uint32_t GetMaxPsduSize() const override
Get the maximum PSDU size in bytes.
Definition: ofdm-phy.cc:644
~OfdmPhy() override
Destructor for OFDM PHY.
Definition: ofdm-phy.cc:145
static WifiMode GetOfdmRate13_5MbpsBW5MHz()
Return a WifiMode for OFDM at 13.5 Mbps with 5 MHz channel spacing.
static WifiMode GetOfdmRate48Mbps()
Return a WifiMode for OFDM at 48 Mbps.
static const PpduFormats m_ofdmPpduFormats
OFDM PPDU formats.
Definition: ofdm-phy.h:452
static uint16_t GetConstellationSize(const std::string &name)
Return the constellation size from the OFDM mode's unique name using ModulationLookupTable.
Definition: ofdm-phy.cc:539
Ptr< SpectrumValue > GetTxPowerSpectralDensity(double txPowerW, Ptr< const WifiPpdu > ppdu, const WifiTxVector &txVector) const override
Definition: ofdm-phy.cc:364
static WifiMode GetOfdmRate54Mbps()
Return a WifiMode for OFDM at 54 Mbps.
uint8_t GetNumberServiceBits() const
Definition: ofdm-phy.cc:280
static WifiCodeRate GetCodeRate(const std::string &name)
Return the WifiCodeRate from the OFDM mode's unique name using ModulationLookupTable.
Definition: ofdm-phy.cc:533
double GetCcaThreshold(const Ptr< const WifiPpdu > ppdu, WifiChannelListType channelType) const override
Return the CCA threshold in dBm for a given channel type.
Definition: ofdm-phy.cc:660
static uint64_t GetPhyRateFromTxVector(const WifiTxVector &txVector, uint16_t staId)
Return the PHY rate corresponding to the supplied TXVECTOR.
Definition: ofdm-phy.cc:559
static uint64_t CalculateDataRate(WifiCodeRate codeRate, uint16_t constellationSize, uint16_t channelWidth)
Calculates data rate from the supplied parameters.
Definition: ofdm-phy.cc:597
static WifiMode GetOfdmRate36Mbps()
Return a WifiMode for OFDM at 36 Mbps.
static WifiMode GetOfdmRate3MbpsBW10MHz()
Return a WifiMode for OFDM at 3 Mbps with 10 MHz channel spacing.
static void InitializeModes()
Initialize all OFDM modes (for all variants).
Definition: ofdm-phy.cc:384
virtual bool IsAllConfigSupported(WifiPpduField field, Ptr< const WifiPpdu > ppdu) const
Checks if the signaled configuration (including bandwidth) is supported by the PHY.
Definition: ofdm-phy.cc:354
PhyFieldRxStatus EndReceiveHeader(Ptr< Event > event)
End receiving the header, perform OFDM-specific actions, and provide the status of the reception.
Definition: ofdm-phy.cc:317
static WifiMode GetOfdmRate2_25MbpsBW5MHz()
Return a WifiMode for OFDM at 2.25 Mbps with 5 MHz channel spacing.
const PpduFormats & GetPpduFormats() const override
Return the PPDU formats of the PHY.
Definition: ofdm-phy.cc:184
static bool IsAllowed(const WifiTxVector &txVector)
Check whether the combination in TXVECTOR is allowed.
Definition: ofdm-phy.cc:638
static WifiMode GetOfdmRate6MbpsBW5MHz()
Return a WifiMode for OFDM at 6 Mbps with 5 MHz channel spacing.
OfdmPhy(OfdmPhyVariant variant=OFDM_PHY_DEFAULT, bool buildModeList=true)
Constructor for OFDM PHY.
Definition: ofdm-phy.cc:105
static uint64_t GetDataRateFromTxVector(const WifiTxVector &txVector, uint16_t staId)
Return the data rate corresponding to the supplied TXVECTOR.
Definition: ofdm-phy.cc:583
static WifiMode GetOfdmRate1_5MbpsBW5MHz()
Return a WifiMode for OFDM at 1.5 Mbps with 5 MHz channel spacing.
static WifiMode GetOfdmRate18MbpsBW10MHz()
Return a WifiMode for OFDM at 18 Mbps with 10 MHz channel spacing.
static Time GetSymbolDuration(uint16_t channelWidth)
Definition: ofdm-phy.cc:622
static uint64_t GetPhyRate(const std::string &name, uint16_t channelWidth)
Return the PHY rate from the OFDM mode's unique name and the supplied parameters.
Definition: ofdm-phy.cc:545
static WifiMode GetOfdmRate12MbpsBW10MHz()
Return a WifiMode for OFDM at 12 Mbps with 10 MHz channel spacing.
static uint16_t GetUsableSubcarriers()
Definition: ofdm-phy.cc:616
static WifiMode GetOfdmRate9MbpsBW10MHz()
Return a WifiMode for OFDM at 9 Mbps with 10 MHz channel spacing.
static WifiMode GetOfdmRate4_5MbpsBW5MHz()
Return a WifiMode for OFDM at 4.5 Mbps with 5 MHz channel spacing.
static WifiMode GetOfdmRate3MbpsBW5MHz()
Return a WifiMode for OFDM at 3 Mbps with 5 MHz channel spacing.
virtual Time GetPreambleDuration(const WifiTxVector &txVector) const
Definition: ofdm-phy.cc:204
static WifiMode GetOfdmRate(uint64_t rate, uint16_t bw=20)
Return a WifiMode for OFDM corresponding to the provided rate and the channel bandwidth (20,...
Definition: ofdm-phy.cc:396
static WifiMode GetOfdmRate27MbpsBW10MHz()
Return a WifiMode for OFDM at 27 Mbps with 10 MHz channel spacing.
static WifiMode GetOfdmRate9MbpsBW5MHz()
Return a WifiMode for OFDM at 9 Mbps with 5 MHz channel spacing.
Ptr< WifiPpdu > BuildPpdu(const WifiConstPsduMap &psdus, const WifiTxVector &txVector, Time ppduDuration) override
Build amendment-specific PPDU.
Definition: ofdm-phy.cc:292
static WifiMode GetOfdmRate12Mbps()
Return a WifiMode for OFDM at 12Mbps.
static WifiMode CreateOfdmMode(std::string uniqueName, bool isMandatory)
Create an OFDM mode from a unique name, the unique name must already be contained inside ModulationLo...
Definition: ofdm-phy.cc:515
uint16_t GetMeasurementChannelWidth(const Ptr< const WifiPpdu > ppdu) const override
Return the channel width used to measure the RSSI.
Definition: ofdm-phy.cc:650
static WifiMode GetOfdmRate24MbpsBW10MHz()
Return a WifiMode for OFDM at 24 Mbps with 10 MHz channel spacing.
static WifiMode GetOfdmRate18Mbps()
Return a WifiMode for OFDM at 18 Mbps.
static uint64_t CalculatePhyRate(WifiCodeRate codeRate, uint64_t dataRate)
Calculate the PHY rate in bps from code rate and data rate.
Definition: ofdm-phy.cc:553
static WifiMode GetOfdmRate6MbpsBW10MHz()
Return a WifiMode for OFDM at 6 Mbps with 10 MHz channel spacing.
static WifiMode GetOfdmRate24Mbps()
Return a WifiMode for OFDM at 24 Mbps.
Time GetDuration(WifiPpduField field, const WifiTxVector &txVector) const override
Get the duration of the PPDU field (or group of fields) used by this entity for the given transmissio...
Definition: ofdm-phy.cc:190
PhyFieldRxStatus DoEndReceiveField(WifiPpduField field, Ptr< Event > event) override
End receiving a given field, perform amendment-specific actions, and provide the status of the recept...
Definition: ofdm-phy.cc:306
virtual Time GetHeaderDuration(const WifiTxVector &txVector) const
Definition: ofdm-phy.cc:228
virtual WifiMode GetHeaderMode(const WifiTxVector &txVector) const
Definition: ofdm-phy.cc:165
WifiMode GetSigMode(WifiPpduField field, const WifiTxVector &txVector) const override
Get the WifiMode for the SIG field specified by the PPDU field.
Definition: ofdm-phy.cc:151
static WifiMode GetOfdmRate12MbpsBW5MHz()
Return a WifiMode for OFDM at 12 Mbps with 5 MHz channel spacing.
static const ModulationLookupTable m_ofdmModulationLookupTable
lookup table to retrieve code rate and constellation size corresponding to a unique name of modulatio...
Definition: ofdm-phy.h:455
static uint64_t GetDataRate(const std::string &name, uint16_t channelWidth)
Return the data rate from the OFDM mode's unique name and the supplied parameters.
Definition: ofdm-phy.cc:589
static WifiMode GetOfdmRate4_5MbpsBW10MHz()
Return a WifiMode for OFDM at 4.5 Mbps with 10 MHz channel spacing.
static WifiMode GetOfdmRate9Mbps()
Return a WifiMode for OFDM at 9 Mbps.
virtual bool IsChannelWidthSupported(Ptr< const WifiPpdu > ppdu) const
Checks if the PPDU's bandwidth is supported by the PHY.
Definition: ofdm-phy.cc:341
static double GetCodeRatio(WifiCodeRate codeRate)
Convert WifiCodeRate to a ratio, e.g., code ratio of WIFI_CODE_RATE_1_2 is 0.5.
Definition: ofdm-phy.cc:565
Time GetSignalExtension(WifiPhyBand band) const
Definition: ofdm-phy.cc:286
Time GetPayloadDuration(uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, MpduType mpdutype, bool incFlag, uint32_t &totalAmpduSize, double &totalAmpduNumSymbols, uint16_t staId) const override
Definition: ofdm-phy.cc:252
virtual Time GetDuration(WifiPpduField field, const WifiTxVector &txVector) const
Get the duration of the PPDU field (or group of fields) used by this entity for the given transmissio...
Definition: phy-entity.cc:190
std::tuple< double, double, double > GetTxMaskRejectionParams() const
Definition: phy-entity.cc:1323
virtual uint64_t ObtainNextUid(const WifiTxVector &txVector)
Obtain the next UID for the PPDU to transmit.
Definition: phy-entity.cc:1260
Ptr< WifiPhy > m_wifiPhy
Pointer to the owning WifiPhy.
Definition: phy-entity.h:942
std::map< std::string, CodeRateConstellationSizePair > ModulationLookupTable
A modulation lookup table using unique name of modulation as key.
Definition: phy-entity.h:534
virtual double GetCcaThreshold(const Ptr< const WifiPpdu > ppdu, WifiChannelListType channelType) const
Return the CCA threshold in dBm for a given channel type.
Definition: phy-entity.cc:1199
std::map< WifiPreamble, std::vector< WifiPpduField > > PpduFormats
A map of PPDU field elements per preamble type.
Definition: phy-entity.h:524
virtual WifiMode GetSigMode(WifiPpduField field, const WifiTxVector &txVector) const
Get the WifiMode for the SIG field specified by the PPDU field.
Definition: phy-entity.cc:150
virtual uint16_t GetRxChannelWidth(const WifiTxVector &txVector) const
Return the channel width used in the reception spectrum model.
Definition: phy-entity.cc:1193
uint16_t GetGuardBandwidth(uint16_t currentChannelWidth) const
Definition: phy-entity.cc:1317
std::list< WifiMode > m_modeList
the list of supported modes
Definition: phy-entity.h:946
double GetRandomValue() const
Obtain a random value from the WifiPhy's generator.
Definition: phy-entity.cc:1156
SnrPer GetPhyHeaderSnrPer(WifiPpduField field, Ptr< Event > event) const
Obtain the SNR and PER of the PPDU field from the WifiPhy's InterferenceHelper class.
Definition: phy-entity.cc:272
uint16_t GetCenterFrequencyForChannelWidth(const WifiTxVector &txVector) const
Get the center frequency of the channel corresponding the current TxVector rather than that of the su...
Definition: phy-entity.cc:1267
virtual bool IsConfigSupported(Ptr< const WifiPpdu > ppdu) const
Checks if the signaled configuration (excluding bandwidth) is supported by the PHY.
Definition: phy-entity.cc:1056
@ DROP
drop PPDU and set CCA_BUSY
Definition: phy-entity.h:104
@ ABORT
abort reception of PPDU
Definition: phy-entity.h:105
virtual PhyFieldRxStatus DoEndReceiveField(WifiPpduField field, Ptr< Event > event)
End receiving a given field, perform amendment-specific actions, and provide the status of the recept...
Definition: phy-entity.cc:389
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:78
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
int64_t GetNanoSeconds() const
Get an approximation of the time stored in this instance in the indicated unit.
Definition: nstime.h:417
int64_t GetFemtoSeconds() const
Get an approximation of the time stored in this instance in the indicated unit.
Definition: nstime.h:427
static WifiMode CreateWifiMode(std::string uniqueName, WifiModulationClass modClass, bool isMandatory, CodeRateCallback codeRateCallback, ConstellationSizeCallback constellationSizeCallback, PhyRateCallback phyRateCallback, DataRateCallback dataRateCallback, AllowedCallback isAllowedCallback)
Definition: wifi-mode.cc:270
represent a single transmission mode
Definition: wifi-mode.h:50
std::string GetUniqueName() const
Definition: wifi-mode.cc:148
uint64_t GetDataRate(uint16_t channelWidth, uint16_t guardInterval, uint8_t nss) const
Definition: wifi-mode.cc:122
uint16_t GetChannelWidth() const
Definition: wifi-phy.cc:980
WifiPhyBand GetPhyBand() const
Get the configured Wi-Fi band.
Definition: wifi-phy.cc:950
static void AddStaticPhyEntity(WifiModulationClass modulation, Ptr< PhyEntity > phyEntity)
Add the PHY entity to the map of implemented PHY entities for the given modulation class.
Definition: wifi-phy.cc:699
const WifiPhyOperatingChannel & GetOperatingChannel() const
Get a const reference to the operating channel.
Definition: wifi-phy.cc:962
double GetCcaSensitivityThreshold() const
Return the CCA sensitivity threshold (dBm).
Definition: wifi-phy.cc:480
uint16_t GetPrimaryChannelCenterFrequency(uint16_t primaryChannelWidth) const
Get the center frequency of the primary channel of the given width.
static Ptr< SpectrumValue > CreateOfdmTxPowerSpectralDensity(uint32_t centerFrequency, uint16_t channelWidth, double txPowerW, uint16_t guardBandwidth, double minInnerBandDbr=-20, double minOuterbandDbr=-28, double lowestPointDbr=-40)
Create a transmit power spectral density corresponding to OFDM (802.11a/g).
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
WifiMode GetMode(uint16_t staId=SU_STA_ID) const
If this TX vector is associated with an SU PPDU, return the selected payload transmission mode.
uint16_t GetChannelWidth() const
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Definition: assert.h:86
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
Definition: fatal-error.h:160
#define NS_ABORT_MSG(msg)
Unconditional abnormal program termination with a message.
Definition: abort.h:49
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:202
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Definition: log.h:268
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
Definition: log.h:282
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
auto MakeBoundCallback(R(*fnPtr)(Args...), BArgs... bargs)
Make Callbacks with varying number of bound arguments.
Definition: callback.h:752
Time MicroSeconds(uint64_t value)
Construct a Time in the indicated unit.
Definition: nstime.h:1362
Time FemtoSeconds(uint64_t value)
Construct a Time in the indicated unit.
Definition: nstime.h:1398
WifiPhyBand
Identifies the PHY band.
Definition: wifi-phy-band.h:33
OfdmPhyVariant
The OFDM (11a) PHY variants.
Definition: ofdm-phy.h:44
WifiChannelListType
Enumeration of the possible channel-list parameter elements defined in Table 8-5 of IEEE 802....
WifiPpduField
The type of PPDU field (grouped for convenience)
MpduType
The type of an MPDU.
@ UNSUPPORTED_SETTINGS
@ L_SIG_FAILURE
@ WIFI_PREAMBLE_LONG
@ WIFI_PHY_BAND_2_4GHZ
The 2.4 GHz band.
Definition: wifi-phy-band.h:35
@ WIFI_MOD_CLASS_OFDM
OFDM (Clause 17)
@ OFDM_PHY_10_MHZ
Definition: ofdm-phy.h:46
@ OFDM_PHY_DEFAULT
Definition: ofdm-phy.h:45
@ OFDM_PHY_5_MHZ
Definition: ofdm-phy.h:47
@ WIFI_PPDU_FIELD_NON_HT_HEADER
PHY header field for DSSS or ERP, short PHY header field for HR/DSSS or ERP, field not present for HT...
@ WIFI_PPDU_FIELD_PREAMBLE
SYNC + SFD fields for DSSS or ERP, shortSYNC + shortSFD fields for HR/DSSS or ERP,...
@ WIFI_PPDU_FIELD_DATA
data field
class anonymous_namespace{ofdm-phy.cc}::ConstructorOfdm g_constructor_ofdm
the constructor for OFDM modes
Every class exported by the ns3 library is enclosed in the ns3 namespace.
const uint16_t WIFI_CODE_RATE_UNDEFINED
undefined coding rate
double RatioToDb(double ratio)
Convert from ratio to dB.
Definition: wifi-utils.cc:52
const uint16_t WIFI_CODE_RATE_3_4
3/4 coding rate
std::unordered_map< uint16_t, Ptr< const WifiPsdu > > WifiConstPsduMap
Map of const PSDUs indexed by STA-ID.
double WToDbm(double w)
Convert from Watts to dBm.
Definition: wifi-utils.cc:46
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:691
const uint16_t WIFI_CODE_RATE_1_2
1/2 coding rate
const std::map< uint16_t, std::array< uint64_t, 8 > > s_ofdmRatesBpsList
OFDM rates in bits per second for each bandwidth (MHz)
Definition: ofdm-phy.cc:81
double DbmToW(double dBm)
Convert from dBm to Watts.
Definition: wifi-utils.cc:40
const uint16_t WIFI_CODE_RATE_2_3
2/3 coding rate
uint16_t WifiCodeRate
These constants define the various convolutional coding rates used for the OFDM transmission modes in...
const std::map< uint16_t, std::array< uint64_t, 8 > > & GetOfdmRatesBpsList()
Get the array of possible OFDM rates for each bandwidth (MHz).
Definition: ofdm-phy.cc:100
#define GET_OFDM_MODE(x, f)
Definition: ofdm-phy.cc:478
Declaration of ns3::OfdmPhy class and ns3::OfdmPhyVariant enum.
Declaration of ns3::OfdmPpdu class.
Status of the reception of the PPDU field.
Definition: phy-entity.h:113
WifiPhyRxfailureReason reason
failure reason
Definition: phy-entity.h:115
PhyRxFailureAction actionIfFailure
action to perform in case of failure
Definition: phy-entity.h:116
bool isSuccess
outcome (true if success) of the reception
Definition: phy-entity.h:114
A struct for both SNR and PER.
Definition: phy-entity.h:148
double snr
SNR in linear scale.
Definition: phy-entity.h:149