ThermostatMode-Schema

Nest Thermostat 

sdm.devices.traits.ThermostatMode

Diese Eigenschaft gehört zu den Gerätetypen von THERMOSTAT, die unterschiedliche 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

Anfragen

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

Thermostatmodus ändern.

SetMode-Anfrage und -Antwort

Anfragen

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, auf den der Thermostat eingestellt werden soll. string
Werte: „HEAT“, „COOL“, „HEATCOOL“, „OFF“

Fehler

Folgende Fehlercodes können in Bezug auf dieses Merkmal zurückgegeben werden:

Fehlermeldung RPC Fehlerbehebung
Der Befehl ist im aktuellen Thermostatmodus nicht zulässig. FAILED_PRECONDITION Bei einigen Thermostatmodellen wird es gemäß der Eigenschaft ThermostatMode nicht unterstützt, den Eco-Modus zu ändern, wenn der Thermostatmodus ausgeschaltet ist. Der Thermostatmodus muss vor dem Umschalten auf den Eco-Modus auf HEIZEN, KÜHLEN oder HEIZENKÜHLEN umgestellt werden.

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