124 lines
5.3 KiB
Markdown
124 lines
5.3 KiB
Markdown
# Ladestation Gateway
|
|
|
|
> Status: implementiert fuer IP-Symcon 8 und den Enelix-2-Vertrag `4.0`.
|
|
|
|
Das Modul bindet genau eine Easee-Ladestation als EMS-Verbraucher an. Es ist
|
|
Kind eines **Easee Gateway** und besitzt keine Zugangsdaten.
|
|
|
|
## Varianten
|
|
|
|
| Betriebsmodus | Verhalten |
|
|
| --- | --- |
|
|
| `Easee` | Solarladen kann als Startwert konfiguriert und lokal umgeschaltet werden. |
|
|
| `Easee - Nur Solarladen` | Solarladen ist fest aktiv und kann nicht abgeschaltet werden. |
|
|
|
|
Die alte eCarUp-Zusatzabhaengigkeit wird nicht uebernommen. Konto,
|
|
Ladestatus und Steuerung laufen ausschliesslich ueber Easee.
|
|
|
|
## Ereignisbasierter Status
|
|
|
|
Das Modul pollt die Ladestation nicht. Es verarbeitet unmittelbar die vom
|
|
Gateway gelieferten Easee-Observations:
|
|
|
|
| Observation | Verwendung |
|
|
| ---: | --- |
|
|
| `47` | Maximalstrom der Ladestation. |
|
|
| `104` | Kabelstromgrenze. |
|
|
| `109` | Fahrzeugerkennung und Ladezustand. |
|
|
| `110` | Aktive Ausgangsphase: Werte 10 bis 15 ergeben 1 Phase, Wert 30 ergibt 3 Phasen. |
|
|
| `119` | Easee-Fehlercode. |
|
|
| `120` | Gemessene Gesamtleistung in kW. |
|
|
| `182..185` | Gemessene Leiterstroeme; der groesste Betrag ist der angezeigte Ladestrom. |
|
|
|
|
Damit entfallen die alte 60-Sekunden-Erkennung, die 7500-W-Schwelle und die
|
|
Voll-Erkennung aus einem unterschaetzten Strom. Fahrzeug, Ladeende und
|
|
Phasenzahl stammen direkt aus der Easee API. Zweiphasige oder noch nicht
|
|
zugewiesene Ausgangsphasen sowie unbekannte Betriebszustaende werden sicher
|
|
als ungueltig behandelt und ergeben bis zur gueltigen 1-/3-Phasenmeldung nur
|
|
`[0]`.
|
|
|
|
## Properties
|
|
|
|
| Ident | Typ | Standard | Beschreibung |
|
|
| --- | --- | ---: | --- |
|
|
| `Betriebsmodus` | Integer | `0` | `0` Easee, `1` Easee - Nur Solarladen. |
|
|
| `Ladestationskennung` | String | leer | Easee-Seriennummer. |
|
|
| `MaximalerLadestrom` | Integer | `16 A` | Lokale Obergrenze von 6 bis 32 A. API- und Kabelgrenze wirken zusaetzlich. |
|
|
| `Ladefreigabe` | Boolean | `false` | Startwert der lokalen Ladefreigabe. |
|
|
| `Solarladen` | Boolean | `true` | Startwert im normalen Easee-Modus. |
|
|
| `PrioritaetPV` | Integer | `0` | Prioritaet im PV-Betrieb. |
|
|
| `PrioritaetPeak` | Integer | `0` | Prioritaet im Peakbetrieb. |
|
|
| `Meldeintervall` | Integer | `10 s` | Periodische Vollmeldung an den Manager. |
|
|
| `VorgabeTimeout` | Integer | `120 s` | Ablauf einer nicht erneuerten Manager-Vorgabe. |
|
|
| `EinstellungenInVisu` | Boolean | `false` | Zeigt Ladefreigabe, Solarladen, Istleistung und Sollleistung. |
|
|
| `DiagnosevariablenAnzeigen` | Boolean | `false` | Zeigt technische Diagnosewerte. |
|
|
| `LoggingEin` | Boolean | `false` | Aktiviert Debugmeldungen ohne Geheimnisse. |
|
|
|
|
## Variablen
|
|
|
|
Immer sichtbar sind `Aktiv`, `FahrzeugVerbunden`, `FahrzeugGeladen`,
|
|
`Ladestrom` und `Phasenzahl`. Mit `EinstellungenInVisu=true` erscheinen
|
|
zusaetzlich `Ladefreigabe`, `Solarladen`, `Istleistung` und `Sollleistung`.
|
|
|
|
Mit `DiagnosevariablenAnzeigen=true` werden der numerische `Fahrzeugstatus`
|
|
und die gemeinsamen EMS-Diagnosewerte sowie
|
|
`GatewayVerbunden`, `ApiMaximalstrom`, `EaseeAktiviert`,
|
|
`AutorisierungErforderlich`, `RemoteStartErforderlich`, `SmartCharging`,
|
|
`GrundKeinLadestrom`, `LetzterGeraetebefehl`, `LetzterStartbefehl` und
|
|
`LeistungsangebotDiagnose` angezeigt. `GrundKeinLadestrom=55` bedeutet bei Easee, dass
|
|
die Autorisierung fehlt.
|
|
|
|
## Regelung
|
|
|
|
Die Leistungsstufen und das PV-/Peak-Verhalten entsprechen der
|
|
Ladestation Stand-Alone:
|
|
|
|
| Betriebsart | Solarladen | Angebot |
|
|
| --- | --- | --- |
|
|
| PV | ein | `[0, ...Ladestufen]` |
|
|
| PV | aus | nur maximale Ladestufe |
|
|
| Peak | ein | `[0]` |
|
|
| Peak | aus | `[0, ...Ladestufen]` |
|
|
|
|
Die niedrigste Grenze aus Property, Observation `47` und Observation `104`
|
|
bestimmt den angebotenen Maximalstrom. Eine neue Observation berechnet das
|
|
Angebot sofort neu und meldet die Aenderung kurz gebuendelt an den Manager.
|
|
Beim Aktivieren oder Umschalten von Solarladen bleibt der bisherige
|
|
Geraetestrom bis zur neuen Manager-Vorgabe unveraendert. Ohne Managerantwort
|
|
greift nach zwei Sekunden das lokale Ersatzverhalten. Sicherheitsabschaltungen
|
|
werden nicht verzoegert.
|
|
|
|
Bei einer Gateway-Unterbrechung werden Fahrzeug- und Phasenstatus sofort
|
|
verworfen; erst ein neuer aktueller Gateway-Zustand gibt die Regelung wieder
|
|
frei. Die eigentliche Vorgabe wird als dynamischer Ladestrom mit `minutes=0`
|
|
an Easee gesendet. Meldet Easee bei positiver Stromvorgabe weiterhin
|
|
`Awaiting Start`, sendet das Modul einmal pro Fahrzeugverbindung zusaetzlich
|
|
`start_charging`. Dieser Befehl autorisiert den Ladevorgang, uebersteuert aber
|
|
keinen vorhandenen Easee-Ladeplan.
|
|
|
|
## Managerkommunikation
|
|
|
|
Das Modul implementiert den
|
|
[EMS-Nachrichtenvertrag `4.0`](../../Schnittstelle.md). Es wird im Manager
|
|
wie die Stand-Alone-Ladestation unter dem Lizenzkatalog `ev_charger`
|
|
gefuehrt. Es gibt keine Manager-ID-Property; die Zuordnung erfolgt nur im
|
|
Manager.
|
|
|
|
## Inbetriebnahme
|
|
|
|
1. Ein konfiguriertes Easee Gateway mit Status `102` bereitstellen.
|
|
2. Darunter **Ladestation Gateway** erstellen.
|
|
3. Variante, Seriennummer und elektrische Maximalgrenze konfigurieren.
|
|
4. Ladefreigabe und Solarladen festlegen.
|
|
5. Die Instanz im Enelix Manager aktiv zuordnen.
|
|
6. Ohne Fahrzeug Status `1` und Angebot `[0]` pruefen.
|
|
7. Fahrzeug verbinden und die API-Werte fuer Status und Phasenzahl kontrollieren.
|
|
8. Erst danach `Aktiv` einschalten und eine kleine Vorgabe testen.
|
|
|
|
## Tests
|
|
|
|
```bash
|
|
composer check
|
|
tests/Symcon/bin/run-symcon-tests.sh single LadestationGateway
|
|
```
|