Entwurf: docs/module/Wassererwaermer/README.md

docs/module/Wassererwaermer/README.md

@@ -0,0 +1,63 @@
+# Wassererwärmer
+
+> Status: Diskussionsentwurf. Vereinigt Boiler x-Stufig, Boiler mit Fühler,
+> Askoheat und Heizung x-Stufig.
+
+Anzahl, Leistung und Ausgangsbelegung werden je Stufe konfiguriert. Temperatur-,
+Nachlade-, Legionellen- und Askoheat-Werte sind Properties und können über
+`EinstellungenInVisu` bedienbar gemacht werden.
+
+## Zusätzliche Variablen
+
+| Ident | Typ / Zugriff | Beschreibung |
+| --- | --- | --- |
+| `Wassertemperatur` | Float / Anzeige | Aktueller Wert in °C. |
+| `TemperaturGueltig` | Boolean / Anzeige | Adapter liefert einen gültigen Wert. |
+| `NachladenAktiv` | Boolean / Anzeige | Mindesttemperaturanforderung aktiv. |
+| `LegionellenbetriebAktiv` | Boolean / Anzeige | Legionellenbetrieb läuft. |
+| `AktiveStufe` | Integer / Anzeige | Stufenkennung; `0` bedeutet aus. |
+| `LetzterLegionellenabschluss` | Integer / Anzeige | Unixzeit des letzten erfolgreichen Abschlusses. |
+| `NachladeMindesttemperatur` | Float / lokal bedienbar | Wirksamer Parameter in °C. |
+| `NachladeMaximaltemperatur` | Float / lokal bedienbar | Wirksamer Parameter in °C. |
+| `Maximaltemperatur` | Float / lokal bedienbar | Normale obere Zieltemperatur in °C. |
+| `Hysterese` | Float / lokal bedienbar | Hysterese in K. |
+| `NachladeMindesttemperaturAktiv` | Boolean / lokal bedienbar | Mindesttemperaturnachladung ein/aus. |
+| `NachladeMaximaltemperaturAktiv` | Boolean / lokal bedienbar | Separates Nachlade-Endziel ein/aus. |
+| `LegionellenfunktionAktiv` | Boolean / lokal bedienbar | Funktion ein/aus. |
+| `Legionellentemperatur` | Float / lokal bedienbar | Zieltemperatur in °C. |
+| `AskoheatFunktionAktiv` | Boolean / lokal bedienbar | Ansteuerung ein/aus. |
+
+## Zusätzliche Properties
+
+| Ident | Typ | Standard / Beschreibung |
+| --- | --- | --- |
+| `NachladeMindesttemperatur` | Float | `0*` °C; Starttemperatur. |
+| `NachladeMaximaltemperatur` | Float | `0*` °C; Endtemperatur. |
+| `Maximaltemperatur` | Float | `0*` °C; normales oberes Ziel. |
+| `Hysterese` | Float | `1` K; grösser 0. |
+| `NachladeMindesttemperaturAktiv` | Boolean | `false`. |
+| `NachladeMaximaltemperaturAktiv` | Boolean | `false`. |
+| `LegionellenfunktionAktiv` | Boolean | `false`. |
+| `Legionellentemperatur` | Float | `0*` °C. |
+| `AskoheatFunktionAktiv` | Boolean | `false`. |
+| `Betriebsprofil` | Auswahl | `Wassererwaermer` oder `EinfacheTemperaturheizung`. |
+| `Leistungsstufen` | String/JSON | `[]`; Stufenkennung, Leistung in W und vollständige Ausgangsbelegung. |
+| `Volumen` | Float | `0` l; `0` deaktiviert thermische Berechnung. |
+| `Mindestlaufzeit` | Integer | `0` s. |
+| `Mindeststillstand` | Integer | `0` s. |
+| `AskoheatInstanzID` | Integer | `0`; nur bei aktivierter Funktion. |
+| `AskoheatLeistungVariableID` | Integer | `0`; nur wenn der Adapter sie benötigt. |
+
+Temperatur-Maximalalter, Temperaturgrenze, Temperatur-Variable-ID, Zeitpläne,
+Legionellenhaltezeit, Legionellenmaximaldauer und Zeitzone entfallen.
+
+## Zustand
+
+`Wassertemperatur_C` als Istwert, `Maximaltemperatur_C` als Sollwert,
+`AktiveStufe`, `NachladenAktiv` und `LegionellenbetriebAktiv` als Status sowie
+`Fuehlerfehler` und `Uebertemperatur` als Störungen.
+
+## Offene Punkte
+
+- Ablauf für „Wassererwärmer über Wärmepumpe betreiben“ separat festlegen.
+- Konkreten Temperaturadapter und die Fühleranbindung bestätigen.