Conservation de l'état de l'appareil lorsque celui-ci est hors ligne avec Device Shadows

Ces didacticiels vous montrent comment utiliser le service AWS IoT Device Shadow pour stocker et mettre à jour les informations d'état d'un appareil. Le document Shadow, qui est un document JSON, montre la modification de l'état de l'appareil en fonction des messages publiés par un appareil, une application locale ou un service. Dans ce didacticiel, le document Shadow montre le changement de couleur d'une ampoule. Ces didacticiels montrent également comment le shadow stocke ces informations même lorsque l'appareil est déconnecté d'Internet, et transmet les dernières informations d'état à l'appareil lorsqu'il revient en ligne et demande ces informations.

Nous vous recommandons d'essayer ces didacticiels dans l'ordre dans lequel ils sont présentés ici, en commençant par les AWS IoT ressources dont vous avez besoin pour créer et la configuration matérielle nécessaire, ce qui vous permet également d'apprendre les concepts progressivement. Ces didacticiels montrent comment configurer et connecter un appareil Raspberry Pi à utiliser avec AWS IoT. Si vous ne disposez pas du matériel requis, vous pouvez suivre ces didacticiels en les adaptant à l'appareil de votre choix ou en créant un appareil virtuel avec Amazon EC2.

Présentation des scénarios du didacticiel

Le scénario de ces didacticiels est une application ou un service local qui modifie la couleur d'une ampoule et publie ses données sur des sujets d'ombre réservés. Ces didacticiels sont similaires à la fonctionnalité Device Shadow décrite dans le didacticiel de démarrage interactif et sont implémentés sur un appareil Raspberry Pi. Les didacticiels de cette section se concentrent sur une seule ombre classique tout en montrant comment vous pouvez adapter des ombres nommées ou plusieurs appareils.

Les didacticiels suivants vous aideront à apprendre à utiliser le service AWS IoT Device Shadow.

AWS IoT Présentation de Device Shadow

Un Device Shadow est une représentation virtuelle persistante d'un périphérique géré par une ressource objet que vous créez dans le AWS IoT registre. Le document Shadow est un document JSON ou un document de JavaScript notation utilisé pour stocker et récupérer les informations sur l'état actuel d'un appareil. Vous pouvez utiliser l'ombre pour obtenir et définir l'état d'un appareil via des sujets MQTT ou des API HTTP REST, que l'appareil soit ou non connecté à l'internet.

Vous pouvez utiliser l'ombre pour obtenir et définir l'état d'un appareil via des sujets MQTT ou des API HTTP REST, que l'appareil soit ou non connecté à l'internet.

Voici un exemple de document de l'État fantôme.

{
  "state": {
    "desired": {
      "color": "green"
      },
    "reported": {
      "color": "blue"
      },
    "delta": {
      "color": "green"
      }
   }
}

Pour mettre à jour le document Shadow d'un appareil, vous pouvez utiliser les rubriques MQTT réservées, les API REST Device Shadow qui prennent en charge le GET, UPDATE, protocole HTTP et les DELETE opérations avec le protocole HTTP, ainsi que la AWS IoT CLI.

Dans l'exemple précédent, supposons que vous souhaitiez changer la desired couleur enyellow. Pour ce faire, envoyez une demande à l'UpdateThingShadowAPI ou publiez un message dans la rubrique Mise à jour, $aws/things/THING_NAME/shadow/update.

{
  "state": {
    "desired": {
      "color": yellow
    }
  }
} 

Les mises à jour concernent uniquement les champs spécifiés dans la demande. Une fois la mise à jour réussie de Device Shadow, AWS IoT publie le nouvel desired état dans la delta rubrique$aws/things/THING_NAME/shadow/delta. Dans ce cas, le document Shadow ressemble à ceci :

{
  "state": {
    "desired": {
      "color": yellow
    },
    "reported": {
      "color": green
    },
    "delta": {
      "color": yellow
      }
  }
} 

Le nouvel état est ensuite signalé au AWS IoT Device Shadow à l'aide de la Update rubrique $aws/things/THING_NAME/shadow/update contenant le message JSON suivant :

{
  "state": {
    "reported": {
      "color": yellow
    }
  }
} 

Si vous souhaitez obtenir les informations sur l'état actuel, envoyez une demande à l'GetThingShadowAPI ou publiez un message MQTT dans la rubrique Get,$aws/things/THING_NAME/shadow/get.

Pour plus d'informations, consultez Service d'ombre de périphérique dans le AWS IoT Service Device Shadow.

Pour plus d'informations sur l'utilisation de Device Shadows dans les appareils, les applications et les services, consultez Utilisation des shadows sur les appareils et Utilisation des shadows dans les applications et les services.

Pour plus d'informations sur l'interaction avec AWS IoT les ombres, consultezInteraction avec les shadows.

Pour plus d'informations sur les sujets réservés au MQTT et les API REST HTTP, consultez Rubriques MQTT de Device Shadow etAPI REST Device Shadow.