共用方式為

針對 Eclipse ThreadX 內嵌裝置教學課程進行疑難解答

  • 發行項

當您遵循 Eclipse ThreadX 內嵌裝置教學課程時，可能會遇到一些常見問題。 一般而言，下列任一來源可能會發生問題：

  • 您的環境。 您的電腦、軟體或網路設定和連線。
  • 您的 Azure IoT 資源。 您建立以連線至 Azure IoT 的 IoT 中樞和裝置。
  • 您的裝置。 實體面板及其設定。

本文針對完成教學課程時可能發生的最常見問題，提供建議的解決方案。

必要條件

所有疑難解答步驟都需要您已完成您正在使用之教學課程的下列必要條件：

  • 您已安裝或取得本教學課程的所有必要條件和軟體工具。
  • 您已建立 Azure IoT 中樞或 Azure IoT Central 應用程式，並依照教學課程中的指示註冊裝置。
  • 您已依照教學課程中的指示，為裝置建置映像。

問題：來源目錄不包含CMakeLists.txt檔案

描述

當您嘗試建置專案時，可能會發生此問題。 這是從 GitHub 不正確複製項目的結果。 除非使用 --recursive 旗標，否則專案包含預設不會複製的多個子模組。

解決方法

  • 當您使用 Git 複製存放庫時，請確認 存在 --recursive 選項。

問題：組建失敗

描述

發生此問題的原因是物件檔案的路徑超過 Windows 中的預設路徑長度上限。 檢查類似下列範例的訊息組建輸出：

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

解決方法

您可以嘗試下列其中一個選項來解決此錯誤：

  • 將存放庫複製到路徑較短的目錄，然後再試一次。
  • 遵循路徑長度上限限制中的指示，在 Windows 11 和 Windows 10 版本 1607 和更新版本中啟用長路徑。

問題：裝置無法連線到IoT中樞

描述

建立 Azure 資源並快閃您的裝置之後，可能會發生此問題。 當您嘗試將新快閃的裝置連線至 Azure IoT 時，您會看到主控台訊息，如下列範例所示：

Unable to resolve DNS for MQTT Server

解決方法

  • 檢查您在 azure_config.h 檔案 中針對 IoT 組態輸入的組態值的拼字和大小寫。 某些IoT資源屬性的值，例如 deviceID 和 primaryKey，會區分大小寫。

問題：Wi-Fi 無法連線

描述

當您閃爍使用Wi-Fi連線的裝置之後，您會收到Wi-Fi無法連線的錯誤訊息。

解決方法

  • 檢查您的Wi-Fi網路頻率和設定。 內嵌裝置教學課程中使用的裝置全都使用 2.4 GHz。 確認您的Wi-Fi路由器已設定為支援2.4-GHz網路。
  • 檢查Wi-Fi模式。 確認您在 azure_config.h 檔案中用於WIFI_MODE常數的設定。 檢查您的Wi-Fi網路安全性或驗證設定，以確認Wi-Fi安全性模式符合您在組態檔中擁有的內容。

問題：閃爍面板失敗

描述

您無法完成閃爍裝置的程式。 下列徵兆表示閃爍不完整：

  • 您所建置的 *.bin映射檔不會複製到裝置。
  • 您用來閃爍裝置的公用程式會發出警告或錯誤。
  • 您用來刷新裝置的公用程式不會指出程式設計已順利完成。

解決方法

  • 請確定您已連線到裝置上正確的 USB 埠。 某些裝置有多個埠。
  • 請嘗試使用不同的 Micro USB 纜線。 某些裝置和纜線不相容。
  • 請嘗試連線到電腦上的不同 USB 埠。 USB 埠可能會在內部中斷連線、在軟體中停用，或暫時處於無法使用狀態。
  • Restart your computer.

問題：裝置無法連線到埠

描述

快閃裝置並連線到計算機之後，您會在終端機軟體中取得如下訊息的輸出：

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

解決方法

  • 在終端機軟體的設定中 ，檢查 [埠 ] 設定以確認已選取正確的埠。 如果顯示多個埠，您可以開啟 Windows 裝置管理員，然後選取 [埠] 節點來尋找連線裝置的正確埠。

問題：終端機輸出顯示加碼文字

描述

成功刷新裝置並連線到計算機之後，您會在終端機軟體中看到文字輸出的亂碼。

解決方法

  • 在終端機軟體的設定中，確認 Baud速率 設定為 115,200。

問題：終端機輸出未顯示文字

描述

成功刷新裝置並連線到計算機之後，您就不會在終端機軟體中看到任何輸出。

解決方法

  • 確認終端機軟體中的設定符合教學課程中的設定。
  • 重新啟動終端機軟體。
  • 按下裝置上的 [ 重設 ] 按鈕。
  • 確認您的USB纜線已正確連接。

問題：裝置與 IoT 中樞 之間的通訊失敗

描述

快閃裝置並連線到計算機之後，您會在終端機視窗中取得類似下列訊息的輸出：

Failed to publish temperature

解決方法

  • 確認定價和調整層是免費或標準層之一。 不支援 基本，因為它不支援雲端到裝置和裝置對應項通訊。

問題：連線到IoT Central或 IoT 中樞時傳送的額外訊息

描述

由於 適用於IoT的Defender模組 預設會從裝置端啟用，因此您可能會在輸出中觀察到額外的訊息。

解決方法

  • 若要停用它，請在 NetX Duo 標頭檔案中nx_port.h定義 NX_AZURE_DISABLE_IOT_SECURITY_MODULE 。

下一步

如果在檢閱本文中的問題之後，您仍然無法在終端機中監視裝置或連線到 Azure IoT，則裝置的硬體或實體設定可能會有問題。 請參閱裝置的製造商頁面，以尋找檔和支持選項。