Guía del termostato para el hogar inteligente
action.devices.types.THERMOSTAT - Los termostatos son dispositivos que controlan la temperatura y tienen modos y puntos 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 elementos relacionados. sinónimos y alias.
Los dispositivos de este tipo controlan la temperatura, mientras que algunas unidades de calefacción/enfriamiento tienen diferentes y los modos alto/bajo, pero no los controles de temperatura.Funciones del dispositivo
Consulta la documentación de la característica correspondiente para detalles de 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 estos rasgos, ingresa el código de error de
functionNotSupported en una respuesta QUERY o EXECUTE. Consulta
Consulta Errores y excepciones para obtener más información.
Los comandos del termostato con frecuencia se encadenan en intents EXECUTE. Un usuario que
indica que *Establecer la calefacción en 22* generará un comando de modo seguido de la 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 intents de ejemplo que representan un "termostato" común según el tipo de dispositivo y las características antes mencionadas. Si agregas o quitas características en tu implementación, modificar tus respuestas en consecuencia para reflejar esos cambios.
Ejemplo de respuesta 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
action.devices.traits.TemperatureSetting
referencia.
{ "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
action.devices.traits.TemperatureSetting
referencia.
{ "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
action.devices.traits.TemperatureSetting
referencia.
{ "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 } } ] } }
ERRORES de dispositivo
Consulta la lista completa de errores y excepciones.inHeatOrCool: Los comandos Calor/Frío/rango fallaron porque el dispositivo está en calor o frío explícito.inHeatCool- Fallaron los comandos Calor o Frío porque el dispositivo está en calor o genial.lockedToRange- El dispositivo está bloqueado en un rango o modo de temperatura, y el no se puede realizar el cambio solicitado.rangeTooClose- Los puntos de temperatura en un rango frío/calor están demasiado cerca de entre sí.