104 lines
2.3 KiB
Markdown
104 lines
2.3 KiB
Markdown
# 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
|
|
|
|
### Subscribe und GetState
|
|
|
|
```json
|
|
{
|
|
"action": "Subscribe",
|
|
"serialNumber": "EH123456"
|
|
}
|
|
```
|
|
|
|
`GetState` besitzt dasselbe Format. Beide Aktionen registrieren die
|
|
Seriennummer und liefern den Cache:
|
|
|
|
```json
|
|
{
|
|
"success": true,
|
|
"connected": true,
|
|
"state": {
|
|
"109": 3,
|
|
"110": 30,
|
|
"120": 11.0,
|
|
"updated": 1790053200
|
|
}
|
|
}
|
|
```
|
|
|
|
### SetDynamicChargerCurrent
|
|
|
|
```json
|
|
{
|
|
"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
|
|
|
|
```json
|
|
{
|
|
"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
|
|
|
|
```json
|
|
{
|
|
"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.
|