ZHK
| ---- noch nicht Teil von FHEM ---- | |
|---|---|
| Zweck / Funktion | |
| Dieses Modul ist noch Entwicklung | |
| Allgemein | |
| Typ | Hilfsmodul |
| Details | |
| Dokumentation | noch nicht Teil von FHEM ---- EN / noch nicht Teil von FHEM ---- DE |
| Modulname | 98_ZHK.pm |
| Ersteller | epsrw1 |
| Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! | |
Das Fhem-Modul ZentralHeizKessel (ZHK) bietet die Möglichkeit, einen Zentralheizkessel mit Vorlauf, Vorlaufmischer/Rücklaufanhebung, Warmwasserspeicher+Ladepumpe zu steuern.
Features
|
An dieser Seite wird momentan noch gearbeitet. |
umfassende Parametereinstellung
- alle Modulteile können einzeln eingestellt oder deaktiviert werden
derzeit enthaltene interne Module
- VorlaufRegler: Heizkurvenberechnung und/oder Zusatzmodule berücksichtigen
- VorlaufZeitschaltplan: Wochenplaner für VL-Absenkung nach Zeiten
- AussentempRegler: zuschaltbare Aussentemp.Option
- HolzofenRegler: Temperatursprung-Erkennung für Kaminofen um VL frühzeitig anzupassen
- automatische Vorlauf-Totalabschaltung
- WarmWasserRegler: Temperatursturzerkennung (sofortiges Nachheizen bei großer Entnahme)
- WwZeitschaltplan: Wochenplaner für die Temp.-Voreinstellung nach Zeiten
- Warmwasser: manuelle Einstellung Eco/Confort/Gradzahl
- WarmWasser Kochprogramm über Wochenplaner
- KesselRegler: Einstellen der optimalen Kesseltemp. nach WarmWasser, Vorlauf, Brennertakt, VL/RL-Differenztemperatur
Beschreibung
die von FHEM mit dem modul ZHK gesteuerten Lastrelais werden in Reihe mit den sicherheitsrelevanten Teilen der Heizung geschaltet (zB. Sicherheitsabschaltung Überhitzung). Dabei sind die Anschlüsse so vorgesehen, daß die Relais im Ruhezustand durchleiten. Falls FHEM einmal nicht laufen sollte, läuft der Heizkessel mit Maximaltemperatur weiter bis die Steuerung neugestartet wurde. Im aktuellen Modulumfang sind folgende Anschlüsse an der Heizung enthalten:
- BrennerStop
- Warmwasser-Ladepumpe
- Warmwasser-Boost (übergehen der Max.Temp.)
- VorlaufPumpe Aus/An
- Mischermotor zB.: [1]
Define
define <name> ZHK <startverzögerung>
Um die Wirkung und Funktionsweise auszuprobieren, bietet sich an, mehrere Dummys zu verwenden:
define zhkBrennerFhemDev dummy
define zhkWwPumpFhemDev dummy
define zhkWwBoostFhemDev dummy
define zhkVorlaufPumpOffFhemDev dummy
define zhkVorlaufMischerFhemDev dummy
define zhkVorlaufTempTriggerFhemDev dummy
Um alle Einstellmöglichkeiten auf Standardwerte Grundeinzustellen kann das Kommando SetAttribs verwendet werden. Bereits bestehende Einstellungen werden dabei nicht überschrieben.
set <name> SetAttribs
Der Wochenplan für die Vorlaufabsenkung kann mit dem befehl vltimer eingestellt werden. Die Syntax ist:
set <name> vltimer <Mo|Di|Mi|Do|Fr|Sa|So|*> <04:00=0|08:30=-3|17:00=0|22:00=-3>
Achtung: bei set "*" werden alle Tage auf einmal überschrieben!
Der Wochenplan für die Warmwassertemperatur kann mit dem befehl wwtimer eingestellt werden. Die Syntax ist:
set <name> wwtimer <Mo|Di|Mi|Do|Fr|Sa|So|*> <04:00=45|08:30=30|17:00=45|22:00=30>
Achtung: bei set "*" werden alle Tage auf einmal überschrieben!
Die warmwassertemperatur kann jederzeit mit FHEM manuell eingestellt werden. Beim nächsten Zeitplan-Punkt geht die Temperatur automatisch wirder auf den vorprogrammierten Wert.
set <name> zhkWwSollTemp <Eco|Confort| gradzahl >
Eco und Confort sind Standardtemperaturen die über Attr voreingestellt werden können.
Readings
Alle Readings sind auch in fhem durch das kommando get readingsHelp <varname> erklärt, für's "schnelle nachschauen zwischendurch".
| Reading | Default | Typ | Beschreibung |
|---|---|---|---|
| zhkBrennerLaststart | 0 | int | brenner cached last start timestamp |
| zhkBrennerActualState | 0 | int | burner state 0=off 1=on |
| zhkWwAlphaActualVal | 0 | float | zuletzt berechneter wert für alpha |
| zhkWwIstLastReading | 0 | string | cached last OW temp for alpha-calc |
| zhkWwPumpStopStatus | off | string | zeigt aktuellen status 1=warmwasser ladepumpe gestoppt 0=aufheizen |
| zhkWwBoostStatus | off | string | zeigt aktuellen status 1=warmwasser temperaturbegrenzer überbrückt |
| zhkWwPumpLaststart | 0 | int | zeitstempel lester start warmwasser ladepumpe |
| zhkWwSollTemp | 30 | int | einstellung User (zeitplan mit at möglich) |
| zhkWwBetriebsmodus | Unbekannt | string | Confort (zb. mit at plan) |
| zhkWwPriorityOn | 0 | int | wenn 1, dann brenner sofort starten |
| zhkWwIstTempVal | 0 | float | OW lesen, wenn fehler dann default MAX |
| zhkWwIstTempTimestamp | 0 | string | timestamp last OW update |
| zhkWwTimerLastSetValue | 0 | int | last Ww desired temp set by timer function |
| zhkHolzofenAlphaActualVal | 0 | float | zuletzt berechneter wert für alpha (./zhkHolzofenTempSensorMinAge |
| zhkHolzofenTempSensorTimestamp | 0 | string | timestamp last OW update |
| zhkHolzofenTempSensorActValue | 0 | float | actual temp of sensor in holzofen room |
| zhkHolzofenTempHistoryCache | 20=11223344 20=11225566 | string | cached last 2 temp readings |
| zhkHolzofenState | 0 | int | 1 |
| zhkGlobalAutoGeneratedReadings | 0 | string | alert if readings were not present in statefile at start |
| zhkAussenTempActualVal | 0 | float | actual aussentemp sensor temperature value |
| zhkAussenTempActualTimestamp | 0 | float | timestamp of last aussentemp value |
| zhkAussenTempTodayMin | 0 | float | aussentemp today's minimum temp |
| zhkAussenTempTodayMax | 0 | float | aussentemp today's maximum temp |
| zhkAussenTempYesterdayMin | 0 | float | aussentemp yesterday's minimum temp |
| zhkAussenTempYesterdayMax | 0 | float | aussentemp yesterday's maximum temp |
| zhkAussenTempYesterday | 0 | float | cache of yesterday's date |
| zhkAussenTempDelayCache | 0=22334455 | string | cache für trägheit aussentemp last-temp=timestamp |
| zhkVorlaufHkurveCalcFaktor | 1.16 | float | erhöhungsfaktor heizkurve |
| zhkVorlaufActualTempVL | VL readErr | float | cached actual vorlauf temperature |
| zhkVorlaufActualTempRL | RL readErr | float | cached actual rücklauf temperature |
| zhkVorlaufMischerPosActualPosition | 0 | int | heizkreis-mischer actual position |
| zhkVorlaufDesiredTemp | 0 | 0 | calculated desired vorlauf temp |
| zhkVorlaufState | 0 | int | actual vorlauf state (auto manual disabled off °C) |
| zhkVorlaufTotalOnOffState | 1 | int | status VL totalabschaltung 1=pump on 0=all off |
| zhkVorlaufTotalOnOffReqTimeOff | 0 | float | internal cache for zhkVorlaufTotalOnOffMischerDelay |
| zhkVorlaufManual | 0 | int | cached manual setting fixed temp if >0 |
| zhkVorlaufTimerTempAdjust | 0 | int | wird in VL zu desired-t addiert |
| zhkKesselDesiredTemp | 35 | int | aktuelle soll-temp kessel |
| zhkKesselActualTemp | 0 | float | cached actual kessel temp |
Attributes
Alle attr sind auch in fhem durch das kommando get attrHelp <varname> erklärt, für's "schnelle nachschauen zwischendurch".
| Attribute | Default | Typ | Beschreibung |
|---|---|---|---|
| zhkBrennerTaktMinOnSec | 300 | int | brenner delay before set off after on-command |
| zhkBrennerFhemDev | P3_BrennerStop | string | brennerschalter, 0=burn 1=off |
| zhkBrennerLogLastStateChange | 0 | int | cache zeitstempel für log betriebsstunden |
| zhkBrennerTaktMinOffSec | 30 | int | delay before set on |
| zhkWwAlphaDownAlarmDiffDeg | 0.8 | float | mindest-temp-diff für sofort-aufheizung |
| zhkWwAlphaUpAlarmDiffDeg | 5 | float | min.diff zu abschaltung hot für AlphaUp |
| zhkWwAlphaThreshold | 0.42 | float | Meßtoleranz ww-temp °C |
| zhkWwTaktMinOnSec | 60 | int | delay before off when WwPump started |
| zhkWwConfortTemp | 31 | int | tempvoreinstellung Confort-Modus |
| zhkWwEcoTemp | 37 | float | tempvoreinstellung Eco-Modus |
| zhkWwPumpFhemDev | P7_WwStop | string | WW pumpe, 0=on / 1=off |
| zhkWwBoostFhemDev | P2_WwBoost | string | relais um analoge temperaturbegrenzug zu übergehen |
| zhkWwBoostStartTemp | 45 | int | temp. ab der die umgehung notwendig ist |
| zhkWwTempSensorFhemDev | 5_15_WarmWasser_EB6F98050000 | string | fhem device to read the temperature from |
| zhkWwTempSensorReading | temperature | string | name of reading with float temp value |
| zhkWwTempSensorMaxAge | 300 | int | sensor ignorieren wenn state-age > x seconds |
| zhkWwTempSensorDefaultOnFailure | 70 | int | default temp to assume if temp-sensor fails |
| zhkWwTimerScheduleSo | 0 | string | schaltpunkte für wochentagsplanung |
| zhkWwTimerScheduleMo | 0 | string | schaltpunkte für wochentagsplanung |
| zhkWwTimerScheduleDi | 0 | string | schaltpunkte für wochentagsplanung |
| zhkWwTimerScheduleMi | 0 | string | schaltpunkte für wochentagsplanung |
| zhkWwTimerScheduleDo | 0 | string | schaltpunkte für wochentagsplanung |
| zhkWwTimerScheduleFr | 0 | string | schaltpunkte für wochentagsplanung |
| zhkWwTimerScheduleSa | 0 | string | schaltpunkte für wochentagsplanung |
| zhkHolzofenResetLowTemp | 18 | float | temp für reset des state auf 0 (if no FhemDev) |
| zhkHolzofenResetLowFhemDev | Heizg_Wohnzimmer1 | 0 | fhem device to read reset-low temp from |
| zhkHolzofenResetLowFhemDevreading | desiredTemperature | 0 | fhem device reading to read reset-low temp from |
| zhkHolzofenAlphaUpAlarmDiffDeg | 3 | float | min.diff für abschaltung hot |
| zhkHolzofenAlphaThreshold | 0.07 | float | Meßtoleranz temp °C |
| zhkHolzofenTempSensorFhemDev | 83_WohnZi_9554CD040000 | string | fhem device to read the temperature from |
| zhkHolzofenTempSensorReading | temperature | string | name of reading with float temp value |
| zhkHolzofenTempSensorMinAge | 300 | int | recalc alpha after seconds |
| zhkHolzofenTempSensorDefaultOnFailure | 20 | int | temp.default if sensor fail |
| zhkHolzofenIgnoreTempIfFhemDev | dummyDisableHolzofen | string | zb. Window shutter, do not trigger if FhemDev state is true |
| zhkGlobalPollInterval | 10 | int | internal loop interval for recalc, increase if cpu load is too high |
| zhkGlobalIncludeValvePositions | 1 | int | enable valve position correction module |
| zhkGlobalIncludeWarmwasser | 1 | int | enable warmwasser module |
| zhkGlobalIncludeKessel | 1 | int | enable kessel regler module |
| zhkGlobalIncludeVorlauf | 1 | int | enable vorlauf (general) module |
| zhkGlobalIncludeVorlaufZeischaltplan | 1 | int | enable vorlauf timer module |
| zhkGlobalIncludeWwZeischaltplan | 1 | int | enable warmwasser timer module |
| zhkGlobalIncludeAussentemp | 1 | int | enable aussentemp module |
| zhkGlobalIncludeHolzofen | 1 | int | enable holzofen detection module |
| zhkAussenTempFhemDev | 81_Aussen_D745CE040000 | string | fhem device aussentemp |
| zhkAussenTempFhemDevReading | temperature | string | fhem dev reading aussentemp |
| zhkAussenTempFhemDevFallback | dummyOnlineWeatherTemp | string | fhem device aussentemp second (fallback or dummy) |
| zhkAussenTempFhemDevReadingFallback | state | string | fhem dev reading aussentemp second (fallback or dummy) |
| zhkAussenTempMaxAge | 1200 | int | max age of out-temp reading timestamp before ignore |
| zhkAussenTempAlarmTempLimit | 16 | float | grundeinstellung AT schaltpunkt °C |
| zhkAussenTempAlarmThreshold | 1 | float | Mindestabweichung vom schaltpunkt für umschaltung |
| zhkAussenTempAlarmDelay | 600 | int | Trägheit AT schaltung seconds |
| zhkAussenTempIgnoreIfFhemDev | dummyDisableAussentemp | string | while state if this fhem device is true, disable aussentemp-calc temporarily |
| zhkAussenTempIsWarmState | 0 | int | actual state, 1=warm 0=cold |
| zhkVorlaufHkurveAussenMax_TH | 15 | int | max.wert für heizkurvenberechnung |
| zhkVorlaufHkurveAussenMin_TL | -20 | int | min.wert für heizkurvenberechnung |
| zhkVorlaufHkurveVorlaufMax_TH | 50 | int | max.wert für heizkurvenberechnung |
| zhkVorlaufHkurveVorlaufMin_TL | 20 | int | min.wert für heizkurvenberechnung |
| zhkVorlaufIgnoreIfFhemDev | dummyDisableVorlauf | string | while state if this fhem device is true, disable vorlauf(general)-calc temporarily |
| zhkVorlaufVLTempFhemDev | 1_17_Vorlauf_D1F798050000 | string | fhem device name, vorlauf temp |
| zhkVorlaufVLTempFhemDevReading | temperature | string | fhem device reading, vorlauf temp |
| zhkVorlaufRLTempFhemDev | 2_12_Ruecklauf_56B897050000 | string | fhem device name, rücklauf temp |
| zhkVorlaufRLTempFhemDevReading | temperature | string | fhem device reading, rücklauf temp |
| zhkVorlaufMischerPosFhemDev | MischerPosition | string | heizkreis-mischer fhem device |
| zhkVorlaufMischerPosFhemDevReading | position | string | heizkreis-mischer device reading für position |
| zhkVorlaufPumpOffFhemDev | P6_PumpOff | string | FhemDev das Vorlauf stromzufuhr pumpe kappt |
| zhkVorlaufMischerFhemDev | VorlaufMischer | string | zb STELLMOTOR FhemDev oder anderes Ventil |
| zhkVorlaufTempTriggerFhemDev | VorlaufRegler | string | evtl.PID20 oder Notify-FhemDev für Mischeransteuerung |
| zhkVorlaufTempTriggerFhemDevSetting | desired | string | evtl.PID20 oder Notify-FhemDev für Mischeransteuerung |
| zhkVorlaufTempTriggerFhemDevReading | desired | string | evtl.PID20 oder Notify-FhemDev für Mischeransteuerung |
| zhkVorlaufTotalOnOffMischerDelay | 150 | string | delay to wait for mischer calibrate before VL off |
| zhkVorlaufTimerScheduleSo | 0 | string | schaltpunkte für wochentagsplanung |
| zhkVorlaufTimerScheduleMo | 0 | string | schaltpunkte für wochentagsplanung |
| zhkVorlaufTimerScheduleDi | 0 | string | schaltpunkte für wochentagsplanung |
| zhkVorlaufTimerScheduleMi | 0 | string | schaltpunkte für wochentagsplanung |
| zhkVorlaufTimerScheduleDo | 0 | string | schaltpunkte für wochentagsplanung |
| zhkVorlaufTimerScheduleFr | 0 | string | schaltpunkte für wochentagsplanung |
| zhkVorlaufTimerScheduleSa | 0 | string | schaltpunkte für wochentagsplanung |
| zhkKesselThreshold | 5 | int | zulässige temp.schwankung kessel |
| zhkKesselMinDiffWw | 8 | int | min.diff Ww-Soll/Kessel-Min-Soll |
| zhkKesselMinDiffVorlauf | 10 | int | min.diff Vorlauf-Soll/Kessel-Min-Soll |
| zhkKesselAbsoluteMaxTemp | 70 | int | sicherheit falls rechenprobleme |
| zhkKesselAbsoluteMinTemp | 30 | int | sicherheit falls rechenprobleme |
| zhkKesselTempFhemDev | 4_14_Kessel_E3CD97050000 | string | fhem device kesseltemperatur |
| zhkKesselTempFhemDevReading | temperature | string | device reading kesseltemperatur |
| zhkKesselTempSecondFhemDev | 0 | string | fhem device kesseltemperatur backup-device |
| zhkKesselTempSecondFhemDevReading | temperature | string | device reading kesseltemperatur backup-device |
| zhkKesselTempMaxReadingAge | 600 | int | max age of kessel temp reading, if too old device is not present or has error ->log alert |
| zhkKesselVLRLdiffErhFaktor | 0 | float | erhöhungsfaktor: gewichtung VL-RL-diff für kesseltemp.einstellung |
| zhkKesselMischerErhFaktor | 0 | float | erhöhungsfaktor: gewichtung mischerposition für kesseltemp.einstellung |
Links
- Thread im Forum, in dem dieses Modul vorgestellt wurde