烟雾/一氧化碳报警 Cluster（SmokeCOAlarm）

Cluster ID: 0x005C  |  所在 Endpoint: 通常在 Endpoint 1（功能端点）

SmokeCOAlarm 是 Matter 中消防安全设备的核心 Cluster，负责烟雾探测、一氧化碳（CO）探测、电池状态监控、设备自检和联动报警。 住宅中常见的独立式烟感、烟雾/CO 二合一探测器、互联式报警系统都依赖这个 Cluster。

Feature 位图

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

命令（Commands）

SmokeCOAlarm Cluster 只有一个命令 —— 触发设备自检。报警设备的核心动作（报警、静音等） 由设备自主触发，不需要外部命令控制。

SelfTestRequest —— 触发自检（0x00）

请求设备执行自检流程。设备会检测传感器、蜂鸣器、电池等是否正常工作。 自检期间 TestInProgress 属性变为 true，完成后触发 SelfTestComplete 事件。 不需要任何参数。

↑ 返回命令列表

属性详解

SmokeCOAlarm Cluster 的属性按功能分为四组。点击下方汇总表中的属性 ID 可跳转到对应的详细说明。

报警状态（0x0000 - 0x0003）

描述设备当前的各类报警状态。ExpressedState 是所有状态的综合优先级结果，其他三个是分项状态。

ExpressedState 枚举值

ExpressedState 反映设备当前最需要关注的状态。优先级从高到低排列：

SmokeState / COState / BatteryAlert / InterconnectSmokeAlarm / InterconnectCOAlarm 枚举值

以上五个属性共用同一套三级报警枚举：

↑ 返回属性列表

设备控制（0x0004 - 0x0007）

描述设备的静音状态、自检进度、硬件健康和使用寿命。

DeviceMuted 枚举值

EndOfServiceAlert 枚举值

↑ 返回属性列表

联动报警（0x0008 - 0x0009）

当多个报警设备互联时，一个设备触发报警后，其他设备会通过联动属性反映该状态。 联动报警让整栋房屋都能听到警报声，即使火源不在当前设备所在的房间。

↑ 返回属性列表

传感器与寿命（0x000A - 0x000C）

传感器健康状态和设备使用寿命相关信息。

ContaminationState 枚举值

SmokeSensitivityLevel 枚举值

↑ 返回属性列表

事件（Events）

SmokeCOAlarm 是 Matter 中事件最丰富的 Cluster 之一。事件记录了报警设备从触发到解除的完整生命周期， 是 App 推送通知和历史记录的主要数据来源。所有事件的优先级均为 Critical。

事件的典型时序

一次完整的烟雾报警生命周期会产生以下事件序列：

1. SmokeAlarm — 传感器检测到烟雾，报警开始
2. AlarmMuted — 用户按下静音按钮（可选）
3. MuteEnded — 静音超时，报警恢复（如果烟雾未消散）
4. AllClear — 烟雾消散，所有报警状态恢复正常

示例数据

一个支持烟雾和 CO 双报警的设备在正常状态下的 SmokeCOAlarm Cluster 读取结果：

{
  // --- 报警综合状态 ---
  "0x0000": 0,              // ExpressedState = Normal（当前无报警）
  "0x0001": 0,              // SmokeState = Normal
  "0x0002": 0,              // COState = Normal
  "0x0003": 0,              // BatteryAlert = Normal
  "0x0004": 0,              // DeviceMuted = NotMuted（未静音）
  "0x0005": false,          // TestInProgress = false（未在自检）
  "0x0006": false,          // HardwareFaultAlert = false
  "0x0007": 0,              // EndOfServiceAlert = Normal

  // --- 联动报警 ---
  "0x0008": 0,              // InterconnectSmokeAlarm = Normal
  "0x0009": 0,              // InterconnectCOAlarm = Normal

  // --- 传感器与寿命 ---
  "0x000A": 0,              // ContaminationState = Normal
  "0x000B": 1,              // SmokeSensitivityLevel = Standard
  "0x000C": 1893456000      // ExpiryDate = 2029-12-31（epoch_s）
}

常见场景