Làm quen với Matter

Chương trình Nhà dành cho nhà phát triển của Google cho phép nhà sản xuất thiết bị kết nối các 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à kiểm soát 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 hỗ trợ Matter trong hệ sinh thái Google Home.

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

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

  • Tài khoản dùng để phát triển chỉ nên có một trung tâm hỗ trợ Matter được kết nối để thử nghiệm. Việc nhiều trung tâm hỗ trợ Matter kết nối 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 thể dự đoán.
  • 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 Mac sẽ được nêu trong các quy trình nếu cần.

Cách tạo

Để tạo 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à SDK Matter.

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 tham gia ít nhất một trong các lớp học lập trình sau:

Sau đó, hãy kiểm tra 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 để hiểu 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 suốt 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 dùng cho nhiều mục đích cho các thiết bị hỗ trợ Thread.
Bổ trợ
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
Thiết bị hoặc bảng phát triển đã được cài đặt ROM bằng bản dựng hoặc ứng dụng mẫu hỗ trợ Matter.
Thiết bị di động
Điện thoại thử nghiệm dùng để hỗ trợ 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 đề xuất để phát triển Matter

Để tích hợp đầy đủ 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. Trung tâm Google có hỗ trợ Thread đóng vai trò vừa là Bộ định tuyến biên cho các thiết bị có 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, API cấp 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 các loại thiết bị Matter được hỗ trợ trong hệ sinh thái Google Home và có thể là:
    • Sản phẩm của riêng bạn có chương trình cơ sở hỗ trợ Matter.
    • Một trong các thiết bị Matter sau đây để sử dụng cho quy trình xác minh toàn diện:
Bảng: Matter ví dụ từ các 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ộ công cụ phát triển EFR32MG24
Bộ khởi động Zigbee và Thread EFR32MG
Telink TLSR9518
Texas Instruments Bộ phát triển LaunchPad CC2652R7

Mã nhà cung cấp

Theo mặc định, bạn có thể sử dụng một trong các VID do CSA phân bổ cho mục đích kiểm thử. Chọn một trong các giá trị sau: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Để sử dụng VID chính thức nhằm chứng nhận và ra mắt tính năng 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 CSA đã cấp VID cho bạn.

Bạn nên triển khai VID này trong phần mềm 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 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ị tiêu dùng.
  • VID phát hành công khai phải do Connectivity Standards Alliance (Alliance) phát hành. 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 đó, bạn có thể tạo các chế độ tích hợp cho VID đó.
  • Đối với mục đích phát triển và thử nghiệm thực địa, 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 trong 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 thử nghiệm thực địa.
  • Người dùng 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 chế độ 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 chế độ tích hợp bằng cách sử dụng 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: Mã nhà cung cấp (VID) và các trường hợp ghép nối loại thiết bị
Những loại người dùng nào có thể uỷ quyền cho thiết bị tham gia 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 nhận VID Bản phát hành chính thức
(Người dùng thông thường)		 Phát triển
(Nhà phát triển, người dùng thử nghiệm thực địa)
Thử nghiệm Không tích hợp trong Developer Console (không thể chứng nhận)
Thử nghiệm Tính năng tích hợp tồn tại trong Developer Console (không thể được chứng nhận)
Sản xuất Chưa được chứng nhận, tính năng tích hợp không tồn tại trong Developer Console
Sản xuất Chưa được chứng nhận, tính năng tích hợp tồn tại trong Developer Console
Sản xuất Được chứng nhận trong DCL Alliance, tính năng tích hợp không tồn tại trong Developer Console
Sản xuất Được chứng nhận trong DCL Alliance và có hoạt động tích hợp trong Developer Console

Mã sản phẩm

Thông tin về thiết bị được đọc từ cụm Thông tin cơ bản Matter. Mã sản phẩm được mã hoá trong phần mềm của thiết bị phải khớp với Mã sản phẩm của chế độ tích hợp Matter trong Developer Console.

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 sẽ không 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 thay đổi này đến Công tắc đèn Bật/Tắt.

Tiếp
Danh sách kiểm tra dành cho nhà phát triển