跳到主要内容

Modbus 转 MQTT

本页说明如何把 Modbus TCP、RTU-over-TCP 或串口 RTU 设备的寄存器映射为 PLC 变量,再通过 MQTT 上行发布。适合仪表、变频器和远程 I/O 的状态采集,不适合安全控制或毫秒级闭环。

数据路径​

Modbus 设备 → Modbus 变量映射 → PLC 变量 → MQTT 上行映射 → Broker

MQTT 下行只允许写入明确授权的设定变量,并且必须由 PLC 逻辑检查安全条件。本页重点说明 Modbus 数据上行。

1. 配置 Modbus 设备​

在 IDE 通讯配置中新增 Modbus 设备,选择传输方式:

  • Modbus TCP;
  • RTU-over-TCP;
  • Modbus RTU 串口。

连接参数​

按设备手册填写:

  • TCP:设备地址、端口、站号和超时;
  • 串口:端口、波特率、数据位、校验、停止位、站号和超时。

新建项中的初值只是填写起点,不能替代设备手册。

2. 建立寄存器映射​

当前映射支持:

区域典型功能码可映射类型
Coil01/05/15Bool
Discrete Input02Bool
Holding Register03/06/16Int16、UInt16、Int32、Float32
Input Register04Int16、UInt16、Int32、Float32

32 位类型支持大端或小端选择。地址既可按设备提供的寄存器编号填写,也可能涉及 0 基/1 基换算;测试前必须对照设备手册。

映射保存后执行“测试连接”,再在线观察变量。连接成功不代表数值正确,还要核对比例系数、字节序和单位。

3. 配置 MQTT 连接​

在 MQTT 配置中填写 Broker、客户端 ID、协议版本、认证、TLS、保活和重连参数。客户端 ID 必须唯一;生产连接应使用 Broker 提供的受信证书。

4. 新增 MQTT 上行映射​

每个上行项需要设置变量、主题、数据类型、QoS、Retain、编码、采样周期和数值死区。

主题必须由项目统一规划。QoS 1 可能重复投递,接收方应做幂等处理;Retain 只用于确需保留的状态。

5. 离线队列​

Broker 断线或发布失败时,上行数据进入离线队列,重连后按顺序补发。队列容量有限,外部系统仍应容忍数据间断和重复。

6. 验证​

  1. 在线监控中确认 Modbus 变量持续更新。
  2. 在 MQTT 状态中确认桥已运行且上行数量正确。
  3. 核对已发布、排队、丢弃和最后错误计数。
  4. 断开 Broker,确认 PLC 控制不受影响且消息进入队列。
  5. 恢复 Broker,确认队列下降并处理可能的重复消息。

使用边界​

  • MQTT 下行只写明确授权的设定变量,不能直接控制安全输出。
  • DarraRT 永久不在通讯桥接中实现 MES / ERP / OEE / SPC 业务。
  • 控制命令和安全输出不得依赖 MQTT。

排错​

现象先检查
Modbus 连接失败IP/串口、端口、站号、超时、串口参数
数值错位地址基准、类型、字节序、比例系数
MQTT 连接失败Broker URL、认证、证书、系统时间
有变量但不发布上行映射、主题、类型、采样周期
队列持续增长Broker 可达性、发布权限、最后错误
下行不生效目标变量权限、数据类型、运行状态和安全条件

相关文档​