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. 建立寄存器映射
当前映射支持:
| 区域 | 典型功能码 | 可映射类型 |
|---|---|---|
| Coil | 01/05/15 | Bool |
| Discrete Input | 02 | Bool |
| Holding Register | 03/06/16 | Int16、UInt16、Int32、Float32 |
| Input Register | 04 | Int16、UInt16、Int32、Float32 |
32 位类型支持大端或小端选择。地址既可按设备提供的寄存器编号填写,也可能涉及 0 基/1 基换算;测试前必须对照设备手册。
映射保存后执行“测试连接”,再在线观察变量。连接成功不代表数值正确,还要核对比例系数、字节序和单位。
3. 配置 MQTT 连接
在 MQTT 配置中填写 Broker、客户端 ID、协议版本、认证、TLS、保活和重连参数。客户端 ID 必须唯一;生产连接应使用 Broker 提供的受信证书。
4. 新增 MQTT 上行映射
每个上行项需要设置变量、主题、数据类型、QoS、Retain、编码、采样周期和数值死区。
主题必须由项目统一规划。QoS 1 可能重复投递,接收方应做幂等处理;Retain 只用于确需保留的状态。
5. 离线队列
Broker 断线或发布失败时,上行数据进入离线队列,重连后按顺序补发。队列容量有限,外部系统仍应容忍数据间断和重复。
6. 验证
- 在线监控中确认 Modbus 变量持续更新。
- 在 MQTT 状态中确认桥已运行且上行数量正确。
- 核对已发布、排队、丢弃和最后错误计数。
- 断开 Broker,确认 PLC 控制不受影响且消息进入队列。
- 恢复 Broker,确认队列下降并处理可能的重复消息。
使用边界
- MQTT 下行只写明确授权的设定变量,不能直接控制安全输出。
- DarraRT 永久不在通讯桥接中实现 MES / ERP / OEE / SPC 业务。
- 控制命令和安全输出不得依赖 MQTT。
排错
| 现象 | 先检查 |
|---|---|
| Modbus 连接失败 | IP/串口、端口、站号、超时、串口参数 |
| 数值错位 | 地址基准、类型、字节序、比例系数 |
| MQTT 连接失败 | Broker URL、认证、证书、系统时间 |
| 有变量但不发布 | 上行映射、主题、类型、采样周期 |
| 队列持续增长 | Broker 可达性、发布权限、最后错误 |
| 下行不生效 | 目标变量权限、数据类型、运行状态和安全条件 |