ThermostatMode-Schema

Nest Thermostat 

sdm.devices.traits.ThermostatMode

Dieses Attribut gehört zu Gerätetypen des Typs 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“, „COOL“, „HEATCOOL“, „OFF“

Beispiel für 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

Ändere 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

{}

SetMode-Anfragefelder

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

Fehler

Die folgenden Fehlercodes können in Bezug auf dieses Attribut zurückgegeben werden:

Fehlermeldung RPC Fehlerbehebung
Der Befehl ist im aktuellen Thermostatmodus nicht zulässig. FAILED_PRECONDITION Bei einigen Thermostatmodellen kann der Eco-Modus nicht geändert werden, wenn der Thermostatmodus gemäß dem ThermostatMode -Trait auf „Aus“ eingestellt ist. Der Thermostatmodus muss auf HEIZEN, KÜHLEN oder HEIZENKÜHLEN geändert werden, bevor der Eco-Modus geändert werden kann.

Eine vollständige Liste der API-Fehlercodes finden Sie in der API-Fehlercode-Referenz.