3. CV-X 软件环境与项目结构
在现场维护 CV-X 系列视觉系统时，很多“故障”其实并不是硬件坏了，而是软件环境、项目文件或参数版本出了问题。例如：换了电脑打开项目后相机不识别、修改了检测参数却忘记保存、现场恢复时把旧版本参数覆盖了新版本、多人调试后不知道哪份程序才是最终版。要快速定位这些问题，必须先理解 CV-X 的软件界面构成、项目文件的组织方式，以及参数保存与版本管理的基本规则。
一、CV-X 软件界面：三个区域决定操作路径
CV-X 的 PC 端软件（如 CV-X 系列对应的设定软件）整体可以理解为三个功能区：设备连接区、项目/程序管理区、参数编辑与监视区。设备连接区负责选择通信方式（以太网、USB 等）并显示在线状态；项目/程序管理区用于打开、新建、另存项目，并管理多个检测程序；参数编辑与监视区则集中了相机图像、检测工具参数、判定阈值和实时结果。
现场诊断时，界面上的几个状态最值得关注：
- 连接状态：显示“在线/离线”。离线时仍可编辑参数，但无法实时取像和写入控制器。
- 当前程序号：CV-X 通常支持多程序切换，切换错程序是“检测结果突然异常”的高频原因。
- 参数修改标记：修改后未保存时，软件一般会有未保存提示或星号标记，这是判断“改了没生效”的第一线索。
- 实时监视画面：用于确认相机取像、触发和判定结果是否与现场一致。
二、项目文件组织：一个项目包含什么
CV-X 的项目并不是单个文件，而是一个以项目为单位的文件夹结构。典型组织如下（不同版本命名可能略有差异，但逻辑一致）：
- 项目根目录：以项目名命名，存放该项目全部配置。
- 程序数据：每个检测程序（Program）对应一组参数，包括相机设置、检测工具、判定条件、输出分配等。
- 系统/通信设置：IP 地址、通信协议、I/O 分配、触发方式等，属于项目级或控制器级配置。
- 图像与日志：部分版本会保存采集图像、NG 图像或运行日志，用于复盘。
理解这一点的意义在于：“程序”和“项目”不是一回事。只备份某个程序，可能丢失通信和系统设置；只备份项目，若现场控制器内程序号与项目不一致，恢复后仍会跑错程序。因此现场维护要同时关注“控制器内当前程序”和“PC 端项目文件”两个层面。
三、参数保存：三个层次必须分清
CV-X 的参数保存常被误解为“点一下保存就完事”，实际上至少涉及三个层次：
- 界面内修改：在软件中调整阈值、ROI、工具参数。此时参数只在软件内存中，未落盘。
- 保存到项目文件：将当前参数写入 PC 端项目，形成可复制、可备份的文件版本。
- 写入控制器：把参数下发到 CV-X 本体，现场运行才真正使用新参数。
现场最常见的错误是：只做了第 1 步或第 2 步，就以为已经生效。判断方法很简单——看控制器当前程序号是否与 PC 端一致，并在实时监视中确认判定结果已按新参数变化。如果结果没变，优先检查是否漏了“写入控制器”。
四、版本管理：现场可执行的命名与回退规则
版本管理不需要复杂工具，关键是形成可回退的副本。推荐命名格式：
项目名_日期_版本号_变更说明
示例：
LINE-A_20240612_v1.0_初始调试
LINE-A_20240618_v1.1_调整定位阈值
LINE-A_20240625_v1.2_新增程序02每次修改前先复制一份当前版本作为回退点，再在副本上修改。这样即使新参数导致误判，也能在几分钟内恢复到上一稳定版本。对于多程序项目，建议在变更说明中注明改的是哪个程序号，避免恢复时覆盖错程序。
五、现场快速核查清单
| 核查项 | 正常状态 | 异常时的常见原因 |
|---|---|---|
| 软件连接状态 | 在线，图像实时刷新 | IP 冲突、网线松动、防火墙拦截 |
| 当前程序号 | 与现场机型/工位一致 | 切换错程序、恢复时未同步 |
| 参数保存标记 | 无未保存提示 | 改完未保存、断电丢失 |
| 控制器参数版本 | 与 PC 端项目一致 | 只保存未写入、写入错程序 |
| 版本备份 | 有日期+版本号副本 | 直接覆盖原文件，无法回退 |
把以上四点——界面状态、项目结构、保存层次、版本命名——固定成现场习惯后，CV-X 的软件类故障排查会明显加快。很多看似“设备不稳定”的问题，最终都能追溯到“程序号不对”或“参数没写入控制器”这两个根因上。