Matter の統合をテストする

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Google Home Developer Console provides a Test page where you can configure and run tests against your Matter integration using the Google Home Test Suite . The Test Suite is a separate application built into the Developer Console that handles all integration testing.

統合のベンダー ID とプロダクト ID 用のデバイスは、委託して Google Home app (GHA) for the account being used with the Developer Console in order to be tested. See Pair a Matter device for more information. で利用可能である必要があります。

Test Suite は、特定の Matter プロジェクト構成に属する一連のデバイスで実行できます。統合で Test Suite を実行して、すべてが正しく機能することを確認することは非常に重要です。

[テスト] ページの [テストの準備完了] に、テストを完了できる Matter 統合が表示されます。

テスト済みの Matter 統合は、[テスト済み] セクションに表示されます。

テストプランの種類

テストプランには次の 2 種類があります。

  • 開発テストプランは、Matter を使用した制御デバイスのテストに使用されます。Matter 認定資格は編集可能ですが、承認の目的で提出することはできません。

  • 認定資格テストプランは、Matter 認定資格専用であり、編集することはできません。 このオプションを選択すると、Matter 統合の新しいバージョンが作成されます。

統合のバージョン

認証のテストプランを作成すると、統合の新しいバージョンが作成されます。この番号付きバージョンは、[テスト] タブ以降の Developer Console のすべての統合リストに表示されます。

新しいバージョンが他の番号付きバージョンから作成されることはありません。たとえば、統合用に最初に作成したテストプランでは、その統合に対してバージョン v.1 が作成されます。別のテストプランを作成すると、統合用のバージョン v.2 が作成されますが、このバージョンは v.1 に基づくものではありません。代わりに、このバージョンは v.1 と同様に、バージョニングされたインスタンスの統合に基づきます。

統合の該当なしのバージョンは、開発タブで管理される統合のバージョニングされていないインスタンスを表します。

つまり、Developer Console Matter から Test を実行します。

  • 統合のバージョン N/A の [テスト] をクリックすると、新しいバージョンが作成されます。バージョン番号は、既存の番号付きバージョンよりも 1 大きくなります。
    • 番号付きのバージョンが存在しない場合は、バージョン v.1 が作成されます。
    • バージョン v.1 が存在する場合は、バージョン v.2 が作成されます。バージョン v.2 が存在する場合は、バージョン v.3 が作成されます。
  • 統合の番号付きバージョンの [テスト](v.1 など)をクリックしても、新しいバージョンは作成されません。代わりに、バージョン v.1 が再度テストされます。

詳細については、統合のバージョニングをご覧ください。

テストプランを作成する

統合バージョンは、バージョニングされていない統合のスナップショットです。つまり、認証用のテストプラン、つまり統合バージョンを作成するときは、統合に関連するすべてのメタデータを、開始した統合に使用する情報にする必要があります

認定用のテストプランを作成する前に、次のことを確認してください。

  1. 会社のプロフィールを作成する
  2. 統合のベンダー ID(VID)を入力します
  3. 設定とブランディングを構成する

インテグレーションのためにこれらをすべて完了していない場合、認定テスト用に作成された統合バージョンは認定できません新しいバージョンを作成する必要があります。つまり、テスト、フィールド トライアル、認定の手順をやり直す必要があります。

また、統合バージョンの認定を受ける前にブランディングを更新する場合は、新しいバージョンを作成し、最初からやり直す必要があります。

テストプランを作成するには:

Google Play Console に移動

  1. プロジェクトのリストで、対象のプロジェクトの横にある [開く] をクリックします。

  2. ページの左側にあるナビゲーション メニューで、[ Matter] > [テスト] に移動します。

  3. テストする統合のバージョン N/A の [テスト] をクリックします。このアクションにより、新しい統合バージョンが作成されます

  4. テストの種類として [開発テスト] または [認定試験] を選択します。 新しいテストプランの作成

    • Google エコシステムで認定取得に向けた準備を進める場合は、[認定試験] を選択します。
    • 開発テストは認定に使用できません。
  5. [Test] をクリックします。「デバイスが見つかりません」というエラー画面が表示された場合、この統合用のデバイスはエコシステムにまだ委託されていません。詳細については、ペア設定のトラブルシューティングをご覧ください。

  6. [Configure your test] 画面でテストの名前を入力し、デバイスのリストからテストするデバイスを選択します。

  7. [次へ: テストプラン] ボタンをクリックします。

  8. [テストプランの作成] ページの [テストスイート] セクションで、実行するテストスイートを選択します。

テストプランを作成する

Test Suite を終了する場合は、 [デベロッパー センターに戻る] をクリックします。

テストプランを実行する

Test Suite の [テストプランの作成] ページで、[テストを実行] をクリックします。[テスト環境] ページが開き、すべてのテストのステータスとログが表示されます。

テスト結果は、テストが完了すると表示されます。各テストスイートの実行ステータス(合格、不合格)が表示されます。

[ログ] ペインには、個々のテスト実行のステータスが表示されます。

テスト結果

[テスト環境] ページからテストプランを再テストするには、テスト実行の完了後にある [ 再テスト] をクリックします。

完了後:

テスト結果を表示して解釈する

Test Suite の [テスト履歴] ページの [テストプラン] セクションで、目的のテストプランの [再テスト] をクリックすることで、開発プランまたは未送信の認定資格テストプランの以前のテスト結果を表示できます。[テスト環境] ページが開き、そのテストの結果が表示されます。

テスト履歴

提出した認証プランの [保存済みの証明書] セクションで [結果] をクリックし、テスト結果レポートを表示します。

Developer Console の [テスト] タブから統合バージョンのテスト結果にアクセスすることもできます。そのページに表示されている統合バージョンの [テスト履歴] の [表示] をクリックして、Test Suite の [テスト履歴] ページに移動します。

コンソールのステータス

テストフェーズでは、次のコンソール ステータスが表示されます。

Section ステータス 説明 要件 必要なご対応
テスト可能 準備完了 このバージョンの統合をテストする準備ができました。 なし このバージョンの統合をテストします。
認定資格取得の準備ができました 準備完了 このバージョンの統合はテスト済みであり、フィールド トライアルまたは認定資格用に提出できます。

バージョンはテストされ、保存されています。

失敗したすべてのテストケースには、Google が審査する正当な理由が含まれます。

必要に応じて再テストします。

トラブルシューティング

依頼したデバイスがテストスイートに表示されない

デバイスをテストベンダー ID(VID)とプロダクト ID(PID)でペア設定しても、Developer Consoleテストスイートを使用してデバイスをテストしようとしても表示されない場合は、複数の統合で同じテスト VID と PID の組み合わせを使用している可能性があります。

トラブルシューティングを行うには、Developer Console からすべてのテストデバイスを削除して、もう一度テストするデバイスをペア設定します。

正しいペアリングが完了したことを確認するには、デバイスのメーカーとモデル情報(CHIP_DEVICE_CONFIG_DEVICE_* 値)をテスト ファームウェア内の一意の値に設定します。

詳しくは、デバイス情報をご覧ください。

デバイスの VID/PID を確認する

Google との統合の開発を開始するには、Google Home Console でプロジェクトとインテグレーションを作成する必要があります。

Bluetooth スニッファのトラブルシューティング

デバイスがビーコンを作成している VID/PID 値は、Developer Console プロジェクトに入力された VID/PID と一致する必要があります。- VID 0xFFF1-0xFFF4 はテスト用に予約されています。基本的なコミッション テストと制御テストには使用できますが、テストスイートには使用できません。- フィールド トライアル。 - OTA

nRF Connect for Mobile などの Bluetooth エンジニアリング アプリを使用すると、[Service Data] フィールドにビーコン デバイスの VID/PID が表示されます。

Android version of nRF Connect, you'll see the VID/PID is listed as 5A23FFFE in the last four bytes of the Service Data field. This indicates a VID of 5A23 and a PID of FFFE — both in little endian format. からのスクリーンショット

BLE アプリはリトル エンディアンで値を表示しますが、Developer Console プロジェクトに入力する VID/PID 値はビッグ エンディアンです。

Bluetooth スニッファに表示されている内容に基づいて、Actions Console プロジェクトに正しい値と形式が入力されていることを確認します。

サンプル スクリーンショットの値で、Developer Console の VID と PID はそれぞれ 235AFEFF になります。