Onboard CAN Software

A telemetry pipeline for vehicle-mounted embedded systems.

Containers

• Deserializer: Reads CAN bus data and stores it in Redis
• Redis: In-memory data store for telemetry buffering and persistence
• Kafka-Connector: Reads telemetry from Redis and streams to Kafka

Configuration

Place your .dbc files in the dbc-files/ directory. All files will be loaded automatically.

Copy .env.example to .env and fill in the required values:

cp .env.example .env

See .env.example for descriptions of each variable.

Build and Run

Build the project:

docker compose build

Run the application:

docker compose up

Prerequisites

This application requires a CAN interface. For development/testing, you can use a virtual CAN interface (vcan0).

Run the following commands on the host machine:

Load the vcan kernel module:

modprobe vcan

Verify the module loaded successfully:

lsmod | grep vcan

Expected output:

vcan                   12288  0