Esquema de ThermostatEco
sdm.devices.traits.ThermostatEco
Este rasgo pertenece a los tipos de dispositivos THERMOSTAT que admiten modos ECO.
Campos
Campo | Descripción | Tipo de datos |
---|---|---|
availableModes |
Es la lista de modos Eco compatibles. | array(string) Valor: ["MANUAL_ECO", "OFF"] |
mode |
Es 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 de 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
Cambiar el modo Eco del termostato
Para cambiar el modo del termostato a HEAT, COOL o HEATCOOL, usa el comando SetMode del rasgo ThermostatMode.
Este comando afecta otros rasgos 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, CALORFRÍO o APAGADO) que estuvo activo.
- Si el modo Eco es MANUAL_ECO, haz lo siguiente:
- Se rechazan los comandos para el rasgo ThermostatTemperatureSetpoint .
- Los puntos de ajuste de temperatura no se devuelven con el rasgo ThermostatTemperatureSetpoint .
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 |
Es 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 relacionados con este atributo:
Mensaje de error | RPC | Solución de problemas |
---|---|---|
No se permite el comando en el modo actual del termostato. | FAILED_PRECONDITION |
Según el rasgo ThermostatMode , algunos modelos de termostatos no admiten el cambio del modo Eco cuando el modo del termostato está APAGADO. El modo del termostato debe cambiarse a HEAT, COOL 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 temperatura cuando el termostato está en modo Eco manual. |
Consulta la Referencia de códigos de error de la API para ver la lista completa de códigos de error de la API.