Google Home Developer Console の [テスト] ページで、Google Home Test Suite を使用して Matter 統合に対するテストを構成、実行できます。Test Suite は Developer 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 については次のようになります。
- 統合のバージョン N/A で [Test] をクリックすると、新しいバージョンが作成されます。バージョン番号は、既存の番号付きバージョンよりも 1 大きくなります。
- 番号付きのバージョンが存在しない場合は、バージョン v.1 が作成されます。
- バージョン v.1 が存在する場合は、バージョン v.2 が作成されます。バージョン v.2 が存在する場合、バージョン v.3 が作成されます。
- 統合の番号付きバージョン(v.1 など)で [テスト] をクリックしても、新しいバージョンは作成されません。v.1代わりに、バージョン v.1 を再度テストします。
詳細については、統合のバージョニングをご覧ください。
テストプランの作成
統合バージョンは、バージョン管理されていない統合のスナップショットです。つまり、認証のテストプラン(つまり統合バージョン)を作成する際は、その統合に関連するすべてのメタデータが、リリースされた統合に使用する情報である必要があります。
認定資格のテストプランを作成する前に、次のことが完了していることを確認してください。
統合でこれらの手順をすべて完了していない場合、認証テスト用に作成された統合バージョンを認定することはできません。新しいバージョンを作成する必要があります。つまり、テスト、フィールド トライアル、認定の手順をやり直します。
また、統合バージョンが認定される前にブランディングを更新する場合、新しいバージョンを作成して最初からやり直す必要があります。
テストプランを作成するには:
プロジェクトのリストで、作業するプロジェクトの横にある [開く] をクリックします。
ページの左側にあるナビゲーション メニューで、[Matter] > [Test] に移動します。
テストする統合のバージョン「なし」で [テスト] をクリックします。この操作により、新しい統合バージョンが作成されます。
テストタイプとして [開発テスト] または [認証テスト] を選択します。
- Google エコシステムでの認証の準備をしている場合は、[認定資格テスト] を選択します。
- 開発テストは認証に使用できません。
[Test] をクリックします。「デバイスが見つかりません」エラー画面が表示された場合、この統合に使用するデバイスはまだエコシステムで開始されていません。詳しくは、ペア設定のトラブルシューティングをご覧ください。
[Configure your test] 画面で、テストの名前を指定し、デバイスのリストからテストするデバイスを選択します。
[Next: Test plan] ボタンをクリックします。
[Create a test plan] ページの [Test suite] セクションで、実行するテストスイートを選択します。
Test Suite を終了するには、[ Developer Center に戻る] をクリックします。
テストプランを実行する
Test Suite の [Create a test plan] ページで、[Run Test] をクリックします。[テスト環境] ページに、すべてのテストのステータスとログが表示されます。
テストが完了すると、テスト結果が表示されます。各テストスイート実行のステータス(合格、不合格)が表示されます。
[ログ] ペインに、個々のテスト実行のステータスが表示されます。
[テスト環境] ページからテストプランを再テストするには、テスト実行の完了後に上部の [
再テスト] をクリックします。完了したら、次の操作を行います。
- [完了] をクリックして、[テスト履歴] ページに移動します。
- [送信] をクリックして、認定用のテスト結果を送信します。
テスト結果を表示して解釈する
Test Suite の [テスト履歴] ページで、[テストプラン] セクションで目的のテストプランの [再テスト] をクリックすると、開発プランまたは未提出の認定テストプランの以前のテスト結果を表示できます。[Test Environment] ページが表示され、テストの結果が表示されます。
提出した認定プランについて、[認定用に保存] セクションの [結果] をクリックしてテスト結果レポートを表示します。
統合バージョンのテスト結果には、Developer Console の [テスト] タブからもアクセスできます。このページに表示されている統合バージョンの [テスト履歴] の [表示] をクリックすると、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 でプロジェクトと統合を作成する必要があります。
デバイスがビーコンに設定している VID または PID の値は、Developer Console プロジェクトに入力した VID または PID と一致している必要があります。
- VID
0xFFF1
~0xFFF4
はテスト用に予約されています。基本的なコミッショニングや制御テストで使用できますが、開発の次のフェーズでは使用できません。
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 と PID はそれぞれ 235A
と FEFF
になります。