Partager via

Créer une application générale

  • Article

Important

Il s’agit de la documentation Azure Sphere (héritée). Azure Sphere (hérité) prend sa retraite le 27 septembre 2027 et les utilisateurs doivent migrer vers Azure Sphere (intégré) pour l’instant. Utilisez le sélecteur de version situé au-dessus du TOC pour afficher la documentation Azure Sphere (intégrée).

Le moyen le plus simple de créer une application de haut niveau consiste à commencer par le modèle vide à partir de l’extension Azure Sphere visual Studio Code et à ajuster 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.

    Barre de commandes dans Visual Studio Code

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

    menu contextuel avec des noms de 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 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 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)

Le moyen le plus simple de créer une application de haut niveau consiste à commencer par le modèle vide à partir de l’extension Visual Studio Azure Sphere et à ajuster 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)

Le moyen le plus simple de créer une application de haut niveau consiste à commencer 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)

Structure de fichiers de base d’une application de haut niveau

Quelle que soit la façon dont vous créez votre application, toutes les applications Azure Sphere partagent les fichiers principaux suivants :

  • Code source de l’application dans un ou plusieurs fichiers. Actuellement, seul le code source du langage C est pris en charge.
  • Fichiers de build CMake. CMakeLists.txt est nécessaire. CMake, avec l’utilitaire de build léger ninja, est utilisé pour contrôler le processus de génération d’application Azure Sphere.
  • Fichier manifeste d’application décrivant les fonctionnalités disponibles pour l’application.

Les applications de haut niveau auront généralement au moins trois autres fichiers :

  • Fichier applibs-versions.h pour spécifier les niveaux de version de différentes API Azure Sphere
  • Deux fichiers de définition matérielle (une version modifiable au format JSON et un fichier de langage C généré à partir de celui-ci) qui offrent un moyen pratique de faire référence aux composants matériels de votre code. Avec un ensemble cohérent de fichiers de définition matérielle, vous pouvez écrire du code source indépendant du matériel, puis générer des images d’application pour du matériel spécifique en ciblant simplement le fichier de définition matérielle approprié dans votre fichier CMakeLists.txt.

Écrire le code

  1. Écrivez le code de votre application à l’aide des exemples d’application de haut niveau Azure Sphere en tant que guides. Les rubriques suivantes décrivent des scénarios d’implémentation spécifiques :
  2. Dans le fichier CMakeLists.txt :
    • Spécifier la révision des outils du Kit de développement logiciel (SDK) Azure Sphere
    • Spécifier l’ensemble d’API cibles
    • Spécifier le matériel cible
  3. Dans le fichier app_manifest.json :
    • Affectez à Name le nom de votre projet.
    • Ajoutez les fonctionnalités spécifiques à l'application requises par votre code, comme les ressources matérielles ou les connexions. Si l’application de haut niveau communique avec une application RTApp, ajoutez l’ID de composant de l’application de haut niveau à la AllowedApplicationConnections fonctionnalité.

Si vous souhaitez déployer votre application de haut niveau en même temps qu’une application partenaire compatible en temps réel, ajoutez l’ID de composant du partenaire au champ partnerComponents de la section configurations de la section launch.vs.json (Visual Studio) ou .vscode/launch.json (Visual Studio Code) :

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

Voir aussi