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

13 KiB
Raw Blame History

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 程序、原始 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 修改保留。