固定标签 Cluster（Fixed Label）

Cluster ID: 0x0040  |  所在 Endpoint: Endpoint 0（Root）或各功能 Endpoint

Fixed Label 存储设备在出厂时写入的标签（键值对），用于描述设备的物理属性或预设分类。 这些标签是只读的 —— 用户和 App 都无法修改，只能读取。 标签内容由制造商在生产阶段确定，比如设备预设的房间、楼层、朝向等信息。

属性总览

Fixed Label 只有一个属性，非常简单。

LabelList（出厂标签列表）

一个 LabelStruct 数组，每个元素是一个键值对。列表可以为空（设备没有预设标签）， 也可以包含多个条目。标签的键（Label）在同一个列表中不应重复。

这个属性是只读的，设备启动后内容固定不变。如果需要可写的标签，使用 UserLabel Cluster（0x0041）。

↑ 返回属性列表

LabelStruct 结构体

LabelStruct 是 Fixed Label 和 UserLabel 共用的数据结构，定义了一个标签的键和值。

常见的出厂标签示例

命令（Commands）

Fixed Label Cluster 没有任何命令。这是一个纯数据 Cluster —— 只提供只读属性供 App 读取，不接受任何写入或操作指令。 如果需要修改标签，请使用 UserLabel Cluster（0x0041）。

示例数据

读取一个厨房传感器设备的 Fixed Label 属性：

{
  // --- 属性 ---
  "0x0": [                    // LabelList — 出厂标签列表
    {
      "Label": "room",        // 标签键：房间
      "Value": "kitchen"      // 标签值：厨房
    },
    {
      "Label": "floor",       // 标签键：楼层
      "Value": "2"            // 标签值：2 楼
    },
    {
      "Label": "orientation", // 标签键：朝向
      "Value": "N"            // 标签值：北
    }
  ]
}

应用场景

场景一：自动归类设备到房间

用户配网完成后，App 读取设备的出厂标签。如果标签中包含 room 键， App 可以自动将设备归类到对应房间，省去用户手动选择的步骤。

// 场景：App 读取设备的出厂标签，自动归类到对应房间
{
  "readRequests": [{
    "attributePath": {
      "endpointId": 0,
      "clusterId": "0x0040",
      "attributeId": "0x00"     // LabelList
    }
  }]
}

// 返回结果
{
  "attributeReports": [{
    "attributeData": {
      "dataVersion": 1,
      "data": [
        { "Label": "room", "Value": "kitchen" },
        { "Label": "floor", "Value": "2" }
      ]
    }
  }]
}

场景二：多 Endpoint 设备区分子功能

一个双路开关有两个 Endpoint，每个 Endpoint 上的 Fixed Label 标注了物理位置（左/右）。 App 读取标签后可以直接在 UI 上标注「左开关」「右开关」，而不是显示无意义的 Endpoint 编号。

// 场景：多 Endpoint 设备，每个 Endpoint 有不同的出厂标签
// Endpoint 1 — 左侧开关
{
  "readRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x0040",
      "attributeId": "0x00"
    }
  }]
}
// 返回: [{ "Label": "position", "Value": "left" }]

// Endpoint 2 — 右侧开关
{
  "readRequests": [{
    "attributePath": {
      "endpointId": 2,
      "clusterId": "0x0040",
      "attributeId": "0x00"
    }
  }]
}
// 返回: [{ "Label": "position", "Value": "right" }]