Tutoriel : Connecter un appareil IoT Edge à votre application Azure IoT Central

Ce tutoriel vous montre comment connecter un appareil IoT Edge à votre application Azure IoT Central. L’appareil IoT Edge exécute un module qui envoie des données de télémétrie de température, de pression et d’humidité à votre application. Vous utilisez un modèle d’appareil pour activer les affichages et les formulaires qui vous permettent d’interagir avec le module sur l’appareil IoT Edge.

Dans ce tutoriel, vous apprenez à effectuer les opérations suivantes :

• Importer un manifeste de déploiement IoT Edge dans votre application IoT Central.
• Ajoutez un appareil IoT Edge qui utilise ce manifeste de déploiement à votre application.
• Connecter l’appareil IoT Edge à votre application.
• Surveillez le runtime IoT Edge à partir de votre application.
• Ajoutez un modèle d’appareil avec des affichages et des formulaires à votre application.
• Affichez les données de télémétrie envoyées à partir de l’appareil dans votre application.

Prérequis

Pour suivre les étapes de ce tutoriel, vous devez disposer des éléments suivants :

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

• Application IoT Central créée à partir du modèle Application personnalisée. Pour plus d’informations, consultez Créer une application IoT Central et À propos de votre application.

Vous devez également être en mesure de charger des fichiers de configuration dans votre application IoT Central à partir de votre ordinateur local.

Importer un manifeste de déploiement

Un manifeste de déploiement spécifie la configuration d’un appareil IoT Edge, y compris les détails des modules personnalisés que l’appareil doit télécharger et exécuter. IoT Edge appareils qui se connectent à une application IoT Central téléchargent leurs manifestes de déploiement à partir de l’application.

Pour ajouter un manifeste de déploiement à IoT Central à utiliser dans ce tutoriel :

1. Téléchargez et enregistrez le manifeste de déploiement EnvironmentalSensorManifest-1-4.json sur votre ordinateur local.

2. Dans votre application IoT Central, accédez à la page Manifestes Edge.

3. Sélectionnez +Nouveau.

4. Dans la page Personnaliser, entrez Capteur environnemental comme nom, puis chargez le fichier EnvironmentalSensorManifest-1-4.json .

5. Une fois le fichier manifeste validé, sélectionnez Suivant.

6. La page Vérifier et terminer affiche les modules définis dans le manifeste, y compris le module personnalisé SimulatedTemperatureSensor . Sélectionnez Créer.

La liste des manifestes Edge inclut désormais le manifeste du capteur environnemental :

Ajouter un appareil IoT Edge

Pour que l’appareil IoT Edge puisse se connecter à votre application IoT Central, vous devez l’ajouter à la liste des appareils et obtenir ses informations d’identification :

1. Accédez à la page Appareils de votre application IoT Central.

2. Dans la page Appareils , vérifiez que Tous les appareils est sélectionné. Sélectionnez + Nouveau.

3. Sur la page Créer un appareil, sélectionnez :

   • Entrez Capteur environnemental - 001 comme nom de l’appareil.
   • Entrez env-sens-001 comme ID d’appareil.
   • Assurez-vous que le modèle de périphérique n'est pas attribué.
   • Assurez-vous que l’appareil n’est pas simulé.
   • Définissez Azure IoT Edge appareil sur Oui.
   • Sélectionnez le manifeste de déploiement IoT Edge capteur environnemental.

4. Sélectionnez Créer.

La liste des appareils de la page Appareils inclut désormais l’appareil Capteur environnemental - 001 . L’état de l’appareil correspond à Inscrit:

Avant de déployer l’appareil IoT Edge, vous devez :

• Étendue de l’ID de votre application IoT Central.
• Valeurs d’ID d’appareil pour l’appareil IoT Edge.
• Valeurs de clé primaire pour l’appareil IoT Edge.

Pour trouver ces valeurs, accédez à l’appareil Capteur environnemental - 001 dans la page Appareils, puis sélectionnez Se connecter. Prenez note de ces valeurs avant de continuer.

Déployer l’appareil IoT Edge

Dans ce didacticiel, vous déployez le runtime IoT Edge sur une machine virtuelle Linux dans Azure. Pour déployer et configurer la machine virtuelle, sélectionnez le bouton suivant :

Dans la page Déploiement personnalisé , utilisez les valeurs suivantes pour remplir le formulaire :

Paramètre	Valeur
Resource group	Créez un groupe de ressources portant un nom tel que MyIoTEdgeDevice_rg.
Region	Sélectionnez une région proche de chez vous.
Dns Label Prefix	Préfixe DNS unique pour votre machine virtuelle.
Admin Username	AzureUser
Admin Password	Un mot de passe de votre choix pour accéder à la machine virtuelle.
Scope Id	Étendue d’ID que vous avez notée précédemment.
Device Id	ID d’appareil dont vous avez pris note précédemment.
Device Key	ID d’appareil dont vous avez pris note précédemment.

Sélectionnez Vérifier + créer, puis Créer. Attendez que le déploiement se termine avant de continuer.

Gérer l’appareil IoT Edge

Pour vérifier que le déploiement de l’appareil IoT Edge a réussi :

1. Accédez à la page Appareils de votre application IoT Central. Vérifiez que l’état de l’appareil Capteur environnemental - 001 est provisionné. Vous devrez peut-être attendre quelques minutes pendant que l’appareil se connecte.

2. Accédez à l’appareil Capteur environnemental - 001 .

3. Dans la page Modules , vérifiez que l’état des trois modules est En cours d’exécution.

Dans la page Modules , vous pouvez afficher les informations d’état sur les modules et effectuer des actions telles que l’affichage de leurs journaux et leur redémarrage.

Voir les données brutes

Dans la page Données brutes de l’appareil Capteur environnemental - 001 , vous pouvez voir les données de télémétrie qu’il envoie et les valeurs de propriété qu’il signale.

À l’heure actuelle, aucun modèle d’appareil n’est attribué à l’appareil IoT Edge, de sorte que toutes les données de l’appareil ne sont pas modélisées. Sans modèle d’appareil, il n’existe pas de vues ou de tableaux de bord permettant d’afficher des informations personnalisées sur l’appareil dans l’application IoT Central. Toutefois, vous pouvez utiliser l’exportation de données pour transférer les données à d’autres services à des fins d’analyse ou de stockage.

Ajouter un modèle d’appareil

Un manifeste de déploiement peut inclure des définitions de propriétés exposées par un module. Par exemple, la configuration dans le manifeste de déploiement du module SimulatedTemperatureSensor comprend les éléments suivants :

"SimulatedTemperatureSensor": {
    "properties.desired": {
        "SendData": true,
        "SendInterval": 10
    }
}

Les étapes suivantes vous montrent comment ajouter un modèle d’appareil pour un appareil IoT Edge et les définitions de propriétés de module à partir du manifeste de déploiement :

1. Accédez à la page Modèles d’appareil dans votre application IoT Central et sélectionnez + Nouveau.

2. Dans la page Sélectionner le type, sélectionnez Azure IoT Edge, puis sélectionnez Suivant : personnaliser.

3. Dans la page Personnaliser, entrez Capteur environnemental comme nom du modèle d’appareil. Sélectionnez Suivant : Vérification).

4. Dans la page Vérifier, sélectionnez Créer.

5. Dans la page Créer un modèle, sélectionnez Modèle personnalisé.

6. Dans la page Capteur environnemental , sélectionnez Modules, puis Importer des modules à partir du manifeste.

7. Dans la boîte de dialogue Importer des modules, sélectionnez le manifeste de déploiement du capteur environnemental , puis Importer.

Le modèle d’appareil inclut désormais un module appelé SimulatedTemperatureSensor avec une interface appelée gestion. Cette interface inclut les définitions des propriétés SendData et SendInterval du manifeste de déploiement.

Un manifeste de déploiement peut uniquement définir des propriétés de module, pas des commandes ou des données de télémétrie. Pour ajouter les définitions de télémétrie au modèle d’appareil :

1. Téléchargez et enregistrez la définition de l’interface EnvironmentalSensorTelemetry.json sur votre ordinateur local.

2. Accédez au module SimulatedTemperatureSensor dans le modèle d’appareil capteur environnemental .

3. Sélectionnez Ajouter une interface héritée (vous devrez peut-être sélectionner ... pour voir cette option). Sélectionnez Importer l’interface. Importez ensuite le fichier EnvironmentalSensorTelemetry.json que vous avez téléchargé précédemment.

Le module inclut désormais une interface de télémétrie qui définit les types de données de télémétrie machine, ambiante et timeCreated :

Pour ajouter une vue qui trace les données de télémétrie à partir de l’appareil :

1. Dans le modèle d’appareil capteur environnemental, sélectionnez Vues.

2. Dans la page Sélectionner pour ajouter une nouvelle vue, sélectionnez Visualisation de l’appareil.

3. Entrez Télémétrie de l’environnement comme nom de la vue.

4. Sélectionnez Démarrer avec des appareils. Ajoutez ensuite les types de télémétrie suivants :

   • ambient/temperature
   • humidité
   • machine/temperature
   • pressure

5. Sélectionnez Ajouter une vignette, puis Enregistrer.

6. Sélectionnez Publier pour publier le modèle.

Afficher le module de télémétrie et de contrôle

Pour afficher les données de télémétrie de votre appareil, vous devez attacher l’appareil au modèle d’appareil :

1. Accédez à la page Appareils et sélectionnez l’appareil Capteur environnemental - 001 .

2. Sélectionnez Migrer.

3. Dans la boîte de dialogue Migrer , sélectionnez le modèle d’appareil capteur environnemental, puis migrer.

4. Accédez à l’appareil Capteur environnemental - 001 et sélectionnez la vue Télémétrie de l’environnement .

5. Le graphique en courbes trace les quatre valeurs de télémétrie que vous avez sélectionnées pour la vue :

   

6. La page Données brutes comprend désormais des colonnes pour les valeurs de télémétrie ambiante, machine et timeCreated .

Pour contrôler le module à l’aide des propriétés définies dans le manifeste de déploiement, accédez à l’appareil Capteur environnemental - 001 et sélectionnez la vue Gérer .

IoT Central a créé automatiquement cette vue à partir de l’interface de gestion dans le module SimulatedTemperatureSensor . La page Données brutes inclut désormais des colonnes pour les propriétés SendData et SendInterval .

Nettoyer les ressources

Si vous ne prévoyez pas de suivre d’autres guides de démarrage rapide ou tutoriels IoT Central, vous pouvez supprimer votre application IoT Central :

1. Dans votre application IoT Central, accédez à Application > Gestion.
2. Sélectionnez Supprimer, puis confirmez l’opération.

Pour supprimer la machine virtuelle qui exécute Azure IoT Edge, accédez au Portail Azure et supprimez le groupe de ressources que vous avez créé précédemment. Si vous avez utilisé le nom recommandé, votre groupe de ressources est appelé MyIoTEdgeDevice_rg.

Étapes suivantes

Si vous préférez suivre l’ensemble des tutoriels IoT Central et en savoir plus sur la création d’une solution IoT Central, consultez :

Créer un modèle d’appareil de passerelle