homebridge-tcc

This is a plugin for North America Honeywell Total Connect Comfort site. It is a partially-working implementation into HomeKit. This plugin is work in progress. Help is appreciated! Please note it does not work with the International Honeywell Total Connect Comfort site. Historical display of temperature data is available via HomeKit apps thats support graphing.

Devices Tested With

• RTH6580WF
• RTH8580WF
• RTH9580
• TH6320WF
• 9850
• MHK1

Installation

1. Install homebridge using: npm install -g homebridge
   
2. Install this plugin using npm install -g homebridge-tcc
3. Update your configuration file. See sample-config below for a sample.

Configuration Sample

"platforms": [
       {
            "platform": "tcc",
            "name" : "Thermostat",
            "username" : ".....",
            "password" : ".....",
            "devices" : [
                  {"deviceID": "1234567", "name": "Other Floor", "usePermanentHolds": true},
                  {"deviceID": "abcdefg", "name": "Main Floor", "usePermanentHolds": false}
          	]
        },
    ]

• platform: tcc
• name: can be anything you want
• username: your Honeywell e-mail
• password: your Honeywell password
• deviceID: Your honeywell deviceID Go to the Honeywell Total Connect Comfort website, log in and open your device. Now look in the address bar and you will see something like:

https://mytotalconnectcomfort.com/portal/Device/Control/1234567

The last part is your Device ID.

Optional settings

• refresh - Data polling interval in seconds, defaults to 60 seconds
• storage - Storage of chart graphing data for history graphing, either fs or googleDrive, defaults to fs
• usePermanentHolds - Place in the device block correlated with your thermostat. If set to true, temperature changes will be set as permanent holds, rather than temporary holds. This will allow you to use HomeKit automations to completely replace your thermostat's schedule. If set to false, the temperature changes will expire after a certain period of time and resume your normal schedule. By default, this is off.

Roadmap

• Need to add throttling around temperature changes

Notes

It seems to be vitally important to set the right system time, especially on raspi!

Credits

• luc-ass - Borrowed your homebridge-evohome plugin as a base to start from
• Dan / Ghostbit - Borrowed your python script for the page flow of the TCC website
• bwdeleeuw - Fahrenheit testing and other enhancements
• devbymike - Validation of RTH9580
• djsomi - Investigation into international TCC site
• gsulshski - Validation of TH6320WF
• l3nticular - Support for Mode 7
• simont77 - FakeGato History
• @hakusaro - Added support for permanent temperature holds.