Easee-Gateway-Schnittstelle

Stand: 2026-09-22

Die Schnittstelle verbindet das kontobezogene Splittermodul EaseeGateway mit beliebig vielen Kindinstanzen LadestationGateway.

IP-Symcon-Daten-IDs

Richtung	DataID
Ladestation an Gateway	`{7AEF3DF7-DA5B-47C5-BCDC-0110D06DDC04}`
Gateway an Ladestation	`{107D5CFA-8F3D-4E38-8643-90DDFE6A3B4D}`

Die aeussere IP-Symcon-Nachricht enthaelt DataID und Buffer. Buffer ist wiederum ein JSON-Objekt.

Anfragen an das Gateway

{
  "action": "Subscribe",
  "serialNumber": "EH123456"
}

GetState besitzt dasselbe Format. Beide Aktionen registrieren die Seriennummer und liefern den Cache:

{
  "success": true,
  "connected": true,
  "state": {
    "109": 3,
    "110": 30,
    "120": 11.0,
    "updated": 1790053200
  }
}

SetDynamicChargerCurrent

{
  "action": "SetDynamicChargerCurrent",
  "serialNumber": "EH123456",
  "amps": 13
}

Zulaessig sind 0 A oder ganzzahlige Werte von 6 A bis 32 A. Das Gateway ruft POST /api/chargers/{serialNumber}/commands/set_dynamic_charger_current mit {"amps":13,"minutes":0} auf.

Ereignisse an Kindinstanzen

Observation

{
  "type": "Observation",
  "serialNumber": "EH123456",
  "id": 110,
  "value": 30,
  "timestamp": 1790053200
}

Verteilt werden die IDs 47, 48, 100, 104, 109, 110, 119, 120, 182 bis 185 und 250. Jede Kindinstanz verwirft Ereignisse anderer Seriennummern.

GatewayStatus

{
  "type": "GatewayStatus",
  "connected": false
}

Bei false setzt die Ladestation Verfuegbarkeit und Aenderbarkeit sofort zurueck. Bei true fordert sie den aktuellen Zustand erneut an.

Zustandsabbildung

Observation 109 wird gemaess Easee OpMode abgebildet: 0 offline, 1 getrennt, 2/6/7/8 bereit, 3 laedt, 4 geladen und 5 Fehler. Unbekannte Werte geben die Regelung nicht frei. Observation 110 liefert die aktive Ausgangsphase: 10..15 einphasig und 30 dreiphasig. Es gibt keine leistungsbasierte Phasenschaetzung.

Fehlervertrag

Gateway-Antworten enthalten immer success. Bei false folgt ein menschenlesbares Feld error; optional wird httpCode ergaenzt. Zugangsdaten, Access Token und Refresh Token duerfen weder in Antworten noch in Ereignissen oder Diagnosevariablen vorkommen.

2.3 KiB Raw Blame History