A Discrete-Event Network Simulator
API
example-ping-lr-wpan-beacon.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2020 Ritsumeikan University, Shiga, Japan
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License version 2 as
6  * published by the Free Software Foundation;
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program; if not, write to the Free Software
15  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16  *
17  * Author: Alberto Gallegos Ramonet <ramonet@fc.ritsumei.ac.jp>
18  */
19 
20 #include "ns3/core-module.h"
21 #include "ns3/internet-apps-module.h"
22 #include "ns3/internet-module.h"
23 #include "ns3/lr-wpan-module.h"
24 #include "ns3/mobility-module.h"
25 #include "ns3/propagation-module.h"
26 #include "ns3/sixlowpan-module.h"
27 #include "ns3/spectrum-module.h"
28 
29 #include <fstream>
30 
31 using namespace ns3;
32 
33 static void
35 {
36  // In the case of transmissions with the Ack flag activated, the transaction is only
37  // successful if the Ack was received.
38  if (params.m_status == LrWpanMacStatus::SUCCESS)
39  {
40  std::cout << Simulator::Now().As(Time::S) << " | Node " << device->GetNode()->GetId()
41  << " | Transmission successfully sent\n";
42  }
43 }
44 
45 int
46 main(int argc, char** argv)
47 {
48  bool verbose = false;
49 
50  CommandLine cmd(__FILE__);
51  cmd.AddValue("verbose", "turn on log components", verbose);
52  cmd.Parse(argc, argv);
53 
54  if (verbose)
55  {
57  LogComponentEnable("LrWpanMac", LOG_LEVEL_INFO);
58  LogComponentEnable("LrWpanCsmaCa", LOG_LEVEL_INFO);
59  LogComponentEnable("LrWpanHelper", LOG_LEVEL_ALL);
61  }
62 
64  nodes.Create(2);
65 
67  mobility.SetMobilityModel("ns3::ConstantPositionMobilityModel");
68  mobility.SetPositionAllocator("ns3::GridPositionAllocator",
69  "MinX",
70  DoubleValue(0.0),
71  "MinY",
72  DoubleValue(0.0),
73  "DeltaX",
74  DoubleValue(20),
75  "DeltaY",
76  DoubleValue(20),
77  "GridWidth",
78  UintegerValue(3),
79  "LayoutType",
80  StringValue("RowFirst"));
81  mobility.SetMobilityModel("ns3::ConstantPositionMobilityModel");
82  mobility.Install(nodes);
83 
84  LrWpanHelper lrWpanHelper;
85  // Add and install the LrWpanNetDevice for each node
86  NetDeviceContainer lrwpanDevices = lrWpanHelper.Install(nodes);
87 
88  Ptr<LrWpanNetDevice> dev1 = lrwpanDevices.Get(0)->GetObject<LrWpanNetDevice>();
89  Ptr<LrWpanNetDevice> dev2 = lrwpanDevices.Get(1)->GetObject<LrWpanNetDevice>();
90 
91  dev1->GetMac()->SetMcpsDataConfirmCallback(MakeBoundCallback(&DataSentMacConfirm, dev1));
92 
93  dev2->GetMac()->SetMcpsDataConfirmCallback(MakeBoundCallback(&DataSentMacConfirm, dev2));
94 
95  // Manual PAN association, coordinator assignment, short address assignment and initialization
96  // of beacon-enabled mode in 802.15.4-2011.
97  // Association using the MAC functions can also be used instead of a manual association.
98 
99  // AssociateToBeaconPan (devices, PAN ID, Coordinator Address, Beacon Order, Superframe Order)
100 
101  // Must be careful not setting the beacon order (BO) and the superframe order (SO) too far apart
102  // or the ping reply (ICMPV6 echo reply) can time out during the inactive period of the
103  // superframe. A full time table of the BO/SO time equivalence can be found at the end of this
104  // document. The current configuration is BO = 14, SO = 13 :
105 
106  // Contention Access Period (CAP) Inactive
107  // (125.82912 secs) (125.82088)
108  // |---------------------------------------------|-------------------------------------------|
109  // Beacon Beacon
110  // Beacon Interval = 251.65 secs
111  // |-----------------------------------------------------------------------------------------|
112 
113  // Manually set an associated PAN, Pan id = 1 the first device (dev1) is used as coordinator
114  lrWpanHelper.CreateAssociatedPan(lrwpanDevices, 5);
115 
116  // Start the beacon mode from the MAC layer of the coordinator (dev1)
118  params.m_panCoor = true;
119  params.m_PanId = 5;
120  params.m_bcnOrd = 14;
121  params.m_sfrmOrd = 13;
122  params.m_logCh = 11;
123 
125  Seconds(0),
127  dev1->GetMac(),
128  params);
129 
130  InternetStackHelper internetv6;
131  internetv6.Install(nodes);
132 
133  SixLowPanHelper sixlowpan;
134  NetDeviceContainer devices = sixlowpan.Install(lrwpanDevices);
135 
136  Ipv6AddressHelper ipv6;
137  ipv6.SetBase(Ipv6Address("2001:2::"), Ipv6Prefix(64));
138  Ipv6InterfaceContainer deviceInterfaces;
139  deviceInterfaces = ipv6.Assign(devices);
140 
141  // Send ping packets after the 2nd second of the simulation during the
142  // first 8 seconds of the CAP in the incoming superframe
143 
144  uint32_t packetSize = 16;
145  uint32_t maxPacketCount = 5;
146  Time interPacketInterval = Seconds(1);
147  PingHelper ping(deviceInterfaces.GetAddress(1, 1));
148 
149  ping.SetAttribute("Count", UintegerValue(maxPacketCount));
150  ping.SetAttribute("Interval", TimeValue(interPacketInterval));
151  ping.SetAttribute("Size", UintegerValue(packetSize));
152  ApplicationContainer apps = ping.Install(nodes.Get(0));
153 
154  apps.Start(Seconds(2.0));
155  apps.Stop(Seconds(7.0));
156 
157  AsciiTraceHelper ascii;
158  lrWpanHelper.EnableAsciiAll(ascii.CreateFileStream("Ping-6LoW-lr-wpan-beacon.tr"));
159  lrWpanHelper.EnablePcapAll(std::string("Ping-6LoW-lr-wpan-beacon"), true);
160 
162 
163  Simulator::Run();
165 
166  return 0;
167 }
168 
169 // BO/SO values to time equivalence
170 // These times are only valid for a 250kbps O-QPSK modulation,
171 // times differ with other modulation configurations.
172 
173 // +------------------------+
174 // | BO/SO | Time (secs) |
175 // +------------------------+
176 // | 0 | 0.01536 secs |
177 // | 1 | 0.03072 secs |
178 // | 2 | 0.06144 secs |
179 // | 3 | 0.12288 secs |
180 // | 4 | 0.24576 secs |
181 // | 5 | 0.49152 secs |
182 // | 6 | 0.98304 secs |
183 // | 7 | 1.96608 secs |
184 // | 8 | 3.93216 secs |
185 // | 9 | 7.86432 secs |
186 // | 10 | 15.72864 secs |
187 // | 11 | 31.45728 secs |
188 // | 12 | 62.91456 secs |
189 // | 13 | 125.82912 secs |
190 // | 14 | 251.65 secs |
191 // +------------------------+
holds a vector of ns3::Application pointers.
void Start(Time start) const
Start all of the Applications in this container at the start time given as a parameter.
void Stop(Time stop) const
Arrange for all of the Applications in this container to Stop() at the Time given as a parameter.
void EnableAsciiAll(std::string prefix)
Enable ascii trace output on each device (which is of the appropriate type) in the set of all nodes c...
Manage ASCII trace files for device models.
Definition: trace-helper.h:174
Ptr< OutputStreamWrapper > CreateFileStream(std::string filename, std::ios::openmode filemode=std::ios::out)
Create and initialize an output stream object we'll use to write the traced bits.
Parse command-line arguments.
Definition: command-line.h:232
This class can be used to hold variables of floating point type such as 'double' or 'float'.
Definition: double.h:42
aggregate IP/TCP/UDP functionality to existing Nodes.
void Install(std::string nodeName) const
Aggregate implementations of the ns3::Ipv4, ns3::Ipv6, ns3::Udp, and ns3::Tcp classes onto the provid...
Helper class to auto-assign global IPv6 unicast addresses.
void SetBase(Ipv6Address network, Ipv6Prefix prefix, Ipv6Address base=Ipv6Address("::1"))
Set the base network number, network prefix, and base interface ID.
Ipv6InterfaceContainer Assign(const NetDeviceContainer &c)
Allocate an Ipv6InterfaceContainer with auto-assigned addresses.
Describes an IPv6 address.
Definition: ipv6-address.h:49
Keep track of a set of IPv6 interfaces.
Ipv6Address GetAddress(uint32_t i, uint32_t j) const
Get the address for the specified index.
Describes an IPv6 prefix.
Definition: ipv6-address.h:455
helps to manage and create IEEE 802.15.4 NetDevice objects
void CreateAssociatedPan(NetDeviceContainer c, uint16_t panId)
Creates an PAN with associated nodes and assigned addresses(16 and 64) from the nodes in the node con...
NetDeviceContainer Install(NodeContainer c)
Install a LrWpanNetDevice and the associated structures (e.g., channel) in the nodes.
void MlmeStartRequest(MlmeStartRequestParams params) override
IEEE 802.15.4-2006, section 7.1.14.1 MLME-START.request Request to allow a PAN coordinator to initiat...
Definition: lr-wpan-mac.cc:584
Network layer to device interface.
Ptr< Node > GetNode() const override
Ptr< LrWpanMac > GetMac() const
Get the MAC used by this NetDevice.
Helper class used to assign positions and mobility models to nodes.
holds a vector of ns3::NetDevice pointers
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
keep track of a set of node pointers.
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
uint32_t GetId() const
Definition: node.cc:117
void EnablePcapAll(std::string prefix, bool promiscuous=false)
Enable pcap output on each device (which is of the appropriate type) in the set of all nodes created ...
Create a ping application and associate it to a node.
Definition: ping-helper.h:48
static void Destroy()
Execute the events scheduled with ScheduleDestroy().
Definition: simulator.cc:142
static void ScheduleWithContext(uint32_t context, const Time &delay, FUNC f, Ts &&... args)
Schedule an event with the given context.
Definition: simulator.h:588
static Time Now()
Return the current simulation virtual time.
Definition: simulator.cc:208
static void Run()
Run the simulation.
Definition: simulator.cc:178
static void Stop()
Tell the Simulator the calling event should be the last one executed.
Definition: simulator.cc:186
Setup a sixlowpan stack to be used as a shim between IPv6 and a generic NetDevice.
NetDeviceContainer Install(NetDeviceContainer c)
Install the SixLoWPAN stack on top of an existing NetDevice.
Hold variables of type string.
Definition: string.h:56
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
TimeWithUnit As(const Unit unit=Time::AUTO) const
Attach a unit to a Time, to facilitate output in a specific unit.
Definition: time.cc:415
@ S
second
Definition: nstime.h:116
Hold an unsigned integer type.
Definition: uinteger.h:45
static void DataSentMacConfirm(Ptr< LrWpanNetDevice > device, McpsDataConfirmParams params)
auto MakeBoundCallback(R(*fnPtr)(Args...), BArgs &&... bargs)
Make Callbacks with varying number of bound arguments.
Definition: callback.h:765
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1326
NodeContainer nodes
devices
Definition: first.py:42
Every class exported by the ns3 library is enclosed in the ns3 namespace.
void LogComponentEnable(const std::string &name, LogLevel level)
Enable the logging output associated with that log component.
Definition: log.cc:302
@ SUCCESS
Definition: ff-mac-common.h:62
LogLevel
Logging severity classes and levels.
Definition: log.h:94
@ LOG_LEVEL_ALL
Print everything.
Definition: log.h:116
@ LOG_PREFIX_FUNC
Prefix all trace prints with function.
Definition: log.h:118
@ LOG_PREFIX_TIME
Prefix all trace prints with simulation time.
Definition: log.h:119
@ LOG_PREFIX_NODE
Prefix all trace prints with simulation node.
Definition: log.h:120
@ LOG_LEVEL_INFO
LOG_INFO and above.
Definition: log.h:104
void LogComponentEnableAll(LogLevel level)
Enable the logging output for all registered log components.
Definition: log.cc:320
cmd
Definition: second.py:40
mobility
Definition: third.py:105
params
Fit Fluctuating Two Ray model to the 3GPP TR 38.901 using the Anderson-Darling goodness-of-fit ##.
bool verbose
MCPS-DATA.confirm params.
MLME-START.request params.
static const uint32_t packetSize
Packet size generated at the AP.