Ns3 Part4 Wireless

transcript

JCSSE 2011's tutorials and workshopsWednesday, 11 May 2011, 9:00 - 16:00

Intelligent Wireless Network GroupDepartment of Computer EngineeringFaculty of Engineering, Kasetsart Universityhttp://iwing.cpe.ku.ac.th

ns-3 Tutorial (Part IV)Wireless &

Tracing System and Visualizing Results

Time Table

09:00 - 10:15 ns-3 Introduction & Installation

10:15 - 10.30 Break

10:30 - 12:00 Hands-On: Point-to-point and CSMA (Ethernet)

12:00 - 13:00 Lunch

13:00 - 14:15 Hands-On: Wireless & Tracing System and Visualizing Results

14:15 - 14:30 Break

14:30 - 15:30 Demonstation: ns-3 protocol stack modification

15:30 - 16:00 Q&A

Wireless modules overview

Tracing with Trace Helpers

Creating custom tracers

Visualizing and analyzing results

Walk-through examples

Hands-on exercise

Outline

ns-3 provides a set of pre-configured trace sources

Users provide trace sinks and attach to the trace source

Multiple trace sources can connect to a trace sink

Tracing Overview

Decouple trace sources from trace sinks:

ns-3 Tracing Model

ns-3 Trace Sources

High-level

Use a helper to hook a predefined trace source to an existing trace sink (e.g., ascii, pcap)

Mid-level

Hook an existing trace source to a custom trace sink

Low-level

Add a new trace source and connect it to a special trace sink

Multiple Levels of Tracing

Ascii Trace Helper

Pcap Trace Helper

Trace Helpers

Custom Trace Sink

DevTxTrace(

std::string context,

Ptr<const Packet> p, Mac48Address address)

std::cout << " TX to=" << address << " p: " << *p << std::endl;

Config::Connect(

"/NodeList/*/DeviceList/*/Mac/MacTx",

MakeCallback(&DevTxTrace));

Name of trace sink function

Path to trace source

Task: model the network topology below in ns-3 and capture ECHO packets transmitted from N7 to N4

We can start from tutorials/third.cc

Walk-Through Example I (1)

N2 N3 N4

N0 N110.1.1.0/24

10.1.2.0/24

10.1.3.0/24

CommandLine class allows processing of command-line arguments

Supply default values of various attributes and variables

Dissecting third.cc

main (int argc, char *argv[])

bool verbose = true;

uint32_t nCsma = 3;

uint32_t nWifi = 3;

CommandLine cmd;

cmd.AddValue ("nCsma", "Number of \"extra\" CSMA nodes/devices", nCsma);

cmd.AddValue ("nWifi", "Number of wifi STA devices", nWifi);

cmd.AddValue ("verbose", "Tell echo applications to log if true", verbose);

cmd.Parse (argc,argv);

Various Helpers are available to help create wireless channel/physical/mac models

Dissecting third.cc

NodeContainer wifiStaNodes;

wifiStaNodes.Create (nWifi);

NodeContainer wifiApNode = p2pNodes.Get (0);

YansWifiChannelHelper channel = YansWifiChannelHelper::Default ();

YansWifiPhyHelper phy = YansWifiPhyHelper::Default ();

phy.SetChannel (channel.Create ());

WifiHelper wifi = WifiHelper::Default ();

wifi.SetRemoteStationManager ("ns3::AarfWifiManager");

WiFi MAC layer

Dissecting third.cc

NqosWifiMacHelper mac = NqosWifiMacHelper::Default ();

Ssid ssid = Ssid ("ns-3-ssid");

mac.SetType ("ns3::StaWifiMac",

"Ssid", SsidValue (ssid),

"ActiveProbing", BooleanValue (false));

NetDeviceContainer staDevices;

staDevices = wifi.Install (phy, mac, wifiStaNodes);

mac.SetType ("ns3::ApWifiMac",

"Ssid", SsidValue (ssid));

NetDeviceContainer apDevices;

apDevices = wifi.Install (phy, mac, wifiApNode);

Configure all nodes in wifiStaNodes

container to be of type “station”

Configure first node of point-to-point link

to be WiFi AP

NodeContainer wifiApNode = p2pNodes.Get (0);

All wireless nodes must be associated with mobility

MobilityHelper provides a lot of help

MobilityHelper mobility;

mobility.SetPositionAllocator ("ns3::GridPositionAllocator",

"MinX", DoubleValue (0.0),

"MinY", DoubleValue (0.0),

"DeltaX", DoubleValue (5.0),

"DeltaY", DoubleValue (10.0),

"GridWidth", UintegerValue (3),

"LayoutType", StringValue ("RowFirst"));

mobility.SetMobilityModel ("ns3::RandomWalk2dMobilityModel",

"Bounds", RectangleValue (Rectangle (-50, 50, -50, 50)));

mobility.Install (wifiStaNodes);

mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");

mobility.Install (wifiApNode);

Dissecting third.cc

(MinX, MinY) DeltaX

DeltaY

Create a copy of third.cc into the scratch dir and rename it to pm-ex1.cc

Edit the source

Change port number from 9 to 7 (standard ECHO port)

Change PCAP file prefix to pm-ex1

$ cp examples/tutorials/third.cc scratch/pm-ex1.cc

UdpEchoServerHelper echoServer (7);

UdpEchoClientHelper echoClient (csmaInterfaces.GetAddress (nCsma), 7);

pointToPoint.EnablePcapAll ("pm-ex1");

phy.EnablePcap ("pm-ex1", apDevices.Get (0));

csma.EnablePcap ("pm-ex1", csmaDevices.Get (0), true);

Run the script

Open the pcap files with WireShark

$ ls *.pcap

pm-ex1-0-0.pcap pm-ex1-0-1.pcap

pm-ex1-1-0.pcap pm-ex1-1-1.pcap

$ wireshark pm-ex1-0-0.pcap

$ ./waf --run pm-ex1

Visualize the simulation by adding option --visualize

Press F3 to start the simulation

$ ./waf --run pm-ex1 --visualize

Attributes can be configured and explored before the simulation starts

#include "ns3/gtk-config-store.h"

GtkConfigStore config;

config.ConfigureAttributes();

Simulator::Run ();

GtkConfigStore can also be invoked in PyViz using Ipythonshell

Ipython must be installed

Task: Using the previous topology, replace ECHO traffic with CBR (Constant Bit Rate) traffic

Walk-Through Example II (1)

N2 N3 N4

N0 N110.1.1.0/24

10.1.2.0/24

10.1.3.0/24

CBR (512 Kbps)

Create pm-ex2.cc from pm-ex1.cc

Use OnOffHelper to generate CBR traffic from the client

$ cp scratch/pm-ex1.cc scratch/pm-ex2.cc

uint16_t port = 9;

OnOffHelper onoff(

"ns3::UdpSocketFactory",

InetSocketAddress("10.1.2.4", port));

onoff.SetAttribute("OnTime", StringValue("Constant:1"));

onoff.SetAttribute("OffTime", StringValue("Constant:0"));

onoff.SetAttribute("DataRate", StringValue("512Kbps"));

onoff.SetAttribute("PacketSize", StringValue("512"));

ApplicationContainer apps = onoff.Install(wifiStaNodes.Get(nWifi-1));

apps.Start(Seconds(5.0));

apps.Stop(Seconds(20.0));

Install app on node N7 only

Create a packet sink on the server

Set simulation time to 30 seconds

Don't forget to change the PCAP trace prefix

PacketSinkHelper sink(

"ns3::UdpSocketFactory",

InetSocketAddress("10.1.2.4", port));

sink.Install(csmaNodes.Get(nCsma));

Simulator::Stop(Seconds(25.0));

Install PacketSinkon node N4

Task: calculate average throughput from previous scenario

Idea: Connect a custom trace sink to PacketSink's Rx trace source

Compute average throughput from

first and last packets' timestamps

total bytes received

Walk-Through Example III (1)

How to determine what trace source PacketSinkprovides?

And how to get to it?

In ns-3 Doxygen, look for ns3::PacketSink (either via Class List or List of Trace Sources)

Look at the documentation for GetTypeId

Finding Path to Trace Source

Trace Sink

Callback Function

We now know that PacketSink object already comes with a trace source, called Rx

We need to write a callback function to serve as a trace sink

Connecting Trace Source/Sink

PacketSinkObject

Trace Source

Quoted from ns-3 Tutorial:

“…always try to copy someone else's working code…”

Opening examples/csma/csma-ping.cc reveals

Then look at definition of SinkRx function:

Callback Signature

$ find examples/ -name "*.cc" -exec grep -H PacketSink/Rx {} \;

examples/csma/csma-ping.cc: Config::ConnectWithoutContext ("/NodeList/3/ApplicationList/0/$ns3::PacketSink/Rx",

examples/csma/csma-packet-socket.cc: Config::Connect ("/NodeList/*/ApplicationList/*/$ns3::PacketSink/Rx",

examples/csma/csma-raw-ip-socket.cc: Config::ConnectWithoutContext

("/NodeList/3/ApplicationList/0/$ns3::PacketSink/Rx", :

Config::ConnectWithoutContext ("/NodeList/3/ApplicationList/0/$ns3::PacketSink/Rx",

MakeCallback (&SinkRx));

static void SinkRx (Ptr<const Packet> p, const Address &ad)

//std::cout << *p << std::endl;

If no example can be found, look at ns-3 source code!

Either way, we now know that our callback's signature should be:

Callback Signature

$ find . -name "*.h" -exec grep -H TracedCallback {} \;

./src/applications/udp-echo/udp-echo-client.h: TracedCallback<Ptr<const Packet> > m_txTrace;

./src/applications/v4ping/v4ping.h: TracedCallback<Time> m_traceRtt;

./src/applications/packet-sink/packet-sink.h: TracedCallback<Ptr<const Packet>, const Address &>

m_rxTrace;

./src/mobility/mobility-model.h: TracedCallback<Ptr<const MobilityModel> > m_courseChangeTrace;

./src/routing/olsr/model/olsr-routing-protocol.h: TracedCallback <const PacketHeader &,

void Callback(Ptr<const Packet>, const Address &)

Note: An additional std::string parameter is required if connection is made with context

Prepare trace sink callback and necessary statistical variables

double firstRxTime = -1.0, lastRxTime;

uint32_t bytesTotal = 0;

void SinkRxTrace(Ptr<const Packet> pkt, const Address &addr)

if (firstRxTime < 0)

firstRxTime = Simulator::Now().GetSeconds();

lastRxTime = Simulator::Now().GetSeconds();

bytesTotal += pkt->GetSize();

Connect trace source with trace sink

Produce statistical report at the end of the script

Run the simulation script

Config::ConnectWithoutContext(

"/NodeList/*/ApplicationList/*/$ns3::PacketSink/Rx",

MakeCallback(&SinkRxTrace));

cout << "Avg throughput = "

<< bytesTotal*8/(lastRxTime-firstRxTime)/1024

<< " kbits/sec" << endl;

Task: study impact of number of clients on average throughput

Experiment setup

2-14 mobile clients

UDP CBR stream

512 Kbps per client

Packet size: 512 bytes

Walk-Through Example IV (1)

Modify the source so that OnOff application is installed on all WiFi stations

Change the line:

ApplicationContainer apps = onoff.Install(wifiStaNodes);

ApplicationContainer apps = onoff.Install(wifiStaNodes.Get(nWifi-1));

Report the number of WiFi stations in addition to the average throughput

Try running the script with various values specified for nWifi argument

cout << "Num clients = " << nWifi << " "

<< "Avg throughput = "

<< bytesTotal*8/(lastRxTime-firstRxTime)/1024

<< " kbits/sec" << endl;

$ waf --run "pm-ex4 --nWifi=1" 2> /dev/null

Num clients = 1 Avg throughput = 512.96 kbits/sec

$ waf --run "pm-ex4 --nWifi=2" 2> /dev/null

Num clients = 2 Avg throughput = 1025.54 kbits/sec

suppress stderr messages

Create a shell-script, named run-all.sh, that runs the simulation with different values for nWifi

Run the shell-script and redirect all stdout messages to a file

#!/bin/bash

for ((i=2; i<=14; i += 2)); do

waf --run "pm-ex4 --nWifi=$i"

$ bash run-all.sh > results.dat

Visualize results with gnuplot

$ gnuplot

gnuplot> plot 'results.dat' using 4:8 with lines

Create a script, genplot.gnuplot, for generating a plot as a PNG file

Change x-axis to load,

Polish the plot: turn on grid, turn off legend

#!/usr/bin/gnuplot

set terminal png

set output 'graph.png'

set xrange [0:]

set yrange [0:]

set xlabel 'Load (kb/s)'

set ylabel 'Average Throughput (kb/s)'

set grid

plot 'results.dat' using ($4*512):8 with lines notitle

Run the plotting script

$ gnuplot genplot.gnuplot

Publication-quality results should be obtained from many replications in each scenario Use --RngRun=<run-number> to change random

sequence

Running Multiple Replications

$ waf --run "pm-ex4 --nWifi=10 --RngRun=3"

Study impact of number of mobile stations to packet delivery ratio

Hands-on Exercise

Ns3 Part4 Wireless

Documents