go-e Charger Smart-Home-Integration, kostenlos und Open Source
go-e Charger Wallboxen über die lokale API: Ladezustand, Leistung, Energie, Strom und Modi.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Verfolge und steuere deine go-e Charger Ladestationen (go-eCharger V3 und V4: HOME+ und HOMEfix V3, Gemini, Gemini flex) aus Gladys, über ihre lokale HTTP-API v2: ohne Cloud. Die Cloud-API von go-e bleibt eine Option für eine Ladestation, die Gladys im lokalen Netzwerk nicht erreicht.
Ohne die Hardware entwickelt: Rückmeldungen sind willkommen. Diese Integration wurde nach der Dokumentation der go-e API und nach echten Antworten aus anderen Projekten geschrieben, ohne Ladestation zur Hand. Wenn dir etwas falsch vorkommt, eröffne ein Issue im GitHub-Repository mit den Protokollen der Integration.
Diese Integration ist nicht mit der go-e GmbH verbunden.
Voraussetzungen
- Eine go-e Charger Ladestation, deren Firmware die HTTP-API v2 kennt (V3 und neuer, Firmware 051.4 oder neuer). Eine alte go-e Charger V2 (nur API v1) wird nicht unterstützt.
- Die lokale HTTP-API v2 eingeschaltet in der go-e App:
- ältere App: Internet → Erweiterte Einstellungen → Zugriff auf /api/status und /api/set API, dann speichern;
- neuere App: Einstellungen → Verbindung → API-Einstellungen → Lokale HTTP-API v2 erlauben.
- Eine feste IP-Adresse für die Ladestation, im Router eingestellt (DHCP-Reservierung): Die Integration erreicht sie über ihre Adresse.
- Gladys 5.2.0 oder neuer.
Ist die API v2 aus, antwortet die Ladestation, lehnt die Anfragen aber ab: Die Konfigurationsseite meldet dann „die lokale HTTP-API v2 ist aus“ und wo du sie einschaltest.
Konfiguration
- Installiere die Integration über Integrationen → Von GitHub installieren (oder den Store) und öffne den Reiter Konfiguration.
- IP-Adressen der Ladestationen: die Adresse jeder Ladestation, durch
Kommas getrennt (zum Beispiel
192.0.2.10, 192.0.2.11). - Aktualisierungsintervall: wie oft die Ladestationen gelesen werden (standardmäßig 15 Sekunden).
- Sprache der Funktionsnamen: Namen der Funktionen neuer Geräte und Sprache der Fehlertexte (standardmäßig Französisch).
- Speichere: Pro Ladestation erscheint ein Gerät im Reiter Erkennung. Füge es hinzu.
- Die Schaltfläche Verbindung testen liest jede Ladestation und sagt für jede, ob sie antwortet (Name, Seriennummer, Firmware) oder warum nicht.
Optional, go-e Cloud: nur für eine Ladestation, die Gladys lokal nicht erreicht. Schalte die Cloud-API in der go-e App ein (Internet → Erweiterte Einstellungen) und gib die Seriennummer der Ladestation und das API-Token aus der App ein. Die Daten laufen dann über die Server von go-e.
Aktualisierung und API-Nutzung
Die Integration liest jede Ladestation selbst, im gewählten Intervall, mit einer
gefilterten Anfrage (/api/status?filter=…, 16 Schlüssel): go-e rät davon ab,
den vollständigen Status zu lesen, und von mehr als einer Anfrage pro Sekunde.
Gladys fragt die Geräte zusätzlich als Rückfall ab; die Integration überspringt
dann eine Ladestation, die sie gerade gelesen hat. Nur geänderte Werte gehen an
Gladys, dazu alle 6 Stunden alle Werte erneut, damit ein stabiler Wert nie „Kein
aktueller Wert“ anzeigt.
Die go-e Cloud hat kein dokumentiertes Kontingent; es gilt derselbe Takt.
Das Gerät Ladestation
| Funktion | Was sie zeigt |
|---|---|
| Anschluss | Verfügbar (kein Auto), Belegt (Auto angesteckt), Nicht verfügbar (offline), Fehler |
| Ladezustand | Lädt, Fahrzeug verbunden (wartet), Angehalten (Fahrzeug): Laden beendet, Angehalten (Ladestation): nicht erlaubt, Inaktiv |
| Auto angesteckt | 1, wenn ein Auto angesteckt ist |
| Ladeleistung | Gesamtleistung, W |
| Leistung L1, L2, L3 | Leistung pro Phase, W |
| Stromstärke L1, L2, L3 | Strom pro Phase, A |
| Energie der Sitzung | Energie seit dem Anstecken des Autos, kWh |
| Gesamtenergie | Der Zähler der Ladestation, kWh: Das Energie-Monitoring von Gladys berechnet daraus Verbrauch und Kosten |
| Ladestrom | Befehl: der dem Auto angebotene Strom, von 6 A bis 16 A (11 kW) oder 32 A (22 kW) |
| Lademodus | Befehl: Automatisch (App), Erzwungenes Laden, Erzwungener Stopp |
| Phasen | Befehl, nur bei Ladestationen, die umschalten können: Automatisch, Einphasig, Dreiphasig |
| Temperatur | Der heißeste Sensor der Ladestation, °C |
| Fehler | Der go-e Fehler in Worten („Keiner“, wenn alles gut ist) |
| Online | 1, solange die Ladestation antwortet |
„Automatisch (App)“ ist der neutrale Modus von go-e: Die Ladestation folgt der App (Zeitplan, Solar-Modus „eco“, aWATTar-Preise). Solarladen bleibt in der go-e App oder in evcc: Diese Integration verdoppelt es nicht.
Widget
Füge das Widget go-e Charger zu einem Dashboard hinzu und wähle eine Ladestation. Es zeigt live die Leistung, die Energie der Sitzung und den Ladestrom, den Zustand in go-e Worten (Bereit, Lädt, Wartet auf das Auto, Laden beendet, Fehler), den Modus, die Phasen und einen eventuellen Fehler. Vier Schaltflächen: Laden (erzwungenes Laden), Stoppen (erzwungener Stopp), Auto (zurück zum Modus der App) und Strom…, die ein Formular für den Strom öffnet. Der aktuelle Modus trägt ein Häkchen.
Szenen-Auslöser
go-e Laden beendet: Das Auto zieht nach dem Laden keinen Strom mehr (es ist
voll oder hat das im Auto oder in der App eingestellte Limit erreicht). Wähle
optional die Ladestation. Die folgenden Aktionen können energy_kwh (Energie
der Sitzung) und charger (ihr Name) verwenden. Er löst einmal pro Ladevorgang
aus, nie beim Start.
„Auto angesteckt“ braucht keinen Auslöser: Nutze die Funktion Auto angesteckt (wechselt auf 1) in einem Auslöser „Gerätewert“.
Szenen-Aktion
go-e Lademodus einstellen: erzwungenes Laden, erzwungener Stopp oder zurück zum automatischen Modus der App. Der Ladestrom braucht keine eigene Aktion: Er ist eine Funktion und wird mit der üblichen Gladys-Aktion „Gerät steuern“ eingestellt.
Szenen-Beispiele
- Im Nachttarif laden: um 22:00 „go-e Lademodus einstellen“ auf Erzwungenes Laden; um 06:00 zurück auf Automatisch (App).
- Melden, wenn das Auto voll ist: Auslöser „go-e Laden beendet“, dann die Nachricht „Laden beendet: {{triggerEvent.data.energy_kwh}} kWh“ senden.
- Den Hauptschalter schützen: Wenn die Leistung des Hauses einen Schwellwert überschreitet, den Ladestrom auf 6 A stellen; sinkt sie wieder, zurück auf 16 A.
Fehlerbehebung
- „Keine Antwort“: Prüfe die Adresse, ob die Ladestation im WLAN ist und ob Gladys und die Ladestation im selben Netzwerk sind.
- „Die lokale HTTP-API v2 ist aus“: Schalte sie in der go-e App ein (siehe Voraussetzungen), speichere und drücke Verbindung testen.
- Cloud: „die go-e Cloud lehnt das Token ab“: Prüfe die Seriennummer (6 Ziffern) und das Token; ein neues Token in der App macht das alte ungültig.
- Ein Befehl scheitert mit „die Ladestation hat die Anfrage abgelehnt“: Der Strom liegt wahrscheinlich über dem in der go-e App eingestellten Maximum.
- Die Protokolle der Integration sagen den Rest: Setze
LOG_LEVEL=debugfür die Details jeder Abfrage.
Grenzen
- Eine Ladestation pro Adresse; der Cloud-Zugang bedient eine einzige Ladestation.
- Die Funktionsnamen und der Höchststrom werden beim Hinzufügen des Geräts festgelegt (eine Regel von Gladys): Um die Sprache zu ändern, lösche das Gerät und füge es erneut hinzu.
- Die Firmware der Ladestation muss 051.4 oder neuer sein (gefilterte Abfragen).
- Kein Zugriff auf RFID-Karten, Zeitpläne, Kabelverriegelung oder Solar-Einstellungen: Das alles bleibt in der go-e App. Die Kabelverriegelung wird bewusst nicht angeboten.
- Die lokale API v2 hat kein Passwort: Jede Person in deinem Netzwerk kann sie nutzen, wie mit der go-e App.
- Nur gegen eine nachgebildete Ladestation und veröffentlichte Antworten getestet (siehe Hinweis oben).
Konfigurationseinstellungen
Diese Einstellungen fragt go-e Charger in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Bevor du anfängst | section | Nein | Schalte in der go-e App die lokale HTTP-API v2 ein (Internet → Erweiterte Einstellungen, oder Verbindung → API-Einstellungen in der neuen App). Gib der Ladestation in deinem Router eine feste IP-Adresse und trage sie unten ein. |
| IP-Adressen der Ladestationen | string | Nein | Eine oder mehrere Adressen, durch Kommas getrennt. |
| Aktualisierungsintervall | select | Nein | Wie oft die Ladestationen gelesen werden. go-e rät von mehr als einer Abfrage pro Sekunde ab. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen neuer Geräte und Sprache der Fehlertexte. |
| Optional: go-e Cloud | section | Nein | Nur für eine Ladestation, die Gladys im lokalen Netzwerk nicht erreicht. Schalte die Cloud-API in der go-e App ein (Internet → Erweiterte Einstellungen): Dort steht das API-Token. Die Daten laufen dann über die Server von go-e. |
| Seriennummer | string | Nein | |
| Cloud-API-Token | secret | Nein |
So installierst du go-e Charger in Gladys
- Öffne in Gladys Integrationen: go-e Charger erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-goecharger:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-goecharger.
go-e Charger benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
go-e Charger ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation