A Discrete-Event Network Simulator
API
energy-model-with-harvesting-example.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014 Wireless Communications and Networking Group (WCNG),
4  * University of Rochester, Rochester, NY, USA.
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 as
8  * published by the Free Software Foundation;
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18  *
19  * Author: Cristiano Tapparello <cristiano.tapparello@rochester.edu>
20  */
21 
50 #include "ns3/core-module.h"
51 #include "ns3/network-module.h"
52 #include "ns3/mobility-module.h"
53 #include "ns3/config-store-module.h"
54 #include "ns3/wifi-module.h"
55 #include "ns3/energy-module.h"
56 #include "ns3/internet-module.h"
57 
58 #include <iostream>
59 #include <fstream>
60 #include <vector>
61 #include <string>
62 
63 using namespace ns3;
64 
65 NS_LOG_COMPONENT_DEFINE ("EnergyWithHarvestingExample");
66 
67 static inline std::string
69 {
71 
72  std::ostringstream oss;
73  oss << "--\nReceived one packet! Socket: " << iaddr.GetIpv4 ()
74  << " port: " << iaddr.GetPort ()
75  << " at time = " << Simulator::Now ().GetSeconds ()
76  << "\n--";
77 
78  return oss.str ();
79 }
80 
86 void
88 {
89  Ptr<Packet> packet;
90  Address from;
91  while ((packet = socket->RecvFrom (from)))
92  {
93  if (packet->GetSize () > 0)
94  {
96  }
97  }
98 }
99 
109 static void
110 GenerateTraffic (Ptr<Socket> socket, uint32_t pktSize, Ptr<Node> n,
111  uint32_t pktCount, Time pktInterval)
112 {
113  if (pktCount > 0)
114  {
115  socket->Send (Create<Packet> (pktSize));
116  Simulator::Schedule (pktInterval, &GenerateTraffic, socket, pktSize, n,
117  pktCount - 1, pktInterval);
118  }
119  else
120  {
121  socket->Close ();
122  }
123 }
124 
126 void
127 RemainingEnergy (double oldValue, double remainingEnergy)
128 {
129  std::cout << Simulator::Now ().GetSeconds ()
130  << "s Current remaining energy = " << remainingEnergy << "J" << std::endl;
131 }
132 
134 void
135 TotalEnergy (double oldValue, double totalEnergy)
136 {
137  std::cout << Simulator::Now ().GetSeconds ()
138  << "s Total energy consumed by radio = " << totalEnergy << "J" << std::endl;
139 }
140 
142 void
143 HarvestedPower (double oldValue, double harvestedPower)
144 {
145  std::cout << Simulator::Now ().GetSeconds ()
146  << "s Current harvested power = " << harvestedPower << " W" << std::endl;
147 }
148 
150 void
152 {
153  std::cout << Simulator::Now ().GetSeconds ()
154  << "s Total energy harvested by harvester = "
155  << TotalEnergyHarvested << " J" << std::endl;
156 }
157 
158 
159 int
160 main (int argc, char *argv[])
161 {
162  /*
163  LogComponentEnable ("EnergySource", LOG_LEVEL_DEBUG);
164  LogComponentEnable ("BasicEnergySource", LOG_LEVEL_DEBUG);
165  LogComponentEnable ("DeviceEnergyModel", LOG_LEVEL_DEBUG);
166  LogComponentEnable ("WifiRadioEnergyModel", LOG_LEVEL_DEBUG);
167  LogComponentEnable ("EnergyHarvester", LOG_LEVEL_DEBUG);
168  LogComponentEnable ("BasicEnergyHarvester", LOG_LEVEL_DEBUG);
169  */
170 
171  std::string phyMode ("DsssRate1Mbps");
172  double Prss = -80; // dBm
173  uint32_t PpacketSize = 200; // bytes
174  bool verbose = false;
175 
176  // simulation parameters
177  uint32_t numPackets = 10000; // number of packets to send
178  double interval = 1; // seconds
179  double startTime = 0.0; // seconds
180  double distanceToRx = 100.0; // meters
181  /*
182  * This is a magic number used to set the transmit power, based on other
183  * configuration.
184  */
185  double offset = 81;
186 
187  // Energy Harvester variables
188  double harvestingUpdateInterval = 1; // seconds
189 
191  cmd.AddValue ("phyMode", "Wifi Phy mode", phyMode);
192  cmd.AddValue ("Prss", "Intended primary RSS (dBm)", Prss);
193  cmd.AddValue ("PpacketSize", "size of application packet sent", PpacketSize);
194  cmd.AddValue ("numPackets", "Total number of packets to send", numPackets);
195  cmd.AddValue ("startTime", "Simulation start time", startTime);
196  cmd.AddValue ("distanceToRx", "X-Axis distance between nodes", distanceToRx);
197  cmd.AddValue ("verbose", "Turn on all device log components", verbose);
198  cmd.Parse (argc, argv);
199 
200  // Convert to time object
201  Time interPacketInterval = Seconds (interval);
202 
203  // disable fragmentation for frames below 2200 bytes
204  Config::SetDefault ("ns3::WifiRemoteStationManager::FragmentationThreshold",
205  StringValue ("2200"));
206  // turn off RTS/CTS for frames below 2200 bytes
207  Config::SetDefault ("ns3::WifiRemoteStationManager::RtsCtsThreshold",
208  StringValue ("2200"));
209  // Fix non-unicast data rate to be the same as that of unicast
210  Config::SetDefault ("ns3::WifiRemoteStationManager::NonUnicastMode",
211  StringValue (phyMode));
212 
213  NodeContainer c;
214  c.Create (2); // create 2 nodes
215  NodeContainer networkNodes;
216  networkNodes.Add (c.Get (0));
217  networkNodes.Add (c.Get (1));
218 
219  // The below set of helpers will help us to put together the wifi NICs we want
221  if (verbose)
222  {
223  wifi.EnableLogComponents ();
224  }
226 
228  /***************************************************************************/
230  wifiPhy.Set ("RxGain", DoubleValue (-10));
231  wifiPhy.Set ("TxGain", DoubleValue (offset + Prss));
232  wifiPhy.Set ("CcaMode1Threshold", DoubleValue (0.0));
233  /***************************************************************************/
234 
236  YansWifiChannelHelper wifiChannel;
237  wifiChannel.SetPropagationDelay ("ns3::ConstantSpeedPropagationDelayModel");
238  wifiChannel.AddPropagationLoss ("ns3::FriisPropagationLossModel");
239  // create wifi channel
240  Ptr<YansWifiChannel> wifiChannelPtr = wifiChannel.Create ();
241  wifiPhy.SetChannel (wifiChannelPtr);
242 
244  // Add a MAC and disable rate control
245  WifiMacHelper wifiMac;
246  wifi.SetRemoteStationManager ("ns3::ConstantRateWifiManager", "DataMode",
247  StringValue (phyMode), "ControlMode",
248  StringValue (phyMode));
249  // Set it to ad-hoc mode
250  wifiMac.SetType ("ns3::AdhocWifiMac");
251 
253  NetDeviceContainer devices = wifi.Install (wifiPhy, wifiMac, networkNodes);
254 
257  Ptr<ListPositionAllocator> positionAlloc = CreateObject<ListPositionAllocator> ();
258  positionAlloc->Add (Vector (0.0, 0.0, 0.0));
259  positionAlloc->Add (Vector (2 * distanceToRx, 0.0, 0.0));
260  mobility.SetPositionAllocator (positionAlloc);
261  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
262  mobility.Install (c);
263 
265  /***************************************************************************/
266  /* energy source */
267  BasicEnergySourceHelper basicSourceHelper;
268  // configure energy source
269  basicSourceHelper.Set ("BasicEnergySourceInitialEnergyJ", DoubleValue (1.0));
270  // install source
271  EnergySourceContainer sources = basicSourceHelper.Install (c);
272  /* device energy model */
273  WifiRadioEnergyModelHelper radioEnergyHelper;
274  // configure radio energy model
275  radioEnergyHelper.Set ("TxCurrentA", DoubleValue (0.0174));
276  radioEnergyHelper.Set ("RxCurrentA", DoubleValue (0.0197));
277  // install device model
278  DeviceEnergyModelContainer deviceModels = radioEnergyHelper.Install (devices, sources);
279 
280  /* energy harvester */
281  BasicEnergyHarvesterHelper basicHarvesterHelper;
282  // configure energy harvester
283  basicHarvesterHelper.Set ("PeriodicHarvestedPowerUpdateInterval", TimeValue (Seconds (harvestingUpdateInterval)));
284  basicHarvesterHelper.Set ("HarvestablePower", StringValue ("ns3::UniformRandomVariable[Min=0.0|Max=0.1]"));
285  // install harvester on all energy sources
286  EnergyHarvesterContainer harvesters = basicHarvesterHelper.Install (sources);
287  /***************************************************************************/
288 
290  InternetStackHelper internet;
291  internet.Install (networkNodes);
292 
293  Ipv4AddressHelper ipv4;
294  NS_LOG_INFO ("Assign IP Addresses.");
295  ipv4.SetBase ("10.1.1.0", "255.255.255.0");
296  Ipv4InterfaceContainer i = ipv4.Assign (devices);
297 
298  TypeId tid = TypeId::LookupByName ("ns3::UdpSocketFactory");
299  Ptr<Socket> recvSink = Socket::CreateSocket (networkNodes.Get (1), tid); // node 1, Destination
301  recvSink->Bind (local);
303 
304  Ptr<Socket> source = Socket::CreateSocket (networkNodes.Get (0), tid); // node 0, Source
306  source->SetAllowBroadcast (true);
307  source->Connect (remote);
308 
310  /***************************************************************************/
311  // all traces are connected to node 1 (Destination)
312  // energy source
313  Ptr<BasicEnergySource> basicSourcePtr = DynamicCast<BasicEnergySource> (sources.Get (1));
314  basicSourcePtr->TraceConnectWithoutContext ("RemainingEnergy", MakeCallback (&RemainingEnergy));
315  // device energy model
316  Ptr<DeviceEnergyModel> basicRadioModelPtr =
317  basicSourcePtr->FindDeviceEnergyModels ("ns3::WifiRadioEnergyModel").Get (0);
318  NS_ASSERT (basicRadioModelPtr != 0);
319  basicRadioModelPtr->TraceConnectWithoutContext ("TotalEnergyConsumption", MakeCallback (&TotalEnergy));
320  // energy harvester
321  Ptr<BasicEnergyHarvester> basicHarvesterPtr = DynamicCast<BasicEnergyHarvester> (harvesters.Get (1));
322  basicHarvesterPtr->TraceConnectWithoutContext ("HarvestedPower", MakeCallback (&HarvestedPower));
323  basicHarvesterPtr->TraceConnectWithoutContext ("TotalEnergyHarvested", MakeCallback (&TotalEnergyHarvested));
324  /***************************************************************************/
325 
326 
328  // start traffic
329  Simulator::Schedule (Seconds (startTime), &GenerateTraffic, source, PpacketSize,
330  networkNodes.Get (0), numPackets, interPacketInterval);
331 
332  Simulator::Stop (Seconds (10.0));
333  Simulator::Run ();
335 
336  return 0;
337 }
void AddPropagationLoss(std::string name, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())
void Set(std::string name, const AttributeValue &v)
Definition: wifi-helper.cc:112
DeviceEnergyModelContainer Install(Ptr< NetDevice > device, Ptr< EnergySource > source) const
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:102
Assign WifiRadioEnergyModel to wifi devices.
an Inet address class
Ipv4Address GetIpv4(void) const
static Ipv4Address GetAny(void)
Holds a vector of ns3::EnergySource pointers.
tuple devices
Definition: first.py:32
holds a vector of std::pair of Ptr and interface index.
Ptr< YansWifiChannel > Create(void) const
void SetRemoteStationManager(std::string type, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())
Definition: wifi-helper.cc:683
void TotalEnergy(double oldValue, double totalEnergy)
Trace function for total energy consumption at node.
Hold variables of type string.
Definition: string.h:41
virtual bool SetAllowBroadcast(bool allowBroadcast)=0
Configure whether broadcast datagram transmissions are allowed.
Make it easy to create and manage PHY objects for the yans model.
static void GenerateTraffic(Ptr< Socket > socket, uint32_t pktSize, Ptr< Node > n, uint32_t pktCount, Time pktInterval)
Creates a BasicEnergyHarvester object.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
Definition: assert.h:67
static void Run(void)
Run the simulation.
Definition: simulator.cc:201
void TotalEnergyHarvested(double oldValue, double TotalEnergyHarvested)
Trace function for the total energy harvested by the node.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
aggregate IP/TCP/UDP functionality to existing Nodes.
uint32_t GetSize(void) const
Returns the the size in bytes of the packet (including the zero-filled initial payload).
Definition: packet.h:792
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:244
static YansWifiPhyHelper Default(void)
Create a phy helper in a default working state.
helps to create WifiNetDevice objects
Definition: wifi-helper.h:231
tuple cmd
Definition: second.py:35
Holds a vector of ns3::DeviceEnergyModel pointers.
virtual NetDeviceContainer Install(const WifiPhyHelper &phy, const WifiMacHelper &mac, NodeContainer c) const
Definition: wifi-helper.cc:712
a polymophic address class
Definition: address.h:90
void SetChannel(Ptr< YansWifiChannel > channel)
Ptr< EnergyHarvester > Get(uint32_t i) const
Get the i-th Ptr stored in this container.
double GetSeconds(void) const
Get an approximation of the time stored in this instance in the indicated unit.
Definition: nstime.h:341
void Install(Ptr< Node > node) const
"Layout" a single node according to the current position allocator type.
tuple mobility
Definition: third.py:101
static EventId Schedule(Time const &delay, MEM mem_ptr, OBJ obj)
Schedule an event to expire after delay.
Definition: simulator.h:1238
AttributeValue implementation for Time.
Definition: nstime.h:957
double startTime
Creates a BasicEnergySource object.
holds a vector of ns3::NetDevice pointers
virtual void SetStandard(enum WifiPhyStandard standard)
Definition: wifi-helper.cc:706
Callback< R > MakeCallback(R(T::*memPtr)(void), OBJ objPtr)
Definition: callback.h:1489
void SetRecvCallback(Callback< void, Ptr< Socket > >)
Notify application when new data is available to be read.
Definition: socket.cc:128
static Ptr< Socket > CreateSocket(Ptr< Node > node, TypeId tid)
This method wraps the creation of sockets that is performed on a given node by a SocketFactory specif...
Definition: socket.cc:71
void Set(std::string name, const AttributeValue &v)
EnergyHarvesterContainer Install(Ptr< EnergySource > source) const
Parse command-line arguments.
Definition: command-line.h:205
static Ipv4Address GetBroadcast(void)
static void Destroy(void)
Execute the events scheduled with ScheduleDestroy().
Definition: simulator.cc:165
void ReceivePacket(Ptr< Socket > socket)
virtual int Connect(const Address &address)=0
Initiate a connection to a remote host.
Ptr< DeviceEnergyModel > Get(uint32_t i) const
Get the i-th Ptr stored in this container.
bool TraceConnectWithoutContext(std::string name, const CallbackBase &cb)
Connect a TraceSource to a Callback without a context.
Definition: object-base.cc:299
void RemainingEnergy(double oldValue, double remainingEnergy)
Trace function for remaining energy at node.
virtual int Bind(const Address &address)=0
Allocate a local endpoint for this socket.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
static InetSocketAddress ConvertFrom(const Address &address)
Returns an InetSocketAddress which corresponds to the input Address.
keep track of a set of node pointers.
Holds a vector of ns3::EnergyHarvester pointers.
DSSS PHY (Clause 15) and HR/DSSS PHY (Clause 18)
void Set(std::string name, const AttributeValue &v)
EnergySourceContainer Install(Ptr< Node > node) const
void SetMobilityModel(std::string type, std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue(), std::string n8="", const AttributeValue &v8=EmptyAttributeValue(), std::string n9="", const AttributeValue &v9=EmptyAttributeValue())
void HarvestedPower(double oldValue, double harvestedPower)
Trace function for the power harvested by the energy harvester.
void Install(std::string nodeName) const
Aggregate implementations of the ns3::Ipv4, ns3::Ipv6, ns3::Udp, and ns3::Tcp classes onto the provid...
#define NS_LOG_UNCOND(msg)
Output the requested message unconditionaly.
manage and create wifi channel objects for the yans model.
create MAC layers for a ns3::WifiNetDevice.
static Time Now(void)
Return the current simulation virtual time.
Definition: simulator.cc:224
virtual void SetType(std::string type, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue(), std::string n8="", const AttributeValue &v8=EmptyAttributeValue(), std::string n9="", const AttributeValue &v9=EmptyAttributeValue(), std::string n10="", const AttributeValue &v10=EmptyAttributeValue())
Ptr< EnergySource > Get(uint32_t i) const
Get the i-th Ptr stored in this container.
Helper class used to assign positions and mobility models to nodes.
static void EnableLogComponents(void)
Helper to enable all WifiNetDevice log components with one statement.
Definition: wifi-helper.cc:752
Ipv4InterfaceContainer Assign(const NetDeviceContainer &c)
Assign IP addresses to the net devices specified in the container based on the current network prefix...
void Add(NodeContainer other)
Append the contents of another NodeContainer to the end of this container.
void AddValue(const std::string &name, const std::string &help, T &value)
Add a program argument, assigning to POD.
Definition: command-line.h:495
static void Stop(void)
Tell the Simulator the calling event should be the last one executed.
Definition: simulator.cc:209
Ptr< Node > Get(uint32_t i) const
Get the Ptr stored in this container at a given index.
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:895
void SetDefault(std::string name, const AttributeValue &value)
Definition: config.cc:774
void Set(std::string name, const AttributeValue &v)
void Add(Vector v)
Add a position to the list of positions.
void Parse(int argc, char *argv[])
Parse the program arguments.
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
DeviceEnergyModelContainer FindDeviceEnergyModels(TypeId tid)
uint16_t GetPort(void) const
tuple wifi
Definition: third.py:89
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
virtual Ptr< Packet > RecvFrom(uint32_t maxSize, uint32_t flags, Address &fromAddress)=0
Read a single packet from the socket and retrieve the sender address.
void SetPropagationDelay(std::string name, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())
virtual int Send(Ptr< Packet > p, uint32_t flags)=0
Send data (or dummy data) to the remote host.
void SetPositionAllocator(Ptr< PositionAllocator > allocator)
Set the position allocator which will be used to allocate the initial position of every node initiali...
virtual int Close(void)=0
Close a socket.
This class can be used to hold variables of floating point type such as 'double' or 'float'...
Definition: double.h:41
a unique identifier for an interface.
Definition: type-id.h:58
static std::string PrintReceivedPacket(Address &from)
void SetBase(Ipv4Address network, Ipv4Mask mask, Ipv4Address base="0.0.0.1")
Set the base network number, network mask and base address.
bool verbose
static TypeId LookupByName(std::string name)
Get a TypeId by name.
Definition: type-id.cc:813