Schéma des fans
sdm.devices.traits.Fan
Ce trait appartient à tout appareil doté de la capacité système de contrôler le ventilateur.
Champs
Champ | Description | Type de données |
---|---|---|
timerMode |
Mode de minuteur actuel. | string Valeurs : "ON", "OFF" |
timerTimeout |
Code temporel au format RFC 3339 auquel le mode Timer 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 la minuterie 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 de réglage de la minuterie du ventilateur. | string Valeurs : "ON", "OFF" |
duration |
Facultatif. Indique la durée, en secondes, pendant laquelle le minuteur doit fonctionner. | string Plage : de "1s" à "43200s" Valeur par défaut : "900s" |
Erreurs
Les codes d'erreur suivants peuvent être renvoyés en lien avec ce trait :
Message d'erreur | RPC | Dépannage |
---|---|---|
Le ventilateur du thermostat n'est pas disponible. | FAILED_PRECONDITION |
Le thermostat n'est pas compatible avec un ventilateur. Les traits et commandes liés au ventilateur ne peuvent pas être utilisés pour 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.