針對 Azure Percept DK 裝置進行疑難排解

  • 發行項

重要

淘汰 Azure Percept DK：

更新 2023 年 2 月 22日：Percept DK 視覺和音訊存取元件的韌體更新 (也稱為視覺和音訊 SOM) 現已 可供使用，且可讓輔助元件在淘汰日期之後繼續運作。

Azure Percept 公開預覽版將持續演進，以支援新的邊緣裝置平台和開發人員體驗。 在此演進過程中，Azure Percept DK 和 Audio Accessory 以及 Percept DK 相關聯的 Azure 支援服務將於 2023 年 3 月 30 日淘汰。

自 2023 年 3 月 30 日起，任何 Azure 服務將不再支援 Azure Percept DK 和 Audio Accessory，包括 Azure Percept Studio、作業系統更新、容器更新、檢視 Web 串流，以及自訂視覺整合。 Microsoft 將不再提供客戶成功支援和任何相關聯的支援服務。 如需詳細資訊，請造訪淘汰通知部落格文章。

本疑難排解文章旨在協助 Azure Percept DK 使用者快速解決其開發工具組的常見問題。 本文也提供在需要額外支援時收集記錄的指導。

記錄檔集合

在本節中，您將取得要收集哪些記錄的指導，以及如何收集這些記錄。

如何收集記錄

  1. 透過 SSH 連線至您的開發套件。

  2. 在 SSH 終端機視窗中執行所需的命令。 如需記錄收集命令的清單，請參閱下一節。

  3. 如需將任何輸出重新導向至 .txt 檔案以進行進一步分析，請使用下列語法：

    sudo [command] > [file name].txt

  4. 變更 .txt 檔案的存取權限，以便加以複製：

    sudo chmod 666 [file name].txt

  5. 透過 SCP 將該檔案複製到您的主機：

    scp [remote username]@[IP address]:[remote file path]/[file name].txt [local host file path]

    [local host file path] 是指您要將 .txt 檔案複製到您主機上的位置。 [remote username] 是在 設定體驗期間選擇的 SSH 使用者名稱。

記錄類型及命令

記錄用途 收集時機 Command
支援搭售方案 - 提供大部分客戶支援要求所需的一組記錄。 每當要求支援時進行收集。 sudo iotedge support-bundle --since 1h

"--since 1h" 可以變更為任何時間範圍，例如 "6h" (6 小時) 、 "6d" (6 天) 或 "6m" (6 分鐘)
OOBE 記錄 - 記錄有關設定體驗的詳細資料。 當您在設定體驗期間發現問題時進行收集。 sudo journalctl -u oobe -b
edgeAgent 記錄 - 記錄裝置上執行之所有模組的版本號碼。 一或多個模組無法運作時，進行收集。 sudo iotedge logs edgeAgent
模組容器記錄 - 記錄特定 IoT Edge 模組容器的詳細資料 當您發現模組出現問題時進行收集 sudo iotedge logs [container name]
網路記錄 - 一組記錄，涵蓋 Wi-Fi 服務和網路堆疊。 當您發現 Wi-Fi 或網路問題時進行收集。 sudo journalctl -u hostapd.service -u wpa_supplicant.service -u ztpd.service -u systemd-networkd > network_log.txt

cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version && rpm -q ztpd > system_ver.txt

執行這兩個命令。 每個命令都會收集多個記錄，並將這些紀錄放入單一輸出中。

警告

support-bundle 命令的輸出可以包含主機、裝置及模組名稱、模組紀錄的資訊等。如果在公用論壇中共用輸出，請注意這一點。

針對命令進行疑難排解

以下是一組命令，可對您使用開發工具組可能會找到的問題進行疑難排解。 若要執行這些命令，您必須先透過 SSH 連線到您的開發工具組。

如需 Azure IoT Edge 命令的詳細資訊，請參閱 Azure IoT Edge 裝置疑難排解文件。

函式 使用時機 命令
請檢查開發工具組上的軟體版本。 每當您需要確認開發工具組上的軟體版本時，請加以使用。 cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version
檢查開發工具組的溫度 在您認為開發工具組可能過熱的情況下使用。 cat /sys/class/thermal/thermal_zone0/temp
檢查開發工具組的遙測識別碼 在您需要知道開發工具組唯一遙測識別碼的情況下使用。 sudo azure-device-health-id
檢查 IoT Edge 的狀態 每當 IoT Edge 模組連線到雲端發生問題時，請加以使用。 sudo iotedge check
重新啟動 Azure IoT Edge 安全性精靈 當 IoT Edge 沒有回應或無法正常運作時，請加以使用。 sudo systemctl restart iotedge
列出已部署的 Azure IoT Edge 模組 當您需要查看部署在開發工具組上的所有模組時，請加以使用 sudo iotedge list
顯示指定檔案系統中可用的/總空間 如果您需要知道開發工具組上的可用儲存體，請加以使用。 df [option] [file]
顯示開發工具組的 IP 和介面資訊 當您需要知道開發工具組的 IP 位址時，請加以使用。 ip route get 1.1.1.1
僅顯示開發工具組的 IP 位址 當您只想要開發工具組的 IP 位址，而不需要其他介面資訊時，請加以使用。 ip route get 1.1.1.1 | awk '{print $7}'
ifconfig [interface]

USB 更新錯誤

錯誤： 解決方案：
透過 UUU 在 USB 快閃期間 LIBUSB_ERROR_XXX 此錯誤是 UUU 更新期間 USB 連線失敗產生的結果。 如果 USB 纜線未正確連線到電腦上的 USB 連接埠或 Percept DK 電訊廠商面板，就會發生此表單的錯誤。 請嘗試拔下並重新連接 USB 纜線的兩端，並切換纜線以確保連線安全。

清除 Azure Percept DK 上的硬碟空間

總共有兩個元件佔用 Azure Percept DK 上的硬碟空間、Docker 容器記錄以及 Docker 容器本身。 為了確保容器記錄不會佔用所有硬碟空間，Azure Percept DK 具有內建的記錄輪替，會在產生新記錄時輪替任何舊的記錄。

若 Docker 容器數目造成硬碟空間問題，您可以遵循下列步驟來刪除未使用的容器：

  1. SSH 連線到開發工具組
  2. 執行這個命令：docker system prune

這會移除所有未使用的容器、網路、影像，以及選擇性地移除磁片區。 如需詳細資訊，請前往此頁面。

Azure Percept DK 電訊廠商面板 LED 狀態

電訊廠商外殼頂部上方有三個小 LED。 雲端圖示列印在 LED 1 旁邊、在 LED 2 旁邊列印 Wi-Fi 圖示，而 LED 3 旁邊列印驚嘆號圖示。 如需每個 LED 狀態的資訊，請參閱下表。

LED State 描述
LED 1 (IoT 中樞) 開啟 (常亮燈) 裝置已連線到 IoT 中樞。
LED 2 (Wi-Fi) 慢速閃爍 裝置已就緒，可由 Wi-Fi Easy Connect 進行設定，並宣佈其目前狀態為設定器。
LED 2 (Wi-Fi) 快速閃爍 驗證成功，正在進行裝置關聯。
LED 2 (Wi-Fi) 開啟 (常亮燈) 驗證和關聯成功；裝置已連線到 Wi-Fi 網路。
LED 3 NA LED 未使用中。