Files
ssp/docs/plc-signal-audit-2026-10-29.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

ssp 与小轴 PLC 信号核对

日期:2026-10-29。依据:E:/QTCode/ssp/项目信号表/小轴信号.xlsx,Sheet1,C4:H87;以及当前 config.ini、ModbusAddressMap、DeviceService、ProductionService。

用户补充确认:使用 M850/M851/M852;D800 为保持寄存器地址 800;M816 是 PLC 给 ssp 的运行状态;M814 由 ssp 写,0=镀前、1=镀后。

1. 本次落实及结论

  • 将 photoPoseR、graspPoseR、lowWordFirst、photoMoveCoil、photoMoveCoilFeedback、comparisonPickCoil 的 INI 入口统一放到 [modbus];M851 兼容旧 photoArrivedCoil 键。
  • 更新已确认的普通流程点位。代码默认 trayNumber=802 与点表一致;当前用户 config.ini 保留其 trayNumber=801 覆盖值,尚未同步,需现场最终确认。相机已有 5 个逻辑点位保持确认地址。
  • 未定义的 25 个点位保留原占位地址并列在下方,不能据此直接认定已具备现场联机条件。
  • 本次只调整配置入口和已明确的地址;连续状态读取是下文建议,尚未改写读取逻辑。原始 Excel 未修改。
  • 为控制修改范围,内部相机 PLC 字段暂保留在 VisionConfig,不改现有调用接口;用户配置统一从 [modbus] 管理。

2. 已对应的信号

普通流程

命令由 ssp 写入;完成信号由 PLC 置位,当前 ssp 完成处理后会清除命令和完成位。表中“软件读完成”未说明清除责任,联调时应确认 PLC 允许这个清除动作、完成位保持到被清除。

ssp 动作 命令配置:旧 → 新 完成配置:旧 → 新 Excel 行
RackPick 托盘取料 rackPickCommand:300 → M800 rackPickFeedback:310 → M807 4、11
RackPlace 托盘放料 rackPlaceCommand:307 → M801 rackPlaceFeedback:317 → M808 5、12
FrontUnload 正面取 frontUnloadCommand:303 → M802 frontUnloadFeedback:313 → M809 6、13
FrontLoad 正面放 frontLoadCommand:301 → M803 frontLoadFeedback:311 → M810 7、14
Flip 翻转 flipCommand:304 → M804 flipFeedback:314 → M811 8、15
BackUnload 反面取 backUnloadCommand:306 → M805 backUnloadFeedback:316 → M812 9、16
BackLoad 反面放 backLoadCommand:305 → M806 backLoadFeedback:315 → M813 10、17
配置 原值 已确认地址 用途 Excel 行
inspectionMode 线圈 320 M814,线圈 814 ssp 写,0=镀前,1=镀后 18
slotNumber 保持寄存器 401 D800,保持寄存器 800 ssp 写工位/格位,当前代码允许 1~49 58
trayNumber 保持寄存器 400 D802,保持寄存器 802 ssp 写物理料盘号 60

FrontLoad/BackLoad 是往检测工位放料;FrontUnload/BackUnload 是从检测工位取料,按这一方向对应点表。

相机前置流程

[modbus] 配置 PLC 地址 Modbus 地址及方式 方向/责任 Excel 行
photoMoveCoil=850 M850 线圈 850,FC05 写 ssp 请求移动;到位后 ssp 清零 36
photoMoveCoilFeedback=851 M851 线圈 851,FC01 读、FC05 清 PLC 置位;ssp 读到到位后清零 37
comparisonPickCoil=852 M852 线圈 852,FC05 写 ssp 每次 RackPick 前覆盖,完成后保留 38
photoPoseR=40 R40~R51 保持寄存器 12328~12339,FC03 一次读 12 字 PLC 提供 6 个 float32;M851 置位前完成更新 75~80
graspPoseR=60 R60~R71 保持寄存器 12348~12359,FC10 一次写 12 字 测量成功才由 ssp 写 6 个 float32 82~87

lowWordFirst=true 控制每个 float 的低 16 位字在前,支持负数;与单个 Modbus 字内部的网络字节序是两回事。点表本身没有明确字序,部署前用已知含负数坐标核对。

注意:photoPoseR=40、graspPoseR=60 填 R 编号,代码会加 0x3000;不能填成 12328、12348。D800 的配置直接填 800,不加 R 偏移。M800 与 D800 是不同地址空间,不冲突。

[vision] 继续放识别开关、IPC 名称、程序路径、超时和协议确认开关;六个物理料盘的 [visionTrayMap] 继续全部映射到配置 1。

3. ssp 使用、点表未定义的 25 个信号

“未定义”指没有可确认的同语义点位;下列地址是当前代码/配置的占位值,不能当成 PLC 实际协议。当前 plcReady 等状态会影响状态读取及生产准入,不能仅补齐相机点位就跳过这些核对。

类别 配置名 当前占位地址 ssp 用途/方向
控制 clearAlarmCommand 线圈 3 写清报警命令
就绪/安全 plcReady 线圈 100 读 PLC 就绪;M816“运行中”不能直接等同
就绪/安全 robotReady 线圈 101 读机器人就绪;M818“运行状态”不能直接等同
就绪/安全 safetyDoorClosed 线圈 102 读总安全门关闭
就绪/安全 emergencyStop 线圈 103 读急停状态,当前 true 表示急停生效
设备状态 inspectionMachineReady 线圈 500 读检测机就绪
设备状态 visionReady 线圈 501 读 PLC 侧视觉就绪;与 IPC 服务就绪是两路来源
设备状态 robotControlCabinetReady 线圈 502 读机器人控制柜就绪
设备状态 mainControlCabinetReady 线圈 503 读主控柜就绪
设备状态 safetyDoor1Closed 线圈 504 读安全门 1 关闭
设备状态 safetyDoor2Closed 线圈 505 读安全门 2 关闭
设备状态 safetyDoor3Closed 线圈 506 读安全门 3 关闭
设备状态 activeAlarm 线圈 507 读报警存在
检测握手 inspectionCommand 线圈 302 写检测触发
检测握手 inspectionFeedback 线圈 312 读检测完成,处理后清零
结果 currentStep 保持寄存器 200 读 PLC 当前步骤
结果 checkResult 保持寄存器 201 读检测结果,当前约定 1=OK、2=NG、3=错误
结果 errorCode 保持寄存器 202 读错误码;usePlcErrorCode=false 时不读取

统计:基础地址映射 42 个点,已对应 17 个,待定义 25 个;另有相机 3 个线圈和 2 组 REAL 数据。每组 REAL 按一个逻辑点统计,不按 12 个字重复计数。

表中有、ssp 暂未接入的点

PLC 点 表内含义 当前情况
M815 收到任务完成信号清除数据 未映射;需明确谁置位、谁清除及何时清哪些数据
M816 PLC开始运行 用户已明确为 PLC → ssp 的运行状态;未单独接入
M817 PLC任务执行中 未单独接入
M818 机器人运行状态 未单独接入;不当作机器人就绪
M820~M825 六个托盘到位接近开关 未单独读取;当前写 trayNumber 不代表已检查到位

M819、D801、D803~D809 未命名,不视为已分配业务信号。是否用 M816/M817 取代现有应答机制属于协议变化,需要另行确认,不能只改地址。

4. 点表需要修订的地方

  1. 第 38 行 M852 已是“是否比对取料”;第 40 行仍重复定义 M852 为旧“相机拍照比对”,第 41~42 行保留 M853/M854。以本次确认的 M850/M851/M852 为准,旧定义建议标为废弃。
  2. 第 62~67 行 D804~D809 的 Modbus 地址全部写成 803,属于重复。若沿用 D800=800 的映射规则应分别为 804~809,但这些空白点要先明确用途再分配。
  3. 第 75 行“R40-R52(12个INT)”应写 R40~R51;第 82 行“R60-R72(12个INT)”应写 R60~R71。6 个 REAL 各占 2 字;最后一个 REAL 起始分别为 R50/R70。
  4. 第 83~87 行相机反馈的 PLC 地址列为空,建议补齐 R62/R64/R66/R68/R70,与现有 Modbus 地址对应。
  5. 建议补充每个点的写入方、有效电平、复位方、保持条件、结果枚举及 REAL 字序。仅有“软件读”不足以完整描述握手。

5. 连续读取分析

现状与不移动地址的优化

普通状态轮询 DeviceService::readStatusStep():12 个线圈逐个 FC01 读取,currentStep/checkResult 各一次 FC03,共 14 次请求;开启错误码后为 15 次。共享串行请求队列,慢响应会累积等待;pollIntervalMs=1000 不保证一轮恰好 1 秒。

当前配置地址 读取内容 现状请求数 建议请求数
线圈 100~103 PLC/机器人就绪、总门、急停 4 1 次 FC01,数量 4
线圈 500~507 其他设备、安全门、报警 8 1 次 FC01,数量 8
保持寄存器 200~201 或 202 步骤、结果、可选错误码 2 或 3 1 次 FC03,数量 2 或 3
合计 一轮普通状态 14 或 15 3 次

这是基于当前占位布局的技术分析,实际部署应使用 PLC 确认地址。代码已有批量 readCoils,普通状态流程还没有使用;保持寄存器需要补普通批量读取入口。先固定真实点表再实施最简单。

相机部分已经批量处理:M850~M852 一次读 3 位;R40 一次读 12 字,R60 一次写 12 字。普通动作当前只轮询正在执行的一个完成位,间隔 50ms,不必为凑连续读取而重复轮询所有完成位。

按现有小轴点表分区

区间 建议角色 读取策略
M800~M806 7 个动作命令 按动作写,不周期读写整组
M807~M813 7 个动作完成 活跃动作按需读;需要总览时可读 7 位
M814~M818 模式、任务清除、PLC/任务/机器人状态 按各点责任使用,避免整组覆盖写
M820~M825 6 个托盘到位 接入后一次 FC01 读 6 位
M850~M852 拍照握手及比对取料 保持一次读 3 位,M852 每次取料前单独写
D800、D802 工位号、料盘号 保持独立写,完成后才发 M850/普通动作命令
R40~R51、R60~R71 输入/输出坐标 分别读写 12 字,不跨中间空隙合并写

如果 PLC 明确 M819 可读,M807~M825 可一次读 19 位,涵盖完成/运行/料盘状态。否则拆开读;不要默认空白区间一定支持读取。

待补信号的地址建议(仅方案,未写入配置)

优先保留已确认的 M800~M825、M850~M852、D800/D802 和 R40/R60。以下区间只在这份表中未定义,不代表 PLC 程序里一定空闲,须由 PLC 方核准。

建议区间 建议顺序 作用
M826~M837 plcReady、robotReady、safetyDoorClosed、emergencyStop、inspectionMachineReady、visionReady、robotControlCabinetReady、mainControlCabinetReady、safetyDoor1Closed、safetyDoor2Closed、safetyDoor3Closed、activeAlarm 12 个普通状态连续,一次读
M838 clearAlarmCommand 清报警单次置 1,不等待反馈;地址仍待 PLC 方确认
M839~M845 暂留 启动、暂停、复位及其反馈已从 ssp 协议删除
M846~M847 inspectionCommand、inspectionFeedback 检测握手
M848~M849 暂留 无当前业务分配
D804~D806 currentStep、checkResult、errorCode 3 个结果字连续;先纠正点表地址列并确认占用

采用此方案后,普通状态为 M826~M837 一次 FC01,加 D804~D805/806 一次 FC03,即 2 次请求;若还需运行状态和托盘到位总览,可在 PLC 确认 M819 可读后,将 M807~M837 一次读 31 位。M850~M852 继续按需读取,便于保留拍照事务的时序和取消处理。

INI 行按“地址空间 → 地址升序”排列便于人工核对;仅调整行顺序不会减少通讯请求,实际优化必须修改读取代码。FC01 的 M 区和 FC03 的 D/R 区不能混为一次读取;读取失败仍应将本轮状态视为无效。批量读也不保证采样期间 PLC 状态完全不变,完成位应保持到约定的清除时刻。

6. 取料流程核对

  1. ssp 写 D802 料盘号、D800 工位号,写入确认后置 M850=1。
  2. PLC/机器人到拍照位置,将 6 个当前位置 float 写好 R40~R51,再置 M851=1。
  3. ssp 读到到位后清 M850/M851,需要识别时读取 R40 并向 VisionGuide 发测量请求。
  4. 识别成功:确认整组写 R60~R71,再确认写 M852=1;未启用或识别失败:不写 R60,确认写 M852=0。
  5. ssp 进入普通 RackPick,命令 M800;PLC 完成反馈 M807。M852 保留,下一次取料前由 ssp 覆盖。

相机测量失败继续普通取料;PLC 到位/读写失败、R60/M852 写入是否成功不确定,仍属于 PLC 握手故障,不能伪装成相机测量失败继续运行。

7. 验证

  • 本机 FakePlc:PLC/配置 13 passed;拍照前置及生产取料流程 47 passed。生产测试中的动作、反馈及 D 地址同步到本次已确认点表。
  • 覆盖旧 [vision] 配置回退、新 [modbus] 优先、移除配置恢复默认、错误新值不回退,以及新默认点位的地址空间不冲突。
  • 根配置的 20 个标量点位逐一对照 Excel PLC 地址列通过,另外核对 R40/R60 及全部六个新配置键位置;ssp 32/64 位全工程编译通过,git diff --check 通过。
  • 测试源位于既有忽略目录 tests/vision_plc、tests/vision_production;未自动添加至 Git。未连接真实 PLC、相机或机器人。