Matter ID 查询

日志、抓包、设备上报数据里全是 0x0101、257、0x0016 这样的数字。把它粘进下面的输入框，就能知道它是哪个 Cluster、哪种设备类型，还是某个全局属性。十六进制、十进制、名称都能查。

查询

试试：

数据来源：connectedhomeip v1.6.0.0

Cluster ID 是固定两个字节吗？

不是。在 Matter 规范里，Cluster ID 是 32 位（4 个字节）的数字，前 16 位是厂商前缀，后 16 位才是编号：

0x0000_0101
  │    └─ 编号 0x0101（门锁）
  └────── 厂商前缀 0x0000（0 = Matter 标准）

所有 Matter 标准 Cluster 的前缀都是 0x0000，所以大家习惯把前面的 0 省掉，只写 0x0101。看起来像“两个字节”，其实是省略写法。厂商自己扩展的 Cluster 就不能省了，它的前缀是厂商 ID，例如 0x1234_FC00 表示厂商 0x1234 的第一个私有 Cluster。

不只是 Cluster，属性、命令、事件、设备类型的 ID 都是同样的“前缀 + 编号”结构，只是各自的编号范围不同：

字段	长度	标准范围（前缀 0x0000）	厂商自定义范围	例子
Cluster ID	32 位	`0x0000` ~ `0x7FFF`	`0xVVVV_FC00` ~ `0xVVVV_FFFE`	`0x0101` 门锁
Attribute ID	32 位	`0x0000` ~ `0x4FFF`；全局属性 `0xF000` ~ `0xFFFE`	`0xVVVV_0000` ~ `0xVVVV_4FFF`	`0x0000` LockState
Command ID	32 位	`0x00` ~ `0xFF`	`0xVVVV_0000` ~ `0xVVVV_00FF`	`0x00` LockDoor
Event ID	32 位	`0x00` ~ `0xFF`	`0xVVVV_0000` ~ `0xVVVV_00FF`	`0x00` DoorLockAlarm
Device Type ID	32 位	`0x0000` ~ `0xBFFF`	`0xVVVV_0000` ~ `0xVVVV_BFFF`	`0x000A` 门锁
Endpoint ID	16 位	`0` ~ `0xFFFE`（0 固定是根节点）	—	`1` 功能端点
Vendor ID	16 位	由 CSA 分配；`0xFFF1` ~ `0xFFF4` 为测试专用	—	`0xFFF1` 测试厂商

同一个数字，在不同字段里是不同的东西

0x0101 放在 cluster_id 里是门锁 Cluster，放在 device_type 里却是可调光灯。每类 ID 各有一套编号，互不相干。看到一个数字时，先确认它出现在哪个字段里，再去查它的含义。

十进制还是十六进制？

协议本身传的是整数，显示成什么格式取决于工具：chip-tool 日志常写 0x0000_0101，Home Assistant 的诊断数据写成十进制 1/257/0（端点/Cluster/属性）。 257 和 0x0101 是同一个数。上面的查询框两种写法都认，纯数字默认按十进制理解。

设备类型 ID 速查

设备类型写在每个端点的 Descriptor.DeviceTypeList 里。下表列出当前版本全部 95 个标准设备类型。“类别”说明它的角色：

Node — 整台设备只有一个，放在根端点 0（如根节点）
Utility — 辅助类型，叠加在其他类型上（如电源、被桥接节点）
Simple — 具体的设备功能（如门锁、灯、传感器）

ID	中文名	官方名称	类别
`0x000A`	门锁	Door Lock	Simple
`0x000B`	门锁控制器	Door Lock Controller	Simple
`0x000E`	聚合器（桥接器）	Aggregator	Simple
`0x000F`	通用开关（按键）	Generic Switch	Simple
`0x0011`	电源	Power Source	Utility
`0x0012`	OTA 升级请求方	OTA Requestor	Utility
`0x0013`	被桥接节点	Bridged Node	Utility
`0x0014`	OTA 升级提供方	OTA Provider	Utility
`0x0015`	门窗磁传感器	Contact Sensor	Simple
`0x0016`	根节点	Root Node	Node
`0x0017`	太阳能发电	Solar Power	Simple
`0x0018`	储能电池	Battery Storage	Simple
`0x0019`	副网络接口	Secondary Network Interface	Utility
`0x0022`	音箱	Speaker	Simple
`0x0023`	投屏播放器	Casting Video Player	Simple
`0x0024`	内容应用	Content App	Simple
`0x0027`	模式选择	Mode Select	Simple
`0x0028`	基础视频播放器	Basic Video Player	Simple
`0x0029`	投屏客户端	Casting Video Client	Simple
`0x002A`	视频遥控器	Video Remote Control	Simple
`0x002B`	风扇	Fan	Simple
`0x002C`	空气质量传感器	Air Quality Sensor	Simple
`0x002D`	空气净化器	Air Purifier	Simple
`0x0041`	防冻检测器	Water Freeze Detector	Simple
`0x0042`	水阀	Water Valve	Simple
`0x0043`	漏水检测器	Water Leak Detector	Simple
`0x0044`	雨量传感器	Rain Sensor	Simple
`0x0045`	土壤传感器	Soil Sensor	Simple
`0x0070`	冰箱	Refrigerator	Simple
`0x0071`	温控柜	Temperature Controlled Cabinet	Simple
`0x0072`	房间空调	Room Air Conditioner	Simple
`0x0073`	洗衣机	Laundry Washer	Simple
`0x0074`	扫地机器人	Robotic Vacuum Cleaner	Simple
`0x0075`	洗碗机	Dishwasher	Simple
`0x0076`	烟雾/一氧化碳报警器	Smoke CO Alarm	Simple
`0x0077`	灶头	Cook Surface	Simple
`0x0078`	灶具	Cooktop	Simple
`0x0079`	微波炉	Microwave Oven	Simple
`0x007A`	抽油烟机	Extractor Hood	Simple
`0x007B`	烤箱	Oven	Simple
`0x007C`	干衣机	Laundry Dryer	Simple
`0x007D`	加湿/除湿器	Humidifier/Dehumidifier	Simple
`0x0090`	网络基础设施管理器	Network Infrastructure Manager	Simple
`0x0091`	Thread 边界路由器	Thread Border Router	Simple
`0x0100`	开关灯	On/Off Light	Simple
`0x0101`	可调光灯	Dimmable Light	Simple
`0x0103`	灯光开关	On/Off Light Switch	Simple
`0x0104`	调光开关	Dimmer Switch	Simple
`0x0105`	调色调光开关	Color Dimmer Switch	Simple
`0x0106`	光照传感器	Light Sensor	Simple
`0x0107`	人体存在传感器	Occupancy Sensor	Simple
`0x010A`	智能插座	On/Off Plug-in Unit	Simple
`0x010B`	可调光插座	Dimmable Plug-in Unit	Simple
`0x010C`	色温灯	Color Temperature Light	Simple
`0x010D`	彩色灯	Extended Color Light	Simple
`0x010F`	嵌入式开关控制	Mounted On/Off Control	Simple
`0x0110`	嵌入式调光控制	Mounted Dimmable Load Control	Simple
`0x0130`	联合 Fabric 管理员	Joint Fabric Administrator	Utility
`0x0140`	对讲机	Intercom	Simple
`0x0141`	音频门铃	Audio Doorbell	Simple
`0x0142`	摄像头	Camera	Simple
`0x0143`	可视门铃	Video Doorbell	Simple
`0x0144`	泛光灯摄像头	Floodlight Camera	Simple
`0x0145`	快照摄像头	Snapshot Camera	Simple
`0x0146`	门铃铃声器	Chime	Simple
`0x0147`	摄像头控制器	Camera Controller	Simple
`0x0148`	门铃	Doorbell	Simple
`0x0150`	环境感知传感器	Ambient Context Sensor	Simple
`0x0152`	距离测量器	Proximity Ranger	Simple
`0x0202`	窗帘	Window Covering	Simple
`0x0203`	窗帘控制器	Window Covering Controller	Simple
`0x0230`	开合设备	Closure	Simple
`0x0231`	开合面板	Closure Panel	Simple
`0x023E`	开合控制器	Closure Controller	Simple
`0x0301`	温控器	Thermostat	Simple
`0x0302`	温度传感器	Temperature Sensor	Simple
`0x0303`	水泵	Pump	Simple
`0x0304`	水泵控制器	Pump Controller	Simple
`0x0305`	气压传感器	Pressure Sensor	Simple
`0x0306`	流量传感器	Flow Sensor	Simple
`0x0307`	湿度传感器	Humidity Sensor	Simple
`0x0309`	热泵	Heat Pump	Simple
`0x030A`	温控控制器	Thermostat Controller	Simple
`0x050C`	电动汽车充电桩	EVSE	Simple
`0x050D`	设备能源管理	Device Energy Management	Utility
`0x050F`	热水器	Water Heater	Simple
`0x0510`	电气传感器	Electrical Sensor	Utility
`0x0511`	电力公用事业电表	Electrical Utility Meter	Simple
`0x0512`	电表参考点	Meter Reference Point	Simple
`0x0513`	电价	Electrical Energy Tariff	Simple
`0x0514`	电表	Electrical Meter	Simple
`0x0516`	断路器	Electrical Circuit Breaker	Simple
`0x0517`	配电箱	Electrical Distribution Enclosure	Simple
`0x0840`	控制桥	Control Bridge	Simple
`0x0850`	开关传感器	On/Off Sensor	Simple

数据来源：connectedhomeip v1.6.0.0

查到 ID 之后

想知道一台设备配网后是什么类型、支持什么功能：看概念总览 · 配网后怎么读出设备能力
手上有设备的原始数据：粘进 JSON 解析器，选“设备原始数据”示例，每个 ID 都会自动翻译
要看某个 Cluster 的字段细节：去 Cluster 手册