Codec Matter Protocol

Hướng dẫn sử dụng Schema C Struct

Chế độ Schema C Struct cho phép bạn định nghĩa cấu trúc dữ liệu bằng cú pháp C/C++ quen thuộc. Trình phân tích trích xuất tên trường, kiểu và tag TLV từ định nghĩa cấu trúc của bạn, sau đó tạo biểu mẫu trực quan để nhập dữ liệu và mã hóa TLV.

Cú pháp được hỗ trợ

// Supported syntax forms:
typedef struct { ... } StructName;
typedef struct Tag { ... } StructName;
struct StructName { ... };

Các kiểu dữ liệu được hỗ trợ

Phương pháp chú thích tag

Sử dụng chú thích để chỉ định tag ngữ cảnh TLV cho mỗi trường. Nếu không chỉ định tag, các tag sẽ được tự động gán bắt đầu từ 0.

uint8_t field1;     // tag 0
uint16_t field2;    // tag: 1
uint32_t field3;    /* tag 2 */
@tag(3) uint64_t field4;

Hỗ trợ mảng

Mảng kích thước cố định (ví dụ: uint32_t data[4]) và mảng kích thước động (ví dụ: uint8_t data[]) được hỗ trợ. Biểu mẫu sẽ cung cấp nút «Thêm mục» để quản lý động các phần tử mảng.

uint32_t subjects[4];  // Fixed-size array (max 4 items)
uint8_t data[];        // Variable-size array

Hạn chế hiện tại

• Chỉ thị tiền xử lý (#define, #ifdef) không được hỗ trợ
• Bí danh typedef (ví dụ: typedef uint8_t BYTE) không được hỗ trợ
• Enum, union và trường bit không được hỗ trợ
• Chỉnh sửa cấu trúc lồng nhau bị giới hạn ở một cấp
• Cấu trúc ẩn danh không được hỗ trợ

Định dạng mã hóa TLV Matter

Matter sử dụng lược đồ mã hóa nhị phân TLV (Tag-Length-Value) nhỏ gọn để tuần tự hóa dữ liệu có cấu trúc. Định dạng này được sử dụng rộng rãi trong ngăn xếp giao thức, bao gồm thông điệp mô hình tương tác, dữ liệu chứng nhận thiết bị và payload kết nối.

Cấu trúc byte điều khiển

Byte điều khiển là byte đầu tiên của mỗi phần tử TLV. 5 bit thấp chỉ định loại phần tử và 3 bit cao cho biết dạng tag.

Các loại phần tử TLV

Trường loại phần tử xác định cách mã hóa phần giá trị. Các kiểu số nguyên sử dụng 1, 2, 4 hoặc 8 byte. Giá trị boolean được mã hóa trực tiếp trong trường loại. Chuỗi và mảng byte mang tiền tố độ dài theo sau là dữ liệu.

Định dạng payload kết nối

Khi kết nối thiết bị Matter, thông tin thiết lập được mã hóa trong payload nhỏ gọn nhúng trong mã QR hoặc biểu diễn dưới dạng mã ghép nối thủ công bằng số. Payload mã QR bắt đầu bằng tiền tố "MT:" theo sau là chuỗi nhị phân mã hóa Base38.

Mã hóa Base38

Payload mã QR Matter sử dụng bộ ký tự Base38 (0-9, A-Z, -.) để biểu diễn chữ số hiệu quả. Mỗi nhóm 3 byte được mã hóa thành 5 ký tự Base38.

Mã ghép nối thủ công

Mã ghép nối thủ công 11 chữ số cung cấp phương thức thay thế khi không thể quét mã QR. Nó mã hóa bộ phân biệt, mã thiết lập và chữ số kiểm tra Verhoeff. Phiên bản 21 chữ số bổ sung thêm ID nhà sản xuất và ID sản phẩm.

Chữ số kiểm tra Verhoeff

Mã ghép nối thủ công sử dụng thuật toán Verhoeff để phát hiện lỗi. Thuật toán này phát hiện tất cả lỗi một chữ số và hầu hết lỗi hoán đổi liền kề.

Ứng dụng trong phát triển

• Gỡ lỗi payload TLV Matter được bắt từ tương tác thiết bị
• Kiểm tra thông điệp yêu cầu và phản hồi của mô hình tương tác
• Xác minh payload kết nối nhúng trong mã QR
• Xác thực cấu trúc TLV của chứng nhận thiết bị
• Xây dựng payload thử nghiệm cho kiểm tra tương thích Matter

Tham chiếu đặc tả

Đặc tả Matter được duy trì bởi Connectivity Standards Alliance (CSA). Định dạng mã hóa TLV được định nghĩa trong Phụ lục A của đặc tả cốt lõi. Mã hóa payload onboarding được đề cập trong Phần 5.1.

• Đặc tả cốt lõi Matter - Tải từ CSA
• Kho mã nguồn mở - github.com/project-chip/connectedhomeip
• Tài liệu SDK - project-chip.github.io/connectedhomeip-doc
• Sổ tay phát triển Matter - handbook.buildwithmatter.com