Vanetza is an open-source implementation of the ETSI C-ITS protocol suite. This comprises the following protocols and features among others:
- GeoNetworking (GN)
- Basic Transport Protocol (BTP)
- Decentralized Congestion Control (DCC)
- Support for ASN.1 messages (Facilities) such as CAM and DENM
Though originally designed to operate on ITS-G5 channels in a Vehicular Ad Hoc Network (VANET) using IEEE 802.11p, Vanetza and its components can be combined with other communication technologies as well, e.g. GeoNetworking over IP multicast.
How to build
Building Vanetza is accomplished by the CMake build system. Hence, CMake needs to be available on the build host.
You need following tools and libraries on your system for compiling Vanetza:
- C++11 compatible compiler, e.g. GNU GCC or Clang
- CMake 3.1 or higher
- Boost 1.58 or higher
- GeographicLib 1.37 or higher
- Crypto++ 5.6.1 or higher
If OpenSSL (1.0 or 1.1) or LibreSSL is available on your system, an alternative security backend implementation is compiled along with the Crypto++ based backend.
security::create_backend for more details.
Following command line snippet demonstrates the build process using a generated Makefile. Other CMake generators and build directory setups can be used as well.
cd vanetza mkdir build && cd build cmake .. make
We strive for quality in our code base. Latest commits are built using Travis CI as part of this effort.
Vanetza ships with a simple demo application called socktap. You can enable the build process for this application by the BUILD_SOCKTAP CMake option. See tools/socktap for details. If socktap is going to be built gpsd is required in addition to aforementioned prerequisites.
Vanetza is primarily a library project intended for integration by other projects, e.g. V2X simulation tools such as Artery.
Projects using CMake can integrate Vanetza most easily by calling
find_package(Vanetza) and then refer to the imported Vanetza targets, such as
Development of Vanetza is part of ongoing research work at Technische Hochschule Ingolstadt. Maintenance is coordinated by Raphael Riebl. Contributions are happily accepted.
Vanetza is licensed under LGPLv3, see license file for details.