Files
VisionGuide/source/SSP_INTEGRATION.md
T
lidg 07632e7de1 feat(camera): 启动自动初始化并在测量前重试失败的初始化
- 程序启动后自动连接左右相机、应用参数并完成一次白平衡
- 测量请求到达时若相机未初始化成功,再初始化一次
- 重试成功继续同一测量请求,失败返回 INITIALIZATION 和 robot_valid=false
- 初始化期间允许一个待处理测量请求,并支持取消
- IPC 状态增加 initialization_in_progress
- 手动白平衡先失效初始化缓存并同步更新就绪状态
- 将带宽设置收口到 CameraManager,更新接入文档

验证:MSVC x64编译通过;启动重试8、IPC9、白平衡6、抓取7项测试通过
2026-10-28 15:19:11 +08:00

3.8 KiB
Raw Blame History

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或机器人操作。