
Die go-e Gemini flex ist eine in Österreich hergestellte EV-Wallbox, verfügbar in den Varianten 11 kW (16 A) und 22 kW (32 A), wobei das neuere Modell Gemini flex 2.0 ein integriertes 4G-LTE-Modul bietet. TapHome kommuniziert mit der Ladestation über die lokale HTTP API v2 per Wi-Fi — eine Cloud-Verbindung ist nicht erforderlich. Die API muss in der go-e App explizit aktiviert werden, bevor TapHome eine Verbindung herstellen kann.
Die Vorlage bietet Ladestatus-Überwachung, Ladestrom-, Modus- und Zwangszustandssteuerung, Phasenumschaltung, phasenweise Spannungs- und Strommessung, einen Energiezähler sowie schreibgeschützte Eingänge für externe PV- und Netzleistungsdaten zur Ermöglichung des Überschussladens.
Konfiguration
Aktivierung der HTTP-API
Die lokale HTTP API v2 ist standardmäßig deaktiviert. Zur Aktivierung:
- Verbinden Sie sich mit dem go-e Charger über die go-e App (verfügbar für iOS und Android)
- Navigieren Sie zu Einstellungen > Verbindung > API-Einstellungen
- Aktivieren Sie „Zugriff auf lokale HTTP-API vX erlauben"
Nach der Aktivierung antwortet die Ladestation auf HTTP-Anfragen auf Port 80. Eine Authentifizierung ist nicht erforderlich — der Zugriff wird ausschließlich über diesen Schalter gesteuert.
Netzwerk-Einrichtung
Die go-e Gemini flex verbindet sich über Wi-Fi (802.11b/g/n, nur 2,4 GHz). Ein Ethernet-Anschluss ist nicht vorhanden. Geben Sie beim Import der TapHome-Vorlage die IP-Adresse der Ladestation ein.
Der go-e Charger unterstützt kein mDNS. Um Verbindungsprobleme nach einer DHCP-Erneuerung zu vermeiden, konfigurieren Sie eine statische IP-Adresse oder eine DHCP-Reservierung auf Ihrem Router für die MAC-Adresse der Ladestation.
Die Ladestation kann im Hotspot-Modus (Direktverbindung) oder als Teilnehmer eines bestehenden Wi-Fi-Netzwerks betrieben werden. Für die TapHome-Integration muss sich die Ladestation im selben Netzwerk wie die TapHome CCU befinden.
Gerätefunktionen
Ladestatus
Das Gerät Ladestatus zeigt den aktuellen Verbindungs- und Ladezustand als Mehrwert-Indikator (nur lesen) an. Der API-Schlüssel car gibt einen von fünf Zuständen zurück: Störung (0), Verfügbar (1), Laden (2), Vorbereitung (3) oder Abgeschlossen (4). Dies ermöglicht TapHome-Automatisierungen, basierend darauf zu reagieren, ob ein Fahrzeug angeschlossen ist, aktiv lädt oder eine Sitzung abgeschlossen hat.
Ladestrom- und Modussteuerung
Zwei steuerbare Geräte verwalten den Betrieb der Ladestation:
Ladestrom — wählt den angeforderten Ladestrom aus sechs diskreten Werten: 6, 8, 10, 12, 14 und 16 A. Die Vorlage ordnet diese den Schalterpositionen 0–5 zu, wobei die Formel
amp/2 - 3zum Lesen und(position + 3) × 2zum Schreiben verwendet wird. Werte werden überapi/set?amp={value}an die Ladestation gesendet.Lademodus — wählt die Ladelogik: Basis (Standard-Dauerladen), Eco (preisoptimiert über Awattar-Tarif) oder Tagesfahrt (automatischer Stopp nach Erreichen des Ziels). Die API verwendet die Werte 3, 4 und 5; die Vorlage ordnet diese den Positionen 0, 1 und 2 zu.
Der Ladestrom-Selektor bildet nur sechs Werte ab (6–16 A in 2-A-Schritten). Die 22-kW-Variante der Gemini flex unterstützt bis zu 32 A, aber Werte über 16 A werden von dieser Vorlage nicht abgedeckt. Zur Nutzung höherer Ströme kann der API-Schlüssel
ampdirekt außerhalb der Vorlage gesetzt werden.
Erzwungener Zustand
Das Gerät Erzwungener Zustand übersteuert die Entscheidung der Ladestation, ob geladen wird. Der API-Schlüssel frc akzeptiert Neutral (0 — die Ladestation entscheidet), Gestoppt (1 — Laden blockiert) und Laden (2 — Laden erzwungen). Der Wert wird über api/set?frc={value} geschrieben und aus der Statusantwort zurückgelesen, weshalb diese Vorlagenrevision frc in den api/status-Filter aufnimmt.
Der Selektor listet außerdem die Positionen 3–9 mit numerischen Platzhalter-Bezeichnungen aus der Vorlage. Die go-e API definiert dafür keine Bedeutung — verwenden Sie nur Neutral, Gestoppt und Laden.
Phasenumschaltung
Das Gerät Phasenumschaltung steuert, wie viele Phasen die Ladestation nutzt: Automatisch (0), 1-Phasig (1) oder 3-Phasig (2). Der go-e Charger unterstützt die Phasenumschaltung auch während einer aktiven Ladesitzung. Im automatischen Modus wählt die Ladestation die optimale Phasenkonfiguration basierend auf der verfügbaren Leistung.
Energieüberwachung
Die Vorlage liest phasenweise Spannung und Strom aus dem nrg-Energiearray der Ladestation, das 16 Werte enthält, die in jedem Abfragezyklus aktualisiert werden:
| Gerät | Quelle | Einheit |
|---|---|---|
| L1 Spannung | nrg[0] | V |
| L2 Spannung | nrg[1] | V |
| L3 Spannung | nrg[2] | V |
| L1 Strom | nrg[4] | A |
| L2 Strom | nrg[5] | A |
| L3 Strom | nrg[6] | A |
Das Gerät Wallbox-Stromzähler zeigt die gesamte gelieferte Energie aus dem Schlüssel eto (Wh) und die momentane Leistungsaufnahme aus nrg[11] geteilt durch 1000. Es ersetzt das frühere Gerät Aktuelle Leistungsaufnahme. Alle Energiewerte sind schreibgeschützt.
Die Vorlage liest die Phasenströme aus
nrg[4],nrg[5]undnrg[6]und die Zählerleistung ausnrg[11]. Die go-e API-Dokumentation führt die Phasenströme an den Indizes 5, 6 und 7, die Neutralleiterleistung an Index 11 und die Gesamtleistung an Index 12 — genau so arbeitete die vorherige Vorlagenrevision. Prüfen Sie die Werte an der Ladestation, bevor Sie sie für Abrechnung oder Automatisierungen verwenden.
Eingänge für PV-Überschussladen
Zwei Nur-Schreiben-Geräte ermöglichen TapHome, externe Energiedaten an die Ladestation für Überschusslade-Berechnungen zu senden:
- Netzeinspeisung — sendet die aktuelle Netzexport-/-importleistung (in kW, durch Multiplikation mit 1000 in W umgerechnet) über
api/set?ids={"pGrid":value} - PV-Leistung — sendet die aktuelle Photovoltaikproduktion (in kW, durch Multiplikation mit 1000 in W umgerechnet) über
api/set?ids={"pPv":value}
Diese Geräte lesen keine Daten von der Ladestation. Der go-e Charger selbst misst weder Netz- noch PV-Leistung — er ist auf externe Quellen angewiesen, die diese Informationen bereitstellen. In einer typischen TapHome-Konfiguration werden Werte von einem separaten Energiezähler oder Solar-Wechselrichter (ebenfalls in TapHome integriert) über diese Nur-Schreiben-Geräte an die Ladestation weitergeleitet, wodurch der Eco-Lademodus zur Optimierung des Eigenverbrauchs aktiviert wird.
Um PV-Überschussladen zu nutzen, stellen Sie den Lademodus auf Eco und verwenden Sie TapHome-Automatisierungen, um regelmäßig aktuelle Netzleistungs- und PV-Produktionswerte in die Geräte Netzeinspeisung und PV-Leistung zu schreiben. Die Ladestation passt ihren Ladestrom automatisch an den verfügbaren Überschuss an.
Weitere Funktionen
Die go-e Charger API v2 stellt zusätzliche Daten bereit, die derzeit nicht in der Vorlage abgebildet sind: phasenweise Leistung (W) und Leistungsfaktor, Neutralleiterspannung, Gesamtleistung (nrg[12]), Sitzungsenergie (wh), Fehlerzustandscodes, Kabelstromlimit, Temperatursensoren, Netzfrequenz, Energielimit-Einstellungen und Konfiguration des minimalen/maximalen Stroms. Diese können in einer zukünftigen Vorlagenaktualisierung hinzugefügt werden.
Fehlerbehebung
Gerät antwortet nicht
- Überprüfen Sie, ob die Ladestation mit dem Wi-Fi verbunden ist und eine gültige IP-Adresse hat — prüfen Sie in der go-e App unter Einstellungen > Verbindung
- Bestätigen Sie, dass die HTTP-API aktiviert ist (Einstellungen > Verbindung > API-Einstellungen)
- Öffnen Sie
http://{charger-ip}/api/statusim Browser — wenn JSON zurückgegeben wird, ist die API erreichbar - Prüfen Sie, ob TapHome CCU und Ladestation im selben Netzwerk / VLAN sind
Ladestrom ändert sich nicht
- Die Vorlage bildet nur sechs Werte ab (6, 8, 10, 12, 14, 16 A). Wenn die Ladestation einen anderen Wert anzeigt (z. B. 20 A über die App eingestellt), zeigt TapHome die nächstgelegene abgebildete Position an
- Überprüfen Sie, ob die Firmware der Ladestation Version 051.4 oder neuer ist — ältere Firmware verwendet eine andere Filtersyntax, die zu Parsing-Problemen führen kann
PV-Überschussladen funktioniert nicht
- Bestätigen Sie, dass der Lademodus auf Eco eingestellt ist — die Überschusslogik wird nur in diesem Modus aktiviert
- Überprüfen Sie, ob die Werte für Netzeinspeisung und PV-Leistung regelmäßig geschrieben werden (mindestens alle 30 Sekunden)
- Prüfen Sie, ob die Werte in kW angegeben sind (die Vorlage konvertiert automatisch in W)
- Öffnen Sie
http://{charger-ip}/api/status?filter=pgrid,ppv, um zu überprüfen, ob die Ladestation die Werte empfängt
Der API-Schlüssel
eto(Gesamtenergie) wird jetzt als Gerät Wallbox-Stromzähler bereitgestellt — der im Statusfilter abgerufene Wert bleibt nicht länger ungenutzt.