3. CV-X软件环境搭建

CV-X 系列智能视觉检测系统的软件环境搭建，是后续所有相机配置、检测逻辑编写与现场调试的前提。它并不是“装一个软件”这么简单，而是由 CV-X 软件安装 → 授权（License）管理 → 项目创建 → 界面导航与工程结构理解 四个环节构成的完整链路。任何一个环节出错，都会在后续出现“相机连不上”“功能灰显”“无法保存工程”等典型故障。本节按实际工程顺序展开，并给出可复现的操作要点与判断依据。

一、软件安装：先分清三个组件

CV-X 的软件环境通常涉及三类组件，安装顺序与作用不同：

• CV-X 主程序（CV-X Series Configuration / 控制器设置软件）：用于相机参数、检测流程、判定逻辑的配置与下载，是核心工作平台。
• 通信与驱动组件：包括以太网通信、USB 驱动、以及用于与 PLC/上位机通信的接口库（如 Ethernet/IP、PROFINET、TCP/IP 通信模块）。
• 辅助工具：如相机固件升级工具、图像保存/回放工具、仿真器（离线模拟运行，无需连接实物相机）。

安装前建议先确认三件事：操作系统版本（CV-X 软件对 Windows 版本有明确支持范围，通常为 Windows 10/11 专业版 64 位）、管理员权限、以及是否已安装旧版本（旧版本残留会导致驱动冲突）。安装时建议关闭杀毒软件与防火墙的实时拦截，否则 USB 驱动或通信服务可能被拦截而安装不完整。

安装完成后，判断是否成功的最直接依据不是“桌面出现图标”，而是：打开主程序后能正常进入工程界面、设备管理器中能看到相机对应的网络/USB 设备、且通信测试能返回响应。若主程序能打开但设备列表为空，问题通常出在驱动或网络配置，而非主程序本身。

二、授权管理：License 决定功能边界

CV-X 软件的授权方式常见为加密狗（USB Dongle）或软授权（License 文件 / 激活码）。授权不是“能不能用”的开关，而是决定可用功能范围与相机数量的关键。例如：基础授权可能只允许连接 1 台相机、使用基础检测工具；扩展授权才开放多相机同步、高级测量工具或仿真功能。

授权管理的典型操作包括：插入加密狗后由软件自动识别；或导入 License 文件并在授权管理界面中查看授权状态。判断授权是否生效，应查看授权界面中的授权类型、有效期、可用相机数、已启用功能模块，而不是仅看软件能否启动。若出现“功能灰显”“提示未授权”，优先检查加密狗是否被识别、License 是否与当前软件版本匹配、以及是否被其他程序占用。

三、项目创建：工程结构与命名规范

CV-X 中的“项目”是检测逻辑、相机参数、判定阈值、通信配置的集合。创建项目时，软件通常会要求选择项目类型/模板（如新建空白工程、从模板创建、或从已有工程复制），并指定保存路径。工程文件一般包含主工程文件与关联的资源文件（图像、标定数据、日志），因此不要把工程保存在桌面或临时目录，应放在固定工程盘符下，并避免中文路径与过深目录。

命名建议采用“产线-工位-功能-版本”的结构，例如 L3_Station2_SealCheck_v1.0。这样在多工位、多版本并行时不会混淆。创建后应先做一次“空工程保存与重新打开”验证，确认工程可正常读写，再开始配置相机。

四、界面导航：四个核心区域

CV-X 主界面通常可划分为四个功能区，理解它们的分工比记住按钮位置更重要：

• 设备/相机树：管理已连接的相机、控制器与通信节点，是“对象入口”。
• 图像显示区：实时画面与冻结画面，用于观察检测区域、光照与工件位置。
• 工具/参数面板：添加检测工具（如边缘、斑点、图案匹配）、设置阈值与判定条件。
• 结果与日志区：显示 OK/NG 判定、测量值、通信收发记录，是调试与排障的主要依据。

导航的基本逻辑是：先在设备树中选中对象 → 在图像区确认视野 → 在工具面板中添加并配置检测项 → 在结果区观察判定输出。若结果区没有数据刷新，应先检查相机是否处于在线状态、触发方式是否正确，而不是反复修改检测参数。

五、常见问题与判断依据

环境搭建阶段的高频问题集中在三类：安装不完整（驱动缺失、通信服务未启动）、授权异常（加密狗未识别、License 版本不匹配）、连接与触发配置错误（IP 不在同一网段、触发源选择错误）。判断时建议按“先看设备是否在线 → 再看授权是否生效 → 最后看触发与结果是否刷新”的顺序排查，避免一上来就修改检测参数。

完成本节四个环节后，应达到的状态是：主程序可正常启动、授权界面显示有效授权、工程可创建并保存、设备树中相机在线、图像区有画面、结果区能随触发刷新判定。满足这些条件，才具备进入下一阶段相机标定与检测工具配置的基础。