PetBoxX 育雏系统：温湿度分阶段管理与自动喷雾设计

         humi < low && temp_ok
IDLE ──────────────────────────→ MISTING
  ↑                                  │
  │   cooldown 结束                  │ humi >= high
  │                                  │ 或超时 max_on_s
  └──── COOLDOWN ←──────────────────┘
           等待 cooldown_s 秒

当 temp < setpoint - temp_guard 时，禁止启动喷雾

// 喷雾启动：泵先开，雾化器随后
static void mist_on(void) {
    set_pump_pwm_output_percent(pump_pct);  // 供水
    set_mist_pwm_output_percent(mist_pct);  // 雾化
}

// 喷雾停止：两者同时关
static void mist_off(void) {
    set_mist_pwm_output_percent(0);
    set_pump_pwm_output_percent(0);
}

HUMI_TARGET=600        # 目标 60%，自动构建 ±5% 区间 [55, 65]
HUMI_BAND=550,650      # 直接设置上下限（×10 整数避免浮点）
HUMI_GUARD=5           # 温度保护 0.5°C
HUMI_TIMING=5,90       # 喷雾最长 5s，冷却 90s
HUMI_STAGE=1           # 快速应用阶段预设

hc.low_x10    # 下限 ×10
hc.high_x10   # 上限 ×10
hc.guard_x10  # 温度保护 ×10
hc.max_on     # 最长喷雾秒数
hc.cooldown   # 冷却等待秒数
hc.state      # 0=IDLE 1=MISTING 2=COOLDOWN

ISR（任意边沿中断）→ 边沿计数
  ↓ 每 100ms 采样一次
  100ms 内边沿数 ≥ 2  →  working = true
  300ms 内有边沿       →  working = true（recent edge 保持）
  否则                 →  working = false

条件满足？
  需要加湿（当前 RH < 目标 RH）
  && 雾化器当前不工作（XKT201 边沿静默）
  && 不在冷却期（上次补水已过 interval_min）
  && 不在锁定期
      ↓
  开泵运行 duration_s 秒
      ↓
  进入冷却期 interval_min 分钟
      ↓
  冷却结束 → 检查本次补水是否有效（RH 变化 ≥ 1%）
      ├─ 有效 → 正常继续
      └─ 无效 → 失败计数 +1
                 失败 ≥ 3 次 → 进入锁定（300s）
                               锁定期间 XKT201 恢复工作 → 自动解锁

if (RH_now - RH_after_last_refill) < 1.0%:
    refill_failures++
    if failures >= 3:
        lockout = true  # 停止补水 300s

SHT30 传感器（~1s 采样）
    │
    ├── humidity_ctrl_tick(humi, temp, setpoint)
    │       │
    │       ├── IDLE: humi < low && temp_ok → mist_on()
    │       │         └── pump ON + mist ON（喷雾供水）
    │       │
    │       └── MISTING: humi >= high || timeout || temp_fail → mist_off()
    │                     └── pump OFF + mist OFF
    │
    └── mist_autofill（独立任务，1s tick）
            │
            ├── XKT201 working?  → 雾化器在工作，跳过补水
            └── NOT working && need_humi && cooldown done
                    └── pump ON（仅泵，雾化器关）→ 补水 duration_s

55% ────────[63.5%]──── 65%
              ↑
           当前湿度，在区间内

状态：IDLE，不喷雾
原因：湿度未跌破下限 55%，无需干预

SP=37.50  T=25.80  err=11.702°C

判断：25.80 < 37.50 - 0.5 → 25.80 < 37.00  ✓ 触发温度保护
结果：即使湿度低于 55%，也禁止喷雾

判断链：
  54% < low(55%)          ✓ 湿度低于下限
  37.2 >= 37.5 - 0.5      ✓ 温度允许（≥ 37.0°C）
  状态 = IDLE              ✓ 不在冷却期

→ 进入 MISTING：泵 ON + 雾化器 ON

喷雾过程：
  t=0s   湿度 54%，开始喷雾
  t=3s   湿度升至 65%（high）→ 触发停止
  → 进入 COOLDOWN，等待 90s
  → 90s 后回到 IDLE

t=0s    喷雾结束 → 进入 COOLDOWN
t=20s   湿度再次跌至 53%（传感器滞后或空间大）
         → 仍在冷却期，不喷雾
t=90s   冷却结束 → 回到 IDLE
t=91s   检测到湿度 53% < 55% → 重新触发喷雾

切换前：目标温度 36.0°C，low=55%  high=65%
操作：前端点击"阶段2"→ 参数填入 34.5°C / [50%, 60%]
分别点击温度下发 + 湿度区间下发

若切换时当前湿度是 62%：
  62% 在新区间 [50%, 60%] 之外（高于 high=60%）
  → 系统等湿度自然降至 60% 以下后进入"在区间内"状态
  → 继续降至 50% 以下才触发喷雾

IDLE → (湿度 < low ∧ 温度达标) → MISTING（最长 max_on_s）
MISTING → (时间到 or 湿度 ≥ high) → COOLDOWN（固定 cooldown_s）
COOLDOWN → 时间到 → IDLE

t=0s    IDLE → 触发喷雾（湿度低 ∧ 温度达标）
t=5s    喷雾停止 → 进入 COOLDOWN
t=5s~   喷雾散热 → 传感器温度可能短暂下降 0.1~0.3°C
t=95s   COOLDOWN 结束 → 回到 IDLE
t=96s   重新检测：若温度已恢复，且湿度仍低 → 再次喷雾
        若温度还没恢复 → temp_guard 拦截，继续等