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

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

ทั้ง 2 วิธีจะใช้ API ของเครือข่าย Matter และ Thread เดียวกัน

แอป Google Home

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

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

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

SDK ของ Android

ติดตั้ง 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 ดังกล่าวก่อนที่คุณจะใช้ 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 ผ่านการรับรองใน DCL ของ Alliance ไม่มีการผสานรวมอยู่ใน 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_*) สำหรับอุปกรณ์เป็นค่าที่ไม่ซ้ำกันในเฟิร์มแวร์ทดสอบ

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