Làm quen với Matter

Chương trình Nhà phát triển Google Home cho phép các nhà sản xuất thiết bị kết nối thiết bị nhà thông minh của họ với hệ sinh thái Google Home. Chúng tôi đang mở rộng đường dẫn thực hiện cục bộ của Hành động nhà thông minh bằng khả năng thêm các thiết bị hỗ trợ Matter để thiết lập bằng Google Home app (GHA) và điều khiển các thiết bị đó bằng Google Assistant, GHA hoặc màn hình thông minh như Google Nest Hub (2nd gen).

Tài liệu này mô tả cách bắt đầu xây dựng và tích hợp một nền tảng được Matter hỗ trợ trong hệ sinh thái Google Home.

Tuyên bố từ chối trách nhiệm

Về các quy trình được mô tả trong tài liệu Matter, hãy lưu ý những điều sau:

  • Bạn chỉ nên kết nối một trung tâm hỗ trợ Matter với tài khoản dùng để phát triển nhằm mục đích thử nghiệm. Việc kết nối nhiều trung tâm hỗ trợ Matter cùng một lúc hoặc kết nối với cùng một cấu trúc trong quá trình kiểm thử có thể dẫn đến hành vi không lường trước được.
  • Tất cả quy trình đều giả định việc sử dụng máy Linux chạy Ubuntu 20.04 để tạo bản dựng và cài đặt ROM cho các mẫu Matter đã được Google kiểm thử. Mặc dù máy macOS được hỗ trợ, nhưng bạn nên dùng Linux. Hướng dẫn dành riêng cho máy Mac được nêu trong các quy trình khi cần.

Cách xây dựng

Để xây dựng một thiết bị hỗ trợ Matter tích hợp với hệ sinh thái Google Home, bạn sẽ làm việc với một bảng phát triển tương thích với Matter và Matter SDK.

Cách dễ nhất để bắt đầu là tham gia các lớp học lập trình của chúng tôi. Bạn nên thực hiện ít nhất một trong các lớp học lập trình sau:

Sau đó, hãy xem danh sách thiết bị được hỗ trợ để đảm bảo rằng thiết bị bạn dự định tích hợp được hỗ trợ trong hệ sinh thái Google Home. Sau đó, hãy đọc kỹ Danh sách kiểm tra dành cho nhà phát triển để nắm được toàn bộ quy trình phát triển từ khi tạo dự án đến khi ra mắt.

Thiết bị được hỗ trợ Danh sách kiểm tra dành cho nhà phát triển

Định nghĩa

Các thuật ngữ sau đây được sử dụng trong toàn bộ tài liệu này:

Bộ định tuyến biên
Một trung tâm triển khai Bộ định tuyến biên Thread đa năng cho các thiết bị hỗ trợ Thread.
Trung tâm
Một thiết bị Google Nest được hỗ trợ, chẳng hạn như Google Nest Hub (2nd gen). Bạn cần có một thiết bị trung tâm để điều khiển các thiết bị hỗ trợ Matter thông qua các nền tảng khác như Assistant, GHA và màn hình thông minh.
Thiết bị hỗ trợ Matter
Một thiết bị hoặc bảng phát triển đã được cài đặt ROM bằng một bản dựng hoặc ứng dụng mẫu có bật Matter.
Thiết bị di động
Điện thoại thử nghiệm dùng để hỗ trợ quá trình ghép nối. Hiện tại, đây là điện thoại Android.

Điều kiện tiên quyết

Các tiện ích IDE nên dùng để phát triển Matter

Để tích hợp hoàn toàn một thiết bị hỗ trợ Matter với hệ sinh thái Google Home, nhà phát triển phải có:

  1. Một trung tâm Google có hỗ trợ Thread để vừa đóng vai trò là border router cho các thiết bị hỗ trợ Thread, vừa là đường dẫn thực hiện cục bộ để định tuyến ý định cho Nhà thông minh.
  2. Thiết bị di động (điện thoại thử nghiệm) đáp ứng các yêu cầu tối thiểu:
    • Android O (8.1, cấp độ API 27 trở lên)
    • iOS (phiên bản 16.5 trở lên)
    • Khả năng BLE
  3. Mã nhà cung cấp (VID) và Mã sản phẩm (PID) cho thiết bị hỗ trợ Matter.
  4. Thiết bị hỗ trợ Matter. Thiết bị này phải là một trong Matter loại thiết bị được hỗ trợ trong hệ sinh thái Google Home và có thể là:
    • Sản phẩm của chính bạn có chương trình cơ sở hỗ trợ Matter.
    • Một trong những thiết bị Matter sau đây để dùng cho quy trình xác minh hai đầu:
Bảng: Matter ví dụ từ nhà cung cấp silicon
Nhà cung cấp Nền tảng Hỗ trợ Thread Hướng dẫn
Bouffalo Lab BL602
BL702
Espressif ESP32 Kiểm thử OTA
Nordic Semiconductor nRF52840 DK Kiểm thử OTA
NXP Bộ phát triển IOTZTB-DK006
Realtek Ameba D Series
Silicon Labs Bộ phát triển EFR32MG24
Bộ công cụ khởi động EFR32MG Zigbee và Thread
Telink TLSR9528 Hướng dẫn cho nhà phát triển về Telink Matter
Texas Instruments Bộ phát triển CC2652R7 LaunchPad

Mã nhà cung cấp

Theo mặc định, bạn có thể sử dụng một trong các VID do Liên minh phân bổ cho mục đích thử nghiệm. Chọn một trong các tuỳ chọn sau: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Để sử dụng VID chính thức nhằm chứng nhận và ra mắt giải pháp tích hợp, trước tiên, bạn phải yêu cầu Google xác minh VID đó để đảm bảo rằng Liên minh đã cấp VID đó cho bạn.

Bạn nên triển khai VID này trong chương trình cơ sở của thiết bị.

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 về Mã nhà cung cấp và loại thiết bị.

  • Bạn không thể sử dụng VID thử nghiệm trên thiết bị của người tiêu dùng.
  • VID chính thức của bạn phải do Connectivity Standards Alliance (Alliance) cấp. Google sẽ xác thực rằng bạn là chủ sở hữu của VID đó trước khi bạn có thể sử dụng VID trong Google Home Developer Console. Sau khi hoàn tất, bạn có thể tạo các chế độ tích hợp cho VID đó.
  • Để phát triển và Field Trial, bạn phải tạo một dự án và tích hợp với tổ hợp VID và PID tương ứng Developer Console. Người dùng uỷ quyền 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 Field Trial.
  • Người dùng là người tiêu dùng chỉ có thể sử dụng sản phẩm của bạn sau khi sản phẩm đó được Alliance chứng nhận.

Bạn chỉ có thể sử dụng VID và PID một lần cho một lần tích hợp. Nếu muốn sử dụng cùng một VID hoặc PID trong quá trình tích hợp, bạn cần:

  • Chỉnh sửa nội dung lồng ghép bằng cách thay đổi VID hoặc PID thành một VID hoặc PID khác.
  • Xoá chế độ tích hợp bằng VID hoặc PID.
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 loại 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 chứng nhận VID và tích hợp bảng điều khiển Phát hành công khai
(Người dùng cá nhân)
Phát triển
(Nhà phát triển, Field Trial người dùng)
Thử nghiệm Không có giải pháp tích hợp trong Developer Console (không thể được chứng nhận)
Thử nghiệm Tính năng tích hợp đã có trong Developer Console (không thể được chứng nhận)
Sản xuất Chưa được chứng nhận, không có giải pháp tích hợp trong Developer Console
Sản xuất Chưa được chứng nhận, giải pháp tích hợp có trong Developer Console
Sản xuất Được chứng nhận trong DCL Alliance, nhưng không có tích hợp trong Developer Console
Sản xuất Đã được chứng nhận trong DCL Alliance và có tích hợp trong Developer Console

Mã sản phẩm

Thông tin về thiết bị được đọc từ Matter Basic Information Cluster. Mã sản phẩm được mã hoá trong chương trình cơ sở của thiết bị phải khớp với Mã sản phẩm của quá trình tích hợp Matter trong Bảng điều khiển dành cho nhà phát triển.

Tính năng không được hỗ trợ

Một số cụm Matter chưa được hiển thị cho người dùng, mặc dù hệ thống có thể sử dụng các cụm này. Trong hầu hết các trường hợp, điều này có nghĩa là người dùng cuối không nhìn thấy các thuộc tính được hiển thị thông qua các cụm này:

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

¹ Xem phần Công tắc đèn bật/tắt để biết mức độ ảnh hưởng của việc này đối với Công tắc đèn bật/tắt.