Exercício – Configurar o Azure Sphere

  • 10 minutos

Instale o software a seguir em seu computador.

Solução de problemas

  1. Se tiver problemas para se conectar ao Azure Sphere por USB, não deixe de desabilitar as VPNs que você possa ter habilitado.
  2. O Adaptador TAP-Windows V9 instalado com clientes VPN, incluindo o cliente do OpenVPN, não é compatível com o Adaptador TAP-Windows V9 necessário e instalado pelo SDK do Azure Sphere. Você precisará desinstalar o cliente VPN e reinstalar o SDK do Azure Sphere para o Visual Studio.
  3. Usuários do Windows. Se a execução do comando ShowIoTCentralConfig do IoT Central falhar com uma mensagem de biblioteca ausente, exclua a pasta de ShowIoTCentralConfig de AppData\Local\Temp\.net.

Versão do SDK do Azure Sphere

Este módulo de aprendizado requer a versão 20.11 ou mais recente do SDK do Azure Sphere.

Usuários do Windows 10

Este módulo de aprendizado dá suporte a desenvolvedores no Linux e no Windows usando o Visual Studio Code. No entanto, se você for um usuário do Windows que se sente confortável com o uso do Visual Studio, ainda poderá concluir os exercícios tendo em mente que as capturas de tela do IDE incluídas neste módulo serão diferentes.

Você precisa fazer o seguinte:

  1. Instalar o SDK do Azure Sphere mais recente.
  2. Instalar o CMake e o Ninja.
  3. Instale o Visual Studio Code.
  4. Instalar a extensão do Azure Sphere do Visual Studio Code.
  5. Declare seu dispositivo.
  6. Configurar a rede para o dispositivo.

O Início Rápido: Instalar o SDK do Azure Sphere para Windows a seguir vai orientar você ao longo do processo.

Instalar o cliente Git para Windows

O cliente Git é necessário para clonar os Laboratórios do Roteiro de Aprendizagem e os Exemplos do SDK do Azure Sphere.

Instale o Git for Windows.

Instalar o GNU Arm Embedded Toolchain para Windows

  1. Baixe o GNU Arm Embedded Toolchain para Windows.
  2. Instalar o GNU Arm Embedded Toolchain

Usuários do Ubuntu 18.04 ou 20.04 LTS

Você precisa fazer o seguinte:

  1. Instale o SDK do Azure Sphere. Instale a nova CLI azsphere v2.
  2. Configurar a conexão do dispositivo.
  3. Instalar o CMake e o Ninja.
  4. Instale o Visual Studio Code.
  5. Instalar a extensão do Azure Sphere do Visual Studio Code.
  6. Declare seu dispositivo.
  7. Configurar a rede para o dispositivo.

O Início Rápido: Instalar o SDK do Azure Sphere para Linux a seguir vai orientar você ao longo do processo.

Instalar o cliente Git para Linux

O cliente Git é necessário para clonar os Laboratórios do Roteiro de Aprendizagem e os Exemplos do SDK do Azure Sphere.

sudo apt install git

Instalar o GNU Arm Embedded Toolchain para Linux

Instalar o GNU Arm Embedded Toolchain para Linux

  1. Baixe o GNU Arm Embedded Toolchain. No momento da redação deste artigo, essa é a Versão 10-2020-q4-major.

  2. Instale o pacote baixado. O seguinte instala a cadeia de ferramentas no diretório /opt.

    sudo tar -xjvf gcc-arm-none-eabi-10-2020-q4-major-x86_64-linux.tar.bz2 -C /opt

  3. Atualize seu caminho. Abra ~/.bashrc e adicione ao final.

    export PATH=$PATH:/opt/gcc-arm-none-eabi-10-2020-q4-major/bin

  4. Opcional: O depurador de núcleo em tempo real depende da biblioteca libncurses.so.5. Dependendo da configuração do sistema, essa biblioteca talvez já esteja instalada; caso contrário, execute os comandos a seguir.

    sudo add-apt-repository universe
sudo apt-get install libncurses5

A extensão Peacock permite que você altere a cor de se workspace do Visual Studio Code. A extensão Peacock é útil quando você tem várias instâncias do Visual Studio Code abertas. Em um dos exercícios, uma instância do Visual Studio Code será anexada ao núcleo de tempo real e outra será anexada ao núcleo do aplicativo de alto nível.

  1. Abra o painel da barra lateral de Extensões no Visual Studio Code
    • Ou escolha as opções de menu para Exibir → Extensões
  2. Pesquise pelo Peacock
  3. Clique em Instalar
  4. Clique em Recarregar, se necessário

Excluir aplicativos existentes no Azure Sphere

  1. Na linha de comando do PowerShell do Windows ou no Terminal do Linux, execute o comando a seguir para excluir os aplicativos existentes no dispositivo.

    azsphere device sideload delete

  2. Reinicie o Azure Sphere.

    azsphere device restart

Habilitar o desenvolvimento de alto nível do núcleo

  1. Na linha de comando do PowerShell do Windows ou no Terminal do Linux, execute o comando a seguir para habilitar o desenvolvimento de aplicativos de alto nível no dispositivo.

    azsphere device enable-development

Habilitar o desenvolvimento de núcleo em tempo real

Usuários do Windows 10

  1. Abra a linha de comando do PowerShell do Windows como Administrador e execute o comando a seguir para habilitar o desenvolvimento de núcleo de tempo real no dispositivo.

    azsphere device enable-development -r

  2. Feche a linha de comando do PowerShell do Windows

Usuários do Linux

  1. Abra o Terminal do Linux e execute o comando a seguir para habilitar o desenvolvimento de núcleo de tempo real no dispositivo.

    azsphere device enable-development -r

Clonar o Roteiro de Aprendizagem do Desenvolvedor do Azure Sphere

Observação

Clone o Roteiro de Aprendizagem do Desenvolvedor do Azure Sphere para um diretório próximo ao diretório raiz no computador. Por exemplo, c:\lab ou ~/. O motivo é que o processo de build do Azure Sphere usa o CMake, que pode apresentar dificuldades com nomes longos de caminho e diretório.

git clone --depth 1 https://github.com/MicrosoftDocs/Azure-Sphere-Developer-Learning-Path.git Azure-Sphere

Clonar os exemplos do Azure Sphere

O repositório de exemplos de Azure Sphere inclui uma ferramenta necessária para listar os pontos de extremidade de rede do Azure IoT Central.

Clone esse repositório no mesmo diretório em que você clonou o Roteiro de Aprendizagem do Desenvolvedor do Azure Sphere.

git clone --depth 1 https://github.com/Azure/azure-sphere-samples.git