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

建物

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

Android O（8.1、API レベル 27）以降のすべてのデバイス: Matter と互換性があります。以下の手順に沿って 必要なモジュールがインストールされているか

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

トラブルシューティングの前に Android Debug Bridge（adb）をセットアップする必要があります。 設定方法

  1. 「adb」をインストールするを パソコンをご覧ください。
  2. 開発者向けオプションと USB をオンにする デバッグ Android のスマートフォンで。

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. 許可リストに登録されたら、次の手順で機能を有効にする必要があります。 <ph type="x-smartling-placeholder">
      </ph>
    • ハブから: <ph type="x-smartling-placeholder">
        </ph>
      1. 画面を上から下にスワイプします。
      2. 設定アイコン をタップします
      3. Fuchsia バージョンを確認します。Google Nest Hub (2nd gen) で次に移動します。 デバイス情報 >技術情報 >Fuchsia バージョン
      4. [Fuchsia バージョン] をタップします7 回。これにより開発者向けオプションが 有効になります
      5. 最上位のメニューに戻る
      6. [開発者向けオプション] をタップ
      7. [パートナー ロギング] をタップします
    • この機能は 24 時間有効です。その後、ステップ 5 以降でロギング機能を再度有効にします。
  3. ハブの IP アドレスを取得します。 <ph type="x-smartling-placeholder">
      </ph>
    • 画面がある場合は、ハブから: <ph type="x-smartling-placeholder">
        </ph>
      1. 画面を上から下にスワイプします。
      2. 設定アイコン をタップします
      3. デバイスの IP アドレスの確認: Nest Hub (2nd gen) で以下にアクセスします。 デバイス情報 >技術情報 >IP アドレス
    • スマートフォンの Google Home app (GHA) から: <ph type="x-smartling-placeholder">
        </ph>
      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 ログの秘匿化を無効にする

  • プライバシーと安全性を確保するため、この機能はエンジニアリング テストの目的でのみ使用してください。
  • 本番環境のデバイスやユーザーにはこのオプションを使用しないでください。
  • 手順: <ph type="x-smartling-placeholder">
      </ph>
    1. ログが編集されていないユーザーの Google アカウントを Google TAM に送信します。
    2. アカウントが許可リストに追加されたことを確認したら、スマートフォンを再起動します。

デバイスの VID または PID を確認する

Google とのインテグレーションの開発を始める場合は、 Google Home コンソールで統合できます。

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

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

  • VID 0xFFF1～0xFFF4 はテスト用に予約されています。目的 基本的な試運転と制御テストですが、 次の開発フェーズがあります。 <ph type="x-smartling-placeholder">

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

この Android バージョンの nRF Connect のスクリーンショットでは、 VID/PID は、先頭の 4 バイト目から 5A23FFFE としてリストされます。 [Service Data] フィールドに入力します。VID が 5A23、PID が FFFE であることを示します。 どちらもリトル エンディアン形式で指定します。

BLE アプリはリトル エンディアンで値を表示しますが、VID/PID 値は Developer Console プロジェクトに入力すると、ビッグ エンディアンになります。

アクションに正しい値と形式が入力されていることを確認する Bluetooth スニファーの表示内容に基づくコンソール プロジェクト。

サンプルのスクリーンショットの値の場合、 Developer Console は、それぞれ 235A と FEFF になります。

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

Google Matter ハブの互換性 Matter 1.0 が使用されており、 安定版ブランチ v1.0-branch からの commit を行います。[公開リリース メモをご覧ください。 新しいハブリリースごとに適用されます。

ペア設定

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

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

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

詳しくは、Matter デバイステストを作成する 使用します。

Matter 対応ハブを確認する

Matter ハブは、 Google。また、 Matter に対応しているビルドをご利用ください。

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

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

「Google に連絡できませんでした」というエラーでコミッショニングが失敗するエラー メッセージ

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

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

「デバイスにアクセスできません」というメッセージが繰り返し表示される場合エラー メッセージが表示され、 Thread 台のデバイスで、利用可能なデバッグをすべて使い切りました 保存されている優先 Thread を消去することをおすすめします。 認証情報を Android スマートフォンの [設定] >アプリ > アプリ&gt;Google Play 開発者サービス >ストレージとキャッシュ >スペースを管理 > すべてのデータの消去。

テスト

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

テスト用のベンダー ID（VID）とプロダクト ID（PID）を使ってデバイスをペア設定しているが、 [Test] でデバイスをテストしても表示されません。 スイート Developer Console で、次の原因が考えられます 複数の統合にわたって同じテスト VID と PID の組み合わせを使用します。

トラブルシューティングを行うには、Developer Console からすべてのテストデバイスを削除してからペア設定してください クリックします。

正しいデバイスとペア設定されていることを確認するには、メーカーと 操作するデバイスのモデル情報（CHIP_DEVICE_CONFIG_DEVICE_* 値） 固有の値を使用します。

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

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

上記のトラブルシューティングの手順をすべて試しても問題が解決しない場合 解決したので大丈夫です。

トラブルシューティングの手順では、デバイスに関する重要なデータを収集しました。 環境を指定できますそのデータを入手して サポートページ: Google Home サポートチームにお問い合わせいただきますよう、お願いいたします。