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/neighbor-cache-helper.h"
23#include "ns3/on-off-helper.h"
24#include "ns3/packet-sink-helper.h"
25#include "ns3/packet-sink.h"
26#include "ns3/spectrum-wifi-helper.h"
28#include "ns3/string.h"
29#include "ns3/udp-client-server-helper.h"
30#include "ns3/udp-server.h"
31#include "ns3/uinteger.h"
32#include "ns3/wifi-acknowledgment.h"
33#include "ns3/wifi-static-setup-helper.h"
34#include "ns3/yans-wifi-channel.h"
35#include "ns3/yans-wifi-helper.h"
63main(
int argc,
char* argv[])
68 bool use80Plus80{
false};
69 bool useExtendedBlockAck{
false};
70 Time simulationTime{
"10s"};
71 bool staticSetup{
true};
72 auto clientAppStartTime =
Seconds(1);
75 std::size_t nStations{1};
76 std::string dlAckSeqType{
"NO-OFDMA"};
77 bool enableUlOfdma{
false};
78 bool enableBsrp{
false};
80 std::vector<uint64_t> mcsValues;
82 int guardInterval{-1};
85 std::string phyModel{
"Yans"};
86 double minExpectedThroughput{0.0};
87 double maxExpectedThroughput{0.0};
88 Time accessReqInterval{0};
91 cmd.AddValue(
"staticSetup",
92 "Whether devices are configured using the static setup helper",
94 cmd.AddValue(
"frequency",
95 "Whether working in the 2.4, 5 or 6 GHz band (other values gets rejected)",
97 cmd.AddValue(
"distance",
98 "Distance in meters between the station and the access point",
100 cmd.AddValue(
"simulationTime",
"Simulation time", simulationTime);
101 cmd.AddValue(
"udp",
"UDP if set to 1, TCP otherwise", udp);
102 cmd.AddValue(
"downlink",
103 "Generate downlink flows if set to 1, uplink flows otherwise",
105 cmd.AddValue(
"useRts",
"Enable/disable RTS/CTS", useRts);
106 cmd.AddValue(
"use80Plus80",
"Enable/disable use of 80+80 MHz", use80Plus80);
107 cmd.AddValue(
"useExtendedBlockAck",
"Enable/disable use of extended BACK", useExtendedBlockAck);
108 cmd.AddValue(
"nStations",
"Number of non-AP HE stations", nStations);
109 cmd.AddValue(
"dlAckType",
110 "Ack sequence type for DL OFDMA (NO-OFDMA, ACK-SU-FORMAT, MU-BAR, AGGR-MU-BAR)",
112 cmd.AddValue(
"enableUlOfdma",
113 "Enable UL OFDMA (useful if DL OFDMA is enabled and TCP is used)",
115 cmd.AddValue(
"enableBsrp",
116 "Enable BSRP (useful if DL and UL OFDMA are enabled and TCP is used)",
119 "muSchedAccessReqInterval",
120 "Duration of the interval between two requests for channel access made by the MU scheduler",
124 "list of comma separated MCS values to test; if unset, all MCS values (0-11) are tested",
126 cmd.AddValue(
"channelWidth",
127 "if set, limit testing to a specific channel width expressed in MHz (20, 40, 80 "
130 cmd.AddValue(
"guardInterval",
131 "if set, limit testing to a specific guard interval duration expressed in "
132 "nanoseconds (800, 1600 or 3200 ns)",
134 cmd.AddValue(
"payloadSize",
"The application payload size in bytes", payloadSize);
135 cmd.AddValue(
"phyModel",
136 "PHY model to use when OFDMA is disabled (Yans or Spectrum). If 80+80 MHz or "
138 "then Spectrum is automatically selected",
140 cmd.AddValue(
"minExpectedThroughput",
141 "if set, simulation fails if the lowest throughput is below this value",
142 minExpectedThroughput);
143 cmd.AddValue(
"maxExpectedThroughput",
144 "if set, simulation fails if the highest throughput is above this value",
145 maxExpectedThroughput);
146 cmd.Parse(argc, argv);
154 if (dlAckSeqType ==
"ACK-SU-FORMAT")
159 else if (dlAckSeqType ==
"MU-BAR")
164 else if (dlAckSeqType ==
"AGGR-MU-BAR")
169 else if (dlAckSeqType !=
"NO-OFDMA")
171 NS_ABORT_MSG(
"Invalid DL ack sequence type (must be NO-OFDMA, ACK-SU-FORMAT, MU-BAR or "
175 if (phyModel !=
"Yans" && phyModel !=
"Spectrum")
177 NS_ABORT_MSG(
"Invalid PHY model (must be Yans or Spectrum)");
179 if (use80Plus80 || (dlAckSeqType !=
"NO-OFDMA"))
182 phyModel =
"Spectrum";
185 double prevThroughput[12] = {0};
187 std::cout <<
"MCS value"
193 <<
"Throughput" <<
'\n';
199 for (uint8_t mcs = minMcs; mcs <= maxMcs; ++mcs)
201 mcsValues.push_back(mcs);
209 attr.DeserializeFromString(mcsStr, checker);
210 mcsValues = attr.Get();
211 std::sort(mcsValues.begin(), mcsValues.end());
214 int minChannelWidth = 20;
215 int maxChannelWidth = frequency == 2.4 ? 40 : 160;
216 if ((channelWidth != -1) &&
217 ((channelWidth < minChannelWidth) || (channelWidth > maxChannelWidth)))
219 NS_FATAL_ERROR(
"Invalid channel width: " << channelWidth <<
" MHz");
221 if (channelWidth >= minChannelWidth && channelWidth <= maxChannelWidth)
223 minChannelWidth = channelWidth;
224 maxChannelWidth = channelWidth;
226 int minGi = enableUlOfdma ? 1600 : 800;
228 if (guardInterval >= minGi && guardInterval <= maxGi)
230 minGi = guardInterval;
231 maxGi = guardInterval;
234 for (
const auto mcs : mcsValues)
238 for (
int width = minChannelWidth;
width <= maxChannelWidth;
width *= 2)
240 const auto is80Plus80 = (use80Plus80 && (
width == 160));
241 const std::string widthStr = is80Plus80 ?
"80+80" : std::to_string(width);
242 const auto segmentWidthStr = is80Plus80 ?
"80" : widthStr;
243 for (
int gi = maxGi; gi >= minGi; gi /= 2)
259 std::string channelStr(
"{0, " + segmentWidthStr +
", ");
263 std::ostringstream ossDataMode;
264 ossDataMode <<
"HeMcs" << mcs;
269 channelStr +=
"BAND_6GHZ, 0}";
273 else if (frequency == 5)
275 std::ostringstream ossControlMode;
276 ossControlMode <<
"OfdmRate" << nonHtRefRateMbps <<
"Mbps";
278 channelStr +=
"BAND_5GHZ, 0}";
280 else if (frequency == 2.4)
282 std::ostringstream ossControlMode;
283 ossControlMode <<
"ErpOfdmRate" << nonHtRefRateMbps <<
"Mbps";
285 channelStr +=
"BAND_2_4GHZ, 0}";
296 channelStr += std::string(
";") + channelStr;
300 wifi.SetRemoteStationManager(
"ns3::ConstantRateWifiManager",
310 if (phyModel ==
"Spectrum")
315 spectrumChannel->AddPropagationLossModel(lossModel);
319 phy.SetChannel(spectrumChannel);
321 mac.SetType(
"ns3::StaWifiMac",
329 if (dlAckSeqType !=
"NO-OFDMA")
331 mac.SetMultiUserScheduler(
"ns3::RrMultiUserScheduler",
339 mac.SetType(
"ns3::ApWifiMac",
340 "EnableBeaconJitter",
346 apDevice =
wifi.Install(phy, mac, wifiApNode);
355 mac.SetType(
"ns3::StaWifiMac",
363 mac.SetType(
"ns3::ApWifiMac",
364 "EnableBeaconJitter",
368 apDevice =
wifi.Install(phy, mac, wifiApNode);
371 int64_t streamNumber = 150;
379 positionAlloc->Add(Vector(0.0, 0.0, 0.0));
380 positionAlloc->Add(Vector(distance, 0.0, 0.0));
381 mobility.SetPositionAllocator(positionAlloc);
383 mobility.SetMobilityModel(
"ns3::ConstantPositionMobilityModel");
400 stack.Install(wifiApNode);
401 stack.Install(wifiStaNodes);
402 streamNumber +=
stack.AssignStreams(wifiApNode, streamNumber);
403 streamNumber +=
stack.AssignStreams(wifiStaNodes, streamNumber);
406 address.SetBase(
"192.168.1.0",
"255.255.255.0");
410 staNodeInterfaces =
address.Assign(staDevices);
411 apNodeInterface =
address.Assign(apDevice);
422 auto serverNodes = downlink ? std::ref(wifiStaNodes) :
std::ref(
wifiApNode);
425 for (std::size_t i = 0; i < nStations; i++)
428 : apNodeInterface.
Get(0));
440 serverApp =
server.Install(serverNodes.get());
441 streamNumber +=
server.AssignStreams(serverNodes.get(), streamNumber);
444 serverApp.
Stop(simulationTime + clientAppStartTime);
445 const auto packetInterval = payloadSize * 8.0 / maxLoad;
447 for (std::size_t i = 0; i < nStations; i++)
454 streamNumber +=
client.AssignStreams(clientNodes.
Get(i), streamNumber);
456 clientApp.
Start(clientAppStartTime);
457 clientApp.
Stop(simulationTime + clientAppStartTime);
463 uint16_t
port = 50000;
467 streamNumber +=
packetSinkHelper.AssignStreams(serverNodes.get(), streamNumber);
470 serverApp.
Stop(simulationTime + clientAppStartTime);
472 for (std::size_t i = 0; i < nStations; i++)
475 onoff.SetAttribute(
"OnTime",
476 StringValue(
"ns3::ConstantRandomVariable[Constant=1]"));
477 onoff.SetAttribute(
"OffTime",
478 StringValue(
"ns3::ConstantRandomVariable[Constant=0]"));
483 onoff.SetAttribute(
"Remote", remoteAddress);
485 streamNumber +=
onoff.AssignStreams(clientNodes.
Get(i), streamNumber);
487 clientApp.
Start(clientAppStartTime);
488 clientApp.
Stop(simulationTime + clientAppStartTime);
501 auto tolerance = 0.10;
518 auto throughput = (rxBytes * 8) / simulationTime.GetMicroSeconds();
522 std::cout << +mcs <<
"\t\t\t" << widthStr <<
" MHz\t\t"
523 << (widthStr.size() > 3 ?
"" :
"\t") << gi <<
" ns\t\t\t" <<
throughput
524 <<
" Mbit/s" << std::endl;
527 if (mcs == minMcs && width == 20 && gi == 3200)
529 if (
throughput * (1 + tolerance) < minExpectedThroughput)
536 if (mcs == maxMcs && width == maxChannelWidth && gi == 800)
538 if (maxExpectedThroughput > 0 &&
539 throughput > maxExpectedThroughput * (1 + tolerance))
561 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.
A helper class to populate neighbor cache.
void PopulateNeighborCache()
Populate neighbor ARP and NDISC caches for all devices.
holds a vector of ns3::NetDevice pointers
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
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 void SetStaticAssociation(Ptr< WifiNetDevice > bssDev, const NetDeviceContainer &clientDevs)
Bypass static capabilities exchange for input devices.
static void SetStaticBlockAck(Ptr< WifiNetDevice > apDev, const NetDeviceContainer &clientDevs, const std::set< tid_t > &tids, std::optional< Mac48Address > gcrGroupAddr=std::nullopt)
Bypass ADDBA Request-Response exchange sequence between AP and STAs for given TIDs.
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.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
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.
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
double MHz_u
MHz weak type.
Ptr< T1 > DynamicCast(const Ptr< T2 > &p)
Cast a Ptr.
double meter_u
meter weak type