Esquema de ThermostatEco
sdm.devices.traits.ThermostatEco
Esta característica pertenece a los tipos de dispositivos del TERMOSTATO que admiten modos ECO.
Campos
Campo | Descripción | Tipo de datos |
---|---|---|
availableModes |
Lista de modos Eco compatibles. | array(string) Valor: ["MANUAL_ECO", "OFF"] |
mode |
El modo Eco actual del termostato. | string Valores: "MANUAL_ECO", "OFF" |
heatCelsius |
Es la temperatura más baja en Celsius a la que el termostato comienza a calefaccionar en modo Eco. | number Ejemplo: 20.0 |
coolCelsius |
Temperatura máxima (en grados Celsius) a la que el termostato comienza a enfriar en modo Eco. | number Ejemplo: 22.0 |
Ejemplo de solicitud GET y respuesta
Solicitud
GET /enterprises/project-id/devices/device-id
Respuesta
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatEco
" : {
"availableModes" : ["MANUAL_ECO", "OFF"],
"mode" : "MANUAL_ECO",
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
Comandos
SetMode
Cambia el modo Eco del termostato.
Para cambiar el modo del termostato a CALOR, Frío o HEATCOOL, usa el comando SetMode de la característica ThermostatMode.
Este comando afecta otras características, según el estado actual del modo Eco o los cambios en él:
- Si el modo Eco está DESACTIVADO, el termostato usará de forma predeterminada el último modo estándar (CALOR, FRÍO, CALEFACCIÓN o APAGADO) que estuvo activo.
- Si el modo Eco es MANUAL_ECO:
- Se rechazaron los comandos de la característica Punto de ajuste de temperatura del termostato .
- La característica ThermostatTemperatureSetpoint no devuelve los puntos de ajuste de temperatura.
Solicitud y respuesta de SetMode
Solicitud
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatEco.SetMode
",
"params" : {
"mode" : "MANUAL_ECO"
}
}
Respuesta
{}
Campos de solicitud SetMode
Campo | Descripción | Tipo de datos |
---|---|---|
mode |
El modo Eco al que se cambiará el termostato. | string Valores: "MANUAL_ECO", "OFF" |
Errores
Se pueden mostrar los siguientes códigos de error en relación con esta característica:
Mensaje de error | RPC | Soluciona problemas |
---|---|---|
No se permite el comando en el modo del termostato actual. | FAILED_PRECONDITION |
Algunos modelos de termostatos no admiten el cambio del modo Eco cuando el modo del termostato está DESACTIVADO, según la característica Mododetermostato . El modo del termostato debe cambiarse a CALOR, FRÍO o HEATCOOL antes de cambiar el modo Eco. |
No se permite el comando cuando el termostato está en modo MANUAL_ECO. | FAILED_PRECONDITION |
No se puede establecer el punto de ajuste de la temperatura cuando el termostato está en modo Eco manual. |
Consulta la referencia de códigos de error de API para la lista completa de códigos de error de API.