Pymodbus v3.8.3中如何调用0x41、0x42这类Modbus功能码？

核心解决方法：发送自定义报文调用厂商功能码 #

Pymodbus没有直接封装0x41、0x42这类厂商自定义功能码的现成方法，直接通过client.execute()发送自定义请求报文即可，具体步骤如下：

1. 0x42功能码（重置测量寄存器）示例代码 #

0x42无需额外参数，直接构造请求执行：

from pymodbus.client import ModbusSerialClient
from pymodbus.pdu import ModbusRequest

# 初始化RTU客户端，参数根据你的设备和串口调整
client = ModbusSerialClient(
    method='rtu',
    port='/dev/ttyUSB0',
    baudrate=9600,
    parity='N',
    stopbits=1,
    timeout=1
)

client.connect()

# 构造0x42功能码请求，slave为设备从站地址（默认一般是1）
reset_req = ModbusRequest(function_code=0x42, slave=1)
response = client.execute(reset_req)

if not response.isError():
    print("测量寄存器重置成功")
else:
    print(f"重置失败: {response}")

client.close()

2. 0x41功能码（厂商校准）示例代码 #

0x41需要携带校准参数（格式以设备 datasheet 为准），用BinaryPayloadBuilder构造参数后发送：

from pymodbus.client import ModbusSerialClient
from pymodbus.pdu import ModbusRequest
from pymodbus.payload import BinaryPayloadBuilder

client = ModbusSerialClient(
    method='rtu',
    port='/dev/ttyUSB0',
    baudrate=9600,
    parity='N',
    stopbits=1,
    timeout=1
)

client.connect()

# 按 datasheet 构造校准参数（示例为电压校准，值需放大10倍）
builder = BinaryPayloadBuilder(endian='big')
builder.add_16bit_int(2200)  # 对应220.0V校准值
builder.add_16bit_int(0)     # 其他校准参数，按文档要求填写

calibrate_req = ModbusRequest(function_code=0x41, slave=1)
calibrate_req.payload = builder.build()  # 附加校准参数

response = client.execute(calibrate_req)

if not response.isError():
    print("校准指令发送成功")
else:
    print(f"校准失败: {response}")

client.close()

Pymodbus常用功能码速查表 #

• 0x01 读线圈：client.read_coils(address, count, slave)
• 0x02 读离散输入：client.read_discrete_inputs(address, count, slave)
• 0x03 读保持寄存器：client.read_holding_registers(address, count, slave)
• 0x04 读输入寄存器：client.read_input_registers(address, count, slave)
• 0x05 写单个线圈：client.write_coil(address, value, slave)
• 0x06 写单个保持寄存器：client.write_register(address, value, slave)
• 0x10 写多个保持寄存器：client.write_registers(address, values, slave)
• 厂商自定义功能码：用ModbusRequest构造请求后，通过client.execute()发送

注意事项 #

• 确认设备的从站地址（slave ID），PZEM-004T默认通常为1
• 串口参数（波特率、奇偶校验等）必须与设备设置完全匹配
• 0x41校准功能的参数格式严格遵循设备 datasheet，错误参数可能导致设备异常
• 执行自定义请求后，通过response.isError()判断操作是否成功

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