布尔状态 Cluster（BooleanState）

Cluster ID: 0x0045  |  所在 Endpoint: 通常在 Endpoint 1（功能端点） |  角色: Server（只读，无命令）

BooleanState 是 Matter 中最简单的 Cluster 之一 —— 只有 1 个属性、0 个命令、1 个事件。 它用于报告一个通用的布尔（true/false）状态，典型的使用场景包括门窗传感器、水浸传感器、烟雾报警器等只需要表达「正常 / 异常」两态的设备。

这个 Cluster 是纯只读的 —— App 端只能读取状态和订阅变化，不能向设备发送任何命令来改变状态。 状态的变化完全由设备端的物理传感器驱动。

属性

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

StateValue（当前状态）

设备当前的布尔状态值。只读，不能通过写属性或命令来改变 —— 只有设备端的物理传感器触发才会更新这个值。

↑ 返回属性列表

事件（Events）

BooleanState 定义了一个事件，当 StateValue 发生变化时由设备端主动上报。 相比轮询属性，订阅事件是监听状态变化的推荐方式。

StateChange —— 状态变更事件（0x00）

当设备的物理状态发生变化（如门被打开、检测到漏水）时，设备会发出此事件。 事件数据中携带变化后的新 StateValue。

事件上报示例：

{
  "eventReports": [{
    "eventData": {
      "path": {
        "endpointId": 1,
        "clusterId": "0x0045",
        "eventId": "0x00"       // StateChange
      },
      "eventNumber": 42,
      "priority": "INFO",
      "data": {
        "0": false              // StateValue = false（状态变化：如门被打开）
      }
    }
  }]
}

订阅请求示例：

{
  "subscribeRequests": [{
    "attributeRequests": [{
      "endpointId": 1,
      "clusterId": "0x0045",
      "attributeId": "0x00"     // StateValue
    }],
    "eventRequests": [{
      "endpointId": 1,
      "clusterId": "0x0045",
      "eventId": "0x00"         // StateChange
    }]
  }],
  "minIntervalFloor": 0,        // 最短上报间隔（秒）
  "maxIntervalCeiling": 300     // 最长上报间隔（秒）
}

↑ 返回事件列表

示例数据

读取一个门窗传感器的 BooleanState Cluster 属性：

{
  // --- 属性 ---
  "0x0": true          // StateValue = true（正常状态，如门已关闭、无漏水）
}

常见场景