Esquema de ThermostatEco
sdm.devices.traits.ThermostatEco
Esta característica pertenece a los tipos de dispositivos de THERMOSTAT 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
GET /enterprises/project-id /devices/device-id
{ "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 CALOR/FRÍO, usa el comando SetMode del atributo 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
POST /enterprises/project-id /devices/device-id :executeCommand { "command" : "sdm.devices.commands.ThermostatEco.SetMode
", "params" : { "mode" : "MANUAL_ECO" } }
{}
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
Es posible que se muestren los siguientes códigos de error en relación con este atributo:
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 CALOR/FRÍO 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.