Criar um aplicativo com capacidade para tempo real

Importante

Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

A maneira mais fácil de criar um novo aplicativo com capacidade para tempo real é começar com o modelo em branco da extensão do Azure Sphere do Visual Studio Code e ajustar a configuração para seu projeto seguindo estas etapas:

1. Inicie o Visual Studio Code. Selecione Exibir>paleta de comandos e digite Azure Sphere: Gerar Novo Projeto.

   

2. Escolha RTCore Blank no menu Modelos.

   

3. Em seguida, o Visual Studio Code exibe uma janela do Explorador de Arquivos. Navegue até a pasta onde deseja colocar o aplicativo em branco e especifique um nome para o projeto, por exemplo, NewRTApp. O Visual Studio Code cria a pasta NewRTApp no local selecionado e gera os arquivos de build para o aplicativo em branco. Você deve ver mensagens do CMake.

Você também pode criar um novo aplicativo com capacidade para tempo real a partir de qualquer um dos exemplos do Azure Sphere com capacidade para tempo real:

1. Clone o repositório de amostras se você ainda não tiver feito isso. Copie uma das pastas de aplicativos de alto nível e renomeie-a para o seu projeto.

2. No arquivo CMakeLists.txt, altere o nome do projeto para o nome da nova pasta. Por exemplo:

   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 do Azure Sphere do Visual Studio e ajustar a configuração ao seu projeto seguindo estas etapas:

1. Inicie o Visual Studio e selecione Criar um projeto.

2. Digite Azure Sphere na caixa de pesquisa rotulada Pesquisar modelos. Selecione Azure Sphere RTCore em Branco na lista retornada e, em seguida, selecione Avançar.

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 selecione Criar. O Visual Studio cria a pasta NewRTApp no local selecionado e gera os arquivos de build para o aplicativo em branco. Você deve ver mensagens do CMake.

Você também pode criar um novo aplicativo com capacidade para tempo real a partir de qualquer um dos exemplos de alto nível do Azure Sphere:

1. Clone o repositório de amostras se você ainda não tiver feito isso. Copie uma das pastas de aplicativos com capacidade de tempo real e renomeie-a para o seu projeto.

2. No arquivo CMakeLists.txt, altere o nome do projeto para o nome da nova pasta. Por exemplo:

   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:

1. Clone o repositório de amostras se você ainda não tiver feito isso. Copie a pasta HelloWorld_RTApp_MT3620_BareMetal e renomeie-a para seu projeto.

2. No arquivo CMakeLists.txt, altere o nome do projeto para o nome da nova pasta. Por exemplo:

   PROJECT(NewRTApp C)

Estrutura básica de arquivos de um aplicativo com capacidade de tempo real

Não importa como você cria seu aplicativo, todos os aplicativos do Azure Sphere compartilham os seguintes arquivos principais:

• Código-fonte do aplicativo em um ou mais arquivos. Atualmente, apenas o código-fonte da linguagem C é suportado.
• Arquivos de compilação do CMake. CMakeLists.txt é obrigatório. O CMake, juntamente com o utilitário de build leve ninja, é usado para controlar o processo de build do aplicativo do Azure Sphere.
• Um arquivo de manifesto do aplicativo que descreve os recursos disponíveis para o aplicativo.

Aplicativos com capacidade de 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.

Escreva seu código

1. Escreva o código do aplicativo usando os exemplos de RTApp do Azure Sphere como guias. Os tópicos a seguir descrevem cenários de implementação específicos:
   • Usar periféricos em um aplicativo com capacidade em tempo real
   • Gerenciar memória e considerações de latência
2. No arquivo app_manifest.json:
   • Configure Name com o nome do seu projeto.
   • Defina ApplicationType como "RealTimeCapable"
   • Adicione quaisquer recursos específicos do aplicativo que seu código exigir, como recursos de hardware ou conexões. 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.

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):

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

Confira também

• Crie um aplicativo com capacidade de tempo real.

• Depure um aplicativo com capacidade em tempo real.