This page is part of archived documentation for openHAB 4.1. Go to the current stable version

# evohome Binding

This binding integrates the Honeywell evohome system. It uses your Honeywell Total Connect Comfort account to access your locations and heating zones.

# Supported Things

The binding supports the following things:

  • evohome Account
  • evotouch control display
  • Heating zones

# evohome Account

This thing functions as the bridge between all the other things. It contains your credentials and connects to the Honeywell web API.

# evotouch

This thing represents the central display controller. It is used to view and change the current system mode.

# Heating zone

The heating zone thing represents the evohome heating zone. It displays the current temperature, the temperature set point and the status of the set point. It also allows you to permanently override the current temperature set point as well as canceling any active overrides.

# Discovery

After setting up the evohome account, the evotouch and heating zones available to your account will be discovered after a manual scan.

# Thing Configuration

Thing configuration is optional, it is easier to use discovery which will automatically add all your zones and displays to the inbox, once the account Thing is online.

# Account

Name Required Description
username yes The username of your TCC account
password yes The password of your TCC account
refreshInterval no The amount of time in seconds between updates (0-3000)

# Display & Zone

Name Required Description
id yes The id which can be found by auto-discovery or the response data (using TRACE logging)
name no A friendly name for use in the UI

# Channels

# Account

None

# Display

Channel Type ID Item Type Description
Mode String Allows to view or set the system mode. Supported values are: Auto, AutoWithEco, Away, DayOff, HeatingOff, Custom

# Zone

Channel Type ID Item Type Description
Temperature Number:Temperature Allows for viewing the current actual temperature of the zone.
SetPointStatus String Allows for viewing the current set point mode of the zone.
SetPoint Number:Temperature Allows for viewing and permanently overriding the temperature set point of the zone. Sending 0 cancels any active set point overrides.
                                                                                                                             |

# Full Example

# demo.things

Bridge evohome:account:your_account_alias [ username="your_user_name", password="your_password" ]
{
    display your_display_alias  [ id="1234" ]
    heatingzone your_zone_alias [ id="5678" ]
}

# demo.items

// evohome Display
String DemoMode                 { channel="evohome:display:your_account_alias:your_display_alias:SystemMode" }

// evohome Heatingzone
Number:Temperature DemoZoneTemperature  { channel="evohome:heatingzone:your_account_alias:your_zone_alias:Temperature" }
String DemoZoneSetPointStatus           { channel="evohome:heatingzone:your_account_alias:your_zone_alias:SetPointStatus" }
Number:Temperature DemoZoneSetPoint     { channel="evohome:heatingzone:your_account_alias:your_zone_alias:SetPoint" }

# demo.sitemap

sitemap evohome label="evohome Menu"
{
    Frame label="evohome display" {
        Selection label="[%s]" item=DemoMode mappings=[
          "Auto"="Normal",
          "AutoWithEco"="Eco",
          "Away"="Away",
          "DayOff"="Day Off",
          "HeatingOff"="Off",
          "Custom"="Custom"
        ]
    }

    Frame label="evohome heating zone" {
        Text     label="Temperature"      item=DemoZoneTemperature      
        Text     label="Status"           item=DemoZoneSetPointStatus   
        Setpoint label="Zone set point"   item=DemoZoneSetPoint minValue=5 maxValue=35 step=0.5
    }
}