Matter 対応デバイスをペア設定します。ペア設定用の QR コードが必要です。Matter デバイスのプラットフォームによっては、この QR コードをご自身で生成しなければならない場合があります。
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
- 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 115200to connect to the device and view logs if it is attached to the host at/dev/ttyUSB0. - 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:
ウェブブラウザでリンクを開き、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 つの方法があります。
- Google Home app (GHA)
- Android の Google Home モバイル SDK と Thread ネットワーク SDK（サードパーティ アプリで利用可能）
どちらのメソッドも同じ Matter と Thread のネットワーク API を使用します。
Google Home アプリ
- GHA を開きます。
- 左上の をタップします。
- [デバイスのセットアップ] をタップします。
- [新しいデバイス] をタップします。
- 家を選択し、[次へ] をタップします。
- GHA がデバイスをスキャンします。デバイスをセットアップするかどうかを確認するメッセージが表示されたら、[別のデバイスのセットアップ] をタップします。
- デバイスタイプごとに [Matter デバイス] をタップします。
- デバイスの QR コード（またはウェブサイトによって生成された QR コード）にカメラを向けます。
- GHA のフローに沿って、ペア設定プロセスを続行します。
モバイル デバイスで GHA とペア設定する際に問題が発生した場合:
- モバイル デバイスの開発者向けオプションが有効になっていることを確認します。
- ペア設定に失敗した直後から、バグレポートを取得してください。
Android SDK
Android の SDK が Play services で利用可能になり、サードパーティ アプリでのテストとペア設定が可能になりました。
まず、Google Home Sample App for Matter から始めることをおすすめします。これは、これらの SDK を使用して Google Home エコシステムの Matter 対応デバイスをコミッショニング、ペア設定、制御する方法を示したものです。
両方の SDK のリファレンス ドキュメントがこちらのサイトにあります。
ペア設定の制限
Matter デバイスは、特定のベンダー ID とデバイスタイプのシナリオでのみ、Google Home エコシステムでペア設定できます。
- 一般ユーザー向けのデバイスではテスト VID を使用できません。
- 本番環境の VID は、CSA 発行である必要があります。この ID を Google Home Developer Console で使用する前に、VID の所有者が Google によって検証されます。有効にすると、その VID の統合を作成できるようになります。
- 開発とフィールド トライアルでは、プロジェクトと、対応する VID および PID 統合を Developer Console に作成する必要があります。デバイスをコミッショニングするユーザーは、プロジェクトのメンバーであるか、フィールド トライアル ユーザーのリストに含まれている必要があります。
- 一般ユーザー向けユーザーは、CSA による認定を受けたプロダクトのみを使用できます。
| どのようなユーザーがデバイスを Google Home エコシステムにコミックできますか。 | |||
|---|---|---|---|
| VID タイプ | VID 認証とコンソール統合ステータス | 本番環境
（一般ユーザー） |
開発
（デベロッパー、フィールド トライアル ユーザー） |
| Test | Developer Console には統合されていない（認定不可） | ||
| Test | 統合が Developer Console に含まれています（認証できません） | ||
| 本番環境 | 認定されていません。Developer Console には統合がありません | ||
| 本番環境 | 未認定、Developer Console に統合 | ||
| 本番環境 | CSA DCL で認定されているが、統合が Developer Console に存在しない | ||
| 本番環境 | CSA DCL で認定されており、Developer Console に統合されている | ||
デバイス情報
ペア設定されているデバイスの技術情報は GHA で確認できます。
- GHA で、デバイスを選択します。
- 右上の アイコンをタップします。
- [技術情報] をタップします。
メーカー、モデル、ハードウェア バージョンなどの識別子は、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_* の値）をテスト ファームウェア内の固有の値に設定します。
詳しくは、デバイス情報をご覧ください。