node-red-contrib-symi-modbus 1.6.0 → 1.6.1

package/README.md

@@ -1235,7 +1235,156 @@ python -m pymodbus.server tcp --port 502
 
 ## 更新日志
 
-### v1.6.0 (2025-10-18) - 智能MQTT连接和Docker/容器环境完美兼容 ✅最新稳定版
+### v1.6.1 (2025-10-18) - 增强日志和故障诊断 ✅最新稳定版
+
+#### 核心改进
+
+**1. 详细的连接状态日志**
+- ✅ 使用emoji图标（✅❌）清晰显示连接状态
+- ✅ Modbus连接成功/失败日志：`✅ Modbus已连接` 或 `❌ Modbus连接失败`
+- ✅ MQTT连接成功日志：`✅ MQTT已连接`
+- ✅ 节点状态栏显示：`Modbus✓ MQTT✓`（绿色圆点）或 `Modbus✗ MQTT✗`（红色圆环）
+
+**2. 完整的状态发布日志**
+- ✅ 每次发布状态到MQTT都显示日志：`📤 发布状态: modbus/relay/10/0/state = ON`
+- ✅ 首次轮询日志：`📊 从站10首次轮询成功，发布32个状态到MQTT`
+- ✅ 状态变化日志：`📊 从站10状态变化，发布5个更新到MQTT`
+- ✅ MQTT未连接警告：`无法发布状态: MQTT未连接 (从站10 线圈0)`
+
+**3. 轮询详情日志**
+- ✅ 开始轮询日志：`🔄 开始轮询 1 个从站设备: 从站10(线圈0-31)`
+- ✅ 连接状态检查：`📡 Modbus连接: 已连接✅, MQTT连接: 已连接✅`
+- ✅ 帮助用户快速定位问题（Modbus连接失败？MQTT连接失败？轮询失败？）
+
+**4. 故障诊断指南**
+
+#### HA实体不可用问题排查步骤
+
+**步骤1：检查Node-RED日志（最重要！）**
+
+```
+✅ 正常日志（一切正常）:
+✅ Modbus已连接: 127.0.0.1:502
+✅ MQTT已连接: mqtt://localhost:1883
+🔄 开始轮询 1 个从站设备: 从站10(线圈0-31)
+📡 Modbus连接: 已连接✅, MQTT连接: 已连接✅
+📊 从站10首次轮询成功，发布32个状态到MQTT
+📤 发布状态: modbus/relay/10/0/state = OFF
+📤 发布状态: modbus/relay/10/1/state = OFF
+... (共32个)
+
+❌ 问题1：Modbus未连接
+❌ Modbus连接失败: connect ECONNREFUSED 127.0.0.1:502
+解决：检查Modbus设备是否运行，地址端口是否正确
+
+❌ 问题2：MQTT未连接
+MQTT错误: connect ECONNREFUSED 127.0.0.1:1883
+所有MQTT broker候选地址都无法连接
+解决：启动MQTT broker (mosquitto)
+
+❌ 问题3：Modbus已连接，但无状态发布
+✅ Modbus已连接
+✅ MQTT已连接
+🔄 开始轮询...
+轮询从站10失败: Timed out
+解决：检查从站地址是否正确，设备是否在线
+```
+
+**步骤2：检查mosquitto日志**
+
+```bash
+# 查看mosquitto日志，确认是否收到状态消息
+tail -f /var/log/mosquitto/mosquitto.log
+
+# 应该看到类似输出：
+Received PUBLISH from modbus_master_xxx (d0, q1, r1, ..., 'modbus/relay/10/0/state', ... (2 bytes))
+Received PUBLISH from modbus_master_xxx (d0, q1, r1, ..., 'modbus/relay/10/1/state', ... (3 bytes))
+```
+
+如果**只看到discovery消息，没有state消息**，说明Modbus轮询失败或状态未发布。
+
+**步骤3：使用MQTT客户端测试**
+
+```bash
+# 订阅所有状态主题
+mosquitto_sub -h localhost -t 'modbus/relay/#' -v
+
+# 应该看到：
+modbus/relay/10/availability online
+modbus/relay/10/0/state OFF
+modbus/relay/10/1/state OFF
+...
+```
+
+如果**只看到availability，没有state**，说明状态未发布。
+
+**步骤4：检查Home Assistant日志**
+
+在HA中查看日志，如果看到类似错误：
+```
+Payload is not supported: {...}
+Invalid fan_modes mode: 0
+```
+
+**这些错误与本节点无关**，这是其他MQTT设备的问题。本节点只发布switch类型实体。
+
+#### 常见问题和解决方案
+
+| 症状 | 原因 | 解决方案 |
+|-----|------|---------|
+| HA实体不可用（unavailable） | 1) Modbus未连接<br>2) MQTT未连接<br>3) 未发布状态 | 查看Node-RED日志，按上述步骤排查 |
+| Node-RED日志无Modbus连接 | Modbus设备未运行或地址错误 | 检查TCP地址/端口或串口配置 |
+| Node-RED日志无MQTT连接 | MQTT broker未运行 | 启动mosquitto服务 |
+| Modbus和MQTT都已连接，但无状态发布 | 1) 轮询失败<br>2) 从站地址错误 | 检查从站地址配置（默认10） |
+| mosquitto日志只有discovery | 状态未发布到MQTT | 检查Modbus轮询是否成功 |
+
+#### 技术改进
+
+**节点状态显示优化**：
+```javascript
+// 新增状态更新函数
+node.updateNodeStatus = function() {
+    const modbusStatus = node.isConnected ? "Modbus✓" : "Modbus✗";
+    const mqttStatus = node.mqttConnected ? "MQTT✓" : "MQTT✗";
+    
+    if (node.isConnected && node.mqttConnected) {
+        node.status({fill: "green", shape: "dot", text: `${modbusStatus} ${mqttStatus}`});
+    } else if (node.isConnected || node.mqttConnected) {
+        node.status({fill: "yellow", shape: "ring", text: `${modbusStatus} ${mqttStatus}`});
+    } else {
+        node.status({fill: "red", shape: "ring", text: `${modbusStatus} ${mqttStatus}`});
+    }
+};
+```
+
+**状态发布日志**：
+```javascript
+node.mqttClient.publish(stateTopic, payload, { qos: 1, retain: true }, (err) => {
+    if (err) {
+        node.warn(`❌ 发布状态失败: ${stateTopic} - ${err.message}`);
+    } else {
+        node.log(`📤 发布状态: ${stateTopic} = ${payload}`);
+    }
+});
+```
+
+#### 升级建议
+
+**从v1.6.0升级到v1.6.1**：
+```bash
+cd ~/.node-red
+npm install node-red-contrib-symi-modbus@latest
+# 重启Node-RED
+```
+
+**新功能**：
+- 无需修改配置，升级后自动获得详细日志
+- 在Node-RED界面中查看节点状态栏，一目了然
+- 出现问题时，日志会清晰指出问题所在
+
+---
+
+### v1.6.0 (2025-10-18) - 智能MQTT连接和Docker/容器环境完美兼容
 
 #### 核心功能
 

package/nodes/modbus-master.js

@@ -94,11 +94,26 @@ module.exports = function(RED) {
         node.currentSlaveIndex = 0;
         node.deviceStates = {}; // 存储每个设备的状态
         node.mqttClient = null;
+        node.mqttConnected = false; // MQTT连接状态
         node.isClosing = false;
         node.lastErrorLog = {}; // 记录每个从站的最后错误日志时间
         node.lastMqttErrorLog = 0; // MQTT错误日志时间
         node.errorLogInterval = 10 * 60 * 1000; // 错误日志间隔：10分钟
         
+        // 更新节点状态显示
+        node.updateNodeStatus = function() {
+            const modbusStatus = node.isConnected ? "Modbus✓" : "Modbus✗";
+            const mqttStatus = node.mqttConnected ? "MQTT✓" : "MQTT✗";
+            
+            if (node.isConnected && node.mqttConnected) {
+                node.status({fill: "green", shape: "dot", text: `${modbusStatus} ${mqttStatus}`});
+            } else if (node.isConnected || node.mqttConnected) {
+                node.status({fill: "yellow", shape: "ring", text: `${modbusStatus} ${mqttStatus}`});
+            } else {
+                node.status({fill: "red", shape: "ring", text: `${modbusStatus} ${mqttStatus}`});
+            }
+        };
+        
         // 初始化设备状态（基于从站配置列表）
         node.config.slaves.forEach((slave) => {
             const slaveId = slave.address;
@@ -131,7 +146,8 @@ module.exports = function(RED) {
                 
                 node.client.setTimeout(5000);
                 node.isConnected = true;
-                node.status({fill: "green", shape: "dot", text: "已连接"});
+                node.log(`✅ Modbus已连接: ${node.config.connectionType === "tcp" ? `${node.config.tcpHost}:${node.config.tcpPort}` : node.config.serialPort}`);
+                node.updateNodeStatus();
                 
                 // 清除错误日志记录（重新部署或重连时允许再次显示错误）
                 node.lastErrorLog = {};
@@ -141,9 +157,9 @@ module.exports = function(RED) {
                 node.startPolling();
                 
             } catch (err) {
-                node.error(`Modbus连接失败: ${err.message}`);
-                node.status({fill: "red", shape: "ring", text: "连接失败"});
+                node.error(`❌ Modbus连接失败: ${err.message}`);
                 node.isConnected = false;
+                node.updateNodeStatus();
                 
                 // 5秒后重试连接（使用定时器避免递归）
                 if (!node.isClosing && !node.reconnectTimer) {
@@ -262,7 +278,8 @@ module.exports = function(RED) {
                     lastConnectAttempt = Date.now();
                     
                     node.mqttClient.on('connect', () => {
-                        node.log(`MQTT已连接: ${brokerUrl}`);
+                        node.mqttConnected = true;
+                        node.log(`✅ MQTT已连接: ${brokerUrl}`);
                         
                         // 成功连接后，更新配置的broker地址（下次优先使用成功的地址）
                         if (brokerUrl !== brokerCandidates[0]) {
@@ -274,6 +291,9 @@ module.exports = function(RED) {
                         
                         // 订阅命令主题
                         node.subscribeCommands();
+                        
+                        // 更新状态显示
+                        node.updateNodeStatus();
                     });
                     
                     node.mqttClient.on('error', (err) => {
@@ -469,6 +489,7 @@ module.exports = function(RED) {
         // 发布MQTT状态
         node.publishMqttState = function(slaveId, coil, value) {
             if (!node.mqttClient || !node.mqttClient.connected) {
+                node.warn(`无法发布状态: MQTT未连接 (从站${slaveId} 线圈${coil})`);
                 return;
             }
             
@@ -478,7 +499,9 @@ module.exports = function(RED) {
             // 使用QoS=1确保消息送达，retain=true确保断线重连后可获取最新状态
             node.mqttClient.publish(stateTopic, payload, { qos: 1, retain: true }, (err) => {
                 if (err) {
-                    node.warn(`发布状态失败: ${stateTopic} - ${err.message}`);
+                    node.warn(`❌ 发布状态失败: ${stateTopic} - ${err.message}`);
+                } else {
+                    node.log(`📤 发布状态: ${stateTopic} = ${payload}`);
                 }
             });
         };
@@ -493,7 +516,9 @@ module.exports = function(RED) {
             node.lastErrorLog = {};
             node.lastMqttErrorLog = 0;
             
-            node.log(`开始轮询 ${node.config.slaves.length} 个从站设备`);
+            const slaveList = node.config.slaves.map(s => `从站${s.address}(线圈${s.coilStart}-${s.coilEnd})`).join(', ');
+            node.log(`🔄 开始轮询 ${node.config.slaves.length} 个从站设备: ${slaveList}`);
+            node.log(`📡 Modbus连接: ${node.isConnected ? '已连接✅' : '未连接❌'}, MQTT连接: ${node.mqttConnected ? '已连接✅' : '未连接❌'}`);
             node.currentSlaveIndex = 0;
             
             // 使用最小的轮询间隔
@@ -540,6 +565,7 @@ module.exports = function(RED) {
                 
                 // 更新设备状态
                 const isFirstPoll = !node.deviceStates[slaveId].initialPublished;
+                let publishCount = 0;
                 
                 for (let i = 0; i < coilCount; i++) {
                     const coilIndex = slave.coilStart + i;
@@ -551,6 +577,7 @@ module.exports = function(RED) {
                     // 第一次轮询或状态改变时，发布到MQTT和触发事件
                     if (isFirstPoll || oldValue !== newValue) {
                         node.publishMqttState(slaveId, coilIndex, newValue);
+                        publishCount++;
                         node.emit('stateUpdate', {
                             slave: slaveId,
                             coil: coilIndex,
@@ -559,6 +586,12 @@ module.exports = function(RED) {
                     }
                 }
                 
+                if (isFirstPoll) {
+                    node.log(`📊 从站${slaveId}首次轮询成功，发布${publishCount}个状态到MQTT`);
+                } else if (publishCount > 0) {
+                    node.log(`📊 从站${slaveId}状态变化，发布${publishCount}个更新到MQTT`);
+                }
+                
                 node.deviceStates[slaveId].lastUpdate = Date.now();
                 node.deviceStates[slaveId].error = null;
                 node.deviceStates[slaveId].initialPublished = true;  // 标记已发布初始状态
@@ -578,11 +611,7 @@ module.exports = function(RED) {
                 node.send(output);
                 
                 // 更新状态显示
-                node.status({
-                    fill: "green",
-                    shape: "dot",
-                    text: `从站${slaveId} 正常`
-                });
+                node.updateNodeStatus();
                 
             } catch (err) {
                 node.deviceStates[slaveId].error = err.message;
@@ -598,13 +627,7 @@ module.exports = function(RED) {
                 }
                 
                 // 更新状态显示
-                const failedCount = Object.values(node.deviceStates).filter(s => s.error).length;
-                const totalCount = node.config.slaves.length;
-                node.status({
-                    fill: failedCount === totalCount ? "red" : "yellow",
-                    shape: "ring",
-                    text: `正常: ${totalCount - failedCount}/${totalCount}`
-                });
+                node.updateNodeStatus();
                 
                 // 仅当全部从站都失败时，检测连接是否断开
                 if (failedCount === totalCount && err.message && 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "node-red-contrib-symi-modbus",
-  "version": "1.6.0",
-  "description": "Node-RED Modbus节点，支持TCP/串口通信、串口自动搜索、多设备轮询、智能MQTT连接（自动fallback到host.docker.internal等）、Home Assistant自动发现和多品牌开关面板，完美兼容Docker/容器环境",
+  "version": "1.6.1",
+  "description": "Node-RED Modbus节点，支持TCP/串口通信、串口自动搜索、多设备轮询、智能MQTT连接（自动fallback到host.docker.internal等）、Home Assistant自动发现和多品牌开关面板，增强日志和状态显示",
   "main": "nodes/modbus-master.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"