案件のビルドに関するトラブルシューティング

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

スマートフォンの互換性を確認する

すべて Android O (8.1, API level 27) and later devices are compatible with Matter. Follow the steps below to check if your phone has the necessary modules.

Android Debug Bridge を設定する

トラブルシューティングの前に Android Debug Bridge(adb)を設定する必要があります。設定方法

  1. パソコンに「adb」をインストールします
  2. Android スマートフォンで、開発者向けオプションと USB デバッグをオンにします。

Google Play 開発者サービス(GPS)Matter モジュールを確認する

Google Play services Matter modules, do the following:

  1. Android Debug Bridge をセットアップします
  2. USB ケーブルを使用して Android スマートフォンをパソコンに接続します。
  3. ターミナルで次のコマンドを実行して、必要な Matter モジュールがインストールされていることを確認します。
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
      
    
    次のような出力が表示された場合は、Matter モジュールがインストールされています。
    com.google.android.gms.home [v222110900]
    上記のバージョン番号はデバイスと異なる場合があります。
  4. ターミナルで次のコマンドを実行して、必要な Thread modules are installed:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
      
    
    If you see output similar to the below, you have the Thread modules installed:
    com.google.android.gms.threadnetwork [v222106301]
    Note that the version number above may be different from your device.
    を確認します。

モジュールが一覧にない場合は、次のいずれかが示されています。

  1. Android の古いバージョンがあります。Android O(8.1)以上であることを確認してください。
  2. Matter モジュールはまだダウンロードされていません。ダウンロードが完了するまで 24 時間以上待ちます。ダウンロードが遅延しないように、この期間中はデバイスの電源が入って充電されていることを確認してください。24 時間以内にモジュールが届かない場合は、デバイスを出荷時設定にリセットして、モジュールを強制的にダウンロードしてみてください。

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

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

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

デバイスがビーコンとして使用している VID/PID 値が、Google Home Developer Console project. - VID 0xFFF1-0xFFF4 is reserved for testing. It may be used for basic commissioning and control tests, but they can't be used for - Test Suite. - Field Trials. - OTA. に入力した VID/PID と一致している必要があります。

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

この Android バージョンの nRF Connect のスクリーンショットでは、サービスデータ フィールドの最後の 4 バイトに VID/PID が 5A23FFFE として表示されます。これは、5A23 の VID と FFFE の PID を示します。どちらもリトル エンディアン形式です。

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

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

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

互換性のある Matter SDK ブランチを使用してデバイスがビルドされたことを確認する

Google Matter ハブは現在 Matter 1.0 と互換性があり、安定版ブランチ v1.0-branch の commit を使用するビルドでテストされています。新しいハブ リリースごとに使用を推奨される commit については、公開リリースノートをご覧ください。

デバイスの認証情報を確認する

独自の CSA 割り当ての VID を使用する場合は、デバイスに正しい認証情報があることを確認します。

  • 認証宣言(CD)。
  • デバイス認証証明書(DAC)とその証明書チェーン。

詳細については、Matter デバイスのテスト証明書を作成するをご覧ください。

Matter 対応ハブを確認する

Matter ハブは、Google でサポートされているハブのいずれかである必要があります。また、Matter と互換性のあるビルドも搭載されている必要があります。

一部のハブは Thread ボーダー ルーターであるため、Thread デバイスを開発してテストすることもできます。他のハブは、Thread 接続を有効にするためにネットワークに別のボーダー ルーターがある場合を除き、Wi-Fi とイーサネット Matter デバイスのみをサポートします。

ハブのビルドは、上端から下にスワイプ > [設定ホイール] > [デバイス情報] > [技術情報] > [Chromecast のファームウェア バージョン] で確認できます。

「Google に接続できませんでした」というエラー メッセージが表示されてコミッションが失敗する

Developer Console で、正しい VID/PID 統合との統合を作成していることを確認します。詳細については、Matter 統合を作成するをご覧ください。

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

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

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

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

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

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

それでも問題が解消されない場合

上記のトラブルシューティングの手順をすべて行っても問題が解決しない場合は、

トラブルシューティングの手順では、デバイス、コンソール プロジェクト、環境に関する重要なデータを収集しました。このデータを入手したら、サポートページで、コミュニティや Google Home サポートチームと問題を共有する最適な方法を確認してください。