Criar um aplicativo com capacidade para tempo realCreate a real-time capable application

A maneira mais fácil de criar um novo aplicativo em tempo real é começar com o modelo em branco por meio da extensão Visual Studio Code Azure Sphere e ajustar a configuração ao seu projeto seguindo estas etapas: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. Inicie o Visual Studio Code.Start Visual Studio Code. Selecione Exibir > paleta de comandos e digite Azure Sphere: gerar novo projeto.Select View > Command palette, and then type Azure Sphere: Generate New Project.

    Barra de comandos no Visual Studio Code

  2. Escolha RTCore em branco no menu modelos.Choose RTCore Blank from the Templates menu.

    menu pop-up com nomes de modelo

  3. Visual Studio Code, em seguida, exibe uma janela Explorador de arquivos.Visual Studio Code then displays a File Explorer window. Navegue até a pasta em que você deseja posicionar o aplicativo em branco e especifique um nome para seu projeto, por exemplo, 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 cria a pasta NewRTApp no local selecionado e gera os arquivos de compilação para o aplicativo em branco.Visual Studio Code creates the NewRTApp folder in your selected location and generates the build files for the blank application. Você deve ver mensagens do CMake.You should see messages from CMake.

Você também pode criar um novo aplicativo com capacidade em tempo real em qualquer um dos exemplos de Azure Sphere compatíveis em tempo real:You can also create a new real-time capable application from any of the real-time capable Azure Sphere samples:

  1. Clone o repositório de amostras se você ainda não tiver feito isso.Clone the samples repo if you haven't already done so. Copie uma das pastas de aplicativo de alto nível e renomeie-a para seu projeto.Copy one of the high-level application folders and rename it for your project.

  2. No arquivo CMakeLists.txt, altere o nome do projeto para o nome da nova pasta.In the CMakeLists.txt file, change the project name to the name of your new folder. Por exemplo:For example:

    PROJECT(NewRTApp C)

A maneira mais fácil de criar um novo aplicativo com capacidade em tempo real é começar com o modelo em branco da extensão de Azure Sphere do Visual Studio e ajustar a configuração para seu projeto seguindo estas etapas: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. Inicie o Visual Studio e selecione Criar um projeto.Start Visual Studio and select Create a new project.

  2. Digite Azure Sphere a caixa de pesquisa rotulada Pesquisar modelos.Type Azure Sphere in the search box labeled Search for templates. Selecione Azure Sphere RTCore em branco na lista retornada e, em seguida, selecione Avançar.Select Azure Sphere RTCore Blank from the returned list, then select Next.

  3. Especifique um nome de projeto (por exemplo, NewRTApp), um local de arquivo de projeto e um nome de solução (que pode ser o mesmo que o nome do projeto) e, em seguida, selecione criar.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. O Visual Studio cria a pasta NewRTApp no local selecionado e gera os arquivos de compilação para o aplicativo em branco.Visual Studio creates the NewRTApp folder in your selected location and generates the build files for the blank application. Você deve ver mensagens do CMake.You should see messages from CMake.

Você também pode criar um novo aplicativo de alto nível de qualquer um dos exemplos de Azure Sphere de alto nível:You can also create a new high-level application from any of the high-level Azure Sphere samples:

  1. Clone o repositório de amostras se você ainda não tiver feito isso.Clone the samples repo if you haven't already done so. Copie uma das pastas de aplicativos compatíveis em tempo real e renomeie-a para o seu projeto.Copy one of the real-time capable application folders and rename it for your project.

  2. No arquivo CMakeLists.txt, altere o nome do projeto para o nome da nova pasta.In the CMakeLists.txt file, change the project name to the name of your new folder. Por exemplo:For example:

    PROJECT(NewRTApp C)

A maneira mais fácil de criar um novo aplicativo com capacidade para tempo real é começar com o exemplo HelloWorld_RTApp_MT3620_BareMetal e ajustar a configuração conforme seu projeto seguindo estas etapas: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. Clone o repositório de amostras se você ainda não tiver feito isso.Clone the samples repo if you haven't already done so. Copie a pasta HelloWorld_RTApp_MT3620_BareMetal e renomeie-a para seu projeto.Copy the HelloWorld_RTApp_MT3620_BareMetal folder and rename it for your project.

  2. No arquivo CMakeLists.txt, altere o nome do projeto para o nome da nova pasta.In the CMakeLists.txt file, change the project name to the name of your new folder. Por exemplo:For example:

    PROJECT(NewRTApp C)

Estrutura básica de arquivos de um aplicativo com capacidade em tempo realBasic file structure of a real-time capable application

Não importa como você cria seu aplicativo, todos os aplicativos Azure Sphere compartilham os seguintes arquivos principais:No matter how you create your application, all Azure Sphere applications share the following core files:

  • Código-fonte do aplicativo em um ou mais arquivos.Application source code in one or more files. Atualmente, há suporte apenas para o código-fonte de linguagem C.Currently, only C language source code is supported.
  • CMake arquivos de compilação.CMake build files. CMakeLists.txt é necessário.CMakeLists.txt is required. O CMake, junto com o utilitário de compilação leve do ninja, é usado para controlar o processo de compilação Azure Sphere aplicativo.CMake, together with the ninja lightweight build utility, is used to control the Azure Sphere application build process.
  • Um arquivo de manifesto de aplicativo que descreve os recursos disponíveis para o aplicativo.An app-manifest file describing the capabilities available to the application.

Aplicativos com capacidade em tempo real adicionam pelo menos um outro arquivo: um arquivo linker. ld para especificar precisamente onde vários componentes do aplicativo devem ser carregados no núcleo em tempo real.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.

Escreva seu códigoWrite your code

  1. Escreva o código do aplicativo usando os exemplos do Azure Sphere RTApp como guias.Write your application code, using the Azure Sphere RTApp samples as guides. Os tópicos a seguir descrevem os cenários de implementação específicos:The following topics describe specific implementation scenarios:
  2. No arquivo app_manifest.json:In the app_manifest.json file:
    • Defina Name para seu nome de projeto,Set Name to your project name,
    • Defina ApplicationType como "RealTimeCapable"Set ApplicationType to "RealTimeCapable"
    • Adicione quaisquer recursos específicos do aplicativo que seu código exigir, como recursos de hardware ou conexões.Add any application-specific capabilities that your code requires, such as hardware resources or connections. Se o RTApp se comunica com um aplicativo de alto nível, adicione a ID de componente do aplicativo de alto nível à funcionalidade AllowedApplicationConnections.If the RTApp communicates with a high-level app, add the component ID of the high-level application to the AllowedApplicationConnections capability.

Se desejar implantar seu RTApp juntamente com um aplicativo do parceiro de alto nível, adicione a ID do componente do parceiro ao campo partnerComponents da seção configurações do arquivo launch.vs.json (Visual Studio) ou .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" ]

Confira tambémSee also