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 los 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 grados Celsius a la que el termostato comienza a calentar en el modo Eco. | number Ejemplo: 20.0 |
coolCelsius |
Es la temperatura más alta en grados Celsius a la que el termostato comienza a enfriar en el modo Eco. | number Ejemplo: 22.0 |
Ejemplo de solicitud y respuesta GET
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 a otros atributos, según el estado actual del modo Eco o los cambios que se realicen en él:
- Si el modo Eco está desactivado, el modo del termostato se establecerá de forma predeterminada en el último modo estándar (CALOR, FRÍO, CALOR Y FRÍO, o APAGADO) que estaba activo.
- Si el modo Eco es MANUAL_ECO:
- Se rechazan los comandos para el atributo ThermostatTemperatureSetpoint .
- El atributo ThermostatTemperatureSetpoint no muestra 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 la solicitud SetMode
Campo | Descripción | Tipo de datos |
---|---|---|
mode |
El modo Eco al que se cambiará el termostato. | string Valores: "MANUAL_ECO", "OFF" |
Errores
En relación con este atributo, se pueden mostrar los siguientes códigos de error:
Mensaje de error | RPC | Solución de problemas |
---|---|---|
No se permite el comando en el modo actual del termostato. | FAILED_PRECONDITION |
Algunos modelos de termostatos no admiten el cambio del modo Eco cuando el modo del termostato está desactivado, según el atributo ThermostatMode . 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 el modo MANUAL_ECO. | FAILED_PRECONDITION |
No se puede establecer el punto de ajuste de temperatura cuando el termostato está en el modo Eco manual. |
Consulta la Referencia de códigos de error de la API para obtener la lista completa de los códigos de error de la API.