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