Skip to content

LikhithST/VSS-ROS-Bridge

Repository files navigation

VSS-ROS-Bridge

Overview

VSS-ROS-Bridge provides a bridge between the KUKSA.val databroker and ROS 2. It subscribes to Vehicle Signal Specification (VSS) data points and publishes them as ROS topics, enabling control of simulators such as turtlesim and the F1TENTH simulator using standardized vehicle signals.


Architecture

flowchart LR
    A[VSS Signals] --> B[KUKSA.val Databroker]
    B --> C[VSS-ROS Bridge]
    C --> D[ROS 2 Topics]
    D --> E[turtlesim]
    D --> F[FlexCAR]
Loading

The VSS-ROS bridge can be easily intentegrated with simulation (turtlesim) or FlexCAR, the following demonstration section demonstrates VSS-ROS bridge being used between turtlesim and FlexCAR with no code changes. This enables safe and faster prototyping and testing of vehicular functions


Demonstration

Turtle Sim

VSS-ROS Bridge Demo

FlexCAR

VSS-ROS Bridge Demo


Technology Stack

  • KUKSA.val
  • COVESA Vehicle Signal Specification (VSS)
  • ROS 2 Humble
  • Docker and Docker Compose

Project Structure

VSS-ROS-Bridge/
├── assets/
├── csv_provider/
├── f2tenth_simulator/
├── publisher/
├── scripts/
├── img/
├── docker-compose.yml
├── Dockerfile
├── README.md
└── LICENSE

Prerequisites

  • Unix-based environment
  • Docker
  • Docker Compose

Getting Started

Clone the repository

git clone https://github.com/LikhithST/VSS-ROS-Bridge.git
cd VSS-ROS-Bridge

Optional configuration

Update environment variables in docker-compose.yml if needed:

  • width
  • height
  • x_coord
  • y_coord

Run the system

docker compose up

This starts:

  • KUKSA Databroker
  • VSS-ROS Bridge
  • ROS simulator

Usage

Send teleoperation commands

source ./scripts/setup.sh

cd csv_provider
python3 provider.py -f output_left_90_1x.csv

Expected Behavior

  • The simulator launches automatically
  • The turtle or vehicle moves according to CSV input
  • ROS topics reflect VSS signals

KUKSA.val Quick Start

Databroker

docker run -it --rm --net=host ghcr.io/eclipse/kuksa.val/databroker:master --insecure

Databroker CLI

docker run -it --rm --net=host ghcr.io/eclipse/kuksa.val/databroker-cli:master

Kuksa Client CLI

docker run -it --rm --net=host ghcr.io/eclipse-kuksa/kuksa-python-sdk/kuksa-client:main

Use Cases

  • Vehicle signal simulation
  • ROS-based control systems
  • Autonomous driving experimentation
  • Automotive and robotics integration

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.


Contributing

Contributions are welcome through issues and pull requests.


Acknowledgements

  • Eclipse KUKSA Project
  • COVESA VSS
  • ROS 2 Community

About

Acts as a bridge between COVESA Vehicle Signal Specification and ROS messages. Demonstrated on modified turtle sim

Topics

Resources

License

Stars

1 star

Watchers

2 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors