ModbusSET

ModbusSET
Zweck / Funktion
Control / Extract information from SET Silent Pool Heat pumps
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Sonstiges
Modulname	98_ModbusSET.pm
Ersteller	StefanStrobel (Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

ModbusSET allows to control / communicate with Silent 10 pool heat pumps from Schmidt Energie Technik (SET). These heat pumps provide a Modbus interface over RS485. The module probably works with other heat pumps from SET as well and since the control device used in these heat pumps is an iChill IC121 from Dixell, it could even work for other heat pumps with this controller as well or with few changes. It defines the modbus holding registers for the temperature sensors and reads them in a defined interval.

The module can also be used as a programming example for the usage of the base Modbus module.

Availability

The module has been checked in

Prerequisites

This module requires the basic Modbus module which itsef requires Device::SerialPort or Win32::SerialPort module.

Define

define <name> ModbusSET <Id> <Interval>

The module connects to the heat pump with Modbus Id <Id> through an already defined modbus device and actively requests data from the heat pump every <Interval> seconds

Example:

define WP ModbusSET 1 60

Configuration of the module

apart from the modbus id and the interval which both are specified in the define command there is nothing that needs to be defined. However there are some attributes that can optionally be used to modify the behavior of the module.

The attributes that control which messages are sent / which data is requested every <Interval> seconds are:

poll-Hyst_Mode
poll-Temp_Luft
poll-Temp_Wasser_Aus_Off
poll-Temp_Wasser_Ein_Off
poll-Temp_Wasser_Aus
poll-Hysterese
poll-Temp_Wasser_Ein
poll-Temp_Soll
poll-Temp_Luft_Off
poll-Temp_Verdampfer
poll-Temp_Verdampfer_Off

if the attribute is set to 1, the corresponding data is requested every <Interval> seconds. If it is set to 0, then the data is not requested.

by default the temperatures are requested if no attributes are set. if some readings should be polled, but less frequently than the normal interval, you can specify a pollDelay-Attribute for the reading. The pollDelay attribute allows to poll objects at a lower rate than the interval specified in the define command. you can either specify a time in seconds or number prefixed by "x" which means a multiple of the interval of the define command. if you specify a normal number then it is interpreted as minimal time between the last read and another automatic read. Please note that this does not create an individual interval timer. Instead the normal interval timer defined by the interval of the define command will check if this reading is due or not yet. So the effective interval will always be a multiple of the interval of the define.

Example:

define WP ModbusSET 1 60
attr WP poll-Temp_Soll 0
attr WP pollDelay-Hysterese 300

Set-Commands

The following set options are available:

Hysterese (defines the hysterese in Kelvin)
Hyst_Mode (defines the interpretation of hysterese for the heating and can be set to mittig, oberhalb or unterhalb)
Temp_Wasser_Aus_Off (offset of sensor in Kelvin - used to kalibrate)
Temp_Wasser_Ein_Off (offset of sensor in Kelvin - used to kalibrate)
Temp_Luft_Off (offset of sensor in Kelvin - used to kalibrate)
Temp_Verdampfer_Off (offset of sensor in Kelvin - used to kalibrate)
Temp_Soll (target temperature of the heating pump)

Get-Commands

All readings are also available as Get commands. Internally a Get command triggers the corresponding request to the device and then interprets the data and returns the right field value. To avoid huge option lists in FHEMWEB, only the most important Get options are visible in FHEMWEB. However this can easily be changed since all the readings and protocol messages are internally defined in the modue in a data structure and to make a Reading visible as Get option only a little option (e.g. showget => 1 has to be added to this data structure

Attributes

do_not_notify

readingFnAttributes

poll-Hyst_Mode

poll-Temp_Luft

poll-Temp_Wasser_Aus_Off

poll-Temp_Wasser_Ein_Off

poll-Temp_Wasser_Aus

poll-Hysterese

poll-Temp_Wasser_Ein

poll-Temp_Soll

poll-Temp_Luft_Off

poll-Temp_Verdampfer

poll-Temp_Verdampfer_Off

include a read request for the corresponding registers when sending requests every interval seconds

pollDelay-*

set a delay for polling individual Readings. In case some readings should be polled less frequently than the normal delay specified during define. Specifying a pollDelay will not create an individual timer for polling this reading but check if the delay is over when the normal update interval is handled.

You can either specify a time in seconds or number prefixed by "x" which means a multiple of the interval of the define command. If you specify a normal numer then it is interpreted as minimal time between the last read and another automatic read. Please note that this does not create an individual interval timer. Instead the normal interval timer defined by the interval of the define command will check if this reading is due or not yet. So the effective interval will always be a multiple of the interval of the define.

dev-timing-timeout

set the timeout for reads, defaults to 2 seconds

dev-timing-minSendDelay

minimal delay between two requests sent to this device

dev-timing-minCommDelay

minimal delay between requests or receptions to/from this device