Files
ssp/docs/visionguide-integration-status.md
lidg 407af2892d feat: 重构视觉取料流程及生产故障恢复
- 删除订单启动、暂停、复位相关 PLC 握手及无效反馈配置
- 清除报警改为仅写 clearAlarmCommand,不等待反馈
- 将拍照位移动、视觉处理和 RackPick 拆分为三个独立动作
- 增加 M850/M851 拍照位动作及 R60/M852 视觉结果流程
- 暂停改为等待当前机器人动作完成,视觉结果不确定时转人工确认
- 删除复位按钮,合并为恢复/重试按钮
- 普通 PAUSED 订单通过启动按钮继续
- 恢复前检查 PLC、安全状态、订单及动作命令反馈
- 支持在途动作接管、已完成动作收尾、安全重试和人工确认
- 故障状态保持订单 RUNNING,并持久化实际恢复阶段
- 恢复成功后仅清除本次软件故障对应的报警
- 更新小轴 PLC 地址、Modbus 配置和视觉集成文档
2026-10-29 17:20:14 +08:00

99 lines
13 KiB
Markdown
Raw Permalink 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.
# VisionGuide 独立进程接入交付记录
## 2026-10-29:PLC 配置归属及小轴点表核对
- R40/R60、REAL 字序、M850/M851/M852 的 INI 配置统一移至 `[modbus]`;M851 配置名为 `photoMoveCoilFeedback`,兼容读取旧 `photoArrivedCoil`。`vision/enabled` 仍是识别开关。
- 已明确的七组取放/翻转命令与完成反馈改为 M800–M813;镀金状态为 M814(0=镀前、1=镀后);工位号为保持寄存器 800。点表及代码默认料盘号为 802,但当前用户 `config.ini` 覆盖为 801,本次保留该配置,待现场最终确认。
- M816 是 PLC 提供的运行状态,不替代 ssp 的启动命令,也不直接等同于就绪。另有 25 个 ssp 使用的信号尚未在点表中定义,保留原占位配置,不能据此认定现场点位已齐全。
- 全量对照、表内冲突和连续读取建议见 [PLC 信号核对](plc-signal-audit-2026-10-29.md)。本次不修改 PLC 程序、原始 Excel 或普通状态读取逻辑。
## 2026-10-29:订单控制、独立动作与恢复/重试
- 删除 `startCommand/startFeedback`、`pauseCommand/pauseFeedback`、`resetCommand/resetFeedback` 和 `clearAlarmFeedback`。订单启动、暂停、恢复不再等待 PLC 控制反馈;清报警只把 `clearAlarmCommand` 写为 1,成功后清除 ssp 活动报警。
- M850/M851、视觉处理、M800/M807 分别是 `PHOTO_MOVING`、`VISION_PROCESSING`、`RACK_PICKING` 三个独立动作。M850/M851 完成并清零后才进入视觉;视觉成功写 R60/M852=1,关闭或识别失败写 M852=0;之后才开始 RackPick。
- 暂停不取消正在运行的机器人动作。机器人动作正常完成并清命令/反馈后暂停;视觉尚未提交 R60/M852 时立即作废并暂停,恢复后重新读取 R40;提交状态不确定时转人工确认。
- 原“复位”改为单一“恢复/重试”。它只处理 `Error/TimeoutPaused/ManualConfirm`,先刷新设备状态并读取当前动作命令/反馈:在途动作继续轮询,已完成动作清信号并前进,明确未发送才重试,曾发送但双 0 则保持人工确认。普通 `PAUSED` 订单由“启动”按钮继续。
## 2026-10-28:单实例与启动复用
- VisionGuide 默认开启 `ssp_visionguide_v1` IPC。SDK 初始化及主窗口创建前,以固定用户数据目录下的 QLockFile 保证同用户单实例;重复启动正常退出,不初始化相机。`--ipc-name` 仍可覆盖端点名,但不绕过单实例锁。升级时先关闭不支持该锁的旧版本。
- ssp“启动”先连接现有实例,仅端点不存在或拒绝连接才创建一次子进程;已有服务可在 executablePath 无效时复用。旧连接尚未释放导致 hello 前断开时,在原截止时间内重连,不重复创建进程。初始化、测量和取料协议保持原约定。
- 退出只关闭自身启动且 PID 匹配的服务。发送 shutdown 后保持管道直到进程退出,避免立即关闭导致请求未读;原有 3 秒延迟强杀绑定启动代次,不影响随后启动的新进程。
- 验证:ssp IPC 16 passed、实际入口/SDK替身 5 passed、32位客户端/64位服务端跨进程 9 passed,共 30 passed。ssp 32/64位、VisionGuide Debug/Release 编译及运行库部署通过;未运行真实相机/PLC。设计见 `docs/superpowers/specs/2026-10-28-vision-single-instance-design.md`。测试仍遵循既有 Git 忽略规则,未自动提交。
## 2026-10-28:按最新确认改为拍照到位前置流程
本节是当前执行协议;下方早期记录中的 850–854 五信号握手、视觉必须 ready 才能启动生产、视觉失败即人工锁定均已被本节替代。
- 普通 RackPick 前独立执行:写托盘号/格位 → M850=1 → 等 M851=1 → ssp 清 M850、M851 → 决定是否识别。关闭视觉也执行这个到位流程。
- vision/enabled 只控制识别。成功且 R60 整组写入确认后写 M852=1;关闭、视觉未连接、缺少料盘映射、初始化重试失败、识别失败、无效/超出 float 范围的坐标、视觉超时或断线时不写 R60,记录原因并写 M852=0。M852 写入确认后才启动普通 RackPick。动作结束保持 M852,下次显式覆盖。M853/M854 不再使用。
- PLC 到位超时、握手读写失败、R40 通信失败、R60/M852 写入未确认仍要求人工核对;不得按视觉失败放行。保留暂停、终止、跨重启恢复锁与原子状态文件。恢复不要求视觉就绪,也不清 M852。
- VisionGuide 启动时自动连接左右相机、应用参数及一次白平衡。收到测量请求时相机未初始化成功则再初始化一次,成功继续同一请求,失败返回 INITIALIZATION 错误。初始化期间允许一个待处理测量,重复请求不重复执行。
- ssp 允许向已连接但未就绪的服务发送测量;请求预算为 requestTimeoutMs + 2 × initializeTimeoutMs,包含可能尚未结束的启动初始化和一次重试。采图/识别的 5 秒截止保持不变。
- 新配置为 photoMoveCoil=850、photoMoveCoilFeedback=851、comparisonPickCoil=852;旧五线圈配置和 handshakeProtocol 不再使用。根配置已启用识别,六个实物料盘均映射到 VisionGuide 配置 1。
- 实施说明:docs/superpowers/specs/2026-10-28-photo-position-pick-design.md。测试采用本地 FakePlc、假视觉服务及相机管理器替身,未连接真实设备。
- 本轮验证:ssp 生产流程 47 passed、IPC 14 passed、PLC 11 passed;VisionGuide 启动初始化/重试 8 passed、IPC 9 passed、白平衡状态 6 passed、抓取/资源门控 7 passed,共 102 passed。ssp Qt 5.14.1 MinGW 32/64 位全工程与 VisionGuide Qt 5.14.1 MSVC 库 / VS2022 v143 全工程编译通过。结果保存在各 build 目录的 contract-results.txt / contract-build.log;启动测试在 build-ssp-startup-test。
- 两套 ssp 测试构建目录旁的 config.ini 已同步新信号配置,识别开关保持关闭;未运行生产 exe。测试源仍在既有忽略规则下的 tests 目录内,本次没有提交 Git。
日期:2026-10-27。已实现软件,未运行真实 PLC、相机或机器人。
## 2026-10-28:恢复与白平衡状态修复
- 视觉故障后,PLC 暂停已确认或任务已终止到 Idle 时,允许重新连接、断开和初始化相机。恢复未完成订单时先执行并确认 PLC 暂停。维护期间仍禁止生产测量、手动诊断和启动生产;初始化成功不会解除人工核对锁。正在执行握手恢复时关闭维护入口,普通 PLC 状态轮询不阻止维护。
- 视觉事务开始前,使用 QSaveFile 原子写入配置文件旁的 `<配置文件名>.vision-state.json`(默认 `config.ini.vision-state.json`)。正常取料动作完成或人工核对成功后才写入完成状态。退出、终止和重新启动不丢失待核对状态;记录损坏时保持锁定;写入失败时不发取料命令、不解除恢复锁。部署升级应保留这个运行状态文件及其配置路径,不用模板覆盖或删除它;该文件已加入 Git 忽略。
- 手动再次执行白平衡会立即使对应相机的初始化缓存失效,并同步刷新 IPC 就绪状态。允许重复执行;再次通过初始化确认白平衡完成后才恢复生产就绪。命令失败时同样保持未就绪。
- 本轮离线验证:ssp IPC 12 passed;生产流程 35 passed(含终止后重启、测量中退出、恢复记录损坏/写入失败、状态轮询与维护交错、启动恢复暂停确认);VisionGuide 白平衡状态 6 passed(相机管理器替身,无真实采图)、既有抓取/资源测试 7 passed。
- ssp Qt 5.14.1 / MinGW 32 位和64位全工程编译通过;VisionGuide Qt 5.14.1 msvc2017_64 库 / VS2022 v143 全工程编译通过。仍未验证 v141 编译器或真实硬件。新增测试仍保留在用户要求忽略的 tests 目录中,未提交 Git。
## 已实现模块
- ssp–PLC:R40/R60 各六个 REAL、12 个寄存器整组读写;低字在前/高字在前编解码校验;视觉写入无自动重试;区分未发送、确认成功、发送后状态不明。保留原单 REAL API。
- ssp–VisionGuide:异步 QLocalSocket、QProcess、四字节大端长度与 JSON、会话/请求/工件/料盘/代次校验、取消与迟到结果拒绝;单个测量在途。
- VisionGuide:独立线程通信;左右相机参数及一次白平衡初始化;新测量页左相机识别后自动计算抓取;冻结 R40 位姿及料盘参数;原 UI/OPC 与自动流程互斥。
- ssp 生产:普通 RackPick 前依次执行三个独立阶段:M850/M851 移动到拍照位、视觉处理、M800/M807 RackPick。到位阶段完成后清 M850/M851;视觉成功写 R60/M852=1,关闭或测量失败写 M852=0。
- 界面及恢复:新增“视觉引导”页显示三组坐标、初始化及流程状态;与生产线程 queued 传值。暂停等待当前机器人动作完成,未提交结果的视觉请求可作废;结果提交状态不明时转人工确认。“恢复/重试”只处理故障状态,普通暂停由“启动/继续”恢复。
## 线圈及固定参数
| 线圈 | 含义 | 控制方 |
|---|---|---|
| 850 | 移动到拍照位置命令 | ssp |
| 851 | 移动到拍照位置完成反馈 | PLC/机器人,ssp 到位后清零 |
| 852 | 是否比对取料;1=使用 R60,0=普通取料 | 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/M852 写入门控及独立动作恢复。内存订单/报警夹具仅用于验证流程,没有做 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;ssp 的六个实物料盘均映射到该配置。该编号代表标定/法向/示教/高度设置,不等同于实物料盘号。
## 待现场验收
确认以上坐标约定和料盘映射,读 R40 对照示教器,检查两台初始化与白平衡、固定参数和抓取结果一致,再受控执行 R60 写入及握手。PLC 应保持请求/接收电平供轮询观察;本版没有 PLC 交易序号,未观察到完整握手会进入人工核对,不以旧确认推进。
未自动提交 Git;原 `ssp.pro.user` 和既有单 REAL 修改保留。