Skip to content

mit-ll/LL-SimpleWireless

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ll-simple-wireless has the following contents:
==============================================
ll-simple-wireless/:
  /doc
  /examples
  /model
  wscript
  README

ll-simple-wireless/doc:
  simple-wireless.rst

ll-simple-wireless/examples:
  directional_test.cc
  error_model_test.cc
  fixed_contention_test.cc
  mixed_directional_network.cc
  multiple_interface_example.cc
  queue_test.cc
  wscript

ll-simple-wireless/model:
  drop-head-queue.cc
  drop-head-queue.h
  priority-queue.cc
  priority-queue.h
  simple-wireless-channel.cc
  simple-wireless-channel.h
  simple-wireless-net-device.cc
  simple-wireless-net-device.h


*** Please refer to the file simple-wireless.rst in the /doc folder for more information about this model.

Installation Instructions
============================================================
(assumes NS3 is already installed; see below for NS3/DCE installation instructions)

1. Modify the NS3 wscript file to include simple-wireless in the build

   For example, if using DCE add the following line at ~line 96 in dce/source/ns-3-dce/wscript
          ns3waf.check_modules(conf, ['simple-wireless'], mandatory = False)

2. Install the simple wireless in NS3 source using one of these methods:
     a) Copy the files directly to the NS3 directory: /src/simple-wireless
     OR
     b) Use a softlink to your location of ll-simple-wireless to create the NS3 directory /src/simple-wireless
     
     NOTE: the directory from the tar file is named ll_simple_wireless but it is installed in NS3 as simple-wireless

3. Add the simple-wireless as a module in the wscript used to build your NS3 scenario.
   
   For example:
       def configure(conf): 
          ns3waf.check_modules(conf, ['core', 'internet', 'simple-wireless'], mandatory = True)

       def build(bld):
          bld.build_a_script('dce', needed = ['core', 'internet', 'dce', 'mobility', 'simple-wireless'],
          target='bin/my_test_script',
          cxxflags=['-std=c++0x'],
          source=[ my_test_script.cc'] )

4. Rebuild NS3 being sure to enable examples if you want to run the example models provided with the Simple Wireless model

Miscellaneous Notes
===========================================================
* The Simple Wireless model has been run with NS3.22/DCE1.5, NS3.21/DCE1.4 and NS3.20/DCE1.3
* The PriorityQueue uses libpcap to classify control packets so this must be installed to use priority queues.

Installation Instructions for NS3/DCE
============================================================
The Simple Wireless model works in NS3.20/DCE1.3, NS3.21/DCE1.4 and NS3.22/DCE1.5. 
If you have any of these versions currently installed you do not need to install a different version. 
The instructions below are for installing NS3.22 and DCE1.5 release but it is not necessary to install
these if you have an earlier, compatible version already installed.

NOTE: It is assumed that DCE will be installed at ~/dce

1. Install Bake from your home directory
      hg clone http://code.nsnam.org/bake bake

2. Set path variables
      Add the following lines to .profile:
           BAKE_HOME="$HOME/bake"
           PATH="$PATH:$BAKE_HOME"
           PYTHONPATH="/usr/lib/python2.7:$BAKE_HOME"

      Execute the .profile:
           . .profile
           
3. Increase file descriptor limit to 2048
      To check the current value:  	$ ulimit –n
      To change the current value: 	$ ulimit –n 2048

4. Create a directory for DCE
      mkdir dce 

5. Configure, download and build DCE 1.5 (note: this automatically includes ns3.22)
      cd dce
      bake.py configure -e dce-ns3-1.5
      bake.py download    [See note below]
      bake.py build

   During download and build, you may run into missing packages. If so, install them using
   sudo apt-get install xxxx  (where xxxx is the name of the missing package)
   Then after installing re-run the download or build command before proceeding to the next step.

   If the gccxml package is missing, the build may complain about pybindgen instead.  Install gccxml and the pybindgen problem will probably go away. 

   To diagnose a build failure, you may need to use the –vvv flag to get more information:
        bake.py build -vvv

   NOTE: Some of the package names may not match what the dce install says is missing. Examples:
        DCE name                Actual Install Name
        --------------------    -------------------
        pybindgen-0.17.0.868    bzr
        qt4                     qt4-dev-tools
        lib_debug               libc6-dbg
        pygraphviz              python-pygraphviz
        pygoocanvas             python-pygoocanvas


**********************************************************************************************************************************
Distribution Statement
----------------------

 Copyright (C) 2015 Massachusetts Institute of Technology
 All rights reserved.

 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License version 2 as
 published by the Free Software Foundation;

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

**********************************************************************************************************************************

About

LL-SimpleWireless model for ns3

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published