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 スニファーのトラブルシューティング

デバイスがビーコンに設定している VID または PID の値は、Google Home 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 と PID はそれぞれ 235AFEFF になります。

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

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

ペア設定

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

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

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

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

Matter 対応ハブを確認する

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

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

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

コミッショニングが失敗し、「Could not contact Google」(Google に連絡できませんでした)というエラー メッセージが表示されます。

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

「デバイスにアクセスできません」というエラー メッセージが表示されてコミッショニングが失敗する

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

テスト

コミッショニングされたデバイスがテストスイートに表示されない

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

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

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

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

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

ここで紹介したトラブルシューティング手順をすべて試しても問題が解決しない場合は、

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