Eclipse uProtocol Rust vsomeip Client

Overview

This library implements a uTransport client for vsomeip in Rust following the uProtocol uTransport Specifications.

Getting Started

Building the Library

To build the library, setup the environment

source build/env_setup.sh

then run:

VSOMEIP_INSTALL_PATH=<path/to/where/to/install/vsomeip> cargo build

in the project root directory.

See vsomeip-sys/README.md for more details on options.

This library leverages the up-rust library for data types and models specified by uProtocol.

Running the Tests

To run the tests, run

 VSOMEIP_INSTALL_PATH= <path/to/vsomeip/install> LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<path/to/vsomeip/install>/lib cargo test -- --test-threads 1

Breaking this down:

• Details about the environment variables can be found in vsomeip-sys/README.md. Please reference there for further detail.
• We need to pass in -- --test-threads 1 because the tests refer to the same configurations and will fall over if they are run simultaneously. So we instruct to use a single thread, i.e. run the tests in serial.

Using the Library

The library contains the following modules: