Skip to content

Waterkotte EcoTouch Heat Pump Binding

Digitalvitamin edited this page Dec 6, 2016 · 5 revisions

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.

outside temperature

power consumption

Further planned features (not yet implemented)

  • add some more <eventType>

feature overview

Installation

Setup intro

Linux and OS X

Windows

FreeBSD


Configuration

Automation*

User Interfaces

Persistence


Community

(link to openHAB forum)

Development


Bindings


Application Integration

Misc


Samples

A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Binding configurations

Use case examples

Item definition examples

Sitemap definition examples

Collections of Rules on a single page

Single Rules

Scripts

Syntax highlighting for external editors


Release Notes

Clone this wiki locally
You can’t perform that action at this time.