Skip to main content

Adding a New Agent and Application in Network Simulator 2 (NS2)

 This post is reproduced from this website http://nile.wpi.edu/NS/new_app_agent.html.  But the above code is compiled for older ns2 version. But nsnam.com showcases the code for ns-2.35 version. You can read the theory about the agent from this weblink.
 
A Simple theory about Application and Agent
In Ns2, Nodes are individual entities where in...

Nodes -> Agent -> Application
Nodes is attached with an Agent and the Agent carries the Application. You can see the following image where Node is attached with the Agent and the Agent carries the FTP or CBR Application

Here is an Agent and Application is implemented
Agent - UDPmm
Application - mmApp


ns2
node -> Agent -> Application
To compile it 
Method 1: Easy method


Please download the code here
  • Copy the mm-app.cc/.h and udp-mm.cc/.h in the -ns-2.35/multimedia directory
  • there is another folder called ns-modified-files/folder, copy the files which are there in to the corresponding location as specified below (Replace the existing files, Also take backup of your old files)
Following Files are modified
-ns-2.35/common/packet.h
 -ns-2.35/common/agent.h
-ns-2.35/tcl/lib/ns-packet.tcl
-ns-2.35/tcl/lib/ns-default.tcl
-ns-2.35/apps/app.h
-ns-2.35/Makefile.in


Then from the ns-2.35/folder 
$] ./configure && make
Test the testmm.tcl file and see the output, you can create any tcl file with udpmm as an agent and mmapp as application layer. 

Method 2: For advanced users...

  1. Copy "mm-app.h", "mm-app.cc", "udp-mm.h" and "udp-mm.cc" to the "~ns-2.35/multimedia" directory.
  1. Add the entry to Makefile.in as shown below
~ns-2.35/Makefile.in
OBJ_CC=
.....................
multimedia/mm-app.o multimedia/udp-mm.o \
  1. Register the new application header by modifying "packet.h" (~ns-2.35/common/packet.h) and "ns-packet.tcl" (~ns-2.35/tcl/lib/ns-packet.tcl) as shown below.
Change the following lines to
// AOMDV packet

static const packet_t PT_AOMDV = 72;

// insert new packet types here
static packet_t PT_NTYPE = 73; // This MUST be the LAST one

// AOMDV packet

static const packet_t PT_AOMDV = 72;

static const packet_t PT_Multimedia = 73;
// insert new packet types here

static packet_t PT_NTYPE = 74; // This MUST be the LAST one

Change the following lines to
name_[PT_AOMDV]= "AOMDV";
name_[PT_NTYPE]= "undefined";


name_[PT_AOMDV]= "AOMDV";
name_[PT_Multimedia]="Multimedia";
name_[PT_NTYPE]= "undefined";

change the following lines in the ns-packet.tcl
# Other:

Encap # common/encap.cc

IPinIP # IP encapsulation

HDLC # High Level Data Link Control

# Other:

Encap # common/encap.cc

IPinIP # IP encapsulation

HDLC # High Level Data Link Control

Multimedia

  1. Add supportMM() and enableMM() methods to the "Agent" class in "agent.h" (~ns-2.35/common/agent.h) as shown below.

Add the two yellow colored lines in agent.h in Agent Class
class Agent : public Connector {

public:

--------------------------

virtual void sendmsg(int sz, AppData*, const char* flags = 0);

virtual void send(int sz, AppData *data) { sendmsg(sz, data, 0); }

virtual int supportMM() { return 0; }
virtual void enableMM(){}

virtual void attachApp(Application* app);

virtual int& size() { return size_; }

  1. Add recv_msg() method to the "Application" class in "app.h" (~ns-2.35/apps/app.h) as shown below.

Add the yellow line to app.h in Application Class.
class Application : public Process {

public:

Application();

virtual void send(int nbytes);

virtual void recv(int nbytes);

virtual void recv_msg(int nbytes, const char *msg=0){}

virtual void resume();

  1. Set default values for the newly introduced configurable parameters in "ns-default.tcl" as shown below.
# There are five rates in which the application layer is supporting..
Application/MmApp set rate0_ 0.3mb
Application/MmApp set rate1_ 0.6mb
Application/MmApp set rate2_ 0.9mb
Application/MmApp set rate3_ 1.2mb
Application/MmApp set rate4_ 1.5mb

Application/MmApp set pktsize_ 1000
Application/MmApp set random_ false

  1. Be SURE to complete this last step. Otherwise, all five-scale rates are initialized to zero unless specified in the input simulation script (i.e., the test simulation script given below will not transmit any frames).
  1. Go to ns-2.35 using shell prompt and enter the commands
./configure
make
  1. Run the file using “ns testmm.tcl” (this is to test your multimedia using applications) 

     Here is a sample output
    Multimedia Agent
     

 T S Pradeep Kumar

Comments

Popular posts from this blog

Installation of NS2 (ns-2.35) in Ubuntu 20.04

Installation of NS2 (ns-2.35) in Ubuntu 20.04 LTS Step 1: Install the basic libraries like      $] sudo apt install build-essential autoconf automake libxmu-dev Step 2: install gcc-4.8 and g++-4.8 open the file using sudo mode $] sudo nano /etc/apt/sources.list Include the following line deb http://in.archive.ubuntu.com/ubuntu bionic main universe $] sudo apt update $] sudo apt install gcc-4.8 g++-4.8 Step 3:  Unzip the ns2 packages to home folder $] tar zxvf ns-allinone-2.35.tar.gz $] cd ns-allinone-2.35/ns-2.35 Modify the following make files. ~ns-2.35/Makefile.in Change @CC@ to gcc-4.8 change @CXX@ to g++-4.8 ~nam-1.15/Makefile.in ~xgraph-12.2/Makefile.in ~otcl-1.14/Makefile.in Change in all places  @CC@ to gcc-4.8 @CPP@ or @CXX@ to g++-4.8 open the file: ~ns-2.35/linkstate/ls.h Change at the Line no 137  void eraseAll() { erase(baseMap::begin(), baseMap::end()); } to This void eraseAll() { this->erase(baseMap::begin(), baseMap::end()); } All changes made Step 4: Open a new termi

Installing ns-3.34 in Ubuntu 20.04

This post shows how to install ns 3.34 in Ubuntu 20.04 LTS Prerequisites: Fresh installation of Ubuntu Version 20.04 LTS  ns3.34 can be downloaded from here Follow the video link for complete step by step instructions on the installation.  This version fixes the compilation issues of vanet-routing-compare.cc (bug in ns3.33)  Issue the following commands after opening a terminal  $ sudo apt update $ sudo apt install g++ python3 python3-dev python-dev pkg-config sqlite3 python3-setuptools git qt5-default gir1.2-goocanvas-2.0 python3-gi python3-gi-cairo python3-pygraphviz gir1.2-gtk-3.0 ipython3 openmpi-bin openmpi-common openmpi-doc libopenmpi-dev autoconf cvs bzr unrar openmpi-bin openmpi-common openmpi-doc libopenmpi-dev tcpdump wireshark libxml2 libxml2-dev Unzip or untar the ns-allinone-3.34.tar.bz2 in the home folder (in my case its /home/pradeepkumar) $ cd ns-allinone-3.34/ $ ./build.py --enable-examples --enable-tests  Once the installation is completed, you may get an output show

Installation of ns3 in Windows 10 and Windows 11 OS using WSL (Windows Subsystem for Linux)

This post shows how to install ns-3.33 in Windows 10 through WSL (Windows Subsystem for Linux) This posts works for Windows 11 also (I have tested it on a Windows 11 ISO and it works the Same way as mentioned in the following post.) This post will work for ns-3.3x version. Prerequisites : Install Windows Subsystem for Linux with GUI: Please refer the following video  System Information: OS used: Windows 10 and WSL (Ubuntu 20.04) GUI: XServer for Windows NS3 Version: ns-3.33 See the following complete video on how to install ns3 in Windows 10 Step 0 : Open XLaunch Step 1 :  Open WSL using PowerShell and open it as Administrator Command:/  wsl $ xfce4-session The GUI of Ubuntu Opens within Windows 10 OS. Step 2 : Download ns3 from nsnam.org website through Mozilla Firefox browser Step 3: Open a Terminal  $ sudo apt update $ sudo apt install build-essential autoconf automake libxmu-dev python3-pygraphviz cvs mercurial bzr git cmake p7zip-full python3-matplotlib python-tk python3-dev qt5-q