Tutoriel : Créer une application en temps réel

• Installez CMake et Ninja pour Windows ou pour Linux.

• Installez Visual Studio Code pour Windows ou pour Linux.
• Installez CMake et Ninja pour Windows ou pour Linux.

• Installez Visual Studio et l’extension Azure Sphere.

Configurer le matériel pour afficher la sortie

Actuellement, chaque cœur en temps réel prend en charge un UART TX uniquement. Les applications en temps réel peuvent utiliser cet UART pour envoyer une sortie de journal à partir de l’appareil. Pendant le développement et le débogage d’applications, vous avez généralement besoin d’un moyen de lire et d’afficher la sortie. L’exemple HelloWorld_RTApp_MT3620_BareMetal montre comment une application peut écrire dans l’UART.

Utilisez un adaptateur USB-série tel que le FTDI Friend pour connecter l’UART sur le cœur en temps réel à un port USB de votre machine. Vous aurez également besoin d’un émulateur de terminal pour établir une connexion série avec les paramètres de terminal 115200-8-N-1 (115 200 bps, 8 bits, aucun bits de parité, un bit d’arrêt) pour afficher la sortie.

Pour configurer le matériel pour afficher la sortie d’une application en temps réel, procédez comme suit. Vous devez vous reporter à la documentation du fabricant de votre matériel pour déterminer les emplacements des broches. Si vous utilisez du matériel qui suit le matériel de conception de carte de référence (RDB) MT3620, comme le kit de développement MT3620 de Seeed Studios, l’examen des en-têtes d’interface RDB peut vous aider à déterminer les emplacements des broches.

1. Connectez GND sur l’adaptateur USB-série à GND sur votre kit de développement. Sur le matériel RDB MT3620, GND est En-tête 3, broche 2.
2. Connectez RX sur l’adaptateur USB-série à IOM4-0 TX sur votre kit de développement. Sur le matériel RDB MT3620, IOM4-0 TX est En-tête 3, broche 6.
3. Connectez l’adaptateur USB-série à un port USB gratuit sur votre ordinateur de développement et déterminez le port auquel le périphérique série est connecté. Sur Windows, démarrez Gestionnaire de périphériques, sélectionnez Afficher>les appareils par conteneur, puis recherchez « USB UART ». Par exemple, L’UART USB FT232R indique l’adaptateur FTDI Friend.
4. Démarrez un programme d’émulateur de terminal et ouvrez un terminal 115200-8-N-1 sur le port COM utilisé par l’adaptateur. Consultez la documentation de l’émulateur de terminal pour savoir comment spécifier le port et la vitesse.

Configurer le matériel pour afficher la sortie

Actuellement, chaque cœur en temps réel prend en charge un UART TX uniquement. Les applications en temps réel peuvent utiliser cet UART pour envoyer une sortie de journal à partir de l’appareil. Pendant le développement et le débogage d’applications, vous avez généralement besoin d’un moyen de lire et d’afficher la sortie. L’exemple HelloWorld_RTApp_MT3620_BareMetal montre comment une application peut écrire dans l’UART.

Utilisez un adaptateur USB-série tel que le FTDI Friend pour connecter l’UART sur le cœur en temps réel à un port USB de votre machine. Vous aurez également besoin d’un émulateur de terminal pour établir une connexion série avec les paramètres de terminal 115200-8-N-1 (115 200 bps, 8 bits, aucun bits de parité, un bit d’arrêt) pour afficher la sortie.

Pour configurer le matériel pour afficher la sortie d’une application en temps réel, procédez comme suit. Vous devez vous reporter à la documentation du fabricant de votre matériel pour déterminer les emplacements des broches. Si vous utilisez du matériel qui suit le matériel de conception de carte de référence (RDB) MT3620, comme le kit de développement MT3620 de Seeed Studios, l’examen des en-têtes d’interface RDB peut vous aider à déterminer les emplacements des broches.

1. Connectez GND sur l’adaptateur USB-série à GND sur votre kit de développement. Sur le matériel RDB MT3620, GND est En-tête 3, broche 2.

2. Connectez RX sur l’adaptateur USB-série à IOM4-0 TX sur votre kit de développement. Sur le matériel RDB MT3620, IOM4-0 TX est En-tête 3, broche 6.

3. Connectez l’adaptateur USB-série à un port USB gratuit sur votre ordinateur de développement et déterminez le port auquel le périphérique série est connecté.

   • Sur Windows, démarrez Gestionnaire de périphériques, sélectionnez Afficher>les appareils par conteneur, puis recherchez « USB UART ». Par exemple, L’UART USB FT232R indique l’adaptateur FTDI Friend.

   • Sur Linux, tapez la commande suivante :

     dmesg | grep ttyUSB
     

     Le port doit être nommé ttyUSBn, où n indique le numéro de port. Si la dmesg commande répertorie plusieurs ports USB, celui qui est connecté au généralement le dernier comme étant attaché. Par exemple, dans ce qui suit, vous utilisez ttyUSB4 :

   ~$ dmesg | grep ttyUSB
   [  144.564350] usb 1-1.1.2: FTDI USB Serial Device converter now attached to ttyUSB0
   [  144.564768] usb 1-1.1.2: FTDI USB Serial Device converter now attached to ttyUSB1
   [  144.565118] usb 1-1.1.2: FTDI USB Serial Device converter now attached to ttyUSB2
   [  144.565593] usb 1-1.1.2: FTDI USB Serial Device converter now attached to ttyUSB3
   [  144.570429] usb 1-1.1.3: FTDI USB Serial Device converter now attached to ttyUSB4
   [  254.171871] ftdi_sio ttyUSB1: FTDI USB Serial Device converter now disconnected from ttyUSB1
   

4. Démarrez un programme d’émulateur de terminal et ouvrez un terminal 115200-8-N-1 sur le port COM utilisé par l’adaptateur. Consultez la documentation de l’émulateur de terminal pour savoir comment spécifier le port et la vitesse.

Générer et exécuter l’application RTApp HelloWorld avec Visual Studio

1. Démarrez Visual Studio. Sélectionnez Ouvrir un dossier local, accédez au dossier dans lequel vous avez extrait le fichier Azure_Sphere___Hello_World.zip téléchargé, puis sélectionnez le dossier HelloWorld_RTApp_MT3620_Baremetal.

2. Si vous n’utilisez pas de RDB MT3620, mettez à jour le fichier app_manifest.json et l’exemple de code pour spécifier l’UART correct, par exemple ISU1.

3. Si la génération de CMake ne démarre pas automatiquement, sélectionnez le fichier CMakeLists.txt.

4. Dans la fenêtre Sortie de Visual Studio , la sortie CMake doit afficher les messages CMake generation started. et CMake generation finished..

5. Sélectionnez Générer>tout. Si le menu n’est pas présent, ouvrez Explorateur de solutions, cliquez avec le bouton droit sur le fichier CMakeLists.txt et sélectionnez Générer. L’emplacement de sortie de l’application HelloWorld_RTApp_MT3620_Baremetal s’affiche dans la fenêtre Sortie .

6. Dans le menu Sélectionner un élément de démarrage, sélectionnez HelloWorld_RTApp_MT3620_Baremetal (RTCore).

7. Appuyez sur F5 pour déployer l’application.

8. L’émulateur de terminal connecté doit afficher la sortie du programme HelloWorld_RTApp_MT3620_Baremetal. Le programme envoie les mots suivants à intervalles d’une seconde :

   Tick

   Tock

9. Utilisez le débogueur pour définir des points d’arrêt, inspecter les variables et essayer d’autres tâches de débogage.

Générer et exécuter l’application RTApp HelloWorld avec Visual Studio Code

1. Dans Visual Studio Code, ouvrez le dossier HelloWorld_RTApp_MT3620_BareMetal dans le dossier dans lequel vous avez extrait le fichier Azure_Sphere___Hello_World.zip téléchargé. Si vous êtes invité à sélectionner un kit, choisissez Ne pas utiliser de kit.

2. Si vous n’utilisez pas de matériel RDB MT3620, mettez à jour le fichier app_manifest.json et l’exemple de code pour spécifier l’UART approprié, par exemple ISU1.

3. Appuyez sur F5 pour démarrer le débogueur. Si le projet n’a pas été généré précédemment, ou si les fichiers ont été modifiés et que la reconstruction est requise, Visual Studio Code génère le projet avant le démarrage du débogage.

4. La fenêtre de sortie Azure Sphere doit afficher « Déploiement de l’image... » suivis des chemins d’accès au SDK et au compilateur.

5. L’émulateur de terminal connecté doit afficher la sortie du programme HelloWorld_RTApp_MT3620_Baremetal. Le programme envoie les mots suivants à intervalles d’une seconde :

   Tick

   Tock

6. Utilisez les fonctionnalités de débogage de Visual Studio Code pour définir des points d’arrêt, inspecter des variables et essayer d’autres tâches de débogage.

Dépannage

L’application peut commencer à s’exécuter avant qu’OpenOCD n’établit une connexion. Par conséquent, les points d’arrêt définis au début du code peuvent être manqués. Une solution de contournement simple consiste à retarder le démarrage de l’application jusqu’à ce qu’OpenOCD se connecte.

1. Insérez le code suivant au début du point d’entrée de l’application RTCoreMain. Cela entraîne l’entrée et le maintien de l’application dans une while boucle jusqu’à ce que la variable f soit définie sur true.

    volatile bool f = false;
    while (!f) {
       // empty.
    }
   

2. Appuyez sur F5 pour démarrer l’application avec le débogage (F5), puis passez à l’exécution.

3. Dans le volet Débogage local , remplacez la valeur de f zéro par un.

4. Parcourez le code comme d’habitude.

Générer l’exemple

1. Ouvrez une interface de ligne de commande à l’aide de PowerShell, de l’invite de commandes Windows ou de l’interpréteur de commandes Linux. Accédez au répertoire de build de votre projet.

2. À partir du répertoire de build de votre projet, à l’invite de commandes, exécutez CMake avec les paramètres suivants :

   cmake --preset <preset-name> <source-path>
   

   • --preset <preset-name>

     Nom prédéfini de configuration de build tel que défini dans CMakePresets.json.

   • --build <cmake-path>

     Répertoire binaire qui contient le cache CMake. Par exemple, si vous exécutez CMake sur un exemple Azure Sphere, la commande build est cmake --build out/ARM-Debug.

   • <source-path>

     Chemin d’accès du répertoire qui contient les fichiers sources de l’exemple d’application. Dans l’exemple, le référentiel d’exemples Azure Sphere a été téléchargé dans un répertoire appelé AzSphere.

     Les paramètres CMake sont séparés par des espaces. Le caractère de continuation de ligne (^ pour la ligne de commande Windows, \ pour la ligne de commande Linux ou ' pour PowerShell) peut être utilisé pour la lisibilité, mais n’est pas obligatoire.

   Les exemples suivants illustrent les commandes CMake pour une application en temps réel. Lorsque cela est indiqué, remplacez <file-path> par le chemin d’installation de gnu Arm Embedded Toolchain sur votre système.

   • Windows
   • Linux

   Invite de commandes Windows

   cmake ^
   --preset "ARM-Debug" ^
   "C:\AzSphere\azure-sphere-samples\Samples\HelloWorld\HelloWorld_RTApp_MT3620_BareMetal"
   

   Windows PowerShell

   cmake `
   --preset "ARM-Debug" `
   "C:\AzSphere\azure-sphere-samples\Samples\HelloWorld\HelloWorld_RTApp_MT3620_BareMetal"
   

3. Exécutez Ninja pour générer l’application et créer le fichier de package d’image :

   ninja -C out/ARM-Debug
   

   Ninja place l’application et les fichiers .imagepackage obtenus dans le répertoire spécifié.

   Vous pouvez également appeler Ninja via CMake avec la commande suivante :

   cmake --build out/<binary-dir>
   

   Définissez <binary-dir> sur le répertoire binaire qui contient le cache CMake. Par exemple, si vous exécutez CMake sur un exemple Azure Sphere, la commande build est cmake --build out/ARM-Debug.

Lors de la résolution des problèmes, en particulier après avoir apporté des modifications à vos commandes CMake, supprimez l’intégralité de votre build et réessayez.

Exécuter l’exemple

1. Supprimez toutes les applications déjà déployées sur l’appareil :

   az sphere device sideload delete
   

2. À partir du répertoire de votre projet, à l’invite de commandes, chargez le package d’image créé par ninja :

   az sphere device sideload deploy --image-package <path-to-imagepackage>
   

   L’application commence à s’exécuter peu après son chargement. Les éléments suivants s’affichent sur l’émulateur de terminal connecté :

   Tick
   
   Tock
   
   Tick
   .
   .
   .
   

3. Obtenez l’ID de composant pour l’image :

   az sphere image-package show --image-package <path-to-imagepackage>
   

   La commande retourne toutes les métadonnées du package d’image. L’ID de composant de l’application apparaît dans la section Identité pour le type d’image d’application. Par exemple :

   ...
     "Identity": {
       "ComponentId": "<component-id>",
       "ImageId": "<image-id>",
       "ImageType": "Application"
     },
   ...
   

   Vous pouvez utiliser les commandes suivantes pour arrêter, démarrer et obtenir les status de l’application :

   az sphere device app stop --component-id <component id>
   

   az sphere device app start --component-id <component id>
   

   az sphere device app show-status --component-id <component id>
   

Déboguer l’exemple

1. Arrêtez l’application si elle est en cours d’exécution.

   az sphere device app stop --component-id <component id>
   

2. Relancez l’application pour le débogage.

   az sphere device app start --debug-mode true  --component-id <component id>
   

   Cette commande retourne le noyau sur lequel l’application s’exécute.

   <component id>
   App state   : running
   Core        : Real-time 0
   

3. Accédez au dossier Openocd pour le sysroot avec lequel l’application a été générée. Les sysroots sont installés dans le dossier d’installation du Kit de développement logiciel (SDK) Azure Sphere. Par exemple, sur Windows, le dossier est installé par défaut sur C:\Program Files (x86)\Microsoft Azure Sphere SDK\Sysroots\*sysroot*\tools\openocd et sur Linux, à l’adresse /opt/azurespheresdk/Sysroots/*sysroot*/tools/sysroots/x86_64-pokysdk-linux.

4. Exécutez openocd comme le montre l’exemple suivant. L’exemple suppose que l’application s’exécute sur le noyau 0. Si l’application s’exécute sur core 1, remplacez « targets io0 » par « targets io1 ».

   • Windows
   • Linux

   openocd -f mt3620-rdb-ftdi.cfg -f mt3620-io0.cfg -c "gdb_memory_map disable" -c "gdb_breakpoint_override hard" -c init -c "targets io0" -c halt -c "targets"
   

5. Accédez au dossier qui contient le fichier .out de l’application et démarrez arm-none-eabi-gdb, qui fait partie de la chaîne d’outils GNU Arm Embedded :

   • Windows
   • Linux

   Invite de commandes Windows

   "C:\Program Files (x86)\GNU Arm Embedded Toolchain\9 2020-q2-update\bin\arm-none-eabi-gdb" HelloWorld_RTApp_MT3620_BareMetal.out
   

   Windows PowerShell

   & "C:\Program Files (x86)\GNU Arm Embedded Toolchain\9 2020-q2-update\bin\arm-none-eabi-gdb" HelloWorld_RTApp_MT3620_BareMetal.out
   

6. Le serveur OpenOCD fournit une interface de serveur GDB sur :4444. Définissez la cible pour le débogage.

   target remote :4444

7. Vous pouvez maintenant exécuter des commandes gdb.

8. L’émulateur de terminal connecté doit afficher la sortie de l’application.