ThermostatMode-Schema

Nest Thermostat 

sdm.devices.traits.ThermostatMode

Diese Eigenschaft gehört zu Gerätetypen vom Typ THERMOSTAT, die verschiedene Thermostatmodi unterstützen.

Felder

Feld Beschreibung Datentyp
availableModes Liste der unterstützten Thermostatmodi array(string)
Wert: ["HEAT", "COOL", "HEATCOOL", "OFF"]
mode Der aktuelle Thermostatmodus. string
Werte: „HEAT“ (Heizen), „COOL“ (Kühlen), „HEATCOOL“ (Heizen und Kühlen), „OFF“ (Aus)

Beispiel für eine GET-Anfrage und -Antwort

Anfrage

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

Antwort

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatMode" : {
      "availableModes" : ["HEAT", "COOL", "HEATCOOL", "OFF"],
      "mode" : "COOL"
    }
  }
}

Befehle

SetMode

Ändern Sie den Thermostatmodus.

SetMode-Anfrage und ‑Antwort

Anfrage

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatMode.SetMode",
  "params" : {
    "mode" : "HEAT"
  }
}

Antwort

{}

Anfragefelder für SetMode

Feld Beschreibung Datentyp
mode Der Modus, in den der Thermostat umgestellt werden soll. string
Werte: „HEAT“, „COOL“, „HEATCOOL“, „AUS“

Fehler

In Bezug auf dieses Attribut können die folgenden Fehlercodes zurückgegeben werden:

Fehlermeldung RPC Fehlerbehebung
Befehl ist im aktuellen Thermostatmodus nicht zulässig. FAILED_PRECONDITION Einige Thermostatmodelle unterstützen laut dem Attribut ThermostatMode nicht, den Eco-Modus zu ändern, wenn der Thermostatmodus deaktiviert ist. Der Thermostatmodus muss auf „HEIZEN“, „KÜHLEN“ oder „HEIZEN/KÜHLEN“ gestellt sein, bevor der Eco-Modus geändert werden kann.

Eine vollständige Liste der API-Fehlercodes findest du in der API-Fehlercode-Referenz.