IoT Platform propose la fonctionnalité de shadow de périphérique pour mettre en cache les données d'état envoyées par chaque périphérique ainsi que les commandes transmises par les applications. Les périphériques connectés peuvent recevoir des commandes depuis IoT Platform. Si les périphériques sont hors ligne, vous pouvez récupérer les commandes depuis IoT Platform une fois qu'ils se reconnectent. Cette rubrique décrit les cas d'utilisation de la fonctionnalité de shadow de périphérique et explique comment l'utiliser.
Shadows de périphérique
Un shadow de périphérique est un fichier JSON qui stocke les données d'état soumises par un périphérique et les données d'état souhaitées par les applications. Pour plus d'informations sur les données JSON, consultez la section Format JSON des shadows de périphérique.
Chaque périphérique ne possède qu'un seul shadow. Un périphérique peut obtenir ou configurer son shadow dans IoT Platform via le protocole MQTT (Message Queuing Telemetry Transport) afin de synchroniser l'état.
Différences entre les shadows de périphérique et les valeurs de propriété souhaitées
Les valeurs de propriété souhaitées et les shadows de périphérique constituent des données souhaitées stockées dans IoT Platform. Une fois connectés, les périphériques récupèrent ces données souhaitées pour exécuter la logique métier correspondante. Le tableau suivant présente les différences entre les valeurs de propriété souhaitées et les shadows de périphérique selon leur champ d'application.
|
Élément |
Description |
|
Valeurs de propriété souhaitées |
Le champ d'application est restreint. Vous ne pouvez spécifier des valeurs que pour les propriétés du langage de spécification des objets (TSL) d'un périphérique. Avant d'utiliser cette fonctionnalité, vous devez définir un modèle TSL pour le périphérique. Utilisez cette fonctionnalité si vous souhaitez spécifier des valeurs souhaitées pour les propriétés TSL d'un périphérique. Pour plus d'exemples, consultez la section Spécifier une valeur de propriété souhaitée pour contrôler l'état d'une ampoule. |
|
Shadows de périphérique |
Le champ d'application est étendu. Cette fonctionnalité est indépendante des propriétés TSL. Vous pouvez l'utiliser pour spécifier des données relatives aux périphériques, telles que l'état du périphérique. La section suivante décrit des scénarios spécifiques. Pour savoir comment configurer les shadows de périphérique, consultez la section Format JSON des shadows de périphérique. |
Scénarios
Dans les scénarios suivants, utilisez la fonctionnalité de shadow de périphérique pour récupérer les données d'état soumises par les périphériques et les données d'état souhaitées par les applications.
-
Les applications demandent l'état du périphérique.
Scénarios :
Un périphérique se connecte et se déconnecte fréquemment en raison de l'instabilité du réseau. Dans ce cas, le périphérique ne peut pas traiter les requêtes provenant des applications.
Plusieurs applications peuvent demander simultanément les données d'état du périphérique. Le périphérique ne peut pas gérer ces requêtes concurrentes ni renvoyer de réponses aux applications.
Synchronisez l'état du périphérique vers le shadow dans IoT Platform. Les applications peuvent ainsi récupérer les données d'état les plus récentes depuis le shadow. Cette approche découple les applications du périphérique.
La figure suivante illustre ce processus. Pour plus d'informations, consultez la section Le périphérique soumet l'état.
-
Les applications envoient des commandes pour modifier l'état du périphérique.
Description : Un périphérique est hors ligne ou se connecte et se déconnecte fréquemment en raison de l'instabilité du réseau. Dans ce cas, l'envoi des commandes depuis les applications vers le périphérique peut échouer.
Stockez les commandes avec leurs horodatages dans le shadow. Une fois le périphérique reconnecté, il récupère les commandes depuis le shadow et décide de les traiter ou non en fonction des horodatages.
La figure suivante illustre ce processus. Pour plus d'informations, consultez les sections Les applications modifient l'état du périphérique, Le périphérique demande le shadow et Le périphérique supprime les propriétés du shadow.
Afficher et mettre à jour un shadow de périphérique
Vous devez configurer la fonctionnalité de shadow de périphérique pour le périphérique concerné. Pour plus d'informations, consultez la section Shadow de périphérique.
Après avoir configuré le périphérique et l'avoir connecté à IoT Platform, vous pouvez afficher et mettre à jour l'état du shadow de périphérique dans la console IoT Platform.
Connectez-vous à la console IoT Platform.
Sur la page Overview, localisez l'instance à gérer et cliquez sur son ID ou son nom.
Dans le volet de navigation de gauche, choisissez .
Sur la page Devices, localisez le périphérique à gérer et cliquez sur View dans la colonne Actions. La page Device Details s'affiche.
-
Cliquez sur l'onglet Device Shadow. Sur cet onglet, vous pouvez consulter le shadow de périphérique soumis par le périphérique.
-
Cliquez sur Update Shadow. Saisissez les informations d'état souhaitées dans la section
"desired".Pour connaître le format des shadows de périphérique, consultez la section Format JSON des shadows de périphérique.
Le périphérique récupère les données d'état souhaitées en s'abonnant à une rubrique spécifique. Si le périphérique est en ligne, IoT Platform lui transmet les données d'état souhaitées en temps réel.
Si le périphérique est hors ligne, le shadow met en cache les données d'état souhaitées. Une fois le périphérique reconnecté, il extrait les dernières données d'état souhaitées depuis IoT Platform.
Opérations API associées
GetDeviceShadow : interroge un shadow de périphérique.
UpdateDeviceShadow : met à jour un shadow de périphérique.