Pymodbus写入寄存器：字节与字编码适配问题求助

问题背景 #

使用Pymodbus的WriteMultipleRegistersRequest类时，其encode方法通过struct.pack('>H', value)将输入值按**16位字（大端序）**编码到报文中。但IO Link主站需要的是特定的字节序列：

0x00, 0x01, 0x64, 0x00, 0x00, 0x01, 0x01, 0x01, 0x00, 0x00, 0x01, 0x00, 0x01, 0x00, 0x04, 0x38

Pymodbus默认编码会给每个单字节值补前导0x00，生成错误的序列：

0x0 0x1 0x0 0x64 0x0 0x0 0x0 0x0 0x0 0x1 0x0 0x1 0x0 0x1 0x0 0x0 0x0 0x0 0x0 0x1 0x0 0x0 0x0 0x1 0x0 0x0 0x0 0x4 0x0 0x38

希望保留Pymodbus的其他功能，避免手动构建完整报文，以下是最优解决方案：

解决方案 #

方法1：手动将字节打包为16位寄存器值（推荐） #

Modbus协议本身以16位寄存器为单位传输，因此直接将目标字节序列两两按大端序组合为16位字，作为write_registers的输入值即可。这样Pymodbus编码后会还原出正确的字节序列。

示例代码：

# 目标字节序列
target_bytes = [0x00, 0x01, 0x64, 0x00, 0x00, 0x01, 0x01, 0x01, 0x00, 0x00, 0x01, 0x00, 0x01, 0x00, 0x04, 0x38]

# 按大端序将字节两两打包为16位寄存器值
register_values = []
for i in range(0, len(target_bytes), 2):
    # 高字节左移8位 + 低字节
    register_val = (target_bytes[i] << 8) | target_bytes[i+1]
    register_values.append(register_val)

# 使用Pymodbus发送请求
from pymodbus.client import ModbusTcpClient

client = ModbusTcpClient("your_iolink_master_ip", port=502)
client.connect()
# 起始寄存器地址设为你需要的地址，这里以0为例，共8个寄存器（对应16字节）
client.write_registers(address=0, values=register_values)
client.close()

方法2：重载WriteMultipleRegistersRequest的编码逻辑 #

如果不想手动打包字节，可以继承WriteMultipleRegistersRequest类，重写encode方法，直接按字节拼接报文，同时保留Pymodbus的请求处理、错误响应等功能。

示例代码：

from pymodbus.register_write_message import WriteMultipleRegistersRequest
from pymodbus.compat import struct

class ByteAlignedWriteRequest(WriteMultipleRegistersRequest):
    def __init__(self, address, byte_values, **kwargs):
        # 寄存器数量为字节数的一半（必须是偶数，符合Modbus协议）
        register_count = len(byte_values) // 2
        super().__init__(address, [0]*register_count, **kwargs)
        self.byte_values = byte_values

    def encode(self):
        # 按照Modbus协议格式编码：地址(2B) + 寄存器数量(2B) + 字节数(1B) + 数据(NB)
        packet = struct.pack('>HH', self.address, self.count)
        packet += struct.pack('>B', len(self.byte_values))
        # 直接拼接目标字节序列
        for byte in self.byte_values:
            packet += struct.pack('>B', byte)
        return packet

# 使用自定义请求类发送
client = ModbusTcpClient("your_iolink_master_ip", port=502)
client.connect()
request = ByteAlignedWriteRequest(address=0, byte_values=target_bytes)
response = client.execute(request)
client.close()

方法3：使用BinaryPayloadBuilder自动打包 #

利用Pymodbus的BinaryPayloadBuilder工具，逐个添加8位字节，再转换为寄存器值列表，无需手动计算打包逻辑。

示例代码：

from pymodbus.payload import BinaryPayloadBuilder
from pymodbus.constants import Endian
from pymodbus.client import ModbusTcpClient

# 初始化Builder，设置大端序（符合Modbus默认）
builder = BinaryPayloadBuilder(byteorder=Endian.Big, wordorder=Endian.Big)
# 逐个添加目标字节
for b in target_bytes:
    builder.add_8bit_uint(b)

# 转换为寄存器值列表
register_values = builder.to_registers()

# 发送请求
client = ModbusTcpClient("your_iolink_master_ip", port=502)
client.connect()
client.write_registers(address=0, values=register_values)
client.close()

内容的提问来源于stack exchange，提问作者timoh