Cluster 手册
Cluster 是 Matter 协议的核心构建单元,每个 Cluster 定义了一组相关的 Attribute(状态字段)和 Command(操作命令)。 本手册收录了 Matter 设备中常用的 Cluster 定义,方便开发和调试时快速查阅。
如何使用
点击已收录的 Cluster 卡片查看完整定义,包括所有 Attribute 的类型/枚举值、Command 的参数和安全要求、以及实际设备数据示例。
已收录 Cluster
0x0101
门锁(DoorLock)
门锁控制:上锁、解锁、用户管理、凭据管理(PIN/指纹/NFC)
0x002F
电源(PowerSource)
电源状态:电池电量、充电状态、供电方式
0x0006即将推出
开关(OnOff)
开关控制:开、关、切换,最基础的控制 Cluster
0x0008即将推出
亮度控制(LevelControl)
亮度/级别控制:调光、渐变、过渡时间设置
0x0300即将推出
颜色控制(ColorControl)
颜色控制:色温调节、HSV 色彩、XY 色坐标
0x0003即将推出
设备标识(Identify)
设备标识:触发闪灯或响铃,帮助用户定位设备
0x001D即将推出
端点描述(Descriptor)
端点描述:列出端点包含的 Cluster、Device Type 等信息
0x0028即将推出
基本信息(BasicInformation)
基本信息:厂商名称、产品名、硬件/固件版本、序列号
0x0031即将推出
网络配置(NetworkCommissioning)
网络配置:WiFi/Thread 网络扫描、连接、凭据管理
如何阅读 Cluster 详情页
每个 Cluster 详情页按照以下结构组织:
- 概述 —— Cluster 是干什么的、通常出现在哪个 Endpoint
- Attributes —— 所有状态字段,按功能分组,标注类型和枚举值
- Commands —— 支持的操作命令,标注参数和安全要求
- 数据示例 —— 来自真实设备的 JSON 数据,逐字段注释,帮助你对照理解