จับคู่อุปกรณ์กรณี

จับคู่อุปกรณ์ที่เปิดใช้ Matter ในการดําเนินการ คุณจะต้องมี โค้ด QR สําหรับการจับคู่ คุณอาจต้องสร้างคิวอาร์โค้ดนี้ด้วยตนเอง ทั้งนี้ขึ้นอยู่กับแพลตฟอร์มของอุปกรณ์ Matter

รับคิวอาร์โค้ด

ห้องใต้ดิน Bouffalo

BL602

ระบบจะพิมพ์สตริงคิวอาร์โค้ดในคอนโซลอนุกรมเมื่ออุปกรณ์เริ่มทํางาน ดูคอนโซลซีเรียลของคุณและคุณควรเห็นข้อความดังนี้:

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
...

เปิดลิงก์ในเว็บเบราว์เซอร์เพื่อแสดงคิวอาร์โค้ด

BL702

ระบบจะพิมพ์สตริงคิวอาร์ในคอนโซลคอนโซลเมื่ออุปกรณ์เริ่มทํางาน ดูคอนโซลซีเรียลของคุณและคุณควรเห็นข้อความดังนี้:

[         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

เปิดลิงก์ในเว็บเบราว์เซอร์เพื่อแสดงคิวอาร์โค้ด

NXP

K32 วัตต์

ระบบจะพิมพ์สตริงคิวอาร์โค้ดในคอนโซลอนุกรมเมื่ออุปกรณ์เริ่มทํางาน ดูคอนโซลซีเรียลของคุณและคุณควรเห็นข้อความดังนี้:

[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
...

เปิดลิงก์ในเว็บเบราว์เซอร์เพื่อแสดงคิวอาร์โค้ด

Realtek

อเมบา ดี

คิวอาร์โค้ดจะเข้ารหัสใน 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

เปิดลิงก์ในเว็บเบราว์เซอร์เพื่อแสดงคิวอาร์โค้ด

ห้องทดลองซิลิคอน

EFR32MG12

เมื่อกระดานเริ่มทํางาน คุณจะเห็นคิวอาร์โค้ดบนจอ LCD ขนาดเล็ก

TLSR9518

ระบบจะพิมพ์สตริงคิวอาร์ในคอนโซลคอนโซลเมื่ออุปกรณ์เริ่มทํางาน ตรวจสอบคอนโซลอนุกรมและคุณจะเห็น 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. SDK บนอุปกรณ์เคลื่อนที่ของ Google สําหรับ Home และ Thread สําหรับ Android (ซึ่งใช้ในแอปของบุคคลที่สามได้)

ทั้ง 2 วิธีจะใช้ Matter และ Thread Network API เดียวกัน

แอป Google Home

  1. เปิด GHA
  2. แตะ ที่มุมบนซ้าย
  3. แตะตั้งค่าอุปกรณ์
  4. แตะอุปกรณ์ใหม่
  5. เลือกบ้านแล้วแตะถัดไป
  6. GHA จะสแกนหาอุปกรณ์ของคุณ เมื่อระบบถามว่าคุณต้องการตั้งค่าอุปกรณ์หรือไม่ ให้แตะตั้งค่าอุปกรณ์อื่น
  7. แตะอุปกรณ์ Matter เครื่องสําหรับอุปกรณ์ทุกประเภท
  8. เล็งกล้องไปที่คิวอาร์โค้ดของอุปกรณ์ (หรือคิวอาร์โค้ดที่เว็บไซต์สร้าง)
  9. ดําเนินการต่อในการจับคู่ตามที่ระบุไว้ในขั้นตอน GHA

หากคุณพบปัญหาในระหว่างการจับคู่อุปกรณ์ GHA กับอุปกรณ์เคลื่อนที่ ให้ทําดังนี้

  1. ตรวจสอบว่าคุณเปิดใช้ตัวเลือกสําหรับนักพัฒนาซอฟต์แวร์สําหรับอุปกรณ์เคลื่อนที่แล้ว
  2. ทันทีที่เริ่มการจับคู่อุปกรณ์ไม่สําเร็จ ให้จับภาพรายงานข้อบกพร่อง

Android SDK

ใช้ Android SDK เพื่อจับคู่อุปกรณ์ Matter และจัดการเครือข่ายเทรดในแอป

มี SDK จํานวน Android รายการใน Play services สําหรับการทดสอบและการจับคู่ในแอปของบุคคลที่สาม

เราขอแนะนําให้เริ่มจาก Google Home Sample App for Matter ซึ่งแสดงวิธีค่าคอมมิชชัน จับคู่ และควบคุมอุปกรณ์ที่ใช้ Matter ในระบบนิเวศ Google Home ด้วย SDK เหล่านี้

เอกสารอ้างอิงสําหรับ SDK ทั้งสองมีอยู่ในไซต์นี้:

ข้อจํากัดการจับคู่

อุปกรณ์ Matter จะจับคู่ได้เฉพาะในระบบนิเวศของ Google Home ในรหัสผู้ให้บริการและสถานการณ์ของอุปกรณ์บางประเภทเท่านั้น

  • ใช้ VID ทดสอบในอุปกรณ์ของผู้บริโภคไม่ได้
  • VID ที่ใช้งานจริงของคุณต้องออกโดย Connectivity Standards Alliance (Alliance) Google จะตรวจสอบว่าคุณเป็นเจ้าของ VID ดังกล่าวก่อนที่คุณจะใช้ใน Google Home Developer Console ในกรณีเช่นนี้ คุณจะสร้าง การผสานรวมสําหรับ VID ดังกล่าวได้
  • เพื่อการพัฒนาและการทดสอบภาคสนาม ต้องรวมโปรเจ็กต์และการผสานรวมที่มีชุดค่าผสม VID และ PID ที่สอดคล้องกันไว้ในที่สร้างขึ้นในDeveloper Console ผู้ใช้ที่มอบหมายให้อุปกรณ์ต้องเป็นสมาชิกของโครงการ หรืออยู่ในรายชื่อผู้ใช้ทดลองใช้งานภาคสนาม
  • ผู้ใช้ทั่วไปจะใช้ผลิตภัณฑ์ได้ก็ต่อเมื่อได้รับการรับรองจาก Alliance เท่านั้น
ตาราง: สถานการณ์การจับคู่รหัสผู้ให้บริการ (VID) และประเภทอุปกรณ์
ผู้ใช้ประเภทใดกําหนดอุปกรณ์ในระบบนิเวศของ Google Home ได้
ประเภท VID การรับรอง VID และสถานะการผสานรวมคอนโซล เวอร์ชันที่ใช้งานจริง
(ผู้ใช้ทั่วไป)
การพัฒนา
(นักพัฒนาซอฟต์แวร์ ผู้ใช้ช่วงทดลองใช้ภาคสนาม)
ทดสอบ ไม่มีการผสานรวมใน Developer Console (รับรองไม่ได้)
ทดสอบ มีการผสานรวมอยู่ใน Developer Console (รับรองไม่ได้)
Production ไม่ได้รับการรับรอง ไม่มีการผสานรวมใน Developer Console
Production ไม่ได้รับการรับรอง มีอยู่ในDeveloper Console
Production ผ่านการรับรองใน Alliance DCL เนื่องจากไม่มีการผสานรวมใน Developer Console
Production ผ่านการรับรองใน DCL Alliance และการผสานรวมอยู่ใน Developer Console

ข้อมูลอุปกรณ์

ดูข้อมูลทางเทคนิคของอุปกรณ์ที่จับคู่ได้ใน GHA

  1. ใน GHA ให้เลือกอุปกรณ์
  2. แตะไอคอน ที่มุมขวาบน
  3. แตะข้อมูลทางเทคนิค

ตัวระบุ เช่น ผู้ผลิต รุ่น และเวอร์ชันฮาร์ดแวร์มาจากเฟิร์มแวร์ Matter ในอุปกรณ์ ไม่ใช่จาก Developer Console ตัวอย่างเช่น ค่า CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAME และ CHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME ในการกําหนดค่าอุปกรณ์ใน Matter SDK

ตัวระบุเหล่านี้อาจมีประโยชน์ในการตรวจสอบว่าอุปกรณ์ใดที่ได้รับการจับคู่เพื่อทดสอบโดยเฉพาะเมื่อใช้รหัสผู้ให้บริการทดสอบและรหัสผลิตภัณฑ์ (ซึ่งอาจซ้ํากันในการผสานรวมต่างๆ ได้)

การแก้ปัญหาการจับคู่

หากคุณจับคู่อุปกรณ์ด้วยรหัสผู้ให้บริการทดสอบ (VID) และรหัสผลิตภัณฑ์ (PID) แต่ไม่ปรากฏเมื่อคุณพยายามทดสอบอุปกรณ์ด้วยชุดทดสอบใน Developer Console ปัญหานี้อาจเกิดขึ้นจากการใช้ชุดรหัส VID และ PID ทดสอบเดียวกันในการผสานรวมหลายรายการ

ในการแก้ปัญหา ให้นําอุปกรณ์ทดสอบทั้งหมดออกจาก Developer Console และจับคู่อุปกรณ์ที่คุณต้องการทดสอบอีกครั้ง

หากต้องการตรวจสอบว่าคุณจับคู่ค่าที่ถูกต้องหรือไม่ ให้ตั้งค่าข้อมูลผู้ผลิตและรุ่น (CHIP_DEVICE_CONFIG_DEVICE_* ค่า) ของอุปกรณ์เป็นค่าที่ไม่ซ้ํากันในเฟิร์มแวร์ทดสอบ

ดูข้อมูลอุปกรณ์สําหรับข้อมูลเพิ่มเติม