vsomeip

vSomeIP

Copyright

Copyright (C) 2014-2026 Bayerische Motoren Werke Aktiengesellschaft (BMW AG) This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.

License

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.

Contributing Guidelines

For comprehensive details on how to contribute effectively to the project, please refer to our CONTRIBUTING.md file.

vSomeIP Overview

The vSomeIP stack implements the http://some-ip.com/ (Scalable service-Oriented MiddlewarE over IP (SOME/IP)) Protocol. The stack consists out of:

• a shared library for SOME/IP (libvsomeip3.so)
• a shared library for SOME/IP's configuration module (libvsomeip3-cfg.so)
• a shared library for SOME/IP's service discovery (libvsomeip3-sd.so)
• a shared library for SOME/IP's E2E protection module (libvsomeip3-e2e.so)

Build Instructions for Linux

Dependencies

• A C++20 enabled compiler is needed.
• vSomeIP uses CMake as buildsystem.
• vSomeIP uses Boost >= 1.75.0:

For the tests Google's test framework https://code.google.com/p/googletest/[gtest] is needed. -- URL: https://googletest.googlecode.com/files/gtest-.zip

To build the documentation doxygen and graphviz are needed: --sudo apt-get install doxygen graphviz

Compilation

For compilation call:

mkdir build
cd build
cmake ..
make

To specify a installation directory (like --prefix= if you're used to autotools) call cmake like:

cmake -DCMAKE_INSTALL_PREFIX:PATH=$YOUR_PATH ..
make
make install

Compilation with predefined unicast and/or diagnosis address

To predefine the unicast address, call cmake like:

cmake -DUNICAST_ADDRESS=<YOUR IP ADDRESS> ..

To predefine the diagnosis address, call cmake like:

cmake -DDIAGNOSIS_ADDRESS=<YOUR DIAGNOSIS ADDRESS> ..

The diagnosis address is a single byte value.

Compilation with custom default configuration folder

To change the default configuration folder, call cmake like:

cmake -DDEFAULT_CONFIGURATION_FOLDER=<DEFAULT CONFIGURATION FOLDER> ..

The default configuration folder is /etc/vsomeip.

Compilation with custom default configuration file

To change the default configuration file, call cmake like:

cmake -DDEFAULT_CONFIGURATION_FILE=<DEFAULT CONFIGURATION FILE> ..

The default configuration file is /etc/vsomeip.json.

Compilation with signal handling

To compile vSomeIP with signal handling (SIGINT/SIGTERM) enabled, call cmake like:

cmake -DENABLE_SIGNAL_HANDLING=1 ..

In the default setting, the application has to take care of shutting down vSomeIP in case these signals are received.

Build Instructions for Android

Dependencies

• vSomeIP uses Boost >= 1.75. The boost libraries (system and filesystem) must be included in the Android source tree and integrated into the build process with an appropriate Android.bp file.

Compilation

In general for building the Android source tree the instructions found on the pages from the Android Open Source Project (AOSP) apply (https://source.android.com/setup/build/requirements).

To integrate the vSomeIP library into the build process, the source code together with the Android.bp file has to be inserted into the Android source tree (by simply copying or by fetching with a custom platform manifest). When building the Android source tree, the Android.bp file is automatically found and considered by the build system.

In order that the vSomeIP library is also included in the Android image, the library has to be added to the PRODUCT_PACKAGES variable in one of a device/target specific makefile:

PRODUCT_PACKAGES += \
    libvsomeip \
    libvsomeip_cfg \
    libvsomeip_sd \
    libvsomeip_e2e \

Build Instructions for Windows

Setup

• Visual Studio Code
• Visual Studio Build Tools with:
  • Desktop development with C++
  • MSVC v143 - VS 2022 C++ x64/x86 build tools
  • Windows 10/11 SDK
  • CMake for Windows
• vSomeIP uses CMake as buildsystem.
• vSomeIP uses Boost >= 1.75.0:
• GIT

For the tests Google's test framework https://code.google.com/p/googletest/[gtest] is needed. -- URL: https://googletest.googlecode.com/files/gtest-.zip or -- git clone https://github.com/google/googletest.git

Compilation

For compilation call:

rmdir /s /q build
cd build
cmake .. -A x64 -DCMAKE_INSTALL_PREFIX:PATH=$YOUR_PATH
cmake --build . --config [Release|Debug]
cmake --build . --config [Release|Debug] --target install

For compilation outside vsomeip-lib folder call:

…