Gitiles
Code Review Sign In
android-review.linaro.org / platform / external / sdv / vsomeip / refs/tags/android-14.0.0_r28
taga1622e6f73b4ff8ff3e0c1174375869b473f3e7e
taggerThe Android Open Source Project <initial-contribution@android.com>Mon Mar 04 14:15:04 2024 -0800
object6a7461f64660822b048b11866d39177ab2b6d1f7 
Android 14.0.0 release 28
commit6a7461f64660822b048b11866d39177ab2b6d1f7[log] [tgz]
authorAndroid Build Coastguard Worker <android-build-coastguard-worker@google.com>Thu Sep 28 01:22:04 2023 +0000
committerAndroid Build Coastguard Worker <android-build-coastguard-worker@google.com>Thu Sep 28 01:22:04 2023 +0000
tree0e363efcd4c3d7e24c97cf7efa52c54623e9d66e
parent63d953b27857894416e4720e2c884521fcebc624 [diff]
parent053ffe1f36ef2f6df530be0640ce936567a09d44 [diff]
Snap for 10872577 from 053ffe1f36ef2f6df530be0640ce936567a09d44 to 24Q1-release

Change-Id: Ic60040965540cd77276489a4f32207660e4da558
tree: 0e363efcd4c3d7e24c97cf7efa52c54623e9d66e
  1. .github/
  2. config/
  3. documentation/
  4. examples/
  5. implementation/
  6. interface/
  7. test/
  8. third_party/
  9. tools/
  10. .gitignore
  11. Android.bp
  12. AUTHORS
  13. CHANGES
  14. CMakeLists.txt
  15. exportmap.gcc
  16. LICENSE
  17. METADATA
  18. MODULE_LICENSE_MPL2
  19. OWNERS
  20. README.md
  21. vsomeip.pc.in
  22. vsomeip.xml
  23. vsomeip3.pc.in
  24. vsomeip3Config.cmake.in
  25. vsomeip3ConfigVersion.cmake.in
  26. vsomeipConfig.cmake.in
  27. vsomeipConfigVersion.cmake.in
README.md

vsomeip

Copyright

Copyright (C) 2015-2017, Bayerische Motoren Werke Aktiengesellschaft (BMW AG)

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/.

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 second shared library for SOME/IP's service discovery (libvsomeip3-sd.so) which is loaded during runtime if the service discovery is enabled.
Build Instructions for Linux
Dependencies
  • A C++11 enabled compiler like gcc >= 4.8 is needed.
  • vsomeip uses CMake as buildsystem.
  • vsomeip uses Boost >= 1.55:

Ubuntu 14.04:

sudo apt-get install libboost-system1.55-dev libboost-thread1.55-dev libboost-log1.55-dev

Ubuntu 12.04: a PPA is necessary to use version 1.54 of Boost: -- URL: https://launchpad.net/~boost-latest/+archive/ubuntu/ppa --sudo add-apt-repository ppa:boost-latest/ppa --sudo apt-get install libboost-system1.55-dev libboost-thread1.55-dev libboost-log1.55-dev

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

To build the documentation asciidoc, source-highlight, doxygen and graphviz is needed: --sudo apt-get install asciidoc source-highlight 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.55. The boost libraries (system, thread and log) 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