|
A Discrete-Event Network Simulator
|
API
|
Go to the documentation of this file.
27 #include "ns3/command-line.h"
28 #include "ns3/config.h"
29 #include "ns3/uinteger.h"
30 #include "ns3/boolean.h"
31 #include "ns3/double.h"
32 #include "ns3/string.h"
34 #include "ns3/yans-wifi-helper.h"
35 #include "ns3/spectrum-wifi-helper.h"
37 #include "ns3/mobility-helper.h"
38 #include "ns3/internet-stack-helper.h"
39 #include "ns3/ipv4-address-helper.h"
40 #include "ns3/udp-client-server-helper.h"
41 #include "ns3/packet-sink-helper.h"
42 #include "ns3/on-off-helper.h"
43 #include "ns3/ipv4-global-routing-helper.h"
44 #include "ns3/packet-sink.h"
45 #include "ns3/yans-wifi-channel.h"
46 #include "ns3/multi-model-spectrum-channel.h"
47 #include "ns3/propagation-loss-model.h"
101 uint16_t channelFreqMhz,
115 int main (
int argc,
char *argv[])
118 double distance = 50;
119 double simulationTime = 10;
120 uint16_t index = 256;
121 std::string wifiType =
"ns3::SpectrumWifiPhy";
122 std::string errorModelType =
"ns3::NistErrorRateModel";
124 const uint32_t tcpPacketSize = 1448;
127 cmd.AddValue (
"simulationTime",
"Simulation time in seconds", simulationTime);
128 cmd.AddValue (
"udp",
"UDP if set to 1, TCP otherwise", udp);
129 cmd.AddValue (
"distance",
"meters separation between nodes", distance);
130 cmd.AddValue (
"index",
"restrict index to single value between 0 and 31", index);
131 cmd.AddValue (
"wifiType",
"select ns3::SpectrumWifiPhy or ns3::YansWifiPhy", wifiType);
132 cmd.AddValue (
"errorModelType",
"select ns3::NistErrorRateModel or ns3::YansErrorRateModel", errorModelType);
133 cmd.AddValue (
"enablePcap",
"enable pcap output",
enablePcap);
134 cmd.Parse (argc,argv);
136 uint16_t startIndex = 0;
137 uint16_t stopIndex = 31;
144 std::cout <<
"wifiType: " << wifiType <<
" distance: " << distance <<
"m; time: " << simulationTime <<
"; TxPower: 1 dBm (1.3 mW)" << std::endl;
145 std::cout << std::setw (5) <<
"index" <<
146 std::setw (6) <<
"MCS" <<
147 std::setw (13) <<
"Rate (Mb/s)" <<
148 std::setw (12) <<
"Tput (Mb/s)" <<
149 std::setw (10) <<
"Received " <<
150 std::setw (12) <<
"Signal (dBm)" <<
151 std::setw (12) <<
"Noise (dBm)" <<
152 std::setw (9) <<
"SNR (dB)" <<
154 for (uint16_t i = startIndex; i <= stopIndex; i++)
156 uint32_t payloadSize;
174 if (wifiType ==
"ns3::YansWifiPhy")
177 channel.AddPropagationLoss (
"ns3::FriisPropagationLossModel",
179 channel.SetPropagationDelay (
"ns3::ConstantSpeedPropagationDelayModel");
184 else if (wifiType ==
"ns3::SpectrumWifiPhy")
187 = CreateObject<MultiModelSpectrumChannel> ();
189 = CreateObject<FriisPropagationLossModel> ();
194 = CreateObject<ConstantSpeedPropagationDelayModel> ();
377 wifi.SetRemoteStationManager (
"ns3::ConstantRateWifiManager",
"DataMode",
DataRate,
383 if (wifiType ==
"ns3::YansWifiPhy")
385 mac.SetType (
"ns3::StaWifiMac",
388 staDevice =
wifi.Install (
phy,
mac, wifiStaNode);
389 mac.SetType (
"ns3::ApWifiMac",
395 else if (wifiType ==
"ns3::SpectrumWifiPhy")
397 mac.SetType (
"ns3::StaWifiMac",
400 staDevice =
wifi.Install (spectrumPhy,
mac, wifiStaNode);
401 mac.SetType (
"ns3::ApWifiMac",
409 Config::Set (
"/NodeList/*/DeviceList/*/$ns3::WifiNetDevice/HtConfiguration/ShortGuardIntervalSupported",
BooleanValue (
false));
411 else if (i > 7 && i <= 15)
413 Config::Set (
"/NodeList/*/DeviceList/*/$ns3::WifiNetDevice/HtConfiguration/ShortGuardIntervalSupported",
BooleanValue (
true));
415 else if (i > 15 && i <= 23)
417 Config::Set (
"/NodeList/*/DeviceList/*/$ns3::WifiNetDevice/HtConfiguration/ShortGuardIntervalSupported",
BooleanValue (
false));
421 Config::Set (
"/NodeList/*/DeviceList/*/$ns3::WifiNetDevice/HtConfiguration/ShortGuardIntervalSupported",
BooleanValue (
true));
428 positionAlloc->
Add (Vector (0.0, 0.0, 0.0));
429 positionAlloc->
Add (Vector (distance, 0.0, 0.0));
430 mobility.SetPositionAllocator (positionAlloc);
432 mobility.SetMobilityModel (
"ns3::ConstantPositionMobilityModel");
440 stack.Install (wifiStaNode);
443 address.SetBase (
"192.168.1.0",
"255.255.255.0");
447 staNodeInterface =
address.Assign (staDevice);
448 apNodeInterface =
address.Assign (apDevice);
457 serverApp = server.Install (wifiStaNode.
Get (0));
462 client.SetAttribute (
"MaxPackets",
UintegerValue (4294967295u));
463 client.SetAttribute (
"Interval",
TimeValue (
Time (
"0.0001")));
464 client.SetAttribute (
"PacketSize",
UintegerValue (payloadSize));
472 uint16_t
port = 50000;
475 serverApp = packetSinkHelper.Install (wifiStaNode.
Get (0));
480 onoff.SetAttribute (
"OnTime",
StringValue (
"ns3::ConstantRandomVariable[Constant=1]"));
481 onoff.SetAttribute (
"OffTime",
StringValue (
"ns3::ConstantRandomVariable[Constant=0]"));
482 onoff.SetAttribute (
"PacketSize",
UintegerValue (payloadSize));
485 onoff.SetAttribute (
"Remote", remoteAddress);
496 std::stringstream ss;
497 ss <<
"wifi-spectrum-per-example-" << i;
498 phy.EnablePcap (ss.str (), apDevice);
507 double throughput = 0;
508 uint64_t totalPacketsThrough = 0;
512 totalPacketsThrough = DynamicCast<UdpServer> (serverApp.
Get (0))->GetReceived ();
513 throughput = totalPacketsThrough * payloadSize * 8 / (simulationTime * 1000000.0);
518 uint64_t totalBytesRx = DynamicCast<PacketSink> (serverApp.
Get (0))->GetTotalRx ();
519 totalPacketsThrough = totalBytesRx / tcpPacketSize;
520 throughput = totalBytesRx * 8 / (simulationTime * 1000000.0);
522 std::cout << std::setw (5) << i <<
523 std::setw (6) << (i % 8) <<
524 std::setprecision (2) << std::fixed <<
525 std::setw (10) << datarate <<
526 std::setw (12) << throughput <<
527 std::setw (8) << totalPacketsThrough;
528 if (totalPacketsThrough > 0)
537 std::cout << std::setw (12) <<
"N/A" <<
538 std::setw (12) <<
"N/A" <<
539 std::setw (12) <<
"N/A" <<
void SetPropagationDelayModel(Ptr< PropagationDelayModel > delay)
Set the propagation delay model to be used.
holds a vector of ns3::NetDevice pointers
@ WIFI_STANDARD_80211n_5GHZ
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
double noise
noise power in dBm
AttributeValue implementation for DataRate.
Ptr< Application > Get(uint32_t i) const
Get the Ptr<Application> stored in this container at a given index.
Create a client application which sends UDP packets carrying a 32bit sequence number and a 64 bit tim...
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.
void Set(std::string path, const AttributeValue &value)
AttributeValue implementation for Boolean.
void AddPropagationLossModel(Ptr< PropagationLossModel > loss)
Add the single-frequency propagation loss model to be used.
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.
AttributeValue implementation for Address.
@ DLT_IEEE802_11_RADIO
Include Radiotap link layer information.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
void SetErrorRateModel(std::string name, 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())
This class can be used to hold variables of floating point type such as 'double' or 'float'.
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
AttributeValue implementation for Ssid.
SignalNoiseDbm structure.
The IEEE 802.11 SSID Information Element.
Create a server application which waits for input UDP packets and uses the information carried into t...
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
Class for representing data rates.
void ConnectWithoutContext(std::string path, const CallbackBase &cb)
static void Stop(void)
Tell the Simulator the calling event should be the last one executed.
a polymophic address class
A helper to make it easier to instantiate an ns3::OnOffApplication on a set of nodes.
void SetFrequency(double frequency)
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.
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.
A helper to make it easier to instantiate an ns3::PacketSinkApplication on a set of nodes.
void MonitorSniffRx(Ptr< const Packet > packet, uint16_t channelFreqMhz, WifiTxVector txVector, MpduInfo aMpdu, SignalNoiseDbm signalNoise, uint16_t staId)
static Ipv4Address GetAny(void)
void(* DataRate)(DataRate oldValue, DataRate newValue)
TracedValue callback signature for DataRate.
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.
AttributeValue implementation for Time.
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.
void SetDefault(std::string name, const AttributeValue &value)
double signal
signal strength in dBm
void SetChannel(Ptr< SpectrumChannel > channel)
aggregate IP/TCP/UDP functionality to existing Nodes.
void Set(std::string name, const AttributeValue &v)
Helper class used to assign positions and mobility models to nodes.
Make it easy to create and manage PHY objects for the spectrum model.