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 dla trybów Chłodzenie i Chłodzenie/Ogrzewanie. number
Przykład: 22,0

Przykład żądania GET i odpowiedzi – HEAT

ŻądanieOdpowiedź
GET /enterprises/project-id/devices/device-id
 
{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

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

ŻądanieOdpowiedź
GET /enterprises/project-id/devices/device-id
 
{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

Przykład żądania GET i odpowiedzi – HEATCOOL

ŻądanieOdpowiedź
GET /enterprises/project-id/devices/device-id
 
{
  "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 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 najpierw znajdować się w trybie ogrzewania:

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

Pamiętaj, że polecenia dotyczące punktu odniesienia przyjmują jako parametr tylko stopnie Celsjusza, ale termostat Google Nest może wyświetlać temperaturę w stopniach Celsjusza lub Fahrenheita.

SetHeat

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

Żądanie i odpowiedź SetHeat

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

{}

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

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

{}

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

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

{}

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 Eco, 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 Gdy termostat jest w ręcznym trybie eko, nie można ustawić punktu regulacji temperatury.

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