A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
wifi-interference-test-suite.cc
1 /*
2  * Copyright (c) 2009 University of Washington
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 
18 #include <iostream>
19 #include <fstream>
20 #include <vector>
21 #include <string>
22 
23 #include "ns3/log.h"
24 #include "ns3/callback.h"
25 #include "ns3/abort.h"
26 #include "ns3/test.h"
27 #include "ns3/pcap-file.h"
28 #include "ns3/config.h"
29 #include "ns3/string.h"
30 #include "ns3/uinteger.h"
31 #include "ns3/double.h"
32 #include "ns3/data-rate.h"
33 #include "ns3/inet-socket-address.h"
34 #include "ns3/internet-stack-helper.h"
35 #include "ns3/ipv4-address-helper.h"
36 #include "ns3/tcp-socket-factory.h"
37 #include "ns3/yans-wifi-helper.h"
38 #include "ns3/propagation-loss-model.h"
39 #include "ns3/propagation-delay-model.h"
40 #include "ns3/yans-wifi-channel.h"
41 #include "ns3/yans-wifi-phy.h"
42 #include "ns3/wifi-net-device.h"
43 #include "ns3/mobility-helper.h"
44 #include "ns3/constant-position-mobility-model.h"
45 #include "ns3/nqos-wifi-mac-helper.h"
46 #include "ns3/simulator.h"
47 
48 NS_LOG_COMPONENT_DEFINE ("WifiInterferenceTestSuite");
49 
50 using namespace ns3;
51 
53 {
54 public:
56  virtual ~WifiInterferenceTestCase ();
57 
58 private:
59  virtual void DoRun (void);
60  void ReceivePacket (Ptr<Socket> socket);
61  static void GenerateTraffic (Ptr<Socket> socket, uint32_t pktSize, uint32_t pktCount, Time pktInterval);
62  void PrintEndSync (std::string context, uint32_t dataRate, double snr, double per);
63  double WifiSimpleInterference (std::string phyMode, double Prss, double Irss, double delta, uint32_t PpacketSize,
64  uint32_t IpacketSize, bool verbose, InternetStackHelper internet);
65  double m_PER;
66  double m_SNR;
67  uint32_t m_DataRate;
68 };
69 
70 // Add some help text to this case to describe what it is intended to test
71 WifiInterferenceTestCase::WifiInterferenceTestCase ()
72  : TestCase ("Test interference calculation when interfering frame exactly overlaps intended frame")
73 {
74 }
75 
76 WifiInterferenceTestCase::~WifiInterferenceTestCase ()
77 {
78 }
79 
80 static inline std::string
81 PrintReceivedPacket (Ptr<Socket> socket)
82 {
83  Address addr;
84  socket->GetSockName (addr);
85  InetSocketAddress iaddr = InetSocketAddress::ConvertFrom (addr);
86 
87  std::ostringstream oss;
88  oss << "Received one packet! Socket: " << iaddr.GetIpv4 () << " port: " << iaddr.GetPort ();
89 
90  return oss.str ();
91 }
92 
93 void
94 WifiInterferenceTestCase::ReceivePacket (Ptr<Socket> socket)
95 {
96  NS_LOG_UNCOND (PrintReceivedPacket (socket));
97 }
98 
99 void
100 WifiInterferenceTestCase::GenerateTraffic (Ptr<Socket> socket, uint32_t pktSize, uint32_t pktCount, Time pktInterval)
101 {
102  if (pktCount > 0)
103  {
104  socket->Send (Create<Packet> (pktSize));
105  Simulator::Schedule (pktInterval, &WifiInterferenceTestCase::GenerateTraffic, socket, pktSize, pktCount-1, pktInterval);
106  }
107  else
108  {
109  socket->Close ();
110  }
111 }
112 
113 void
114 WifiInterferenceTestCase::PrintEndSync (std::string context, uint32_t dataRate, double snr, double per)
115 {
116  NS_LOG_UNCOND ("EndSync: Received frame with dataRate=" << dataRate << ", SNR=" << snr << ", PER =" << per);
117  m_PER = per;
118  m_SNR = snr;
119  m_DataRate = dataRate;
120 }
121 
122 double
123 WifiInterferenceTestCase::WifiSimpleInterference (std::string phyMode,double Prss, double Irss, double delta, uint32_t PpacketSize, uint32_t IpacketSize, bool verbose, InternetStackHelper internet)
124 {
125 
126  uint32_t numPackets = 1;
127  double interval = 1.0; // seconds
128  double startTime = 10.0; // seconds
129  double distanceToRx = 100.0; // meters
130 
131  double offset = 91; // This is a magic number used to set the
132  // transmit power, based on other configuration
133 
134  m_PER = 0;
135  m_SNR = 0;
136  m_DataRate = 0;
137 
138  // Convert to time object
139  Time interPacketInterval = Seconds (interval);
140 
141  // disable fragmentation for frames below 2200 bytes
142  Config::SetDefault ("ns3::WifiRemoteStationManager::FragmentationThreshold", StringValue ("2200"));
143  // turn off RTS/CTS for frames below 2200 bytes
144  Config::SetDefault ("ns3::WifiRemoteStationManager::RtsCtsThreshold", StringValue ("2200"));
145  // Fix non-unicast data rate to be the same as that of unicast
146  Config::SetDefault ("ns3::WifiRemoteStationManager::NonUnicastMode",
147  StringValue (phyMode));
148 
149  NodeContainer c;
150  c.Create (3);
151 
152  // The below set of helpers will help us to put together the wifi NICs we want
153  WifiHelper wifi;
155 
156  YansWifiPhyHelper wifiPhy = YansWifiPhyHelper::Default ();
157  // This is one parameter that matters when using FixedRssLossModel
158  // set it to zero; otherwise, gain will be added
159  wifiPhy.Set ("RxGain", DoubleValue (0) );
160  wifiPhy.Set ("CcaMode1Threshold", DoubleValue (0.0) );
161 
162  // ns-3 supports RadioTap and Prism tracing extensions for 802.11b
163  wifiPhy.SetPcapDataLinkType (YansWifiPhyHelper::DLT_IEEE802_11_RADIO);
164 
165  YansWifiChannelHelper wifiChannel;
166  wifiChannel.SetPropagationDelay ("ns3::ConstantSpeedPropagationDelayModel");
167  wifiChannel.AddPropagationLoss ("ns3::LogDistancePropagationLossModel");
168  wifiPhy.SetChannel (wifiChannel.Create ());
169 
170  // Add a non-QoS upper mac, and disable rate control
171  NqosWifiMacHelper wifiMac = NqosWifiMacHelper::Default ();
172  wifi.SetRemoteStationManager ("ns3::ConstantRateWifiManager",
173  "DataMode",StringValue (phyMode),
174  "ControlMode",StringValue (phyMode));
175  // Set it to adhoc mode
176  wifiMac.SetType ("ns3::AdhocWifiMac");
177  NetDeviceContainer devices = wifi.Install (wifiPhy, wifiMac, c.Get (0));
178  // This will disable these sending devices from detecting a signal
179  // so that they do not backoff
180  wifiPhy.Set ("EnergyDetectionThreshold", DoubleValue (0.0) );
181  wifiPhy.Set ("TxGain", DoubleValue (offset + Prss) );
182  devices.Add (wifi.Install (wifiPhy, wifiMac, c.Get (1)));
183  wifiPhy.Set ("TxGain", DoubleValue (offset + Irss) );
184  devices.Add (wifi.Install (wifiPhy, wifiMac, c.Get (2)));
185 
186  // Note that with FixedRssLossModel, the positions below are not
187  // used for received signal strength.
188  MobilityHelper mobility;
189  Ptr<ListPositionAllocator> positionAlloc = CreateObject<ListPositionAllocator> ();
190  positionAlloc->Add (Vector (0.0, 0.0, 0.0));
191  positionAlloc->Add (Vector (distanceToRx, 0.0, 0.0));
192  positionAlloc->Add (Vector (-1*distanceToRx, 0.0, 0.0));
193  mobility.SetPositionAllocator (positionAlloc);
194  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
195  mobility.Install (c);
196 
197  // InternetStackHelper internet;
198  internet.Install (c);
199 
200  Ipv4AddressHelper ipv4;
201  NS_LOG_INFO ("Assign IP Addresses.");
202  ipv4.SetBase ("10.1.1.0", "255.255.255.0");
203  Ipv4InterfaceContainer i = ipv4.Assign (devices);
204 
205  TypeId tid = TypeId::LookupByName ("ns3::UdpSocketFactory");
206  Ptr<Socket> recvSink = Socket::CreateSocket (c.Get (0), tid);
207  InetSocketAddress local = InetSocketAddress (Ipv4Address ("10.1.1.1"), 80);
208  recvSink->Bind (local);
209  recvSink->SetRecvCallback (MakeCallback (&WifiInterferenceTestCase::ReceivePacket, this));
210 
211  Ptr<Socket> source = Socket::CreateSocket (c.Get (1), tid);
212  InetSocketAddress remote = InetSocketAddress (Ipv4Address ("255.255.255.255"), 80);
213  source->Connect (remote);
214 
215  // Interferer will send to a different port; we will not see a
216  // "Received packet" message
217  Ptr<Socket> interferer = Socket::CreateSocket (c.Get (2), tid);
218  InetSocketAddress interferingAddr = InetSocketAddress (Ipv4Address ("255.255.255.255"), 49000);
219  interferer->Connect (interferingAddr);
220 
221  Config::Connect ("/NodeList/0/DeviceList/0/$ns3::WifiNetDevice/Phy/$ns3::YansWifiPhy/EndSync", MakeCallback (&WifiInterferenceTestCase::PrintEndSync, this));
222  // Tracing
223 // wifiPhy.EnablePcap ("wifi-simple-interference", devices.Get (0));
224 
225  Simulator::ScheduleWithContext (source->GetNode ()->GetId (),
226  Seconds (startTime), &GenerateTraffic,
227  source, PpacketSize, numPackets, interPacketInterval);
228 
229  Simulator::ScheduleWithContext (interferer->GetNode ()->GetId (),
230  Seconds (startTime + delta/1000000.0), &GenerateTraffic,
231  interferer, IpacketSize, numPackets, interPacketInterval);
232 
233  Simulator::Run ();
234  Simulator::Destroy ();
235 
236  return m_PER;
237 }
238 
239 void
241 {
242 
243  std::string phyMode ("DsssRate1Mbps");
244  double Prss = -90; // -dBm
245  double Irss = -90; // -dBm
246  double delta = 0; // microseconds
247  uint32_t PpacketSize = 1000; // bytes
248  uint32_t IpacketSize = 1000; // bytes
249  bool verbose = false;
250  double PER, PER1, PER2;
251  InternetStackHelper internet;
252 
253  // Compute the packet error rate (PER) when delta=0 microseconds. This
254  // means that the interferer arrives at exactly the same time as the
255  // intended packet
256  PER = WifiSimpleInterference (phyMode,Prss,Irss,delta,PpacketSize,IpacketSize,verbose,internet);
257 
258  // Now rerun this test case and compute the PER when the delta time between
259  // arrival of the intended frame and interferer is 1 microsecond.
260  delta = 1;
261  PER1 = WifiSimpleInterference (phyMode,Prss,Irss,delta,PpacketSize,IpacketSize,verbose,internet);
262 
263  // Now rerun this test case and compute the PER when the delta time between
264  // arrival of the intended frame and interferer is 2 microseconds.
265  delta = 2;
266  PER2 = WifiSimpleInterference (phyMode,Prss,Irss,delta,PpacketSize,IpacketSize,verbose,internet);
267 
268  double PERDiff1 = PER - PER1;
269 
270  double PERDiff2 = PER1 - PER2;
271 
272  NS_TEST_ASSERT_MSG_EQ (PERDiff1, PERDiff2,
273  "The PER difference due to 1 microsecond difference in arrival shouldn't depend on absolute arrival");
274 }
275 
277 {
278 public:
280 };
281 
282 WifiInterferenceTestSuite::WifiInterferenceTestSuite ()
283  : TestSuite ("ns3-wifi-interference", UNIT)
284 {
285  AddTestCase (new WifiInterferenceTestCase, TestCase::QUICK);
286 }
287 
288 static WifiInterferenceTestSuite wifiInterferenceTestSuite;
289 
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())
virtual void DoRun(void)
Implementation to actually run this test case.
keep track of time unit.
Definition: nstime.h:149
an Inet address class
Ipv4Address GetIpv4(void) const
holds a vector of std::pair of Ptr<Ipv4> 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:68
hold variables of type string
Definition: string.h:19
Make it easy to create and manage PHY objects for the yans model.
A suite of tests to run.
Definition: test.h:962
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())
#define NS_LOG_COMPONENT_DEFINE(name)
Definition: log.h:122
virtual int GetSockName(Address &address) const =0
void SetPcapDataLinkType(enum SupportedPcapDataLinkTypes dlt)
aggregate IP/TCP/UDP functionality to existing Nodes.
#define NS_LOG_INFO(msg)
Definition: log.h:264
void Set(std::string name, const AttributeValue &v)
encapsulates test code
Definition: test.h:834
helps to create WifiNetDevice objects
Definition: wifi-helper.h:92
a 3d vector
Definition: vector.h:31
NetDeviceContainer Install(const WifiPhyHelper &phy, const WifiMacHelper &mac, NodeContainer c) const
Definition: wifi-helper.cc:97
a polymophic address class
Definition: address.h:86
void SetChannel(Ptr< YansWifiChannel > channel)
void Install(Ptr< Node > node) const
"Layout" a single node according to the current position allocator type.
void Add(NetDeviceContainer other)
Append the contents of another NetDeviceContainer to the end of this container.
holds a vector of ns3::NetDevice pointers
void SetStandard(enum WifiPhyStandard standard)
Definition: wifi-helper.cc:91
Callback< R > MakeCallback(R(T::*memPtr)(void), OBJ objPtr)
Definition: callback.h:502
void SetRecvCallback(Callback< void, Ptr< Socket > >)
Notify application when new data is available to be read.
Definition: socket.cc:127
create non QoS-enabled MAC layers for a ns3::WifiNetDevice.
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.
keep track of a set of node pointers.
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
#define NS_LOG_UNCOND(msg)
Definition: log.h:343
manage and create wifi channel objects for the yans model.
void AddTestCase(TestCase *testCase) NS_DEPRECATED
Add an individual test case to this test suite.
Definition: test.cc:172
Helper class used to assign positions and mobility models to nodes.
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:38
Ipv4InterfaceContainer Assign(const NetDeviceContainer &c)
Assign IP addresses to the net devices specified in the container based on the current network prefix...
Time Seconds(double seconds)
create ns3::Time instances in units of seconds.
Definition: nstime.h:586
uint32_t GetId(void) const
Definition: node.cc:105
virtual Ptr< Node > GetNode(void) const =0
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
uint16_t GetPort(void) const
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
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)
virtual int Close(void)=0
Close a socket.
Hold an floating point type.
Definition: double.h:41
a unique identifier for an interface.
Definition: type-id.h:44
void SetBase(Ipv4Address network, Ipv4Mask mask, Ipv4Address base="0.0.0.1")
Set the base network number, network mask and base address.