feat: 重构视觉取料流程及生产故障恢复
- 删除订单启动、暂停、复位相关 PLC 握手及无效反馈配置 - 清除报警改为仅写 clearAlarmCommand,不等待反馈 - 将拍照位移动、视觉处理和 RackPick 拆分为三个独立动作 - 增加 M850/M851 拍照位动作及 R60/M852 视觉结果流程 - 暂停改为等待当前机器人动作完成,视觉结果不确定时转人工确认 - 删除复位按钮,合并为恢复/重试按钮 - 普通 PAUSED 订单通过启动按钮继续 - 恢复前检查 PLC、安全状态、订单及动作命令反馈 - 支持在途动作接管、已完成动作收尾、安全重试和人工确认 - 故障状态保持订单 RUNNING,并持久化实际恢复阶段 - 恢复成功后仅清除本次软件故障对应的报警 - 更新小轴 PLC 地址、Modbus 配置和视觉集成文档
This commit is contained in:
@@ -1,5 +1,19 @@
|
||||
# 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` 仍可覆盖端点名,但不绕过单实例锁。升级时先关闭不支持该锁的旧版本。
|
||||
@@ -16,7 +30,7 @@
|
||||
- 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 后使用视觉结果。
|
||||
- 新配置为 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。
|
||||
@@ -36,18 +50,16 @@
|
||||
- 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 输出并重读全部握手;旧坐标不重发。
|
||||
- ssp 生产:普通 RackPick 前依次执行三个独立阶段:M850/M851 移动到拍照位、视觉处理、M800/M807 RackPick。到位阶段完成后清 M850/M851;视觉成功写 R60/M852=1,关闭或测量失败写 M852=0。
|
||||
- 界面及恢复:新增“视觉引导”页显示三组坐标、初始化及流程状态;与生产线程 queued 传值。暂停等待当前机器人动作完成,未提交结果的视觉请求可作废;结果提交状态不明时转人工确认。“恢复/重试”只处理故障状态,普通暂停由“启动/继续”恢复。
|
||||
|
||||
## 线圈及固定参数
|
||||
|
||||
| 线圈 | 含义 | 控制方 |
|
||||
|---|---|---|
|
||||
| 850 | 机器人接收结果成功 | PLC/机器人 |
|
||||
| 851 | 请求拍照,机器人已停稳且 R40 已更新 | PLC/机器人 |
|
||||
| 852 | 相机拍照比对中 | ssp |
|
||||
| 853 | 相机数据比对错误 | ssp |
|
||||
| 854 | 相机比对通过,R60 可用 | ssp |
|
||||
| 850 | 移动到拍照位置命令 | ssp |
|
||||
| 851 | 移动到拍照位置完成反馈 | PLC/机器人,ssp 到位后清零 |
|
||||
| 852 | 是否比对取料;1=使用 R60,0=普通取料 | ssp,每次取料前覆盖并保持 |
|
||||
|
||||
测量固定:左相机、高精细化、5 秒采图/识别截止、MinScore 0.70、Greediness 0.80、YOLO 中心选择、相机显示模型原点、模型 +Z 抓取偏移 4.40 mm。偏移只在 VisionGuide 应用一次。整体通信和机器人确认使用独立超时。
|
||||
|
||||
@@ -65,7 +77,7 @@
|
||||
| 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 位两套构建验证。
|
||||
生产测试包含真实异步 Modbus 管理器与本地 FakePlc,覆盖 R60/M852 写入门控及独立动作恢复。内存订单/报警夹具仅用于验证流程,没有做 PostgreSQL 全库回归。相机识别质量、真实白平衡完成和机器人目标消费尚未现场验收。没有通过 GUI 操作 Qt Creator;验证为对应 Qt/MinGW 的 qmake 和 make 构建。用户现有 `ssp.pro.user` 保存的活动 Kit 为 MinGW 64 位,本次保留该文件既有修改,并补齐 32/64 位两套构建验证。
|
||||
|
||||
## 配置与使用
|
||||
|
||||
@@ -77,7 +89,7 @@
|
||||
|
||||
视觉故障后若活动订单的 PLC 步骤仍处于取料/上料等无法明确恢复的状态,人工恢复会保留锁定并提示先终止当前任务、核对机器人后再恢复,不会进入旧的 Loading 空状态或先发 PLC 启动。仅已明确进入现有正面/反面检测步骤时可接回原恢复流程。
|
||||
|
||||
VisionGuide 原测量页已有 1–99 料盘配置选择,现场文件目前保存配置 1 和 2;它是标定/法向/示教/高度设置编号,不自动等同 ssp 实物料盘号。本次未修改其用户配置。
|
||||
VisionGuide 当前只使用配置 1;ssp 的六个实物料盘均映射到该配置。该编号代表标定/法向/示教/高度设置,不等同于实物料盘号。
|
||||
|
||||
## 待现场验收
|
||||
|
||||
|
||||
Reference in New Issue
Block a user