Freigeben über


Problembehandlung der eingebetteten Eclipse ThreadX-Gerätetutorials

Wenn Sie den Eclipse ThreadX-Lernprogrammen für eingebettete Geräte folgen, treten möglicherweise einige häufige Probleme auf. Im Allgemeinen können Probleme in einer der folgenden Quellen auftreten:

  • Ihre Umgebung. Ihre Maschine, Software oder Netzwerkeinrichtung und -verbindung.
  • Ihre Azure IoT-Ressourcen. Der IoT-Hub und das Gerät, das Sie erstellt haben, um eine Verbindung mit Azure IoT herzustellen.
  • Ihr Gerät. Das physische Board und seine Konfiguration.

Dieser Artikel enthält vorgeschlagene Lösungen für die häufigsten Probleme, die auftreten können, wenn Sie die Lernprogramme abschließen.

Voraussetzungen

Alle Schritte zur Problembehandlung erfordern, dass Sie die folgenden Voraussetzungen abgeschlossen haben, die für die Anleitung gelten, an der Sie arbeiten:

  • Sie haben alle Voraussetzungen und die Softwaretools für das Lernprogramm installiert oder erworben.
  • Sie haben einen Azure IoT-Hub oder eine Azure IoT Central-Anwendung erstellt und ein Gerät registriert, wie im Lernprogramm beschrieben.
  • Sie haben ein Bild für das Gerät erstellt, wie im Lernprogramm beschrieben.

Problem: Das Quellverzeichnis enthält keine CMakeLists.txt Datei.

Beschreibung

Dieses Problem kann auftreten, wenn Sie versuchen, das Projekt zu erstellen. Es ist das Ergebnis, dass das Projekt falsch von GitHub geklont wurde. Das Projekt enthält mehrere Untermodule, die standardmäßig nicht geklont werden, es sei denn, das Flag "--rekursive " wird verwendet.

Resolution

  • Wenn Sie das Repository mit Git klonen, vergewissern Sie sich, dass die Option --rekursiv vorhanden ist.

Problem: Der Build schlägt fehl.

Beschreibung

Das Problem kann auftreten, da der Pfad zu einer Objektdatei die standardmäßige maximale Pfadlänge in Windows überschreitet. Prüfen Sie die Build-Ausgabe auf eine Nachricht ähnlich dem folgenden Beispiel:

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

Resolution

Sie können eine der folgenden Optionen ausprobieren, um diesen Fehler zu beheben:

  • Klonen Sie das Repository in ein Verzeichnis mit einem kürzeren Pfad, und versuchen Sie es erneut.
  • Befolgen Sie die Anweisungen unter "Maximale Pfadlängenbeschränkung ", um lange Pfade in Windows 11 und Windows 10, Version 1607 und höher, zu aktivieren.

Problem: Das Gerät kann keine Verbindung mit dem Iot-Hub herstellen.

Beschreibung

Das Problem kann auftreten, nachdem Sie Azure-Ressourcen erstellt und Ihr Gerät geflashed haben. Wenn Sie versuchen, Ihr neu geblitztes Gerät mit Azure IoT zu verbinden, wird eine Konsolenmeldung wie im folgenden Beispiel angezeigt:

Unable to resolve DNS for MQTT Server

Resolution

  • Überprüfen Sie die Rechtschreibung und den Fall der Konfigurationswerte, die Sie für Ihre IoT-Konfiguration in der Datei azure_config.h eingegeben haben. Bei den Werten für einige IoT-Ressourcenattribute, wie deviceID und primaryKey, wird die Groß- und Kleinschreibung beachtet.

Problem: Wi-Fi kann keine Verbindung herstellen

Beschreibung

Nachdem Sie ein Gerät blinken, das eine Wi-Fi Verbindung verwendet, wird eine Fehlermeldung angezeigt, dass Wi-Fi keine Verbindung herstellen kann.

Resolution

  • Überprüfen Sie ihre Wi-Fi Netzwerkhäufigkeit und -einstellungen. Die in den eingebetteten Gerätelernprogrammen verwendeten Geräte verwenden alle 2,4 GHz. Vergewissern Sie sich, dass Ihr Wi-Fi Router für die Unterstützung eines 2,4-GHz-Netzwerks konfiguriert ist.
  • Überprüfen Sie den Wi-Fi Modus. Überprüfen Sie, welche Einstellung Sie für die WIFI_MODE Konstante in der Datei azure_config.h verwendet haben. Überprüfen Sie Ihre Wi-Fi Netzwerksicherheits- oder Authentifizierungseinstellungen, um zu bestätigen, dass der Wi-Fi Sicherheitsmodus mit den Einstellungen in der Konfigurationsdatei übereinstimmt.

Problem: Das Flashen des Boards ist fehlgeschlagen

Beschreibung

Sie können den Prozess des Flashens Ihres Geräts nicht abschließen. Die folgenden Symptome deuten darauf hin, dass das Blinken unvollständig ist:

  • Die von Ihnen erstellten *.bin Bilddatei wird nicht auf das Gerät kopiert.
  • Das Hilfsprogramm, das Sie zum Flashen des Geräts verwenden, gibt eine Warnung oder einen Fehler zurück.
  • Das Hilfsprogramm, das Sie zum Flashen des Geräts verwenden, sagt nicht, dass die Programmierung erfolgreich abgeschlossen wurde.

Resolution

  • Stellen Sie sicher, dass Sie an den richtigen USB-Anschluss auf dem Gerät angeschlossen sind. Einige Geräte verfügen über mehr als einen Port.
  • Versuchen Sie, ein anderes Micro-USB-Kabel zu verwenden. Einige Geräte und Kabel sind nicht kompatibel.
  • Versuchen Sie, eine Verbindung mit einem anderen USB-Anschluss auf Ihrem Computer herzustellen. Ein USB-Anschluss kann intern getrennt, in der Software deaktiviert oder vorübergehend in einem nicht verwendbaren Zustand sein.
  • Starten Sie den Computer neu.

Problem: Das Gerät kann keine Verbindung zum Port herstellen.

Beschreibung

Nachdem Sie Ihr Gerät flashen und mit Ihrem Computer verbunden haben, erhalten Sie die Ausgabe wie die folgende Meldung in Ihrer Terminalsoftware:

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

Resolution

  • Überprüfen Sie in den Einstellungen für Ihre Terminalsoftware die Porteinstellung , um zu bestätigen, dass der richtige Port ausgewählt ist. Wenn mehrere Ports angezeigt werden, können Sie den Windows-Geräte-Manager öffnen und den Knoten "Ports" auswählen, um den richtigen Port für Ihr verbundenes Gerät zu finden.

Problem: Die Terminalausgabe zeigt unformatierten Text an.

Beschreibung

Nachdem Sie Ihr Gerät erfolgreich geflasht und mit Ihrem Computer verbunden haben, wird in Ihrer Terminalsoftware eine unleserliche Textausgabe angezeigt.

Resolution

  • Vergewissern Sie sich in den Einstellungen für Ihre Terminalsoftware, dass die Baudrate-Einstellung115.200 beträgt.

Problem: Terminalausgabe zeigt keinen Text an

Beschreibung

Nachdem Sie Ihr Gerät erfolgreich flashen und mit Ihrem Computer verbunden haben, wird keine Ausgabe in Ihrer Terminalsoftware angezeigt.

Resolution

  • Vergewissern Sie sich, dass die Einstellungen in Ihrer Terminalsoftware den Einstellungen im Lernprogramm entsprechen.
  • Starten Sie die Terminalsoftware neu.
  • Drücken Sie die Schaltfläche "Zurücksetzen " auf Ihrem Gerät.
  • Vergewissern Sie sich, dass Ihr USB-Kabel ordnungsgemäß angeschlossen ist.

Problem: Kommunikation zwischen Gerät und IoT Hub schlägt fehl

Beschreibung

Nachdem Sie Ihr Gerät flashen und an Ihren Computer anschließen, erhalten Sie eine Ausgabe ähnlich der folgenden Meldung im Terminalfenster.

Failed to publish temperature

Resolution

  • Vergewissern Sie sich, dass die Preis- und Skalierungsstufe eine von "Kostenlos " oder "Standard" ist. Basic wird nicht unterstützt , da es keine Cloud-zu-Gerät- und Geräte-Twin-Kommunikation unterstützt.

Problem: Zusätzliche Nachrichten, die beim Herstellen einer Verbindung mit IoT Central oder IoT Hub gesendet werden

Beschreibung

Da Defender für IoT-Modul standardmäßig vom Geräteende aktiviert ist, beobachten Sie möglicherweise zusätzliche Meldungen in der Ausgabe.

Resolution

  • Um sie zu deaktivieren, definieren Sie NX_AZURE_DISABLE_IOT_SECURITY_MODULE in der NetX Duo-Headerdatei nx_port.h.

Nächste Schritte

Wenn Sie nach der Überprüfung der Probleme in diesem Artikel Ihr Gerät in einem Terminal nicht überwachen oder eine Verbindung mit Azure IoT herstellen können, liegt möglicherweise ein Problem mit der Hardware oder physischen Konfiguration Ihres Geräts vor. Auf der Seite des Herstellers für Ihr Gerät finden Sie Dokumentations- und Supportoptionen.