Updated November 2026 · Hybrid telemetry in production since October 30, 2026
This page describes the Solar House monitoring architecture: the FranklinWH battery system, solar arrays, Raspberry Pi, data pipeline, and displays. Local Modbus TCP is the preferred live telemetry source, with the Franklin cloud API retained as a fallback.
Key files generated on the Pi:
solar.json – validated production snapshot used by downstream servicessolar_cloud.json – Franklin cloud snapshot retained for fallbackhybrid_downstream_test/shadow_24h/modbus.json – local Modbus adapter snapshothybrid_downstream_test/shadow_24h/health.json – hybrid source-health diagnosticsdaily_summary.json – daily totalshistory/YYYY-MM-DD.jsonl – per-day time seriessolar_screenshot.png – TRMNL snapshot
The Pi collects local aGate Modbus telemetry and maintains a Franklin cloud
feed. Approximately once per minute, the hybrid selector prefers fresh,
healthy Modbus data and falls back to the cloud when needed. A validated
snapshot is atomically published to solar.json; downstream
displays and automations continue to use that stable interface. Selected
files are uploaded to the public web server on their own schedule.
The Live web page checks for updates every 15 seconds; this does not
mean new measurements are produced every 15 seconds. TRMNL refreshes
on a separate, less frequent schedule.
The aGate provides read-only local SunSpec/Modbus TCP measurements.
Franklin cloud data remains available if local measurements are unavailable
or stale. The selector checks source freshness and health and requires
several distinct healthy local readings before returning from cloud fallback
to Modbus. The validated solar.json is the common input for
Solar House dashboards and downstream integrations.
Local Modbus access is used for monitoring only; the pipeline does not issue equipment control commands.
The Replay view reads from the daily JSONL files to provide a
smooth, controlled playback of any day’s operation. You can scrub
through time with the slider, change playback speed, or loop the
entire day. The headline displays a concise summary:
S x.x · H x.x · G x.x · B x.x · SOC xx%.
The companion diagram describes how solar, battery, grid, and weather data reach the dashboards. It should be reviewed separately to ensure it also reflects the October 2026 hybrid telemetry change. How the Solar Dashboard Updates