Schéma de fan
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 du minuteur actuel. | string Valeurs : "ON", "OFF" |
timerTimeout |
Code temporel, au format RFC 3339, d'expiration du moment où le mode minuteur est désactivé. | string Exemple : "2019-05-10T03:22:54Z" |
Exemple de requête GET et de réponse
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 SetTimer et réponse
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 requête SetTimer
Champ | Description | Type de données |
---|---|---|
timerMode |
Mode de réglage du minuteur du ventilateur. | string Valeurs : "ON", "OFF" |
duration |
Facultatif. Spécifie la durée d'exécution du minuteur, en secondes. | string Plage : "1 s" à "43200s" Par défaut : "900s" |
Erreurs
Le ou les codes d'erreur suivants peuvent être renvoyés pour cette caractéristique:
Message d'erreur | RPC | Dépannage |
---|---|---|
Ventilateur du thermostat indisponible. | FAILED_PRECONDITION |
Le thermostat n'est pas équipé d'un ventilateur. Impossible d'utiliser les fonctionnalités et commandes liées aux fans sur cet appareil. |
Consultez la documentation de référence sur les codes d'erreur de l'API pour la liste complète des codes d'erreur de l'API.