hacomfoairmqtt

Home Assistant integration for ComfoAir 350 device via serial communication and MQTT This work is based on scripts created for Domoticz integration https://github.com/AlbertHakvoort/StorkAir-Zehnder-WHR-930-Domoticz-MQTT

configuration.yaml - sample entries for MQTT Fan integration device and service status binary_sensor

src/ca350 - python script to communicate with the CA350 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

servicetest.sh - simple script to test ca350 service status

File locations when installed on FreeNAS jail: Python script: /usr/local/share/ca350/bin Daemon config file: /usr/local/etc/rc.d/ca350

Installation instructions:

1. The following packages are needed: sudo pkg install python3-pip python3-yaml
2. Create directory for the application /usr/local/share/ca350/bin/ and copy src/ca350 script to it
3. Copy the src/config.ini.dist to /usr/local/share/ca350/bin/config.ini and update as required (serial port and MQTT server mainly)
4. Create virtual environment: python3 -m venv /usr/local/share/ca350/
5. install packages in the venv:

source /usr/local/share/ca350/bin/activate.csh
sudo pip3 install paho-mqtt pyserial
deactivate

6. Copy rc.d/ca350 script to the directory: /usr/local/etc/rc.d/
7. Enable the service: service ca350 enable
8. Start the service service ca350 start

Home Assistant Comfoair MQTT Configuration

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)

MQTT Auto Discovery Configutation:

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: HAEnableAutoDiscoverySensors = True

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

Configuration: HAEnableAutoDiscoveryClimate = False

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

HA Lovelace Widget:

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

TODO:

• 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!