Matter 疑難排解

建築物

確認手機是否相容

所有 Android O (8.1、API 級別 27) 以上版本裝置都與 Matter 相容。請按照下列步驟檢查手機是否具備必要的模組。

設定 Android Debug Bridge

請先設定 Android Debug Bridge (adb),再進行疑難排解。會議前置作業:

  1. 在電腦上安裝「ADB」
  2. Android 手機上開啟開發人員選項和 USB 偵錯功能

驗證 Google Play 服務 (GPS) Matter 模組

如要確認是否有 Google Play services Matter 模組,請按照下列步驟操作:

  1. 設定 Android Debug Bridge
  2. 使用 USB 傳輸線將 Android 手機連接到電腦。
  3. 在終端機中執行這個指令,以確認已安裝必要的 Matter 模組:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
      
    
    如果看到類似下方的輸出內容,表示已安裝 Matter 模組:
    com.google.android.gms.home [v222110900]
    請注意,上述的版本號碼可能與裝置不同。
  4. 在終端機中執行這個指令,確認是否已安裝必要的 Thread 模組:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
      
    
    如果以下範例顯示類似以下範例的輸出內容,則表示您已安裝 Thread 模組:
    com.google.android.gms.threadnetwork [v222106301]
    請注意,裝置上的版本號碼可能不同。

如果系統未列出模組,表示:

  1. 你的 Android 版本過舊。請確定其為 Android O (8.1) 以上版本。
  2. 尚未下載 Matter 模組。請至少等待 24 小時,讓系統下載這些檔案。請確保裝置已開機且處於充電狀態,以免下載作業延遲。如果 24 小時內仍未收到模組,您可以嘗試將裝置恢復原廠設定,強制下載模組。

驗證裝置的 VID/PID

如要開始開發 Google 整合項目,您必須在 Google Home 控制台建立專案和整合功能。

排解藍牙 Sniffer 的問題

裝置信標的 VID/PID 值應與輸入 Google Home Developer Console 專案內的 VID/PID 相符。

  • VID 0xFFF10xFFF4 保留用於測試。這類 API 可用於基本佣金和控管測試,但在下列開發階段無法使用:

使用藍牙工程應用程式 (例如 nRF Connect for Mobile) 時,您可以在「Service Data」欄位中看到信標裝置的 VID/PID。

在「nRF Connect」Android 版本的螢幕截圖中,您會看到 VID/PID 從「Service Data」欄位的第四個位元組開始列出。5A23FFFE這代表 5A23 的 VID 和 FFFE PID 為小端子格式

BLE 應用程式以小端數字顯示值,但您在 Developer Console 專案中輸入的 VID/PID 值位於大端。

驗證是否已根據藍牙 Sniffer 顯示的內容,在 Actions Console 專案中輸入正確的值和格式。

針對範例螢幕截圖中的值,Developer Console 中的 VID 和 PID 分別為 235AFEFF

確認裝置是透過相容的 Matter SDK 分支版本建構

Google Matter Hub 與 Matter 1.0 相容,並已測試使用使用穩定分支版本 v1.0-branch 的修訂版本的建構。請查看公開版本資訊,瞭解建議與每個新的中樞版本搭配使用的特定修訂版本。

配對中

驗證裝置的憑證

使用自己的 Alliance 指派的 VID 時,請確認您裝置上的憑證正確無誤

  • 認證聲明 (CD)。
  • 裝置認證憑證 (DAC) 及其憑證鏈結。

詳情請參閱「建立 Matter 裝置測試憑證」。

確認與 Matter 相容的中樞裝置

Matter 中樞必須是 Google 支援的中樞。也需要在與 Matter 相容的「版本」上。

有些中樞裝置也是 Thread 邊界路由器,因此可讓您開發及測試 Thread 裝置。其他中樞裝置只支援 Wi-Fi 和乙太網路 Matter 裝置,除非您網路中新增其他邊界路由器來啟用 Thread 連線。

如要驗證中樞版本,可以使用以下方式驗證:將手指從頂端邊緣往下滑動 > 設定輪轉 > 裝置資訊 > 技術資訊 > Chromecast 韌體版本

調試失敗,顯示「無法聯絡 Google」錯誤訊息

確認您已在 Developer Console 中,使用正確的 VID/PID 組合建立整合。詳情請參閱「建立 Matter 整合」一文。

調試失敗,顯示「無法連線至裝置」錯誤訊息

如果執行 Thread 裝置時持續收到「無法連線到裝置」錯誤訊息,並且已用盡所有可用的偵錯選項,建議您在 Android 手機上清除已儲存的偏好 Thread 憑證,方法是依序點選「設定」>「應用程式」>「應用程式」>「Google Play 服務」>「儲存空間與快取」>「管理所有資料」

測試

測試套件不會顯示調試裝置

如果您已將測試供應商 ID (VID) 和產品 ID (PID) 與裝置配對,但您嘗試在 Developer Console使用測試套件測試裝置時未顯示這個圖示,可能是因為在多個整合中使用相同的測試 VID 和 PID 組合。

如要進行疑難排解,請從 Developer Console 中移除所有測試裝置,然後配對要再次測試的裝置。

如要驗證配對的結果是否正確,您可以將裝置的製造商和型號資訊 (CHIP_DEVICE_CONFIG_DEVICE_* 值) 設為測試韌體中不重複的值。

詳情請參閱「裝置資訊」。

如果問題仍未解決

如果完成上述所有疑難排解步驟後,您的問題仍未解決,沒關係!

在疑難排解步驟中,您已收集與裝置、主控台專案和環境相關的重要資料。取得這些資料後,請查看支援頁面,瞭解如何最有效地與社群和 Google Home 支援團隊分享問題。