A Discrete-Event Network Simulator
API
simple-device-energy-model.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2010 Andrea Sacco
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Author: Andrea Sacco <andrea.sacco85@gmail.com>
19  */
20 
21 #include "ns3/simulator.h"
22 #include "ns3/trace-source-accessor.h"
23 #include "ns3/energy-source.h"
25 #include "ns3/log.h"
26 
27 namespace ns3 {
28 
29 NS_LOG_COMPONENT_DEFINE ("SimpleDeviceEnergyModel");
30 
31 NS_OBJECT_ENSURE_REGISTERED (SimpleDeviceEnergyModel);
32 
33 TypeId
35 {
36  static TypeId tid = TypeId ("ns3::SimpleDeviceEnergyModel")
38  .AddConstructor<SimpleDeviceEnergyModel> ()
39  .AddTraceSource ("TotalEnergyConsumption",
40  "Total energy consumption of the radio device.",
42  "ns3::TracedValue::DoubleCallback")
43  ;
44  return tid;
45 }
46 
48 {
49  NS_LOG_FUNCTION (this);
50  m_lastUpdateTime = Seconds (0.0);
51  m_actualCurrentA = 0.0;
52  m_source = 0;
53 }
54 
56 {
57  NS_LOG_FUNCTION (this);
58 }
59 
60 void
62 {
63  NS_LOG_FUNCTION (this << source);
64  NS_ASSERT (source != NULL);
65  m_source = source;
66 }
67 
68 void
70 {
71  NS_LOG_FUNCTION (this << node);
72  NS_ASSERT (node != NULL);
73  m_node = node;
74 }
75 
78 {
79  NS_LOG_FUNCTION (this);
80  return m_node;
81 }
82 
83 double
85 {
86  NS_LOG_FUNCTION (this);
88 }
89 
90 void
92 {
93  NS_LOG_FUNCTION (this << current);
94  Time duration = Simulator::Now () - m_lastUpdateTime;
95 
96  double energyToDecrease = 0.0;
97  double supplyVoltage = m_source->GetSupplyVoltage ();
98  energyToDecrease = duration.GetSeconds () * current * supplyVoltage;
99 
100  // update total energy consumption
101  m_totalEnergyConsumption += energyToDecrease;
102  // update last update time stamp
104  // notify energy source
105  m_source->UpdateEnergySource ();
106  // update the current drain
107  m_actualCurrentA = current;
108 }
109 
110 void
112 {
113  NS_LOG_FUNCTION (this);
114  m_source = 0;
115 }
116 
117 double
119 {
120  NS_LOG_FUNCTION (this);
121  return m_actualCurrentA;
122 }
123 
124 } // namespace ns3
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:95
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:73
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:44
Base class for device energy models.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
Definition: assert.h:61
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
virtual void SetEnergySource(Ptr< EnergySource > source)
Sets pointer to EnergySouce installed on node.
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
double GetSeconds(void) const
Get an approximation of the time stored in this instance in the indicated unit.
Definition: nstime.h:327
TracedValue< double > m_totalEnergyConsumption
Every class exported by the ns3 library is enclosed in the ns3 namespace.
virtual double GetTotalEnergyConsumption(void) const
void DoDispose(void)
Destructor implementation.
static Time Now(void)
Return the current simulation virtual time.
Definition: simulator.cc:223
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:859
virtual double DoGetCurrentA(void) const
virtual void SetNode(Ptr< Node > node)
Sets pointer to node.
a unique identifier for an interface.
Definition: type-id.h:51
TypeId SetParent(TypeId tid)
Definition: type-id.cc:631
virtual Ptr< Node > GetNode(void) const
Gets pointer to node.