node-red-contrib-symi-mesh 1.3.1 → 1.6.1

package/nodes/rs485-debug.html

@@ -0,0 +1,238 @@
+<script type="text/javascript">
+    RED.nodes.registerType('rs485-debug', {
+        category: 'Symi Mesh',
+        color: '#87CEEB',
+        defaults: {
+            name: { value: '' },
+            rs485Config: { value: '', type: 'symi-485-config', required: true },
+            displayMode: { value: 'hex' },
+            showTimestamp: { value: true },
+            maxMessages: { value: 100 }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'serial.svg',
+        paletteLabel: 'RS485调试',
+        label: function() {
+            return this.name || 'RS485调试';
+        },
+        oneditprepare: function() {
+            var node = this;
+            var autoRefreshInterval = null;
+            var autoRefreshEnabled = true;
+            
+            // 设置编辑面板更宽
+            var panel = $('#dialog-form').parent();
+            if (panel.length && panel.width() < 700) {
+                panel.css('width', '800px');
+            }
+            
+            // 加载历史消息 - 显示全部100条（增量更新避免闪烁）
+            var lastMessageCount = 0;
+            var lastMessageTime = '';
+            
+            function loadHistory() {
+                if (!node.id) return;
+                $.getJSON('/rs485-debug/history/' + node.id, function(messages) {
+                    var container = $('#debug-history');
+                    
+                    if (messages.length === 0) {
+                        if (lastMessageCount !== 0) {
+                            container.empty();
+                            container.append('<div class="debug-empty">暂无数据，部署后将显示RS485通信数据</div>');
+                            lastMessageCount = 0;
+                            lastMessageTime = '';
+                        }
+                        return;
+                    }
+                    
+                    // 检查是否有新消息（通过最后一条消息的时间戳判断）
+                    var latestTime = messages.length > 0 ? messages[messages.length - 1].timestamp : '';
+                    if (latestTime === lastMessageTime && messages.length === lastMessageCount) {
+                        return; // 没有新消息，不更新DOM
+                    }
+                    
+                    // 有新消息时才重建列表
+                    container.empty();
+                    messages.forEach(function(msg) {
+                        var dir = msg.direction === 'TX' ? '→ TX' : '← RX';
+                        var dirClass = msg.direction === 'TX' ? 'tx' : 'rx';
+                        var html = '<div class="debug-line ' + dirClass + '">' +
+                            '<span class="time">' + msg.timestampLocal + '</span>' +
+                            '<span class="dir">' + dir + '</span>' +
+                            '<span class="hex">' + msg.hex + '</span>';
+                        if (msg.modbus) {
+                            html += '<span class="info">从机:' + msg.modbus.slaveAddr + ' ' + msg.modbus.funcName + '</span>';
+                        }
+                        html += '</div>';
+                        container.append(html);
+                    });
+                    container.scrollTop(container[0].scrollHeight);
+                    
+                    // 更新状态
+                    lastMessageCount = messages.length;
+                    lastMessageTime = latestTime;
+                    $('#debug-status').text('已缓存 ' + messages.length + ' 条');
+                });
+            }
+
+            // 自动刷新（实时采集）
+            function startAutoRefresh() {
+                if (autoRefreshInterval) clearInterval(autoRefreshInterval);
+                autoRefreshInterval = setInterval(function() {
+                    if (autoRefreshEnabled) {
+                        loadHistory();
+                    }
+                }, 500); // 每500ms刷新一次
+            }
+
+            function stopAutoRefresh() {
+                if (autoRefreshInterval) {
+                    clearInterval(autoRefreshInterval);
+                    autoRefreshInterval = null;
+                }
+            }
+
+            // 清空历史
+            $('#btn-clear-history').on('click', function() {
+                $.post('/rs485-debug/clear/' + node.id, function() {
+                    loadHistory();
+                });
+            });
+
+            // 手动刷新
+            $('#btn-refresh-history').on('click', loadHistory);
+
+            // 切换自动刷新
+            $('#btn-auto-refresh').on('click', function() {
+                autoRefreshEnabled = !autoRefreshEnabled;
+                if (autoRefreshEnabled) {
+                    $(this).addClass('active').find('i').removeClass('fa-pause').addClass('fa-play');
+                    $(this).find('span').text('实时');
+                    startAutoRefresh();
+                } else {
+                    $(this).removeClass('active').find('i').removeClass('fa-play').addClass('fa-pause');
+                    $(this).find('span').text('暂停');
+                }
+            });
+
+            // 初始加载并启动自动刷新
+            loadHistory();
+            startAutoRefresh();
+
+            // 编辑面板关闭时停止自动刷新
+            var originalCancel = RED.editor.cancel;
+            var cleanupDone = false;
+            function cleanup() {
+                if (!cleanupDone) {
+                    cleanupDone = true;
+                    stopAutoRefresh();
+                }
+            }
+            // 监听对话框关闭事件
+            $(document).one('editableDialogClose', cleanup);
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="rs485-debug">
+    <style>
+        .debug-section { margin: 12px 0; padding: 10px; border: 1px solid #ddd; border-radius: 5px; background: #fafafa; }
+        .debug-section h4 { margin: 0 0 10px 0; font-size: 13px; color: #333; }
+        #debug-history { max-height: calc(100vh - 400px); min-height: 400px; overflow-y: auto; background: #1e1e1e; border-radius: 4px; padding: 10px; font-family: 'Consolas', 'Monaco', monospace; font-size: 12px; }
+        .debug-empty { color: #888; text-align: center; padding: 20px; }
+        .debug-line { padding: 3px 0; border-bottom: 1px solid #333; color: #ddd; }
+        .debug-line.tx { color: #98c379; }
+        .debug-line.rx { color: #61afef; }
+        .debug-line .time { color: #888; margin-right: 8px; }
+        .debug-line .dir { font-weight: bold; margin-right: 8px; min-width: 40px; display: inline-block; }
+        .debug-line .hex { color: #e5c07b; }
+        .debug-line .info { color: #c678dd; margin-left: 10px; font-size: 10px; }
+        .debug-buttons { margin-top: 8px; }
+        .debug-buttons button { margin-right: 8px; }
+    </style>
+
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> 名称</label>
+        <input type="text" id="node-input-name" placeholder="RS485调试">
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-rs485Config"><i class="fa fa-plug"></i> RS485连接</label>
+        <input type="text" id="node-input-rs485Config">
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-displayMode"><i class="fa fa-eye"></i> 显示模式</label>
+        <select id="node-input-displayMode" style="width:70%">
+            <option value="hex">十六进制 (HEX)</option>
+            <option value="ascii">ASCII字符</option>
+            <option value="both">十六进制 + ASCII</option>
+        </select>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-showTimestamp"><i class="fa fa-clock-o"></i> 显示时间戳</label>
+        <input type="checkbox" id="node-input-showTimestamp" style="width:auto; margin-left:0">
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-maxMessages"><i class="fa fa-database"></i> 缓存条数</label>
+        <input type="number" id="node-input-maxMessages" min="10" max="1000" style="width:70%">
+    </div>
+
+    <div class="debug-section">
+        <h4><i class="fa fa-terminal"></i> 通信数据预览 <span id="debug-status" style="font-weight:normal;color:#888;font-size:11px;"></span></h4>
+        <div id="debug-history"></div>
+        <div class="debug-buttons">
+            <button type="button" id="btn-auto-refresh" class="red-ui-button red-ui-button-small active" style="background:#4CAF50;color:white;">
+                <i class="fa fa-play"></i> <span>实时</span>
+            </button>
+            <button type="button" id="btn-refresh-history" class="red-ui-button red-ui-button-small">
+                <i class="fa fa-refresh"></i> 刷新
+            </button>
+            <button type="button" id="btn-clear-history" class="red-ui-button red-ui-button-small">
+                <i class="fa fa-trash"></i> 清空
+            </button>
+        </div>
+    </div>
+
+    <div class="form-tips">
+        <p><b>使用说明：</b></p>
+        <p>• 自动显示RS485总线上的所有通信数据</p>
+        <p>• <span style="color:#98c379">绿色TX</span>：发送数据 | <span style="color:#61afef">蓝色RX</span>：接收数据</p>
+        <p>• 输入端可发送十六进制字符串测试（如：01 03 00 00 00 01）</p>
+        <p>• 输出端输出格式化的通信日志</p>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="rs485-debug">
+    <p>RS485/Modbus通信调试节点，用于抓取并显示原始字节流</p>
+    
+    <h3>功能</h3>
+    <ul>
+        <li>实时显示RS485总线通信数据</li>
+        <li>自动解析Modbus RTU帧结构</li>
+        <li>支持十六进制和ASCII两种显示模式</li>
+        <li>可手动发送测试帧</li>
+    </ul>
+
+    <h3>输入</h3>
+    <p>发送十六进制字符串或Buffer到RS485总线</p>
+    <pre>msg.payload = "01 03 00 00 00 01 84 0A"</pre>
+
+    <h3>输出</h3>
+    <dl>
+        <dt>payload</dt><dd>格式化的通信日志字符串</dd>
+        <dt>topic</dt><dd>rs485/tx 或 rs485/rx</dd>
+        <dt>rs485</dt><dd>完整的通信数据对象（含时间戳、原始数据等）</dd>
+    </dl>
+
+    <h3>Modbus功能码解析</h3>
+    <ul>
+        <li>0x01 - 读线圈</li>
+        <li>0x03 - 读保持寄存器</li>
+        <li>0x06 - 写单寄存器</li>
+        <li>0x10 - 写多寄存器</li>
+    </ul>
+</script>

package/nodes/rs485-debug.js

@@ -0,0 +1,220 @@
+/**
+ * RS485 Debug Node
+ * 用于抓取并显示原始485字节流，以十六进制格式输出
+ * 帮助调试串口或TCP网关下的Modbus通信
+ */
+
+module.exports = function(RED) {
+    function RS485DebugNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        node.name = config.name || '';
+        node.rs485Config = RED.nodes.getNode(config.rs485Config);
+        node.displayMode = config.displayMode || 'hex';  // hex, ascii, both
+        node.showTimestamp = config.showTimestamp !== false;
+        node.maxMessages = parseInt(config.maxMessages) || 100;
+        
+        // 消息缓存
+        node.messageBuffer = [];
+
+        if (!node.rs485Config) {
+            node.status({ fill: 'red', shape: 'ring', text: '未配置RS485连接' });
+            return;
+        }
+
+        // 更新状态
+        function updateStatus() {
+            const configName = node.rs485Config.name || `${node.rs485Config.host}:${node.rs485Config.port}`;
+            if (node.rs485Config.connected) {
+                node.status({ fill: 'green', shape: 'dot', text: `监听中 ${configName} (${node.messageBuffer.length}条)` });
+            } else {
+                node.status({ fill: 'yellow', shape: 'ring', text: `等待连接 ${configName}...` });
+            }
+        }
+
+        // 格式化数据为十六进制
+        function formatHex(buffer) {
+            if (!Buffer.isBuffer(buffer)) {
+                buffer = Buffer.from(buffer);
+            }
+            return buffer.toString('hex').toUpperCase().match(/.{1,2}/g)?.join(' ') || '';
+        }
+
+        // 格式化数据为ASCII（可打印字符）
+        function formatAscii(buffer) {
+            if (!Buffer.isBuffer(buffer)) {
+                buffer = Buffer.from(buffer);
+            }
+            let result = '';
+            for (let i = 0; i < buffer.length; i++) {
+                const byte = buffer[i];
+                result += (byte >= 32 && byte <= 126) ? String.fromCharCode(byte) : '.';
+            }
+            return result;
+        }
+
+        // 解析Modbus功能码
+        function parseModbusFunction(buffer) {
+            if (!Buffer.isBuffer(buffer) || buffer.length < 2) return null;
+            const funcCode = buffer[1];
+            const funcNames = {
+                0x01: '读线圈',
+                0x02: '读离散输入',
+                0x03: '读保持寄存器',
+                0x04: '读输入寄存器',
+                0x05: '写单线圈',
+                0x06: '写单寄存器',
+                0x0F: '写多线圈',
+                0x10: '写多寄存器'
+            };
+            return {
+                slaveAddr: buffer[0],
+                funcCode: funcCode,
+                funcName: funcNames[funcCode] || '未知(0x' + funcCode.toString(16).toUpperCase() + ')'
+            };
+        }
+
+        // 处理接收到的数据帧
+        function handleFrame(frame, direction) {
+            const timestamp = new Date();
+            const hexData = formatHex(frame);
+            const modbusInfo = parseModbusFunction(frame);
+            
+            const msg = {
+                timestamp: timestamp.toISOString(),
+                timestampLocal: timestamp.toLocaleTimeString('zh-CN', { hour12: false }) + '.' + timestamp.getMilliseconds().toString().padStart(3, '0'),
+                direction: direction,  // 'TX' or 'RX'
+                length: frame.length,
+                hex: hexData,
+                raw: frame,
+                modbus: modbusInfo
+            };
+
+            if (node.displayMode === 'ascii' || node.displayMode === 'both') {
+                msg.ascii = formatAscii(frame);
+            }
+
+            // 添加到缓存
+            node.messageBuffer.push(msg);
+            if (node.messageBuffer.length > node.maxMessages) {
+                node.messageBuffer.shift();
+            }
+
+            // 构建输出payload
+            let displayText = '';
+            if (node.showTimestamp) {
+                displayText += '[' + msg.timestampLocal + '] ';
+            }
+            displayText += (direction === 'TX' ? '→ TX: ' : '← RX: ');
+            displayText += hexData;
+            
+            if (modbusInfo) {
+                displayText += ' | 从机:' + modbusInfo.slaveAddr + ' ' + modbusInfo.funcName;
+            }
+
+            // 输出消息
+            node.send({
+                payload: displayText,
+                topic: 'rs485/' + direction.toLowerCase(),
+                rs485: msg
+            });
+
+            // 同时输出到debug面板
+            node.debug(displayText);
+            updateStatus();
+        }
+
+        // 【重要】先绑定事件监听器，再注册到配置节点
+        // 否则如果连接很快建立，事件可能丢失
+        
+        // 监听发送帧
+        node.rs485Config.on('tx', function(frame) {
+            handleFrame(frame, 'TX');
+        });
+
+        // 监听原始接收数据（显示所有总线数据）
+        node.rs485Config.on('data', function(data) {
+            handleFrame(data, 'RX');
+        });
+
+        // 连接状态事件
+        node.rs485Config.on('connected', function() {
+            node.log(`RS485连接已建立: ${node.rs485Config.host}:${node.rs485Config.port}`);
+            updateStatus();
+        });
+
+        node.rs485Config.on('disconnected', function() {
+            node.warn('RS485连接已断开');
+            updateStatus();
+        });
+
+        node.rs485Config.on('error', function(err) {
+            node.error('RS485错误: ' + err.message);
+            node.status({ fill: 'red', shape: 'ring', text: '错误: ' + err.message });
+        });
+
+        // 现在注册到配置节点（这会触发连接）
+        node.rs485Config.register(node);
+        node.log(`已注册到RS485配置: ${node.rs485Config.host}:${node.rs485Config.port}`);
+
+        // 处理输入消息（手动发送测试帧）
+        node.on('input', function(msg) {
+            if (msg.payload) {
+                let frame;
+                if (Buffer.isBuffer(msg.payload)) {
+                    frame = msg.payload;
+                } else if (typeof msg.payload === 'string') {
+                    // 尝试解析十六进制字符串
+                    const hexStr = msg.payload.replace(/\s/g, '');
+                    if (/^[0-9A-Fa-f]+$/.test(hexStr)) {
+                        frame = Buffer.from(hexStr, 'hex');
+                    }
+                }
+                
+                if (frame && node.rs485Config.connected) {
+                    node.rs485Config.send(frame);
+                    handleFrame(frame, 'TX');
+                    node.log('手动发送: ' + formatHex(frame));
+                } else if (!node.rs485Config.connected) {
+                    node.warn('RS485未连接，无法发送');
+                }
+            }
+        });
+
+        // 初始状态
+        updateStatus();
+
+        // 清理
+        node.on('close', function(done) {
+            if (node.rs485Config) {
+                node.rs485Config.deregister(node);
+            }
+            node.messageBuffer = [];
+            done();
+        });
+    }
+
+    RED.nodes.registerType('rs485-debug', RS485DebugNode);
+
+    // API: 获取消息历史
+    RED.httpAdmin.get('/rs485-debug/history/:nodeId', function(req, res) {
+        const node = RED.nodes.getNode(req.params.nodeId);
+        if (node && node.messageBuffer) {
+            res.json(node.messageBuffer);
+        } else {
+            res.json([]);
+        }
+    });
+
+    // API: 清空消息历史
+    RED.httpAdmin.post('/rs485-debug/clear/:nodeId', function(req, res) {
+        const node = RED.nodes.getNode(req.params.nodeId);
+        if (node) {
+            node.messageBuffer = [];
+            res.json({ success: true });
+        } else {
+            res.json({ success: false, error: '节点未找到' });
+        }
+    });
+};