📚 课程目录第4章基线建立与首次归档

4. 基线建立与首次归档

在三菱iQ-F系列PLC的工程管理中，基线（Baseline）是指经过确认、可追溯、可作为后续变更参照的工程状态快照。它不是一个单独的文件，而是一组相互关联的工程资产集合：工程文件本体、程序清单、参数快照、硬件配置记录以及归档目录结构。首次基线建立的意义在于，当后续出现程序修改、参数调整或硬件更换时，工程师能够明确回答“改了什么、从哪个版本开始改、改前是什么状态”这三个问题。

一、基线应包含的五类资产

iQ-F工程的基线不是简单复制一个GX Works3工程文件夹。一个可用的基线至少应覆盖以下五类内容：

工程备份：GX Works3工程的完整副本，包含程序、参数、软元件注释、标签等。建议同时保留原始工程目录和压缩包两种形式，压缩包用于长期归档，原始目录用于快速恢复。
程序清单：按程序块（如MAIN、子程序、中断程序）列出块名、语言类型（梯形图/ST/FBD）、步数或指令数、最后修改时间。程序清单是判断“程序规模是否变化”的直接依据。
参数快照：PLC参数、模块参数、以太网参数、定位参数等关键设置的导出记录。iQ-F的参数分散在多个设置界面中，仅靠工程文件难以快速比对，建议以截图或参数导出文件形式固化。
硬件配置记录：CPU型号（如FX5U-32MT/ES）、扩展模块型号与顺序、扩展板型号、连接的特殊适配器，以及各模块的站号或起始I/O编号。
归档目录结构：统一的目录命名和层级，使不同人员、不同时间建立的基线能够被快速定位和比对。

这五类资产之间存在明确的对应关系：工程备份是“整体”，程序清单和参数快照是“局部索引”，硬件配置记录是“物理基础”，归档目录结构是“存放规则”。缺少任何一类，基线的可追溯性都会下降。

二、首次基线的建立流程

首次基线建立应在设备出厂程序调试完成、现场试运行通过、且甲方或负责人确认当前状态可作为后续变更起点之后进行。具体操作按以下顺序展开。

第一步：确认工程当前状态。在GX Works3中打开工程，执行“编译”操作，确认无错误。检查程序块是否完整、软元件注释是否已填写、标签是否已定义。若存在未使用的测试程序块或临时修改，应在建立基线前清理，避免将调试残留带入基线。

第二步：执行工程备份。使用“工程”菜单中的“另存为”功能，将工程保存为带日期和版本标识的名称，例如 FX5U_LineA_20250610_V1.0.gx3。随后关闭工程，将整个工程文件夹复制到归档位置。注意：GX Works3工程可能引用外部标签文件或注释文件，复制时应确认工程文件夹内文件完整。

第三步：生成程序清单。在GX Works3中打开“程序块”列表，逐块记录块名、语言、步数。也可通过“工程信息”或打印功能导出程序一览。示例记录如下：

程序块清单（示例）
MAIN        梯形图    1240步    最后修改：2025-06-09 16:22
INIT        梯形图     186步    最后修改：2025-06-08 09:10
ALARM       梯形图     342步    最后修改：2025-06-09 11:05
MOTION_CTRL ST         520步    最后修改：2025-06-09 15:40
COMM_ETH    梯形图     268步    最后修改：2025-06-07 14:30

程序清单的作用是：后续若某程序块步数发生明显变化，可快速定位到变更范围。

第四步：固化参数快照。依次打开PLC参数、模块参数、以太网参数、定位参数等设置界面，对每个界面进行截图或使用参数导出功能保存为文件。重点记录：CPU动作模式、通信端口设置、IP地址、子网掩码、默认网关、定位轴参数、高速计数器设置。参数快照应注明导出日期和工程版本。

第五步：记录硬件配置。记录CPU模块型号、扩展模块从左到右的排列顺序、扩展板型号、终端模块是否存在。同时记录各模块的I/O起始地址和站号。硬件配置记录建议以表格形式保存，便于后续更换模块时比对。

第六步：建立归档目录。推荐采用“项目—设备—版本—资产类型”的层级结构。例如：

归档根目录/
└── LineA_FX5U/
    └── V1.0_20250610/
        ├── 01_工程备份/
        │   ├── FX5U_LineA_20250610_V1.0.gx3
        │   └── FX5U_LineA_20250610_V1.0.zip
        ├── 02_程序清单/
        │   └── 程序块清单_V1.0.xlsx
        ├── 03_参数快照/
        │   ├── PLC参数_V1.0.pdf
        │   ├── 以太网参数_V1.0.pdf
        │   └── 定位参数_V1.0.pdf
        ├── 04_硬件配置/
        │   └── 硬件配置记录_V1.0.xlsx
        └── 05_基线说明/
            └── 基线确认单_V1.0.pdf

目录中的版本号与日期应保持一致，避免出现“V1.0”对应多个日期的情况。基线说明文件应记录建立人、确认人、建立日期和基线适用范围。

三、基线确认与后续使用

完成上述五类资产的收集后，应由建立人和确认人共同签署基线确认单。确认单至少包含：工程名称、CPU型号、基线版本号、建立日期、程序块数量、参数快照文件清单、硬件模块清单、归档路径。确认单本身也应放入归档目录的“05_基线说明”中。

基线建立后，后续任何程序修改或参数调整都应以该基线为起点。每次变更完成后，应生成新的版本目录（如V1.1_20250715），并在变更说明中注明相对于V1.0的差异。这样，当现场出现异常时，可以快速回退到最近一个已知稳定的基线版本。

实用提示：首次基线建立时，建议同时保存一份CPU内的实际程序读取结果。GX Works3支持从CPU读取程序并与工程文件比对，若读取结果与工程文件不一致，说明工程文件并非CPU当前运行状态，此时建立的基线将失去参照意义。读取比对应在建立基线前完成。

常见疏漏：仅备份GX Works3工程文件而忽略参数快照和硬件配置记录，是首次基线建立中最常见的问题。iQ-F的以太网参数、定位参数等并不总是随工程文件完整呈现，且硬件模块的物理排列顺序在工程中可能以抽象方式显示。缺少这两类记录，后续更换模块或调整通信参数时将无法准确判断原始状态。

基线建立不是一次性任务，而是版本治理的起点。首次基线越完整，后续变更的可追溯性越强。在实际项目中，建议将基线建立纳入设备验收流程，作为程序交付的必要环节，而不是等到出现问题后再补做。