Créer une application de haut niveau

Le moyen le plus simple de créer une application de haut niveau consiste à commencer avec le modèle Vide à partir de l’extension Visual Studio Code Azure Sphere et à ajuster la configuration à votre projet en procédant comme suit :

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

   

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

   

3. Visual Studio Code affiche ensuite une fenêtre Explorateur de fichiers. Accédez au dossier où 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 à l’emplacement sélectionné et génère les fichiers de build de l’application vide. Les messages de CMake doivent s’afficher.

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 de matériel dans le référentiel d’exemples Azure Sphere ou en créer une comme décrit dans Définitions de matériel.

   L’exemple suivant montre comment ajouter les exemples de définitions de matériel pour le Kit de développement Seeed Azure Sphere MT3620 :

   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 générale à partir de l’un des exemples Azure Sphere de haut niveau :

1. Clonez le référentiel d’exemples si vous ne l’avez pas déjà fait. Copiez l’un des dossiers d’application généraux 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 générale consiste à commencer avec 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 dans 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 à l’emplacement sélectionné et génère les fichiers de build pour l’application vide. Les messages de CMake doivent s’afficher.

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 de matériel dans le référentiel d’exemples Azure Sphere ou en créer une comme décrit dans Définitions de matériel.

   L’exemple suivant montre comment ajouter les exemples de définitions de matériel pour le Kit de développement Seeed Azure Sphere MT3620 :

   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 générale à partir de l’un des exemples Azure Sphere de haut niveau :

1. Clonez le référentiel d’exemples si vous ne l’avez pas déjà fait. Copiez l’un des dossiers d’application généraux 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. Clonez le référentiel d’exemples si vous ne l’avez pas déjà fait. Copiez l’un des dossiers d’application généraux 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 fichier 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 obligatoire. CMake, avec l’utilitaire de génération légère ninja, est utilisé pour contrôler le processus de génération de l’application Azure Sphere.
• Fichier manifeste d’application décrivant les fonctionnalités disponibles pour l’application.

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

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

Écrire votre code

1. Écrivez votre code d’application à l’aide des exemples d’applications de haut niveau Azure Sphere comme guides. Les rubriques suivantes décrivent des scénarios d’implémentation spécifiques :
   • Utiliser des périphériques dans une application de haut niveau
   • Se connecter aux services web
   • Utiliser wolfSSL pour les connexions TLS
   • Gérer les certificats
   • Comprendre l’utilisation de la mémoire
   • Différer les mises à jour de l’appareil
   • Gérer l’heure et utiliser l’horloge en temps réel
   • Utiliser le stockage de l’appareil
   • Communiquer avec une application compatible en temps réel
   • Gérer l’état de mise hors tension
   • Définir des profils d’alimentation
   • Effectuer une découverte de service
2. Dans le fichierCMakeLists.txt :
   • Spécifier la révision des outils du Kit de développement logiciel (SDK) Azure Sphere
   • Spécifier l’ensemble d’API cible
   • Spécifier le matériel cible
3. Dans le fichier app_manifest.json :
   • Définissez sur Name le nom de votre projet.
   • Ajoutez toutes les fonctionnalités spécifiques à l’application dont votre code a besoin, telles que les ressources matérielles ou les connexions. Si l’application de haut niveau communique avec une application en temps réel, ajoutez l’ID de composant de l’application de haut niveau à la AllowedApplicationConnections fonctionnalité.

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

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

Voir aussi

• Créez une application de haut niveau.
• Déboguer une application de haut niveau.