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

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

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

Bouffalo Lab

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

K32W

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

[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

Ameba D

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

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

Silicon Labs

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 และ SDK เครือข่าย Thread ของ Google สำหรับ 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 อุปกรณ์และจัดการเครือข่ายเทรดในแอป

Android SDK พร้อมใช้งานแล้วใน 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 (ไม่สามารถ ได้รับการรับรอง)
การผลิต ไม่ได้รับการรับรองเนื่องจากไม่มีการผสานรวมใน Developer Console
การผลิต ไม่ได้รับการรับรอง มีการผสานรวมใน Developer Console
การผลิต ได้รับการรับรองใน DCL ของ Alliance แต่การผสานรวมจะไม่ มีอยู่ใน Developer Console
การผลิต ได้รับการรับรองใน 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) สำหรับการทดสอบ อุปกรณ์จะไม่ปรากฏขึ้นมาเมื่อคุณพยายามทดสอบอุปกรณ์โดยใช้ Test Suite ใน Developer Console ซึ่งอาจเกิดจากสาเหตุ โดยใช้ชุดทดสอบ VID และ PID เดียวกันในการผสานรวมหลายรายการ

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

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

โปรดดูข้อมูลเพิ่มเติมในข้อมูลอุปกรณ์