Share via

Depurar um aplicativo de alto nível

  • Artigo

  1. Verifique se o dispositivo está conectado ao computador por USB. No menu Definir item de inicialização, selecione Aplicativo do Azure Sphere (HLCore) em que o Aplicativo Azure Sphere é o nome do aplicativo de alto nível atual ou pressione F5.

    Botão Depurador de GDB remoto

  2. Se você for solicitado a criar o projeto, selecione Sim. O Visual Studio compila o aplicativo, cria um pacote de imagem, o carrega de lado no quadro e inicia-o no modo de depuração. Sideloading significa que o aplicativo é entregue diretamente do computador por meio de uma conexão com fio, em vez de entregue pela nuvem.

    Observe a ID da imagem do pacote de imagem na saída Exibir>Saída>Mostrar de: Saída de compilação . Você usará a ID da imagem mais tarde no Tutorial: Criar uma implantação na nuvem.

  3. Por padrão, a janela Saída mostra a saída da Saída do Dispositivo. Para ver as mensagens do depurador, selecione Depurar no menu mostrar saída de: menu suspenso. Você também pode inspecionar a desmontagem do programa, registros ou memória por meio do menu Depurar>Windows .

Em seguida, você pode usar o depurador do Visual Studio para definir pontos de interrupção, pausar, passar por cima, entrar, reiniciar ou parar o aplicativo.

Enquanto estiver parado em um ponto de interrupção no código-fonte C, você pode abrir uma janela Desmontar que mostra o endereço atual, o mnemônico da montadora para o comando atual e informações como os registros envolvidos ou o comando de código-fonte que está sendo executado.

Para abrir a janela Desmontar :

  1. Verifique se o arquivo de código-fonte C que contém o ponto de interrupção está aberto no Visual Studio.
  2. Selecione Depurar>Desmontagem doWindows> ou pressione Alt+8.

  1. Pressione F5 para criar e depurar o projeto. Se o projeto não tiver sido criado anteriormente ou se os arquivos tiverem sido alterados e a reconstrução for necessária, Visual Studio Code criará o projeto antes do início da depuração.

  2. Aguarde vários segundos para Visual Studio Code criar o aplicativo, criar um pacote de imagem, implantá-lo no quadro e iniciá-lo no modo de depuração. Você verá status atualizações no painel Saída ao longo do caminho.

    Primeiro, o CMake determina se o aplicativo precisa ser criado. Nesse caso, o foco muda para a janela de saída, que exibe a saída de CMake/Build.

    Em seguida, o painel Saída mostra o resultado à medida que o pacote de imagem é implantado no dispositivo. Por fim, o Console de Depuração recebe o foco e mostra a saída do depurador.

Use o depurador Visual Studio Code para definir pontos de interrupção, pausar, passar por cima, entrar, reiniciar ou parar o aplicativo.

Enquanto estiver parado em um ponto de interrupção no código-fonte C, você pode abrir uma exibição de desmontagem que mostra o endereço atual, dados hex brutos, o mnemônico da montadora para o comando atual e informações como os registros envolvidos ou o comando de código-fonte sendo executado.

Para abrir a exibição Desmontar:

  1. Verifique se o arquivo de código-fonte C que contém o ponto de interrupção está aberto em um editor de Visual Studio Code.
  2. Clique com o botão direito do mouse na janela do editor e selecione Abrir Exibição desmontada ou selecione Exibir> Exibiçãode Desmontagem Abertada Paleta> de Comandos.

Para depurar o aplicativo, interrompa-o e reinicie-o com a depuração:

az sphere device app stop --component-id <ComponentId>

az sphere device app start --debug-mode --component-id <ComponentId>

Você deve ver:

<ComponentID>
App state   : debugging
GDB port    : 2345
Output port : 2342
Core        : High-level
Command completed successfully in 00:00:00.9121174.

  1. Abra um prompt de comando e use qualquer cliente terminal do Windows para estabelecer uma conexão Telnet ou TCP bruta para ler o fluxo de saída do processo. Especifique 192.168.35.2 como o endereço IP e 2342 como a porta.

  2. Abra uma interface de linha de comando usando o PowerShell, o Prompt de Comando do Windows ou o shell de comando do Linux. Inicie o depurador de linha de comando gdb :

    Prompt de Comando do Windows

    "C:\Program Files (x86)\Microsoft Azure Sphere SDK\Sysroots\*sysroot*\tools\gcc\arm-poky-linux-musleabi-gdb.exe" IntercoreComms_HighLevelApp.out

    Windows PowerShell

    & "C:\Program Files (x86)\Microsoft Azure Sphere SDK\Sysroots\*sysroot*\tools\gcc\arm-poky-linux-musleabi-gdb.exe" IntercoreComms_HighLevelApp.out

    Nota

    O SDK do Azure Sphere é fornecido com vários sysroots para que os aplicativos possam direcionar diferentes conjuntos de API, conforme descrito em Versão de runtime do aplicativo, sysroots e APIs Beta. Os sysroots são instalados na pasta de instalação do SDK do Azure Sphere em Sysroots.

  3. Defina o destino de depuração remota como endereço IP 192.168.35.2 na porta 2345:

    target remote 192.168.35.2:2345

  4. Execute todos os comandos gdb escolhidos. Por exemplo:

    break main

    c

    Os break comandos e c definem um ponto de interrupção na entrada para main() e, em seguida, continuam a execução após o ponto de interrupção, respectivamente. Várias fontes de documentação estão disponíveis para gdb.