Lüfterschema
sdm.devices.traits.Fan
Diese Eigenschaft gehört zu jedem Gerät, das über ein System zur Steuerung des Lüfters verfügt.
Felder
Feld | Beschreibung | Datentyp |
---|---|---|
timerMode |
Aktueller Timermodus. | string Werte: „EIN“, „AUS“ |
timerTimeout |
Zeitstempel im RFC 3339-Format, zu dem der Timermodus deaktiviert 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
Timer für Lüfter ändern
Anforderung und Antwort "SetTimer"
Anfrage
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.Fan.SetTimer
",
"params" : {
"timerMode" : "ON",
"duration" : "3600s"
}
}
Antwort
{}
Anforderungsfelder für SetTimer
Feld | Beschreibung | Datentyp |
---|---|---|
timerMode |
Der Modus zum Einstellen des Lüfter-Timers. | string Werte: „EIN“, „AUS“ |
duration |
Optional. Gibt die Dauer in Sekunden an, die der Timer ausgeführt werden soll. | string Bereich: „1s“ auf „43.200s“ Standard: „900s“ |
Fehler
Die folgenden Fehlercodes können in Bezug auf dieses Merkmal zurückgegeben werden:
Fehlermeldung | RPC | Fehlerbehebung |
---|---|---|
Lüfter des Thermostats nicht verfügbar. | FAILED_PRECONDITION |
Der Thermostat hat keine Lüfterfunktion. Lüfterbezogene Traits und Befehle können für dieses Gerät nicht verwendet werden. |
In der API-Fehlercode-Referenz können Sie nachlesen, die vollständige Liste der API-Fehlercodes.