python玩转modbus

最新推荐文章于 2025-03-03 10:19:48 发布
最新推荐文章于 2025-03-03 10:19:48 发布
阅读量3.2w 收藏 262
点赞数 41
分类专栏： 学习记录 文章标签： python 后端 物联网 单片机
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/pista/article/details/121911024
版权
本文介绍了如何使用Python的modbus_tk库在RTU和TCP模式下执行Modbus协议，包括读写线圈、寄存器等操作。详细讲解了RtuMaster和TcpMaster类的使用，并提供了模拟测试的方法和错误码说明。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

python玩转modbus

1. modbus协议简介

Modbus协议是一项应用层报文传输协议，包括ASCII / RTU / TCP三种报文类型，协议本身不定义物理层，只定义了控制器能够认识和使用的消息结构，而不管消息是经过何种网络进行通信的。

标准的Modbus协议物理层接口主要有RS232 / RS422 / RS485和以太网。采用Master/Slave主从方式通信

关于modbus协议更多更详细的介绍，可自行查阅

2. 环境配置

py3

python 目前主流使用操作modbus协议的库有三个

  • pymodbus

    • 使用twisted实现的modbus完整协议（支持异步通讯）

  • MinimalModbus

    • 只支持modbusrtu

  • modbus_tk

    • 完整modbus协议栈的实现，支持modbus tcp/rtu｛1.提供slave模拟器，即模拟modbus server:502), web-based hmi master支持｝

今天主要使用modbus_tk库，versions=1.1.2。相关资料https://pypi.python.org/pypi/modbus_tk

  • pip3 install modbus_tk==1.1.2

3. 主要函数

不管是通过串口(RTU/ASCII )还是以太网（TCP）模式读写数据modbus_tk库提供的唯一函数，所以我们先介绍这个函数

  • execute(slave, function_code, starting_address, quantity_of_x=0, output_value=0, data_format="", expected_length=-1, write_starting_address_FC23=0）

    • slave：从机站号 ，0为广播所有的slave

    • function_code：功能码

      codefunction
      1READ_COILS 读线圈
      2READ_DISCRETE_INPUTS 读离散输入
      3READ_HOLDING_REGISTERS 读保持寄存器
      4READ_INPUT_REGISTERS读输入寄存器
      5WRITE_SINGLE_COIL写单一线圈
      6WRITE_SINGLE_REGISTER写单一寄存器
      15WRITE_MULTIPLE_COILS写多个线圈
      16WRITE_MULTIPLE_REGISTERS 写多寄存器
      还有其它不常用大家可自己看源码

    • starting_address：起始地址

    • quantity_of_x：读取数据长度，RTU模式数据长度如下图1，TCP模式数据长度是和不同模块的cpu限制有关如下图2
      图1：在这里插入图片描述
      图2：
      在这里插入图片描述

    • output_value：一个整数（单个写入）或可迭代的值（批量写入）

    • data_format：读取的数据进行格式化，参考下图unpcak中的格式字符串内容

      在这里插入图片描述

    • expected_length：没用过

    • write_starting_address_FC23：没用过

4. RTU模式

硬件链接方式通过物理485或232口

modbus_tk库提供了一个RtuMaster类，实例化一个RtuMaster对象，需要初始化封装一个Serial对象

import serial
import modbus_tk.defines as cst
from modbus_tk import modbus_rtu

master = modbus_rtu.RtuMaster(serial.Serial(port=PORT, baudrate=9600, bytesize=8, parity='N', stopbits=1, xonxoff=0))
master.set_timeout(1.0)
# port：串口
# baudrate：波特率
# bytesize：字节大小
# parity：校验位
# stopbits：停止位
# timeout：读超时设置
# writeTimeout：写超时
# xonxoff：软件流控
# rtscts：硬件流控
# dsrdtr：硬件流控
 
# 读保持寄存器 03H 1站号 地址0 长度0-10
res_tuple = master.execute(1, cst.READ_HOLDING_REGISTERS, 0, 10)  # 返回元组

示例

import serial
import modbus_tk.defines as cst
from modbus_tk import modbus_rtu


def demo(PORT):
    master = modbus_rtu.RtuMaster(serial.Serial(port=PORT, baudrate=9600, bytesize=8, 														parity='N', stopbits=1, xonxoff=0))
    master.set_timeout(1.0)
    
    res1 = master.execute(1, cst.READ_COILS, 0, 10)
    res2 = master.execute(2, cst.READ_DISCRETE_INPUTS, 0, 8)
    res3 = master.execute(3, cst.READ_INPUT_REGISTERS, 100, 3)
    res4 = master.execute(4, cst.READ_HOLDING_REGISTERS, 100, 12)
    res5 = master.execute(5, cst.WRITE_SINGLE_COIL, 7, output_value=1)
    res6 = master.execute(6, cst.WRITE_SINGLE_REGISTER, 100, output_value=54)
    res7 = master.execute(7, cst.WRITE_MULTIPLE_COILS, 0, output_value=[1, 1, 0, 1, 1])
    res8 = master.execute(8, cst.WRITE_MULTIPLE_REGISTERS, 100, output_value=xrange(12))
if __name__ == '__main__':
    demo('com1')

5. TCP模式

硬件链接方式通过以太网口

相同modbus_tk库提供了一个TcpMaster类，实例化一个TcpMaster对象，需要初始化封装ip地址和端口号

import modbus_tk.defines as cst
import modbus_tk.modbus_tcp as modbus_tcp

server = modbus_tcp.TcpMaster(host：str, port：int)
server.set_timeout(1.0)

# host: ip地址
# port： 端口

# 读保持寄存器 03H 1站号 地址0 长度0-10
res1 = server.execute(1, cst.READ_HOLDING_REGISTERS, 0, 10)

示例

import modbus_tk.defines as cst
import modbus_tk.modbus_tcp as modbus_tcp


def demo(ip，port):
    server = modbus_tcp.TcpMaster(host：str, port：int)
	server.set_timeout(1.0)
    
    res1 = master.execute(1, cst.READ_COILS, 0, 10)
    res2 = master.execute(2, cst.READ_DISCRETE_INPUTS, 0, 8)
    res3 = master.execute(3, cst.READ_INPUT_REGISTERS, 100, 3)
    res4 = master.execute(4, cst.READ_HOLDING_REGISTERS, 100, 12)
    res5 = master.execute(5, cst.WRITE_SINGLE_COIL, 7, output_value=1)
    res6 = master.execute(6, cst.WRITE_SINGLE_REGISTER, 100, output_value=54)
    res7 = master.execute(7, cst.WRITE_MULTIPLE_COILS, 0, output_value=[1, 1, 0, 1, 1])
    res8 = master.execute(8, cst.WRITE_MULTIPLE_REGISTERS, 100, output_value=xrange(12))
if __name__ == '__main__':
    demo('192.168.2.1'，102)

* 错误码

modbus exception codesnotes
1ILLEGAL_FUNCTION = 1 功能代码不合法
2ILLEGAL_DATA_ADDRESS = 2 数据地址不合法
3ILLEGAL_DATA_VALUE = 3 数据值不合法
4SLAVE_DEVICE_FAILURE = 4 slave设备失败
5COMMAND_ACKNOWLEDGE = 5 命令已收到
6SLAVE_DEVICE_BUSY = 6 slave设备忙
8MEMORY_PARITY_ERROR = 8 内存奇偶误差

6. 模拟测试

环境需要:

  • 安装vspd.exe 用于模拟串口 (主要测试RTU模式代码，如果是测试TCP模式就不用下载串口模拟器)

  • modbus slave 用于模拟从机

安装包地址:

链接：https://pan.baidu.com/s/1BLxTjG6ZFv65R6pfhHD3kg 
提取码：xynb

软件模拟操作流程

  1. 串口模拟，打开串口模拟软件，点击添加串口

    在这里插入图片描述

  2. 左侧看见已添加的串口

    在这里插入图片描述

  3. 从机数据模拟。打开从机模拟软件，点击F8，进行，箭头从上到下依次是从站id设置，功能码设置，起始地址，数据长度，直接默认就可以点击ok

    在这里插入图片描述

  4. 然后就会看见，双击对应的地址数据就可以赋值，必须是整数

    在这里插入图片描述

    在这里插入图片描述

    在这里插入图片描述

  5. 从机链接模式设置 点击F3,进行设置，更据自己的主机代码是rtu还是tcp就选那种模式，rtu就用Serial Port，tcp模式就用modbus tcp/ip,

    在这里插入图片描述

    在这里插入图片描述

  6. 主机就可以用ide编辑代码测试了

    用上面的示例代码就可以进行读写测试了

* 下一篇我用实体硬件设备给大家带来更详细的示例用法

  • 主机：树莓派加485扩展版

    • 系统RASPBERRY PI OS(32-BIT)

  • 从机：ABB变频器

    • 型号 ACS510-01
Python 使用Modbus-RTU
爱分享的小猿
10-15 1015
Python Modbus RTU
【CSDN下载】第七期：微信小程序跳一跳游戏破解源码、Modbus TCP和TCP通信测试
CSDN-下载的新天地
01-12 2573
为便于广大开发者对热门资源的下载需求，下载频道专为广大开发者开辟了推荐一周IT优质资源通道，以供开发者参考下载，同时欢迎大家上传优质资源并留言所需的资源，小编会汇总所需，及时奉上所求。源码系列微信小程序1300多套集合含php，node，js，有后台无后台版 【摘要说明】手账，游戏，视频配置教程，八大类企业展示小程序，外卖，leanCloud后端，php后台，nodejs后端。这是一个大集合，单文
学习使用pymodbus模块实现Modbus通讯
Logintern09的博客
08-20 1316
Modbus是一种工业领域广泛使用的通信协议，而PyModbus是一个在Python中实现Modbus通信的库。它支持多种Modbus模式，包括RTU（通过串行线路），ASCII和TCP/IP。
pymodbus简单使用
最新发布
月亮的技术博客
03-03 338
是一个基于Python的开源Modbus协议实现库，主要用于工业自动化领域的设备通信。它支持Modbus RTU/ASCII over Serial（串口）及Modbus TCP/IP（以太网）协议，提供客户端（主站）和服务器（从站）功能，适用于PLC、传感器、仪表等设备的读写操作。其设计目标是为开发者提供轻量级、高灵活性的Modbus通信解决方案。
modbus通信的Python实现
02-19
采用Python编程语言实现modbusTCP 通信，资料包含有对寄存器操作例子
Modbus协议与Python
weixin_46184311的博客
07-18 3618
使用python建立modbus通讯，讲解modbus基本原理，如何使用python搭建从站与主站，如何进行对浮点数进行读写。
基于Python的Modbus-TCP/IP客户端
07-06
基于Python的Modbus-TCP/IP客户端,本例为从01号从站读取22个内存字(%MW),大家可以根据需要自行修改.
pymodbus, 在 python 中，编写了一个完整的modbus协议.zip
10-11
pymodbus, 在 python 中，编写了一个完整的modbus协议 摘要Pymodbus是使用 Twisted 实现异步通信内核的完整Modbus协议实现。 如果需要更轻量级的项目，也可以不使用任何第三方依赖项( 除了 pyserial ) 。 这里外，它应该在任何 python 版本>
python pymodbus库使用教程（以Modbus RTU为例）（read_holding_registers()、read_input_registers()）
热门推荐
Dontla的博客
11-23 2万+
Modbus是一种工业领域广泛使用的通信协议，而PyModbus是一个在Python中实现Modbus通信的库。它支持多种Modbus模式，包括RTU（通过串行线路），ASCII和TCP/IP。本教程将重点介绍如何使用PyModbus库进行Modbus RTU通信。有时候，标准的Modbus函数不足以满足特定的需求。PyModbus允许创建自定义消息和事务处理器，使得可以扩展协议以适应特殊用例。
python使用MODBUS
07-27
- *2* [python玩转modbus](https://blog.csdn.net/pista/article/details/121911024)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_...
modbus python
08-16
- *1* *3* [python玩转modbus](https://blog.csdn.net/pista/article/details/121911024)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_...
用Python写的Modbus-TCP/IP客户端
08-06
用Python写的Modbus-TCP/IP客户端，可用，文档虽小，但功能能实现，请需要的朋友下载，更改后就可以是自己的了
Python与物联网：构建智能硬件控制程序的关键技术
参考资源链接：[《Python编程：给孩子玩的趣味指南》高清PDF电子书](https://wenku.csdn.net/doc/646dae11d12cbe7ec3eb21ff?spm=1055.2635.3001.10343) # 1. Python在物联网中的应用概述 Python语言因其简洁的语法...
Python编写Modbus详细指南与示例
alicyh的专栏
11-25 1438
Modbus是一种串行通信协议，广泛用于工业自动化领域。它定义了一系列消息结构，用于在多个设备之间交换数据。Python由于其易用性和丰富的库，成为了编写Modbus应用程序的热门选择。PyModbus是Python中一个功能强大的Modbus协议栈实现，支持RTU和TCP两种模式。
python实现modbus通讯-modbus_tk
sinat_35773915的博客
07-17 8603
通过使用Modbus_Tk库，我们可以方便地实现Modbus RTU和Modbus TCP的客户端和服务端。本文提供了示例代码，帮助读者快速上手。如果你对Modbus_Tk库有更多的需求，可以查阅官方文档以获取更多信息和示例代码。希望本文能够对你有所帮助！
Modbus协议及基于Python的ModbusTCP客户端实现
WonderThink的博客
07-04 1万+
modbus-TCP协议及Python3的使用示例。
python 实现Modebus 通信（pyModbusTCP ）
姚家湾博客
06-28 7089
尽管python 并不实现实时控制应用程序，但是它编写程序实在是太方便了。至少在程序快速成型和验证过程中可以使用Python 来实现，另一方面，Python 强大的数值计算和图形显示能力也能够实现modbus 设备的远程监控，数据采集，甚至AI 训练。注意的是 auto_open和auto_close两个标记，它指明每次请求modbusTCP 时是否会自动打开和关闭TCP/IP 连接。如果auto_close=True 表示每次都会自动关闭连接，经测试，它会引起2秒中的延时。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值