802.11 PHY layer model More...

#include "spectrum-wifi-phy.h"

Inheritance diagram for ns3::SpectrumWifiPhy:

Collaboration diagram for ns3::SpectrumWifiPhy:

Public Types
typedef void(*	SignalArrivalCallback) (bool signalType, uint32_t senderNodeId, double rxPower, Time duration)
	Callback invoked when the PHY model starts to process a signal. More...

Public Types inherited from ns3::WifiPhy
using	ChannelTuple = std::tuple< uint8_t, uint16_t, WifiPhyBand, 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
	SpectrumWifiPhy ()

	~SpectrumWifiPhy () override

void	AddChannel (const Ptr< SpectrumChannel > channel, const FrequencyRange &freqRange=WHOLE_WIFI_SPECTRUM)
	Attach a SpectrumChannel to use for a given frequency range. More...

void	ConfigureInterface (uint16_t frequency, uint16_t width)
	Configure a non-active spectrum PHY interface to operate on a given frequency with a given width. More...

WifiSpectrumBandFrequencies	ConvertIndicesToFrequencies (const WifiSpectrumBandIndices &indices) const override
	This is a helper function to convert start and stop indices to start and stop frequencies. More...

Ptr< AntennaModel >	GetAntenna () const
	Get the antenna model used for reception. More...

WifiSpectrumBandInfo	GetBand (uint16_t bandWidth, uint8_t bandIndex=0) override
	Get the info of a given band. More...

Ptr< Channel >	GetChannel () const override
	Return the Channel this WifiPhy is connected to. More...

FrequencyRange	GetCurrentFrequencyRange () const override
	Get the frequency range of the current RF interface. More...

Ptr< WifiSpectrumPhyInterface >	GetCurrentInterface () const
	Get the currently active spectrum PHY interface. More...

uint16_t	GetGuardBandwidth (uint16_t currentChannelWidth) const override

Ptr< const WifiPpdu >	GetRxPpduFromTxPpdu (Ptr< const WifiPpdu > ppdu)
	Determine the WifiPpdu to be used by the RX PHY based on the WifiPpdu sent by the TX PHY. More...

const std::map< FrequencyRange, Ptr< WifiSpectrumPhyInterface > > &	GetSpectrumPhyInterfaces () const
	Get the map of interfaces attached to this spectrum PHY. More...

std::tuple< double, double, double >	GetTxMaskRejectionParams () const override

void	SetAntenna (const Ptr< AntennaModel > antenna)

void	SetChannelSwitchedCallback (Callback< void > callback)

void	SetDevice (const Ptr< WifiNetDevice > device) override
	Sets the device this PHY is associated with. More...

void	StartRx (Ptr< SpectrumSignalParameters > rxParams, Ptr< const WifiSpectrumPhyInterface > interface)
	Input method for delivering a signal from the spectrum channel and low-level PHY interface to this SpectrumWifiPhy instance. More...

void	StartTx (Ptr< const WifiPpdu > ppdu) override

void	Transmit (Ptr< WifiSpectrumSignalParameters > txParams)
	This function is sending the signal to the Spectrum channel after finishing the configuration of the transmit parameters. More...

Public Member Functions inherited from ns3::WifiPhy
	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...

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...

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...

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

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...

WifiModulationClass	GetMaxModulationClassSupported () const

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...

uint32_t	GetSubcarrierSpacing () const

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...

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	IsReceivingPhyHeader () const

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 (const std::shared_ptr< 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	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	SetMaxModulationClassSupported (WifiModulationClass modClass)
	Set the maximum modulation class that has to be supported by this PHY object. 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	SetOperatingChannel (const WifiPhyOperatingChannel &channel)
	If the standard for this object has not been set yet, store the channel settings corresponding to the given operating channel. 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	SetPreviouslyRxPpduUid (uint64_t uid)
	Set the UID of the previously received PPDU. 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...

void	UnregisterListener (const std::shared_ptr< WifiPhyListener > &listener)

Public Member Functions inherited from ns3::Object
	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...

Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
	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...

Public Member Functions inherited from ns3::ObjectBase
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 TypeId	GetTypeId ()
	Get the type ID. More...

Static Public Member Functions inherited from ns3::WifiPhy
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 Public Member Functions inherited from ns3::Object
static TypeId	GetTypeId ()
	Register this type. More...

Static Public Member Functions inherited from ns3::ObjectBase
static TypeId	GetTypeId ()
	Get the type ID. More...

Protected Member Functions
void	DoChannelSwitch () override
	Actually switch channel based on the stored channel settings. More...

void	DoDispose () override
	Destructor implementation. More...

void	DoInitialize () override
	Initialize() implementation. More...

Protected Member Functions inherited from ns3::WifiPhy
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...

void	DoDispose () override
	Destructor implementation. More...

void	DoInitialize () override
	Initialize() implementation. More...

std::optional< 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=nullptr)
	Check if PHY state should move to CCA busy state based on current state of interference tracker. More...

Protected Member Functions inherited from ns3::Object
	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...

Protected Member Functions inherited from ns3::ObjectBase
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< WifiSpectrumPhyInterface >	m_currentSpectrumPhyInterface
	The current Spectrum PHY interface (held for performance reasons) More...

std::map< FrequencyRange, Ptr< WifiSpectrumPhyInterface > >	m_spectrumPhyInterfaces
	Spectrum PHY interfaces. More...

Protected Attributes inherited from ns3::WifiPhy
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
bool	CanStartRx (Ptr< const WifiPpdu > ppdu) const
	Determine whether the PHY shall issue a PHY-RXSTART.indication primitive in response to a given PPDU. More...

WifiSpectrumBands	ComputeBands (Ptr< WifiSpectrumPhyInterface > spectrumPhyInterface)
	This function computes the bands that belong to a given spectrum PHY interface. More...

WifiSpectrumBandFrequencies	ConvertIndicesToFrequenciesForInterface (Ptr< WifiSpectrumPhyInterface > spectrumPhyInterface, const WifiSpectrumBandIndices &indices) const
	This is a helper function to convert start and stop indices to start and stop frequencies. More...

WifiSpectrumBandInfo	GetBandForInterface (Ptr< WifiSpectrumPhyInterface > spectrumPhyInterface, uint16_t bandWidth, uint8_t bandIndex=0)
	Get the info of a given band that belongs to a given spectrum PHY interface. More...

HeRuBands	GetHeRuBands (Ptr< WifiSpectrumPhyInterface > spectrumPhyInterface, uint16_t guardBandwidth)
	This function computes the RU bands that belong to a given spectrum PHY interface. More...

Ptr< WifiSpectrumPhyInterface >	GetInterfaceCoveringChannelBand (uint16_t frequency, uint16_t width) const
	Get the spectrum PHY interface that covers a band portion of the RF channel. More...

void	NotifyChannelSwitched ()
	Notify the spectrum channel has switched. More...

void	ResetSpectrumModel (Ptr< WifiSpectrumPhyInterface > spectrumPhyInterface, uint16_t centerFrequency, uint16_t channelWidth)
	Perform run-time spectrum model change. More...

void	UpdateInterferenceHelperBands (Ptr< WifiSpectrumPhyInterface > spectrumPhyInterface)
	This function is called to update the bands handled by the InterferenceHelper. More...

Private Attributes
Ptr< AntennaModel >	m_antenna
	antenna model More...

Callback< void >	m_channelSwitchedCallback
	Callback when channel switched. More...

bool	m_disableWifiReception
	forces this PHY to fail to sync on any signal More...

TracedCallback< bool, uint32_t, double, Time >	m_signalCb
	Signal callback. More...

bool	m_trackSignalsInactiveInterfaces
	flag whether signals coming from inactive spectrum PHY interfaces are tracked More...

double	m_txMaskInnerBandMinimumRejection
	The minimum rejection (in dBr) for the inner band of the transmit spectrum mask. More...

double	m_txMaskOuterBandMaximumRejection
	The maximum rejection (in dBr) for the outer band of the transmit spectrum mask. More...

double	m_txMaskOuterBandMinimumRejection
	The minimum rejection (in dBr) for the outer band of the transmit spectrum mask. More...

Friends
class	::SpectrumWifiPhyFilterTest
	allow SpectrumWifiPhyFilterTest class access More...

Additional Inherited Members
Related Functions inherited from ns3::ObjectBase
static TypeId	GetObjectIid ()
	Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More...

Detailed Description

802.11 PHY layer model

This PHY implements a spectrum-aware enhancement of the 802.11 SpectrumWifiPhy model.

This PHY model depends on a channel loss and delay model as provided by the ns3::SpectrumPropagationLossModel and ns3::PropagationDelayModel classes.

Definition at line 60 of file spectrum-wifi-phy.h.

Member Typedef Documentation

◆ SignalArrivalCallback

typedef void(* ns3::SpectrumWifiPhy::SignalArrivalCallback) (bool signalType, uint32_t senderNodeId, double rxPower, Time duration)

Callback invoked when the PHY model starts to process a signal.

Parameters

signalType	Whether signal is WiFi (true) or foreign (false)
senderNodeId	Node Id of the sender of the signal
rxPower	received signal power (dBm)
duration	Signal duration

Definition at line 132 of file spectrum-wifi-phy.h.

Constructor & Destructor Documentation

◆ SpectrumWifiPhy()

ns3::SpectrumWifiPhy::SpectrumWifiPhy ( )

Definition at line 95 of file spectrum-wifi-phy.cc.

References NS_LOG_FUNCTION.

◆ ~SpectrumWifiPhy()

ns3::SpectrumWifiPhy::~SpectrumWifiPhy ( )

override

Definition at line 102 of file spectrum-wifi-phy.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ AddChannel()

void ns3::SpectrumWifiPhy::AddChannel	(	const Ptr< SpectrumChannel >	channel,
		const FrequencyRange &	freqRange = `WHOLE_WIFI_SPECTRUM`
	)

Attach a SpectrumChannel to use for a given frequency range.

Parameters

channel	the SpectrumChannel to attach
freqRange	the frequency range, bounded by a minFrequency and a maxFrequency in MHz

Definition at line 232 of file spectrum-wifi-phy.cc.

References third::channel, ns3::WifiPhy::GetDevice(), m_spectrumPhyInterfaces, NS_ABORT_MSG_IF, and NS_LOG_FUNCTION.

Referenced by LargestIdlePrimaryChannelTest::DoRun(), SpectrumWifiPhyBasicTest::DoSetup(), SpectrumWifiPhyFilterTest::DoSetup(), TestNonHtDuplicatePhyReception::DoSetup(), TestMultipleCtsResponsesFromMuRts::DoSetup(), WifiPhyCcaThresholdsTest::DoSetup(), WifiPhyCcaIndicationTest::DoSetup(), TestDlMuMimoPhyTransmission::DoSetup(), TestUlMuMimoPhyTransmission::DoSetup(), TestDlOfdmaPhyTransmission::DoSetup(), TestDlOfdmaPhyPuncturing::DoSetup(), TestUlOfdmaPpduUid::DoSetup(), TestMultipleHeTbPreambles::DoSetup(), TestUlOfdmaPhyTransmission::DoSetup(), TestPhyPaddingExclusion::DoSetup(), WifiPhyReceptionTest::DoSetup(), TestUnsupportedBandwidthReception::DoSetup(), TestPrimary20CoveredByPpdu::DoSetup(), TestSpectrumChannelWithBandwidthFilter::DoSetup(), WifiPhyThresholdsTest::DoSetup(), and InterferenceExperiment::Run().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CanStartRx()

bool ns3::SpectrumWifiPhy::CanStartRx ( Ptr< const WifiPpdu > ppdu ) const

private

Determine whether the PHY shall issue a PHY-RXSTART.indication primitive in response to a given PPDU.

Parameters

ppdu the PPDU

Returns: true if the PHY shall issue a PHY-RXSTART.indication primitive in response to a PPDU, false otherwise

Definition at line 394 of file spectrum-wifi-phy.cc.

References ns3::WifiPhy::GetLatestPhyEntity().

Referenced by StartRx().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ComputeBands()

WifiSpectrumBands ns3::SpectrumWifiPhy::ComputeBands ( Ptr< WifiSpectrumPhyInterface > spectrumPhyInterface )

private

This function computes the bands that belong to a given spectrum PHY interface.

Parameters

spectrumPhyInterface the spectrum PHY interface to consider to compute the bands

Returns: the computed bands for the spectrum PHY interface

Definition at line 126 of file spectrum-wifi-phy.cc.

References GetBandForInterface(), and NS_LOG_FUNCTION.

Referenced by UpdateInterferenceHelperBands().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ConfigureInterface()

void ns3::SpectrumWifiPhy::ConfigureInterface	(	uint16_t	frequency,
		uint16_t	width
	)

Configure a non-active spectrum PHY interface to operate on a given frequency with a given width.

The function searches for the non-active PHY interface that operates on the frequency range corresponding to the spectrum portion specified by the caller. It takes care to configure the RX spectrum model of the PHY interface and to update the bands tracked in interference helper.

Parameters

frequency	the center frequency in MHz the PHY interface should use
width	the channel width in MHz the PHY interface should use

Definition at line 363 of file spectrum-wifi-phy.cc.

References GetInterfaceCoveringChannelBand(), m_currentSpectrumPhyInterface, m_trackSignalsInactiveInterfaces, NS_ABORT_MSG_IF, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ResetSpectrumModel().

Here is the call graph for this function:

◆ ConvertIndicesToFrequencies()

WifiSpectrumBandFrequencies ns3::SpectrumWifiPhy::ConvertIndicesToFrequencies ( const WifiSpectrumBandIndices & indices ) const

overridevirtual

This is a helper function to convert start and stop indices to start and stop frequencies.

Parameters

indices the start/stop indices to convert

Returns: the converted frequencies

Implements ns3::WifiPhy.

Definition at line 642 of file spectrum-wifi-phy.cc.

References ConvertIndicesToFrequenciesForInterface(), m_currentSpectrumPhyInterface, and NS_ABORT_IF.

Here is the call graph for this function:

◆ ConvertIndicesToFrequenciesForInterface()

WifiSpectrumBandFrequencies ns3::SpectrumWifiPhy::ConvertIndicesToFrequenciesForInterface	(	Ptr< WifiSpectrumPhyInterface >	spectrumPhyInterface,
		const WifiSpectrumBandIndices &	indices
	)		const

private

This is a helper function to convert start and stop indices to start and stop frequencies.

Parameters

spectrumPhyInterface	the spectrum PHY interface to consider for the calculations
indices	the start/stop indices to convert

Returns: the converted frequencies

Definition at line 649 of file spectrum-wifi-phy.cc.

References NS_ABORT_IF.

Referenced by ConvertIndicesToFrequencies(), GetBandForInterface(), and GetHeRuBands().

Here is the caller graph for this function:

◆ DoChannelSwitch()

void ns3::SpectrumWifiPhy::DoChannelSwitch ( )

overrideprotectedvirtual

Actually switch channel based on the stored channel settings.

Reimplemented from ns3::WifiPhy.

Definition at line 287 of file spectrum-wifi-phy.cc.

References ns3::WifiPhy::DoChannelSwitch(), ns3::WifiPhy::GetChannelWidth(), ns3::WifiPhy::GetFrequency(), GetInterfaceCoveringChannelBand(), ns3::WifiPhy::GetOperatingChannel(), ns3::Object::IsInitialized(), ns3::WifiPhyOperatingChannel::IsSet(), m_currentSpectrumPhyInterface, m_trackSignalsInactiveInterfaces, NotifyChannelSwitched(), NS_ABORT_MSG_IF, NS_LOG_DEBUG, NS_LOG_FUNCTION, ResetSpectrumModel(), ns3::Simulator::ScheduleNow(), and ns3::WifiPhy::SwitchMaybeToCcaBusy().

Here is the call graph for this function:

◆ DoDispose()

void ns3::SpectrumWifiPhy::DoDispose ( void )

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, MuMimoSpectrumWifiPhy, and MuRtsCtsSpectrumWifiPhy.

Definition at line 108 of file spectrum-wifi-phy.cc.

References ns3::WifiPhy::DoDispose(), m_antenna, m_channelSwitchedCallback, m_currentSpectrumPhyInterface, m_spectrumPhyInterfaces, NS_LOG_FUNCTION, and ns3::Callback< R, UArgs >::Nullify().

Here is the call graph for this function:

◆ DoInitialize()

void ns3::SpectrumWifiPhy::DoInitialize ( void )

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, MuMimoSpectrumWifiPhy, and MuRtsCtsSpectrumWifiPhy.

Definition at line 119 of file spectrum-wifi-phy.cc.

References ns3::WifiPhy::DoInitialize(), and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ GetAntenna()

Ptr< AntennaModel > ns3::SpectrumWifiPhy::GetAntenna ( ) const

Get the antenna model used for reception.

Returns: the AntennaModel used for reception

Definition at line 539 of file spectrum-wifi-phy.cc.

References m_antenna.

Referenced by ns3::WifiSpectrumPhyInterface::GetAntenna(), and ns3::WifiSpectrumPhyInterface::StartTx().

Here is the caller graph for this function:

◆ GetBand()

WifiSpectrumBandInfo ns3::SpectrumWifiPhy::GetBand	(	uint16_t	bandWidth,
		uint8_t	bandIndex = `0`
	)

overridevirtual

Get the info of a given band.

Parameters

bandWidth	the width of the band to be returned (MHz)
bandIndex	the index of the band to be returned

Returns: the info that defines the band

Implements ns3::WifiPhy.

Definition at line 635 of file spectrum-wifi-phy.cc.

References GetBandForInterface(), m_currentSpectrumPhyInterface, and NS_ABORT_IF.

Referenced by SpectrumWifiPhyFilterTest::RxCallback().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetBandForInterface()

WifiSpectrumBandInfo ns3::SpectrumWifiPhy::GetBandForInterface	(	Ptr< WifiSpectrumPhyInterface >	spectrumPhyInterface,
		uint16_t	bandWidth,
		uint8_t	bandIndex = `0`
	)

private

Get the info of a given band that belongs to a given spectrum PHY interface.

Parameters

spectrumPhyInterface	the spectrum PHY interface
bandWidth	the width of the band to be returned (MHz)
bandIndex	the index of the band to be returned

Returns: the info that defines the band

Definition at line 600 of file spectrum-wifi-phy.cc.

References ConvertIndicesToFrequenciesForInterface(), two-ray-to-three-gpp-ch-calibration::frequencies, ns3::WifiPhy::GetSubcarrierSpacing(), NS_ASSERT, and NS_ASSERT_MSG.

Referenced by ComputeBands(), and GetBand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetChannel()

Ptr< Channel > ns3::SpectrumWifiPhy::GetChannel ( ) const

overridevirtual

Return the Channel this WifiPhy is connected to.

Returns: the Channel this WifiPhy is connected to

Implements ns3::WifiPhy.

Definition at line 225 of file spectrum-wifi-phy.cc.

References m_currentSpectrumPhyInterface, and NS_ABORT_IF.

◆ GetCurrentFrequencyRange()

FrequencyRange ns3::SpectrumWifiPhy::GetCurrentFrequencyRange ( ) const

overridevirtual

Get the frequency range of the current RF interface.

Returns: the frequency range of the current RF interface

Implements ns3::WifiPhy.

Definition at line 672 of file spectrum-wifi-phy.cc.

References m_currentSpectrumPhyInterface, and NS_ABORT_IF.

◆ GetCurrentInterface()

Ptr< WifiSpectrumPhyInterface > ns3::SpectrumWifiPhy::GetCurrentInterface ( ) const

Get the currently active spectrum PHY interface.

Returns: the current spectrum PHY interface

Definition at line 703 of file spectrum-wifi-phy.cc.

References m_currentSpectrumPhyInterface.

◆ GetGuardBandwidth()

uint16_t ns3::SpectrumWifiPhy::GetGuardBandwidth ( uint16_t currentChannelWidth ) const

overridevirtual

Parameters

currentChannelWidth channel width of the current transmission (MHz)

Returns: the width of the guard band (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.

Implements ns3::WifiPhy.

Definition at line 578 of file spectrum-wifi-phy.cc.

Referenced by ResetSpectrumModel(), SpectrumWifiPhyFilterTest::RunOne(), TestMultipleHeTbPreambles::RxHeTbPpdu(), and UpdateInterferenceHelperBands().

Here is the caller graph for this function:

◆ GetHeRuBands()

HeRuBands ns3::SpectrumWifiPhy::GetHeRuBands	(	Ptr< WifiSpectrumPhyInterface >	spectrumPhyInterface,
		uint16_t	guardBandwidth
	)

private

This function computes the RU bands that belong to a given spectrum PHY interface.

Parameters

spectrumPhyInterface	the spectrum PHY interface to consider to compute the RU bands
guardBandwidth	width of the guard band in MHz

Returns: the computed RU bands for the spectrum PHY interface

Definition at line 149 of file spectrum-wifi-phy.cc.

References ns3::HePhy::ConvertHeRuSubcarriers(), ConvertIndicesToFrequenciesForInterface(), ns3::HeRu::GetNRus(), ns3::WifiPhy::GetOperatingChannel(), ns3::HeRu::RuSpec::GetPhyIndex(), ns3::WifiPhyOperatingChannel::GetPrimaryChannelIndex(), ns3::HeRu::GetSubcarrierGroup(), ns3::WifiPhy::GetSubcarrierSpacing(), NS_ABORT_IF, ns3::HeRu::RU_2x996_TONE, and check-style-clang-format::type.

Referenced by StartRx(), and UpdateInterferenceHelperBands().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetInterfaceCoveringChannelBand()

Ptr< WifiSpectrumPhyInterface > ns3::SpectrumWifiPhy::GetInterfaceCoveringChannelBand	(	uint16_t	frequency,
		uint16_t	width
	)		const

private

Get the spectrum PHY interface that covers a band portion of the RF channel.

Parameters

frequency	the center frequency in MHz of the RF channel band
width	the width in MHz of the RF channel band

Returns: the spectrum PHY interface that covers the indicated band of the RF channel

Definition at line 685 of file spectrum-wifi-phy.cc.

References m_spectrumPhyInterfaces.

Referenced by ConfigureInterface(), and DoChannelSwitch().

Here is the caller graph for this function:

◆ GetRxPpduFromTxPpdu()

Ptr< const WifiPpdu > ns3::SpectrumWifiPhy::GetRxPpduFromTxPpdu ( Ptr< const WifiPpdu > ppdu )

Determine the WifiPpdu to be used by the RX PHY based on the WifiPpdu sent by the TX PHY.

Parameters

ppdu	the WifiPpdu transmitted by the TX PHY

Returns: the WifiPpdu to be used by the RX PHY

Definition at line 533 of file spectrum-wifi-phy.cc.

References ns3::WifiPhy::GetPhyEntityForPpdu().

Referenced by StartRx().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetSpectrumPhyInterfaces()

const std::map< FrequencyRange, Ptr< WifiSpectrumPhyInterface > > & ns3::SpectrumWifiPhy::GetSpectrumPhyInterfaces ( ) const

Get the map of interfaces attached to this spectrum PHY.

Returns: the map of interfaces attached to this spectrum PHY

Definition at line 679 of file spectrum-wifi-phy.cc.

References m_spectrumPhyInterfaces.

◆ GetTxMaskRejectionParams()

std::tuple< double, double, double > ns3::SpectrumWifiPhy::GetTxMaskRejectionParams ( ) const

overridevirtual

Returns: a tuple containing the minimum rejection (in dBr) for the inner band, the minimum rejection (in dBr) for the outer band, and the maximum rejection (in dBr) for the outer band for the transmit spectrum mask.

This method is only relevant for SpectrumWifiPhy.

Implements ns3::WifiPhy.

Definition at line 664 of file spectrum-wifi-phy.cc.

References m_txMaskInnerBandMinimumRejection, m_txMaskOuterBandMaximumRejection, and m_txMaskOuterBandMinimumRejection.

◆ GetTypeId()

TypeId ns3::SpectrumWifiPhy::GetTypeId ( void )

static

Get the type ID.

Returns: the object TypeId

Definition at line 52 of file spectrum-wifi-phy.cc.

References m_disableWifiReception, m_signalCb, m_trackSignalsInactiveInterfaces, m_txMaskInnerBandMinimumRejection, m_txMaskOuterBandMaximumRejection, m_txMaskOuterBandMinimumRejection, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakeDoubleAccessor(), ns3::MakeTraceSourceAccessor(), and ns3::TypeId::SetParent().

Here is the call graph for this function:

◆ NotifyChannelSwitched()

void ns3::SpectrumWifiPhy::NotifyChannelSwitched ( )

private

Notify the spectrum channel has switched.

Definition at line 354 of file spectrum-wifi-phy.cc.

References ns3::Callback< R, UArgs >::IsNull(), and m_channelSwitchedCallback.

Referenced by DoChannelSwitch().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ResetSpectrumModel()

void ns3::SpectrumWifiPhy::ResetSpectrumModel	(	Ptr< WifiSpectrumPhyInterface >	spectrumPhyInterface,
		uint16_t	centerFrequency,
		uint16_t	channelWidth
	)

private

Perform run-time spectrum model change.

Parameters

spectrumPhyInterface	the spectrum PHY interface for which the spectrum model should be changed
centerFrequency	the center frequency in MHz the PHY interface should use
channelWidth	the channel width in MHz the PHY interface should use

Definition at line 261 of file spectrum-wifi-phy.cc.

References GetGuardBandwidth(), ns3::WifiPhy::GetSubcarrierSpacing(), NS_LOG_FUNCTION, and UpdateInterferenceHelperBands().

Referenced by ConfigureInterface(), and DoChannelSwitch().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetAntenna()

void ns3::SpectrumWifiPhy::SetAntenna ( const Ptr< AntennaModel > antenna )

Parameters

antenna an AntennaModel to include in the transmitted SpectrumSignalParameters (in case any objects downstream of the SpectrumWifiPhy wish to adjust signal properties based on the transmitted antenna model. This antenna is also used when the underlying WifiSpectrumPhyInterface::GetAntenna() method is called.

Note: this method may be split into separate SetTx and SetRx methods in the future if the modeling need for this arises

Definition at line 545 of file spectrum-wifi-phy.cc.

References m_antenna, and NS_LOG_FUNCTION.

◆ SetChannelSwitchedCallback()

void ns3::SpectrumWifiPhy::SetChannelSwitchedCallback ( Callback< void > callback )

Parameters

callback the callback to invoke when operating channel has switched.

Definition at line 709 of file spectrum-wifi-phy.cc.

References m_channelSwitchedCallback.

◆ SetDevice()

void ns3::SpectrumWifiPhy::SetDevice ( const Ptr< WifiNetDevice > device )

overridevirtual

Sets the device this PHY is associated with.

Parameters

device the device this PHY is associated with

Reimplemented from ns3::WifiPhy.

Definition at line 552 of file spectrum-wifi-phy.cc.

References m_spectrumPhyInterfaces, NS_LOG_FUNCTION, and ns3::WifiPhy::SetDevice().

Referenced by SpectrumWifiPhyBasicTest::DoSetup(), SpectrumWifiPhyFilterTest::DoSetup(), TestNonHtDuplicatePhyReception::DoSetup(), TestMultipleCtsResponsesFromMuRts::DoSetup(), WifiPhyCcaThresholdsTest::DoSetup(), WifiPhyCcaIndicationTest::DoSetup(), TestDlMuMimoPhyTransmission::DoSetup(), TestUlMuMimoPhyTransmission::DoSetup(), TestDlOfdmaPhyTransmission::DoSetup(), TestDlOfdmaPhyPuncturing::DoSetup(), TestUlOfdmaPpduUid::DoSetup(), TestMultipleHeTbPreambles::DoSetup(), TestUlOfdmaPhyTransmission::DoSetup(), TestPhyPaddingExclusion::DoSetup(), WifiPhyReceptionTest::DoSetup(), TestUnsupportedBandwidthReception::DoSetup(), TestSpectrumChannelWithBandwidthFilter::DoSetup(), WifiPhyThresholdsTest::DoSetup(), and InterferenceExperiment::Run().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ StartRx()

void ns3::SpectrumWifiPhy::StartRx	(	Ptr< SpectrumSignalParameters >	rxParams,
		Ptr< const WifiSpectrumPhyInterface >	interface
	)

Input method for delivering a signal from the spectrum channel and low-level PHY interface to this SpectrumWifiPhy instance.

Parameters

rxParams	Input signal parameters
interface	the Spectrum PHY interface for which the signal has been detected

Definition at line 400 of file spectrum-wifi-phy.cc.

References ns3::Time::As(), CanStartRx(), ns3::DbmToW(), ns3::DbToRatio(), ns3::SpectrumSignalParameters::duration, ns3::WifiSpectrumValueHelper::GetBandPowerW(), ns3::WifiPhy::GetChannelWidth(), ns3::SpectrumPhy::GetDevice(), GetHeRuBands(), ns3::WifiPhy::GetRxGain(), GetRxPpduFromTxPpdu(), ns3::WifiPhy::GetRxSensitivity(), ns3::WifiPhy::GetStandard(), ns3::Integral(), m_currentSpectrumPhyInterface, m_disableWifiReception, ns3::WifiPhy::m_interference, m_signalCb, m_trackSignalsInactiveInterfaces, ns3::Time::NS, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, NS_LOG_INFO, ns3::SpectrumSignalParameters::psd, ns3::WifiPhy::StartReceivePreamble(), ns3::WifiPhy::SwitchMaybeToCcaBusy(), ns3::SpectrumSignalParameters::txPhy, ns3::WIFI_STANDARD_80211ax, and ns3::WToDbm().

Referenced by TestMultipleHeTbPreambles::DoRxHeTbPpduOfdmaPart(), TestMultipleHeTbPreambles::RxHeTbPpdu(), TestAmpduReception::SendAmpduWithThreeMpdus(), WifiPhyReceptionTest::SendPacket(), TestUnsupportedBandwidthReception::SendPpdu(), SpectrumWifiPhyBasicTest::SendSignal(), WifiPhyThresholdsTest::SendSignal(), and ns3::WifiSpectrumPhyInterface::StartRx().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ StartTx()

void ns3::SpectrumWifiPhy::StartTx ( Ptr< const WifiPpdu > ppdu )

overridevirtual

Parameters

ppdu	the PPDU to send

Implements ns3::WifiPhy.

Reimplemented in OfdmaSpectrumWifiPhy.

Definition at line 563 of file spectrum-wifi-phy.cc.

References ns3::WifiPhy::GetPhyEntity(), and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ Transmit()

void ns3::SpectrumWifiPhy::Transmit ( Ptr< WifiSpectrumSignalParameters > txParams )

This function is sending the signal to the Spectrum channel after finishing the configuration of the transmit parameters.

Parameters

txParams the parameters to be provided to the Spectrum channel

Definition at line 570 of file spectrum-wifi-phy.cc.

References m_currentSpectrumPhyInterface, NS_ABORT_IF, and NS_LOG_FUNCTION.

◆ UpdateInterferenceHelperBands()

void ns3::SpectrumWifiPhy::UpdateInterferenceHelperBands ( Ptr< WifiSpectrumPhyInterface > spectrumPhyInterface )

private

This function is called to update the bands handled by the InterferenceHelper.

Parameters

spectrumPhyInterface the spectrum PHY interface for which the bands should be updated

Definition at line 193 of file spectrum-wifi-phy.cc.

References ComputeBands(), GetGuardBandwidth(), GetHeRuBands(), ns3::WifiPhy::GetStandard(), ns3::WifiPhy::m_interference, NS_LOG_FUNCTION, and ns3::WIFI_STANDARD_80211ax.

Referenced by ResetSpectrumModel().

Here is the call graph for this function:

Here is the caller graph for this function:

Friends And Related Function Documentation

◆ ::SpectrumWifiPhyFilterTest

friend class ::SpectrumWifiPhyFilterTest

friend

allow SpectrumWifiPhyFilterTest class access

Definition at line 64 of file spectrum-wifi-phy.h.

Member Data Documentation

◆ m_antenna

Ptr<AntennaModel> ns3::SpectrumWifiPhy::m_antenna

private

antenna model

Definition at line 283 of file spectrum-wifi-phy.h.

Referenced by DoDispose(), GetAntenna(), and SetAntenna().

◆ m_channelSwitchedCallback

Callback<void> ns3::SpectrumWifiPhy::m_channelSwitchedCallback

private

Callback when channel switched.

Definition at line 298 of file spectrum-wifi-phy.h.

Referenced by DoDispose(), NotifyChannelSwitched(), and SetChannelSwitchedCallback().

◆ m_currentSpectrumPhyInterface

Ptr<WifiSpectrumPhyInterface> ns3::SpectrumWifiPhy::m_currentSpectrumPhyInterface

protected

The current Spectrum PHY interface (held for performance reasons)

Definition at line 196 of file spectrum-wifi-phy.h.

Referenced by ConfigureInterface(), ConvertIndicesToFrequencies(), DoChannelSwitch(), DoDispose(), GetBand(), GetChannel(), GetCurrentFrequencyRange(), GetCurrentInterface(), StartRx(), and Transmit().

◆ m_disableWifiReception

bool ns3::SpectrumWifiPhy::m_disableWifiReception

private

forces this PHY to fail to sync on any signal

Definition at line 285 of file spectrum-wifi-phy.h.

Referenced by GetTypeId(), and StartRx().

◆ m_signalCb

TracedCallback<bool, uint32_t, double, Time> ns3::SpectrumWifiPhy::m_signalCb

private

Signal callback.

Definition at line 289 of file spectrum-wifi-phy.h.

Referenced by GetTypeId(), and StartRx().

◆ m_spectrumPhyInterfaces

std::map<FrequencyRange, Ptr<WifiSpectrumPhyInterface> > ns3::SpectrumWifiPhy::m_spectrumPhyInterfaces

protected

Spectrum PHY interfaces.

Definition at line 193 of file spectrum-wifi-phy.h.

Referenced by AddChannel(), DoDispose(), GetInterfaceCoveringChannelBand(), GetSpectrumPhyInterfaces(), and SetDevice().

◆ m_trackSignalsInactiveInterfaces

bool ns3::SpectrumWifiPhy::m_trackSignalsInactiveInterfaces

private

flag whether signals coming from inactive spectrum PHY interfaces are tracked

Definition at line 286 of file spectrum-wifi-phy.h.

Referenced by ConfigureInterface(), DoChannelSwitch(), GetTypeId(), and StartRx().

◆ m_txMaskInnerBandMinimumRejection

double ns3::SpectrumWifiPhy::m_txMaskInnerBandMinimumRejection

private

The minimum rejection (in dBr) for the inner band of the transmit spectrum mask.

Definition at line 291 of file spectrum-wifi-phy.h.

Referenced by GetTxMaskRejectionParams(), and GetTypeId().

◆ m_txMaskOuterBandMaximumRejection

double ns3::SpectrumWifiPhy::m_txMaskOuterBandMaximumRejection

private

The maximum rejection (in dBr) for the outer band of the transmit spectrum mask.

Definition at line 295 of file spectrum-wifi-phy.h.

Referenced by GetTxMaskRejectionParams(), and GetTypeId().

◆ m_txMaskOuterBandMinimumRejection

double ns3::SpectrumWifiPhy::m_txMaskOuterBandMinimumRejection

private

The minimum rejection (in dBr) for the outer band of the transmit spectrum mask.

Definition at line 293 of file spectrum-wifi-phy.h.

Referenced by GetTxMaskRejectionParams(), and GetTypeId().

The documentation for this class was generated from the following files:

src/wifi/model/spectrum-wifi-phy.h
src/wifi/model/spectrum-wifi-phy.cc

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ SignalArrivalCallback

Constructor & Destructor Documentation

◆ SpectrumWifiPhy()

◆ ~SpectrumWifiPhy()

Member Function Documentation

◆ AddChannel()

◆ CanStartRx()

◆ ComputeBands()

◆ ConfigureInterface()

◆ ConvertIndicesToFrequencies()

◆ ConvertIndicesToFrequenciesForInterface()

◆ DoChannelSwitch()

◆ DoDispose()

◆ DoInitialize()

◆ GetAntenna()

◆ GetBand()

◆ GetBandForInterface()

◆ GetChannel()

◆ GetCurrentFrequencyRange()

◆ GetCurrentInterface()

◆ GetGuardBandwidth()

◆ GetHeRuBands()

◆ GetInterfaceCoveringChannelBand()

◆ GetRxPpduFromTxPpdu()

◆ GetSpectrumPhyInterfaces()

◆ GetTxMaskRejectionParams()

◆ GetTypeId()

◆ NotifyChannelSwitched()

◆ ResetSpectrumModel()

◆ SetAntenna()

◆ SetChannelSwitchedCallback()

◆ SetDevice()

◆ StartRx()

◆ StartTx()

◆ Transmit()

◆ UpdateInterferenceHelperBands()

Friends And Related Function Documentation

◆ ::SpectrumWifiPhyFilterTest

Member Data Documentation

◆ m_antenna

◆ m_channelSwitchedCallback

◆ m_currentSpectrumPhyInterface

◆ m_disableWifiReception

◆ m_signalCb

◆ m_spectrumPhyInterfaces

◆ m_trackSignalsInactiveInterfaces

◆ m_txMaskInnerBandMinimumRejection

◆ m_txMaskOuterBandMaximumRejection

◆ m_txMaskOuterBandMinimumRejection