基于Python串口的Modbus RTU协议封装与解析实例
基于Python串口通信(pyserial),深入剖析Modbus RTU协议报文结构、CRC-16校验实现、请求帧封装与响应解析全流程实例。
在工业自动化现场或嵌入式测控系统中,工程师常常需要使用计算机连接 USB 转 RS-485 适配器,向变送器、智能电表或 PLC 读取运行数据。这类设备最通用的通信语言之一便是 Modbus RTU。尽管开源社区提供了许多封装成熟的高级库,但在面临协议适配、通信丢包、报文校验异常或排查偶发硬件故障时,理解底层二进制帧格式并掌握原生封装与解析方法是不可或缺的技能。本文将通过原生 Python 与基础串口库 pyserial,完整演示 Modbus RTU 请求帧的字节组装、CRC-16 校验计算、串口收发时序及响应解析过程。
一、物理链路与通信拓扑
Modbus RTU 是一种基于主从架构(Master-Slave)的串行通信协议。在同一条通信总线上,仅允许存在一个主机(Master,通常为主控计算机或工控机),以及一个或多个从机设备(Slave,如温湿度变送器、电力测量仪表)。所有数据交互均由主机发起查询请求,对应从站接收并应答,从机之间不能相互通信,从机也不会主动上报数据。
在物理实现层面,Modbus RTU 最常搭配 RS-485 差分总线。主机通过 USB 转 RS-485 串口线引出 A+ 和 B- 两根信号线,采用“手拉手”菊花链拓扑连接到各个从机的 A/B 端子上。通信双方必须事先约定完全一致的串口物理参数,包括波特率(如 9600 bps)、数据位(通常为 8)、校验位(无校验 N、偶校验 E 或奇校验 O)和停止位(1 或 2 位)。
二、Modbus RTU 协议帧格式与 CRC16 校验
在 Modbus RTU 模式下,信息以纯二进制连续字节流传输。每个完整的通信数据包称为应用数据单元(ADU),它由三部分构成:从站地址(1 字节)、协议数据单元(PDU,包含 1 字节功能码与数据域),以及位于末尾的 16 位循环冗余校验码(CRC-16,占 2 字节)。
以最常用的 03H(读取保持寄存器) 功能码为例,主机发送的请求帧结构固定为 8 字节:
- 从站地址(1 字节): 目标设备的识别号,有效范围一般为 1 到 247。0 为广播地址。
- 功能码(1 字节): 指定当前操作类型。读保持寄存器为
0x03。 - 起始寄存器地址(2 字节): 采用大端字节序(高位字节在前,低位字节在后)。例如寄存器 0 表示为
0x00 0x00。 - 读取寄存器数量(2 字节): 同样采用大端序。例如读取 2 个寄存器表示为
0x00 0x02。 - CRC16 校验码(2 字节): 对前 6 个字节计算所得的校验值,特别注意:Modbus 规定低位字节在前,高位字节在后(小端传输)。
从机正常响应时,返回报文格式如下:
- 从站地址(1 字节)与功能码(1 字节): 与请求帧回显一致。
- 返回字节计数(1 字节): 告知后续数据部分的字节长度。每个寄存器为 16 位(2 字节),若读取 N 个寄存器,该值为
2 * N。 - 寄存器数据域(2*N 字节): 各寄存器的具体数值,按寄存器顺序大端排列。
- CRC16 校验码(2 字节): 覆盖从站地址到数据末尾全部字节的 CRC 校验码(低字节在前)。
三、CRC-16 校验算法实现
Modbus RTU 所采用的 CRC 校验算法有其严格的数学规范:多项式为 0xA001(即 0x8005 的逆序反射),初始值为 0xFFFF。对报文中的每一个字节按位与多项式异或运算后,最终输出一个 16 位无符号整数。在组装进报文时,需要将该 16 位整数拆解为低 8 位与高 8 位。
下面是用纯 Python 实现的标准 Modbus CRC-16 计算函数:
def calculate_crc16(data: bytes) -> bytes:
"""
计算 Modbus RTU CRC-16 校验码
:param data: 待校验的原始字节序列
:return: 2字节的 bytes 对象 (低字节在前,高字节在后)
"""
crc = 0xFFFF
for byte in data:
crc ^= byte
for _ in range(8):
if crc & 0x0001:
crc = (crc >> 1) ^ 0xA001
else:
crc >>= 1
# 拆解为小端序: 低位字节在前,高位字节在后
crc_low = crc & 0xFF
crc_high = (crc >> 8) & 0xFF
return bytes([crc_low, crc_high])
实战要点提醒:许多初学者在此处踩坑,误将 CRC 以大端格式发送(即 bytes([crc_high, crc_low])),导致从机直接忽略该请求或因 CRC 错误静默不响应。请务必核实 Modbus 规范强制要求的“低字节在前,高字节在后”。
四、Python 串口收发与响应解析流程
从发出请求到最终获取工程测量值,整个处理流程必须严格按照工业时序推进:
- 构建 PDU 数据载荷:根据从站 ID、功能码 03H、目标寄存器地址及数量,使用
struct.pack组织前 6 字节; - 追加 CRC 校验:对前 6 字节调用 CRC 函数,拼接为长度为 8 字节的完整请求帧;
- 清空缓冲区并发送:在写入串口前,调用
serial.reset_input_buffer()清除旧残留数据,然后使用serial.write()发送帧; - 接收应答:设置合理的读取超时(通常设为 0.5s 到 1.0s),先读取响应头确定返回长度,再完整读取剩余数据和 CRC 校验位;
- 合法性与错误校验:
- 检查返回从站地址是否匹配;
- 检查功能码:若最高位被置位(如收到
0x83),表示从站返回了异常码(如非法数据地址、从站忙等); - 对接收到的完整响应帧(除末尾 2 字节 CRC 外)重新计算 CRC,核对与帧末尾的 CRC 是否一致;
- 数据解码转换:从数据域中提取高低字节,组合为 16 位整数,并根据传感器说明书计算实际工程量(如除以 10.0 得到实际摄氏度)。
五、完整 Python 实例代码实现
在实际代码中,建议将串口对象管理、帧封装、CRC 计算与结果解析统一组织为一个小巧高效的客户端类。以下代码无需安装臃肿的第三方协议栈,仅依赖 Python 标准库中的 struct 与基础串口通信库 pyserial(通过 pip install pyserial 安装)。
import time
import struct
import serial
class ModbusRTUMaster:
"""Modbus RTU 主站封装与解析轻量级客户端"""
def __init__(self, port: str, baudrate: int = 9600, timeout: float = 1.0):
# 初始化并打开物理串口
self.ser = serial.Serial(
port=port,
baudrate=baudrate,
bytesize=serial.EIGHTBITS,
parity=serial.PARITY_NONE,
stopbits=serial.STOPBITS_ONE,
timeout=timeout
)
@staticmethod
def calculate_crc(data: bytes) -> bytes:
"""标准 Modbus CRC16 计算"""
crc = 0xFFFF
for byte in data:
crc ^= byte
for _ in range(8):
if crc & 0x0001:
crc = (crc >> 1) ^ 0xA001
else:
crc >>= 1
return bytes([crc & 0xFF, (crc >> 8) & 0xFF])
def read_holding_registers(self, slave_id: int, start_address: int, count: int) -> list:
"""
03H 功能码:读取保持寄存器
:param slave_id: 从站设备地址 (1-247)
:param start_address: 寄存器起始地址 (0 起始)
:param count: 读取的寄存器数量
:return: 包含各寄存器16位整数的列表
"""
# 1. 组装请求 PDU: 功能码 0x03, 起始地址(大端2B), 寄存器数(大端2B)
pdu = struct.pack(">B B H H", slave_id, 0x03, start_address, count)
# 2. 计算 CRC 并构建完整的 8 字节 RTU 帧
request_frame = pdu + self.calculate_crc(pdu)
# 3. 准备串口并发送
self.ser.reset_input_buffer()
self.ser.write(request_frame)
# 4. 接收响应头 (从站地址 1B + 功能码 1B + 字节计数 1B = 3B)
header = self.ser.read(3)
if len(header) < 3:
raise TimeoutError("从机应答超时,未能接收到完整的响应头")
resp_slave_id, resp_func, byte_count = struct.unpack(">BBB", header)
# 检查是否返回错误码 (功能码最高位被置 1)
if resp_func == 0x83:
# 异常帧结构: 地址(1B) + 异常功能码(1B) + 异常码(1B) + CRC(2B)
exception_code = byte_count # 第3字节此时为异常代码
err_crc = self.ser.read(2)
raise RuntimeError(f"从机返回 Modbus 异常码: 0x{exception_code:02X}")
if resp_slave_id != slave_id or resp_func != 0x03:
raise ValueError(f"响应头不匹配: 从站={resp_slave_id}, 功能码={resp_func}")
# 5. 根据字节计数读取数据域与末尾的 2 字节 CRC
payload_and_crc = self.ser.read(byte_count + 2)
if len(payload_and_crc) < byte_count + 2:
raise TimeoutError("数据域或校验码接收不完整")
data_bytes = payload_and_crc[:byte_count]
received_crc = payload_and_crc[byte_count:]
# 6. 验证 CRC 校验码
full_received_body = header + data_bytes
expected_crc = self.calculate_crc(full_received_body)
if received_crc != expected_crc:
raise ValueError(f"CRC 校验失败: 接收值={received_crc.hex()} 计算值={expected_crc.hex()}")
# 7. 解包 16 位寄存器数值 (每个寄存器 2 字节,大端格式)
num_registers = byte_count // 2
register_values = struct.unpack(f">{num_registers}H", data_bytes)
return list(register_values)
def close(self):
"""释放并关闭串口"""
if self.ser.is_open:
self.ser.close()
# 使用示例
if __name__ == "__main__":
# 根据实际系统串口名称调整,例如 Windows 为 'COM3',Linux 为 '/dev/ttyUSB0'
master = ModbusRTUMaster(port="/dev/ttyUSB0", baudrate=9600, timeout=0.8)
try:
# 读取 1 号从机,从 0x0000 起始的 2 个寄存器 (假设存放温度和湿度)
registers = master.read_holding_registers(slave_id=1, start_address=0x0000, count=2)
print("寄存器原始值 (16位无符号):", [f"0x{val:04X}" for val in registers])
# 假设设备协议规约: 温度 = 寄存器0 / 10.0 (°C),湿度 = 寄存器1 / 10.0 (%RH)
temperature = registers[0] / 10.0
humidity = registers[1] / 10.0
print(f"解析结果 -> 温度: {temperature} °C, 湿度: {humidity} %RH")
finally:
master.close()
六、现场常见通信故障排查与调试要点
在实际工业现场部署时,即便代码完全正确,也常常会因为线缆连接、时序偏差或电气干扰导致读取超时或乱码。遇到通信异常时,可以依据以下排查矩阵进行定位:
七、总结
通过本文的推演与实现,我们可以看到 Modbus RTU 协议的核心逻辑清晰而紧凑:
- 物理层依托半双工 RS-485 差分总线实现多节点挂载;
- 链路层通过固定功能码、起始地址和长度构成 PDU,并附加 CRC-16 保证数据完整性;
- 应用层通过简单的字节序转换与线性公式,将 16 位整型数据转化为实际物理度量。
掌握这套基于 Python 的底层封装与解析方案,不仅能够在轻量级边缘计算节点中免去第三方库的依赖,还能在面对非标准 Modbus 变体设备时,快速定制出稳定可靠的通信接口。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









