Applications for the Raspberry Pi 5 inside "Sophie" the RV: a set of Docker services (MQTT broker, RV-C/CAN decoder, battery/solar/tire monitors, a GPIO alarm, and a React dashboard) plus host-side glue for networking and the internet uplink.
Where to look:
CLAUDE.md— operational and security status: the uplink/WAN setup, the host firewall, the de-privileged dashboard and the loopback host-root daemons, the PIN gate, and day-to-day notes (e.g. rebuild-before-up -d).plan_history.md— condensed record of the major work done, with the still-open field tests.- Component READMEs:
firewall/,usbhub/,sophie-hostd/,sdcard-writes/,webserver/. - This file — the MQTT topic contract every service publishes and consumes to.
Two namespaces, split by purpose:
RVC/<DGN>[/<instance>]— RV-C-style telemetry. JSON payloads mirroring RV-C DGN records (as decoded by rvc2mqtt) or records shaped like them (battery, solar, tires). Publishers own these topics; consumers only read.rv/<subsystem>/<noun>/command— control messages to a service.rv/<subsystem>/<noun>/status— state from a service (retained where the state must survive restarts).
| Topic | Kind | Payload | Publisher → Consumer |
|---|---|---|---|
RVC/<DGN>/<instance> |
telemetry | JSON (RV-C record) | rvc2mqtt → webserver, watcher |
RVC/BATTERY_STATUS/1 |
telemetry | JSON | bat2mqtt → webserver, watcher |
RVC/SOLAR_CONTROLLER_STATUS/1 |
telemetry | JSON | ve.direct → webserver, watcher |
RVC/TIRE_STATUS/<position> |
telemetry | JSON | tirelinc → webserver |
rv/alarm/interior/command |
command | on / off |
webserver → alarm |
rv/alarm/bike/command |
command | on / off |
webserver → alarm |
rv/alarm/interior/status |
status | on / off (retained) |
alarm → webserver, alarm (restore on restart) |
rv/alarm/bike/status |
status | on / off (retained) |
alarm → webserver, alarm (restore on restart) |
rv/alarm/status |
status | JSON detail (retained) | alarm → webserver |
rv/tire/buzzer/command |
command | JSON {"seconds": N, "tire": "<name>"} to start (seconds: 0 = indefinite); literal stop to stop |
tirelinc → alarm |
rv/tire/alarm/command |
command | silence (12-hour fault silence) |
webserver → tirelinc |
RVC/SYS_ERRORS |
telemetry | JSON {"error": str, "timestamp": int} |
watcher, tirelinc (staleness) → dashboard |
The legacy aliases (rv/tire/buzzer, rv/tire/buzzer/stop,
RVC/TIRE_ALARM/silence) were retired in Phase 5 — all publishers and
subscribers now use the topics above.