漏掉一次除法,首次工厂演示把 35°C 显示成 350
Node-RED 一个下午就能把 Modbus、OPC UA 接到 MQTT,坑在数值换算、装包重启和编辑器安全。
要点速览
- MQTT 用内置的 in/out 节点即可;Modbus 和 OPC UA 需要另装包,装完要重启 Node-RED
- Modbus 寄存器只是 16 位整数,原始值通常要按寄存器表换算后再发布
- 编辑器默认不设任何安全保护,在工厂网络中长期运行 Node-RED 之前,要先启用 adminAuth 和 HTTPS
通过 Modbus 读取温度传感器,可能读到数字 350。FlowFuse 正是用这个例子说明,实际温度是 35.0°C。设想车间里的第一次演示,仪表盘显示炉温 350 度:漏掉一次除法,就足以让演示失败。
如果你是前线部署工程师(FDE),要为制造业客户部署数据或 AI 产品,第一个问题几乎总是同一个:怎么把 PLC 里的读数拿出来?设备说的是 Modbus 或 OPC UA,你的系统要的是 MQTT。
Node-RED 能快速搭起这座桥。它是一款基于流的编程工具,起源于 IBM 新兴技术服务(Emerging Technology Services)团队,编辑器运行在浏览器中:把节点连起来就行,不必从零写一个服务。但它有几个坑,最好在去现场之前就了解清楚。
哪些是内置的,哪些需要安装?
MQTT 是内置的。Node-RED cookbook 介绍了 MQTT in 和 MQTT out 节点的用法,另需一个配置节点来定义 broker。如果本地已经运行了 broker,host 填 localhost,端口保持 1883 即可。带安全认证的 broker 需要额外配置。
设备一侧需要安装。FlowFuse 指出,Node-RED 默认不带 Modbus 节点。node-red-contrib-modbus 包同时支持 Modbus TCP 和串口,可以通过 Palette Manager 安装,也可以用 npm install 安装。OPC UA 则用 node-red-contrib-opcua 包,它基于 node-opcua 库,在 Node-RED 目录下用 npm 安装。
官方文档里有一个容易忽略的细节:装完包后必须重启 Node-RED,新节点才会生效。如果是在客户正在运行的网关上操作,要提前告知运维人员会有这次重启。
Modbus:一个寄存器,一次除法
据 Chipkin 的指南,Modbus 寄存器只是一个 16 位整数,没有单位,也没有小数点。这个数字的含义写在设备的寄存器表里。寄存器表标明分辨率为 0.1 时,原始值要除以 10。
假设客户的寄存器表里有这样一行:1 号炉传感器,一个保持寄存器,16 位整数,分辨率 0.1,单位 °C。Modbus 节点读到 350。如果原样发布,仪表盘就会显示炉温 350 度。
因此,最小的流包括四个环节:Modbus 节点读取寄存器,function 节点做换算,MQTT out 发布到结构化的 topic,最后由 broker 接收数据。下面的代码仅作示意,假设原始值已经在 msg.payload 中:
// 系数取自寄存器表:分辨率 0.1 → 除以 10
const raw = msg.payload; // 例如 350
msg.payload = raw / 10; // 35.0(°C)
msg.topic = "factory/furnace-1/temperature";
return msg;
代码里的 10 不是凭空来的,它来自寄存器表。每台设备的寄存器表都要向客户要。
32 位浮点数:两个寄存器,顺序由厂商决定
更难处理的是 32 位浮点数。每个值占两个寄存器,而 Chipkin 指出,各家厂商对这两个寄存器的排列顺序各不相同。只有和具体设备的顺序一致,才能正确解码。
看一个实际例子:35.0 按标准 32 位浮点数表示为 0x420C0000。如果设备先发高位字,Modbus 节点会读到两个整数 [16908, 0],因为 0x420C 等于 16908。下面的示意代码把两个寄存器拼成 4 个字节,再按浮点数读出:
// 假设寄存器表注明:32 位浮点,高位字在前
const [hi, lo] = msg.payload; // 例如 [16908, 0]
const buf = Buffer.alloc(4);
buf.writeUInt16BE(hi, 0);
buf.writeUInt16BE(lo, 2);
msg.payload = buf.readFloatBE(0); // 35
return msg;
如果厂商先发低位字,payload 就是 [0, 16908]。用同一段代码处理,得到的是一个接近 0 的极小数,而不是 35。修正方法很简单,交换两行 write 即可,但前提是知道顺序:要么查寄存器表,要么用已知值实测。
当数据混合了多种类型或需要字节交换时,FlowFuse 建议使用 buffer-parser 节点,而不是手写代码。无论用哪种方式,都要先和客户 HMI 屏幕上的读数核对,再相信这个数字。
OPC UA:endpoint、READ,然后接 MQTT
FlowFuse 的 OPC UA 分步指南很简短。把 OpcUa-Client 节点拖进流中,点击 Endpoint 字段旁边的“+”,填入一台正在运行的 OPC UA 服务器的 URL。如果服务器没有启用安全设置,policy 可以保留为 None。
接着,action 类型选 READ,再把节点输出连到指向 broker 的 mqtt out 节点。完成这三步后,从服务器读到的值就会进入 MQTT topic。
policy 为 None 只适合测试。所以去现场之前,要和工厂工程师一起列出 endpoint 清单、需要的变量及其单位,并确认服务器是否启用了安全设置。这份清单才是真正的工作量,连节点反而轻松得多。
现场四类常见错误
这四类错误值得打印出来,每次出差都带上:
| 错误 | 后果 | 如何避免 |
|---|---|---|
| 发布原始值 | 仪表盘显示 350,而不是 35.0°C | 按寄存器表换算;32 位浮点数要匹配厂商的寄存器顺序 |
| 编辑器保持默认设置 | 网络上的任何人都能修改流 | 在 settings.js 中取消 adminAuth 的注释,再改用 HTTPS |
| OT 网络无外网,缺少包 | 现场无法安装 Modbus 或 OPC UA 节点 | 去现场前准备好包,并测试安装 |
| Node.js 版本过旧 | Modbus 包无法运行 | 该包需要 Node.js 22 及以上、Node-RED 4 及以上;Node-RED 推荐 Node 24.x |
第二类错误值得展开说。Node-RED 的安全文档明确指出,默认编辑器不受保护,只适合可信网络。放在工厂里,这意味着任何能接入网络的人都能修改连着设备的流。
第三类错误源于安装方式。无论用 palette 还是 npm,都要下载包。如果客户的 OT 网络不能访问外网,到了现场当天才发现就太晚了。
第四类也值得远程提前检查:Node-RED 5.x 至少需要 Node.js 22,老旧网关可能得先升级。
先学什么,简历上写什么?
先学 MQTT(topic、broker、命名规范),再学 Modbus 如何用寄存器存储数据,最后再学 OPC UA。学习过程中,把 settings.js 仔细读一遍,弄清安全设置在哪里。
在岗位描述中,OT/IT 集成、MQTT、PLC 数据之类的字眼,说明这个岗位正需要搭这类数据桥。简历上写一句具体的“搭建 Modbus 和 OPC UA 到 MQTT 的数据桥,按寄存器表换算寄存器值,启用 adminAuth 和 HTTPS”,比“有 IoT 经验”有说服力得多。
整条链路都可以在笔记本上练习。用 inject 节点发出 350 来代替真实设备,经过上面的 function 节点,把 35.0 发布到本地 1883 端口的 broker。然后把 [16908, 0] 注入浮点解码器,再改成 [0, 16908],看看错误结果是什么样子,最后启用 adminAuth,重新登录编辑器。
在工厂 AI 项目里,Node-RED 不是光鲜的部分。但如果经过它的数据单位错了,下游的每个模型也都会跟着错。
这篇文章对你有帮助吗?
感谢你的反馈!
10 个信源
- About : Node-RED
- Securing Node-RED : Node-RED
- How to Bridge Modbus to MQTT: Step-by-Step Guide · 2026-08-13
- Modbus Scaling & Data Conversion Guide · 2026-03-12
- BiancoRoyal/node-red-contrib-modbus (GitHub)
- node-red-contrib-opcua : Node-RED Library
- Bridging OPC UA Data to MQTT with Node-RED (2026) · 2026-06-03
- Supported Node versions · 2026-06
- Adding nodes to the palette : Node-RED
- Connect to an MQTT Broker, Node-RED Cookbook