針對 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 裝置管理員，然後選取 [連接埠] 節點來尋找已連線裝置的正確連接埠。

問題：終端輸出顯示亂碼

描述

在順利刷新裝置並將其連線到您的電腦之後，您在終端軟體中看到有亂碼的輸出。

解決方法

• 在終端軟體的設定中，確認 [傳輸速率] 設定為 115,200。

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

描述

在順利刷新裝置並將其連線到您的電腦之後，您在終端軟體中沒有看到任何的輸出。

解決方法

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

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

描述

在刷新您的裝置並將其連線到您的電腦之後，您在終端視窗中收到了類似下列訊息的輸出：

Failed to publish temperature

解決方法

• 確認定價與級別層是免費或標準版其中一個。 不支援基本版，因為它不支援雲端到裝置和裝置分身通訊。

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

描述

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

解決方法

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

下一步

如果在檢閱本文中的問題之後，您仍然無法在終端螢幕中監視您的裝置，或連線到 Azure IoT，那麼您的裝置的硬體或實體組態可能有問題。 請參閱您裝置的製造商頁面，以尋找說明文件和支援選項。

• STMicroelectronics B-L475E-IOT01