Lưu ý! Chương trình dùng thử dành cho nhà phát triển mới sắp ra mắt. Hãy đăng ký tại đây và trở thành một trong những người đầu tiên dùng thử các công cụ mới cũng như đưa ra ý kiến phản hồi.

Ghép nối thiết bị Vấn đề

Ghép nối thiết bị hỗ trợ Matter của bạn. Để thực hiện việc này, bạn cần có mã QR để ghép nối. Tuỳ thuộc vào nền tảng thiết bị Matter, bạn có thể cần phải tự tạo mã QR này.

Nhận mã QR

Phòng thí nghiệm Bouffalo

BL602

Chuỗi mã QR được in trong bảng điều khiển nối tiếp khi thiết bị khởi động. Kiểm tra bảng điều khiển nối tiếp của bạn và bạn sẽ thấy các thông báo như sau:

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

Mở đường liên kết trong một trình duyệt web để hiển thị mã QR.

BL702

Chuỗi mã QR được in trong bảng điều khiển nối tiếp khi thiết bị khởi động. Kiểm tra bảng điều khiển nối tiếp của bạn và bạn sẽ thấy các thông báo như sau:

[         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

Mở đường liên kết trong một trình duyệt web để hiển thị mã QR.

Hàm NXP

32 W

Chuỗi mã QR được in trong bảng điều khiển nối tiếp khi thiết bị khởi động. Kiểm tra bảng điều khiển nối tiếp của bạn và bạn sẽ thấy các thông báo như sau:

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

Mở đường liên kết trong một trình duyệt web để hiển thị mã QR.

Realtek

Dê Ameba D

Mã QR được mã hoá trong một URL. URL này sẽ được in trong bảng điều khiển nối tiếp khi khởi động bảng 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

Mở đường liên kết trong một trình duyệt web để hiển thị mã QR.

Phòng thí nghiệm Silicon

EFR32MG12

Khi bo mạch khởi động, bạn sẽ thấy một mã QR trên màn hình LCD nhỏ.

TLSR9518

Chuỗi mã QR được in trong bảng điều khiển nối tiếp khi thiết bị khởi động. Kiểm tra bảng điều khiển nối tiếp và bạn sẽ thấy một URL sẽ hiển thị mã QR khi mở trong trình duyệt:

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

Ghép nối thiết bị

Có hai cách để ghép nối thiết bị:

  1. Google Home app (GHA)
  2. Google Mobile và SDK mạng Thread của Google dành cho Android (có thể dùng trong ứng dụng của bên thứ ba)

Cả hai phương thức đều sử dụng cùng một API mạng MatterThread.

Ứng dụng Google Home

  1. Mở GHA.
  2. Nhấn vào ở góc trên bên trái.
  3. Nhấn vào Thiết lập thiết bị.
  4. Nhấn vào Thiết bị mới.
  5. Chọn nhà riêng của bạn rồi nhấn vào Tiếp theo.
  6. GHA sẽ quét tìm thiết bị của bạn. Khi lời nhắc nhắc bạn có muốn thiết lập thiết bị hay không, hãy nhấn vào Thiết lập một thiết bị khác.
  7. Nhấn vào Matter thiết bị để chọn loại thiết bị bất kỳ.
  8. Hướng máy ảnh vào mã QR của thiết bị (hoặc mã QR do trang web tạo).
  9. Tiếp tục quá trình ghép nối như được chỉ ra trong luồng GHA.

Nếu bạn gặp vấn đề khi ghép nối với GHA trên thiết bị di động:

  1. Đảm bảo bạn đã bật Tuỳ chọn cho nhà phát triển trên thiết bị di động.
  2. Ngay sau khi ghép nối không thành công, hãy chụp báo cáo lỗi.

SDK Android

Triển khai SDK Android của chúng tôi để ghép nối các thiết bị theo chuẩn Matter và quản lý các luồng Thread trong ứng dụng

Android SDK đã được cung cấp trong Play services để kiểm thử và ghép nối trong một ứng dụng bên thứ ba.

Bạn nên bắt đầu bằng Google Home Sample App for Matter để minh hoạ cách ủy quyền, ghép nối và điều khiển thiết bị hỗ trợ Matter trong hệ sinh thái Google Home bằng các SDK này.

Tài liệu tham khảo cho cả hai SDK có sẵn trên trang web này:

Hạn chế ghép nối

Bạn chỉ có thể ghép nối thiết bị Matter trong hệ sinh thái Google Home trong một số trường hợp nhất định về mã nhà cung cấp và loại thiết bị.

  • Không thể sử dụng VID thử nghiệm trong thiết bị của người dùng thông thường.
  • VID sản xuất của bạn phải do CSA phát hành. Google sẽ xác thực bạn là chủ sở hữu của VID đó trước khi bạn có thể sử dụng trong Google Home Developer Console. Khi điều đó xảy ra, bạn sẽ có thể tạo các tích hợp cho VID đó.
  • Để phát triển và dùng thử tại hiện trường, bạn phải tạo một dự án và tích hợp với tổ hợp PVID và PID tương ứng trong Developer Console. Người dùng vận hành thiết bị phải là thành viên của dự án hoặc có tên trong danh sách người dùng bản thử nghiệm.
  • Người dùng thông thường chỉ có thể sử dụng sản phẩm sau khi đã được tổ chức CSA chứng nhận.
Bảng: Các trường hợp ghép nối mã nhà cung cấp (VID) và loại thiết bị
Những kiểu người dùng nào có thể đưa thiết bị vào hệ sinh thái Google Home?
Loại VID Trạng thái tích hợp bảng điều khiển và chứng chỉ VID Bản chính thức
(Người dùng cá nhân)
Phát triển
(Nhà phát triển, người dùng bản dùng thử nội bộ)
Thử nghiệm Không tích hợp trong Developer Console (không thể được chứng nhận)
Thử nghiệm Tích hợp có trong Developer Console (không thể được chứng nhận)
Sản xuất Không được chứng nhận, tích hợp không tồn tại trong Developer Console
Sản xuất Không được chứng nhận, có tích hợp trong Developer Console
Sản xuất Được chứng nhận trong CSL DCL, tích hợp không tồn tại trong Developer Console
Sản xuất Được chứng nhận trong CSL DCL và tích hợp có trong Developer Console

Thông tin thiết bị

Bạn có thể xem thông tin kỹ thuật cho thiết bị đã ghép nối trong GHA.

  1. Trong GHA, hãy chọn thiết bị.
  2. Nhấn vào biểu tượng ở phía trên bên phải.
  3. Nhấn vào Thông tin kỹ thuật.

Các giá trị nhận dạng như Nhà sản xuất, Kiểu máyPhiên bản phần cứng đến từ chương trình cơ sở Matter trên thiết bị chứ không phải từ Developer Console. Ví dụ: giá trị CHIP_DEVICE_CONFIG_DEVICE_VENDOR_NAMECHIP_DEVICE_CONFIG_DEVICE_PRODUCT_NAME trong cấu hình thiết bị trong SDK Matter.

Các giá trị nhận dạng này có thể hữu ích cho việc xác thực thiết bị nào đã được ghép nối cho mục đích Thử nghiệm, đặc biệt là khi sử dụng mã nhà cung cấp thử nghiệm và mã sản phẩm (có thể được nhân bản trong các công cụ tích hợp).

Khắc phục sự cố ghép nối

Nếu bạn đã ghép nối thiết bị với Mã nhà cung cấp thử nghiệm (VID) và Mã sản phẩm (PID), nhưng mã này không xuất hiện khi bạn cố gắng kiểm tra thiết bị bằng Bộ thử nghiệm trong Developer Console, thì nguyên nhân có thể là do sử dụng cùng một tổ hợp kiểm thử VID và PID trên nhiều công cụ tích hợp.

Để khắc phục sự cố, hãy xoá tất cả thiết bị thử nghiệm khỏi Developer Console và ghép nối thiết bị bạn muốn kiểm thử lại.

Để xác thực rằng bạn đã ghép nối thông tin chính xác, bạn có thể đặt thông tin Nhà sản xuất và Thông tin mô hình (giá trị CHIP_DEVICE_CONFIG_DEVICE_*) cho thiết bị thành giá trị duy nhất trong chương trình cơ sở kiểm thử.

Xem phần Thông tin thiết bị để biết thêm thông tin.