Cluster 手册
Cluster 是 Matter 协议的核心构建单元，每个 Cluster 定义了一组相关的 Attribute（状态字段）和 Command（操作命令）。本手册按 Matter 规范分类收录了 82 个 Cluster，点击卡片查看详情。
按 ID 查 Cluster
手上有一个 Cluster ID（比如日志里的 0x0101 或 257）？输入就能查到它是哪个 Cluster，并跳到对应的手册页。Cluster ID 完整是 4 个字节，标准 Cluster 省略了前面的厂商前缀 0x0000，详见 ID 结构说明。
试试：
数据来源：connectedhomeip v1.6.0.0
照明控制3
灯光的开关、亮度、色温、色彩
暖通空调4
温控、风扇、水泵等环境设备
闭合设备3
门锁、窗帘、阀门等开合控制
传感与测量10
温湿度、气压、光照、空气质量等环境监测
0x0402
温度测量（TemperatureMeasurement）
温度传感器：当前温度、量程范围、精度
0x0405
湿度测量（RelativeHumidityMeasurement）
湿度传感器：当前相对湿度、量程范围、精度
0x0403
气压测量（PressureMeasurement）
气压传感器：kPa 读数、扩展精度模式
0x0400
光照测量（IlluminanceMeasurement）
光照传感器：对数编码的勒克斯值、传感器类型
0x0404
流量测量（FlowMeasurement）
流量传感器：0.1 m³/h 单位、液体/气体流速
0x0406
占位感应（OccupancySensing）
人体存在检测：PIR、超声波、雷达、物理接触传感器
0x005B
空气质量（AirQuality）
空气质量指数：7 级评估（Good → ExtremelyPoor）
0x040D
CO₂ 浓度（CarbonDioxideConcentrationMeasurement）
CO₂ 浓度测量：ppm 读数、峰值/均值、等级指示
0x042A
PM2.5 浓度（Pm25ConcentrationMeasurement）
PM2.5 细颗粒物浓度：μg/m³ 读数、AQI 参考
0x040C
CO 浓度（CarbonMonoxideConcentrationMeasurement）
CO 一氧化碳浓度：安全阈值、与 SmokeCOAlarm 配合
安防与输入4
报警、传感器配置、物理输入设备
家电14
洗衣机、洗碗机、冰箱、微波炉、扫地机等智能家电
0x0050
模式选择（ModeSelect）
通用模式切换：厂商自定义模式列表、启动默认模式
0x0060
运行状态（OperationalState）
通用状态机：启动/暂停/停止/恢复、阶段进度、错误处理
0x0051
洗衣机模式（LaundryWasherMode）
洗衣机工作模式：标准洗/快洗/深层洗，基于 ModeBase 派生
0x0053
洗衣机控制（LaundryWasherControls）
洗衣机参数：转速选择、漂洗次数，配合洗衣机模式使用
0x0059
洗碗机模式（DishwasherMode）
洗碗机工作模式：标准/重油/轻柔，基于 ModeBase 派生
0x005D
洗碗机报警（DishwasherAlarm）
洗碗机告警：门未关、进水异常、排水异常、温度异常
0x0052
冰箱模式（RefrigeratorMode）
冰箱工作模式：速冷/速冻、多温区独立控制
0x005E
微波炉模式（MicrowaveOvenMode）
微波炉工作模式：常规加热、解冻，基于 ModeBase 派生
0x005F
微波炉控制（MicrowaveOvenControl）
微波炉参数：烹饪时间、功率级别、瓦数设置
0x0054
扫地机运行模式（RvcRunMode）
扫地机器人运行模式：清扫/建图/待机，RVC 三件套之一
0x0055
扫地机清洁模式（RvcCleanMode）
扫地机清洁模式：深度清洁/快速清扫/静音模式
0x0061
扫地机运行状态（RvcOperationalState）
扫地机状态机：清扫/回充/充电/停靠、GoHome 命令
0x0071
HEPA 滤芯（HepaFilterMonitoring）
HEPA 滤芯监控：剩余寿命、更换提醒、替换产品
0x0072
活性炭滤芯（ActivatedCarbonFilterMonitoring）
活性炭滤芯监控：气体/异味吸附、寿命跟踪
媒体12
电视、机顶盒、音箱等媒体设备的播放、输入、频道控制
0x0506
媒体播放（MediaPlayback）
媒体播放控制：播放/暂停/快进/快退、进度跟踪、音轨字幕
0x0507
媒体输入（MediaInput）
输入源管理：HDMI/USB/AUX 切换、输入重命名
0x050B
音频输出（AudioOutput）
音频输出管理：HDMI/蓝牙/光纤/耳机切换
0x0504
频道（Channel）
频道管理：频道列表、按号切换、模糊搜索、节目指南
0x0509
键盘输入（KeypadInput）
遥控器按键：CEC 键码映射、导航/数字/媒体键
0x050A
内容启动（ContentLauncher）
内容播放入口：URL 启动、内容搜索、流媒体协议
0x0505
目标导航（TargetNavigator）
内容目标切换：App 列表、菜单页面间跳转
0x050D
应用信息（ApplicationBasic）
应用基本信息：厂商/版本/运行状态、每个 App 一个 Endpoint
0x050C
应用启动器（ApplicationLauncher）
应用生命周期：启动/停止/隐藏 App、当前前台应用
0x050E
账户登录（AccountLogin）
内容账户认证：流媒体服务登录/登出、临时 PIN 机制
0x0503
网络唤醒（WakeOnLan）
设备唤醒：提供 MAC/IPv6 地址用于 WoL 魔术包唤醒
0x0508
低功耗（LowPower）
设备休眠：Sleep 命令让媒体设备进入待机，配合 WoL 唤醒
通用功能6
设备标识、分组、场景、绑定、权限等跨设备通用能力
节点信息与配置11
设备基本信息、电源、标签、本地化、时间等节点级配置
0x0028
基本信息（BasicInformation）
基本信息：厂商名称、产品名、硬件/固件版本、序列号
0x0039
桥接设备信息（BridgedDeviceBasicInformation）
桥接子设备：Zigbee/Z-Wave 设备通过网关暴露到 Matter 的基本信息
0x002F
电源（PowerSource）
电源状态：电池电量、充电状态、供电方式
0x002E
电源配置（PowerSourceConfiguration）
电源映射：哪些 Endpoint 提供电源信息、优先级顺序
0x0040
工厂标签（FixedLabel）
出厂标签：只读键值对，标记设备位置、朝向等工厂信息
0x0041
用户标签（UserLabel）
用户标签：可写键值对，自定义设备分组、归属等元数据
0x002B
语言配置（LocalizationConfiguration）
语言/区域设置：BCP 47 标签、设备界面语言切换
0x002C
时间格式（TimeFormatLocalization）
时间显示偏好：12/24 小时制、日历类型
0x002D
单位配置（UnitLocalization）
单位偏好：温度显示单位（华氏/摄氏/开尔文）
0x0038
时间同步（TimeSynchronization）
时间管理：UTC 设置、时区/夏令时、NTP 配置、可信时间源
0x0046
间歇连接管理（IcdManagement）
低功耗设备：SIT/LIT 模式、Check-In 协议、客户端注册
配网与安全5
设备配网流程、证书管理、组播密钥
0x0031
网络配置（NetworkCommissioning）
网络配置：WiFi/Thread 网络扫描、连接、凭据管理
0x0030
通用配网（GeneralCommissioning）
配网流程控制：FailSafe 机制、区域配置、配网完成确认
0x003C
管理员配网（AdministratorCommissioning）
配网窗口控制：打开/关闭配对模式、增强配网 vs 基础配网
0x003E
操作凭据（OperationalCredentials）
证书管理：NOC/CSR/Fabric、多管理员、证书轮换
0x003F
组密钥管理（GroupKeyManagement）
组播密钥：KeySet 管理、Epoch 密钥轮换、组安全策略
OTA 与诊断7
固件更新、设备诊断、网络状态监控
0x0029
OTA 提供者（OtaSoftwareUpdateProvider）
OTA 服务端：固件查询、下载协商、更新确认
0x002A
OTA 请求者（OtaSoftwareUpdateRequestor）
OTA 客户端：Provider 管理、更新状态跟踪、进度上报
0x0033
通用诊断（GeneralDiagnostics）
设备健康：网络接口、运行时间、启动原因、硬件/网络故障
0x0034
软件诊断（SoftwareDiagnostics）
软件运行时：堆内存、线程栈、高水位标记
0x0035
Thread 诊断（ThreadNetworkDiagnostics）
Thread 网络：拓扑角色、邻居表、路由表、收发计数器
0x0036
WiFi 诊断（WiFiNetworkDiagnostics）
WiFi 连接：RSSI、安全类型、信标丢失、关联失败
0x0037
以太网诊断（EthernetNetworkDiagnostics）
以太网连接：PHY 速率、全双工、收发包计数、冲突
能源管理3
电力测量、能量统计、智能用电调度
如何阅读 Cluster 详情页
每个 Cluster 详情页按照以下结构组织：
- Cluster ID — 标题里的十六进制编号。完整是 32 位，前 16 位是厂商前缀（标准 Cluster 为 0x0000，通常省略），可用上方查询框反查
- 概述 — Cluster 是干什么的、通常出现在哪个 Endpoint
- Attributes — 所有状态字段，按功能分组，标注类型和枚举值
- Commands — 支持的操作命令，标注参数和安全要求
- 数据示例 — 来自真实设备的 JSON 数据，逐字段注释，帮助你对照理解