11#ifndef WIFI_PHY_COMMON_H
12#define WIFI_PHY_COMMON_H
18#include "ns3/fatal-error.h"
54 std::vector<WifiSpectrumBandIndices>
56 std::vector<WifiSpectrumBandFrequencies>
96 for (std::size_t segmentIndex = 0; segmentIndex < band.
indices.size(); ++segmentIndex)
98 os <<
"indices segment" << segmentIndex <<
": [" << band.
indices.at(segmentIndex).first
99 <<
"-" << band.
indices.at(segmentIndex).second <<
"], frequencies segment"
100 << segmentIndex <<
": [" << band.
frequencies.at(segmentIndex).first <<
"Hz-"
101 << band.
frequencies.at(segmentIndex).second <<
"Hz] ";
143 return (os <<
"Code rate undefined");
145 return (os <<
"Code rate 1/2");
147 return (os <<
"Code rate 2/3");
149 return (os <<
"Code rate 3/4");
151 return (os <<
"Code rate 5/6");
153 return (os <<
"Code rate 5/8");
155 return (os <<
"Code rate 13/16");
157 return (os <<
"Code rate 1/4");
159 return (os <<
"Code rate 13/28");
161 return (os <<
"Code rate 13/21");
163 return (os <<
"Code rate 52/63");
165 return (os <<
"Code rate 13/14");
167 return (os <<
"Code rate 7/8");
170 return (os <<
"Unknown");
209 return (os <<
"LONG");
211 return (os <<
"SHORT");
213 return (os <<
"HT_MF");
215 return (os <<
"VHT_SU");
217 return (os <<
"VHT_MU");
219 return (os <<
"DMG_CTRL");
221 return (os <<
"DMG_SC");
223 return (os <<
"DMG_OFDM");
225 return (os <<
"HE_SU");
227 return (os <<
"HE_ER_SU");
229 return (os <<
"HE_MU");
231 return (os <<
"HE_TB");
233 return (os <<
"EHT_MU");
235 return (os <<
"EHT_TB");
238 return (os <<
"INVALID");
280 return (os <<
"DSSS");
282 return (os <<
"HR/DSSS");
284 return (os <<
"ERP-OFDM");
286 return (os <<
"OFDM");
290 return (os <<
"VHT");
292 return (os <<
"DMG_CTRL");
294 return (os <<
"DMG_OFDM");
296 return (os <<
"DMG_SC");
298 return (os <<
"DMG_LP_SC");
302 return (os <<
"EHT");
305 return (os <<
"unknown");
351 return (os <<
"preamble");
353 return (os <<
"non-HT header");
355 return (os <<
"HT-SIG");
357 return (os <<
"training");
359 return (os <<
"SIG-A");
361 return (os <<
"SIG-B");
363 return (os <<
"U-SIG");
365 return (os <<
"EHT-SIG");
367 return (os <<
"data");
370 return (os <<
"unknown");
400 return (os <<
"DL MU");
402 return (os <<
"UL MU");
405 return (os <<
"unknown");
455 return (os <<
"UNSUPPORTED_SETTINGS");
457 return (os <<
"CHANNEL_SWITCHING");
459 return (os <<
"RXING");
461 return (os <<
"TXING");
463 return (os <<
"SLEEPING");
465 return (os <<
"OFF");
467 return (os <<
"TRUNCATED_TX");
469 return (os <<
"BUSY_DECODING_PREAMBLE");
471 return (os <<
"PREAMBLE_DETECT_FAILURE");
473 return (os <<
"RECEPTION_ABORTED_BY_TX");
475 return (os <<
"L_SIG_FAILURE");
477 return (os <<
"HT_SIG_FAILURE");
479 return (os <<
"SIG_A_FAILURE");
481 return (os <<
"SIG_B_FAILURE");
483 return (os <<
"U_SIG_FAILURE");
485 return (os <<
"EHT_SIG_FAILURE");
487 return (os <<
"PREAMBLE_DETECTION_PACKET_SWITCH");
489 return (os <<
"FRAME_CAPTURE_PACKET_SWITCH");
491 return (os <<
"OBSS_PD_CCA_RESET");
493 return (os <<
"PPDU_TOO_LATE");
495 return (os <<
"FILTERED");
497 return (os <<
"DMG_HEADER_FAILURE");
499 return (os <<
"DMG_ALLOCATION_ENDED");
501 return (os <<
"SIGNAL_DETECTION_ABORTED_BY_TX");
505 return (os <<
"UNKNOWN");
535 return (os <<
"PRIMARY");
537 return (os <<
"SECONDARY");
539 return (os <<
"SECONDARY40");
541 return (os <<
"SECONDARY80");
544 return (os <<
"UNKNOWN");
561 return (os <<
"20MHz");
563 return (os <<
"22MHz");
565 return (os <<
"5MHz");
567 return (os <<
"10MHz");
569 return (os <<
"40MHz");
571 return (os <<
"80MHz");
573 return (os <<
"160MHz");
575 return (os <<
"80+80MHz");
577 return (os <<
"2160MHz");
580 return (os <<
"UNKNOWN");
614 bool useShortPreamble =
false);
636 WifiModulationClass modClassAnswer);
655bool IsMu(WifiPreamble preamble);
663bool IsDlMu(WifiPreamble preamble);
671bool IsUlMu(WifiPreamble preamble);
716bool IsEht(WifiPreamble preamble);
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
WifiPhyRxfailureReason
Enumeration of the possible reception failure reasons.
WifiPreamble
The type of preamble to be used by an IEEE 802.11 transmission.
WifiPpduType
The type of PPDU (SU, DL MU, or UL MU)
WifiModulationClass
This enumeration defines the modulation classes per (Table 10-6 "Modulation classes"; IEEE 802....
WifiChannelWidthType
Enumeration of the possible channel widths.
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)
@ PREAMBLE_DETECT_FAILURE
@ FRAME_CAPTURE_PACKET_SWITCH
@ SIGNAL_DETECTION_ABORTED_BY_TX
@ RECEPTION_ABORTED_BY_TX
@ PREAMBLE_DETECTION_PACKET_SWITCH
@ WIFI_MOD_CLASS_DMG_OFDM
DMG (Clause 21)
@ WIFI_MOD_CLASS_DMG_CTRL
DMG (Clause 21)
@ WIFI_MOD_CLASS_OFDM
OFDM (Clause 17)
@ WIFI_MOD_CLASS_HR_DSSS
HR/DSSS (Clause 16)
@ WIFI_MOD_CLASS_UNKNOWN
Modulation class unknown or unspecified.
@ WIFI_MOD_CLASS_DMG_SC
DMG (Clause 21)
@ WIFI_MOD_CLASS_HT
HT (Clause 19)
@ WIFI_MOD_CLASS_EHT
EHT (Clause 36)
@ WIFI_MOD_CLASS_VHT
VHT (Clause 22)
@ WIFI_MOD_CLASS_HE
HE (Clause 27)
@ WIFI_MOD_CLASS_DMG_LP_SC
DMG (Clause 21)
@ WIFI_MOD_CLASS_DSSS
DSSS (Clause 15)
@ WIFI_MOD_CLASS_ERP_OFDM
ERP-OFDM (18.4)
@ WIFI_CHANLIST_SECONDARY40
@ WIFI_CHANLIST_SECONDARY
@ WIFI_CHANLIST_SECONDARY80
@ WIFI_PPDU_FIELD_SIG_B
SIG-B field.
@ WIFI_PPDU_FIELD_TRAINING
STF + LTF fields (excluding those in preamble for HT-GF)
@ 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_EHT_SIG
EHT-SIG field.
@ WIFI_PPDU_FIELD_HT_SIG
HT-SIG field.
@ WIFI_PPDU_FIELD_PREAMBLE
SYNC + SFD fields for DSSS or ERP, shortSYNC + shortSFD fields for HR/DSSS or ERP,...
@ WIFI_PPDU_FIELD_U_SIG
U-SIG field.
@ WIFI_PPDU_FIELD_DATA
data field
@ WIFI_PPDU_FIELD_SIG_A
SIG-A field.
void(* Time)(Time oldValue, Time newValue)
TracedValue callback signature for Time.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Time GetPpduMaxTime(WifiPreamble preamble)
Get the maximum PPDU duration (see Section 10.14 of 802.11-2016) for the PHY layers defining the aPPD...
bool IsEht(WifiPreamble preamble)
Return true if a preamble corresponds to an EHT transmission.
Time GetGuardIntervalForMode(WifiMode mode, const Ptr< WifiNetDevice > device)
Get the guard interval for a given WifiMode.
std::ostream & operator<<(std::ostream &os, const Angles &a)
bool IsAllowedControlAnswerModulationClass(WifiModulationClass modClassReq, WifiModulationClass modClassAnswer)
Return whether the modulation class of the selected mode for the control answer frame is allowed.
bool IsMu(WifiPreamble preamble)
Return true if a preamble corresponds to a multi-user transmission.
std::vector< WifiSpectrumBandInfo > WifiSpectrumBands
vector of spectrum bands
double MHz_u
MHz weak type.
WifiModulationClass GetModulationClassForPreamble(WifiPreamble preamble)
Return the modulation class corresponding to the given preamble type.
std::pair< Hz_u, Hz_u > WifiSpectrumBandFrequencies
typedef for a pair of start and stop frequencies to represent a band
MHz_u GetMaximumChannelWidth(WifiModulationClass modulation)
Get the maximum channel width allowed for the given modulation class.
bool operator<(const EventId &a, const EventId &b)
MHz_u GetChannelWidthInMhz(WifiChannelWidthType width)
Get the total channel width for the channel width type.
WifiModulationClass GetModulationClassForStandard(WifiStandard standard)
Return the modulation class corresponding to a given standard.
bool IsDlMu(WifiPreamble preamble)
Return true if a preamble corresponds to a downlink multi-user transmission.
std::set< MHz_u > GetSupportedChannelWidthSet(WifiStandard standard, WifiPhyBand band)
Get the supported channel width set that can be advertised in PHY capabilities.
WifiPreamble GetPreambleForTransmission(WifiModulationClass modulation, bool useShortPreamble)
Return the preamble to be used for the transmission.
static constexpr uint8_t MAX_PROPAGATION_DELAY_USEC
maximum propagation delay
bool IsUlMu(WifiPreamble preamble)
Return true if a preamble corresponds to a uplink multi-user transmission.
WifiCodeRate
These constants define the various convolutional coding rates used for the OFDM transmission modes in...
@ WIFI_CODE_RATE_2_3
2/3 coding rate
@ WIFI_CODE_RATE_13_21
13/21 coding rate
@ WIFI_CODE_RATE_1_2
1/2 coding rate
@ WIFI_CODE_RATE_3_4
3/4 coding rate
@ WIFI_CODE_RATE_1_4
1/4 coding rate
@ WIFI_CODE_RATE_UNDEFINED
undefined coding rate
@ WIFI_CODE_RATE_7_8
7/8 coding rate
@ WIFI_CODE_RATE_52_63
52/63 coding rate
@ WIFI_CODE_RATE_13_14
13/14 coding rate
@ WIFI_CODE_RATE_13_28
13/28 coding rate
@ WIFI_CODE_RATE_5_6
5/6 coding rate
@ WIFI_CODE_RATE_5_8
5/8 coding rate
@ WIFI_CODE_RATE_13_16
13/16 coding rate
WifiSpectrumBandInfo structure containing info about a spectrum band.
std::vector< WifiSpectrumBandFrequencies > frequencies
the start and stop frequencies for each segment of the band
std::vector< WifiSpectrumBandIndices > indices
the start and stop indices for each segment of the band