布尔状态配置 Cluster（BooleanStateConfiguration）

Cluster ID: 0x0080  |  所在 Endpoint: 与 BooleanState 同一 Endpoint（功能端点）

BooleanStateConfiguration 是 BooleanState（0x0045）的配套 Cluster —— BooleanState 负责报告传感器的二值状态（true/false），而 BooleanStateConfiguration 则负责配置传感器的行为： 管理告警输出（视觉闪烁、蜂鸣声）以及调节传感器灵敏度。

典型使用场景：门窗传感器检测到门被打开时，BooleanState 的 StateValue 变为 false， 同时 BooleanStateConfiguration 控制是否亮灯闪烁（Visual）、是否发出蜂鸣声（Audible）， 以及传感器的触发灵敏度等级。

命令（Commands）

BooleanStateConfiguration Cluster 有 2 个命令，分别用于抑制告警和启用/禁用告警。 两个命令都通过 AlarmModeBitmap 位图来指定操作哪些告警通道。 点击下方表格中的命令 ID 可跳转到对应的详细说明。

SuppressAlarm —— 抑制告警（0x00）

临时抑制当前正在激活的告警。例如传感器正在蜂鸣报警，用户按了「静音」按钮后， App 发送此命令让蜂鸣暂停。抑制不等于禁用 —— 告警通道仍然是启用的， 下次传感器再次触发时告警会重新激活。此命令需要设备支持 SPRS（AlarmSuppress） 特性。

↑ 返回命令列表

EnableDisableAlarm —— 启用/禁用告警（0x01）

启用或禁用指定的告警通道。修改的是 AlarmsEnabled 属性， 决定后续传感器触发时哪些告警通道会响应。此命令需要设备支持至少一个告警特性（VIS 或 AUD）。

↑ 返回命令列表

属性详解

BooleanStateConfiguration Cluster 共有 7 个应用属性，分为灵敏度配置和告警状态两组。 点击下方汇总表中的属性 ID 可跳转到对应的详细说明。

灵敏度配置（0x0000 ~ 0x0002）

控制传感器的触发灵敏度。灵敏度用一个从 0 开始的整数级别表示， 0 是最高灵敏度（最容易触发），数值越大灵敏度越低。 这组属性需要设备支持 SENS（SensitivityLevel） 特性。

↑ 返回属性列表

告警状态（0x0003 ~ 0x0006）

管理传感器的告警输出通道。所有告警属性都使用 AlarmModeBitmap 类型， 通过位图控制视觉（闪灯）和听觉（蜂鸣）两种告警模式。

↑ 返回属性列表

AlarmModeBitmap

AlarmsActive、AlarmsSuppressed、AlarmsEnabled、AlarmsSupported 四个属性， 以及两个命令的参数，都使用同一套 AlarmModeBitmap 位图定义。 每一位代表一种告警输出通道：

事件（Events）

BooleanStateConfiguration 定义了一个 AlarmsStateChanged 事件， 在告警状态发生任何变化时由设备端主动上报。

AlarmsStateChanged —— 告警状态变更事件（0x00）

当告警状态发生变化时（告警激活、解除或被抑制），设备会产生此事件。 事件携带变化后的完整告警快照。控制器应当订阅此事件以实时获取告警变化通知。

事件上报示例（视觉告警激活，听觉告警被抑制）：

{
  "eventReports": [{
    "eventData": {
      "path": {
        "endpointId": 1,
        "clusterId": "0x0080",
        "eventId": "0x00"       // AlarmsStateChanged
      },
      "eventNumber": 15,
      "priority": "INFO",
      "data": {
        "0": "0x01",            // AlarmsActive = 0x01（视觉告警激活）
        "1": "0x02"             // AlarmsSuppressed = 0x02（听觉告警已抑制）
      }
    }
  }]
}

↑ 返回事件列表

Feature 位图

BooleanStateConfiguration 通过 FeatureMap（0xFFFC）声明设备支持哪些能力：

示例数据

一个同时支持视觉告警、听觉告警和灵敏度调节的门窗传感器，读取 BooleanStateConfiguration 属性的结果：

{
  // --- 灵敏度配置（SENS 特性）---
  "0x0000": 1,              // CurrentSensitivityLevel = 1（当前灵敏度级别）
  "0x0001": 3,              // SupportedSensitivityLevels = 3（支持 0/1/2 三个级别）
  "0x0002": 1,              // DefaultSensitivityLevel = 1（出厂默认级别）

  // --- 告警状态（VIS + AUD 特性）---
  "0x0003": "0x03",         // AlarmsActive = 0x03（视觉 + 听觉告警均已激活）
  "0x0004": "0x00",         // AlarmsSuppressed = 0x00（无告警被抑制）
  "0x0005": "0x03",         // AlarmsEnabled = 0x03（视觉 + 听觉告警均已启用）
  "0x0006": "0x03"          // AlarmsSupported = 0x03（设备支持视觉 + 听觉告警）
}

常见场景