Schéma du ventilateur
sdm.devices.traits.Fan
Cette caractéristique appartient à tout appareil capable de contrôler le ventilateur.
Champs
Champ | Description | Type de données |
---|---|---|
timerMode |
Mode minuteur actuel. | string Valeurs: "ON", "OFF" |
timerTimeout |
Code temporel, au format RFC 3339, auquel le mode minuteur sera désactivé. | string Exemple: "2019-05-10T03:22:54Z" |
Exemple de requête et de réponse GET
Requête
GET /enterprises/project-id/devices/device-id
Réponse
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.Fan
" : {
"timerMode" : "ON",
"timerTimeout" : "2019-05-10T03:22:54Z"
}
}
}
Commandes
SetTimer
Modifier le minuteur du ventilateur
Requête et réponse SetTimer
Requête
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.Fan.SetTimer
",
"params" : {
"timerMode" : "ON",
"duration" : "3600s"
}
}
Réponse
{}
Champs de la requête SetTimer
Champ | Description | Type de données |
---|---|---|
timerMode |
Mode permettant de régler le minuteur du ventilateur. | string Valeurs: "ON", "OFF" |
duration |
Facultatif. Spécifie la durée d'exécution du minuteur, en secondes. | string Plage : de "1 s" à "43200 s" Valeur par défaut: "900 s" |
Erreurs
Le ou les codes d'erreur suivants peuvent être renvoyés en lien avec cette caractéristique:
Message d'erreur | RPC | Dépannage |
---|---|---|
Ventilateur du thermostat indisponible. | FAILED_PRECONDITION |
Le thermostat n'est pas équipé d'un ventilateur. Les caractéristiques et les commandes liées aux fans ne peuvent pas être utilisées sur cet appareil. |
Consultez la documentation de référence sur les codes d'erreur de l'API pour obtenir la liste complète des codes d'erreur de l'API.