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 # 后端 # 物联网 # 单片机
Logo
华为云开发者联盟

为开发者提供学习成长、分享交流、生态实践、资源工具等服务，帮助开发者快速成长。

更多推荐

cover

HAS2024：华为云以系统性创新加速千行万业智能化升级

avatar 华为云开发者联盟
cover

数仓的两种轻量级数据交换格式：json与jsonb

avatar 华为云开发者联盟
cover

如何使用云数据库GaussDB管理平台进行实例安装？

avatar 华为云开发者联盟