Przewodnik po termostatach do inteligentnego domu
action.devices.types.THERMOSTAT – termostaty to urządzenia sterujące temperaturą z nastawami i trybami. Różnica między nimi a ogrzewaniem i klimatyzacją polega na tym, że te ostatnie mogą mieć tylko tryby i ustawienia (np. wysoka/niska) zamiast docelowej temperatury.
Ten typ wskazuje, że urządzenie ma ikonę termostatu oraz niektóre powiązane synonimy i aliasy.
Urządzenia tego typu kontrolują temperaturę, podczas gdy niektóre jednostki grzejąco-chłodzące mają inne elementy sterujące i tryby wysokiej/niskiej temperatury, ale nie mają elementów sterujących temperaturą.Funkcje urządzenia
Szczegółowe informacje o wdrożeniu, takie jak atrybuty i stany, które powinna obsługiwać usługa, oraz sposób tworzenia odpowiedzi na wywołania EXECUTE i QUERY, znajdziesz w odpowiedniej dokumentacji atrybutu.
Wymagane cechy
Te cechy i polecenia są wymagane, jeśli są dostępne na Twoim urządzeniu. Jeśli urządzenie nie obsługuje tych atrybutów, wpisz kod błędu functionNotSupported w odpowiedzi na QUERY lub EXECUTE. Więcej informacji znajdziesz w sekcji Błędy i wyjątki.
Polecenia termostatu są często łączone w intentach EXECUTE. Użytkownik, który powie *Set the heat to 72* (Ustaw temperaturę na 22 stopnie), wygeneruje polecenie trybu, po którym nastąpi ustawienie temperatury.
Wymagania dotyczące jakości
- Opóźnienie: musi być mniejsze lub równe 700 ms.
- Niezawodność: musi być większa lub równa 97%.
Przykładowe urządzenie: prosty termostat
Ta sekcja zawiera przykładowe dane intencji przedstawiające typ urządzenia „Termostat” na podstawie wymienionych powyżej cech i właściwości. Jeśli w swojej implementacji dodasz lub usuniesz cechy, odpowiednio zmodyfikuj odpowiedzi, aby uwzględnić te zmiany.
Przykładowa odpowiedź 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" } } ] } }
Przykładowa odpowiedź na zapytanie
{ "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 } } } }
Przykładowe polecenia EXECUTE
ThermostatTemperatureSetpoint
Więcej informacji o parametrach polecenia znajdziesz w dokumentacji
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
Więcej informacji o parametrach polecenia znajdziesz w dokumentacji
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
Więcej informacji o parametrach polecenia znajdziesz w dokumentacji
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 } } ] } }
BŁĘDY urządzenia
Zobacz pełną listę błędów i wyjątków.inHeatOrCool– polecenia ogrzewania/chłodzenia/zakresu nie działają, ponieważ urządzenie jest w trybie ogrzewania lub chłodzenia.inHeatCool– polecenia dotyczące ogrzewania lub chłodzenia nie działają, ponieważ urządzenie jest w trybie ogrzewania lub chłodzenia.lockedToRange– urządzenie jest zablokowane w zakresie temperatury lub trybie, więc żądana zmiana nie może zostać wprowadzona.rangeTooClose– punkty temperatury w zakresie ogrzewania/chłodzenia są zbyt blisko siebie.