MaHo Labs: Go-E Charger

go-e Charger (Gemini / HOME+ / HOMEfix) auslesen, steuern und automatisch zwischen 1- und 3-phasig umschalten

V0.0.2

Was macht dieser Baustein?

Verbindet Ihren go-e Charger über Modbus TCP mit dem Gira X1. Der Baustein liest Ladezustand, Ströme, Spannungen, Leistung und Energie aus und steuert Ladestrom (6–32 A) sowie die Ladefreigabe.

Für PV-Überschussladen schaltet die Phasen-Automatik abhängig von der verfügbaren Überschussleistung selbstständig zwischen 1-phasigem und 3-phasigem Laden um – mit Hysterese und Mindestabstand zwischen zwei Umschaltungen, damit die Wallbox nicht ständig hin- und herschaltet.

Hauptfunktionen

Auslesen

Auto-Status, Fehlercode, Ströme und Spannungen L1–L3, Ladeleistung, Sitzungs- und Gesamtenergie sowie die verfügbaren Phasen.

Steuern

Ladestrom von 6 bis 32 A vorgeben und Laden freigeben oder sperren – direkt über Gruppenadressen oder aus der Logik.

Phasen-Automatik

Automatische Umschaltung 1-phasig ↔ 3-phasig nach PV-Überschuss mit Hysterese (zwei Schwellen) und 5 Minuten Mindestabstand.

Sanfte Umschaltung

Optional wird das Laden vor dem Phasenwechsel kurz pausiert und danach automatisch wieder freigegeben – schonend für Fahrzeug und Wallbox.

Go-E Charger Logikbaustein im Gira X1

Der Go-E Charger in der Gira X1 Logik-Ansicht mit allen Ein- und Ausgängen

Voraussetzung am go-e Charger

Die Modbus-TCP-Schnittstelle muss in der go-e App aktiviert sein (Internet → Erweiterte Einstellungen → Modbus). Für Phasenumschaltung und Freigabe ist Firmware 55.6 oder neuer erforderlich. Der Charger sollte eine feste IP-Adresse (bzw. DHCP-Reservierung) erhalten und im selben Netz wie der Gira X1 erreichbar sein.

Parameter

ParameterBeschreibung
IP-Adresse IP-Adresse des go-e Chargers im lokalen Netz.
Port Modbus-TCP-Port, Standard 502.
Unit-ID Modbus-Geräte-ID (Unit-Identifier) des Chargers, Standard 1.

Eingänge

Steuerung

EingangBeschreibung
Trigger Löst bei jedem eintreffenden Wert eine Abfrage aller Messwerte aus. Zyklisch verdrahten (z. B. alle 10–60 s).
Ladestrom Sollwert (A) Gewünschter Ladestrom, wird auf 6–32 A begrenzt und bei jeder Änderung an den Charger geschrieben. Standard 6 A.
Laden freigeben true = Laden freigegeben (der Charger lädt gemäß seiner Zugangskontrolle), false = Laden gesperrt. Standard true.

Hinweis: Initialisierung nach dem Start

Nach einem Neustart des Gira X1 schreibt der Baustein einmalig den aktuellen Wert von „Ladestrom Sollwert (A)“ und „Laden freigeben“ an den Charger – ohne dass ein Trigger nötig ist. Ist der Charger in diesem Moment nicht erreichbar, wird die Initialisierung etwa jede Minute wiederholt, bis sie erfolgreich war.

Phasen-Automatik

EingangBeschreibung
Phasen-Automatik aktiv true = automatische Phasenumschaltung nach Überschussleistung ein. Standard false.
Überschussleistung (W) Aktuell verfügbare Überschussleistung inklusive der aktuellen Ladeleistung der Wallbox (Einspeisung − Netzbezug + Ausgang „Leistung (W)“). Jeder neue Wert löst eine Bewertung aus. Standard 0 W – wird nur bei aktiver Phasen-Automatik ausgewertet; ohne Verdrahtung „Phasen-Automatik aktiv“ auf false lassen.
Schwelle 1-phasig (W) Unterschreitet der Überschuss diesen Wert bei 3-phasigem Laden, wird auf 1-phasig umgeschaltet. Standard 3500 W.
Schwelle 3-phasig (W) Überschreitet der Überschuss diesen Wert bei 1-phasigem Laden, wird auf 3-phasig umgeschaltet. Standard 4500 W. Muss größer als die 1-phasig-Schwelle sein (Hysterese).
Sanfte Umschaltung true = vor dem Phasenwechsel wird das Laden für ca. 5 s gesperrt, dann umgeschaltet und anschließend gemäß „Laden freigeben“ wieder freigegeben. Standard false.

Hinweis: Fahrzeuge mit 1-phasigem Ladegerät

Viele Plug-in-Hybride und einige Elektrofahrzeuge laden nur 1-phasig, auch wenn die Wallbox 3 Phasen bereitstellt. „Phasen-Info“ zeigt dann z. B. „Wallbox 3-phasig, Fahrzeug lädt 1-phasig“. Die Phasenumschaltung ändert bei solchen Fahrzeugen an der Ladeleistung nichts – maßgeblich ist allein der Ladestrom.

Hinweis: Mindestabstand zwischen Umschaltungen

Zwischen zwei Phasenumschaltungen liegen mindestens 5 Minuten. Kurzzeitige Schwankungen der Überschussleistung (z. B. Wolkendurchgang) führen dadurch nicht zu ständigem Umschalten.

Lizenz

EingangBeschreibung
Lizenzschlüssel Der gerätegebundene Lizenzschlüssel. Nach Ablauf des 12-stündigen Testzeitraums erforderlich. Siehe Abschnitt „Lizenzierung“.

Ausgänge

Status / Laden

AusgangBeschreibung
Auto-StatusStatus als Zahl: 0 = Unbekannt/Fehler, 1 = Bereit – kein Fahrzeug, 2 = Lädt, 3 = Wartet auf Fahrzeug, 4 = Ladung beendet.
Auto-Status TextStatus im Klartext.
Lädttrue, solange ein Ladevorgang aktiv ist.
Fehlercode / Fehler TextFehlercode des Chargers und Klartext: 0 = OK, 1 = Fehlerstrom (FI), 3 = Phasenfehler, 8 = Erdungsfehler, 10 = Interner Fehler.

Messwerte

AusgangBeschreibung
Strom L1/L2/L3 (A)Ladestrom je Phase.
Spannung L1/L2/L3 (V)Spannung je Phase.
Leistung (W)Aktuelle Ladeleistung.
Sitzungsenergie (kWh)Geladene Energie des aktuellen bzw. letzten Ladevorgangs.
Gesamtenergie (kWh)Gesamtzähler des Chargers.

Phasen

AusgangBeschreibung
Aktuelle Phase (1 oder 3)Phasen, die die Wallbox aktuell schaltet (1 oder 3). Bei Phasenmodus „Automatik“ am Charger wird der tatsächliche Schützzustand übernommen.
Phasen-InfoKlartext mit Phasenmodus, geschalteten Phasen und – während einer Ladung – den vom Fahrzeug genutzten Phasen, z. B. „Automatik, Wallbox 3-phasig, Fahrzeug lädt 1-phasig“.
NetzphasenAnzahl der Netzphasen, die am Charger anliegen (0–3). Bei einem Drehstromanschluss 3; ein kleinerer Wert weist auf einen Phasenausfall, eine ausgelöste Sicherung oder einen 1-phasigen Anschluss hin.
Letzte UmschaltungZielmodus und Uhrzeit der letzten automatischen Umschaltung.

Diagnose

AusgangBeschreibung
Verbundentrue, wenn der letzte Modbus-Zugriff erfolgreich war.
Fehlertrue bei fehlgeschlagenem Lesen, Schreiben oder Verbindungsaufbau.
Diagnose„OK“ oder Klartext der letzten Fehlermeldung (z. B. „Lese-Fehler: …“, „Umschaltung fehlgeschlagen: …“).

Lizenz

AusgangBeschreibung
Lizenz gültig true, wenn der Baustein aktiv ist – also bei gültigem Lizenzschlüssel oder während des Testzeitraums. Nur dann wird gelesen und gesteuert.
MAC-Adresse Die MAC-Adresse des Gira X1 – wird für die Lizenzanforderung benötigt und kann hier direkt abgelesen werden.
Lizenz-Status Klartext-Status: „Lizenz gültig“, „Testzeitraum – noch X h“, „Testzeitraum abgelaufen – Lizenzschlüssel erforderlich“ oder „Ungültige Lizenz“.

Lizenzierung

Hinweis: Gerätegebundene Lizenz

Der Lizenzschlüssel ist an die MAC-Adresse des jeweiligen Gira X1 gebunden und funktioniert nur auf diesem Gerät. Nach Ablauf des Testzeitraums (siehe unten) wird ohne gültige Lizenz weder gelesen noch gesteuert; alle Ausgänge stehen dann auf 0 bzw. false.

Testzeitraum (12 Stunden)

Nach dem ersten Start läuft der Baustein 12 Stunden lang ohne Lizenz voll funktionsfähig – zum Ausprobieren. Während dieser Zeit zeigt der Ausgang „Lizenz-Status“ „Testzeitraum – noch X h“ an und „Lizenz gültig“ steht auf true. Nach Ablauf wird ein gültiger Lizenzschlüssel benötigt.

Der Testzeitraum stützt sich auf die Uhrzeit des Gira X1 und wird durch keinen Eingang verlängert.

So aktivieren Sie den Baustein:

Hinweis: Prüfung erst bei eintreffendem Wert

Lesen und Steuern erfolgt nur, wenn der Baustein ausgeführt wird – also sobald ein Wert an einem Eingang eintrifft (Trigger, Ladestrom, Freigabe, Überschussleistung oder das Eintragen des Lizenzschlüssels). Lizenz und Testzeitraum werden dabei sowie zusätzlich etwa jede Minute im Hintergrund geprüft. Ausgenommen ist nur die einmalige Initialisierung nach dem Start.

Wichtig: Schlüssel unverändert übernehmen

Der Lizenzschlüssel ist zeichengenau (Groß-/Kleinschreibung). Kopieren Sie ihn vollständig und ohne zusätzliche Leerzeichen oder Zeilenumbrüche.

Fehlerbehebung

ProblemMögliche UrsacheLösung
„Modbus Connect fehlgeschlagen“ / Verbunden = false Modbus TCP am Charger nicht aktiviert, falsche IP-Adresse oder Port, Charger nicht im Netz Modbus TCP in der go-e App aktivieren, IP-Adresse und Port prüfen, Erreichbarkeit im Netz prüfen
„Lese-Fehler: …“ Falsche Unit-ID oder Verbindung während der Abfrage abgebrochen Unit-ID prüfen (Standard 1), Netzwerkverbindung prüfen
Alle Messwerte −1 bzw. unplausibel große Zahlen Veraltete Firmware oder am Charger geänderte Modbus-Einstellungen „Bytes tauschen“ (msb) / „Register tauschen“ (msr) Firmware des Chargers aktualisieren; msb und msr auf Werkseinstellung (aus) belassen
Werte kommen nur unregelmäßig / gar nicht an Trigger-Eingang wird nicht ausgelöst Trigger zyklisch (z. B. alle 10–60 s) auslösen
Ladestrom wird nicht übernommen Wert außerhalb 6–32 A (wird begrenzt) oder am Charger ein niedrigeres Maximum eingestellt Maximalstrom in der go-e App prüfen, Ausgang „Diagnose“ beachten
Phasen-Automatik schaltet nicht „Phasen-Automatik aktiv“ = false, keine Überschussleistung verdrahtet, Mindestabstand von 5 min noch nicht abgelaufen oder Überschuss zwischen den Schwellen Eingänge prüfen, Schwellen sinnvoll setzen (3-phasig > 1-phasig), 5 min abwarten
Nach einer Umschaltung wird nicht geladen Charger war beim Abschluss der sanften Umschaltung nicht erreichbar Der Baustein holt die Freigabe automatisch beim nächsten eintreffenden Wert bzw. innerhalb etwa einer Minute nach; „Diagnose“ beachten
Alle Werte bleiben auf 0, Status „Testzeitraum abgelaufen“ 12-h-Testzeitraum abgelaufen, keine Lizenz hinterlegt Gültigen Lizenzschlüssel eintragen (siehe Abschnitt „Lizenzierung“)
Status „Ungültige Lizenz“ Schlüssel fehlerhaft kopiert oder für anderes Gerät ausgestellt MAC-Adresse am Ausgang prüfen und Schlüssel zeichengenau neu eintragen