# 漏掉一次除法，首次工厂演示把 35°C 显示成 350

> Node-RED 一个下午就能把 Modbus、OPC UA 接到 MQTT，坑在数值换算、装包重启和编辑器安全。

原文: https://fdetimes.net/zh/tools/node-red-opc-ua-modbus-to-mqtt/

通过 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 中：

```js
// 系数取自寄存器表：分辨率 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 个字节，再按浮点数读出：

```js
// 假设寄存器表注明：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 不是光鲜的部分。但如果经过它的数据单位错了，下游的每个模型也都会跟着错。

**本周动手试试:**

- 在 Node.js 22 及以上版本上安装 Node-RED 4 及以上版本，添加 node-red-contrib-modbus，用 inject 节点发出 350，把 35.0 发布到本地 1883 端口的 broker
- 在 settings.js 中取消 adminAuth 的注释，设置密码，再尝试重新登录编辑器
- 写一份出发前检查清单：Node.js 和 Node-RED 版本、要带的 contrib 包，以及要向客户索取的寄存器表和 OPC UA endpoint 清单

## 信源

- [About : Node-RED](https://nodered.org/about/)

- [Securing Node-RED : Node-RED](https://nodered.org/docs/user-guide/runtime/securing-node-red)

- [How to Bridge Modbus to MQTT: Step-by-Step Guide](https://flowfuse.com/blog/2024/12/publishing-modbus-data-to-uns)

- [Modbus Scaling & Data Conversion Guide](https://docs.chipkin.com/articles/modbus-scaling-and-data-conversion-guide/)

- [BiancoRoyal/node-red-contrib-modbus (GitHub)](https://github.com/BiancoRoyal/node-red-contrib-modbus)

- [node-red-contrib-opcua : Node-RED Library](https://flows.nodered.org/node/node-red-contrib-opcua)

- [Bridging OPC UA Data to MQTT with Node-RED (2026)](https://flowfuse.com/blog/2024/08/opc-ua-to-mqtt-with-node-red/)

- [Supported Node versions](https://nodered.org/docs/faq/node-versions)

- [Adding nodes to the palette : Node-RED](https://nodered.org/docs/user-guide/runtime/adding-nodes)

- [Connect to an MQTT Broker, Node-RED Cookbook](https://cookbook.nodered.org/mqtt/connect-to-broker)
