Ventilatorschema

Nest Thermostat 

sdm.devices.traits.Fan

Dieses Merkmal gehört zu allen Geräten, die das System zur Steuerung des Ventilators verwenden können.

Felder

Feld Beschreibung Datentyp
timerMode Aktueller Timer-Modus. string
Werte: „ON“, „OFF“
timerTimeout Zeitstempel im RFC 3339-Format, zu dem der Timer-Modus auf „OFF“ gesetzt wird. string
Beispiel: „2019-05-10T03:22:54Z“

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.Fan" : {
      "timerMode" : "ON",
      "timerTimeout" : "2019-05-10T03:22:54Z"
    }
  }
}

Befehle

SetTimer

Den Ventilator-Timer ändern.

SetTimer-Anfrage und -Antwort

Anfrage

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.Fan.SetTimer",
  "params" : {
    "timerMode" : "ON",
    "duration" : "3600s"
  }
}

Antwort

{}

SetTimer-Anfragefelder

Feld Beschreibung Datentyp
timerMode Der Modus, in dem der Ventilator-Timer eingestellt werden soll. string
Werte: „ON“, „OFF“
duration Optional. Gibt die Zeit in Sekunden an, für die der Timer eingestellt ist. string
Bereich: „1s“ bis „43200s“
Standard: „900s“

Fehler

Die folgenden Fehlercodes können im Zusammenhang mit diesem Merkmal zurückgegeben werden:

Fehlermeldung RPC Fehlerbehebung
Thermostat-Ventilator nicht verfügbar. FAILED_PRECONDITION Der Thermostat hat keine Ventilatorfunktion. Ventilatorbezogene Merkmale und Befehle können für dieses Gerät nicht verwendet werden.

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