Exercice - Déployer une application de haut niveau sur votre appareil Azure Sphere - Training

10 minutes

Dans cet exercice, nous allons déployer une application de haut niveau sur votre appareil Azure Sphere.

Étape 1 : Ouvrir le projet de labo

Démarrez Visual Studio Code.
Dans le menu, cliquez sur Fichier, puis Ouvrir le dossier.
Ouvrez le dossier du labo Azure-Sphere.
Ouvrez le dossier Lab_2_Send_Telemetry_to_Azure_IoT.
Cliquez sur Sélectionner un dossier ou sur le bouton OK pour ouvrir le projet.

Étape 2 : Configurer l’application Azure Sphere

Dans Visual Studio Code, ouvrez le fichier app_manifest.json. Les ressources nécessaires à cette application doivent être déclarées dans la section Capabilities.
Mettez à jour les propriétés de connexion du hub Azure IoT Hub.
- Mettez à jour CmdArgs avec l’étendue de votre ID Azure IoT DPS.
- Mettez à jour DeviceAuthentication avec votre ID de locataire Azure Sphere. Rappelez-vous qu’il s’agit de la valeur numérique résultant de l’exécution de la commande azsphere tenant show-selected.
Mettez à jour AllowedConnections avec le point de terminaison global Device Provisioning Service, votre point de terminaison DPS et votre point de terminaison Azure IoT Hub. Consultez l’exemple ci-dessous pour savoir quel est le bon format de ces points de terminaison.
Vous pouvez mettre en forme le document app_manifest. JSON en cliquant avec le bouton droit de la souris sur le document et en sélectionnant Mettre le de document en forme dans le menu contextuel.

Passez en revue votre fichier app_manifest.json mis à jour. Il doit ressembler à ce qui suit.

{
    "SchemaVersion": 1,
    "Name": "AzureSphereIoTCentral",
    "ComponentId": "25025d2c-66da-4448-bae1-ac26fcdd3627",
    "EntryPoint": "/bin/app",
    "CmdArgs": [ "--ConnectionType", "DPS", "--ScopeID", "0ne0099999D" ],
    "Capabilities": {
        "Gpio": [
            "$NETWORK_CONNECTED_LED",
            "$LED_RED",
            "$LED_GREEN",
            "$LED_BLUE"
        ],
        "I2cMaster": [
            "$I2cMaster2"
        ],
        "PowerControls": [
            "ForceReboot"
        ],
        "AllowedConnections": [
            "global.azure-devices-provisioning.net",
            "<Your device provisioning service endpoint>",
            "<Your Azure IoT hub endpoint>"
        ],
        "DeviceAuthentication": "9d7e79eb-9999-43ce-9999-fa8888888894"
    },
    "ApplicationType": "Default"
}

Enregistrez le fichier app_manifest.json mis à jour.
IMPORTANT. Copiez le contenu de votre fichier app_manifest.json dans le Bloc-notes ou votre éditeur de texte sélectionné, car vous aurez besoin de ces informations de configuration pour les prochains labos.

Étape 3 : Sélectionner la configuration de votre carte de développement

Ces labos prennent en charge les cartes de développement Avnet et Seeed Studio. Vous devez définir la configuration qui correspond à votre carte de développement. Par défaut, la carte de développement est configurée pour le starter kit Avnet Azure Sphere Révision 1. Si vous avez cette carte, aucune configuration supplémentaire n’est requise.

Ouvrez CMakeLists.txt.
Ajoutez un caractère # au début de la ligne set AVNET pour la désactiver.

Décommentez la commande set qui correspond à votre carte de développement Azure Sphere.

set(AVNET TRUE "AVNET Azure Sphere Starter Kit Revision 1 ")
# set(AVNET_REV_2 TRUE "AVNET Azure Sphere Starter Kit Revision 2 ")
# set(SEEED_STUDIO_RDB TRUE "Seeed Studio Azure Sphere MT3620 Development Kit (aka Reference Design Board or rdb)")
# set(SEEED_STUDIO_MINI TRUE "Seeed Studio Azure Sphere MT3620 Mini Dev Board")

Enregistrez le fichier. Le cache CMake est généré automatiquement.

Étape 4 : Déployer l’application sur Azure Sphere

Démarrer le processus de création et de déploiement de l’application

Ouvrez main.c.
Sélectionnez CMake : [Déboguer] : Prêt dans la barre d’état de Visual Studio Code.
Dans Visual Studio Code, appuyez sur F5 pour générer, déployer et démarrer votre application, qui s’exécute sur l’appareil Azure Sphere, et attacher le débogueur distant.
Essayez de définir un point d’arrêt dans la fonction MeasureSensorHandler. La fonction sera appelée toutes les 5 secondes.

Notes

Vous pouvez découvrir comment définir des points d’arrêt dans cet article : Débogage dans Visual Studio Code.

Afficher la sortie du débogueur

Sélectionnez l’onglet Sortie de Visual Studio Code pour voir la sortie des instructions Log_Debug dans le code.

Conseil

Vous pouvez ouvrir l’onglet Sortie en utilisant le raccourci Ctrl+Maj+U de Visual Studio Code ou en cliquant sur l’onglet Sortie.
L’appareil négocie la sécurité, puis commence à envoyer des données de télémétrie à Azure IoT Hub.

Notes

Il est possible que quelques messages d’erreur du type Échec de création du descripteur IoTHub apparaissent. Ils se produisent pendant la négociation de la connexion à Azure IoT Hub.

Étape 5 : Comportement attendu de l’appareil

Starter kit Azure Sphere MT3620 Révision 1 et 2

The illustration shows the Avnet Azure Sphere kit.

La LED WLAN clignote toutes les 5 secondes quand il est connecté à Azure.

Kit de développement Seeed Studio Azure Sphere MT3620

The illustration shows the Seeed Studio Azure Sphere kit.

La LED WLAN clignote toutes les 5 secondes quand il est connecté à Azure.

Carte de développement Seeed Studio MT3620 Mini

The illustration shows the Seeed Studio Mini Azure Sphere kit.

La LED User (Utilisateur) clignote toutes les 5 secondes quand il est connecté à Azure.

Étape 6 : Afficher les données de télémétrie de l’appareil avec Azure IoT Explorer

Lancez Azure IoT Explorer.
Cliquez sur Afficher les appareils de ce hub.
Cliquez sur votre appareil.

Le nom de l’appareil est votre ID d’appareil Azure Sphere. Vous pouvez afficher votre ID d’appareil en exécutant la commande suivante à partir de la ligne de commande PowerShell Windows ou du Terminal Linux.
```
azsphere device show-attached
```
Cliquez sur Composants IoT Plug-and-Play dans le menu latéral.
Cliquez sur Composant par défaut.
Sélectionnez Télémétrie dans le menu.
Cliquez sur le bouton Démarrer.
Cliquez sur Afficher les événements modélisés pour faire correspondre le modèle IoT Plug-and-Play aux données de télémétrie.