Device States

Device States

The plugin exposes all of the standard Indigo Thermostat Device States supported by the ColorTouch hardware, as well as all of the ColorTouch API parameters. Obviously there is some overlap between the two, in which case the standard Indigo Thermostat Device States are used.
 

DeviceStates

 

Standard Indigo Device States

All but a few of the standard Indigo Thermostat Device States are supported in the usual manner, with the few exceptions noted below:

  • The “Any Humidity Changed”, and “Zone 1 Humidity” states are available only for the T5900, as the T5800 lacks a humidity sensor (in fact, that is the only difference between the two models).
     
  • “Dehumidifier Equipment State” and “Humidifier Equipment State” are not are not available for either model, as they are not supported by the ColorTouch API.

Notes

  • The “Zone 1 Temperature” Device State refers to the thermostat’s internal temperature sensor.
     
  • The “Zone 2 Temperature” Device State refers to the optional, external temperature sensor and is available only if the Device is configured to support one (see Configuration).

 

ColorTouch Custom Device States

In addition to the standard Indigo Thermostat Device States, the following additional Custom Device States are also available:

  • Onboard Name (ct_name): The name optionally assigned to the thermostat, and displayed in the lower left corner of the touchscreen. Can be set only via the touchscreen (14 characters max).
     
  • Operating State (ct_state): The thermostat’s current operating state (0: Idle, 1: Heating, 2: Cooling, 3: Lockout, 4: Error).
     
  • Away Mode (ct_away): (0: Home, 1 = Away).
     
  • Room Temperature (ct_spacetemp): The current temperature displayed on the touchscreen. Can be configured (via the touchscreen) to represent the Main (internal) Temperature Sensor, the Secondary (external) Temperature Sensor, or the average of the two. It is this value the thermostat compares against the temperature setpoints to determine when to switch the HVAC equipment and/or fan on and off.
     
  • Temperature Units (ct_tempunits): (0: Fahrenheit, 1: Celsius).
     
  • Temperature Setpoint Delta (ct_setpointdelta): The minimum allowed difference between the Heat To setpoint and the Cool To setpoint; adjustable only via the touchscreen.
     
  • Cool To Min (ct_cooltempmin): The minimum allowed Cool setpoint; adjustable only via the touchscreen.
     
  • Cool To Max (ct_cooltempmax): The maximum allowed Cool setpoint; adjustable only via the touchscreen.
     
  • Heat To Min (ct_heattempmin): The minimum allowed Heat setpoint; adjustable only via the touchscreen.
     
  • Heat To Max (ct_heattempmax): The maximum allowed Heat setpoint; adjustable only via the touchscreen.
     
  • Humidify Setpoint (ct_hum_setpoint): Current humidify setpoint.
     
  • Dehumidify Setpoint (ct_dehum_setpoint): Current dehumidify setpoint.
     
  • Onboard Schedule (ct_shedule): Provided in the interest of completeness; matches the “schedule” property returned from the hardware; you’ll generally want to use the Schedule Mode Device State (ctSheduleMode), below, instead (0: Off, 1: On)
     
  • Onboard Schedule Part (ct_shedulepart): Provided in the interest of completeness; matches the “schedulepart” property returned from the hardware; you’ll generally want to use the Schedule Mode Description Device State, below, instead (0: morning, 1: day, 2: evening, 3: night, 255: inactive).
     
  • Schedule Mode (ctSheduleMode): Current Schedule Mode (0: Off, 1: Onboard (built-in) Schedule running, 2: Custom Schedule Folder #1 running, 3: Custom Schedule Folder #2 running, etc.). See Custom Schedules, for more information.
     
  • Schedule Mode Description (ctSheduleModeDescription): Textual description of the current Schedule status.
     
  • Schedule Folders (ctSheduleFolders): a JSON-encoded list of Indigo Schedule Folder IDs; this is the current list of Custom Schedule Folders that have been added to the Custom Schedule Folders List. See Custom Schedules, for more information.
     
  • Air Filter Alert (ctAlertAirFilter): (0: Inactive, 1: Active), see Alerts, for more information.
     
  • UV Lamp Alert (ctAlertUVLamp): (0: Inactive, 1: Active), see Alerts, for more information.
     
  • Service Alert (ctAlertService): (0: Inactive, 1: Active), see Alerts, for more information.
     
  • Alerts Updated (ctAlertsUpdated): Date/time string indicating when the Alerts status was last updated (format: “2015-02-25 13:57:43”).
     
  • Runtime Data (ctRuntimes): a JSON-encoded list of time-stamped records with minutes of runtime for each stage, for each of the previous six (6) days. See Runtime Data, for more information.
     
  • Runtime Data Updated (ctRuntimesUpdated): Date/time string indicating when the Runtime data were last read from the thermostat (format: “2015-02-25 13:57:43”).
     
  • Sensor Data (ctSensors): a JSON-encoded string containing a list of individual sensor readings. See Sensor Data, for more information.
     
  • Sensor Data Updated (ctSensorsUpdated): Date/time string indicating when the Sensor data were last read from the thermostat (format: “2015-02-25 13:57:43”).
     
  • Available Modes (ct_availablemodes): Integer indicating which system operating modes are available; depends upon the thermostat’s configuration and the equipment to which it is connected (0: All modes, 1: heat/cool (Auto) only, 2: heat only, 3: cool only).
     
  • Last Update (ctLastUpdate): Date/time string indicating when the thermostat’s status was last updated (format: “2015-02-25 13:57:43”).