当前位置： 首页 > news >正文

Python pymodbus模块详解

news 2026/3/26 20:42:23

好的，我们来详细讲解一下 Python 的pymodbus模块。

概述

pymodbus是一个用纯 Python 实现的 Modbus 协议栈。Modbus 是一种广泛应用于工业自动化领域的串行通信协议，常用于连接 PLC（可编程逻辑控制器）、传感器、仪表等设备。pymodbus支持 Modbus TCP（基于 TCP/IP）和 Modbus RTU/ASCII（基于串行线路，如 RS-232/RS-485）两种主要传输方式。

核心功能与概念

  1. 协议类型:

    • Modbus TCP: 使用 TCP/IP 协议进行通信，端口号通常为 502。
    • Modbus RTU: 使用串行通信（RS-232/485），数据以二进制形式传输。
    • Modbus ASCII: 使用串行通信，数据以 ASCII 字符形式传输（较少见）。

  2. 角色:

    • Client (主站/Master): 发起请求的设备。通常由上位机（如运行 Python 程序的 PC）充当。
    • Server (从站/Slave): 响应请求的设备。通常是 PLC、传感器等现场设备。pymodbus也可以用来模拟从站设备。

  3. 数据模型 (寄存器类型):

    • 线圈 (Coils): 1 位，可读写。通常表示开关量输出状态（如继电器开/关）。
    • 离散输入 (Discrete Inputs): 1 位，只读。通常表示开关量输入状态（如按钮按下/松开）。
    • 保持寄存器 (Holding Registers): 16 位，可读写。通常存储设备参数、设定值等。
    • 输入寄存器 (Input Registers): 16 位，只读。通常存储设备采集的实时数据（如温度、压力）。

  4. 常用功能码:

    • 01 (0x01): 读取线圈状态。
    • 02 (0x02): 读取离散输入状态。
    • 03 (0x03): 读取保持寄存器。
    • 04 (0x04): 读取输入寄存器。
    • 05 (0x05): 写单个线圈。
    • 06 (0x06): 写单个保持寄存器。
    • 15 (0x0F): 写多个线圈。
    • 16 (0x10): 写多个保持寄存器。

安装

pip install pymodbus

使用示例

作为客户端 (Client) - 读取数据

Modbus TCP 示例 (同步)
from pymodbus.client import ModbusTcpClient # 连接到 Modbus TCP 服务器 (假设地址为 192.168.1.100, 端口 502) client = ModbusTcpClient('192.168.1.100', port=502) connection = client.connect() # 建立连接 if connection: try: # 读取从站地址为 1 的设备上的保持寄存器 (功能码 03) # 起始地址 = 0, 读取数量 = 5 个寄存器 response = client.read_holding_registers(address=0, count=5, slave=1) if not response.isError(): # 获取寄存器值列表 (每个寄存器是 16 位无符号整数) registers = response.registers print(f"读取到的寄存器值: {registers}") else: print(f"读取错误: {response}") finally: client.close() # 关闭连接 else: print("无法连接到 Modbus 服务器")

http://my.tv.sohu.com/us/442093011/697362370.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjM3MC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362554.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjU1NC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362556.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjU1Ni5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362557.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjU1Ny5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362559.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjU1OS5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362464.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjQ2NC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362615.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjYxNS5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362572.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjU3Mi5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362574.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjU3NC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362619.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjYxOS5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362396.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjM5Ni5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362637.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjYzNy5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362710.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjcxMC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362812.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjgxMi5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362653.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjY1My5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362816.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjgxNi5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362657.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjY1Ny5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362661.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjY2MS5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362663.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjY2My5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362740.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2Mjc0MC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362684.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjY4NC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362698.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjY5OC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362753.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2Mjc1My5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362840.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2Mjg0MC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362934.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MjkzNC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362764.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2Mjc2NC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362768.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2Mjc2OC5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697362946.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2Mjk0Ni5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697363023.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MzAyMy5zaHRtbA==.html
http://my.tv.sohu.com/us/442093011/697363039.shtml
https://tv.sohu.com/v/dXMvNDQyMDkzMDExLzY5NzM2MzAzOS5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697351510.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MTUxMC5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697351283.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MTI4My5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697351634.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MTYzNC5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697351640.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MTY0MC5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697351712.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MTcxMi5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697351757.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MTc1Ny5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697351929.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MTkyOS5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352133.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjEzMy5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352092.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjA5Mi5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352150.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjE1MC5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352000.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjAwMC5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352189.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjE4OS5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352278.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjI3OC5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352447.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjQ0Ny5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352507.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjUwNy5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352380.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjM4MC5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352634.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjYzNC5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697352393.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MjM5My5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697353030.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MzAzMC5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697353771.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1Mzc3MS5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697353773.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1Mzc3My5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697353911.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MzkxMS5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697353778.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1Mzc3OC5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697353915.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1MzkxNS5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697353797.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1Mzc5Ny5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697354043.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1NDA0My5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697354106.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1NDEwNi5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697353886.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1Mzg4Ni5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697354109.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1NDEwOS5zaHRtbA==.html
http://my.tv.sohu.com/us/438920216/697353947.shtml
https://tv.sohu.com/v/dXMvNDM4OTIwMjE2LzY5NzM1Mzk0Ny5zaHRtbA==.html

Modbus RTU 示例 (同步)
from pymodbus.client import ModbusSerialClient # 连接到串口设备 (例如 COM3, 波特率 9600, 8N1) # method='rtu' 表示使用 RTU 模式 client = ModbusSerialClient( port='COM3', baudrate=9600, bytesize=8, parity='N', stopbits=1, method='rtu' ) connection = client.connect() if connection: try: # 读取从站地址为 1 的设备上的输入寄存器 (功能码 04) # 起始地址 = 100, 读取数量 = 3 个寄存器 response = client.read_input_registers(address=100, count=3, slave=1) if not response.isError(): registers = response.registers print(f"读取到的输入寄存器值: {registers}") else: print(f"读取错误: {response}") finally: client.close()

作为服务器 (Server) - 提供数据

Modbus TCP 服务器示例
from pymodbus.server import StartTcpServer from pymodbus.datastore import ModbusSequentialDataBlock from pymodbus.datastore import ModbusSlaveContext, ModbusServerContext # 定义数据存储 # 初始化各个数据区域 (起始地址, 初始值列表) coils = ModbusSequentialDataBlock(0, [False] * 100) # 100 个线圈，初始为 False discrete_inputs = ModbusSequentialDataBlock(0, [True] * 100) # 100 个离散输入，初始为 True holding_registers = ModbusSequentialDataBlock(0, [0] * 100) # 100 个保持寄存器，初始为 0 input_registers = ModbusSequentialDataBlock(0, [0] * 100) # 100 个输入寄存器，初始为 0 # 创建从站上下文 (Slave Context)，关联数据块 slave_context = ModbusSlaveContext( di=discrete_inputs, # 离散输入 co=coils, # 线圈 hr=holding_registers, # 保持寄存器 ir=input_registers, # 输入寄存器 ) # 创建服务器上下文 (Server Context)，可以包含多个从站 (这里只定义了一个从站，地址为 1) context = ModbusServerContext(slaves={1: slave_context}, single=False) # 启动 TCP 服务器，监听所有接口 (0.0.0.0) 的 502 端口 StartTcpServer(context=context, address=("0.0.0.0", 502))

高级特性

  • 异步客户端: 使用AsyncModbusTcpClient或AsyncModbusSerialClient，配合asyncio库进行异步编程，提高并发性能。
  • 数据解析: 寄存器通常存储 16 位数据。对于 32 位浮点数、64 位整数等，需要将多个寄存器组合起来并按特定字节序解析。pymodbus提供了payload模块中的工具（如BinaryPayloadBuilder,BinaryPayloadDecoder）来帮助处理这些复杂数据类型。
  • 自定义数据存储: 可以继承ModbusSparseDataBlock或实现自己的存储类，用于更灵活地管理数据。
  • 回调: 服务器端可以设置回调函数，在数据被读取或写入时执行自定义逻辑。

注意事项

  1. 地址偏移: Modbus 协议中的寄存器地址通常从 0 开始。但有些设备手册或软件习惯使用从 1 开始的地址（如 40001 代表保持寄存器地址 0）。使用pymodbus时，传入的address参数通常是基于 0 的索引。务必查阅设备文档确认地址映射规则。
  2. 字节序 (Endianness): 处理多寄存器数据（如浮点数）时，必须了解设备使用的字节序（大端序 Big-Endian / 小端序 Little-Endian）和字序（高低字顺序）。
  3. 超时: 在创建客户端时设置合理的timeout参数，避免网络或设备响应慢导致程序长时间阻塞。
  4. 错误处理: 始终检查response.isError()并处理可能的异常（如超时、连接失败、Modbus 异常响应）。
  5. 资源释放: 使用try...finally确保连接 (client.close()) 或服务器 (StopTcpServer()/StopSerialServer()) 被正确关闭。

总结

pymodbus是一个功能强大且灵活的 Python Modbus 库，适用于开发需要与工业设备通信的应用程序。通过理解 Modbus 协议基础、数据模型和pymodbus提供的接口，开发者可以高效地实现主站（数据采集、控制）或从站（模拟设备、数据提供）功能。务必参考官方文档和示例代码以获取更详细的信息：https://pymodbus.readthedocs.io/。

http://www.jsqmd.com/news/320175/

相关文章：

  • 蓝桥杯JAVA--启蒙之路（七）继承多态
  • 2026年江苏光伏支架钢管实力厂家五强推荐与选型指南
  • 【软件测试】9_性能测试实战 _性能测试监控
  • 【软件测试】10_性能测试实战 _性能分析和调优
  • 2026年口碑好的布袋除尘器/低压长布袋除尘器行业内知名厂家排行榜
  • 【总结】25年最常用的10个AI工具推荐
  • 2026年靠谱的糖苷/癸基葡糖苷厂家最新推荐排行榜
  • 2026年热门的海上疏浚浮吊/港口浮吊最新TOP厂家排名
  • 2026年知名的木浆棉复合百洁布/压缩木浆棉源头厂家
  • 2026年知名的端氨基聚醚/环氧基封端烯丙基聚醚厂家最新用户好评榜
  • 【深度学习实战】阿里“小云”语音唤醒模型部署全攻略：从环境填坑到执行推理
  • Docker 部署 PicGo：一次配置,随处使用
  • MySQL用C/C++连接
  • 2026年诚信的大连校企合作的公司行业推荐TOP榜
  • 不想用 ElevenLabs？2026 年 7 款 AI 语音、TTS 与语音克隆替代方案评测
  • 2026年诚信的大连学习3D建模质量榜
  • 2026国自然改版“瘦身”，科研人破局全靠这款AI神器！
  • DeepBI Listing 优化功能第二弹：保姆级优化报告，对着抄就赢！
  • 2026年专业的大连日本留学签证/大连日本留学品牌力榜
  • 2026年质量好的自动吨袋包装机/称重式吨袋包装机厂家最新推荐排行榜
  • 2026年可靠的大连日本语言学校申请奖金/大连日本语言学校申请签证服务力排名
  • 夷陵区农资选购全攻略：2026年优质店铺推荐与避坑指南
  • 2026年热门的铝箔全身式隔热服/炉前隔热服值得信赖厂家推荐（精选）
  • 2026年湖北彩色玻璃实力供应商综合评选指南
  • 2026年口碑好的纺织硅油/化妆品保湿剂硅油厂家推荐及选择参考
  • 武汉方矩管销售公司哪家信誉好？2026年精选6家实力厂商
  • 2026年太原岩土勘察实力机构深度测评与优选指南
  • 2026年湖北别墅石材装饰品牌选购全攻略与TOP服务商解析
  • 2026年第一季度武汉镀锌管优质供应商综合评测与推荐
  • 2026年1月合肥京东代运营服务商综合评估与精选推荐