Thermostats
Devices that can regulate the temperature of a location, so that the location's temperature is maintained near a desired set point temperature.
Thermostat Properties
temperature_fahrenheit
Number
Temperature, measured in Fahrenheit.
temperature_celsius
Number
Temperature, measured in Celsius.
relative_humidity
Number
Relative humidity, the amount of moisture in the air compared to the maximum amount of moisture the air can hold at a given temperature. It is a percentage expressed as a number between 0
and 1
, inclusive.
available_hvac_mode_settings
Array of enums (strings)
A list of the available HVAC modes for the thermostat.
Possible values:
cool
heat
heat_cool
off
Climate Setting Properties
hvac_mode_setting
Enum (string) Required
HVAC mode to which the thermostat is set.
Possible values:
cool
heat
heat_cool
off
cooling_set_point_celsius
Number Optional
The cooling set point, measured in Celsius, if cooling is turned on. When the ambient temperature rises above this set point, cooling turns on.
heating_set_point_celsius
Number Optional
The heating set point, measured in Celsius, if heating is turned on. When the ambient temperature drops below this set point, heating turns on.
cooling_set_point_fahrenheit
Number Optional
The cooling set point, measured in Fahrenheit, if cooling is turned on. When the ambient temperature rises above this set point, cooling turns on.
heating_set_point_fahrenheit
Number Optional
The heating set point, measured in Fahrenheit, if heating is turned on. When the ambient temperature drops below this set point, heating turns on.
manual_override_enabled
Boolean Required
Indicates whether another user can use the thermostat or API to override this climate setting.
Climate Set Points
When heating is turned on, you will need to set a heating set point. When the ambient temperature drops below this set point, heating will turn on.
When cooling is turned on, you will need to set a cooling set point. When the ambient temperature rises above this set point, cooling will turn on.
When you have heat_cool
turned on, where both heating and cooling systems are enabled, you will need to set heating and cooling set points. The cooling set point needs to be set to a temperature higher than that of the heating set point. On some systems, there might also be a minimum difference between the heating and cooling set points.
List of Methods
Last updated
Was this helpful?