HomeAssistant integration of Zehnder ComfoClime (and all devices in ComfoNet bus like the ComfoAir Q)
ComfoClime is a HVAC solution as additional device for the ComfoAir Q series. It comes with its own app and an propietary JSON API. The ComfoClime unit is connected to the local network via WiFi/WLAN, the API is available only local via HTTP requests without authentication. The integration can also control the ventilation main unit ComfoAir Q. It currently offers:
- reading the dashboard data similar to the official app
- climate control entity with HVAC modes (heat/cool/fan_only/off) and preset modes (comfort/power/eco)
- reading and writing the active temperature profile
- setting the ventilation fan speed
- autodiscovering all connected devices
- property (r/w) and telemetry (r/o) values of all connected devices
- restarting the ComfoClime unit via service call
- configuration via config flow by host/ip
- locals in english and german
- add this repository via HACS (user defined repositories, URL:
https://github.com/msfuture/comfoclime) - install the "Zehnder ComfoClime" integration in HACS
- restart Home Assistant
- add the ComfoClime device (connected devices like the ComfoAir Q are detected and added automatically)
API documentation with practical Python examples:
- ComfoClimeAPI.md - Concise API reference with Python code examples
- Original documentation - Detailed reverse engineered API knowledge
- PDO Protocol - Telemetry sensor protocol
- RMI Protocol - Property access protocol
Feel free to extend!
The integration provides a comprehensive climate control entity that unifies all temperature and ventilation control features:
- Off: System standby mode
- Heat: Heating mode (automatically sets season to heating)
- Cool: Cooling mode (automatically sets season to cooling)
- Fan Only: Ventilation only mode (season set to transition)
- Comfort: Maximum comfort temperature profile
- Power: Power saving temperature profile
- Eco: Energy efficient temperature profile
- Set target temperature for heating (15-25°C) and cooling (20-28°C) seasons
- Current temperature display from indoor sensor
- Automatic temperature range adjustment based on active season
The climate entity automatically:
- Detects current season from ComfoClime dashboard
- Adjusts available temperature ranges accordingly
- Shows appropriate HVAC actions (heating/cooling/fan/idle)
- Manages system state based on fan activity
There are many more telemetry and property values, that make sense to be offered by the integration. The ComfoClime unit itself is fully integrated but there are some missing sensors, switches and numbers of the ComfoAirQ unit to be added in the future. You are missing one? The definitions are in seperate files in the entities folder, so you can try them yourself. If they are working you can open an issue or directly open a pull request.
Feel free to participate! 🙋♂️
@michaelarnauts and his integration of ComfoConnect, where I discovered a lot of telemetries and properties of the ventilation unit: https://github.com/michaelarnauts/aiocomfoconnect