A Discrete-Event Network Simulator
API
wifi-simple-infra.cc
Go to the documentation of this file.
1 /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2009 The Boeing Company
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  */
19 
20 //
21 // This script configures two nodes on an 802.11b physical layer, with
22 // 802.11b NICs in infrastructure mode, and by default, the station sends
23 // one packet of 1000 (application) bytes to the access point. The
24 // physical layer is configured
25 // to receive at a fixed RSS (regardless of the distance and transmit
26 // power); therefore, changing position of the nodes has no effect.
27 //
28 // There are a number of command-line options available to control
29 // the default behavior. The list of available command-line options
30 // can be listed with the following command:
31 // ./waf --run "wifi-simple-infra --help"
32 //
33 // For instance, for this configuration, the physical layer will
34 // stop successfully receiving packets when rss drops below -97 dBm.
35 // To see this effect, try running:
36 //
37 // ./waf --run "wifi-simple-infra --rss=-97 --numPackets=20"
38 // ./waf --run "wifi-simple-infra --rss=-98 --numPackets=20"
39 // ./waf --run "wifi-simple-infra --rss=-99 --numPackets=20"
40 //
41 // Note that all ns-3 attributes (not just the ones exposed in the below
42 // script) can be changed at command line; see the documentation.
43 //
44 // This script can also be helpful to put the Wifi layer into verbose
45 // logging mode; this command will turn on all wifi logging:
46 //
47 // ./waf --run "wifi-simple-infra --verbose=1"
48 //
49 // When you are done, you will notice two pcap trace files in your directory.
50 // If you have tcpdump installed, you can try this:
51 //
52 // tcpdump -r wifi-simple-infra-0-0.pcap -nn -tt
53 //
54 
55 #include "ns3/core-module.h"
56 #include "ns3/network-module.h"
57 #include "ns3/mobility-module.h"
58 #include "ns3/config-store-module.h"
59 #include "ns3/wifi-module.h"
60 #include "ns3/internet-module.h"
61 
62 #include <iostream>
63 #include <fstream>
64 #include <vector>
65 #include <string>
66 
67 using namespace ns3;
68 
69 NS_LOG_COMPONENT_DEFINE ("WifiSimpleInfra");
70 
72 {
73  while (socket->Recv ())
74  {
75  NS_LOG_UNCOND ("Received one packet!");
76  }
77 }
78 
79 static void GenerateTraffic (Ptr<Socket> socket, uint32_t pktSize,
80  uint32_t pktCount, Time pktInterval )
81 {
82  if (pktCount > 0)
83  {
84  socket->Send (Create<Packet> (pktSize));
85  Simulator::Schedule (pktInterval, &GenerateTraffic,
86  socket, pktSize,pktCount-1, pktInterval);
87  }
88  else
89  {
90  socket->Close ();
91  }
92 }
93 
94 
95 int main (int argc, char *argv[])
96 {
97  std::string phyMode ("DsssRate1Mbps");
98  double rss = -80; // -dBm
99  uint32_t packetSize = 1000; // bytes
100  uint32_t numPackets = 1;
101  double interval = 1.0; // seconds
102  bool verbose = false;
103 
105 
106  cmd.AddValue ("phyMode", "Wifi Phy mode", phyMode);
107  cmd.AddValue ("rss", "received signal strength", rss);
108  cmd.AddValue ("packetSize", "size of application packet sent", packetSize);
109  cmd.AddValue ("numPackets", "number of packets generated", numPackets);
110  cmd.AddValue ("interval", "interval (seconds) between packets", interval);
111  cmd.AddValue ("verbose", "turn on all WifiNetDevice log components", verbose);
112 
113  cmd.Parse (argc, argv);
114  // Convert to time object
115  Time interPacketInterval = Seconds (interval);
116 
117  // disable fragmentation for frames below 2200 bytes
118  Config::SetDefault ("ns3::WifiRemoteStationManager::FragmentationThreshold", StringValue ("2200"));
119  // turn off RTS/CTS for frames below 2200 bytes
120  Config::SetDefault ("ns3::WifiRemoteStationManager::RtsCtsThreshold", StringValue ("2200"));
121  // Fix non-unicast data rate to be the same as that of unicast
122  Config::SetDefault ("ns3::WifiRemoteStationManager::NonUnicastMode",
123  StringValue (phyMode));
124 
125  NodeContainer c;
126  c.Create (2);
127 
128  // The below set of helpers will help us to put together the wifi NICs we want
130  if (verbose)
131  {
132  wifi.EnableLogComponents (); // Turn on all Wifi logging
133  }
135 
137  // This is one parameter that matters when using FixedRssLossModel
138  // set it to zero; otherwise, gain will be added
139  wifiPhy.Set ("RxGain", DoubleValue (0) );
140  // ns-3 supports RadioTap and Prism tracing extensions for 802.11b
142 
143  YansWifiChannelHelper wifiChannel;
144  wifiChannel.SetPropagationDelay ("ns3::ConstantSpeedPropagationDelayModel");
145  // The below FixedRssLossModel will cause the rss to be fixed regardless
146  // of the distance between the two stations, and the transmit power
147  wifiChannel.AddPropagationLoss ("ns3::FixedRssLossModel","Rss",DoubleValue (rss));
148  wifiPhy.SetChannel (wifiChannel.Create ());
149 
150  // Add a mac and disable rate control
151  WifiMacHelper wifiMac;
152  wifi.SetRemoteStationManager ("ns3::ConstantRateWifiManager",
153  "DataMode",StringValue (phyMode),
154  "ControlMode",StringValue (phyMode));
155 
156  // Setup the rest of the mac
157  Ssid ssid = Ssid ("wifi-default");
158  // setup sta.
159  wifiMac.SetType ("ns3::StaWifiMac",
160  "Ssid", SsidValue (ssid));
161  NetDeviceContainer staDevice = wifi.Install (wifiPhy, wifiMac, c.Get (0));
162  NetDeviceContainer devices = staDevice;
163  // setup ap.
164  wifiMac.SetType ("ns3::ApWifiMac",
165  "Ssid", SsidValue (ssid));
166  NetDeviceContainer apDevice = wifi.Install (wifiPhy, wifiMac, c.Get (1));
167  devices.Add (apDevice);
168 
169  // Note that with FixedRssLossModel, the positions below are not
170  // used for received signal strength.
172  Ptr<ListPositionAllocator> positionAlloc = CreateObject<ListPositionAllocator> ();
173  positionAlloc->Add (Vector (0.0, 0.0, 0.0));
174  positionAlloc->Add (Vector (5.0, 0.0, 0.0));
175  mobility.SetPositionAllocator (positionAlloc);
176  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
177  mobility.Install (c);
178 
179  InternetStackHelper internet;
180  internet.Install (c);
181 
182  Ipv4AddressHelper ipv4;
183  NS_LOG_INFO ("Assign IP Addresses.");
184  ipv4.SetBase ("10.1.1.0", "255.255.255.0");
185  Ipv4InterfaceContainer i = ipv4.Assign (devices);
186 
187  TypeId tid = TypeId::LookupByName ("ns3::UdpSocketFactory");
188  Ptr<Socket> recvSink = Socket::CreateSocket (c.Get (0), tid);
190  recvSink->Bind (local);
192 
193  Ptr<Socket> source = Socket::CreateSocket (c.Get (1), tid);
194  InetSocketAddress remote = InetSocketAddress (Ipv4Address ("255.255.255.255"), 80);
195  source->SetAllowBroadcast (true);
196  source->Connect (remote);
197 
198  // Tracing
199  wifiPhy.EnablePcap ("wifi-simple-infra", devices);
200 
201  // Output what we are doing
202  NS_LOG_UNCOND ("Testing " << numPackets << " packets sent with receiver rss " << rss );
203 
205  Seconds (1.0), &GenerateTraffic,
206  source, packetSize, numPackets, interPacketInterval);
207 
208  Simulator::Stop (Seconds (30.0));
209  Simulator::Run ();
211 
212  return 0;
213 }
214 
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
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:102
an Inet address class
static Ipv4Address GetAny(void)
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
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 Run(void)
Run the simulation.
Definition: simulator.cc:201
static void GenerateTraffic(Ptr< Socket > socket, uint32_t pktSize, uint32_t pktCount, Time pktInterval)
#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.
#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
void SetPcapDataLinkType(enum SupportedPcapDataLinkTypes dlt)
Set the data link type of PCAP traces to be used.
Definition: wifi-helper.cc:530
virtual NetDeviceContainer Install(const WifiPhyHelper &phy, const WifiMacHelper &mac, NodeContainer c) const
Definition: wifi-helper.cc:712
void SetChannel(Ptr< YansWifiChannel > channel)
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
void Add(NetDeviceContainer other)
Append the contents of another NetDeviceContainer to the end of this container.
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
Parse command-line arguments.
Definition: command-line.h:205
static void Destroy(void)
Execute the events scheduled with ScheduleDestroy().
Definition: simulator.cc:165
virtual int Connect(const Address &address)=0
Initiate a connection to a remote host.
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.
keep track of a set of node pointers.
virtual Ptr< Packet > Recv(uint32_t maxSize, uint32_t flags)=0
Read data from the socket.
DSSS PHY (Clause 15) and HR/DSSS PHY (Clause 18)
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 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.
tuple ssid
Definition: third.py:93
manage and create wifi channel objects for the yans model.
create MAC layers for a ns3::WifiNetDevice.
The IEEE 802.11 SSID Information Element.
Definition: ssid.h:38
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())
Helper class used to assign positions and mobility models to nodes.
static void ScheduleWithContext(uint32_t context, Time const &delay, MEM mem_ptr, OBJ obj)
Schedule an event with the given context.
Definition: simulator.h:1319
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:40
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...
uint32_t GetId(void) const
Definition: node.cc:107
virtual Ptr< Node > GetNode(void) const =0
Return the node this socket is associated with.
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
AttributeValue implementation for Ssid.
Definition: ssid.h:95
void SetDefault(std::string name, const AttributeValue &value)
Definition: config.cc:774
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.
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.
static const uint32_t packetSize
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())
void EnablePcap(std::string prefix, Ptr< NetDevice > nd, bool promiscuous=false, bool explicitFilename=false)
Enable pcap output the indicated net device.
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
Include Radiotap link layer information.
Definition: wifi-helper.h:117
void ReceivePacket(Ptr< Socket > socket)
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