Python实战：用pymodbus读写PLC中的浮点数和字符串（字节序详解）
Python实战：工业级PLC数据通信中的浮点数与字符串处理精要
当我们需要从PLC读取一个温度传感器的浮点数值，或是向设备写入一段包含生产批次信息的字符串时，Modbus协议的基础读写操作往往显得力不从心。工业现场的数据交换远比简单的整数传输复杂得多——字节序的差异、数据类型的转换、内存对齐等问题，都可能让看似简单的通信任务变成一场调试噩梦。
1. 工业通信中的复杂数据类型挑战
在工业自动化领域，PLC与上位机之间的数据交换从来不是简单的整数传输。温度传感器的读数可能是32位浮点数，设备状态信息可能编码为ASCII字符串，而生产参数可能包含有符号整数。这些复杂数据类型在Modbus协议中需要通过保持寄存器（Holding Registers）来传输，而每个寄存器只能存储16位无符号整数。
常见的问题场景包括：
- 从西门子S7-1200读取的温度值显示为毫无意义的巨大数字
- 写入三菱FX系列PLC的字符串在HMI界面上显示为乱码
- 不同厂商设备间的数据交换结果不一致
这些问题的根源大多在于**字节序(Byte Order)和字序(Word Order)**的处理不当。工业设备制造商对数据在寄存器中的存储方式有不同的实现：
| 设备厂商 | 典型字节序配置 | 常见数据类型问题 |
|---|---|---|
| 西门子 | Big-Endian字序 | 浮点数解析错误 |
| 三菱 | Little-Endian字节序 | 字符串分段错位 |
| 欧姆龙 | 混合Endian | 多字节数据高位丢失 |
| ABB | 可配置Endian | 跨平台数据不一致 |
2. pymodbus的核心工具：BinaryPayloadBuilder与BinaryPayloadDecoder
pymodbus库提供的BinaryPayloadBuilder和BinaryPayloadDecoder是处理复杂数据类型的关键工具。它们的工作原理是将Python原生数据类型转换为符合特定字节序要求的寄存器序列，以及反向解析过程。
2.1 构建数据：BinaryPayloadBuilder实战
假设我们需要向地址40001开始的寄存器写入以下数据：
- 设备ID字符串："Line1_Station3" (ASCII编码)
- 当前温度：25.6 (32位浮点数)
- 生产计数：1200 (16位无符号整数)
- 设备状态：0xA5 (8位位掩码)
from pymodbus.client import ModbusTcpClient from pymodbus.payload import BinaryPayloadBuilder from pymodbus.constants import Endian def write_complex_data(host, port): client = ModbusTcpClient(host, port) builder = BinaryPayloadBuilder( byteorder=Endian.Big, wordorder=Endian.Big ) # 添加各类型数据 builder.add_string("Line1_Station3") # 自动补空格到偶数长度 builder.add_32bit_float(25.6) builder.add_16bit_uint(1200) builder.add_8bit_uint(0xA5) # 转换为寄存器列表 payload = builder.to_registers() # 写入到PLC client.write_registers(address=40001, values=payload) client.close()关键参数说明：
byteorder：控制单个16位寄存器内的字节顺序wordorder：控制多个寄存器之间的排列顺序add_string默认使用ASCII编码，长度不足会自动补空格
2.2 解析数据：BinaryPayloadDecoder技巧
从PLC读取复杂数据时，必须确保解码器配置与编码时完全一致。以下是从地址40001读取并解析前述数据的完整示例：
from pymodbus.payload import BinaryPayloadDecoder def read_complex_data(host, port): client = ModbusTcpClient(host, port) # 先读取原始寄存器数据 response = client.read_holding_registers(address=40001, count=8) registers = response.registers # 创建解码器（参数必须与编码时一致） decoder = BinaryPayloadDecoder.fromRegisters( registers, byteorder=Endian.Big, wordorder=Endian.Big ) # 按写入顺序解析数据 device_id = decoder.decode_string(12).decode('ascii').strip() temperature = decoder.decode_32bit_float() production_count = decoder.decode_16bit_uint() status = decoder.decode_8bit_uint() print(f"设备ID: {device_id}") print(f"温度值: {temperature:.1f}℃") print(f"生产计数: {production_count}") print(f"状态字: {bin(status)}") client.close()注意：decode_string()需要指定长度参数，该值必须与写入时的字符串长度（包括填充）完全一致，否则后续数据解析位置将错位。
3. 字节序问题的深度解析与解决方案
字节序问题堪称工业通信领域的"头号杀手"。我们来看一个真实案例：某汽车生产线使用西门子PLC（Big-Endian）和第三方视觉设备（Little-Endian）通信，温度数据始终无法正确显示。
3.1 字节序组合实验
通过以下代码可以直观展示不同字节序组合对数据解析的影响：
import struct from pymodbus.payload import BinaryPayloadBuilder def endian_experiment(): test_float = 123.456 # 测试所有字节序组合 for byteorder in ['>', '<']: for wordorder in ['>', '<']: builder = BinaryPayloadBuilder( byteorder=byteorder, wordorder=wordorder ) builder.add_32bit_float(test_float) payload = builder.build() # 使用struct模块验证 fmt = f'{wordorder}{byteorder}f' unpacked = struct.unpack(fmt, payload)[0] print(f"Byte: {byteorder} Word: {wordorder} -> " f"原始值: {test_float} 解析值: {unpacked}")可能的输出结果：
Byte: > Word: > -> 原始值: 123.456 解析值: 123.456 Byte: > Word: < -> 原始值: 123.456 解析值: 1.729903e+22 Byte: < Word: > -> 原始值: 123.456 解析值: 2.9746e-39 Byte: < Word: < -> 原始值: 123.456 解析值: 123.4563.2 设备字节序速查表
不同厂商设备的典型配置：
| 设备类型 | 字节序(byteorder) | 字序(wordorder) | 备注 |
|---|---|---|---|
| 西门子S7-1200 | > (Big) | > (Big) | 典型的大端模式 |
| 三菱FX系列 | < (Little) | > (Big) | 寄存器内字节反转 |
| 欧姆龙CP1E | > (Big) | < (Little) | 特殊混合模式 |
| ABB AC500 | 可配置 | 可配置 | 需查看参数设置 |
| 施耐德Modicon | > (Big) | > (Big) | 传统Modbus标准实现 |
4. 工业实战：完整通信流程示例
让我们通过一个完整的温度监控系统案例，展示实际项目中的最佳实践。系统需要：
- 从PLC(地址40001)读取温度值(32位浮点数)
- 从PLC(地址40005)读取设备状态字符串(20字节ASCII)
- 向PLC(地址40020)写入新的温度设定值(32位浮点数)
4.1 通信协议定义
from dataclasses import dataclass @dataclass class PLCAddressMap: TEMPERATURE_READ = 40001 # 32位浮点数 DEVICE_INFO = 40005 # 20字节ASCII字符串 TEMPERATURE_SET = 40020 # 32位浮点数4.2 安全通信实现
import logging from pymodbus.exceptions import ModbusException class PLCTemperatureController: def __init__(self, host, port=502): self.client = ModbusTcpClient(host, port) self.logger = logging.getLogger(__name__) def read_temperature(self): try: response = self.client.read_holding_registers( address=PLCAddressMap.TEMPERATURE_READ, count=2 ) decoder = BinaryPayloadDecoder.fromRegisters( response.registers, byteorder=Endian.Big, wordorder=Endian.Big ) return decoder.decode_32bit_float() except ModbusException as e: self.logger.error(f"温度读取失败: {e}") return None def write_setpoint(self, temperature): builder = BinaryPayloadBuilder( byteorder=Endian.Big, wordorder=Endian.Big ) builder.add_32bit_float(temperature) try: self.client.write_registers( address=PLCAddressMap.TEMPERATURE_SET, values=builder.to_registers() ) return True except ModbusException as e: self.logger.error(f"设定值写入失败: {e}") return False def __enter__(self): self.client.connect() return self def __exit__(self, exc_type, exc_val, exc_tb): self.client.close()4.3 错误处理与调试技巧
在实际工业环境中，以下调试方法非常实用：
原始数据检查：先读取原始寄存器值，确认物理层通信正常
raw_data = client.read_holding_registers(address, count).registers print(f"原始寄存器值: {raw_data}")字节序快速测试：当不确定设备字节序时，可以写入已知值测试
test_values = { '32bit_float': 1.0, '16bit_int': -100, 'string': 'TEST' }交叉验证工具：使用Modbus Poll等专业工具与Python代码交叉验证
日志记录建议：在关键步骤添加详细日志
logger.debug(f"解码前寄存器值: {registers}") logger.debug(f"解码后数据: {decoded_data}")
在完成上述代码实现后，实际部署时发现三菱PLC的字符串显示异常。经过分析，发现三菱设备使用特殊的字节序组合（Big Word/Little Byte），通过调整解码器参数后问题解决：
# 三菱FX系列特殊配置 decoder = BinaryPayloadDecoder.fromRegisters( registers, byteorder=Endian.Little, # 注意此处不同 wordorder=Endian.Big )