Venstar ColorTouch

This driver is for the Venstar ColorTouch Line of thermostats.

Supported models with the Skyport Wi-Fi Key (ACCO454) are T5800, T5900, T6800, and T6900.

Supported models with built in Wi-Fi are T7850, T7900, T8850, T8900, and the First Alert THERM-500.

Upcoming Venstar Voyager series thermostats with Wi-Fi capabilities should also be supported.

Due to no Wi-Fi/network capabilities the T7800 and T8800 ColorTouch thermostats are not supported.

Note - Local API must be turned on in the ColorTouch Accessories menu.

Revision History
1.0 The Initial release of the driver

1.01 Updated compatible thermostat models.

Updated Get Info configuration information for Passcode settings.

1.02 Added note for turning Local API On.

1.1 Added Humidify/Dehumidify level commands and variables.

Added Humidity Threshold commands, variables, and events.

1.11 Optimized code for when Enable Selected Thermostat is active.

Adjusted driver send function for compatibility with Venstar firmware 4.08.

1.2 Adjusted discrepancy in driver when no Humidify/Dehumidify control was available for newer model thermostats.

Fixed issue with thermostat names when not using selected capabilities.

1.21 Added manual Thermostat Query Commands

1.22 Maintenance Update - Added advanced debugging capabilities.

Defaulted Enable Selected Thermostat configuration to false for APEX compatibility.

1.23 Fixed issue with threshold level variables causing errors.

Tested with firmware version 5.10 on a T7850.

Config Settings

Selected Thermostat Settings

- Enable Selected Thermostat - Used for enabling the selected thermostat feature included in the driver. Note- The selected thermostat feature is useful during user interface creation by allowing one set of commands and variables to control multiple thermostats based on the currently selected thermostat from the list of configured thermostats.

Thermostat Configuration

- Number of Thermostats - Enter the number of thermostats installed in the project. Up to 24 thermostats are supported. Note- This field will determine how many thermostat configurations are visible throughout the driver.

Thermostat (1-24) Configuration

- Thermostat (1-24) Name - Enter the name used in Settings/Thermostat Name on the thermostat.

- Thermostat (1-24) IP Address - Enter the IP address of the thermostat. It is recommended the thermostat be setup to use a static IP address.

- Thermostat (1-24) IP Port - Enter the IP port of the thermostat. The default setting for control is port 80.

- Thermostat (1-24) Refresh Rate - Select the refresh rate preferred for updating the thermostat information. 15, 30, 45, and 60 seconds are the selections available. Note - Initially all variables should be acquired upon the thermostat initialization. Once the thermostat initializes, the query requests for sensors, runtimes, and alerts are performed in a round-robin style with the info query being sent with each round-robin query.

- Thermostat (1-24) Passcode Used - Select if Auto Screen lock is enabled on thermostat.

- Thermostat (1-24) Passcode - Enter the passcode configured in the thermostat for operation while Auto Screen lock is enabled.

- Thermostat (1-24) Sensor 1 Attached - Check the field sensor 1 is connected.

- Thermostat (1-24) Sensor 2 Attached - Check the field sensor 2 is connected.

Additional Driver Notes

- Upon driver initialization the variables used for configured thermostats will be cleared and set to a startup default. Once feedback is received for a thermostat, its variables will be populated with the appropriate feedback. If a variable still shows the cleared data after the thermostat has been properly initialized, this means there was no value for the variable, or the settings corresponding to the variable are not set up appropriately in the thermostat.

- Connection state variables are based on whether the driver receives a response to the preceding command that was sent. If no response happens within the wait period the connection status will show as disconnected. If the driver receives any response from the thermostat (including error messages), the connection status will show as connected.

- Venstar firmware 4.08 does not provide proper Humidify/Dehumidify feedback so humidification/dehumidification control and feedback is unavailable with 4.08.

- If there are any issues controlling a thermostat using 4.08 firmware, make sure the thermostat does NOT have a name entered Settings/Thermostat Name/ menu of the thermostat. Naming a thermostat with 4.08 firmware may cause the info/query poll response to fail.

Note - Local API must be turned on in the ColorTouch Accessories menu.