node-red-contrib-mitsubishi 1.1.0

三菱 MC Protocol 3E/4E 采集节点 — 纯TCP零依赖, 支持Q/L/iQ-R/iQ-F/FX5U

npm install node-red-contrib-mitsubishi

node-red-contrib-mitsubishi

三菱 MC Protocol 3E/4E 以太网采集节点。一个节点读 N 个点位，零外部依赖，纯 TCP 实现。

截图

为什么选这个节点？

特性

• 独立可用 — 纯 Node.js net + Buffer，不依赖任何第三方库或后端服务
• 表格编辑器 — 一个节点配置 N 个点位，自动按寄存器类型和地址聚类，合并为批量读取
• 6 种数据类型 — INT16 / UINT16 / INT32 / UINT32 / FLOAT32 / BOOL
• 8 种软元件 — D / W / R / X / Y / M / L / B，位元件（X/Y/M/L/B）自动逐位拆包
• 斜率偏移变换 — engValue = rawValue × slope + offset，节点直接输出工程值
• 4E serialNo 完整支持 — 每帧自增，响应校验，防止串包
• 批量保护 — 单次读取字数超 960 自动拆包，防 PLC 报 0xC059
• 错误诊断 — 19 个 MC 错误码映射为中文/英文可读信息
• 模拟模式 — RED.settings.mcSimulationMode = true 不连 PLC 即可测试
• 零依赖 — 仅使用 Node.js 内置 net + Buffer
• 15+ 运行时 BUG 已修复 — 锁重入、异步异常、serialNo 首帧跳号、脏帧拦截、批量超限等

安装

cd ~/.node-red
npm install node-red-contrib-mitsubishi

重启 Node-RED，左侧节点栏出现 "三菱 PLC" 分类，包含两个节点：

支持的 PLC

使用方法

1. 添加 PLC 连接配置

拖入 PLC 连接配置 节点，双击配置：

2. 配置点位表格

拖入 MC 读取 节点，关联 PLC 配置，在表格中添加点位：

斜率/偏移公式：engValue = rawValue × slope + offset

例如 PLC 存温度原始值 2530（实际 253.0℃），设斜率 = 0.1，偏移 = 0，输出 engValue = 253.0

3. 触发采集

inject 节点 → MC 读取节点，部署后点击 inject 按钮即可采集。

4. 动态点位（高级）

上游节点传入 msg.tags 会覆盖表格配置，适配 EdgeLink 采集管线：

msg.tags = [
  { id: "温度", regType: "D", addr: 100, dataType: "INT16", slope: 0.1, offset: 0 },
  { id: "压力", regType: "D", addr: 200, dataType: "FLOAT32" }
];

输出格式

正常采集

msg.payload = {
  success: true,
  deviceId: "PLC-1",          // 适配 edgelink-pg-store 动态分表
  data: {
    "温度": {
      rawValue: 2530,         // PLC 原始 int16
      engValue: 253.0,        // 解码后 × 斜率 + 偏移
      quality: 0,             // 0=正常 2=异常
      ts: "2026-06-30T08:00:00.000Z",
      regType: "D"            // 寄存器类型
    },
    "压力": {
      rawValue: 4123,
      engValue: 41.23,
      quality: 0,
      ts: "2026-06-30T08:00:00.000Z",
      regType: "D"
    },
    "开关": {
      rawValue: 1,
      engValue: 1,
      quality: 0,
      ts: "2026-06-30T08:00:00.000Z",
      regType: "X"
    }
  },
  error: null,
  driverType: "driver-mc-protocol",
  plcIp: "192.168.1.10",
  plcPort: 5007,
  roundTimeMs: 12
}

PLC 读取失败

msg.payload = {
  success: false,
  deviceId: "PLC-1",
  data: {},
  error: "[PLC 0xC052] Address out of range",
  driverType: "driver-mc-protocol",
  plcIp: "192.168.1.10",
  plcPort: 5007,
  roundTimeMs: 3012
}

网络故障

msg.payload = {
  success: false,
  deviceId: "PLC-1",
  data: {},
  error: "[NETWORK] TCP closed (no data)",
  ...
}

架构

┌──────────┐     ┌─────────────────────────────┐     ┌──────────┐
│ inject / │     │     mitsubishi-read          │     │ 三菱 PLC │
│ 动态tags │────→│                              │────→│          │
└──────────┘     │  1. 校验 + 清洗点位          │     │ Q / L /  │
                 │  2. 去重 + 聚类分组          │     │ iQ-R /   │
                 │  3. 逐组 3E/4E 帧请求        │     │ FX5U     │
                 │  4. 解码 + 斜率变换          │     └──────────┘
                 │  5. 输出 {raw,eng,quality}   │
                 └─────────────────────────────┘

 帧构造: build3EFrame / build4EFrame
 响应解析: parseMCResponse (subheader + endCode + serialNo + dataLen 校验)
 错误分类: 19 个 MC 错误码 + 网络错误 + 脏帧拦截
 锁机制: 按 host:port 维度全局锁，串行采集，60s 过期自释放

与 node-red-contrib-mcprotocol 对比

模拟模式

在 Node-RED settings.js 中添加：

mcSimulationMode: true

重启后所有 MC 读取 节点不连 PLC，直接返回随机仿真数据。用于离线开发、CI 测试、Demo 演示。

与 EdgeLink 生态集成

┌──────────────────┐     ┌──────────────────────┐     ┌──────────────────┐
│ node-red-contrib │     │ node-red-contrib     │     │ PostgreSQL /     │
│ -mitsubishi      │────→│ -edgelink-pg         │────→│ TimescaleDB      │
│ (本节点)         │     │ (PG 批量写入)        │     │                  │
└──────────────────┘     └──────────────────────┘     └──────────────────┘

本节点输出的 deviceId、regType、rawValue、engValue、quality、ts 字段可由 edgelink-pg-store 自动识别为 MC 驱动格式，零配置写入数据库。

FAQ

Q: 为什么不用连接池？
MC 协议是无状态短连接。每次采集建立 TCP → 发送帧 → 接收响应 → 关闭。用连接池不会带来性能提升（TCP 握手开销远小于 PLC 扫描周期），反而有状态泄漏风险。

Q: 能同时读多个 PLC 吗？
可以。每个 PLC 连接配置 配置一个 PLC。多个 MC 读取 节点关联不同配置即可。全局锁按 host:port 隔离，不同 PLC 并行执行。

Q: 点位地址能写成 "D100" 格式吗？
可以。地址字段兼容 "D100" 格式（自动提取数字部分），也支持纯数字 100。

Q: switch 元素一次最多读多少个点位？
字元件单次最多 960 字，位元件单次最多 15360 点。超出自动拆组，无需手动干预。

Q: 支持 FX3U 吗？
带以太网模块（FX3U-ENET）支持 3E 帧。不带以太网模块的 FX3U 不支持（需要 1E 帧或串口）。

许可证

MIT · 可自由商用、修改、再发布