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

Matter 対応デバイスをペア設定します。これを行うには、 ペア設定用の QR コードが表示されます。使用するプラットフォームのプラットフォームによっては、 Matter 台のデバイスです。この QR コードの生成が必要になる場合があります できます。

QR コードを取得する

ブーファロー研究所

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 の Home Mobile SDK と Thread Network SDK for Android(サードパーティ製アプリで使用可能)

どちらのメソッドも同じ Matter を使用し、 Thread Network API。

Google Home アプリ

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

以下のデバイスで GHA とペア設定する際に問題が発生した場合は、 モバイル デバイスの場合:

  1. Developers Studio アプリが オプション 有効にする必要があります
  2. ペア設定に失敗した直後に、バグを記録します。 レポートをご覧ください。
で確認できます。

Android SDK

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

Android 個の SDK が使用可能になりました Play services: サードパーティ製アプリでのテストとペア設定。

最初は Google Home Sample App for Matter: Matter 対応デバイスのコミッショニング、ペア設定、操作 Google Home エコシステムで利用できます

両 SDK のリファレンス ドキュメントについては、次のサイトをご覧ください。

ペア設定の制限

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

  • テスト用の VID は一般消費者向けデバイスでは使用できません。
  • 製品版 VID は Connectivity Standards Alliance (Alliance) によって発行されている必要があります。Google は Google Home Developer Console で使用する前に、VID の所有者であることを確認してください。そうすると 統合されます
  • 開発とフィールド トライアルの目的で、プロジェクトと 対応する VID と PID の組み合わせを Developer Console で作成する必要があります。ユーザーによる試運転 デバイスはプロジェクトのメンバーであるか、リストに含まれている必要があります。 提供します
  • 消費者は、 Alliance
表: ベンダー ID(VID)とデバイスタイプ ペア設定のシナリオ
コミッションを課金できるユーザーのタイプ Google Home エコシステムに取り込むにはどうすればよいでしょうか。
VID の種類 VID 認定とコンソールの統合ステータス 本番環境
(一般ユーザー)
開発環境
(デベロッパー、フィールド トライアル版ユーザー)
テスト Developer Console に統合されていない(認定不可)
テスト 統合が Developer Console に存在します( 認定)
本番環境 認定されていません。Developer Console に統合が存在しません。
本番環境 認定なし、Developer Console に統合が存在します
本番環境 Alliance DCL で認定されているが、統合は認定されていない Developer Console に存在する
本番環境 Alliance DCL で認定され、統合が存在する (Developer Console

デバイス情報

ペア設定したデバイスの技術情報は、 GHA

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

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

これらの識別子は、ペア設定されたデバイスを検証する際に役立ちます。 テストの目的(特にテスト用のベンダー ID を使用する場合) プロダクト ID(統合間で複製可能)。

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

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

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

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

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