IoT Platform propose la fonctionnalité de device shadow pour mettre en cache les états envoyés par les appareils et les commandes transmises par la plateforme. Les appareils connectés reçoivent les commandes depuis IoT Platform. Si les appareils sont hors ligne, récupérez les commandes auprès d'IoT Platform une fois qu'ils se reconnectent. Cette rubrique explique comment configurer Link SDK for C pour utiliser la fonctionnalité de device shadow.
Prérequis
Vous disposez des informations d'authentification de l'appareil.
-
Lorsque vous personnalisez le SDK, activez l'option dans la section Device shadow.
Informations générales
-
Un device shadow est un fichier JSON stocké dans IoT Platform. Ce shadow sert à mettre en cache les propriétés de l'appareil soumises (
reported) ainsi que les propriétés souhaitées par les applications cloud (desired).Pour plus d'informations, consultez la rubrique Présentation du device shadow.
Pour en savoir plus sur le format JSON des device shadows, consultez la rubrique Format JSON du device shadow.
Pour obtenir des détails sur le processus de transfert de données des device shadows, consultez la rubrique Flux de données du device shadow.
no heading
Fonctionnement
Un appareil appelle les opérations d'API de Link SDK for C pour envoyer ses informations d'état à IoT Platform via MQTT. IoT Platform met ces informations en cache sous forme de device shadow. L'appareil peut ensuite interroger ou supprimer des propriétés contenues dans ce shadow en appelant les opérations d'API appropriées.
Le schéma suivant illustre ce processus. Dans cet exemple, le fichier de code d'exemple ./demos/shadow_basic_demo.c est utilisé.
Pour plus d'informations sur les opérations d'API spécifiques aux device shadows, consultez la documentation relative à aiot_shadow_api.h.
no heading
Exemples
Pour consulter un exemple de code illustrant la fonctionnalité de connexion MQTT, reportez-vous à la rubrique Exemples d'utilisation.
Pour connaître les codes d'erreur associés à la fonctionnalité de connexion MQTT, consultez les descriptions des codes de statut dans aiot_shadow_api.h.