802.11 PHY layer model More...

#include "yans-wifi-phy.h"

Inheritance diagram for ns3::YansWifiPhy:

Collaboration diagram for ns3::YansWifiPhy:

Public Member Functions
	YansWifiPhy ()

virtual	~YansWifiPhy ()

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

uint16_t	GetGuardBandwidth (uint16_t currentChannelWidth) const override

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

void	SetChannel (const Ptr< YansWifiChannel > channel)
	Set the YansWifiChannel this YansWifiPhy is to be connected to. More...

void	StartTx (Ptr< WifiPpdu > ppdu) override

Public Member Functions inherited from ns3::WifiPhy
	WifiPhy ()

virtual	~WifiPhy ()

void	AddSupportedChannelWidth (uint16_t width)

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	ConfigureStandardAndBand (WifiPhyStandard standard, WifiPhyBand band)
	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 (void)
	For HE receptions only, check and possibly modify the transmit power restriction state at the end of PPDU reception. More...

Time	GetAckTxTime (void) const
	Return the estimated Ack TX time for this PHY. More...

Time	GetBlockAckTxTime (void) const
	Return the estimated BlockAck TX time for this PHY. More...

std::list< uint8_t >	GetBssMembershipSelectorList (void) 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 (void) const
	Return the CCA threshold (dBm). More...

uint8_t	GetChannelNumber (void) const
	Return current channel number. More...

Time	GetChannelSwitchDelay (void) const

uint16_t	GetChannelWidth (void) const

WifiMode	GetDefaultMode (void) const
	Get the default WifiMode supported by the PHY. More...

Time	GetDelayUntilIdle (void)

Ptr< NetDevice >	GetDevice (void) const
	Return the device this PHY is associated with. More...

uint16_t	GetFrequency (void) const

Time	GetLastRxEndTime (void) const
	Return the end time of the last received packet. More...

Time	GetLastRxStartTime (void) const
	Return the start time of the last received packet. More...

uint8_t	GetMaxSupportedRxSpatialStreams (void) const

uint8_t	GetMaxSupportedTxSpatialStreams (void) 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 (void) 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 (void) const
	Return the mobility model this PHY is associated with. More...

std::list< WifiMode >	GetModeList (void) 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 (void) const

uint8_t	GetNTxPower (void) const
	Return the number of available transmission power levels. More...

uint8_t	GetNumberOfAntennas (void) const

const WifiPhyOperatingChannel &	GetOperatingChannel (void) const
	Get a const reference to the operating channel. More...

WifiPhyBand	GetPhyBand (void) const
	Get the configured Wi-Fi band. More...

Ptr< PhyEntity >	GetPhyEntity (WifiModulationClass modulation) const
	Get the supported PHY entity corresponding to the modulation class, for the WifiPhy instance. More...

WifiPhyStandard	GetPhyStandard (void) const
	Get the configured Wi-Fi standard. More...

Time	GetPifs (void) 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 (void) const

double	GetRxGain (void) const
	Return the reception gain (dB). More...

double	GetRxSensitivity (void) const
	Return the receive sensitivity threshold (dBm). More...

bool	GetShortPhyPreambleSupported (void) const
	Return whether short PHY preamble is supported. More...

Time	GetSifs (void) const
	Return the Short Interframe Space (SIFS) for this PHY. More...

Time	GetSlot (void) const
	Return the slot duration for this PHY. More...

Ptr< WifiPhyStateHelper >	GetState (void) const
	Return the WifiPhyStateHelper of this PHY. More...

std::vector< uint16_t >	GetSupportedChannelWidthSet (void) const

double	GetTxGain (void) const
	Return the transmission gain (dB). More...

double	GetTxPowerEnd (void) 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 (void) const
	Return the minimum available transmission power level (dBm). More...

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

bool	IsStateIdle (void) const

bool	IsStateOff (void) const

bool	IsStateRx (void) const

bool	IsStateSleep (void) const

bool	IsStateSwitching (void) const

bool	IsStateTx (void) const

void	NotifyChannelAccessRequested (void)
	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, 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	ResetReceive (Ptr< Event > event)
	Reset PHY at the end of the packet under reception after it has failed the PHY header. More...

void	ResumeFromOff (void)
	Resume from off mode. More...

void	ResumeFromSleep (void)
	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, WifiTxVector txVector)

void	SetCapabilitiesChangedCallback (Callback< void > callback)

void	SetCcaEdThreshold (double threshold)
	Sets the CCA threshold (dBm). More...

virtual void	SetChannelNumber (uint8_t id)
	Set channel number. More...

virtual void	SetChannelWidth (uint16_t channelWidth)
	If the operating channel for this object has not been set yet, the given channel width is saved and will be used, along with the center frequency and channel number that have been saved similarly, to set the operating channel when the standard and band are configured. More...

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

void	SetErrorRateModel (const Ptr< ErrorRateModel > rate)
	Sets the error rate model. More...

void	SetFrameCaptureModel (const Ptr< FrameCaptureModel > frameCaptureModel)
	Sets the frame capture model. More...

virtual void	SetFrequency (uint16_t freq)
	If the operating channel for this object has not been set yet, the given center frequency is saved and will be used, along with the channel number and width that have been saved similarly, to set the operating channel when the standard and band are configured. 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 (void)
	Put in off mode. More...

void	SetOperatingChannel (uint8_t number, uint16_t frequency, uint16_t width)
	Set the operating channel according to the specified parameters. 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	SetPrimary20Index (uint8_t index)
	Set the index of the primary 20 MHz channel (0 indicates the 20 MHz subchannel with the lowest center frequency). 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 (void)
	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< WifiPpdu > ppdu, RxPowerWattPerChannelBand rxPowersW, Time rxDuration)
	Start receiving the PHY preamble of a PPDU (i.e. More...

void	UnregisterListener (WifiPhyListener *listener)

Public Member Functions inherited from ns3::Object
	Object ()
	Constructor. More...

virtual	~Object ()
	Destructor. More...

void	AggregateObject (Ptr< Object > other)
	Aggregate two Objects together. More...

void	Dispose (void)
	Dispose of this Object. More...

AggregateIterator	GetAggregateIterator (void) const
	Get an iterator to the Objects aggregated to this one. More...

virtual TypeId	GetInstanceTypeId (void) const
	Get the most derived TypeId for this 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...

template<typename T >
Ptr< T >	GetObject (void) const
	Get a pointer to the requested aggregated Object. More...

void	Initialize (void)
	Invoke DoInitialize on all Objects aggregated to this one. More...

bool	IsInitialized (void) 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)
	Copy constructor. More...

uint32_t	GetReferenceCount (void) const
	Get the reference count of the object. More...

SimpleRefCount &	operator= (const SimpleRefCount &o)
	Assignment operator. More...

void	Ref (void) const
	Increment the reference count. More...

void	Unref (void) 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 erros. 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 (void)
	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 (void)

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 (void)
	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 (void)
	Register this type. More...

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

Protected Member Functions
void	DoDispose (void) override
	Destructor 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...

Time	DoChannelSwitch (void)
	Perform any actions necessary when user changes operating channel after initialization. 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...

uint16_t	GetMeasurementChannelWidth (const Ptr< const WifiPpdu > ppdu) const
	Return the channel width used to measure the RSSI. More...

WifiSpectrumBand	GetPrimaryBand (uint16_t bandWidth)
	If the operating channel width is a multiple of 20 MHz, return the start band index and the stop band index for the primary channel of the given bandwidth (which must be a multiple of 20 MHz and not exceed the operating channel width). More...

void	Reset (void)
	Reset data upon end of TX or RX. More...

void	SwitchMaybeToCcaBusy (uint16_t channelWidth)
	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	DoInitialize (void)
	Initialize() implementation. More...

virtual void	NotifyNewAggregate (void)
	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 (void)
	Notifier called once the ObjectBase is fully constructed. More...

Private Attributes
Ptr< YansWifiChannel >	m_channel
	YansWifiChannel that this YansWifiPhy is connected to. More...

Additional Inherited Members
Public Types inherited from ns3::WifiPhy
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(*	PhyRxPayloadBeginTracedCallback) (WifiTxVector txVector, Time psduDuration)
	TracedCallback signature for start of PSDU reception events. More...

typedef void(*	PsduTxBeginCallback) (WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW)
	TracedCallback signature for PSDU transmit events. More...

Static Public Attributes inherited from ns3::WifiPhy
static const std::set< FrequencyChannelInfo >	m_frequencyChannels
	Available frequency channels. 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...

InterferenceHelper	m_interference
	the class handling 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...

Related Functions inherited from ns3::ObjectBase
static TypeId	GetObjectIid (void)
	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 model of 802.11a. The model implemented here is based on the model described in "Yet Another Network Simulator", (http://cutebugs.net/files/wns2-yans.pdf).

This PHY model depends on a channel loss and delay model as provided by the ns3::PropagationLossModel and ns3::PropagationDelayModel classes, both of which are members of the ns3::YansWifiChannel class.

Config Paths

ns3::YansWifiPhy is accessible through the following paths with Config::Set and Config::Connect:

"/NodeList/[i]/DeviceList/[i]/$ns3::WifiNetDevice/Phy/$ns3::YansWifiPhy"
"/NodeList/[i]/DeviceList/[i]/$ns3::WaveNetDevice/PhyEntities/[i]/$ns3::YansWifiPhy"

No Attributes are defined for this type.

Attributes defined in parent class ns3::WifiPhy

Frequency: The center frequency (MHz) of the operating channel. If the operating channel for this object has not been set yet, the value of this attribute is saved and will be used, along with the channel number and width configured via other attributes, to set the operating channel when the standard and band are configured. The default value of this attribute is 0, which means unspecified center frequency. Note that if center frequency and channel number are both 0 when the standard and band are configured, a default channel (of the configured width, if any, or the default width for the current standard and band, otherwise) is set. If the operating channel for this object has been already set, the specified center frequency must uniquely identify a channel in the band being used.
- Set with class: ns3::UintegerValue
- Underlying type: uint16_t 0:65535
- Initial value: 0
- Flags: construct write read
ChannelNumber: The channel number of the operating channel. If the operating channel for this object has not been set yet, the value of this attribute is saved and will be used, along with the center frequency and width configured via other attributes, to set the operating channel when the standard and band are configured. The default value of this attribute is 0, which means unspecified channel number. Note that if center frequency and channel number are both 0 when the standard and band are configured, a default channel (of the configured width, if any, or the default width for the current standard and band, otherwise) is set. If the operating channel for this object has been already set, the specified channel number must uniquely identify a channel in the band being used.
- Set with class: ns3::UintegerValue
- Underlying type: uint8_t 0:233
- Initial value: 0
- Flags: construct write read
ChannelWidth: The width in MHz of the operating channel (5, 10, 20, 22, 40, 80 or 160). If the operating channel for this object has not been set yet, the value of this attribute is saved and will be used, along with the center frequency and channel number configured via other attributes, to set the operating channel when the standard and band are configured. The default value of this attribute is 0, which means unspecified channel width. Note that if center frequency and channel number are both 0 when the standard and band are configured, a default channel (of the configured width, if any, or the default width for the current standard and band, otherwise) is set. Do not set this attribute when the standard and band of this object have been already configured, because it cannot uniquely identify a channel in the band being used.
- Set with class: ns3::UintegerValue
- Underlying type: uint16_t 5:160
- Initial value: 0
- Flags: construct write read
Primary20MHzIndex: The index of the primary 20 MHz channel within the operating channel (0 indicates the 20 MHz subchannel with the lowest center frequency). This attribute is only valid if the width of the operating channel is a multiple of 20 MHz.
- Set with class: ns3::UintegerValue
- Underlying type: uint8_t 0:7
- Initial value: 0
- Flags: construct write
RxSensitivity: The energy of a received signal should be higher than this threshold (dBm) for the PHY to detect the signal. This threshold refers to a width of 20 MHz and will be scaled to match the width of the received signal.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: -101
- Flags: construct write read
CcaEdThreshold: The energy of a non Wi-Fi received signal should be higher than this threshold (dBm) to allow the PHY layer to declare CCA BUSY state. This check is performed on the 20 MHz primary channel only.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: -62
- Flags: construct write read
TxGain: Transmission gain (dB).
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0
- Flags: construct write read
RxGain: Reception gain (dB).
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0
- Flags: construct write read
TxPowerLevels: Number of transmission power levels available between TxPowerStart and TxPowerEnd included.
- Set with class: ns3::UintegerValue
- Underlying type: uint8_t 0:255
- Initial value: 1
- Flags: construct write read
TxPowerEnd: Maximum available transmission level (dBm).
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 16.0206
- Flags: construct write read
TxPowerStart: Minimum available transmission level (dBm).
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 16.0206
- Flags: construct write read
RxNoiseFigure: Loss (dB) in the Signal-to-Noise-Ratio due to non-idealities in the receiver. According to Wikipedia (http://en.wikipedia.org/wiki/Noise_figure), this is "the difference in decibels (dB) between the noise output of the actual receiver to the noise output of an ideal receiver with the same overall gain and bandwidth when the receivers are connected to sources at the standard noise temperature T0 (usually 290 K)".
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 7
- Flags: construct write
State: The state of the PHY layer.
- Set with class: ns3::PointerValue
- Underlying type: ns3::Ptr< ns3::WifiPhyStateHelper>
- Initial value: 0
- Flags: construct write read
ChannelSwitchDelay: Delay between two short frames transmitted on different frequencies.
- Set with class: ns3::TimeValue
- Underlying type: Time -9.22337e+18ns:+9.22337e+18ns
- Initial value: +250000ns
- Flags: construct write read
Antennas: The number of antennas on the device.
- Set with class: ns3::UintegerValue
- Underlying type: uint8_t 1:8
- Initial value: 1
- Flags: construct write read
MaxSupportedTxSpatialStreams: The maximum number of supported TX spatial streams.This parameter is only valuable for 802.11n/ac/ax STAs and APs.
- Set with class: ns3::UintegerValue
- Underlying type: uint8_t 1:8
- Initial value: 1
- Flags: construct write read
MaxSupportedRxSpatialStreams: The maximum number of supported RX spatial streams.This parameter is only valuable for 802.11n/ac/ax STAs and APs.
- Set with class: ns3::UintegerValue
- Underlying type: uint8_t 1:8
- Initial value: 1
- Flags: construct write read
ShortPlcpPreambleSupported: Whether or not short PHY preamble is supported.This parameter is only valuable for 802.11b STAs and APs.Note: 802.11g APs and STAs always support short PHY preamble.
- Set with class: BooleanValue
- Underlying type: bool
- Initial value: false
- Flags: construct write read
FrameCaptureModel: Ptr to an object that implements the frame capture model
- Set with class: ns3::PointerValue
- Underlying type: ns3::Ptr< ns3::FrameCaptureModel>
- Initial value: 0
- Flags: construct write read
PreambleDetectionModel: Ptr to an object that implements the preamble detection model
- Set with class: ns3::PointerValue
- Underlying type: ns3::Ptr< ns3::PreambleDetectionModel>
- Initial value: 0
- Flags: construct write read
PostReceptionErrorModel: An optional packet error model can be added to the receive packet process after any propagation-based (SNR-based) error models have been applied. Typically this is used to force specific packet drops, for testing purposes.
- Set with class: ns3::PointerValue
- Underlying type: ns3::Ptr< ns3::ErrorModel>
- Initial value: 0
- Flags: construct write read
Sifs: The duration of the Short Interframe Space. NOTE that the default value is overwritten by the value defined by the standard; if you want to set this attribute, you have to do it after that the PHY object is initialized.
- Set with class: ns3::TimeValue
- Underlying type: Time -9.22337e+18ns:+9.22337e+18ns
- Initial value: +0ns
- Flags: construct write read
Slot: The duration of a slot. NOTE that the default value is overwritten by the value defined by the standard; if you want to set this attribute, you have to do it after that the PHY object is initialized.
- Set with class: ns3::TimeValue
- Underlying type: Time -9.22337e+18ns:+9.22337e+18ns
- Initial value: +0ns
- Flags: construct write read
Pifs: The duration of the PCF Interframe Space. NOTE that the default value is overwritten by the value defined by the standard; if you want to set this attribute, you have to do it after that the PHY object is initialized.
- Set with class: ns3::TimeValue
- Underlying type: Time -9.22337e+18ns:+9.22337e+18ns
- Initial value: +0ns
- Flags: construct write read
PowerDensityLimit: The mean equivalent isotropically radiated power densitylimit (in dBm/MHz) set by regulators.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 100
- Flags: construct write read

No TraceSources are defined for this type.

TraceSources defined in parent class ns3::WifiPhy

PhyTxBegin: Trace source indicating a packet has begun transmitting over the channel medium
Callback signature: ns3::Packet::TracedCallback
PhyTxPsduBegin: Trace source indicating a PSDU has begun transmitting over the channel medium
Callback signature: ns3::WifiPhy::PsduTxBeginCallback
PhyTxEnd: Trace source indicating a packet has been completely transmitted over the channel.
Callback signature: ns3::Packet::TracedCallback
PhyTxDrop: Trace source indicating a packet has been dropped by the device during transmission
Callback signature: ns3::Packet::TracedCallback
PhyRxBegin: Trace source indicating a packet has begun being received from the channel medium by the device
Callback signature: ns3::Packet::TracedCallback
PhyRxPayloadBegin: Trace source indicating the reception of the payload of a PPDU has begun
Callback signature: ns3::WifiPhy::PhyRxPayloadBeginTracedCallback
PhyRxEnd: Trace source indicating a packet has been completely received from the channel medium by the device
Callback signature: ns3::Packet::TracedCallback
PhyRxDrop: Trace source indicating a packet has been dropped by the device during reception
Callback signature: ns3::Packet::TracedCallback
MonitorSnifferRx: Trace source simulating a wifi device in monitor mode sniffing all received frames
Callback signature: ns3::WifiPhy::MonitorSnifferRxTracedCallback
MonitorSnifferTx: Trace source simulating the capability of a wifi device in monitor mode to sniff all frames being transmitted
Callback signature: ns3::WifiPhy::MonitorSnifferTxTracedCallback

Size of this type is 864 bytes (on a 64-bit architecture).

Definition at line 47 of file yans-wifi-phy.h.

Constructor & Destructor Documentation

◆ YansWifiPhy()

ns3::YansWifiPhy::YansWifiPhy ( )

Definition at line 44 of file yans-wifi-phy.cc.

References ns3::InterferenceHelper::AddBand(), ns3::WifiPhy::m_interference, and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ ~YansWifiPhy()

ns3::YansWifiPhy::~YansWifiPhy ( )

virtual

Definition at line 54 of file yans-wifi-phy.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ DoDispose()

void ns3::YansWifiPhy::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::WifiPhy.

Definition at line 60 of file yans-wifi-phy.cc.

References ns3::WifiPhy::DoDispose(), m_channel, and NS_LOG_FUNCTION.

Here is the call graph for this function:

◆ GetChannel()

Ptr< Channel > ns3::YansWifiPhy::GetChannel ( void ) const

overridevirtual

Return the Channel this WifiPhy is connected to.

Returns: the Channel this WifiPhy is connected to

Implements ns3::WifiPhy.

Definition at line 68 of file yans-wifi-phy.cc.

References m_channel.

◆ GetGuardBandwidth()

uint16_t ns3::YansWifiPhy::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 90 of file yans-wifi-phy.cc.

References NS_ABORT_MSG.

◆ GetTxMaskRejectionParams()

std::tuple< double, double, double > ns3::YansWifiPhy::GetTxMaskRejectionParams ( void ) 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 97 of file yans-wifi-phy.cc.

References NS_ABORT_MSG.