feat: 按钮去抖+配网界面美化+水浸离线+LED独立任务+报警全拓展(人身优先)+有人才检测

include/alarm_manager.h

@@ -1,9 +1,12 @@
 /**
  * @file alarm_manager.h
- * @brief 报警管理器 - 双模式 (本地判定 + 服务端指令)
+ * @brief 报警管理器 - 多类型分优先级报警 (本地判定 + 服务端指令)
  *
- * 本地模式: 离线也能用, 跌倒/水浸/心率异常/呼吸异常 本地判定触发
+ * 优先级: 跌倒 > 水浸 > 心率异常 > 呼吸异常 > 温湿度异常 > 传感器故障
+ *
+ * 本地模式: 离线也能用, 全部类型本地判定触发
  * 服务端模式: 收到 cmd/{gateid}/alarm, alarm/restore 执行联动
+ * 防抖: 传感器故障需连续 N 次确认才触发, 避免误报
  */
 
 #ifndef ALARM_MANAGER_H
@@ -12,16 +15,23 @@
 #include <Arduino.h>
 #include "config.h"
 
+// 报警回调 — 通知外部 (如 MQTT 上报)
+typedef void (*AlarmCallback)(uint8_t type, bool triggered, const char* desc);
+
 class AlarmManager {
 public:
-    // 告警类型 (本地 + 服务端共用)
-    enum AlarmType {
+    // 告警类型 (按优先级从高到低)
+    enum AlarmType : uint8_t {
         ALARM_NONE = 0,
-        ALARM_FALL,             // 跌倒 (本地 + 服务端)
-        ALARM_WATER_LEAK,       // 水浸 (本地 + 服务端)
-        ALARM_HEART_ABNORMAL,   // 心率异常 (本地)
-        ALARM_BREATH_ABNORMAL,  // 呼吸异常 (本地)
-        ALARM_SERVER,           // 服务端下发 (通用)
+        ALARM_FALL,               // 跌倒 (本地 + 服务端) ★★★★★
+        ALARM_WATER_LEAK,         // 水浸 (本地 + 服务端) ★★★★
+        ALARM_HEART_ABNORMAL,     // 心率异常 (本地) ★★★
+        ALARM_BREATH_ABNORMAL,    // 呼吸异常 (本地) ★★★
+        ALARM_TEMP_ABNORMAL,      // 温度异常 (本地) ★★
+        ALARM_HUMI_ABNORMAL,      // 湿度异常 (本地) ★★
+        ALARM_SENSOR_FAULT,       // 传感器故障 (本地) ★
+        ALARM_SERVER,             // 服务端下发 (通用)
+        ALARM_COUNT
     };
 
     AlarmManager();
@@ -34,11 +44,11 @@ public:
     // 本地报警接口 (离线可用)
     // ============================================================
 
-    /** 触发本地报警 */
-    void triggerLocal(AlarmType type);
+    /** 触发本地报警 (防抖由调用方处理) */
+    void triggerLocal(AlarmType type, const char* detail = nullptr);
     /** 清除本地报警 */
     void clearLocal(AlarmType type);
-    /** 清除所有本地报警 */
+    /** 清除所有本地报警 (含防抖计数器) */
     void clearAllLocal();
 
     // ============================================================
@@ -53,33 +63,58 @@ public:
     void buzzerTest(uint32_t durationSec);
 
     // ============================================================
-    // 状态查询 (上报用)
+    // 回调注册
     // ============================================================
 
-    bool isBuzzerOn() const      { return _buzzerOn; }
-    bool hasActiveAlarm() const  { return _activeCount > 0; }
-    const char* getActiveAlarmType() const;
+    /** 报警状态变化回调 (触发/清除时调用, 用于MQTT上报) */
+    void onAlarmChange(AlarmCallback cb) { _alarmCb = cb; }
+
+    // ============================================================
+    // 状态查询
+    // ============================================================
+
+    bool isBuzzerOn() const           { return _buzzerOn; }
+    bool hasActiveAlarm() const       { return _activeCount > 0; }
+    uint8_t getActiveCount() const    { return _activeCount; }
+    AlarmType getHighestAlarm() const;
+    const char* getAlarmName(AlarmType type) const;
+    const char* getActiveAlarmStr() const;
 
 private:
+    // 报警优先级 (越小越紧急)
+    static uint8_t _priority(AlarmType t);
+
     void _setBuzzer(bool on);
     void _setLED(bool on);
     void _updateBuzzer();
     void _updateLED();
+    uint32_t _buzzerIntervalFor(AlarmType type);
 
     // 蜂鸣器/LED 状态
     bool     _buzzerOn;
     bool     _ledOn;
-    uint32_t _buzzerOffTime;       // 定时关闭时刻 (0=手动关)
+    uint32_t _buzzerOffTime;       // 定时关闭时刻 (0=手动/无限)
     uint32_t _buzzerToggleTime;    // 间歇切换时刻
     bool     _buzzerBeepState;     // 间歇状态 (响/停)
     uint8_t  _beepCount;           // 当前周期哔了几声
+    uint8_t  _beepsPerCycle;       // 当前报警类型每周期几声
+    uint32_t _beepOnMs;            // 每声持续 ms
+    uint32_t _beepOffMs;           // 每声间隔 ms
+    uint32_t _cyclePauseMs;        // 周期间停顿 ms
 
-    // 活动报警列表 (最多 4 个同时)
-    AlarmType _activeAlarms[4];
+    // 活动报警列表 (最多 5 个同时)
+    static const uint8_t MAX_ACTIVE = 5;
+    AlarmType _activeAlarms[MAX_ACTIVE];
     uint8_t   _activeCount;
 
+    // 当前详情 (用于上报)
+    char      _activeDetail[64];
+
     // LED 闪烁
     uint32_t _lastLEDToggle;
+
+    // 回调
+    AlarmCallback _alarmCb;
 };
 
 #endif // ALARM_MANAGER_H