Python minimalmodbus库是Modbus RTU通信的轻量级选择，安装简单，代码简洁，适合工业自动化场景。 它把Modbus协议的核心功能封装成直观的方法，让你用几行代码就能完成串口读写，特别适合快速原型开发与设备调试。
minimalmodbus 使用教程：从安装到读取保持寄存器
要上手minimalmodbus,先完成安装，再通过几步操作与设备建立连接，读取数据，整个过程在多数Python版本上都能顺利执行。
安装与依赖
在终端执行pip install minimalmodbus即可，库本身依赖pyserial，安装时会自动处理，要求Python 3.6以上，Windows、Linux、macOS均支持，据业内专家指出，该项目在树莓派等ARM平台上的兼容性也很好，长期维护且更新及时。
初始化串口与从站地址
实例化Instrument对象时，传入串口名称和从站ID，串口名称在Windows上为COMx，Linux上为/dev/ttyUSB0或/dev/ttyAMA0，一个典型的初始化代码段：
import minimalmodbus
instrument = minimalmodbus.Instrument('COM1', 1) # 串口COM1，从站地址1
instrument.serial.baudrate = 9600
instrument.serial.bytesize = 8
instrument.serial.parity = minimalmodbus.serial.PARITY_NONE
instrument.serial.stopbits = 1
instrument.serial.timeout = 0.5
参数需与设备手册一致,多数情况下，9600波特率、8数据位、无校验、1停止位是通用配置。
读取保持寄存器
使用read_register方法，指定寄存器地址（从0开始）、小数位数（源码中为number_of_decimals，用于整数转浮点）和功能码，默认功能码为03，可省略。
value = instrument.read_register(0, 0, 3) # 地址0，小数位数0，功能码03 print(value)
若读取连续多个寄存器,用read_registers
，返回列表，批量读取能显著减少通信次数，提高效率。
写入寄存器操作
写入单个寄存器使用write_register，功能码可以是06或16，例如将数值100写入地址1：
instrument.write_register(1, 100, 0, 6) # 地址1，数值100，小数位数0，功能码06
写入多个寄存器用write_registers，第一个参数为起始地址，第二个参数为数值列表，功能码自动使用16。
读取输入寄存器
输入寄存器（功能码04）是只读的，用于读取传感器或设备状态，使用read_register时指定功能码为4即可：
input_value = instrument.read_register(0, 0, 4)
minimalmodbus同样支持读取线圈（功能码01）和离散输入（功能码02），通过read_bit方法实现，但大部分场景下保持寄存器和输入寄存器已足够。
minimalmodbus 和 pymodbus 对比：如何选择
对于Python开发者,Modbus通信库主要分minimalmodbus和pymodbus，行业共识认为，两者定位不同，选择取决于项目规模与复杂度。
| 对比项 | minimalmodbus | pymodbus |
|---|---|---|
| 协议支持 | 仅RTU | RTU、ASCII、TCP、UDP |
| 安装与依赖 | 极简，仅pyserial | 功能丰富，依赖较多，部分扩展需额外安装 |
| 代码量 | 几行即可完成读写 | 通常需要更多配置代码，支持异步 |
| 学习曲线 | 低，文档简洁 | 中等，功能全面但文档较复杂 |
| 适用场景 | 小型监控、调试工具、单从站设备 | 大型系统、多协议网关、服务器模拟 |
如果你的项目只是通过串口读写
几个寄存器,minimalmodbus几乎是最直接的选择，它不需要理解异步框架，也不用处理多个协议分支，而pymodbus内置TCP服务器和客户端，支持多主站，适合分布式系统或需要协议转换的场景，两者都是免费开源，但minimalmodbus在轻量级场景下更受欢迎。
python modbus rtu 通讯实战：minimalmodbus 在串口485中的应用
在实际工业环境中,Modbus RTU通常运行在RS485总线上，minimalmodbus通过串口与485转换器通信，实现与多台从站设备的数据交换。
硬件连接与参数设置
电脑通过USB转485模块连接设备,确认驱动正确安装，在设备管理器中找到对应串口号，波特率、校验位需与从站设备一致，常见设置为9600-8-N-1，若总线上有多台设备，需确保每个从站地址唯一，终端电阻匹配。
读取多个寄存器
读取设备参数,如温度、压力、频率等，常需要连续读取多个寄存器，例如读取地址0开始的10个保持寄存器：
values = instrument.read_registers(0, 10, 3)
返回的列表按地址顺序排列,注意，某些设备寄存器地址可能从1开始，需根据手册调整。
浮点数读写
minimalmodbus支持直接读写浮点数,基于IEEE 754标准，占用两个连续寄存器，使用read_float和write_float方法，指定起始地址、字节序和数据类型，例如读取地址20开始的浮点数：
temp = instrument.read_float(20, byteorder=0, number_of_registers=2)
写入时类似：
instrument.write_float(20, 25.5, byteorder=0)
字节序参数byteorder=0表示大端，1表示小端，需与设备约定一致，这一功能让浮点数处理变得简单，无需手动打包。
错误处理与超时设置
通信中可能出现超时、CRC错误或从站无响应，minimalmodbus的
timeout属性控制等待时间，单位为秒，建议根据设备响应速度设为0.5至2秒，捕获异常时，可判断minimalmodbus.NoResponseError或minimalmodbus.InvalidResponseError，并重试或记录日志。
try:
value = instrument.read_register(0, 0, 3)
except minimalmodbus.NoResponseError:
print("无响应，检查连接")
except minimalmodbus.InvalidResponseError:
print("CRC错误，数据异常")
稳定的通信还依赖于总线负载和线缆质量,在长距离传输时增加终端电阻和屏蔽层。
minimalmodbus 库 常见问题解答
Q1: minimalmodbus 读取数据超时怎么办？
检查串口参数是否与设备一致,包括波特率、数据位、校验位，确认从站地址匹配，且总线上没有地址冲突，适当增加timeout值，或循环重试，若频繁超时，需排查硬件连接、RS485转换器供电或终端电阻是否缺失。
Q2: minimalmodbus 支持功能码03和06吗？
支持,minimalmodbus默认使用03读取保持寄存器，06写入单个寄存器，16写入多个寄存器，其他功能码如01（读线圈）、02（读离散输入）、04（读输入寄存器）、05（写单线圈）通过read_bit、write_bit或指定功能码参数实现，几乎所有常用功能码都已覆盖。
Q3: minimalmodbus 在Python 3.11上兼容吗？
相容,minimalmodbus持续更新，在Python 3.6到3.11版本上均测试通过，安装时如遇依赖问题，升级pyserial至最新版即可。
minimalmodbus以极低的门槛实现了Modbus RTU通信的核心功能，代码简洁，运行稳定，无论是快速验证设备通信，还是构建轻量级的工业监控系统，它都能胜任，掌握这款库，就等于掌握了Python串口通信的实用技能，让工业自动化开发更高效。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/python-minimalmodbus%e6%80%8e%e4%b9%88%e7%94%a8%ef%bc%8c%e5%a6%82%e4%bd%95%e5%ae%89%e8%a3%85%ef%bc%9f/
