Créer une application en temps réel
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 compatible en temps réel 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 :
Démarrez Visual Studio Code. Sélectionnez La palette de commandes Afficher>, puis tapez Azure Sphere : Générer un nouveau projet.
Choisissez RTCore Vide dans le menu Modèles.
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 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 :
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.
Dans le fichier CMakeLists.txt, remplacez le nom du projet par le nom de votre nouveau dossier. Par exemple :
PROJECT(NewRTApp C)
Le moyen le plus simple de créer une application compatible en temps réel 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 :
Démarrez Visual Studio et sélectionnez Créer un projet.
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.Spécifiez un nom de projet (par exemple, NewRTApp), 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 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 de haut niveau :
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.
Dans le fichier CMakeLists.txt, remplacez le nom du projet par le nom de votre nouveau dossier. Par exemple :
PROJECT(NewRTApp C)
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 :
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.
Dans le fichier CMakeLists.txt, remplacez le nom du projet par le nom de votre nouveau dossier. Par exemple :
PROJECT(NewRTApp C)
Structure de fichiers de base d’une application en temps réel
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 compatibles en temps réel ajoutent au moins un autre fichier : un fichier linker.ld pour spécifier précisément où différents composants de l’application doivent être chargés sur le cœur en temps réel.
Écrire le code
- Écrivez le code de votre application à l’aide des exemples RTApp Azure Sphere en tant que guides. Les rubriques suivantes décrivent des scénarios d’implémentation spécifiques :
- Dans le fichier app_manifest.json :
- Définissez
Name
sur le nom de votre projet. - Paramétrez
ApplicationType
sur"RealTimeCapable"
- Ajoutez les fonctionnalités spécifiques à l'application requises par votre code, comme les ressources matérielles ou les connexions. Si l'application en temps réel communique avec une application générale, ajoutez l'ID de composant de l'application générale à la fonctionnalité
AllowedApplicationConnections
.
- Définissez
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" ]