Device Update pour Azure IoT Hub utilisant Azure RTOS

Cet article explique comment créer l’agent Device Update pour Azure IoT Hub dans Azure RTOS NetX Duo. Il fournit également des API simples permettant aux développeurs d’intégrer les fonctionnalités de Device Update dans leur application. Explorez les exemples de cartes d’évaluation des semiconducteurs clés qui incluent des guides de démarrage pour apprendre à configurer, générer et déployer des mises à jour OTA sur les appareils.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Prérequis

• Accès à une instance IoT Hub. Il est recommandé d’utiliser un niveau S1 (Standard) ou supérieur.
• Une instance et un compte Device Update liés à votre hub IoT. Suivez le guide montrant comment créer et lier un compte Device Update si vous ne l’avez pas encore fait.

Bien démarrer

Chaque exemple de projet de système d'exploitation en temps réel (RTOS) Azure spécifique à une carte contient du code et de la documentation sur l’utilisation de Device Update pour IoT Hub. Vous allez :

1. Téléchargez les exemples de fichiers spécifiques à une carte à partir des exemples Azure RTOS et Device Update.
2. Recherchez le dossier docs à partir de l’exemple téléchargé.
3. À partir de la documentation, suivez les étapes pour préparer les ressources Azure et un compte, et y inscrire les appareils IoT.
4. Suivez la documentation pour générer une nouvelle image de microprogramme et importer le manifeste pour votre carte.
5. Publiez l’image du microprogramme et le manifeste sur Device Update pour IoT Hub.
6. Téléchargez et exécutez le projet sur votre appareil.

Apprenez-en davantage sur Azure RTOS.

Étiqueter votre appareil

1. Veillez à ce que l’application de l’appareil de l’étape précédente soit toujours en cours d’exécution.

2. Connectez-vous au portail Azure et accédez à votre hub IoT.

3. Dans le volet gauche, sélectionnez Appareils. Recherchez votre appareil IoT et accédez au jumeau d’appareil.

4. Dans le jumeau d’appareil, supprimez toutes les valeurs d’étiquette Device Update existantes en leur affectant la valeur null.

5. Ajoutez une nouvelle valeur d’étiquette Device Update à l’objet JSON racine, comme indiqué :

       "tags": {
               "ADUGroup": "<CustomTagValue>"
               }
   

Créer un groupe de mise à jour

1. Accédez à l’onglet Groupes et déploiements en haut de la page.

   

2. Sélectionnez Ajouter un groupe pour créer un groupe.

   

3. Sélectionnez une étiquette IoT Hub et une classe d’appareil dans la liste. Sélectionnez ensuite Créer un groupe.

   

4. Une fois le groupe créé, vous voyez que la liste des groupes et le graphique de conformité des mises à jour ont été mis à jour. Le graphique de conformité des mises à jour montre le nombre d’appareils dans différents états de conformité : À la mise à jour la plus récente, Nouvelles mises à jour disponibles et Mises à jour en cours. En savoir plus sur la conformité des mises à jour.

   

5. Vous voyez maintenant le groupe que vous venez de créer ainsi que toutes les mises à jour disponibles pour les appareils dans le nouveau groupe. Si des appareils ne répondent pas aux exigences de classe d’appareil du groupe, ils apparaissent dans un groupe non valide correspondant. Pour déployer la meilleure mise à jour disponible sur le nouveau groupe défini par l’utilisateur à partir de cet affichage, sélectionnez Déployer à côté du groupe.

En savoir plus sur l’ajout d’étiquettes et la création de groupes de mises à jour.

Déployer un nouveau microprogramme

1. Une fois le groupe créé, vous devriez voir une nouvelle mise à jour disponible pour votre groupe d’appareils, avec un lien vers cette mise à jour sous Meilleure mise à jour. Vous devrez peut-être actualiser une fois. En savoir plus sur la conformité des mises à jour.

2. Sélectionnez le groupe cible en sélectionnant le nom du groupe. Vous êtes redirigé vers les détails du groupe sous Informations de base du groupe.

   

3. Pour démarrer le déploiement, accédez à l’onglet Déploiement actuel. Sélectionnez le lien de déploiement à côté de la mise à jour souhaitée dans la section Mises à jour disponibles. La meilleure mise à jour disponible pour un groupe donné est indiquée par la mention Optimale.

   

4. Planifiez votre déploiement pour qu’il démarre immédiatement ou plus tard. Sélectionnez ensuite Créer.

   Conseil

   Par défaut, la date et l’heure de Début est définie sur 24 heures à partir de votre heure actuelle. Veillez à sélectionner une autre date et heure si vous souhaitez que le déploiement commence plus tôt.

   

5. Sous Détails du déploiement, État devient Actif. La mise à jour déployée est marquée avec la mention (déploiement en cours).

   

6. Affichez le graphique de conformité pour voir que la mise à jour est maintenant en cours.

7. Une fois votre appareil correctement mis à jour, vous voyez que votre graphique de conformité et les détails du déploiement sont mis à jour pour concorder.

   

Surveiller le déploiement de la mise à jour

1. Sélectionnez l’onglet Historique du déploiement en haut de la page.

   

2. Sélectionnez Détails à côté du déploiement que vous avez créé.

   

3. Sélectionnez Actualiser pour voir les détails d’état les plus récents.

Vous avez maintenant réussi une mise à jour d’image de bout en bout à l’aide du service Device Update pour IoT Hub sur un appareil Azure RTOS embarqué.

Étapes suivantes

Pour en savoir plus sur Azure RTOS et son fonctionnement avec IoT Hub, consultez la page web Azure RTOS.