Python实现Modbus TCP主站脚本:快速批量读取工业PLC的寄存器数据
工业上位机读PLC,别按寄存器逐个发请求。正确思路是“按点表合并相邻地址→单次批读保持/输入寄存器→用BinaryPayloadDecoder拆浮点/有符号/缩放→多PLC用线程池或asyncio并发→超时重试+异常码归类”。pymodbus 3.x用ModbusTcpClient,保持寄存器0x03、输入寄存器0x04,地址按0基填写,文档里的40001对应address=0。
一、单PLC批量读点表
先定义点表,把相邻区间合并成最少请求。温度/流量常占2个寄存器浮点,状态/计数常占1个寄存器:
from pymodbus.client import ModbusTcpClient
from pymodbus.payload import BinaryPayloadDecoder
from pymodbus.constants import Endian
def read_plc(ip, unit=1):
c=ModbusTcpClient(ip, port=502, timeout=3, retries=2)
if not c.connect():
return None
out={}
try:
# 0~9保持:可放电压/电流/功率等,按需解码
r=c.read_holding_registers(0,10,slave=unit)
if not r.isError():
dec=BinaryPayloadDecoder.fromRegisters(
r.registers, byteorder=Endian.BIG, wordorder=Endian.BIG)
out['voltage']=dec.decode_32bit_float() # 0-1
out['current']=dec.decode_32bit_float() # 2-3
out['power'] =dec.decode_32bit_float() # 4-5
out['status'] =r.registers[9] # 9单独状态
# 输入寄存器:能耗、故障字等
ri=c.read_input_registers(0,4,slave=unit)
if not ri.isError():
out['energy']=ri.registers[0]/10.0 # 缩放0.1kWh
out['fault'] =ri.registers[1]
finally:
c.close()
return out
单次读count建议不超过125个16位寄存器;跨大区间隔不要强行合成一段,避免读到PLC未映射地址返回非法数据地址异常。 浮点字节序按PLC手册改BIG/LITTLE,wordorder不对会出现数值数量级错乱。
二、多PLC并发轮询
10台以内串行可接受;几十台上量用线程池,每台独立连接,单台超时不影响全局:
from concurrent.futures import ThreadPoolExecutor
plcs=[{"ip":"192.168.1.10","unit":1},
{"ip":"192.168.1.11","unit":1},
{"ip":"192.168.1.12","unit":2}]
def safe(ip,unit):
try:
return ip, read_plc(ip,unit)
except Exception as e:
return ip, {"err":str(e)}
with ThreadPoolExecutor(max_workers=8) as ex:
res=list(ex.map(lambda d:safe(d["ip"],d["unit"]), plcs))
for ip,data in res:
print(ip, data)
对高密采集也可改用AsyncModbusTcpClient,多设备await gather并发,减少线程切换:
import asyncio
from pymodbus.client import AsyncModbusTcpClient
async def one(ip,unit,addr,count):
async with AsyncModbusTcpClient(ip,port=502,timeout=5) as c:
r=await c.read_holding_registers(addr,count,slave=unit)
return ip, None if r.isError() else r.registers
async def all_plc():
jobs=[one(p["ip"],p["unit"],0,10) for p in plcs]
return await asyncio.gather(*jobs, return_exceptions=True)
三、重试、断线、异常归类
工业网口常抖动,建议连接级重试+业务级退避,不无限重连:
import time
def read_retry(ip,addr,count,unit=1,max_try=3):
for i in range(max_try):
try:
c=ModbusTcpClient(ip,timeout=3)
if not c.connect(): raise ConnectionError("connect fail")
r=c.read_holding_registers(addr,count,slave=unit)
c.close()
if r.isError():
raise RuntimeError(str(r))
return r.registers
except Exception as e:
time.sleep(min(2**i,8)) # 1/2/4/8s退避
return None
返回功能码+0x80要按异常码处理:0x01非法功能、0x02非法地址、0x03非法数据值、0x04从站故障;地址越界别重试,先改点表。 经RS485网关的TCP设备响应慢,timeout设3~5s,轮询周期按PLC性能放200ms~1s,避免“轰炸”导致回异常或不响应。
四、落地要点
点表版本化:PLC地址、类型、缩放、字节序、单位全部配置化,换型号只改JSON不改代码;
保持长连接轮询,避免每点新建TCP;断链检测后重连,不复用死socket;
有符号16位用value-65536修正,32位用decode_32bit_int,BCD电表单独写转换;
多主站同读同PLC要错开周期,写操作单独加锁,防止HMI和脚本互相覆盖;
数据后接SQLite/InfluxDB或MQTT,原始registers和解析值都存,便于追溯“是PLC给错还是脚本解错”;
防火墙只放可信IP访问502,厂级网络走VPN/专线,别把Modbus直接暴露公网。
按“合并批读→类型解码→并发采集→重试降级→落库看板”写,几台小型PLC用同步脚本半小时可跑通,几十台产线PLC切异步/线程池,既能把轮询周期压下来,也方便后续接SCADA和告警。





