node-red-contrib-mitsubishi 1.0.0

package/README.md

@@ -0,0 +1,58 @@
+# node-red-contrib-mitsubishi
+
+三菱 MC Protocol 3E/4E 以太网采集节点，零依赖纯 TCP 实现。
+
+## 特性
+
+- **独立可用** — 脱离任何后端，拖拽配置即可采集 PLC 数据
+- **表格编辑器** — 一个节点读 N 个点位，自动聚类合并批量读取
+- **6 种数据类型** — INT16/UINT16/INT32/UINT32/FLOAT32/BOOL
+- **8 种软元件** — D/W/R/X/Y/M/L/B，位元件自动拆包
+- **斜率偏移变换** — `engValue = rawValue × slope + offset`，节点直接出最终值
+- **错误诊断** — 19 个 MC 错误码映射为中文可读信息
+- **模拟模式** — 全局 `mcSimulationMode=true` 不连 PLC 直接返回仿真数据
+- **零依赖** — 仅使用 Node.js 内置 `net` + `Buffer`
+
+## 支持的 PLC
+
+| 系列 | 帧格式 | 状态 |
+|------|--------|------|
+| Q 系列 (QnU/QnUDV) | 3E/4E | ✅ |
+| L 系列 | 3E/4E | ✅ |
+| iQ-R | 4E | ✅ |
+| iQ-F (FX5U) | 4E | ✅ |
+| FX3U + 以太网模块 | 3E | ✅ |
+| A 系列 | 1E/2E | ❌ |
+
+## 安装
+
+```bash
+cd ~/.node-red
+npm install node-red-contrib-mitsubishi
+```
+
+重启 Node-RED，左侧节点栏出现 **"三菱 PLC"** 分类。
+
+## 使用方法
+
+拖入 `MC 读取` 节点 → 添加 `PLC 连接配置` → 在表格中添加点位 → 部署 → inject 触发。
+
+**输入**: empty（使用节点表格配置）或 `msg.tags`（动态覆盖）
+
+**输出**: `msg.payload.data[tagId] = { rawValue, engValue, quality, ts }`
+
+## 与 node-red-contrib-mcprotocol 对比
+
+| | 本节点 | mcprotocol 插件 |
+|------|---------|-----------|
+| 点位数量 | N 个/节点 | 1 个/节点 |
+| 批量优化 | ✅ 智能聚类 | ❌ |
+| dataType | 6 种 | INT16 |
+| 位元件 | ✅ 拆包 | ❌ |
+| eng 变换 | ✅ | ❌ |
+| 错误诊断 | 中文可读 | "timeout" |
+| 模拟模式 | ✅ | ❌ |
+
+## 许可证
+
+MIT

package/nodes/mitsubishi-config.html

@@ -0,0 +1,62 @@
+<script type="text/x-red" data-template-name="mitsubishi-config">
+  <div class="form-row">
+    <label for="node-config-input-name"><i class="fa fa-tag"></i> 名称</label>
+    <input type="text" id="node-config-input-name" placeholder="PLC-1">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-host"><i class="fa fa-globe"></i> IP 地址</label>
+    <input type="text" id="node-config-input-host" placeholder="192.168.1.10">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-port"><i class="fa fa-plug"></i> 端口</label>
+    <input type="number" id="node-config-input-port" placeholder="5007" min="1" max="65535">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-frame"><i class="fa fa-exchange"></i> 帧格式</label>
+    <select id="node-config-input-frame">
+      <option value="3E">3E (Q/L/FX3U)</option>
+      <option value="4E">4E (iQ-R/iQ-F/FX5U)</option>
+    </select>
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-networkNo"><i class="fa fa-sitemap"></i> 网络号</label>
+    <input type="number" id="node-config-input-networkNo" value="0" min="0" max="255">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-stationNo"><i class="fa fa-server"></i> 站号</label>
+    <input type="number" id="node-config-input-stationNo" value="0" min="0" max="255">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-timeout"><i class="fa fa-clock-o"></i> 超时 (ms)</label>
+    <input type="number" id="node-config-input-timeout" value="3000" min="500" max="30000">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-maxRetries"><i class="fa fa-repeat"></i> 重试次数</label>
+    <input type="number" id="node-config-input-maxRetries" value="2" min="0" max="10">
+  </div>
+  <div class="form-row">
+    <label for="node-config-input-retryInterval"><i class="fa fa-hourglass-half"></i> 重试间隔 (ms)</label>
+    <input type="number" id="node-config-input-retryInterval" value="300" min="50" max="10000">
+  </div>
+</script>
+
+<script type="text/javascript">
+  RED.nodes.registerType('mitsubishi-config', {
+    category: 'config',
+    defaults: {
+      name: { value: 'PLC-1' },
+      host: { value: '192.168.1.10', required: true },
+      port: { value: 5007, required: true, validate: RED.validators.number() },
+      frame: { value: '3E', required: true },
+      networkNo: { value: 0, validate: RED.validators.number() },
+      stationNo: { value: 0, validate: RED.validators.number() },
+      timeout: { value: 3000, validate: RED.validators.number() },
+      maxRetries: { value: 2, validate: RED.validators.number() },
+      retryInterval: { value: 300, validate: RED.validators.number() }
+    },
+    label: function () {
+      return this.name || 'PLC-1';
+    },
+    paletteLabel: 'PLC 连接配置'
+  });
+</script>

package/nodes/mitsubishi-config.js

@@ -0,0 +1,21 @@
+/**
+ * mitsubishi-config — 三菱 PLC 连接配置节点
+ * 保存 IP、端口、帧格式等连接参数，供 mitsubishi-read 节点引用
+ */
+module.exports = function (RED) {
+  function MitsubishiConfigNode(config) {
+    RED.nodes.createNode(this, config);
+    this.name = config.name || 'PLC-1';
+    this.host = config.host || '192.168.1.10';
+    this.port = parseInt(config.port, 10) || 5007;
+    this.frame = config.frame || '3E';
+    this.networkNo = parseInt(config.networkNo, 10) || 0;
+    this.stationNo = parseInt(config.stationNo, 10) || 0;
+    this.timeout = parseInt(config.timeout, 10) || 3000;
+    this.maxRetries = parseInt(config.maxRetries, 10);
+    if (isNaN(this.maxRetries)) this.maxRetries = 2;
+    this.retryInterval = parseInt(config.retryInterval, 10);
+    if (isNaN(this.retryInterval)) this.retryInterval = 300;
+  }
+  RED.nodes.registerType('mitsubishi-config', MitsubishiConfigNode);
+};

package/nodes/mitsubishi-read.html

@@ -0,0 +1,152 @@
+<script type="text/x-red" data-template-name="mitsubishi-read">
+  <div class="form-row">
+    <label for="node-input-name"><i class="fa fa-tag"></i> 名称</label>
+    <input type="text" id="node-input-name" placeholder="三菱MC读取">
+  </div>
+  <div class="form-row">
+    <label for="node-input-plc"><i class="fa fa-microchip"></i> PLC 配置</label>
+    <input type="text" id="node-input-plc" placeholder="选择 mitsubishi-config 节点">
+  </div>
+  <div class="form-row">
+    <label for="node-input-serialNo"><i class="fa fa-hashtag"></i> 序列号 (4E帧, 0=不启用)</label>
+    <input type="number" id="node-input-serialNo" value="0" min="0" max="65535" style="width:100px">
+  </div>
+
+  <!-- 点位编辑表格 -->
+  <div class="form-row" style="margin-top:8px">
+    <label><i class="fa fa-list"></i> 默认点位 (msg.tags 传入时覆盖)</label>
+  </div>
+  <div style="margin-bottom:4px">
+    <table style="width:100%;font-size:12px;border-collapse:collapse">
+      <thead>
+        <tr style="color:#888">
+          <th style="width:11%;text-align:left">寄存器</th>
+          <th style="width:10%;text-align:left">地址</th>
+          <th style="width:16%;text-align:left">数据类型</th>
+          <th style="width:11%;text-align:left">斜率</th>
+          <th style="width:11%;text-align:left">偏移</th>
+          <th style="width:24%;text-align:left">名称</th>
+          <th style="width:6%"></th>
+          <th style="width:11%;text-align:left">ID</th>
+        </tr>
+      </thead>
+      <tbody id="tags-tbody"></tbody>
+    </table>
+    <button class="red-ui-button" onclick="addTagRow()" style="margin-top:4px;font-size:11px">
+      <i class="fa fa-plus"></i> 添加点位
+    </button>
+  </div>
+  <input type="hidden" id="node-input-tags">
+
+  <hr>
+  <div style="color:#888;font-size:11px;margin-bottom:4px">
+    <i class="fa fa-info-circle"></i> 静态: 表格配置 | 动态: msg.tags 传入覆盖<br>
+    输出: msg.payload.data[点位ID] = {rawValue, engValue, quality, ts}<br>
+    变换: engValue = rawValue × slope + offset
+  </div>
+</script>
+
+<script type="text/javascript">
+  var tagEditor = {
+    rows: [],
+    init: function () {
+      try { this.rows = JSON.parse($('#node-input-tags').val() || '[]'); } catch (e) { this.rows = []; }
+      this.render();
+    },
+    add: function () {
+      this.rows.push({ id: '', regType: 'D', addr: '', dataType: 'INT16', slope: '1', offset: '0', name: '' });
+      this.render();
+      this.save();
+    },
+    remove: function (idx) {
+      this.rows.splice(idx, 1);
+      this.render();
+      this.save();
+    },
+    update: function (idx, field, val) {
+      this.rows[idx][field] = val;
+      this.save();
+    },
+    save: function () {
+      $('#node-input-tags').val(JSON.stringify(this.rows));
+    },
+    render: function () {
+      var self = this;
+      var tbody = $('#tags-tbody');
+      tbody.empty();
+      this.rows.forEach(function (row, idx) {
+        var tr = $('<tr>');
+        var mkOpt = function (vals, cur) {
+          var s = '';
+          vals.forEach(function (v) { s += '<option' + (cur === v ? ' selected' : '') + '>' + v + '</option>'; });
+          return s;
+        };
+        var mkSel = function (vals, cur) { return $('<select style="width:95%">' + mkOpt(vals, cur) + '</select>'); };
+
+        // 寄存器
+        var reg = mkSel(['D','W','R','X','Y','M','L','B'], row.regType || 'D');
+        reg.on('change', function () { self.update(idx, 'regType', $(this).val()); });
+        tr.append($('<td>').append(reg));
+
+        // 地址
+        var addr = $('<input type="text" style="width:90%" placeholder="100">').val(row.addr || '');
+        addr.on('change', function () { self.update(idx, 'addr', $(this).val()); });
+        tr.append($('<td>').append(addr));
+
+        // 数据类型
+        var dt = mkSel(['INT16','UINT16','INT32','UINT32','FLOAT32','BOOL'], row.dataType || 'INT16');
+        dt.on('change', function () { self.update(idx, 'dataType', $(this).val()); });
+        tr.append($('<td>').append(dt));
+
+        // 斜率
+        var slope = $('<input type="number" style="width:90%" step="any" placeholder="1">').val(row.slope || '1');
+        slope.on('change', function () { self.update(idx, 'slope', $(this).val()); });
+        tr.append($('<td>').append(slope));
+
+        // 偏移
+        var off = $('<input type="number" style="width:90%" step="any" placeholder="0">').val(row.offset || '0');
+        off.on('change', function () { self.update(idx, 'offset', $(this).val()); });
+        tr.append($('<td>').append(off));
+
+        // 名称
+        var nm = $('<input type="text" style="width:95%" placeholder="温度">').val(row.name || '');
+        nm.on('change', function () { self.update(idx, 'name', $(this).val()); });
+        tr.append($('<td>').append(nm));
+
+        // 删除
+        var del = $('<button class="red-ui-button" style="font-size:10px;padding:1px 5px">✕</button>');
+        del.on('click', function (e) { e.preventDefault(); self.remove(idx); });
+        tr.append($('<td>').append(del));
+
+        // ID (自动生成或手动填)
+        var id = $('<input type="text" style="width:95%" placeholder="auto">').val(row.id || '');
+        id.on('change', function () { self.update(idx, 'id', $(this).val()); });
+        tr.append($('<td>').append(id));
+
+        tbody.append(tr);
+      });
+    }
+  };
+
+  RED.nodes.registerType('mitsubishi-read', {
+    category: '三菱 PLC',
+    color: '#C7E9C0',
+    defaults: {
+      name: { value: '三菱MC读取' },
+      plc: { type: 'mitsubishi-config', required: true },
+      serialNo: { value: 0 },
+      tags: { value: '[]' }
+    },
+    inputs: 1,
+    outputs: 1,
+    paletteLabel: 'MC 读取',
+    label: function () { return this.name || '三菱MC读取'; },
+    oneditprepare: function () {
+      tagEditor.init();
+      window.addTagRow = function () { tagEditor.add(); };
+    },
+    oneditsave: function () {
+      delete window.addTagRow;
+    }
+  });
+</script>

package/nodes/mitsubishi-read.js

@@ -0,0 +1,468 @@
+/**
+ * mitsubishi-read — 三菱 MC Protocol 3E/4E 读取节点 v2.0
+ *
+ * 独立使用: 节点表格配置点位 → inject触发 → 输出eng值
+ * 集成使用: msg.tags 传入覆盖节点配置
+ *
+ * 变换: engValue = rawValue * slope + offset
+ * 输出: msg.payload.data[tagId] = {rawValue, engValue, quality, ts}
+ */
+module.exports = function (RED) {
+  var net = require('net');
+
+  // ===== MC 软元件代码映射 =====
+  var MC_DEVICE_CODES = {
+    'D': 0xA8, 'W': 0xB4, 'X': 0x9C, 'Y': 0x9D,
+    'M': 0x90, 'L': 0x92, 'B': 0xA0, 'R': 0xAF
+  };
+  var BIT_DEVICES = { 'X': true, 'Y': true, 'M': true, 'L': true, 'B': true };
+
+  // ===== MC 错误码映射 =====
+  var MC_ERROR_CODES = {
+    0xC050: 'CPU busy', 0xC051: 'Device not supported', 0xC052: 'Address out of range',
+    0xC053: 'Batch size out of range', 0xC054: 'Write protect error',
+    0xC055: 'Remote operation error', 0xC056: 'File not found', 0xC057: 'File name error',
+    0xC059: 'Points out of range', 0xC05B: 'CPU type mismatch', 0xC05C: 'Remote password error',
+    0xC05F: 'CPU module error', 0xC061: 'Monitor timer timeout',
+    0xC06F: 'ASCII code error', 0xC070: 'Frame length error',
+    0xC0D0: 'PLC not running', 0x4004: '4E: Device not supported',
+    0x401A: '4E: Address out of range', 0x4028: '4E: Points out of range'
+  };
+  function mcErrorText(code) {
+    return MC_ERROR_CODES[code] || ('Unknown MC error 0x' + code.toString(16).toUpperCase());
+  }
+
+  function clampInt(v, def, min, max) {
+    var n = parseInt(v, 10);
+    if (isNaN(n)) n = def;
+    return Math.max(min, Math.min(n, max));
+  }
+
+  // ===== 帧构造 =====
+  function build3EFrame(startAddr, wordCount, stationNo, regType, networkNo) {
+    var deviceCode = MC_DEVICE_CODES[regType] || 0xA8;
+    var buf = Buffer.alloc(21);
+    buf[0] = 0x50; buf[1] = 0x00;
+    buf[2] = networkNo || 0; buf[3] = 0xFF; buf[4] = 0xFF; buf[5] = 0x03;
+    buf[6] = stationNo || 0; buf[7] = 0x0C; buf[8] = 0x00;
+    buf[9] = 0x10; buf[10] = 0x00;
+    buf[11] = 0x01; buf[12] = 0x04; buf[13] = 0x00; buf[14] = 0x00;
+    buf[15] = startAddr & 0xFF; buf[16] = (startAddr >> 8) & 0xFF;
+    buf[17] = (startAddr >> 16) & 0xFF;
+    buf[18] = deviceCode;
+    buf.writeUInt16LE(wordCount, 19);
+    return buf;
+  }
+
+  function build4EFrame(startAddr, wordCount, stationNo, regType, networkNo, serialNo) {
+    var deviceCode = MC_DEVICE_CODES[regType] || 0xA8;
+    var hasSN = (serialNo !== 0);
+    var buf = Buffer.alloc(hasSN ? 24 : 22);
+    buf[0] = 0x54; buf[1] = 0x00;
+    buf[2] = networkNo || 0; buf[3] = 0xFF; buf[4] = 0xFF; buf[5] = 0x03;
+    buf[6] = stationNo || 0;
+    buf[7] = hasSN ? 0x0F : 0x0D; buf[8] = 0x00;
+    buf[9] = 0x10; buf[10] = 0x00;
+    var off = 11;
+    if (hasSN) { buf[off] = serialNo & 0xFF; buf[off + 1] = (serialNo >> 8) & 0xFF; off += 2; }
+    buf[off] = 0x01; buf[off + 1] = 0x04; off += 2;
+    buf[off] = 0x00; buf[off + 1] = 0x00; off += 2;
+    buf.writeUInt32LE(startAddr, off); off += 4;
+    buf[off] = deviceCode; off += 1;
+    buf.writeUInt16LE(wordCount, off);
+    return buf;
+  }
+
+  // ===== 响应解析 =====
+  function parseMCResponse(buf, startAddr, regType, frameType, sentSN) {
+    if (!buf || buf.length < 11) return { err: 'Buffer too short' };
+    var subheader = (buf[0] === 0xD0) ? 0x50 : ((buf[0] === 0xD4) ? 0xD4 : 0);
+    if (subheader === 0) return { err: 'Invalid subheader' };
+
+    var endCode = buf.readUInt16LE(9);
+    if (endCode !== 0) return { mcError: endCode, mcErrorText: mcErrorText(endCode) };
+
+    var dataLen = buf.readUInt16LE(7) - ((frameType === '4E') ? 4 : 2);
+    if (dataLen < 0 || dataLen > 2000) return { err: 'Bad dataLen: ' + dataLen };
+
+    var dataStart = (frameType === '4E') ? 13 : 11;
+    if (frameType === '4E' && sentSN > 0 && buf.length >= 13) {
+      if (buf.readUInt16LE(11) !== sentSN) return { err: 'SerialNo mismatch' };
+    }
+
+    if (buf.length < dataStart + dataLen) return { err: 'Incomplete frame' };
+
+    var result = {};
+    if (BIT_DEVICES[regType]) {
+      for (var w = 0; w < dataLen / 2; w++) {
+        var wordVal = buf.readUInt16LE(dataStart + w * 2);
+        for (var b = 0; b < 16; b++) {
+          result[regType + (startAddr + w * 16 + b)] = (wordVal >> b) & 1;
+        }
+      }
+    } else {
+      for (var i = 0; i < dataLen / 2; i++) {
+        result[regType + (startAddr + i)] = buf.readInt16LE(dataStart + i * 2);
+      }
+    }
+    return result;
+  }
+
+  // ===== 斜率偏移变换 =====
+  function applyTransform(rawValue, tagDef) {
+    if (rawValue === null || rawValue === undefined) return null;
+    var slope = parseFloat(tagDef.slope || tagDef.transformSlopeA || 1);
+    var offset = parseFloat(tagDef.offset || tagDef.transformOffsetB || 0);
+    if (isNaN(slope)) slope = 1;
+    if (isNaN(offset)) offset = 0;
+    var eng = rawValue * slope + offset;
+    return parseFloat(eng.toFixed(4));
+  }
+
+  // ===== 主节点 =====
+  function MitsubishiReadNode(config) {
+    RED.nodes.createNode(this, config);
+    var node = this;
+
+    node.plcConfig = RED.nodes.getNode(config.plc);
+    if (!node.plcConfig) {
+      node.error('未关联 PLC 配置节点');
+      return;
+    }
+    node.serialNo = parseInt(config.serialNo, 10) || 0;
+
+    // 解析节点表格配置的默认点位
+    var configTags = [];
+    try { configTags = JSON.parse(config.tags || '[]'); } catch (e) { configTags = []; }
+
+    node.on('input', function (msg) {
+      var plc = node.plcConfig;
+
+      // === 读取点位: msg.tags → msg.payload.tags → 节点表格配置 ===
+      var rawTags = msg.tags || (msg.payload && msg.payload.tags);
+      if (!rawTags || (Array.isArray(rawTags) && rawTags.length === 0)) {
+        rawTags = configTags;
+      }
+      if (!Array.isArray(rawTags)) rawTags = [rawTags];
+      var tags = rawTags;
+
+      // === 校验并清洗标签 ===
+      var validTags = [];
+      for (var i = 0; i < tags.length; i++) {
+        var t = tags[i];
+        var rt = t.regType || 'D';
+        if (!MC_DEVICE_CODES[rt]) {
+          if (rt) node.warn('[MC] Unknown regType: ' + rt + ', using D');
+          rt = 'D';
+        }
+        // 地址: 兼容数字和 "D100" 格式
+        var rawAddr = (t.addr !== undefined) ? t.addr : (t.regAddr || t.tag_address || t.registerAddress || '');
+        if (typeof rawAddr === 'string') rawAddr = String(rawAddr).replace(/\D/g, '');
+        var addr = parseInt(rawAddr, 10);
+        if (isNaN(addr) || addr < 0) {
+          node.warn('[MC] Invalid addr for tag ' + (t.id || t.name || ('#' + i)));
+          continue;
+        }
+        // ID: 优先用 t.id，其次 t.name，最后自生成
+        var tagId = t.id || t.name || (rt + addr);
+        validTags.push({
+          id: String(tagId),
+          regType: rt,
+          addr: addr,
+          dataType: t.dataType || 'INT16',
+          slope: t.slope || t.transformSlopeA || 1,
+          offset: t.offset || t.transformOffsetB || 0,
+          name: t.name || (rt + addr)
+        });
+      }
+
+      if (validTags.length === 0) {
+        node.status({ fill: 'grey', shape: 'dot', text: '0 valid tags' });
+        return;
+      }
+
+      // === 参数 ===
+      var timeout = clampInt(plc.timeout, 3000, 500, 30000);
+      var maxRetries = clampInt(plc.maxRetries, 2, 0, 10);
+      var retryInterval = clampInt(plc.retryInterval, 300, 50, 10000);
+      var frameType = plc.frame || '3E';
+      var stationNo = plc.stationNo || 0;
+      var networkNo = plc.networkNo || 0;
+      var roundStart = Date.now();
+
+      // === 模拟模式 ===
+      var SIM_MODE = false;
+      try { SIM_MODE = RED.settings.mcSimulationMode || false; } catch (e) {}
+
+      if (SIM_MODE) {
+        var simOut = {};
+        validTags.forEach(function (t) {
+          var raw = BIT_DEVICES[t.regType] ? (Math.random() > 0.5 ? 1 : 0) : Math.floor(Math.random() * 1000);
+          simOut[t.id] = { rawValue: raw, engValue: applyTransform(raw, t), quality: 0, ts: new Date().toISOString() };
+        });
+        msg.payload = { success: true, data: simOut, error: null, roundTimeMs: Date.now() - roundStart };
+        node.status({ fill: 'green', shape: 'dot', text: 'SIM ' + validTags.length + ' tags' });
+        node.send(msg);
+        return;
+      }
+
+      // === 去重: 同 regType + addr 保留最后一个 ===
+      var seen = {};
+      var deduped = [];
+      for (var di = validTags.length - 1; di >= 0; di--) {
+        var dt = validTags[di];
+        var dk = dt.regType + '|' + dt.addr;
+        if (!seen[dk]) { seen[dk] = true; deduped.unshift(dt); }
+      }
+      if (deduped.length < validTags.length) {
+        node.warn('[MC] Deduped ' + (validTags.length - deduped.length) + ' duplicate tags');
+      }
+      validTags = deduped;
+
+      // === 聚类分组 ===
+      var byRegType = {};
+      validTags.forEach(function (t) {
+        if (!byRegType[t.regType]) byRegType[t.regType] = [];
+        byRegType[t.regType].push(t);
+      });
+
+      var groups = [];
+      Object.keys(byRegType).forEach(function (rt) {
+        var sorted = byRegType[rt].slice().sort(function (a, b) { return a.addr - b.addr; });
+        var cluster = [sorted[0]];
+        for (var i = 1; i < sorted.length; i++) {
+          var gap = sorted[i].addr - cluster[cluster.length - 1].addr;
+          if (gap <= 20 && cluster.length < 50) {
+            cluster.push(sorted[i]);
+          } else {
+            groups.push({ regType: rt, tags: cluster });
+            cluster = [sorted[i]];
+          }
+        }
+        if (cluster.length > 0) groups.push({ regType: rt, tags: cluster });
+      });
+
+      if (groups.length === 0) {
+        node.status({ fill: 'red', shape: 'ring', text: 'no groups' });
+        msg.payload = { success: false, data: {}, error: 'No valid register groups' };
+        node.send(msg);
+        return;
+      }
+
+      // === 全局锁 (按 host:port) ===
+      var lockKey = 'edge_mc_lock_' + plc.host + '_' + plc.port;
+      if (!global._mcLocks) global._mcLocks = {};
+      if (global._mcLocks[lockKey] && (Date.now() - global._mcLocks[lockKey] < 60000)) {
+        node.status({ fill: 'yellow', shape: 'dot', text: 'busy' });
+        setTimeout(function () { node.send(msg); }, 200);
+        return;
+      }
+      global._mcLocks[lockKey] = Date.now();
+
+      // === 顺序处理 groups ===
+      var allRaw = {};   // raw values from PLC
+      var hasFailed = false;
+      var firstError = '';
+      var currentSN = node.serialNo;
+
+      function processGroup(gi) {
+        if (gi >= groups.length) {
+          // 全部完成 → 构建输出（含斜率偏移变换）
+          var output = {};
+          validTags.forEach(function (t) {
+            var entry = allRaw[t.id];
+            if (entry) {
+              output[t.id] = {
+                rawValue: entry.rawValue,
+                engValue: applyTransform(entry.rawValue, t),
+                quality: entry.quality,
+                ts: entry.ts
+              };
+            }
+          });
+          msg.payload = {
+            success: !hasFailed,
+            data: output,
+            error: hasFailed ? firstError : null,
+            driverType: 'driver-mc-protocol',
+            plcIp: plc.host,
+            plcPort: plc.port,
+            roundTimeMs: Date.now() - roundStart
+          };
+          node.status({
+            fill: hasFailed ? 'red' : 'green',
+            shape: 'dot',
+            text: (plc.name || plc.host) + ' ' + Object.keys(output).length + ' vals ' + (Date.now() - roundStart) + 'ms'
+          });
+          delete global._mcLocks[lockKey];
+          node.send(msg);
+          return;
+        }
+
+        var grp = groups[gi];
+        var addrs = grp.tags.map(function (t) { return t.addr; });
+        var startA = addrs[0];
+        var isBit = BIT_DEVICES[grp.regType] || false;
+        if (isBit) startA = startA - (startA % 16);
+
+        var wordCount;
+        if (isBit) {
+          wordCount = Math.ceil((addrs[addrs.length - 1] - startA + 1) / 16);
+        } else {
+          wordCount = addrs[addrs.length - 1] - startA + 1;
+        }
+
+        // 字数上限 + 自动拆包
+        var MAX_WORDS = isBit ? 15360 : 960;
+        if (wordCount > MAX_WORDS) {
+          var newGroups = [];
+          var ss = 0;
+          while (ss < grp.tags.length) {
+            var se = ss;
+            while (se < grp.tags.length && (grp.tags[se].addr - grp.tags[ss].addr) < MAX_WORDS) se++;
+            newGroups.push({ regType: grp.regType, tags: grp.tags.slice(ss, se) });
+            ss = se;
+          }
+          groups.splice.apply(groups, [gi, 1].concat(newGroups));
+          setTimeout(function () { processGroup(gi); }, 0);
+          return;
+        }
+
+        function attemptGroup(attempt) {
+          if (attempt > maxRetries) {
+            hasFailed = true;
+            if (!firstError) firstError = 'MC read failed for ' + grp.regType + startA;
+            setTimeout(function () { processGroup(gi + 1); }, 0);
+            return;
+          }
+
+          if (frameType === '4E' && currentSN > 0) currentSN = (currentSN + 1) & 0xFFFF;
+          var sentSN = (frameType === '4E' && currentSN > 0) ? currentSN : 0;
+
+          var client = new net.Socket();
+          var buf = Buffer.alloc(0);
+          var resolved = false;
+          client.setTimeout(timeout);
+
+          client.connect(plc.port, plc.host, function () {
+            try {
+              var frame = (frameType === '4E')
+                ? build4EFrame(startA, wordCount, stationNo, grp.regType, networkNo, sentSN)
+                : build3EFrame(startA, wordCount, stationNo, grp.regType, networkNo);
+              client.write(frame);
+            } catch (e) {
+              node.warn('[MC] connect error: ' + e.message);
+              if (!resolved) { resolved = true; try { client.destroy(); } catch (e2) {} }
+              setTimeout(function () { attemptGroup(attempt + 1); }, retryInterval);
+            }
+          });
+
+          client.on('data', function (chunk) {
+            try {
+              buf = Buffer.concat([buf, chunk]);
+              var hdrLen = (frameType === '4E') ? 13 : 11;
+              if (!resolved && buf.length >= hdrLen) {
+                var dataLen = buf.readUInt16LE(7) - ((frameType === '4E') ? 4 : 2);
+                if (dataLen < 0 || dataLen > 2000) {
+                  resolved = true; try { client.destroy(); } catch (e) {}
+                  setTimeout(function () { attemptGroup(attempt + 1); }, retryInterval);
+                  return;
+                }
+                if (buf.length >= hdrLen + dataLen) {
+                  resolved = true;
+                  var raw = parseMCResponse(buf, startA, grp.regType, frameType, sentSN);
+
+                  if (raw && raw.mcError) {
+                    hasFailed = true;
+                    if (!firstError) firstError = '[PLC 0x' + raw.mcError.toString(16).toUpperCase() + '] ' + raw.mcErrorText;
+                    _destroyedByUs = true; try { client.destroy(); } catch (e) {}
+                    setTimeout(function () { processGroup(gi + 1); }, 0);
+                  } else if (raw && !raw.err) {
+                    grp.tags.forEach(function (t) {
+                      var key = grp.regType + t.addr;
+                      var rv = raw[key];
+                      var q = 0;
+                      if (rv === undefined || rv === null) { q = 2; rv = null; }
+                      else if (!isBit) {
+                        var dt = t.dataType || 'INT16';
+                        if (dt === 'UINT16') { if (rv < 0) rv += 65536; }
+                        else if (dt === 'INT32' || dt === 'UINT32' || dt === 'FLOAT32') {
+                          var adj = raw[grp.regType + (t.addr + 1)];
+                          if (adj === undefined || adj === null) { q = 2; rv = null; }
+                          else {
+                            var hi = rv, lo = adj;
+                            var combined = (hi << 16) | (lo & 0xFFFF);
+                            if (dt === 'INT32') rv = (combined > 0x7FFFFFFF) ? combined - 0x100000000 : combined;
+                            else if (dt === 'UINT32') rv = combined >>> 0;
+                            else if (dt === 'FLOAT32') {
+                              var b32 = Buffer.alloc(4);
+                              b32.writeInt16LE(hi, 0); b32.writeInt16LE(lo, 2);
+                              rv = parseFloat(b32.readFloatLE(0).toFixed(4));
+                            }
+                          }
+                        }
+                      }
+                      allRaw[t.id] = { rawValue: rv, quality: q, ts: new Date().toISOString() };
+                    });
+                    _destroyedByUs = true; try { client.destroy(); } catch (e) {}
+                    setTimeout(function () { processGroup(gi + 1); }, 0);
+                  } else {
+                    _destroyedByUs = true; try { client.destroy(); } catch (e) {}
+                    setTimeout(function () { attemptGroup(attempt + 1); }, retryInterval);
+                  }
+                }
+              }
+            } catch (e) {
+              node.warn('[MC] data handler error: ' + e.message);
+              if (!resolved) { resolved = true; try { client.destroy(); } catch (e2) {} }
+              setTimeout(function () { processGroup(gi + 1); }, 0);
+            }
+          });
+
+          client.on('timeout', function () {
+            if (resolved) return;
+            resolved = true;
+            try { client.destroy(); } catch (e) {}
+            setTimeout(function () { attemptGroup(attempt + 1); }, retryInterval);
+          });
+
+          client.on('error', function () {
+            if (resolved) return;
+            resolved = true;
+            try { client.destroy(); } catch (e) {}
+            setTimeout(function () { attemptGroup(attempt + 1); }, retryInterval);
+          });
+
+          var _destroyedByUs = false;
+          client.on('close', function () {
+            if (_destroyedByUs) return;  // 我们自己关的，不做错误处理
+            if (!resolved) {
+              resolved = true;
+              if (buf.length === 0) {
+                hasFailed = true;
+                if (!firstError) firstError = '[NETWORK] TCP closed (no data)';
+                setTimeout(function () { processGroup(gi + 1); }, 0);
+              } else {
+                // 收到部分数据但帧不完整，重试
+                setTimeout(function () { attemptGroup(attempt + 1); }, retryInterval);
+              }
+            }
+          });
+        }
+        attemptGroup(0);
+      }
+
+      try {
+        processGroup(0);
+      } catch (e) {
+        node.warn('[MC] Exception: ' + e.message);
+        delete global._mcLocks[lockKey];
+        msg.payload = { success: false, data: {}, error: e.message };
+        node.status({ fill: 'red', shape: 'ring', text: 'exception' });
+        node.send(msg);
+      }
+    });
+  }
+
+  RED.nodes.registerType('mitsubishi-read', MitsubishiReadNode);
+};

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "node-red-contrib-mitsubishi",
+  "version": "1.0.0",
+  "description": "三菱 MC Protocol 3E/4E 采集节点 — 纯TCP零依赖, 支持Q/L/iQ-R/iQ-F/FX5U",
+  "main": "nodes/mitsubishi-read.js",
+  "node-red": {
+    "nodes": {
+      "mitsubishi-config": "nodes/mitsubishi-config.js",
+      "mitsubishi-read": "nodes/mitsubishi-read.js"
+    }
+  },
+  "keywords": [
+    "node-red",
+    "mitsubishi",
+    "mc-protocol",
+    "plc",
+    "3e",
+    "4e",
+    "melsec",
+    "industrial",
+    "iot",
+    "edgelink"
+  ],
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "license": "MIT"
+}