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

  • Artigo

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

  • O seu ambiente. Configuração e ligação da sua máquina, software ou rede.
  • Seus recursos do Azure IoT. O hub IoT e o dispositivo que você criou para se conectar ao Azure IoT.
  • O seu dispositivo. A placa física e sua configuração.

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 ferramentas de software para o tutorial.
  • Você criou um hub do Azure IoT 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 CMakeLists.txt arquivo

Description

Esse problema pode ocorrer quando você tenta criar o projeto. É o resultado do projeto ter sido clonado incorretamente 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: a compilação falha

Description

O problema pode ocorrer porque o caminho para um arquivo de objeto excede o comprimento máximo de caminho padrão no Windows. Examine a saída da compilação para uma mensagem semelhante ao exemplo a seguir:

-- 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

Você pode tentar 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 em Limitação de comprimento máximo de 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

Description

O problema pode ocorrer depois de criar recursos do Azure e piscar o dispositivo. Quando você tenta conectar seu dispositivo recém-piscado ao Azure IoT, você vê uma mensagem de console como o exemplo a seguir:

Unable to resolve DNS for MQTT Server

Resolução

  • Verifique a ortografia e maiúsculas e minúsculas dos valores de configuração que você inseriu para sua configuração de IoT no arquivo azure_config.h. Os valores de alguns atributos de recursos da IoT, como deviceID e primaryKey, diferenciam maiúsculas de minúsculas.

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

Description

Depois de piscar 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 a frequência e as definições da sua rede Wi-Fi. Os dispositivos usados nos tutoriais de dispositivos incorporados usam todos 2,4 GHz. Confirme se o seu router Wi-Fi está configurado para suportar uma rede de 2,4 GHz.
  • Verifique o modo Wi-Fi. Confirme qual configuração você usou para a constante de WIFI_MODE no arquivo azure_config.h . Verifique as definições de segurança ou autenticação da rede Wi-Fi para confirmar se o modo de segurança Wi-Fi corresponde ao que tem no ficheiro de configuração.

Problema: Falha ao piscar a placa

Description

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

  • O arquivo de imagem *.bin que você criou não copia para o dispositivo.
  • O utilitário que você está usando para piscar o dispositivo dá um aviso ou erro.
  • O utilitário que você está usando para piscar o dispositivo não diz que a programação foi concluída com êxito.

Resolução

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

Problema: o dispositivo não consegue se conectar à porta

Description

Depois de piscar o dispositivo e conectá-lo ao computador, você obtém 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 Porta para confirmar se a porta correta está selecionada. Se houver várias portas exibidas, você poderá abrir o Gerenciador de Dispositivos do Windows e selecionar o nó Portas para encontrar a porta correta para o dispositivo conectado.

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

Description

Depois de piscar o dispositivo com êxito e conectá-lo ao computador, você verá 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 da taxa de transmissão é 115.200.

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

Description

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

Resolução

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

Problema: a comunicação entre o dispositivo e o Hub IoT falha

Description

Depois de piscar o dispositivo e conectá-lo ao computador, você obtém a seguinte mensagem na janela do terminal:

Failed to publish temperature

Resolução

  • Confirme se o nível de Preço e escala é Gratuito ou Padrão. O Basic não é suportado , uma vez que não suporta comunicação cloud-to-device e device twin.

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

Description

Como o módulo Defender for IoT está habilitado por padrão na extremidade do dispositivo, você pode observar mensagens extras na saída.

Resolução

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

Próximos passos

Se, depois de analisar os problemas neste artigo, você ainda não conseguir monitorar seu dispositivo em um terminal ou conectar-se ao Azure IoT, pode haver um problema com o hardware ou a configuração física do dispositivo. Consulte a página do fabricante do seu dispositivo para encontrar opções de documentação e suporte.