Thermostat — thermostat v1
Capabilities
Declared in the driver manifest under [[proxy]] capabilities. Anything not declared takes the default below.
| Capability | Type | Default | Meaning |
|---|
fan_modes | string[] | ["auto","on"] | |
has_auto | bool | false | Dual setpoint auto-changeover |
has_cool | bool | true | |
has_fan_control | bool | true | |
has_heat | bool | true | |
has_hold | bool | false | Can override a schedule until cancelled |
has_humidity | bool | false | |
has_humidity_control | bool | false | |
setpoint_max_c | f32 | 35.0 | |
setpoint_min_c | f32 | 4.0 | |
setpoint_step_c | f32 | 0.5 | |
stage_count | u8 | 1 | |
Commands
set_cool_setpoint
Only present when has_cool is declared true.
| Parameter | Type | Notes |
|---|
celsius | f32 | |
set_fan_mode
Only present when has_fan_control is declared true.
| Parameter | Type | Notes |
|---|
mode | string | |
set_heat_setpoint
Only present when has_heat is declared true.
| Parameter | Type | Notes |
|---|
celsius | f32 | |
set_hold
Only present when has_hold is declared true.
| Parameter | Type | Notes |
|---|
hold | bool | |
set_mode
| Parameter | Type | Notes |
|---|
mode | one of off · heat · cool · auto | |
Notifications
humidity_changed
Only present when has_humidity is declared true.
| Parameter | Type | Notes |
|---|
percent | f32 0–100 | |
hvac_state_changed
What the equipment is actually doing right now
| Parameter | Type | Notes |
|---|
state | one of idle · heating · cooling · fan | |
mode_changed
| Parameter | Type | Notes |
|---|
mode | string | |
online_changed
| Parameter | Type | Notes |
|---|
online | bool | |
setpoint_changed
| Parameter | Type | Notes |
|---|
celsius | f32 | |
which | one of heat · cool | |
temperature_changed
| Parameter | Type | Notes |
|---|
celsius | f32 | |
State
Last-known values core keeps for a binding of this proxy.
| Key | Type | Meaning |
|---|
cool_setpoint_c | f32 | |
display_unit | string | |
heat_setpoint_c | f32 | |
humidity | f32 | |
hvac_state | string | |
mode | string | |
online | bool | |
setpoint_c | f32 | |
temperature_c | f32 | |