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,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。
|
||||
|
||||
Reference in New Issue
Block a user