A Discrete-Event Network Simulator
API
wifi-manager-example.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2016 University of Washington
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  * Authors: Tom Henderson <tomhend@u.washington.edu>
19  * Matías Richart <mrichart@fing.edu.uy>
20  * Sébastien Deronne <sebastien.deronne@gmail.com>
21  */
22 
23 // Test the operation of a wifi manager as the SNR is varied, and create
24 // a gnuplot output file for plotting.
25 //
26 // The test consists of a device acting as server and a device as client generating traffic.
27 //
28 // The output consists of a plot of the rate observed and selected at the client device.
29 //
30 // By default, the 802.11a standard using IdealWifiManager is plotted. Several command line
31 // arguments can change the following options:
32 // --wifiManager (Aarf, Aarfcd, Amrr, Arf, Cara, Ideal, Minstrel, MinstrelHt, Onoe, Rraa)
33 // --standard (802.11a, 802.11b, 802.11g, 802.11n-5GHz, 802.11n-2.4GHz, 802.11ac, 802.11-holland, 802.11-10MHz, 802.11-5MHz)
34 // --serverShortGuardInterval and --clientShortGuardInterval (for 802.11n/ac)
35 // --serverNss and --clientNss (for 802.11n/ac)
36 // --serverChannelWidth and --clientChannelWidth (for 802.11n/ac)
37 // --broadcast instead of unicast (default is unicast)
38 // --rtsThreshold (by default, value of 99999 disables it)
39 
40 #include "ns3/core-module.h"
41 #include "ns3/network-module.h"
42 #include "ns3/wifi-module.h"
43 #include "ns3/stats-module.h"
44 #include "ns3/mobility-module.h"
45 #include "ns3/propagation-module.h"
46 
47 using namespace ns3;
48 
49 NS_LOG_COMPONENT_DEFINE ("WifiManagerExample");
50 
51 // 290K @ 20 MHz
52 const double NOISE_DBM_Hz = -174.0;
54 
55 double g_intervalBytes = 0;
56 uint64_t g_intervalRate = 0;
57 
58 void
60 {
61  NS_LOG_DEBUG ("Received size " << pkt->GetSize ());
62  g_intervalBytes += pkt->GetSize ();
63 }
64 
65 void
66 RateChange (uint64_t oldVal, uint64_t newVal)
67 {
68  NS_LOG_DEBUG ("Change from " << oldVal << " to " << newVal);
69  g_intervalRate = newVal;
70 }
71 
72 void
73 RateChangeMinstrelHt (uint64_t newVal, Mac48Address dest)
74 {
75  NS_LOG_DEBUG ("Change to " << newVal);
76  g_intervalRate = newVal;
77 }
78 
80 struct Step
81 {
82  double stepSize;
83  double stepTime;
84 };
85 
88 {
90  {
91  m_name = "none";
92  }
105  StandardInfo (std::string name, enum WifiPhyStandard standard, uint16_t width, double snrLow, double snrHigh, double xMin, double xMax, double yMax)
106  : m_name (name),
107  m_standard (standard),
108  m_width (width),
109  m_snrLow (snrLow),
110  m_snrHigh (snrHigh),
111  m_xMin (xMin),
112  m_xMax (xMax),
113  m_yMax (yMax)
114  {
115  }
116  std::string m_name;
117  enum WifiPhyStandard m_standard;
118  uint16_t m_width;
119  double m_snrLow;
120  double m_snrHigh;
121  double m_xMin;
122  double m_xMax;
123  double m_yMax;
124 };
125 
126 void
127 ChangeSignalAndReportRate (Ptr<FixedRssLossModel> rssModel, struct Step step, double rss, Gnuplot2dDataset& rateDataset, Gnuplot2dDataset& actualDataset)
128 {
129  NS_LOG_FUNCTION (rssModel << step.stepSize << step.stepTime << rss);
130  double snr = rss - noiseDbm;
131  rateDataset.Add (snr, g_intervalRate / 1000000.0);
132  // Calculate received rate since last interval
133  double currentRate = ((g_intervalBytes * 8) / step.stepTime) / 1e6; // Mb/s
134  actualDataset.Add (snr, currentRate);
135  rssModel->SetRss (rss - step.stepSize);
136  NS_LOG_INFO ("At time " << Simulator::Now ().As (Time::S) << "; observed rate " << currentRate << "; setting new power to " << rss - step.stepSize);
137  g_intervalBytes = 0;
138  Simulator::Schedule (Seconds (step.stepTime), &ChangeSignalAndReportRate, rssModel, step, (rss - step.stepSize), rateDataset, actualDataset);
139 }
140 
141 int main (int argc, char *argv[])
142 {
143  std::vector <StandardInfo> serverStandards;
144  std::vector <StandardInfo> clientStandards;
145  uint32_t steps;
146  uint32_t rtsThreshold = 999999; // disabled even for large A-MPDU
147  uint32_t maxAmpduSize = 65535;
148  double stepSize = 1; // dBm
149  double stepTime = 1; // seconds
150  uint32_t packetSize = 1024; // bytes
151  bool broadcast = 0;
152  int ap1_x = 0;
153  int ap1_y = 0;
154  int sta1_x = 5;
155  int sta1_y = 0;
156  uint16_t serverNss = 1;
157  uint16_t clientNss = 1;
158  uint16_t serverShortGuardInterval = 800;
159  uint16_t clientShortGuardInterval = 800;
160  uint16_t serverChannelWidth = 20;
161  uint16_t clientChannelWidth = 20;
162  std::string wifiManager ("Ideal");
163  std::string standard ("802.11a");
164  StandardInfo serverSelectedStandard;
165  StandardInfo clientSelectedStandard;
166  bool infrastructure = false;
167 
169  cmd.AddValue ("rtsThreshold", "RTS threshold", rtsThreshold);
170  cmd.AddValue ("maxAmpduSize", "Max A-MPDU size", maxAmpduSize);
171  cmd.AddValue ("stepSize", "Power between steps (dBm)", stepSize);
172  cmd.AddValue ("stepTime", "Time on each step (seconds)", stepTime);
173  cmd.AddValue ("broadcast", "Send broadcast instead of unicast", broadcast);
174  cmd.AddValue ("serverChannelWidth", "Set channel width of the server (valid only for 802.11n or ac)", serverChannelWidth);
175  cmd.AddValue ("clientChannelWidth", "Set channel width of the client (valid only for 802.11n or ac)", clientChannelWidth);
176  cmd.AddValue ("serverNss", "Set nss of the server (valid only for 802.11n or ac)", serverNss);
177  cmd.AddValue ("clientNss", "Set nss of the client (valid only for 802.11n or ac)", clientNss);
178  cmd.AddValue ("serverShortGuardInterval", "Set short guard interval of the server (802.11n/ac/ax) in nanoseconds", serverShortGuardInterval);
179  cmd.AddValue ("clientShortGuardInterval", "Set short guard interval of the client (802.11n/ac/ax) in nanoseconds", clientShortGuardInterval);
180  cmd.AddValue ("standard", "Set standard (802.11a, 802.11b, 802.11g, 802.11n-5GHz, 802.11n-2.4GHz, 802.11ac, 802.11-holland, 802.11-10MHz, 802.11-5MHz, 802.11ax-5GHz, 802.11ax-2.4GHz)", standard);
181  cmd.AddValue ("wifiManager", "Set wifi rate manager (Aarf, Aarfcd, Amrr, Arf, Cara, Ideal, Minstrel, MinstrelHt, Onoe, Rraa)", wifiManager);
182  cmd.AddValue ("infrastructure", "Use infrastructure instead of adhoc", infrastructure);
183  cmd.Parse (argc,argv);
184 
185  // Print out some explanation of what this program does
186  std::cout << std::endl << "This program demonstrates and plots the operation of different " << std::endl;
187  std::cout << "Wi-Fi rate controls on different station configurations," << std::endl;
188  std::cout << "by stepping down the received signal strength across a wide range" << std::endl;
189  std::cout << "and observing the adjustment of the rate." << std::endl;
190  std::cout << "Run 'wifi-manager-example --PrintHelp' to show program options."<< std::endl << std::endl;
191 
192  if (infrastructure == false)
193  {
194  NS_ABORT_MSG_IF (serverNss != clientNss, "In ad hoc mode, we assume sender and receiver are similarly configured");
195  }
196 
197  if (standard == "802.11b")
198  {
199  NS_ABORT_MSG_IF (serverChannelWidth != 22 && serverChannelWidth != 22, "Invalid channel width for standard " << standard);
200  NS_ABORT_MSG_IF (serverNss != 1, "Invalid nss for standard " << standard);
201  NS_ABORT_MSG_IF (clientChannelWidth != 22 && clientChannelWidth != 22, "Invalid channel width for standard " << standard);
202  NS_ABORT_MSG_IF (clientNss != 1, "Invalid nss for standard " << standard);
203  }
204  else if (standard == "802.11a" || standard == "802.11g")
205  {
206  NS_ABORT_MSG_IF (serverChannelWidth != 20, "Invalid channel width for standard " << standard);
207  NS_ABORT_MSG_IF (serverNss != 1, "Invalid nss for standard " << standard);
208  NS_ABORT_MSG_IF (clientChannelWidth != 20, "Invalid channel width for standard " << standard);
209  NS_ABORT_MSG_IF (clientNss != 1, "Invalid nss for standard " << standard);
210  }
211  else if (standard == "802.11n-5GHz" || standard == "802.11n-2.4GHz")
212  {
213  NS_ABORT_MSG_IF (serverChannelWidth != 20 && serverChannelWidth != 40, "Invalid channel width for standard " << standard);
214  NS_ABORT_MSG_IF (serverNss == 0 || serverNss > 4, "Invalid nss " << serverNss << " for standard " << standard);
215  NS_ABORT_MSG_IF (clientChannelWidth != 20 && clientChannelWidth != 40, "Invalid channel width for standard " << standard);
216  NS_ABORT_MSG_IF (clientNss == 0 || clientNss > 4, "Invalid nss " << clientNss << " for standard " << standard);
217  }
218  else if (standard == "802.11ac")
219  {
220  NS_ABORT_MSG_IF (serverChannelWidth != 20 && serverChannelWidth != 40 && serverChannelWidth != 80 && serverChannelWidth != 160, "Invalid channel width for standard " << standard);
221  NS_ABORT_MSG_IF (serverNss == 0 || serverNss > 4, "Invalid nss " << serverNss << " for standard " << standard);
222  NS_ABORT_MSG_IF (clientChannelWidth != 20 && clientChannelWidth != 40 && clientChannelWidth != 80 && clientChannelWidth != 160, "Invalid channel width for standard " << standard);
223  NS_ABORT_MSG_IF (clientNss == 0 || clientNss > 4, "Invalid nss " << clientNss << " for standard " << standard);
224  }
225  else if (standard == "802.11ax-5GHz" || standard == "802.11ax-2.4GHz")
226  {
227  NS_ABORT_MSG_IF (serverChannelWidth != 20 && serverChannelWidth != 40 && serverChannelWidth != 80 && serverChannelWidth != 160, "Invalid channel width for standard " << standard);
228  NS_ABORT_MSG_IF (serverNss == 0 || serverNss > 4, "Invalid nss " << serverNss << " for standard " << standard);
229  NS_ABORT_MSG_IF (clientChannelWidth != 20 && clientChannelWidth != 40 && clientChannelWidth != 80 && clientChannelWidth != 160, "Invalid channel width for standard " << standard);
230  NS_ABORT_MSG_IF (clientNss == 0 || clientNss > 4, "Invalid nss " << clientNss << " for standard " << standard);
231  }
232 
233  std::string plotName = "wifi-manager-example-";
234  std::string dataName = "wifi-manager-example-";
235  plotName += wifiManager;
236  dataName += wifiManager;
237  plotName += "-";
238  dataName += "-";
239  plotName += standard;
240  dataName += standard;
241  if (standard == "802.11n-5GHz" ||
242  standard == "802.11n-2.4GHz" ||
243  standard == "802.11ac" ||
244  standard == "802.11ax-5GHz" ||
245  standard == "802.11ax-2.4GHz")
246  {
247  plotName += "-server=";
248  dataName += "-server=";
249  std::ostringstream oss;
250  oss << serverChannelWidth << "MHz_" << serverShortGuardInterval << "ns_" << serverNss << "SS";
251  plotName += oss.str ();
252  dataName += oss.str ();
253  plotName += "-client=";
254  dataName += "-client=";
255  oss.str("");
256  oss << clientChannelWidth << "MHz_" << clientShortGuardInterval << "ns_" << clientNss << "SS";
257  plotName += oss.str ();
258  dataName += oss.str ();
259  }
260  plotName += ".eps";
261  dataName += ".plt";
262  std::ofstream outfile (dataName.c_str ());
263  Gnuplot gnuplot = Gnuplot (plotName);
264 
265  // As channel width increases, scale up plot's yRange value
266  uint32_t channelRateFactor = std::max (clientChannelWidth, serverChannelWidth) / 20;
267  channelRateFactor = channelRateFactor * std::max (clientNss, serverNss);
268 
269  // The first number is channel width, second is minimum SNR, third is maximum
270  // SNR, fourth and fifth provide xrange axis limits, and sixth the yaxis
271  // maximum
272  serverStandards.push_back (StandardInfo ("802.11a", WIFI_PHY_STANDARD_80211a, 20, 3, 27, 0, 30, 60));
273  serverStandards.push_back (StandardInfo ("802.11b", WIFI_PHY_STANDARD_80211b, 22, -5, 11, -6, 15, 15));
274  serverStandards.push_back (StandardInfo ("802.11g", WIFI_PHY_STANDARD_80211g, 20, -5, 27, -6, 30, 60));
275  serverStandards.push_back (StandardInfo ("802.11n-5GHz", WIFI_PHY_STANDARD_80211n_5GHZ, serverChannelWidth, 3, 30, 0, 35, 80 * channelRateFactor));
276  serverStandards.push_back (StandardInfo ("802.11n-2.4GHz", WIFI_PHY_STANDARD_80211n_2_4GHZ, serverChannelWidth, 3, 30, 0, 35, 80 * channelRateFactor));
277  serverStandards.push_back (StandardInfo ("802.11ac", WIFI_PHY_STANDARD_80211ac, serverChannelWidth, 5, 35, 0, 40, 120 * channelRateFactor));
278  serverStandards.push_back (StandardInfo ("802.11-holland", WIFI_PHY_STANDARD_holland, 20, 3, 27, 0, 30, 60));
279  serverStandards.push_back (StandardInfo ("802.11-10MHz", WIFI_PHY_STANDARD_80211_10MHZ, 10, 3, 27, 0, 30, 60));
280  serverStandards.push_back (StandardInfo ("802.11-5MHz", WIFI_PHY_STANDARD_80211_5MHZ, 5, 3, 27, 0, 30, 60));
281  serverStandards.push_back (StandardInfo ("802.11ax-5GHz", WIFI_PHY_STANDARD_80211ax_5GHZ, serverChannelWidth, 5, 55, 0, 60, 120 * channelRateFactor));
282  serverStandards.push_back (StandardInfo ("802.11ax-2.4GHz", WIFI_PHY_STANDARD_80211ax_2_4GHZ, serverChannelWidth, 5, 55, 0, 60, 120 * channelRateFactor));
283 
284  clientStandards.push_back (StandardInfo ("802.11a", WIFI_PHY_STANDARD_80211a, 20, 3, 27, 0, 30, 60));
285  clientStandards.push_back (StandardInfo ("802.11b", WIFI_PHY_STANDARD_80211b, 22, -5, 11, -6, 15, 15));
286  clientStandards.push_back (StandardInfo ("802.11g", WIFI_PHY_STANDARD_80211g, 20, -5, 27, -6, 30, 60));
287  clientStandards.push_back (StandardInfo ("802.11n-5GHz", WIFI_PHY_STANDARD_80211n_5GHZ, clientChannelWidth, 3, 30, 0, 35, 80 * channelRateFactor));
288  clientStandards.push_back (StandardInfo ("802.11n-2.4GHz", WIFI_PHY_STANDARD_80211n_2_4GHZ, clientChannelWidth, 3, 30, 0, 35, 80 * channelRateFactor));
289  clientStandards.push_back (StandardInfo ("802.11ac", WIFI_PHY_STANDARD_80211ac, clientChannelWidth, 5, 35, 0, 40, 120 * channelRateFactor));
290  clientStandards.push_back (StandardInfo ("802.11-holland", WIFI_PHY_STANDARD_holland, 20, 3, 27, 0, 30, 60));
291  clientStandards.push_back (StandardInfo ("802.11-10MHz", WIFI_PHY_STANDARD_80211_10MHZ, 10, 3, 27, 0, 30, 60));
292  clientStandards.push_back (StandardInfo ("802.11-5MHz", WIFI_PHY_STANDARD_80211_5MHZ, 5, 3, 27, 0, 30, 60));
293  clientStandards.push_back (StandardInfo ("802.11ax-5GHz", WIFI_PHY_STANDARD_80211ax_5GHZ, clientChannelWidth, 5, 45, 0, 50, 160 * channelRateFactor));
294  clientStandards.push_back (StandardInfo ("802.11ax-2.4GHz", WIFI_PHY_STANDARD_80211ax_2_4GHZ, clientChannelWidth, 5, 45, 0, 50, 160 * channelRateFactor));
295 
296  for (std::vector<StandardInfo>::size_type i = 0; i != serverStandards.size (); i++)
297  {
298  if (standard == serverStandards[i].m_name)
299  {
300  serverSelectedStandard = serverStandards[i];
301  }
302  }
303  for (std::vector<StandardInfo>::size_type i = 0; i != clientStandards.size (); i++)
304  {
305  if (standard == clientStandards[i].m_name)
306  {
307  clientSelectedStandard = clientStandards[i];
308  }
309  }
310 
311  NS_ABORT_IF (serverSelectedStandard.m_name == "none");
312  NS_ABORT_IF (clientSelectedStandard.m_name == "none");
313  std::cout << "Testing " << serverSelectedStandard.m_name << " with " << wifiManager << " ..." << std::endl;
314  NS_ABORT_MSG_IF (clientSelectedStandard.m_snrLow >= clientSelectedStandard.m_snrHigh, "SNR values in wrong order");
315  steps = std::abs ((int) (clientSelectedStandard.m_snrHigh - clientSelectedStandard.m_snrLow ) / stepSize) + 1;
316  NS_LOG_DEBUG ("Using " << steps << " steps for SNR range " << clientSelectedStandard.m_snrLow << ":" << clientSelectedStandard.m_snrHigh);
317  Ptr<Node> clientNode = CreateObject<Node> ();
318  Ptr<Node> serverNode = CreateObject<Node> ();
319 
321  wifi.SetStandard (serverSelectedStandard.m_standard);
323  wifiPhy.Set ("RxNoiseFigure", DoubleValue (0.0));
324  wifiPhy.Set ("EnergyDetectionThreshold", DoubleValue (-110.0));
325  wifiPhy.Set ("CcaMode1Threshold", DoubleValue (-110.0));
326 
327  Ptr<YansWifiChannel> wifiChannel = CreateObject<YansWifiChannel> ();
328  Ptr<ConstantSpeedPropagationDelayModel> delayModel = CreateObject<ConstantSpeedPropagationDelayModel> ();
329  wifiChannel->SetPropagationDelayModel (delayModel);
330  Ptr<FixedRssLossModel> rssLossModel = CreateObject<FixedRssLossModel> ();
331  wifiChannel->SetPropagationLossModel (rssLossModel);
332  wifiPhy.SetChannel (wifiChannel);
333 
334  wifi.SetRemoteStationManager ("ns3::" + wifiManager + "WifiManager", "RtsCtsThreshold", UintegerValue (rtsThreshold));
335 
336  NetDeviceContainer serverDevice;
337  NetDeviceContainer clientDevice;
338 
339  WifiMacHelper wifiMac;
340  if (infrastructure)
341  {
342  Ssid ssid = Ssid ("ns-3-ssid");
343  wifiMac.SetType ("ns3::StaWifiMac",
344  "Ssid", SsidValue (ssid),
345  "ActiveProbing", BooleanValue (false));
346  serverDevice = wifi.Install (wifiPhy, wifiMac, serverNode);
347  wifiMac.SetType ("ns3::ApWifiMac",
348  "Ssid", SsidValue (ssid),
349  "BeaconGeneration", BooleanValue (true));
350  clientDevice = wifi.Install (wifiPhy, wifiMac, clientNode);
351  }
352  else
353  {
354  wifiMac.SetType ("ns3::AdhocWifiMac",
355  "BE_MaxAmpduSize", UintegerValue (maxAmpduSize));
356  serverDevice = wifi.Install (wifiPhy, wifiMac, serverNode);
357  clientDevice = wifi.Install (wifiPhy, wifiMac, clientNode);
358  }
359 
360  if (wifiManager == "MinstrelHt")
361  {
362  Config::ConnectWithoutContext ("/NodeList/0/DeviceList/*/$ns3::WifiNetDevice/RemoteStationManager/$ns3::MinstrelHtWifiManager/RateChange", MakeCallback (&RateChangeMinstrelHt));
363  }
364  else
365  {
366  Config::ConnectWithoutContext ("/NodeList/0/DeviceList/*/$ns3::WifiNetDevice/RemoteStationManager/$ns3::" + wifiManager + "WifiManager/Rate", MakeCallback (&RateChange));
367  }
368  // Configure the mobility.
370  Ptr<ListPositionAllocator> positionAlloc = CreateObject<ListPositionAllocator> ();
371  //Initial position of AP and STA
372  positionAlloc->Add (Vector (ap1_x, ap1_y, 0.0));
373  NS_LOG_INFO ("Setting initial AP position to " << Vector (ap1_x, ap1_y, 0.0));
374  positionAlloc->Add (Vector (sta1_x, sta1_y, 0.0));
375  NS_LOG_INFO ("Setting initial STA position to " << Vector (sta1_x, sta1_y, 0.0));
376  mobility.SetPositionAllocator (positionAlloc);
377  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
378  mobility.Install (clientNode);
379  mobility.Install (serverNode);
380 
381  Gnuplot2dDataset rateDataset (clientSelectedStandard.m_name + std::string ("-rate selected"));
382  Gnuplot2dDataset actualDataset (clientSelectedStandard.m_name + std::string ("-observed"));
383  struct Step step;
384  step.stepSize = stepSize;
385  step.stepTime = stepTime;
386 
387  // Perform post-install configuration from defaults for channel width,
388  // guard interval, and nss, if necessary
389  // Obtain pointer to the WifiPhy
390  Ptr<NetDevice> ndClient = clientDevice.Get (0);
391  Ptr<NetDevice> ndServer = serverDevice.Get (0);
392  Ptr<WifiNetDevice> wndClient = ndClient->GetObject<WifiNetDevice> ();
393  Ptr<WifiNetDevice> wndServer = ndServer->GetObject<WifiNetDevice> ();
394  Ptr<WifiPhy> wifiPhyPtrClient = wndClient->GetPhy ();
395  Ptr<WifiPhy> wifiPhyPtrServer = wndServer->GetPhy ();
396  wifiPhyPtrClient->SetNumberOfAntennas (clientNss);
397  wifiPhyPtrClient->SetMaxSupportedTxSpatialStreams (clientNss);
398  wifiPhyPtrClient->SetMaxSupportedRxSpatialStreams (clientNss);
399  wifiPhyPtrServer->SetNumberOfAntennas (serverNss);
400  wifiPhyPtrServer->SetMaxSupportedTxSpatialStreams (serverNss);
401  wifiPhyPtrServer->SetMaxSupportedRxSpatialStreams (serverNss);
402  // Only set the channel width and guard interval for HT and VHT modes
403  if (serverSelectedStandard.m_name == "802.11n-5GHz"
404  || serverSelectedStandard.m_name == "802.11n-2.4GHz"
405  || serverSelectedStandard.m_name == "802.11ac")
406  {
407  wifiPhyPtrServer->SetChannelWidth (serverSelectedStandard.m_width);
408  wifiPhyPtrServer->SetShortGuardInterval (serverShortGuardInterval == 400);
409  wifiPhyPtrClient->SetChannelWidth (clientSelectedStandard.m_width);
410  wifiPhyPtrClient->SetShortGuardInterval (clientShortGuardInterval == 400);
411  }
412  else if (serverSelectedStandard.m_name == "802.11ax-5GHz"
413  || serverSelectedStandard.m_name == "802.11ax-2.4GHz")
414  {
415  wifiPhyPtrServer->SetChannelWidth (serverSelectedStandard.m_width);
416  wifiPhyPtrServer->SetGuardInterval (NanoSeconds (serverShortGuardInterval));
417  wifiPhyPtrClient->SetChannelWidth (clientSelectedStandard.m_width);
418  wifiPhyPtrClient->SetGuardInterval (NanoSeconds (clientShortGuardInterval));
419  }
420  NS_LOG_DEBUG ("Channel width " << wifiPhyPtrClient->GetChannelWidth () << " noiseDbm " << noiseDbm);
421  NS_LOG_DEBUG ("NSS " << wifiPhyPtrClient->GetMaxSupportedTxSpatialStreams ());
422 
423  // Configure signal and noise, and schedule first iteration
424  noiseDbm += 10 * log10 (clientSelectedStandard.m_width * 1000000);
425  double rssCurrent = (clientSelectedStandard.m_snrHigh + noiseDbm);
426  rssLossModel->SetRss (rssCurrent);
427  NS_LOG_INFO ("Setting initial Rss to " << rssCurrent);
428  //Move the STA by stepsSize meters every stepTime seconds
429  Simulator::Schedule (Seconds (0.5 + stepTime), &ChangeSignalAndReportRate, rssLossModel, step, rssCurrent, rateDataset, actualDataset);
430 
431  PacketSocketHelper packetSocketHelper;
432  packetSocketHelper.Install (serverNode);
433  packetSocketHelper.Install (clientNode);
434 
435  PacketSocketAddress socketAddr;
436  socketAddr.SetSingleDevice (serverDevice.Get (0)->GetIfIndex ());
437  if (broadcast)
438  {
439  socketAddr.SetPhysicalAddress (serverDevice.Get (0)->GetBroadcast ());
440  }
441  else
442  {
443  socketAddr.SetPhysicalAddress (serverDevice.Get (0)->GetAddress ());
444  }
445  // Arbitrary protocol type.
446  // Note: PacketSocket doesn't have any L4 multiplexing or demultiplexing
447  // The only mux/demux is based on the protocol field
448  socketAddr.SetProtocol (1);
449 
450  Ptr<PacketSocketClient> client = CreateObject<PacketSocketClient> ();
451  client->SetRemote (socketAddr);
452  client->SetStartTime (Seconds (0.5)); // allow simulation warmup
453  client->SetAttribute ("MaxPackets", UintegerValue (0)); // unlimited
454  client->SetAttribute ("PacketSize", UintegerValue (packetSize));
455 
456  // Set a maximum rate 10% above the yMax specified for the selected standard
457  double rate = clientSelectedStandard.m_yMax * 1e6 * 1.10;
458  double clientInterval = static_cast<double> (packetSize) * 8 / rate;
459  NS_LOG_DEBUG ("Setting interval to " << clientInterval << " sec for rate of " << rate << " bits/sec");
460 
461  client->SetAttribute ("Interval", TimeValue (Seconds (clientInterval)));
462  clientNode->AddApplication (client);
463 
464  Ptr<PacketSocketServer> server = CreateObject<PacketSocketServer> ();
465  server->SetLocal (socketAddr);
467  serverNode->AddApplication (server);
468 
469  Simulator::Stop (Seconds ((steps + 1) * stepTime));
470  Simulator::Run ();
472 
473  gnuplot.AddDataset (rateDataset);
474  gnuplot.AddDataset (actualDataset);
475 
476  std::ostringstream xMinStr, xMaxStr, yMaxStr;
477  std::string xRangeStr ("set xrange [");
478  xMinStr << clientSelectedStandard.m_xMin;
479  xRangeStr.append (xMinStr.str ());
480  xRangeStr.append (":");
481  xMaxStr << clientSelectedStandard.m_xMax;
482  xRangeStr.append (xMaxStr.str ());
483  xRangeStr.append ("]");
484  std::string yRangeStr ("set yrange [0:");
485  yMaxStr << clientSelectedStandard.m_yMax;
486  yRangeStr.append (yMaxStr.str ());
487  yRangeStr.append ("]");
488 
489  std::string title ("Results for ");
490  title.append (standard);
491  title.append (" with ");
492  title.append (wifiManager);
493  title.append ("\\n");
494  if (standard == "802.11n-5GHz"
495  || standard == "802.11n-2.4GHz"
496  || standard == "802.11ac"
497  || standard == "802.11n-5GHz"
498  || standard == "802.11ax-2.4GHz")
499  {
500  std::ostringstream serverGiStrStr;
501  std::ostringstream serverWidthStrStr;
502  std::ostringstream serverNssStrStr;
503  title.append ("server: width=");
504  serverWidthStrStr << serverSelectedStandard.m_width;
505  title.append (serverWidthStrStr.str ());
506  title.append ("MHz");
507  title.append (" GI=");
508  serverGiStrStr << serverShortGuardInterval;
509  title.append (serverGiStrStr.str ());
510  title.append ("ns");
511  title.append (" nss=");
512  serverNssStrStr << serverNss;
513  title.append (serverNssStrStr.str ());
514  title.append ("\\n");
515  std::ostringstream clientGiStrStr;
516  std::ostringstream clientWidthStrStr;
517  std::ostringstream clientNssStrStr;
518  title.append ("client: width=");
519  clientWidthStrStr << clientSelectedStandard.m_width;
520  title.append (clientWidthStrStr.str ());
521  title.append ("MHz");
522  title.append (" GI=");
523  clientGiStrStr << clientShortGuardInterval;
524  title.append (clientGiStrStr.str ());
525  title.append ("ns");
526  title.append (" nss=");
527  clientNssStrStr << clientNss;
528  title.append (clientNssStrStr.str ());
529  }
530  gnuplot.SetTerminal ("postscript eps color enh \"Times-BoldItalic\"");
531  gnuplot.SetLegend ("SNR (dB)", "Rate (Mb/s)");
532  gnuplot.SetTitle (title);
533  gnuplot.SetExtra (xRangeStr);
534  gnuplot.AppendExtra (yRangeStr);
535  gnuplot.AppendExtra ("set key top left");
536  gnuplot.GenerateOutput (outfile);
537  outfile.close ();
538 
539  return 0;
540 }
541 
ERP-OFDM PHY (Clause 19, Section 19.5)
void Set(std::string name, const AttributeValue &v)
Definition: wifi-helper.cc:132
uint32_t AddApplication(Ptr< Application > application)
Associate an Application to this Node.
Definition: node.cc:157
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
OFDM PHY for the 5 GHz band (Clause 17 with 5 MHz channel bandwidth)
AttributeValue implementation for Boolean.
Definition: boolean.h:36
void SetLocal(PacketSocketAddress addr)
set the local address and protocol to be used
void SetPropagationLossModel(const Ptr< PropagationLossModel > loss)
HT PHY for the 5 GHz band (clause 20)
Class to represent a 2D points plot.
Definition: gnuplot.h:117
double m_yMax
Y maximum.
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
Definition: object.h:459
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr stored in this container at a given index.
Make it easy to create and manage PHY objects for the yans model.
an address for a packet socket
static void Run(void)
Run the simulation.
Definition: simulator.cc:226
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
HE PHY for the 2.4 GHz band (clause 26)
uint32_t GetSize(void) const
Returns the the size in bytes of the packet (including the zero-filled initial payload).
Definition: packet.h:796
second
Definition: nstime.h:114
OFDM PHY for the 5 GHz band (Clause 17 with 10 MHz channel bandwidth)
double m_snrLow
lowest SNR
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:277
const double NOISE_DBM_Hz
HT PHY for the 2.4 GHz band (clause 20)
static YansWifiPhyHelper Default(void)
Create a phy helper in a default working state.
double stepSize
step size in dBm
helps to create WifiNetDevice objects
Definition: wifi-helper.h:213
void ChangeSignalAndReportRate(Ptr< FixedRssLossModel > rssModel, struct Step step, double rss, Gnuplot2dDataset &rateDataset, Gnuplot2dDataset &actualDataset)
Give ns3::PacketSocket powers to ns3::Node.
tuple cmd
Definition: second.py:35
void SetSingleDevice(uint32_t device)
Set the address to match only a specified NetDevice.
a polymophic address class
Definition: address.h:90
void SetChannel(Ptr< YansWifiChannel > channel)
WifiPhyStandard
Identifies the PHY specification that a Wifi device is configured to use.
Ptr< WifiPhy > GetPhy(void) const
void SetPropagationDelayModel(const Ptr< PropagationDelayModel > delay)
HE PHY for the 5 GHz band (clause 26)
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:1375
a simple class to generate gnuplot-ready plotting commands from a set of datasets.
Definition: gnuplot.h:371
#define max(a, b)
Definition: 80211b.c:45
AttributeValue implementation for Time.
Definition: nstime.h:1055
Time NanoSeconds(uint64_t value)
Construct a Time in the indicated unit.
Definition: nstime.h:1017
Hold an unsigned integer type.
Definition: uinteger.h:44
Step structure.
holds a vector of ns3::NetDevice pointers
std::string m_name
name
Hold together all Wifi-related objects.
Callback< R > MakeCallback(R(T::*memPtr)(void), OBJ objPtr)
Definition: callback.h:1489
void ConnectWithoutContext(std::string path, const CallbackBase &cb)
Definition: config.cc:832
void Add(double x, double y)
Definition: gnuplot.cc:359
void PacketRx(Ptr< const Packet > pkt, const Address &addr)
Parse command-line arguments.
Definition: command-line.h:205
static void Destroy(void)
Execute the events scheduled with ScheduleDestroy().
Definition: simulator.cc:190
This is intended to be the configuration used in this paper: Gavin Holland, Nitin Vaidya and Paramvir...
double m_snrHigh
highest SNR
enum WifiPhyStandard m_standard
standard
void RateChangeMinstrelHt(uint64_t newVal, Mac48Address dest)
double noiseDbm
bool TraceConnectWithoutContext(std::string name, const CallbackBase &cb)
Connect a TraceSource to a Callback without a context.
Definition: object-base.cc:293
OFDM PHY for the 5 GHz band (Clause 17)
Every class exported by the ns3 library is enclosed in the ns3 namespace.
void SetPhysicalAddress(const Address address)
Set the destination address.
virtual void SetChannelWidth(uint8_t channelwidth)
Definition: wifi-phy.cc:1296
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 SetShortGuardInterval(bool shortGuardInterval)
Enable or disable support for HT/VHT short guard interval.
Definition: wifi-phy.cc:630
void SetMaxSupportedRxSpatialStreams(uint8_t streams)
Definition: wifi-phy.cc:1338
an EUI-48 address
Definition: mac48-address.h:43
tuple ssid
Definition: third.py:93
void Install(Ptr< Node > node) const
Aggregate an instance of a ns3::PacketSocketFactory onto the provided node.
create MAC layers for a ns3::WifiNetDevice.
static Time Now(void)
Return the current simulation virtual time.
Definition: simulator.cc:249
void SetGuardInterval(Time guardInterval)
Definition: wifi-phy.cc:643
The IEEE 802.11 SSID Information Element.
Definition: ssid.h:35
double m_xMax
X maximum.
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())
StandardInfo structure.
Helper class used to assign positions and mobility models to nodes.
#define NS_ABORT_IF(cond)
Abnormal program termination if a condition is true.
Definition: abort.h:77
uint16_t m_width
channel width
void SetMaxSupportedTxSpatialStreams(uint8_t streams)
Definition: wifi-phy.cc:1324
double m_xMin
X minimum.
#define NS_ABORT_MSG_IF(cond, msg)
Abnormal program termination if a condition is true, with a message.
Definition: abort.h:108
void SetRemote(PacketSocketAddress addr)
set the remote address and protocol to be used
void AddValue(const std::string &name, const std::string &help, T &value)
Add a program argument, assigning to POD.
Definition: command-line.h:498
static void Stop(void)
Tell the Simulator the calling event should be the last one executed.
Definition: simulator.cc:234
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Definition: log.h:269
double g_intervalBytes
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:993
AttributeValue implementation for Ssid.
Definition: ssid.h:117
double stepTime
step size in seconds
void SetProtocol(uint16_t protocol)
Set the protocol.
void Add(Vector v)
Add a position to the list of positions.
void Parse(int argc, char *argv[])
Parse the program arguments.
tuple wifi
Definition: third.py:89
void SetNumberOfAntennas(uint8_t antennas)
Definition: wifi-phy.cc:1310
static const uint32_t packetSize
void SetPositionAllocator(Ptr< PositionAllocator > allocator)
Set the position allocator which will be used to allocate the initial position of every node initiali...
void RateChange(uint64_t oldVal, uint64_t newVal)
This class can be used to hold variables of floating point type such as 'double' or 'float'...
Definition: double.h:41
StandardInfo(std::string name, enum WifiPhyStandard standard, uint16_t width, double snrLow, double snrHigh, double xMin, double xMax, double yMax)
Constructor.
uint64_t g_intervalRate
void SetAttribute(std::string name, const AttributeValue &value)
Set a single attribute, raising fatal errors if unsuccessful.
Definition: object-base.cc:185
void SetStartTime(Time start)
Specify application start time.
Definition: application.cc:69