A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
ns3::WaveformGenerator Class Reference

#include <waveform-generator.h>

+ Inheritance diagram for ns3::WaveformGenerator:

Public Member Functions

Ptr< NetDeviceGetDevice ()
 
double GetDutyCycle () const
 
Ptr< MobilityModelGetMobility ()
 
Time GetPeriod () const
 
Ptr< AntennaModelGetRxAntenna ()
 
Ptr< const SpectrumModelGetRxSpectrumModel () const
 
void SetAntenna (Ptr< AntennaModel > a)
 
void SetChannel (Ptr< SpectrumChannel > c)
 
void SetDevice (Ptr< NetDevice > d)
 
void SetDutyCycle (double value)
 
void SetMobility (Ptr< MobilityModel > m)
 
void SetPeriod (Time period)
 
void SetTxPowerSpectralDensity (Ptr< SpectrumValue > txs)
 
virtual void Start ()
 
void StartRx (Ptr< SpectrumSignalParameters > params)
 
virtual void Stop ()
 
- Public Member Functions inherited from ns3::Object
void AggregateObject (Ptr< Object > other)
 
void Dispose (void)
 
AggregateIterator GetAggregateIterator (void) const
 
virtual TypeId GetInstanceTypeId (void) const
 
template<typename T >
Ptr< T > GetObject (void) const
 
template<typename T >
Ptr< T > GetObject (TypeId tid) const
 
void Initialize (void)
 
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount (const SimpleRefCount &o)
 
uint32_t GetReferenceCount (void) const
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 
void Ref (void) const
 
void Unref (void) const
 
- Public Member Functions inherited from ns3::ObjectBase
void GetAttribute (std::string name, AttributeValue &value) const
 
bool GetAttributeFailSafe (std::string name, AttributeValue &attribute) const
 
void SetAttribute (std::string name, const AttributeValue &value)
 
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
 
bool TraceConnect (std::string name, std::string context, const CallbackBase &cb)
 
bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
 
bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
 
bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
 

Static Public Member Functions

static TypeId GetTypeId (void)
 
- Static Public Member Functions inherited from ns3::SpectrumPhy
static TypeId GetTypeId (void)
 
- Static Public Member Functions inherited from ns3::Object
static TypeId GetTypeId (void)
 
- Static Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
static void Cleanup (void)
 
- Static Public Member Functions inherited from ns3::ObjectBase
static TypeId GetTypeId (void)
 

Private Member Functions

virtual void DoDispose (void)
 
virtual void GenerateWaveform ()
 

Private Attributes

bool m_active
 
Ptr< AntennaModelm_antenna
 
Ptr< SpectrumChannelm_channel
 
double m_dutyCycle
 
Ptr< MobilityModelm_mobility
 
Ptr< NetDevicem_netDevice
 
Time m_period
 
TracedCallback< Ptr< const
Packet > > 
m_phyTxEndTrace
 
TracedCallback< Ptr< const
Packet > > 
m_phyTxStartTrace
 
Time m_startTime
 
Ptr< SpectrumValuem_txPowerSpectralDensity
 

Additional Inherited Members

- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 
virtual void DoInitialize (void)
 
virtual void NotifyNewAggregate (void)
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 
virtual void NotifyConstructionCompleted (void)
 

Detailed Description

Simple SpectrumPhy implementation that sends customizable waveform. The generated waveforms have a given Spectrum Power Density and duration (set with the SetResolution()) . The generator activates and deactivates periodically with a given period and with a duty cycle of 1/2.

This PHY model supports a single antenna model instance which is used for both transmission and reception (though received signals are discarded by this PHY).

Doxygen introspection did not find any typical Config paths.

Attributes

  • Period: the period (=1/frequency)
    • Set with class: TimeValue
    • Underlying type: Time
    • Initial value: +1000000000.0ns
    • Flags: construct write read
  • DutyCycle: the duty cycle of the generator, i.e., the fraction of the period that is occupied by a signal
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 0.5
    • Flags: construct write read

TraceSources

  • TxStart: Trace fired when a new transmission is started
  • TxEnd: Trace fired when a previosuly started transmission is finished

Definition at line 52 of file waveform-generator.h.

Member Function Documentation

void ns3::WaveformGenerator::DoDispose ( void  )
privatevirtual

This method is called by Object::Dispose or by the object's destructor, whichever comes first.

Subclasses are expected to implement their real destruction code in an overriden 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.

Definition at line 56 of file waveform-generator.cc.

References NS_LOG_FUNCTION.

Ptr< NetDevice > ns3::WaveformGenerator::GetDevice ( )
virtual

get the associated NetDevice instance

Returns
a Ptr to the associated NetDevice instance

Implements ns3::SpectrumPhy.

Definition at line 95 of file waveform-generator.cc.

double ns3::WaveformGenerator::GetDutyCycle ( ) const
Returns
the value of the duty cycle

Definition at line 184 of file waveform-generator.cc.

Ptr< MobilityModel > ns3::WaveformGenerator::GetMobility ( )
virtual

get the associated MobilityModel instance

Returns
a Ptr to the associated MobilityModel instance

Implements ns3::SpectrumPhy.

Definition at line 102 of file waveform-generator.cc.

Time ns3::WaveformGenerator::GetPeriod ( ) const
Returns
the value of the period according to which the WaveformGenerator switches on and off

Definition at line 171 of file waveform-generator.cc.

Ptr< AntennaModel > ns3::WaveformGenerator::GetRxAntenna ( )
virtual

get the AntennaModel used by the NetDevice for reception

Returns
a Ptr to the AntennaModel used by the NetDevice for reception

Implements ns3::SpectrumPhy.

Definition at line 152 of file waveform-generator.cc.

Ptr< const SpectrumModel > ns3::WaveformGenerator::GetRxSpectrumModel ( ) const
virtual
Returns
returns the SpectrumModel that this SpectrumPhy expects to be used for all SpectrumValues that are passed to StartRx. If 0 is returned, it means that any model will be accepted.

Implements ns3::SpectrumPhy.

Definition at line 109 of file waveform-generator.cc.

void ns3::WaveformGenerator::SetAntenna ( Ptr< AntennaModel a)

set the AntennaModel to be used

Parameters
athe Antenna Model

Definition at line 158 of file waveform-generator.cc.

References NS_LOG_FUNCTION.

void ns3::WaveformGenerator::SetChannel ( Ptr< SpectrumChannel c)
virtual

Set the channel attached to this device.

Parameters
cthe channel

Implements ns3::SpectrumPhy.

Definition at line 130 of file waveform-generator.cc.

References NS_LOG_FUNCTION_NOARGS.

void ns3::WaveformGenerator::SetDevice ( Ptr< NetDevice d)
virtual

set the associated NetDevice instance

Parameters
dthe NetDevice instance

Implements ns3::SpectrumPhy.

Definition at line 116 of file waveform-generator.cc.

void ns3::WaveformGenerator::SetDutyCycle ( double  value)
Parameters
valuethe value of the duty cycle

Definition at line 179 of file waveform-generator.cc.

void ns3::WaveformGenerator::SetMobility ( Ptr< MobilityModel m)
virtual

Set the mobility model associated with this device.

Parameters
mthe mobility model

Implements ns3::SpectrumPhy.

Definition at line 123 of file waveform-generator.cc.

void ns3::WaveformGenerator::SetPeriod ( Time  period)

Set the period according to which the WaveformGenerator switches on and off

Parameters
period

Definition at line 165 of file waveform-generator.cc.

void ns3::WaveformGenerator::SetTxPowerSpectralDensity ( Ptr< SpectrumValue txs)

Set the Power Spectral Density used for outgoing waveforms

Parameters
txsthe Power Spectral Density

Definition at line 145 of file waveform-generator.cc.

References NS_LOG_FUNCTION.

void ns3::WaveformGenerator::Start ( void  )
virtual

Start the waveform generator

Definition at line 215 of file waveform-generator.cc.

References ns3::Now(), NS_LOG_FUNCTION, NS_LOG_LOGIC, and ns3::Simulator::ScheduleNow().

void ns3::WaveformGenerator::StartRx ( Ptr< SpectrumSignalParameters params)
virtual

Notify the SpectrumPhy instance of an incoming signal

Parameters
paramsthe parameters of the signals being received

Implements ns3::SpectrumPhy.

Definition at line 139 of file waveform-generator.cc.

References NS_LOG_FUNCTION.

void ns3::WaveformGenerator::Stop ( void  )
virtual

Stop the waveform generator

Definition at line 229 of file waveform-generator.cc.

References NS_LOG_FUNCTION.


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