node-red-contrib-symi-mesh 1.2.3

package/nodes/symi-device.html

@@ -0,0 +1,303 @@
+<script type="text/javascript">
+    RED.nodes.registerType('symi-device', {
+        category: 'Symi Mesh',
+        color: '#89CFF0',
+        defaults: {
+            name: { value: '' },
+            gateway: { value: '', type: 'symi-gateway', required: true },
+            deviceMac: { value: '', required: true },
+            channel: { value: 1 },
+            deviceData: { value: '' },
+            outputFormat: { value: 'full' },
+            threeInOneSubType: { value: 'ac' },
+            threeInOneRealMac: { value: '' }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'bridge.png',
+        label: function() {
+            if (this.name) return this.name;
+            if (this.deviceMac && this.channel > 1) {
+                return 'Symi设备-' + this.channel + '路';
+            }
+            return 'Symi设备';
+        },
+        labelStyle: function() {
+            return this.name ? 'node_label_italic' : '';
+        },
+        oneditprepare: function() {
+            var node = this;
+            node._deviceCache = {};
+            
+            var updateChannelSelector = function(channels) {
+                if (channels > 1) {
+                    $('.channel-row').show();
+                    var channelSelect = $('#node-input-channel');
+                    channelSelect.empty();
+                    for (var i = 1; i <= channels; i++) {
+                        channelSelect.append($('<option></option>').val(i).text('第' + i + '路'));
+                    }
+                    if (node.channel) {
+                        channelSelect.val(node.channel);
+                    }
+                } else {
+                    $('.channel-row').hide();
+                }
+            };
+            
+            var updateThreeInOneSelector = function(deviceType) {
+                if (deviceType === 0x94 || deviceType === 148) {
+                    $('.three-in-one-row').show();
+                    $('.three-in-one-mac-row').show();
+                } else {
+                    $('.three-in-one-row').hide();
+                    $('.three-in-one-mac-row').hide();
+                }
+            };
+            
+            var loadDevices = function(gatewayId) {
+                if (!gatewayId) {
+                    return;
+                }
+                
+                var deviceSelect = $('#node-input-deviceMac');
+                var currentValue = deviceSelect.val();
+                
+                deviceSelect.empty();
+                deviceSelect.append('<option value="">-- 选择设备 --</option>');
+                
+                $.getJSON('/symi-gateway/devices/' + gatewayId)
+                    .done(function(devices) {
+                        console.log('加载设备列表:', devices.length, '个设备');
+                        if (devices && devices.length > 0) {
+                            devices.forEach(function(device) {
+                                var label = device.name + ' (' + device.mac + ')';
+                                if (device.channels > 1) {
+                                    label += ' [' + device.channels + '路]';
+                                }
+                                if (device.isThreeInOne) {
+                                    label += ' [三合一]';
+                                }
+                                var option = $('<option></option>')
+                                    .val(device.mac)
+                                    .text(label)
+                                    .data('channels', device.channels)
+                                    .data('deviceType', device.isThreeInOne ? 0x94 : device.deviceType);
+                                deviceSelect.append(option);
+                                node._deviceCache[device.mac] = device;
+                            });
+                        }
+                        
+                        if (currentValue) {
+                            deviceSelect.val(currentValue);
+                        } else if (node.deviceMac) {
+                            deviceSelect.val(node.deviceMac);
+                        }
+                        
+                        deviceSelect.trigger('change');
+                    })
+                    .fail(function(err) {
+                        console.log('加载设备失败:', err);
+                    });
+            };
+            
+            $('#node-input-gateway').on('change', function() {
+                loadDevices($(this).val());
+            });
+            
+            $('#node-input-deviceMac').on('change', function() {
+                var selectedMac = $(this).val();
+                if (!selectedMac) {
+                    $('.channel-row').hide();
+                    $('.three-in-one-row').hide();
+                    return;
+                }
+                
+                var device = node._deviceCache[selectedMac];
+                if (!device) {
+                    var selectedOption = $(this).find('option:selected');
+                    var channels = selectedOption.data('channels') || 1;
+                    var deviceType = selectedOption.data('deviceType') || 0;
+                    updateChannelSelector(channels);
+                    updateThreeInOneSelector(deviceType);
+                } else {
+                    updateChannelSelector(device.channels);
+                    updateThreeInOneSelector(device.deviceType);
+                }
+            });
+            
+            if (this.deviceMac && this.deviceData) {
+                try {
+                    var savedDevice = JSON.parse(this.deviceData);
+                    if (savedDevice.channels > 1) {
+                        updateChannelSelector(savedDevice.channels);
+                    }
+                    if (savedDevice.deviceType === 0x94 || savedDevice.deviceType === 148) {
+                        updateThreeInOneSelector(savedDevice.deviceType);
+                    }
+                } catch(e) {}
+            }
+            
+            if (this.gateway) {
+                loadDevices(this.gateway);
+            }
+        },
+        oneditsave: function() {
+            var selectedMac = $('#node-input-deviceMac').val();
+            if (selectedMac && this._deviceCache && this._deviceCache[selectedMac]) {
+                this.deviceData = JSON.stringify(this._deviceCache[selectedMac]);
+            }
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="symi-device">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> 名称</label>
+        <input type="text" id="node-input-name" placeholder="设备名称">
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-gateway"><i class="fa fa-server"></i> 网关</label>
+        <input type="text" id="node-input-gateway">
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-deviceMac"><i class="fa fa-microchip"></i> 设备</label>
+        <select id="node-input-deviceMac" style="width:70%">
+            <option value="">-- 选择设备 --</option>
+        </select>
+        <input type="hidden" id="node-input-deviceData">
+    </div>
+    
+    <div class="form-row channel-row" style="display:none">
+        <label for="node-input-channel"><i class="fa fa-th"></i> 通道</label>
+        <select id="node-input-channel" style="width:70%">
+            <option value="1">第1路</option>
+        </select>
+    </div>
+    
+    <div class="form-row three-in-one-row" style="display:none">
+        <label for="node-input-threeInOneSubType"><i class="fa fa-th-list"></i> 子实体</label>
+        <select id="node-input-threeInOneSubType" style="width:70%">
+            <option value="ac">空调</option>
+            <option value="fresh_air">新风</option>
+            <option value="floor_heating">地暖</option>
+        </select>
+    </div>
+    
+    <div class="form-row three-in-one-mac-row" style="display:none">
+        <label for="node-input-threeInOneRealMac"><i class="fa fa-id-card"></i> 真实MAC</label>
+        <input type="text" id="node-input-threeInOneRealMac" placeholder="CCDA20B84A89" style="width:70%">
+        <div style="margin-left: 105px; margin-top: 5px;">
+            <small>输入12位MAC地址（无冒号，如CCDA20B84A89）</small>
+        </div>
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-outputFormat"><i class="fa fa-list"></i> 输出格式</label>
+        <select id="node-input-outputFormat">
+            <option value="full">完整（包含设备信息）</option>
+            <option value="simple">简单（仅状态值）</option>
+        </select>
+    </div>
+    
+    <div class="form-tips">
+        <p><b>输入：</b>接收控制命令，支持多种格式</p>
+        <p><b>输出：</b>设备状态变化时自动输出</p>
+        <p><b>KNX同步：</b>直接与KNX节点连线即可实现双向同步</p>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="symi-device">
+    <p>Symi Mesh设备节点，同时支持输入控制和输出状态反馈</p>
+    
+    <h3>输入 (控制设备)</h3>
+    <p>接收以下格式的控制命令：</p>
+    
+    <h4>开关控制</h4>
+    <pre>msg.payload = true;           // 打开
+msg.payload = false;          // 关闭
+msg.payload = "on";           // 打开
+msg.payload = 1;              // 打开
+msg.channel = 1;              // 多路开关指定通道(1-6)</pre>
+    
+    <h4>调光控制</h4>
+    <pre>msg.command = "brightness";
+msg.payload = 80;             // 亮度 0-100
+
+msg.command = "colorTemp";
+msg.payload = 50;             // 色温 0-100
+
+msg.command = "rgb";
+msg.payload = {               // RGB颜色
+    r: 255, g: 128, b: 64,
+    ww: 0, cw: 0              // 可选
+};</pre>
+    
+    <h4>窗帘控制</h4>
+    <pre>msg.payload = "open";         // 打开
+msg.payload = "close";        // 关闭
+msg.payload = "stop";         // 停止
+msg.payload = 50;             // 位置 0-100</pre>
+    
+    <h4>温控控制</h4>
+    <pre>msg.command = "temperature";
+msg.payload = 25;             // 温度 16-30
+
+msg.command = "mode";
+msg.payload = "cool";         // cool/heat/fan_only/dry
+
+msg.command = "fan";
+msg.payload = "auto";         // high/medium/low/auto</pre>
+    
+    <h4>场景控制</h4>
+    <pre>msg.payload = 2;              // 场景ID 0-31</pre>
+    
+    <h3>输出 (状态反馈)</h3>
+    <p>设备状态变化时自动输出：</p>
+    
+    <h4>完整格式 (outputFormat: full)</h4>
+    <pre>{
+    topic: "设备名称",
+    payload: {
+        switch: true,         // 或其他状态字段
+        brightness: 80,
+        ...
+    },
+    device: {
+        mac: "aa:bb:cc:dd:ee:ff",
+        name: "设备名称",
+        type: "light",
+        address: 0x1234
+    },
+    attrType: 0x03
+}</pre>
+    
+    <h4>简单格式 (outputFormat: simple)</h4>
+    <pre>{
+    topic: "设备名称",
+    payload: true             // 或 80, 或其他状态值
+}</pre>
+    
+    <h3>KNX双向同步</h3>
+    <p>直接与KNX节点连线实现双向同步：</p>
+    <pre>
+[KNX节点] ----输出---→ [Symi设备节点] ----输入
+    ↑                           ↓
+    └--------输入←------输出-----┘
+    
+双向连线后：
+- KNX控制 → Symi设备执行
+- Symi状态变化 → KNX同步
+</pre>
+    
+    <h3>使用技巧</h3>
+    <ul>
+        <li>从下拉列表选择设备，无需手动输入MAC地址</li>
+        <li>一个节点同时处理输入和输出</li>
+        <li>可以与inject、debug、KNX、function等任意节点连接</li>
+        <li>支持msg覆盖配置（如channel、command等）</li>
+    </ul>
+</script>
+

package/nodes/symi-device.js

@@ -0,0 +1,344 @@
+/**
+ * Symi Device Node - 设备节点（同时支持输入控制和输出状态）
+ */
+
+module.exports = function(RED) {
+    function SymiDeviceNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+        
+        node.gateway = RED.nodes.getNode(config.gateway);
+        node.deviceMac = config.deviceMac;
+        node.channel = parseInt(config.channel) || 1;
+        node.outputFormat = config.outputFormat || 'full';
+        node.threeInOneSubType = config.threeInOneSubType || 'ac';
+        node.threeInOneRealMac = config.threeInOneRealMac || '';
+        
+        // 如果提供了真实MAC，更新设备
+        if (node.threeInOneRealMac && node.deviceMac && node.deviceMac.startsWith('00:00:00:00:')) {
+            setTimeout(() => {
+                const device = node.gateway.getDevice(node.deviceMac);
+                if (device && device.isThreeInOne) {
+                    // MAC反序并格式化
+                    const cleanMac = node.threeInOneRealMac.replace(/[:-]/g, '').toLowerCase();
+                    if (cleanMac.length === 12) {
+                        const reversedMac = cleanMac.match(/.{2}/g).reverse().join(':');
+                        node.gateway.updateThreeInOneMac(device.networkAddress, reversedMac);
+                        node.log(`已更新三合一面板MAC: ${reversedMac}`);
+                    }
+                }
+            }, 2000);
+        }
+        
+        if (!node.gateway) {
+            node.error('未配置网关');
+            node.status({ fill: 'red', shape: 'ring', text: '未配置网关' });
+            return;
+        }
+        
+        node.device = null;
+        node.status({ fill: 'yellow', shape: 'ring', text: '等待连接' });
+        
+        const updateDevice = () => {
+            if (node.deviceMac) {
+                node.device = node.gateway.getDevice(node.deviceMac);
+                if (node.device) {
+                    const channelInfo = node.device.channels > 1 ? ` 第${node.channel}路` : '';
+                    node.status({ 
+                        fill: 'green', 
+                        shape: 'dot', 
+                        text: `已连接${channelInfo}` 
+                    });
+                } else {
+                    node.status({ fill: 'yellow', shape: 'ring', text: '等待设备' });
+                }
+            }
+        };
+        
+        const handleStateChange = (eventData) => {
+            if (!node.deviceMac || eventData.device.macAddress !== node.deviceMac) {
+                return;
+            }
+            
+            updateDevice();
+            
+            const msg = node.formatOutput(eventData);
+            node.send(msg);
+            
+            node.status({ 
+                fill: 'green', 
+                shape: 'dot', 
+                text: `最后更新: ${new Date().toLocaleTimeString()}` 
+            });
+        };
+        
+        node.gateway.on('gateway-connected', () => {
+            node.status({ fill: 'green', shape: 'ring', text: '网关已连接' });
+            updateDevice();
+        });
+        
+        node.gateway.on('gateway-disconnected', () => {
+            node.status({ fill: 'red', shape: 'ring', text: '网关断开' });
+        });
+        
+        node.gateway.on('device-list-complete', () => {
+            updateDevice();
+        });
+        
+        node.gateway.on('device-state-changed', handleStateChange);
+        
+        node.on('input', async function(msg) {
+            try {
+                if (!node.gateway.connected) {
+                    node.error('网关未连接');
+                    return;
+                }
+                
+                if (!node.device) {
+                    updateDevice();
+                    if (!node.device) {
+                        node.error('设备未找到');
+                        return;
+                    }
+                }
+                
+                const command = node.parseInputCommand(msg);
+                if (!command) {
+                    node.warn('无效的命令格式');
+                    return;
+                }
+                
+                await node.sendControl(command);
+                
+                node.status({ fill: 'green', shape: 'dot', text: '命令已发送' });
+                
+            } catch (error) {
+                node.error(`控制失败: ${error.message}`);
+                node.status({ fill: 'red', shape: 'dot', text: '控制失败' });
+            }
+        });
+        
+        node.on('close', () => {
+            node.gateway.removeListener('device-state-changed', handleStateChange);
+            node.status({});
+        });
+        
+        updateDevice();
+    }
+
+    SymiDeviceNode.prototype.parseInputCommand = function(msg) {
+        const payload = msg.payload;
+        const device = this.device;
+        const entityType = device.getEntityType();
+        
+        let command = null;
+        
+        if (entityType === 'switch') {
+            const channel = parseInt(msg.channel) || node.channel || 1;
+            let value;
+            
+            if (typeof payload === 'boolean') {
+                value = payload;
+            } else if (typeof payload === 'number') {
+                value = payload > 0;
+            } else if (typeof payload === 'string') {
+                value = payload.toLowerCase() === 'on' || payload === '1' || payload === 'true';
+            } else {
+                return null;
+            }
+            
+            command = {
+                attrType: 0x02,
+                param: this.buildSwitchParam(channel, value, device.channels)
+            };
+            
+        } else if (entityType === 'light') {
+            if (msg.command === 'brightness' || (!msg.command && typeof payload === 'number')) {
+                const brightness = Math.max(0, Math.min(100, parseInt(payload)));
+                command = { attrType: 0x03, param: Buffer.from([brightness]) };
+                
+            } else if (msg.command === 'colorTemp') {
+                const colorTemp = Math.max(0, Math.min(100, parseInt(payload)));
+                command = { attrType: 0x04, param: Buffer.from([colorTemp]) };
+                
+            } else if (msg.command === 'rgb' && typeof payload === 'object') {
+                // 五色调光：RGB+WW+CW，参数范围0-100（百分比）
+                const r = Math.max(0, Math.min(100, parseInt(payload.r || 0)));
+                const g = Math.max(0, Math.min(100, parseInt(payload.g || 0)));
+                const b = Math.max(0, Math.min(100, parseInt(payload.b || 0)));
+                const ww = Math.max(0, Math.min(100, parseInt(payload.ww || 0)));
+                const cw = Math.max(0, Math.min(100, parseInt(payload.cw || 0)));
+                command = { attrType: 0x11, param: Buffer.from([r, g, b, ww, cw]) };
+                
+            } else if (typeof payload === 'boolean' || typeof payload === 'string') {
+                const value = typeof payload === 'boolean' ? payload : 
+                              (payload.toLowerCase() === 'on' || payload === '1');
+                command = { attrType: 0x02, param: Buffer.from([value ? 0x02 : 0x01]) };
+            }
+            
+        } else if (entityType === 'cover') {
+            if (typeof payload === 'string') {
+                const actions = { 'open': 0x01, 'close': 0x02, 'stop': 0x03 };
+                const action = actions[payload.toLowerCase()];
+                if (action) {
+                    command = { attrType: 0x05, param: Buffer.from([action]) };
+                }
+            } else if (typeof payload === 'number') {
+                const position = Math.max(0, Math.min(100, parseInt(payload)));
+                command = { attrType: 0x06, param: Buffer.from([position]) };
+            }
+            
+        } else if (entityType === 'climate') {
+            if (msg.command === 'temperature') {
+                const temp = Math.max(16, Math.min(30, parseInt(payload)));
+                command = { attrType: 0x1B, param: Buffer.from([temp]) };
+                
+            } else if (msg.command === 'mode') {
+                const modes = { 'cool': 1, 'heat': 2, 'fan_only': 3, 'dry': 4, 'off': 0 };
+                const mode = modes[payload] || 0;
+                if (mode > 0) {
+                    command = { attrType: 0x1D, param: Buffer.from([mode]) };
+                }
+                
+            } else if (msg.command === 'fan') {
+                const fans = { 'high': 1, 'medium': 2, 'low': 3, 'auto': 4 };
+                const fan = fans[payload] || 4;
+                command = { attrType: 0x1C, param: Buffer.from([fan]) };
+            }
+            
+        } else if (entityType === 'scene') {
+            const sceneId = parseInt(payload);
+            if (sceneId >= 0 && sceneId <= 31) {
+                command = { sceneId: sceneId };
+            }
+            
+        } else if (entityType === 'three_in_one') {
+            // 三合一设备控制
+            const subType = msg.subType || this.threeInOneSubType;
+            
+            if (subType === 'ac') {
+                // 空调控制
+                if (msg.command === 'temperature') {
+                    const temp = Math.max(16, Math.min(30, parseInt(payload)));
+                    command = { attrType: 0x94, param: Buffer.from([1, 0x1B, temp]) };
+                } else if (msg.command === 'mode') {
+                    const modes = { 'cool': 1, 'heat': 2, 'fan_only': 3, 'dry': 4, 'off': 0 };
+                    const mode = modes[payload] || 0;
+                    if (mode > 0) {
+                        command = { attrType: 0x94, param: Buffer.from([1, 0x1D, mode]) };
+                    }
+                } else if (msg.command === 'fan') {
+                    const fans = { 'high': 1, 'medium': 2, 'low': 3, 'auto': 4 };
+                    const fan = fans[payload] || 4;
+                    command = { attrType: 0x94, param: Buffer.from([1, 0x1C, fan]) };
+                }
+                
+            } else if (subType === 'fresh_air') {
+                // 新风控制
+                if (msg.command === 'switch' || typeof payload === 'boolean') {
+                    const switchValue = typeof payload === 'boolean' ? payload : 
+                                       (payload.toLowerCase() === 'on' || payload === '1');
+                    command = { attrType: 0x94, param: Buffer.from([2, 0x02, switchValue ? 0x02 : 0x01]) };
+                } else if (msg.command === 'speed') {
+                    const speed = Math.max(0, Math.min(100, parseInt(payload)));
+                    command = { attrType: 0x94, param: Buffer.from([2, 0x03, speed]) };
+                } else if (msg.command === 'mode') {
+                    const modes = { 'low': 1, 'medium': 2, 'high': 3, 'auto': 4 };
+                    const mode = modes[payload] || 4;
+                    command = { attrType: 0x94, param: Buffer.from([2, 0x1C, mode]) };
+                }
+                
+            } else if (subType === 'floor_heating') {
+                // 地暖控制
+                if (msg.command === 'temperature') {
+                    const temp = Math.max(16, Math.min(35, parseInt(payload)));
+                    command = { attrType: 0x94, param: Buffer.from([3, 0x1B, temp]) };
+                } else if (msg.command === 'mode') {
+                    const modes = { 'heat': 2, 'off': 0 };
+                    const mode = modes[payload] || 0;
+                    if (mode > 0) {
+                        command = { attrType: 0x94, param: Buffer.from([3, 0x1D, mode]) };
+                    }
+                } else if (typeof payload === 'boolean' || typeof payload === 'string') {
+                    const value = typeof payload === 'boolean' ? payload : 
+                                 (payload.toLowerCase() === 'on' || payload === '1');
+                    command = { attrType: 0x94, param: Buffer.from([3, 0x02, value ? 0x02 : 0x01]) };
+                }
+            }
+        }
+        
+        return command;
+    };
+
+    SymiDeviceNode.prototype.buildSwitchParam = function(channel, value, totalChannels) {
+        // 使用新的状态组合算法，返回参数格式：[channels, targetChannel, targetState]
+        // 这将触发protocol.js中的状态查询和组合逻辑
+        return Buffer.from([totalChannels, channel, value ? 1 : 0]);
+    };
+
+    SymiDeviceNode.prototype.sendControl = async function(command) {
+        if (command.sceneId !== undefined) {
+            return await this.gateway.sendScene(command.sceneId);
+        } else {
+            return await this.gateway.sendControl(
+                this.device.networkAddress,
+                command.attrType,
+                command.param
+            );
+        }
+    };
+
+    SymiDeviceNode.prototype.formatOutput = function(eventData) {
+        const device = eventData.device;
+        const state = eventData.state;
+        const attrType = eventData.attrType;
+        
+        if (this.outputFormat === 'simple') {
+            return {
+                topic: device.name,
+                payload: this.extractMainValue(state, attrType)
+            };
+        }
+        
+        return {
+            topic: device.name,
+            payload: state,
+            device: {
+                mac: device.macAddress,
+                name: device.name,
+                type: device.getEntityType(),
+                address: device.networkAddress
+            },
+            attrType: attrType
+        };
+    };
+
+    SymiDeviceNode.prototype.extractMainValue = function(state, attrType) {
+        switch (attrType) {
+            case 0x02: return state.switch !== undefined ? state.switch : state;
+            case 0x03: return state.brightness;
+            case 0x04: return state.colorTemp;
+            case 0x05: return state.curtainStatus;
+            case 0x06: return state.curtainPosition;
+            case 0x0C: return state.motion;
+            case 0x11: return state.rgb;
+            case 0x1B: return state.targetTemp;
+            case 0x1C: return state.fanMode;
+            case 0x1D: return state.climateMode;
+            case 0x94: 
+                // 三合一设备，根据子类型返回状态
+                if (this.threeInOneSubType === 'ac') {
+                    return state.ac || state;
+                } else if (this.threeInOneSubType === 'fresh_air') {
+                    return state.fresh_air || state;
+                } else if (this.threeInOneSubType === 'floor_heating') {
+                    return state.floor_heating || state;
+                }
+                return state;
+            default: return state;
+        }
+    };
+
+    RED.nodes.registerType('symi-device', SymiDeviceNode);
+};
+