node-red-zelecproto 0.1.0 → 0.1.2

package/645.js

@@ -433,6 +433,20 @@ function decode645(_msg) {
         return arr.includes(di)
     }
 
+    function expandBits16(v) {
+        const bits = {};
+        for (let i = 0; i < 16; i++) {
+            bits[`bit${i}`] = (v >> i) & 0x1;
+        }
+        return bits;
+    }
+    function expandBits32(v) {
+        const bits = {};
+        for (let i = 0; i < 32; i++) {
+            bits[`bit${i}`] = (v >>> i) & 0x1;
+        }
+        return bits;
+    }
 
     // —— 常用分支（保留你的原分支，增加越界保护）——
     function buildDays(prefix) {
@@ -520,66 +534,22 @@ function decode645(_msg) {
                 rawValue: w1,
                 rawBlockHex: statusBlockHex,
                 binary: bin16(w1),
-                keys: {
-                    '停电抄表电池欠压': !!bit(w1, 3),
-                    '时钟电池欠压': !!bit(w1, 2),
-                    '有功功率方向反向': !!bit(w1, 4),
-                    '无功功率方向反向': !!bit(w1, 5),
-                    '控制回路错误': !!bit(w1, 8),
-                    'ESAM错误': !!bit(w1, 9),
-                    '内部程序错误': !!bit(w1, 12),
-                    '存储器故障或损坏': !!bit(w1, 13),
-                    '透支状态': !!bit(w1, 14),
-                    '时钟故障': !!bit(w1, 15)
-                }
+                bits: expandBits16(w1)
             };
 
-            // —— 状态字2（与你现有的 04000502 保持一致）——
+            // 状态字2/3只保留原始数值和binary，具体位义由上层业务或文档表解释。
             const w2 = readU16LE();
-            const dir = (b) => (b ? '反向' : '正向');
             const word2 = (w2 === null) ? null : {
                 rawValue: w2,
                 binary: bin16(w2),
-                fields: {
-                    'A相有功功率方向': dir(bit(w2, 0)),
-                    'B相有功功率方向': dir(bit(w2, 1)),
-                    'C相有功功率方向': dir(bit(w2, 2)),
-                    'A相无功功率方向': dir(bit(w2, 4)),
-                    'B相无功功率方向': dir(bit(w2, 5)),
-                    'C相无功功率方向': dir(bit(w2, 6))
-                }
+                bits: expandBits16(w2)
             };
 
-            // —— 状态字3（与你现有的 04000503 保持一致）——
             const w3 = readU16LE();
-            const supplyBits = (w3 === null) ? 0 : ((w3 >> 1) & 0b11);
-            const supplyMode = (
-                supplyBits === 0 ? '主电源' :
-                    supplyBits === 1 ? '辅助电源' :
-                        supplyBits === 2 ? '电池供电' : '保留'
-            );
-            const meterTypeBits = (w3 === null) ? 0 : ((w3 >> 8) & 0b11);
-            const meterType = (
-                meterTypeBits === 0 ? '非预付费表' :
-                    meterTypeBits === 1 ? '电量型预付费表' :
-                        meterTypeBits === 2 ? '电费型预付费表' : '保留'
-            );
             const word3 = (w3 === null) ? null : {
                 rawValue: w3,
                 binary: bin16(w3),
-                fields: {
-                    当前运行时段套数: (bit(w3, 0) ? '第二套' : '第一套'),
-                    供电方式: supplyMode,
-                    编程允许状态: (bit(w3, 3) ? '有效' : '失效'),
-                    继电器状态: (bit(w3, 4) ? '断' : '通'),
-                    当前运行时区套数: (bit(w3, 5) ? '第二套' : '第一套'),
-                    继电器命令状态: (bit(w3, 6) ? '断' : '通'),
-                    预跳闸报警状态: (bit(w3, 7) ? '有' : '无'),
-                    电能表类型: meterType,
-                    当前运行分时费率套数: (bit(w3, 10) ? '第二套' : '第一套'),
-                    当前阶梯套数: (bit(w3, 11) ? '第二套' : '第一套'),
-                    保电状态: (bit(w3, 12) ? '保电' : '非保电')
-                }
+                bits: expandBits16(w3)
             };
 
             // —— 密钥状态字（与你现有的 04000508 保持一致，32位）——
@@ -588,6 +558,7 @@ function decode645(_msg) {
                 rawValue: w8,
                 hexValue: w8.toString(16).toUpperCase().padStart(8, '0'),
                 binary: bin32(w8),
+                bits: expandBits32(w8),
                 keys: {
                     '主控密钥有效': !!bit(w8, 0),
                     '身份认证密钥有效': !!bit(w8, 1),
@@ -616,78 +587,31 @@ function decode645(_msg) {
 
             value = {
                 rawValue: v, binary: bin,
-                keys: {
-                    '停电抄表电池欠压': !!(v & (1 << 3)),    // bit3: 0=正常, 1=欠压
-                    '时钟电池欠压': !!(v & (1 << 2)),        // bit2: 0=正常, 1=欠压
-                    '有功功率方向反向': !!(v & (1 << 4)),    // bit4: 0=正向, 1=反向
-                    '无功功率方向反向': !!(v & (1 << 5)),    // bit5: 0=正向, 1=反向
-                    '控制回路错误': !!(v & (1 << 8)),        // bit8: 0=正常, 1=错误
-                    'ESAM错误': !!(v & (1 << 9)),           // bit9: 0=正常, 1=错误
-                    '内部程序错误': !!(v & (1 << 12)),       // bit12: 0=正常, 1=错误
-                    '存储器故障或损坏': !!(v & (1 << 13)),   // bit13: 0=正常, 1=故障
-                    '透支状态': !!(v & (1 << 14)),          // bit14: 0=正常, 1=透支
-                    '时钟故障': !!(v & (1 << 15))           // bit15: 0=正常, 1=故障
-                }
+                bits: expandBits16(v)
             };
         } else if (di === '04000502' && arrPush.length >= 6) {
-            // 运行状态字2（方向类）：A/B/C 相有功与无功功率方向（0=正向，1=反向）
+            // 状态字2只返回原始数值，binary为bit15..bit0。
             const lo = arrPush[4] & 0xFF;
             const hi = arrPush[5] & 0xFF;
             const v = (hi << 8) | lo;
             const bin = v.toString(2).padStart(16, '0');
 
-            const bit = (n) => ((v >> n) & 0x1);
-            const dir = (b) => (b ? '反向' : '正向');
-
             value = {
                 rawValue: v,
                 binary: bin,
-                fields: {
-                    'A相有功功率方向': dir(bit(0)),
-                    'B相有功功率方向': dir(bit(1)),
-                    'C相有功功率方向': dir(bit(2)),
-                    'A相无功功率方向': dir(bit(4)),
-                    'B相无功功率方向': dir(bit(5)),
-                    'C相无功功率方向': dir(bit(6))
-                }
+                bits: expandBits16(v)
             };
         } else if (di === '04000503' && arrPush.length >= 6) {
-            // 运行状态字3（操作类）
+            // 状态字3只返回原始数值，binary为bit15..bit0。
             const lo = arrPush[4] & 0xFF;
             const hi = arrPush[5] & 0xFF;
             const v = (hi << 8) | lo;
             const bin = v.toString(2).padStart(16, '0');
 
-            const supplyBits = (v >> 1) & 0b11; // bit2-bit1
-            const supplyMode = (
-                supplyBits === 0 ? '主电源' :
-                    supplyBits === 1 ? '辅助电源' :
-                        supplyBits === 2 ? '电池供电' : '保留'
-            );
-
-            const meterTypeBits = (v >> 8) & 0b11; // bit9-bit8
-            const meterType = (
-                meterTypeBits === 0 ? '非预付费表' :
-                    meterTypeBits === 1 ? '电量型预付费表' :
-                        meterTypeBits === 2 ? '电费型预付费表' : '保留'
-            );
-
             value = {
                 rawValue: v,
                 binary: bin,
-                fields: {
-                    当前运行时段套数: (v & 0x1) ? '第二套' : '第一套',               // bit0
-                    供电方式: supplyMode,                                          // bit2-bit1
-                    编程允许状态: (v & (1 << 3)) ? '有效' : '失效',                   // bit3
-                    继电器状态: (v & (1 << 4)) ? '断' : '通',                        // bit4（线路实际工作状态）
-                    当前运行时区套数: (v & (1 << 5)) ? '第二套' : '第一套',           // bit5
-                    继电器命令状态: (v & (1 << 6)) ? '断' : '通',                    // bit6（远程拉闸命令）
-                    预跳闸报警状态: (v & (1 << 7)) ? '有' : '无',                    // bit7
-                    电能表类型: meterType,                                          // bit9-bit8
-                    当前运行分时费率套数: (v & (1 << 10)) ? '第二套' : '第一套',      // bit10
-                    当前阶梯套数: (v & (1 << 11)) ? '第二套' : '第一套',              // bit11
-                    保电状态: (v & (1 << 12)) ? '保电' : '非保电'                    // bit12
-                }
+                bits: expandBits16(v)
             };
         }
         // else if (['0000FF00', '0001FF00', '0002FF00'].includes(di) && arrPush.length > 4) {
@@ -702,6 +626,7 @@ function decode645(_msg) {
                 rawValue: v,
                 hexValue: v.toString(16).toUpperCase().padStart(8, '0'),
                 binary: v.toString(2).padStart(32, '0'),
+                bits: expandBits32(v),
                 keys: {
                     '主控密钥有效': !!(v & (1 << 0)), '身份认证密钥有效': !!(v & (1 << 1)), '密钥协商密钥有效': !!(v & (1 << 2)),
                     '密钥更新密钥有效': !!(v & (1 << 3)), '传输密钥有效': !!(v & (1 << 4)), '保护密钥有效': !!(v & (1 << 5)),

package/698.js

@@ -870,182 +870,142 @@ function parseStatusWordFromAxdrBitString(buffer) {
     const bytes = buffer.slice(start, end);
     if (bytes.length < 2) return null;
     const bits = [];
+    // A-XDR bit-string按每字节高位到低位展开。
     for (const byte of bytes.slice(0, 2)) {
         for (let bit = 7; bit >= 0; bit--) {
             bits.push((byte >> bit) & 0x01);
         }
     }
     let statusWord = 0;
+    // 文档表F.x中的bit编号按展开后的bit-string下标映射，后续binary再按645一致的数值形式输出。
     for (let i = 0; i < 16; i++) {
         statusWord |= bits[i] << i;
     }
     return {
         statusWord,
-        binary: bits.slice(0, 16).join('')
+        binary: bits.slice(0, 16).join(''),
+        consumed: end
     };
 }
 
-/**
- * 解析电表运行状态字2 - 与645协议格式保持一致
- * @param {Buffer} dataBuffer - 数据缓冲区
- * @returns {Object} 解析结果
- */
-
-function parseMeterStatus(dataBuffer, oad = '20140201') {
-    const result = createStandardResult("电表状态", oad, dataBuffer);
-    try {
-        // 1. 读取原始状态字（小端）
-        const statusWordLe = parseMeterStatusOptimized(dataBuffer);
-
-        // 2. 转换为大端，用于大端逻辑判断
-        const statusWordBe = toBigEndian16(statusWordLe);
-
-        if (statusWordBe !== null) {
-            const valTmp = statusWordBe & 0xFFFF;
-            const bin = valTmp.toString(2).padStart(16, '0'); // 最高位bit15在最左
+function expandBits16(v) {
+    const bits = {};
+    for (let i = 0; i < 16; i++) {
+        bits[`bit${i}`] = (v >> i) & 0x1;
+    }
+    return bits;
+}
 
-            // 3. 大端判断：bit0 是最左边的最高位
-            result.value = {
-                rawValue: valTmp,
-                binary: bin,
-                keys: {
-                    'bit15 时钟故障': bin[0] === '1',
-                    'bit14 透支状态': bin[1] === '1',
-                    'bit13 存储器故障或损坏': bin[2] === '1',
-                    'bit12 内部程序错误': bin[3] === '1',
-                    'bit11 保留': bin[4] === '1',
-                    'bit10 保留': bin[5] === '1',
-                    'bit9  ESAM错误': bin[6] === '1',
-                    'bit8  控制回路错误': bin[7] === '1',
-                    'bit7  保留': bin[8] === '1',
-                    'bit6  保留': bin[9] === '1',
-                    'bit5  无功功率方向反向': bin[10] === '1',
-                    'bit4  有功功率方向反向': bin[11] === '1',
-                    'bit3  停电抄表电池欠压': bin[12] === '1',
-                    'bit2  时钟电池欠压': bin[13] === '1',
-                    'bit1  需量积算方式': bin[14] === '1',
-                    'bit0  保留': bin[15] === '1'
-                }
-            };
+function format698StatusWord(statusWord, bitStringStatus = null, index = null) {
+    const val16 = statusWord & 0xFFFF;
+    return {
+        ...(index == null ? {} : { index }),
+        rawValue: val16,
+        statusWordHex: val16.toString(16).padStart(4, '0').toUpperCase(),
+        // binary按原始bit-string显示，便于与645页面展示口径保持一致。
+        binary: bitStringStatus?.binary || val16.toString(2).padStart(16, '0'),
+        bits: expandBits16(val16)
+    };
+}
 
-            setSuccessResult(result, {
-                timestamp: null,
-                statusWord: valTmp,
-                statusWordHex: valTmp.toString(16).padStart(4, '0').toUpperCase(),
-                statusBits: decodeMeterStatusBits(valTmp)
-            }, { generic: { dataType: 'bit-string' } });
+function parseStatusWordsFromAxdrArray(buffer) {
+    if (!Buffer.isBuffer(buffer) || buffer.length < 2 || buffer[0] !== 0x01) return [];
+    const L = readAxdrLength(buffer, 1);
+    const count = L.len;
+    let offset = 1 + L.size;
+    const words = [];
+
+    for (let i = 0; i < count && offset < buffer.length; i++) {
+        if (buffer[offset] === 0x04) {
+            const word = parseStatusWordFromAxdrBitString(buffer.slice(offset));
+            if (!word) break;
+            words.push(word);
+            offset += word.consumed;
         } else {
-            throw new Error("无法解析状态字");
+            const { consumed } = enhancedParseData(buffer.slice(offset), '2014', '02');
+            if (!consumed) break;
+            offset += consumed;
         }
-
-    } catch (e) {
-        console.error('parseMeterStatus错误:', e.message);
-        setErrorResult(result, e.message);
     }
 
-    return result;
+    return words;
 }
 
-
-/**
- * 解析电表运行状态字3（20140203）- 按操作类位义输出字段
- */
-function parseMeterStatusWord3(dataBuffer) {
-    const oad = '20140203';
-    const result = createStandardResult("电表运行状态字3", oad, dataBuffer);
+function parseMeterStatusWord698(dataBuffer, oad, dataType) {
+    const result = createStandardResult(dataType, oad, dataBuffer);
     try {
         const bitStringStatus = parseStatusWordFromAxdrBitString(dataBuffer);
         const statusWord = bitStringStatus?.statusWord ?? parseMeterStatusOptimized(dataBuffer);
         if (statusWord === null) throw new Error('无法解析状态字');
 
-        const val16 = statusWord & 0xFFFF; // 低16位
-        const bin = bitStringStatus?.binary ?? val16.toString(2).padStart(16, '0');
-
-        const supplyBits = (val16 >> 1) & 0b11; // bit2-bit1
-        const supplyMode = (
-            supplyBits === 0 ? '主电源' :
-                supplyBits === 1 ? '辅助电源' :
-                    supplyBits === 2 ? '电池供电' : '保留'
-        );
-
-        const meterTypeBits = (val16 >> 8) & 0b11; // bit9-bit8
-        const meterType = (
-            meterTypeBits === 0 ? '非预付费表' :
-                meterTypeBits === 1 ? '电量型预付费表' :
-                    meterTypeBits === 2 ? '电费型预付费表' : '保留'
-        );
-
-        result.value = {
-            rawValue: val16,
-            binary: bin,
-            fields: {
-                当前运行时段套数: (val16 & 0x1) ? '第二套' : '第一套',
-                供电方式: supplyMode,                              // bit2-bit1
-                编程允许状态: (val16 & (1 << 3)) ? '有效' : '失效',   // bit3
-                继电器状态: (val16 & (1 << 4)) ? '断' : '通',        // bit4（线路实际工作状态）
-                当前运行时区套数: (val16 & (1 << 5)) ? '第二套' : '第一套',
-                继电器命令状态: (val16 & (1 << 6)) ? '断' : '通',    // bit6（远程拉闸命令）
-                预跳闸报警状态: (val16 & (1 << 7)) ? '有' : '无',    // bit7
-                电能表类型: meterType,                              // bit9-bit8
-                当前运行分时费率套数: (val16 & (1 << 10)) ? '第二套' : '第一套',
-                当前阶梯套数: (val16 & (1 << 11)) ? '第二套' : '第一套',
-                保电状态: (val16 & (1 << 12)) ? '保电' : '非保电'
-            }
-        };
+        const value = format698StatusWord(statusWord, bitStringStatus);
+        result.value = value;
 
         setSuccessResult(result, {
-            statusWord: val16,
-            statusWordHex: val16.toString(16).padStart(4, '0').toUpperCase(),
-            statusBits: decodeMeterStatusBits(val16)
+            statusWord: value.rawValue,
+            statusWordHex: value.statusWordHex,
+            statusBits: decodeMeterStatusBits(value.rawValue)
         }, { generic: { dataType: 'bit-string' } });
     } catch (e) {
         setErrorResult(result, e.message);
     }
+
     return result;
 }
 
-/**
- * 解析电表运行状态字2（20140202）- 返回原始位数组，不强加语义
- */
-function parseMeterStatusWord2(dataBuffer) {
-    const oad = '20140202';
-    const result = createStandardResult("电表运行状态字2", oad, dataBuffer);
+function parseMeterStatusArray698(dataBuffer) {
+    const oad = '20140200';
+    const result = createStandardResult("电表状态", oad, dataBuffer);
     try {
-        const bitStringStatus = parseStatusWordFromAxdrBitString(dataBuffer);
-        const statusWord = bitStringStatus?.statusWord ?? parseMeterStatusOptimized(dataBuffer);
-        if (statusWord === null) throw new Error('无法解析状态字');
-
-        const val16 = statusWord & 0xFFFF;
-        const bin = bitStringStatus?.binary ?? val16.toString(2).padStart(16, '0');
-
-        const bit = (n) => ((val16 >> n) & 0x1);
-        const dir = (b) => (b ? '反向' : '正向'); // 0=正向, 1=反向
-
-        // 按表F.2位义生成具名字段
-        const fields = {
-            'A相有功功率方向': dir(bit(0)), // bit0
-            'B相有功功率方向': dir(bit(1)), // bit1
-            'C相有功功率方向': dir(bit(2)), // bit2
-            'A相无功功率方向': dir(bit(4)), // bit4
-            'B相无功功率方向': dir(bit(5)), // bit5
-            'C相无功功率方向': dir(bit(6))  // bit6
-            // 其余bit3、bit7、bit8~bit15为保留
-        };
+        const parsedWords = parseStatusWordsFromAxdrArray(dataBuffer);
+        if (!parsedWords.length) throw new Error('无法解析状态字数组');
 
+        const words = parsedWords.map((word, index) => format698StatusWord(word.statusWord, word, index + 1));
         result.value = {
-            rawValue: val16,
-            binary: bin,
-            bits: decodeMeterStatusBits(val16),
-            fields
+            word1: words[0] || null,
+            word2: words[1] || null,
+            word3: words[2] || null,
+            words
         };
 
-        setSuccessResult(result, { statusWord: val16, statusWordHex: val16.toString(16).padStart(4, '0').toUpperCase(), statusBits: decodeMeterStatusBits(val16) }, { generic: { dataType: 'bit-string' } });
+        setSuccessResult(result, {
+            statusWords: words,
+            statusWord: words[0]?.rawValue ?? null,
+            statusWordHex: words[0]?.statusWordHex ?? null,
+            statusBits: words[0] ? decodeMeterStatusBits(words[0].rawValue) : []
+        }, { generic: { dataType: 'array' } });
     } catch (e) {
         setErrorResult(result, e.message);
     }
+
     return result;
 }
 
+/**
+ * 解析电表运行状态字1或状态字数组
+ * @param {Buffer} dataBuffer - 数据缓冲区
+ * @returns {Object} 解析结果
+ */
+
+function parseMeterStatus(dataBuffer, oad = '20140201') {
+    if (oad === '20140200') return parseMeterStatusArray698(dataBuffer);
+    return parseMeterStatusWord698(dataBuffer, oad, "电表状态");
+}
+
+/**
+ * 解析电表运行状态字3（20140203）
+ */
+function parseMeterStatusWord3(dataBuffer) {
+    return parseMeterStatusWord698(dataBuffer, '20140203', "电表运行状态字3");
+}
+
+/**
+ * 解析电表运行状态字2（20140202）
+ */
+function parseMeterStatusWord2(dataBuffer) {
+    return parseMeterStatusWord698(dataBuffer, '20140202', "电表运行状态字2");
+}
+
 /**
  * 优化的状态字解析策略
  * @param {Buffer} dataBuffer - 数据缓冲区

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-red-zelecproto",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "node-red zelecproto node",
   "main": "index.js",
   "scripts": {

package/AGENTS.md

@@ -1,133 +0,0 @@
-# AGENTS.md
-
-This file contains guidelines and commands for agentic coding agents working in the node-red-zelecproto repository.
-
-## Global Settings
-- **Proxy**: Execute `proxy` command before running any network-related commands to enable proxy connection
-
-## Build/Test/Lint Commands
-
-### Current Commands
-- `npm test` - Currently shows "Error: no test specified" (placeholder)
-- No build, lint, or typecheck commands are currently configured
-
-### Testing
-- Use `node test.js` to run the manual test file
-- Test file located at: `test.js`
-- For single test execution, run `node -e "require('./test.js')"`
-
-### Development
-- No build process required (Node-RED nodes load directly)
-- Manual testing via Node-RED flow editor recommended
-
-## Code Style Guidelines
-
-### File Structure and Naming
-- Main node files: `zelecproto.js`, `zbatchproto.js`, `zeleble.js`
-- Protocol implementations: `645.js`, `698.js`, `ble.js`
-- HTML definitions: `zelecproto.html`, `zbatchproto.html`, `zeleble.html`
-- Icons in: `icons/` directory (SVG format)
-- Use kebab-case for file names
-
-### Module Pattern
-All Node-RED nodes must follow this pattern:
-```javascript
-module.exports = function (RED) {
-    "use strict";
-    
-    // Require dependencies
-    var proto645 = require("./645");
-    
-    function NodeName(n) {
-        RED.nodes.createNode(this, n);
-        var node = this;
-        
-        this.on("input", function (msg, send, done) {
-            // Process message
-            send(msg);
-            done();
-        });
-        
-        this.on('close', () => {
-            // Cleanup if needed
-        });
-    }
-    
-    RED.nodes.registerType("nodename", NodeName);
-}
-```
-
-### Import/Require Style
-- Use `var` for requires (consistent with existing codebase)
-- Local dependencies first: `var proto645 = require("./645");`
-- Group requires at top of module function
-- Use relative paths for local files
-
-### Code Formatting
-- Use strict mode: `"use strict";` at top of module function
-- Indentation: 4 spaces (consistent with existing files)
-- Semicolons required
-- String quotes: single quotes preferred
-- Object property access: dot notation for known properties, bracket notation for dynamic
-
-### Naming Conventions
-- Node functions: PascalCase (e.g., `zelecproto`, `zbatchproto`)
-- Variables: camelCase (e.g., `msg`, `node`, `addrBytes`)
-- Constants: UPPER_SNAKE_CASE (e.g., `START`, `END`, `OAD`)
-- File names: kebab-case (e.g., `zelecproto.js`, `645.js`)
-
-### Error Handling
-- Use `throw new Error()` for validation errors
-- Include descriptive error messages
-- Validate input parameters before processing
-- Example: `if (addrRaw.length !== 12) throw new Error('com_exec_addr 必须是 6 字节(12个HEX字符)');`
-
-### Message Processing
-- Always use the three-parameter input handler: `function (msg, send, done)`
-- Call `send(msg)` before `done()`
-- Clean up temporary properties: `delete msg._proto`
-- Preserve original message structure when possible
-
-### Protocol Implementation
-- 645 Protocol: Focus on DL/T 645 frame building/parsing
-- 698 Protocol: DL/T 698.45 encode/decode with CRC-16/X-25
-- BLE Protocol: 国网多芯物联表蓝牙通信协议
-- Each protocol file should export a function that takes `msg` and returns modified `msg`
-
-### HTML Node Definitions
-- Use data-template-name attribute matching node type
-- Include name field in all nodes
-- Set appropriate category, color, and icon
-- Category: 'zutils' for all nodes
-- Icons: reference SVG files in icons/ directory
-
-### Comments and Documentation
-- Use Chinese comments for protocol-specific explanations (consistent with existing code)
-- Use JSDoc-style comments for functions
-- Include protocol references and frame format descriptions
-- Example: `// 国网多芯物联表《蓝牙通信及脉冲检定说明手册(0224)》协议`
-
-### Buffer/Hex Handling
-- Use `Buffer.from()` for creating buffers
-- Hex strings should be uppercase without spaces for final output
-- Use helper functions for hex/bytes conversion
-- Maintain consistent hex formatting across protocols
-
-### Node-RED Integration
-- Register nodes in package.json under `node-red.nodes`
-- Minimum Node.js version: >=15
-- Minimum Node-RED version: >=1.3
-- No external dependencies currently required
-
-## Development Workflow
-1. Modify protocol implementation files as needed
-2. Test with `node test.js` or via Node-RED flow editor
-3. Ensure all nodes follow the standard module pattern
-4. Verify HTML definitions match JavaScript node registrations
-5. Test message processing with sample data
-
-## Protocol-Specific Notes
-- 645: Handle address reversal and OAD encryption
-- 698: Implement CRC-16/X-25 checksum validation
-- BLE: Follow frame format with Start/End markers
-- All protocols should support both encode and decode operations