feat(vision): 新增拍照到位前置流程并支持视觉失败降级取料
- 在普通 RackPick 前写托盘号、格位并置 M850,收到 M851 后清除两位 - 使用 vision/enabled 控制识别,关闭时仍执行拍照到位流程 - 识别成功且 R60 写入确认后写 M852=1,视觉关闭或失败时写 M852=0 - 确认 M852 写入后启动 RackPick,动作结束保留 M852 - 移除旧 850–854 五信号握手,更新配置和协议文档 - 允许未就绪的视觉服务接收测量,扩展超时以覆盖初始化重试 - 保留 PLC 写入失败阻断、暂停发送门控及迟到结果拒绝 - 持久化未完成事务,支持 PLC 暂停后的视觉维护与人工恢复 验证:MinGW 32/64 位编译通过;生产流程47、IPC14、PLC11项测试通过
This commit is contained in:
@@ -1,5 +1,7 @@
|
||||
# 方案二:按模块实施 R40 → VisionGuide → R60
|
||||
|
||||
> 历史实施记录:2026-10-28 起,PLC 五信号握手和视觉失败策略已由 `superpowers/specs/2026-10-28-photo-position-pick-design.md` 及 `visionguide-integration-status.md` 顶部的新协议替代。当前 M850=移动请求、M851=到位反馈、M852=取料模式;普通 RackPick 在这些准备操作完成后才启动。
|
||||
|
||||
更新:2026-10-27。状态:模块 A–F 已实施,ssp 的 Qt 5.14.1 / MinGW 32 位工程已编译,VisionGuide 独立 MSVC x64 工程已编译;PLC、IPC、生产流程已完成无硬件模拟测试。未连接真实 PLC/相机/机器人;现场验收尚待完成。实际交付与测试见 `docs/visionguide-integration-status.md`。
|
||||
|
||||
## 1. 已确定目标与边界
|
||||
|
||||
@@ -0,0 +1,15 @@
|
||||
# 拍照到位与取料模式(已确认)
|
||||
|
||||
本文件替代旧 850–854 五信号流程。ssp 与 VisionGuide 同机、同用户,以现有本机 IPC 通信。
|
||||
|
||||
每次料架取料(即使关闭视觉识别)先写托盘号和格位,再置 M850。收到 M851 后由 ssp 依次清 M850、M851,再决定是否识别;此期间机器人保持拍照位,R40 为本次 XYZABC。仅此准备阶段完成后才启动原 RackPick。
|
||||
|
||||
识别开关使用 vision/enabled。关闭时写 M852=0;开启且识别成功时先确认整组 R60 写入,再写 M852=1;初始化失败、测量失败、无效结果、超时或视觉连接不可用时不写 R60,记录原因并写 M852=0。缺少料盘映射视为本次视觉不可用,不猜测配置号。确认 M852 写入后才能启动 RackPick;M852 在动作后保持,不清零。M853、M854 不再使用。
|
||||
|
||||
PLC 通信错误、到位超时、R60 或 M852 写入未确认仍停止并要求核对;不能把 PLC 写入失败当作视觉失败放行。暂停、停止、进程重启和旧请求的保护继续保留,恢复不依赖相机就绪。恢复仅核对 M850/M851,不清 M852,不重发旧 R60。
|
||||
|
||||
VisionGuide 在 SDK 初始化、程序启动后自动执行一次相机连接、参数应用和白平衡。收到测量请求时,若相机未初始化成功,重试初始化一次;成功继续同一请求,失败返回关联该请求的结构化错误。启动初始化过程中允许暂存一个测量请求,禁止并发初始化/采图。客户端必须允许向未就绪但已连接的服务发送测量,等待预算包含启动初始化、一次重试与测量。
|
||||
|
||||
PLC 坐标仍为 6 个 float32(12 字),支持负数;沿用现有字序配置、固定视觉参数和标定规则。本轮不连接真实设备、不自动提交 Git。
|
||||
|
||||
验证:模拟 PLC 检查托盘/格位→M850→M851→清位→R40/测量→R60→M852→RackPick 顺序、关闭视觉、各类视觉失败降级、M852 保持及逐次覆盖、PLC 失败阻断、暂停/停止/迟到结果/恢复。IPC 验证未就绪测量及初始化中的单请求;相机替身验证初始化成功、失败重试与白平衡。编译 ssp 与 VisionGuide。
|
||||
@@ -1,7 +1,29 @@
|
||||
# VisionGuide 独立进程接入交付记录
|
||||
|
||||
## 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、photoArrivedCoil=851、comparisonPickCoil=852;旧五线圈配置和 handshakeProtocol 不再使用。根配置启用已确认的新 PLC 协议,识别开关仍为 enabled=false;现场填写 visionTrayMap 并设 enabled=true 后使用视觉结果。
|
||||
- 实施说明: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。
|
||||
|
||||
@@ -14,14 +14,16 @@
|
||||
| --- | --- |
|
||||
| hello | 协议握手及进程 session;不初始化设备 |
|
||||
| get_status | 返回 ready/resource_busy 以及可选 initialization 对象 |
|
||||
| initialize | 左右相机及算法初始化;accepted 后返回 ok/error |
|
||||
| measure | 本次拍照、识别、抓取计算;accepted 后返回终态 |
|
||||
| initialize | 显式初始化/维护入口;accepted 后返回 ok/error;VisionGuide 启动也自动执行相机初始化 |
|
||||
| measure | 本次拍照、识别、抓取计算;相机未初始化成功时先重试一次初始化,成功继续同一请求,失败返回 error/INITIALIZATION;accepted 后返回终态 |
|
||||
| cancel | 带 target_request_id,取消该测量;cancel 本身独立应答,测量返回 cancelled |
|
||||
| show_window | 显示原视觉调试窗口 |
|
||||
| shutdown | 正常关闭(ssp 只对自己启动的进程发送) |
|
||||
|
||||
服务端主动状态消息使用 `type:"status"`、`request_id:""`、当前 session。业务失败不丢失关联上下文。相同测量编号不得重新采图。
|
||||
|
||||
状态增加 `initialization_in_progress` bool。启动初始化时 `resource_busy:true`,允许接收一个测量请求等待初始化结束,其他测量仍返回 BUSY。ssp 不以 ready=false 直接拒绝测量;测量请求可触发一次初始化重试。客户端总等待预算为 `requestTimeoutMs + 2 * initializeTimeoutMs`,不改变采图/识别的 5 秒截止。初始化失败返回结构化 `status:"error"`、`error_code:"INITIALIZATION"`、`robot_valid:false`,保留 request_id/context。ssp 将视觉失败转换为 M852=0 的普通取料路径,不写 R60。
|
||||
|
||||
状态响应还提供字符串 `server_process_id`。ssp 只有在该值与自身 QProcess 启动的子进程 PID 一致时才发送 shutdown;连接外部实例时退出仅断开。
|
||||
|
||||
## measure 请求
|
||||
@@ -61,4 +63,4 @@
|
||||
|
||||
## ssp 线程接口
|
||||
|
||||
VisionService 及其 QLocalSocket/QProcess 在 GUI 线程中创建使用。生产线程通过 queued connection 传 `QJsonObject` 值快照:`measure(request)`、`cancel(requestId)`,接收 `measurementFinished(result)`、`availabilityChanged(ready,busy,session)`。无阻塞等待,退出不依赖生产线程等 GUI 回答。`setProductionActive(bool)` 使诊断入口与生产互斥;自动请求使用 `measure`,页面使用 `diagnose`。
|
||||
VisionService 及其 QLocalSocket/QProcess 在 GUI 线程中创建使用。生产线程通过 queued connection 传 `QJsonObject` 值快照:`measure(request)`、`cancel(requestId)`,接收 `measurementFinished(result)`、`availabilityChanged(ready,busy,session)`。无阻塞等待,退出不依赖生产线程等 GUI 回答。`setProductionActive(active, maintenanceAllowed)` 使诊断入口与生产互斥;待人工核对时保持 active,只有 PLC 暂停已确认或任务已终止到 Idle 才允许维护连接和初始化,仍禁止测量。自动请求使用 `measure`,页面使用 `diagnose`。此变更仅为 ssp 内部线程接口,线上的 IPC 协议版本仍为 1。
|
||||
|
||||
Reference in New Issue
Block a user