DokumentationEasee Gateway#
Status: implementiert fuer IP-Symcon 8 und die Easee Cloud API.
Das Modul stellt pro Easee-Nutzerkonto genau eine gemeinsame Verbindung bereit. Benutzername, Passwort, Access Token und Refresh Token verbleiben im Gateway. Mehrere Instanzen von Ladestation Gateway koennen denselben Elternknoten verwenden.
Funktionsumfang#
- Anmeldung mit Easee-Benutzerkonto und automatische Token-Erneuerung,
- gemeinsame Ereignisverbindung zu
streams.easee.com, - Abonnement mehrerer Ladestationen mit aktuellem Zustand,
- Verteilung der Easee-Observations an die passenden Kindinstanzen,
- Stromvorgabe ueber
set_dynamic_charger_current, - Wiederverbindung und erneute Anmeldung aller Stationen nach Unterbrechungen,
- TLS-Zertifikatspruefung standardmaessig aktiv.
Properties#
| Ident | Typ | Standard | Beschreibung |
|---|---|---|---|
Active |
Boolean | true |
Aktiviert Anmeldung und Ereignisverbindung. |
Username |
String | leer | E-Mail-Adresse oder Telefonnummer des Easee-Kontos. |
Password |
Passwort | leer | Passwort, nur im Gateway gespeichert. |
VerifyCertificate |
Boolean | true |
Prueft TLS-Zertifikate fuer REST und WebSocket. |
Die interne Property Testmodus ist nicht im Formular sichtbar und wird nur
vom automatisierten IP-Symcon-Test verwendet.
Variablen#
| Ident | Typ | Beschreibung |
|---|---|---|
Connected |
Boolean | Ereignisverbindung ist betriebsbereit. |
SubscriptionCount |
Integer | Anzahl angemeldeter Seriennummern. |
LastError |
String | Letzter Fehler ohne Zugangsdaten oder Tokens. |
API und Ereignisse#
Der Gateway-Transport ist in
Easee-Gateway-Schnittstelle
vollstaendig beschrieben. Fuer Fahrzeug- und Phasenstatus werden insbesondere
Observation 109 und 110 verteilt. Nach jeder Wiederverbindung wird der
Cache verworfen und durch SubscribeWithCurrentState neu aufgebaut.
Fehlerbehandlung#
| Status | Bedeutung |
|---|---|
102 |
Verbindung aktiv. |
104 |
Gateway deaktiviert. |
201 |
Benutzername oder Passwort fehlt. |
202 |
Anmeldung oder Token-Erneuerung fehlgeschlagen. |
203 |
Ereignisverbindung fehlgeschlagen. |
REST-Aufrufe verwenden 5 Sekunden Verbindungs- und 30 Sekunden Gesamt-Timeout. HTTP-401 fuehrt einmalig zu einer Token-Erneuerung und Wiederholung. Tokens werden nie als Variable oder Debugtext ausgegeben.
Inbetriebnahme#
- Eine Instanz Easee Gateway erstellen.
- Benutzername und Passwort des Easee-Kontos eintragen.
- TLS-Pruefung aktiviert lassen.
- Speichern und Status
102sowieConnected=trueabwarten. - Fuer jede Station eine Kindinstanz Ladestation Gateway anlegen.
- Bei mehreren Konten je Konto eine eigene Gateway-Instanz verwenden.
Tests#
composer check prueft Syntax und Unit-Tests. Der Funktionstest laeuft mit:
tests/Symcon/bin/run-symcon-tests.sh single EaseeGateway