Guía de termostatos de casa inteligente
action.devices.types.THERMOSTAT
: Los termostatos son dispositivos que controlan la temperatura, con puntos y modos establecidos. Esto los separa de los calefactores y las unidades de aire acondicionado que solo pueden tener modos y parámetros de configuración (por ejemplo, alta/baja) en comparación con un objetivo de temperatura.
Este tipo indica que el dispositivo obtiene el ícono de Thermostat y algunos sinónimos y alias relacionados.
Los dispositivos de este tipo controlan la temperatura, mientras que algunas unidades de calefacción/enfriamiento tienen controles diferentes y modos alto/bajo, pero no controles de temperatura.Funciones del dispositivo
Consulta la documentación de las características correspondiente para obtener detalles de la implementación, como los atributos y los estados que tu servicio debe admitir, y cómo compilar respuestas EXECUTE y QUERY.
Características requeridas
Estas características y comandos son obligatorios, si corresponde a tu dispositivo. Si tu dispositivo no admite estas características, ingresa el código de error functionNotSupported
en una respuesta de QUERY o EXECUTE. Consulta Errores y excepciones para obtener más información.
Con frecuencia, los comandos del termostato se encadenan en intents EXECUTE
. Si un usuario dice *Establece la calefacción en 72*, generará un comando de modo seguido de un ajuste de temperatura.
Requisitos de calidad
- Latencia: Debe ser menor o igual que 700 ms.
- Confiabilidad: Debe ser mayor o igual que el 97%.
Dispositivo de ejemplo: Termostato simple
En esta sección, se incluyen ejemplos de cargas útiles de intent que representan un "termostato" común según el tipo y las características de dispositivo anteriores. Si agregas o quitas características en tu implementación, modifica tus respuestas según corresponda para reflejar esos cambios.
Respuesta de muestra de SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.THERMOSTAT", "traits": [ "action.devices.traits.TemperatureSetting" ], "name": { "name": "Simple thermostat" }, "willReportState": true, "attributes": { "availableThermostatModes": [ "off", "heat", "cool", "heatcool", "on" ], "thermostatTemperatureRange": { "minThresholdCelsius": 15, "maxThresholdCelsius": 30 }, "thermostatTemperatureUnit": "F" }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Ejemplo de respuesta de QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "thermostatMode": "cool", "thermostatTemperatureSetpoint": 23, "thermostatTemperatureAmbient": 25.1, "thermostatHumidityAmbient": 45.3 } } } }
Ejemplos de comandos EXECUTE
ThermostatTemperatureSetpoint
Para obtener detalles adicionales sobre los parámetros del comando, consulta la referencia de
action.devices.traits.TemperatureSetting
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ThermostatTemperatureSetpoint", "params": { "thermostatTemperatureSetpoint": 22 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "thermostatMode": "cool", "thermostatTemperatureSetpoint": 22, "thermostatTemperatureAmbient": 25.1 } } ] } }
ThermostatTemperatureSetRange
Para obtener detalles adicionales sobre los parámetros del comando, consulta la referencia de
action.devices.traits.TemperatureSetting
.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ThermostatTemperatureSetRange", "params": { "thermostatTemperatureSetpointHigh": 26, "thermostatTemperatureSetpointLow": 22 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "thermostatMode": "heatcool", "thermostatTemperatureSetpointHigh": 26, "thermostatTemperatureSetpointLow": 22, "thermostatTemperatureAmbient": 25.1 } } ] } }
ThermostatSetMode
Para obtener detalles adicionales sobre los parámetros del comando, consulta la referencia de
action.devices.traits.TemperatureSetting
.
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ThermostatSetMode", "params": { "thermostatMode": "heatcool" } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "thermostatMode": "heatcool", "thermostatTemperatureSetpointHigh": 26, "thermostatTemperatureSetpointLow": 22, "thermostatTemperatureAmbient": 25.1 } } ] } }
ERRORS de dispositivos
Consulta la lista completa de errores y excepciones.inHeatOrCool
: Falló los comandos Calor/Frío/Rango porque el dispositivo está en calefacción o enfriamiento explícito.inHeatCool
: Los comandos de Calor o Frío fallaban porque el dispositivo está en calor o frío.lockedToRange
: El dispositivo está bloqueado en un rango o modo de temperatura, y no se puede realizar el cambio solicitado.rangeTooClose
: Los puntos de temperatura en un rango Calor • Frío están demasiado cerca entre sí.