Installation & Setup

Integration installieren

1. sg_energy_hub.zip von den Releases herunterladen.
2. So entpacken, dass dieser Pfad entsteht:

<HA-Konfiguration>/custom_components/sg_energy_hub/manifest.json

1. Home Assistant neu starten.
2. Einstellungen → Geräte & Dienste → Integration hinzufügen und nach SpeicherGuru Energy Hub suchen.

Demo-Modus

Demo (simulierte Werte) wählen und bestätigen. Es entsteht ein Gerät mit PV-Leistung, PV-Energie, Batterie-SoC, Batterie-Leistung, Batterietemperatur, Netzleistung, Hauslast, Wärmepumpen-Leistung und Temperaturen.

Demo-Werte werden lokal erzeugt. Der Demo-Eintrag kontaktiert kein Gerät und schaltet bei einer fehlgeschlagenen echten Verbindung niemals auf Demo-Werte um.

Modbus TCP

Modbus TCP device wählen und ausfüllen:

Feld	Bedeutung
Host	IP-Adresse oder Hostname des Gateways/Wechselrichters
Port	TCP-Port, normalerweise 502
Unit-ID	Modbus-Slave-/Unit-ID, normalerweise 1
Profil	Register-Mapping für Hersteller/Modell
Timeout	Wartezeit auf eine Antwort in Sekunden
Name	Optionaler Gerätename; Standard ist der Profilname

Vor dem Anlegen des Eintrags öffnet die Integration eine TCP-Verbindung und liest das erste Register des Profils. Bei einem Verbindungsfehler bleibt das Formular mit cannot_connect stehen; eine Modbus-Ausnahme erscheint als modbus_exception.

Gateways

Modbus-zu-WLAN/LAN-Gateways wie der USR-DW60 funktionieren, wenn sie einen transparenten Modbus-TCP-Endpunkt bereitstellen. Die Integration braucht eine TCP-Verbindung pro Gerät; ein Gateway, das nur einen Client gleichzeitig zulässt, sollte für Home Assistant reserviert sein.

Mehrere Geräte

Jeder Config Entry ist genau ein Gerät mit eigenem Coordinator, eigenen Entities und eigenem Lizenzstatus. Für einen weiteren Wechselrichter, Speicher oder eine Wärmepumpe die Integration erneut hinzufügen.

Unique-IDs bestehen bei Modbus aus Host, Port, Unit-ID und Profil-ID, beim Demo-Eintrag aus demo. Der Demo-Eintrag kann nur einmal existieren.

Optionen

Konfigurieren am Eintrag öffnen:

Option	Standard	Bedeutung
Abfrageintervall	60 s	10–900 Sekunden
Schreibzugriff erlauben	Aus	Erforderlich für write_register; zusätzlich Pro
Standarddauer Support-Session	4 h	1–24 Stunden
Lizenzserver-URL	leer	Optional, für Support-Tokens

Änderungen laden den Eintrag neu.

Eigene Profile

JSON-Dateien hier ablegen:

<HA-Konfiguration>/sg_energy_hub/profiles/

Sie werden beim nächsten Start geladen. Alle Felder stehen im Profilformat.