Python中Modbus正确引用及pymodbus读取寄存器返回乱码问题问询

核心需求 #

• 掌握Python生态下MODBUS通信库的正确引用、调用方式
• 实现Morningstar太阳能控制器的数据读取，目标读取范围为Read Holding Registers（功能码0x03） 下前15个地址区间的运行参数
• 已对照控制器官方MODBUS协议文档明确各参数的寄存器存储规则，当前设备通信可连通，但返回数值均为无意义乱码

现有测试代码 #

from pymodbus.client.sync import ModbusSerialClient as ModbusClient
 
client = ModbusClient(method = 'rtu', port = 'COM1', baudrate = 9600)
client.connect()
 
result = client.read_input_registers(0x003,6,unit=1)
solarVoltage = float(result.registers[0] )
chargingCurrent = float(result.registers[1] )
batteryVoltage = float(result.registers[2] )
batteryTemperature = float(result.registers[3] )
 
# Do something with the data
print(solarVoltage)
print(chargingCurrent)
print(batteryVoltage)
print(batteryTemperature)
 
client.close()

测试过程记录 #

• 读取6个寄存器的原始返回值序列为：[0, 17058, 18943, 17662, 18634, 18938, 26098, 8374, 42046, 32768]
• 原计划读取逻辑地址5-30的参数区间，测试将读取起始地址调整为0x0004时，返回寄存器值为17056
• 现存待确认问题：乱码来源无法判定为浮点数格式解析错误，还是寄存器地址读取偏差

问题根因与修正方案 #

1. 功能码调用不匹配 #

现有代码使用read_input_registers方法，对应MODBUS功能码0x04（读取输入寄存器），与目标读取的保持寄存器（功能码0x03）要求不匹配，读取到的地址空间不属于目标参数存储区。

• 修正方式：替换读取方法为read_holding_registers，确保功能码与协议文档要求一致。

2. 寄存器地址偏移规则未适配 #

MODBUS协议通用地址偏移约定：设备文档中标注的逻辑地址，通常比pymodbus可直接传入的寄存器起始地址大1。

• 修正方式：若文档标注逻辑起始地址为5，传入pymodbus的实际起始地址应为0x0004，与前期测试的调整方向匹配，需配合正确的读取函数使用。

3. 数值解析规则偏差 #

Morningstar控制器的寄存器数值并非通过单寄存器16位值直接转换浮点数，需严格对照协议文档定义的规则解析：

• 大部分参数为带符号整数格式，需按照文档标注的分辨率（比例系数）换算实际值，例如电压类参数通常分辨率为0.01V，原始寄存器值乘以0.01即为实际电压
• 不存在单寄存器存储float16格式的定义，无需进行float16类型转换

4. 通信参数匹配校验 #

• 确认MODBUS RTU通信的串口配置与控制器默认值一致，Morningstar控制器默认串口参数通常为8数据位、无校验、1停止位（8N1）
• 确认从站地址（unit参数）与控制器实际配置一致，避免跨设备读取无关空间的数据

修正后参考代码 #

from pymodbus.client.sync import ModbusSerialClient as ModbusClient

# 初始化RTU客户端，匹配控制器默认通信参数
client = ModbusClient(
    method='rtu',
    port='COM1',
    baudrate=9600,
    bytesize=8,
    parity='N',
    stopbits=1
)
client.connect()

# 调用正确的保持寄存器读取方法，适配地址偏移规则
result = client.read_holding_registers(
    address=0x0004,  # 对应文档逻辑地址5
    count=6,
    unit=1
)

# 按照协议定义的规则解析原始寄存器值
raw_registers = result.registers
# 示例：电池电压，分辨率0.01V
battery_voltage = raw_registers[0] * 0.01
# 示例：充电电流，分辨率0.01A
charging_current = raw_registers[1] * 0.01
# 示例：太阳能阵列电压，分辨率0.01V
solar_voltage = raw_registers[2] * 0.01
# 示例：电池温度，分辨率1℃，固定偏移量-20℃
battery_temperature = raw_registers[3] - 20

print(solar_voltage)
print(charging_current)
print(battery_voltage)
print(battery_temperature)

client.close()

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