Ecobee integration, detailed reporting for heatpumps (stages, aux-heat)

i got new forced-air heating systems in my house last year with new ecobee thermostats. at the time, i had the understanding that there was an ecobee integration for home-assistant, and assumed all would be well.

at some point in spring of 2024, ecobee apparently stopped letting people do the dev account signup that had previously been required to enable the integration. so the only way to get my systems connected to HA was to first connect them as homekit devices, then use homekit integration to bring them into HA.

that worked for me and i have basic functionality of viewing/controlling thermostats. however i can’t see or control the details of the current state of the system in terms of whether it is stage-1-heat, stage-2-heat, or aux-heat. instead i can only see basically on vs. off information.

i can view this information (at least the current real-time state) by actually looking at the thermostat. i can also see this info (and some limited amount of history) via the ecobee cloud (website). so i know that it is ā€œpossibleā€ to see and extract this data. this data is important in terms of monitoring and understanding system performance. having both visibility and control of this info (and related parameter settings like threshold temps) can be an important way that people can control/manage how much electricity they’re using. for my own needs, if i have an electrical outage and am running on generators, i’d like to be able to switch the system to use aux (gas) heat and not run the heat pumps, for example. i can’t do this with the limited access i get through HA.

does anyone know whether there might be plans to restore the ecobee integration at some point? will ecobee start offering dev access again at some point (as they apparently did previously)? anyone know whether there are any plans to improve the homekit support and add additional details like ability to see and control aux-heat?

Here’s a link to a document describing the Homekit Accessory Protocol (HAP).

Here’s the section describing the mandatory and optional features of HAP’s ā€œThermostat accessory objectā€.

HAP’s Thermostat accessory doesn’t support features like identifying and/or controlling heating/cooling stages, etc. Therefore Home Assistant’s Homekit Device integration cannot model the additional features of an Ecobee thermostat (or other manufacturer) via HAP’s Thermostat.

Perhaps it may be possible to model the additional features using other HAP accessories. For example, HAP has a Fan accessory which might be used to model the Ecobee’s fan control. However, I am not sufficiently familiar with HAP to know what could be used to define/control heating/cooling stages. Plus I don’t know if there are any ā€˜best practices’ that discourage modelling a physical device as multiple HAP accessories.

tl;dr
HAP only supports a basic set of thermostat features.


Although Ecobee thermostats do not support the Matter protocol, it serves as a useful comparison to HAP. This document describes version 1.2 of the Matter protocol and Matter’s Thermostat model appears to support more features than HAP. Perhaps if Ecobee ever supports Matter (pure speculation), it will become possible to expose more of its features via Home Assistant’s Matter integration.

1 Like