Solar House — System Architecture

Updated November 2026 · Hybrid telemetry in production since October 30, 2026

Overview

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.

Components
Data Files

Key files generated on the Pi:

Update Cycle

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.

Hybrid Telemetry and Fallback

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.

Replay Page Notes

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%.

Solar Dashboard Data Flow

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