測試 Matter 整合

Google Home Developer Console 提供「Test」頁面,您可以使用 Google Home Test Suite 針對 Matter 整合設定及執行測試。Test Suite 是內建於 Developer Console 中的獨立應用程式,可處理所有整合測試。

如要測試整合的供應商 ID 和產品 ID,裝置必須經過委派,並在 Google Home app (GHA) 中提供給與 Developer Console 搭配使用的帳戶。詳情請參閱「配對 Matter 裝置」。

Test Suite 可在屬於特定 Matter 專案設定的一系列裝置上執行。請務必在整合上執行 Test Suite,以確保一切正常運作。

在「Test」頁面中,已完成並可進行測試的 Matter 整合會列在「Ready to test」中。

Matter 已測試的整合項目會列於「已測試」部分。

測試計畫類型

測試計畫分為兩種類型:

  • 開發測試計畫可用於測試使用 Matter 控制裝置的情況。您可以編輯這些檔案,但無法提交進行 Matter 認證。

  • 「認證」測試方案專供 Matter 認證使用,無法編輯。選取這個選項會建立新的 Matter 整合版本。

請使用 Developer Console 中的 Test Suite 提交認證測試結果。如果您想在開發期間執行 Test Suite 以進行測試,請參閱 Google Home 測試套件頁面,瞭解獨立版本。

整合版本

您為認證建立測試計畫時,系統會建立新的整合版本。這個編號版本會列在 Developer Console 的「Test」(測試) 分頁之後的所有整合清單中。

系統不會從其他編號版本建立新版本。舉例來說,您為整合建立的第一個測試計畫會為該整合建立 v.1 版本。建立另一個測試計畫會為該整合建立 v.2 版本,但這個版本不會以 v.1 為基礎。相反地,這個版本是以未命名版本的整合服務為基礎,與 v.1 相同。

整合的 N/A 版本代表整合的未命名版本,可在「Develop」分頁中管理。

換句話說,在 Developer Console 中依序點選 Matter >「測試」

  • 如果您點選整合版本 N/A 的「測試」,系統會建立新版本。版本號碼會比任何現有的編號版本高一個。
    • 如果沒有編號版本,系統會建立 v.1 版本。
    • 如果已存在 v.1 版本,系統會建立 v.2 版本。如果已存在 v.2 版本,系統就會建立 v.3 版本,以此類推。
  • 如果您點選整合項目的編號版本 (例如 v.1) 的「Test」,系統不會建立新版本。而是再次測試 v.1 版本。

詳情請參閱「整合版本管理」。

建立測試計畫

整合版本是未經過版本化的整合作業的快照。也就是說,當您建立認證測試計畫 (以及整合版本) 時,與該整合相關的所有中繼資料,必須是您要用於已啟動的整合的資訊

建立認證測試計畫前,請務必先完成下列事項:

  1. 建立公司資料
  2. 為整合作業輸入正式版供應商 ID (VID)
  3. 設定的設定和品牌

如果您尚未完成整合作業,則為認證測試而建立的整合版本無法獲得認證您必須建立新版本,也就是重新執行「測試」、「實地測試」和「認證」步驟。

如果您想在整合版本通過認證前更新品牌資訊,也必須建立新版本並重新開始。

如何建立測試計畫:

前往開發人員控制台

  1. 在專案清單中,點選所需專案旁的「開啟」

建立新的測試計畫

  1. 在頁面左側的導覽選單中,依序前往「Matter」>「測試」
  2. 針對要測試的整合功能,按一下「測試」,針對 N/A 版本。這個動作會建立新的整合版本
  3. 選取「開發測試」或「認證測試」,然後按一下「測試」
    • 如果您準備取得 Google 生態系統的認證,請選取「認證測驗」
    • 開發測試無法用於認證。
  4. 在「設定測試」畫面中,輸入測試名稱,然後按一下「自動配對裝置」,選取要配對的裝置。

    • Android 裝置:

    設定測試計畫

      1. Make sure you installed GHA to your phone.
      1. Connect your phone with a USB cable to the host machine.
      1. You must
        [Enable USB debugging on your device](https://developer.android.com/studio/debug/dev-options#Enable-debugging)
        The `APK` `com.chip.interop.moblysnippet` will automatically download
        and install.
      1. Once your phone is connected, enter the **Pairing code** and
        **Device name** to auto-pair your device.
    
    • iOS 裝置:您必須手動配對裝置。如需手動配對的操作說明,請參閱「Google Home 應用程式」一節。
    • 如果您已有裝置,系統可能會要求您解除配對裝置並重新配對,或配對新的裝置。
  5. 按一下「下一步:測試計畫」按鈕。

  6. 在「Create a test plan」頁面的「Test suites」部分中,選取要執行的測試套件。

建立測試計畫 如要退出 Test Suite,請按一下「Return to Developer Center」(返回開發人員中心)

執行測試計畫

Test Suite 的「Create a test plan」頁面中,按一下「Run Test」。系統會顯示「測試環境」頁面,其中包含所有測試的狀態和記錄檔。

測試完成後,系統會顯示測試結果。每個測試套件執行作業的狀態會顯示在旁邊 (通過、失敗)。

「Logs」窗格會顯示各項測試執行作業的狀態。

測試結果 如要透過「測試環境」頁面重新測試測試計畫,請在測試執行完畢後,按一下頂端的「 重新測試」

完成後:

查看及解讀測試結果

Test Suite 的「Test history」頁面中,您可以查看開發計畫或未提交的認證測試計畫的先前測試結果,方法是點選「Test plans」部分中所需測試計畫的「Retest」。系統會將您導向「測試環境」頁面,當中會顯示該測試的結果。

測試記錄

如果您已提交認證計畫,請按一下「已儲存供認證」部分中的「結果」,查看測試結果報告。

您也可以透過 Developer Console 中的「Test」分頁,查看整合版本的測試結果。按一下該頁面所列任何整合版本的「測試記錄」,即可前往 Test Suite 中的「測試記錄」頁面。

主控台狀態

在測試階段,您會遇到下列控制台狀態:

Section 狀態 說明 規定 後續步驟
已可測試 已就緒 這個版本的 integration 已可進行測試。 不適用 測試這個版本的 integration。
通過測試 已就緒 這個版本的 integration 已通過測試,可提交進行實地測試或認證。

已測試並儲存版本。

所有失敗的測試案例都會附上 Google 審查的理由。

視需要「重測」

重新測試

認證

如果需要重新測試以取得認證,請在開始重新測試後配對裝置。

開發

如果您需要重新測試開發內容,可以使用現有的裝置,而無須重新配對。

疑難排解

已授權的裝置未顯示在 Test Suite 中

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

如要排解問題,請從 Developer Console 移除所有測試裝置,然後再次配對要測試的裝置。

如要確認已配對正確的裝置,您可以在測試韌體中將裝置的製造商和型號資訊 (CHIP_DEVICE_CONFIG_DEVICE_* 值) 設為專屬值。

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

確認裝置的 VID/PID

如要開始開發與 Google 的整合功能,請務必在 Google Home 控制台中建立專案和整合項目。

排解藍牙嗅探工具的問題

裝置發送的 VID/PID 值應與您在 Developer Console 專案中輸入的 VID/PID 相符。

  • VID 0xFFF1 - 0xFFF4 是測試專用。這些測試可用於基本調試和控制測試,但在下列開發階段時無法使用:

您可以使用 nRF Connect for Mobile 等藍牙工程應用程式,在「Service Data」欄位中查看訊號發送裝置的 VID/PID。

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

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

根據藍牙嗅探器顯示的內容,驗證是否已在 Actions 資訊主頁專案中輸入正確的值和格式。

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