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, amount of moisture in the air compared to the maximum amount of moisture the air can hold at a given temperature. It is expressed as a percentage.

can_enable_automatic_cooling

boolean

If true, the thermostat is connected to a cooling system

can_enable_automatic_heating

boolean

If true, the thermostat is connected to a heating system

available_hvac_mode_settings

Array<string>

A list of the available HVAC Modes for the Thermostat. These can include: - cool - heat - heatcool - off

current_climate_setting

Climate Setting Properties

property name
type
Description

automatic_heating_enabled

boolean

Whether the thermostat has heating turned on

automatic_cooling_enabled

boolean

Whether the thermostat has cooling turned on

hvac_mode_setting

heatcool | heat | cool | off

The HVAC mode the thermostat is set to.

cooling_set_point_fahrenheit

number | null

The cooling set point if cooling is turned on. When the ambient temperature rises above this set point, cooling will turn on.

heating_set_point_fahrenheit

number | null

The heating set point if heating is turned on. When the ambient temperature drops below this set point, heating will turn on.

manual_override_enabled

boolean

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 heatcool 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?