This small Linux tool connects to an EV's CAN bus over a Bluetooth ELM327 OBD-II adapter and forwards live vehicle telemetry (battery, odometer, tire pressure) to a local REST endpoint, designed to be consumed by aa-proxy-rs for Android Auto EV routing and dashboards.

This repository is a fork of the original manio/canze-rs, generalised beyond the Renault Zoe into a multi-vehicle telemetry daemon driven by JSON profiles. The name of the original project is inspired by (and a tribute to) the great CanZE project.

Adding a new vehicle requires no Rust changes — see Adding a vehicle profile below.

canze-rs runs as a long-lived daemon. While the car's OBD dongle is in range and the car is awake (charging or driving), it polls the PIDs declared by the active profile and POSTs the readings as JSON to three endpoints on localhost:

Only fields whose PIDs are declared in the active profile are populated; the rest are omitted from the JSON. If the profile reports SOC as a percentage and the config provides battery_capacity_wh, canze-rs derives battery_level_wh automatically.

canze-rs 0.2.0

USAGE:
    canze-rs [OPTIONS]

OPTIONS:
    -c, --config <CONFIG>    Config file path [default: /etc/canze-rs.conf]
    -d, --debug              Enable debug info
    -h, --help               Print help information
    -V, --version            Print version information

The daemon reads its configuration from /etc/canze-rs.conf:

[general]
mac                  = 00:00:00:00:00:00  # Bluetooth OBD-II dongle MAC
car                  = ev6                # profile name; loaded from /etc/canze-rs/<car>.json
battery_capacity_wh  = 77400              # optional; enables derived battery_level_wh from SOC %

Profile JSONs ship in this repo under profiles/. At install time they need to be copied to /etc/canze-rs/<name>.json (e.g. profiles/ev6.json → /etc/canze-rs/ev6.json).

{
  "name": "Hyundai Ioniq 5",       // display name (logged at startup)
  "pids": [
    {
      "ecu_tx": "7E4",             // request header
      "ecu_rx": "7EC",             // response filter
      "pid":    "220105",          // service+PID bytes (UDS / Mode 22 typical)
      "fields": [
        {
          "name":       "battery_level_percentage",
          "byte_index": 31,        // offset into the response payload; negative = from end
          "length":     1,         // bytes (1, 2 or 3)
          "multiplier": 0.5,       // raw * multiplier ...
          "offset":     0.0        // ... + offset = final value
        }
      ]
    }
  ]
}

Fields whose name is recognised by canze-rs are aggregated into the appropriate POST. Recognised names today:

• Battery — battery_level_percentage, battery_level_wh, external_temp_celsius
• Odometer — odometer_km, trip_km
• Tire pressure — tire_fl_kpa, tire_fr_kpa, tire_rl_kpa, tire_rr_kpa

1. Identify the OBD ECU TX/RX headers and the Mode 22 PID(s) for the parameters you want. The CanZE project is an excellent reference.
2. Determine the byte offset, length, multiplier, and offset for each field within the response payload.
3. Drop a new JSON file under profiles/ (and copy it to /etc/canze-rs/<name>.json).
4. Point car = <name> at it in /etc/canze-rs.conf.

No code changes required.

cargo build --release

For embedded / Buildroot integration, this repo includes a vendored cargo configuration that pins crate sources to a local VENDOR/ directory — see .cargo/config.toml. Populate VENDOR/ with cargo vendor (online), then build offline.

GPL-2.0. See LICENSE.

• Original manio/canze-rs by Mariusz Białończyk — the Renault Zoe SOC logger this fork started from.
• The CanZE project.