3. 项目文档完整性核查

在Modicon自动化项目的验收与交付阶段，文档完整性核查往往是最容易被低估、却最容易在后期引发争议的环节。设备能跑、画面能动，并不代表项目可以顺利交付；真正决定交付质量的，是当业主工程师、维护人员或第三方审计人员拿到这套资料时，能否在不依赖原开发者口头解释的情况下，独立完成故障排查、参数恢复、程序修改和备件更换。文档齐套性检查的核心目标，就是确认“交付物是否构成一个自洽、可追溯、可复现的技术包”。

本节讨论的交付文档，通常包括五类核心对象：IO清单、网络拓扑、PLC程序版本、HMI画面、变频器与伺服参数表。它们不是孤立文件，而是彼此引用、相互校验的关系网。例如IO清单中的模块地址必须与PLC硬件组态一致，网络拓扑中的IP地址必须与PLC、HMI、变频器的实际配置一致，HMI画面中的变量地址必须能在PLC变量表中找到对应条目。核查的本质，是沿着这些引用关系逐条验证一致性。

核查工作应当以“实际硬件和实际运行状态”为基准，而不是以某一份文档为基准。很多项目出问题，恰恰是因为拿PLC程序去核对IO清单，结果两份文档都错了，却互相印证为“一致”。正确的做法是：先到现场确认模块型号、槽位、通道接线、网络设备端口连接、变频器面板显示参数，再回到文档中逐项比对。图中用实线表示文档对基准的归属关系，用红色虚线表示文档之间的交叉校验关系，这两类关系构成了核查的完整路径。

IO清单核查：从物理通道到逻辑地址

IO清单的核查不能只看“有没有这份表”，而要确认表内信息是否足以支撑维护。一份可用的IO清单至少应包含：模块型号与订货号、机架/槽位编号、通道地址（如%I0.0、%IW100）、信号类型（DI/DO/AI/AO）、量程或信号范围（如4-20mA对应0-100℃）、接线端子号、以及对应的现场设备位号。核查时，选取不少于10%的通道进行现场抽查，重点核对模拟量通道的量程设置与PLC程序中的缩放指令是否匹配。

例如，某压力变送器量程为0-1.6MPa，输出4-20mA，接入AI模块后PLC程序中缩放公式为：

工程值 = (原始值 - 6400) / (32000 - 6400) * 1.6
// 其中6400对应4mA，32000对应20mA，1.6为量程上限(MPa)

如果IO清单中标注的量程是0-1.0MPa，而程序按1.6MPa缩放，现场显示就会偏差60%。这类问题在验收阶段若不通过文档核查发现，投产后会直接导致工艺参数误判。

网络拓扑与参数表的联合核查

网络拓扑图应标注每个节点的IP地址、子网掩码、网关、设备名称、交换机端口号以及通信协议。核查时，将拓扑图与PLC硬件组态中的以太网端口配置、HMI的IP设置、变频器通信卡参数逐一对照。对于Modbus TCP或EtherNet/IP网络，还需核对从站节点地址与参数表中的通信地址是否一致。

变频器与伺服参数表的核查重点在于“可恢复性”。参数表不应只记录修改过的参数，而应记录所有非出厂默认值的参数，并标注出厂值、当前设定值和修改原因。核查时，随机选取3-5台设备，通过操作面板或调试软件读取实际参数，与参数表比对。若发现参数表缺失关键参数（如电机铭牌参数、编码器分辨率、限位设置），应要求补充完整后方可进入交付流程。

PLC程序版本与HMI画面的追溯性

PLC程序版本核查需要确认三件事：工程文件版本号与现场运行程序一致、程序注释完整可读、变量表与IO清单及HMI变量绑定一致。建议在程序属性中填写版本号、修改日期和修改人，并保留至少一个与现场运行版本完全一致的备份文件。HMI画面核查则关注画面层级是否清晰、报警记录是否可导出、用户权限是否合理分配、以及画面变量是否全部能在PLC变量表中找到对应条目。

齐套性检查表与判定标准

为便于执行，可将核查结果整理为如下检查表。每项检查均需给出“符合/不符合/不适用”的明确结论，不符合项需注明具体位置和整改要求。

核查完成后，应形成一份《文档完整性核查记录》，逐项记录核查结论、不符合项描述、整改责任人和整改期限。只有当所有不符合项关闭并复验通过后，才能进入最终交付确认环节。文档齐套性不是“有就行”，而是“对得上、看得懂、能恢复”，这三条标准应贯穿核查全过程。