A Discrete-Event Network Simulator
API
wifi-issue-211-test-suite.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2020
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: Stefano Avallone <stavallo@unina.it>
19  * Rémy Grünblatt <remy@grunblatt.org>
20  */
21 
22 #include "ns3/test.h"
23 #include "ns3/string.h"
24 #include "ns3/boolean.h"
25 #include "ns3/qos-utils.h"
26 #include "ns3/packet.h"
27 #include "ns3/wifi-net-device.h"
28 #include "ns3/ap-wifi-mac.h"
29 #include "ns3/mobility-helper.h"
30 #include "ns3/spectrum-wifi-helper.h"
31 #include "ns3/multi-model-spectrum-channel.h"
32 #include "ns3/udp-client-server-helper.h"
33 #include "ns3/internet-stack-helper.h"
34 #include "ns3/ipv4-address-helper.h"
35 #include "ns3/rng-seed-manager.h"
36 #include "ns3/config.h"
37 #include "ns3/queue-size.h"
38 
39 using namespace ns3;
40 
41 
59 class Issue211Test : public TestCase
60 {
61 public:
65  Issue211Test ();
66  virtual ~Issue211Test ();
67 
68  virtual void DoRun (void);
69 
70 private:
75  void CalcThroughput (Ptr<UdpServer> server);
76 
77  std::vector<double> m_tputValues;
78  uint64_t m_lastRxBytes;
80  uint32_t m_payloadSize;
81 };
82 
84  : TestCase ("Test case for resuming data transmission when the recipient moves back"),
85  m_lastRxBytes (0),
86  m_lastCheckPointTime (Seconds (0)),
87  m_payloadSize (2000)
88 {
89 }
90 
92 {
93 }
94 
95 void
97 {
98  uint64_t rxBytes = m_payloadSize * server->GetReceived ();
99  double tput = (rxBytes - m_lastRxBytes) * 8. / (Simulator::Now () - m_lastCheckPointTime).ToDouble (Time::US); // Mb/s
100  m_tputValues.push_back (tput);
101  m_lastRxBytes = rxBytes;
103 }
104 
105 void
107 {
108  Time simulationTime (Seconds (6.0));
109  Time moveAwayTime (Seconds (2.0));
110  Time moveBackTime (Seconds (4.0));
111 
112  RngSeedManager::SetSeed (1);
113  RngSeedManager::SetRun (40);
114  int64_t streamNumber = 100;
115 
117  wifiApNode.Create (1);
118 
119  NodeContainer wifiStaNode;
120  wifiStaNode.Create (1);
121 
122  Ptr<MultiModelSpectrumChannel> spectrumChannel = CreateObject<MultiModelSpectrumChannel> ();
123  Ptr<FriisPropagationLossModel> lossModel = CreateObject<FriisPropagationLossModel> ();
124  spectrumChannel->AddPropagationLossModel (lossModel);
125  Ptr<ConstantSpeedPropagationDelayModel> delayModel = CreateObject<ConstantSpeedPropagationDelayModel> ();
126  spectrumChannel->SetPropagationDelayModel (delayModel);
127 
129  phy.SetChannel (spectrumChannel);
130 
132  wifi.SetStandard (WIFI_STANDARD_80211n);
133  wifi.SetRemoteStationManager ("ns3::ConstantRateWifiManager",
134  "DataMode", StringValue ("HtMcs0"),
135  "ControlMode", StringValue ("HtMcs0"));
136 
137  Config::SetDefault ("ns3::WifiMacQueue::MaxSize", QueueSizeValue (QueueSize ("50p")));
138 
140  mac.SetType ("ns3::StaWifiMac",
141  "Ssid", SsidValue (Ssid ("issue211-test")));
142 
143  NetDeviceContainer staDevices = wifi.Install (phy, mac, wifiStaNode);
144 
145  mac.SetType ("ns3::ApWifiMac",
146  "Ssid", SsidValue (Ssid ("issue211-test")),
147  "EnableBeaconJitter", BooleanValue (false));
148 
150 
151  // Assign fixed streams to random variables in use
152  wifi.AssignStreams (apDevices, streamNumber);
153 
155  Ptr<ListPositionAllocator> positionAlloc = CreateObject<ListPositionAllocator> ();
156 
157  positionAlloc->Add (Vector (0.0, 0.0, 0.0));
158  positionAlloc->Add (Vector (5.0, 0.0, 0.0));
159  mobility.SetPositionAllocator (positionAlloc);
160 
161  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
162  mobility.Install (wifiApNode);
163  mobility.Install (wifiStaNode);
164 
165  /* Internet stack*/
167  stack.Install (wifiApNode);
168  stack.Install (wifiStaNode);
169 
171  address.SetBase ("192.168.1.0", "255.255.255.0");
172  Ipv4InterfaceContainer staNodeInterface;
173  Ipv4InterfaceContainer apNodeInterface;
174 
175  staNodeInterface = address.Assign (staDevices.Get (0));
176  apNodeInterface = address.Assign (apDevices.Get (0));
177 
178  ApplicationContainer serverApp;
179  Time warmup (Seconds (1.0)); // to account for association
180 
181  uint16_t port = 9;
182  UdpServerHelper server (port);
183  serverApp = server.Install (wifiStaNode.Get (0));
184  serverApp.Start (Seconds (0.0));
185  serverApp.Stop (warmup + simulationTime);
186 
187  UdpClientHelper client (staNodeInterface.GetAddress (0), port);
188  client.SetAttribute ("MaxPackets", UintegerValue (4294967295u));
189  client.SetAttribute ("Interval", TimeValue (MilliSeconds (1)));
190  client.SetAttribute ("PacketSize", UintegerValue (m_payloadSize)); // 16 Mb/s
191  ApplicationContainer clientApp = client.Install (wifiApNode.Get (0));
192  clientApp.Start (warmup);
193  clientApp.Stop (warmup + simulationTime);
194 
195  Ptr<MobilityModel> staMobility = wifiStaNode.Get (0)->GetObject<MobilityModel> ();
196 
197  // First check-point: station moves away
198  Simulator::Schedule (warmup + moveAwayTime, &MobilityModel::SetPosition, staMobility,
199  Vector (10000.0, 0.0, 0.0));
200  Simulator::Schedule (warmup + moveAwayTime + MilliSeconds (10), &Issue211Test::CalcThroughput, this,
201  DynamicCast<UdpServer> (serverApp.Get (0)));
202 
203  // Second check-point: station moves back
204  Simulator::Schedule (warmup + moveBackTime, &MobilityModel::SetPosition, staMobility,
205  Vector (5.0, 0.0, 0.0));
206  Simulator::Schedule (warmup + moveBackTime, &Issue211Test::CalcThroughput, this,
207  DynamicCast<UdpServer> (serverApp.Get (0)));
208 
209  // Last check-point: simulation finish time
210  Simulator::Schedule (warmup + simulationTime, &Issue211Test::CalcThroughput, this,
211  DynamicCast<UdpServer> (serverApp.Get (0)));
212 
213  Simulator::Stop (warmup + simulationTime);
214  Simulator::Run ();
215 
216  NS_TEST_EXPECT_MSG_EQ (m_tputValues.size (), 3, "Unexpected number of throughput values");
217  NS_TEST_EXPECT_MSG_GT (m_tputValues[0], 0, "Throughput must be non null before station moves away");
218  NS_TEST_EXPECT_MSG_EQ (m_tputValues[1], 0,"Throughput must be null while the station is away");
219  NS_TEST_EXPECT_MSG_GT (m_tputValues[2], 0, "Throughput must be non null when the station is back");
220 
221  // Print throughput values when the test is run through test-runner
222  for (const auto& t : m_tputValues)
223  {
224  std::cout << "Throughput = " << t << " Mb/s" << std::endl;
225  }
226 
227  Simulator::Destroy ();
228 }
229 
237 {
238 public:
240 };
241 
243  : TestSuite ("wifi-issue-211", UNIT)
244 {
245  AddTestCase (new Issue211Test, TestCase::QUICK);
246 }
247 
Test for issue 211 (https://gitlab.com/nsnam/ns-3-dev/-/issues/211)
std::vector< double > m_tputValues
throughput in sub-intervals
Time m_lastCheckPointTime
time of last check-point
virtual void DoRun(void)
Implementation to actually run this TestCase.
Issue211Test()
Constructor.
uint32_t m_payloadSize
payload size in bytes
uint64_t m_lastRxBytes
RX bytes at last check-point.
void CalcThroughput(Ptr< UdpServer > server)
Compute the average throughput since the last check-point.
Block Ack Test Suite.
holds a vector of ns3::Application pointers.
Ptr< Application > Get(uint32_t i) const
Get the Ptr<Application> stored in this container at a given index.
void Start(Time start)
Arrange for all of the Applications in this container to Start() at the Time given as a parameter.
void Stop(Time stop)
Arrange for all of the Applications in this container to Stop() at the Time given as a parameter.
AttributeValue implementation for Boolean.
Definition: boolean.h:37
aggregate IP/TCP/UDP functionality to existing Nodes.
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
holds a vector of std::pair of Ptr<Ipv4> and interface index.
Ipv4Address GetAddress(uint32_t i, uint32_t j=0) const
Helper class used to assign positions and mobility models to nodes.
Keep track of the current position and velocity of an object.
holds a vector of ns3::NetDevice pointers
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.
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
Definition: object.h:470
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:74
Class for representing queue sizes.
Definition: queue-size.h:95
AttributeValue implementation for QueueSize.
Definition: queue-size.h:221
Make it easy to create and manage PHY objects for the spectrum model.
The IEEE 802.11 SSID Information Element.
Definition: ssid.h:36
AttributeValue implementation for Ssid.
Definition: ssid.h:105
Hold variables of type string.
Definition: string.h:41
encapsulates test code
Definition: test.h:994
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite.
Definition: test.cc:299
A suite of tests to run.
Definition: test.h:1188
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:103
AttributeValue implementation for Time.
Definition: nstime.h:1308
Create a client application which sends UDP packets carrying a 32bit sequence number and a 64 bit tim...
void SetAttribute(std::string name, const AttributeValue &value)
Record an attribute to be set in each Application after it is is created.
ApplicationContainer Install(NodeContainer c)
Create a server application which waits for input UDP packets and uses the information carried into t...
ApplicationContainer Install(NodeContainer c)
Create one UDP server application on each of the Nodes in the NodeContainer.
Hold an unsigned integer type.
Definition: uinteger.h:44
helps to create WifiNetDevice objects
Definition: wifi-helper.h:274
create MAC layers for a ns3::WifiNetDevice.
uint16_t port
Definition: dsdv-manet.cc:45
void SetDefault(std::string name, const AttributeValue &value)
Definition: config.cc:849
Time Now(void)
create an ns3::Time instance which contains the current simulation time.
Definition: simulator.cc:287
#define NS_TEST_EXPECT_MSG_GT(actual, limit, msg)
Test that an actual value is greater than a limit and report if not.
Definition: test.h:899
#define NS_TEST_EXPECT_MSG_EQ(actual, limit, msg)
Test that an actual and expected (limit) value are equal and report if not.
Definition: test.h:240
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1244
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
Definition: nstime.h:1252
@ WIFI_STANDARD_80211n
address
Definition: first.py:44
stack
Definition: first.py:41
Every class exported by the ns3 library is enclosed in the ns3 namespace.
staDevices
Definition: third.py:103
mac
Definition: third.py:99
wifi
Definition: third.py:96
apDevices
Definition: third.py:106
wifiApNode
Definition: third.py:90
mobility
Definition: third.py:108
phy
Definition: third.py:93
static void SetPosition(Ptr< Node > node, Vector position)
Definition: wifi-ap.cc:89
static Issue211TestSuite g_issue211TestSuite
the test suite