3. ctrlX WORKS工程环境搭建
ctrlX WORKS 是博世力士乐 ctrlX AUTOMATION 平台的工程中枢，它把控制器、驱动、I/O 与应用的配置、编程、调试和版本管理集中到一个基于 Eclipse 的桌面环境中。理解这一节的关键，不是记住菜单在哪，而是建立一条从“装好工具”到“连上设备、建好工程、管好固件、看清状态、纳入版本控制”的完整链路。下面按实际工程顺序展开，并给出可参考的示例参数。
安装与首次配置
ctrlX WORKS 以安装包形式分发，Windows 与 Linux 均有对应版本。安装前先确认系统满足最低要求：建议 16 GB 内存、SSD 剩余空间 20 GB 以上、屏幕分辨率不低于 1920×1080，并预留一个可用的以太网口用于连接 ctrlX CORE。安装过程中会提示选择工作区（Workspace）目录，建议单独放在非系统盘，例如 D:\ctrlX_Workspaces\demo_line，便于后续备份和版本管理。
首次启动后需要做三件配置。第一，设置网络接口：在“首选项 → 网络”中指定用于设备扫描的网卡，避免多网卡环境下扫描到无关网段。第二，配置设备发现协议：ctrlX CORE 默认通过 mDNS/DNS-SD 广播，若企业网络屏蔽组播，可改用固定 IP 直连。第三，设置默认固件仓库路径，用于存放下载的 .raucb 固件包。示例中我们把控制器网口设为 192.168.10.10/24，工程主机设为 192.168.10.100/24，两者处于同一子网。
设备扫描与连接
设备扫描是建立在线关系的第一步。在“设备”视图中点击“扫描”，ctrlX WORKS 会向指定网段发送发现请求，返回结果通常包含设备名称、型号（如 ctrlX CORE X3、X5、X7）、IP 地址、固件版本和序列号。若扫描不到，按以下顺序排查：网线是否插在控制器的 XF10 调试口或 XF20 工程口、主机防火墙是否放行 mDNS、控制器是否已完成上电自检（状态灯由红转绿）。
扫描到设备后，双击即可建立在线连接。首次连接会要求输入控制器凭据，默认管理员账户为 boschrexroth，首次登录强制修改密码。连接成功后，设备图标会显示绿色在线标记，此时才能进行固件升级、应用部署和在线诊断。
项目创建与设备模板
在 ctrlX WORKS 中新建工程时，推荐使用“ctrlX 工程”模板，而不是空工程。模板会自动生成设备节点、应用容器和默认通信配置。创建时需指定目标设备型号，例如 ctrlX CORE X3，并选择是否启用 PLC、运动控制或 IoT 应用。示例工程命名为 DemoLine_Conveyor，用于一条输送线控制。
工程创建后，目录结构通常包含：Device（设备描述）、PLC（IEC 61131-3 程序）、Motion（轴配置）、App（容器化应用）和 Config（网络与安全配置）。建议在首次创建后立即执行一次“构建”，确认工具链完整，再开始写逻辑。
固件管理
ctrlX CORE 的固件以 RAUC 包（.raucb）形式发布，支持 A/B 分区升级和回滚。在 ctrlX WORKS 的“固件管理”视图中，可以查看当前版本、可用版本和升级历史。升级前务必确认：目标版本与硬件型号匹配、升级期间不断电、已备份当前工程和配置。
示例操作：当前固件 1.20.0，目标 1.22.0。导入 ctrlX_CORE_X3_1.22.0.raucb 后点击“升级”，控制器会写入备用分区并重启。重启后若新版本异常，可在启动阶段选择回滚到 1.20.0。升级完成后，用“设备信息”核对版本号，并检查应用是否自动恢复。
在线诊断
在线诊断是验证工程是否真正生效的手段。ctrlX WORKS 提供日志查看器、变量监控表和状态面板。日志查看器可按级别（Info/Warning/Error）过滤，变量监控表可实时读写 PLC 变量。示例中监控输送线启动信号 Conveyor_Start 和速度设定 Speed_Set，若启动后速度反馈 Speed_Act 长时间为 0，则检查轴使能和驱动报警。
诊断时建议遵循“先状态、后日志、再变量”的顺序：先看设备是否在线、应用是否运行，再看日志中是否有错误码，最后用变量监控定位具体逻辑。这样能避免在无关变量上浪费时间。
版本控制基础
ctrlX WORKS 工程本质上是文本与二进制混合的目录，适合用 Git 管理。建议在工程根目录初始化仓库，并添加 .gitignore 排除编译输出和临时文件。示例命令如下：
cd D:\ctrlX_Workspaces\demo_line\DemoLine_Conveyor
git init
git add .
git commit -m "初始工程：输送线控制模板"
git branch feature/conveyor-speed
提交时注意：工程文件（.project、.plc、.xml）应纳入版本控制；固件包体积大，建议单独存放并记录版本号，不直接提交到 Git。每次固件升级或逻辑变更后，提交一次并写清变更说明，便于回溯。