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 控制台中建立專案和整合服務。

排解藍牙封包嗅探器問題

裝置發出信號的 VID/PID 值，應與輸入 Google Home Developer Console 專案的 VID/PID 相符。

  • VID 0xFFF1 - 0xFFF4 保留用於測試。 這些裝置可用於基本委任和控制測試，但無法在下列開發階段使用：

使用 nRF Connect for Mobile 等藍牙工程應用程式，即可在「Service Data」欄位中查看信標裝置的 VID/PID。

從 nRF Connect 的 Android 版本擷取的這張螢幕截圖中，您會看到 VID/PID 列為 5A23FFFE，從「Service Data」欄位的第四個位元組開始。這表示 VID 為 5A23，PID 為 FFFE，兩者皆為小端序格式。

BLE 應用程式會以小端序顯示值，但您在 Developer Console 專案中輸入的 VID/PID 值為大端序。

根據藍牙封包嗅探器顯示的內容，確認您已在 Actions 開發人員控制台專案中輸入正確的值和格式。

以範例螢幕截圖中的值為例，Developer Console 中的 VID 和 PID 分別為 235A 和 FEFF。

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

Google Matter 中樞裝置與 Matter 1.0 相容，且已使用穩定分支 v1.0-branch 的提交內容建構版本進行測試。請參閱公開發布說明，瞭解建議搭配每個新中樞版本使用的特定提交內容。

配對中

驗證裝置憑證

使用自行Alliance指派的 VID 時，請確保裝置上的憑證正確無誤：

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

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

確認 Matter 相容的 Hub

Matter 必須是 Google 支援的中樞裝置。此外，裝置必須搭載支援 Matter 的版本。

部分中樞裝置也是 Thread 邊界路由器，因此可供您開發及測試 Thread 裝置。其他中樞裝置僅支援 Wi-Fi 和乙太網路 Matter 裝置，除非網路中有其他邊界路由器，可啟用 Thread 連線。

如要驗證 Hub 版本，請依序執行下列操作：從頂端邊緣向下滑動手指 > 設定輪 > 裝置資訊 > 技術資訊 > 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 支援團隊。