|
A Discrete-Event Network Simulator
|
API
|
Go to the documentation of this file.
21 #include "ns3/command-line.h"
22 #include "ns3/string.h"
23 #include "ns3/pointer.h"
25 #include "ns3/yans-wifi-helper.h"
27 #include "ns3/mobility-helper.h"
28 #include "ns3/internet-stack-helper.h"
29 #include "ns3/ipv4-address-helper.h"
30 #include "ns3/udp-client-server-helper.h"
31 #include "ns3/on-off-helper.h"
32 #include "ns3/yans-wifi-channel.h"
33 #include "ns3/wifi-net-device.h"
34 #include "ns3/qos-txop.h"
35 #include "ns3/wifi-mac.h"
86 int main (
int argc,
char *argv[])
88 uint32_t payloadSize = 1472;
89 double simulationTime = 10;
92 bool verifyResults = 0;
95 cmd.AddValue (
"payloadSize",
"Payload size in bytes", payloadSize);
96 cmd.AddValue (
"simulationTime",
"Simulation time in seconds", simulationTime);
97 cmd.AddValue (
"distance",
"Distance in meters between the station and the access point", distance);
98 cmd.AddValue (
"enablePcap",
"Enable/disable pcap file generation",
enablePcap);
99 cmd.AddValue (
"verifyResults",
"Enable/disable results verification at the end of the simulation", verifyResults);
100 cmd.Parse (argc, argv);
113 wifi.SetRemoteStationManager (
"ns3::IdealWifiManager");
116 NetDeviceContainer staDeviceA, staDeviceB, staDeviceC, staDeviceD, apDeviceA, apDeviceB, apDeviceC, apDeviceD;
122 mac.SetType (
"ns3::StaWifiMac",
127 mac.SetType (
"ns3::ApWifiMac",
136 mac.SetType (
"ns3::StaWifiMac",
142 mac.SetType (
"ns3::ApWifiMac",
160 wifi_dev = DynamicCast<WifiNetDevice> (dev);
161 wifi_mac = wifi_dev->
GetMac ();
170 mac.SetType (
"ns3::StaWifiMac",
176 mac.SetType (
"ns3::ApWifiMac",
184 wifi_dev = DynamicCast<WifiNetDevice> (dev);
185 wifi_mac = wifi_dev->
GetMac ();
194 mac.SetType (
"ns3::StaWifiMac",
200 mac.SetType (
"ns3::ApWifiMac",
208 wifi_dev = DynamicCast<WifiNetDevice> (dev);
209 wifi_mac = wifi_dev->
GetMac ();
217 mobility.SetMobilityModel (
"ns3::ConstantPositionMobilityModel");
220 positionAlloc->
Add (Vector (0.0, 0.0, 0.0));
221 positionAlloc->
Add (Vector (10.0, 0.0, 0.0));
222 positionAlloc->
Add (Vector (20.0, 0.0, 0.0));
223 positionAlloc->
Add (Vector (30.0, 0.0, 0.0));
225 positionAlloc->
Add (Vector (distance, 0.0, 0.0));
226 positionAlloc->
Add (Vector (10 + distance, 0.0, 0.0));
227 positionAlloc->
Add (Vector (20 + distance, 0.0, 0.0));
228 positionAlloc->
Add (Vector (30 + distance, 0.0, 0.0));
232 mobility.SetPositionAllocator (positionAlloc);
238 stack.Install (wifiApNodes);
242 address.SetBase (
"192.168.1.0",
"255.255.255.0");
244 StaInterfaceA =
address.Assign (staDeviceA);
246 ApInterfaceA =
address.Assign (apDeviceA);
248 address.SetBase (
"192.168.2.0",
"255.255.255.0");
250 StaInterfaceB =
address.Assign (staDeviceB);
252 ApInterfaceB =
address.Assign (apDeviceB);
254 address.SetBase (
"192.168.3.0",
"255.255.255.0");
256 StaInterfaceC =
address.Assign (staDeviceC);
258 ApInterfaceC =
address.Assign (apDeviceC);
260 address.SetBase (
"192.168.4.0",
"255.255.255.0");
262 StaInterfaceD =
address.Assign (staDeviceD);
264 ApInterfaceD =
address.Assign (apDeviceD);
267 uint16_t
port = 5001;
276 OnOffHelper clientA (
"ns3::UdpSocketFactory", destA);
277 clientA.SetAttribute (
"OnTime",
StringValue (
"ns3::ConstantRandomVariable[Constant=1]"));
278 clientA.SetAttribute (
"OffTime",
StringValue (
"ns3::ConstantRandomVariable[Constant=0]"));
279 clientA.SetAttribute (
"DataRate",
StringValue (
"100000kb/s"));
280 clientA.SetAttribute (
"PacketSize",
UintegerValue (payloadSize));
294 OnOffHelper clientB (
"ns3::UdpSocketFactory", destB);
295 clientB.SetAttribute (
"OnTime",
StringValue (
"ns3::ConstantRandomVariable[Constant=1]"));
296 clientB.SetAttribute (
"OffTime",
StringValue (
"ns3::ConstantRandomVariable[Constant=0]"));
297 clientB.SetAttribute (
"DataRate",
StringValue (
"100000kb/s"));
298 clientB.SetAttribute (
"PacketSize",
UintegerValue (payloadSize));
312 OnOffHelper clientC (
"ns3::UdpSocketFactory", destC);
313 clientC.SetAttribute (
"OnTime",
StringValue (
"ns3::ConstantRandomVariable[Constant=1]"));
314 clientC.SetAttribute (
"OffTime",
StringValue (
"ns3::ConstantRandomVariable[Constant=0]"));
315 clientC.SetAttribute (
"DataRate",
StringValue (
"100000kb/s"));
316 clientC.SetAttribute (
"PacketSize",
UintegerValue (payloadSize));
330 OnOffHelper clientD (
"ns3::UdpSocketFactory", destD);
331 clientD.SetAttribute (
"OnTime",
StringValue (
"ns3::ConstantRandomVariable[Constant=1]"));
332 clientD.SetAttribute (
"OffTime",
StringValue (
"ns3::ConstantRandomVariable[Constant=0]"));
333 clientD.SetAttribute (
"DataRate",
StringValue (
"100000kb/s"));
334 clientD.SetAttribute (
"PacketSize",
UintegerValue (payloadSize));
342 phy.EnablePcap (
"AP_A", apDeviceA.
Get (0));
343 phy.EnablePcap (
"STA_A", staDeviceA.
Get (0));
344 phy.EnablePcap (
"AP_B", apDeviceB.
Get (0));
345 phy.EnablePcap (
"STA_B", staDeviceB.
Get (0));
346 phy.EnablePcap (
"AP_C", apDeviceC.
Get (0));
347 phy.EnablePcap (
"STA_C", staDeviceC.
Get (0));
348 phy.EnablePcap (
"AP_D", apDeviceD.
Get (0));
349 phy.EnablePcap (
"STA_D", staDeviceD.
Get (0));
356 uint64_t totalPacketsThroughA = DynamicCast<UdpServer> (serverAppA.
Get (0))->GetReceived ();
357 uint64_t totalPacketsThroughB = DynamicCast<UdpServer> (serverAppB.
Get (0))->GetReceived ();
358 uint64_t totalPacketsThroughC = DynamicCast<UdpServer> (serverAppC.
Get (0))->GetReceived ();
359 uint64_t totalPacketsThroughD = DynamicCast<UdpServer> (serverAppD.
Get (0))->GetReceived ();
363 double throughput = totalPacketsThroughA * payloadSize * 8 / (simulationTime * 1000000.0);
364 std::cout <<
"AC_BE with default TXOP limit (0ms): " <<
'\n'
365 <<
" Throughput = " << throughput <<
" Mbit/s" <<
'\n';
366 if (verifyResults && (throughput < 28 || throughput > 29))
368 NS_LOG_ERROR (
"Obtained throughput " << throughput <<
" is not in the expected boundaries!");
372 throughput = totalPacketsThroughB * payloadSize * 8 / (simulationTime * 1000000.0);
373 std::cout <<
"AC_BE with non-default TXOP limit (3.008ms): " <<
'\n'
374 <<
" Throughput = " << throughput <<
" Mbit/s" <<
'\n';
375 if (verifyResults && (throughput < 35 || throughput > 36))
377 NS_LOG_ERROR (
"Obtained throughput " << throughput <<
" is not in the expected boundaries!");
380 std::cout <<
" Maximum TXOP duration = " << beTxopTracer.m_max.GetMicroSeconds () <<
" us" <<
'\n';
383 NS_LOG_ERROR (
"Maximum TXOP duration " << beTxopTracer.m_max <<
" is not in the expected boundaries!");
387 throughput = totalPacketsThroughC * payloadSize * 8 / (simulationTime * 1000000.0);
388 std::cout <<
"AC_VI with default TXOP limit (3.008ms): " <<
'\n'
389 <<
" Throughput = " << throughput <<
" Mbit/s" <<
'\n';
390 if (verifyResults && (throughput < 35 || throughput > 36))
392 NS_LOG_ERROR (
"Obtained throughput " << throughput <<
" is not in the expected boundaries!");
395 std::cout <<
" Maximum TXOP duration = " << viTxopTracer.m_max.GetMicroSeconds () <<
" us" <<
'\n';
398 NS_LOG_ERROR (
"Maximum TXOP duration " << viTxopTracer.m_max <<
" is not in the expected boundaries!");
402 throughput = totalPacketsThroughD * payloadSize * 8 / (simulationTime * 1000000.0);
403 std::cout <<
"AC_VI with non-default TXOP limit (0ms): " <<
'\n'
404 <<
" Throughput = " << throughput <<
" Mbit/s" <<
'\n';
405 if (verifyResults && (throughput < 31.5 || throughput > 32.5))
407 NS_LOG_ERROR (
"Obtained throughput " << throughput <<
" is not in the expected boundaries!");
holds a vector of ns3::NetDevice pointers
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Ptr< Application > Get(uint32_t i) const
Get the Ptr<Application> stored in this container at a given index.
static YansWifiChannelHelper Default(void)
Create a channel helper in a default working state.
Make it easy to create and manage PHY objects for the YANS model.
Parse command-line arguments.
void Add(Vector v)
Add a position to the list of positions.
AttributeValue implementation for Boolean.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
void Stop(Time stop)
Arrange for all of the Applications in this container to Stop() at the Time given as a parameter.
helps to create WifiNetDevice objects
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
Time MicroSeconds(uint64_t value)
Construct a Time in the indicated unit.
Keeps the maximum duration among all TXOPs.
Hold objects of type Ptr<T>.
@ DLT_IEEE802_11_RADIO
Include Radiotap link layer information.
void Trace(Time startTime, Time duration)
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
AttributeValue implementation for Ssid.
The IEEE 802.11 SSID Information Element.
Create a server application which waits for input UDP packets and uses the information carried into t...
static void Stop(void)
Tell the Simulator the calling event should be the last one executed.
void GetAttribute(std::string name, AttributeValue &value) const
Get the value of an attribute, raising fatal errors if unsuccessful.
A helper to make it easier to instantiate an ns3::OnOffApplication on a set of nodes.
Ptr< NetDevice > GetDevice(uint32_t index) const
Retrieve the index-th NetDevice associated to this node.
holds a vector of std::pair of Ptr<Ipv4> and interface index.
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
Simulation virtual time values and global simulation resolution.
Handle packet fragmentation and retransmissions for QoS data frames as well as MSDU aggregation (A-MS...
Callback< R, Ts... > MakeCallback(R(T::*memPtr)(Ts...), OBJ objPtr)
Build Callbacks for class method members which take varying numbers of arguments and potentially retu...
static void Run(void)
Run the simulation.
Hold variables of type string.
#define NS_LOG_ERROR(msg)
Use NS_LOG to output a message of level LOG_ERROR.
void Start(Time start)
Arrange for all of the Applications in this container to Start() at the Time given as a parameter.
Time Seconds(double value)
Construct a Time in the indicated unit.
static void Destroy(void)
Execute the events scheduled with ScheduleDestroy().
holds a vector of ns3::Application pointers.
void SetTxopLimit(Time txopLimit)
Set the TXOP limit.
keep track of a set of node pointers.
Ipv4Address GetAddress(uint32_t i, uint32_t j=0) const
Hold an unsigned integer type.
manage and create wifi channel objects for the YANS model.
create MAC layers for a ns3::WifiNetDevice.
bool TraceConnectWithoutContext(std::string name, const CallbackBase &cb)
Connect a TraceSource to a Callback without a context.
aggregate IP/TCP/UDP functionality to existing Nodes.
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
Helper class used to assign positions and mobility models to nodes.
Ptr< WifiMac > GetMac(void) const