Honeywell Evohome

With this app you can manage your Evohome and other systems that connect via Total Connect Comfort from within Homey. It is using the unofficial API of Evohome.

Supported devices

The following devices are known to work with the app:

Control systems:

• Evohome ( + gateway RFG100 )
• Evohome Wifi
• Round Wireless ( + gateway RFG100 )

Thermostats (always in combination with Control system)

• HR92

Not in the list? It still could be supported; as long as your thermostat can be controlled via the Total Connect Comfort app, it should be controllable by the Homey app. Feedback is appreciated, so I can adjust the list.

Settings

After installing the application, first visit the Homey Settings and navigate to the 'Honeywell Evohome' application.

Fill in your username (email address) and password and press save. Then, go to Devices and add a Honeywell Evohome device. Press thermostat and select which devices you'd like to add into Homey.

Flow support

Triggers

• When temperature changes: triggers a flow when temperature changes
  • Via device card: individual temperature changes
  • Via Evohome card: any temperature measurement changes
• When target temperature changes: triggers a flow when the target temperature setting changes
  • Via device card: individual target temperature settings changes

Conditions

No conditions defined at this moment

Actions

• Set temperature ; this will set the individual temperature on a device. Attention: there is no way yet to cancel this setting other than setting another temperature or using the Evohome app/system.

• Reset temperature: Cancel individual device setting

• Cancel all adjustments: Cancel all individual thermostat settings

• Execute QuickAction ; these are the generic settings of your Evohome. You can choose between:

  • Auto: this is the normal mode, Evohome will follow the set program
  • Economy: this is the economy mode, normally 3 degrees lower than Auto
  • Heating Off: This will turn your heating off ( with a lower limit of 7 degrees to protect the system from freezing )
  • Away: This will set the Evohome system to Away mode
  • Day Off: This will set the Evohome system to 'Day off' mode
  • Custom: This will set the Evohome system to 'Custom' mode; whatever you configured in Evohome itself

• Execute QuickAction (manual entry); with this card you can enter the quickaction yourself. This is usefull if you have stored a quickaction value in a variable in Homey, this can be used e.g. to restore a previous setting. e.g. door open, set quickaction for heating off, then when door closes, set quickaction with variable where the previous status was stored (e.g. Auto).

All actions are currently on 'permanent' mode. In the future there might be timers (e.g. set Economy for two hours). If you need that now, using the Homey built in-timers or the CountDown app to trigger a timed event.

Acknowledgement

Initial scripting (based on HC2) provided by Webster Icons provided by Webster & Reflow Additional information by various sources on Internet

Donate

If you like the app, consider a donation to support development

Limitations

Although multiple locations are supported, the quickaction works only on the first location. This is work in progress.

ToDo in order of my priority (donate to change priority ;-) )

• Add multiple location support for quickactions
• Cancel all adjustments in an intelligent way to limit calls to Honeywell
• Add target temperature triggers
• Low battery detection
• Add hot water device support
• Check when heating mode is changing ( e.g. following schedule , permament, etc)
• Clean-up code
• Time limits on quick Actions
• Time limits on temperature heatSetpoint
• Add timeout to code if Evohome service doesn't respond
• Add error checking in code
• Translation to NL

Known bugs

In order of priority:

• When access token of Honeywell expires, the first login might give an error when reading status. Unsure if this also affects when updating; statistically changes are higher with the 5 minute interval. That's probably why I only see it during the regular_update.

Unknown bugs

Yes ;-)

Changelog

• V3.0.0 2020-02-10 : Rewrite to include multiple locations
• V2.2.0 2019-04-02 : Added Evohome quickaction global token to be used in logic
• V2.1.9 2019-02-23 : Display login failures at start-up in timeline
• V2.1.7 2019-02-21 : Bugfix permanent quickaction (spotted by WillyBits)
• V2.1.6 2019-02-17 : New action card: QuickAction with temporary override
• V2.1.5 2019-02-15 : New quickaction: Auto with Reset (forces all zones to follow schedule), new card: temporary zone temperature
• V2.1.3 2019-02-12 : Fixed adding devices bug; Fixed deleted devices warnings in log
• V2.1.2 2019-02-11 : New action card: cancel all manual adjustments. All zones will follow schedule again.
• V2.1.1 2019-02-08 : Pairing includes authentication check. BUG: All devices are added, you cannot choose anymore.
• V2.1.0 2019-02-08 : New authentication code, fixed set manual and reset temp procedures, various bugfixes
• V2.0.5 2019-02-07 : Bugfix for zone_data crash
• V2.0.3 2019-01-17 : Bugfix for V2.0.1 ; not handling all cases, rewrite login procedure
• V2.0.2 2019-01-16 : Bugfixes, target setting via device card immediately visible in app
• V2.0.1 2019-01-15 : Bugfix when not having any devices
• V2.0.0 2019-01-15 : SDK2 enabled
• V1.0.6 2019-02-15 : Add supported devices in README
• V1.0.5 2017-11-21 : Evohome tag of temperature bugfix (number instead of string)
• V1.0.4 2017-09-05 : Ignore hot water devices in thermostat driver
• V1.0.3 2017-09-04 : Ignore reading of 128 degrees of thermostats (128 = controller received no input from thermostat)
• V1.0.2 2016-12-11 : Fixed bug in action card to use tokens for manual input
• V1.0.1 2016-12-05 : Action card to manually set the temperature instead of a slider
• V1.0.0 2016-11-19 : Quick Action setting and triggering working again
• V0.4.9 2016-11-16 : Bugfix for target_temperature reporting when setting the temperature via Homey. There is a maximum 5 minute delay before it shows in the device card and insight logging
• V0.4.8 2016-11-07 : Added target_temperature logging
• V0.4.7 2016-10-21 : Correct 'cancel temperature' implementation
• V0.4.6 2016-08-04 : Disabled quickaction checking due to API change
• V0.4.5 2016-07-22 : Removed some logging that cluttered the logging in settings
• V0.4.3 2016-06-15 : Solved 'first-run' bug
• V0.4.2 2016-06-14 : extra trigger & action cards, fixed bugs, first code clean-up
• V0.4.1 2016-06-09 : release for app store
• V0.3.6 2016-06-07 : insights logging added, pairing bugs solved
• V0.3.1 2016-06-05 : Second test release, including pairing of thermostats
• V0.0.1 2016-05-28 : First test release on Github