建築物
確認你的手機是否相容
所有 Android O (8.1,API 級別 27) 以上版本的裝置都與 Matter 相容。請按照下列步驟操作,檢查手機是否已有必要的模組。
設定 Android Debug Bridge
排解問題前,請先設定 Android Debug Bridge (adb
)。會議前置作業:
- 在電腦上安裝「ADB」。
- 在 Android 手機上開啟開發人員選項和 USB 偵錯功能。
驗證 Google Play 服務 (GPS) Matter 模組
如要確認您是否有 Google Play services Matter 模組,請執行下列步驟:
- 設定 Android Debug Bridge。
- 使用 USB 傳輸線將 Android 手機連接到電腦。
- 在終端機中執行這個指令,確認已安裝必要的 Matter 模組:
adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
com.google.android.gms.home [v222110900]
請注意,上述版本號碼可能與您的裝置不同。 - 在終端機中執行這個指令,確認已安裝必要的 Thread 模組:
adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
com.google.android.gms.threadnetwork [v222106301]
請注意,裝置上的版本號碼可能不同。
如果模組不在清單中,表示有以下任一種情況:
- 你的 Android 版本已過時。請確認其為 Android O (8.1) 以上版本。
- 尚未下載 Matter 模組。請等待至少 24 小時,讓下載內容。請確保您的裝置處於開機狀態且正在充電,以免下載時間延遲。如果您在 24 小時內仍未收到模組,可以嘗試將裝置恢復原廠設定,強制下載模組。
Fuchsia 中樞裝置記錄
如何為本機記錄擷取啟用中樞:
- 將含有裝置序號和型號的電子郵件傳送到 Google Technical Account Manager (TAM)。就如裝置底下的小字母所示。
- 列入許可清單後,請按照下列步驟啟用這項功能:
- 透過中心:
- 從畫面頂端向下滑動。
- 輕觸「設定」圖示
- 找出 Fuchsia 版本:在 Google Nest Hub (2nd gen) 上,依序前往「裝置資訊」>「技術資訊」>「 Fuchsia 版本」。
- 輕觸「Fuchsia 版本」7 次。這會啟用開發人員選項
- 返回頂層選單
- 輕觸「開發人員選項」
- 輕觸「合作夥伴記錄」
- 這項功能將啟用 24 小時。之後,請從步驟 5 開始重新啟用記錄功能。
- 透過中心:
- 取得中樞的 IP 位址:
- 如果中樞內有螢幕,請嘗試下列操作:
- 從畫面頂端向下滑動。
- 輕觸「設定」圖示
- 找出裝置 IP 位址:在 Nest Hub (2nd gen) 上,依序前往「Device information」(裝置資訊) >「Technical information」(技術資訊) >「IP 位址」(IP 位址)。
- 透過手機使用「Google Home app (GHA)」:
- 輕觸裝置,開啟裝置詳細資料頁面
- 輕觸「設定」圖示 開啟設定頁面
- 找出裝置 IP 位址:依序前往「裝置資訊」>「技術資訊」>「IP 位址」
- 如果中樞內有螢幕,請嘗試下列操作:
- 如要從中樞裝置擷取記錄,您需要透過使用相同 Wi-Fi 網路的電腦,向中樞發出 GET HTTP 要求。
- 請記下端點的通訊埠和路徑:
curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
- 連線僅可保持開啟一分鐘,但從緩衝區擷取的資料通常需要 20 至 30 分鐘的過往事件。
- 在理想情況下,完成測試程序後,系統會立即使用此方法擷取記錄,確保緩衝區包含與測試相關的內容 (與 Android 錯誤報告類似)。
- 請記下端點的通訊埠和路徑:
停用 Android 記錄遮蓋功能
- 為了保障隱私權和安全性,這項功能只能用於工程測試目的。
- 請勿在正式版裝置或使用者中使用這個選項。
- 步驟:
- 針對有未遮蓋記錄的使用者,將他們的 Google 帳戶傳送給你的 Google TAM。
- 確認帳戶已加入許可清單後,請重新啟動手機。
驗證裝置的 VID/PID
如果您想開始開發與 Google 的整合服務,必須在 Google Home 控制台中建立專案和整合功能。
裝置信標的 VID/PID 值應與您在 Google Home Developer Console 專案中輸入的 VID/PID 相符。
使用 nRF Connect for Mobile 等藍牙工程應用程式,您可以在「Service Data」欄位中查看信標裝置的 VID/PID。
在 nRF Connect Android 版本的螢幕截圖中,從「Service Data」欄位的第四個位元組開始,VID/PID 會顯示為 5A23FFFE
。這表示 VID 為 5A23
以及 FFFE
的 PID,兩者皆採用小結尾格式。
BLE 應用程式顯示的值以小端序顯示,但您在 Developer Console 專案中輸入的 VID/PID 值是很大的端子。
根據藍牙 Sniffer,驗證是否已在 Actions Console 專案中輸入正確的值和格式。
就範例螢幕截圖中的值而言,Developer Console 中的 VID 和 PID 分別為 235A
和 FEFF
。
確認裝置是否使用相容的 Matter SDK 分支版本建構
Google Matter Hub 與 Matter 1.0 相容,而且已針對使用穩定版 v1.0-branch
的修訂版本進行測試。請參閱公開版本資訊,瞭解每個新的中樞版本建議使用的特定修訂版本。
配對中
驗證裝置憑證
使用自己 Alliance 指派的 VID 時,請確保您裝置上具有正確的憑證:
- 認證聲明 (CD)。
- 裝置認證憑證 (DAC) 及其憑證鏈結。
詳情請參閱「建立 Matter 裝置測試憑證」。
確認與 Matter 相容的中樞裝置
您的 Matter 中樞必須是 Google 支援的中樞。也必須位於與 Matter 相容的版本上。
部分中樞裝置也是 Thread 邊界路由器,因此可讓您開發及測試 Thread 裝置。除非您的網路有其他邊界路由器,才能啟用 Thread 連線,否則其他中樞裝置僅支援 Wi-Fi 和乙太網路 Matter 裝置。
您可以使用以下方式驗證您的中樞版本:從上邊緣往下滑動 > 設定輪廓 > 裝置資訊 > 技術資訊 > Chromecast 韌體版本
執行失敗,並顯示「無法聯絡 Google」錯誤訊息
請確認您已在 Developer Console 中使用正確的 VID/PID 組合建立整合。詳情請參閱「建立 Matter 整合」。
執行失敗,並顯示「無法連線至裝置」錯誤訊息
調試 Thread 裝置時,如果一直收到「無法連線到裝置」錯誤訊息,並且已用盡所有可用的偵錯選項,建議您依序前往「設定」>「應用程式」>「應用程式應用程式」>「Google Play 服務」>「儲存空間與快取」>「管理空間」>「清除所有資料」,清除 Android 手機上儲存的偏好 Thread 憑證,以便清除設定。
測試
測試套件未顯示已調試的裝置
如果您已使用測試供應商 ID (VID) 和產品 ID (PID) 配對裝置,但您嘗試在 Developer Console 中使用測試套件測試裝置時並未顯示,可能是因為在多個整合中使用相同的測試 VID 和 PID 組合所致。
如要排解問題,請從 Developer Console 中移除所有測試裝置,然後重新配對要測試的裝置。
如要驗證是否已配對正確的版本,您可以將裝置的製造商和模型資訊 (CHIP_DEVICE_CONFIG_DEVICE_*
值) 設為測試韌體中的唯一值。
詳情請參閱「裝置資訊」。
如果問題仍未解決
如果完成上述所有疑難排解步驟後,問題仍未解決,別擔心!
在疑難排解步驟中,您已收集到裝置、控制台專案和環境的相關重要資料。備妥該資料後,請參閱支援頁面,瞭解如何與社群和 Google Home 支援團隊分享最佳問題。