A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
ns3::BasicEnergySource Class Reference

BasicEnergySource decreases/increases remaining energy stored in itself in linearly. More...

#include "basic-energy-source.h"

+ Inheritance diagram for ns3::BasicEnergySource:
+ Collaboration diagram for ns3::BasicEnergySource:

Public Member Functions

 BasicEnergySource ()
 
 ~BasicEnergySource () override
 
double GetEnergyFraction () override
 
Time GetEnergyUpdateInterval () const
 
double GetInitialEnergy () const override
 
double GetRemainingEnergy () override
 
double GetSupplyVoltage () const override
 
void SetEnergyUpdateInterval (Time interval)
 
void SetInitialEnergy (double initialEnergyJ)
 
void SetSupplyVoltage (double supplyVoltageV)
 
void UpdateEnergySource () override
 Implements UpdateEnergySource.
 
- Public Member Functions inherited from ns3::EnergySource
 EnergySource ()
 
 ~EnergySource () override
 
void AppendDeviceEnergyModel (Ptr< DeviceEnergyModel > deviceEnergyModelPtr)
 
void ConnectEnergyHarvester (Ptr< EnergyHarvester > energyHarvesterPtr)
 
void DisposeDeviceModels ()
 Calls Dispose () method of the device energy models.
 
DeviceEnergyModelContainer FindDeviceEnergyModels (std::string name)
 
DeviceEnergyModelContainer FindDeviceEnergyModels (TypeId tid)
 
virtual double GetEnergyFraction ()=0
 
virtual double GetInitialEnergy () const =0
 
Ptr< NodeGetNode () const
 
virtual double GetRemainingEnergy ()=0
 
virtual double GetSupplyVoltage () const =0
 
void InitializeDeviceModels ()
 Calls Start () method of the device energy models.
 
void SetNode (Ptr< Node > node)
 Sets pointer to node containing this EnergySource.
 
virtual void UpdateEnergySource ()=0
 This function goes through the list of DeviceEnergyModels to obtain total current draw at the energy source and updates remaining energy.
 
- Public Member Functions inherited from ns3::Object
 Object ()
 Constructor.
 
 ~Object () override
 Destructor.
 
void AggregateObject (Ptr< Object > other)
 Aggregate two Objects together.
 
void Dispose ()
 Dispose of this Object.
 
AggregateIterator GetAggregateIterator () const
 Get an iterator to the Objects aggregated to this one.
 
TypeId GetInstanceTypeId () const override
 Get the most derived TypeId for this Object.
 
template<typename T >
Ptr< T > GetObject () const
 Get a pointer to the requested aggregated Object.
 
template<>
Ptr< ObjectGetObject () const
 Specialization of () for objects of type ns3::Object.
 
template<typename T >
Ptr< T > GetObject (TypeId tid) const
 Get a pointer to the requested aggregated Object by TypeId.
 
template<>
Ptr< ObjectGetObject (TypeId tid) const
 Specialization of (TypeId tid) for objects of type ns3::Object.
 
void Initialize ()
 Invoke DoInitialize on all Objects aggregated to this one.
 
bool IsInitialized () const
 Check if the object has been initialized.
 
void UnidirectionalAggregateObject (Ptr< Object > other)
 Aggregate an Object to another Object.
 
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 Default constructor.
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor.
 
uint32_t GetReferenceCount () const
 Get the reference count of the object.
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment operator.
 
void Ref () const
 Increment the reference count.
 
void Unref () const
 Decrement the reference count.
 
- Public Member Functions inherited from ns3::ObjectBase
virtual ~ObjectBase ()
 Virtual destructor.
 
void GetAttribute (std::string name, AttributeValue &value) const
 Get the value of an attribute, raising fatal errors if unsuccessful.
 
bool GetAttributeFailSafe (std::string name, AttributeValue &value) const
 Get the value of an attribute without raising errors.
 
virtual TypeId GetInstanceTypeId () const =0
 Get the most derived TypeId for this Object.
 
void SetAttribute (std::string name, const AttributeValue &value)
 Set a single attribute, raising fatal errors if unsuccessful.
 
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
 Set a single attribute without raising errors.
 
bool TraceConnect (std::string name, std::string context, const CallbackBase &cb)
 Connect a TraceSource to a Callback with a context.
 
bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
 Connect a TraceSource to a Callback without a context.
 
bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected with a context.
 
bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected without a context.
 

Static Public Member Functions

static TypeId GetTypeId ()
 Get the type ID.
 
- Static Public Member Functions inherited from ns3::EnergySource
static TypeId GetTypeId ()
 Get the type ID.
 
- Static Public Member Functions inherited from ns3::Object
static TypeId GetTypeId ()
 Register this type.
 
- Static Public Member Functions inherited from ns3::ObjectBase
static TypeId GetTypeId ()
 Get the type ID.
 

Private Member Functions

void CalculateRemainingEnergy ()
 Calculates remaining energy.
 
void DoDispose () override
 Defined in ns3::Object.
 
void DoInitialize () override
 Defined in ns3::Object.
 
void HandleEnergyDrainedEvent ()
 Handles the remaining energy going to zero event.
 
void HandleEnergyRechargedEvent ()
 Handles the remaining energy exceeding the high threshold after it went below the low threshold.
 

Private Attributes

bool m_depleted
 set to true when the remaining energy goes below the low threshold, set to false again when the remaining energy exceeds the high threshold
 
EventId m_energyUpdateEvent
 energy update event
 
Time m_energyUpdateInterval
 energy update interval
 
double m_highBatteryTh
 high battery threshold, as a fraction of the initial energy
 
double m_initialEnergyJ
 initial energy, in Joules
 
Time m_lastUpdateTime
 last update time
 
double m_lowBatteryTh
 low battery threshold, as a fraction of the initial energy
 
TracedValue< doublem_remainingEnergyJ
 remaining energy, in Joules
 
double m_supplyVoltageV
 supply voltage, in Volts
 

Additional Inherited Members

- Protected Member Functions inherited from ns3::EnergySource
void BreakDeviceEnergyModelRefCycle ()
 This function is called to break reference cycle between EnergySource and DeviceEnergyModel.
 
double CalculateTotalCurrent ()
 
void NotifyEnergyChanged ()
 This function notifies all DeviceEnergyModel of energy changed event.
 
void NotifyEnergyDrained ()
 This function notifies all DeviceEnergyModel of energy depletion event.
 
void NotifyEnergyRecharged ()
 This function notifies all DeviceEnergyModel of energy recharged event.
 
- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 Copy an Object.
 
virtual void DoDispose ()
 Destructor implementation.
 
virtual void DoInitialize ()
 Initialize() implementation.
 
virtual void NotifyNewAggregate ()
 Notify all Objects aggregated to this one of a new Object being aggregated.
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 Complete construction of ObjectBase; invoked by derived classes.
 
virtual void NotifyConstructionCompleted ()
 Notifier called once the ObjectBase is fully constructed.
 

Detailed Description

BasicEnergySource decreases/increases remaining energy stored in itself in linearly.

Introspection did not find any typical Config paths.


Attributes

  • BasicEnergyHighBatteryThreshold: High battery threshold for basic energy source.
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 0.15
    • Flags: constructwriteread
  • BasicEnergyLowBatteryThreshold: Low battery threshold for basic energy source.
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 0.1
    • Flags: constructwriteread
  • BasicEnergySourceInitialEnergyJ: Initial energy stored in basic energy source.
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 10
    • Flags: constructwriteread
  • BasicEnergySupplyVoltageV: Initial supply voltage for basic energy source.
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 3
    • Flags: constructwriteread
  • PeriodicEnergyUpdateInterval: Time between two consecutive periodic energy updates.
    • Set with class: ns3::TimeValue
    • Underlying type: Time +9.22337e+18ns:+9.22337e+18ns
    • Initial value: +1e+09ns
    • Flags: constructwriteread

TraceSources

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

Definition at line 38 of file basic-energy-source.h.

Constructor & Destructor Documentation

◆ BasicEnergySource()

ns3::BasicEnergySource::BasicEnergySource ( )

Definition at line 78 of file basic-energy-source.cc.

References m_depleted, m_lastUpdateTime, NS_LOG_FUNCTION, and ns3::Seconds().

+ Here is the call graph for this function:

◆ ~BasicEnergySource()

ns3::BasicEnergySource::~BasicEnergySource ( )
override

Definition at line 85 of file basic-energy-source.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ CalculateRemainingEnergy()

void ns3::BasicEnergySource::CalculateRemainingEnergy ( )
private

Calculates remaining energy.

This function uses the total current from all device models to calculate the amount of energy to decrease. The energy to decrease is given by: energy to decrease = total current * supply voltage * time duration This function subtracts the calculated energy to decrease from remaining energy.

Definition at line 221 of file basic-energy-source.cc.

References ns3::EnergySource::CalculateTotalCurrent(), ns3::Time::IsPositive(), m_lastUpdateTime, m_remainingEnergyJ, m_supplyVoltageV, ns3::Simulator::Now(), NS_ASSERT, NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by UpdateEnergySource().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ DoDispose()

void ns3::BasicEnergySource::DoDispose ( )
overrideprivatevirtual

Defined in ns3::Object.

Reimplemented from ns3::Object.

Definition at line 198 of file basic-energy-source.cc.

References ns3::EnergySource::BreakDeviceEnergyModelRefCycle(), and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ DoInitialize()

void ns3::BasicEnergySource::DoInitialize ( )
overrideprivatevirtual

Defined in ns3::Object.

Reimplemented from ns3::Object.

Definition at line 191 of file basic-energy-source.cc.

References NS_LOG_FUNCTION, and UpdateEnergySource().

+ Here is the call graph for this function:

◆ GetEnergyFraction()

double ns3::BasicEnergySource::GetEnergyFraction ( )
overridevirtual
Returns
Energy fraction.

Implements GetEnergyFraction.

Implements ns3::EnergySource.

Definition at line 144 of file basic-energy-source.cc.

References m_initialEnergyJ, m_remainingEnergyJ, NS_LOG_FUNCTION, and UpdateEnergySource().

+ Here is the call graph for this function:

◆ GetEnergyUpdateInterval()

Time ns3::BasicEnergySource::GetEnergyUpdateInterval ( ) const
Returns
The interval between each energy update.

Definition at line 114 of file basic-energy-source.cc.

References m_energyUpdateInterval, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ GetInitialEnergy()

double ns3::BasicEnergySource::GetInitialEnergy ( ) const
overridevirtual
Returns
Initial energy stored in energy source, in Joules.

Implements GetInitialEnergy.

Implements ns3::EnergySource.

Definition at line 128 of file basic-energy-source.cc.

References m_initialEnergyJ, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ GetRemainingEnergy()

double ns3::BasicEnergySource::GetRemainingEnergy ( )
overridevirtual
Returns
Remaining energy in energy source, in Joules

Implements GetRemainingEnergy.

Implements ns3::EnergySource.

Definition at line 135 of file basic-energy-source.cc.

References m_remainingEnergyJ, NS_LOG_FUNCTION, and UpdateEnergySource().

Referenced by AnimationRemainingEnergyTestCase::CheckLogic().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ GetSupplyVoltage()

double ns3::BasicEnergySource::GetSupplyVoltage ( ) const
overridevirtual
Returns
Supply voltage at the energy source.

Implements GetSupplyVoltage.

Implements ns3::EnergySource.

Definition at line 121 of file basic-energy-source.cc.

References m_supplyVoltageV, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ GetTypeId()

TypeId ns3::BasicEnergySource::GetTypeId ( )
static

Get the type ID.

Returns
The object TypeId.

Definition at line 36 of file basic-energy-source.cc.

References GetEnergyUpdateInterval(), GetInitialEnergy(), GetSupplyVoltage(), m_highBatteryTh, m_lowBatteryTh, m_remainingEnergyJ, ns3::MakeDoubleAccessor(), ns3::MakeTimeAccessor(), ns3::MakeTimeChecker(), ns3::MakeTraceSourceAccessor(), ns3::Seconds(), SetEnergyUpdateInterval(), SetInitialEnergy(), ns3::TypeId::SetParent(), and SetSupplyVoltage().

+ Here is the call graph for this function:

◆ HandleEnergyDrainedEvent()

void ns3::BasicEnergySource::HandleEnergyDrainedEvent ( )
private

Handles the remaining energy going to zero event.

This function notifies all the energy models aggregated to the node about the energy being depleted. Each energy model is then responsible for its own handler.

Definition at line 205 of file basic-energy-source.cc.

References ns3::EnergySource::NotifyEnergyDrained(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by UpdateEnergySource().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ HandleEnergyRechargedEvent()

void ns3::BasicEnergySource::HandleEnergyRechargedEvent ( )
private

Handles the remaining energy exceeding the high threshold after it went below the low threshold.

This function notifies all the energy models aggregated to the node about the energy being recharged. Each energy model is then responsible for its own handler.

Definition at line 213 of file basic-energy-source.cc.

References ns3::EnergySource::NotifyEnergyRecharged(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.

Referenced by UpdateEnergySource().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ SetEnergyUpdateInterval()

void ns3::BasicEnergySource::SetEnergyUpdateInterval ( Time  interval)
Parameters
intervalEnergy update interval.

This function sets the interval between each energy update.

Definition at line 107 of file basic-energy-source.cc.

References m_energyUpdateInterval, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ SetInitialEnergy()

void ns3::BasicEnergySource::SetInitialEnergy ( double  initialEnergyJ)
Parameters
initialEnergyJInitial energy, in Joules

Sets initial energy stored in the energy source. Note that initial energy is assumed to be set before simulation starts and is set only once per simulation.

Definition at line 91 of file basic-energy-source.cc.

References m_initialEnergyJ, m_remainingEnergyJ, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by GetTypeId(), and AnimationRemainingEnergyTestCase::PrepareNetwork().

+ Here is the caller graph for this function:

◆ SetSupplyVoltage()

void ns3::BasicEnergySource::SetSupplyVoltage ( double  supplyVoltageV)
Parameters
supplyVoltageVSupply voltage at the energy source, in Volts.

Sets supply voltage of the energy source.

Definition at line 100 of file basic-energy-source.cc.

References m_supplyVoltageV, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ UpdateEnergySource()

void ns3::BasicEnergySource::UpdateEnergySource ( )
overridevirtual

Implements UpdateEnergySource.

Implements ns3::EnergySource.

Definition at line 153 of file basic-energy-source.cc.

References CalculateRemainingEnergy(), HandleEnergyDrainedEvent(), HandleEnergyRechargedEvent(), ns3::EventId::IsExpired(), m_depleted, m_energyUpdateEvent, m_energyUpdateInterval, m_highBatteryTh, m_initialEnergyJ, m_lastUpdateTime, m_lowBatteryTh, m_remainingEnergyJ, ns3::EnergySource::NotifyEnergyChanged(), ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Simulator::Schedule(), and UpdateEnergySource().

Referenced by DoInitialize(), BasicEnergyHarvesterTestCase::DoRun(), GetEnergyFraction(), GetRemainingEnergy(), BasicEnergyUpdateTest::StateSwitchTest(), and UpdateEnergySource().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Member Data Documentation

◆ m_depleted

bool ns3::BasicEnergySource::m_depleted
private

set to true when the remaining energy goes below the low threshold, set to false again when the remaining energy exceeds the high threshold

Definition at line 151 of file basic-energy-source.h.

Referenced by BasicEnergySource(), and UpdateEnergySource().

◆ m_energyUpdateEvent

EventId ns3::BasicEnergySource::m_energyUpdateEvent
private

energy update event

Definition at line 153 of file basic-energy-source.h.

Referenced by UpdateEnergySource().

◆ m_energyUpdateInterval

Time ns3::BasicEnergySource::m_energyUpdateInterval
private

energy update interval

Definition at line 155 of file basic-energy-source.h.

Referenced by GetEnergyUpdateInterval(), SetEnergyUpdateInterval(), and UpdateEnergySource().

◆ m_highBatteryTh

double ns3::BasicEnergySource::m_highBatteryTh
private

high battery threshold, as a fraction of the initial energy

Definition at line 146 of file basic-energy-source.h.

Referenced by GetTypeId(), and UpdateEnergySource().

◆ m_initialEnergyJ

double ns3::BasicEnergySource::m_initialEnergyJ
private

initial energy, in Joules

Definition at line 143 of file basic-energy-source.h.

Referenced by GetEnergyFraction(), GetInitialEnergy(), SetInitialEnergy(), and UpdateEnergySource().

◆ m_lastUpdateTime

Time ns3::BasicEnergySource::m_lastUpdateTime
private

last update time

Definition at line 154 of file basic-energy-source.h.

Referenced by BasicEnergySource(), CalculateRemainingEnergy(), and UpdateEnergySource().

◆ m_lowBatteryTh

double ns3::BasicEnergySource::m_lowBatteryTh
private

low battery threshold, as a fraction of the initial energy

Definition at line 145 of file basic-energy-source.h.

Referenced by GetTypeId(), and UpdateEnergySource().

◆ m_remainingEnergyJ

TracedValue<double> ns3::BasicEnergySource::m_remainingEnergyJ
private

◆ m_supplyVoltageV

double ns3::BasicEnergySource::m_supplyVoltageV
private

supply voltage, in Volts

Definition at line 144 of file basic-energy-source.h.

Referenced by CalculateRemainingEnergy(), GetSupplyVoltage(), and SetSupplyVoltage().


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