Guía de termostatos inteligentes para el hogar
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 ajustes (por ejemplo, temperatura alta y mínima) en comparación con un objetivo de temperatura.
Este tipo indica que el dispositivo obtiene el ícono del termostato y algunos sinónimos y sinónimos relacionados.
Los dispositivos de este tipo controlan la temperatura, mientras que algunas unidades de calefacción/enfriamiento tienen controles diferentes y modos de temperatura alta y baja, pero no los de temperatura.Funciones del dispositivo
Consulta la documentación de características correspondiente para obtener detalles de implementación, como atributos y estados que tu servicio debe admitir, y cómo compilar respuestas de EXECUTE y QUERY.
Características obligatorias
Estas características y comandos son necesarios si corresponden a tu dispositivo.
Los comandos del termostato se encadenan con frecuencia en intents EXECUTE
. Un usuario que dice *Establece la calefacción en 22 grados* generará un comando de modo seguido de una temperatura establecida.
Requisitos de calidad
- Latencia: Debe ser menor o igual que 700 ms.
- Confiabilidad: Debe ser mayor o igual que 97%.
Dispositivo de ejemplo: termostato simple
Esta sección contiene cargas útiles de intent de ejemplo que representan un "Termostato" común según el tipo de dispositivo y las características anteriores. Si agregas o quitas rasgos 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" } } ] } }
Respuesta de muestra 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 } } } }
Comandos de EXECUTE de muestra
Punto de ajuste del termostato
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 } } ] } }
Rango de temperatura del termostato
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 } } ] } }
Modo de Termostato
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 } } ] } }
Dispositivo ERRORS
Consulta la lista completa de errores y excepciones.inHeatOrCool
: Los comandos de Calor, Frío y Rango fallan porque el dispositivo está en calor o frío explícitos.inHeatCool
: Los comandos de Calor o Frío fallaron porque el dispositivo está en calefacción 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 de calor o frío están demasiado cerca entre sí.