Files
ssp/docs/visionguide-integration-status.md
T

58 lines
6.0 KiB
Markdown
Raw Normal View History

2026-10-27 22:16:55 +08:00
# VisionGuide 独立进程接入交付记录
日期:2026-10-27。已实现软件,未运行真实 PLC、相机或机器人。
## 已实现模块
- ssp–PLC:R40/R60 各六个 REAL、12 个寄存器整组读写;低字在前/高字在前编解码校验;视觉写入无自动重试;区分未发送、确认成功、发送后状态不明。保留原单 REAL API。
- ssp–VisionGuide:异步 QLocalSocket、QProcess、四字节大端长度与 JSON、会话/请求/工件/料盘/代次校验、取消与迟到结果拒绝;单个测量在途。
- VisionGuide:独立线程通信;左右相机参数及一次白平衡初始化;新测量页左相机识别后自动计算抓取;冻结 R40 位姿及料盘参数;原 UI/OPC 与自动流程互斥。
- ssp 生产:只在 RackPick 料架取料中执行视觉子流程。先确认旧握手全低,再发原取料运动命令,收到 851 才读取 R40;有效结果写 R60,写应答确认后才置 854;等 850 及 850/851 复位,再清 ssp 输出,继续原动作反馈。
- 界面及恢复:新增“视觉引导”页显示三组坐标、初始化及流程状态;与生产线程 queued 传值。暂停/停止立即作废旧请求;提交后不确定状态保持人工恢复锁,停止到 Idle 也不能直接开启新订单。恢复按钮要求现场核对,先读 850/851,再清 ssp 输出并重读全部握手;旧坐标不重发。
## 线圈及固定参数
| 线圈 | 含义 | 控制方 |
|---|---|---|
| 850 | 机器人接收结果成功 | PLC/机器人 |
| 851 | 请求拍照,机器人已停稳且 R40 已更新 | PLC/机器人 |
| 852 | 相机拍照比对中 | ssp |
| 853 | 相机数据比对错误 | ssp |
| 854 | 相机比对通过,R60 可用 | ssp |
测量固定:左相机、高精细化、5 秒采图/识别截止、MinScore 0.70、Greediness 0.80、YOLO 中心选择、相机显示模型原点、模型 +Z 抓取偏移 4.40 mm。偏移只在 VisionGuide 应用一次。整体通信和机器人确认使用独立超时。
## 构建和验证
| 项目 | 结果与位置 |
|---|---|
| ssp 全工程(32 位) | Qt 5.14.1 / MinGW 7.3 32 位编译链接成功;`tmp/build-ssp-vision-client/ssp.exe`,日志 `production-build.log` |
| ssp 全工程(64 位,当前保存的 Kit) | Qt 5.14.1 / MinGW 7.3 64 位完整编译链接成功;`tmp/build-ssp-vision-64/ssp.exe`,PE 类型 AMD64;日志 `tmp/build-ssp-vision-64/build.log`。产物旁已复制根目录 `config.ini`,未运行该 exe |
| VisionGuide 全工程 | Qt 5.14.1 msvc2017_64 库 + 本机 VS2022 v143 编译器成功;`E:/QTCode/VisionGuide/VisionGuide_Qt/source/build-ssp-integration/bin/VisionGuide.exe`。本机未验证 VS2017 v141 编译器 |
| PLC 测试 | `tests/vision_plc`,11 passed;`tmp/vision_plc_build/final-results.txt` |
| ssp IPC 测试 | `tests/vision_ipc`,11 passed;`tmp/build-vision-ipc/test-results.txt` |
| 生产流程测试 | `tests/vision_production`,28 passed、0 failed;`tmp/build-vision-production/final-results.txt`;无硬件且无业务数据库连接 |
| 32 位 ssp / 64 位服务通信 | 6 passed;`tmp/build-cross-client/final-results.txt`;真实双端通信代码、假相机业务 |
| VisionGuide IPC | 8 passed;`E:/QTCode/VisionGuide/VisionGuide_Qt/source/build-ssp-ipc-test/results-final.txt` |
| VisionGuide 抓取/资源门控 | 7 passed;`E:/QTCode/VisionGuide/VisionGuide_Qt/source/build-ssp-grasp-test/results-final-ready.txt` |
生产测试包含真实异步 Modbus 管理器与本地 FakePlc,覆盖 R60/854 已排队而暂停槽尚未执行时的发送前门控。内存订单/报警夹具仅用于验证流程,没有做 PostgreSQL 全库回归。相机识别质量、真实白平衡完成和机器人目标消费尚未现场验收。没有通过 GUI 操作 Qt Creator;验证为对应 Qt/MinGW 的 qmake 和 make 构建。用户现有 `ssp.pro.user` 保存的活动 Kit 为 MinGW 64 位,本次保留该文件既有修改,并补齐 32/64 位两套构建验证。
## 配置与使用
1. Qt Creator 4.11.0 继续打开 `ssp.pro`,选择原 Qt 5.14.1 MinGW kit;新增 Qt Network 仍是 Qt 5.14 API。
2. 将根目录 `config.ini` 放到生成的 `ssp.exe` 同目录。当前测试构建目录已复制一份;Creator 使用其他构建目录时也要复制,默认配置读取 exe 同目录。
3. `vision/executablePath` 指向完整 VisionGuide 运行目录中的 exe。当前构建路径可用于开发;部署后按实际路径修改。保留其 `visionguide.package.json`、`qt.conf` 和完整模型/标定资源关系,不能把 MSVC DLL 混入 ssp 的 MinGW 目录。
4. 初次先在视觉页面启动/连接 VisionGuide,执行初始化。调试时“显示窗口”后“断开”可释放自动控制;自动生产期间诊断互斥。启动/初始化按钮会调用实际相机,需在设备测试阶段操作。
5. `enabled=false`、`contractConfirmed=false` 保留,料盘映射不猜测。上线前填写 `[visionTrayMap]`,核对 REAL 字序、单位 mm/deg、world/TOOL1、`Rz(A)Ry(B)Rx(C)` 和12字范围后再开启。多个 ssp 料盘可按现场需要映射到同一视觉配置。
视觉故障后若活动订单的 PLC 步骤仍处于取料/上料等无法明确恢复的状态,人工恢复会保留锁定并提示先终止当前任务、核对机器人后再恢复,不会进入旧的 Loading 空状态或先发 PLC 启动。仅已明确进入现有正面/反面检测步骤时可接回原恢复流程。
VisionGuide 原测量页已有 1–99 料盘配置选择,现场文件目前保存配置 1 和 2;它是标定/法向/示教/高度设置编号,不自动等同 ssp 实物料盘号。本次未修改其用户配置。
## 待现场验收
确认以上坐标约定和料盘映射,读 R40 对照示教器,检查两台初始化与白平衡、固定参数和抓取结果一致,再受控执行 R60 写入及握手。PLC 应保持请求/接收电平供轮询观察;本版没有 PLC 交易序号,未观察到完整握手会进入人工核对,不以旧确认推进。
未自动提交 Git;原 `ssp.pro.user` 和既有单 REAL 修改保留。