Compartilhar via

Solução de problemas dos tutoriais de dispositivo inserido do Eclipse ThreadX

  • Artigo

Ao seguir os tutoriais de dispositivo inserido do Eclipse ThreadX, você pode enfrentar alguns problemas comuns. Em geral, podem ocorrer os problemas em uma das seguintes fontes:

  • Seu ambiente. A configuração e a conexão do computador, do software ou da rede.
  • Seus recursos de IoT do Azure. O hub IoT e o dispositivo que você criou para se conectar à IoT do Azure.
  • Seu dispositivo. A placa física e a configuração dela.

Este artigo fornece resoluções sugeridas para os problemas mais comuns que podem ocorrer à medida que você conclui os tutoriais.

Pré-requisitos

Todas as etapas de solução de problemas exigem que você tenha concluído os seguintes pré-requisitos para o tutorial em que está trabalhando:

  • Você instalou ou adquiriu todos os pré-requisitos e as ferramentas de software para o tutorial.
  • Você criou um hub IoT do Azure ou um aplicativo do Azure IoT Central e registrou um dispositivo, conforme indicado no tutorial.
  • Você criou uma imagem para o dispositivo, conforme indicado no tutorial.

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

Descrição

Esse problema pode ocorrer quando você tenta criar o projeto. É o resultado da clonagem incorreta do projeto do GitHub. O projeto contém vários submódulos que não serão clonados por padrão, a menos que o sinalizador --recursive seja usado.

Resolução

  • Ao clonar o repositório usando o Git, confirme se a opção --recursive está presente.

Problema: falha no build

Descrição

O problema pode ocorrer devido ao caminho para um arquivo de objeto exceder o tamanho máximo do caminho padrão no Windows. Examine a saída do build em busca de uma mensagem semelhante ao seguinte exemplo:

-- Configuring done
CMake Warning in C:/embedded tutorials/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 tutorials/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

Experimente usar uma das seguintes opções para resolver esse erro:

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

Problema: o dispositivo não consegue se conectar ao hub IoT

Descrição

O problema pode ocorrer depois que você cria recursos do Azure e instala uma imagem no dispositivo. Ao tentar conectar o dispositivo com uma imagem recém-instalada à IoT do Azure, você vê uma mensagem do console como o seguinte exemplo:

Unable to resolve DNS for MQTT Server

Resolução

  • Verifique a ortografia e o uso de letras maiúsculas e minúsculas dos valores de configuração inseridos para a configuração de IoT no arquivo azure_config.h. Os valores de alguns atributos de recursos de IoT, como deviceID e primaryKey, diferenciam maiúsculas de minúsculas.

Problema: o Wi-Fi não consegue se conectar

Descrição

Depois de instalar uma imagem em um dispositivo que usa uma conexão Wi-Fi, você recebe uma mensagem de erro informando que o Wi-Fi não consegue se conectar.

Resolução

  • Verifique as configurações e a frequência da rede Wi-Fi. Todos os dispositivos usados nos tutoriais do dispositivo inserido usam 2,4 GHz. Confirme se o Wi-Fi está configurado para dar suporte a uma rede de 2,4 GHz.
  • Verifique o modo do Wi-Fi. Confirme a configuração usada para a constante WIFI_MODE no arquivo azure_config.h. Verifique as configurações de autenticação ou de segurança da rede Wi-Fi para confirmar se o modo de segurança do Wi-Fi corresponde ao que existe no arquivo de configuração.

Problema: falha ao instalar uma imagem na placa

Descrição

Não é possível concluir o processo de instalação de uma imagem no dispositivo. Os seguintes sintomas indicam que o flash está incompleto:

  • O arquivo de imagem *.bin criado não é copiado para o dispositivo.
  • O utilitário usado para instalar uma imagem no dispositivo indica um aviso ou um erro.
  • O utilitário usado para instalar uma imagem no dispositivo não indica a conclusão bem-sucedida da programação.

Resolução

  • Verifique se você está conectado à porta USB correta no dispositivo. Alguns dispositivos têm mais de uma porta.
  • Tente usar outro cabo Micro USB. Alguns dispositivos e cabos são incompatíveis.
  • Tente se conectar a outra porta USB no computador. Uma porta USB pode estar desconectada internamente, desabilitada no software ou temporariamente em um estado inutilizável.
  • Reinicie seu computador.

Problema: falha do dispositivo em se conectar à porta

Descrição

Depois de instalar uma imagem no dispositivo e conectá-lo ao computador, você recebe uma saída como a seguinte mensagem no software do terminal:

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

Resolução

  • Nas configurações do software do terminal, verifique a configuração da Porta para confirmar se a porta correta está selecionada. Se várias portas forem exibidas, abra o Gerenciador de Dispositivos do Windows e selecione o nó Portas para encontrar a porta correta para o dispositivo conectado.

Problema: a saída do terminal mostra um texto ilegível

Descrição

Depois de instalar uma imagem no dispositivo com êxito e conectá-lo ao computador, você vê uma saída de texto ilegível no software do terminal.

Resolução

  • Nas configurações do software do terminal, confirme se a configuração Taxa de transmissão é 115.200.

Problema: a saída do terminal não mostra nenhum texto

Descrição

Depois de instalar uma imagem no dispositivo com êxito e conectá-lo ao computador, você não vê nenhuma saída no software do terminal.

Resolução

  • Confirme se as configurações no software do terminal correspondem às configurações descritas no tutorial.
  • Reinicie o software do terminal.
  • Pressione o botão Reiniciar no dispositivo.
  • Confirme se o cabo USB está conectado corretamente.

Problema: falha na comunicação entre o dispositivo e o hub IoT

Descrição

Depois de instalar uma imagem no dispositivo e conectá-lo ao computador, você recebe uma saída como a seguinte mensagem na janela do terminal:

Failed to publish temperature

Resolução

  • Confirme se o Tipo de preço e de escala é Gratuito ou Standard. Não há suporte para o Básico, pois ele não dá suporte à comunicação de nuvem para dispositivo e de dispositivo gêmeo.

Problema: mensagens extras enviadas ao se conectar com o IoT Central ou Hub IoT

Descrição

Como o módulo Defender para IoT está habilitado por padrão no dispositivo, mensagens adicionais podem ser exibidas na saída.

Resolução

  • Para desabilitá-lo, defina NX_AZURE_DISABLE_IOT_SECURITY_MODULE em nx_port.h do arquivo de cabeçalho do NetX Duo.

Próximas etapas

Se, depois de examinar os problemas neste artigo, você ainda não puder monitorar seu dispositivo em um terminal nem se conectar à IoT do Azure, poderá haver um problema com a configuração física ou de hardware do dispositivo. Confira a página do fabricante do dispositivo para encontrar a documentação e as opções de suporte.