Difference between revisions of "Ns-3 on Visual Studio 2012"

From Nsnam
Jump to: navigation, search
(Adding a new module)
(Adding a new module)
Line 101: Line 101:
 
File:new_filter.png|Create model and helper filters
 
File:new_filter.png|Create model and helper filters
 
File:model_helper.png|Add a new source file to model
 
File:model_helper.png|Add a new source file to model
 +
File:source.png|a new source file under "model"
 
</gallery>
 
</gallery>
 
[[File:New filter|thumbnail|New Filter]]
 
[[File:New filter|thumbnail|New Filter]]
 
[[File:Model helper|thumbnail|Add a new source file to model]]
 
[[File:Model helper|thumbnail|Add a new source file to model]]
 +
[[File:Source|thumbnail|a new source file under "model"]]
  
 
== Design of the solution ==
 
== Design of the solution ==

Revision as of 19:23, 29 September 2013

Prerequisites

Please note: Visual Studio 2010 is not supported

How to download

The ns-3 package is available for download using mercurial using the command below

hg clone http://code.nsnam.org/jabraham3/ns-3-win2

How to build

Open the solution file "ns-3-win2/windows/ns-3-dev/ns-3-dev.sln" using Visual Studio 2012. After all the projects are loaded do the following:

  • From the menu click "Build" --> "Build Solution"
Click Build--> Build Solution

If all goes well we should see a build log similar to the below

1>  main.vcxproj -> C:\ws\test\ns-3-win2\windows\ns-3-dev\Debug\main.exe
========== Build: 1 succeeded, 0 failed, 34 up-to-date, 0 skipped ==========

Running the main program

The "main" project is set as the "Startup" project. The "Startup" project contains the program with the 'main' function. The main project is set to run "third.cc".

Default program is third.cc


The executable can be run from the command-prompt by

C:\>cd windows\ns-3-dev\Debug
..Debug>main.exe


executing main.exe








.

Changing the main program

To replace the default main program in the "main" project. Do the following:

  1. Select the "main" project
  2. Expand the "Source Files" filter
  3. Right-Click on the existing .cc file, which in a new installation is "third.cc" and select "Remove"
  4. Right-Click on "Source Files" --> "Add"
  5. In the popup-menu select "Existing Item" to add an existing source file or select "New Item" to create a new source file.

Changing the current main program

  1. At this point you can repeat the #How to build steps above to build the solution.

Adding a new module

To create your own module do the following:

  • Create an empty C++ project
    • Right-click on the "Solution ns-3-dev" and select Add --> "New Project"
    • In the dialog that follows select "Visual C++"--> "Empty Project" as the type of project.
    • Enter the name of your module such as "MyModule" and click OK.
  • Open the properties page
    • From the solution view, right-click on the new project ("MyModule") and select "Properties"
  • Set the path to find headers:
    • Under "Configuration Properties" --> "C/C++" --> "General" --> "Additional Include Directories" on the right-pane append the value "$(SolutionDir)\headers;" to specify the location of other ns-3 headers
  • Set Preprocessor defintions:
    • Under "Configuration Properties" --> "C/C++" --> "Preprocessor" --> "Preprocessor definitions" on the right-pane append the value "WIN32"
  • Set the module as a static library:
    • Under "Configuration Properties" --> "General" --> "Project Defaults" (on the right-pane) --> "Configuration Type" --> set the value to "Static Library (.lib)"
  • Move your modules header files to the common headers location:
    • Under "Configuration Properties" --> "Build Events" --> "Post-Build Events" --> "Command Line" (on the right-pane) --> Add the following lines to move your API's model and helper headers to the common ns-3 header location.
copy "$(SolutionDir)\..\..\src\MyModule\model\*.h"  "$(SolutionDir)\headers\ns3"
copy "$(SolutionDir)\..\..\src\MyModule\helper\*.h"  "$(SolutionDir)\headers\ns3"
  • Create model and helper filters to add source files:
    • From the solution view, right-click on the new project ("MyModule") and select "Add" --> "New Filter" and name the new filter as "model". Repeat the same to create another filter named "helper"
    • Right-click the "model" filter and select "Add" --> "New Item" and enter a suitable file name for your source file.
File:New filter
New Filter
File:Model helper
Add a new source file to model
File:Source
a new source file under "model"

Design of the solution