9#include "ns3/attribute-container.h"
10#include "ns3/boolean.h"
11#include "ns3/command-line.h"
12#include "ns3/config.h"
13#include "ns3/double.h"
15#include "ns3/he-phy.h"
16#include "ns3/internet-stack-helper.h"
17#include "ns3/ipv4-address-helper.h"
18#include "ns3/ipv4-global-routing-helper.h"
20#include "ns3/mobility-helper.h"
21#include "ns3/multi-model-spectrum-channel.h"
22#include "ns3/on-off-helper.h"
23#include "ns3/packet-sink-helper.h"
24#include "ns3/packet-sink.h"
25#include "ns3/spectrum-wifi-helper.h"
27#include "ns3/string.h"
28#include "ns3/udp-client-server-helper.h"
29#include "ns3/udp-server.h"
30#include "ns3/uinteger.h"
31#include "ns3/wifi-acknowledgment.h"
32#include "ns3/yans-wifi-channel.h"
33#include "ns3/yans-wifi-helper.h"
61main(
int argc,
char* argv[])
66 bool use80Plus80{
false};
67 bool useExtendedBlockAck{
false};
68 Time simulationTime{
"10s"};
71 std::size_t nStations{1};
72 std::string dlAckSeqType{
"NO-OFDMA"};
73 bool enableUlOfdma{
false};
74 bool enableBsrp{
false};
76 std::vector<uint64_t> mcsValues;
78 int guardInterval{-1};
81 std::string phyModel{
"Yans"};
82 double minExpectedThroughput{0.0};
83 double maxExpectedThroughput{0.0};
84 Time accessReqInterval{0};
87 cmd.AddValue(
"frequency",
88 "Whether working in the 2.4, 5 or 6 GHz band (other values gets rejected)",
90 cmd.AddValue(
"distance",
91 "Distance in meters between the station and the access point",
93 cmd.AddValue(
"simulationTime",
"Simulation time", simulationTime);
94 cmd.AddValue(
"udp",
"UDP if set to 1, TCP otherwise", udp);
95 cmd.AddValue(
"downlink",
96 "Generate downlink flows if set to 1, uplink flows otherwise",
98 cmd.AddValue(
"useRts",
"Enable/disable RTS/CTS", useRts);
99 cmd.AddValue(
"use80Plus80",
"Enable/disable use of 80+80 MHz", use80Plus80);
100 cmd.AddValue(
"useExtendedBlockAck",
"Enable/disable use of extended BACK", useExtendedBlockAck);
101 cmd.AddValue(
"nStations",
"Number of non-AP HE stations", nStations);
102 cmd.AddValue(
"dlAckType",
103 "Ack sequence type for DL OFDMA (NO-OFDMA, ACK-SU-FORMAT, MU-BAR, AGGR-MU-BAR)",
105 cmd.AddValue(
"enableUlOfdma",
106 "Enable UL OFDMA (useful if DL OFDMA is enabled and TCP is used)",
108 cmd.AddValue(
"enableBsrp",
109 "Enable BSRP (useful if DL and UL OFDMA are enabled and TCP is used)",
112 "muSchedAccessReqInterval",
113 "Duration of the interval between two requests for channel access made by the MU scheduler",
117 "list of comma separated MCS values to test; if unset, all MCS values (0-11) are tested",
119 cmd.AddValue(
"channelWidth",
120 "if set, limit testing to a specific channel width expressed in MHz (20, 40, 80 "
123 cmd.AddValue(
"guardInterval",
124 "if set, limit testing to a specific guard interval duration expressed in "
125 "nanoseconds (800, 1600 or 3200 ns)",
127 cmd.AddValue(
"payloadSize",
"The application payload size in bytes", payloadSize);
128 cmd.AddValue(
"phyModel",
129 "PHY model to use when OFDMA is disabled (Yans or Spectrum). If 80+80 MHz or "
131 "then Spectrum is automatically selected",
133 cmd.AddValue(
"minExpectedThroughput",
134 "if set, simulation fails if the lowest throughput is below this value",
135 minExpectedThroughput);
136 cmd.AddValue(
"maxExpectedThroughput",
137 "if set, simulation fails if the highest throughput is above this value",
138 maxExpectedThroughput);
139 cmd.Parse(argc, argv);
147 if (dlAckSeqType ==
"ACK-SU-FORMAT")
152 else if (dlAckSeqType ==
"MU-BAR")
157 else if (dlAckSeqType ==
"AGGR-MU-BAR")
162 else if (dlAckSeqType !=
"NO-OFDMA")
164 NS_ABORT_MSG(
"Invalid DL ack sequence type (must be NO-OFDMA, ACK-SU-FORMAT, MU-BAR or "
168 if (phyModel !=
"Yans" && phyModel !=
"Spectrum")
170 NS_ABORT_MSG(
"Invalid PHY model (must be Yans or Spectrum)");
172 if (use80Plus80 || (dlAckSeqType !=
"NO-OFDMA"))
175 phyModel =
"Spectrum";
178 double prevThroughput[12] = {0};
180 std::cout <<
"MCS value"
186 <<
"Throughput" <<
'\n';
192 for (uint8_t mcs = minMcs; mcs <= maxMcs; ++mcs)
194 mcsValues.push_back(mcs);
202 attr.DeserializeFromString(mcsStr, checker);
203 mcsValues = attr.Get();
204 std::sort(mcsValues.begin(), mcsValues.end());
207 int minChannelWidth = 20;
208 int maxChannelWidth = frequency == 2.4 ? 40 : 160;
209 if ((channelWidth != -1) &&
210 ((channelWidth < minChannelWidth) || (channelWidth > maxChannelWidth)))
212 NS_FATAL_ERROR(
"Invalid channel width: " << channelWidth <<
" MHz");
214 if (channelWidth >= minChannelWidth && channelWidth <= maxChannelWidth)
216 minChannelWidth = channelWidth;
217 maxChannelWidth = channelWidth;
219 int minGi = enableUlOfdma ? 1600 : 800;
221 if (guardInterval >= minGi && guardInterval <= maxGi)
223 minGi = guardInterval;
224 maxGi = guardInterval;
227 for (
const auto mcs : mcsValues)
231 for (
int width = minChannelWidth; width <= maxChannelWidth; width *= 2)
233 const auto is80Plus80 = (use80Plus80 && (width == 160));
234 const std::string widthStr = is80Plus80 ?
"80+80" : std::to_string(width);
235 const auto segmentWidthStr = is80Plus80 ?
"80" : widthStr;
236 for (
int gi = maxGi; gi >= minGi; gi /= 2)
252 std::string channelStr(
"{0, " + segmentWidthStr +
", ");
256 std::ostringstream ossDataMode;
257 ossDataMode <<
"HeMcs" << mcs;
262 channelStr +=
"BAND_6GHZ, 0}";
266 else if (frequency == 5)
268 std::ostringstream ossControlMode;
269 ossControlMode <<
"OfdmRate" << nonHtRefRateMbps <<
"Mbps";
271 channelStr +=
"BAND_5GHZ, 0}";
273 else if (frequency == 2.4)
275 std::ostringstream ossControlMode;
276 ossControlMode <<
"ErpOfdmRate" << nonHtRefRateMbps <<
"Mbps";
278 channelStr +=
"BAND_2_4GHZ, 0}";
289 channelStr += std::string(
";") + channelStr;
293 wifi.SetRemoteStationManager(
"ns3::ConstantRateWifiManager",
303 if (phyModel ==
"Spectrum")
308 spectrumChannel->AddPropagationLossModel(lossModel);
312 phy.SetChannel(spectrumChannel);
314 mac.SetType(
"ns3::StaWifiMac",
322 if (dlAckSeqType !=
"NO-OFDMA")
324 mac.SetMultiUserScheduler(
"ns3::RrMultiUserScheduler",
332 mac.SetType(
"ns3::ApWifiMac",
333 "EnableBeaconJitter",
337 apDevice =
wifi.Install(phy, mac, wifiApNode);
346 mac.SetType(
"ns3::StaWifiMac",
354 mac.SetType(
"ns3::ApWifiMac",
355 "EnableBeaconJitter",
359 apDevice =
wifi.Install(phy, mac, wifiApNode);
362 int64_t streamNumber = 150;
370 positionAlloc->Add(Vector(0.0, 0.0, 0.0));
371 positionAlloc->Add(Vector(distance, 0.0, 0.0));
372 mobility.SetPositionAllocator(positionAlloc);
374 mobility.SetMobilityModel(
"ns3::ConstantPositionMobilityModel");
381 stack.Install(wifiApNode);
382 stack.Install(wifiStaNodes);
383 streamNumber +=
stack.AssignStreams(wifiApNode, streamNumber);
384 streamNumber +=
stack.AssignStreams(wifiStaNodes, streamNumber);
387 address.SetBase(
"192.168.1.0",
"255.255.255.0");
391 staNodeInterfaces =
address.Assign(staDevices);
392 apNodeInterface =
address.Assign(apDevice);
396 auto serverNodes = downlink ? std::ref(wifiStaNodes) :
std::ref(
wifiApNode);
399 for (std::size_t i = 0; i < nStations; i++)
402 : apNodeInterface.Get(0));
414 serverApp =
server.Install(serverNodes.get());
415 streamNumber +=
server.AssignStreams(serverNodes.get(), streamNumber);
419 const auto packetInterval = payloadSize * 8.0 / maxLoad;
421 for (std::size_t i = 0; i < nStations; i++)
428 streamNumber +=
client.AssignStreams(clientNodes.
Get(i), streamNumber);
437 uint16_t
port = 50000;
441 streamNumber +=
packetSinkHelper.AssignStreams(serverNodes.get(), streamNumber);
446 for (std::size_t i = 0; i < nStations; i++)
449 onoff.SetAttribute(
"OnTime",
450 StringValue(
"ns3::ConstantRandomVariable[Constant=1]"));
451 onoff.SetAttribute(
"OffTime",
452 StringValue(
"ns3::ConstantRandomVariable[Constant=0]"));
457 onoff.SetAttribute(
"Remote", remoteAddress);
459 streamNumber +=
onoff.AssignStreams(clientNodes.
Get(i), streamNumber);
475 auto tolerance = 0.10;
492 auto throughput = (rxBytes * 8) / simulationTime.GetMicroSeconds();
496 std::cout << +mcs <<
"\t\t\t" << widthStr <<
" MHz\t\t"
497 << (widthStr.size() > 3 ?
"" :
"\t") << gi <<
" ns\t\t\t" <<
throughput
498 <<
" Mbit/s" << std::endl;
501 if (mcs == minMcs && width == 20 && gi == 3200)
503 if (
throughput * (1 + tolerance) < minExpectedThroughput)
510 if (mcs == maxMcs && width == maxChannelWidth && gi == 800)
512 if (maxExpectedThroughput > 0 &&
513 throughput > maxExpectedThroughput * (1 + tolerance))
535 if (
throughput * (1 + tolerance) > prevThroughput[index])
a polymophic address class
AttributeValue implementation for Address.
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.
Ptr< Application > Get(uint32_t i) const
Get the Ptr<Application> stored in this container at a given index.
void Stop(Time stop) const
Arrange for all of the Applications in this container to Stop() at the Time given as a parameter.
uint32_t GetN() const
Get the number of Ptr<Application> stored in this container.
A container for one type of attribute.
AttributeValue implementation for Boolean.
Parse command-line arguments.
AttributeValue implementation for DataRate.
This class can be used to hold variables of floating point type such as 'double' or 'float'.
Hold variables of type enum.
static uint64_t GetDataRate(uint8_t mcsValue, MHz_u channelWidth, Time guardInterval, uint8_t nss)
Return the data rate corresponding to the supplied HE MCS index, channel width, guard interval,...
static uint64_t GetNonHtReferenceRate(uint8_t mcsValue)
Calculate the rate in bps of the non-HT Reference Rate corresponding to the supplied HE MCS index.
aggregate IP/TCP/UDP functionality to existing Nodes.
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
static Ipv4Address GetAny()
static void PopulateRoutingTables()
Build a routing database and initialize the routing tables of the nodes in the simulation.
holds a vector of std::pair of Ptr<Ipv4> and interface index.
std::pair< Ptr< Ipv4 >, uint32_t > Get(uint32_t i) const
Get the std::pair of an Ptr<Ipv4> and interface stored at the location specified by the index.
Helper class used to assign positions and mobility models to nodes.
holds a vector of ns3::NetDevice pointers
keep track of a set of node pointers.
void Add(const NodeContainer &nc)
Append the contents of another NodeContainer to the end of this container.
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
A helper to make it easier to instantiate an ns3::OnOffApplication on a set of nodes.
A helper to make it easier to instantiate an ns3::PacketSinkApplication on a set of nodes.
Smart pointer class similar to boost::intrusive_ptr.
static EventId Schedule(const Time &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
static void Destroy()
Execute the events scheduled with ScheduleDestroy().
static void Run()
Run the simulation.
static void Stop()
Tell the Simulator the calling event should be the last one executed.
Make it easy to create and manage PHY objects for the spectrum model.
The IEEE 802.11 SSID Information Element.
AttributeValue implementation for Ssid.
Hold variables of type string.
Simulation virtual time values and global simulation resolution.
AttributeValue implementation for Time.
Create a client application which sends UDP packets carrying a 32bit sequence number and a 64 bit tim...
Create a server application which waits for input UDP packets and uses the information carried into t...
Hold an unsigned integer type.
helps to create WifiNetDevice objects
static int64_t AssignStreams(NetDeviceContainer c, int64_t stream)
Assign a fixed random variable stream number to the random variables used by the PHY and MAC aspects ...
create MAC layers for a ns3::WifiNetDevice.
@ DLT_IEEE802_11_RADIO
Include Radiotap link layer information.
static YansWifiChannelHelper Default()
Create a channel helper in a default working state.
Make it easy to create and manage PHY objects for the YANS model.
Ptr< AttributeChecker > MakeAttributeContainerChecker()
Make uninitialized AttributeContainerChecker using explicit types.
Ptr< const AttributeChecker > MakeUintegerChecker()
void SetDefault(std::string name, const AttributeValue &value)
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
#define NS_ABORT_MSG(msg)
Unconditional abnormal program termination with a message.
#define NS_LOG_ERROR(msg)
Use NS_LOG to output a message of level LOG_ERROR.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Ptr< T > CreateObject(Args &&... args)
Create an object by type, with varying number of constructor parameters.
Time NanoSeconds(uint64_t value)
Construct a Time in the indicated unit.
Time Seconds(double value)
Construct a Time in the indicated unit.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Ptr< T1 > DynamicCast(const Ptr< T2 > &p)
Cast a Ptr.