diff --git a/docs/module/Pufferspeicher/README.md b/docs/module/Pufferspeicher/README.md new file mode 100644 index 0000000..3e90bb3 --- /dev/null +++ b/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.