使用pymodbus读取Modbus设备数据失败的排查求助

1. 寄存器地址与功能码匹配问题 #

热电偶模块的温度数据通常存储在输入寄存器（对应Modbus功能码04，read_input_registers方法），而非你代码中使用的保持寄存器（功能码03）。另外注意地址偏移：

• 若官网文档标注的寄存器地址是0x01（十进制1），多数设备采用1-based地址编号，而pymodbus默认使用0-based索引，因此代码中需将register_address设为0；若文档明确是0-based，则设为1。

2. 串口参数与RS485收发控制 #

• 先修正代码中的语法错误：移除参数行末尾的-> data sheet注释（会导致代码报错），确保参数格式合法。
• RS485是半双工通信，需控制收发切换，在初始化客户端时添加rtscts=True参数（依赖CH340模块的RTS引脚切换收发）：

  client = ModbusClient(
      method='rtu',
      port='COM4',
      baudrate=9600,
      parity='N',
      stopbits=1,
      bytesize=8,
      timeout=5,
      rtscts=True  # 关键：启用RS485流控制
  )
  

• 再次核对模块文档的波特率、停止位、奇偶校验参数，确保与代码完全一致（部分模块默认波特率可能是19200而非9600）。

3. 硬件连接排查 #

• 确认RS485的A/B线未接反：严格按照模块标识连接（A接A，B接B），接反会导致无响应。
• 若通信环境存在干扰，尝试在RS485总线两端添加120Ω终端电阻（单设备连接时可省略，但多设备或长距离必须添加）。
• 检查CH340模块是否被其他程序占用（比如串口助手未关闭），导致无法建立通信。

4. 修正后的测试代码 #

from pymodbus.client import ModbusSerialClient as ModbusClient 

client = ModbusClient(
    method='rtu',
    port='COM4',
    baudrate=9600,
    parity='N',
    stopbits=1,
    bytesize=8,
    timeout=5,
    rtscts=True
)

# 先确认连接状态
if not client.connect():
    print("设备连接失败")
    exit()

device_address = 1
# 假设文档0x01是1-based输入寄存器，转换为0-based索引
register_address = 0
number_of_reads = 1

# 优先尝试读取输入寄存器（温度数据常用存储位置）
response = client.read_input_registers(register_address, number_of_reads, unit=device_address)

if response.isError():
    print(f"读取输入寄存器失败: {response}")
    #  fallback到读取保持寄存器
    response = client.read_holding_registers(register_address, number_of_reads, unit=device_address)
    if response.isError():
        print(f"读取保持寄存器失败: {response}")
    else:
        # 处理温度数据（部分模块用补码表示负数）
        raw_value = response.registers[0]
        if raw_value > 0x7FFF:
            raw_value = raw_value - 0x10000
        temperature = raw_value / 10.0
        print(f"温度（保持寄存器）: {temperature:.1f} °C")
else:
    raw_value = response.registers[0]
    if raw_value > 0x7FFF:
        raw_value = raw_value - 0x10000
    temperature = raw_value / 10.0
    print(f"温度（输入寄存器）: {temperature:.1f} °C")

client.close()

5. 底层调试方法 #

用串口调试工具（如串口助手）发送手动构造的Modbus RTU命令，验证硬件通信是否正常：

• 发送十六进制指令：01 04 00 00 00 01 31 CA（含义：读取地址1的输入寄存器0x0000，共1个寄存器）
• 若工具能收到设备返回，说明硬件和参数无问题，问题出在pymodbus代码；若无返回，继续排查硬件接线或模块参数设置。

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