Entwurf: Batterie

docs/module/Batterie/README.md

@@ -0,0 +1,59 @@
+# Batterie
+
+> Status: Diskussionsentwurf. Positiv bedeutet Laden, negativ Entladen.
+
+Die Auswahl des Batterietyps bestimmt den Adapter und die sichtbaren
+Anschlussfelder. Ohne Logging bleibt von den zusätzlichen Variablen nur
+`Ladestatus` sichtbar.
+
+## Zusätzliche Variablen
+
+| Ident | Typ / Zugriff | Beschreibung |
+| --- | --- | --- |
+| `Ladestatus` | Integer / Anzeige | `0` unbekannt, `1` ruhend, `2` laden, `3` entladen. |
+| `Ladezustand` | Float / Logging | Physischer Ladezustand in %. |
+| `LadezustandGueltig` | Boolean / Logging | Gültigkeit unabhängig von der Leistungsmessung. |
+| `Steuerungsmodus` | Integer / lokal bedienbar | `0` Batterie, `1` Manager, `2` Virtuelle Batterie führt. |
+| `NotnachladungAktiv` | Boolean / Logging | Aus Ladezustand ermittelter lokaler Bedarf. |
+| `LadeleistungVerfuegbar` | Float / Logging | Aktuell nutzbare Ladeleistung in W. |
+| `EntladeleistungVerfuegbar` | Float / Logging | Aktuell nutzbare Entladeleistung als positiver Betrag in W. |
+| `MaxLadeleistung` | Float / lokal bedienbar | Wirksamer Parameter in W. |
+| `MaxEntladeleistung` | Float / lokal bedienbar | Wirksamer Parameter in W. |
+| `Mindestladezustand` | Float / lokal bedienbar | Wirksamer Parameter in %. |
+| `Maximalladezustand` | Float / lokal bedienbar | Wirksamer Parameter in %. |
+| `Nachladeschwelle` | Float / lokal bedienbar | Wirksamer Parameter in %. |
+| `Nachladehysterese` | Float / lokal bedienbar | Wirksamer Parameter in %. |
+| `Notnachladeleistung` | Float / lokal bedienbar | `0` deaktiviert; sonst Leistung in W. |
+
+## Zusätzliche Properties
+
+| Ident | Typ | Standard / Beschreibung |
+| --- | --- | --- |
+| `MaxLadeleistung` | Float | `0*` W; einzige einstellbare obere Ladegrenze. |
+| `MaxEntladeleistung` | Float | `0` W; einzige einstellbare obere Entladegrenze. |
+| `Mindestladezustand` | Float | `0*` %; Bereich 0–100. |
+| `Maximalladezustand` | Float | `100` %; grösser als Mindestladezustand. |
+| `Nachladeschwelle` | Float | `0*` %; zwischen Mindest- und Maximalladezustand. |
+| `Nachladehysterese` | Float | `2` %; Schwelle plus Hysterese höchstens Maximalladezustand. |
+| `Notnachladeleistung` | Float | `0` W; sonst höchstens MaxLadeleistung. |
+| `Batterietyp` | Auswahl | `Unkonfiguriert`, `Herstellerunabhaengig`, `Goodwe`, `SolarEdge`, `SigEnergy`. |
+| `BatterieInstanzID` | Integer | `0`; für kompatible Herstelleradapter. |
+| `LadezustandVariableID` | Integer | `0`; nur herstellerunabhängig. |
+| `IstleistungVariableID` | Integer | `0`; nur herstellerunabhängig. |
+| `SollleistungVariableID` | Integer | `0`; nur herstellerunabhängig, vorzeichenbehaftet in W. |
+| `LadezustandMaxAlter` | Integer | `60` s; Aktualität des Ladezustands. |
+| `VirtuelleBatterieID` | Integer | `0`; Pflicht bei Steuerungsmodus 2. |
+
+Anschlussart, Batteriespannung, Gerätezuordnung, Leistungsschritt,
+Sollwertquelle und externe Sollwerte entfallen.
+
+## Zustand
+
+`Ladezustand_Prozent` als Istwert; `Steuerungsmodus` und
+`NotnachladungAktiv` als Status; `LadezustandFehlt` und `Geraetefehler` als
+Störungen.
+
+## Offene Punkte
+
+- Michis konkrete Fehlerliste nachliefern und gegen den Entwurf prüfen.
+- Datenpunkte und Leistungsgrenzen der drei Herstelleradapter verifizieren.