建物
スマートフォンの互換性を確認する
Android O(8.1、API レベル 27)以降のデバイスはすべて Matter と互換性があります。以下の手順に沿って、スマートフォンに必要なモジュールが搭載されているかどうかを確認します。
Android Debug Bridge を設定する
トラブルシューティングの前に、Android Debug Bridge(adb
)をセットアップする必要があります。設定方法
- パソコンに「adb」をインストールします。
- Android スマートフォンで開発者向けオプションと USB デバッグをオンにします。
Google Play 開発者サービス(GPS)Matter モジュールを確認する
Google Play services Matter モジュールがインストールされているかどうかを確認する手順は次のとおりです。
- Android Debug Bridge を設定する。
- USB ケーブルを使用して、Android スマートフォンをパソコンに接続します。
- ターミナルで次のコマンドを実行して、必要な Matter モジュールがインストールされていることを確認します。
次のような出力が表示された場合は、Matter モジュールがインストールされています。adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
上記のバージョン番号は、お使いのデバイスと異なる場合があります。com.google.android.gms.home [v222110900]
- ターミナルで次のコマンドを実行して、必要な Thread モジュールがインストールされていることを確認します。
出力が次の例のようになる場合は、Thread モジュールがインストールされています。adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
お使いのデバイスのバージョン番号は異なる場合があります。com.google.android.gms.threadnetwork [v222106301]
モジュールが一覧表示されない場合は、次のいずれかです。
- Android のバージョンが古い。Android O(8.1)以上であることを確認します。
- Matter モジュールはまだダウンロードされていません。ダウンロードが完了するまで 24 時間以上待ちます。ダウンロードが遅れないように、この間、デバイスの電源がオンで充電されていることを確認してください。24 時間以内にモジュールが届かない場合は、デバイスを出荷時の設定にリセットして、モジュールを強制的にダウンロードしてみてください。
デバイスの VID/PID を確認する
Google との統合の開発を開始するには、Google Home コンソールでプロジェクトと統合を作成する必要があります。
デバイスがビーコンで送信する 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 サポートチームと問題を共有する最善の方法を確認してください。