Crie um aplicativo capaz de trabalhar em tempo real
Importante
Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) 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 em tempo real é começar com o modelo em branco da extensão do Visual Studio Code Azure Sphere e ajustar a configuração ao seu projeto seguindo estas etapas:
Inicie o Visual Studio Code. Selecione Exibir>paleta de comandos e digite Azure Sphere: Gerar novo projeto.
Escolha RTCore Blank no menu Modelos.
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 seu projeto, por exemplo, NewRTApp. Visual Studio Code cria a pasta NewRTApp em seu local selecionado e gera os arquivos de compilação para o aplicativo em branco. Deverá ver mensagens do CMake.
Você também pode criar um novo aplicativo com capacidade em tempo real a partir de qualquer um dos exemplos do Azure Sphere com capacidade em tempo real:
Clone o repositório de amostras, se ainda não o tiver feito. Copie uma das pastas de aplicativos de alto nível e renomeie-a para seu projeto.
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 Visual Studio Azure Sphere e ajustar a configuração ao seu projeto seguindo estas etapas:
Inicie o Visual Studio e selecione Criar um novo projeto.
Digite
Azure Sphere
na caixa de pesquisa Procurar modelos. Selecione Azure Sphere RTCore Blank na lista retornada e, em seguida, selecione Next.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 compilação para o aplicativo em branco. Deverá ver mensagens do CMake.
Você também pode criar um novo aplicativo capaz de tempo real a partir de qualquer um dos exemplos de alto nível do Azure Sphere:
Clone o repositório de amostras, se ainda não o tiver feito. Copie uma das pastas de aplicativos com capacidade de tempo real e renomeie-a para seu projeto.
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 exemplo de HelloWorld_RTApp_MT3620_BareMetal e ajustar a configuração ao seu projeto seguindo estas etapas:
Clone o repositório de amostras, se ainda não o tiver feito. Copie a pasta HelloWorld_RTApp_MT3620_BareMetal e renomeie-a para seu projeto.
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 capaz 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.
- CMake arquivos de compilação. CMakeLists.txt é necessário. O CMake, juntamente com o utilitário de compilação leve ninja, é usado para controlar o processo de compilação do aplicativo Azure Sphere.
- Um arquivo de manifesto do aplicativo que descreve os recursos disponíveis para o aplicativo.
Aplicativos capazes 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 o seu código
- Escreva o código do seu aplicativo, usando os exemplos do Azure Sphere RTApp como guias. Os tópicos a seguir descrevem cenários de implementação específicos:
- No ficheiro app_manifest.json:
- Defina
Name
para o nome do seu projeto, - Defina
ApplicationType
como"RealTimeCapable"
- Adicione todos os recursos específicos do aplicativo que seu código exige, como recursos de hardware ou conexões. Se o RTApp se comunicar com um aplicativo de alto nível, adicione a ID do componente do aplicativo de alto nível ao
AllowedApplicationConnections
recurso.
- Defina
Se você quiser implantar seu RTApp junto com um aplicativo de parceiro de alto nível, adicione a ID do componente do parceiro ao campo partnerComponents da seção de configurações do arquivo launch.vs.json (Visual Studio) ou .vscode/launch.json (Visual Studio Code):
"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]