Resolução de problemas do dispositivo incorporado Azure RTOS

À medida que segue os quickstarts de desenvolvimento do dispositivo incorporado, poderá experimentar alguns problemas comuns. Em geral, as questões podem ocorrer em qualquer uma das seguintes fontes:

  • O seu ambiente. A sua máquina, software ou configuração de rede e ligação.
  • Os seus recursos Azure IoT. O hub ioT e dispositivo que criou para ligar ao Azure IoT.
  • O seu dispositivo. A placa física e a sua configuração.

Este artigo fornece resoluções sugeridas para as questões mais comuns que podem ocorrer à medida que completa os quickstarts.

Pré-requisitos

Todos os passos de resolução de problemas requerem que tenha completado os seguintes pré-requisitos para o arranque rápido em que está a trabalhar:

  • Instalou ou adquiriu todos os pré-requisitos e ferramentas de software para o arranque rápido.
  • Criou um hub Azure IoT ou uma aplicação Azure IoT Central, e registou um dispositivo, como indicado no quickstart.
  • Construíste uma imagem para o dispositivo, como direcionado para o arranque rápido.

Problema: O diretório de origem não contém CMakeLists.txt ficheiro

Descrição

Esta questão pode ocorrer quando se tenta construir o projeto. É o resultado do projeto ter sido incorretamente clonado de GitHub. O projeto contém vários submódulos que não serão clonados por defeito a menos que a bandeira recursiva seja usada.

Resolução

  • Quando clonar o repositório usando Git, confirme que a opção recursiva está presente.

Problema: A construção falha

Descrição

O problema pode ocorrer porque o caminho para um ficheiro de objeto excede o comprimento máximo do caminho em Windows. Examine a saída de construção para uma mensagem semelhante ao seguinte exemplo:

-- Configuring done
CMake Warning in C:/embedded quickstarts/areallyreallyreallylongpath/getting-started/core/lib/netxduo/addons/azure_iot/azure_iot_security_module/iot-security-module-core/CMakeLists.txt:
  The object file directory

    C:/embedded quickstarts/areallyreallyreallylongpath/getting-started/NXP/MIMXRT1060-EVK/build/lib/netxduo/addons/azure_iot/azure_iot_security_module/iot-security-module-core/CMakeFiles/asc_security_core.dir/./

  has 208 characters.  The maximum full path to an object file is 250
  characters (see CMAKE_OBJECT_PATH_MAX).  Object file

    src/serializer/extensions/custom_builder_allocator.c.obj

  cannot be safely placed under this directory.  The build may not work
  correctly.


-- Generating done

Resolução

Pode tentar uma das seguintes opções para resolver este erro:

  • Clone o repositório num diretório com um caminho mais curto e tente novamente.
  • Siga as instruções na Limitação máxima do comprimento do caminho para permitir longos caminhos em Windows 11 e Windows 10, versão 1607 e posterior.

Problema: O dispositivo não consegue ligar-se ao hub do Iot

Descrição

O problema pode ocorrer depois de ter criado recursos Azure e ter mostrado o seu dispositivo. Quando tenta ligar o seu dispositivo recém-piscado ao Azure IoT, vê uma mensagem de consola como o seguinte exemplo:

Unable to resolve DNS for MQTT Server

Resolução

  • Verifique a ortografia e o caso dos valores de configuração introduzidos para a sua configuração IoT no ficheiro azure_config.h. Os valores de alguns atributos de recursos IoT, tais como deviceID e primaryKey, são sensíveis a casos.

Problema: Wi-Fi é incapaz de se ligar

Descrição

Depois de piscar um dispositivo que utiliza uma ligação Wi-Fi, obtém-se uma mensagem de erro que Wi-Fi não consegue ligar.

Resolução

  • Verifique a frequência e as definições de rede Wi-Fi. Os dispositivos utilizados no dispositivo incorporado utilizam todos 2,4 GHz. Confirme que o seu router Wi-Fi está configurado para suportar uma rede de 2,4 GHz.
  • Verifique o modo Wi-Fi. Confirme a configuração utilizada para a WIFI_MODE constante no ficheiro azure_config.h . Verifique as definições de segurança ou autenticação de rede Wi-Fi para confirmar que o modo de segurança Wi-Fi corresponde ao que tem no ficheiro de configuração.

Problema: Piscar o tabuleiro falha

Descrição

Não é possível completar o processo de piscar o seu dispositivo. Os seguintes sintomas indicam que o piscar está incompleto:

  • O ficheiro de imagem *.bin que construíste não copia para o dispositivo.
  • O utilitário que está a usar para piscar o dispositivo dá um aviso ou erro.
  • O utilitário que está a usar para piscar o dispositivo não diz que a programação foi concluída com sucesso.

Resolução

  • Certifique-se de que está ligado à porta USB correta do dispositivo. Alguns dispositivos têm mais de uma porta.
  • Tente utilizar um cabo Micro USB diferente. Alguns dispositivos e cabos são incompatíveis.
  • Tente ligar-se a uma porta USB diferente no seu computador. Uma porta USB pode ser desligada internamente, desativada em software ou temporariamente num estado inutilizável.
  • Reinicie o computador.

Problema: Dispositivo não se liga à porta

Descrição

Depois de piscar o seu dispositivo e conectá-lo ao computador, obtém a saída como a seguinte mensagem no seu software terminal:

Failed to initialize the port.
Please verify the COM port settings.

Resolução

  • Nas definições do seu software de terminal, verifique a definição da Porta para confirmar que a porta correta está selecionada. Se houver várias portas apresentadas, pode abrir Windows Gestor de Dispositivos e selecionar o nó portões para encontrar a porta correta para o seu dispositivo conectado.

Problema: Saída terminal mostra texto enrugado

Descrição

Depois de piscar o seu dispositivo com sucesso e conectá-lo ao seu computador, vê a saída de texto aguçada no seu software terminal.

Resolução

  • Nas definições para o seu software terminal, confirme que a definição da taxa Baud é de 115.200.

Problema: Saída terminal não mostra texto

Descrição

Depois de piscar o seu dispositivo com sucesso e conectá-lo ao computador, não vê saída no seu software terminal.

Resolução

  • Confirme que as definições do seu software terminal coincidem com as definições no arranque rápido.
  • Reinicie o seu software terminal.
  • Prima o botão Reset no seu dispositivo.
  • Confirme se o cabo USB está corretamente ligado.

Problema: Falha na comunicação entre dispositivo e Hub IoT

Descrição

Depois de piscar o seu dispositivo e conectá-lo ao computador, obtém-se saída como a seguinte mensagem na janela do terminal:

Failed to publish temperature

Resolução

  • Confirme que o preço e o nível de escala são de Free ou Standard. O básico não é suportado , uma vez que não suporta comunicação dupla cloud-to-device e dispositivo.

Problema: Mensagens extra enviadas ao ligar-se à IoT Central ou Hub IoT

Descrição

Uma vez que o módulo Defender para IoT está ativado por predefinição a partir da extremidade do dispositivo, poderá observar mensagens extra na saída.

Resolução

  • Para desativá-lo, defina NX_AZURE_DISABLE_IOT_SECURITY_MODULE no ficheiro nx_port.hde cabeçalho NetX Duo .

Passos seguintes

Se depois de rever os problemas deste artigo, ainda não conseguir monitorizar o seu dispositivo num terminal ou ligar-se ao Azure IoT, poderá haver um problema com o hardware ou configuração física do seu dispositivo. Consulte a página do fabricante para encontrar documentação e opções de suporte.