KEBA Wallbox + Display in der Gira X1 Logik-Ansicht
Was macht der Baustein?
Der Baustein bindet eine KEBA KeContact P30 oder P40 Wallbox direkt über Modbus TCP in Ihre Gira X1 Logik ein – ganz ohne Cloud. Er liest Ladezustand, Ströme, Spannungen, Leistung sowie Gesamt- und Sitzungsenergie aus und kann den Ladestrom setzen sowie das Laden freigeben oder sperren.
Damit lässt sich z. B. PV-Überschussladen, eine Lastbegrenzung oder eine komfortable Dashboard-Anzeige realisieren.
Das Paket enthält zwei Bausteine: den Wallbox-Baustein (Auslesen & Steuern) und den Display-Baustein, mit dem sich Text auf dem Display der Wallbox anzeigen lässt. Beide teilen sich eine Lizenz.
Vollständige Messwerte
Ladezustand, Strom L1–L3, Spannung L1–L3, Leistung, Leistungsfaktor, Gesamt- und Sitzungsenergie.
Aktive Steuerung
Ladestrom stufenlos von 6–63 A setzen und das Laden jederzeit freigeben oder sperren.
P30 & P40
Eine gemeinsame KeContact-Registerkarte – der Baustein funktioniert mit beiden Serien.
Robust
Verbindungsaufbau nur bei Bedarf (Connect → Lesen/Schreiben → Disconnect), mit Diagnose-Ausgang.
Voraussetzungen an der Wallbox
- Modbus TCP aktivieren: DIP-Schalter DSW1.3 = ON (siehe KEBA-Installationsanleitung).
- Wallbox per LAN im selben Netz wie der Gira X1.
- Port 502, Geräte-ID (Unit) = 255 (KEBA-Vorgabe).
- Modbus darf nicht parallel zur UDP-Schnittstelle genutzt werden.
- P30 c-Serie ab Firmware 3.10.16 bzw. x-Serie ab Software 1.11.
Parameter
| Parameter | Beschreibung |
|---|---|
| IP-Adresse | IP der Wallbox im LAN. |
| Port | Modbus-TCP-Port. Standard 502. |
| Geräte-ID (Unit) | Modbus Unit-ID. Bei KEBA 255 (Standardwert, nicht ändern). |
Eingänge
| Eingang | Beschreibung |
|---|---|
| Trigger | Löst eine Abfrage aus. Mit einem Zeitgeber/Oszillator takten (empfohlen ≥ 0,5 s, praktisch z. B. alle 5 s). Nur bei einem Trigger werden Werte gelesen. |
| Ladestrom Sollwert (A) | Setzt die Höhe des Ladestroms in Ampere. Möglich sind 6 bis 63 A; kleinere Werte werden automatisch auf 6 A angehoben. Standardwert 6 A. Steuert nicht das Ein-/Ausschalten – dafür „Laden freigeben". |
| Laden freigeben | Der Ein-/Aus-Schalter des Ladevorgangs: true = freigeben, false = sperren (laufender Ladevorgang wird gestoppt). Standardwert true. |
| Lizenzschlüssel | Der gerätegebundene Lizenzschlüssel. Nach Ablauf des 12-stündigen Testzeitraums erforderlich. Siehe Abschnitt „Lizenzierung". |
Ausgänge
Status & Laden
| Ausgang | Beschreibung |
|---|---|
| Ladezustand | 0 = Start, 1 = nicht bereit/kein Fahrzeug, 2 = bereit (wartet auf Fahrzeug), 3 = lädt, 4 = Fehler, 5 = unterbrochen. |
| Ladezustand Text | Klartext zum Ladezustand. |
| Lädt | true, wenn aktuell ein Ladevorgang läuft (Ladezustand 3). |
| Kabelstatus | Steckverbindung/Verriegelung (0/1/3/5/7 gemäß KEBA-Doku). |
| Fehlercode | 0 = kein Fehler, sonst KEBA-Fehlercode. |
Elektrische Werte
| Ausgang | Beschreibung |
|---|---|
| Strom L1/L2/L3 (A) | Gemessener Ladestrom je Phase. |
| Spannung L1/L2/L3 (V) | Gemessene Spannung je Phase. |
| Leistung (W) | Aktuelle Ladeleistung. |
| Leistungsfaktor (%) | cos φ in Prozent. |
Energie & Info
| Ausgang | Beschreibung |
|---|---|
| Gesamtenergie (kWh) | Geräte-Gesamtzählerstand (persistent). |
| Sitzungsenergie (kWh) | Übertragene Energie der aktuellen Ladesitzung. |
| Max. Ladestrom (A) | Aktuell von der Wallbox erlaubter Maximalstrom. |
| Phasen | Phasenumschaltzustand (1 oder 3 Phasen). |
Status & Lizenz
| Ausgang | Beschreibung |
|---|---|
| Verbunden | true, wenn die Modbus-Verbindung steht. |
| Fehler | true bei einem Verbindungs-/Lesefehler. |
| Diagnose | Klartext-Meldung: „OK" oder die genaue Fehlerursache (z. B. Timeout, Connect fehlgeschlagen). |
| Lizenz gültig | true bei gültiger Lizenz oder im Testzeitraum. |
| MAC-Adresse | MAC des Gira X1 – wird für die Lizenzanforderung benötigt. |
| Lizenz-Status | Klartext-Status der Lizenz. |
Steuerung
Ladestrom setzen
Ein neuer Wert am Eingang „Ladestrom Sollwert (A)" wird sofort an die Wallbox übernommen. Der Wert bleibt aktiv, bis er erneut gesetzt oder die Box neu gestartet wird. Zum dauerhaften Begrenzen sind die DIP-Schalter der Box vorgesehen.
Wichtig: Untergrenze 6 A
Der Ladestrom lässt sich technisch nicht unter 6 A stellen – das ist die Mindestvorgabe von Wallbox und Fahrzeug (Norm). Wird am Eingang ein kleinerer Wert angelegt (z. B. 3 A oder 0 A), begrenzt der Baustein automatisch auf 6 A und schreibt diesen Wert. Der Sollwert wird ebenso nach oben auf 63 A begrenzt.
Ein Wert von 0 A stoppt das Laden also nicht. Zum Anhalten den Eingang „Laden freigeben" verwenden (siehe unten).
Ein-/Ausschalten nur über „Laden freigeben"
Das Starten und Stoppen des Ladevorgangs erfolgt ausschließlich über den
Eingang „Laden freigeben": true gibt die Wallbox frei, false
sperrt sie. Beim Sperren wird ein laufender Ladevorgang gestoppt.
Der Ladestrom-Eingang dient nur der Höhe des Ladestroms (6–63 A), nicht dem An-/Ausschalten. Wer laden/nicht laden steuern will, schaltet „Laden freigeben".
Display-Baustein (Text auf der Wallbox anzeigen)
Das Paket enthält einen zweiten Baustein „MaHo Labs: KEBA Display". Damit lässt sich beliebiger Text auf dem Display der Wallbox anzeigen – z. B. „Laden fertig", eine Begrüßung oder der aktuelle Ladezustand. Der Text wird automatisch gesendet, sobald sich der Eingang „Text" ändert.
Voraussetzungen am Gerät
Das Display wird über einen anderen Kanal angesprochen als die Wallbox-Steuerung (Netzwerk-Textbefehl statt Modbus). Damit es funktioniert:
- DIP-Schalter DSW1.3 = ON (ist für den Betrieb ohnehin nötig).
- Firmware der Wallbox 3.9.14 oder neuer.
- Die Wallbox muss ein Display besitzen (modellabhängig).
Parameter & Eingänge
| Feld | Beschreibung |
|---|---|
| IP-Adresse | IP-Adresse der Wallbox (dieselbe wie beim Wallbox-Baustein). |
| Anzeigedauer min (s) | Mindest-Anzeigedauer in Sekunden (0–3600). 0 = Standardverhalten der Wallbox (ca. 2 s). Werte über 3600 werden automatisch auf 3600 begrenzt. |
| Anzeigedauer max (s) | Maximale Anzeigedauer in Sekunden (0–3600). 0 = Standardverhalten der Wallbox (ca. 10 s). Werte über 3600 werden auf 3600 begrenzt; ist „max" kleiner als „min", wird „max" automatisch auf „min" angehoben. |
| Text | Der anzuzeigende Text. Bei jedem neuen Wert wird automatisch gesendet – kein separater Trigger nötig. |
| Lizenzschlüssel | Gemeinsame Lizenz mit dem Wallbox-Baustein: derselbe Schlüssel schaltet beide frei. |
Ausgänge
| Ausgang | Beschreibung |
|---|---|
| Gesendet | true, wenn der Text erfolgreich abgeschickt wurde. |
| Gesendeter Text | Der zuletzt gesendete Text (wie er auf dem Display erscheint). |
| Fehler | true bei einem Sendefehler (z. B. falsche IP). |
| Diagnose | Kurze Klartext-Meldung zum letzten Sendeversuch. |
Hinweis: Textlänge und Leerzeichen
Das Display zeigt maximal 23 Zeichen an – längerer Text wird automatisch gekürzt. Leerzeichen werden automatisch umgewandelt, damit sie korrekt dargestellt werden; im Eingang „Text" schreiben Sie ganz normal mit Leerzeichen (z. B. „Laden fertig").
Hinweis: Anzeigedauer
Bleiben beide Zeiten auf 0, gelten die Standardwerte der Wallbox
(ca. 2 s min, 10 s max). Für eine eigene Dauer tragen Sie Sekunden in „Anzeigedauer min/max"
ein – zulässig sind 0 bis 3600 Sekunden (1 Stunde). Größere Eingaben
werden automatisch auf 3600 begrenzt, damit keine Fehlwerte an die Wallbox gehen.
Für eine dauerhafte Anzeige den Text regelmäßig neu senden (z. B. alle paar Minuten).
Wichtig: Die Wallbox bestimmt die tatsächliche Anzeigedauer
Die gesendete Anzeigedauer ist ein Wunschwert – wie lange der Text wirklich stehen bleibt, entscheidet die Wallbox. Sie kann die Anzeige jederzeit vorzeitig überschreiben, insbesondere durch eigene Meldungen (z. B. eichrechtlich relevante Zähler-/MID-Informationen, Statuswechsel beim Anstecken/Laden). Eine garantierte Mindest- oder Höchstdauer gibt es daher nicht; bei einem neuen Ladevorgang oder einer Gerätemeldung verschwindet der Text ggf. früher.
Hinweis: Senden erfolgt ohne Rückmeldung
Der Textbefehl wird an die Wallbox gesendet, ohne dass diese den Empfang bestätigt. „Gesendet" bedeutet daher: der Befehl wurde abgeschickt – nicht zwingend, dass er angekommen ist. In der Praxis ist das unkritisch; bei Bedarf den Text einfach erneut senden.
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 werden ohne gültige Lizenz keine Werte mehr gelesen oder geschrieben.
Testzeitraum (12 Stunden)
Nach dem ersten Start läuft der Baustein 12 Stunden lang ohne Lizenz voll
funktionsfähig. Während dieser Zeit zeigt „Lizenz-Status" „Testzeitraum – noch X h" und
„Lizenz gültig" steht auf true. Nach Ablauf wird ein gültiger Lizenzschlüssel
benötigt. Ein Reset verlängert den Testzeitraum nicht.
So aktivieren Sie den Baustein:
-
MAC-Adresse ablesen
Am Ausgang „MAC-Adresse" wird die Geräte-Adresse angezeigt (z. B. 00:11:22:33:44:55). -
Lizenz anfordern
MAC-Adresse per E-Mail an labs@maho-elektrotechnik.de senden. Sie erhalten einen gerätegebundenen Lizenzschlüssel. -
Schlüssel eintragen
Schlüssel am Eingang „Lizenzschlüssel" eintragen. Bei Gültigkeit wechselt „Lizenz gültig" auftrueund „Lizenz-Status" auf „Lizenz gültig".
Hinweis: Automatische Prüfung kurz nach Start
Die Lizenz wird etwa 5 Sekunden nach dem Start automatisch geprüft und danach zyklisch – auch ohne dass ein Wert an einem Eingang eintrifft. Daten werden hingegen nur gelesen/geschrieben, wenn ein Trigger bzw. ein Steuerbefehl eintrifft.
Wichtig: Schlüssel unverändert übernehmen
Der Lizenzschlüssel ist zeichengenau (Groß-/Kleinschreibung). Vollständig und ohne zusätzliche Leerzeichen oder Zeilenumbrüche kopieren.
Fehlerbehebung
| Problem | Mögliche Ursache | Lösung |
|---|---|---|
| „Verbunden" bleibt false, „Diagnose" zeigt Connect/Timeout | Modbus TCP nicht aktiv, falsche IP/Port, oder Box nicht erreichbar | DIP-Schalter DSW1.3 = ON, IP/Port prüfen (502), Box im selben Netz, UDP nicht parallel nutzen |
| Verbindung steht, aber keine Werte / Lesefehler | Falsche Geräte-ID | Geräte-ID (Unit) auf 255 setzen |
| Werte ändern sich nicht | Kein Trigger | Zeitgeber/Oszillator an den Eingang „Trigger" anschließen |
| Ladestrom wird nicht übernommen | Wert außerhalb 6–63 A oder zu häufig geschrieben | Sollwert zwischen 6 und 63 A halten, Schreibabstand ≥ 5 s |
| Laden hört bei Ladestrom 0 A / < 6 A nicht auf | Ladestrom kann nicht unter 6 A – der Baustein begrenzt automatisch auf 6 A | Zum Stoppen „Laden freigeben" auf false setzen, nicht den Ladestrom reduzieren |
| Status „Testzeitraum abgelaufen – Lizenzschlüssel erforderlich" | 12-h-Testzeitraum abgelaufen, keine Lizenz | Gültigen Lizenzschlüssel eintragen (siehe „Lizenzierung") |
| Status „Ungültige Lizenz" | Schlüssel fehlerhaft kopiert oder für anderes Gerät | MAC am Ausgang prüfen und Schlüssel zeichengenau neu eintragen |
| Text erscheint nicht auf dem Display | DIP DSW1.3 nicht auf ON, Firmware zu alt, falsche IP oder Modell ohne Display | DSW1.3 = ON prüfen, Firmware ≥ 3.9.14, IP der Wallbox kontrollieren; „Diagnose"-Ausgang beachten |
Changelog
Erstveröffentlichung mit Wallbox- und Display-Baustein.
Beta – nur Wallbox-Baustein.