# Software

The software listed on this page was developed during my PhD and used during my studies.

## Measuring of Network Characteristics using Mobile Cellular Networks

The first version of the Rate Measurement Framework (RMF) was developed by Sebastian Wilken during his master thesis. It was further enhanced by Christian Lange and Tobias Krauthoff during their master theses and Franz Kary during his project phase. Lately large parts were modified by me to fullfill all requirements for the currently used self-induced congestion aware implementation of our measurement algorithm.

The RMF itself is publisehd under the MIT License, the version used for the paper can be found in the source tarball.
All later versions of the sources are also available through the github repository https://github.com/hhucn/rmf.

The RMF makes use of STLSoft and Pantheios (using the BSD-form license) librariers. As Pantheois needs to be patched for gcc>4.6, the patched sources are included in our tarball and in the dependencies directory on github (including the corresponding licenses).

Please read the INSTALL file in the tarball for detailed installation instructions.

# Trace-based UMTS Simulation (TBUS) for OMNeT++ and VSimRTI

Last changed: March 1st 2016

This Website provides an overview of the developed software and resources for the paper Coupled Simulation of Mobile Cellular Networks, Road Traffic and V2X applications using Traces.
The copyright of each resource used remains at the resource's author(s).
Our own contributions are marked as such and do not claim the copyright of original authors.
The corresponding licenses are included in the given projects. While the simulations for the paper were conducted using VSimRTI 0.14.0 we describe the installation on the more advanced VSimRTI 0.15.0.

## Licensing Notice

In addition to the published licenses, VSimRTI requires a valid license to be run.
This license can be obtained from Fraunhofer FOKUS as described in the Introduction chapter of the VSimRTI manual available from www.dcaiti.tu-berlin.de/research/simulation/download/.

## Software Requirements

These instructions have been tested for VSimRTI 0.15.0, SUMO 0.21.0 and OMNeT++ 4.4.1 on multiple linux systems.
Other versions may work, but have not been tested.

## Installation instructions

We wrote a small installation script that eases the compilation and installation of our OMNeT++ module and example scenarios in VSimRTI. Nevertheless some manual steps are needed during the installation.
The installation script should only alter content or create ~/omnetpp-4.4.1 and ~/vsimrti-allinonce and append omnetpp-4.4.1 to your PATH variable.

Before starting the installation please make sure that:

• you have no valuable simulation results in your vsimrti directories,
• that omnet++ is not already installed for the current user
• that omnet++ is not included in the PATH variable of the current user.
We are not responsible for data loss by our script or software!

For an easier installation of required libraries and programs, please have a look at this list. If you are working on a debian-based system, the following command can install all necessary packages:
sudo apt-get update && sudo apt-get install libicu-dev mpi-default-dev libpcap-dev libproj-dev tk-dev tcl-dev libxerces-c-dev libtool libgdal-dev libfox-1.6-dev libxml2-dev zlib1g-dev default-jre bison flex build-essential gcc g++

1. Get copys of the following downloads and store them at a location you can type easily. In the remainder of these instuctions we assume you stored the files in /tmp.
2. Install VSimRTI by unzipping vsimrti-bin-0.15.0.zip according to their manual Section 1.2.
3. Install SUMO >=0.21.0 and SUMO <=0.24.0 according to Section 6.5.2 of the VSimRTI manaul.
On ubuntu system often apt-get install sumo suffices.
4. Use our installation script tbus-installer.sh:
/tmp/tbus-installer.sh -t /tmp/omnetpp-4.4.1-src.tgz -p ~/vsimrti-allinone/vsimrti/
assuming that you downloaded the files to /tmp and unzipped vsimrti-0.15.0.zip to ~/vsimrti-allinone.
The script will automatically
• configure, compile and install OMNeT++ 4.4.1 with Fraunhofers patch and our libtbus to ~/omnetpp-4.4.1
• disable automatic starting of omnetpp in vsimrti default.xml
• install the example scenarios for tbus Taubental-large and Taubental-large-etsi including all necessary files to start a libtbus based simulation.
Especially the compilation of omnet++ will take some time. The displayed compilation warnings are normal and can be ignored.

## Starting a simulation

We provide two example scenarios using the same simulation area but different implementations of the emergency vehicle warning V2X-application:

• Taubental-large-etsi: A simulation using etsi conform CAM and DEMN intervals for emergency vehichle warning messages.
• Taubental-large: An enhanced version of the V2X application, that is optimized for cellular network usage.
To start a simulation using Taubental-large scenario you need to issue the following two commands in the vsimrti directory:
1. ./start-omnet-federate.sh -c scenarios/Taubental-large
2. ./vsimrti.sh -u USERNAME -c scenarios/Taubental-large/vsimrti/vsimrti_config.xml