測試 Matter 整合

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

為測試整合的供應商 ID 和產品 ID,裝置必須在 Google Home app (GHA) 中取得並可提供用於 Developer Console 的帳戶。詳情請參閱「配對 Matter 裝置」。

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

在「測試」頁面中,「已可測試」會列出已完成且可供測試的 Matter 項整合項目。

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

測試方案類型

測試計畫分為兩種類型:

  • 開發測試計畫的用途是測試採用 Matter 的控制裝置。您可以編輯這些屬性,但無法提交 Matter 認證。

  • 認證測試計畫僅適用於 Matter 認證,無法編輯。如果選取這個選項,系統會建立新的 Matter 整合功能版本。

整合版本

建立認證的測試方案時,系統會建立新的整合版本。「測試」分頁之後,Developer Console 的所有整合清單都會列出這個編號版本。

系統不會透過其他已編號的版本建立新版本。舉例來說,您為整合作業建立的第一個測試計畫將會為該整合作業建立 v.1 版。如果建立另一個測試計畫,系統就會為這項整合建立版本 v.2,但這個版本不會以 v.1 為基礎。而是以整合的未版本化執行個體為基礎,與 v.1 相同。

整合作業的「不適用」版本代表整合的未版本化執行個體,該執行個體是在「Develop」分頁管理。

換句話說,在 Developer Console 中,於 Matter > Test 下:

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

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

建立測試計畫

整合版本是未版本整合的數據匯報。也就是說,當您建立認證的測試計畫並因此建立整合版本時,與該整合相關的所有中繼資料都必須是您要用於已啟動整合作業的資訊

建立認證的測試計畫之前,請確認您已完成下列事項:

  1. 已建立公司資料
  2. 輸入整合用的實際工作環境供應商 ID (VID)
  3. 已設定和品牌宣傳

如果尚未完成整合執行的所有步驟,則無法認證為認證測試建立的整合版本。您必須建立新的版本,也就是重做測試、實地測試和認證步驟。

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

如何建立測試計畫:

前往開發人員控制台

  1. 在專案清單中,找到您要使用的專案,然後按一下旁邊的「Open」

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

  3. 針對要測試的整合點選「測試」版本「不適用」。這項操作會建立新的整合版本

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

    • 如果您打算在 Google 生態系統中進行認證,請選取「認證測試」
    • 開發測試不得用於認證。
  5. 按一下 [測試]。如果系統顯示「No device found」(找不到裝置) 錯誤畫面,則表示用於此整合的裝置尚未針對生態系統獲得佣金。詳情請參閱「排解配對問題」一文。

  6. 在「Configure your test」畫面中,輸入測試名稱,然後從裝置清單中選取要測試的裝置。

  7. 點選「下一步:測試方案」按鈕。

  8. 在「建立測試方案」頁面的「測試套件」區段中,選取要執行的測試套件。

建立測試計畫

如要退出 Test Suite,請按一下「Back to Developer Center」(返回開發人員中心)

執行測試計畫

Test Suite 的「Create a test plan」(建立測試計畫) 頁面中,按一下「Run Test」(執行測試)。系統隨即會顯示「Test 環境」頁面,其中包含所有測試的狀態和記錄。

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

「記錄檔」窗格會顯示每項測試執行作業的狀態。

測試結果

如要在「Test 環境」頁面中重新測試測試計畫,請在測試執行作業完成後點選頂端的「 Retest」

完成後:

查看及解讀測試結果

Test Suite 的「Test history」(測試記錄) 頁面中,您可以針對開發計畫或未提交認證測試計畫,在「Test plan」區段中按一下所需測試方案的「Retest」。系統會將您導向「Test Environment」頁面,其中會顯示測試結果。

測試記錄

對於已提交的認證計畫,按一下「已儲存為認證」部分的「結果」,即可查看測試結果報告。

您也可以透過 Developer Console 的「Test」分頁存取整合版本的測試結果。在該頁面上列出的任何整合版本的「Test history」中,按一下「View」,即可前往 Test Suite 的「Test history」頁面。

控制台狀態

在測試階段中,控制台狀態如下:

章節 狀態 說明 規定 後續步驟
已可進行測試 已就緒 這個版本的「 integration 」已準備就緒,現可進行測試。 不適用 測試這個版本的 integration。
通過測試 已就緒 這個版本的「 integration 」已完成測試,可提交來進行實測或認證。

版本已測試並儲存。

所有失敗的測試案例都包括需要 Google 審查的理由。

視需要重新測試

疑難排解

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

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

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

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

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

驗證裝置的 VID/PID

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

排解藍牙 Sniffer 的問題

裝置信標的 VID/PID 值應與輸入 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