3. 项目文档体系梳理

在WAGO自动化项目的验收交付阶段，文档体系不是“附带材料”，而是与程序、画面同等重要的交付物。验收方往往先通过文档判断系统是否可维护、可追溯、可扩展，再决定是否签署验收单。一个结构清晰的文档体系，通常围绕五类核心文件展开：硬件清单、接线图、I/O分配表、网络配置表、版本记录。它们之间不是孤立存在的，而是互为索引：硬件清单告诉你“有什么”，接线图告诉你“怎么接”，I/O分配表告诉你“信号对应哪个点”，网络配置表告诉你“设备之间怎么通信”，版本记录告诉你“当前交付的是哪一版”。

一、硬件清单：从BOM到可核对台账

硬件清单的本质是项目BOM（物料清单）的交付版。它不应只罗列型号，而应包含位号、名称、型号、数量、安装位置、备注六个基本字段。以某WAGO 750系列项目为例，典型条目如下：

整理时建议以“位号”为主键，与接线图、I/O分配表保持同一套编号。位号一旦确定，不要在后期随意更改；若必须变更，应在版本记录中注明“位号变更”及影响范围。硬件清单的核对方法很简单：现场逐一点数，核对型号与固件版本，并在备注栏记录实际到货批次。对于WAGO模块，固件版本尤其重要，因为不同固件对某些功能块的支持存在差异。

二、接线图：端子号与线号的对应关系

接线图是验收时最容易产生争议的文件。WAGO系统的接线图通常包括电源分配图、模块端子接线图、外部设备接线图三类。绘制时不必追求“美术效果”，但必须保证三个信息完整：线号、端子号、信号方向。例如，数字量输入模块750-430的端子1为DI1，端子2为DI2，公共端为端子3/4（24VDC 0V）。外部按钮的常开触点一端接DI1，另一端接24VDC 0V，则线号可编为“X1:1—SB1:13—24V0V”。

整理接线图时，建议采用“一页一模块”或“一页一设备”的方式，避免一张图塞入过多信息。对于模拟量信号，必须标注信号类型、量程、屏蔽层接地方式。例如4-20mA压力变送器接入750-455，应在图中注明“屏蔽层单端接地于柜内PE排”。验收时，接线图应与实际接线逐点核对，重点检查线号是否清晰、端子是否紧固、屏蔽层是否按要求处理。

三、I/O分配表：程序与现场的桥梁

I/O分配表是程序变量与物理点位的映射表，也是调试和排障时使用频率最高的文档。它至少应包含：点位地址、信号名称、信号类型、模块位号、端子号、量程/状态说明、程序变量名。以下为示例片段：

点位地址   信号名称        类型    模块位号  端子号   说明              程序变量
%IX0.0     启动按钮         DI      -A2:1    1       常开，24VDC       bStartPB
%IX0.1     停止按钮         DI      -A2:1    2       常闭，24VDC       bStopPB
%QX0.0     主接触器         DO      -A3:1    1       24VDC/0.5A        bMainKM
%IW0       压力变送器       AI      -A4:1    1       4-20mA，0-1.6MPa  rPressure

整理I/O分配表的关键是“地址连续、命名规范、说明完整”。WAGO 750系列的数字量输入通常从%IX0.0开始按字节排列，模拟量输入从%IW0开始按字排列。若项目中使用了多个模块，建议在表中增加“模块顺序”列，标明模块在DIN轨上的物理顺序，便于现场对照。验收时，可随机抽取10%的点位进行强制输出或短接测试，确认I/O分配表与实际响应一致。

四、网络配置表：IP、协议与端口

WAGO PFC200通常具备两个以太网口，支持Modbus TCP、EtherNet/IP、PROFINET等协议。网络配置表应记录设备名称、IP地址、子网掩码、网关、协议、端口、站号/设备ID。例如：

整理网络配置表时，建议同时记录交换机端口分配和网线标签。验收时，使用ping命令逐台测试连通性，并用Modbus Poll等工具读取从站寄存器，确认端口和站号无误。若项目涉及跨网段通信，还需在表中注明路由规则或网关地址。

五、版本记录：让交付物可追溯

版本记录是文档体系的“时间轴”。它不需要复杂，但必须包含版本号、日期、修改人、修改内容、影响范围。例如：

版本   日期        修改人   修改内容                        影响范围
V1.0   2024-03-01  张工     初始交付                        全部文档
V1.1   2024-03-05  张工     修正750-455量程为0-1.6MPa      I/O分配表、接线图
V1.2   2024-03-10  李工     增加变频器Modbus站号说明        网络配置表

版本记录应与程序版本、HMI画面版本保持同步。建议在项目文件夹中建立“版本记录”单独文件，每次修改后立即更新，不要等到验收前集中补写。验收时，验收方通常会核对“当前运行程序版本”与“版本记录中最新版本”是否一致，若不一致，需要说明原因并补充记录。

六、整理方法与验收核对要点

五类文档整理时，建议遵循“先定编号、再填内容、最后交叉核对”的顺序。具体做法是：第一步，确定位号规则（如-A1、-A2）和线号规则（如X1:1、X1:2），并写入版本记录；第二步，按硬件清单→接线图→I/O分配表→网络配置表的顺序逐项填写，每填完一类，立即与现场核对；第三步，在验收前做一次“交叉索引检查”，即随机抽取一个位号，检查它在五类文档中是否都能找到对应记录，且信息一致。

最后，文档交付前应统一转换为PDF格式，避免因软件版本差异导致格式错乱。PDF文件按“硬件清单、接线图、I/O分配表、网络配置表、版本记录”分文件夹存放，并附一份“文档总目录”说明各文件的位置和版本。验收时，将总目录与版本记录一并提交，验收方即可快速了解整个文档体系的结构和当前状态。