easy-ocpp

OCPP 1.6J · 2.0.1 · 1.5 SOAP

Ihr eigener OCPP-Server für bis zu zehn Wallboxen

easy-ocpp ist ein selbst gehostetes Ladepunkt-Management-System (CSMS) für kleine und mittlere Unternehmen. Es spricht OCPP 1.6J, 2.0.1 und 1.5 SOAP. Ein Programm, eine SQLite-Datei, kein Cloud-Abo und keine dauerhafte Internetverbindung.

Release herunterladen Quellcode auf GitHub

Keine Cloud, kein Abo

Alles läuft auf einem Rechner, der Ihnen gehört. Ein kleiner Server reicht, ein NUC, notfalls ein übriger Büro-PC. Ladedaten verlassen Ihr Netz nicht.

Ein Programm, eine Datei

Kein Datenbankserver, kein Message-Broker, kein Container-Stack. Entpacken, starten, fertig. Der gesamte Datenbestand ist eine SQLite-Datei, die Sie zum Sichern einfach kopieren.

Gebaut für 1–10 Wallboxen

Bewusst keine Konzern-Plattform. Das, was ein Betrieb mit einer Handvoll Ladepunkte wirklich braucht, ohne den Betriebsaufwand drumherum.

Was es kann

Wallbox-Inventar

Online-Status, Connectors, Firmware und Seriennummer je Ladepunkt, direkt aus der OCPP-Verbindung.

Chip-Verwaltung

Neue Chips werden über ein Lernfenster von zwei Minuten angelernt: Chip an die Wallbox halten, der Server fängt den Tag ab.

Chips und Personen

Ein Chip gehört entweder zu einer Person oder er ist ein Gast-Chip. Die Kategorie folgt der Zuordnung und kann ihr nicht widersprechen.

Live-Messwerte

Geladene kWh, aktuelle Leistung und Ladestand während der Ladung, alle zehn Sekunden aktualisiert.

Ladelimits

Automatische Abschaltung bei erreichter Ziel-Energie oder abgelaufener Zeit, je nachdem was zuerst eintritt.

Gast-Ladungen

Für Besucher aus der Ferne freischalten und auf ein Gast-Label buchen.

Auswertungen

Ladungsliste mit CSV-Export, Statistik nach Monat, Quartal und Jahr sowie ein Monats-PDF je Person.

Vier Sprachen

Die gesamte Oberfläche auf Deutsch, Englisch, Französisch und Spanisch, pro Benutzer umschaltbar.

Zwei Rollen, sauber getrennt

Es gibt genau eine Sorte Person im System: den Benutzer. Ein Mitarbeiter ist ein Benutzer, und seine Chips, Ladungen und Limits hängen direkt an diesem Konto. Was ein Mitarbeiter darf, ist bewusst eng gefasst.

AdminMitarbeiter
Wallboxen, Chips, Benutzerverwaltung
Ladungen aller Personen
Eigene Ladungen, CSV, Statistik, Monats-PDF
Eigene laufende Ladung sehen und beenden
Ziel-kWh und Timer an der eigenen Ladung
Standardvorgaben für jeden Mitarbeiter

Die Einschränkungen greifen auf dem Server. Etwas in der Oberfläche auszublenden würde nicht genügen. Nach dem Anmelden landet ein Mitarbeiter auf seiner eigenen Seite, und die Navigation zeigt ihm nur, was er auch öffnen darf.

Ladelimits, die tatsächlich abschalten

Eine Ladung endet von selbst, sobald sie eine Ziel-Energie oder einen Timer erreicht, je nachdem was zuerst eintritt. Beides ist optional. Jede Person hat Standardvorgaben, die für jede neue Ladung gelten und die entweder der Mitarbeiter selbst oder ein Administrator setzt; an der laufenden Ladung lassen sich die Werte weiterhin ändern.

Ein Watchdog prüft alle 15 Sekunden und schickt RemoteStopTransaction. Das Energielimit wird zusätzlich sofort beim Eintreffen neuer Messwerte geprüft, damit nicht bis zum nächsten Takt über das Ziel hinaus geladen wird. Lehnt eine Wallbox den Stop ab, wird es erneut versucht.

Loslegen

Ein Release für Windows oder Linux holen, entpacken, starten. Die Oberfläche liegt dann auf Port 8080; der erste Login ist admin / admin.

Oder selbst aus dem Quellcode bauen:

git clone https://github.com/hilman2/easy-ocpp.git
cd easy-ocpp
cargo run --release

Wallbox verbinden

Den Ladepunkt auf Ihren Server zeigen lassen. Die Subprotokolle werden automatisch ausgehandelt, und ein unbekannter Ladepunkt trägt sich beim ersten Verbinden selbst ein.

ws://<host>:8080/ocpp/<ChargePointId>

Für ältere OCPP-1.5-Geräte über SOAP:

POST http://<host>:8080/ocpp15

Protokoll-Unterstützung

VersionTransportStand
OCPP 1.6JWebSocketVollständig (Boot, Heartbeat, Status, Authorize, Transaktionen, Messwerte, Remote-Start/Stop, Konfiguration)
OCPP 2.0.1WebSocketGerüst (BootNotification und TransactionEvent)
OCPP 1.5SOAPGerüst (Boot und Heartbeat)

Häufige Fragen

Was ist ein CSMS?

Ein Charging Station Management System ist das Backend, mit dem eine Ladestation spricht. Es autorisiert RFID-Karten, zeichnet Ladevorgänge und Zählerstände auf und kann Ladungen aus der Ferne starten oder beenden. OCPP ist das Protokoll, über das die beiden sich unterhalten.

Funktioniert das mit meiner Wallbox?

Jeder Ladepunkt, der OCPP 1.6J über WebSocket spricht, sollte laufen. Das trifft auf die große Mehrheit der in den letzten Jahren verkauften Geräte zu. Ältere Hardware, die nur OCPP 1.5 SOAP kann, verbindet sich für Boot und Heartbeat.

Brauche ich eine Internetverbindung?

Nein. Die Wallboxen verbinden sich über das lokale Netz mit Ihrem Server. Internet brauchen Sie nur, wenn Sie die Oberfläche von außen erreichen wollen.

Wie sehe ich, wer wie viel geladen hat?

Jede Ladung hängt an dem RFID-Chip, mit dem sie gestartet wurde, und jeder Chip gehört zu einer Person. Ladungsliste, Statistik und Monats-PDF sind entsprechend gruppiert. Ladungen auf nicht zugeordneten Chips laufen als Gast-Ladung.

Sehen Mitarbeiter die Ladungen der anderen?

Nein. Ein Mitarbeiter sieht ausschließlich die Ladungen, die mit seinen eigenen Chips gestartet wurden. Nur ein Administrator sieht alles.

Was kostet es?

Nichts. easy-ocpp ist Open Source unter der MIT-Lizenz. Es gibt keine kostenpflichtige Variante und keine Gebühr je Ladepunkt.