Schemat ThermostatEco
sdm.devices.traits.ThermostatEco
Ten atrybut należy do typów urządzeń THERMOSTAT, które obsługują tryby ECO.
Pola
Pole | Opis | Typ danych |
---|---|---|
availableModes |
Lista obsługiwanych trybów Eco. | array(string) Wartość: ["MANUAL_ECO", "OFF"] |
mode |
Bieżący tryb eko termostatu. | string Wartości: „MANUAL_ECO”, „OFF” |
heatCelsius |
Najniższa temperatura w stopniach Celsjusza, przy której termostat zaczyna ogrzewać w trybie eko. | number Przykład: 20,0 |
coolCelsius |
Najwyższa temperatura w stopniach Celsjusza, przy której termostat zaczyna chłodzić w trybie eko. | number Przykład: 22,0 |
Przykładowe żądanie GET i odpowiedź
Żądanie
GET /enterprises/project-id/devices/device-id
Odpowiedź
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatEco
" : {
"availableModes" : ["MANUAL_ECO", "OFF"],
"mode" : "MANUAL_ECO",
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
Polecenia
SetMode
zmieniać tryb eko termostatu;
Aby zmienić tryb termostatu na HEAT, COOL lub HEATCOOL, użyj polecenia SetMode cechy ThermostatMode.
To polecenie wpływa na inne cechy w zależności od bieżącego stanu trybu Eco lub zmian w nim:
- Jeśli tryb Eko jest WYŁĄCZONY, termostat domyślnie przełączy się na ostatni aktywny tryb standardowy (OGRZEWANIE, CHŁODZENIE, OGRZEWANIE/CHŁODZENIE lub WYŁĄCZONY).
- Jeśli tryb eko to MANUAL_ECO:
- Polecenia dotyczące cechy ThermostatTemperatureSetpoint są odrzucane.
- Ustawione temperatury nie są zwracane przez cechę ThermostatTemperatureSetpoint .
Żądanie i odpowiedź SetMode
Żądanie
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatEco.SetMode
",
"params" : {
"mode" : "MANUAL_ECO"
}
}
Odpowiedź
{}
Pola żądania SetMode
Pole | Opis | Typ danych |
---|---|---|
mode |
Tryb Eko, na który ma zostać przełączony termostat. | string Wartości: „MANUAL_ECO”, „OFF” |
Błędy
W związku z tym atrybutem mogą być zwracane te kody błędów:
Komunikat o błędzie | RPC | Rozwiązywanie problemów |
---|---|---|
Polecenie jest niedozwolone w bieżącym trybie termostatu. | FAILED_PRECONDITION |
Niektóre modele termostatów nie obsługują zmiany trybu Eko, gdy termostat jest wyłączony, zgodnie z atrybutem ThermostatMode . Przed zmianą trybu Eko należy zmienić tryb termostatu na GRZANIE, CHŁODZENIE lub GRZANIE/CHŁODZENIE. |
Polecenie jest niedozwolone, gdy termostat jest w trybie MANUAL_ECO. | FAILED_PRECONDITION |
Gdy termostat jest w ręcznym trybie eko, nie można ustawić temperatury docelowej. |
Pełną listę kodów błędów interfejsu API znajdziesz w dokumentacji kodów błędów interfejsu API.