Matter のトラブルシューティング

建物

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

Android O(8.1、API レベル 27)以降のすべてのデバイスは Matter と互換性があります。スマートフォンに必要なモジュールが搭載されているかどうかを確認する手順は次のとおりです。

Android Debug Bridge をセットアップする

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

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

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

Google Play services Matter モジュールがあるかどうかを確認するには、次の操作を行います。

  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 モジュールがインストールされていることを確認します。
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
      
    
    次の例のような出力が表示された場合、Thread モジュールがインストールされています。
    com.google.android.gms.threadnetwork [v222106301]
    デバイスのバージョン番号は異なる場合があります。

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

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

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

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

Bluetooth Sniffer のトラブルシューティング

デバイスがビーコンで送信している VID/PID 値は、Google Home Developer Console プロジェクトに入力した VID/PID 値と一致している必要があります。

  • VID 0xFFF1 - 0xFFF4 はテスト用に予約されています。基本的なコミッショニング テストや制御テストには使用できますが、開発の次のフェーズでは使用できません。

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

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 はそれぞれ 235AFEFF になります。

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

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

ペア設定

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

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

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

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

Matter 対応ハブを確認する

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

一部のハブは Thread 境界ルーターでもあるため、 Thread デバイスの開発とテストが可能になります。他のハブは Wi-Fi とイーサネットのみをサポートMatterネットワーク内に Thread 接続を有効にする別の境界ルータがない限り、デバイスは Thread に接続できません。

ハブのビルドは、次の方法で確認できます: 上端から指を下にスライド > 設定ホイール > デバイス情報 > 技術情報 > Chromecast ファームウェア バージョン

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

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

「デバイスにアクセスできません」というエラーメッセージが表示され、試運転が失敗する

試運転時に「デバイスにアクセスできません」というエラーメッセージが引き続き表示される場合は、Threadデバイスで利用可能なデバッグオプションをすべて使い果たした場合は、保存されている優先設定をクリアすることをお勧めします。Thread Android スマートフォンの認証情報を使用してクリーンなセットアップを行う設定 > アプリ > アプリ > Google Play 開発者サービス > ストレージとキャッシュ > 容量を管理 > すべてのデータを消去

テスト

委託されたデバイスがテストスイートに表示されない

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

トラブルシューティングするには、すべてのテストデバイスをDeveloper Consoleテストしたいデバイスを再度ペアリングします。

正しいペアリングができたことを確認するには、メーカーとモデルの情報(CHIP_DEVICE_CONFIG_DEVICE_*デバイスのデフォルトの値(文字列、数値など)をテスト ファームウェア内の一意の値に変更します。

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

それでも問題が解決しない場合

こちらのトラブルシューティングの手順をすべて試しても問題が解決しない場合は、ご心配なく。

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