A WiFi radio energy model. More...

#include <wifi-radio-energy-model.h>

Inheritance diagram for ns3::WifiRadioEnergyModel:

Public Types
typedef Callback< void >	WifiRadioEnergyDepletionCallback

Public Types inherited from ns3::DeviceEnergyModel
typedef Callback< void, int >	ChangeStateCallback

Public Member Functions
virtual void	ChangeState (int newState)
	Changes state of the WifiRadioEnergyMode. More...

double	GetCcaBusyCurrentA (void) const

WifiPhy::State	GetCurrentState (void) const

double	GetIdleCurrentA (void) const

WifiRadioEnergyModelPhyListener *	GetPhyListener (void)

double	GetRxCurrentA (void) const

double	GetSwitchingCurrentA (void) const

virtual double	GetTotalEnergyConsumption (void) const

double	GetTxCurrentA (void) const

virtual void	HandleEnergyDepletion (void)
	Handles energy depletion. More...

void	SetCcaBusyCurrentA (double ccaBusyCurrentA)

void	SetEnergyDepletionCallback (WifiRadioEnergyDepletionCallback callback)

virtual void	SetEnergySource (Ptr< EnergySource > source)
	Sets pointer to EnergySouce installed on node. More...

void	SetIdleCurrentA (double idleCurrentA)

void	SetRxCurrentA (double rxCurrentA)

void	SetSwitchingCurrentA (double switchingCurrentA)

void	SetTxCurrentA (double txCurrentA)

Public Member Functions inherited from ns3::DeviceEnergyModel
double	GetCurrentA (void) const

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

SimpleRefCount &	operator= (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::DeviceEnergyModel
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
void	DoDispose (void)

virtual double	DoGetCurrentA (void) const

void	SetWifiRadioState (const WifiPhy::State state)

Private Attributes
double	m_ccaBusyCurrentA

WifiPhy::State	m_currentState

WifiRadioEnergyDepletionCallback	m_energyDepletionCallback

double	m_idleCurrentA

Time	m_lastUpdateTime

WifiRadioEnergyModelPhyListener *	m_listener

double	m_rxCurrentA

Ptr< EnergySource >	m_source

double	m_switchingCurrentA

TracedValue< double >	m_totalEnergyConsumption

double	m_txCurrentA

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

A WiFi radio energy model.

4 states are defined for the radio: TX, RX, IDLE, SLEEP. Default state is IDLE. The different types of transactions that are defined are:

Tx: State goes from IDLE to TX, radio is in TX state for TX_duration, then state goes from TX to IDLE.
Rx: State goes from IDLE to RX, radio is in RX state for RX_duration, then state goes from RX to IDLE.
Go_to_Sleep: State goes from IDLE to SLEEP.
End_of_Sleep: State goes from SLEEP to IDLE. The class keeps track of what state the radio is currently in.

Energy calculation: For each transaction, this model notifies EnergySource object. The EnergySource object will query this model for the total current. Then the EnergySource object uses the total current to calculate energy.

Default values for power consumption are based on CC2420 radio chip, with supply voltage as 2.5V and currents as 17.4 mA (TX), 18.8 mA (RX), 20 uA (sleep) and 426 uA (idle).

Doxygen introspection did not find any typical Config paths.

Attributes

IdleCurrentA: The default radio Idle current in Ampere.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.000426
- Flags: construct write read
CcaBusyCurrentA: The default radio CCA Busy State current in Ampere.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.000426
- Flags: construct write read
TxCurrentA: The radio Tx current in Ampere.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.0174
- Flags: construct write read
RxCurrentA: The radio Rx current in Ampere.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.0197
- Flags: construct write read
SwitchingCurrentA: The default radio Channel Switch current in Ampere.
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.000426
- Flags: construct write read

TraceSources

TotalEnergyConsumption: Total energy consumption of the radio device.

Definition at line 147 of file wifi-radio-energy-model.h.

Member Typedef Documentation

typedef Callback<void> ns3::WifiRadioEnergyModel::WifiRadioEnergyDepletionCallback

Callback type for energy depletion handling.

Definition at line 153 of file wifi-radio-energy-model.h.

Member Function Documentation

void ns3::WifiRadioEnergyModel::ChangeState ( int newState )

virtual

Changes state of the WifiRadioEnergyMode.

Parameters

newState New state the wifi radio is in.

Implements DeviceEnergyModel::ChangeState.

Implements ns3::DeviceEnergyModel.

Definition at line 201 of file wifi-radio-energy-model.cc.

References ns3::WifiPhy::CCA_BUSY, ns3::Time::GetNanoSeconds(), ns3::Time::GetSeconds(), ns3::WifiPhy::IDLE, ns3::Simulator::Now(), NS_ASSERT, NS_FATAL_ERROR, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::WifiPhy::RX, SetWifiRadioState(), ns3::WifiPhy::SWITCHING, and ns3::WifiPhy::TX.

void ns3::WifiRadioEnergyModel::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 273 of file wifi-radio-energy-model.cc.

References NS_LOG_FUNCTION.

double ns3::WifiRadioEnergyModel::DoGetCurrentA ( void ) const

privatevirtual