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:

  1. Inicie o Visual Studio Code. Selecione Ver>Paleta de comandos e, em seguida, escreva Azure Sphere: Gerar Novo Projeto.

    Barra de comandos no Visual Studio Code

  2. Selecione RTCore Em Branco no menu Modelos.

    menu de pop-up com nomes de modelo

  3. 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:

  1. 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.

  2. 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:

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

  2. 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.

  3. 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:

  1. 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.

  2. 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:

  1. 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.

  2. 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

  1. 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:
  2. 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.

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" ]

Consulte também