Matter デバイスをペア設定する

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Matter -enabled device. To do this, you'll need a QR code for pairing. Depending on the platform of your Matter device, you may need to generate this QR code yourself. をペア設定

QR コードを取得する

Bouffalo ラボ

BL602

デバイスの起動時に、QR コード文字列がシリアル コンソールに出力されます。シリアル コンソールを確認すると、次のようなメッセージが表示されます。

Booting BL602 Chip...
██████╗ ██╗      ██████╗  ██████╗ ██████╗
██╔══██╗██║     ██╔════╝ ██╔═████╗╚════██╗
██████╔╝██║     ███████╗ ██║██╔██║ █████╔╝
██╔══██╗██║     ██╔═══██╗████╔╝██║██╔═══╝
██████╔╝███████╗╚██████╔╝╚██████╔╝███████╗
╚═════╝ ╚══════╝ ╚═════╝  ╚═════╝ ╚══════╝
...
[INFO] ==================================================
[INFO] chip-bl602-lighting-example starting
[INFO] ==================================================
...
[INFO] [SVR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[INFO] [SVR] Copy/paste the below URL in a browser to see the QR Code:
[INFO] [SVR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234
...

ウェブブラウザでリンクを開き、QR コードを表示します。

BL702

デバイスの起動時に、QR コード文字列がシリアル コンソールに出力されます。シリアル コンソールを確認すると、次のようなメッセージが表示されます。

[         0][-][PROGR] ==================================================
[         0][-][PROGR] bouffalolab chip-lighting-example, built at Dec 14 2022 02:05:19
[         0][-][PROGR] ==================================================
...
[      1636][-][PROGR] Starting OpenThread task
[      1655][DL][PROGR] Device Configuration:
[      1703][DL][PROGR]   Serial Number: TEST_SN
[      1703][DL][PROGR]   Vendor Id: 65521 (0xFFF1)
[      1703][DL][PROGR]   Product Id: 32773 (0x8005)
[      1752][DL][PROGR]   Hardware Version: 0
[      1799][DL][PROGR]   Setup Pin Code (0 for UNKNOWN/ERROR): 20202021
[      1846][DL][PROGR]   Setup Discriminator (0xFFFF for UNKNOWN/ERROR): 3840 (0xF00)
[      1893][DL][PROGR]   Manufacturing Date: (not set)
[      1893][DL][PROGR]   Device Type: 65535 (0xFFFF)
[      1987][SVR][PROGR] SetupQRCode: [MT:NOTAREALQRCODE01234]
[      1987][SVR][PROGR] Copy/paste the below URL in a browser to see the QR Code:
[      1988][SVR][PROGR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%NOTAREALQRCODE01234

      

Espressif

Getting the QR code differs for each type of ESP32-based kit:

ESP32 DevkitC

  1. Connect the device to a host machine and use a serial terminal to connect to it and display its logs. For example, on a Linux host machine, you might use screen /dev/ttyUSB0 115200 to connect to the device and view logs if it is attached to the host at /dev/ttyUSB0.
  2. A URL is displayed in the logs when the device is first booted. Open the link in a web browser to display the QR code.

M5Stack ESP32

When first booted, the device will display a QR code menu option. Select it to see the QR code in the device's display.

ESP32 WROVER Kit

The device shows the QR code immediately after booting.

Nordic Semiconductor

nRF52840

Since the nRF52840 board doesn't have a display, the QR code string is printed in the serial console when it boots up. For example:

I: 1317 [SVR]SetupQRCode:  [MT:I347HHY00 0C9SS0]
I: 1321 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1327 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI347HHY00%200C9SS0

ウェブブラウザでリンクを開き、QR コードを表示します。

NXP

K32W

デバイスの起動時に、QR コード文字列がシリアル コンソールに出力されます。シリアル コンソールを確認すると、次のようなメッセージが表示されます。

[Info]Welcome to NXP Lighting Demo App
[Info]OpenThread started: OK
...
[Info]Server Listening...
[Info]SetupQRCode:  [MT:I34DVDY00 0C9SS0]
[Info]Copy/paste the below URL in a browser to see the QR Code:
[Info]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI34DVDY00%200C9SS0
...

ウェブブラウザでリンクを開き、QR コードを表示します。

Realtek

アメバ D

QR コードは URL でエンコードされ、AMEBA D ボードの起動時にシリアル コンソールに出力されます。

Setup PIN code: 20202021 (0x1344225)
Short Manual(decimal) setup code: 34970112332
Long Manual(decimal) setup code:  749701123309050652796
QR CODE Text: 'MT:NOTAREALQRCODE01234'
Copy/paste the below URL in a browser to see the QR CODE:

https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234

ウェブブラウザでリンクを開き、QR コードを表示します。

Silicon Labs

EFR32MG12

ボードを起動すると、小さな LCD ディスプレイに QR コードが表示されます。

TLSR9518

デバイスの起動時に、QR コード文字列がシリアル コンソールに出力されます。シリアル コンソールを確認すると、ブラウザで開いたときに QR コードを表示する URL が表示されます。

*** Booting Zephyr OS build v3.1.0-rc1-3593-gdac17979d626  ***
I: Init CHIP stack
I: Starting CHIP task
…
I: 812 [DL]BLEManagerImpl::ConfigureAdvertisingData
I: 823 [DL]Setting device name to : "TelinkMatter"
…
I: 1093 [SVR]SetupQRCode: [MT:NOTAREALQRCODE01234]
I: 1099 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1107 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234

デバイスをペア設定する

デバイスをペア設定するには、次の 2 つの方法があります。

  1. Google Home app (GHA)
  2. Google のホーム モバイルと Thread Network SDKs for Android (which can be used in a 3rd party app)

どちらのメソッドでも、同じ Matter API と Thread ネットワーク API を使用します。

Google Home アプリ

  1. GHA を開きます。
  2. 左上にある をタップします。
  3. [デバイスのセットアップ] をタップします。
  4. [新しいデバイス] をタップします。
  5. 家を選択して [次へ] をタップします。
  6. GHA がデバイスをスキャンします。デバイスをセットアップするかどうかを尋ねるメッセージが表示されたら、[別のデバイスのセットアップ] をタップします。
  7. デバイスタイプに応じて [ Matter デバイス] をタップします。
  8. デバイスの QR コード(またはウェブサイトによって生成された QR コード)にカメラを向けます。
  9. GHA フローの手順に沿ってペア設定プロセスを続行します。

モバイル デバイスで GHA とペア設定する際に問題が発生した場合は、次のようにします。

  1. モバイル デバイスで開発者向けオプションが有効になっていることを確認します。
  2. ペア設定に失敗した直後にバグレポートをキャプチャします。

Android SDK

Android SDK を実装して Matter デバイスをペア設定し、アプリで Thread ネットワークを管理する

Android SDK は Play services で利用できるようになり、サードパーティ製アプリでのテストとペア設定が可能になりました。

Google Home Sample App for Matter から始めて、これらの SDK を使用して Google Home エコシステム内で Matter 対応デバイスをコミッション、ペア設定、制御する方法から始めることをおすすめします。

両方の SDK のリファレンス ドキュメントがこのサイトにあります。

ペア設定の制限

Matter のデバイスは、特定のベンダー ID とデバイスタイプのシナリオでのみ、Google Home エコシステムとペア設定できます。

  • 一般ユーザー向けのデバイスではテスト VID を使用できません。
  • 製品版(一般ユーザー向け)デバイスをペア設定するには、CSA DCL で認定されている必要があります。
  • 開発とフィールド トライアルを行うためには、デバイスを Google Home Developer Console に登録する必要があります。
表: ベンダー ID(VID)とデバイスタイプのペア設定のシナリオ
デバイスを Google Home エコシステムにコミッションできるのは、どのようなユーザーですか。
VID の種類 VID 認証と登録ステータス 本番環境
(一般ユーザー)
開発
(デベロッパー、フィールド トライアルのユーザー)
Test 未登録(認証できません) なし なし
Test Developer Console で登録済み(認証不可) なし
プロダクション 未認定、未登録 なし
プロダクション 未認定、 Developer Console で登録済み
プロダクション CSA DCL の承認、未登録 なし
プロダクション CSA DCL で認定済みで、 Developer Console に登録されている

デバイス情報

ペア設定されたデバイスの技術情報は GHA で確認できます。

  1. GHA で、デバイスを選択します。
  2. 右上にある アイコンをタップします。
  3. [技術情報] をタップします。

メーカー、モデル、ハードウェアのバージョンなどの識別子は、Developer Console ではなく、デバイス上の Matter ファームウェアから取得されます。たとえば、Matter SDK のデバイス構成CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME 値と CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME 値。

この ID は、特にテスト用のベンダー ID とプロダクト ID(統合間で重複する可能性がある)を使用する場合に、テスト目的でペア設定されたデバイスの確認に役立ちます。

ペア設定のトラブルシューティング

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

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

正しいペアリングが完了したことを確認するには、デバイスのメーカーとモデル情報(CHIP_DEVICE_CONFIG_DEVICE_* 値)をテスト ファームウェア内の一意の値に設定します。

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