Waterkotte heat pump with Resümat CD4

WKRCD4
Zweck / Funktion
Control / Extract information from Waterkotte Heat pumps with Resümat CD4 controller
Allgemein
Typ	Contrib
Details
Dokumentation	Thema
Support (Forum)	Sonstiges
Modulname	98_WKRCD4.pm
Ersteller	StefanStrobel (Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

WKRCD4 allows to control / communicate with older heat pumps from Waterkotte that have a control unit called Resümat CD4 with an RS232 serial interface. Newer heat pumps from Waterkotte typically have a modbus interface that can be controlled with module ModbusAttr.
CD4 control units with software version 7000, 8000 or 8011 can be controlled with another version of the WKRCD4 module.

Availability

The module has been checked in to the contrib area.

Prerequisites

This module requires Device::SerialPort or Win32::SerialPort module. Make sure to set "Modem-Klingelzeichen" and "Fremdzugriff" to the lowest possible value.

Define

define <name> WKRCD4 <devicename@speed> <Interval>

The module connects to the heat pump through a serial interface and actively requests data from the heat pump every <Interval> seconds

Example:

define WP WKRCD4 /dev/dualser0@9600 60
attr WP stateFormat Status
attr WP event-min-interval .*:3600
attr WP event-on-change-reading .*

Configuration of the module

Apart from the serial interface and the interval there is nothing that needs to be defined.

Get-Commands

There are only two parameters for which an explicit GET has been implemented. Most values are just readings that are automatically requested:

Hzg-TempBasisSoll
WW-Temp-Soll

Set-Commands

There is only one parameter that can be changed:

Hzg-TempBasisSoll

Supported readings

The module extracts the following readings from the heat pump:

Versions-Nummer       
Temp-Aussen           
Temp-Ruecklauf-Soll   
Temp-Ruecklauf        
Temp-Vorlauf          
Temp-WW-Soll          
Temp-WW               
Temp-Raum             
Temp-WQuelle-Ein      
Temp-WQuelle-Aus      
Temp-Verdampfer       
Temp-Kondensator      
Temp-Saugleitung      
Druck-Verdampfer      
Druck-Kondensator     
Hzg-TempEinsatz       
Hzg-TempBasisSoll     
Hzg-KlSteilheit       
Hzg-KlBegrenz         
Hzg-TempRlSoll        
Hzg-TempRlIst         
Hzg-TmpRaumSoll       
Hzg-RaumEinfluss      
Hzg-ExtAnhebung       
Hzg-Zeit-Ein          
Hzg-Zeit-Aus          
Hzg-AnhebungEin       
Hzg-AnhebungAus       
Hzg-St2Begrenz        
Hzg-Hysterese         
Hzg-PumpenNachl       
Klg-Abschaltung       
Klg-Temp-Einsatz      
Klg-TeBasisSoll       
Klg-KlSteilheit       
Klg-KlBegrenz         
Klg-KlSollwert        
Klg-Temp-Rl           
Ww-Abschaltung        
Ww-Zeit-Ein           
Ww-Zeit-Aus           
Ww-Temp-Ist           
Ww-Temp-Soll          
Ww-Hysterese          
Uhrzeit               
Datum                 
BetrStundenKompressor 
BetrStundenHzgPu      
BetrStundenWwPu       
BetrStundenSt2        
Zeit                  
SetBetriebsMode       
Display-Zeile-1       
Display-Zeile-2       
Status-Gesamt         
Status-Heizung        
Status-Kuehlung       
Mode-Heizung          
Mode-Kuehlung         
Mode-Warmwasser       
Heizung               
Kuehlung              
Warmwasser  

Attributes

do_not_notify

...

readingFnAttributes

...