疑難解答 Azure 球體問題

  • 發行項

以下是安裝和設定期間可能發生之問題的一些疑難解答步驟。

裝置通訊問題

從主計算機連線到裝置失敗的原因可能有很多，而且可能會觸發數個錯誤訊息的任何一則，視遇到的工具或應用程式而定。 下列錯誤訊息可能表示連線失敗：

  • An error occurred. Please check your device is connected and your PC has been configured correctly, then retry.
  • Could not connect to the device. Check if your device is connected to the PC. The device may be unresponsive if it is applying an Azure Sphere operating system update; wait a few minutes and then retry. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.
  • An unexpected issue occurred. Please try again; if the issue persists, please refer to aka.ms/azurespheresupport for troubleshooting suggestions and support.
  • Failed to retrieve device ID from attached device: 'Could not connect to the device; please ensure it is attached.'
  • Failed to establish communication with device after recovery.

有三個元件可能會造成裝置通訊問題： (1) 命令行介面本身; (2) 可促進與裝置通訊的DCS) 裝置通訊服務 (DCS; (3) 裝置。

若要隔離原因，請執行下列診斷步驟：

  1. 確認您可以直接與裝置通訊。 在網頁瀏覽器中流覽。https://192.168.35.2/status 忽略並關閉任何顯示的 SSL 警告。 您應該會在網頁瀏覽器視窗中看到類似： {"uptime":56} 的輸出。

注意

您也可以從命令行使用 curl https://192.168.35.2/status --insecure執行此步驟。

注意

您也可以從 PowerShell (v6 或更高 Invoke-WebRequest https://192.168.35.2/status -SkipCertificateCheck) 執行此步驟。

  1. 確認裝置通訊服務偵測到裝置。 http://localhost:48938/api/service/devices在網頁瀏覽器中流覽，並確認 JSON 輸出中至少顯示一個裝置。

警告

Linux DCS 僅包含在 SDK 版本 23.05 及更新版本中。 遵循 SDK 版本 22.11 及較舊版本的 舊版疑難解答步驟 。

注意

您也可以透過從 PowerShell Invoke-WebRequest http://localhost:48938/api/service/devices執行此步驟。

DCS 無法直接與裝置通訊，且DCS未偵測到裝置

如果無法與裝置建立連線 (步驟 1) 且 DCS (步驟 2) 無法偵測到該裝置，則實體裝置設定可能發生問題。

首先，檢查計算機偵測到的裝置。

從終端機：

  1. 執行 sudo lsusb。 確認 未來Technology Devices International， Ltd FT4232H Quad HS USB-UART/FIFO IC 出現在輸出中。

使用 PowerShell 視窗：

  1. 執行 Get-PnpDevice -PresentOnly | Where-Object { $_。InstanceId -match '^USB' }。 確認輸出中顯示 MSFT MT3620 Std 介面 。

如果先前的命令 未 傳回預期的輸出，請將裝置連接到不同的 USB 埠。 如果仍無法解決您的問題，請檢查裝置是否已正確設定其跳線。 例如，Seeed MT3620 開發工具包是從原廠出貨，其中包含橫跨 J3 圖釘 2 和 3 的跳線標頭，從主要電源供應器啟用時鐘。 檢查頁首是否尚未移除或移除。

無法直接與裝置通訊，但 DCS 偵測到 裝置

如果無法與裝置建立連線 (步驟 1) ，但 DCS (步驟 2) 偵測到該裝置，則可能是裝置或裝置通訊服務處於不良狀態。

如果您剛將裝置連線到因特網，而且裝置的作業系統已過期，則裝置可能正在套用操作系統更新。 如果時間與發行視窗一致，裝置進行操作系統更新的可能性也很小。 在作業系統更新期間，您將無法與裝置通訊。

如果您懷疑裝置是最新狀態且/或未連線到因特網，則下一個最佳選項是拔除插頭並將裝置重新連接到您的電腦。 這應該會造成DCS更新其與裝置的連線，並將裝置重設為初始狀態。

如果您無法拔除插頭並重新連接裝置，下一個最佳選項是重新啟動DCS。 從終端機：

  1. 執行 sudo azspheredctl restart。 確認命令已成功完成。
    1. 如果指令失敗，請執行 sudo systemctl restart azsphered。

如果您無法拔除插頭並重新連接裝置，下一個最佳選項是發行DCS的 Rescan 命令。 收到此命令時，DCS 會迴圈並重設用來與 MT3620 通訊的 FTDI 介面晶片。 使用 PowerShell 視窗：

  1. 執行命令 az sphere device rescan-attached

現在重新執行您一開始嘗試的命令。 如果問題仍未解決，下一個最佳選項是嘗試重新啟動DCS。 從系統管理員層級的 Powershell 視窗：

  1. 執行 Restart-Service -Name AzureSphereDeviceCommunicationService。 確認命令已成功完成。

或者，使用圖形使用者介面重新啟動DCS。

  1. 按 [開始 ] 並輸入 [服務]。 以滑鼠右鍵按兩下 Azure 球體裝置通訊服務 ，然後選取 [重新啟動]。

現在重新執行您一開始嘗試的命令。

如果指令持續失敗，或 az sphere device list-attached 輸出結果類似：

1 device attached:
--> Device ID: Cannot get device ID
  --> Is responsive: no
  --> IP address: 192.168.35.2
  --> Connection path: 213

運行 az sphere device recover

可以直接與裝置通訊，且DCS 偵測到 裝置

這可能表示 CLI 有問題。 請確定您有最新版本的 SDK。

如果您有最新版本的 SDK，但問題仍未解決，請將問題張貼至 Q&A 論壇。

中斷連線或遺失裝置

如果您的計算機可以連線到 Azure 球體裝置，但通常會中斷連線，表示您可能在 IP 子網中發生衝突。

Azure 球體使用子網 192.168.35.*。 如果您有其他使用相同子網的軟體，請停用該軟體或限制所使用的IP位址範圍。 目前，您無法變更 Azure 球體使用的 IP 位址範圍。

無法套用裝置功能

如果您在嘗試將 裝置功能 套用至 Azure 球體裝置時收到錯誤訊息，可能是裝置上的作業系統過期。 如果裝置長時間處於離線狀態，Microsoft 在該期間更新其內部密鑰，就可能會發生此問題。 下列錯誤是此問題的問題：

az 球形裝置啟用開發或 az 球形裝置啟用雲端測試命令會傳回類似下列的錯誤：

error: The device did not accept the device capability configuration. Please check the Azure Sphere OS on your device is up-to-date using 'az sphere device show-deployment-status'.

az 球形裝置功能更新命令會傳回類似下列情況的錯誤：

error: Could not apply device capability configuration to device.

這是因為裝置上受信任的鍵盤已過期。 若要解決這個問題，請依照 這裡的指示進行。

無法建立四個 USB 序列轉換程式

設定 MT3620 開發面板之後，您應該會在 裝置管理員 中看到四個 USB 序列轉換程式。 如果您看到少於四個，可能是 FTDI 驅動程式發生問題。

注意

如果此面板先前已用於 RTApp 開發，您可能會看到三個轉換程式，而非四個。 這是正常現象，並不代表錯誤。

如果未正確安裝 FTDI 驅動程式，轉換程式可能會出現在錯誤的位置，例如其他裝置，或可能完全無法顯示。

若要解決此問題：

  1. 若要開啟 裝置管理員，請按兩下 [開始]，然後輸入 裝置管理員。

  2. 在 [通用串行總線控制器] 底下，選取 [USB 串行轉換器 A]。以滑鼠右鍵按鍵按下列 選項時移除驅動程式：

    卸載裝置並刪除驅動程式

    針對 USB 串行轉換器 B 到 USB 串行轉換器 D 重複此步驟。

  3. 從電腦拔除開發面板，再重新插回。 「MSFT MT3620 Std Interface」應該會顯示三角形警告圖示，表示沒有可用的驅動程式。

  4. 以滑鼠右鍵按兩下其中一個 MSFT MT3620 Std Interface 裝置，然後選取 [更新驅動程式]。 針對更新的驅動程式軟體，選擇 [自動 搜尋]。更新更新應該會全部修正。 您現在應該會在 [通用串行總線控制器] 區段中看到四個 USB 序列轉換器。 如果四個轉換程式都未顯示出來，請針對每個轉換器重複此步驟。

無法安裝 FTDI 驅動程式

當 Azure 球體裝置第一次插入電腦時，Windows 應該會自動下載並安裝 FTDI 驅動程式。 如果驅動程式已正確安裝，您會在 裝置管理員的通用串行總線控制器下方看到四個 USB 串行轉換器，如設定您的開發人員套件中所述。

Windows 10 版本 2004 不會搜尋驅動程式。 在此情況下，系統不會自動下載並安裝驅動程式，且您會在 裝置管理員 中看到下列專案：

裝置管理員 中列出的 MT3620 專案

若要安裝驅動程式，請從 Future Technology Devices International (FTDI) 手動下載驅動程式。 選擇符合您 Windows 安裝 (32 位或 64 位) 的驅動程式。

如需 Windows 10 版本的可用性日期和組建編號，請參閱 Windows 10 發行資訊。 此資訊可協助您判斷您的 Windows 10 版本早於或晚於版本 2004。

TAP-Windows 配接器設定所造成的連線問題

Azure 球體工具透過USB使用IP網路與附加的開發面板通訊。 這需要 OpenVPN Technologies 的 TAP-Windows 適配卡。 Azure 球體 SDK 安裝程式會在您的電腦上安裝此配接器，如果尚未出現此適配卡。

TAP-Windows 配接器回報了兩種不同類型的問題：

  • 如果已安裝不同版本的 TAP-Windows 適配卡，或 Azure 球體裝置未連線至 TAP-Windows 適配卡的第一個實例，Azure 球體工具可能無法連線到您的裝置。

  • 如果您使用 Cisco AnyConnect 虛擬專用網 (VPN) ，您的 TAP-Windows 適配器可能會顯示為未擷取，且裝置通訊可能無法運作。 這是因為 VPN 可以將流量從 TAP 適配卡的 IP 位址重新導向。

確定 Azure 球體裝置已連接到適當的 TAP-Windows 卡

若要判斷問題是否與 TAP 配接器相關，請先找出電腦上已安裝多少 TAP 配接器，然後視需要修改安裝。

若要判斷電腦上已安裝多少 TAP 配接器：

  1. 開啟 [Windows 設定]，然後選 取 [網络 & 因特網 群組。

  2. 在 [ 進階網络設定] 底下，選 取 [變更適配卡選項]。 您應該只會看到一個 TAP 適配卡，如下列螢幕快照所示：

    一個 TAP 配接器

    如果您看到多個 TAP 適配卡，或者只看到一個 TAP 適配卡，但其名稱不是 Azure 球體，請依照下列步驟卸載所有 TAP 適配卡並重新安裝 SDK。 如果您沒有看到 TAP 適配卡，請重新安裝 SDK。

若要卸載 TAP 配接器：

  1. 按兩下 [開始] 並輸入 裝置管理員。

  2. 在 裝置管理員 中，開啟 [網络適配器]，然後選取 [TAP-Windows 適配卡]：

    使用 TAP 配接器 裝置管理員

  3. 以滑鼠右鍵按兩下 [TAP-Windows 適配卡 ]，然後選取 [ 卸載裝置]。 在對話框中，選 取 [刪除此裝置的驅動程序軟體]，然後按兩下 [ 卸載]。

  4. 以系統管理員身分開啟命令提示字元，並執行下列 Powershell 安裝程式腳本：

     powershell -ExecutionPolicy RemoteSigned -File "%ProgramData%\Microsoft\Azure Sphere\TapDriverInstaller\TapDriverInstaller.ps1" Install

  5. 如果安裝成功，請重新啟動 Azure 球體裝置通訊服務：

    net stop AzureSphereDeviceCommunicationService

    net start AzureSphereDeviceCommunicationService

  6. 重新安裝 Azure 球體 SDK。

修正使用 Cisco AnyConnect VPN 用戶端時的未鏈接狀態

當您使用 Cisco AnyConnect VPN 用戶端時，TAP-Windows 適配卡可能會顯示為未擷取，且裝置通訊可能無法運作。 您可以修正問題，如下所示：

  1. 請確定您的電腦有系統管理員許可權。

  2. 開啟 [Windows 設定]，然後選 取 [網络 & 因特網 群組。

  3. 在 [ 進階網络設定] 底下，選 取 [變更適配卡選項]。

  4. 以滑鼠右鍵按兩下 [Azure 球 TAP-Windows 轉接器 V9 ，然後選取 [ 內容]。

  5. 在 [ 網络] 索引標籤 上，找出 Cisco AnyConnect Network Access Manager 篩選驅動 程序專案，並清除該專案。

    顯示 Cisco AnyConnect 專案未選取的 TAP-Windows 配接器屬性

  6. 選取 [確定 ] 以儲存設定並結束屬性。

  7. 開啟命令提示字元並輸入 az sphere device show-attached 命令，檢查目前與 Azure 球體裝置的通訊是否正常運作。

裝置無回應

Azsphere 命令出現下列一或多個錯誤，可能表示 Azure 球體裝置通訊服務無法啟動：

  • warn: Device is not responding. Could not perform version check.​
  • Device is not responding. Cannot get device ID.​
  • error: Could not connect to the Azure Sphere Device Communication Service. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.​
  • error: The device is not responding. The device may be unresponsive if it is applying an Azure Sphere operating system update; please retry in a few minutes.

確定您已執行 裝置通訊疑難解答步驟。

如果您的問題仍未解決，而且您的計算機最近已執行 Windows 更新，則裝置通訊服務可能會在 Windows 更新之後無法啟動，以及在其中一個內部 JSON 設定檔案或設定檔案損毀的情況下。

Windows Update 之後失敗

這些錯誤可能會在您更新電腦上的 Windows 之後發生。 有時候 Windows Update 卸載通訊服務所需的 FTDI 驅動程式。

若要解決問題：

  1. 從USB拔除 Azure 球體裝置，然後再次插回。 重新安裝裝置時，應該會重新安裝正確的驅動程式。
  2. 如果拔除並重新拖曳裝置無法修正問題，請卸載並重新安裝 Azure 球體 SDK。

JSON 檔案

如果您最近未更新 Windows，錯誤的原因可能是 restore.json 該服務所用的檔案。

若要解決此問題：

  1. 儲存下列檔案的複本：

    c:\windows\serviceprofiles\localservice\appdata\local\Azure Sphere Tools\restore.json

  2. 從檔案的原始位置刪除檔案。

  3. 停止，然後重新啟動 Azure 球體裝置通訊服務：

    net stop AzureSphereDeviceCommunicationService

    net start AzureSphereDeviceCommunicationService

已損毀的設定檔案

如果在您嘗試執行命令時回報錯誤，損毀的設定檔案可能會使您的裝置無法正確執行。

若要解決此問題，請刪除位於 Windows 上的 .azsphere\config 或 ~/.azsphere/config 上的損毀設定檔案。

Windows 在插入或拔除裝置時當機

MT3620 開發人員面板具有未來技術裝置國際 (FTDI) FT4232HQ 晶片，可促進裝置和計算機之間的通訊。 官方的 FTDI 驅動程式「合併驅動程式模型 (CMD) 」包含兩個驅動程式：一個可透過 D2XX API 存取，另一個則提供同一個裝置的虛擬 com 埠 (VCP) 。 如果 FTDI 晶片已啟用 VCP 模式，則預設會安裝這兩個驅動程式。 這可能會在晶片電力迴圈時造成 Windows 當機。

若要解決此問題，您可以停用 FTDI 晶片的 VCP 模式。 您必須使用FT_PROG工具來重新規劃 FTDI 晶片的 EEPROM。

  1. 請參閱 FTDI FT_PROG程式設計工具 ，瞭解如何下載及安裝此工具。

  2. 如FT_PROG GUI 應用程式中所述，執行 FT_PROG並尋找您的連接裝置。

  3. 在 [裝置樹] 檢視中，展開 [硬體特定] 區段。 您應該會看到四個埠。

    FTProg 硬體特定四個埠

  4. 選 取 [埠 A ]，然後選擇 [D2XX Direct ]，而不是 [虛擬 Com 連接埠]。

    選取埠 A 和 D2XX 直接

  5. 對埠 C 和埠 D 重複上一個步驟。埠 B 應該已經處於 D2XX Direct 模式。

  6. 選取 [程序裝置] 圖示， (類似閃電) 進入程序設計模式。

    點選單擊 [程序裝置]

  7. 選取 [程式 ] 以程式化 EEPROM，然後等待它完成。

    程序裝置

  8. 從 USB 埠拔除裝置，然後重新連接裝置以開啟電源迴圈，並使變更生效。 在 Windows 裝置管理員 中，[埠 (COM & LPT) 一節現在應該會顯示三個較少的 COM 埠。 通用串行總線裝置的數量應該維持不變。

啟用 RTApp 偵錯之後，與非 Azure 球體 FTDI 裝置的連線中斷

部分 Azure 球體使用者在使用 az 球體裝置啟用開發 -enable-rt-core-debugging 命令從其主計算機開發和偵錯 RTApps 之後，已回報無法再與其他附加的非 Azure 球體 FTDI 裝置通訊。

例如，如果您的計算機同時連接 Azure 球體裝置和不同的 FTDI 裝置，您可能會在執行命令之前，在 Windows 裝置管理員 中看到兩個名為 USB 串行轉換器 B 裝置的通用串行控制器。

具有兩個串行轉換器 B 的設備管理員

執行命令之後，USB Serial Converter B 裝置從 [通用串行總線控制器] 區段消失，而兩個新裝置出現在 裝置管理員 中顯示的通用串行總線裝置中。

設備管理員兩部 USB 裝置

原因

發生此問題的原因在於 az 球形裝置啟用開發 -- enable-rt-core-debugging 命令會在 MT3620 上安裝適用於 FTDI 晶片之埠 B 的新驅動程式;埠隨即變成 MSFT MT3620 Std 介面。 不過，安裝此驅動程式時，不慎變更其他非 Azure 球體裝置之埠 B 的驅動程式。 由於基礎庫中的限制，所有配備相同 VID (0x0403) 和 PID (0x6011) 的 FTDI 裝置都會更換其埠 B 驅動程式。

解決方案

請依照下列步驟，將任何非 Azure 球體裝置的驅動程式手動還原為先前的版本：

  1. 在 裝置管理員 中，在範例) 中選取非 Azure 球體裝置 (另一個 FTDI Quad GZ，然後以滑鼠右鍵按兩下並選取 [更新驅動程式]。

  2. 在 [更新驅動程式] 中，選 取 [瀏覽電腦上的驅動程序軟體]。

    瀏覽電腦上的驅動程式

  3. 選 取 [讓我從計算機上的可用驅動程式清單中挑選]。

    讓我挑選

  4. 從清單中選取 USB 串行轉換器 B 驅動程式，然後按 [ 下一步]。

    usb 序列轉換器 b

  5. 按兩下確認視窗中的 [ 關閉 ]。

  6. 裝置管理員 應該會將其他 FTDI 裝置的埠 B 顯示為 USB 串行轉換器 B，表示它使用正式的 FTDI 驅動程式。 MT3620 的驅動程式仍然是 MSFT MT3620 Std 介面。

    埠 B 已還原

其他資訊

  • 如果您在執行 azsphere 裝置啟用開發 -- enable-rt-core-debugging 命令后插入另一個新的非 Azure 球體 FTDI 裝置，該裝置將會以相同的方式獲派 Azure 球體 MT3620 的驅動程式。 重複上述步驟，將裝置還原為正式的 FTDI 驅動程式。

  • 如果將非 Azure 球體 FTDI 裝置還原到正式的 FTDI 驅動程式之後拔除插頭再重新插入，裝置將會保留正式的 FTDI 驅動程式。

  • 如果您在還原驅動程序之後再次執行 az 球形裝置啟用開發 - enable-rt-core-debugging 命令，非 Azure 球體 FTDI 裝置會再次更換其驅動程式，而且您必須依照 解決方案 中的步驟還原為正式的 FTDI 驅動程式。 不論 Azure 球體 FTDI 裝置在 執行 az 球體裝置啟用開發時是否連接到計算機，都會發生這種情況 -- enable-rt-core-debugging 命令。

無法辨識的命令

如果您在輸入 azsphere 命令時看到下列錯誤，請確定您使用的是 Windows 上的 PowerShell 或標準命令提示字元。

'azsphere' is not recognized as an internal or external command, operable program or batch file.

安裝程式在 60% 時當機

安裝程式在 60% 時當機，您會收到裝置通訊服務無法啟動的訊息。 這通常會在 TAP 驅動程式安裝以奇怪的方式失敗，使系統處於不確定狀態時發生。

確認問題為 TAP 驅動程式

  1. 開啟 Windows 事件檢視器 以檢查記錄檔。

  2. 如需下列錯誤訊息，請查看應用程式記錄檔和 Azure 球體裝置通訊服務記錄檔：

    「SerialSlipToTun.TunInterfaceSetupException：錯誤存取 System.Collections.generic.KeyNotFoundException ---> tun 登錄設定：找不到 Tun 輕觸裝置---> System.Security.SecurityException：不允許要求的登錄存取權。」

    Windows 事件檢視器 的螢幕快照。

  3. 檢查應用程式記錄時，請篩選記錄檔，以避免看到許多不相關的訊息。 在 [ 動作] 索 引標籤上，選取 [篩選目前的記錄]。

  4. 選取 [錯誤]，然後選取 [AzureSphereDeviceCommunicationService ]，只列出來自 Azure 球體裝置通訊服務的錯誤訊息。

    [篩選目前的記錄] 對話框的螢幕快照。

  5. 如果您在應用程式記錄或 Azure 球體裝置通訊服務記錄檔中都找不到錯誤，則這可能不是 TAP 驅動程序問題。

若要解決 TAP 驅動程式問題，請遵循下列步驟：

  1. 移至 [網络與共用中心]，然後選取 [變更適配卡設定]。

    網路共用中心的螢幕快照。

  2. 在 [網络] Connections [Azure 球體] 底下，選取 [TAP-WIndows 配接器 V9] 並開啟其屬性。

    網路 Connections 的螢幕快照。

  3. 在 Azure 球體內容中，選 取 [因特網通訊協定版本 4 (TCP/IPv4) ，然後選取 [ 內容 ] 以檢視通訊協議設定。

    Azure 球體內容的螢幕快照。

  4. 確定IP位址設為192.168.35.1，子網遮罩設為255.255.255.255.0。

  5. 再試一次安裝程式。 如果仍然當機，請嘗試重設您的網路連線。 若要重設，請移至 [ 設定>網络 & 因特網>狀態 ]，然後選取靠近頁面底部的 [ 網络重設 ]。

    重要

    重設您的網路將會重設所有網路設定。

停止 Azure 球體裝置通訊服務

如果安裝程序當機，您可以使用 task 要 命令來停止 Azure 球體裝置通訊服務。

請依照下列步驟執行：

  1. 複製 AzureSphere 的 PIDDeviceCommunicationService。

    • 移至 [ 任務管理器>服務] 索 引標籤，並記下 AzureSphereDeviceCommunicationService 服務的 PID，或
    • 在命令列中，輸入 tasklist /fi "SERVICES eq AzureSphereDeviceCommunicationService*" 並複製輸出中的 PID。

  2. 在命令行中輸入下列內容以結束服務。 任務 列 命令會結束對應至程式標識碼的程式。 此 /f 選項會用來強制結束程式。

    taskkill /PID <DCS_PID> /f

  3. 再試一次安裝程式。

無法停止 Azure 球體裝置通訊服務

升級現有的 Azure 球體 SDK 時，您可能會看到「服務 』Azure 球體裝置通訊服務'' (AzureSphereDeviceCommunicationService) 無法停止的訊息。 確認您有足夠的許可權可以停止系統服務」。如果您收到此訊息，請重新啟動並再次執行安裝程式。

使用分割通道時裝置通訊中斷

當開發計算機連線到公司 VPN，且 VPN 設定停用分割閘道時，開發電腦可能無法與 Azure 球體裝置通訊。

若要解決此問題，請執行下列其中一項操作：

  • 中斷與公司 VPN 的連線，然後再次嘗試連線到 Azure 球體裝置。
  • 變更 VPN 設定以允許分割網道。

通訊問題也可能是 TAP-Windows 配接器設定所造成。 請參閱 TAP-Windows 配接器設定 疑難解答一節。

無法在 Windows 11 上安裝或卸載 Azure 球體 SDK

升級至 Windows 11 之後，用戶無法安裝或卸載 Azure 球體 SDK。 若要解決此問題，請安裝 Windows 版 Azure 球體 SDK 的最新版本。 安裝 21.07 更新 2 或更新版本之後，您將能夠卸載 SDK。

無法編譯或偵錯 RTApps

如果 CMake 報告錯誤尋找工具鏈，或 openocd 當您嘗試建立或偵錯 RTApp 時，請確定：

疑難解答 23.05 裝置通訊前的問題

警告

這些步驟適用於 SDK 版本 22.11 或更舊版本的使用者。 執行 azsphere show-version，確認已安裝的 SDK 版本為 22.11 或更舊版本。

在執行 SDK 版本 22.11 或更舊版本的 Linux 系統上，每次插入裝置或拔除或重新插頭時，都必須執行 azsphere_connect.sh 腳本。 腳本會重新整理裝置連線，並包含將網路流量對應到裝置的內核驅動程式。

如果您遇到通訊問題，請從下列基本步驟開始：

  1. 確定裝置已透過 USB 連接。

  2. 如果您尚未執行 azsphere_connect.sh 腳本，請執行該腳本。

  3. 確認您可以直接與裝置通訊。 在網頁瀏覽器中流覽。https://192.168.35.2/status 忽略並關閉任何顯示的 SSL 警告。 您應該會在網頁瀏覽器視窗中看到類似： {"uptime":56} 的輸出。

注意

您也可以從命令行使用 curl https://192.168.35.2/status --insecure執行此步驟。

  1. 如果錯誤持續發生，請將裝置從USB埠拔除、再次插回，然後等待裝置重新啟動。 然後執行 azsphere_connect.sh 腳本。

  2. 如果錯誤持續發生，請確定沒有與其他網路工具的子網衝突。