# 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.