# ssp 独立进程接入 使用本目录 `VisionGuide.pro` 构建;不需要导出算法 DLL。ssp 保留原 MinGW 工程,此程序使用 Qt 5.14.1 MSVC x64 kit,运行目录必须保留部署脚本生成的 DLL、`visionguide.package.json`、`qt.conf` 和原项目资源目录。 启动参数:`VisionGuide.exe --ipc-name ssp_visionguide_v1 --background`。不带 `--background` 时显示原窗口;不带 `--ipc-name` 时不启动 IPC。程序启动后自动执行左右相机连接、参数应用及一次白平衡;失败保持程序运行。收到测量请求时相机尚未初始化成功则再初始化一次,成功继续同一请求,失败返回 INITIALIZATION 错误和 robot_valid=false。显式 initialize 仍用于维护。 初始化期间状态包含 initialization_in_progress=true;IPC 可接收一个待处理测量,其他请求仍受资源互斥约束。客户端允许未就绪状态发送测量,总超时需覆盖启动初始化、一次重试及测量。ssp 在视觉失败后写 M852=0 并继续普通 RackPick;视觉成功时确认 R60 写入后写 M852=1。VisionGuide 不操作 PLC。 协议对应 ssp 的 `docs/visionguide-ipc-protocol.md`:同用户 QLocalSocket,4字节大端长度和 UTF-8 JSON,协议版本1。通信在独立线程执行;相机/界面仍沿用原线程边界。控制端连接期间手动界面只供查看,OPC、标定和参数修改不能抢占;需断开控制端后进行手动配置。 初始化沿用 CameraPanel 当前曝光、增益和带宽值,两台相机分别连接、应用参数、提交一次白平衡、获取新帧并检查 BalanceWhiteAuto=Off。成功的同一连接代次不重复初始化。相机错误或断开使该路初始化失效。白平衡不完成时返回失败,不用命令提交成功冒充完成。 2026-10-28 修复:手动再次执行白平衡时,先失效该路初始化状态并通知 IPC 更新就绪信息,再提交 Once。重复执行仍允许;命令失败也不能复用先前的完成状态。重新接回 ssp 后执行初始化,待确认完成后恢复生产就绪。`tests/vision_camera` 使用实际 CameraPanel 和相机管理器替身验证状态流转,不访问真实相机。 测量复用新测量页:读取指定料盘配置,冻结输入机器人位姿、标定、示教及高度策略,然后显式采用左相机、高精细化、5秒、0.70/0.80、中心选择、模型原点显示和4.40mm偏移。返回相机原点与左路抓取XYZABC两组数值;原点显示不会取消抓取偏移。取消或截止后算子仍在运行时保持 busy,迟到成功不会发布。旧分步位姿/调试和双目数据采集在整个操作期间保持资源占用,即使原进度界面处理嵌套事件,IPC初始化、测量和退出也会拒绝抢占。 测试工程: - `tests/vision_ipc/vision_ipc.pro`:不加载相机SDK的真实本机socket测试,验证分包/粘包、会话、去重、取消、断线、busy、单客户端及非法帧。 - `tests/vision_grasp/vision_grasp.pro`:复用实际抓取实现的无相机测试,验证已知几何、R40快照、偏移一次、部分成功和迟到结果拒绝。测试产物同样名为 VisionGuide.exe,位于独立测试构建目录,不用于生产。 - `tests/vision_camera/vision_startup.pro`:实际 MainWindow/CameraPanel 配合相机管理器替身,验证启动初始化、失败重试一次、继续原请求、失败返回、初始化期间等待及取消。使用独立 build-ssp-startup-test,产物同样名为 VisionGuide.exe,仅供测试,禁止部署为生产程序。 2026-10-27 本机验证使用 Qt 5.14.1 msvc2017_64 库和已安装 VS2022 v143 14.44 编译器;本机未安装 v141,故尚未实测 MSVC2017 编译器。实际左右相机白平衡、同图识别一致性和机器人握手仍需现场验收。没有执行真实相机、PLC或机器人操作。