Matter の統合をテストする

Google Home Developer Console の [テスト] ページで、Google Home Test Suite を使用して Matter 統合のテストを構成、実行できます。Test SuiteDeveloper Console に組み込まれている個別のアプリであり、すべての統合テストを処理します。

統合のベンダー ID とプロダクト ID のデバイスは、テストを受けるためにコミッショニングされ、Developer Console で使用されているアカウントの Google Home app (GHA) で使用可能である必要があります。詳しくは、Matter 対応デバイスのペア設定をご覧ください。

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] では次のようになります。

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

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

テスト計画を作成する

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

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

  1. 企業プロフィールを作成していること
  2. 統合の本番環境のベンダー ID(VID)を入力する
  3. 設定とブランディングの設定

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

また、統合バージョンが認定される前にブランディングを更新したい場合は、新しいバージョンを作成してやり直す必要があります。

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

Play Console に移動

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

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

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

  4. [開発テスト] または [認証テスト] のテストタイプを選択します。新しいテスト計画の作成

    • Google エコシステムで認定の準備を行う場合は、[認定試験] を選択します。
    • 開発テストは認証に使用できません。
  5. [Test] をクリックします。「No device found」というエラー画面が表示された場合は、この統合に使用するデバイスはまだエコシステムでコミッショニングされていません。詳しくは、ペア設定のトラブルシューティングをご覧ください。

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

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

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

テスト計画を作成する

Test Suite を終了する場合は、[ Developer Center に戻る] をクリックします。

テストプランを実行する

Test Suite の [Create a test plan] ページで、[Run Test] をクリックします。[テスト環境] ページが表示されます。このページには、すべてのテストのステータスとログが表示されます。

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

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

テスト結果

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

完了したら、次の操作を行います。

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

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

テスト履歴

提出した認証計画について、[認証用に保存] セクションの [結果] をクリックして、テスト結果レポートを表示します。

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

コンソールのステータス

テストフェーズでは、次のコンソール ステータスが発生します。

セクション ステータス Description 要件 次のステップ
テスト可能 準備完了 このバージョンの integration をテストする準備ができました。 なし このバージョンの integrationをテストします。
テストされた 準備完了 このバージョンの integration はテスト済みで、フィールド トライアルまたは認定のために提出できます。

バージョンのテストと保存を行いました。

失敗したテストケースには、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 0xFFF10xFFF4 はテスト用に予約されています。基本的なコミッショニング テストや制御テストで使用できますが、開発の次のフェーズでは使用できません。

nRF Connect for Mobile などの Bluetooth エンジニアリング アプリを使用すると、[Service Data] フィールドでビーコン デバイスの VID や PID を確認できます。

この Android バージョンの nRF Connect のスクリーンショットでは、VID/PID が [Service Data] フィールドの 4 バイト目から 5A23FFFE と表示されます。これは、VID が 5A23 で、PID が FFFE であることを示します(どちらもリトル エンディアン形式)。

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

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

上のスクリーンショットの例では、Developer Console の VID は 235A、PID は FEFF となります。