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 時間以内にモジュールが届かない場合は、デバイスを出荷時の設定にリセットして、モジュールを強制的にダウンロードしてみてください。

Fuchsia ハブデバイスのログ

ローカルログの取得用ハブを有効にするには:

  1. デバイスのシリアル番号とモデル番号を記載したメールを Google Technical Account Manager (TAM) に送信します。デバイスの下部に小文字で記載されています。
  2. 許可リストに登録されたら、次の手順で機能を有効にする必要があります。
    • ハブから:
      1. 画面を上から下にスワイプします。
      2. 設定アイコン をタップします。
      3. Fuchsia のバージョンを確認する: Google Nest Hub (2nd gen) で、[デバイス情報 > 技術情報 > Fuchsia バージョン] に移動します。
      4. [Fuchsia バージョン] を 7 回タップします。これにより、開発者向けオプションが有効になります。
      5. 最上位メニューに戻る
      6. [開発者向けオプション] をタップします。
      7. [パートナー ロギング] をタップします。
    • この機能は 24 時間有効になります。その後、手順 5 以降でロギング機能を再度有効にします。
  3. ハブの IP アドレスを取得します。
    • ハブから（画面がある場合）:
      1. 画面を上から下にスワイプします。
      2. 設定アイコン をタップします。
      3. デバイスの IP アドレスを確認する: Nest Hub (2nd gen) で、[デバイス情報 > 技術情報 > IP アドレス] に移動します。
    • スマートフォンの Google Home app (GHA) から:
      1. デバイスをタップして、デバイスの詳細ページを開きます。
      2. 設定アイコン をタップして設定ページを表示します。
      3. デバイスの IP アドレスを確認します。[デバイス情報 > 技術情報 > IP アドレス] に移動します。
  4. ハブからログを取得するには、同じ Wi-Fi ネットワーク上のパソコンからハブに GET HTTP リクエストを送信します。
    • エンドポイントのポートとパスをメモします。 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • 接続をオープンに保つことができるのは 1 分間のみですが、通常、バッファから取得されるデータには過去 20 ～ 30 分間のイベントが含まれています。
      • 理想的には、テスト手順の完了直後にこの方法でログを抽出し、バッファにテストに関連するコンテンツが確実に含まれるようにします（Android バグレポートと同様に）。

Android ログの除去を無効にする

  • プライバシーとセキュリティのため、この機能はエンジニアリング テストの目的でのみ使用してください。
  • 本番環境のデバイスやユーザーにはこのオプションを使用しないでください。
  • 手順:
    1. ログの除去を解除するユーザーの Google アカウントを Google TAM に送信します。
    2. アカウントが許可リストに追加されたことを確認したら、スマートフォンを再起動します。

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

Google との統合の開発を開始するには、Google Home コンソールでプロジェクトと統合を作成する必要があります。

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

デバイスがビーコンで送信する 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 はそれぞれ 235A と FEFF になります。

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

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

ペア設定

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

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

  • 認定宣言（CD）。
  • デバイス構成証明書（DAC）とその証明書チェーン。

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

Matter 対応のハブを確認する

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

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

ハブのビルドを確認するには、画面上端から下にスワイプ > 設定アイコン > デバイス情報 > 技術情報 > Chromecast のファームウェア バージョンに移動します。

セットアップが失敗し、「Google に接続できませんでした」というエラー メッセージが表示される

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

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

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

テスト

設定済みデバイスがテストスイートに表示されない

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

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

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

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

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

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

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