Créer des applications partenaires

Créer une application de haut niveau

Pour créer une application de haut niveau, commencez par le modèle HLCore Blank à partir de l’extension Visual Studio Code Azure Sphere et ajustez la configuration à votre projet en procédant comme suit :

1. Démarrez Visual Studio Code. Sélectionnez La palette de commandes Afficher>, puis tapez Azure Sphere : Générer un nouveau projet.

   

2. Choisissez HLCore Blank dans le menu Modèles.

   

3. Visual Studio Code affiche ensuite une fenêtre Explorateur de fichiers. Accédez au dossier dans lequel vous souhaitez placer l’application vide (ou sélectionnez Nouveau dossier et créez un répertoire de projet partenaire de niveau supérieur) et spécifiez un nom pour votre projet, par exemple NewHLApp. Visual Studio Code crée le dossier NewHLApp dans votre emplacement sélectionné et génère les fichiers de build de l’application vide. Vous devez voir en principe des messages de CMake.

4. Ouvrez le fichier CMakeLists.txt et spécifiez le dossier qui contient les définitions du matériel que vous utilisez. Par défaut, l’application HLCore Blank ne contient aucune définition matérielle. Vous pouvez trouver des exemples de définitions matérielles dans le référentiel d’exemples Azure Sphere ou en créer un comme décrit dans les définitions matérielles.

   Voici comment ajouter les exemples de définitions matérielles pour le Kit de développement Mt3620 Seeed Azure Sphere :

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Cette ligne doit être insérée avant le début azsphere_target_add_image_packagede la commande finale.

Vous pouvez également créer une application de haut niveau à partir de l’un des exemples Azure Sphere de haut niveau :

1. Si ce n'est déjà fait, clonez le référentiel d'exemples. Copiez l’un des dossiers d’application de haut niveau et renommez-le pour votre projet.

2. Dans le fichier CMakeLists.txt, remplacez le nom du projet par le nom de votre nouveau dossier. Par exemple :

   PROJECT(NewHLApp C)

Créer une application RTApp

Pour créer une application en temps réel, commencez par le modèle RTCore Blank à partir de l’extension Visual Studio Code Azure Sphere et ajustez la configuration à votre projet en procédant comme suit :

1. Démarrez Visual Studio Code. Sélectionnez La palette de commandes Afficher>, puis tapez Azure Sphere : Générer un nouveau projet.

   

2. Choisissez RTCore Vide dans le menu Modèles.

   

3. Visual Studio Code affiche ensuite une fenêtre Explorateur de fichiers. Accédez au dossier contenant votre dossier d’application de haut niveau et spécifiez un nom pour votre projet, par exemple NewRTApp. Visual Studio Code crée le dossier NewRTApp dans votre emplacement sélectionné et génère les fichiers de build de l’application vide. Vous devez voir en principe des messages de CMake.

Vous pouvez également créer une application compatible en temps réel à partir de l’un des exemples Azure Sphere compatibles en temps réel :

1. Si ce n'est déjà fait, clonez le référentiel d'exemples. Copiez l’un des dossiers d’application de haut niveau et renommez-le pour votre projet.

2. Dans le fichier CMakeLists.txt, remplacez le nom du projet par le nom de votre nouveau dossier. Par exemple :

   PROJECT(NewRTApp C)

Configurer votre espace de travail pour le développement d’applications partenaires

Pour joindre efficacement votre application de haut niveau et votre application en temps réel pour le développement, combinez vos deux applications dans un espace de travail multi-racine unique comme suit :

1. Ouvrez le dossier d’application de haut niveau dans Visual Studio Code.

2. Sélectionnez Fichier>Ajouter un dossier à l’espace de travail, puis sélectionnez votre dossier d’application en temps réel.

3. Sélectionnez Fichier>Enregistrer l’espace de travail sous..., puis enregistrez votre fichier dans le dossier qui contient à la fois les applications en temps réel et les applications de haut niveau.

4. Ouvrez votre fichier d’espace de travail dans un éditeur de texte et ajoutez les informations de lancement suivantes immédiatement après la "settings" ligne :

    "launch": {
        "configurations": [{
            "name": "Launch Azure Sphere Apps (All Cores)",
            "type": "azurespheredbg",
            "request": "launch",
            "args": [],
            "stopAtEntry": false,
            "environment": [],
            "externalConsole": true,
            "partnerComponents": [],
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ]
        }],
        "compounds": []
    }

Pour plus d’informations sur les espaces de travail multi-racines, consultez la documentation de Visual Studio Code.

Créer une application de haut niveau

Pour créer une application de haut niveau, commencez par le modèle HLCore Blank à partir de l’extension Visual Studio Azure Sphere et ajustez la configuration à votre projet en procédant comme suit :

1. Démarrez Visual Studio et sélectionnez Créer un projet.

2. Tapez Azure Sphere la zone de recherche intitulée Rechercher des modèles. Sélectionnez Azure Sphere HLCore Blank dans la liste retournée, puis sélectionnez Suivant.

3. Spécifiez un nom de projet (par exemple, NewHLApp), un emplacement de fichier projet et un nom de solution (qui peut être identique au nom du projet), puis sélectionnez Créer. Visual Studio crée le dossier NewHLpp dans votre emplacement sélectionné et génère les fichiers de build de l’application vide. Vous devez voir en principe des messages de CMake.

4. Ouvrez le fichier CMakeLists.txt et spécifiez le dossier qui contient les définitions du matériel que vous utilisez. Par défaut, l’application HL Blank ne contient aucune définition matérielle. Vous pouvez trouver des exemples de définitions matérielles dans le référentiel d’exemples Azure Sphere ou en créer un comme décrit dans les définitions matérielles.

   Voici comment ajouter les exemples de définitions matérielles pour le Kit de développement Mt3620 Seeed Azure Sphere :

   azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

   Cette ligne doit être insérée avant le début azsphere_target_add_image_packagede la commande finale.

Vous pouvez également créer une application de haut niveau à partir de l’un des exemples Azure Sphere de haut niveau :

1. Si ce n'est déjà fait, clonez le référentiel d'exemples. Copiez l’un des dossiers d’application de haut niveau et renommez-le pour votre projet.

2. Dans le fichier CMakeLists.txt, remplacez le nom du projet par le nom de votre nouveau dossier. Par exemple :

   PROJECT(NewHLApp C)

Créer une application RTApp

Pour créer une application compatible en temps réel, commencez par le modèle RTCore Blank à partir de l’extension Visual Studio Azure Sphere et ajustez la configuration à votre projet en procédant comme suit :

1. Démarrez Visual Studio et sélectionnez Créer un projet.

2. Tapez Azure Sphere la zone de recherche intitulée Rechercher des modèles. Sélectionnez Azure Sphere RTCore Blank dans la liste retournée, puis sélectionnez Suivant.

3. Spécifiez un nom de projet (par exemple, NewRTApp), un emplacement de fichier projet et le nom de la solution que vous avez utilisé pour votre application de haut niveau, puis sélectionnez Créer. Visual Studio crée le dossier NewRTApp dans votre emplacement sélectionné et génère les fichiers de build de l’application vide. Vous devez voir en principe des messages de CMake.

Vous pouvez également créer une application compatible en temps réel à partir de l’un des exemples Azure Sphere compatibles en temps réel :

1. Si ce n'est déjà fait, clonez le référentiel d'exemples. Copiez l’un des dossiers d’application en temps réel et renommez-le pour votre projet.

2. Dans le fichier CMakeLists.txt, remplacez le nom du projet par le nom de votre nouveau dossier. Par exemple :

   PROJECT(NewRTApp C)

Créer un fichier de lancement Visual Studio de niveau supérieur

Pour travailler simultanément avec des applications partenaires, vous souhaitez autoriser Visual Studio à déboguer en plusieurs cœurs. Vous pouvez l’activer en créant un fichier launch.vs.json dans le dossier de niveau supérieur contenant les deux dossiers d’application partenaire. Ce fichier doit avoir un contenu similaire à ce qui suit :

{
  "version": "0.2.1",
  "defaults": {},
  "configurations": [
    {
      "type": "azurespheredbg",
      "name": "Azure Sphere Apps (All Cores)",
      "project": "PartnerAppsHL/CMakeLists.txt",
      "DebugBuildStepBuildAll": "true",
      "workingDirectory": "${workspaceRoot}",
      "applicationPath": "${debugInfo.target}",
      "imagePath": "${debugInfo.targetImage}",
      "targetCore": "AnyCore",
      "partnerComponents": [ "0cc81b35-08dd-4d65-b318-5fa73a4ff6b1", "a9d25f0a-807e-4cb9-80e8-80fee5a1bcb4" ]
    }
  ]
}

La "project" ligne doit contenir le chemin d’accès relatif au fichier CMakeLists.txt de l’application de haut niveau, et la "partnerComponents" ligne doit avoir les ID de composant des deux applications partenaires.

Une fois que vous avez créé ce fichier de launch.vs.json de niveau supérieur, vous pouvez ouvrir Visual Studio dans le dossier de niveau supérieur et vous verrez l’option Azure Sphere Apps (Tous les cœurs) dans le menu Sélectionner un élément de démarrage.

Créer un fichier CMakeWorkspaceSettings.json

Si vous utilisez Visual Studio 2022, version 17.1 ou ultérieure et que vous disposez d’un projet avec plusieurs racines, comme l’exemple IntercoreComms, vous devez ajouter un fichier CMakeWorkspaceSettings.json au dossier de niveau supérieur du projet. Le fichier comporte deux entrées, une pour spécifier que la build CMake est activée et qu’elle contient les chemins d’accès aux plusieurs racines. Par exemple, pour l’exemple IntercoreComms, le CMakeWorkspaceSettings.json a le contenu suivant :

{
  "enableCMake": true,
  "sourceDirectory": [ "IntercoreComms_HighLevelApp", "IntercoreComms_RTApp_MT3620_BareMetal" ]
}

Les chemins d’accès sont spécifiés par rapport au dossier contenant le fichier CMakeWorkspaceSettings.json.

Créer une application de haut niveau

Pour créer une application de haut niveau, commencez par l’un des exemples Azure Sphere de haut niveau :

1. Si ce n'est déjà fait, clonez le référentiel d'exemples. Copiez l’un des dossiers d’application de haut niveau et renommez-le pour votre projet.

2. Dans le fichier CMakeLists.txt, remplacez le nom du projet par le nom de votre nouveau dossier. Par exemple :

   PROJECT(NewHLApp C)

Créer une application RTApp

Pour créer une application en temps réel, le plus simple est de commencer avec l’exemple HelloWorld_RTApp_MT3620_BareMetal et d’adapter la configuration à votre projet en suivant ces étapes :

1. Si ce n'est déjà fait, clonez le référentiel d'exemples. Copiez le dossier HelloWorld_RTApp_MT3620_BareMetal et renommez-le pour votre projet.

2. Dans le fichier CMakeLists.txt, remplacez le nom du projet par le nom de votre nouveau dossier. Par exemple :

   PROJECT(NewRTApp C)

1. Si vous souhaitez déployer votre application en temps réel avec une application partenaire générale, ajoutez l’ID de composant du partenaire dans le champ partnerComponents de la section configurations du fichier launch.vs.json (Visual Studio) ou du fichier .vscode/launch.json (Visual Studio Code) :

   "partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]

1. Si vous souhaitez déployer votre application en temps réel avec une application partenaire générale, ajoutez l’ID de composant du partenaire dans le champ partnerComponents de la section configurations du fichier launch.vs.json (Visual Studio) ou du fichier .vscode/launch.json (Visual Studio Code) :

   "partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]