3. XG-X软件环境与工程创建
KEYENCE XG-X 系列的视觉引导工程并不是在单一窗口里“画完就算”，而是围绕一个可保存、可复用、可在线调试的工程文件展开。理解 XG-X Navigator 与 XG-X Studio 的分工、工程文件的目录结构，以及相机连接与在线调试的基本流程，是后续标定、机器人通信和引导程序开发的前提。本节以 XG-X 系列常用的 XG-X Navigator 与 XG-X Studio 环境为例，说明从软件启动到工程落地、再到相机在线确认的完整路径。
一、Navigator 与 Studio 的分工
XG-X 的软件环境通常由两个协同工作的部分构成。XG-X Navigator 更偏向“设备与工程管理”：它负责发现网络中的 XG-X 控制器、建立与相机的连接、管理工程文件的打开与保存、查看控制器状态，并启动 XG-X Studio 进行具体视觉程序的编辑。XG-X Studio 则是“视觉程序开发环境”：在这里布置相机图像、添加检测单元、设置参数、运行流程、观察结果，并最终把程序下载到控制器中运行。
可以把两者理解为“工程入口”和“程序车间”的关系。Navigator 解决的是“连哪台设备、打开哪个工程、当前是否在线”；Studio 解决的是“这个工程里有哪些相机、每个相机执行什么检测、参数是多少、结果如何输出”。实际工程中，常见做法是先在 Navigator 中确认控制器与相机在线，再进入 Studio 编辑流程，最后回到 Navigator 或在线界面确认运行状态。
二、工程文件结构：一个工程包含什么
XG-X 的工程文件不是单个文件，而是一个以工程名命名的文件夹结构。典型工程目录中会包含：工程配置文件、各相机的程序文件、图像与标定数据、日志与备份文件等。理解这些内容的归属，有助于在复制工程、备份参数或排查“换了电脑打不开”的问题时快速定位。
工程配置主要记录控制器型号、相机数量、通信方式、触发设置等全局信息；相机程序则保存每台相机的检测流程、单元参数、ROI 区域和输出结果定义；标定数据保存相机与机器人之间的坐标变换关系，是视觉引导能否准确落地的关键；图像与日志用于回放和追溯。实际工程中，建议把“可复用的工程模板”和“现场标定数据”分开管理，避免把某台设备的标定结果误用到另一台设备上。
三、相机连接与在线调试基本流程
相机连接的第一步是物理与网络确认。XG-X 控制器通常通过以太网口与 PC 或交换机连接，相机则通过专用线缆接入控制器。上电后，在 Navigator 中执行设备搜索，若控制器出现在列表中，说明网络层已通；若搜索不到，优先检查 PC 的 IP 是否与控制器处于同一网段、网线是否插在正确的端口、防火墙是否拦截了搜索广播。
搜索到控制器后，双击进入或选择“打开工程”。此时 Navigator 会读取控制器内已有的工程列表，也可以选择本地工程文件打开。若工程中已配置相机，Navigator 会显示相机数量与在线状态。在线调试的核心动作是“取像确认”：在 Studio 中选中某台相机，执行一次实时取像或触发取像，观察图像是否正常、亮度是否合适、工件是否完整落在视野内。若图像全黑或全白，先检查镜头盖、光源、曝光时间和触发模式，而不是急于改检测参数。
取像正常后，再进入检测单元的参数调整。以常见的“位置检测”为例，先框选 ROI 区域，再设置边缘阈值或模板匹配的相似度阈值。调整时建议每次只改一个参数，并观察结果数值的变化。例如模板匹配相似度从 0.70 提高到 0.85 后，若原本能稳定找到的工件开始出现“未找到”，说明阈值过高或模板本身包含了易变化的背景区域，应重新截取模板或降低阈值。在线调试的价值就在于这种“改一下、看一眼”的即时反馈。
参数确认后，需要把工程保存并下载到控制器。注意区分“保存到本地”和“下载到控制器”：前者只是把工程文件写到 PC 磁盘，后者才会让控制器按新参数运行。下载完成后，建议在 Navigator 或在线界面中手动触发一次，确认控制器返回的结果与 Studio 中看到的一致。若使用机器人通信，还应检查输出结果的数据格式、坐标单位和触发时序是否与机器人侧约定一致。
四、工程创建中的常见问题与判断依据
工程创建阶段最常见的问题有三类。第一类是“连不上”：Navigator 搜索不到控制器，或能搜索到但无法打开工程。判断依据是看控制器面板的链路指示灯与 PC 的 ping 结果，先排除物理层和网段问题。第二类是“取不到像”：相机在线但图像窗口无画面。此时应检查触发源设置——若工程配置为外部触发，而当前没有触发信号，实时窗口自然不会刷新；可临时切换为连续取像确认相机本身是否正常。第三类是“结果不稳定”：同一工件多次触发，检测结果时有时无。这通常与光照变化、ROI 过大、阈值过紧有关，应回到取像与参数层面逐项排查，而不是反复下载工程。
从工程管理角度看，建议在项目初期就建立清晰的命名与备份习惯。例如按“项目名_相机编号_功能”命名工程，每次重大参数变更前复制一份备份，标定数据单独存放并记录对应的机器人工具坐标。这样在后续多相机扩展或现场复制时，可以快速定位问题，而不必从头重建整个工程。
掌握 Navigator 与 Studio 的分工、工程文件的组成，以及“连接—取像—调参—下载—验证”的在线调试主线，就具备了进入下一阶段标定与引导程序开发的基础环境。后续的坐标变换、机器人通信和精度验证，都将在这一工程框架内展开。