Home Assistant连接Waveshare RS485转以太网适配器失败求助

1. 补全Modbus配置的关键参数 #

PC端Modbus Poll能正常通信，说明适配器与通风系统的Modbus参数匹配，重点补充HA配置中缺失的核心项：

• 单元ID（Slave ID）：RTU协议必须指定目标设备的Slave ID，默认HA配置未设置，需添加slave:字段（替换为通风系统实际Slave ID）：

  modbus:
    - type: rtuovertcp
      host: 192.168.1.231
      port: 502
      name: "RS485EthVentilator"
      slave: 1  # 替换为你的通风系统Slave ID
      timeout: 3  # 延长超时时间，默认1秒可能不足以适配NUC到适配器的网络延迟
  

• 超时时间：根据实际网络情况调整为2-5秒，避免因延迟导致通信中断。

2. 排查网络连通性 #

即使IP和端口正确，NUC的防火墙可能拦截出站502端口：

• 用NUC终端执行nc -zv 192.168.1.231 502，测试端口是否能连通。如果不通，先配置防火墙允许HA访问该端口。
• 检查NUC与适配器是否在同一VLAN，避免跨VLAN的路由限制。

3. 开启HA的Modbus详细日志 #

默认日志仅显示“通信关闭”，开启Debug级日志可查看具体报错细节：
在configuration.yaml中添加日志配置：

logger:
  default: info
  logs:
    homeassistant.components.modbus: debug
    pymodbus: debug

重启HA后查看日志，会显示Modbus请求报文、响应状态，可定位是CRC错误、Slave ID不匹配还是超时问题。

4. Node-RED节点调试优化 #

针对Node-RED的模糊报错，调整以下配置：

• 确认连接类型选择RTU over TCP，而非TCP模式。
• 在连接配置中指定正确Slave ID，将超时时间设为3秒以上。
• 改用Raw Request节点，手动构造与Modbus Poll一致的请求报文，对比响应差异。

5. Python脚本验证通信基础 #

用pymodbus编写测试脚本，先验证NUC到适配器的通信是否正常，排除HA组件的适配问题：

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

# 替换为实际参数
HOST = "192.168.1.231"
PORT = 502
SLAVE_ID = 1

client = ModbusTcpClient(host=HOST, port=PORT, timeout=3)
connection = client.connect()

if connection:
    print("连接成功")
    # 替换为你在Modbus Poll中使用的寄存器地址和数量
    response = client.read_holding_registers(address=0, count=2, slave=SLAVE_ID)
    if not response.isError():
        decoder = BinaryPayloadDecoder.fromRegisters(response.registers, byteorder=Endian.Big)
        print(f"读取数据: {decoder.decode_32bit_float()}")
    else:
        print(f"读取失败: {response}")
    client.close()
else:
    print("连接失败")

如果脚本能成功读取数据，说明通信基础正常，问题出在HA配置或组件适配；如果失败，重点检查适配器的RTU over TCP模式设置。

6. 确认适配器的工作模式 #

登录适配器网页管理界面，核对以下设置：

• 确认适配器工作在RTU over TCP模式（部分设备标注为“Modbus RTU转TCP”），而非纯TCP Server模式。
• 再次核对串口参数（波特率、数据位、停止位、奇偶校验），确保与通风系统、Modbus Poll的配置完全一致。

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