Przewodnik po inteligentnym domowym termostacie
action.devices.types.THERMOSTAT – termostaty to urządzenia zarządzające temperaturą za pomocą ustawionych punktów i trybów. To odróżnia je od grzejników i klimatyzatorów, które mogą mieć tylko ustawione tryby i ustawienia (np. wysoka/niska) w porównaniu z docelową temperaturą.
Ten typ oznacza, że urządzenie zobaczy ikonę termostatu oraz pewne powiązane synonimy i aliasy.
Urządzenia tego typu sterują temperaturą, podczas gdy niektóre urządzenia ogrzewania i chłodzenia mają różne opcje sterowania oraz tryby wysokiej/niskiej, ale nie sterują temperaturą.Funkcje urządzenia
W dokumentacji odpowiedniej cechy znajdziesz szczegółowe informacje na temat implementacji, takie jak atrybuty i stany, które powinna obsługiwać usługa, oraz informacje o tworzeniu odpowiedzi EXECUTE i QUERY.
Wymagane cechy
Te cechy i polecenia są wymagane, jeśli dotyczy to Twojego urządzenia. Jeśli Twoje urządzenie nie obsługuje tych cech, wpisz kod błędu functionNotSupported w odpowiedzi QUERY lub EXECUTE. Więcej informacji znajdziesz w artykule Błędy i wyjątki.
Polecenia termostatu są często łączone w intencjach EXECUTE. Użytkownik, który powie *Ustaw ogrzewanie na 22 stopnie*, wyświetli polecenie trybu i ustaw temperaturę.
Wymagania dotyczące jakości
- Czas oczekiwania: nie może przekraczać 700 ms.
- Niezawodność: musi wynosić co najmniej 97%.
Przykładowe urządzenie: prosty termostat
Ta sekcja zawiera przykładowe ładunki intencji reprezentujące wspólny „termostat” określony na podstawie powyższego typu urządzenia i cech. Jeśli dodasz lub usuniesz cechy w swojej implementacji, zmodyfikuj odpowiedzi, by 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 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
}
}
}
}
Przykładowe polecenia EXECUTE
Nastawa temperatury termostatu
Więcej informacji o parametrach poleceń 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
}
}
]
}
}
ZakresUstawienia temperatury termostatu
Więcej informacji o parametrach poleceń 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
}
}
]
}
}
Ustawianie trybu termostatu
Więcej informacji o parametrach poleceń 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
}
}
]
}
}
Urządzenie ERRORS
Zobacz pełną listę błędów i wyjątków.inHeatOrCool– polecenia ogrzewania/chłodzenia/zakresu temperatury nie działają, ponieważ urządzenie jest wyraźnie grzane lub chłodne.inHeatCool– polecenia ogrzewania lub chłodzenia nie działają, ponieważ urządzenie jest nagrzewane lub chłodne.lockedToRange– urządzenie jest zablokowane na podstawie zakresu lub trybu temperatury i nie można wprowadzić żądanej zmiany.rangeTooClose– punkty temperatury w zakresie chłodzenia ogrzewania są zbyt blisko siebie.