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
1.4 KiB
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