This project lets you use an ESP32 device with a CAN interface to interact with the Zehnder ComfoAir Q ventilation unit. Tested with:
It exposes all known information and airflow control through the ESPHome native API, and allows you to integrate the unit in Home Assistant as depicted below:
You can find the configuration YAML files in the docs
folder.
Untested but might also work on an ESP8266 with an MCP2551 (untested).
Needs at least ESPHome 2022.5.0 (since it depends on some CAN bus component updates).
See specific guides for each device:
Copy and rename secrets.yaml.example
to secrets.yaml
and update it with your WiFi credentials (wifi_ssid
and wifi_password
).
Build the image with ESPHome
make compile
make upload
By default the project builds for the AtomS3 board. To change your board, you can specify the
BOARD
parameter. For example for the Olimex ESP32-EVB:make compile BOARD=esp32-evb make upload BOARD=esp32-evb
Now when you go to the Home Assistant “Integrations” screen (under “Configuration” panel), you should see the ESPHome device show up in the discovered section (although this can take up to 5 minutes). Alternatively, you can manually add the device by clicking “CONFIGURE” on the ESPHome integration and entering “
Optional: for the ventilation card with the arrows, see docs/home-assistant/example-picture-elements-card.yaml
Based on the original repo: https://github.com/felixstorm/esphome-custom-components
Inspired by
A lot of this repo was inspired by the reverse engineering here.