feat: Batteriemodul ereignisbasiert integrieren

docs/migration/Batterie.md

@@ -0,0 +1,67 @@
+# Migration Batterie aus Enelix 1
+
+## Ziel
+
+Die bisherige Batterie wird als Enelix-2-Verbraucher auf Vertrag 4.0
+umgestellt. Das alte Repository bleibt unveraendert und dient nur als
+Verhaltensreferenz.
+
+## Uebernommen
+
+- positive Sollleistung fuer Laden und negative Sollleistung fuer Entladen
+- dynamische maximale Lade- und Entladeleistung aus Variablen
+- Ladezustand, Netzleistung und aktuelle Batterieleistung als Eingaben
+- 250-W-Grundraster und 50-W-Feinwerte um 0
+- Reserve-, Mindestladezustands- und Hystereselogik
+- getrennte Angebote fuer PV und Peak
+- Wechselrichter- oder Enelix-Steuerung
+- Registercodes fuer generisch, GoodWe, SolarEdge und Sigenergy
+- Aufsummierung der bezogenen Energie
+
+## Angepasst
+
+| Enelix 1 | Enelix 2 |
+| --- | --- |
+| zyklischer Timer Do_UserCalc | Messwert- und Managerereignisse |
+| IdleCounter in Zyklen | Aenderungssperre in Sekunden mit Einmaltimer |
+| PowerSteps als Modulvariable | Leistungswerte_W direkt im Vertrag |
+| interne Stellwertvariablen | ausgewaehlte Registervariablen mit RequestAction |
+| fest verdrahtete Herstellerhilfsvariablen | dynamisch sichtbare Registerauswahl |
+| fest codierte 2-%-Hysterese | Property LadezustandHysterese |
+| berechnete Istleistung | gemessene Istleistung, Leistungsquelle 2 |
+| Interval-basierte Energie | Zeitintegration zwischen Ereignissen und Vollmeldungen |
+| Is_Peak_Shaving als Variable | Betriebsart PV oder Peak im Vertrag 4.0 |
+
+## Neu implementiert
+
+- Validierung aller Mess- und Registervariablen
+- Pflichtaktion auf jeder Zielregistervariable
+- Messwertalter und sicherer Zustand bei ungueltigen Messwerten
+- Sollwert-Timeout
+- Diagnosevariablen, Registerfehlerstatus und Debug-Logging
+- standardisierte PHPUnit- und Symcon-8.0-Laufzeittests
+- explizite Schnittstellenbeschreibung
+
+## Verworfen
+
+- direkter SetValue-Aufruf auf internen Leistungs- und Modusvariablen
+- zyklische Regelung mit frei konfigurierbarem Interval
+- doppelte Peak-/PV-Codepfade mit identischer Registerabbildung
+- ungenutzte Batteriespannungsproperty
+- CheckIdle mit globalem GetValue ohne Objekt-ID
+
+## Umstellung einer Anlage
+
+1. Bestehende Batterieinstanz und alle bisherigen Variablen-IDs dokumentieren.
+2. Sicherung der IP-Symcon-Konfiguration erstellen.
+3. Neue Enelix-2-Batterieinstanz anlegen.
+4. Fuenf Messwertvariablen zuordnen.
+5. Batterietyp waehlen und die eingeblendeten Registervariablen zuordnen.
+6. Reserve, Mindestladezustand und Aenderungssperre uebertragen.
+7. Neue Batterie im Enelix-2-Manager zuordnen.
+8. Diagnose und Logging aktivieren.
+9. Laden, Entladen, 0 W und Wechselrichtermodus unter Aufsicht testen.
+10. Alte Instanz erst nach erfolgreicher Feldpruefung deaktivieren.
+
+Ein automatisches Loeschen oder Ueberschreiben der alten Instanz findet nicht
+statt.