測試 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. 在專案清單中,點選所需專案旁的「開啟」

  2. 在頁面左側的導覽選單中,依序前往「Matter」>「測試」

  3. 針對要測試的整合功能,按一下「測試」,針對 N/A 版本。這個動作會建立新的整合版本

  4. 選取「開發測試」或「認證測試」建立新的測試計畫

    • 如果您準備取得 Google 生態系統的認證,請選取「認證測驗」
    • 開發測試無法用於認證。
  5. 按一下 [測試]。如果畫面顯示「找不到裝置」錯誤訊息,表示這項整合功能的裝置尚未納入生態系統。詳情請參閱配對疑難排解

  6. 在「設定測試」畫面中,輸入測試名稱,並從裝置清單中選取要測試的裝置。

  7. 按一下「下一步:測試計畫」按鈕。

  8. 在「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,兩者皆為小端格式

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

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

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