信创适配档案室监控系统，恒温恒湿消毒净化设备联动开发笔记

信创适配档案室监控系统，恒温恒湿消毒净化设备联动开发笔记

物联网 · 智慧档案 · 信创适配 · 恒温恒湿净化联动 · 盛世宏博

关键词：DA/T 42-2022、DA/T 101-2024、信创服务器、国产操作系统、Modbus RTU/TCP、恒湿消毒净化一体机、边缘联动引擎、国密传输、策略状态机、档案库房闭环调控、多设备互斥联锁、时序数据归档、三员管理

一、开发前置背景与需求边界

本项目为党政机关综合档案室新建监控及环境调控系统开发项目，项目硬性前置约束：全栈信创适配，不允许依赖境外闭源组件、商用非信创数据库、闭源第三方SDK，平台部署底座为飞腾服务器、银河麒麟V10服务器操作系统，后端数据库选用人大金仓，时序存储模块基于国产化时序库适配版本，中间件使用东方通TongWeb，整体需要满足网络安全等级保护2.0三级测评要求，同时符合档案行业DA/T 42-2022《档案库房技术管理规范》、DA/T 101-2024《智慧档案馆建设指南》。

库房受控对象为国产化恒湿消毒净化一体机，设备集成除湿、加湿、空气循环、紫外/等离子消毒、空气过滤、VOC吸附多项功能，区别于独立除湿机、加湿器、消毒设备的分散控制模式。传统档案监控项目普遍采用“平台下发指令直接控制设备”的简单联动模式，该模式存在明显缺陷：网络抖动、平台服务重启、服务器维护时联动逻辑失效；多模式之间缺少互斥保护，容易出现加湿、除湿同时开启，或者消毒时段人员进入库房仍持续执行消毒流程，对档案载体、库房管理人员带来风险；不同品牌净化设备寄存器定义、状态反馈逻辑不统一，驱动耦合度高，后期更换设备需要大面积修改平台业务代码。

本次开发核心目标，是搭建一套信创兼容、边缘优先、设备驱动解耦、具备完整状态机保护的恒温恒湿消毒净化联动子系统。联动逻辑下沉至国产化边缘采集网关执行，平台仅承担参数下发、状态展示、告警归档、报表导出、人工干预权限校验职能；边缘网关独立维护库房Zone分区状态，网络中断、上层平台不可用时，恒温恒湿闭环调控、消毒定时策略、安全联锁保护持续运行，保障库房档案存储环境不间断管控。

需求清单梳理：

1. 环境感知接入：RJ45 Modbus TCP温湿度变送器、485温湿度测点、漏水检测模块、门磁、人体红外存在探测器；所有测点数据标准化上送，按库房Zone分区隔离；
2. 受控设备接入：国产恒湿消毒净化一体机，南向协议标准Modbus RTU/TCP，支持读写运行模式、目标温湿度、启停指令、消毒定时、故障状态读取；
3. 闭环调控逻辑：分区独立PID恒温恒湿调节，支持比例带、积分、微分参数独立配置，支持防震荡互斥锁，加湿与除湿动作互锁；
4. 消毒流程管控：定时消毒、手动消毒、预约消毒三种模式，消毒动作与库房人员检测、库房门磁信号强联锁；检测到库房内有人或者库房门非法开启时，立即终止紫外消毒流程，等离子消毒按需降级；
5. 信创适配约束：业务服务可在ARM架构下编译运行，不包含x86专属二进制依赖；设备上行报文支持SM4国密加密传输，身份认证使用SM2签名；
6. 权限审计：所有人工干预操作（手动启停设备、修改PID参数、修改消毒计划、解除联锁）全部写入不可篡改审计日志，遵循档案系统三员管理隔离规范；
7. 数据留存：温湿度实时数据、设备运行状态、联动事件、告警记录分类存储，原始时序数据保存不少于5年，联动操作审计日志永久归档；
8. 对外接口：北向RESTful标准化接口，供单位统一运维平台、电子档案管理系统对接订阅环境与设备状态。

开发前置规范确认：纸质档案库房标准区间温度14℃～24℃，相对湿度45%～60%RH；调控策略支持自定义阈值、预警阈值，阈值分为告警阈值与调控阈值两层，预警阈值用于提前预调节，减少大幅度启停设备带来的环境波动。

二、整体架构分层设计（信创解耦架构）

整体延续感知终端层、国产化边缘网关层、信创平台服务层、应用展示层四层架构，联动核心逻辑下沉在边缘网关，平台层为策略配置与审计展示载体，实现“重边缘、轻平台”的设计思路，规避平台单点故障导致环境失控风险。

2.1 感知终端层

1. 温湿度采集终端：分体式RJ45 POE温湿度记录仪、RS485隔离型温湿度变送器，探头布置于密集架架内、库房回风位置，架内测点加权权重高于回风测点，用于分区等效温湿度计算；设备自带硬件CRC校验、探头断线自检，故障状态主动上报状态寄存器；
2. 安全探测终端：定位式漏水检测控制器、门磁开关、人体红外存在传感器；人体存在传感器为本次消毒联锁的关键输入，区别于普通红外移动探测，可静态识别库房内是否持续有人，避免人员静止状态下误判无人，错误启动紫外消毒；
3. 受控执行终端：国产化恒湿消毒净化一体机，设备寄存器分为只读状态寄存器组、可写控制寄存器组、参数配置寄存器组，设备自带本地硬件过载保护、风机故障、滤芯堵塞、水位异常自检，故障码统一映射到平台标准化故障编码。

2.2 国产化边缘网关层（联动开发核心载体）

网关硬件采用国产工业处理器，固件基于国产Linux，南向驱动框架独立封装设备驱动抽象层，将温湿度变送器、漏水控制器、净化一体机封装成标准化物模型，业务策略代码和设备寄存器驱动代码解耦。网关内部核心模块划分：

1. 南向协议驱动模块：Modbus RTU/TCP通用驱动，净化一体机专属协议适配插件，寄存器地址、数据放大系数、故障码映射表以配置文件形式加载，不需要修改代码即可适配同系列不同版本一体机；
2. 测点预处理与滤波模块：滑动均值滤波、异常值剔除、分区多测点加权计算模块，过滤车间/库房瞬时干扰带来的数值毛刺，输出分区等效温度、等效湿度给联动状态机；
3. 分区联动状态机引擎（开发重点）：每一个库房Zone独立实例一套状态机，状态包括【正常待机、除湿运行、加湿运行、恒温运行、消毒准备、消毒运行、消毒终止、设备故障锁定、安全联锁锁定】，状态之间跳转条件、跳转动作、互斥规则全部配置化；
4. PID闭环调节器：每个Zone独立PID实例，支持参数远程下发、本地持久化保存，支持输出限幅、动作延时、换向死区，抑制一体机频繁启停震荡；
5. 安全联锁判断单元：优先级高于PID调控策略，火警、漏水紧急告警、库房人员存在、门磁开启信号触发后，直接锁定高危动作（紫外消毒、加湿进水阀）；
6. 缓存与断点续传模块：TF卡持久化存储测点、状态变更、联动事件，网络恢复后携带原始时间戳批量上送，保证时序数据连续；
7. 国密加密传输模块：网关与平台之间MQTT上行报文SM4加密，设备接入身份SM2签名校验，防止报文篡改、伪造控制指令。

2.3 信创平台服务层

平台部署于飞腾+银河麒麟底座，服务采用SpringCloud微服务拆分，所有服务编译为ARM架构包，适配国产中间件、数据库：

1. 设备接入服务：网关接入认证、心跳管理、物模型标准化解析，异构设备数据归一；
2. 联动配置管理服务：提供页面配置入口，用于配置Zone分区、温湿度阈值、PID参数、消毒定时计划、联锁条件、告警等级；配置下发至网关后，网关本地持久化；平台只做配置存储，不实时参与闭环运算；
3. 时序存储服务：接收网关上报的温湿度、设备状态时序数据，写入国产化时序库，支持按分区、时间段查询曲线，用于DA/T规范报表生成；
4. 审计与告警服务：捕获联动状态变更、人工干预事件，写入人大金仓事务库，告警分级推送，一级告警（漏水、火警、消毒联锁触发）优先推送；
5. 权限三员服务：系统管理员、安全管理员、审计管理员权限隔离，审计管理员仅可读审计日志，无法下发控制指令、修改联动策略；
6. 北向API网关：对外提供标准化JSON接口，支持第三方档案业务系统订阅库房环境、设备状态。

2.4 前端应用层

前端适配国产浏览器（统信浏览器、奇安信信创版），包含库房组态看板、设备控制面板、联动策略配置页、消毒计划管理页、审计日志查询、温湿度报表导出页面；支持分区权限隔离，库房管理员仅可操作授权分区设备。

三、恒湿消毒净化一体机物模型与寄存器适配开发笔记

开发前期踩坑重点：不同厂家净化一体机Modbus寄存器定义差异极大，部分设备寄存器存在写寄存器需要先解锁、参数修改重启生效、状态反馈延迟2~5s、故障码位域分散等非标设计，如果直接硬编码寄存器地址，后续更换设备驱动改造量巨大。本次开发采用配置化驱动方案，把所有寄存器映射关系放到yaml配置文件，驱动程序只读取配置文件进行解析。

3.1 寄存器分组定义（标准化映射模板）

寄存器统一采用16位无符号/有符号整型，数值缩放系数、偏移量在配置文件中定义。

1. 实时状态只读组

• 0x0001：设备运行状态（0待机，1除湿，2加湿，3循环，4消毒，5故障）
• 0x0002：设备故障码（bit位映射：风机故障、水位告警、滤芯告警、通讯故障、传感器故障）
• 0x0003：本机采集温度
• 0x0004：本机采集湿度
• 0x0005：消毒剩余时间

1. 控制可写组

• 0x0100：设备总启停（0停止，1启动）
• 0x0101：模式选择（0自动恒温恒湿，1仅除湿，2仅加湿，3循环通风，4消毒）
• 0x0102：目标温度设定值
• 0x0103：目标湿度设定值
• 0x0104：消毒启动指令（脉冲写1触发，自动清零）

1. 参数配置组

• 0x0200：除湿回差
• 0x0201：加湿回差
• 0x0202：消毒时长

开发注意事项：部分一体机控制寄存器为脉冲触发，不是电平保持。下发消毒启动指令之后，程序不能持续循环写1，否则会重复触发消毒流程，需要做脉冲锁，只在状态跳转瞬间写入一次触发值，然后停止写指令。这是现场调试阶段高频BUG点。

3.2 设备驱动抽象层开发要点

抽象接口定义：

// 伪代码接口定义
interface PurifyDeviceDriver {
    // 读取设备全部状态寄存器
    DeviceState readAllState();
    // 设置目标温湿度
    bool setTargetTempHum(float temp, float hum);
    // 下发模式指令
    bool setWorkMode(WorkMode mode);
    // 启动定时消毒
    bool startDisinfect(int durationMin);
    // 紧急停止消毒
    bool stopDisinfect();
    // 获取故障文本描述
    String getFaultDesc(int faultCode);
}

新增其他品牌一体机时，只需要新增驱动实现类+对应的寄存器yaml映射文件，上层联动状态机完全不需要修改，实现驱动与业务逻辑解耦。

四、分区PID恒温恒湿闭环策略开发与防震荡处理

档案库房环境属于大惯性、大滞后系统，密集架、档案载体本身具备储热储湿特性，温湿度变化响应缓慢，直接使用简单的开关量阈值控制，会造成一体机频繁启停，设备损耗加快，库房湿度来回震荡，很难稳定维持在45%~60%RH区间。因此采用增量式PID调节器，配套换向互斥锁、最小运行间隔、死区限制。

4.1 分区等效温湿度计算逻辑

一个Zone内存在N个温湿度测点，区分架内测点和空气回风测点： 等效湿度 H = (H_shelf * 0.7) + (H_air * 0.3) 等效温度 T = (T_shelf * 0.7) + (T_air * 0.3) 架内测点权重更高，优先保证档案载体微环境达标，而不是仅仅保证库房空气回风达标。当任意一个架内测点断线时，自动降级为纯回风测点计算，并上报测点故障告警。

4.2 PID参数配置化

每个库房独立配置Kp、Ki、Kd、输出限幅、死区、最小持续运行时间。 增量PID输出转换为设备动作指令：

• 输出正向达到除湿阈值 → 进入除湿状态机；
• 输出负向达到加湿阈值 → 进入加湿状态机；
• 输出在死区范围内 → 维持待机或者循环通风；

互斥锁强制规则：加湿状态和除湿状态互斥，状态切换必须等待最小间隔（默认15分钟，可配置）。 哪怕湿度瞬间跳变，也不允许除湿结束立刻启动加湿，避免一体机内部管路、换热系统短时间冷热交替，加速设备老化，同时防止库房局部结露风险。

4.3 预调节预警机制

设置两层阈值：预警阈值、调控阈值。 示例目标湿度区间45~60%RH： 预警上限57%RH，调控上限60%RH；预警下限48%RH，调控下限45%RH； 到达预警阈值时，优先启动内循环风机预调节，不直接开启强除湿/加湿；只有越过调控阈值才执行强力调节，平缓环境变化曲线，提升稳定性。

五、消毒流程状态机与安全联锁开发（重点安全模块）

消毒流程是档案系统风险最高的联动逻辑，紫外消毒不能在有人状态执行，是开发阶段安全评审重点项，状态机拆分【消毒准备、消毒运行、正常结束、联锁终止、故障终止】五个子状态，所有跳转条件不可绕过。

5.1 三种消毒触发模式

1. 定时自动消毒：平台配置周计划，例如每日凌晨2:00启动，时长60分钟；定时触发前，状态机先进入消毒准备阶段，持续检测门磁、人体存在信号；
2. 预约消毒：管理员在平台预约未来某一时间窗口消毒，需要权限审批，审批记录写入审计；
3. 手动强制消毒：高权限账号人工触发，触发前弹窗二次确认，同时记录操作人员账号、时间、备注，审计日志重点标记人工干预。

5.2 联锁触发条件（最高优先级，一旦满足立即终止紫外消毒）

任意条件成立，立刻下发停止消毒指令，并且锁定消毒任务，需要人工复位之后才能再次启动：

1. 人体存在传感器检测到库房内存在人员；
2. 库房门磁由关闭变为开启；
3. 收到火警一级告警；
4. 收到漏水紧急告警；

等离子净化模式可配置降级策略：有人时关闭紫外，保留低功率等离子循环，不强制停机；紫外模块必须切断。

5.3 消毒准备阶段逻辑（防误触发关键）

定时时间到达，不会直接启动消毒，先进入准备等待周期（默认30s可配置）：

• 持续轮询人体存在、门磁信号；
• 弹窗告警、现场声光提示即将启动消毒；
• 准备周期内检测到有人/开门 → 直接取消本次消毒计划，生成联锁告警日志；
• 准备周期全程无人员、门磁闭合 → 正式下发消毒启动指令，进入消毒运行状态；
• 消毒运行期间持续监测联锁信号，实时判断终止条件。

开发坑点记录：人体传感器存在上报延迟，不能只采集一次信号判定，需要连续3次采样（间隔2s）确认有人，才执行联锁，避免传感器瞬时报文抖动造成消毒频繁误终止。

六、信创适配开发、国密安全与三员审计实现

6.1 ARM信创适配踩坑记录

1. 编译依赖：原有部分第三方工具链只支持x86，移植时替换为国产开源组件，时序库、MQTT客户端全部选用支持ARM64的版本，禁止引入闭源预编译so；
2. 时间库兼容：银河麒麟系统时区、闰秒处理和x86版本存在差异，所有测点时间戳统一使用UTC时间，平台再做时区转换，避免日志时间错乱；
3. 字符编码：数据库连接串强制指定UTF-8，人大金仓在信创环境下容易出现中文乱码，需要统一驱动编码参数；
4. 进程守护：网关服务、平台微服务配置systemd自启动，适配国产操作系统服务管理机制，断电上电自动恢复联动策略。

6.2 国密传输实现方案

网关与平台MQTT链路不使用标准TLS，采用SM2+SM4国密套件：

1. 网关接入平台前，使用SM2证书完成身份认证，非法网关无法接入；
2. 上报测点、事件报文载荷使用SM4加密，报文头携带签名；
3. 平台下发控制指令、策略配置同样加密签名，网关校验签名合法之后才执行，防止内网攻击者伪造指令启停设备。

6.3 三员权限与审计日志设计

三员权限严格隔离：

• 系统管理员：负责设备接入、Zone分区、联动策略参数配置；不可查看审计日志，不能下发人工控制指令；
• 安全管理员：账号管理、证书管理、密码策略、权限分配；不修改库房调控策略；
• 审计管理员：只读权限，仅查询审计日志、联动事件、告警记录，无任何设备控制、策略修改权限；

审计日志字段：事件ID、分区ID、事件类型（自动联动/人工操作/联锁触发）、操作账号、操作时间、原始参数、修改后参数、设备编号、结果（成功/失败）、备注；日志表关闭update、delete权限，只允许insert写入，满足档案审计不可篡改要求。

七、调试流程、仿真测试与现场联调方案

开发阶段分为单元仿真测试、网关半实物仿真、库房现场联调、72h稳定性试运行四个阶段，不能直接上线投产。

1. 单元仿真：本地编写状态机仿真脚本，模拟温湿度变化、人员进入、门磁开关、故障信号，遍历所有状态跳转分支，重点覆盖联锁终止、互斥锁逻辑，检查是否存在死锁、状态卡死；
2. 半实物联调：实验室接入一台真实恒湿消毒净化一体机、温湿度变送器，网关跑真实固件，平台信创环境部署完成，验证配置下发、指令返回、国密加密链路、断点续传；模拟断网场景，验证网关独立闭环调控；
3. 单库房现场调试：接入现场传感器与一体机，先关闭自动联动，全部改为手动模式，验证读写寄存器正常、故障码上报正确；再开启自动调控，逐步微调PID参数，观察温湿度曲线收敛效果；单独测试消毒联锁，安排人员进入库房验证消毒切断动作；
4. 并行试运行：新旧环境系统并行采集72h，对比温湿度曲线、设备动作时序，统计误联锁、误启停次数，优化滤波参数与延时判定阈值，试运行合格之后正式切换为全自动模式。

典型调试BUG记录

1. BUG1：下发消毒指令后，设备偶尔不启动。根因：寄存器是脉冲触发，程序循环持续写1，设备识别为持续信号拒绝执行；修复：增加脉冲标记，状态跳转瞬间写一次，之后停止写寄存器；
2. BUG2：湿度稳定后反复小幅震荡，一体机频繁启停。根因：PID微分参数过大，缺少换向最小间隔；修复：增大死区，增加加湿除湿互斥冷却时间，降低Kd；
3. BUG3：网络恢复后部分联动事件丢失。根因：网关只缓存测点数据，不缓存状态机事件；修复：事件和测点数据分开持久化，事件优先上送；
4. BUG4：信创平台读取网关数据偶发解密失败。根因：报文分片到达顺序错乱；修复：增加报文序号校验，乱序报文丢弃重传。

八、运维配套、故障诊断与版本迭代规划

系统上线后网关支持远程配置、远程固件升级，升级流程增加安全校验：升级包SM2签名校验，升级前自动备份当前策略配置，升级失败自动回滚旧固件，升级窗口选择非工作时段。 运维诊断工具内置在网关Web页面：Modbus报文监视器、状态机实时状态展示、PID输出曲线、联锁条件实时判断面板，运维人员可以直接查看当前触发联锁的信号来源，快速定位是传感器误报还是逻辑问题。 设备维护台账绑定平台：一体机滤芯更换、传感器计量校准、设备维保记录录入系统，设置到期预警；净化一体机故障上报之后，平台自动推送故障码、故障说明、初步排查指引给运维人员。

版本迭代规划：V1.0完成恒温恒湿闭环+消毒联锁基础功能；V1.1增加多台净化机组协同调度（大面积多机组库房）；V1.2接入VOC、二氧化碳传感器，联动新风净化，拓展库房空气品质联动策略。

九、开发总结

本次信创档案室监控系统联动开发，核心思路是把环境闭环、安全联锁下沉边缘，平台轻量化作为配置审计载体，依托状态机实现恒温恒湿PID调节与消毒流程的可靠管控，解决传统平台直控模式单点故障失控、多动作逻辑冲突、消毒安全风险高的痛点。驱动抽象层的设计，实现了净化一体机设备型号无关化，降低后续设备替换、扩容开发工作量；整套系统全链路适配国产软硬件底座，配套国密加密、三员审计机制，同时满足档案行业规范、等保三级、信创项目验收多重合规要求。

在档案库房环境调控场景中，恒温恒湿和消毒净化联动不是简单的“达到阈值就开机”，需要充分考虑库房大滞后特性、设备互斥保护、人员安全联锁、审计留痕等档案行业特有约束，边缘状态机+PID的组合方案，是兼顾稳定性、安全性、合规性的优选实现方案，可在后续新建、改造信创档案室项目复用整套开发框架与驱动模板。

标签：#信创档案监控 #档案室恒温恒湿净化联动 #恒湿消毒净化一体机 #Modbus联动开发 #边缘状态机 #DA/T42-2022 #国密传输 #档案库房PID调控 #三员管理 #智慧档案开发笔记