802.11 PHY layer model More...
#include "wifi-phy.h"
Public Types | |
using | ChannelTuple = std::tuple< uint8_t, uint16_t, int, uint8_t > |
Tuple identifying an operating channel. More... | |
typedef void(* | MonitorSnifferRxCallback) (Ptr< const Packet > packet, uint16_t channelFreqMhz, WifiTxVector txVector, MpduInfo aMpdu, SignalNoiseDbm signalNoise, uint16_t staId) |
TracedCallback signature for monitor mode receive events. More... | |
typedef void(* | MonitorSnifferTxCallback) (const Ptr< const Packet > packet, uint16_t channelFreqMhz, WifiTxVector txVector, MpduInfo aMpdu, uint16_t staId) |
TracedCallback signature for monitor mode transmit events. More... | |
typedef void(* | PhyRxBeginTracedCallback) (Ptr< const Packet > packet, RxPowerWattPerChannelBand rxPowersW) |
TracedCallback signature for PhyRxBegin trace source. More... | |
typedef void(* | PhyRxPayloadBeginTracedCallback) (WifiTxVector txVector, Time psduDuration) |
TracedCallback signature for start of PSDU reception events. More... | |
typedef void(* | PhyTxBeginTracedCallback) (Ptr< const Packet > packet, double txPowerW) |
TracedCallback signature for Phy transmit events. More... | |
typedef void(* | PsduTxBeginCallback) (WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW) |
TracedCallback signature for PSDU transmit events. More... | |
Public Member Functions | |
WifiPhy () | |
~WifiPhy () override | |
virtual int64_t | AssignStreams (int64_t stream) |
Assign a fixed random variable stream number to the random variables used by this model. More... | |
double | CalculateSnr (const WifiTxVector &txVector, double ber) const |
virtual void | ConfigureStandard (WifiStandard standard) |
Configure the PHY-level parameters for different Wi-Fi standard. More... | |
virtual WifiSpectrumBand | ConvertHeRuSubcarriers (uint16_t bandWidth, uint16_t guardBandwidth, HeRu::SubcarrierRange range, uint8_t bandIndex=0) const |
void | EndReceiveInterBss () |
For HE receptions only, check and possibly modify the transmit power restriction state at the end of PPDU reception. More... | |
Time | GetAckTxTime () const |
Return the estimated Ack TX time for this PHY. More... | |
virtual WifiSpectrumBand | GetBand (uint16_t bandWidth, uint8_t bandIndex=0) |
Get the start band index and the stop band index for a given band. More... | |
Time | GetBlockAckTxTime () const |
Return the estimated BlockAck TX time for this PHY. More... | |
std::list< uint8_t > | GetBssMembershipSelectorList () const |
The WifiPhy::BssMembershipSelector() method is used (e.g., by a WifiRemoteStationManager) to determine the set of transmission/reception modes that this WifiPhy(-derived class) can support - a set of WifiMode objects which we call the BssMembershipSelectorSet, and which is stored inside HT PHY (and above) instances. More... | |
double | GetCcaEdThreshold () const |
Return the CCA energy detection threshold (dBm). More... | |
double | GetCcaSensitivityThreshold () const |
Return the CCA sensitivity threshold (dBm). More... | |
virtual Ptr< Channel > | GetChannel () const =0 |
Return the Channel this WifiPhy is connected to. More... | |
uint8_t | GetChannelNumber () const |
Return current channel number. More... | |
Time | GetChannelSwitchDelay () const |
uint16_t | GetChannelWidth () const |
WifiMode | GetDefaultMode () const |
Get the default WifiMode supported by the PHY. More... | |
Time | GetDelayUntilIdle () |
Ptr< WifiNetDevice > | GetDevice () const |
Return the device this PHY is associated with. More... | |
uint16_t | GetFrequency () const |
virtual uint16_t | GetGuardBandwidth (uint16_t currentChannelWidth) const =0 |
Time | GetLastRxEndTime () const |
Return the end time of the last received packet. More... | |
Time | GetLastRxStartTime () const |
Return the start time of the last received packet. More... | |
Ptr< PhyEntity > | GetLatestPhyEntity () const |
Get the latest PHY entity supported by this PHY instance. More... | |
uint8_t | GetMaxSupportedRxSpatialStreams () const |
uint8_t | GetMaxSupportedTxSpatialStreams () const |
WifiMode | GetMcs (WifiModulationClass modulation, uint8_t mcs) const |
Get the WifiMode object corresponding to the given MCS of the given modulation class. More... | |
std::list< WifiMode > | GetMcsList () const |
The WifiPhy::GetMcsList() method is used (e.g., by a WifiRemoteStationManager) to determine the set of transmission/reception MCS indices that this WifiPhy(-derived class) can support - a set of MCS indices which is stored by each HT PHY (and above). More... | |
std::list< WifiMode > | GetMcsList (WifiModulationClass modulation) const |
Get the list of supported MCSs for the given modulation class (i.e. More... | |
Ptr< MobilityModel > | GetMobility () const |
Return the mobility model this PHY is associated with. More... | |
std::list< WifiMode > | GetModeList () const |
The WifiPhy::GetModeList() method is used (e.g., by a WifiRemoteStationManager) to determine the set of transmission/reception (non-MCS) modes that this WifiPhy(-derived class) can support - a set of modes which is stored by each non-HT PHY. More... | |
std::list< WifiMode > | GetModeList (WifiModulationClass modulation) const |
Get the list of supported (non-MCS) modes for the given modulation class (i.e. More... | |
uint16_t | GetNMcs () const |
uint8_t | GetNTxPower () const |
Return the number of available transmission power levels. More... | |
uint8_t | GetNumberOfAntennas () const |
const WifiPhyOperatingChannel & | GetOperatingChannel () const |
Get a const reference to the operating channel. More... | |
WifiPhyBand | GetPhyBand () const |
Get the configured Wi-Fi band. More... | |
Ptr< PhyEntity > | GetPhyEntity (WifiModulationClass modulation) const |
Get the supported PHY entity corresponding to the modulation class. More... | |
Ptr< PhyEntity > | GetPhyEntity (WifiStandard standard) const |
Get the supported PHY entity corresponding to the wifi standard. More... | |
Ptr< PhyEntity > | GetPhyEntityForPpdu (const Ptr< const WifiPpdu > ppdu) const |
Get the supported PHY entity to use for a received PPDU. More... | |
Time | GetPifs () const |
Return the PCF Interframe Space (PIFS) for this PHY. More... | |
double | GetPowerDbm (uint8_t power) const |
Get the power of the given power level in dBm. More... | |
uint64_t | GetPreviouslyRxPpduUid () const |
uint8_t | GetPrimary20Index () const |
uint8_t | GetPrimaryChannelNumber (uint16_t primaryChannelWidth) const |
Get channel number of the primary channel. More... | |
double | GetRxGain () const |
Return the reception gain (dB). More... | |
double | GetRxSensitivity () const |
Return the receive sensitivity threshold (dBm). More... | |
bool | GetShortPhyPreambleSupported () const |
Return whether short PHY preamble is supported. More... | |
Time | GetSifs () const |
Return the Short Interframe Space (SIFS) for this PHY. More... | |
Time | GetSlot () const |
Return the slot duration for this PHY. More... | |
WifiStandard | GetStandard () const |
Get the configured Wi-Fi standard. More... | |
Ptr< WifiPhyStateHelper > | GetState () const |
Return the WifiPhyStateHelper of this PHY. More... | |
uint16_t | GetTxBandwidth (WifiMode mode, uint16_t maxAllowedBandWidth=std::numeric_limits< uint16_t >::max()) const |
Get the bandwidth for a transmission occurring on the current operating channel and using the given WifiMode, subject to the constraint that the TX bandwidth cannot exceed the given maximum allowed value. More... | |
double | GetTxGain () const |
Return the transmission gain (dB). More... | |
virtual std::tuple< double, double, double > | GetTxMaskRejectionParams () const =0 |
double | GetTxPowerEnd () const |
Return the maximum available transmission power level (dBm). More... | |
double | GetTxPowerForTransmission (Ptr< const WifiPpdu > ppdu) const |
Compute the transmit power for the next transmission. More... | |
double | GetTxPowerStart () const |
Return the minimum available transmission power level (dBm). More... | |
bool | HasFixedPhyBand () const |
bool | IsMcsSupported (WifiModulationClass modulation, uint8_t mcs) const |
Check if the given MCS of the given modulation class is supported by the PHY. More... | |
bool | IsModeSupported (WifiMode mode) const |
Check if the given WifiMode is supported by the PHY. More... | |
bool | IsStateCcaBusy () const |
bool | IsStateIdle () const |
bool | IsStateOff () const |
bool | IsStateRx () const |
bool | IsStateSleep () const |
bool | IsStateSwitching () const |
bool | IsStateTx () const |
void | NotifyChannelAccessRequested () |
Notify the PHY that an access to the channel was requested. More... | |
void | NotifyMonitorSniffRx (Ptr< const WifiPsdu > psdu, uint16_t channelFreqMhz, WifiTxVector txVector, SignalNoiseDbm signalNoise, std::vector< bool > statusPerMpdu, uint16_t staId=SU_STA_ID) |
Public method used to fire a MonitorSniffer trace for a wifi PSDU being received. More... | |
void | NotifyMonitorSniffTx (Ptr< const WifiPsdu > psdu, uint16_t channelFreqMhz, WifiTxVector txVector, uint16_t staId=SU_STA_ID) |
Public method used to fire a MonitorSniffer trace for a wifi PSDU being transmitted. More... | |
void | NotifyRxBegin (Ptr< const WifiPsdu > psdu, const RxPowerWattPerChannelBand &rxPowersW) |
Public method used to fire a PhyRxBegin trace. More... | |
void | NotifyRxDrop (Ptr< const WifiPsdu > psdu, WifiPhyRxfailureReason reason) |
Public method used to fire a PhyRxDrop trace. More... | |
void | NotifyRxEnd (Ptr< const WifiPsdu > psdu) |
Public method used to fire a PhyRxEnd trace. More... | |
void | NotifyTxBegin (WifiConstPsduMap psdus, double txPowerW) |
Public method used to fire a PhyTxBegin trace. More... | |
void | NotifyTxDrop (Ptr< const WifiPsdu > psdu) |
Public method used to fire a PhyTxDrop trace. More... | |
void | NotifyTxEnd (WifiConstPsduMap psdus) |
Public method used to fire a PhyTxEnd trace. More... | |
void | RegisterListener (WifiPhyListener *listener) |
void | ResetCca (bool powerRestricted, double txPowerMaxSiso=0, double txPowerMaxMimo=0) |
Reset PHY to IDLE, with some potential TX power restrictions for the next transmission. More... | |
void | ResumeFromOff () |
Resume from off mode. More... | |
void | ResumeFromSleep () |
Resume from sleep mode. More... | |
void | Send (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) |
This function is a wrapper for the Send variant that accepts a WifiConstPsduMap as first argument. More... | |
void | Send (WifiConstPsduMap psdus, const WifiTxVector &txVector) |
void | SetCapabilitiesChangedCallback (Callback< void > callback) |
void | SetCcaEdThreshold (double threshold) |
Sets the CCA energy detection threshold (dBm). More... | |
void | SetCcaSensitivityThreshold (double threshold) |
Sets the CCA sensitivity threshold (dBm). More... | |
void | SetDevice (const Ptr< WifiNetDevice > device) |
Sets the device this PHY is associated with. More... | |
void | SetErrorRateModel (const Ptr< ErrorRateModel > model) |
Sets the error rate model. More... | |
void | SetFixedPhyBand (bool enable) |
Configure whether it is prohibited to change PHY band after initialization. More... | |
void | SetFrameCaptureModel (const Ptr< FrameCaptureModel > frameCaptureModel) |
Sets the frame capture model. More... | |
virtual void | SetInterferenceHelper (const Ptr< InterferenceHelper > helper) |
Sets the interference helper. More... | |
void | SetMaxSupportedRxSpatialStreams (uint8_t streams) |
void | SetMaxSupportedTxSpatialStreams (uint8_t streams) |
void | SetMobility (const Ptr< MobilityModel > mobility) |
assign a mobility model to this device More... | |
void | SetNTxPower (uint8_t n) |
Sets the number of transmission power levels available between the minimum level and the maximum level. More... | |
void | SetNumberOfAntennas (uint8_t antennas) |
void | SetOffMode () |
Put in off mode. More... | |
void | SetOperatingChannel (const ChannelTuple &channelTuple) |
If the standard for this object has not been set yet, store the given channel settings. More... | |
void | SetPifs (Time pifs) |
Set the PCF Interframe Space (PIFS) for this PHY. More... | |
void | SetPostReceptionErrorModel (const Ptr< ErrorModel > em) |
Attach a receive ErrorModel to the WifiPhy. More... | |
void | SetPreambleDetectionModel (const Ptr< PreambleDetectionModel > preambleDetectionModel) |
Sets the preamble detection model. More... | |
void | SetReceiveErrorCallback (RxErrorCallback callback) |
void | SetReceiveOkCallback (RxOkCallback callback) |
void | SetRxGain (double gain) |
Sets the reception gain (dB). More... | |
void | SetRxNoiseFigure (double noiseFigureDb) |
Sets the RX loss (dB) in the Signal-to-Noise-Ratio due to non-idealities in the receiver. More... | |
void | SetRxSensitivity (double threshold) |
Sets the receive sensitivity threshold (dBm). More... | |
void | SetShortPhyPreambleSupported (bool preamble) |
Enable or disable short PHY preamble. More... | |
void | SetSifs (Time sifs) |
Set the Short Interframe Space (SIFS) for this PHY. More... | |
void | SetSleepMode () |
Put in sleep mode. More... | |
void | SetSlot (Time slot) |
Set the slot duration for this PHY. More... | |
void | SetTxGain (double gain) |
Sets the transmission gain (dB). More... | |
void | SetTxPowerEnd (double end) |
Sets the maximum available transmission power level (dBm). More... | |
void | SetTxPowerStart (double start) |
Sets the minimum available transmission power level (dBm). More... | |
void | SetWifiRadioEnergyModel (const Ptr< WifiRadioEnergyModel > wifiRadioEnergyModel) |
Sets the wifi radio energy model. More... | |
void | StartReceivePreamble (Ptr< const WifiPpdu > ppdu, RxPowerWattPerChannelBand &rxPowersW, Time rxDuration) |
Start receiving the PHY preamble of a PPDU (i.e. More... | |
virtual void | StartTx (Ptr< const WifiPpdu > ppdu)=0 |
void | UnregisterListener (WifiPhyListener *listener) |
![]() | |
Object () | |
Constructor. More... | |
~Object () override | |
Destructor. More... | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. More... | |
void | Dispose () |
Dispose of this Object. More... | |
AggregateIterator | GetAggregateIterator () const |
Get an iterator to the Objects aggregated to this one. More... | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. More... | |
template<typename T > | |
Ptr< T > | GetObject () const |
Get a pointer to the requested aggregated Object. More... | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. More... | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. More... | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. More... | |
void | Initialize () |
Invoke DoInitialize on all Objects aggregated to this one. More... | |
bool | IsInitialized () const |
Check if the object has been initialized. More... | |
![]() | |
SimpleRefCount () | |
Default constructor. More... | |
SimpleRefCount (const SimpleRefCount &o[[maybe_unused]]) | |
Copy constructor. More... | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. More... | |
SimpleRefCount & | operator= (const SimpleRefCount &o[[maybe_unused]]) |
Assignment operator. More... | |
void | Ref () const |
Increment the reference count. More... | |
void | Unref () const |
Decrement the reference count. More... | |
![]() | |
virtual | ~ObjectBase () |
Virtual destructor. More... | |
void | GetAttribute (std::string name, AttributeValue &value) const |
Get the value of an attribute, raising fatal errors if unsuccessful. More... | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising errors. More... | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. More... | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. More... | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. More... | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. More... | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. More... | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. More... | |
Static Public Member Functions | |
static void | AddStaticPhyEntity (WifiModulationClass modulation, Ptr< PhyEntity > phyEntity) |
Add the PHY entity to the map of implemented PHY entities for the given modulation class. More... | |
static Time | CalculatePhyPreambleAndHeaderDuration (const WifiTxVector &txVector) |
static Time | CalculateTxDuration (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector, WifiPhyBand band) |
This function is a wrapper for the CalculateTxDuration variant that accepts a WifiConstPsduMap as first argument. More... | |
static Time | CalculateTxDuration (uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, uint16_t staId=SU_STA_ID) |
static Time | CalculateTxDuration (WifiConstPsduMap psduMap, const WifiTxVector &txVector, WifiPhyBand band) |
static uint32_t | GetMaxPsduSize (WifiModulationClass modulation) |
Get the maximum PSDU size in bytes for the given modulation class. More... | |
static Time | GetPayloadDuration (uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, MpduType mpdutype, bool incFlag, uint32_t &totalAmpduSize, double &totalAmpduNumSymbols, uint16_t staId) |
static Time | GetPayloadDuration (uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, MpduType mpdutype=NORMAL_MPDU, uint16_t staId=SU_STA_ID) |
static Time | GetPreambleDetectionDuration () |
static Time | GetStartOfPacketDuration (const WifiTxVector &txVector) |
static const Ptr< const PhyEntity > | GetStaticPhyEntity (WifiModulationClass modulation) |
Get the implemented PHY entity corresponding to the modulation class. More... | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
static WifiConstPsduMap | GetWifiConstPsduMap (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) |
Get a WifiConstPsduMap from a PSDU and the TXVECTOR to use to send the PSDU. More... | |
![]() | |
static TypeId | GetTypeId () |
Register this type. More... | |
![]() | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
Protected Member Functions | |
void | AddPhyEntity (WifiModulationClass modulation, Ptr< PhyEntity > phyEntity) |
Add the PHY entity to the map of supported PHY entities for the given modulation class for the WifiPhy instance. More... | |
virtual void | DoChannelSwitch () |
Actually switch channel based on the stored channel settings. More... | |
void | DoDispose () override |
Destructor implementation. More... | |
void | DoInitialize () override |
Initialize() implementation. More... | |
Time | GetDelayUntilChannelSwitch () |
Perform any actions necessary when user changes operating channel after initialization. More... | |
void | NotifyCcaBusy (const Ptr< const WifiPpdu > ppdu, Time duration) |
Notify PHY state helper to switch to CCA busy state,. More... | |
void | Reset () |
Reset data upon end of TX or RX. More... | |
void | SwitchMaybeToCcaBusy (const Ptr< const WifiPpdu > ppdu) |
Check if PHY state should move to CCA busy state based on current state of interference tracker. More... | |
![]() | |
Object (const Object &o) | |
Copy an Object. More... | |
virtual void | NotifyNewAggregate () |
Notify all Objects aggregated to this one of a new Object being aggregated. More... | |
![]() | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. More... | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. More... | |
Protected Attributes | |
Ptr< Event > | m_currentEvent |
Hold the current event. More... | |
std::map< std::pair< uint64_t, WifiPreamble >, Ptr< Event > > | m_currentPreambleEvents |
store event associated to a PPDU (that has a unique ID and preamble combination) whose preamble is being received More... | |
EventId | m_endPhyRxEvent |
the end of PHY receive event More... | |
EventId | m_endTxEvent |
the end of transmit event More... | |
Ptr< InterferenceHelper > | m_interference |
Pointer to a helper responsible for interference computations. More... | |
std::map< WifiModulationClass, Ptr< PhyEntity > > | m_phyEntities |
This map holds the supported PHY entities. More... | |
uint64_t | m_previouslyRxPpduUid |
UID of the previously received PPDU, reset to UINT64_MAX upon transmission. More... | |
Ptr< UniformRandomVariable > | m_random |
Provides uniform random variables. More... | |
uint32_t | m_rxMpduReferenceNumber |
A-MPDU reference number to identify all received subframes belonging to the same received A-MPDU. More... | |
Ptr< WifiPhyStateHelper > | m_state |
Pointer to WifiPhyStateHelper. More... | |
uint32_t | m_txMpduReferenceNumber |
A-MPDU reference number to identify all transmitted subframes belonging to the same received A-MPDU. More... | |
Private Member Functions | |
void | AbortCurrentReception (WifiPhyRxfailureReason reason) |
Due to newly arrived signal, the current reception cannot be continued and has to be aborted. More... | |
void | Configure80211a () |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11a standard. More... | |
void | Configure80211ac () |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11ac standard. More... | |
void | Configure80211ax () |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11ax standard. More... | |
void | Configure80211b () |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11b standard. More... | |
void | Configure80211be () |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11be standard. More... | |
void | Configure80211g () |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11g standard. More... | |
void | Configure80211n () |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11n standard. More... | |
void | Configure80211p () |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11p standard. More... | |
void | ConfigureHtDeviceMcsSet () |
Configure the device MCS set with the appropriate HtMcs modes for the number of available transmit spatial streams. More... | |
Ptr< const WifiPsdu > | GetAddressedPsduInPpdu (Ptr< const WifiPpdu > ppdu) const |
Get the PSDU addressed to that PHY in a PPDU (useful for MU PPDU). More... | |
void | PushMcs (WifiMode mode) |
Add the given MCS to the device MCS set. More... | |
void | RebuildMcsMap () |
Rebuild the mapping of MCS values to indices in the device MCS set. More... | |
Static Private Member Functions | |
static std::map< WifiModulationClass, Ptr< PhyEntity > > & | GetStaticPhyEntities () |
Private Attributes | |
Time | m_ackTxTime |
estimated Ack TX time More... | |
WifiPhyBand | m_band |
WifiPhyBand. More... | |
Time | m_blockAckTxTime |
estimated BlockAck TX time More... | |
Callback< void > | m_capabilitiesChangedCallback |
Callback when PHY capabilities changed. More... | |
double | m_ccaEdThresholdW |
Clear channel assessment (CCA) energy detection (ED) threshold in watts. More... | |
double | m_ccaSensitivityThresholdW |
Clear channel assessment (CCA) modulation and coding rate sensitivity threshold in watts. More... | |
bool | m_channelAccessRequested |
Flag if channels access has been requested (used for OBSS_PD SR) More... | |
ChannelTuple | m_channelSettings |
Store operating channel settings until initialization. More... | |
Time | m_channelSwitchDelay |
Time required to switch between channel. More... | |
Ptr< WifiNetDevice > | m_device |
Pointer to the device. More... | |
bool | m_fixedPhyBand |
True to prohibit changing PHY band after initialization. More... | |
Ptr< FrameCaptureModel > | m_frameCaptureModel |
Frame capture model. More... | |
Ptr< MobilityModel > | m_mobility |
Pointer to the mobility model. More... | |
double | m_noiseFigureDb |
The noise figure in dB. More... | |
uint8_t | m_nTxPower |
Number of available transmission power levels. More... | |
uint8_t | m_numberOfAntennas |
Number of transmitters. More... | |
WifiPhyOperatingChannel | m_operatingChannel |
Operating channel. More... | |
TracedCallback< Ptr< const Packet >, uint16_t, WifiTxVector, MpduInfo, SignalNoiseDbm, uint16_t > | m_phyMonitorSniffRxTrace |
A trace source that emulates a Wi-Fi device in monitor mode sniffing a packet being received. More... | |
TracedCallback< Ptr< const Packet >, uint16_t, WifiTxVector, MpduInfo, uint16_t > | m_phyMonitorSniffTxTrace |
A trace source that emulates a Wi-Fi device in monitor mode sniffing a packet being transmitted. More... | |
TracedCallback< Ptr< const Packet >, RxPowerWattPerChannelBand > | m_phyRxBeginTrace |
The trace source fired when a packet begins the reception process from the medium. More... | |
TracedCallback< Ptr< const Packet >, WifiPhyRxfailureReason > | m_phyRxDropTrace |
The trace source fired when the PHY layer drops a packet it has received. More... | |
TracedCallback< Ptr< const Packet > > | m_phyRxEndTrace |
The trace source fired when a packet ends the reception process from the medium. More... | |
TracedCallback< WifiTxVector, Time > | m_phyRxPayloadBeginTrace |
The trace source fired when the reception of the PHY payload (PSDU) begins. More... | |
TracedCallback< Ptr< const Packet >, double > | m_phyTxBeginTrace |
The trace source fired when a packet begins the transmission process on the medium. More... | |
TracedCallback< Ptr< const Packet > > | m_phyTxDropTrace |
The trace source fired when the PHY layer drops a packet as it tries to transmit it. More... | |
TracedCallback< Ptr< const Packet > > | m_phyTxEndTrace |
The trace source fired when a packet ends the transmission process on the medium. More... | |
TracedCallback< WifiConstPsduMap, WifiTxVector, double > | m_phyTxPsduBeginTrace |
The trace source fired when a PSDU map begins the transmission process on the medium. More... | |
Time | m_pifs |
PCF Interframe Space (PIFS) duration. More... | |
Ptr< ErrorModel > | m_postReceptionErrorModel |
Error model for receive packet events. More... | |
double | m_powerDensityLimit |
the power density limit (dBm/MHz) More... | |
bool | m_powerRestricted |
Flag whether transmit power is restricted by OBSS PD SR. More... | |
Ptr< PreambleDetectionModel > | m_preambleDetectionModel |
Preamble detection model. More... | |
double | m_rxGainDb |
Reception gain (dB) More... | |
double | m_rxSensitivityW |
Receive sensitivity threshold in watts. More... | |
uint8_t | m_rxSpatialStreams |
Number of supported RX spatial streams. More... | |
bool | m_shortPreamble |
Flag if short PHY preamble is supported. More... | |
Time | m_sifs |
Short Interframe Space (SIFS) duration. More... | |
Time | m_slot |
Slot duration. More... | |
WifiStandard | m_standard |
WifiStandard. More... | |
Time | m_timeLastPreambleDetected |
Record the time the last preamble was detected. More... | |
double | m_txGainDb |
Transmission gain (dB) More... | |
double | m_txPowerBaseDbm |
Minimum transmission power (dBm) More... | |
double | m_txPowerEndDbm |
Maximum transmission power (dBm) More... | |
double | m_txPowerMaxMimo |
MIMO maximum transmit power due to OBSS PD SR power restriction (dBm) More... | |
double | m_txPowerMaxSiso |
SISO maximum transmit power due to OBSS PD SR power restriction (dBm) More... | |
uint8_t | m_txSpatialStreams |
Number of supported TX spatial streams. More... | |
Ptr< WifiRadioEnergyModel > | m_wifiRadioEnergyModel |
Wifi radio energy model. More... | |
Friends | |
class | PhyEntity |
Additional Inherited Members | |
![]() | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More... | |
802.11 PHY layer model
ns3::WifiPhy is accessible through the following paths with Config::Set and Config::Connect:
Time
+0ns:+9.22337e+18ns Time
+9.22337e+18ns:+9.22337e+18ns Time
+9.22337e+18ns:+9.22337e+18ns Time
+9.22337e+18ns:+9.22337e+18ns Size of this type is 744 bytes (on a 64-bit architecture).
Definition at line 52 of file wifi-phy.h.
using ns3::WifiPhy::ChannelTuple = std::tuple<uint8_t , uint16_t , int , uint8_t > |
Tuple identifying an operating channel.
Definition at line 866 of file wifi-phy.h.
typedef void(* ns3::WifiPhy::MonitorSnifferRxCallback) (Ptr< const Packet > packet, uint16_t channelFreqMhz, WifiTxVector txVector, MpduInfo aMpdu, SignalNoiseDbm signalNoise, uint16_t staId) |
TracedCallback signature for monitor mode receive events.
packet | the packet being received |
channelFreqMhz | the frequency in MHz at which the packet is received. Note that in real devices this is normally the frequency to which the receiver is tuned, and this can be different than the frequency at which the packet was originally transmitted. This is because it is possible to have the receiver tuned on a given channel and still to be able to receive packets on a nearby channel. |
txVector | the TXVECTOR that holds RX parameters |
aMpdu | the type of the packet (0 is not A-MPDU, 1 is a MPDU that is part of an A-MPDU and 2 is the last MPDU in an A-MPDU) and the A-MPDU reference number (must be a different value for each A-MPDU but the same for each subframe within one A-MPDU) |
signalNoise | signal power and noise power in dBm |
staId | the STA-ID |
Definition at line 632 of file wifi-phy.h.
typedef void(* ns3::WifiPhy::MonitorSnifferTxCallback) (const Ptr< const Packet > packet, uint16_t channelFreqMhz, WifiTxVector txVector, MpduInfo aMpdu, uint16_t staId) |
TracedCallback signature for monitor mode transmit events.
packet | the packet being transmitted |
channelFreqMhz | the frequency in MHz at which the packet is transmitted. |
txVector | the TXVECTOR that holds TX parameters |
aMpdu | the type of the packet (0 is not A-MPDU, 1 is a MPDU that is part of an A-MPDU and 2 is the last MPDU in an A-MPDU) and the A-MPDU reference number (must be a different value for each A-MPDU but the same for each subframe within one A-MPDU) |
staId | the STA-ID |
Definition at line 671 of file wifi-phy.h.
typedef void(* ns3::WifiPhy::PhyRxBeginTracedCallback) (Ptr< const Packet > packet, RxPowerWattPerChannelBand rxPowersW) |
TracedCallback signature for PhyRxBegin trace source.
packet | the packet being received |
rxPowersW | the receive power per channel band in Watts |
Definition at line 702 of file wifi-phy.h.
typedef void(* ns3::WifiPhy::PhyRxPayloadBeginTracedCallback) (WifiTxVector txVector, Time psduDuration) |
TracedCallback signature for start of PSDU reception events.
txVector | the TXVECTOR decoded from the PHY header |
psduDuration | the duration of the PSDU |
Definition at line 711 of file wifi-phy.h.
typedef void(* ns3::WifiPhy::PhyTxBeginTracedCallback) (Ptr< const Packet > packet, double txPowerW) |
TracedCallback signature for Phy transmit events.
packet | the packet being transmitted |
txPowerW | the transmit power in Watts |
Definition at line 683 of file wifi-phy.h.
typedef void(* ns3::WifiPhy::PsduTxBeginCallback) (WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW) |
TracedCallback signature for PSDU transmit events.
psduMap | the PSDU map being transmitted |
txVector | the TXVECTOR holding the TX parameters |
txPowerW | the transmit power in Watts |
Definition at line 692 of file wifi-phy.h.
ns3::WifiPhy::WifiPhy | ( | ) |
Definition at line 335 of file wifi-phy.cc.
References m_random, m_state, and NS_LOG_FUNCTION.
|
override |
Definition at line 361 of file wifi-phy.cc.
References NS_LOG_FUNCTION.
|
private |
Due to newly arrived signal, the current reception cannot be continued and has to be aborted.
reason | the reason the reception is aborted |
Definition at line 2072 of file wifi-phy.cc.
References ns3::EventId::Cancel(), GetAddressedPsduInPpdu(), GetChannelWidth(), ns3::EventId::IsRunning(), m_currentEvent, m_currentPreambleEvents, m_endPhyRxEvent, m_interference, m_phyEntities, m_state, NotifyRxDrop(), ns3::Simulator::Now(), NS_LOG_FUNCTION, and ns3::OBSS_PD_CCA_RESET.
Referenced by ns3::PhyEntity::AbortCurrentReception(), ResetCca(), and Send().
|
protected |
Add the PHY entity to the map of supported PHY entities for the given modulation class for the WifiPhy instance.
This is a wrapper method used to check that the PHY entity is in the static map of implemented PHY entities (
modulation | the modulation class |
phyEntity | the PHY entity |
Definition at line 755 of file wifi-phy.cc.
References GetStaticPhyEntities(), m_phyEntities, NS_ABORT_MSG_IF, NS_ASSERT_MSG, and NS_LOG_FUNCTION.
Referenced by Configure80211a(), Configure80211ac(), Configure80211ax(), Configure80211b(), Configure80211be(), Configure80211g(), Configure80211n(), and Configure80211p().
|
static |
Add the PHY entity to the map of implemented PHY entities for the given modulation class.
Through this method, child classes can add their own PHY entities in a static manner.
modulation | the modulation class |
phyEntity | the PHY entity |
Definition at line 745 of file wifi-phy.cc.
References GetStaticPhyEntities(), NS_ASSERT_MSG, and NS_LOG_FUNCTION.
Referenced by anonymous_namespace{dsss-phy.cc}::ConstructorDsss::ConstructorDsss(), anonymous_namespace{eht-phy.cc}::ConstructorEht::ConstructorEht(), anonymous_namespace{erp-ofdm-phy.cc}::ConstructorErpOfdm::ConstructorErpOfdm(), anonymous_namespace{he-phy.cc}::ConstructorHe::ConstructorHe(), anonymous_namespace{ht-phy.cc}::ConstructorHt::ConstructorHt(), anonymous_namespace{ofdm-phy.cc}::ConstructorOfdm::ConstructorOfdm(), and anonymous_namespace{vht-phy.cc}::ConstructorVht::ConstructorVht().
|
virtual |
Assign a fixed random variable stream number to the random variables used by this model.
Return the number of streams (possibly zero) that have been assigned.
stream | first stream index to use |
Definition at line 2184 of file wifi-phy.cc.
References m_interference, m_random, NS_LOG_FUNCTION, and ns3::RandomVariableStream::SetStream().
Referenced by TestNonHtDuplicatePhyReception::DoRun(), TestUlOfdmaPpduUid::DoRun(), TestMultipleHeTbPreambles::DoRun(), TestThresholdPreambleDetectionWithoutFrameCapture::DoRun(), TestThresholdPreambleDetectionWithFrameCapture::DoRun(), TestSimpleFrameCaptureModel::DoRun(), TestPhyHeadersReception::DoRun(), TestAmpduReception::DoRun(), TestUnsupportedBandwidthReception::DoRun(), TestMultipleCtsResponsesFromMuRts::DoSetup(), TestPhyPaddingExclusion::DoSetup(), WifiPhyCcaIndicationTest::RunOne(), TestDlOfdmaPhyTransmission::RunOne(), TestDlOfdmaPhyPuncturing::RunOne(), TestUlOfdmaPhyTransmission::RunOne(), and TestUlOfdmaPowerControl::RunOne().
|
static |
txVector | the transmission parameters used for this packet |
Definition at line 1473 of file wifi-phy.cc.
References ns3::WifiTxVector::GetModulationClass(), and GetStaticPhyEntity().
Referenced by ns3::MinstrelHtWifiManager::CalculateMpduTxDuration(), ns3::InterferenceHelper::CalculatePayloadPer(), CalculateTxDuration(), ns3::HePpdu::GetTxDuration(), ns3::DsssPpdu::GetTxDuration(), ns3::VhtPpdu::GetTxDuration(), ns3::HePhy::GetValidPpduDuration(), ns3::FrameExchangeManager::SendMpdu(), ns3::HeFrameExchangeManager::SendMuRts(), ns3::HtFrameExchangeManager::SendPsdu(), ns3::HeFrameExchangeManager::SendPsduMap(), ns3::FrameExchangeManager::SendRts(), ns3::DsssPpdu::SetDsssHeader(), ns3::VhtPpdu::SetVhtSigHeader(), and ns3::FrameExchangeManager::UpdateNav().
double ns3::WifiPhy::CalculateSnr | ( | const WifiTxVector & | txVector, |
double | ber | ||
) | const |
txVector | the transmission vector |
ber | the probability of bit error rate |
Definition at line 689 of file wifi-phy.cc.
References m_interference.
|
static |
This function is a wrapper for the CalculateTxDuration variant that accepts a WifiConstPsduMap as first argument.
This function inserts the given PSDU in a WifiConstPsduMap along with a STA-ID value that is determined based on whether the given PSDU has to be transmitted as a DL or UL frame, thus allowing to properly calculate the TX duration in case the PSDU has to be transmitted as an UL frame.
psdu | the PSDU to transmit |
txVector | the TXVECTOR used for the transmission of the PSDU |
band | the frequency band |
Definition at line 1492 of file wifi-phy.cc.
References CalculateTxDuration(), and GetWifiConstPsduMap().
|
static |
size | the number of bytes in the packet to send |
txVector | the TXVECTOR used for the transmission of this packet |
band | the frequency band being used |
staId | the STA-ID of the recipient (only used for MU) |
Definition at line 1480 of file wifi-phy.cc.
References CalculatePhyPreambleAndHeaderDuration(), GetPayloadDuration(), ns3::Time::IsStrictlyPositive(), ns3::NORMAL_MPDU, and NS_ASSERT.
Referenced by ns3::FrameExchangeManager::CalculateAcknowledgmentTime(), ns3::HtFrameExchangeManager::CalculateAcknowledgmentTime(), ns3::FrameExchangeManager::CalculateProtectionTime(), CalculateTxDuration(), ns3::PhyEntity::CalculateTxDuration(), ns3::HePhy::CalculateTxDuration(), TestPrimary20CoveredByPpdu::CreatePpdu(), ns3::FrameExchangeManager::DoSendCtsAfterRts(), ns3::QosFrameExchangeManager::GetCtsToSelfDurationId(), ns3::FrameExchangeManager::GetFrameDurationId(), ns3::QosFrameExchangeManager::GetFrameDurationId(), ns3::HeFrameExchangeManager::GetMuRtsDurationId(), ns3::FrameExchangeManager::GetRtsDurationId(), ns3::QosFrameExchangeManager::GetRtsDurationId(), ns3::HtPpdu::GetTxDuration(), ns3::OfdmPpdu::GetTxDuration(), ns3::FrameExchangeManager::GetTxDuration(), SpectrumWifiPhyBasicTest::MakeSignal(), WifiPhyThresholdsTest::MakeWifiSignal(), TestMultipleHeTbPreambles::RxHeTbPpdu(), Send(), TestAmpduReception::SendAmpduWithThreeMpdus(), ns3::HtFrameExchangeManager::SendBlockAck(), ns3::QosFrameExchangeManager::SendCfEndIfNeeded(), ns3::FrameExchangeManager::SendCtsToSelf(), ns3::FrameExchangeManager::SendMpdu(), ns3::HtFrameExchangeManager::SendMpduFromBaManager(), TestUlOfdmaPowerControl::SendMuBar(), ns3::HeFrameExchangeManager::SendMuRts(), TestNonHtDuplicatePhyReception::SendNonHtDuplicatePpdu(), ns3::FrameExchangeManager::SendNormalAck(), TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket(), TestThresholdPreambleDetectionWithFrameCapture::SendPacket(), TestPhyHeadersReception::SendPacket(), TestSimpleFrameCaptureModel::SendPacket(), TestUnsupportedBandwidthReception::SendPpdu(), ns3::HtFrameExchangeManager::SendPsdu(), ns3::HeFrameExchangeManager::SendPsduMap(), ns3::FrameExchangeManager::SendRts(), TestUlOfdmaPpduUid::SendTbPpdu(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), ns3::RrMultiUserScheduler::TrySendingBsrpTf(), and ns3::FrameExchangeManager::UpdateNav().
|
static |
psduMap | the PSDU(s) to transmit indexed by STA-ID |
txVector | the TXVECTOR used for the transmission of the PPDU |
band | the frequency band being used |
Definition at line 1500 of file wifi-phy.cc.
References ns3::WifiTxVector::GetModulationClass(), and GetStaticPhyEntity().
|
private |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11a standard.
Definition at line 816 of file wifi-phy.cc.
References AddPhyEntity(), GetSifs(), GetSlot(), m_ackTxTime, ns3::MicroSeconds(), NS_LOG_FUNCTION, SetPifs(), SetSifs(), SetSlot(), and ns3::WIFI_MOD_CLASS_OFDM.
Referenced by Configure80211n(), and ConfigureStandard().
|
private |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11ac standard.
Definition at line 910 of file wifi-phy.cc.
References AddPhyEntity(), Configure80211n(), NS_LOG_FUNCTION, and ns3::WIFI_MOD_CLASS_VHT.
Referenced by Configure80211ax(), and ConfigureStandard().
|
private |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11ax standard.
Definition at line 918 of file wifi-phy.cc.
References AddPhyEntity(), Configure80211ac(), Configure80211n(), m_band, NS_LOG_FUNCTION, ns3::WIFI_MOD_CLASS_HE, and ns3::WIFI_PHY_BAND_2_4GHZ.
Referenced by Configure80211be(), and ConfigureStandard().
|
private |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11b standard.
Definition at line 831 of file wifi-phy.cc.
References AddPhyEntity(), GetSifs(), GetSlot(), m_ackTxTime, ns3::MicroSeconds(), NS_LOG_FUNCTION, SetPifs(), SetSifs(), SetSlot(), ns3::WIFI_MOD_CLASS_DSSS, and ns3::WIFI_MOD_CLASS_HR_DSSS.
Referenced by Configure80211g(), and ConfigureStandard().
|
private |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11be standard.
Definition at line 933 of file wifi-phy.cc.
References AddPhyEntity(), Configure80211ax(), NS_LOG_FUNCTION, and ns3::WIFI_MOD_CLASS_EHT.
Referenced by ConfigureStandard().
|
private |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11g standard.
Definition at line 848 of file wifi-phy.cc.
References AddPhyEntity(), Configure80211b(), NS_LOG_FUNCTION, and ns3::WIFI_MOD_CLASS_ERP_OFDM.
Referenced by Configure80211n(), and ConfigureStandard().
|
private |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11n standard.
Definition at line 891 of file wifi-phy.cc.
References AddPhyEntity(), Configure80211a(), Configure80211g(), m_band, m_blockAckTxTime, m_txSpatialStreams, ns3::MicroSeconds(), NS_LOG_FUNCTION, ns3::WIFI_MOD_CLASS_HT, and ns3::WIFI_PHY_BAND_2_4GHZ.
Referenced by Configure80211ac(), Configure80211ax(), and ConfigureStandard().
|
private |
Configure WifiPhy with appropriate channel frequency and supported rates for 802.11p standard.
Definition at line 861 of file wifi-phy.cc.
References AddPhyEntity(), GetChannelWidth(), GetSifs(), GetSlot(), m_ackTxTime, ns3::MicroSeconds(), NS_FATAL_ERROR, NS_LOG_FUNCTION, ns3::OFDM_PHY_10_MHZ, ns3::OFDM_PHY_5_MHZ, SetPifs(), SetSifs(), SetSlot(), and ns3::WIFI_MOD_CLASS_OFDM.
Referenced by ConfigureStandard().
|
private |
Configure the device MCS set with the appropriate HtMcs modes for the number of available transmit spatial streams.
|
virtual |
Configure the PHY-level parameters for different Wi-Fi standard.
standard | the Wi-Fi standard |
Definition at line 941 of file wifi-phy.cc.
References Configure80211a(), Configure80211ac(), Configure80211ax(), Configure80211b(), Configure80211be(), Configure80211g(), Configure80211n(), Configure80211p(), ns3::WifiPhyOperatingChannel::IsSet(), m_channelSettings, m_operatingChannel, m_phyEntities, m_standard, NS_ABORT_MSG_IF, NS_ASSERT_MSG, NS_LOG_DEBUG, NS_LOG_FUNCTION, SetOperatingChannel(), ns3::WIFI_STANDARD_80211a, ns3::WIFI_STANDARD_80211ac, ns3::WIFI_STANDARD_80211ax, ns3::WIFI_STANDARD_80211b, ns3::WIFI_STANDARD_80211be, ns3::WIFI_STANDARD_80211g, ns3::WIFI_STANDARD_80211n, ns3::WIFI_STANDARD_80211p, and ns3::WIFI_STANDARD_UNSPECIFIED.
Referenced by DoChannelSwitch(), LargestIdlePrimaryChannelTest::DoRun(), AmpduAggregationTest::DoRun(), TwoLevelAggregationTest::DoRun(), DcfImmediateAccessBroadcastTestCase::DoRun(), Bug2831TestCase::DoRun(), HeAggregationTest::DoRunSubTest(), SpectrumWifiPhyBasicTest::DoSetup(), SpectrumWifiPhyFilterTest::DoSetup(), TestNonHtDuplicatePhyReception::DoSetup(), TestMultipleCtsResponsesFromMuRts::DoSetup(), WifiPhyCcaThresholdsTest::DoSetup(), WifiPhyCcaIndicationTest::DoSetup(), TestDlOfdmaPhyTransmission::DoSetup(), TestDlOfdmaPhyPuncturing::DoSetup(), TestUlOfdmaPpduUid::DoSetup(), TestMultipleHeTbPreambles::DoSetup(), TestUlOfdmaPhyTransmission::DoSetup(), TestPhyPaddingExclusion::DoSetup(), TestThresholdPreambleDetectionWithoutFrameCapture::DoSetup(), TestThresholdPreambleDetectionWithFrameCapture::DoSetup(), TestSimpleFrameCaptureModel::DoSetup(), TestPhyHeadersReception::DoSetup(), TestAmpduReception::DoSetup(), TestUnsupportedBandwidthReception::DoSetup(), TestPrimary20CoveredByPpdu::DoSetup(), WifiPhyThresholdsTest::DoSetup(), and InterferenceExperiment::Run().
|
virtual |
bandWidth | the width (MHz) of the band used for the OFDMA transmission. Must be a multiple of 20 MHz |
guardBandwidth | width of the guard band (MHz) |
range | the subcarrier range of the HE RU |
bandIndex | the index (starting at 0) of the band within the operating channel |
This is a helper function to convert HE RU subcarriers, which are relative to the center frequency subcarrier, to the indexes used by the Spectrum model.
Reimplemented in ns3::SpectrumWifiPhy.
Definition at line 1839 of file wifi-phy.cc.
References NS_ASSERT_MSG.
Referenced by ns3::HePhy::GetNonOfdmaBand(), ns3::HePhy::GetRuBandForRx(), and ns3::HePhy::GetRuBandForTx().
|
protectedvirtual |
Actually switch channel based on the stored channel settings.
Reimplemented in ns3::SpectrumWifiPhy.
Definition at line 1152 of file wifi-phy.cc.
References ConfigureStandard(), ns3::VhtConfiguration::Get160MHzOperationSupported(), GetChannelSwitchDelay(), ns3::WifiPhyOperatingChannel::GetDefaultChannelNumber(), ns3::GetDefaultChannelWidth(), ns3::GetDefaultPhyBand(), ns3::WifiNetDevice::GetHtConfiguration(), ns3::WifiNetDevice::GetVhtConfiguration(), ns3::Object::IsInitialized(), m_band, m_channelSettings, m_device, m_fixedPhyBand, m_interference, m_operatingChannel, m_standard, m_state, NS_ABORT_MSG, NS_ABORT_MSG_IF, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::WifiPhyOperatingChannel::Set(), ns3::WifiPhyOperatingChannel::SetPrimary20Index(), and ns3::WIFI_PHY_BAND_UNSPECIFIED.
Referenced by ns3::SpectrumWifiPhy::DoChannelSwitch(), and SetOperatingChannel().
|
overrideprotectedvirtual |
Destructor implementation.
This method is called by Dispose() or by the Object's destructor, whichever comes first.
Subclasses are expected to implement their real destruction code in an overridden version of this method and chain up to their parent's implementation once they are done. i.e, for simplicity, the destructor of every subclass should be empty and its content should be moved to the associated DoDispose() method.
It is safe to call GetObject() from within this method.
Reimplemented from ns3::Object.
Reimplemented in OfdmaSpectrumWifiPhy, MuRtsCtsSpectrumWifiPhy, and ns3::YansWifiPhy.
Definition at line 392 of file wifi-phy.cc.
References ns3::EventId::Cancel(), m_currentEvent, m_currentPreambleEvents, m_device, m_endPhyRxEvent, m_endTxEvent, m_frameCaptureModel, m_interference, m_mobility, m_phyEntities, m_postReceptionErrorModel, m_preambleDetectionModel, m_random, m_state, m_wifiRadioEnergyModel, and NS_LOG_FUNCTION.
Referenced by ns3::SpectrumWifiPhy::DoDispose(), and ns3::YansWifiPhy::DoDispose().
|
overrideprotectedvirtual |
Initialize() implementation.
This method is called only once by Initialize(). If the user calls Initialize() multiple times, DoInitialize() is called only the first time.
Subclasses are expected to override this method and chain up to their parent's implementation once they are done. It is safe to call GetObject() and AggregateObject() from within this method.
Reimplemented from ns3::Object.
Reimplemented in OfdmaSpectrumWifiPhy, and MuRtsCtsSpectrumWifiPhy.
Definition at line 367 of file wifi-phy.cc.
References ns3::WifiNetDevice::GetNode(), ns3::Object::GetObject(), m_device, m_mobility, NS_ABORT_MSG_UNLESS, NS_LOG_FUNCTION, and NS_LOG_WARN.
Referenced by ns3::SpectrumWifiPhy::DoInitialize().
void ns3::WifiPhy::EndReceiveInterBss | ( | ) |
For HE receptions only, check and possibly modify the transmit power restriction state at the end of PPDU reception.
Definition at line 1850 of file wifi-phy.cc.
References m_channelAccessRequested, m_powerRestricted, and NS_LOG_FUNCTION.
Referenced by ResetCca().
Time ns3::WifiPhy::GetAckTxTime | ( | ) | const |
Return the estimated Ack TX time for this PHY.
Definition at line 804 of file wifi-phy.cc.
References m_ackTxTime.
Referenced by ns3::MinstrelWifiManager::CalculateTimeUnicastPacket(), and ns3::ChannelAccessManager::GetEifsNoDifs().
|
private |
Get the PSDU addressed to that PHY in a PPDU (useful for MU PPDU).
ppdu | the PPDU to extract the PSDU from |
Definition at line 2168 of file wifi-phy.cc.
References GetPhyEntityForPpdu().
Referenced by AbortCurrentReception().
|
virtual |
Get the start band index and the stop band index for a given band.
bandWidth | the width of the band to be returned (MHz) |
bandIndex | the index of the band to be returned |
Reimplemented in ns3::SpectrumWifiPhy.
Definition at line 2175 of file wifi-phy.cc.
Referenced by ns3::HePhy::GetPer20MHzDurations(), ns3::PhyEntity::GetPrimaryBand(), and ns3::PhyEntity::GetSecondaryBand().
Time ns3::WifiPhy::GetBlockAckTxTime | ( | ) | const |
Return the estimated BlockAck TX time for this PHY.
Definition at line 810 of file wifi-phy.cc.
References m_blockAckTxTime.
Referenced by ns3::MinstrelHtWifiManager::CalculateRetransmits().
std::list< uint8_t > ns3::WifiPhy::GetBssMembershipSelectorList | ( | ) | const |
The WifiPhy::BssMembershipSelector() method is used (e.g., by a WifiRemoteStationManager) to determine the set of transmission/reception modes that this WifiPhy(-derived class) can support - a set of WifiMode objects which we call the BssMembershipSelectorSet, and which is stored inside HT PHY (and above) instances.
Definition at line 1301 of file wifi-phy.cc.
References list, and m_phyEntities.
Referenced by ns3::StaWifiMac::CheckSupportedRates().
double ns3::WifiPhy::GetCcaEdThreshold | ( | ) | const |
Return the CCA energy detection threshold (dBm).
Definition at line 492 of file wifi-phy.cc.
References m_ccaEdThresholdW, and ns3::WToDbm().
Referenced by ns3::PhyEntity::GetCcaThreshold(), ns3::VhtPhy::GetCcaThreshold(), and GetTypeId().
double ns3::WifiPhy::GetCcaSensitivityThreshold | ( | ) | const |
Return the CCA sensitivity threshold (dBm).
Definition at line 505 of file wifi-phy.cc.
References m_ccaSensitivityThresholdW, and ns3::WToDbm().
Referenced by ns3::PhyEntity::GetCcaThreshold(), ns3::OfdmPhy::GetCcaThreshold(), ns3::VhtPhy::GetCcaThreshold(), and GetTypeId().
Return the Channel this WifiPhy is connected to.
Implemented in ns3::YansWifiPhy, and ns3::SpectrumWifiPhy.
Referenced by ns3::WaveNetDevice::GetChannel(), ns3::WifiNetDevice::GetChannel(), and GetTypeId().
uint8_t ns3::WifiPhy::GetChannelNumber | ( | ) | const |
Return current channel number.
Definition at line 1020 of file wifi-phy.cc.
References ns3::WifiPhyOperatingChannel::GetNumber(), and m_operatingChannel.
Referenced by SetChannelFrequencyTest::DoRun(), ns3::MeshWifiInterfaceMac::GetFrequencyChannel(), GetTypeId(), ns3::YansWifiChannel::Send(), ns3::WaveFrameExchangeManager::StartTransmission(), ns3::DefaultChannelScheduler::SwitchToNextChannel(), and ns3::PhyEntity::Transmit().
Time ns3::WifiPhy::GetChannelSwitchDelay | ( | ) | const |
Definition at line 683 of file wifi-phy.cc.
References m_channelSwitchDelay.
Referenced by ns3::DefaultChannelScheduler::AssignDefaultCchAccess(), DoChannelSwitch(), and ns3::DefaultChannelScheduler::SwitchToNextChannel().
uint16_t ns3::WifiPhy::GetChannelWidth | ( | ) | const |
Definition at line 1026 of file wifi-phy.cc.
References ns3::WifiPhyOperatingChannel::GetWidth(), and m_operatingChannel.
Referenced by AbortCurrentReception(), ns3::IdealWifiManager::BuildSnrThresholds(), ns3::PhyEntity::CanStartRx(), TestMultiUserScheduler::ComputeWifiTxVector(), Configure80211p(), ns3::ChannelAccessManager::DoGrantDcfAccess(), ns3::IdealWifiManager::DoReportRtsOk(), AmpduAggregationTest::DoRun(), TwoLevelAggregationTest::DoRun(), TestNonHtDuplicatePhyReception::DoRun(), SetChannelFrequencyTest::DoRun(), HeAggregationTest::DoRunSubTest(), ns3::SpectrumWifiPhy::GetBand(), ns3::SpectrumWifiPhy::GetBandBandwidth(), ns3::HtPhy::GetCcaIndication(), ns3::VhtPhy::GetCcaIndication(), ns3::HePhy::GetNonOfdmaBand(), ns3::ChannelAccessManager::GetPer20MHzBusy(), ns3::HePhy::GetPer20MHzDurations(), ns3::PhyEntity::GetPrimaryBand(), ns3::HePhy::GetRuBandForRx(), ns3::PhyEntity::GetRxChannelWidth(), ns3::DsssPhy::GetRxChannelWidth(), ns3::SpectrumWifiPhy::GetRxSpectrumModel(), ns3::PhyEntity::GetSecondaryBand(), GetTxBandwidth(), GetTypeId(), ns3::ThompsonSamplingWifiManager::InitializeStation(), ns3::ChannelAccessManager::InitLastBusyStructs(), ns3::OfdmPhy::IsChannelWidthSupported(), ns3::SpectrumWifiPhy::ResetSpectrumModel(), ns3::SpectrumWifiPhy::StartRx(), PowerRateAdaptationTest::TestAparf(), PowerRateAdaptationTest::TestParf(), PowerRateAdaptationTest::TestRrpaa(), and ns3::SpectrumWifiPhy::UpdateInterferenceHelperBands().
WifiMode ns3::WifiPhy::GetDefaultMode | ( | ) | const |
Get the default WifiMode supported by the PHY.
This is the first mode to be added (i.e. the lowest one over all supported PHY entities).
Definition at line 1880 of file wifi-phy.cc.
References m_phyEntities, and NS_ASSERT_MSG.
|
protected |
Perform any actions necessary when user changes operating channel after initialization.
Definition at line 1101 of file wifi-phy.cc.
References ns3::EventId::Cancel(), CCA_BUSY, GetDelayUntilIdle(), IDLE, ns3::Object::IsInitialized(), IsStateSwitching(), m_channelAccessRequested, m_currentEvent, m_currentPreambleEvents, m_endPhyRxEvent, m_phyEntities, m_powerRestricted, m_state, NS_ASSERT, NS_LOG_DEBUG, RX, ns3::Seconds(), SLEEP, and TX.
Referenced by SetOperatingChannel().
Time ns3::WifiPhy::GetDelayUntilIdle | ( | ) |
The PHY will never become WifiPhy::IDLE before the delay returned by this method but it could become really idle later.
Definition at line 2040 of file wifi-phy.cc.
References m_state.
Referenced by GetDelayUntilChannelSwitch(), ns3::StaWifiMac::MissedBeacons(), and SetSleepMode().
Ptr< WifiNetDevice > ns3::WifiPhy::GetDevice | ( | ) | const |
Return the device this PHY is associated with.
Definition at line 606 of file wifi-phy.cc.
References m_device.
Referenced by ns3::HePhy::CanStartRx(), ns3::HePhy::DoGetEvent(), ns3::HePhy::DoStartReceivePayload(), ns3::HePhy::GetBssColor(), ns3::VhtPhy::GetCcaThreshold(), ns3::WifiRemoteStationManager::GetEhtSupported(), ns3::WifiRemoteStationManager::GetGuardInterval(), ns3::WifiRemoteStationManager::GetHeSupported(), ns3::WifiRemoteStationManager::GetHtSupported(), ns3::WifiRemoteStationManager::GetLdpcSupported(), ns3::WifiRemoteStationManager::GetShortGuardIntervalSupported(), ns3::HePhy::GetStaId(), ns3::WifiRemoteStationManager::GetVhtSupported(), ns3::HePhy::SetTrigVector(), and ns3::HePhy::StartTx().
uint16_t ns3::WifiPhy::GetFrequency | ( | ) | const |
Definition at line 1014 of file wifi-phy.cc.
References ns3::WifiPhyOperatingChannel::GetFrequency(), and m_operatingChannel.
Referenced by TestNonHtDuplicatePhyReception::DoRun(), SetChannelFrequencyTest::DoRun(), ns3::PhyEntity::EndReceivePayload(), ns3::HePhy::GetPer20MHzDurations(), ns3::SpectrumWifiPhy::GetRxSpectrumModel(), GetTypeId(), ns3::SpectrumWifiPhy::ResetSpectrumModel(), and Send().
|
pure virtual |
currentChannelWidth | channel width of the current transmission (MHz) |
Note: in order to properly model out of band transmissions for OFDM, the guard band has been configured so as to expand the modeled spectrum up to the outermost referenced point in "Transmit spectrum mask" sections' PSDs of each PHY specification of 802.11-2016 standard. It thus ultimately corresponds to the current channel bandwidth (which can be different from devices max channel width).
This method is only relevant for SpectrumWifiPhy.
Implemented in ns3::YansWifiPhy, and ns3::SpectrumWifiPhy.
Referenced by ns3::PhyEntity::GetGuardBandwidth().
Time ns3::WifiPhy::GetLastRxEndTime | ( | ) | const |
Return the end time of the last received packet.
Definition at line 2052 of file wifi-phy.cc.
References m_state.
Referenced by ns3::PhyEntity::DoEndReceivePayload(), and ns3::HePhy::DoEndReceivePayload().
Time ns3::WifiPhy::GetLastRxStartTime | ( | ) | const |
Return the start time of the last received packet.
Definition at line 2046 of file wifi-phy.cc.
References m_state.
Get the latest PHY entity supported by this PHY instance.
Definition at line 719 of file wifi-phy.cc.
References GetPhyEntity(), and m_standard.
Referenced by ns3::ErpOfdmPhy::BuildPpdu(), ns3::OfdmPhy::BuildPpdu(), ns3::SpectrumWifiPhy::CanStartRx(), OfdmaSpectrumWifiPhy::GetHePhy(), GetPhyEntityForPpdu(), NotifyCcaBusy(), TestMultipleHeTbPreambles::RxHeTbPpdu(), TestPhyPaddingExclusion::SetTrigVector(), TestUlOfdmaPhyTransmission::SetTrigVector(), and SwitchMaybeToCcaBusy().
|
static |
Get the maximum PSDU size in bytes for the given modulation class.
modulation | the modulation class |
Definition at line 1509 of file wifi-phy.cc.
References GetStaticPhyEntity().
Referenced by ns3::QosFrameExchangeManager::IsWithinSizeAndTimeLimits().
uint8_t ns3::WifiPhy::GetMaxSupportedRxSpatialStreams | ( | ) | const |
Definition at line 1295 of file wifi-phy.cc.
References m_rxSpatialStreams.
Referenced by ns3::ApWifiMac::GetEhtOperation(), ns3::ApWifiMac::GetHeOperation(), GetTypeId(), ns3::HePhy::IsConfigSupported(), and ns3::HtPhy::IsConfigSupported().
uint8_t ns3::WifiPhy::GetMaxSupportedTxSpatialStreams | ( | ) | const |
Definition at line 1277 of file wifi-phy.cc.
References m_txSpatialStreams.
Referenced by ns3::IdealWifiManager::BuildSnrThresholds(), GetTypeId(), ns3::ThompsonSamplingWifiManager::InitializeStation(), and Send().
WifiMode ns3::WifiPhy::GetMcs | ( | WifiModulationClass | modulation, |
uint8_t | mcs | ||
) | const |
Get the WifiMode object corresponding to the given MCS of the given modulation class.
modulation | the modulation class |
mcs | the MCS value |
Definition at line 1991 of file wifi-phy.cc.
References IsMcsSupported(), m_phyEntities, and NS_ASSERT_MSG.
The WifiPhy::GetMcsList() method is used (e.g., by a WifiRemoteStationManager) to determine the set of transmission/reception MCS indices that this WifiPhy(-derived class) can support - a set of MCS indices which is stored by each HT PHY (and above).
Definition at line 1956 of file wifi-phy.cc.
References list, and m_phyEntities.
Referenced by ns3::WifiRemoteStationManager::AddAllSupportedMcs(), and ns3::ThompsonSamplingWifiManager::InitializeStation().
std::list< WifiMode > ns3::WifiPhy::GetMcsList | ( | WifiModulationClass | modulation | ) | const |
Get the list of supported MCSs for the given modulation class (i.e.
corresponding to a given PHY entity).
modulation | the modulation class |
Definition at line 1973 of file wifi-phy.cc.
References list, and m_phyEntities.
Ptr< MobilityModel > ns3::WifiPhy::GetMobility | ( | ) | const |
Return the mobility model this PHY is associated with.
This method will return either the mobility model that has been explicitly set by a call to YansWifiPhy::SetMobility(), or else will return the mobility model (if any) that has been aggregated to the node.
Definition at line 618 of file wifi-phy.cc.
References m_mobility.
Referenced by ns3::WifiSpectrumPhyInterface::GetMobility(), and ns3::YansWifiChannel::Send().
The WifiPhy::GetModeList() method is used (e.g., by a WifiRemoteStationManager) to determine the set of transmission/reception (non-MCS) modes that this WifiPhy(-derived class) can support - a set of modes which is stored by each non-HT PHY.
It is important to note that this list is a superset (not necessarily proper) of the OperationalRateSet (which is logically, if not actually, a property of the associated WifiRemoteStationManager), which itself is a superset (again, not necessarily proper) of the BSSBasicRateSet.
Definition at line 1907 of file wifi-phy.cc.
References list, and m_phyEntities.
Referenced by ns3::WifiRemoteStationManager::AddAllSupportedModes(), and ns3::StaWifiMac::UpdateApInfo().
std::list< WifiMode > ns3::WifiPhy::GetModeList | ( | WifiModulationClass | modulation | ) | const |
Get the list of supported (non-MCS) modes for the given modulation class (i.e.
corresponding to a given PHY entity).
modulation | the modulation class |
Definition at line 1924 of file wifi-phy.cc.
References list, and m_phyEntities.
uint16_t ns3::WifiPhy::GetNMcs | ( | ) | const |
Definition at line 1942 of file wifi-phy.cc.
References m_phyEntities.
uint8_t ns3::WifiPhy::GetNTxPower | ( | ) | const |
Return the number of available transmission power levels.
Definition at line 555 of file wifi-phy.cc.
References m_nTxPower.
uint8_t ns3::WifiPhy::GetNumberOfAntennas | ( | ) | const |
Definition at line 1245 of file wifi-phy.cc.
References m_numberOfAntennas.
Referenced by GetTypeId(), SetMaxSupportedRxSpatialStreams(), and SetMaxSupportedTxSpatialStreams().
const WifiPhyOperatingChannel & ns3::WifiPhy::GetOperatingChannel | ( | ) | const |
Get a const reference to the operating channel.
Definition at line 1008 of file wifi-phy.cc.
References m_operatingChannel.
Referenced by ns3::PhyEntity::BuildPpdu(), ns3::EhtPhy::BuildPpdu(), ns3::HePhy::BuildPpdu(), ns3::HtPhy::BuildPpdu(), ns3::DsssPhy::BuildPpdu(), ns3::ErpOfdmPhy::BuildPpdu(), ns3::OfdmPhy::BuildPpdu(), ns3::VhtPhy::BuildPpdu(), ns3::PhyEntity::CanStartRx(), MultiLinkSetupTest::CheckMlSetup(), ns3::ChannelAccessManager::DoGrantDcfAccess(), TestNonHtDuplicatePhyReception::DoRun(), SetChannelFrequencyTest::DoRun(), ns3::WifiDefaultAssocManager::EndScanning(), ns3::HtPhy::GetCcaIndication(), ns3::VhtPhy::GetCcaIndication(), ns3::PhyEntity::GetCenterFrequencyForChannelWidth(), ns3::HePhy::GetCenterFrequencyForNonOfdmaPart(), ns3::HePhy::GetNonOfdmaBand(), ns3::HePhy::GetPer20MHzDurations(), ns3::ApWifiMac::GetReducedNeighborReport(), ns3::HePhy::GetRuBandForRx(), ns3::HePhy::GetRuBandForTx(), ns3::HePhy::GetTxPowerSpectralDensity(), ns3::ChannelAccessManager::InitLastBusyStructs(), TestPrimary20CoveredByPpdu::RunOne(), and ns3::SpectrumWifiPhy::UpdateInterferenceHelperBands().
|
static |
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) |
Definition at line 1452 of file wifi-phy.cc.
References ns3::WifiTxVector::GetModulationClass(), and GetStaticPhyEntity().
|
static |
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. |
staId | the STA-ID of the PSDU (only used for MU PPDUs) |
Definition at line 1433 of file wifi-phy.cc.
Referenced by ns3::MinstrelHtWifiManager::CalculateMpduTxDuration(), CalculateTxDuration(), and ns3::PhyEntity::ScheduleEndOfMpdus().
WifiPhyBand ns3::WifiPhy::GetPhyBand | ( | ) | const |
Get the configured Wi-Fi band.
Definition at line 996 of file wifi-phy.cc.
References m_band.
Referenced by ns3::EhtPhy::BuildPpdu(), ns3::HePhy::BuildPpdu(), ns3::HtPhy::BuildPpdu(), ns3::ErpOfdmPhy::BuildPpdu(), ns3::OfdmPhy::BuildPpdu(), ns3::VhtPhy::BuildPpdu(), ns3::FrameExchangeManager::CalculateAcknowledgmentTime(), ns3::HtFrameExchangeManager::CalculateAcknowledgmentTime(), ns3::FrameExchangeManager::CalculateProtectionTime(), MultiLinkMuTxTest::CheckBlockAck(), ns3::ChannelAccessManager::DoGrantDcfAccess(), ns3::FrameExchangeManager::DoSendCtsAfterRts(), ns3::HePhy::DoStartReceivePayload(), ns3::QosFrameExchangeManager::GetCtsToSelfDurationId(), ns3::FrameExchangeManager::GetFrameDurationId(), ns3::QosFrameExchangeManager::GetFrameDurationId(), ns3::MsduAggregator::GetMaxAmsduSize(), ns3::HeFrameExchangeManager::GetMuRtsDurationId(), ns3::FrameExchangeManager::GetRtsDurationId(), ns3::QosFrameExchangeManager::GetRtsDurationId(), ns3::FrameExchangeManager::GetTxDuration(), ns3::WifiRemoteStationManager::GetVhtSupported(), SpectrumWifiPhyBasicTest::MakeSignal(), WifiPhyThresholdsTest::MakeWifiSignal(), TestMultipleHeTbPreambles::RxHeTbPpdu(), ns3::PhyEntity::ScheduleEndOfMpdus(), TestMultiUserScheduler::SelectTxFormat(), Send(), TestAmpduReception::SendAmpduWithThreeMpdus(), ns3::HtFrameExchangeManager::SendBlockAck(), ns3::QosFrameExchangeManager::SendCfEndIfNeeded(), ns3::FrameExchangeManager::SendCtsToSelf(), ns3::FrameExchangeManager::SendMpdu(), ns3::HtFrameExchangeManager::SendMpduFromBaManager(), ns3::HeFrameExchangeManager::SendMuRts(), TestNonHtDuplicatePhyReception::SendNonHtDuplicatePpdu(), ns3::FrameExchangeManager::SendNormalAck(), TestThresholdPreambleDetectionWithoutFrameCapture::SendPacket(), TestThresholdPreambleDetectionWithFrameCapture::SendPacket(), TestPhyHeadersReception::SendPacket(), TestSimpleFrameCaptureModel::SendPacket(), TestUnsupportedBandwidthReception::SendPpdu(), ns3::HtFrameExchangeManager::SendPsdu(), ns3::HeFrameExchangeManager::SendPsduMap(), ns3::HeFrameExchangeManager::SendPsduMapWithProtection(), ns3::FrameExchangeManager::SendRts(), TestUlOfdmaPpduUid::SendTbPpdu(), TestPhyPaddingExclusion::SetTrigVector(), TestUlOfdmaPhyTransmission::SetTrigVector(), ns3::StaWifiMac::StartScanning(), ns3::MeshWifiInterfaceMac::SwitchFrequencyChannel(), MultiLinkMuTxTest::Transmit(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), ns3::RrMultiUserScheduler::TrySendingBsrpTf(), and ns3::FrameExchangeManager::UpdateNav().
Ptr< PhyEntity > ns3::WifiPhy::GetPhyEntity | ( | WifiModulationClass | modulation | ) | const |
Get the supported PHY entity corresponding to the modulation class.
modulation | the modulation class |
Definition at line 704 of file wifi-phy.cc.
References m_phyEntities, and NS_ABORT_MSG_IF.
Referenced by ns3::ObssPdAlgorithm::ConnectWifiNetDevice(), ns3::EhtFrameExchangeManager::ForwardPsduDown(), GetLatestPhyEntity(), GetPhyEntity(), GetPhyEntityForPpdu(), WifiPhyCcaThresholdsTest::RunOne(), TestPrimary20CoveredByPpdu::RunOne(), Send(), ns3::HeFrameExchangeManager::SendPsduMap(), TestUlOfdmaPpduUid::SendTbPpdu(), and ns3::SpectrumWifiPhy::StartTx().
Ptr< PhyEntity > ns3::WifiPhy::GetPhyEntity | ( | WifiStandard | standard | ) | const |
Get the supported PHY entity corresponding to the wifi standard.
standard | the wifi standard |
Definition at line 713 of file wifi-phy.cc.
References ns3::GetModulationClassForStandard(), and GetPhyEntity().
Get the supported PHY entity to use for a received PPDU.
This typically returns the entity corresponding to the modulation class used to transmit the PPDU. If the modulation class used to transmit the PPDU is not supported by the PHY, the latest PHY entity corresponding to the configured standard is returned. If the modulation used to transmit the PPDU is non-HT (duplicate), the latest PHY entity corresponding to the configured standard is also returned.
ppdu | the received PPDU |
Definition at line 725 of file wifi-phy.cc.
References GetLatestPhyEntity(), GetPhyEntity(), m_phyEntities, NS_ABORT_IF, and ns3::WIFI_MOD_CLASS_HT.
Referenced by GetAddressedPsduInPpdu(), ns3::SpectrumWifiPhy::GetRxPpduFromTxPpdu(), and ns3::PhyEntity::StartReceivePreamble().
Time ns3::WifiPhy::GetPifs | ( | ) | const |
Return the PCF Interframe Space (PIFS) for this PHY.
Definition at line 798 of file wifi-phy.cc.
References m_pifs.
Referenced by ns3::ChannelAccessManager::DoGrantDcfAccess(), ns3::QosFrameExchangeManager::PifsRecovery(), and ns3::QosFrameExchangeManager::TransmissionFailed().
double ns3::WifiPhy::GetPowerDbm | ( | uint8_t | power | ) | const |
Get the power of the given power level in dBm.
In SpectrumWifiPhy implementation, the power levels are equally spaced (in dBm).
power | the power level |
Definition at line 664 of file wifi-phy.cc.
References m_nTxPower, m_txPowerBaseDbm, m_txPowerEndDbm, NS_ASSERT, and NS_ASSERT_MSG.
Referenced by ns3::AparfWifiManager::CheckInit(), ns3::ParfWifiManager::CheckInit(), ns3::RrpaaWifiManager::CheckInit(), ns3::AparfWifiManager::DoGetDataTxVector(), ns3::ParfWifiManager::DoGetDataTxVector(), ns3::RrpaaWifiManager::DoGetDataTxVector(), GetTxPowerForTransmission(), Send(), and ns3::YansWifiPhy::StartTx().
|
static |
Definition at line 1421 of file wifi-phy.cc.
References ns3::MicroSeconds().
Referenced by ns3::PhyEntity::EndPreambleDetectionPeriod(), and ns3::PhyEntity::StartPreambleDetectionPeriod().
uint64_t ns3::WifiPhy::GetPreviouslyRxPpduUid | ( | ) | const |
Definition at line 1798 of file wifi-phy.cc.
References m_previouslyRxPpduUid.
Referenced by ns3::HePhy::ObtainNextUid().
uint8_t ns3::WifiPhy::GetPrimary20Index | ( | ) | const |
Definition at line 1032 of file wifi-phy.cc.
References ns3::WifiPhyOperatingChannel::GetPrimaryChannelIndex(), and m_operatingChannel.
Referenced by GetTypeId().
uint8_t ns3::WifiPhy::GetPrimaryChannelNumber | ( | uint16_t | primaryChannelWidth | ) | const |
Get channel number of the primary channel.
primaryChannelWidth | the width of the primary channel (MHz) |
Definition at line 2202 of file wifi-phy.cc.
References ns3::WifiPhyOperatingChannel::GetPrimaryChannelNumber(), m_operatingChannel, and m_standard.
double ns3::WifiPhy::GetRxGain | ( | ) | const |
Return the reception gain (dB).
Definition at line 581 of file wifi-phy.cc.
References m_rxGainDb.
Referenced by GetTypeId(), and ns3::SpectrumWifiPhy::StartRx().
double ns3::WifiPhy::GetRxSensitivity | ( | ) | const |
Return the receive sensitivity threshold (dBm).
Definition at line 479 of file wifi-phy.cc.
References m_rxSensitivityW, and ns3::WToDbm().
Referenced by GetTypeId(), and ns3::SpectrumWifiPhy::StartRx().
bool ns3::WifiPhy::GetShortPhyPreambleSupported | ( | ) | const |
Return whether short PHY preamble is supported.
Definition at line 594 of file wifi-phy.cc.
References m_shortPreamble.
Referenced by GetTypeId().
Time ns3::WifiPhy::GetSifs | ( | ) | const |
Return the Short Interframe Space (SIFS) for this PHY.
Definition at line 774 of file wifi-phy.cc.
References m_sifs.
Referenced by ns3::FrameExchangeManager::CalculateAcknowledgmentTime(), ns3::HtFrameExchangeManager::CalculateAcknowledgmentTime(), ns3::FrameExchangeManager::CalculateProtectionTime(), ns3::MinstrelHtWifiManager::CalculateRetransmits(), ns3::MinstrelWifiManager::CalculateTimeUnicastPacket(), Configure80211a(), Configure80211b(), Configure80211p(), OfdmaAckSequenceTest::DoRun(), ns3::FrameExchangeManager::DoSendCtsAfterRts(), ns3::HtFrameExchangeManager::EndReceiveAmpdu(), ns3::FrameExchangeManager::GetCtsToSelfDurationId(), ns3::ChannelAccessManager::GetEifsNoDifs(), ns3::FrameExchangeManager::GetFrameDurationId(), ns3::FrameExchangeManager::GetRtsDurationId(), ns3::ChannelAccessManager::GetSifs(), ns3::QosFrameExchangeManager::PifsRecovery(), ns3::FrameExchangeManager::ReceiveMpdu(), ns3::HtFrameExchangeManager::ReceiveMpdu(), ns3::QosFrameExchangeManager::ReceiveMpdu(), TestMultiUserScheduler::SelectTxFormat(), ns3::HtFrameExchangeManager::SendBlockAck(), ns3::FrameExchangeManager::SendCtsToSelf(), ns3::FrameExchangeManager::SendMpdu(), ns3::HtFrameExchangeManager::SendMpduFromBaManager(), TestUlOfdmaPowerControl::SendMuBar(), ns3::HeFrameExchangeManager::SendMuRts(), ns3::FrameExchangeManager::SendNormalAck(), ns3::HtFrameExchangeManager::SendPsdu(), ns3::HeFrameExchangeManager::SendPsduMap(), ns3::HeFrameExchangeManager::SendPsduMapWithProtection(), ns3::FrameExchangeManager::SendRts(), ns3::FrameExchangeManager::TransmissionSucceeded(), ns3::HtFrameExchangeManager::TransmissionSucceeded(), ns3::QosFrameExchangeManager::TransmissionSucceeded(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), ns3::RrMultiUserScheduler::TrySendingBsrpTf(), and ns3::FrameExchangeManager::UpdateNav().
Time ns3::WifiPhy::GetSlot | ( | ) | const |
Return the slot duration for this PHY.
Definition at line 786 of file wifi-phy.cc.
References m_slot.
Referenced by ns3::MinstrelHtWifiManager::CalculateRetransmits(), ns3::MinstrelWifiManager::CalculateTimeUnicastPacket(), Configure80211a(), Configure80211b(), Configure80211p(), OfdmaAckSequenceTest::DoRun(), ns3::ChannelAccessManager::GetSlot(), ns3::FrameExchangeManager::SendMpdu(), ns3::HeFrameExchangeManager::SendMuRts(), ns3::HtFrameExchangeManager::SendPsdu(), ns3::HeFrameExchangeManager::SendPsduMap(), ns3::FrameExchangeManager::SendRts(), and ns3::FrameExchangeManager::UpdateNav().
WifiStandard ns3::WifiPhy::GetStandard | ( | ) | const |
Get the configured Wi-Fi standard.
Definition at line 1002 of file wifi-phy.cc.
References m_standard.
Referenced by ns3::WifiMac::ConfigurePhyDependentParameters(), ns3::SpectrumWifiPhy::GetBandBandwidth(), ns3::MsduAggregator::GetMaxAmsduSize(), ns3::ChannelAccessManager::InitLastBusyStructs(), ns3::SpectrumWifiPhy::StartRx(), and ns3::SpectrumWifiPhy::UpdateInterferenceHelperBands().
|
static |
txVector | the transmission parameters used for this packet |
Definition at line 1427 of file wifi-phy.cc.
References ns3::MicroSeconds().
Ptr< WifiPhyStateHelper > ns3::WifiPhy::GetState | ( | ) | const |
Return the WifiPhyStateHelper of this PHY.
Definition at line 436 of file wifi-phy.cc.
References m_state.
Referenced by WifiPhyThresholdsTest::DoSetup(), and ns3::FrameExchangeManager::ResetPhy().
|
staticprivate |
Definition at line 429 of file wifi-phy.cc.
Referenced by AddPhyEntity(), AddStaticPhyEntity(), and GetStaticPhyEntity().
|
static |
Get the implemented PHY entity corresponding to the modulation class.
This is used to compute the different amendment-specific parameters within calling static methods.
modulation | the modulation class |
Definition at line 695 of file wifi-phy.cc.
References GetStaticPhyEntities(), and NS_ABORT_MSG_IF.
Referenced by ns3::InterferenceHelper::CalculatePayloadSnrPer(), CalculatePhyPreambleAndHeaderDuration(), CalculateTxDuration(), GetMaxPsduSize(), GetPayloadDuration(), and GetWifiConstPsduMap().
uint16_t ns3::WifiPhy::GetTxBandwidth | ( | WifiMode | mode, |
uint16_t | maxAllowedBandWidth = std::numeric_limits<uint16_t>::max() |
||
) | const |
Get the bandwidth for a transmission occurring on the current operating channel and using the given WifiMode, subject to the constraint that the TX bandwidth cannot exceed the given maximum allowed value.
mode | the given WifiMode |
maxAllowedBandWidth | the maximum allowed TX bandwidth |
Definition at line 1050 of file wifi-phy.cc.
References GetChannelWidth(), ns3::GetMaximumChannelWidth(), ns3::WifiMode::GetModulationClass(), min, ns3::WIFI_MOD_CLASS_DSSS, and ns3::WIFI_MOD_CLASS_HR_DSSS.
Referenced by ns3::IdealWifiManager::DoGetDataTxVector(), and ns3::MinstrelHtWifiManager::DoGetDataTxVector().
double ns3::WifiPhy::GetTxGain | ( | ) | const |
Return the transmission gain (dB).
Definition at line 568 of file wifi-phy.cc.
References m_txGainDb.
Referenced by GetTxPowerForTransmission(), GetTypeId(), Send(), ns3::PhyEntity::StartTx(), ns3::HePhy::StartTx(), and ns3::YansWifiPhy::StartTx().
|
pure virtual |
This method is only relevant for SpectrumWifiPhy.
Implemented in ns3::YansWifiPhy, and ns3::SpectrumWifiPhy.
Referenced by ns3::PhyEntity::GetTxMaskRejectionParams().
double ns3::WifiPhy::GetTxPowerEnd | ( | ) | const |
Return the maximum available transmission power level (dBm).
Definition at line 542 of file wifi-phy.cc.
References m_txPowerEndDbm.
Referenced by GetTypeId().
Compute the transmit power for the next transmission.
The returned power will satisfy the power density constraints after addition of antenna gain.
ppdu | the PPDU to transmit |
Definition at line 2132 of file wifi-phy.cc.
References GetPowerDbm(), GetTxGain(), m_powerDensityLimit, m_powerRestricted, m_txPowerMaxMimo, m_txPowerMaxSiso, min, NS_LOG_FUNCTION, NS_LOG_INFO, and ns3::RatioToDb().
Referenced by Send(), ns3::PhyEntity::StartTx(), ns3::HePhy::StartTx(), and ns3::YansWifiPhy::StartTx().
double ns3::WifiPhy::GetTxPowerStart | ( | ) | const |
Return the minimum available transmission power level (dBm).
Definition at line 529 of file wifi-phy.cc.
References m_txPowerBaseDbm.
Referenced by GetTypeId().
|
static |
Get the type ID.
Definition at line 62 of file wifi-phy.cc.
References GetCcaEdThreshold(), GetCcaSensitivityThreshold(), GetChannel(), GetChannelNumber(), GetChannelWidth(), GetFrequency(), GetMaxSupportedRxSpatialStreams(), GetMaxSupportedTxSpatialStreams(), GetNumberOfAntennas(), GetPrimary20Index(), GetRxGain(), GetRxSensitivity(), GetShortPhyPreambleSupported(), GetTxGain(), GetTxPowerEnd(), GetTxPowerStart(), HasFixedPhyBand(), m_channelSwitchDelay, m_frameCaptureModel, m_nTxPower, m_phyMonitorSniffRxTrace, m_phyMonitorSniffTxTrace, m_phyRxBeginTrace, m_phyRxDropTrace, m_phyRxEndTrace, m_phyRxPayloadBeginTrace, m_phyTxBeginTrace, m_phyTxDropTrace, m_phyTxEndTrace, m_phyTxPsduBeginTrace, m_pifs, m_postReceptionErrorModel, m_powerDensityLimit, m_preambleDetectionModel, m_sifs, m_slot, m_state, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakeDoubleAccessor(), ns3::MakeEnumChecker(), ns3::MakePointerAccessor(), ns3::MakeTimeAccessor(), ns3::MakeTimeChecker(), ns3::MakeTraceSourceAccessor(), ns3::MakeUintegerAccessor(), ns3::MicroSeconds(), ns3::Seconds(), SetCcaEdThreshold(), SetCcaSensitivityThreshold(), SetFixedPhyBand(), SetMaxSupportedRxSpatialStreams(), SetMaxSupportedTxSpatialStreams(), SetNumberOfAntennas(), SetOperatingChannel(), ns3::TypeId::SetParent(), SetRxGain(), SetRxNoiseFigure(), SetRxSensitivity(), SetShortPhyPreambleSupported(), SetTxGain(), SetTxPowerEnd(), SetTxPowerStart(), ns3::WIFI_PHY_BAND_2_4GHZ, ns3::WIFI_PHY_BAND_5GHZ, ns3::WIFI_PHY_BAND_6GHZ, and ns3::WIFI_PHY_BAND_UNSPECIFIED.
|
static |
Get a WifiConstPsduMap from a PSDU and the TXVECTOR to use to send the PSDU.
The STA-ID value is properly determined based on whether the given PSDU has to be transmitted as a DL or UL frame.
psdu | the given PSDU |
txVector | the TXVECTOR to use to send the PSDU |
Definition at line 1687 of file wifi-phy.cc.
References ns3::WifiTxVector::GetModulationClass(), and GetStaticPhyEntity().
Referenced by CalculateTxDuration(), and Send().
bool ns3::WifiPhy::HasFixedPhyBand | ( | ) | const |
Definition at line 1044 of file wifi-phy.cc.
References m_fixedPhyBand.
Referenced by ns3::WifiDefaultAssocManager::EndScanning(), GetTypeId(), and ns3::StaWifiMac::StartScanning().
bool ns3::WifiPhy::IsMcsSupported | ( | WifiModulationClass | modulation, |
uint8_t | mcs | ||
) | const |
Check if the given MCS of the given modulation class is supported by the PHY.
modulation | the modulation class |
mcs | the MCS value |
Definition at line 1896 of file wifi-phy.cc.
References m_phyEntities.
Referenced by GetMcs().
bool ns3::WifiPhy::IsModeSupported | ( | WifiMode | mode | ) | const |
Check if the given WifiMode is supported by the PHY.
mode | the wifi mode to check |
Definition at line 1867 of file wifi-phy.cc.
References m_phyEntities.
bool ns3::WifiPhy::IsStateCcaBusy | ( | ) | const |
Definition at line 1998 of file wifi-phy.cc.
References m_state.
bool ns3::WifiPhy::IsStateIdle | ( | ) | const |
Definition at line 2004 of file wifi-phy.cc.
References m_state.
bool ns3::WifiPhy::IsStateOff | ( | ) | const |
Definition at line 2034 of file wifi-phy.cc.
References m_state.
Referenced by ns3::PhyEntity::DropPreambleEvent().
bool ns3::WifiPhy::IsStateRx | ( | ) | const |
Definition at line 2010 of file wifi-phy.cc.
References m_state.
Referenced by ns3::PhyEntity::EndPreambleDetectionPeriod(), and ns3::PhyEntity::ResetReceive().
bool ns3::WifiPhy::IsStateSleep | ( | ) | const |
Definition at line 2028 of file wifi-phy.cc.
References m_state.
Referenced by ns3::PhyEntity::DropPreambleEvent().
bool ns3::WifiPhy::IsStateSwitching | ( | ) | const |
Definition at line 2022 of file wifi-phy.cc.
References m_state.
Referenced by GetDelayUntilChannelSwitch().
bool ns3::WifiPhy::IsStateTx | ( | ) | const |
Definition at line 2016 of file wifi-phy.cc.
References m_state.
Notify PHY state helper to switch to CCA busy state,.
ppdu | the incoming PPDU or nullptr for any signal |
duration | the duration of the CCA state |
Definition at line 2065 of file wifi-phy.cc.
References GetLatestPhyEntity(), NS_LOG_FUNCTION, and ns3::WIFI_CHANLIST_PRIMARY.
Referenced by ns3::PhyEntity::EndPreambleDetectionPeriod(), ns3::PhyEntity::EndReceiveField(), and ns3::PhyEntity::StartReceiveField().
void ns3::WifiPhy::NotifyChannelAccessRequested | ( | ) |
Notify the PHY that an access to the channel was requested.
This is typically called by the channel access manager to to notify the PHY about an ongoing transmission. The PHY will use this information to determine whether it should use power restriction as imposed by OBSS_PD SR.
Definition at line 1860 of file wifi-phy.cc.
References m_channelAccessRequested, and NS_LOG_FUNCTION.
Referenced by ns3::ChannelAccessManager::RequestAccess().
void ns3::WifiPhy::NotifyMonitorSniffRx | ( | Ptr< const WifiPsdu > | psdu, |
uint16_t | channelFreqMhz, | ||
WifiTxVector | txVector, | ||
SignalNoiseDbm | signalNoise, | ||
std::vector< bool > | statusPerMpdu, | ||
uint16_t | staId = SU_STA_ID |
||
) |
Public method used to fire a MonitorSniffer trace for a wifi PSDU being received.
Implemented for encapsulation purposes. This method will extract all MPDUs if packet is an A-MPDU and will fire tracedCallback. The A-MPDU reference number (RX side) is set within the method. It must be a different value for each A-MPDU but the same for each subframe within one A-MPDU.
psdu | the PSDU being received |
channelFreqMhz | the frequency in MHz at which the packet is received. Note that in real devices this is normally the frequency to which the receiver is tuned, and this can be different than the frequency at which the packet was originally transmitted. This is because it is possible to have the receiver tuned on a given channel and still to be able to receive packets on a nearby channel. |
txVector | the TXVECTOR that holds RX parameters |
signalNoise | signal power and noise power in dBm (noise power includes the noise figure) |
statusPerMpdu | reception status per MPDU |
staId | the STA-ID |
Definition at line 1593 of file wifi-phy.cc.
References ns3::FIRST_MPDU_IN_AGGREGATE, ns3::WifiPsdu::GetAmpduSubframe(), ns3::WifiPsdu::GetNMpdus(), ns3::WifiPsdu::GetPacket(), ns3::WifiPsdu::IsAggregate(), ns3::WifiTxVector::IsAggregation(), ns3::WifiPsdu::IsSingle(), ns3::LAST_MPDU_IN_AGGREGATE, m_phyMonitorSniffRxTrace, m_rxMpduReferenceNumber, ns3::MIDDLE_MPDU_IN_AGGREGATE, ns3::MpduInfo::mpduRefNumber, ns3::NORMAL_MPDU, NS_ASSERT_MSG, ns3::SINGLE_MPDU, and ns3::MpduInfo::type.
Referenced by ns3::PhyEntity::EndReceivePayload().
void ns3::WifiPhy::NotifyMonitorSniffTx | ( | Ptr< const WifiPsdu > | psdu, |
uint16_t | channelFreqMhz, | ||
WifiTxVector | txVector, | ||
uint16_t | staId = SU_STA_ID |
||
) |
Public method used to fire a MonitorSniffer trace for a wifi PSDU being transmitted.
Implemented for encapsulation purposes. This method will extract all MPDUs if packet is an A-MPDU and will fire tracedCallback. The A-MPDU reference number (RX side) is set within the method. It must be a different value for each A-MPDU but the same for each subframe within one A-MPDU.
psdu | the PSDU being received |
channelFreqMhz | the frequency in MHz at which the packet is transmitted. |
txVector | the TXVECTOR that holds TX parameters |
staId | the STA-ID |
Definition at line 1647 of file wifi-phy.cc.
References ns3::FIRST_MPDU_IN_AGGREGATE, ns3::WifiPsdu::GetAmpduSubframe(), ns3::WifiPsdu::GetNMpdus(), ns3::WifiPsdu::GetPacket(), ns3::WifiPsdu::IsAggregate(), ns3::WifiTxVector::IsAggregation(), ns3::WifiPsdu::IsSingle(), ns3::LAST_MPDU_IN_AGGREGATE, m_phyMonitorSniffTxTrace, m_rxMpduReferenceNumber, ns3::MIDDLE_MPDU_IN_AGGREGATE, ns3::MpduInfo::mpduRefNumber, ns3::NORMAL_MPDU, NS_ASSERT_MSG, ns3::SINGLE_MPDU, and ns3::MpduInfo::type.
Referenced by Send().
void ns3::WifiPhy::NotifyRxBegin | ( | Ptr< const WifiPsdu > | psdu, |
const RxPowerWattPerChannelBand & | rxPowersW | ||
) |
Public method used to fire a PhyRxBegin trace.
Implemented for encapsulation purposes.
psdu | the PSDU being transmitted |
rxPowersW | the receive power per channel band in Watts |
Definition at line 1557 of file wifi-phy.cc.
References m_phyRxBeginTrace, and ns3::PeekPointer().
Referenced by ns3::PhyEntity::EndPreambleDetectionPeriod().
void ns3::WifiPhy::NotifyRxDrop | ( | Ptr< const WifiPsdu > | psdu, |
WifiPhyRxfailureReason | reason | ||
) |
Public method used to fire a PhyRxDrop trace.
Implemented for encapsulation purposes.
psdu | the PSDU being transmitted |
reason | the reason the packet was dropped |
Definition at line 1581 of file wifi-phy.cc.
References m_phyRxDropTrace, and ns3::PeekPointer().
Referenced by AbortCurrentReception(), ns3::HePhy::DoGetEvent(), ns3::PhyEntity::DropPreambleEvent(), ns3::PhyEntity::EndPreambleDetectionPeriod(), and ns3::PhyEntity::EndReceiveField().
Public method used to fire a PhyRxEnd trace.
Implemented for encapsulation purposes.
psdu | the PSDU being transmitted |
Definition at line 1569 of file wifi-phy.cc.
References ns3::TracedCallback< Ts >::IsEmpty(), m_phyRxEndTrace, and ns3::PeekPointer().
Referenced by ns3::PhyEntity::EndReceivePayload().
void ns3::WifiPhy::NotifyTxBegin | ( | WifiConstPsduMap | psdus, |
double | txPowerW | ||
) |
Public method used to fire a PhyTxBegin trace.
Implemented for encapsulation purposes.
psdus | the PSDUs being transmitted (only one unless DL MU transmission) |
txPowerW | the transmit power in Watts |
Definition at line 1515 of file wifi-phy.cc.
References m_phyTxBeginTrace, and ns3::PeekPointer().
Referenced by Send().
Public method used to fire a PhyTxDrop trace.
Implemented for encapsulation purposes.
psdu | the PSDU being transmitted |
Definition at line 1545 of file wifi-phy.cc.
References ns3::TracedCallback< Ts >::IsEmpty(), m_phyTxDropTrace, and ns3::PeekPointer().
Referenced by Send().
void ns3::WifiPhy::NotifyTxEnd | ( | WifiConstPsduMap | psdus | ) |
Public method used to fire a PhyTxEnd trace.
Implemented for encapsulation purposes.
psdus | the PSDUs being transmitted (only one unless DL MU transmission) |
Definition at line 1530 of file wifi-phy.cc.
References ns3::TracedCallback< Ts >::IsEmpty(), m_phyTxEndTrace, and ns3::PeekPointer().
Referenced by Send().
|
private |
Add the given MCS to the device MCS set.
mode | the MCS to add to the device MCS set |
|
private |
Rebuild the mapping of MCS values to indices in the device MCS set.
void ns3::WifiPhy::RegisterListener | ( | WifiPhyListener * | listener | ) |
listener | the new listener |
Add the input listener to the list of objects to be notified of PHY-level events.
Definition at line 454 of file wifi-phy.cc.
References m_state.
Referenced by ns3::WifiRadioEnergyModelHelper::DoInstall(), SpectrumWifiPhyListenerTest::DoSetup(), WifiPhyCcaIndicationTest::DoSetup(), and TestUlOfdmaPhyTransmission::DoSetup().
|
protected |
Reset data upon end of TX or RX.
Definition at line 1804 of file wifi-phy.cc.
References m_currentEvent, m_currentPreambleEvents, m_phyEntities, NS_LOG_FUNCTION, and SwitchMaybeToCcaBusy().
Referenced by ns3::PhyEntity::ErasePreambleEvent(), ns3::PhyEntity::NotifyInterferenceRxEndAndClear(), TestMultipleHeTbPreambles::Reset(), and Send().
void ns3::WifiPhy::ResetCca | ( | bool | powerRestricted, |
double | txPowerMaxSiso = 0 , |
||
double | txPowerMaxMimo = 0 |
||
) |
Reset PHY to IDLE, with some potential TX power restrictions for the next transmission.
powerRestricted | flag whether the transmit power is restricted for the next transmission |
txPowerMaxSiso | the SISO transmit power restriction for the next transmission in dBm |
txPowerMaxMimo | the MIMO transmit power restriction for the next transmission in dBm |
Definition at line 2109 of file wifi-phy.cc.
References AbortCurrentReception(), EndReceiveInterBss(), m_currentEvent, m_powerRestricted, m_txPowerMaxMimo, m_txPowerMaxSiso, ns3::Simulator::Now(), NS_ASSERT, NS_LOG_FUNCTION, ns3::OBSS_PD_CCA_RESET, ns3::Simulator::Schedule(), and ns3::Simulator::ScheduleNow().
void ns3::WifiPhy::ResumeFromOff | ( | ) |
Resume from off mode.
Definition at line 1393 of file wifi-phy.cc.
References CCA_BUSY, IDLE, m_state, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, OFF, RX, SLEEP, SWITCHING, SwitchMaybeToCcaBusy(), and TX.
Referenced by ns3::StaWifiMac::Disassociated(), and ns3::WifiRadioEnergyModelHelper::DoInstall().
void ns3::WifiPhy::ResumeFromSleep | ( | ) |
Resume from sleep mode.
Definition at line 1365 of file wifi-phy.cc.
References CCA_BUSY, IDLE, m_currentPreambleEvents, m_state, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, RX, SLEEP, SWITCHING, SwitchMaybeToCcaBusy(), and TX.
void ns3::WifiPhy::Send | ( | Ptr< const WifiPsdu > | psdu, |
const WifiTxVector & | txVector | ||
) |
This function is a wrapper for the Send variant that accepts a WifiConstPsduMap as first argument.
This function inserts the given PSDU in a WifiConstPsduMap along with a STA-ID value that is determined based on whether the given PSDU has to be transmitted as a DL or UL frame.
psdu | the PSDU to send (in a SU PPDU) |
txVector | the TXVECTOR that has TX parameters such as mode, the transmission mode to use to send this PSDU, and txPowerLevel, a power level to use to send the whole PPDU. The real transmission power is calculated as txPowerMin + txPowerLevel * (txPowerMax - txPowerMin) / nTxLevels |
Definition at line 1693 of file wifi-phy.cc.
References GetWifiConstPsduMap(), and NS_LOG_FUNCTION.
Referenced by ns3::FrameExchangeManager::ForwardMpduDown(), ns3::HtFrameExchangeManager::ForwardPsduDown(), ns3::QosFrameExchangeManager::SendCfEndIfNeeded(), WifiPhyCcaIndicationTest::SendHeSuPpdu(), TestUlOfdmaPowerControl::SendMuBar(), TestUlOfdmaPpduUid::SendMuPpdu(), TestDlOfdmaPhyTransmission::SendMuPpdu(), TestDlOfdmaPhyPuncturing::SendMuPpdu(), TestNonHtDuplicatePhyReception::SendNonHtDuplicatePpdu(), SpectrumWifiPhyFilterTest::SendPpdu(), TestUlOfdmaPpduUid::SendSuPpdu(), and TestUlOfdmaPpduUid::SendTbPpdu().
void ns3::WifiPhy::Send | ( | WifiConstPsduMap | psdus, |
const WifiTxVector & | txVector | ||
) |
psdus | the PSDUs to send |
txVector | the TXVECTOR that has tx parameters such as mode, the transmission mode to use to send this PSDU, and txPowerLevel, a power level to use to send the whole PPDU. The real transmission power is calculated as txPowerMin + txPowerLevel * (txPowerMax - txPowerMin) / nTxLevels |
Definition at line 1700 of file wifi-phy.cc.
References AbortCurrentReception(), ns3::Time::As(), CalculateTxDuration(), ns3::EventId::Cancel(), ns3::DbmToW(), GetFrequency(), GetMaxSupportedTxSpatialStreams(), ns3::WifiTxVector::GetModulationClass(), ns3::WifiTxVector::GetNssMax(), GetPhyBand(), GetPhyEntity(), GetPowerDbm(), GetTxGain(), GetTxPowerForTransmission(), ns3::WifiTxVector::GetTxPowerLevel(), ns3::EventId::IsExpired(), m_channelAccessRequested, m_currentEvent, m_currentPreambleEvents, m_endPhyRxEvent, m_endTxEvent, m_phyEntities, m_phyTxPsduBeginTrace, m_powerRestricted, m_previouslyRxPpduUid, m_state, m_wifiRadioEnergyModel, NotifyMonitorSniffTx(), NotifyTxBegin(), NotifyTxDrop(), NotifyTxEnd(), ns3::Simulator::Now(), ns3::Time::NS, NS_ASSERT, NS_FATAL_ERROR, NS_LOG_DEBUG, NS_LOG_FUNCTION, OFF, ns3::RECEPTION_ABORTED_BY_TX, Reset(), ns3::Simulator::Schedule(), StartTx(), and TX.
void ns3::WifiPhy::SetCapabilitiesChangedCallback | ( | Callback< void > | callback | ) |
callback | the callback to invoke when PHY capabilities have changed. |
Definition at line 466 of file wifi-phy.cc.
References m_capabilitiesChangedCallback.
void ns3::WifiPhy::SetCcaEdThreshold | ( | double | threshold | ) |
Sets the CCA energy detection threshold (dBm).
The energy of a all received signals should be higher than this threshold to allow the PHY layer to declare CCA BUSY state.
threshold | the CCA threshold in dBm |
Definition at line 485 of file wifi-phy.cc.
References ns3::DbmToW(), m_ccaEdThresholdW, and NS_LOG_FUNCTION.
Referenced by GetTypeId(), and WifiPhyCcaThresholdsTest::RunOne().
void ns3::WifiPhy::SetCcaSensitivityThreshold | ( | double | threshold | ) |
Sets the CCA sensitivity threshold (dBm).
The energy of a received wifi signal should be higher than this threshold to allow the PHY layer to declare CCA BUSY state.
threshold | the CCA sensitivity threshold in dBm |
Definition at line 498 of file wifi-phy.cc.
References ns3::DbmToW(), m_ccaSensitivityThresholdW, and NS_LOG_FUNCTION.
Referenced by GetTypeId(), and WifiPhyCcaThresholdsTest::RunOne().
void ns3::WifiPhy::SetDevice | ( | const Ptr< WifiNetDevice > | device | ) |
Sets the device this PHY is associated with.
device | the device this PHY is associated with |
Definition at line 600 of file wifi-phy.cc.
References m_device.
Referenced by AmpduAggregationTest::DoRun(), TwoLevelAggregationTest::DoRun(), DcfImmediateAccessBroadcastTestCase::DoRun(), Bug2831TestCase::DoRun(), HeAggregationTest::DoRunSubTest(), SpectrumWifiPhyFilterTest::DoSetup(), TestNonHtDuplicatePhyReception::DoSetup(), TestMultipleCtsResponsesFromMuRts::DoSetup(), WifiPhyCcaThresholdsTest::DoSetup(), WifiPhyCcaIndicationTest::DoSetup(), TestDlOfdmaPhyTransmission::DoSetup(), TestDlOfdmaPhyPuncturing::DoSetup(), TestUlOfdmaPpduUid::DoSetup(), TestMultipleHeTbPreambles::DoSetup(), TestUlOfdmaPhyTransmission::DoSetup(), TestPhyPaddingExclusion::DoSetup(), and InterferenceExperiment::Run().
void ns3::WifiPhy::SetErrorRateModel | ( | const Ptr< ErrorRateModel > | model | ) |
Sets the error rate model.
model | the error rate model |
Definition at line 632 of file wifi-phy.cc.
References m_interference, and NS_ASSERT.
Referenced by DcfImmediateAccessBroadcastTestCase::DoRun(), Bug2831TestCase::DoRun(), SpectrumWifiPhyBasicTest::DoSetup(), SpectrumWifiPhyFilterTest::DoSetup(), TestNonHtDuplicatePhyReception::DoSetup(), TestMultipleCtsResponsesFromMuRts::DoSetup(), WifiPhyCcaIndicationTest::DoSetup(), TestDlOfdmaPhyTransmission::DoSetup(), TestDlOfdmaPhyPuncturing::DoSetup(), TestUlOfdmaPpduUid::DoSetup(), TestMultipleHeTbPreambles::DoSetup(), TestUlOfdmaPhyTransmission::DoSetup(), TestPhyPaddingExclusion::DoSetup(), TestThresholdPreambleDetectionWithoutFrameCapture::DoSetup(), TestThresholdPreambleDetectionWithFrameCapture::DoSetup(), TestSimpleFrameCaptureModel::DoSetup(), TestPhyHeadersReception::DoSetup(), TestAmpduReception::DoSetup(), TestUnsupportedBandwidthReception::DoSetup(), TestPrimary20CoveredByPpdu::DoSetup(), WifiPhyThresholdsTest::DoSetup(), and InterferenceExperiment::Run().
void ns3::WifiPhy::SetFixedPhyBand | ( | bool | enable | ) |
Configure whether it is prohibited to change PHY band after initialization.
enable | true to prohibit changing PHY band after initialization, false otherwise |
Definition at line 1038 of file wifi-phy.cc.
References m_fixedPhyBand.
Referenced by GetTypeId().
void ns3::WifiPhy::SetFrameCaptureModel | ( | const Ptr< FrameCaptureModel > | frameCaptureModel | ) |
Sets the frame capture model.
frameCaptureModel | the frame capture model |
Definition at line 646 of file wifi-phy.cc.
References m_frameCaptureModel.
Referenced by TestThresholdPreambleDetectionWithFrameCapture::DoSetup(), TestSimpleFrameCaptureModel::DoSetup(), TestAmpduReception::DoSetup(), and InterferenceExperiment::Run().
|
virtual |
Sets the interference helper.
helper | the interference helper |
Reimplemented in ns3::YansWifiPhy.
Definition at line 624 of file wifi-phy.cc.
References ns3::DbToRatio(), m_interference, m_noiseFigureDb, and m_numberOfAntennas.
Referenced by SpectrumWifiPhyBasicTest::DoSetup(), SpectrumWifiPhyFilterTest::DoSetup(), TestNonHtDuplicatePhyReception::DoSetup(), TestMultipleCtsResponsesFromMuRts::DoSetup(), WifiPhyCcaIndicationTest::DoSetup(), TestDlOfdmaPhyTransmission::DoSetup(), TestDlOfdmaPhyPuncturing::DoSetup(), TestUlOfdmaPpduUid::DoSetup(), TestMultipleHeTbPreambles::DoSetup(), TestUlOfdmaPhyTransmission::DoSetup(), TestPhyPaddingExclusion::DoSetup(), TestThresholdPreambleDetectionWithoutFrameCapture::DoSetup(), TestThresholdPreambleDetectionWithFrameCapture::DoSetup(), TestSimpleFrameCaptureModel::DoSetup(), TestPhyHeadersReception::DoSetup(), TestAmpduReception::DoSetup(), TestUnsupportedBandwidthReception::DoSetup(), TestPrimary20CoveredByPpdu::DoSetup(), WifiPhyThresholdsTest::DoSetup(), InterferenceExperiment::Run(), and ns3::YansWifiPhy::SetInterferenceHelper().
void ns3::WifiPhy::SetMaxSupportedRxSpatialStreams | ( | uint8_t | streams | ) |
streams | the maximum number of supported RX spatial streams. |
Definition at line 1283 of file wifi-phy.cc.
References GetNumberOfAntennas(), ns3::Callback< R, UArgs >::IsNull(), m_capabilitiesChangedCallback, m_rxSpatialStreams, and NS_ASSERT.
Referenced by GetTypeId().
void ns3::WifiPhy::SetMaxSupportedTxSpatialStreams | ( | uint8_t | streams | ) |
streams | the maximum number of supported TX spatial streams. |
Definition at line 1251 of file wifi-phy.cc.
References GetNumberOfAntennas(), ns3::Callback< R, UArgs >::IsNull(), m_capabilitiesChangedCallback, m_phyEntities, m_txSpatialStreams, NS_ASSERT, and ns3::WIFI_MOD_CLASS_HT.
Referenced by GetTypeId().
void ns3::WifiPhy::SetMobility | ( | const Ptr< MobilityModel > | mobility | ) |
assign a mobility model to this device
This method allows a user to specify a mobility model that should be associated with this physical layer. Calling this method is optional and only necessary if the user wants to override the mobility model that is aggregated to the node.
mobility | the mobility model this PHY is associated with |
Definition at line 612 of file wifi-phy.cc.
References m_mobility, and third::mobility.
Referenced by DcfImmediateAccessBroadcastTestCase::DoRun(), Bug2831TestCase::DoRun(), SpectrumWifiPhyFilterTest::DoSetup(), TestNonHtDuplicatePhyReception::DoSetup(), TestMultipleCtsResponsesFromMuRts::DoSetup(), TestDlOfdmaPhyTransmission::DoSetup(), TestDlOfdmaPhyPuncturing::DoSetup(), TestUlOfdmaPpduUid::DoSetup(), TestUlOfdmaPhyTransmission::DoSetup(), TestPhyPaddingExclusion::DoSetup(), InterferenceExperiment::Run(), and ns3::WifiSpectrumPhyInterface::SetMobility().
void ns3::WifiPhy::SetNTxPower | ( | uint8_t | n | ) |
Sets the number of transmission power levels available between the minimum level and the maximum level.
Transmission power levels are equally separated (in dBm) with the minimum and the maximum included.
n | the number of available levels |
Definition at line 548 of file wifi-phy.cc.
References m_nTxPower, and NS_LOG_FUNCTION.
void ns3::WifiPhy::SetNumberOfAntennas | ( | uint8_t | antennas | ) |
antennas | the number of antennas on this node. |
Definition at line 1233 of file wifi-phy.cc.
References m_interference, m_numberOfAntennas, NS_ASSERT_MSG, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiPhy::SetOffMode | ( | ) |
Put in off mode.
Definition at line 1350 of file wifi-phy.cc.
References ns3::EventId::Cancel(), m_channelAccessRequested, m_endPhyRxEvent, m_endTxEvent, m_phyEntities, m_powerRestricted, m_state, and NS_LOG_FUNCTION.
Referenced by ns3::WifiRadioEnergyModelHelper::DoInstall(), and ns3::StaWifiMac::ReceiveAssocResp().
void ns3::WifiPhy::SetOperatingChannel | ( | const ChannelTuple & | channelTuple | ) |
If the standard for this object has not been set yet, store the given channel settings.
Otherwise, check if a channel switch can be performed now. If not, schedule another call to this method when channel switch can be performed. Otherwise, set the operating channel based on the given channel settings and call ConfigureStandard if the PHY band has changed.
channelTuple | the given channel settings |
Definition at line 1062 of file wifi-phy.cc.
References DoChannelSwitch(), GetDelayUntilChannelSwitch(), ns3::Object::IsInitialized(), ns3::Time::IsStrictlyNegative(), ns3::Time::IsStrictlyPositive(), m_channelSettings, m_standard, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Simulator::Schedule(), ns3::Seconds(), and ns3::WIFI_STANDARD_UNSPECIFIED.
Referenced by ns3::DefaultChannelScheduler::AssignDefaultCchAccess(), Bug2831TestCase::ChangeSupportedChannelWidth(), ConfigureStandard(), LargestIdlePrimaryChannelTest::DoRun(), TestNonHtDuplicatePhyReception::DoRun(), TestUnsupportedBandwidthReception::DoRun(), SetChannelFrequencyTest::DoRun(), Bug2831TestCase::DoRun(), SpectrumWifiPhyBasicTest::DoSetup(), TestMultipleCtsResponsesFromMuRts::DoSetup(), WifiPhyCcaThresholdsTest::DoSetup(), TestUlOfdmaPpduUid::DoSetup(), TestMultipleHeTbPreambles::DoSetup(), TestPhyPaddingExclusion::DoSetup(), TestThresholdPreambleDetectionWithoutFrameCapture::DoSetup(), TestThresholdPreambleDetectionWithFrameCapture::DoSetup(), TestSimpleFrameCaptureModel::DoSetup(), TestPhyHeadersReception::DoSetup(), TestAmpduReception::DoSetup(), WifiPhyThresholdsTest::DoSetup(), GetTypeId(), InterferenceExperiment::Run(), SpectrumWifiPhyFilterTest::RunOne(), WifiPhyCcaIndicationTest::RunOne(), TestDlOfdmaPhyTransmission::RunOne(), TestDlOfdmaPhyPuncturing::RunOne(), TestUlOfdmaPhyTransmission::RunOne(), TestPrimary20CoveredByPpdu::RunOne(), WifiPhyCcaIndicationTest::SendHeSuPpdu(), InterferenceHelperSequenceTest::SwitchCh(), ns3::MeshWifiInterfaceMac::SwitchFrequencyChannel(), and ns3::DefaultChannelScheduler::SwitchToNextChannel().
void ns3::WifiPhy::SetPifs | ( | Time | pifs | ) |
Set the PCF Interframe Space (PIFS) for this PHY.
pifs | the PIFS duration |
Definition at line 792 of file wifi-phy.cc.
References m_pifs.
Referenced by Configure80211a(), Configure80211b(), and Configure80211p().
void ns3::WifiPhy::SetPostReceptionErrorModel | ( | const Ptr< ErrorModel > | em | ) |
Attach a receive ErrorModel to the WifiPhy.
The WifiPhy may optionally include an ErrorModel in the packet receive chain. The error model is additive to any modulation-based error model based on SNR, and is typically used to force specific packet losses or for testing purposes.
em | Pointer to the ErrorModel. |
Definition at line 639 of file wifi-phy.cc.
References m_postReceptionErrorModel, and NS_LOG_FUNCTION.
Referenced by WifiTxopTest::DoRun(), MultiLinkTxTest::DoSetup(), MultiLinkMuTxTest::DoSetup(), and Bug2470TestCase::RunSubtest().
void ns3::WifiPhy::SetPreambleDetectionModel | ( | const Ptr< PreambleDetectionModel > | preambleDetectionModel | ) |
Sets the preamble detection model.
preambleDetectionModel | the preamble detection model |
Definition at line 652 of file wifi-phy.cc.
References m_preambleDetectionModel.
Referenced by WifiPhyCcaIndicationTest::DoSetup(), TestMultipleHeTbPreambles::DoSetup(), TestUlOfdmaPhyTransmission::DoSetup(), TestThresholdPreambleDetectionWithoutFrameCapture::DoSetup(), TestThresholdPreambleDetectionWithFrameCapture::DoSetup(), TestSimpleFrameCaptureModel::DoSetup(), and TestAmpduReception::DoSetup().
void ns3::WifiPhy::SetReceiveErrorCallback | ( | RxErrorCallback | callback | ) |
callback | the callback to invoke upon erroneous packet reception. |
Definition at line 448 of file wifi-phy.cc.
References m_state.
Referenced by SpectrumWifiPhyBasicTest::DoSetup(), TestMultipleCtsResponsesFromMuRts::DoSetup(), TestDlOfdmaPhyTransmission::DoSetup(), TestDlOfdmaPhyPuncturing::DoSetup(), TestUlOfdmaPhyTransmission::DoSetup(), TestPhyPaddingExclusion::DoSetup(), TestThresholdPreambleDetectionWithoutFrameCapture::DoSetup(), TestThresholdPreambleDetectionWithFrameCapture::DoSetup(), TestAmpduReception::DoSetup(), TestUnsupportedBandwidthReception::DoSetup(), and WifiPhyThresholdsTest::DoSetup().
void ns3::WifiPhy::SetReceiveOkCallback | ( | RxOkCallback | callback | ) |
callback | the callback to invoke upon successful packet reception. |
Definition at line 442 of file wifi-phy.cc.
References m_state.
Referenced by SpectrumWifiPhyBasicTest::DoSetup(), TestMultipleCtsResponsesFromMuRts::DoSetup(), TestDlOfdmaPhyTransmission::DoSetup(), TestDlOfdmaPhyPuncturing::DoSetup(), TestUlOfdmaPhyTransmission::DoSetup(), TestPhyPaddingExclusion::DoSetup(), TestThresholdPreambleDetectionWithoutFrameCapture::DoSetup(), TestThresholdPreambleDetectionWithFrameCapture::DoSetup(), TestSimpleFrameCaptureModel::DoSetup(), TestAmpduReception::DoSetup(), TestUnsupportedBandwidthReception::DoSetup(), WifiPhyThresholdsTest::DoSetup(), TestUlOfdmaPowerControl::ReplaceReceiveOkCallbackOfAp(), ns3::FrameExchangeManager::ResetPhy(), and ns3::FrameExchangeManager::SetWifiPhy().
void ns3::WifiPhy::SetRxGain | ( | double | gain | ) |
Sets the reception gain (dB).
gain | the reception gain in dB |
Definition at line 574 of file wifi-phy.cc.
References m_rxGainDb, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiPhy::SetRxNoiseFigure | ( | double | noiseFigureDb | ) |
Sets the RX loss (dB) in the Signal-to-Noise-Ratio due to non-idealities in the receiver.
noiseFigureDb | noise figure in dB |
Definition at line 511 of file wifi-phy.cc.
References ns3::DbToRatio(), m_interference, m_noiseFigureDb, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiPhy::SetRxSensitivity | ( | double | threshold | ) |
Sets the receive sensitivity threshold (dBm).
The energy of a received signal should be higher than this threshold to allow the PHY layer to detect the signal.
threshold | the receive sensitivity threshold in dBm |
Definition at line 472 of file wifi-phy.cc.
References ns3::DbmToW(), m_rxSensitivityW, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiPhy::SetShortPhyPreambleSupported | ( | bool | preamble | ) |
Enable or disable short PHY preamble.
preamble | sets whether short PHY preamble is supported or not |
Definition at line 587 of file wifi-phy.cc.
References m_shortPreamble, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiPhy::SetSifs | ( | Time | sifs | ) |
Set the Short Interframe Space (SIFS) for this PHY.
sifs | the SIFS duration |
Definition at line 768 of file wifi-phy.cc.
References m_sifs.
Referenced by Configure80211a(), Configure80211b(), and Configure80211p().
void ns3::WifiPhy::SetSleepMode | ( | ) |
Put in sleep mode.
Definition at line 1316 of file wifi-phy.cc.
References CCA_BUSY, GetDelayUntilIdle(), IDLE, m_channelAccessRequested, m_powerRestricted, m_state, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, RX, ns3::Simulator::Schedule(), SLEEP, SWITCHING, and TX.
void ns3::WifiPhy::SetSlot | ( | Time | slot | ) |
Set the slot duration for this PHY.
slot | the slot duration |
Definition at line 780 of file wifi-phy.cc.
References m_slot.
Referenced by Configure80211a(), Configure80211b(), Configure80211p(), ns3::ApWifiMac::SendOneBeacon(), and ns3::StaWifiMac::UpdateApInfo().
void ns3::WifiPhy::SetTxGain | ( | double | gain | ) |
Sets the transmission gain (dB).
gain | the transmission gain in dB |
Definition at line 561 of file wifi-phy.cc.
References m_txGainDb, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::WifiPhy::SetTxPowerEnd | ( | double | end | ) |
Sets the maximum available transmission power level (dBm).
end | the maximum transmission power level (dBm) |
Definition at line 535 of file wifi-phy.cc.
References m_txPowerEndDbm, and NS_LOG_FUNCTION.
Referenced by GetTypeId(), InterferenceExperiment::Run(), and WifiPhyCcaIndicationTest::SendHeSuPpdu().
void ns3::WifiPhy::SetTxPowerStart | ( | double | start | ) |
Sets the minimum available transmission power level (dBm).
start | the minimum transmission power level (dBm) |
Definition at line 522 of file wifi-phy.cc.
References m_txPowerBaseDbm, NS_LOG_FUNCTION, and two-ray-to-three-gpp-ch-calibration::start.
Referenced by GetTypeId(), InterferenceExperiment::Run(), and WifiPhyCcaIndicationTest::SendHeSuPpdu().
void ns3::WifiPhy::SetWifiRadioEnergyModel | ( | const Ptr< WifiRadioEnergyModel > | wifiRadioEnergyModel | ) |
Sets the wifi radio energy model.
wifiRadioEnergyModel | the wifi radio energy model |
Definition at line 658 of file wifi-phy.cc.
References m_wifiRadioEnergyModel.
Referenced by ns3::WifiRadioEnergyModelHelper::DoInstall().
void ns3::WifiPhy::StartReceivePreamble | ( | Ptr< const WifiPpdu > | ppdu, |
RxPowerWattPerChannelBand & | rxPowersW, | ||
Time | rxDuration | ||
) |
Start receiving the PHY preamble of a PPDU (i.e.
the first bit of the preamble has arrived).
ppdu | the arriving PPDU |
rxPowersW | the receive power in W per band |
rxDuration | the duration of the PPDU |
Definition at line 1817 of file wifi-phy.cc.
References m_interference, m_phyEntities, NS_LOG_DEBUG, NS_LOG_FUNCTION, and SwitchMaybeToCcaBusy().
Referenced by ns3::SpectrumWifiPhy::StartRx().
ppdu | the PPDU to send |
Implemented in OfdmaSpectrumWifiPhy, ns3::YansWifiPhy, and ns3::SpectrumWifiPhy.
Referenced by Send().
Check if PHY state should move to CCA busy state based on current state of interference tracker.
ppdu | the incoming PPDU or nullptr for any signal |
Definition at line 2058 of file wifi-phy.cc.
References GetLatestPhyEntity(), and NS_LOG_FUNCTION.
Referenced by ns3::PhyEntity::DropPreambleEvent(), ns3::PhyEntity::EndReceiveField(), ns3::PhyEntity::EndReceivePayload(), ns3::PhyEntity::ErasePreambleEvent(), Reset(), ns3::PhyEntity::ResetReceive(), ResumeFromOff(), ResumeFromSleep(), ns3::PhyEntity::StartReceivePreamble(), StartReceivePreamble(), and ns3::SpectrumWifiPhy::StartRx().
void ns3::WifiPhy::UnregisterListener | ( | WifiPhyListener * | listener | ) |
listener | the listener to be unregistered |
Remove the input listener from the list of objects to be notified of PHY-level events.
Definition at line 460 of file wifi-phy.cc.
References m_state.
|
friend |
Definition at line 55 of file wifi-phy.h.
|
private |
estimated Ack TX time
Definition at line 1445 of file wifi-phy.h.
Referenced by Configure80211a(), Configure80211b(), Configure80211p(), and GetAckTxTime().
|
private |
WifiPhyBand.
Definition at line 1437 of file wifi-phy.h.
Referenced by Configure80211ax(), Configure80211n(), DoChannelSwitch(), and GetPhyBand().
|
private |
estimated BlockAck TX time
Definition at line 1446 of file wifi-phy.h.
Referenced by Configure80211n(), and GetBlockAckTxTime().
|
private |
Callback when PHY capabilities changed.
Definition at line 1487 of file wifi-phy.h.
Referenced by SetCapabilitiesChangedCallback(), SetMaxSupportedRxSpatialStreams(), and SetMaxSupportedTxSpatialStreams().
|
private |
Clear channel assessment (CCA) energy detection (ED) threshold in watts.
Definition at line 1449 of file wifi-phy.h.
Referenced by GetCcaEdThreshold(), and SetCcaEdThreshold().
|
private |
Clear channel assessment (CCA) modulation and coding rate sensitivity threshold in watts.
Definition at line 1451 of file wifi-phy.h.
Referenced by GetCcaSensitivityThreshold(), and SetCcaSensitivityThreshold().
|
private |
Flag if channels access has been requested (used for OBSS_PD SR)
Definition at line 1466 of file wifi-phy.h.
Referenced by EndReceiveInterBss(), GetDelayUntilChannelSwitch(), NotifyChannelAccessRequested(), Send(), SetOffMode(), and SetSleepMode().
|
private |
Store operating channel settings until initialization.
Definition at line 1438 of file wifi-phy.h.
Referenced by ConfigureStandard(), DoChannelSwitch(), and SetOperatingChannel().
|
private |
Time required to switch between channel.
Definition at line 1476 of file wifi-phy.h.
Referenced by GetChannelSwitchDelay(), and GetTypeId().
Hold the current event.
Definition at line 1219 of file wifi-phy.h.
Referenced by AbortCurrentReception(), ns3::PhyEntity::DoAbortCurrentReception(), DoDispose(), ns3::PhyEntity::DoEndReceivePayload(), ns3::PhyEntity::EndPreambleDetectionPeriod(), OfdmaSpectrumWifiPhy::GetCurrentEvent(), ns3::PhyEntity::GetCurrentEvent(), GetDelayUntilChannelSwitch(), Reset(), ResetCca(), ns3::PhyEntity::ResetReceive(), Send(), and ns3::PhyEntity::StartReceivePreamble().
|
protected |
store event associated to a PPDU (that has a unique ID and preamble combination) whose preamble is being received
Definition at line 1221 of file wifi-phy.h.
Referenced by AbortCurrentReception(), ns3::PhyEntity::AddPreambleEvent(), DoDispose(), ns3::PhyEntity::DoEndReceivePayload(), ns3::PhyEntity::DoEndReceivePreamble(), ns3::PhyEntity::DoGetEvent(), ns3::PhyEntity::DropPreambleEvent(), ns3::PhyEntity::EndPreambleDetectionPeriod(), ns3::PhyEntity::ErasePreambleEvent(), OfdmaSpectrumWifiPhy::GetCurrentPreambleEvents(), ns3::PhyEntity::GetCurrentPreambleEvents(), GetDelayUntilChannelSwitch(), Reset(), ns3::PhyEntity::ResetReceive(), ResumeFromSleep(), Send(), and ns3::PhyEntity::StartReceivePreamble().
|
private |
Pointer to the device.
Definition at line 1478 of file wifi-phy.h.
Referenced by DoChannelSwitch(), DoDispose(), DoInitialize(), GetDevice(), and SetDevice().
|
protected |
the end of PHY receive event
Definition at line 1216 of file wifi-phy.h.
Referenced by AbortCurrentReception(), DoDispose(), ns3::PhyEntity::EndPreambleDetectionPeriod(), ns3::PhyEntity::EndReceiveField(), GetDelayUntilChannelSwitch(), Send(), SetOffMode(), ns3::PhyEntity::StartReceiveField(), and ns3::PhyEntity::StartReceivePayload().
|
protected |
the end of transmit event
Definition at line 1217 of file wifi-phy.h.
Referenced by DoDispose(), Send(), and SetOffMode().
|
private |
True to prohibit changing PHY band after initialization.
Definition at line 1440 of file wifi-phy.h.
Referenced by DoChannelSwitch(), HasFixedPhyBand(), and SetFixedPhyBand().
|
private |
Frame capture model.
Definition at line 1481 of file wifi-phy.h.
Referenced by DoDispose(), GetTypeId(), SetFrameCaptureModel(), and ns3::PhyEntity::StartReceivePreamble().
|
protected |
Pointer to a helper responsible for interference computations.
Definition at line 1206 of file wifi-phy.h.
Referenced by AbortCurrentReception(), AssignStreams(), CalculateSnr(), ns3::PhyEntity::CreateInterferenceEvent(), DoChannelSwitch(), DoDispose(), ns3::PhyEntity::EndPreambleDetectionPeriod(), ns3::PhyEntity::EndReceivePayload(), ns3::PhyEntity::GetDelayUntilCcaEnd(), OfdmaSpectrumWifiPhy::GetEnergyDuration(), ns3::PhyEntity::GetPhyHeaderSnrPer(), ns3::PhyEntity::GetReceptionStatus(), ns3::PhyEntity::NotifyInterferenceRxEndAndClear(), ns3::PhyEntity::ResetReceive(), SetErrorRateModel(), SetInterferenceHelper(), ns3::YansWifiPhy::SetInterferenceHelper(), SetNumberOfAntennas(), SetRxNoiseFigure(), ns3::PhyEntity::StartPreambleDetectionPeriod(), StartReceivePreamble(), ns3::SpectrumWifiPhy::StartRx(), ns3::PhyEntity::UpdateInterferenceEvent(), and ns3::SpectrumWifiPhy::UpdateInterferenceHelperBands().
|
private |
Pointer to the mobility model.
Definition at line 1479 of file wifi-phy.h.
Referenced by DoDispose(), DoInitialize(), GetMobility(), and SetMobility().
|
private |
The noise figure in dB.
Definition at line 1474 of file wifi-phy.h.
Referenced by SetInterferenceHelper(), and SetRxNoiseFigure().
|
private |
Number of available transmission power levels.
Definition at line 1458 of file wifi-phy.h.
Referenced by GetNTxPower(), GetPowerDbm(), GetTypeId(), and SetNTxPower().
|
private |
Number of transmitters.
Definition at line 1470 of file wifi-phy.h.
Referenced by GetNumberOfAntennas(), SetInterferenceHelper(), and SetNumberOfAntennas().
|
private |
Operating channel.
Definition at line 1439 of file wifi-phy.h.
Referenced by ConfigureStandard(), DoChannelSwitch(), GetChannelNumber(), GetChannelWidth(), GetFrequency(), GetOperatingChannel(), GetPrimary20Index(), ns3::PhyEntity::GetPrimaryBand(), GetPrimaryChannelNumber(), and ns3::PhyEntity::GetSecondaryBand().
|
protected |
This map holds the supported PHY entities.
The set of parameters (e.g. mode) that this WifiPhy(-derived class) can support can be obtained through it.
When it comes to modes, in conversation we call this set the DeviceRateSet (not a term you'll find in the standard), and it is a superset of standard-defined parameters such as the OperationalRateSet, and the BSSBasicRateSet (which, themselves, have a superset/subset relationship).
Mandatory rates relevant to this WifiPhy can be found by iterating over the elements of this map, for each modulation class, looking for WifiMode objects for which WifiMode::IsMandatory() is true.
Definition at line 1244 of file wifi-phy.h.
Referenced by AbortCurrentReception(), AddPhyEntity(), ConfigureStandard(), DoDispose(), MuRtsCtsSpectrumWifiPhy::DoInitialize(), OfdmaSpectrumWifiPhy::DoInitialize(), ns3::PhyEntity::EndPreambleDetectionPeriod(), GetBssMembershipSelectorList(), GetDefaultMode(), GetDelayUntilChannelSwitch(), GetMcs(), GetMcsList(), GetModeList(), GetNMcs(), GetPhyEntity(), GetPhyEntityForPpdu(), IsMcsSupported(), IsModeSupported(), Reset(), Send(), SetMaxSupportedTxSpatialStreams(), SetOffMode(), and StartReceivePreamble().
|
private |
A trace source that emulates a Wi-Fi device in monitor mode sniffing a packet being received.
As a reference with the real world, firing this trace corresponds in the madwifi driver to calling the function ieee80211_input_monitor()
Definition at line 1406 of file wifi-phy.h.
Referenced by GetTypeId(), and NotifyMonitorSniffRx().
|
private |
A trace source that emulates a Wi-Fi device in monitor mode sniffing a packet being transmitted.
As a reference with the real world, firing this trace corresponds in the madwifi driver to calling the function ieee80211_input_monitor()
Definition at line 1425 of file wifi-phy.h.
Referenced by GetTypeId(), and NotifyMonitorSniffTx().
|
private |
The trace source fired when a packet begins the reception process from the medium.
Definition at line 1355 of file wifi-phy.h.
Referenced by GetTypeId(), and NotifyRxBegin().
|
private |
The trace source fired when the PHY layer drops a packet it has received.
Definition at line 1386 of file wifi-phy.h.
Referenced by GetTypeId(), and NotifyRxDrop().
|
private |
The trace source fired when a packet ends the reception process from the medium.
Definition at line 1379 of file wifi-phy.h.
Referenced by GetTypeId(), and NotifyRxEnd().
|
private |
The trace source fired when the reception of the PHY payload (PSDU) begins.
This traced callback models the behavior of the PHY-RXSTART primitive which is launched upon correct decoding of the PHY header and support of modes within. We thus assume that it is sent just before starting the decoding of the payload, since it's there that support of the header's content is checked. In addition, it's also at that point that the correct decoding of HT-SIG, VHT-SIGs, and HE-SIGs are checked.
Definition at line 1371 of file wifi-phy.h.
Referenced by ns3::PhyEntity::DoStartReceivePayload(), ns3::PhyEntity::EndReceiveField(), GetTypeId(), and ns3::PhyEntity::NotifyPayloadBegin().
|
private |
The trace source fired when a packet begins the transmission process on the medium.
Definition at line 1324 of file wifi-phy.h.
Referenced by GetTypeId(), and NotifyTxBegin().
|
private |
The trace source fired when the PHY layer drops a packet as it tries to transmit it.
Definition at line 1347 of file wifi-phy.h.
Referenced by GetTypeId(), and NotifyTxDrop().
|
private |
The trace source fired when a packet ends the transmission process on the medium.
Definition at line 1339 of file wifi-phy.h.
Referenced by GetTypeId(), and NotifyTxEnd().
|
private |
The trace source fired when a PSDU map begins the transmission process on the medium.
Definition at line 1331 of file wifi-phy.h.
Referenced by GetTypeId(), and Send().
|
private |
PCF Interframe Space (PIFS) duration.
Definition at line 1444 of file wifi-phy.h.
Referenced by GetPifs(), GetTypeId(), and SetPifs().
|
private |
Error model for receive packet events.
Definition at line 1484 of file wifi-phy.h.
Referenced by DoDispose(), ns3::PhyEntity::GetReceptionStatus(), GetTypeId(), and SetPostReceptionErrorModel().
|
private |
the power density limit (dBm/MHz)
Definition at line 1459 of file wifi-phy.h.
Referenced by GetTxPowerForTransmission(), and GetTypeId().
|
private |
Flag whether transmit power is restricted by OBSS PD SR.
Definition at line 1461 of file wifi-phy.h.
Referenced by EndReceiveInterBss(), GetDelayUntilChannelSwitch(), GetTxPowerForTransmission(), ResetCca(), Send(), SetOffMode(), and SetSleepMode().
|
private |
Preamble detection model.
Definition at line 1482 of file wifi-phy.h.
Referenced by DoDispose(), ns3::PhyEntity::EndPreambleDetectionPeriod(), GetTypeId(), and SetPreambleDetectionModel().
|
protected |
UID of the previously received PPDU, reset to UINT64_MAX upon transmission.
Definition at line 1224 of file wifi-phy.h.
Referenced by ns3::PhyEntity::EndReceivePayload(), GetPreviouslyRxPpduUid(), Send(), MuRtsCtsSpectrumWifiPhy::SetPpduUid(), OfdmaSpectrumWifiPhy::SetPpduUid(), and OfdmaSpectrumWifiPhy::SetTriggerFrameUid().
|
protected |
Provides uniform random variables.
Definition at line 1208 of file wifi-phy.h.
Referenced by WifiPhy(), AssignStreams(), DoDispose(), and ns3::PhyEntity::GetRandomValue().
|
private |
Reception gain (dB)
Definition at line 1455 of file wifi-phy.h.
Referenced by GetRxGain(), and SetRxGain().
|
protected |
A-MPDU reference number to identify all received subframes belonging to the same received A-MPDU.
Definition at line 1213 of file wifi-phy.h.
Referenced by NotifyMonitorSniffRx(), and NotifyMonitorSniffTx().
|
private |
Receive sensitivity threshold in watts.
Definition at line 1448 of file wifi-phy.h.
Referenced by GetRxSensitivity(), and SetRxSensitivity().
|
private |
Number of supported RX spatial streams.
Definition at line 1472 of file wifi-phy.h.
Referenced by GetMaxSupportedRxSpatialStreams(), and SetMaxSupportedRxSpatialStreams().
|
private |
Flag if short PHY preamble is supported.
Definition at line 1469 of file wifi-phy.h.
Referenced by GetShortPhyPreambleSupported(), and SetShortPhyPreambleSupported().
|
private |
Short Interframe Space (SIFS) duration.
Definition at line 1442 of file wifi-phy.h.
Referenced by GetSifs(), GetTypeId(), and SetSifs().
|
private |
Slot duration.
Definition at line 1443 of file wifi-phy.h.
Referenced by GetSlot(), GetTypeId(), and SetSlot().
|
private |
WifiStandard.
Definition at line 1436 of file wifi-phy.h.
Referenced by ConfigureStandard(), DoChannelSwitch(), GetLatestPhyEntity(), GetPrimaryChannelNumber(), GetStandard(), and SetOperatingChannel().
|
protected |
Pointer to WifiPhyStateHelper.
Definition at line 1209 of file wifi-phy.h.
Referenced by WifiPhy(), AbortCurrentReception(), DoChannelSwitch(), DoDispose(), GetDelayUntilChannelSwitch(), GetDelayUntilIdle(), GetLastRxEndTime(), GetLastRxStartTime(), GetState(), GetTypeId(), IsStateCcaBusy(), IsStateIdle(), IsStateOff(), IsStateRx(), IsStateSleep(), IsStateSwitching(), IsStateTx(), RegisterListener(), ResumeFromOff(), ResumeFromSleep(), Send(), SetOffMode(), ns3::PhyEntity::SetOwner(), SetReceiveErrorCallback(), SetReceiveOkCallback(), SetSleepMode(), and UnregisterListener().
|
private |
Record the time the last preamble was detected.
Definition at line 1485 of file wifi-phy.h.
Referenced by ns3::PhyEntity::EndPreambleDetectionPeriod(), and ns3::PhyEntity::StartReceivePreamble().
|
private |
Transmission gain (dB)
Definition at line 1454 of file wifi-phy.h.
Referenced by GetTxGain(), and SetTxGain().
|
protected |
A-MPDU reference number to identify all transmitted subframes belonging to the same received A-MPDU.
Definition at line 1211 of file wifi-phy.h.
|
private |
Minimum transmission power (dBm)
Definition at line 1456 of file wifi-phy.h.
Referenced by GetPowerDbm(), GetTxPowerStart(), and SetTxPowerStart().
|
private |
Maximum transmission power (dBm)
Definition at line 1457 of file wifi-phy.h.
Referenced by GetPowerDbm(), GetTxPowerEnd(), and SetTxPowerEnd().
|
private |
MIMO maximum transmit power due to OBSS PD SR power restriction (dBm)
Definition at line 1465 of file wifi-phy.h.
Referenced by GetTxPowerForTransmission(), and ResetCca().
|
private |
SISO maximum transmit power due to OBSS PD SR power restriction (dBm)
Definition at line 1463 of file wifi-phy.h.
Referenced by GetTxPowerForTransmission(), and ResetCca().
|
private |
Number of supported TX spatial streams.
Definition at line 1471 of file wifi-phy.h.
Referenced by Configure80211n(), GetMaxSupportedTxSpatialStreams(), and SetMaxSupportedTxSpatialStreams().
|
private |
Wifi radio energy model.
Definition at line 1483 of file wifi-phy.h.
Referenced by DoDispose(), Send(), and SetWifiRadioEnergyModel().