skWare Honeywell WiFi Thermostat Plug-In for HomeSeer HS4

Terms & Conditions

Honeywell has chosen not to provide access to their API to anyone other than large businesses. As a result, this plugin uses the only way available to control these devices: the Total Connect™ Comfort Portal (TCCP). This means that if Honeywell changes their website, work will have to be done on this plugin to make it compatible, and that there is a chance the website changes could render it inoperable. These changes are done without my knowledge or control, and your purchase/use of this plug-in is as-is and at your own risk.

Furthermore, excessive activity on your account may result in your account being suspended, requiring you to call Honeywell and get it re-activated. While this plugin has been designed to minimize the chances of this occurring by implementing preventative measures such as queues, timers and minimum command, update and polling frequencies, these values can be changed by the user. Regardless of the values entered (be they the default, smaller or larger), by activating this plugin in your HomeSeer software, you acknowledge this risk and agree to indemnify and hold harmless the developer of this plugin, HomeSeer Technologies, and any other third party plugin developers from any damages (including but not limited to financial, time spent, opportunity cost, loss of account privileges, and the inability to control your thermostats or other connected devices).

Total Connect™ is a trademark of Honeywell International Inc.

Overview

The skWare Honeywell WiFi Thermostat Plug-In for HomeSeer provides you with a way to monitor and control your Honeywell Total Connect™ Comfort-controlled thermostat from HomeSeer.

The interface displays thermostat information including status, setpoints, current temperatures, and modes. For example, a thermostat named "First Floor" might show:

Controls are available to update setpoints ([+1], [-1]), change system mode (AUTO, COOL, HEAT, OFF), and manage fan settings (ON, AUTO, CIRCULATE). Hold types can also be managed (NONE, TEMPORARY, PERMANENT).

Installation

This Plug-In is installed using the built-in updater capability of HomeSeer. New installations include the binaries and supporting files needed to run the Plug-In, and updates will replace any of those items that have changed.

Before you set it up, you must create your account, login, and acknowledge any alerts or notifications on Honeywell's Total Connect Comfort website. It may be necessary to do this from time to time as changes are made to the site.

System Requirements

The skWare Honeywell WiFi Thermostat Plug-In for HomeSeer runs on both Windows and Linux installations of HS4 version 4.2.19.0 or higher.

• On Linux, this plug-in requires Mono 4.8.1 or higher.
• For Windows servers, it must be Vista or newer.

The following thermostats have been tested with this plug-in, but any thermostats controlled via the Honeywell Total Connect™ Comfort Portal (US-based models only at this time) may work. Please report back via the HomeSeer forums if you have success or problems with any specific model.

• RTH6580WF - Wi-Fi 7-Day Programmable Thermostat
• RTH9580WF - Wi-Fi Smart Thermostat
• THX9421R5021 - (Redesigned) Prestige 2.0 IAQ*
• THX9321R5000 - Prestige HD*
• THX9321R5030 - Prestige HD*
• TH8321R1001 - (All-New) RedLINK VisionPRO 8000*
• TH6320R1004 - FocusPRO® 6000 Wireless (programmable)*
• TH5320R1002 - FocusPRO® 5000 Wireless (non-programmable)*

*With a RedLINK Internet Gateway (THM6000R1002).

Configuration

After installing the Plug-In, a new “Honeywell WiFi Thermostat” menu item can be found under the “Plug-Ins" menu in the HomeSeer browser interface.

Initial Setup

When the plugin first starts, the “Initial Setup” menu item will guide you through the initial steps. After accepting the Terms & Conditions, you will be prompted to provide your My Total Connect Comfort Portal credentials. The setup process involves three steps: Step 1: Terms & Conditions, Step 2: Credentials (User, Password), and Step 3: Setup Complete.

Thermostat List

On the "Thermostat List" page, you can add or manage thermostats controlled by HomeSeer. Select thermostats from the list available on the Total Connect Comfort Portal. Click “Update List" if newly added thermostats are not shown. The list displays the assigned name in Honeywell and the corresponding HomeSeer root device name (which can be changed later).

Once thermostats are saved, you can edit the minimum and maximum allowed cool or heat settings for each device. These settings are specific to HomeSeer and do not override the thermostat's physical settings. Attempting to set values outside these limits in HomeSeer events will result in them being adjusted to the nearest allowed limit.

You can also select a thermostat and click "Remove" to delete its associated devices.

Settings

The “Settings” item under the “Honeywell WiFi Thermostat” menu allows for additional configuration options. Here you can update credentials, test the connection, and monitor authentication status. Frequent logins or rapid plugin restarts may temporarily block your account; wait a few minutes before restarting if this occurs.

The "Config" page controls plug-in behavior and logging output.

Account Options

This section allows for API key and secret input if you wish to use your own account credentials instead of the built-in shared API key. Using your own account is recommended for potentially avoiding rate limits.

• API Key (Optional)
• API Secret (Optional)
• Authorization Status: [RESET MY CONNECTION TO THE LYRIC SERVICES]

Thermostat Options

• Poll Interval: Specifies how often HomeSeer checks the website for current settings. A minimum of 300 seconds (5 minutes) is required.
• Update Frequency: Controls the minimum time between update requests (e.g., manual updates via button or script). A minimum of 15 seconds is required. Requests made faster will show a "Waiting for update..." status.
• Simulate Auto mode for thermostats without native support: Enables automatic mode switching based on indoor temperature relative to setpoints. A 3-degree difference between Cool and Heat Setpoints is recommended.

Logging Options

• HomeSeer Log Level: Select the logging level for HomeSeer.
• Plugin Log File Level: Select the logging level for the plugin's dedicated log file.

Buttons are available to [DOWNLOAD LOG FILE] and [CLEAR LOG FILE] for easier log management.

Thermostat Devices

After adding thermostats, HomeSeer creates devices and child devices based on the thermostat's capabilities. The first polling populates these devices.

Key devices and their functions:

• Status: Shows the last request/command status and data refresh time.
• Indoor Temp, Indoor Humidity, Outdoor Temp, Outdoor Humidity: Display status-only data reported by the thermostat.
• Fan Mode: Shows the current fan setting ("On" or "Auto") and allows mode changes.
• Fan Status: Indicates if the fan is currently running ("On" or "Off").
• Cool Setpoint / Heat Setpoint: Displays and allows adjustment of the current setpoint using dropdowns or [+1]/[-1] increments. If a Permanent Hold is active, it's maintained; otherwise, a temporary hold may be issued.
• Hold Type: Shows the current hold status ("None", "Temporary", or "Permanent") and provides buttons to change it.
• System Mode: Displays the current mode ("Cool", "Heat", "Emergency Heat", "Auto", "Off") and offers control buttons. If "Simulate Auto" is enabled, an "Auto" button is added, and the plugin manages mode switching based on temperature.
• Operating Status: Indicates if the system is running (e.g., "Idle", "Heating", "Cooling").
• Operating Mode: Shows the mode the unit is currently working in (e.g., "Auto", "Simulated Auto").

Command Processing

To prevent excessive commands to Honeywell, the plugin checks the timestamp of the last update request. If it's too soon based on the "Update Frequency," a timer is set to wait until the frequency has passed before requesting the update again. Polling timers are reset with each update, meaning a setpoint change will restart the polling interval timer.

Support

Support for the skWare Honeywell WiFi Thermostat Plug-In for HomeSeer is available through standard HomeSeer channels. The primary support mechanism is the Honeywell WiFi Thermostat forum on the HomeSeer website. For direct contact, the author can be reached at steve@skware.net.

Appendix 1: Files

The following files are used by the Plug-In. Directories in bold are part of the standard HomeSeer installation. Files marked with * are created by the software during usage; all other files are included in the installation.

HomeSeer Installation Directory

• HSPI_SKWARE_HW_WIFI_TSTAT.exe
• HSPI_SKWARE_HW_WIFI_TSTAT.exe.config
• \Bin
• \skWare
• \Config
• \WiFiThermostat
• HtmlAgilityPack.dll
• log4net.dll
• Newtonsoft.Json.dll
• skWare.Common.dll
• skWare.Common.HS4.dll
• skWare.Common.HS4.dll.config
• skWare.HomeSeer.WiFiThermostat.Core.dll
• skWare.HomeSeer.WiFiThermostat.Core.dll.config

Config Directory

• HSPI_SKWARE_HW_WIFI_TSTAT.ini*

Html Directory

• \WiFiThermostat
• Debug.html
• debug_list.html
• Help.html
• Settings.html
• Setup.html
• skWare Honeywell WiFi Thermostat Plug-In User Guide.pdf
• skware_common.js
• thermostat_list.html
• Thermostats.html
• \images
• auto.png
• auxheat.png
• cool.png
• failed.png
• fan-auto.png
• fan-circulate.png
• fan-off.png
• fan-on.png
• heat.png
• humidity.png
• nostatus.png
• off.png
• permanent.png
• schedule.png
• success.png
• temporary.png
• thermometer-cool-0.png
• thermometer-cool-1.png
• thermometer-cool-2.png
• thermometer-cool-3.png
• thermometer-cool-4.png
• thermometer-cool-5.png
• thermometer-generic-0.png
• thermometer-generic-1.png
• thermometer-generic-2.png
• thermometer-generic-3.png
• thermometer-generic-4.png
• thermometer-generic-5.png
• thermometer-heat-0.png
• thermometer-heat-1.png
• thermometer-heat-2.png
• thermometer-heat-3.png
• thermometer-heat-4.png
• thermometer-heat-5.png
• unknown.png
• waiting.png

Logs Directory

• HSPI_SKWARE_HW_WIFI_TSTAT.log*