2021-04-27 22:23:32 +02:00
|
|
|
# EcoTouch Binding
|
|
|
|
|
|
|
|
|
|
The openHAB EcoTouch binding allows interaction with a [Waterkotte](https://www.waterkotte.de/) heat pump.
|
|
|
|
|
|
|
|
|
|
## Supported Things
|
|
|
|
|
|
|
|
|
|
| Thing type | Description |
|
|
|
|
|
|-----------------|--------------------------------------------------|
|
|
|
|
|
| geo | Waterkotte EcoTouch Geo + EcoVent |
|
|
|
|
|
| air | Waterkotte EcoTouch Air + EcoVent |
|
|
|
|
|
|
|
|
|
|
This binding was tested with a Waterkotte DS 5027 Ai DS 5010.5Ai geothermal heat pump.
|
|
|
|
|
|
|
|
|
|
## Discovery
|
|
|
|
|
|
|
|
|
|
Discovery is not supported. You need to provide the IP address of the display unit of the heatpump.
|
|
|
|
|
|
|
|
|
|
## Thing Configuration
|
|
|
|
|
|
|
|
|
|
Things can be fully configured via the UI. The following information is useful when configuring things via thing configuration files.
|
|
|
|
|
|
|
|
|
|
| Property | Type | Default | Required | Description |
|
|
|
|
|
|---------------------------------|---------|---------|----------|-------------|
|
|
|
|
|
| ip | String | | yes | IP address or hostname of the display unit of the heat pump |
|
|
|
|
|
| username | String | | yes | since software version 1.6.xx of the display unit: "waterkotte"; previously "admin". |
|
|
|
|
|
| password | String | | yes | since software version 1.6.xx of the display unit: "waterkotte"; previously "wtkadmin". |
|
|
|
|
|
| refresh | Integer | 60 | no | time in s after which all channels will be requested again from the heat pump |
|
|
|
|
|
|
|
|
|
|
## Channels
|
|
|
|
|
|
|
|
|
|
Standard channels:
|
|
|
|
|
|
|
|
|
|
| Channel ID | Type | Read-Only | Description |
|
|
|
|
|
|----------------------------|----------------------|-----------|-----------------------------------------------------------------|
|
|
|
|
|
| adapt_heating | Number:Temperature | no | Allows to adjust the heating temperature by an offset |
|
|
|
|
|
| alarm | Number:Dimensionless | yes | Alarm |
|
|
|
|
|
| cop_cooling | Number:Dimensionless | yes | COP Cooling |
|
|
|
|
|
| cop_heating | Number:Dimensionless | yes | COP Heating |
|
|
|
|
|
| enable_cooling | Switch | no | Enable Cooling |
|
|
|
|
|
| enable_heating | Switch | no | Enable Heating |
|
|
|
|
|
| enable_warmwater | Switch | no | Enable Warm Water |
|
|
|
|
|
| power_compressor | Number:Power | yes | Power Compressor |
|
|
|
|
|
| power_cooling | Number:Power | yes | Power Cooling |
|
|
|
|
|
| power_heating | Number:Power | yes | Power Heating |
|
|
|
|
|
| state_alarm | Switch | yes | State Alarm |
|
|
|
|
|
| temperature_cooling_return | Number:Temperature | yes | Temperature Cooling Return |
|
|
|
|
|
| temperature_cooling_set2 | Number:Temperature | no | Temperature Cooling Setpoint BMS |
|
|
|
|
|
| temperature_flow | Number:Temperature | yes | Temperature Flow |
|
|
|
|
|
| temperature_heating_return | Number:Temperature | yes | Temperature Heating Return |
|
|
|
|
|
| temperature_heating_set | Number:Temperature | yes | Temperature Heating Setpoint |
|
|
|
|
|
| temperature_outside | Number:Temperature | yes | The current outside temperature |
|
|
|
|
|
| temperature_outside_24h | Number:Temperature | yes | The outside temperature averaged over one day |
|
|
|
|
|
| temperature_return | Number:Temperature | yes | Temperature Return |
|
|
|
|
|
| temperature_return_set | Number:Temperature | yes | Temperature Return Setpoint |
|
|
|
|
|
| temperature_room | Number:Temperature | yes | Temperature Room |
|
|
|
|
|
| temperature_room_1h | Number:Temperature | yes | Temperature Room 1h Average |
|
|
|
|
|
| temperature_source_in | Number:Temperature | yes | Temperature Source Input |
|
|
|
|
|
| temperature_source_out | Number:Temperature | yes | Temperature Source Output |
|
|
|
|
|
| temperature_water | Number:Temperature | yes | Temperature Water |
|
|
|
|
|
| temperature_water_set2 | Number:Temperature | no | Temperature Water Setpoint BMS |
|
|
|
|
|
|
|
|
|
|
Advanced channels:
|
|
|
|
|
|
|
|
|
|
| Channel ID | Type | Read-Only | Description |
|
|
|
|
|
|----------------------------------|----------------------|-----------|-------------------------------------------------------------------------|
|
|
|
|
|
| compressor_power | Number:Dimensionless | yes | Percent Power Compressor |
|
2021-12-24 10:36:04 +01:00
|
|
|
| coolEnableTemp | Number:Temperature | no | Temperature Cooling Enable |
|
2021-04-27 22:23:32 +02:00
|
|
|
| date_day | Number:Dimensionless | yes | Day |
|
|
|
|
|
| date_month | Number:Dimensionless | yes | Month |
|
|
|
|
|
| date_year | Number:Dimensionless | yes | Year |
|
|
|
|
|
| enable_pool | Switch | no | Enable Pool |
|
|
|
|
|
| enable_pv | Switch | no | Enable PV |
|
|
|
|
|
| hysteresis_heating | Number:Temperature | no | Hysteresis Heating |
|
2024-06-02 14:48:20 +02:00
|
|
|
| hysteresis_warmwater | Number:Temperature | no | Hysteresis Warm Water |
|
2021-04-27 22:23:32 +02:00
|
|
|
| interruptions | Number:Dimensionless | yes | Interruptions |
|
|
|
|
|
| manual_4wayvalve | Number:Dimensionless | no | Operating Mode 4Way Valve |
|
|
|
|
|
| manual_coolvalve | Number:Dimensionless | no | Operating Mode Cooling Valve |
|
|
|
|
|
| manual_heatingpump | Number:Dimensionless | no | Operating Mode Heating Pump |
|
|
|
|
|
| manual_multiext | Number:Dimensionless | no | Operating Mode Multi Ouput Ext |
|
|
|
|
|
| manual_poolvalve | Number:Dimensionless | no | Operating Mode Pool Valve |
|
|
|
|
|
| manual_solarpump1 | Number:Dimensionless | no | Operating Mode Solar Pump |
|
|
|
|
|
| manual_solarpump2 | Number:Dimensionless | no | Operating Mode Solar Pump 2 |
|
|
|
|
|
| manual_sourcepump | Number:Dimensionless | no | Operating Mode Source Pump |
|
|
|
|
|
| manual_tankpump | Number:Dimensionless | no | Operating Mode Tank Pump |
|
|
|
|
|
| manual_valve | Number:Dimensionless | no | Operating Mode Valve |
|
|
|
|
|
| maxVLTemp | Number:Temperature | yes | maxVLTemp |
|
|
|
|
|
| nviHeizkreisNorm | Number:Temperature | no | nviHeizkreisNorm |
|
|
|
|
|
| nviNormAussen | Number:Temperature | no | nviNormAussen |
|
2021-12-24 10:36:04 +01:00
|
|
|
| nviSollKuehlen | Number:Temperature | no | nviSollKuehlen |
|
2021-04-27 22:23:32 +02:00
|
|
|
| nviTHeizgrenze | Number:Temperature | no | nviTHeizgrenze |
|
|
|
|
|
| nviTHeizgrenzeSoll | Number:Temperature | no | nviTHeizgrenze Setpoint |
|
|
|
|
|
| operating_hours_circulation_pump | Number:Time | yes | Operating Hours Circulation Pump |
|
|
|
|
|
| operating_hours_compressor1 | Number:Time | yes | Operating Hours Compressor 1 |
|
|
|
|
|
| operating_hours_compressor2 | Number:Time | yes | Operating Hours Compressor 2 |
|
|
|
|
|
| operating_hours_solar | Number:Time | yes | Operating Hours Solar |
|
|
|
|
|
| operating_hours_source_pump | Number:Time | yes | Operating Hours Source Pump |
|
|
|
|
|
| percent_compressor | Number:Dimensionless | yes | Percent Compressor |
|
|
|
|
|
| percent_heat_circ_pump | Number:Dimensionless | yes | Percent Heating Circulation Pump |
|
|
|
|
|
| percent_source_pump | Number:Dimensionless | yes | Percent Source Pump |
|
|
|
|
|
| position_expansion_valve | Number:Dimensionless | yes | Position Expansion Valve |
|
|
|
|
|
| pressure_condensation | Number:Pressure | yes | Pressure Condensation |
|
|
|
|
|
| pressure_evaporation | Number:Pressure | yes | Pressure Evaporation |
|
|
|
|
|
| state | Number:Dimensionless | yes | A Bitfield which encodes the state of all valves, pumps and compressors |
|
|
|
|
|
| state_compressor1 | Switch | yes | State Compressor 1 |
|
|
|
|
|
| state_compressor2 | Switch | yes | State Compressor 2 |
|
|
|
|
|
| state_cooling | Switch | yes | State Cooling |
|
|
|
|
|
| state_cooling4way | Switch | yes | State Cooling4Way |
|
|
|
|
|
| state_evd | Switch | yes | State EVD |
|
|
|
|
|
| state_extheater | Switch | yes | State External Heater |
|
|
|
|
|
| state_heatingpump | Switch | yes | State Heating Pump |
|
|
|
|
|
| state_pool | Switch | yes | State Pool |
|
|
|
|
|
| state_service | Switch | yes | State Service Mode |
|
|
|
|
|
| state_solar | Switch | yes | State Solar |
|
|
|
|
|
| state_sourcepump | Switch | yes | State Source Pump |
|
|
|
|
|
| state_water | Switch | yes | State Water |
|
|
|
|
|
| tempSet0Deg | Number:Temperature | yes | Heating Setpoint at 0°C Outside |
|
|
|
|
|
| tempchange_cooling_pv | Number:Temperature | no | Temperature Change Cooling if PV |
|
|
|
|
|
| tempchange_heating_pv | Number:Temperature | no | Temperature Change Heating if PV |
|
|
|
|
|
| tempchange_pool_pv | Number:Temperature | no | Temperature Change Pool if PV |
|
|
|
|
|
| tempchange_warmwater_pv | Number:Temperature | no | Temperature Change Water if PV |
|
|
|
|
|
| temperature2_outside_1h | Number:Temperature | yes | Temperature Outside 1h Average |
|
|
|
|
|
| temperature_condensation | Number:Temperature | yes | Temperature Condensation |
|
|
|
|
|
| temperature_cooling_set | Number:Temperature | yes | Temperature Cooling Setpoint |
|
|
|
|
|
| temperature_evaporation | Number:Temperature | yes | Temperature Evaporation |
|
|
|
|
|
| temperature_heating_set2 | Number:Temperature | no | Temperature Heating Setpoint BMS |
|
|
|
|
|
| temperature_outside_1h | Number:Temperature | yes | The outside temperature averaged over one hour |
|
|
|
|
|
| temperature_pool | Number:Temperature | yes | Temperature Pool |
|
|
|
|
|
| temperature_pool_set | Number:Temperature | yes | Temperature Pool Setpoint |
|
|
|
|
|
| temperature_pool_set2 | Number:Temperature | no | Temperature Pool Setpoint BMS |
|
|
|
|
|
| temperature_solar | Number:Temperature | yes | Temperature Solar |
|
|
|
|
|
| temperature_solar_flow | Number:Temperature | yes | Temperature Solar Flow |
|
|
|
|
|
| temperature_storage | Number:Temperature | yes | Temperature Storage |
|
|
|
|
|
| temperature_suction | Number:Temperature | yes | Temperature Suction |
|
|
|
|
|
| temperature_water_set | Number:Temperature | yes | Temperature Water Setpoint |
|
2024-03-04 18:58:40 +01:00
|
|
|
| percent_water_limit_min | Number:Dimensionless | no | Percent Water Power limit Min |
|
|
|
|
|
| percent_water_limit_max | Number:Dimensionless | no | Percent Water Power limit Max |
|
|
|
|
|
| percent_heating_limit_min | Number:Dimensionless | no | Percent Heating Power limit Min |
|
|
|
|
|
| percent_heating_limit_max | Number:Dimensionless | no | Percent Heating Power limit Min |
|
2021-04-27 22:23:32 +02:00
|
|
|
| time_hour | Number:Dimensionless | yes | Hour |
|
|
|
|
|
| time_minute | Number:Dimensionless | yes | Minute |
|
|
|
|
|
| version_bios | Number:Dimensionless | yes | Version BIOS |
|
|
|
|
|
| version_controller | Number:Dimensionless | yes | Version Display Controller |
|
|
|
|
|
| version_controller_build | Number:Dimensionless | yes | Build Number Display Controller |
|
|
|
|
|
|
|
|
|
|
If the Ecovent Unit is attached to the heat pump, the following additional channels are available:
|
|
|
|
|
|
|
|
|
|
| Channel ID | Type | Read-Only | Description |
|
|
|
|
|
|----------------------------|----------------------|-----------|-------------|
|
|
|
|
|
| ecovent_CO2_value | Number:Dimensionless | yes | EcoVent CO2 |
|
|
|
|
|
| ecovent_mode | Number:Dimensionless | no | EcoVent Mode (0..5: Day, Night, Timer, Party, Vacation, Bypass) |
|
|
|
|
|
| ecovent_moisture_value | Number:Dimensionless | yes | EcoVent Air Moisture |
|
|
|
|
|
| ecovent_output_y1 | Number:Dimensionless | yes | EcoVent Fan |
|
|
|
|
|
| ecovent_temp_exhaust_air | Number:Temperature | yes | EcoVent Temperature Exhaust Air |
|
|
|
|
|
| ecovent_temp_exit_air | Number:Temperature | yes | EcoVent Temperature Exit Air |
|
|
|
|
|
| ecovent_temp_outdoor_air | Number:Temperature | yes | EcoVent Temperature Outdoor Air |
|
|
|
|
|
| ecovent_temp_supply_air | Number:Temperature | yes | EcoVent Temperature Supply Air |
|
|
|
|
|
|
|
|
|
|
The air heatpump has the following additional channels:
|
|
|
|
|
|
|
|
|
|
| Channel ID | Type | Read-Only | Description |
|
|
|
|
|
|-------------------------|--------------------|-----------|-------------------------|
|
|
|
|
|
| temperature_suction_air | Number:Temperature | yes | Temperature Suction Air |
|
|
|
|
|
| temperature_sump | Number:Temperature | yes | Temperature Sump |
|
|
|
|
|
| temperature_surrounding | Number:Temperature | yes | Temperature Surrounding |
|
|
|
|
|
|
|
|
|
|
## Example
|
|
|
|
|
|
|
|
|
|
### ecotouch.things
|
|
|
|
|
|
2022-12-07 21:09:32 +01:00
|
|
|
```java
|
2021-04-27 22:23:32 +02:00
|
|
|
Thing ecotouch:geo:heatpump "Waterkotte Heatpump" @ "basement" [ ip="192.168.1.100", username="admin", password="wtkadmin", refresh=120 ]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### ecotouch.items
|
|
|
|
|
|
2022-12-07 21:09:32 +01:00
|
|
|
```java
|
2021-04-27 22:23:32 +02:00
|
|
|
Number:Temperature HeatPump_Temp_Aussen { channel="ecotouch:geo:heatpump:temperature_outside" }
|
|
|
|
|
Number:Temperature HeatPump_Temp_Aussen_1d { channel="ecotouch:geo:heatpump:temperature_outside_24h" }
|
|
|
|
|
Number:Temperature HeatPump_Temp_Quelle_in { channel="ecotouch:geo:heatpump:temperature_source_in" }
|
|
|
|
|
Number:Temperature HeatPump_Temp_Quelle_out { channel="ecotouch:geo:heatpump:temperature_source_out" }
|
|
|
|
|
Number:Temperature HeatPump_Temp_Wasser { channel="ecotouch:geo:heatpump:temperature_water" }
|
|
|
|
|
Number:Temperature HeatPump_Temp_Heizen { channel="ecotouch:geo:heatpump:temperature_heating_return" }
|
|
|
|
|
Number:Power HeatPump_power_el { channel="ecotouch:geo:heatpump:power_compressor" }
|
|
|
|
|
Number:Power HeatPump_power_th { channel="ecotouch:geo:heatpump:power_heating" }
|
|
|
|
|
Number HeatPump_COP_heating { channel="ecotouch:geo:heatpump:cop_heating" }
|
|
|
|
|
Number:Temperature HeatPump_adaptHeating { channel="ecotouch:geo:heatpump:adapt_heating" }
|
2021-12-24 10:36:04 +01:00
|
|
|
Switch HeatPump_state_sourcepump { channel="ecotouch:geo:heatpump:state_sourcepump" }
|
2021-04-27 22:23:32 +02:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### ecotouch.sitemap
|
|
|
|
|
|
2022-12-07 21:09:32 +01:00
|
|
|
```perl
|
2021-04-27 22:23:32 +02:00
|
|
|
sitemap ecotouch label="Waterkotte EcoTouch"
|
|
|
|
|
{
|
|
|
|
|
Text item=HeatPump_Temp_Aussen
|
|
|
|
|
Text item=HeatPump_Temp_Aussen_1d
|
|
|
|
|
Text item=HeatPump_Temp_Quelle_in
|
|
|
|
|
Text item=HeatPump_Temp_Quelle_out
|
|
|
|
|
Text item=HeatPump_Temp_Wasser
|
|
|
|
|
Text item=HeatPump_Temp_Heizen
|
|
|
|
|
Text item=HeatPump_Temp_Heizen
|
|
|
|
|
Text item=HeatPump_power_th
|
|
|
|
|
Text item=HeatPump_COP_heating
|
|
|
|
|
Setpoint item=HeatPump_adaptHeating minValue=-2.0 maxValue=2.0 step=0.5
|
|
|
|
|
}
|
|
|
|
|
```
|
2021-12-24 10:36:04 +01:00
|
|
|
|
|
|
|
|
A snippet to show the current state of the heatpump (you need to have the corresponding items in your .items-file):
|
|
|
|
|
|
2022-12-07 21:09:32 +01:00
|
|
|
```java
|
2021-12-24 10:36:04 +01:00
|
|
|
Text label="State" icon="settings" {
|
|
|
|
|
Text item=HeatPump_state_sourcepump label="State Source Pump [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
Text item=HeatPump_state_heatingpump label="State Heating Pump [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
Text item=HeatPump_state_evd label="State EVD [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
Text item=HeatPump_state_compressor1 label="State Compressor 1 [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
Text item=HeatPump_state_extheater label="State External Heater [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
Text item=HeatPump_state_alarm label="State Alarm [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
Text item=HeatPump_state_cooling label="State Cooling [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
Text item=HeatPump_state_water label="State Water [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
Text item=HeatPump_state_pool label="State Pool [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
Text item=HeatPump_state_solar label="State Solar [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
Text item=HeatPump_state_cooling4way label="State Cooling4Way [%s]" valuecolor=[==ON="green", ==OFF="red"]
|
|
|
|
|
}
|
|
|
|
|
```
|
