PHY entity for HT (11n) More...
#include "ht-phy.h"
Public Member Functions | |
HtPhy (uint8_t maxNss=1, bool buildModeList=true) | |
Constructor for HT PHY. | |
~HtPhy () override | |
Destructor for HT PHY. | |
Ptr< WifiPpdu > | BuildPpdu (const WifiConstPsduMap &psdus, const WifiTxVector &txVector, Time ppduDuration) override |
Build amendment-specific PPDU. | |
uint8_t | GetBssMembershipSelector () const |
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 transmission parameters. | |
virtual Time | GetHtSigDuration () const |
virtual WifiMode | GetHtSigMode () const |
virtual Time | GetLSigDuration (WifiPreamble preamble) const |
uint8_t | GetMaxSupportedMcsIndexPerSs () const |
Set the maximum supported MCS index per spatial stream. | |
WifiMode | GetMcs (uint8_t index) const override |
Get the WifiMode corresponding to the given MCS index. | |
Time | GetPayloadDuration (uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, MpduType mpdutype, bool incFlag, uint32_t &totalAmpduSize, double &totalAmpduNumSymbols, uint16_t staId) const override |
const PpduFormats & | GetPpduFormats () const override |
Return the PPDU formats of the PHY. | |
WifiMode | GetSigMode (WifiPpduField field, const WifiTxVector &txVector) const override |
Get the WifiMode for the SIG field specified by the PPDU field. | |
virtual Time | GetTrainingDuration (const WifiTxVector &txVector, uint8_t nDataLtf, uint8_t nExtensionLtf=0) const |
bool | HandlesMcsModes () const override |
Check if the WifiModes handled by this PHY are MCSs. | |
bool | IsMcsSupported (uint8_t index) const override |
Check if the WifiMode corresponding to the given MCS index is supported. | |
void | SetMaxSupportedMcsIndexPerSs (uint8_t maxIndex) |
Set the maximum supported MCS index per spatial stream. | |
void | SetMaxSupportedNss (uint8_t maxNss) |
Configure the maximum number of spatial streams supported by this HT PHY. | |
Public Member Functions inherited from ns3::OfdmPhy | |
OfdmPhy (OfdmPhyVariant variant=OFDM_PHY_DEFAULT, bool buildModeList=true) | |
Constructor for OFDM PHY. | |
~OfdmPhy () override | |
Destructor for OFDM PHY. | |
Ptr< WifiPpdu > | BuildPpdu (const WifiConstPsduMap &psdus, const WifiTxVector &txVector, Time ppduDuration) override |
Build amendment-specific PPDU. | |
dBm_u | GetCcaThreshold (const Ptr< const WifiPpdu > ppdu, WifiChannelListType channelType) const override |
Return the CCA threshold for a given channel type. | |
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 transmission parameters. | |
Time | GetPayloadDuration (uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, MpduType mpdutype, bool incFlag, uint32_t &totalAmpduSize, double &totalAmpduNumSymbols, uint16_t staId) const override |
const PpduFormats & | GetPpduFormats () const override |
Return the PPDU formats of the PHY. | |
Ptr< const WifiPpdu > | GetRxPpduFromTxPpdu (Ptr< const WifiPpdu > ppdu) override |
The WifiPpdu from the TX PHY is received by each RX PHY attached to the same channel. | |
WifiMode | GetSigMode (WifiPpduField field, const WifiTxVector &txVector) const override |
Get the WifiMode for the SIG field specified by the PPDU field. | |
Public Member Functions inherited from ns3::PhyEntity | |
virtual | ~PhyEntity () |
Destructor for PHY entity. | |
std::list< WifiMode >::const_iterator | begin () const |
Return a const iterator to the first WifiMode. | |
Time | CalculatePhyPreambleAndHeaderDuration (const WifiTxVector &txVector) const |
virtual Time | CalculateTxDuration (const WifiConstPsduMap &psduMap, const WifiTxVector &txVector, WifiPhyBand band) const |
virtual void | CancelAllEvents () |
Cancel and clear all running events. | |
void | CancelRunningEndPreambleDetectionEvents () |
Cancel all end preamble detection events. | |
virtual bool | CanStartRx (Ptr< const WifiPpdu > ppdu) const |
Determine whether the PHY shall issue a PHY-RXSTART.indication primitive in response to a given PPDU. | |
std::list< WifiMode >::const_iterator | end () const |
Return a const iterator to past-the-last WifiMode. | |
void | EndReceiveField (WifiPpduField field, Ptr< Event > event) |
End receiving a given field. | |
void | EndReceivePayload (Ptr< Event > event) |
The last symbol of the PPDU has arrived. | |
virtual Ptr< const WifiPsdu > | GetAddressedPsduInPpdu (Ptr< const WifiPpdu > ppdu) const |
Get the PSDU addressed to that PHY in a PPDU (useful for MU PPDU). | |
Time | GetDurationUpToField (WifiPpduField field, const WifiTxVector &txVector) const |
Get the duration of the PPDU up to (but excluding) the given field. | |
virtual Time | GetMaxDelayPpduSameUid (const WifiTxVector &txVector) |
Obtain the maximum time between two PPDUs with the same UID to consider they are identical and their power can be added construtively. | |
WifiPpduField | GetNextField (WifiPpduField currentField, WifiPreamble preamble) const |
Return the field following the provided one. | |
virtual uint8_t | GetNumModes () const |
PhyHeaderSections | GetPhyHeaderSections (const WifiTxVector &txVector, Time ppduStart) const |
Return a map of PHY header chunk information per PPDU field. | |
Time | GetRemainingDurationAfterField (Ptr< const WifiPpdu > ppdu, WifiPpduField field) const |
Get the remaining duration of the PPDU after the end of the given field. | |
virtual uint16_t | GetStaId (const Ptr< const WifiPpdu > ppdu) const |
Return the STA ID that has been assigned to the station this PHY belongs to. | |
virtual WifiConstPsduMap | GetWifiConstPsduMap (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) const |
Get a WifiConstPsduMap from a PSDU and the TXVECTOR to use to send the PSDU. | |
virtual bool | IsModeSupported (WifiMode mode) const |
Check if the WifiMode is supported. | |
bool | NoEndPreambleDetectionEvents () const |
virtual void | NotifyCcaBusy (const Ptr< const WifiPpdu > ppdu, Time duration, WifiChannelListType channelType) |
Notify PHY state helper to switch to CCA busy state,. | |
virtual uint64_t | ObtainNextUid (const WifiTxVector &txVector) |
Obtain the next UID for the PPDU to transmit. | |
void | ResetReceive (Ptr< Event > event) |
Reset PHY at the end of the PPDU under reception after it has failed the PHY header. | |
void | SetOwner (Ptr< WifiPhy > wifiPhy) |
Set the WifiPhy owning this PHY entity. | |
void | StartReceiveField (WifiPpduField field, Ptr< Event > event) |
Start receiving a given field. | |
virtual void | StartReceivePreamble (Ptr< const WifiPpdu > ppdu, RxPowerWattPerChannelBand &rxPowersW, Time rxDuration) |
Start receiving the PHY preamble of a PPDU (i.e. | |
virtual void | StartTx (Ptr< const WifiPpdu > ppdu) |
This function is called by SpectrumWifiPhy to send the PPDU while performing amendment-specific actions. | |
virtual void | SwitchMaybeToCcaBusy (const Ptr< const WifiPpdu > ppdu) |
Check if PHY state should move to CCA busy state based on current state of interference tracker. | |
void | Transmit (Time txDuration, Ptr< const WifiPpdu > ppdu, dBm_u txPower, Ptr< SpectrumValue > txPowerSpectrum, const std::string &type) |
This function prepares most of the WifiSpectrumSignalParameters parameters and invokes SpectrumWifiPhy's Transmit method. | |
Public Member Functions inherited from ns3::SimpleRefCount< PhyEntity > | |
SimpleRefCount () | |
Default constructor. | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment operator. | |
void | Ref () const |
Increment the reference count. | |
void | Unref () const |
Decrement the reference count. | |
Static Public Member Functions | |
static WifiCodeRate | GetCodeRate (uint8_t mcsValue) |
Return the coding rate corresponding to the supplied HT MCS index between 0 and 7, since HT MCS index > 8 is used for higher NSS. | |
static uint16_t | GetConstellationSize (uint8_t mcsValue) |
Return the constellation size corresponding to the supplied HT MCS index between 0 and 7, since HT MCS index > 8 is used for higher NSS. | |
static uint64_t | GetDataRate (uint8_t mcsValue, MHz_u channelWidth, Time guardInterval, uint8_t nss) |
Return the data rate corresponding to the supplied HT MCS index, channel width, guard interval, and number of spatial streams. | |
static uint64_t | GetDataRateFromTxVector (const WifiTxVector &txVector, uint16_t staId) |
Return the data rate corresponding to the supplied TXVECTOR. | |
static WifiCodeRate | GetHtCodeRate (uint8_t mcsValue) |
Return the coding rate corresponding to the supplied HT MCS index. | |
static uint16_t | GetHtConstellationSize (uint8_t mcsValue) |
Return the constellation size corresponding to the supplied HT MCS index. | |
static WifiMode | GetHtMcs (uint8_t index) |
Return the HT MCS corresponding to the provided index. | |
static WifiMode | GetHtMcs0 () |
Return MCS 0 from HT MCS values. | |
static WifiMode | GetHtMcs1 () |
Return MCS 1 from HT MCS values. | |
static WifiMode | GetHtMcs10 () |
Return MCS 10 from HT MCS values. | |
static WifiMode | GetHtMcs11 () |
Return MCS 11 from HT MCS values. | |
static WifiMode | GetHtMcs12 () |
Return MCS 12 from HT MCS values. | |
static WifiMode | GetHtMcs13 () |
Return MCS 13 from HT MCS values. | |
static WifiMode | GetHtMcs14 () |
Return MCS 14 from HT MCS values. | |
static WifiMode | GetHtMcs15 () |
Return MCS 15 from HT MCS values. | |
static WifiMode | GetHtMcs16 () |
Return MCS 16 from HT MCS values. | |
static WifiMode | GetHtMcs17 () |
Return MCS 17 from HT MCS values. | |
static WifiMode | GetHtMcs18 () |
Return MCS 18 from HT MCS values. | |
static WifiMode | GetHtMcs19 () |
Return MCS 19 from HT MCS values. | |
static WifiMode | GetHtMcs2 () |
Return MCS 2 from HT MCS values. | |
static WifiMode | GetHtMcs20 () |
Return MCS 20 from HT MCS values. | |
static WifiMode | GetHtMcs21 () |
Return MCS 21 from HT MCS values. | |
static WifiMode | GetHtMcs22 () |
Return MCS 22 from HT MCS values. | |
static WifiMode | GetHtMcs23 () |
Return MCS 23 from HT MCS values. | |
static WifiMode | GetHtMcs24 () |
Return MCS 24 from HT MCS values. | |
static WifiMode | GetHtMcs25 () |
Return MCS 25 from HT MCS values. | |
static WifiMode | GetHtMcs26 () |
Return MCS 26 from HT MCS values. | |
static WifiMode | GetHtMcs27 () |
Return MCS 27 from HT MCS values. | |
static WifiMode | GetHtMcs28 () |
Return MCS 28 from HT MCS values. | |
static WifiMode | GetHtMcs29 () |
Return MCS 29 from HT MCS values. | |
static WifiMode | GetHtMcs3 () |
Return MCS 3 from HT MCS values. | |
static WifiMode | GetHtMcs30 () |
Return MCS 30 from HT MCS values. | |
static WifiMode | GetHtMcs31 () |
Return MCS 31 from HT MCS values. | |
static WifiMode | GetHtMcs4 () |
Return MCS 4 from HT MCS values. | |
static WifiMode | GetHtMcs5 () |
Return MCS 5 from HT MCS values. | |
static WifiMode | GetHtMcs6 () |
Return MCS 6 from HT MCS values. | |
static WifiMode | GetHtMcs7 () |
Return MCS 7 from HT MCS values. | |
static WifiMode | GetHtMcs8 () |
Return MCS 8 from HT MCS values. | |
static WifiMode | GetHtMcs9 () |
Return MCS 9 from HT MCS values. | |
static WifiMode | GetLSigMode () |
static uint64_t | GetNonHtReferenceRate (uint8_t mcsValue) |
Calculate the rate in bps of the non-HT Reference Rate corresponding to the supplied HT MCS index. | |
static uint64_t | GetPhyRate (uint8_t mcsValue, MHz_u channelWidth, Time guardInterval, uint8_t nss) |
Return the PHY rate corresponding to the supplied HT MCS index, channel width, guard interval, and number of spatial stream. | |
static uint64_t | GetPhyRateFromTxVector (const WifiTxVector &txVector, uint16_t staId) |
Return the PHY rate corresponding to the supplied TXVECTOR. | |
static void | InitializeModes () |
Initialize all HT modes. | |
static bool | IsAllowed (const WifiTxVector &txVector) |
Check whether the combination in TXVECTOR is allowed. | |
Static Public Member Functions inherited from ns3::OfdmPhy | |
static WifiCodeRate | GetCodeRate (const std::string &name) |
Return the WifiCodeRate from the OFDM mode's unique name using ModulationLookupTable. | |
static uint16_t | GetConstellationSize (const std::string &name) |
Return the constellation size from the OFDM mode's unique name using ModulationLookupTable. | |
static uint64_t | GetDataRate (const std::string &name, MHz_u channelWidth) |
Return the data rate from the OFDM mode's unique name and the supplied parameters. | |
static uint64_t | GetDataRateFromTxVector (const WifiTxVector &txVector, uint16_t staId) |
Return the data rate corresponding to the supplied TXVECTOR. | |
static WifiMode | GetOfdmRate (uint64_t rate, MHz_u bw=20) |
Return a WifiMode for OFDM corresponding to the provided rate and the channel bandwidth (20, 10, or 5 MHz). | |
static WifiMode | GetOfdmRate12Mbps () |
Return a WifiMode for OFDM at 12Mbps. | |
static WifiMode | GetOfdmRate12MbpsBW10MHz () |
Return a WifiMode for OFDM at 12 Mbps with 10 MHz channel spacing. | |
static WifiMode | GetOfdmRate12MbpsBW5MHz () |
Return a WifiMode for OFDM at 12 Mbps with 5 MHz channel spacing. | |
static WifiMode | GetOfdmRate13_5MbpsBW5MHz () |
Return a WifiMode for OFDM at 13.5 Mbps with 5 MHz channel spacing. | |
static WifiMode | GetOfdmRate18Mbps () |
Return a WifiMode for OFDM at 18 Mbps. | |
static WifiMode | GetOfdmRate18MbpsBW10MHz () |
Return a WifiMode for OFDM at 18 Mbps with 10 MHz channel spacing. | |
static WifiMode | GetOfdmRate1_5MbpsBW5MHz () |
Return a WifiMode for OFDM at 1.5 Mbps with 5 MHz channel spacing. | |
static WifiMode | GetOfdmRate24Mbps () |
Return a WifiMode for OFDM at 24 Mbps. | |
static WifiMode | GetOfdmRate24MbpsBW10MHz () |
Return a WifiMode for OFDM at 24 Mbps with 10 MHz channel spacing. | |
static WifiMode | GetOfdmRate27MbpsBW10MHz () |
Return a WifiMode for OFDM at 27 Mbps with 10 MHz channel spacing. | |
static WifiMode | GetOfdmRate2_25MbpsBW5MHz () |
Return a WifiMode for OFDM at 2.25 Mbps with 5 MHz channel spacing. | |
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 WifiMode | GetOfdmRate3MbpsBW5MHz () |
Return a WifiMode for OFDM at 3 Mbps with 5 MHz channel spacing. | |
static WifiMode | GetOfdmRate48Mbps () |
Return a WifiMode for OFDM at 48 Mbps. | |
static WifiMode | GetOfdmRate4_5MbpsBW10MHz () |
Return a WifiMode for OFDM at 4.5 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 | GetOfdmRate54Mbps () |
Return a WifiMode for OFDM at 54 Mbps. | |
static WifiMode | GetOfdmRate6Mbps () |
Return a WifiMode for OFDM at 6 Mbps. | |
static WifiMode | GetOfdmRate6MbpsBW10MHz () |
Return a WifiMode for OFDM at 6 Mbps with 10 MHz channel spacing. | |
static WifiMode | GetOfdmRate6MbpsBW5MHz () |
Return a WifiMode for OFDM at 6 Mbps with 5 MHz channel spacing. | |
static WifiMode | GetOfdmRate9Mbps () |
Return a WifiMode for OFDM at 9 Mbps. | |
static WifiMode | GetOfdmRate9MbpsBW10MHz () |
Return a WifiMode for OFDM at 9 Mbps with 10 MHz channel spacing. | |
static WifiMode | GetOfdmRate9MbpsBW5MHz () |
Return a WifiMode for OFDM at 9 Mbps with 5 MHz channel spacing. | |
static uint64_t | GetPhyRate (const std::string &name, MHz_u channelWidth) |
Return the PHY rate from the OFDM mode's unique name and the supplied parameters. | |
static uint64_t | GetPhyRateFromTxVector (const WifiTxVector &txVector, uint16_t staId) |
Return the PHY rate corresponding to the supplied TXVECTOR. | |
static void | InitializeModes () |
Initialize all OFDM modes (for all variants). | |
static bool | IsAllowed (const WifiTxVector &txVector) |
Check whether the combination in TXVECTOR is allowed. | |
Protected Member Functions | |
virtual void | BuildModeList () |
Build mode list. | |
PhyFieldRxStatus | DoEndReceiveField (WifiPpduField field, Ptr< Event > event) override |
End receiving a given field, perform amendment-specific actions, and provide the status of the reception. | |
CcaIndication | GetCcaIndication (const Ptr< const WifiPpdu > ppdu) override |
Get CCA end time and its corresponding channel list type when a new signal has been received by the PHY. | |
uint32_t | GetMaxPsduSize () const override |
Get the maximum PSDU size in bytes. | |
virtual uint8_t | GetNumberBccEncoders (const WifiTxVector &txVector) const |
virtual Time | GetSymbolDuration (const WifiTxVector &txVector) const |
Ptr< SpectrumValue > | GetTxPowerSpectralDensity (Watt_u txPower, Ptr< const WifiPpdu > ppdu) const override |
bool | IsAllConfigSupported (WifiPpduField field, Ptr< const WifiPpdu > ppdu) const override |
Checks if the signaled configuration (including bandwidth) is supported by the PHY. | |
bool | IsConfigSupported (Ptr< const WifiPpdu > ppdu) const override |
Checks if the signaled configuration (excluding bandwidth) is supported by the PHY. | |
Protected Member Functions inherited from ns3::OfdmPhy | |
PhyFieldRxStatus | DoEndReceiveField (WifiPpduField field, Ptr< Event > event) override |
End receiving a given field, perform amendment-specific actions, and provide the status of the reception. | |
PhyFieldRxStatus | EndReceiveHeader (Ptr< Event > event) |
End receiving the header, perform OFDM-specific actions, and provide the status of the reception. | |
virtual Time | GetHeaderDuration (const WifiTxVector &txVector) const |
virtual WifiMode | GetHeaderMode (const WifiTxVector &txVector) const |
uint32_t | GetMaxPsduSize () const override |
Get the maximum PSDU size in bytes. | |
MHz_u | GetMeasurementChannelWidth (const Ptr< const WifiPpdu > ppdu) const override |
Return the channel width used to measure the RSSI. | |
uint8_t | GetNumberServiceBits () const |
virtual Time | GetPreambleDuration (const WifiTxVector &txVector) const |
Time | GetSignalExtension (WifiPhyBand band) const |
Ptr< SpectrumValue > | GetTxPowerSpectralDensity (Watt_u txPower, Ptr< const WifiPpdu > ppdu) const override |
virtual bool | IsChannelWidthSupported (Ptr< const WifiPpdu > ppdu) const |
Checks if the PPDU's bandwidth is supported by the PHY. | |
Protected Member Functions inherited from ns3::PhyEntity | |
void | AbortCurrentReception (WifiPhyRxfailureReason reason) |
Abort the current reception. | |
void | AddPreambleEvent (Ptr< Event > event) |
Add an entry to the map of current preamble events (stored in WifiPhy). | |
Ptr< Event > | CreateInterferenceEvent (Ptr< const WifiPpdu > ppdu, Time duration, RxPowerWattPerChannelBand &rxPower, bool isStartHePortionRxing=false) |
Create an event using WifiPhy's InterferenceHelper class. | |
virtual void | DoAbortCurrentReception (WifiPhyRxfailureReason reason) |
Perform amendment-specific actions before aborting the current reception. | |
virtual void | DoEndReceivePayload (Ptr< const WifiPpdu > ppdu) |
Perform amendment-specific actions at the end of the reception of the payload. | |
virtual PhyFieldRxStatus | DoEndReceivePreamble (Ptr< Event > event) |
End receiving the preamble, perform amendment-specific actions, and provide the status of the reception. | |
virtual Ptr< Event > | DoGetEvent (Ptr< const WifiPpdu > ppdu, RxPowerWattPerChannelBand &rxPowersW) |
Get the event corresponding to the incoming PPDU. | |
virtual void | DoResetReceive (Ptr< Event > event) |
Perform amendment-specific actions before resetting PHY at the end of the PPDU under reception after it has failed the PHY header. | |
virtual bool | DoStartReceiveField (WifiPpduField field, Ptr< Event > event) |
Start receiving a given field, perform amendment-specific actions, and signify if it is supported. | |
virtual Time | DoStartReceivePayload (Ptr< Event > event) |
Start receiving the PSDU (i.e. | |
void | DropPreambleEvent (Ptr< const WifiPpdu > ppdu, WifiPhyRxfailureReason reason, Time endRx) |
Drop the PPDU and the corresponding preamble detection event, but keep CCA busy state after the completion of the currently processed event. | |
void | EndOfMpdu (Ptr< Event > event, Ptr< WifiMpdu > mpdu, size_t mpduIndex, Time relativeStart, Time mpduDuration) |
The last symbol of an MPDU in an A-MPDU has arrived. | |
void | EndPreambleDetectionPeriod (Ptr< Event > event) |
End the preamble detection period. | |
void | ErasePreambleEvent (Ptr< const WifiPpdu > ppdu, Time rxDuration) |
Erase the event corresponding to the PPDU from the list of preamble events, but consider it as noise after the completion of the current event. | |
virtual std::pair< MHz_u, WifiSpectrumBandInfo > | GetChannelWidthAndBand (const WifiTxVector &txVector, uint16_t staId) const |
Get the channel width and band to use (will be overloaded by child classes). | |
Ptr< const Event > | GetCurrentEvent () const |
Get the pointer to the current event (stored in WifiPhy). | |
const std::map< std::pair< uint64_t, WifiPreamble >, Ptr< Event > > & | GetCurrentPreambleEvents () const |
Get the map of current preamble events (stored in WifiPhy). | |
Time | GetDelayUntilCcaEnd (dBm_u threshold, const WifiSpectrumBandInfo &band) |
Return the delay until CCA busy is ended for a given sensitivity threshold and a given band. | |
MHz_u | GetGuardBandwidth (MHz_u currentChannelWidth) const |
SnrPer | GetPhyHeaderSnrPer (WifiPpduField field, Ptr< Event > event) const |
Obtain the SNR and PER of the PPDU field from the WifiPhy's InterferenceHelper class. | |
WifiSpectrumBandInfo | GetPrimaryBand (MHz_u bandWidth) const |
If the operating channel width is a multiple of 20 MHz, return the info corresponding to the primary channel of the given bandwidth (which must be a multiple of 20 MHz and not exceed the operating channel width). | |
double | GetRandomValue () const |
Obtain a random value from the WifiPhy's generator. | |
std::pair< bool, SignalNoiseDbm > | GetReceptionStatus (Ptr< WifiMpdu > mpdu, Ptr< Event > event, uint16_t staId, Time relativeMpduStart, Time mpduDuration) |
Get the reception status for the provided MPDU and notify. | |
virtual MHz_u | GetRxChannelWidth (const WifiTxVector &txVector) const |
Return the channel width used in the reception spectrum model. | |
Watt_u | GetRxPowerForPpdu (Ptr< Event > event) const |
Obtain the received power for a given band. | |
WifiSpectrumBandInfo | GetSecondaryBand (MHz_u bandWidth) const |
If the channel bonding is used, return the info corresponding to the secondary channel of the given bandwidth (which must be a multiple of 20 MHz and not exceed the operating channel width). | |
std::tuple< dBr_u, dBr_u, dBr_u > | GetTxMaskRejectionParams () const |
virtual void | HandleRxPpduWithSameContent (Ptr< Event > event, Ptr< const WifiPpdu > ppdu, RxPowerWattPerChannelBand &rxPower) |
Handle reception of a PPDU that carries the same content of another PPDU. | |
void | NotifyInterferenceRxEndAndClear (bool reset) |
Notify WifiPhy's InterferenceHelper of the end of the reception, clear maps and end of MPDU event, and eventually reset WifiPhy. | |
void | NotifyPayloadBegin (const WifiTxVector &txVector, const Time &payloadDuration) |
Fire the trace indicating that the PHY is starting to receive the payload of a PPDU. | |
virtual void | RxPayloadFailed (Ptr< const WifiPsdu > psdu, double snr, const WifiTxVector &txVector) |
Perform amendment-specific actions when the payload is unsuccessfuly received. | |
virtual void | RxPayloadSucceeded (Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, uint16_t staId, const std::vector< bool > &statusPerMpdu) |
Perform amendment-specific actions when the payload is successfully received. | |
void | ScheduleEndOfMpdus (Ptr< Event > event) |
Schedule end of MPDUs events. | |
void | StartPreambleDetectionPeriod (Ptr< Event > event) |
Start the preamble detection period. | |
void | StartReceivePayload (Ptr< Event > event) |
Start receiving the PSDU (i.e. | |
Static Protected Member Functions | |
static uint64_t | CalculateDataRate (Time symbolDuration, uint16_t usableSubCarriers, uint16_t numberOfBitsPerSubcarrier, double codingRate, uint8_t nss) |
Calculates data rate from the supplied parameters. | |
static uint64_t | CalculateNonHtReferenceRate (WifiCodeRate codeRate, uint16_t constellationSize) |
Return the rate (in bps) of the non-HT Reference Rate which corresponds to the supplied code rate and constellation size. | |
static uint64_t | CalculatePhyRate (WifiCodeRate codeRate, uint64_t dataRate) |
Return the PHY rate corresponding to the supplied code rate and data rate. | |
static double | GetCodeRatio (WifiCodeRate codeRate) |
Convert WifiCodeRate to a ratio, e.g., code ratio of WIFI_CODE_RATE_1_2 is 0.5. | |
static Time | GetSymbolDuration (Time guardInterval) |
static uint16_t | GetUsableSubcarriers (MHz_u channelWidth) |
Static Protected Member Functions inherited from ns3::OfdmPhy | |
static uint64_t | CalculateDataRate (Time symbolDuration, uint16_t usableSubCarriers, uint16_t numberOfBitsPerSubcarrier, double codingRate) |
Calculates data rate from the supplied parameters. | |
static uint64_t | CalculateDataRate (WifiCodeRate codeRate, uint16_t constellationSize, MHz_u channelWidth) |
Calculates data rate from the supplied parameters. | |
static uint64_t | CalculatePhyRate (WifiCodeRate codeRate, uint64_t dataRate) |
Calculate the PHY rate in bps from code rate and data rate. | |
static double | GetCodeRatio (WifiCodeRate codeRate) |
Convert WifiCodeRate to a ratio, e.g., code ratio of WIFI_CODE_RATE_1_2 is 0.5. | |
static Time | GetSymbolDuration (MHz_u channelWidth) |
static uint16_t | GetUsableSubcarriers () |
Protected Attributes | |
uint8_t | m_bssMembershipSelector |
the BSS membership selector | |
uint8_t | m_maxMcsIndexPerSs |
the maximum MCS index per spatial stream as defined by the standard | |
uint8_t | m_maxSupportedMcsIndexPerSs |
the maximum supported MCS index per spatial stream | |
Protected Attributes inherited from ns3::PhyEntity | |
std::vector< EventId > | m_endOfMacHdrEvents |
the end of MAC header events | |
std::vector< EventId > | m_endOfMpduEvents |
the end of MPDU events (only used for A-MPDUs) | |
std::vector< EventId > | m_endPreambleDetectionEvents |
the end of preamble detection events | |
std::vector< EventId > | m_endRxPayloadEvents |
the end of receive events (only one unless UL MU reception) | |
std::list< WifiMode > | m_modeList |
the list of supported modes | |
std::map< UidStaIdPair, SignalNoiseDbm > | m_signalNoiseMap |
Map of the latest signal power and noise power in dBm (noise power includes the noise figure) | |
Ptr< WifiPhyStateHelper > | m_state |
Pointer to WifiPhyStateHelper of the WifiPhy (to make it reachable for child classes) | |
std::map< UidStaIdPair, std::vector< bool > > | m_statusPerMpduMap |
Map of the current reception status per MPDU that is filled in as long as MPDUs are being processed by the PHY in case of an A-MPDU. | |
Ptr< WifiPhy > | m_wifiPhy |
Pointer to the owning WifiPhy. | |
Private Member Functions | |
PhyFieldRxStatus | EndReceiveHtSig (Ptr< Event > event) |
End receiving the HT-SIG, perform HT-specific actions, and provide the status of the reception. | |
Static Private Member Functions | |
static WifiMode | CreateHtMcs (uint8_t index) |
Return the HT MCS corresponding to the provided index. | |
Private Attributes | |
uint8_t | m_maxSupportedNss |
Maximum supported number of spatial streams (used to build HT MCS indices) | |
Static Private Attributes | |
static const PpduFormats | m_htPpduFormats |
HT PPDU formats. | |
Additional Inherited Members | |
Public Types inherited from ns3::PhyEntity | |
typedef std::pair< std::pair< Time, Time >, WifiMode > | PhyHeaderChunkInfo |
A pair containing information on the PHY header chunk, namely the start and stop times of the chunk and the WifiMode used. | |
typedef std::map< WifiPpduField, PhyHeaderChunkInfo > | PhyHeaderSections |
A map of PhyHeaderChunkInfo elements per PPDU field. | |
enum | PhyRxFailureAction { DROP = 0 , ABORT , IGNORE } |
Action to perform in case of RX failure. More... | |
Protected Types inherited from ns3::PhyEntity | |
using | CcaIndication |
CCA end time and its corresponding channel list type (can be std::nullopt if IDLE) | |
typedef std::pair< WifiCodeRate, uint16_t > | CodeRateConstellationSizePair |
A pair to hold modulation information: code rate and constellation size. | |
typedef std::map< std::string, CodeRateConstellationSizePair > | ModulationLookupTable |
A modulation lookup table using unique name of modulation as key. | |
typedef std::map< WifiPreamble, std::vector< WifiPpduField > > | PpduFormats |
A map of PPDU field elements per preamble type. | |
typedef std::pair< uint64_t, uint16_t > | UidStaIdPair |
A pair of a UID and STA_ID. | |
Static Protected Attributes inherited from ns3::PhyEntity | |
static uint64_t | m_globalPpduUid = 0 |
Global counter of the PPDU UID. | |
PHY entity for HT (11n)
HT PHY is based on OFDM PHY. Only HT-Mixed is supported (support for HT-Greenfield has been removed). Only HT MCSs up to 31 are supported.
Refer to IEEE 802.11-2016, clause 19.
ns3::HtPhy::HtPhy | ( | uint8_t | maxNss = 1, |
bool | buildModeList = true ) |
Constructor for HT PHY.
maxNss | the maximum number of spatial streams |
buildModeList | flag used to add HT modes to list (disabled by child classes to only add child classes' modes) |
Definition at line 45 of file ht-phy.cc.
References BuildModeList(), ns3::HT_MAX_NSS, HT_PHY, m_bssMembershipSelector, m_maxMcsIndexPerSs, m_maxSupportedMcsIndexPerSs, m_maxSupportedNss, NS_ABORT_MSG_IF, and NS_LOG_FUNCTION.
|
override |
|
protectedvirtual |
Build mode list.
Should be redone whenever the maximum MCS index per spatial stream ,or any other important parameter having an impact on the MCS index (e.g. number of spatial streams for HT), changes.
Reimplemented in ns3::EhtPhy, ns3::HePhy, and ns3::VhtPhy.
Definition at line 67 of file ht-phy.cc.
References CreateHtMcs(), HT_PHY, m_bssMembershipSelector, m_maxSupportedMcsIndexPerSs, m_maxSupportedNss, ns3::PhyEntity::m_modeList, NS_ASSERT, NS_LOG_FUNCTION, and NS_LOG_LOGIC.
Referenced by HtPhy(), SetMaxSupportedMcsIndexPerSs(), and SetMaxSupportedNss().
|
overridevirtual |
Build amendment-specific PPDU.
psdus | the PHY payloads (PSDUs) |
txVector | the TXVECTOR that was used for the PPDU |
ppduDuration | the transmission duration of the PPDU |
Reimplemented from ns3::PhyEntity.
Reimplemented in ns3::VhtPhy.
Definition at line 372 of file ht-phy.cc.
References ns3::Create(), ns3::WifiPhy::GetOperatingChannel(), ns3::PhyEntity::m_wifiPhy, NS_LOG_FUNCTION, and ns3::PhyEntity::ObtainNextUid().
|
staticprotected |
Calculates data rate from the supplied parameters.
symbolDuration | the symbol duration |
usableSubCarriers | the number of usable subcarriers for data |
numberOfBitsPerSubcarrier | the number of data bits per subcarrier |
codingRate | the coding rate |
nss | the considered number of streams |
Definition at line 700 of file ht-phy.cc.
References ns3::OfdmPhy::CalculateDataRate().
Referenced by ns3::EhtPhy::GetDataRate(), ns3::HePhy::GetDataRate(), GetDataRate(), and ns3::VhtPhy::GetDataRate().
|
staticprotected |
Return the rate (in bps) of the non-HT Reference Rate which corresponds to the supplied code rate and constellation size.
codeRate | the convolutional coding rate |
constellationSize | the size of modulation constellation |
To convert an HT MCS to its corresponding non-HT Reference Rate use the modulation and coding rate of the HT MCS and lookup in Table 10-7 of IEEE 802.11-2016s.
Definition at line 733 of file ht-phy.cc.
References NS_FATAL_ERROR, ns3::WIFI_CODE_RATE_1_2, ns3::WIFI_CODE_RATE_2_3, ns3::WIFI_CODE_RATE_3_4, and ns3::WIFI_CODE_RATE_5_6.
Referenced by ns3::VhtPhy::CalculateNonHtReferenceRate(), and GetNonHtReferenceRate().
|
staticprotected |
Return the PHY rate corresponding to the supplied code rate and data rate.
codeRate | the code rate |
dataRate | the data rate in bps |
Definition at line 651 of file ht-phy.cc.
References GetCodeRatio().
Referenced by ns3::EhtPhy::GetPhyRate(), ns3::HePhy::GetPhyRate(), GetPhyRate(), and ns3::VhtPhy::GetPhyRate().
|
staticprivate |
Return the HT MCS corresponding to the provided index.
This method binds all the callbacks used by WifiMode.
index | the index of the MCS |
Definition at line 571 of file ht-phy.cc.
References ns3::WifiModeFactory::CreateWifiMcs(), GetDataRateFromTxVector(), GetHtCodeRate(), GetHtConstellationSize(), GetNonHtReferenceRate(), GetPhyRateFromTxVector(), IsAllowed(), ns3::MakeBoundCallback(), ns3::MakeCallback(), NS_ASSERT_MSG, and ns3::WIFI_MOD_CLASS_HT.
Referenced by BuildModeList().
|
overrideprotectedvirtual |
End receiving a given field, perform amendment-specific actions, and provide the status of the reception.
field | the ending PPDU field |
event | the event holding incoming PPDU's information |
Reimplemented from ns3::PhyEntity.
Reimplemented in ns3::VhtPhy.
Definition at line 383 of file ht-phy.cc.
References ns3::OfdmPhy::DoEndReceiveField(), EndReceiveHtSig(), NS_LOG_FUNCTION, ns3::WIFI_PPDU_FIELD_HT_SIG, ns3::WIFI_PPDU_FIELD_NON_HT_HEADER, and ns3::WIFI_PPDU_FIELD_TRAINING.
Referenced by ns3::EhtPhy::DoEndReceiveField(), and ns3::VhtPhy::DoEndReceiveField().
|
private |
End receiving the HT-SIG, perform HT-specific actions, and provide the status of the reception.
event | the event holding incoming PPDU's information |
Definition at line 400 of file ht-phy.cc.
References ns3::PhyEntity::PhyFieldRxStatus::actionIfFailure, ns3::PhyEntity::DROP, ns3::PhyEntity::GetPhyHeaderSnrPer(), ns3::PhyEntity::GetRandomValue(), ns3::HT_SIG_FAILURE, IsAllConfigSupported(), ns3::PhyEntity::PhyFieldRxStatus::isSuccess, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::PhyEntity::SnrPer::per, ns3::RatioToDb(), ns3::PhyEntity::PhyFieldRxStatus::reason, ns3::PhyEntity::SnrPer::snr, ns3::UNSUPPORTED_SETTINGS, ns3::WIFI_PPDU_FIELD_HT_SIG, and ns3::WIFI_PREAMBLE_HT_MF.
Referenced by DoEndReceiveField().
uint8_t ns3::HtPhy::GetBssMembershipSelector | ( | ) | const |
Definition at line 158 of file ht-phy.cc.
References m_bssMembershipSelector.
|
overrideprotectedvirtual |
Get CCA end time and its corresponding channel list type when a new signal has been received by the PHY.
ppdu | the incoming PPDU or nullptr for any signal |
Reimplemented from ns3::PhyEntity.
Reimplemented in ns3::VhtPhy.
Definition at line 817 of file ht-phy.cc.
References ns3::PhyEntity::GetCcaIndication(), ns3::OfdmPhy::GetCcaThreshold(), ns3::WifiPhy::GetChannelWidth(), ns3::PhyEntity::GetDelayUntilCcaEnd(), ns3::WifiPhy::GetOperatingChannel(), ns3::PhyEntity::GetPrimaryBand(), ns3::WifiPhyOperatingChannel::GetPrimaryChannelCenterFrequency(), ns3::PhyEntity::GetSecondaryBand(), ns3::WifiPhyOperatingChannel::GetSecondaryChannelCenterFrequency(), ns3::PhyEntity::m_wifiPhy, ns3::WIFI_CHANLIST_PRIMARY, and ns3::WIFI_CHANLIST_SECONDARY.
Referenced by ns3::VhtPhy::GetCcaIndication().
|
static |
Return the coding rate corresponding to the supplied HT MCS index between 0 and 7, since HT MCS index > 8 is used for higher NSS.
This function is reused by child classes.
mcsValue | the MCS index |
Definition at line 593 of file ht-phy.cc.
References ns3::WIFI_CODE_RATE_1_2, ns3::WIFI_CODE_RATE_2_3, ns3::WIFI_CODE_RATE_3_4, ns3::WIFI_CODE_RATE_5_6, and ns3::WIFI_CODE_RATE_UNDEFINED.
Referenced by ns3::VhtPhy::GetCodeRate(), and GetHtCodeRate().
|
staticprotected |
Convert WifiCodeRate to a ratio, e.g., code ratio of WIFI_CODE_RATE_1_2 is 0.5.
codeRate | the code rate |
Definition at line 666 of file ht-phy.cc.
References ns3::OfdmPhy::GetCodeRatio(), and ns3::WIFI_CODE_RATE_5_6.
Referenced by CalculatePhyRate(), ns3::EhtPhy::GetDataRate(), ns3::HePhy::GetDataRate(), GetDataRate(), and ns3::VhtPhy::GetDataRate().
|
static |
Return the constellation size corresponding to the supplied HT MCS index between 0 and 7, since HT MCS index > 8 is used for higher NSS.
This function is reused by child classes.
mcsValue | the MCS index |
Definition at line 621 of file ht-phy.cc.
Referenced by ns3::VhtPhy::GetConstellationSize(), and GetHtConstellationSize().
|
static |
Return the data rate corresponding to the supplied HT MCS index, channel width, guard interval, and number of spatial streams.
This function is mainly used as a callback for WifiMode operation.
mcsValue | the HT MCS index |
channelWidth | the channel width |
guardInterval | the guard interval duration in nanoseconds |
nss | the number of spatial streams |
Definition at line 687 of file ht-phy.cc.
References CalculateDataRate(), GetCodeRatio(), GetHtCodeRate(), GetHtConstellationSize(), ns3::Time::GetNanoSeconds(), GetSymbolDuration(), ns3::OfdmPhy::GetUsableSubcarriers(), and NS_ASSERT.
Referenced by GetDataRateFromTxVector(), and GetPhyRate().
|
static |
Return the data rate corresponding to the supplied TXVECTOR.
This function is mainly used as a callback for WifiMode operation.
txVector | the TXVECTOR used for the transmission |
staId | the station ID (only here to have a common signature for all callbacks) |
Definition at line 678 of file ht-phy.cc.
References ns3::WifiTxVector::GetChannelWidth(), GetDataRate(), ns3::WifiTxVector::GetGuardInterval(), ns3::WifiMode::GetMcsValue(), ns3::WifiTxVector::GetMode(), and ns3::WifiTxVector::GetNss().
Referenced by CreateHtMcs().
|
overridevirtual |
Get the duration of the PPDU field (or group of fields) used by this entity for the given transmission parameters.
field | the PPDU field (or group of fields) |
txVector | the transmission parameters |
Reimplemented from ns3::PhyEntity.
Reimplemented in ns3::VhtPhy.
Definition at line 202 of file ht-phy.cc.
References ns3::OfdmPhy::GetDuration(), GetHtSigDuration(), GetLSigDuration(), ns3::WifiTxVector::GetNess(), ns3::WifiTxVector::GetNssMax(), ns3::WifiTxVector::GetPreambleType(), GetTrainingDuration(), ns3::MicroSeconds(), ns3::WIFI_PPDU_FIELD_HT_SIG, ns3::WIFI_PPDU_FIELD_NON_HT_HEADER, ns3::WIFI_PPDU_FIELD_PREAMBLE, and ns3::WIFI_PPDU_FIELD_TRAINING.
Referenced by ns3::EhtPhy::GetDuration(), and ns3::VhtPhy::GetDuration().
|
static |
Return the coding rate corresponding to the supplied HT MCS index.
This function calls GetCodeRate and is used as a callback for WifiMode operation.
mcsValue | the MCS index |
Definition at line 587 of file ht-phy.cc.
References GetCodeRate().
Referenced by CreateHtMcs(), GetDataRate(), GetNonHtReferenceRate(), and GetPhyRate().
|
static |
Return the constellation size corresponding to the supplied HT MCS index.
mcsValue | the MCS index |
Definition at line 615 of file ht-phy.cc.
References GetConstellationSize().
Referenced by CreateHtMcs(), GetDataRate(), and GetNonHtReferenceRate().
|
static |
Return the HT MCS corresponding to the provided index.
index | the index of the MCS |
Definition at line 482 of file ht-phy.cc.
References CASE, and NS_ABORT_MSG.
Referenced by InitializeModes(), and ns3::HtPpdu::SetTxVectorFromPhyHeaders().
|
static |
Return MCS 0 from HT MCS values.
Referenced by WifiErrorRateModelsTestSuite::WifiErrorRateModelsTestSuite(), WifiPhyCcaThresholdsTest::CreateDummyHtPpdu(), TxDurationTest::DoRun(), and WifiErrorRateModelsTestCaseMimo::DoRun().
|
static |
Return MCS 1 from HT MCS values.
|
static |
Return MCS 10 from HT MCS values.
|
static |
Return MCS 11 from HT MCS values.
|
static |
Return MCS 12 from HT MCS values.
|
static |
Return MCS 13 from HT MCS values.
|
static |
Return MCS 14 from HT MCS values.
|
static |
Return MCS 15 from HT MCS values.
|
static |
Return MCS 16 from HT MCS values.
|
static |
Return MCS 17 from HT MCS values.
|
static |
Return MCS 18 from HT MCS values.
|
static |
Return MCS 19 from HT MCS values.
|
static |
Return MCS 2 from HT MCS values.
|
static |
Return MCS 20 from HT MCS values.
|
static |
Return MCS 21 from HT MCS values.
|
static |
Return MCS 22 from HT MCS values.
|
static |
Return MCS 23 from HT MCS values.
|
static |
Return MCS 24 from HT MCS values.
|
static |
Return MCS 25 from HT MCS values.
|
static |
Return MCS 26 from HT MCS values.
|
static |
Return MCS 27 from HT MCS values.
|
static |
Return MCS 28 from HT MCS values.
|
static |
Return MCS 29 from HT MCS values.
|
static |
Return MCS 3 from HT MCS values.
|
static |
Return MCS 30 from HT MCS values.
|
static |
Return MCS 31 from HT MCS values.
|
static |
Return MCS 4 from HT MCS values.
|
static |
Return MCS 5 from HT MCS values.
|
static |
Return MCS 6 from HT MCS values.
Referenced by PhyHeaderSectionsTest::DoRun(), and TxDurationTest::DoRun().
|
static |
Return MCS 7 from HT MCS values.
Referenced by WifiErrorRateModelsTestSuite::WifiErrorRateModelsTestSuite(), and TxDurationTest::DoRun().
|
static |
Return MCS 8 from HT MCS values.
|
static |
Return MCS 9 from HT MCS values.
|
virtual |
Reimplemented in ns3::VhtPhy.
Definition at line 263 of file ht-phy.cc.
References ns3::MicroSeconds().
Referenced by GetDuration().
|
virtual |
Reimplemented in ns3::VhtPhy.
Definition at line 152 of file ht-phy.cc.
References GetLSigMode().
Referenced by GetSigMode().
|
virtual |
preamble | the type of preamble |
Reimplemented in ns3::HePhy, and ns3::VhtPhy.
Definition at line 242 of file ht-phy.cc.
References ns3::MicroSeconds().
Referenced by GetDuration().
|
static |
Definition at line 146 of file ht-phy.cc.
References ns3::OfdmPhy::GetOfdmRate6Mbps().
Referenced by GetHtSigMode(), ns3::VhtPhy::GetSigAMode(), and GetSigMode().
|
overrideprotectedvirtual |
Get the maximum PSDU size in bytes.
Implements ns3::PhyEntity.
Reimplemented in ns3::VhtPhy.
uint8_t ns3::HtPhy::GetMaxSupportedMcsIndexPerSs | ( | ) | const |
Set the maximum supported MCS index per spatial stream.
For HT, this results in non-continuous indices for supported MCSs.
Definition at line 181 of file ht-phy.cc.
References m_maxSupportedMcsIndexPerSs.
|
overridevirtual |
Get the WifiMode corresponding to the given MCS index.
index | the index of the MCS |
This method should be used only for HtPhy and child classes.
Reimplemented from ns3::PhyEntity.
Definition at line 87 of file ht-phy.cc.
References ns3::PhyEntity::m_modeList, and NS_ABORT_MSG.
|
static |
Calculate the rate in bps of the non-HT Reference Rate corresponding to the supplied HT MCS index.
This function calls CalculateNonHtReferenceRate and is used as a callback for WifiMode operation.
mcsValue | the HT MCS index |
Definition at line 725 of file ht-phy.cc.
References CalculateNonHtReferenceRate(), GetHtCodeRate(), and GetHtConstellationSize().
Referenced by CreateHtMcs().
|
protectedvirtual |
txVector | the transmission parameters |
Add an encoder when crossing maxRatePerCoder frontier.
The value of 320 Mbps and 350 Mbps for normal GI and short GI (resp.) were obtained by observing the rates for which Nes was incremented in tables 19-27 to 19-41 of IEEE 802.11-2016.
Reimplemented in ns3::HePhy, and ns3::VhtPhy.
Definition at line 349 of file ht-phy.cc.
References ns3::WifiMode::GetDataRate(), ns3::WifiTxVector::GetGuardInterval(), ns3::WifiTxVector::GetMode(), and ns3::Time::GetNanoSeconds().
Referenced by GetPayloadDuration().
|
overridevirtual |
size | the number of bytes in the packet to send |
txVector | the TXVECTOR used for the transmission of this packet |
band | the frequency band |
mpdutype | the type of the MPDU as defined in WifiPhy::MpduType. |
incFlag | this flag is used to indicate that the variables need to be update or not This function is called a couple of times for the same packet so variables should not be increased each time. |
totalAmpduSize | the total size of the previously transmitted MPDUs for the concerned A-MPDU. If incFlag is set, this parameter will be updated. |
totalAmpduNumSymbols | the number of symbols previously transmitted for the MPDUs in the concerned A-MPDU, used for the computation of the number of symbols needed for the last MPDU. If incFlag is set, this parameter will be updated. |
staId | the STA-ID of the PSDU (only used for MU PPDUs) |
Implements ns3::PhyEntity.
Definition at line 269 of file ht-phy.cc.
References ns3::FemtoSeconds(), ns3::FIRST_MPDU_IN_AGGREGATE, ns3::WifiMode::GetDataRate(), ns3::Time::GetFemtoSeconds(), ns3::WifiTxVector::GetMode(), ns3::Time::GetNanoSeconds(), GetNumberBccEncoders(), ns3::OfdmPhy::GetNumberServiceBits(), ns3::OfdmPhy::GetSignalExtension(), GetSymbolDuration(), ns3::WifiTxVector::IsStbc(), ns3::LAST_MPDU_IN_AGGREGATE, ns3::MIDDLE_MPDU_IN_AGGREGATE, ns3::NORMAL_MPDU, NS_ASSERT, NS_FATAL_ERROR, and ns3::SINGLE_MPDU.
|
static |
Return the PHY rate corresponding to the supplied HT MCS index, channel width, guard interval, and number of spatial stream.
This function calls CalculatePhyRate and is mainly used as a callback for WifiMode operation.
mcsValue | the HT MCS index |
channelWidth | the considered channel width |
guardInterval | the considered guard interval duration |
nss | the considered number of stream |
Definition at line 643 of file ht-phy.cc.
References CalculatePhyRate(), GetDataRate(), and GetHtCodeRate().
Referenced by GetPhyRateFromTxVector().
|
static |
Return the PHY rate corresponding to the supplied TXVECTOR.
This function is mainly used as a callback for WifiMode operation.
txVector | the TXVECTOR used for the transmission |
staId | the station ID (only here to have a common signature for all callbacks) |
Definition at line 657 of file ht-phy.cc.
References ns3::WifiTxVector::GetChannelWidth(), ns3::WifiTxVector::GetGuardInterval(), ns3::WifiMode::GetMcsValue(), ns3::WifiTxVector::GetMode(), ns3::WifiTxVector::GetNss(), and GetPhyRate().
Referenced by CreateHtMcs().
|
overridevirtual |
Return the PPDU formats of the PHY.
Implements ns3::PhyEntity.
Reimplemented in ns3::VhtPhy.
Definition at line 122 of file ht-phy.cc.
References m_htPpduFormats.
|
overridevirtual |
Get the WifiMode for the SIG field specified by the PPDU field.
field | the PPDU field |
txVector | the transmission parameters |
Reimplemented from ns3::PhyEntity.
Reimplemented in ns3::VhtPhy.
Definition at line 128 of file ht-phy.cc.
References GetHtSigMode(), GetLSigMode(), ns3::OfdmPhy::GetSigMode(), ns3::WIFI_PPDU_FIELD_HT_SIG, ns3::WIFI_PPDU_FIELD_NON_HT_HEADER, ns3::WIFI_PPDU_FIELD_PREAMBLE, and ns3::WIFI_PPDU_FIELD_TRAINING.
Referenced by ns3::VhtPhy::GetSigMode().
|
protectedvirtual |
txVector | the transmission parameters |
Reimplemented in ns3::HePhy.
Definition at line 363 of file ht-phy.cc.
References ns3::WifiTxVector::GetGuardInterval(), ns3::Time::GetNanoSeconds(), GetSymbolDuration(), and NS_ASSERT.
Referenced by GetDataRate(), ns3::VhtPhy::GetDataRate(), GetPayloadDuration(), and GetSymbolDuration().
guardInterval | the guard interval duration |
Definition at line 719 of file ht-phy.cc.
References ns3::NanoSeconds().
|
virtual |
txVector | the transmission parameters |
nDataLtf | the number of data LTF fields (excluding those in preamble) |
nExtensionLtf | the number of extension LTF fields |
Reimplemented in ns3::HePhy, and ns3::VhtPhy.
Definition at line 248 of file ht-phy.cc.
References ns3::MicroSeconds(), and NS_ABORT_MSG_IF.
Referenced by GetDuration().
|
overrideprotectedvirtual |
txPower | power to spread across the bands |
ppdu | the PPDU that will be transmitted |
This is a helper function to create the right TX PSD corresponding to the amendment of this PHY.
Implements ns3::PhyEntity.
Definition at line 453 of file ht-phy.cc.
References ns3::WifiSpectrumValueHelper::CreateHtOfdmTxPowerSpectralDensity(), ns3::PhyEntity::GetGuardBandwidth(), ns3::PhyEntity::GetTxMaskRejectionParams(), NS_ASSERT, and NS_LOG_FUNCTION.
|
staticprotected |
|
overridevirtual |
Check if the WifiModes handled by this PHY are MCSs.
Reimplemented from ns3::PhyEntity.
|
static |
Initialize all HT modes.
Definition at line 473 of file ht-phy.cc.
References GetHtMcs().
Referenced by anonymous_namespace{ht-phy.cc}::ConstructorHt::ConstructorHt().
|
overrideprotectedvirtual |
Checks if the signaled configuration (including bandwidth) is supported by the PHY.
field | the current PPDU field (SIG used for checking config) |
ppdu | the received PPDU |
true
if supported, false
otherwise Reimplemented from ns3::OfdmPhy.
Reimplemented in ns3::VhtPhy.
Definition at line 425 of file ht-phy.cc.
References ns3::OfdmPhy::IsAllConfigSupported(), and ns3::WIFI_PPDU_FIELD_NON_HT_HEADER.
Referenced by EndReceiveHtSig(), and ns3::VhtPhy::IsAllConfigSupported().
|
static |
Check whether the combination in TXVECTOR is allowed.
This function is used as a callback for WifiMode operation.
txVector | the TXVECTOR |
Definition at line 805 of file ht-phy.cc.
Referenced by CreateHtMcs().
Checks if the signaled configuration (excluding bandwidth) is supported by the PHY.
ppdu | the received PPDU |
true
if supported, false
otherwise Reimplemented from ns3::PhyEntity.
Definition at line 435 of file ht-phy.cc.
References ns3::WifiPhy::GetMaxSupportedRxSpatialStreams(), ns3::PhyEntity::IsModeSupported(), ns3::PhyEntity::m_wifiPhy, and NS_LOG_DEBUG.
|
overridevirtual |
Check if the WifiMode corresponding to the given MCS index is supported.
index | the index of the MCS |
Will return false for non-MCS modes.
Reimplemented from ns3::PhyEntity.
Definition at line 103 of file ht-phy.cc.
References ns3::PhyEntity::m_modeList.
void ns3::HtPhy::SetMaxSupportedMcsIndexPerSs | ( | uint8_t | maxIndex | ) |
Set the maximum supported MCS index per spatial stream.
For HT, this results in non-continuous indices for supported MCSs.
maxIndex | the maximum MCS index per spatial stream supported by this entity |
The provided value should not be greater than maximum standard-defined value.
Definition at line 164 of file ht-phy.cc.
References BuildModeList(), m_maxMcsIndexPerSs, m_maxSupportedMcsIndexPerSs, ns3::PhyEntity::m_modeList, NS_ABORT_MSG_IF, NS_LOG_FUNCTION, and NS_LOG_LOGIC.
void ns3::HtPhy::SetMaxSupportedNss | ( | uint8_t | maxNss | ) |
Configure the maximum number of spatial streams supported by this HT PHY.
maxNss | the maximum number of spatial streams |
Definition at line 187 of file ht-phy.cc.
References BuildModeList(), ns3::HT_MAX_NSS, HT_PHY, m_bssMembershipSelector, m_maxSupportedNss, ns3::PhyEntity::m_modeList, NS_ASSERT, NS_LOG_FUNCTION, and NS_LOG_LOGIC.
|
protected |
the BSS membership selector
Definition at line 544 of file ht-phy.h.
Referenced by ns3::EhtPhy::EhtPhy(), ns3::HePhy::HePhy(), HtPhy(), ns3::VhtPhy::VhtPhy(), ns3::EhtPhy::BuildModeList(), ns3::HePhy::BuildModeList(), BuildModeList(), ns3::VhtPhy::BuildModeList(), GetBssMembershipSelector(), ns3::VhtPhy::GetHtSigMode(), and SetMaxSupportedNss().
|
staticprivate |
HT PPDU formats.
Definition at line 569 of file ht-phy.h.
Referenced by GetPpduFormats().
|
protected |
the maximum MCS index per spatial stream as defined by the standard
Definition at line 542 of file ht-phy.h.
Referenced by ns3::EhtPhy::EhtPhy(), ns3::HePhy::HePhy(), HtPhy(), ns3::VhtPhy::VhtPhy(), and SetMaxSupportedMcsIndexPerSs().
|
protected |
the maximum supported MCS index per spatial stream
Definition at line 543 of file ht-phy.h.
Referenced by ns3::EhtPhy::EhtPhy(), ns3::HePhy::HePhy(), HtPhy(), ns3::VhtPhy::VhtPhy(), ns3::EhtPhy::BuildModeList(), ns3::HePhy::BuildModeList(), BuildModeList(), ns3::VhtPhy::BuildModeList(), GetMaxSupportedMcsIndexPerSs(), and SetMaxSupportedMcsIndexPerSs().
|
private |
Maximum supported number of spatial streams (used to build HT MCS indices)
Definition at line 566 of file ht-phy.h.
Referenced by HtPhy(), BuildModeList(), and SetMaxSupportedNss().