智慧档案环境系统运维：温湿度设备定期校准与故障快速定位指南

前3个月：出厂应力释放，可能有微小正向偏移（0.2~0.5%RH）
3~12个月：相对稳定期，漂移量小
12~24个月：老化加速，尤其高湿暴露后
24个月以上：部分传感器进入快速退化区，偏差可能跳变

一级：计量标准器（实验室级）
  ↓ 比对
二级：现场便携校准仪（可携带至库房）
  ↓ 比对
三级：在线运行传感器（库房内实际部署）

步骤1：准备
  - 便携校准仪提前30min开机预热，确认电量/状态
  - 选择比对测点（优先选关键库房的远角测点）
  - 记录环境状态（机组运行模式、当前温湿度）

步骤2：同置
  - 将便携校准仪探头与在线传感器探头并排放置
  - 间距 < 5cm，避免互相遮挡气流
  - 等待30min使两者达到热平衡

步骤3：读数
  - 每分钟记录一次，连续5次
  - 取5次平均值作为比对结果

步骤4：判定
  - 偏差 = 在线值 - 便携仪值
  - 温度偏差 > ±0.5℃ 或 湿度偏差 > ±3%RH → 需校准/更换
  - 温度偏差 > ±1.0℃ 或 湿度偏差 > ±5%RH → 立即更换，该点数据标记为 suspect

步骤5：处置
  - 可现场校准的传感器（带校准按键/软件）：现场修正偏移量
  - 不可现场校准的：拆下返厂或启用备用传感器
  - 更新校准台账

步骤6：记录
  - 校准日期、设备ID、便携仪编号、偏差值、处置方式、操作人
  - 平台侧标记校准事件，历史数据不修改但可标注"已校准偏移"

def calc_next_cal_interval(sensor_id, history):
    """
    根据历史校准记录和漂移趋势计算下次校准间隔
    """
    records = history[sensor_id]  # [(date, drift_temp, drift_humi)]
    
    if len(records) < 3:
        return 180  # 不足3次记录，默认半年
    
    # 计算漂移速率（%/月）
    humi_drifts = [(r[1].drift_humi - r[0].drift_humi) / (r[1].date - r[0].date).days * 30 
                   for r in zip(records[:-1], records[1:])]
    avg_drift_rate = mean(humi_drifts)
    
    if avg_drift_rate < 0.05:   # 月漂移 < 0.05%RH，稳定
        return 365  # 延长至一年
    elif avg_drift_rate < 0.1:  # 月漂移 < 0.1%RH
        return 180  # 维持半年
    else:                        # 月漂移 > 0.1%RH，退化快
        return 90   # 缩短至季度

第一层：平台侧（数据是否到达）
  → 看平台是否收到最新上报
  → 收到但值异常 → 跳到第三层
  → 未收到 → 跳到第二层

第二层：网络/通信（数据是否传输）
  → Ping 网关/交换机端口
  → 检查 PoE 端口状态和功率
  → 检查 VLAN/路由/防火墙规则
  → 抓包确认（Wireshark）
  → 网络正常但数据不通 → 跳到第三层

第三层：设备侧（数据是否正确产生）
  → 检查传感器 LCD 本地显示
  → 检查供电（电压/电流）
  → 检查接线（端子松动/氧化）
  → 本地读取寄存器（modpoll/pymodbus）
  → 设备正常但数据异常 → 校准/更换

现象：某测点温度从 21℃ 跳到 35℃ 又回到 21℃，持续数秒
定位步骤：
  1. 检查该点是否唯一跳变（其他测点正常 → 单点问题）
  2. 检查 LCD 本地显示是否同步跳变
     - LCD 也跳 → 传感器硬件故障/供电不稳
     - LCD 正常 → 通信干扰/数据解析错误
  3. 检查 PoE 端口错误计数（CRC error、alignment error）
  4. 检查网线是否靠近强电（感应干扰）
  5. 检查边缘网关日志是否有该点采集超时重试
处置：
  - 硬件故障 → 更换传感器
  - 通信干扰 → 重新布线/加磁环/换屏蔽线
  - 供电不稳 → 检查 PoE 交换机端口功率是否充足

现象：某测点数值长时间不变，但设备在线
定位步骤：
  1. 检查 LCD 是否仍在刷新
     - LCD 刷新 → 传感器正常，通信层问题
     - LCD 冻结 → 传感器死机
  2. 通信层：用 modpoll 手动读取寄存器，看是否响应
     - 有响应但值不变 → 传感器内部 ADC 故障
     - 无响应 → 网络/协议问题
  3. 检查网关轮询日志，是否有超时
处置：
  - 传感器死机 → 断电重启，若反复出现则更换
  - ADC 故障 → 更换
  - 通信超时 → 检查网线/交换机端口

现象：某库房所有测点同时离线
定位步骤：
  1. 检查该区域 PoE 交换机是否在线（Ping）
  2. 检查交换机上行链路状态（端口灯/日志）
  3. 检查该交换机供电（PDU/UPS）
  4. 检查 VLAN 配置是否被误改
  5. 检查是否有施工导致网线被拔/剪断
处置：
  - 交换机掉电 → 检查供电回路
  - 上行断开 → 检查光纤/网线/光模块
  - 配置丢失 → 从备份恢复配置
  - 物理损坏 → 启用备用交换机/临时跳线

现象：温湿度越限，但机组/除湿机未响应
定位步骤：
  1. 确认平台是否产生告警（数据层正常）
  2. 确认边缘侧策略是否触发（查策略日志）
     - 未触发 → 检查阈值配置、滞回条件、手动/自动模式
     - 已触发但未下发 → 检查 Modbus 写操作日志
  3. 手动用 modpoll 写寄存器测试机组响应
     - 手动写成功 → 边缘侧逻辑问题
     - 手动写失败 → 机组通信/权限问题
  4. 检查机组是否处于"本地"模式（手自动开关）
  5. 检查互锁条件是否阻止了动作
处置：
  - 阈值/模式配置错误 → 修正配置
  - 边缘逻辑 bug → 修复策略/回滚版本
  - 机组本地模式 → 切回远程
  - 互锁阻止 → 确认安全后临时旁路（需审批）

现象：历史曲线有断点，但设备在线
定位步骤：
  1. 检查缺失模式：规律性缺失（如每小时丢5分钟）→ 网关轮询周期/超时设置
  2. 随机缺失 → 网络抖动/交换机缓冲区溢出
  3. 检查网关系统资源（CPU/内存/磁盘）
  4. 检查 MQTT 连接是否频繁重连
  5. 检查平台侧是否有写入延迟
处置：
  - 轮询超时 → 增大超时/减少并发
  - 网络抖动 → 检查交换机端口协商速率/双工模式
  - 资源不足 → 优化网关配置/升级硬件

{
  "fault_id": "F-2025-0115-001",
  "symptom": "库房B所有测点离线",
  "root_cause": "PoE交换机上行光模块故障",
  "location_path": ["平台无数据", "交换机不可达", "光模块TX光功率=0", "更换光模块恢复"],
  "resolution_time": "23min",
  "prevention": "光模块冗余/定期光功率检测",
  "tags": ["通信中断", "PoE交换机", "光模块", "库房B"]
}