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

166 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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、相机或机器人。