Entwurf: docs/module/Pufferspeicher/README.md

docs/module/Pufferspeicher/README.md

@@ -0,0 +1,54 @@
+# Pufferspeicher
+
+> Status: Diskussionsentwurf.
+
+Regelt elektrische Heizstufen nach Pufferbedarf. Die Heizkurve verwendet einen
+Fusspunkt bei 20 °C Aussentemperatur und eine Steigung:
+
+`Solltemperatur = FusspunktVorlauftemperatur + HeizkurvenSteigung × (20 - Aussentemperatur)`
+
+Anschliessend wird auf Mindest- und Maximaltemperatur begrenzt.
+
+## Zusätzliche Variablen
+
+| Ident | Typ / Zugriff | Beschreibung |
+| --- | --- | --- |
+| `Puffertemperatur` | Float / Anzeige | Aktuelle Temperatur in °C. |
+| `Aussentemperatur` | Float / Anzeige | Heizkurveneingang in °C. |
+| `TemperaturenGueltig` | Boolean / Anzeige | Beide Quellen sind gültig. |
+| `Solltemperatur` | Float / Anzeige | Berechneter und begrenzter Sollwert in °C. |
+| `Heizbedarf` | Boolean / Anzeige | Bedarf unter Berücksichtigung der Hysterese. |
+| `AktiveStufe` | Integer / Anzeige | Stufenkennung; `0` bedeutet aus. |
+| `FusspunktVorlauftemperatur` | Float / lokal bedienbar | Wirksamer Parameter in °C. |
+| `HeizkurvenSteigung` | Float / lokal bedienbar | Anhebung pro K fallender Aussentemperatur. |
+| `Mindesttemperatur` | Float / lokal bedienbar | Untere Begrenzung in °C. |
+| `Maximaltemperatur` | Float / lokal bedienbar | Obere Begrenzung in °C. |
+| `Hysterese` | Float / lokal bedienbar | Ein unter Soll minus Hysterese, aus bei Soll. |
+
+## Zusätzliche Properties
+
+| Ident | Typ | Standard / Beschreibung |
+| --- | --- | --- |
+| `FusspunktVorlauftemperatur` | Float | `0*` °C; Vorlauf bei 20 °C aussen. |
+| `HeizkurvenSteigung` | Float | `0*`; mindestens 0. |
+| `Mindesttemperatur` | Float | `0*` °C. |
+| `Maximaltemperatur` | Float | `0*` °C. |
+| `Hysterese` | Float | `1` K; grösser 0. |
+| `Leistungsstufen` | String/JSON | `[]`; Stufenkennung, Leistung in W und Ausgangsbelegung. |
+| `PuffertemperaturVariableID` | Integer | `0`; Temperaturquelle. |
+| `AussentemperaturVariableID` | Integer | `0`; Aussentemperaturquelle. |
+| `Mindestlaufzeit` | Integer | `0` s. |
+| `Mindeststillstand` | Integer | `0` s. |
+
+Vier bisherige Heizkurventemperaturen, beide Heizkurvenquellen, Übernahmeaktion,
+Zeitplan und Zeitzone entfallen.
+
+## Zustand
+
+`Puffertemperatur_C` und `Aussentemperatur_C` als Istwerte,
+`Solltemperatur_C` als Sollwert, `Heizbedarf` als Status und `Fuehlerfehler` als
+Störung.
+
+## Offene Punkte
+
+- Optionale Einbindung der Wärmepumpe beim Pufferheizen ausarbeiten.