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 を使用するビルドでテストされています。新しいハブリリースごとに使用が推奨される具体的な commit については、公開リリースノートをご覧ください。

ペア設定

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

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

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

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

Matter 対応ハブを確認する

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

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

ハブビルドは、上端から下にスライドする > 設定ホイール > デバイス情報 > 技術情報 > 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 サポートチームと問題を最適な方法で共有する方法を確認してください。