Schemat ThermostatEco
sdm.devices.traits.ThermostatEco
Ta cecha 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 rozpoczyna ogrzewanie w trybie Eco. | number Przykład: 20,0 |
coolCelsius |
Najwyższa temperatura w stopniach Celsjusza, przy której termostat rozpoczyna chłodzenie w trybie Eco. | number Przykład: 22,0 |
Przykładowe żądanie i odpowiedź GET
Żą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
Zmień tryb eko termostatu.
Aby zmienić tryb termostatu na HEAT, COOL lub HEATCOOL, użyj polecenia SetMode atrybutu ThermostatMode.
To polecenie wpływa na inne cechy w zależności od obecnego stanu trybu Eko lub jego zmiany:
- Jeśli tryb Eco jest WYŁĄCZONY, tryb termostatu zostanie domyślnie ustawiony na ostatni tryb standardowy (HEAT, COOL, HEATCOOL lub OFF), który był aktywny.
- Jeśli tryb eko to MANUAL_ECO:
- Polecenia dotyczące ThermostatTemperatureSetpoint w trybie portretowym są odrzucane.
- Wartości graniczne temperatury nie są zwracane przez ThermostatTemperatureSetpoint w trybie poziomym.
Żą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, w którym termostat ma się przełączyć. | string Wartości: „MANUAL_ECO”, „OFF” |
Błędy
W związku z tą cechą mogą zostać zwrócone te kody błędów:
Komunikat o błędzie | RPC | Rozwiązywanie problemów |
---|---|---|
Polecenie jest niedozwolone w obecnym trybie termostatu. | FAILED_PRECONDITION |
Niektóre modele termostatów nie obsługują zmiany trybu Eko, gdy tryb termostatu jest wyłączony, zgodnie z ThermostatMode w układach pionowych. Przed zmianą trybu Eco termostat musi zostać przełączony na tryb GRZEJ, CHŁODZ lub GRZEJ/CHŁODZ. |
Polecenie jest niedozwolone, gdy termostat w trybie MANUAL_ECO. | FAILED_PRECONDITION |
Gdy termostat jest w ręcznym trybie eko, nie można ustawić punktu odniesienia temperatury. |
Pełną listę kodów błędów interfejsu API znajdziesz w dokumentacji kodu błędu interfejsu API.