Files
venus/dbus-vrm-history/README.md
dev 9756538f16 Initial commit: Venus OS boat addons monorepo
Organizes 11 projects for Cerbo GX/Venus OS into a single repository:
- axiom-nmea: Raymarine LightHouse protocol decoder
- dbus-generator-ramp: Generator current ramp controller
- dbus-lightning: Blitzortung lightning monitor
- dbus-meteoblue-forecast: Meteoblue weather forecast
- dbus-no-foreign-land: noforeignland.com tracking
- dbus-tides: Tide prediction from depth + harmonics
- dbus-vrm-history: VRM cloud history proxy
- dbus-windy-station: Windy.com weather upload
- mfd-custom-app: MFD app deployment package
- venus-html5-app: Custom Victron HTML5 app fork
- watermaker: Watermaker PLC control UI

Adds root README, .gitignore, project template, and per-project
.gitignore files. Sensitive config files excluded via .gitignore
with .example templates provided.

Made-with: Cursor
2026-03-16 17:04:16 +00:00

1.4 KiB

dbus-vrm-history

Venus OS D-Bus service that proxies historical data from the VRM cloud API and exposes it on D-Bus/MQTT for the frontend dashboard.

Features

  • Fetches historical stats from VRM cloud API (battery SOC, consumption, generator runtime, battery cycles)
  • Auto-discovers VRM site ID from device portal ID
  • Configurable refresh interval
  • Exposes history data on D-Bus for use by venus-html5-app custom views

Architecture

Module Purpose
dbus-vrm-history.py Main service, D-Bus setup, request handling
vrm_client.py VRM API client (stats, widgets, site discovery)
config.py Service name, VRM URL, refresh interval, status codes

Installation

scp -r dbus-vrm-history root@<cerbo-ip>:/data/
ssh root@<cerbo-ip>
bash /data/dbus-vrm-history/install.sh

Configuration

Set your VRM API token after installation:

dbus -y com.victronenergy.vrmhistory /Config/Token SetValue 'your-vrm-api-token'

D-Bus Service

  • Service name: com.victronenergy.vrmhistory
  • Config paths: /Config/Token, /Config/SiteId, /Config/RefreshInterval
  • History paths: /History/Soc, /History/Consumption, /History/GeneratorRuntime, /History/BatteryCycles

Service Management

svstat /service/dbus-vrm-history
svc -t /service/dbus-vrm-history        # restart
tail -f /var/log/dbus-vrm-history/current | tai64nlocal