Schemat ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Ta cecha należy do typów urządzeń TERMOSTAT, które obsługują ustawianie docelowej temperatury i zakresu temperatury.

Pola

Pole Opis Typ danych
heatCelsius Docelowa temperatura w stopniach Celsjusza dla trybów termostatu HEAT i HEATCOOL. number
Przykład: 20,0
coolCelsius Docelowa temperatura w stopniach Celsjusza na termostacie w trybach CHŁODZANIE i Ogrzewanie chłodniczego. number
Przykład: 22,0

Przykładowe żądanie i odpowiedź GET – HEAT

Żądanie

GET /enterprises/project-id/devices/device-id

Odpowiedź

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

Przykładowe żądanie i odpowiedź GET – COOL

Żądanie

GET /enterprises/project-id/devices/device-id

Odpowiedź

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

Przykład żądania GET i odpowiedzi – HEATCOOL

Żądanie

GET /enterprises/project-id/devices/device-id

Odpowiedź

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

Polecenia

Przed zmianą wartości punktu odniesienia temperatury termostat musi być w trybie odpowiadającym wywoływanemu poleceniu. Polecenie i pola służące do zmiany wartości punktu regulacji różnią się w zależności od trybu termostatu.

Na przykład, aby wydać polecenie SetHeat , termostat musi być najpierw w trybie ogrzewania:

Tryb Polecenie Pola
OGRZEWANIE SetHeat heatCelsius
CHŁODNE SetCool coolCelsius
HEATCOOL SetRange heatCelsius, coolCelsius

Pamiętaj, że polecenia dotyczące ustawienia temperatury przyjmują tylko stopnie w stopniach Celsjusza, ale Google Nest Thermostat może wyświetlać temperaturę w stopniach Celsjusza lub Fahrenheita.

SetHeat

Ustawia temperaturę docelową, gdy termostat jest w trybie Ogrzewanie.

Żądanie i odpowiedź SetHeat

Żądanie

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

Odpowiedź

{}

Pola żądania SetHeat

Pole Opis Typ danych
heatCelsius Docelowa temperatura, która ma być ustawiona, gdy termostat pracuje w trybie grzania. number
Przykład: 22,0

SetCool

Ustawia temperaturę docelową, gdy termostat jest w trybie Chłodzenie.

Żądanie i odpowiedź SetCool

Żądanie

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

Odpowiedź

{}

Pola żądania SetCool

Pole Opis Typ danych
coolCelsius Docelowa temperatura, która ma być ustawiona, gdy termostat jest w trybie chłodzenia. number
Przykład: 20,0

SetRange

Ustawia minimalną i maksymalną temperaturę, gdy termostat jest w trybie HEATCOOL.

Żądanie i odpowiedź SetRange

Żądanie

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

Odpowiedź

{}

Pola żądania SetRange

Pole Opis Typ danych
heatCelsius Minimalna docelowa temperatura, którą należy ustawić, gdy termostat jest w trybie HEATCOOL. number
Przykład: 20,0
coolCelsius Maksymalna docelowa temperatura, którą należy ustawić, gdy termostat jest w trybie HEATCOOL. number
Przykład: 22,0

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 niedozwolone w bieżącym 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.
Wartość chłodzenia musi być większa niż wartość ogrzewania. INVALID_ARGUMENT Upewnij się, że pole heatCelsius jest mniejsze niż pole coolCelsius w poleceniu.
Polecenie niedozwolone, gdy termostat jest w trybie MANUAL_ECO. FAILED_PRECONDITION Nie można ustawić nastawy temperatury, gdy termostat jest w ręcznym trybie Eko.

Pełną listę kodów błędów interfejsu API znajdziesz w przewodniku po kodach błędów interfejsu API.