Criar uma aplicação com capacidade em tempo real
A forma mais fácil de criar uma nova aplicação com capacidade em tempo real é começar com o modelo Em branco a partir da extensão do Azure Sphere do Visual Studio Code e ajustar a configuração ao seu projeto ao seguir estes passos:
Inicie o Visual Studio Code. Selecione Ver>Paleta de comandos e, em seguida, escreva Azure Sphere: Gerar Novo Projeto.
Selecione RTCore Em Branco no menu Modelos.
Em seguida, o Visual Studio Code apresenta uma janela Explorador de Ficheiros. Navegue para a pasta onde pretende colocar a aplicação Em branco e especifique um nome para o projeto, por exemplo NewRTApp. O Visual Studio Code cria a pasta NewRTApp na sua localização selecionada e gera os ficheiros de compilação para a aplicação em branco. Deverá ver mensagens do CMake.
Também pode criar uma nova aplicação com capacidade em tempo real a partir de qualquer um dos exemplos do Azure Sphere em tempo real:
Clone o repositório de exemplos se ainda não o tiver feito. Copie uma das pastas de aplicação de alto nível e mude o nome para o projeto.
No ficheiro CMakeLists.txt, altere o nome do projeto para o nome da sua nova pasta. Por exemplo:
PROJECT(NewRTApp C)
A forma mais fácil de criar uma nova aplicação com capacidade em tempo real é começar com o modelo Em branco a partir da extensão do Visual Studio Azure Sphere e ajustar a configuração ao seu projeto ao seguir estes passos:
Inicie o Visual Studio e selecione Criar um novo projeto.
Escreva
Azure Sphere
na caixa de pesquisa com o nome Procurar modelos. Selecione Azure Sphere RTCore Blank na lista devolvida e, em seguida, selecione Seguinte.Especifique um nome de projeto (por exemplo, NewRTApp), uma localização de ficheiro de projeto e um nome de solução (que pode ser o mesmo que o nome do projeto) e, em seguida, selecione Criar. O Visual Studio cria a pasta NewRTApp na sua localização selecionada e gera os ficheiros de compilação da aplicação em branco. Deverá ver mensagens do CMake.
Também pode criar uma nova aplicação com capacidade em tempo real a partir de qualquer um dos exemplos de alto nível do Azure Sphere:
Clone o repositório de exemplos se ainda não o tiver feito. Copie uma das pastas da aplicação em tempo real e mude o nome para o projeto.
No ficheiro CMakeLists.txt, altere o nome do projeto para o nome da sua nova pasta. Por exemplo:
PROJECT(NewRTApp C)
A forma mais fácil de criar uma nova aplicação com capacidade em tempo real é começar com o exemplo de HelloWorld_RTApp_MT3620_BareMetal e ajustar a configuração ao seu projeto ao seguir estes passos:
Clone o repositório de exemplos se ainda não o tiver feito. Copie a pasta HelloWorld_RTApp_MT3620_BareMetal e mude o nome para o projeto.
No ficheiro CMakeLists.txt, altere o nome do projeto para o nome da sua nova pasta. Por exemplo:
PROJECT(NewRTApp C)
Estrutura de ficheiros básica de uma aplicação com capacidade em tempo real
Independentemente da forma como criar a sua aplicação, todas as aplicações do Azure Sphere partilham os seguintes ficheiros principais:
- Código fonte da aplicação num ou mais ficheiros. Atualmente, apenas o código fonte de linguagem C é suportado.
- Ficheiros de criação CMake. CMakeLists.txt é necessário. O CMake, juntamente com o utilitário ninja lightweight build, é utilizado para controlar o processo de compilação da aplicação do Azure Sphere.
- Um ficheiro de manifesto de aplicação que descreve as capacidades disponíveis para a aplicação.
As aplicações com capacidade em tempo real adicionam pelo menos um outro ficheiro: um ficheiro linker.ld para especificar com precisão onde devem ser carregados vários componentes da aplicação no núcleo em tempo real.
Escrever o código
- Escreva o código da aplicação com os exemplos rtApp do Azure Sphere como guias. Os tópicos seguintes descrevem cenários de implementação específicos:
- No ficheiro app_manifest.json:
- Defina
Name
como o nome do projeto, - Definir
ApplicationType
como"RealTimeCapable"
- Adicione quaisquer capacidades específicas da aplicação necessárias ao seu código, tais como recursos de hardware ou ligações. Se o RTApp comunicar com uma aplicação de alto nível, adicione o ID do componente da aplicação de alto nível à
AllowedApplicationConnections
capacidade.
- Defina
Se quiser implementar o RTApp juntamente com uma aplicação de parceiro de alto nível, adicione o ID de componente do parceiro ao campo partnerComponents da secção de configurações do ficheiro launch.vs.json (Visual Studio) ou .vscode/launch.json (Visual Studio Code):
"partnerComponents": [ "25025d2c-66da-4448-bae1-ac26fcdd3627" ]