SpeicherGuru Energy Hub

Commercial Home Assistant integration for manufacturer-neutral, cloud-free access to PV inverters, battery storage and heat pumps over Modbus TCP.

Register maps are data, not code: every device is described by a JSON profile that can be added or updated without touching the integration.

Version 0.1.0

This release contains the working core: demo mode, Modbus HAL, profile registry, sensors, licensing, support session lifecycle and diagnostics. Auto-discovery, profile sync and a real VPN provider are prepared but not wired yet.

What it does

• Reads Modbus TCP registers directly (function codes 3, 4, 6 and 16).
• Creates sensors from a JSON profile, including scaling, units, device class and state class.
• Runs without a cloud account and without a vendor gateway service.
• Offers a demo mode with simulated PV, battery and heat pump values.
• Verifies signed commercial licences and gates advanced features.
• Opens a time-limited, client-initiated support window on request.
• Produces a redacted diagnostic payload for support cases.

Quick start

1. Install sg_energy_hub into custom_components/.
2. Restart Home Assistant.
3. Add SpeicherGuru Energy Hub and choose Demo or Modbus TCP.
4. For Modbus, enter host, port, unit id and a profile.

Continue with Installation & Setup.

Environments

Purpose	URL
Documentation	https://ha-sg-energy-hub.pages.speicherguru.de/
Demo release	https://ha-sg-energy-hub.speicherguru.de/
PR demo	https://pr-<number>.ha-sg-energy-hub.speicherguru.de/
PR docs	https://pr-<number>.ha-sg-energy-hub.pages.speicherguru.de/

Scope of this version

Area	State
Modbus TCP reads	working
Profile-driven sensors	working
Demo mode	working
Licence verification and gating	working, licence server not connected
Support session lifecycle	working, no tunnel provider
Diagnostics download	working, no upload
Auto-discovery / register probing	not implemented
Profile sync from licence server	not implemented
WireGuard/Tailscale provider	not implemented