Looking MQTT Version?

If you need to install the MQTT version just browse this repo with tag last-mqtt.

Comfoair Q 350 ESPHome bridge

This software script let you use a ESP32 + CAN Transceiver to interact with the Comfoair Q 350 unit.

It does expose all known informations through ESPHOME and let you control the air flow via Home Assistant as well.

It does allow you to integrate the unit on Home Assistant as depicted below:

Custom PCB

Inside the docs/pcb folder you can find both gerber file and BOM. Files are provided as is. It's up to you to check data and schematic correctness.

This repository is meant to be working with the custom pcb above. But you can always buy components separately such as Waveshare SN65HVD230 and a voltage regulator as well as an ESP32 of your choice and it will work.

The pcb will look like this once soldered and mounted.

DIY

Prerequisites for custom build:

ESP32 -> link
DC-DC converter -> link
RJ45 Female -> link
Can Transceiver -> Waveshare SN65HVD230

Some ethernet cable

Here a simple schematic. made by @mat3u

---------------+        +---------------+                 +-------------+
(oran/red)12V  o--------o IN+      OUT+ o-----------------o VIN         |
               |        |   [LM2596S]   |                 |             |
(brown)   GND  o--------o IN-      OUT- o-----------------o GND         |
               |        +---------------+                 |             |
    [RJ45]     |                                          |   [ESP32]   |
  [ComfoAir]   |                                          |             |
               |        +-------------------------+       |             |
(w/blue) CAN_L o--------o CAN_L               3v3 o-------o 3v3         |
(blue)   CAN_H o--------o CAN_H               GND o-------o GND         |
---------------+        |                         |       |             |
                        |   [SN65HVD230]   CAN TX o-------o 25          |
                        |                  CAN RX o-------o 21          |
                        +-------------------------+       +-------------+

esphome conf

To include this repo use the external_components configuration like so:

# ...
external_components:
  - source: github://vekexasia/comfoair-esp32
    components: [ comfoair ]

comfoair:

# ...

Home Assistant Services

The component exposes 2 services.

comfoair_send_command
comfoair_send_hex

NOTE: the prefix could differ depending on your esphome device name.

comfoair_send_command: allows one "command" parameter. The value of the param can be one of the following pre-bundled commands:

ventilation_level_0
ventilation_level_1
ventilation_level_2
ventilation_level_3
boost_10_min
boost_20_min
boost_30_min
boost_60_min
boost_end
auto
manual
bypass_activate_1h
bypass_deactivate_1h
bypass_auto
ventilation_supply_only
ventilation_supply_only_reset
ventilation_extract_only
ventilation_extract_only_reset
temp_profile_normal
temp_profile_cool
temp_profile_warm

In case you need more flexibility you can use the comfoair_send_hex service like follows:

service: esphome.comfoair_send_hex
data:
  hexSequence: "8415070100000000100e000000"

^^ the above is equivalent to ventilation_extract_only (which has an inner timer of 1h)

Credits

A lot of this repo was inspired by the reverse engineering here. If you'd like to know more how the unit communicates, head over

There's also a Node.JS version with a Raspberry PI here

hsmade / comfoair-mcp2515