Skip to content

v1.16.2

Latest

Choose a tag to compare

@github-actions github-actions released this 16 Nov 00:54

✨ 新增 — Modbus RTU 从站支持严格 RTU over TCP(用户反馈 issue #37 系列场景)

v1.11.1 的 tcp_bridge 说的是 Modbus TCP(MBAP)帧;串口服务器透传场景
(NPort/USR-TCP232 等把 RTU 串口透传成 TCP)需要的是 RTU 帧直走 TCP
(addr+PDU+CRC16,无 MBAP 头)——本版补上该模式:

  • Modbus RTU 高级配置新增 mode=rtu_over_tcp(TCP 端口默认 5022):
    pymodbus framer=FramerType.RTU over TCP 客户端、任何串口服务器透传
    链路可直接对接
  • 帧处理复用串口模式(v1.9.1)的 _extract_rtu_frame(CRC 校验/字节流
    错位重同步/广播不响应语义完全一致),传输层换 TCP
  • port 语义修正:显式指定 mode=rtu_over_tcp/tcp_bridge 时 int port
    不再被旧兼容逻辑强制覆盖为 tcp_bridge
  • 高级配置面板暴露 mode 与 rtu_over_tcp_port

🧪 测试(tests/test_rtu_over_tcp.py 2 例)

  • pymodbus RTU-framer 客户端直连从站:读保持寄存器(float32 精确 25.5)+
    写线圈 → 从站反映
  • ProtoForge 主站(mode=rtu_over_tcp)↔ 从站互连:轮询采集 + 远端写
  • 测试方法学教训:pymodbus 同步客户端必须跑在线程里(asyncio.to_thread)
    ——直接在测试协程里调用会阻塞事件循环饿死从站协程(表现为 No response 假超时)

Full Changelog: v1.16.1...v1.16.2