Home Assistant integration for Zehnder ComfoAir serial controlled ventilation systems via RS232 serial connection and MQTT. While the scripts has been developed using the protocol description for Zehnder ComfoAir devices, it should also be compatible with largely similar systems from other manufacturers, such as StorkAir WHR930, Wernig G90-380, and Paul Santos 370 DC. It has also undergone successful testing on a ComfoAir 350.
It is not compatible with the newer ComfoAir Q series or Aeris Next models as they use a different communication standard.
This work is based on scripts created for Domoticz integration https://github.com/AlbertHakvoort/StorkAir-Zehnder-WHR-930-Domoticz-MQTT
src/ca350.py - python script to communicate with the Comfoair unit via serial port, publish data on MQTT broker and react to control messages
src/config.ini.dist - sample configuration file. Needs to be renamed to config.ini and customized
rc.d/ca350 - rc.d script to set up the service in FreeNAS jail virtual python environment
Dockerfile- Dockerfile to create and build the container
docker-compose.yml - Docker-Compose script for easy use
If you want to install the software as Docker Container, in Home Assistant Operating System (HAOS) or on FreeBSD based systems (like TrueNAS), please have a look here:
https://github.com/adorobis/hacomfoairmqtt/wiki
| Configuration Name | Description |
|---|---|
| SerialPort | The Serialport to the Comfoair on the Host Linux Machine. Examples: /dev/ttyUSB0 or /dev/cuau3 |
| MQTTServer | IP Adress to your MQTT Server, may be different to the HA Server |
| MQTTPort | Port of your MQTT Server. Default: 1833 |
| MQTTKeepalive | MQTT Keepalive Settings. Default: 45 |
| MQTTUser | MQTT User, if you enabled authorization on your MQTT Server. Default: False (no authentication) |
| MQTTPassword | MQTT User Password, if you enabled authorization on your MQTT Server. Default: False (no authentication) |
| refresh_interval | Refresh Interval in Seconds. Default: 10 |
| enablePcMode | Automaticly enable PC Mode (disable comfosense). Default: False (disabled) |
| RS485_protocol | Enable RS485 protocol, if false RSS232 is used Default: False (RS232) |
| debug | Enable Debug Output. Default: False (disabled) |
If you are using MQTT in Home Assistant, you will probably have the Auto Discovery enabled by default.k The MQTT AD implementation is expected to run with the prefix "homeassistant/".
| Configuration Name | Description |
|---|---|
| HAEnableAutoDiscoverySensors | Enable Home Assistant Auto Discovery |
| HAAutoDiscoveryDeviceId | Unique ID to use for Home Assistant Device Discovery |
| HAAutoDiscoveryDeviceName | Device name to show in the Home Assistant frontend |
| HAAutoDiscoveryDeviceManufacturer | Device manufacturer to show in the Home Assistant frontend |
| HAAutoDiscoveryDeviceModel | Device model to show in the Home Assistant frontend |
If you enable Autodiscovery in this Service, you will get following entities:
The entity id consists of the HAAutoDiscoveryDeviceName and the Entity Name.
| Entity Type | Entity Name | Unit | Description |
|---|---|---|---|
| sensor | Analog sensor 1 | % | Analog reading for accesories, eg: Comfosense CO2 sensor |
| sensor | Analog sensor 2 | % | Analog reading for accesories, eg: Comfosense CO2 sensor |
| sensor | Analog sensor 3 | % | Analog reading for accesories, eg: Comfosense CO2 sensor |
| sensor | Analog sensor 4 | % | Analog reading for accesories, eg: Comfosense CO2 sensor |
| sensor | Bypass valve | % | Bypass valve value: 0 % = Closed, 100 % = Open |
| sensor | Return air level | % | Fan level for exhaust fan |
| sensor | Supply air level | % | Fan level for supply fan |
| sensor | Exhaust fan speed | rpm | Fan rotation speed for exhaust fan |
| sensor | Supply fan speed | rpm | Fan rotation speed for supply fan |
| sensor | Outside temperature | °C | Air temperature from outside |
| sensor | Supply temperature | °C | Air temperature supplied to the house |
| sensor | Return temperature | °C | Air temperature extracted from the house |
| sensor | Exhaust temperature | °C | Air temperature going outside |
| sensor | Summer mode | Current climate mode: Summer means cooling via bypass at nighttime, Winter means bypass always closed |
|
| sensor | Filter hours | h | Filter hours counter |
| number | Filter weeks | weeks | Configuration for filter weeks, possible values from 1 to 26, appears as "number" entity type in HA |
| button | Reset filter | Button entity type to reset filter status | |
| binary_sensor | Summer mode | Current climate mode: On means cooling via bypass at nighttime, Off means bypass always closed |
|
| binary_sensor | Preheating status | Whether the unit is preheating the air before it enters the heat exchanger. | |
| binary_sensor | Bypass valve | State of the bypass valve | |
| binary_sensor | Filter status | Whether or not the air filters need cleaning / replacing | |
| sensor | EWT Temperature | °C | EWT Temperature (geothermal heat exchanger) |
| number | EWT Lower Set Temperature | °C | EWT Lower Set Temperature control |
| number | EWT Upper Set Temperature | °C | EWT Upper Set Temperature control |
| number | EWT speed up | % | EWT speed up control |
Adding the Comfoair as an HAVC makes sense, since it has a temperature control and a fan.
| Entity Name | Description |
|---|---|
| climate.ca350_climate | Expose Comfort Temperature Control & Fan Control |
The following Lovelace widgets depend on the MQTT AD enities and can be used with this service:
- https://github.com/TimWeyand/lovelace-comfoair
- https://github.com/mweimerskirch/lovelace-hacomfoairmqtt
- Modify the Repo so Home Assistant could also integrate this as "offical" AddOn from the UI
- Move container image from Ubuntu to Alpine Linux to reduce footprint
- Create installation script for automatic installation of the script
- venv
- [x dependencies and the service.
- Installation description for Debian based Linux Systems
- Full Control in Home Assistant with a single Widget (Fan Speed, Temperature)
- React on input immediatly - Still Read on Interval Status
- Implement set_fan_levels() based on values from MQTT (e.g. input_numbers in HA) to set the fan levels for all modes. Also enables setting intake or exhaust fans only as in original controller.
Troubleshooting If you encounter any issues during the setup process, please refer to the official documentation for Docker, Docker Compose, MQTT and Homeassistant.
Contributions Contributions to improve and expand this repository are welcome. Feel free to fork the repository, make your changes, and submit a pull request.