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 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 はそれぞれ 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 のファームウェア バージョンで検証できます。

コミッショニングが失敗し、「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 サポートチームに伝える最適な方法を確認してください。