Wärmepumpe in OpenHAB einbinden
OpenHAB ist eine open-source Smarthome Lösung, die unterschiedlichste Smarthome Systeme und Protokolle auf einer einzigen Plattform zusammenbringt. Die Java-basierte Lösung ermöglicht eine zentrale Steuerung sowie das Erstellen flexibler Automatisierungsregeln für Geräte verschiedenster Marken. Mit OpenHABian lässt sich OpenHAB schnell und einfach auf einem Raspberry Pi installieren.
Lokale API mit MQTT
Voraussetzungen:
- Bosch K40 RF oder Buderus MX400 WLAN-Gateway mit der Gateway-Firmware 15.00.01 oder neuer.
- Ein MQTT-Broker, zum Beispiel Mosquitto. Bei einer Installation mit OpenHABian könnt ihr Mosquitto über
sudo openhabian-configunter Optional Components installieren. - Das MQTT Binding und die JSONPath-Transformation in OpenHAB.
Die k40rf-bridge stellt Werte des K 40 RF über einen MQTT-Broker bereit. Mit installiertem MQTT Binding und eingerichtetem Broker kann OpenHAB die Bridge über MQTT Discovery erkennen. Das Projekt-README enthält auch Beispiele für manuell konfigurierte Things und Items. Der Zugriff ist lesend und die MQTT-Topics unterscheiden sich von den folgenden EMS-ESP-Beispielen.
EMS-ESP mit MQTT
Voraussetzungen:
- Ein eingerichtetes EMS-ESP-Gateway mit aktivierter MQTT-Verbindung.
- Ein MQTT-Broker, zum Beispiel Mosquitto, den sowohl EMS-ESP als auch OpenHAB erreichen können. Bei einer Installation mit OpenHABian könnt ihr Mosquitto über
sudo openhabian-configunter Optional Components installieren. - Das MQTT Binding und die JSONPath-Transformation in OpenHAB. Die folgende Konfiguration verwendet ein manuell definiertes MQTT-Thing; MQTT Discovery ist dafür nicht erforderlich.
Die Beispiele setzen das Entitäts-ID-Format Einzelinstanz, MQTT-Namen (3.5) in den MQTT-Einstellungen von EMS-ESP voraus.
Falls ihr ein anderes Entitäts-ID-Format oder mehr Heizkreise verwendet, passt die Topics und JSON-Pfade entsprechend an.
MQTT-Thing und Channels
Speichert die folgende Konfiguration als things/mqtt.things im OpenHAB-Konfigurationsverzeichnis.
Ersetzt die Broker-Adresse 192.168.178.20 durch eure eigene Adresse.
Falls euer Broker eine Anmeldung verlangt, ergänzt in der Bridge username="<benutzername>" und password="<passwort>".
Wenn der Broker bereits in OpenHAB eingerichtet ist, verwendet dessen Thing-UID anstelle von mqtt:broker:myMQTTBroker und übernehmt nur das Wärmepumpen-Thing.
availabilityTopic zeigt anhand von ems-esp/status, ob das Gateway online ist.
Jeder Channel liest über stateTopic ein MQTT-Topic und extrahiert mit transformationPattern den gewünschten Wert.
Da die Beispiele kein commandTopic definieren, dienen sie ausschließlich zum Auslesen.
things/mqtt.things
Bridge mqtt:broker:myMQTTBroker "MQTT-Broker" [
host="192.168.178.20",
port=1883,
clientID="openhab-emsesp"
]
Thing mqtt:topic:emsesp "Wärmepumpe" (mqtt:broker:myMQTTBroker) [
availabilityTopic="ems-esp/status",
payloadAvailable="online",
payloadNotAvailable="offline"
] {
Channels:
Type number : TxFails "EMS-Sendefehler" [stateTopic="ems-esp/heartbeat", transformationPattern="JSONPATH:$.txfails"]
Type number : NrgTotal "Wärmeenergie" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.nrgtotal", unit="kWh"]
Type number : NrgWwTotal "Wärmeenergie WW" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.dhw.nrg", unit="kWh"]
Type number : NrgHeatingTotal "Wärmeenergie Heizung" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.nrgheat", unit="kWh"]
Type number : MeterTotal "Elektr. Energie" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.metertotal", unit="kWh"]
Type number : PowerCons "Elektr. Leistung" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.hpcurrpower", unit="W"]
Type number : NrgConsHeatingTotal "Elektr. Energie Heizung" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.meterheat", unit="kWh"]
Type number : NrgConsWarmWaterTotal "Elektr. Energie WW" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.dhw.meter", unit="kWh"]
Type number : Modulation "Modulation" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.curburnpow"]
Type number : OutdoorTemp "Außentemperatur" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.outdoortemp", unit="°C"]
Type number : SelectedFlowTemp "Geplanter Vorlauf" [stateTopic="ems-esp/thermostat_data", transformationPattern="JSONPATH:$.hc1.targetflowtemp", unit="°C"]
Type number : CurrFlowTemp "Vorlauf" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.curflowtemp", unit="°C"]
Type number : ReturnTemp "Rücklauf" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.rettemp", unit="°C"]
Type number : CarrierReturn "TC0" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.hptc0", unit="°C"]
Type number : CarrierForward "TC1" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.hptc1", unit="°C"]
Type number : CondenserTemp "TC3" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.hptc3", unit="°C"]
Type number : CompressorTemp "TR1" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.hptr1", unit="°C"]
Type number : CondenserReturnTemp "TR3" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.hptr3", unit="°C"]
Type number : EvaporatorTemp "TR5" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.hptr5", unit="°C"]
Type number : EvaporatorReturnTemp "TR4" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.hptr4", unit="°C"]
Type number : AirInletTemp "Lufteintritt TL2" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.hptl2", unit="°C"]
Type number : CurrWarmWaterTemp "WW-Temperatur" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.dhw.curtemp", unit="°C"]
Type number : RoomSetpointTemp "Raumsolltemperatur" [stateTopic="ems-esp/thermostat_data", transformationPattern="JSONPATH:$.hc1.seltemp", unit="°C"]
Type string : HeatingActive "Heizung aktiv" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.heatingactive"]
Type string : WarmWaterActive "Warmwasser aktiv" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.tapwateractive"]
Type string : EmergencyOps "Notbetrieb" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.emergencyops"]
Type string : WarmWaterMode "Warmwassermodus" [stateTopic="ems-esp/thermostat_data", transformationPattern="JSONPATH:$.dhw.mode"]
Type number : PC0Flow "PC0 Volumenstrom" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.pc0flow", unit="l/h"]
Type number : PC1Flow "PC1 Volumenstrom" [stateTopic="ems-esp/boiler_data", transformationPattern="JSONPATH:$.pc1flow", unit="l/h"]
}
Items und Einheiten
Speichert die folgenden Items als items/heating.items.
Die Channel-IDs müssen zu den Namen im MQTT-Thing passen.
Energiezähler verwenden Number:Energy mit kWh, die elektrische Leistung Number:Power mit W und Temperaturen Number:Temperature mit °C.
Für die Volumenströme ist der Typ Number:VolumetricFlowRate mit l/h vorgesehen.
Einzelheiten erklärt die OpenHAB-Dokumentation zu Einheiten.
items/heating.items
Number HP_TxFails "EMS-Sendefehler [%.0f]" {channel="mqtt:topic:emsesp:TxFails"}
Number:Energy HP_NrgTotal "Wärmeenergie [%.1f kWh]" {channel="mqtt:topic:emsesp:NrgTotal", unit="kWh"}
Number:Energy HP_NrgWwTotal "Wärmeenergie WW [%.1f kWh]" {channel="mqtt:topic:emsesp:NrgWwTotal", unit="kWh"}
Number:Energy HP_NrgHeatingTotal "Wärmeenergie Heizung [%.1f kWh]" {channel="mqtt:topic:emsesp:NrgHeatingTotal", unit="kWh"}
Number:Energy HP_MeterTotal "Elektr. Energie [%.1f kWh]" {channel="mqtt:topic:emsesp:MeterTotal", unit="kWh"}
Number:Power HP_PowerCons "Elektr. Leistung [%.0f W]" {channel="mqtt:topic:emsesp:PowerCons", unit="W"}
Number:Energy HP_NrgConsHeatingTotal "Elektr. Energie Heizung [%.1f kWh]" {channel="mqtt:topic:emsesp:NrgConsHeatingTotal", unit="kWh"}
Number:Energy HP_NrgConsWarmWaterTotal "Elektr. Energie WW [%.1f kWh]" {channel="mqtt:topic:emsesp:NrgConsWarmWaterTotal", unit="kWh"}
Number HP_Modulation "Modulation [%.1f %%]" {channel="mqtt:topic:emsesp:Modulation"}
Number:Temperature HP_OutdoorTemp "Außentemperatur [%.1f °C]" {channel="mqtt:topic:emsesp:OutdoorTemp", unit="°C"}
Number:Temperature HP_SelectFlowTemp "Geplanter Vorlauf [%.1f °C]" {channel="mqtt:topic:emsesp:SelectedFlowTemp", unit="°C"}
Number:Temperature HP_CurrFlowTemp "Vorlauf [%.1f °C]" {channel="mqtt:topic:emsesp:CurrFlowTemp", unit="°C"}
Number:Temperature HP_ReturnTemp "Rücklauf [%.1f °C]" {channel="mqtt:topic:emsesp:ReturnTemp", unit="°C"}
Number:Temperature HP_CarrierReturn "TC0 [%.1f °C]" {channel="mqtt:topic:emsesp:CarrierReturn", unit="°C"}
Number:Temperature HP_CarrierForward "TC1 [%.1f °C]" {channel="mqtt:topic:emsesp:CarrierForward", unit="°C"}
Number:Temperature HP_CondenserTemp "TC3 [%.1f °C]" {channel="mqtt:topic:emsesp:CondenserTemp", unit="°C"}
Number:Temperature HP_CompressorTemp "TR1 [%.1f °C]" {channel="mqtt:topic:emsesp:CompressorTemp", unit="°C"}
Number:Temperature HP_CondenserReturnTemp "TR3 [%.1f °C]" {channel="mqtt:topic:emsesp:CondenserReturnTemp", unit="°C"}
Number:Temperature HP_EvaporatorTemp "TR5 [%.1f °C]" {channel="mqtt:topic:emsesp:EvaporatorTemp", unit="°C"}
Number:Temperature HP_EvaporatorReturnTemp "TR4 [%.1f °C]" {channel="mqtt:topic:emsesp:EvaporatorReturnTemp", unit="°C"}
Number:Temperature HP_AirInletTemp "Lufteintritt TL2 [%.1f °C]" {channel="mqtt:topic:emsesp:AirInletTemp", unit="°C"}
Number:Temperature HP_CurrWarmWaterTemp "WW-Temperatur [%.1f °C]" {channel="mqtt:topic:emsesp:CurrWarmWaterTemp", unit="°C"}
Number:Temperature HP_RoomSetpointTemp "Raumsolltemperatur [%.1f °C]" {channel="mqtt:topic:emsesp:RoomSetpointTemp", unit="°C"}
String HP_HeatingActive "Heizungbetrieb [%s]" {channel="mqtt:topic:emsesp:HeatingActive"}
String HP_WarmWaterActive "Warmwasserbereitung [%s]" {channel="mqtt:topic:emsesp:WarmWaterActive"}
String HP_WarmWaterMode "Warmwassermodus [%s]" {channel="mqtt:topic:emsesp:WarmWaterMode"}
String HP_EmergencyOps "Notbetrieb [%s]" {channel="mqtt:topic:emsesp:EmergencyOps"}
Number:VolumetricFlowRate HP_PC0Flow "PC0 Volumenstrom [%.0f l/h]" {channel="mqtt:topic:emsesp:PC0Flow", unit="l/h"}
Number:VolumetricFlowRate HP_PC1Flow "PC1 Volumenstrom [%.0f l/h]" {channel="mqtt:topic:emsesp:PC1Flow", unit="l/h"}
Number HP_AZTotal "Arbeitszahl gesamt [%.2f]"
Number HP_AZHeating "Arbeitszahl Heizung [%.2f]"
Number HP_AZWarmWater "Arbeitszahl Warmwasser [%.2f]"
Die Statuswerte bleiben String-Items und zeigen die von EMS-ESP gelieferten Texte, beispielsweise on oder off.
Die Modulation ist eine Zahl; %% im Anzeigetext stellt das Prozentzeichen dar.
Arbeitszahlen berechnen
Die Arbeitszahl ist der Quotient aus erzeugter Wärmeenergie und eingesetzter elektrischer Energie.
Beispielsweise ergeben 10.000 kWh / 2.500 kWh eine Arbeitszahl von 4,00.
Für die drei Bereiche verwenden wir diese Zählerpaare:
| Bereich | Wärmeenergie | Elektrische Energie | Berechnetes Item |
|---|---|---|---|
| Gesamt | HP_NrgTotal |
HP_MeterTotal |
HP_AZTotal |
| Heizung | HP_NrgHeatingTotal |
HP_NrgConsHeatingTotal |
HP_AZHeating |
| Warmwasser | HP_NrgWwTotal |
HP_NrgConsWarmWaterTotal |
HP_AZWarmWater |
Die drei Arbeitszahl-Items sind im obigen Beispiel für items/heating.items bereits enthalten und haben keine Channel-Bindung.
Die Energie-Items dienen weiterhin als Berechnungsgrundlage.
Die Arbeitszahlen beziehen sich auf die gesamte in den Zählern erfasste Laufzeit.
Für die Arbeitszahl eines bestimmten Tages, Monats oder Jahres müsstet ihr stattdessen die Energiedifferenzen dieses Zeitraums verwenden.
Speichert die folgende Rules-DSL-Regel als rules/heating.rules.
Sie berechnet die Arbeitszahlen beim Start beziehungsweise Laden der Regel und bei Änderungen der sechs Energie-Items neu.
Beide Energiewerte werden vor der Division in kWh umgerechnet.
Bei fehlenden Messwerten oder einem elektrischen Energieeinsatz von 0 wird das betreffende Arbeitszahl-Item auf UNDEF gesetzt.
rules/heating.rules
import org.openhab.core.library.types.QuantityType
rule "Arbeitszahlen der Waermepumpe berechnen"
when
Item HP_NrgTotal changed or
Item HP_MeterTotal changed or
Item HP_NrgHeatingTotal changed or
Item HP_NrgConsHeatingTotal changed or
Item HP_NrgWwTotal changed or
Item HP_NrgConsWarmWaterTotal changed
then
// Gesamt: Energiezähler zuerst auf dieselbe Einheit bringen.
val waermeGesamt = HP_NrgTotal.state
val stromGesamt = HP_MeterTotal.state
if (waermeGesamt instanceof QuantityType && stromGesamt instanceof QuantityType) {
val q = (waermeGesamt as QuantityType<?>).toUnit("kWh").doubleValue
val p = (stromGesamt as QuantityType<?>).toUnit("kWh").doubleValue
if (q >= 0 && p > 0) {
HP_AZTotal.postUpdate(q / p)
} else {
HP_AZTotal.postUpdate(UNDEF)
}
} else {
HP_AZTotal.postUpdate(UNDEF)
}
// Heizen: Energiezähler zuerst auf dieselbe Einheit bringen.
val waermeHeizen = HP_NrgHeatingTotal.state
val stromHeizen = HP_NrgConsHeatingTotal.state
if (waermeHeizen instanceof QuantityType && stromHeizen instanceof QuantityType) {
val q = (waermeHeizen as QuantityType<?>).toUnit("kWh").doubleValue
val p = (stromHeizen as QuantityType<?>).toUnit("kWh").doubleValue
if (q >= 0 && p > 0) {
HP_AZHeating.postUpdate(q / p)
} else {
HP_AZHeating.postUpdate(UNDEF)
}
} else {
HP_AZHeating.postUpdate(UNDEF)
}
// Warmwasser: Energiezähler zuerst auf dieselbe Einheit bringen.
val waermeWarmwasser = HP_NrgWwTotal.state
val stromWarmwasser = HP_NrgConsWarmWaterTotal.state
if (waermeWarmwasser instanceof QuantityType && stromWarmwasser instanceof QuantityType) {
val q = (waermeWarmwasser as QuantityType<?>).toUnit("kWh").doubleValue
val p = (stromWarmwasser as QuantityType<?>).toUnit("kWh").doubleValue
if (q >= 0 && p > 0) {
HP_AZWarmWater.postUpdate(q / p)
} else {
HP_AZWarmWater.postUpdate(UNDEF)
}
} else {
HP_AZWarmWater.postUpdate(UNDEF)
}
end
Sitemap für die Heizung
Speichert das Beispiel als sitemaps/heating.sitemap.
OpenHAB verwendet für diese textbasierte Oberfläche die Endung .sitemap.
Wenn ihr bereits eine Sitemap habt, könnt ihr den äußeren Frame in deren sitemap-Block übernehmen.
Die Sitemap-Dokumentation beschreibt die verfügbaren Elemente.
sitemaps/heating.sitemap
sitemap heating label="Heizung" {
Frame label="Wärmepumpe" {
Text item=HP_CurrWarmWaterTemp label="Warmwassertemperatur [%.1f °C]" icon="temperature" {
Frame label="Temperaturen und Betrieb" {
Text item=HP_RoomSetpointTemp
Text item=HP_SelectFlowTemp
Text item=HP_CurrFlowTemp
Text item=HP_ReturnTemp
Text item=HP_Modulation label="Modulation [%s %%]"
Text item=HP_AirInletTemp label="WP-Außentemperatur [%.1f °C]"
Text item=HP_PowerCons label="Leistungsaufnahme [%.0f W]"
Text item=HP_PC0Flow
Text item=HP_PC1Flow
Text item=HP_HeatingActive
Text item=HP_WarmWaterActive
Text item=HP_EmergencyOps
Text item=HP_WarmWaterMode
}
Frame label="Arbeitszahlen" {
Text item=HP_AZTotal
Text item=HP_AZHeating
Text item=HP_AZWarmWater
}
}
}
}
Der Eintrag für die Warmwassertemperatur öffnet eine Detailseite mit Betriebswerten und den drei Arbeitszahlen.