ComfoAir

ComfoAir
Zweck / Funktion
Extract information and control the ventilation devices ComfoAir from Zehnder, WHR930 from StorkAir, G90-380 from Wernig and Santos 370 DC from Paul
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Sonstiges
Modulname	98_ComfoAir.pm
Ersteller	StefanStrobel (Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

The ComfoAir module communicates with ComfoAir ventilation systems from Zehnder, especially the ComfoAir 350 (CA350) connected via serial line to the fhem computer.

Many other ventilation systems use the same communication device and protocol, e.g. WHR930 from StorkAir, G90-380 from Wernig and Santos 370 DC from Paul. They can be controlled with this module as well.

This module is based on the protocol description at http://www.see-solutions.de/sonstiges/Protokollbeschreibung_ComfoAir.pdf, fixes some small erorrs in this protocol description and copies some ideas from earlier modules for the same devices that were posted in the fhem forum from danhauck(Santos) and Joachim (WHR962).

The module can be used in two ways depending on how fhem and / or a vendor supplied remote control device like CC Ease or CC Luxe are connected to the system. If a remote control device is connected it is strongly advised that fhem does not send data to the ventilation system as well and only listens to the communication between the vendor equipment.

The RS232 interface used is not made to support more than two parties communicating and connecting fhem in parallel to a CC Ease or similar device can lead to collisions when sending data which can corrupt the ventilation system. If connected in parallel, fhem should only passively listen and <Interval> is to be set to 0. If no remote control device is connected to the ventilation systems then fhem has to take control and actively request data in the interval to be defined. Otherwiese fhem will not see any data. In this case fhem can also send commands to modify settings.

Availability

The module has been checked in

Prerequisites

This module requires the Device::SerialPort or Win32::SerialPort module.

Define

define <name> ComfoAir <device> <Interval>

The module connects to the ventilation system through the given serial device and either passively listens to data that is communicated between the ventialation system and its remote control device (e.g. CC Luxe) or it actively requests data from the ventilation system every <Interval> seconds

Example:

define ZL ComfoAir /dev/ttyUSB1@9600 60

Configuration of the module

apart from the serial connection and the interval which both are specified in the define command there are several attributes that can optionally be used to modify the behavior of the module. The module internally gives names to all the protocol messages that are defined in the module and these names can be used in attributes to define which requests are periodically sent to the ventilation device. The same names can also be used with set commands to manually send a request. Since all messages and readings are generically defined in a data structure in the module, it should be quite easy to add more protocol details if needed without programming.

The names currently defined are:

Bootloader-Version
Firmware-Version
RS232-Modus
Sensordaten
KonPlatine-Version
Verzoegerungen
Ventilation-Levels
Temperaturen
Betriebsstunden
Status-Bypass
Status-Vorheizung

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

poll-Bootloader-Version
poll-Firmware-Version
poll-RS232-Modus
poll-Sensordaten
poll-KonPlatine-Version
poll-Verzoegerungen
poll-Ventilation-Levels
poll-Temperaturen
poll-Betriebsstunden
poll-Status-Bypass
poll-Status-Vorheizung

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 Ventilation-Levels, Temperaturen and Status-Bypass are requested if no attributes are set.

Example:

define ZL ComfoAir /dev/ttyUSB1@9600 60
attr ZL poll-Status-Bypass 0
define FileLog_Lueftung FileLog ./log/Lueftung-%Y.log ZL

Set-Commands

like with the attributes mentioned above, set commands can be used to send a request for data manually. The following set options are available for this:

request-Status-Bypass 
request-Bootloader-Version 
request-Sensordaten
request-Temperaturen 
request-Firmware-Version 
request-KonPlatine-Version 
request-Ventilation-Levels 
request-Verzoegerungen 
request-Betriebsstunden 
request-Status-Vorheizung 

additionally important fields can be modified with set:

Temp_Komfort (target temperature for comfort)
Stufe (ventilation level)

Get-Commands

All readings that are derived from the responses to protocol requests 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 respective 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

Readings

The readings created by this module might look like this:

Attributes

do_not_notify

readingFnAttributes

poll-Bootloader-Version

poll-Firmware-Version

poll-RS232-Modus

poll-Sensordaten

poll-KonPlatine-Version

poll-Verzoegerungen

poll-Ventilation-Levels

poll-Temperaturen

poll-Betriebsstunden

poll-Status-Bypass

poll-Status-Vorheizung

if any of these attributes are set to 1 the module includes a request for the data belonging to the named group when sending requests every <interval> seconds

hide-Bootloader-Version

hide-Firmware-Version

hide-RS232-Modus

hide-Sensordaten

hide-KonPlatine-Version

hide-Verzoegerungen

hide-Ventilation-Levels

hide-Temperaturen

hide-Betriebsstunden

hide-Status-Bypass

hide-Status-Vorheizung

if set to 1 the module prevents readings of the named group from being created even if used passively without polling and an external remote control requests this data. Please note that this attribute doesn't delete already existing readings.

queueDelay

modify the delay used when sending requests to the device from the internal queue, defaults to 1 second

queueMax

max length of the send queue, defaults to 50

timeout

set the timeout for reads, defaults to 2 seconds