Enelix-EMS/docs/module/Ladestation-Gateway/README.md

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 und Solarladen.
DiagnosevariablenAnzeigen	Boolean	false	Zeigt technische Diagnosewerte.
LoggingEin	Boolean	false	Aktiviert Debugmeldungen ohne Geheimnisse.

Variablen

Immer sichtbar sind Aktiv, FahrzeugVerbunden, FahrzeugGeladen, Fahrzeugstatus, Ladestrom und Phasenzahl. Der normalisierte Fahrzeugstatus ist 0 unbekannt, 1 getrennt, 2 bereit, 3 laedt, 4 geladen oder 5 Fehler.

Optional sichtbar sind die gemeinsamen EMS-Diagnosewerte sowie GatewayVerbunden, ApiMaximalstrom, LetzterGeraetebefehl und LeistungsangebotDiagnose.

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

Managerkommunikation

Das Modul implementiert den EMS-Nachrichtenvertrag 4.0. 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

composer check
tests/Symcon/bin/run-symcon-tests.sh single LadestationGateway