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

24 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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或机器人操作。