绑定 Cluster（Binding）

Cluster ID: 0x001E  |  所在 Endpoint: 功能端点（如 Endpoint 1） |  角色: Client 侧配置（无命令，通过写属性配置）

Binding 是 Matter 中定义设备间「接线关系」的 Cluster。它解决的核心问题是： 一个设备发出的命令，应该发给谁？

举个例子：你有一个智能开关和一个智能灯泡。按下开关时，开关怎么知道该控制哪盏灯？ 答案就是 Binding —— 在开关的 Binding 属性里写入灯泡的地址，开关就「认识」了这盏灯。

属性

Binding Cluster 只有一个属性，且是必须支持的。

Binding（绑定目标列表）

一个 TargetStruct 的列表，每个条目描述一个绑定目标。 设备会按照这个列表中的地址发送命令。列表为空表示没有绑定任何目标。

写入时是全量替换 —— 新写入的列表会完全覆盖旧的。 如果只想添加一个绑定，需要先读取现有列表，追加新条目后整体写回。

TargetStruct 字段

↑ 返回属性列表

示例数据

读取绑定列表

{
  // 读取绑定列表
  "attributeRequests": [{
    "endpointId": 1,
    "clusterId": "0x001E",
    "attributeId": "0x00"          // Binding
  }]
}

单播绑定（开关 → 灯泡）

将开关（Endpoint 1）绑定到 Node 2 上的灯泡（Endpoint 1）的 OnOff Cluster：

{
  // 单播绑定：开关 → 灯泡
  // 写入 Endpoint 1 的 Binding 属性
  "writeRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x001E",
      "attributeId": "0x00"        // Binding
    },
    "dataVersion": 0,
    "data": [
      {
        "0": 2,                    // Node = 2（目标灯泡的 Node ID）
        "2": 1,                    // Endpoint = 1（目标灯泡的功能端点）
        "3": "0x0006",             // Cluster = OnOff（绑定到 OnOff Cluster）
        "254": 1                   // FabricIndex = 1
      }
    ]
  }]
}

组播绑定（开关 → 灯群组）

将开关绑定到群组 1，按下时群组内所有灯一起响应：

{
  // 组播绑定：开关 → 一组灯
  "writeRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x001E",
      "attributeId": "0x00"        // Binding
    },
    "dataVersion": 0,
    "data": [
      {
        "1": 1,                    // Group = 1（目标群组 ID）
        "3": "0x0006",             // Cluster = OnOff（绑定到 OnOff Cluster）
        "254": 1                   // FabricIndex = 1
      }
    ]
  }]
}

多重绑定（一个开关控制多个目标）

同一个开关同时绑定两盏灯和一个群组 —— 列表中的每个条目都是一个独立的绑定目标：

{
  // 多重绑定：一个开关同时控制多个目标
  "writeRequests": [{
    "attributePath": {
      "endpointId": 1,
      "clusterId": "0x001E",
      "attributeId": "0x00"
    },
    "dataVersion": 0,
    "data": [
      {
        "0": 2, "2": 1, "3": "0x0006",   // 灯泡 A（Node 2, Endpoint 1, OnOff）
        "254": 1
      },
      {
        "0": 3, "2": 1, "3": "0x0006",   // 灯泡 B（Node 3, Endpoint 1, OnOff）
        "254": 1
      },
      {
        "1": 1, "3": "0x0006",            // 群组 1（客厅所有灯）
        "254": 1
      }
    ]
  }]
}

常见场景