Partager via

Résolution des problèmes liés aux didacticiels sur les appareils incorporés Eclipse ThreadX

  • Article

En suivant les tutoriels Eclipse ThreadX sur les appareils incorporés, vous risquez de rencontrer des problèmes courants. En général, les problèmes se produisent dans l’une des sources suivantes :

  • Votre environnement. Votre ordinateur, logiciel ou la connexion et la configuration réseau.
  • Vos ressources Azure IoT. Le hub IoT et l’appareil que vous avez créés pour vous connecter à Azure IoT.
  • Votre appareil. La carte physique et sa configuration.

Cet article fournit des suggestions de résolutions pour les problèmes les plus courants qui peuvent se produire lors des tutoriels.

Prérequis

Toutes les étapes de résolution des problèmes requièrent que vous remplissiez les prérequis suivants pour le tutoriel que vous utilisez :

  • Vous avez installé ou acquis tous les prérequis et les outils logiciels pour le tutoriel.
  • Vous avez créé un hub Azure IoT ou une application Azure IoT Central, et vous avez inscrit un appareil, comme indiqué dans le tutoriel.
  • Vous avez créé une image pour l’appareil, comme indiqué dans le tutoriel.

Problème : le répertoire source ne contient aucun fichier CMakeLists.txt

Description

Ce problème peut se produire quand vous essayez de créer le projet. Cela est dû au fait que le projet a été incorrectement cloné à partir de GitHub. Le projet contient plusieurs sous-modules qui ne sont pas clonés par défaut, sauf si l’indicateur --recursive est utilisé.

Résolution

  • Quand vous clonez le référentiel à l’aide de Git, vérifiez que l’option --recursive est présente.

Problème : échec de la génération

Description

Le problème peut se produire car le chemin d’accès à un fichier objet dépasse la longueur maximale du chemin par défaut dans Windows. Examinez la sortie de la compilation pour trouver un message similaire à l'exemple suivant :

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

Résolution

Vous pouvez essayer l’une des options suivantes pour résoudre ce problème :

  • Clonez le référentiel dans un répertoire dont le chemin est plus court et réessayez.
  • Suivez les instructions dans Limitation de la longueur maximale du chemin pour autoriser des chemins longs dans Windows 11 et Windows 10, version 1607 et ultérieures.

Problème : connexion impossible de l’appareil au hub IoT

Description

Le problème peut se produire une fois que vous avez créé des ressources Azure et flashé votre appareil. Quand vous essayez de connecter votre appareil qui vient d’être flashé sur Azure IoT, un message de console semblable au message suivant s’affiche :

Unable to resolve DNS for MQTT Server

Résolution

  • Vérifiez l’orthographe et la casse des valeurs de configuration que vous avez entrées pour votre configuration IoT dans le fichier azure_config.h. Les valeurs de certains attributs de ressource IoT, comme deviceID et primaryKey, respectent la casse.

Problème : connexion impossible du Wi-Fi

Description

Après avoir flashé un appareil qui utilise une connexion Wi-Fi, vous obtenez un message d'erreur indiquant que la connexion Wi-Fi est impossible.

Résolution

  • Vérifiez la fréquence et les paramètres de votre réseau Wi-Fi. Les appareils utilisés dans les tutoriels des appareils intégrés utilisent tous 2,4 GHz. Vérifiez que votre routeur Wi-Fi est configuré pour prendre en charge un réseau 2,4 GHz.
  • Vérifiez le mode Wi-Fi. Confirmez le paramètre que vous avez utilisé pour la constante WIFI_MODE dans le fichier azure_config.h. Vérifiez vos paramètres d’authentification ou de sécurité réseau Wi-Fi pour vérifier que le mode de sécurité Wi-Fi correspond au fichier de configuration.

Problème : échec pour flasher la carte

Description

Vous ne pouvez pas effectuer le processus pour flasher votre appareil. Les symptômes suivants indiquent que le flashing est incomplet :

  • Le fichier d’image *.bin que vous créez n’est pas copié sur l’appareil.
  • L’utilitaire que vous utilisez pour flasher l’appareil émet un avertissement ou une erreur.
  • L’utilitaire que vous utilisez pour flasher l’appareil n’indique pas que la programmation s’est terminée avec succès.

Résolution

  • Vérifiez que vous êtes connecté au port USB correct sur l’appareil. Certains appareils ont plus d’un port.
  • Essayez d’utiliser un autre câble micro USB. Certains appareils et câbles sont incompatibles.
  • Essayez de vous connecter à un port USB différent sur votre ordinateur. Un port USB peut être déconnecté en interne, désactivé dans le logiciel ou être temporairement dans un état inutilisable.
  • Redémarrez votre ordinateur.

Problème : échec de la connexion de l’appareil au port

Description

Après avoir flashé votre appareil et l'avoir connecté à votre ordinateur, vous obtenez un message comme le suivant dans votre logiciel de terminal :

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

Résolution

  • Dans les paramètres de votre logiciel terminal, vérifiez le paramètre Port pour confirmer que le port correct est sélectionné. Si plusieurs ports sont affichés, vous pouvez ouvrir le Gestionnaire de périphériques Windows et sélectionner le nœud Ports pour trouver le port approprié pour votre appareil connecté.

Problème : la sortie du terminal affiche un texte altéré

Description

Une fois que vous avez correctement flashé votre appareil et que vous l’avez connecté à votre ordinateur, une sortie de texte altéré s’affiche dans votre logiciel terminal.

Résolution

  • Dans les paramètres de votre logiciel terminal, confirmez que le paramètre de vitesse en bauds est défini sur 115 200.

Problème : la sortie du terminal n’affiche aucun texte

Description

Une fois que vous avez correctement flashé votre appareil et que vous l’avez connecté à votre ordinateur, aucune sortie ne s’affiche dans votre logiciel terminal.

Résolution

  • Vérifiez que les paramètres de votre logiciel terminal correspondent aux paramètres du tutoriel.
  • Redémarrez votre logiciel terminal.
  • Appuyez sur le bouton de réinitialisation de votre appareil.
  • Vérifiez que votre câble USB est correctement connecté.

Problème : échec de la communication entre l’appareil et IoT Hub

Description

Après avoir flashé votre appareil et l'avoir connecté à votre ordinateur, vous obtenez une sortie comme le message suivant dans votre fenêtre de terminal :

Failed to publish temperature

Résolution

  • Vérifiez que Tarification et niveau de mise à l’échelle est défini sur Gratuit ou Standard. Le niveau De base n’est pas pris en charge, car il ne prend pas en charge la communication cloud-à-appareil et jumeau d’appareil.

Problème : messages supplémentaires envoyés lors de la connexion à IoT Central ou IoT Hub

Description

Comme Defender for IoT module est activé par défaut du côté de l'appareil, vous pouvez observer des messages supplémentaires dans la sortie.

Résolution

  • Pour le désactiver, définissez NX_AZURE_DISABLE_IOT_SECURITY_MODULE dans le fichier d’en-tête NetX Duo nx_port.h.

Étapes suivantes

Si vous ne pouvez toujours pas superviser votre appareil dans un terminal ni vous connecter à Azure IoT après avoir passé en revue les problèmes décrits dans cet article, il peut s’agir d’un problème de configuration matérielle ou physique de votre appareil. Pour obtenir la documentation et les options de support, consultez la page du fabricant de votre appareil.