Was OCPP-Verbindungsfehler verursacht — ein Überblick
Das Open Charge Point Protocol (OCPP) ist ein offenes Kommunikationsprotokoll zwischen einer Ladestation (Charge Point) und einem Charge-Point-Management-System (CPMS), auch Backend oder Central System genannt. Die Verbindung läuft über WebSocket, meist gesichert per TLS (wss://). Schlägt die Verbindung fehl, meldet die Wallbox je nach Hersteller einen Statuscode wie Unavailable, Faulted oder bleibt schlicht ohne Backend-Kontakt im Offline-Modus.
Typische Ursachen lassen sich vier Bereichen zuordnen:
- Netzwerk — fehlerhaftes WLAN, keine Route zum Backend-Server
- Konfiguration — falsche OCPP-URL, falsches Protokoll (1.6 vs. 2.0.1), Tippfehler in der Charge-Point-ID
- TLS / Zertifikate — abgelaufenes oder nicht akzeptiertes Server-Zertifikat
- Backend-seitig — Server nicht erreichbar, falsche Whitelist, Auth-Fehler
Schritt 1: Netzwerkkonnektivität prüfen
Bevor Sie OCPP-Parameter anfassen, bestätigen Sie, dass die Wallbox überhaupt ins Internet kommt. Viele Geräte bieten eine Diagnose-Oberfläche per Browser (lokale IP-Adresse, häufig 192.168.x.x). Dort führen Sie einen Ping-Test auf 8.8.8.8 durch. Schlägt dieser fehl, liegt das Problem im lokalen Netz — nicht in OCPP.
Checkliste Netzwerk:
- DHCP-Lease erhalten (IP-Adresse sichtbar im Router)?
- Gateway erreichbar (Ping auf Router-IP)?
- DNS auflösbar — Backend-Hostname per nslookup oder dig testen?
- Firewall-Regel: Port 443 (wss) oder 80 (ws) nach außen freigegeben?
- Bei LAN-Anschluss: Kabel und Switch-Port auf Link-Status prüfen
Viele Firmennetzwerke blockieren ausgehende WebSocket-Verbindungen per Proxy oder Deep Packet Inspection. In diesem Fall benötigen Sie eine explizite Freigabe für die Backend-Domain.
Schritt 2: OCPP-URL und Charge-Point-ID verifizieren
Die OCPP-Verbindungsadresse folgt diesem Schema: wss://backend.example.com/ocpp/<ChargePointID>. Drei Fehler treten hier am häufigsten auf:
- Falsches Protokoll-Präfix — ws:// statt wss:// oder umgekehrt
- Falsche Charge-Point-ID — Groß-/Kleinschreibung zählt, Leerzeichen sind nicht erlaubt
- Falscher Pfad — das Backend erwartet oft einen spezifischen Endpunkt-Pfad, der in der Doku des CPMS steht
Vergleichen Sie die eingetragene URL Zeichen für Zeichen mit der Angabe Ihres CPMS-Anbieters. Kopieren Sie die URL aus dem Backend-Portal direkt in die Wallbox-Konfiguration — Handabtippen erzeugt Tippfehler.
Schritt 3: OCPP-Version abgleichen
OCPP existiert in den Versionen 1.5, 1.6 (JSON), 2.0 und 2.0.1. Die heute verbreitete Version ist OCPP 1.6 J (JSON over WebSocket). OCPP 2.0.1 ist rückwärts inkompatibel. Stellt die Wallbox eine Verbindung mit 1.6 her, das Backend erwartet aber 2.0.1, bricht der Handshake sofort ab — ohne aussagekräftige Fehlermeldung.
Prüfen Sie im Backend-Portal, welche OCPP-Version der Endpunkt unterstützt, und stellen Sie die Wallbox auf exakt diese Version ein. Einige Wallboxen (z. B. im Segment der kommerziellen Geräte) unterstützen beide Versionen per Firmware-Einstellung.
Schritt 4: TLS-Zertifikate und Uhrzeit prüfen
WebSocket-Secure-Verbindungen (wss://) erfordern ein gültiges TLS-Zertifikat auf dem Server. Die Wallbox prüft dieses Zertifikat gegen ihre interne Zertifikatskette. Schlägt die Prüfung fehl, bricht sie die Verbindung kommentarlos ab oder loggt einen Eintrag wie TLS handshake failed.
Häufige TLS-Ursachen:
- Abgelaufenes Server-Zertifikat — im Browser die Backend-URL aufrufen und Zertifikatsdetails prüfen
- Selbstsigniertes Zertifikat — manche Wallboxen akzeptieren diese nicht ohne manuellen Import
- Falsche Systemuhr der Wallbox — liegt die Uhr mehr als wenige Minuten daneben, schlägt TLS grundsätzlich fehl. NTP-Server konfigurieren (Standard: pool.ntp.org) und Uhrzeit im Diagnose-Menü prüfen
- Veraltete CA-Bundle in der Firmware — Firmware-Update des Herstellers einspielen
Schritt 5: Backend-Logs und Whitelist auswerten
Erreicht die Verbindungsanfrage den Backend-Server, erscheint dort ein Log-Eintrag — auch wenn die Wallbox intern keinen Fehler anzeigt. Öffnen Sie im CPMS-Portal den Bereich Charge Points oder Logs und filtern Sie nach der Charge-Point-ID. Typische Backend-Fehlermeldungen und ihre Bedeutung:
| Fehlermeldung (Backend) | Ursache | Maßnahme |
|---|---|---|
| Unknown ChargePoint | ID nicht registriert | Charge-Point-ID im Backend anlegen |
| Authentication failed | Falsches Passwort / Basic-Auth | Zugangsdaten in Wallbox aktualisieren |
| Protocol mismatch | OCPP-Version nicht unterstützt | Version in Wallbox oder Backend anpassen |
| Connection refused | IP-Whitelist greift | Öffentliche IP der Wallbox freischalten |
| Kein Log-Eintrag | Paket kommt nicht an (Firewall/Routing) | Schritt 1 wiederholen, Firewall prüfen |
Schritt 6: WebSocket-Handshake mit einem externen Tool prüfen
Wenn unklar bleibt, ob die Wallbox überhaupt eine Verbindung aufbaut, hilft ein WebSocket-Client wie websocat (Kommandozeile) oder Postman (GUI). Verbinden Sie sich vom selben Netzwerksegment wie die Wallbox mit der identischen OCPP-URL. Erhalten Sie eine Antwort, liegt das Problem in der Wallbox-Konfiguration oder -Firmware. Schlägt die Verbindung auch vom externen Tool fehl, liegt es am Netzwerk oder Backend.
Befehlsbeispiel mit websocat:
websocat wss://backend.example.com/ocpp/MEINE-ID --header „Sec-WebSocket-Protocol: ocpp1.6“
Der Header Sec-WebSocket-Protocol: ocpp1.6 ist laut OCPP-Spezifikation zwingend. Fehlt er, lehnt ein strikt konformes Backend die Verbindung ab.
Firmware-Update und Factory-Reset als letztes Mittel
Lässt sich die Verbindung trotz korrekter Konfiguration nicht herstellen, spielen Sie das aktuelle Firmware-Update des Herstellers ein. Bekannte Fehler in der TLS-Bibliothek oder im WebSocket-Stack werden häufig in Patch-Releases behoben. Dokumentieren Sie vorher alle Einstellungen — ein Factory-Reset löscht die Konfiguration vollständig.
Nach einem Reset beginnen Sie die Konfiguration in dieser Reihenfolge: Netzwerk → Datum/Uhrzeit → OCPP-URL → Charge-Point-ID → Neuverbindung. Diese Reihenfolge stellt sicher, dass TLS-Prüfungen mit korrekter Systemzeit ablaufen, bevor die erste Verbindung aufgebaut wird.
Kernaussagen
- OCPP-Verbindungsfehler entstehen in vier Bereichen: Netzwerk, Konfiguration, TLS/Zertifikate, Backend — diese Reihenfolge abarbeiten.
- Die Charge-Point-ID muss im Backend registriert und in der Wallbox zeichengenau eingetragen sein — Groß-/Kleinschreibung zählt.
- Eine falsche Systemuhr der Wallbox lässt TLS-Verbindungen grundsätzlich fehlschlagen — NTP-Synchronisation vor der Fehlersuche prüfen.
- OCPP 1.6 und 2.0.1 sind nicht kompatibel — Backend und Wallbox müssen exakt dieselbe Version sprechen.
- Der WebSocket-Header Sec-WebSocket-Protocol: ocpp1.6 ist Pflicht — fehlt er, lehnen konforme Backends die Verbindung ab.
Häufige Fragen (FAQ)
-
question: Welche Ports muss ich in der Firewall freigeben damit OCPP funktioniert?answer: Für verschlüsselte Verbindungen (wss://) benötigen Sie Port 443 TCP ausgehend. Unverschlüsselte Verbindungen (ws://) nutzen Port 80 TCP. Im Unternehmensumfeld blockieren Proxies häufig WebSocket-Upgrades — hier ist eine explizite Freigabe der Backend-Domain auf Protokollebene nötig.
-
question: Warum erscheint die Wallbox im Backend als offline, obwohl sie im lokalen Netz erreichbar ist?answer: Die lokale Erreichbarkeit und die OCPP-Backend-Verbindung sind unabhängig. Die Wallbox kann per Browser-Oberfläche (lokale IP) ansprechbar sein, aber gleichzeitig den WebSocket zum CPMS nicht aufbauen. Prüfen Sie Backend-Logs und TLS-Zertifikat — der Fehler liegt meist in Konfiguration oder Zertifikatsprüfung.
-
question: Wie finde ich heraus welche OCPP-Version meine Wallbox unterstützt?answer: Die unterstützten OCPP-Versionen stehen im Datenblatt oder im technischen Handbuch des Herstellers. Im Konfigurationsmenü der Wallbox (Web-UI oder Display) gibt es meist eine Auswahl. Geräte der OCPP-2.0.1-Generation führen dies explizit auf — ältere Geräte ohne Firmware-Update unterstützen häufig nur 1.6.
-
question: Was ist der Unterschied zwischen Charge-Point-ID und dem OCPP-Passwort?answer: Die Charge-Point-ID identifiziert die Ladestation eindeutig im Backend und ist Teil der WebSocket-URL. Das OCPP-Passwort (Basic-Auth) ist ein optionaler Authentifizierungsmechanismus, den OCPP 1.6 als Basic-Auth über HTTP-Header überträgt. Beide Werte müssen in Backend und Wallbox übereinstimmen — sie erfüllen aber unterschiedliche Funktionen.
-
question: Kann ich OCPP auch ohne Internetverbindung lokal betreiben?answer: Ja — ein lokales CPMS (z. B. Open-Source-Lösung SteVe oder CitrineOS) im internen Netz reicht aus. Die Wallbox verbindet sich dann per wss:// auf die lokale Server-IP. Für TLS ist in diesem Fall ein selbstsigniertes Zertifikat nötig, das manuell in die Wallbox importiert werden muss, sofern der Hersteller das unterstützt.