4. CV-X软件环境与项目创建

CV-X 系列（如 CV-X100/CV-X200 控制器）的工程化使用，第一步不是写检测逻辑，而是把“软件环境—设备连接—图像采集—工程文件”这条基础链路搭稳。很多现场问题（图像忽明忽暗、触发丢帧、换线后参数全乱）并非算法问题，而是工程创建与采集参数没有规范化。本节按实际调试顺序，讲清从零建立工程到文件管理的关键操作与判断依据。

一、软件环境与工程的基本构成

CV-X 的配置通过 PC 端 CV-X 系列设定软件（如 CV-X100 对应的设定工具）完成，控制器与相机、光源、I/O 构成一个独立系统。一个“工程”在软件中对应一组完整的检测配置，通常包含：相机与图像输入设置、检测工具（如边缘、斑点、读码、OCR）参数、判定阈值与输出分配、以及系统级设置（触发、存储、通信）。工程以文件形式保存在控制器内部，并可导出到 CF 卡或通过网口备份到 PC。

建立工程前先确认三件事：控制器型号与软件版本匹配；相机分辨率与镜头视野满足被测物最小特征（读码场景要保证码元在图像中占足够像素）；通信方式（以太网、RS-232C、PLC 并行 I/O）已确定。这些决定了后续参数的可选范围。

二、设备连接与通信确认

典型连接顺序是：相机接控制器 CAMERA 口（多相机时注意通道编号）→ 光源接光源输出口 → 控制器 LAN 口接 PC 或交换机 → 触发信号接 I/O 或由内部触发产生。上电后先在软件中执行“控制器搜索/连接”，确认能识别到控制器 IP 与相机通道。

通信确认的实用判断：在软件“系统设置—通信”中查看连接状态；用一条测试触发观察是否每次都能取到新图像。若连接成功但取像失败，优先检查触发源选择（内部/外部）、触发极性与相机通道是否与接线一致。示例：使用外部光电传感器触发时，若传感器为 NPN 常开，需在 I/O 设置中把对应输入设为下降沿有效，否则会出现“有信号但不取像”。

三、图像采集参数设置

采集参数直接决定后续检测的稳定性，核心包括：

• 曝光时间：决定亮度与运动模糊。产线运动读码时，曝光过长会拖影导致码无法识别，应结合线速度估算。示例：被测物移动速度约 300 mm/s，允许模糊量按 0.1 mm 计，则曝光时间应控制在约 0.1/300 ≈ 0.33 ms 量级，实际需留余量并配合光源亮度调整。
• 增益：提高亮度但引入噪声，优先加光源、后加增益。
• 触发模式：内部自由运行适合调试；外部触发适合与产线同步。
• 光源控制：亮度、频闪与相机曝光同步，频闪可提升瞬间亮度并减少发热。
• 白平衡/彩色处理：读码与尺寸检测通常用黑白，减少处理量。

调整方法：先固定增益为低值，调曝光使背景灰度落在中段（例如 8 位图像约 100～150），再让码/特征与背景形成足够对比。判断依据不是“看起来清楚”，而是看灰度直方图是否分离、边缘是否锐利。若直方图两端堆积（过曝或欠曝），说明曝光或光源需要重调。

四、工程创建与保存的规范做法

建议按“新建工程→命名→设置相机与触发→调采集→建检测工具→设判定与输出→保存并备份”的顺序推进。命名要能体现产线、机型与版本，例如 L3_A机型_读码_v1.2_20240610，避免使用“新建工程1”这类无法追溯的名称。

保存分三层：控制器内部保存（现场运行用）、CF 卡/U 盘导出（换线与应急）、PC 归档（版本管理）。每次修改参数前先导出当前版本，修改后再另存新版本号，形成可回退的版本链。若现场出现“昨天还好、今天判定全 NG”，第一动作应是比对当前工程与备份工程的参数差异，而不是直接重调算法。

五、可直接使用的工程创建检查表

把上述链路走通后，后续的读码工具、OCR、尺寸测量才有稳定的输入基础。工程文件管理的意义在于：当产线换型或参数被误改时，你能在几分钟内恢复到已验证的可用状态，而不是从零重调。