智能制造与工业软件 / 系统课时
通过 Modbus TCP 回传判定值
通过 Modbus TCP 回传判定值
视觉程序算出 OK 或 NG 后,需要将结果交给 PLC 控制分拣机构。这里用三个连续的保持寄存器传递工件序号与判定码,并让 PLC 在超时或重复报文时保持安全状态,避免上一件工件的结果误用于下一件。
学习目标
- 正确约定 Modbus TCP 寄存器地址、16 位编码及工件序号。
- 使用 Python 写入视觉判定结果并检查协议应答。
- 在 PLC 侧实现去重、超时处理与现场验收。
先约定寄存器与判定码
假设 PLC 是 Modbus TCP 服务端,IP 为 192.168.10.20,端口为 502;视觉工控机是客户端。下表是本例自行约定的寄存器映射,必须在 PLC 工程中实际配置,不是所有品牌 PLC 的默认地址。
| 常见显示地址 | 报文零基地址 | 用途 | 取值 |
|---|---|---|---|
| 40001 | 0 | seq_hi |
工件序号高 16 位 |
| 40002 | 1 | seq_lo |
工件序号低 16 位 |
| 40003 | 2 | result |
1=OK,2=NG,3=检测异常 |
每个 Holding Register 占 16 位,报文内按高字节在前编码。序号 70000 拆为高字 1、低字 4464;PLC 再按高字乘 65536 加低字还原。不同 PLC 的 40001 标注及字地址偏移可能不同,要以设备手册和在线监控值核对。功能码 0x10(写多个保持寄存器)一次提交这三个值;它的正常响应仅确认服务器处理了写请求,不代表分拣动作已经执行。
看清视觉结果如何进入 PLC
PLC 触发相机时生成一个尚未消费的 expected_seq,并把该序号随触发事件交给视觉程序。视觉程序完成推理后回传同一序号;PLC 只在序号匹配、当前工件仍在等待且尚未处理时消费结果。

expected_seq 必须来自 PLC 的当前触发任务,不能由视觉程序独立随意递增。生产系统还可以让 PLC 在消费后回写已处理序号作为业务 ACK;这样能区分“寄存器写入成功”和“本件结果已被执行”。
用 Python 写入三个保持寄存器
下面示例使用 Python 3.10+ 标准库直接组装 Modbus TCP 报文,无须依赖特定第三方库。将代码保存为 modbus_result.py。程序检查事务号、单元号、功能码和写入数量;--seq 应由上游 PLC 触发流程提供。
import argparse
import socket
import struct
CODES = {'OK': 1, 'NG': 2, 'ERROR': 3}
def receive_exact(sock, size):
data = bytearray()
while len(data) < size:
part = sock.recv(size - len(data))
if not part:
raise ConnectionError('PLC 提前断开连接')
data.extend(part)
return bytes(data)
def write_result(host, port, unit, seq, code):
# 32 位序号拆为两个16位寄存器,功能码0x10批量写三个寄存器
values = (seq >> 16, seq & 0xFFFF, code)
pdu = struct.pack('>BHHBHHH', 0x10, 0, 3, 6, *values)
request = struct.pack('>HHHB', 1, 0, len(pdu) + 1, unit) + pdu
with socket.create_connection((host, port), timeout=1.0) as sock:
sock.settimeout(1.0)
sock.sendall(request)
header = receive_exact(sock, 7)
tid, protocol, length, reply_unit = struct.unpack('>HHHB', header)
if (tid, protocol, reply_unit) != (1, 0, unit) or not 2 <= length <= 254:
raise ValueError('MBAP 报文头不匹配')
response = receive_exact(sock, length - 1)
if len(response) == 2 and response[0] == 0x90:
raise RuntimeError(f'Modbus 异常码:{response[1]}')
if response != struct.pack('>BHH', 0x10, 0, 3):
raise ValueError('写入响应不符合预期')
def main():
parser = argparse.ArgumentParser()
parser.add_argument('--host', required=True)
parser.add_argument('--port', type=int, default=502)
parser.add_argument('--unit', type=int, default=1)
parser.add_argument('--seq', type=int, required=True)
parser.add_argument('--result', choices=CODES, required=True)
args = parser.parse_args()
if not 1 <= args.seq <= 0xFFFFFFFF or not 0 <= args.unit <= 255:
parser.error('seq 必须为1~4294967295,unit 必须为0~255')
try:
write_result(args.host, args.port, args.unit, args.seq, CODES[args.result])
except (OSError, ValueError, RuntimeError) as exc:
# 超时可能发生在PLC已经写入之后,不能据此断定写入失败
raise SystemExit(f'写入未确认:{exc};交由PLC超时保护处理')
print(f'Modbus写入已确认:seq={args.seq},result={args.result}')
if __name__ == '__main__':
main()预期结果:在 PLC 地址映射正确、允许写功能码 0x10 且网络畅通时,执行以下命令:
python modbus_result.py --host 192.168.10.20 --port 502 --unit 1 --seq 42 --result OK预期输出:
Modbus写入已确认:seq=42,result=OK这仅是成功通信时的示例输出,并非无设备时也会出现。Unit ID 1 是本例配置;直连 PLC 可能忽略它,经 TCP/RTU 网关时则要按从站地址设置。
把超时与重复写入关在安全边界内
PLC 不能只读取 40003=1 就放行。建议在 PLC 程序中按以下条件执行,超时时间 2000 ms 只是调试起点,需根据相机曝光、算法耗时、输送线节拍和机构距离实测确定。
- 每次触发新工件时,设置
pending=true、expected_seq和计时起点;上一件的判定码即使还在寄存器里也不生效。 - 同一扫描周期读取序号高字、低字和判定码,仅当
pending=true、序号等于expected_seq且未超时才接受。 result=1允许合格路线;result=2执行剔除;result=3或非法数值按异常处理,不允许默认放行。- 一旦消费本件结果就清除
pending并记录已消费序号;重试时即使三个寄存器再次写入相同内容,也不得重复触发气缸。 - 超过
2000 ms仍没有有效结果时转入剔除、停线或报警等经风险评估选定的安全状态,迟到的 OK 不得恢复放行。
按故障场景逐项验收
在断开执行机构或进入安全调试模式后,先监控 PLC 的 seq_hi、seq_lo、result、pending 和超时标志,再进行以下测试:
| 注入场景 | 合格的验收表现 |
|---|---|
| 序号 42、OK | 寄存器为 0, 42, 1,本件只执行一次合格动作 |
| 序号 43、NG | 寄存器为 0, 43, 2,只执行一次剔除 |
| 重发已消费的 43 | 不再次驱动执行机构 |
| PLC 等待 44,却收到迟到的 43 | 忽略结果,44 继续等待或超时 |
| 拔网线、PLC 断电或禁止写寄存器 | 程序显示未确认;PLC 超时进入约定安全状态 |
| 检测程序返回 ERROR | PLC 不按 OK 放行并记录异常 |
若连接立即拒绝,先检查 PLC 的 Modbus TCP Server 是否开启、IP、端口 502 和工业防火墙;若报 Modbus 异常码 02,优先核对寄存器映射;若异常码 01,检查设备是否支持 0x10。投产前还要核对输送线从拍照到剔除位的实际延迟,并通过 PLC 业务 ACK 或现场 I/O 反馈确认动作完成,不能仅以 TCP 写入成功作为整线验收依据。