Creare un'applicazione con funzionalità in tempo realeCreate a real-time capable application

Il modo più semplice per creare una nuova applicazione in tempo reale consiste nell'iniziare con il modello vuoto dall'estensione Visual Studio Code Azure Sphere e modificare la configurazione nel progetto attenendosi alla procedura seguente:The easiest way to create a new real-time application is to start with the Blank template from the Visual Studio Code Azure Sphere extension and adjust the configuration to your project by following these steps:

  1. Avviare Visual Studio Code.Start Visual Studio Code. Selezionare Visualizza > riquadro comandi, quindi digitare Azure Sphere: genera nuovo progetto.Select View > Command palette, and then type Azure Sphere: Generate New Project.

    Barra di comando in Visual Studio Code

  2. Scegliere RTCore vuoto dal menu modelli.Choose RTCore Blank from the Templates menu.

    menu a comparsa con i nomi dei modelli

  3. Visual Studio Code viene visualizzata una finestra Esplora file.Visual Studio Code then displays a File Explorer window. Passare alla cartella in cui si vuole inserire l'applicazione vuota e specificare un nome per il progetto, ad esempio NewRTApp.Navigate to the folder where you want to place the Blank application and specify a name for your project, for example, NewRTApp. Visual Studio Code crea la cartella NewRTApp nel percorso selezionato e genera i file di compilazione per l'applicazione vuota.Visual Studio Code creates the NewRTApp folder in your selected location and generates the build files for the blank application. Verranno visualizzati messaggi da CMake.You should see messages from CMake.

È anche possibile creare una nuova applicazione con supporto in tempo reale da uno degli esempi di Azure Sphere in grado di supportare in tempo reale:You can also create a new real-time capable application from any of the real-time capable Azure Sphere samples:

  1. Se non è già stato fatto, clonare il repository di esempi.Clone the samples repo if you haven't already done so. Copiare una delle cartelle dell'applicazione di alto livello e rinominarla per il progetto.Copy one of the high-level application folders and rename it for your project.

  2. Nel file CMakeLists.txt modificare il nome del progetto in base al nome della nuova cartella.In the CMakeLists.txt file, change the project name to the name of your new folder. Ad esempio:For example:

    PROJECT(NewRTApp C)

Il modo più semplice per creare una nuova applicazione con supporto in tempo reale consiste nell'iniziare con il modello vuoto dall'estensione Azure Sphere di Visual Studio e modificare la configurazione nel progetto attenendosi alla procedura seguente:The easiest way to create a new real-time capable application is to start with the Blank template from the Visual Studio Azure Sphere extension and adjust the configuration to your project by following these steps:

  1. Avviare Visual Studio e selezionare Crea un nuovo progetto.Start Visual Studio and select Create a new project.

  2. Digitare Azure Sphere nella casella di ricerca l'etichetta Cerca modelli.Type Azure Sphere in the search box labeled Search for templates. Selezionare Azure Sphere RTCore nell'elenco restituito, quindi fare clic su Avanti.Select Azure Sphere RTCore Blank from the returned list, then select Next.

  3. Specificare un nome di progetto (ad esempio, NewRTApp), un percorso del file di progetto e un nome di soluzione, che può corrispondere al nome del progetto, quindi selezionare Crea.Specify a project name (for example, NewRTApp), a project file location, and a solution name (which can be the same as the project name), and then select Create. Visual Studio crea la cartella NewRTApp nel percorso selezionato e genera i file di compilazione per l'applicazione vuota.Visual Studio creates the NewRTApp folder in your selected location and generates the build files for the blank application. Verranno visualizzati messaggi da CMake.You should see messages from CMake.

È anche possibile creare una nuova applicazione di alto livello da uno degli esempi di Azure Sphere di alto livello:You can also create a new high-level application from any of the high-level Azure Sphere samples:

  1. Se non è già stato fatto, clonare il repository di esempi.Clone the samples repo if you haven't already done so. Copiare una delle cartelle dell'applicazione con supporto in tempo reale e rinominarla per il progetto.Copy one of the real-time capable application folders and rename it for your project.

  2. Nel file CMakeLists.txt modificare il nome del progetto in base al nome della nuova cartella.In the CMakeLists.txt file, change the project name to the name of your new folder. Ad esempio:For example:

    PROJECT(NewRTApp C)

Il modo più semplice per creare una nuova applicazione con funzionalità in tempo reale consiste nell'iniziare con l'esempio HelloWorld_RTApp_MT3620_BareMetal e modificare la configurazione in base al progetto eseguendo questa procedura:The easiest way to create a new real-time capable application is to start with the HelloWorld_RTApp_MT3620_BareMetal sample and adjust the configuration to your project by following these steps:

  1. Se non è già stato fatto, clonare il repository di esempi.Clone the samples repo if you haven't already done so. Copiare la cartella HelloWorld_RTApp_MT3620_BareMetal e rinominarla in base al progetto.Copy the HelloWorld_RTApp_MT3620_BareMetal folder and rename it for your project.

  2. Nel file CMakeLists.txt modificare il nome del progetto in base al nome della nuova cartella.In the CMakeLists.txt file, change the project name to the name of your new folder. Ad esempio:For example:

    PROJECT(NewRTApp C)

Struttura di file di base di un'applicazione con supporto in tempo realeBasic file structure of a real-time capable application

Indipendentemente dalla modalità di creazione dell'applicazione, tutte le applicazioni Azure Sphere condividono i file principali seguenti:No matter how you create your application, all Azure Sphere applications share the following core files:

  • Codice sorgente dell'applicazione in uno o più file.Application source code in one or more files. Attualmente, è supportato solo il codice sorgente del linguaggio C.Currently, only C language source code is supported.
  • File di compilazione CMake.CMake build files. CMakeLists.txt è obbligatorio.CMakeLists.txt is required. CMake, insieme a Ninja Lightweight Build Utility, viene usato per controllare il processo di compilazione dell'applicazione Azure Sphere.CMake, together with the ninja lightweight build utility, is used to control the Azure Sphere application build process.
  • Un file manifesto dell'app che descrive le funzionalità disponibili per l'applicazione.An app-manifest file describing the capabilities available to the application.

Le applicazioni con supporto in tempo reale aggiungono almeno un altro file: un file linker. LD per specificare con precisione i vari componenti dell'applicazione da caricare sul core in tempo reale.Real-time capable applications add at least one other file: a linker.ld file to specify precisely where various components of the application are to be loaded on the real-time core.

Scrivere il codiceWrite your code

  1. Scrivere il codice dell'applicazione usando gli esempi di Azure Sphere RTApp come guide.Write your application code, using the Azure Sphere RTApp samples as guides. Negli argomenti seguenti sono descritti gli specifici scenari di implementazione:The following topics describe specific implementation scenarios:
  2. Nel file app_manifest.json:In the app_manifest.json file:
    • Impostare Name sul nome del progettoSet Name to your project name,
    • Impostare ApplicationType su "RealTimeCapable"Set ApplicationType to "RealTimeCapable"
    • Aggiungere eventuali funzionalità specifiche dell'applicazione richieste dal codice, ad esempio risorse hardware o connessioni.Add any application-specific capabilities that your code requires, such as hardware resources or connections. Se l'applicazione RTApp comunica con un'app di alto livello, aggiungere l'ID componente dell'applicazione di alto livello alla funzionalità AllowedApplicationConnections.If the RTApp communicates with a high-level app, add the component ID of the high-level application to the AllowedApplicationConnections capability.

Se si vuole distribuire l'applicazione RTApp insieme a un'app partner di alto livello, aggiungere l'ID componente del partner al campo partnerComponents nella sezione configurations del file launch.vs.json (Visual Studio) o .vscode/launch.json (Visual Studio Code):If you want to deploy your RTApp alongside a high-level partner app, add the component ID of the partner to the partnerComponents field of the configurations section of the launch.vs.json (Visual Studio) or .vscode/launch.json (Visual Studio Code) file :

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

Vedi ancheSee also