端点描述 Cluster（Descriptor）

Cluster ID: 0x001D  |  所在 Endpoint: 每个 Endpoint 都必须有（包括 Endpoint 0）

Descriptor 是 Matter 协议中最基础的 Cluster，它回答一个核心问题：这个 Endpoint 上有什么？ Controller（手机、音箱、Hub）连上一个 Matter 设备后，第一件事就是读取各个 Endpoint 的 Descriptor， 从而知道设备支持哪些 Device Type、实现了哪些 Cluster、以及端点之间的层级关系。

这个 Cluster 是纯只读的 —— 没有任何 Command，只有 Attribute。设备在出厂时就决定了这些信息，运行时不会改变。

Descriptor 解决什么问题

Matter 设备的数据模型是树状结构：一个 Node（物理设备）包含多个 Endpoint，每个 Endpoint 代表一个功能单元。 但 Controller 连上设备时，并不知道这棵树长什么样。Descriptor 就是这棵树的自描述机制：

• DeviceTypeList —— 告诉 Controller "我是什么"（门锁？灯？开关？）
• ServerList / ClientList —— 告诉 Controller "我能做什么"（支持哪些 Cluster）
• PartsList —— 告诉 Controller "我下面还有谁"（子端点列表）

属性总览

Descriptor 只有 5 个属性，但每个都至关重要。点击属性 ID 可跳转到详细说明。

属性详解

DeviceTypeList（0x0000）

列出该端点支持的所有 Device Type。每个条目是一个 DeviceTypeStruct，包含设备类型 ID 和版本号。 大多数端点只有一个 Device Type，但规范允许一个端点同时声明多个。

DeviceTypeStruct 结构

↑ 返回属性列表

ServerList（0x0001）

列出该端点作为 Server 实现的所有 Cluster ID。 所谓 Server，就是"持有数据、响应读写请求"的一方。 例如一把门锁的 Endpoint 1 的 ServerList 会包含 0x0101（DoorLock）， 因为锁的状态（是否上锁、用户列表等）存储在设备端。

Controller 通过读取 ServerList，就知道可以对这个端点发送哪些 Cluster 的读/写/命令请求。

↑ 返回属性列表

ClientList（0x0002）

列出该端点作为 Client 实现的所有 Cluster ID。 Client 是"发起请求"的一方 —— 大多数终端设备（灯、锁、传感器）的 ClientList 为空， 因为它们只被控制，不主动控制别人。

ClientList 非空的典型场景：物理开关（Switch）。 一个墙壁开关会在 ClientList 中声明 0x0006（OnOff Client）， 表示它会主动向灯具发送开关命令。

↑ 返回属性列表

PartsList（0x0003）

列出该端点的子端点编号。这个属性定义了端点之间的层级关系。

↑ 返回属性列表

TagList（0x0004）— 可选

为端点附加语义标签，用于区分功能相同但位置或用途不同的端点。 例如一个设备有两个温度传感器端点，可以通过 TagList 标记一个是"室内"，另一个是"室外"。

TagList 需要设备声明 TAGLIST Feature（Feature Bit 0）才会出现。

SemanticTagStruct 结构

↑ 返回属性列表

Controller 如何使用 Descriptor 发现设备

Controller 连上一个 Matter 设备后，标准的端点发现流程如下：

1. 读取 Endpoint 0 的 PartsList —— 拿到所有功能端点编号，如 [1, 2, 3]
2. 遍历每个端点，读取 DeviceTypeList —— 知道 Endpoint 1 是门锁、Endpoint 2 是温度传感器...
3. 读取 ServerList —— 知道每个端点具体支持哪些 Cluster（能做哪些操作）
4. 根据以上信息构建 UI —— 门锁端点显示开锁按钮，温度传感器端点显示温度数值

示例数据

场景一：普通设备（门锁）

Endpoint 0（Root Node）的 Descriptor：

{
  // Endpoint 0（Root Node）的 Descriptor
  "DeviceTypeList": [
    { "DeviceType": "0x0016", "Revision": 2 }   // Root Node
  ],
  "ServerList": [
    "0x001D",   // Descriptor
    "0x0028",   // BasicInformation
    "0x002F",   // PowerSource
    "0x0030",   // GeneralCommissioning
    "0x0031",   // NetworkCommissioning
    "0x003E",   // OperationalCredentials
    "0x0033"    // GeneralDiagnostics
  ],
  "ClientList": [],
  "PartsList": [ 1, 2, 3 ]   // 该节点还有 Endpoint 1、2、3
}

Endpoint 1（门锁功能端点）的 Descriptor：

{
  // Endpoint 1（功能端点，比如一把门锁）的 Descriptor
  "DeviceTypeList": [
    { "DeviceType": "0x000A", "Revision": 3 }   // DoorLock
  ],
  "ServerList": [
    "0x001D",   // Descriptor（自身）
    "0x0003",   // Identify
    "0x0101",   // DoorLock
    "0x002F"    // PowerSource
  ],
  "ClientList": [],
  "PartsList": []   // 叶子端点，没有子端点
}

场景二：Bridge 设备

Bridge（网关/桥接器）的 Endpoint 0 的 PartsList 会列出所有桥接的子设备：

{
  // Endpoint 0（Bridge 设备）的 Descriptor
  "DeviceTypeList": [
    { "DeviceType": "0x000E", "Revision": 2 }   // Aggregator（Bridge）
  ],
  "ServerList": [ "0x001D", "0x0028", "0x0039" ],
  "PartsList": [ 1, 2, 3, 4, 5 ]   // 桥接了 5 个子设备

  // 每个子端点（1~5）各自有独立的 Descriptor，
  // 描述各自的 DeviceType 和 Cluster 列表
}