Home Assistant integration for ComfoAir (*) devices via serial communication and MQTT
*It is not compatible with the newer Q 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
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. 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
- Create installation script for automatic installation of the script
- venv
- 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.
Any help welcome!
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent