This repository provides code to integrate the OMNeT++ network simulator with the Mobility Simulation Framework Eclipse MOSAIC. The federate is a wrapper around OMNeT++ and the INET framework and provides a socket-based communication between this federate and the OmnetppAmbassador, thus enabling a coupling between those two tools.
The federate can be build using the omnet_installer.sh script which is bundled with each Eclipse MOSAIC distribution. See MOSAIC's website for additional and detailed instructions.
The subsequent instructions therefore adresses advanced users who want to alter the source code of the federate. If you just want to use the coupling between MOSAIC and OMNeT++, you can use the omnet_installer.sh script.
The omnetpp-federate has the following dependencies:
protobufgtestinet(tested with version4.1)omnetpp(tested with version5.5)
Building omnetpp-federate requires further dependencies:
premakepremake-autoconf
The source code and binary tar balls for Windows, Linux and Mac OS X of premake are available at https://premake.github.io/download.html.
When you choose the binary version then the tar ball extracts just one single binary called premake5 for direct use. Please keep in mind that premake is
written as a c-binding to a modified variant of lua that is statically linked in. The currently (premake5-alpha12) linked in lua version is 5.3 which should be considered when placing extensions of premake.
The building of premake5 from source for linux is strait forward and is done with GNU make.
~$ make -f Bootstrap.mak linux
~# cp bin/release/premake5 /usr/local/binThe second dependency premake5-autoconf can be downloaded from https://github.com/Blizzard/premake-autoconf.git.
It consists of a flat directory of lua files. These can be directly placed in the omnet-federate build directory or
in a directory your premake5 can find it. Usually it will show the search directories that is looking into for modules when a module was not found, i.e. /usr/local/share/lua/5.3/. The premake5-autoconf module introduces support for autoconf style checks for headers and libraries and, and full clang support.
Ubuntu 16.04 xenial users can use a package from "PPA for Paul McEnery", see https://launchpad.net/~pmcenery/+archive/ubuntu/ppa/+packages?field.name_filter=premake&field.status_filter=published&field.series_filter=.
~$ premake5 gmake
~$ make config=debug clean # config=release
~$ make config=debug # config=releaseSome source file are generated by the OMNeT++ message compiler or the protobuf compiler. To regenerate these files
pass the options --generate-opp-messages and/or --generate-protobuf. The regeneration is done during make.
To trigger the install target pass --install to premake5 and run make as super user.
~$ premake5 gmake --install
~# make config=debug clean
~# make config=debugTo run omnetpp-federate with NED files specify the NED root source folder:
~$ /usr/bin/omnetpp-federate -n /usr/share/ned omnetpp.iniOtherwise, if there are multiple directories then you can specify the NED source directories by setting the environment variable NEDPATH.
~$ export NEDPATH="/usr/include/inet:/usr/share/ned"
~$ /usr/bin/omnetpp-federate