8 unstable releases (3 breaking)
0.4.0 | Sep 23, 2022 |
---|---|
0.3.2 | Aug 31, 2022 |
0.2.2 | Aug 17, 2022 |
0.2.1 | Apr 26, 2022 |
0.1.1 | Sep 23, 2021 |
#569 in Hardware support
26 downloads per month
1.5MB
27K
SLoC
Vehicle Signal Specification for Cyclonedds-rs
This crate generates the DDS Topic types for use in an automotive platform. The types are based on the GENIVI VSS Specification. The aim of the Vehicle Signal Specification (VSS) is to create a common understanding of vehicle signals independent of the protocol or serialization format.
This crate depends on cyclonedds-rs, the safe Rust binding for cyclonedds.
Version
Version 3.0 of the specification is used. https://github.com/COVESA/vehicle_signal_specification/commit/525e2bd00ddf061851bdc75e849178e5d3ad5833
Usage of DDS Keys
This implementation uses keys in the generated types. This simplifies the type path considerably. For example, in the GENIVI VSS, you will find the following type names
- Vehicle.Cabin.Door.Row1.Left.Window.Position
- Vehicle.Cabin.Door.Row2.Left.Window.Position
- Vehicle.Cabin.Door.Row1.Right.Window.Position
- Vehicle.Cabin.Door.Row2.Right.Window.Position
In the generated binding, you will find just one type
- Vehicle.Cabin.Door.Window.Position
The Row and the Side of the window is converted into values within the Position structure.vehicle_signals::vehicle::cabin:🚪🪟:Position The row and the side are marked as topic keys.
Build Instructions (If you want to move to a newer version of the VSS)
The signals are generated from the CSV output of the GENIVI vehicle signal specification. Copy the generated CSV file into this repo and update the build.rs to reflect the correct file.
Vehicle signal specification : https://github.com/GENIVI/vehicle_signal_specification/
Examples
- Vehicle Speed Publisher https://github.com/sjames/demo-vehicle-speed-publisher.git
- Vehicle Speed Subscriber (async support) https://github.com/sjames/demo-vehicle-speed-subscriber.git
Dependencies
~2–6MB
~111K SLoC