Criar um aplicativo de alto nível

  • Artigo

A maneira mais fácil de criar um novo aplicativo de alto nível é começar com o modelo Blank da extensão Visual Studio Code Azure Sphere e ajustar a configuração ao seu projeto seguindo estas etapas:

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

    Barra de comandos no código do Visual Studio

  2. Escolha HL Em branco no menu Modelos.

    menu pop-up com nomes de modelo

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

  4. Abra o arquivo CMakeLists.txt e especifique a pasta que contém definições para o hardware que você está usando. Por padrão, o aplicativo HL Blank não contém definições de hardware. Você pode encontrar definições de hardware de exemplo no repositório Exemplos do Azure Sphere ou criar uma conforme descrito em definições de hardware.

    O seguinte mostra como adicionar as definições de hardware de exemplo para o Kit de Desenvolvimento mt3620 do Seeed Azure Sphere:

    azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

    Essa linha deve ser inserida antes do comando final iniciar azsphere_target_add_image_package.

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

  1. Clone o repositório de exemplos se você ainda não tiver feito isso. Copie uma das pastas de aplicativo de alto nível 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(NewHLApp C)

A maneira mais fácil de criar um novo aplicativo de alto nível é começar com o modelo Blank da extensão do Visual Studio Azure Sphere e ajustar a configuração ao seu projeto seguindo estas etapas:

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

  2. Digite Azure Sphere na caixa de pesquisa rotulada Pesquisar modelos. Selecione Azure Sphere HLCore Blank na lista retornada e selecione Avançar.

  3. Especifique um nome de projeto (por exemplo, NewHLApp), um local de arquivo de projeto e um nome da solução (que pode ser o mesmo que o nome do projeto) e selecione Criar. O Visual Studio cria a pasta NewHLpp em seu local selecionado e gera os arquivos de build para o aplicativo em branco. Você deve ver mensagens do CMake.

  4. Abra o arquivo CMakeLists.txt e especifique a pasta que contém definições para o hardware que você está usando. Por padrão, o aplicativo HL Blank não contém definições de hardware. Você pode encontrar definições de hardware de exemplo no repositório Exemplos do Azure Sphere ou criar uma conforme descrito em definições de hardware.

    O seguinte mostra como adicionar as definições de hardware de exemplo para o Kit de Desenvolvimento mt3620 do Seeed Azure Sphere:

    azsphere_target_hardware_definition(${PROJECT_NAME} TARGET_DIRECTORY "HardwareDefinitions/mt3620_rdb" TARGET_DEFINITION "sample_appliance.json")

    Essa linha deve ser inserida antes do comando final iniciar azsphere_target_add_image_package.

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

  1. Clone o repositório de exemplos se você ainda não tiver feito isso. Copie uma das pastas de aplicativo de alto nível 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(NewHLApp C)

A maneira mais fácil de criar um novo aplicativo de alto nível é começar com qualquer um dos exemplos do Azure Sphere de alto nível:

  1. Clone o repositório de exemplos se você ainda não tiver feito isso. Copie uma das pastas de aplicativo de alto nível 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(NewHLApp C)

Estrutura de arquivo básica de um aplicativo de alto nível

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, há suporte apenas para o código-fonte do idioma C.
  • Arquivos de compilação do CMake. CMakeLists.txt é necessário. O CMake, juntamente com o utilitário de build leve ninja, é usado para controlar o processo de build de aplicativo do Azure Sphere.
  • Um arquivo de manifesto de aplicativo que descreve os recursos disponíveis para o aplicativo.

Aplicativos de alto nível normalmente têm pelo menos três outros arquivos:

  • Um arquivo applibs-versions.h para especificar os níveis de versão de várias APIs do Azure Sphere
  • Dois arquivos de definição de hardware (uma versão editável no formato JSON e uma linguagem C incluem o arquivo gerado a partir dele) que fornecem uma maneira conveniente de se referir aos componentes de hardware em seu código. Com um conjunto consistente de arquivos de definição de hardware, você pode escrever código-fonte independente de hardware e criar imagens de aplicativo para hardware específico, simplesmente redirecionando o arquivo de definição de hardware apropriado em seu arquivo CMakeLists.txt.

Escreva seu código

  1. Escreva o código do aplicativo usando os exemplos de aplicativo de alto nível do Azure Sphere como guias. Os tópicos a seguir descrevem cenários de implementação específicos:
  2. No arquivoCMakeLists.txt:
    • Especificar revisão de ferramentas do SDK do Azure Sphere
    • Especificar conjunto de API de destino
    • Especificar o hardware de destino
  3. No arquivo app_manifest.json:
    • Defina Name como o nome do projeto.
    • Adicione todas as funcionalidades específicas do aplicativo que seu código exige, como recursos de hardware ou conexões. Se o aplicativo de alto nível se comunicar com um RTApp, adicione a ID do componente do aplicativo de alto nível à AllowedApplicationConnections funcionalidade.

Se você quiser implantar seu aplicativo de alto nível ao lado de um aplicativo parceiro capaz em tempo real, 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" ]

Consulte também