{"id":15035739,"url":"https://github.com/covesa/vsomeip","last_synced_at":"2025-10-07T09:52:47.150Z","repository":{"id":37629310,"uuid":"68405620","full_name":"COVESA/vsomeip","owner":"COVESA","description":"An implementation of Scalable service-Oriented MiddlewarE over IP","archived":false,"fork":false,"pushed_at":"2025-09-15T10:53:49.000Z","size":15541,"stargazers_count":1288,"open_issues_count":114,"forks_count":757,"subscribers_count":82,"default_branch":"master","last_synced_at":"2025-09-15T12:28:59.227Z","etag":null,"topics":["automotive","service-discovery","someip","vsomeip"],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/COVESA.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-09-16T18:36:18.000Z","updated_at":"2025-09-15T10:53:53.000Z","dependencies_parsed_at":"2023-02-09T12:15:51.543Z","dependency_job_id":"c1249267-0487-4359-b7ef-d4b7dc026c86","html_url":"https://github.com/COVESA/vsomeip","commit_stats":{"total_commits":464,"total_committers":60,"mean_commits":7.733333333333333,"dds":0.5948275862068966,"last_synced_commit":"5b593b7d0a0c5f51bda0d712b4537e790656817d"},"previous_names":["genivi/vsomeip"],"tags_count":72,"template":false,"template_full_name":null,"purl":"pkg:github/COVESA/vsomeip","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/COVESA%2Fvsomeip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/COVESA%2Fvsomeip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/COVESA%2Fvsomeip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/COVESA%2Fvsomeip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/COVESA","download_url":"https://codeload.github.com/COVESA/vsomeip/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/COVESA%2Fvsomeip/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278755147,"owners_count":26040034,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automotive","service-discovery","someip","vsomeip"],"created_at":"2024-09-24T20:29:21.579Z","updated_at":"2025-10-07T09:52:47.144Z","avatar_url":"https://github.com/COVESA.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"### vSomeIP\n\n##### Copyright\nCopyright (C) 2015-2024, Bayerische Motoren Werke Aktiengesellschaft (BMW AG)\n\n##### License\n\nThis Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0.\nIf a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.\n\n##### Contributing Guidelines\n\nFor comprehensive details on how to contribute effectively to the project, please refer to our [CONTRIBUTING.md](./CONTRIBUTING.md) file.\n\n##### vSomeIP Overview\n----------------\nThe vSomeIP stack implements the http://some-ip.com/ (Scalable service-Oriented MiddlewarE over IP (SOME/IP)) Protocol.\nThe stack consists out of:\n\n* a shared library for SOME/IP (`libvsomeip3.so`)\n* a shared library for SOME/IP's configuration module (`libvsomeip3-cfg.so`)\n* a shared library for SOME/IP's service discovery (`libvsomeip3-sd.so`)\n* a shared library for SOME/IP's E2E protection module (`libvsomeip3-e2e.so`)\n\nOptional:\n\n* a shared library for compatibility with vsomeip v2 (`libvsomeip.so`)\n\n##### Build Instructions for Linux\n\n###### Dependencies\n\n- A C++17 enabled compiler is needed.\n- vSomeIP uses CMake as buildsystem.\n- vSomeIP uses Boost \u003e= 1.66.0:\n\nFor the tests Google's test framework https://code.google.com/p/googletest/[gtest] is needed.\n-- URL: https://googletest.googlecode.com/files/gtest-\u003cversion\u003e.zip\n\nTo build the documentation doxygen and graphviz are needed:\n--`sudo apt-get install doxygen graphviz`\n\n###### Compilation\n\nFor compilation call:\n\n```bash\nmkdir build\ncd build\ncmake ..\nmake\n```\n\nTo specify a installation directory (like `--prefix=` if you're used to autotools) call cmake like:\n```bash\ncmake -DCMAKE_INSTALL_PREFIX:PATH=$YOUR_PATH ..\nmake\nmake install\n```\n\n###### Compilation with predefined unicast and/or diagnosis address\nTo predefine the unicast address, call cmake like:\n```bash\ncmake -DUNICAST_ADDRESS=\u003cYOUR IP ADDRESS\u003e ..\n```\n\nTo predefine the diagnosis address, call cmake like:\n```bash\ncmake -DDIAGNOSIS_ADDRESS=\u003cYOUR DIAGNOSIS ADDRESS\u003e ..\n```\nThe diagnosis address is a single byte value.\n\n###### Compilation with custom default configuration folder\nTo change the default configuration folder, call cmake like:\n```bash\ncmake -DDEFAULT_CONFIGURATION_FOLDER=\u003cDEFAULT CONFIGURATION FOLDER\u003e ..\n```\nThe default configuration folder is `/etc/vsomeip`.\n\n###### Compilation with custom default configuration file\nTo change the default configuration file, call cmake like:\n```bash\ncmake -DDEFAULT_CONFIGURATION_FILE=\u003cDEFAULT CONFIGURATION FILE\u003e ..\n```\nThe default configuration file is `/etc/vsomeip.json`.\n\n###### Compilation with signal handling\n\nTo compile vSomeIP with signal handling (SIGINT/SIGTERM) enabled, call cmake like:\n```bash\ncmake -DENABLE_SIGNAL_HANDLING=1 ..\n```\nIn the default setting, the application has to take care of shutting down vSomeIP in case these signals are received.\n\n###### Note on Ubuntu 24.04 Build Issues\n\nIf you encounter build issues on Ubuntu 24.04, consider using Ubuntu 22.04 as a temporary fix. This is due to the ongoing transition of the GitHub Actions runner to Ubuntu 24.04, which may cause compatibility issues.\n\n##### Build Instructions for Android\n\n###### Dependencies\n\n- vSomeIP uses Boost \u003e= 1.66. 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.\n\n###### Compilation\n\nIn 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).\n\nTo 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).\nWhen building the Android source tree, the Android.bp file is automatically found and considered by the build system.\n\nIn 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:\n\n```\nPRODUCT_PACKAGES += \\\n    libvsomeip \\\n    libvsomeip_cfg \\\n    libvsomeip_sd \\\n    libvsomeip_e2e \\\n```\n\n##### Build Instructions for Windows\n\n###### Setup\n\n- Visual Studio Code\n- Visual Studio Build Tools with:\n    - Desktop development with C++\n    - MSVC v143 - VS 2022 C++ x64/x86 build tools\n    - Windows 10/11 SDK\n    - CMake for Windows\n- vSomeIP uses CMake as buildsystem.\n- vSomeIP uses Boost \u003e= 1.71.0:\n- GIT\n\nFor the tests Google's test framework https://code.google.com/p/googletest/[gtest] is needed.\n-- URL: https://googletest.googlecode.com/files/gtest-\u003cversion\u003e.zip\nor\n-- git clone https://github.com/google/googletest.git\n\n###### Compilation\n\nFor compilation call:\n\n```bash\nrmdir /s /q build\ncd build\ncmake .. -A x64 -DCMAKE_INSTALL_PREFIX:PATH=$YOUR_PATH\ncmake --build . --config [Release|Debug]\ncmake --build . --config [Release|Debug] --target install\n```\n\nFor compilation outside vsomeip-lib folder call:\n\n```bash\nrmdir /s /q build\ncmake -B \"buildlib\" -DCMAKE_BUILD_TYPE=[Release|Debug] -DCMAKE_INSTALL_PREFIX=$YOUR_PATH -A x64 vsomeip-lib\n#vsomeip-lib compilation\ncmake --build build --config [Release|Debug] --parallel 16 --target install\n#examples compilation\ncmake --build build --config [Release|Debug] --parallel 16 --parallel 16 --target examples\ncmake --build build --config [Release|Debug] --parallel 16 --target install\n#unit-tests compilation\ncmake --build build/test --config [Release|Debug] --parallel 16 --parallel 16 --target build_unit_tests\n#all tests compilation\ncmake --build build/test --config [Release|Debug] --parallel 16 --parallel 16 --target all build_tests\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcovesa%2Fvsomeip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcovesa%2Fvsomeip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcovesa%2Fvsomeip/lists"}