This trait belongs to device types of THERMOSTAT that can report HVAC details.
Fields
Field
Description
Data Type
status
Current HVAC status of the thermostat.
string Values: "OFF", "HEATING", "COOLING"
Timing of events
Note that an event for a change in HVAC status may not be delivered at the same time as events
for a thermostat mode change.
For example, sometimes there is
a
delay in starting a thermostat's heating or cooling mode in order to protect the HVAC
system. In this scenario, changing the thermostat mode may only initially send events for
ThermostatMode and
ThermostatTemperatureSetpoint trait changes, with the
ThermostatHvac trait change sent later as a separate
event once the system actually turns on. If there was no delay in turning on the HVAC system, all
three events would be sent at the same time.
[null,null,["Last updated 2025-02-26 UTC."],[[["The `ThermostatHvac` trait applies to THERMOSTAT devices and provides information about their heating, ventilation, and air conditioning (HVAC) status."],["The `status` field indicates the current HVAC mode of the thermostat, which can be \"OFF\", \"HEATING\", or \"COOLING\"."],["Events related to HVAC status changes might not always be delivered simultaneously with thermostat mode change events, potentially due to system protection delays."],["While you can retrieve the HVAC status using a GET request, there are no specific commands to control this trait directly."]]],["The `ThermostatHvac` trait, applicable to THERMOSTAT devices, reports the current HVAC status, which can be \"OFF,\" \"HEATING,\" or \"COOLING.\" HVAC status change events might be delayed, occurring separately from thermostat mode or temperature setpoint changes. A GET request retrieves the device's HVAC status under the \"sdm.devices.traits.ThermostatHvac\" trait. No commands are available for this trait. Error codes are available for reference.\n"]]
