Waterkotte EcoTouch Heat Pump Binding

Documentation of the Waterkotte EcoTouch heat pump binding bundle.

Introduction

For installation of the binding, please see Wiki page Bindings.

Precondition

This bundle connects to your heat pump via network. Make sure the display unit of your heat pump is connected to your network and that the network settings are configured. By default, the heat pump uses DHCP.

login data for openhab.cfg:
(current / since Display-Software 1.6.xx): ecotouch:ip= ecotouch:username=waterkotte ecotouch:password=waterkotte (previous, until Display-Software 1.5.xx): ecotouch:username=admin, ecotouch:password=wtkadmin

Generic Item Binding Configuration

The binding configurations format is simple and looks like this:

ecotouch="<eventType>"

where <eventType> is one of the following values:

description	<eventType>	itemClass	write	notes
Außentemperatur	temperature_outside	number
Außentemperatur gemittelt über 1h	temperature_outside_1h	number
Außentemperatur gemittelt über 24h	temperature_outside_24h	number
Quelleneintrittstemperatur	temperature_source_in	number
Quellenaustrittstemperatur	temperature_source_out	number
Verdampfungstemperatur	temperature_evaporation	number
Sauggastemperatur	temperature_suction	number
Verdampfungsdruck	pressure_evaporation	number
Temperatur Rücklauf Soll	temperature_return_set	number
Temperatur Rücklauf	temperature_return	number
Temperatur Vorlauf	temperature_flow	number
Kondensationstemperatur	temperature_condensation	number
Kondensationsdruck	pressure_condensation	number
Speichertemperatur	temperature_storage	number
Raumtemperatur	temperature_room	number
Raumtemperatur gemittelt über 1h	temperature_room_1h	number
Warmwassertemperatur	temperature_water	number
Pooltemperatur	temperature_pool	number
Solarkollektortemperatur	temperature_solar	number
Solarkreis Vorlauf	temperature_solar_flow	number
Ventilöffnung elektrisches Expansionsventil %	position_expansion_valve	number
elektrische Leistung Verdichter	power_compressor	number
abgegebene thermische Heizleistung der Wärmepumpe	power_heating	number
abgegebene thermische KälteLeistung der Wärmepumpe	power_cooling	number
COP Heizleistung	cop_heating	number
COP Kälteleistung	cop_cooling	number
Aktuelle Heizkreistemperatur	temperature_heating_return	number
Geforderte Temperatur im Heizbetrieb	temperature_heating_set	number
Sollwertvorgabe Heizkreistemperatur	temperature_heating_set2	number	yes
Aktuelle Kühlkreistemperatur	temperature_cooling_return	number
Geforderte Temperatur im Kühlbetrieb	temperature_cooling_set	number
Sollwertvorgabe Kühlbetrieb	temperature_cooling_set2	number	yes
Sollwert Warmwassertemperatur	temperature_water_set	number
Sollwertvorgabe Warmwassertemperatur	temperature_water_set2	number	yes
Sollwert Poolwassertemperatur	temperature_pool_set	number
Sollwertvorgabe Poolwassertemperatur	temperature_pool_set2	number	yes
geforderte Verdichterleistung	compressor_power	number
% Heizungsumwälzpumpe	percent_heat_circ_pump	number
% Quellenpumpe	percent_source_pump	number
% Leistung Verdichter	percent_compressor	number
Heizkurve - Norm-Aussen-Temp (Auslegungstemp)	nviNormAussen	number	yes
Heizkurve - Temp Heizkreis bei Auslegungstemp	nviHeizkreisNorm	number	yes
Heizkurve - Temp Heizgrenze	nviTHeizgrenze	number	yes
Heizkurve - Temp Heizkreis Heizgrenze	nviTHeizgrenzeSoll	number	yes
Heizkurve - max. VL-Temp	maxVLTemp	number	yes
Kühlen Einschalt-Aussentemp	coolEnableTemp	number	yes
geforderte Kühltemperatur	nviSollKuehlen	number
Firmware-Version Regler	version_controller	number
Build-Nr. Regler	version_controller_build	number
Bios-Version Regler	version_bios	number
Datum: Tag	date_day	number
Datum: Monat	date_month	number
Datum: Jahr	date_year	number
Uhrzeit: Stunde	time_hour	number
Uhrzeit: Minute	time_minute	number
Betriebsstunden Verdichter 1	operating_hours_compressor1	number
Betriebsstunden Verdichter 2	operating_hours_compressor2	number
Betriebsstunden Heizungsumwälzpumpe	operating_hours_circulation_pump	number
Betriebsstunden Quellenpumpe	operating_hours_source_pump	number
Betriebsstunden Solarkreis	operating_hours_solar	number
Handabschaltung Heizbetrieb	enable_heating	switch	yes
Handabschaltung Kühlbetrieb	enable_cooling	switch	yes
Handabschaltung Warmwasserbetrieb	enable_warmwater	switch	yes
Handabschaltung Pool_Heizbetrieb	enable_pool	switch	yes
Status der Wärmepumpenkomponenten	state	number
Status Quellenpumpe	state_sourcepump	switch
Status Heizungsumwälzpumpe	state_heatingpump	switch
Status Freigabe Regelung EDV / Magnetventil	state_evd	switch
Status Verdichter 1	state_compressor1	switch
Status Verdichter 2	state_compressor2	switch
Status externer Wärmeerzeuger	state_extheater	switch
Status Alarmausgang	state_alarm	switch
Status Motorventil Kühlbetrieb	state_cooling	switch
Status Motorventil Warmwasser	state_water	switch
Status Motorventil Pool	state_pool	switch
Status Solarbetrieb	state_solar	switch
Status 4-Wege-Ventil	state_cooling4way	switch
Temperaturanpassung für die Heizung -2,0 / +2,0	adapt_heating	number	yes	-2 bis +2 (0,5)---> 0 bis 8
Handschaltung Heizungspumpe	manual_heatingpump		yes	(H-0-A) H= manuell ein (Handschaltung), 0= aus, A= Automatik
Handschaltung Quellenpumpe	manual_sourcepump		yes	(H-0-A)
Handschaltung Solarpumpe 1	manual_solarpump1		yes	(H-0-A)
Handschaltung Solarpumpe 2	manual_solarpump2		yes	(H-0-A)
Handschaltung Speicherladepumpe	manual_tankpump		yes	(H-0-A)
Handschaltung Brauchwasserventil	manual_valve		yes	(H-0-A)
Handschaltung Poolventil	manual_poolvalve		yes	(H-0-A)
Handschaltung Kühlventil	manual_coolvalve		yes	(H-0-A)
Handschaltung Vierwegeventil	manual_4wayvalve		yes	(H-0-A)
Handschaltung Multiausgang Ext.	manual_multiext		yes	(H-0-A)

As a result, your lines in the items file might look like the following:

/* Waterkotte EcoTouch heat pump DEMO */
Group Heatpump
Group Heatpump_outside
Group Heatpump_source
Group Heatpump_control
Group Heatpump_water
Group Heatpump_heating
Group Heatpump_power
Group Heatpump_state
Number Chart_Period "Chart Period"
Number HeatPump_Temperature_3   "Wärmepumpe Außentemperatur [%.1f °C]"   <temperature> (Heatpump,Heatpump_outside) { ecotouch="temperature_outside" }
Number HeatPump_Temperature_4   "Wärmepumpe Außentemperatur 1h [%.1f °C]"   <temperature> (Heatpump,Heatpump_outside) { ecotouch="temperature_outside_1h" }
Number HeatPump_Temperature_5   "Wärmepumpe Außentemperatur 24h [%.1f °C]"   <temperature> (Heatpump,Heatpump_outside) { ecotouch="temperature_outside_24h" }
Number HeatPump_Temperature_6   "Wärmepumpe Quelleneintrittstemperatur [%.1f °C]"   <temperature> (Heatpump,Heatpump_source) { ecotouch="temperature_source_in" }
Number HeatPump_Temperature_7   "Wärmepumpe Quellenaustrittstemperatur [%.1f °C]"   <temperature> (Heatpump,Heatpump_source) { ecotouch="temperature_source_out" }
Number HeatPump_Temperature_8   "Wärmepumpe Vorlauf [%.1f °C]"   <temperature> (Heatpump,Heatpump_control) { ecotouch="temperature_flow" }
Number HeatPump_Temperature_9   "Wärmepumpe Rücklauf [%.1f °C]"   <temperature> (Heatpump,Heatpump_control) { ecotouch="temperature_return" }
Number HeatPump_Temperature_10   "Wärmepumpe Rücklauf Soll [%.1f °C]"   <temperature> (Heatpump,Heatpump_control) { ecotouch="temperature_return_set" }
Number HeatPump_Temperature_11   "Wärmepumpe Warmwasser Ist [%.1f °C]"   <temperature> (Heatpump,Heatpump_water) { ecotouch="temperature_water" }
Number HeatPump_Temperature_12   "Wärmepumpe Warmwasser Soll [%.1f °C]"   <temperature> (Heatpump,Heatpump_water) { ecotouch="temperature_water_set" }
Number HeatPump_Temperature_13   "Wärmepumpe Warmwasser Soll2 [%.1f °C]"   <temperature> (Heatpump,Heatpump_water) { ecotouch="temperature_water_set2" }
Number HeatPump_Temperature_14   "Wärmepumpe Heizung Ist [%.1f °C]"   <temperature> (Heatpump,Heatpump_heating) { ecotouch="temperature_heating_return" }
Number HeatPump_Temperature_15   "Wärmepumpe Heizung Soll [%.1f °C]"   <temperature> (Heatpump,Heatpump_heating) { ecotouch="temperature_heating_set" }
Number HeatPump_Temperature_16   "Wärmepumpe Heizung Soll2 [%.1f °C]"   <temperature> (Heatpump,Heatpump_heating) { ecotouch="temperature_heating_set2" }
Number HeatPump_power_1   "Wärmepumpe elektrische Leistung [%.1f kW]"   <energy> (Heatpump,Heatpump_power) { ecotouch="power_compressor" }
Number HeatPump_power_2   "Wärmepumpe thermische Leistung [%.1f kW]"   <energy> (Heatpump,Heatpump_power) { ecotouch="power_heating" }
Number HeatPump_state            "Wärmepumpe Status [%i]"   <settings> (Heatpump) { ecotouch="state" }
Number HeatPump_state_sourcepump "Wärmepumpe Status Quellenpumpe [%i]"   <settings> (Heatpump,Heatpump_state) { ecotouch="state_sourcepump" }
Number HeatPump_state_heatingpump "Wärmepumpe Status Heizungsumwälzpumpe [%i]"   <settings> (Heatpump,Heatpump_state) { ecotouch="state_heatingpump" }
Number HeatPump_state_compressor1 "Wärmepumpe Status Kompressor [%i]"   <settings> (Heatpump,Heatpump_state) { ecotouch="state_compressor1" }
Number HeatPump_state_water      "Wärmepumpe Status Motorventil Warmwasser[%i]"   <settings> (Heatpump,Heatpump_state) { ecotouch="state_water" }

Sitemap Example

    Frame label="Waterkotte" {
            Text item=HeatPump_Temperature_3 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_outside period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_outside period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_outside period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_6 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_source period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_source period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_source period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_7 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_source period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_source period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_source period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_8 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_control period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_control period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_control period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_9 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_control period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_control period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_control period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_10 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_control period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_control period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_control period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_11 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_water period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_water period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_water period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_12 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_water period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_water period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_water period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_13 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_water period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_water period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_water period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_14 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_heating period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_heating period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_heating period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_15 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_heating period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_heating period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_heating period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_Temperature_16 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_heating period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_heating period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_heating period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_power_1 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_power period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_power period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_power period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
            Text item=HeatPump_power_2 {
                    Frame {
                            Switch item=Chart_Period label="Chart Period" mappings=[0="Hour", 1="Day", 2="Week"]
                            Chart item=Heatpump_power period=h refresh=60000 visibility=[Chart_Period==0, Chart_Period=="Uninitialized"]
                            Chart item=Heatpump_power period=D refresh=60000 visibility=[Chart_Period==1]
                            Chart item=Heatpump_power period=W refresh=60000 visibility=[Chart_Period==2]
                    }
            }
    }

Gallery

The following charts are created via the rrd4j chart and heatpump bundle.

Further planned features (not yet implemented)

• add some more <eventType>