node-red-contrib-symi-mesh 1.2.3

package/nodes/symi-gateway.html

@@ -0,0 +1,83 @@
+<script type="text/javascript">
+    RED.nodes.registerType('symi-gateway', {
+        category: 'config',
+        defaults: {
+            name: { value: '' },
+            connectionType: { value: 'tcp' },
+            host: { value: '' },
+            port: { value: 4196 },
+            serialPort: { value: '' },
+            baudRate: { value: 115200 }
+        },
+        label: function() {
+            return this.name || (this.connectionType === 'tcp' 
+                ? `Symi Gateway (${this.host}:${this.port})` 
+                : `Symi Gateway (${this.serialPort})`);
+        },
+        oneditprepare: function() {
+            $('#node-config-input-connectionType').on('change', function() {
+                if ($(this).val() === 'tcp') {
+                    $('.tcp-config').show();
+                    $('.serial-config').hide();
+                } else {
+                    $('.tcp-config').hide();
+                    $('.serial-config').show();
+                }
+            }).trigger('change');
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="symi-gateway">
+    <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="网关名称">
+    </div>
+    
+    <div class="form-row">
+        <label for="node-config-input-connectionType"><i class="fa fa-plug"></i> 连接方式</label>
+        <select id="node-config-input-connectionType">
+            <option value="tcp">TCP/IP (局域网)</option>
+            <option value="serial">串口 (USB)</option>
+        </select>
+    </div>
+    
+    <div class="form-row tcp-config">
+        <label for="node-config-input-host"><i class="fa fa-server"></i> IP地址</label>
+        <input type="text" id="node-config-input-host" placeholder="192.168.1.100">
+    </div>
+    
+    <div class="form-row tcp-config">
+        <label for="node-config-input-port"><i class="fa fa-random"></i> 端口</label>
+        <input type="number" id="node-config-input-port" placeholder="4196">
+    </div>
+    
+    <div class="form-row serial-config">
+        <label for="node-config-input-serialPort"><i class="fa fa-usb"></i> 串口路径</label>
+        <input type="text" id="node-config-input-serialPort" placeholder="/dev/ttyUSB0 或 COM3">
+    </div>
+    
+    <div class="form-row serial-config">
+        <label for="node-config-input-baudRate"><i class="fa fa-tachometer"></i> 波特率</label>
+        <input type="number" id="node-config-input-baudRate" placeholder="115200">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="symi-gateway">
+    <p>Symi蓝牙Mesh网关配置节点</p>
+    <h3>连接方式</h3>
+    <dl>
+        <dt>TCP/IP</dt>
+        <dd>通过局域网连接网关，适用于网络版网关</dd>
+        <dt>串口</dt>
+        <dd>通过USB串口连接网关，适用于串口模块</dd>
+    </dl>
+    <h3>功能</h3>
+    <ul>
+        <li>自动连接并保持连接（断线重连）</li>
+        <li>自动发现设备（53 12 00 41命令）</li>
+        <li>MAC地址持久化存储</li>
+        <li>短地址动态更新</li>
+    </ul>
+</script>
+

package/nodes/symi-gateway.js

@@ -0,0 +1,450 @@
+/**
+ * Symi Gateway Configuration Node
+ */
+
+const TCPClient = require('../lib/tcp-client');
+const SerialClient = require('../lib/serial-client');
+const { DeviceManager } = require('../lib/device-manager');
+const { ProtocolHandler, parseStatusEvent, OP_RESP_DEVICE_LIST } = require('../lib/protocol');
+
+module.exports = function(RED) {
+    function SymiGatewayNode(config) {
+        RED.nodes.createNode(this, config);
+        
+        this.name = config.name;
+        this.connectionType = config.connectionType || 'tcp';
+        this.host = config.host;
+        this.port = parseInt(config.port) || 4196;
+        this.serialPort = config.serialPort;
+        this.baudRate = parseInt(config.baudRate) || 115200;
+        
+        this.client = null;
+        this.deviceManager = new DeviceManager(this.context(), this);
+        this.protocolHandler = new ProtocolHandler();
+        this.connected = false;
+        this.deviceListComplete = false;
+        this.isQueryingStates = false; // 标记是否正在查询状态
+        
+        this.log(`Initializing Symi Gateway: ${this.connectionType === 'tcp' ? `${this.host}:${this.port}` : this.serialPort}`);
+        
+        // 监听三合一设备检测事件
+        this.deviceManager.on('three-in-one-detected', async (device) => {
+            this.log(`三合一设备被识别，开始查询所有状态: ${device.name}`);
+            try {
+                // 查询环境温湿度（优先）
+                await this.sendControl(device.networkAddress, 0x16, Buffer.from([]));
+                await new Promise(r => setTimeout(r, 100));
+                await this.sendControl(device.networkAddress, 0x17, Buffer.from([]));
+                await new Promise(r => setTimeout(r, 100));
+                // 查询空调状态
+                await this.sendControl(device.networkAddress, 0x1B, Buffer.from([]));
+                await new Promise(r => setTimeout(r, 100));
+                await this.sendControl(device.networkAddress, 0x1C, Buffer.from([]));
+                await new Promise(r => setTimeout(r, 100));
+                await this.sendControl(device.networkAddress, 0x1D, Buffer.from([]));
+                await new Promise(r => setTimeout(r, 100));
+                // 查询新风状态
+                await this.sendControl(device.networkAddress, 0x68, Buffer.from([]));
+                await new Promise(r => setTimeout(r, 100));
+                await this.sendControl(device.networkAddress, 0x69, Buffer.from([]));
+                await new Promise(r => setTimeout(r, 100));
+                await this.sendControl(device.networkAddress, 0x6A, Buffer.from([]));
+                await new Promise(r => setTimeout(r, 100));
+                // 查询地暖状态
+                await this.sendControl(device.networkAddress, 0x6B, Buffer.from([]));
+                await new Promise(r => setTimeout(r, 100));
+                await this.sendControl(device.networkAddress, 0x6C, Buffer.from([]));
+                await new Promise(r => setTimeout(r, 100));
+                this.log(`三合一设备状态查询完成`);
+            } catch (error) {
+                this.warn(`三合一设备状态查询失败: ${error.message}`);
+            }
+        });
+        
+        this.connect();
+        
+        this.on('close', (done) => {
+            this.disconnect().then(done).catch(done);
+        });
+    }
+
+    SymiGatewayNode.prototype.connect = async function() {
+        try {
+            if (this.connectionType === 'tcp') {
+                this.client = new TCPClient(this.host, this.port, this);
+            } else {
+                this.client = new SerialClient(this.serialPort, this.baudRate, this);
+            }
+            
+            this.client.on('connected', () => {
+                this.log('Gateway connected');
+                this.connected = true;
+                this.emit('gateway-connected');
+                
+                // 连接成功后，延迟发现设备
+                setTimeout(() => {
+                    if (this.connected) {
+                        this.discoverDevices();
+                    }
+                }, 1000);
+            });
+            
+            this.client.on('disconnected', () => {
+                this.log('Gateway disconnected');
+                this.connected = false;
+                this.deviceListComplete = false;
+                this.isQueryingStates = false;
+                this.emit('gateway-disconnected');
+            });
+            
+            this.client.on('frame', (frame) => {
+                this.handleFrame(frame);
+            });
+            
+            this.client.on('error', (error) => {
+                // 错误已经在客户端记录，这里只做额外处理（如果需要）
+                this.debug(`Client error handled: ${error.message}`);
+            });
+            
+            // 尝试初始连接
+            await this.client.connect();
+            
+        } catch (error) {
+            // 初始连接失败，但自动重连会继续尝试
+            this.error(`Initial connection failed: ${error.message}, will retry automatically`);
+        }
+    };
+
+    SymiGatewayNode.prototype.disconnect = async function() {
+        if (this.client) {
+            await this.client.disconnect();
+            this.client = null;
+        }
+        this.connected = false;
+    };
+
+    SymiGatewayNode.prototype.handleFrame = function(frame) {
+        // 记录所有接收到的frame的详细信息
+        const frameHex = Buffer.from([frame.header, frame.opcode, ...(frame.status !== null ? [frame.status] : []), frame.length, ...frame.payload, frame.checksum]).toString('hex').toUpperCase();
+        this.log(`[TCP Frame] 接收: ${frameHex} (opcode=0x${frame.opcode.toString(16).toUpperCase()})`);
+        
+        if (frame.opcode === OP_RESP_DEVICE_LIST && frame.status === 0x00) {
+            this.parseDeviceListFrame(frame);
+        } else if (frame.isDeviceStatusEvent()) {
+            try {
+                const event = parseStatusEvent(frame);
+                this.log(`[状态事件] 地址=0x${event.networkAddress.toString(16).toUpperCase()}, 消息类型=0x${event.attrType.toString(16).toUpperCase()}, 参数=[${Array.from(event.parameters).map(p => '0x' + p.toString(16).toUpperCase()).join(', ')}]`);
+                
+                const device = this.deviceManager.updateDeviceState(
+                    event.networkAddress,
+                    event.attrType,
+                    event.parameters
+                );
+                
+                // 只在非查询状态期间才发送state-changed事件到MQTT
+                // 查询状态期间的事件只用于更新设备状态，不触发MQTT发布
+                if (device && !this.isQueryingStates) {
+                    this.emit('device-state-changed', {
+                        device: device,
+                        attrType: event.attrType,
+                        parameters: event.parameters,
+                        state: device.state
+                    });
+                }
+            } catch (error) {
+                this.error(`Error parsing status event: ${error.message}`);
+            }
+        } else if (frame.opcode === 0xB0) {
+            // 控制命令响应
+            this.log(`[控制响应] 0xB0: ${frameHex} ${frame.status === 0 ? '(成功)' : '(失败)'}`)
+        } else {
+            // 其他frame类型
+            this.log(`[其他Frame] ${frameHex}`);
+        }
+    };
+
+    SymiGatewayNode.prototype.parseDeviceListFrame = function(frame) {
+        if (frame.payload.length < 16) return;
+        
+        const maxDevices = frame.payload[0];
+        const index = frame.payload[1];
+        const macBytes = frame.payload.slice(2, 8);
+        const macAddress = Array.from(macBytes).map(b => b.toString(16).padStart(2, '0')).join(':');
+        const networkAddress = frame.payload[8] | (frame.payload[9] << 8);
+        const vendorId = frame.payload[10] | (frame.payload[11] << 8);
+        const deviceType = frame.payload[12];
+        const deviceSubType = frame.payload[13];
+        const statusByte = frame.payload[14];
+        const online = (statusByte & 0x01) === 0x01;
+        
+        const device = this.deviceManager.addOrUpdateDevice({
+            macAddress, networkAddress, deviceType, deviceSubType,
+            vendorId, online
+        });
+        
+        this.log(`Device ${index + 1}/${maxDevices}: ${device.name} @ 0x${networkAddress.toString(16).toUpperCase()}`);
+        
+        // 对于温控器类型(0x0A)，需要通过查询0x94来判断是否是三合一
+        if (deviceType === 10) {
+            device.needsThreeInOneCheck = true;
+            this.log(`温控器设备待检测，将通过0x94查询确认类型: ${device.name}`);
+        }
+        
+        if (index === maxDevices - 1) {
+            this.log(`Device discovery complete: ${maxDevices} devices`);
+            
+            // 先查询设备状态，完成后再触发device-list-complete
+            setTimeout(async () => {
+                this.isQueryingStates = true; // 开始查询状态
+                await this.queryAllDeviceStates();
+                this.isQueryingStates = false; // 查询完成
+                
+                this.deviceListComplete = true;
+                // 状态查询完成后才触发device-list-complete，确保设备类型已确认
+                this.emit('device-list-complete', this.deviceManager.getAllDevices());
+            }, 500);
+        }
+    };
+    
+    SymiGatewayNode.prototype.queryAllDeviceStates = async function() {
+        const devices = this.deviceManager.getAllDevices();
+        this.log(`开始查询${devices.length}个设备的初始状态...`);
+        
+        for (const device of devices) {
+            try {
+                let queryAttrs = [];
+                
+                // 根据设备类型查询不同属性
+                if ([1, 2, 3].includes(device.deviceType)) {
+                    queryAttrs = [0x02]; // 开关状态
+                } else if (device.deviceType === 9) {
+                    queryAttrs = [0x02, 0x0E]; // 插卡取电：开关状态、插卡状态
+                } else if (device.deviceType === 4 || device.deviceType === 0x18) {
+                    queryAttrs = [0x02, 0x03, 0x04]; // 灯光：开关、亮度、色温
+                } else if (device.deviceType === 5) {
+                    queryAttrs = [0x05, 0x06]; // 窗帘：运行状态、位置
+                } else if (device.deviceType === 10) {
+                    // 温控器类型：先查询三合一专用消息(0x68/0x6B)判断是否是三合一
+                    if (device.needsThreeInOneCheck) {
+                        this.log(`检测设备${device.name}是否为三合一面板...`);
+                        // 先查询0x68(新风开关)，如果有响应就是三合一
+                        queryAttrs = [0x68];
+                    } else if (device.isThreeInOne) {
+                        // 已确认是三合一，查询完整状态
+                        queryAttrs = [0x16, 0x1B, 0x1C, 0x1D, 0x68, 0x6A, 0x6B, 0x6C];
+                    } else {
+                        // 普通温控器
+                        queryAttrs = [0x02, 0x16, 0x1B, 0x1C, 0x1D];
+                    }
+                }
+                
+                for (const attr of queryAttrs) {
+                    const frame = this.protocolHandler.buildDeviceStatusQueryFrame(device.networkAddress, attr);
+                    await this.client.sendFrame(frame, 2);
+                    await this.sleep(150); // 增加延迟确保设备有时间响应
+                }
+                
+                // 等待设备响应，检查是否被标记为三合一
+                if (device.needsThreeInOneCheck) {
+                    await this.sleep(800); // 增加到800ms确保响应到达
+                    if (device.isThreeInOne) {
+                        this.log(`设备${device.name}确认为三合一面板，继续查询完整状态`);
+                        device.needsThreeInOneCheck = false;
+                        this.deviceManager.saveDevices();
+                        
+                        // 查询三合一的其他状态
+                        const threeInOneAttrs = [0x02, 0x16, 0x1B, 0x1C, 0x1D, 0x6A, 0x6B, 0x6C];
+                        for (const attr of threeInOneAttrs) {
+                            const frame = this.protocolHandler.buildDeviceStatusQueryFrame(device.networkAddress, attr);
+                            await this.client.sendFrame(frame, 2);
+                            await this.sleep(150);
+                        }
+                    } else {
+                        this.log(`设备${device.name}确认为普通温控器`);
+                        device.needsThreeInOneCheck = false;
+                        device.thermostatConfirmed = true; // 标记为已确认的温控器
+                        this.deviceManager.saveDevices();
+                        
+                        // 查询温控器状态
+                        const tempCtrlAttrs = [0x02, 0x16, 0x1B, 0x1C, 0x1D];
+                        for (const attr of tempCtrlAttrs) {
+                            const frame = this.protocolHandler.buildDeviceStatusQueryFrame(device.networkAddress, attr);
+                            await this.client.sendFrame(frame, 2);
+                            await this.sleep(150);
+                        }
+                    }
+                }
+            } catch(e) {
+                this.error(`查询设备${device.name}失败: ${e.message}`);
+            }
+        }
+        
+        this.log('设备状态查询完成');
+        
+        // 启用所有设备的状态上报功能
+        this.log('启用设备状态上报功能...');
+        for (const device of devices) {
+            try {
+                // 启用状态上报：msg_type=0x10, param=0x01
+                const frame = this.protocolHandler.buildDeviceControlFrame(device.networkAddress, 0x10, Buffer.from([0x01]));
+                await this.client.sendFrame(frame, 2);
+                await this.sleep(50);
+                this.log(`已启用设备${device.name}的状态上报`);
+            } catch(e) {
+                this.error(`启用设备${device.name}状态上报失败: ${e.message}`);
+            }
+        }
+        this.log('状态上报功能启用完成');
+    };
+    
+    SymiGatewayNode.prototype.sleep = function(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    };
+
+    SymiGatewayNode.prototype.discoverDevices = async function() {
+        if (!this.connected) {
+            this.error('Not connected');
+            return false;
+        }
+        
+        try {
+            this.log('Discovering devices (53 12 00 41)...');
+            const frame = this.protocolHandler.buildReadDeviceListFrame();
+            await this.client.sendFrame(frame, 0);
+            return true;
+        } catch (error) {
+            this.error(`Discovery failed: ${error.message}`);
+            return false;
+        }
+    };
+
+    SymiGatewayNode.prototype.sendControl = async function(networkAddr, attrType, param) {
+        if (!this.connected) {
+            throw new Error('Not connected');
+        }
+        
+        // 对于开关控制，如果参数格式是[channels, targetChannel, targetState]，需要先查询当前状态
+        if (attrType === 0x02 && param.length === 3) {
+            const channels = param[0];
+            const targetChannel = param[1];
+            const targetState = param[2] === 1;
+            
+            // 单路开关直接控制，无需查询
+            if (channels === 1) {
+                const directParam = Buffer.from([targetState ? 0x02 : 0x01]);
+                const frame = this.protocolHandler.buildDeviceControlFrame(networkAddr, attrType, directParam);
+                return await this.client.sendFrame(frame, 1);
+            }
+            
+            // 多路开关需要使用当前缓存状态
+            try {
+                // 从设备管理器获取当前状态
+                const device = this.deviceManager.getDeviceByAddress(networkAddr);
+                let currentState = null;
+                
+                if (device && typeof device.getCurrentSwitchState === 'function') {
+                    currentState = device.getCurrentSwitchState();
+                    this.log(`使用缓存状态: 0x${currentState.toString(16).toUpperCase()}`);
+                } else if (device && device.state.switchState !== undefined) {
+                    currentState = device.state.switchState;
+                    this.log(`使用保存状态: 0x${currentState.toString(16).toUpperCase()}`);
+                } else {
+                    // 如果没有当前状态，查询一次
+                    this.log(`查询开关状态: 地址0x${networkAddr.toString(16).toUpperCase()}`);
+                    const queryFrame = this.protocolHandler.buildDeviceStatusQueryFrame(networkAddr, 0x02);
+                    await this.client.sendFrame(queryFrame, 2);
+                    await this.sleep(200);
+                    
+                    if (device && typeof device.getCurrentSwitchState === 'function') {
+                        currentState = device.getCurrentSwitchState();
+                    } else {
+                        // 使用默认全关状态
+                        const defaultStates = { 2: 0x05, 3: 0x15, 4: 0x55, 6: 0x5555 };
+                        currentState = defaultStates[channels] || 0x55;
+                        this.log(`使用默认状态: 0x${currentState.toString(16).toUpperCase()}`);
+                    }
+                }
+                
+                // 使用状态组合算法
+                const stateValue = this.protocolHandler.buildSwitchState(channels, targetChannel, targetState, currentState);
+                
+                let controlParam;
+                if (Buffer.isBuffer(stateValue)) {
+                    // 6路开关，2字节状态
+                    controlParam = stateValue;
+                } else {
+                    // 1-4路开关，1字节状态
+                    controlParam = Buffer.from([stateValue]);
+                }
+                
+                this.log(`发送开关控制: 地址0x${networkAddr.toString(16).toUpperCase()}, 第${targetChannel}路${targetState ? '开' : '关'}, 状态值0x${stateValue.toString(16).toUpperCase()}`);
+                const frame = this.protocolHandler.buildDeviceControlFrame(networkAddr, attrType, controlParam);
+                return await this.client.sendFrame(frame, 1);
+                
+            } catch (error) {
+                this.error(`开关控制失败: ${error.message}`);
+                throw error;
+            }
+        }
+        
+        // 其他控制直接发送
+        const frame = this.protocolHandler.buildDeviceControlFrame(networkAddr, attrType, param);
+        return await this.client.sendFrame(frame, 1);
+    };
+
+    SymiGatewayNode.prototype.sendScene = async function(sceneId) {
+        if (!this.connected) {
+            throw new Error('Not connected');
+        }
+        
+        const frame = this.protocolHandler.buildSceneControlFrame(sceneId);
+        return await this.client.sendFrame(frame, 1);
+    };
+
+    SymiGatewayNode.prototype.getDeviceList = function() {
+        return this.deviceManager.getDeviceList();
+    };
+
+    SymiGatewayNode.prototype.getDevice = function(mac) {
+        return this.deviceManager.getDeviceByMac(mac);
+    };
+    
+    SymiGatewayNode.prototype.updateThreeInOneMac = function(addr, realMac) {
+        const device = this.deviceManager.getDeviceByAddress(addr);
+        if (device && device.isThreeInOne && device.needsMacUpdate) {
+            this.log(`更新三合一面板MAC: 0x${addr.toString(16).toUpperCase()} -> ${realMac}`);
+            
+            // 删除旧MAC映射
+            const oldMac = device.macAddress;
+            this.deviceManager.devices.delete(oldMac);
+            
+            // 更新设备MAC
+            device.macAddress = realMac;
+            device.needsMacUpdate = false;
+            device.name = device.generateName();
+            
+            // 重新添加映射
+            this.deviceManager.devices.set(realMac, device);
+            this.deviceManager.macToAddress.set(realMac, addr);
+            this.deviceManager.saveDevices();
+            
+            // 触发重新发布MQTT Discovery
+            this.emit('device-updated', device, true);
+        }
+    };
+
+    RED.nodes.registerType('symi-gateway', SymiGatewayNode);
+    
+    if (RED.httpAdmin) {
+        RED.httpAdmin.get('/symi-gateway/devices/:id', function(req, res) {
+            const node = RED.nodes.getNode(req.params.id);
+            if (node && node.deviceManager) {
+                res.json(node.deviceManager.getDeviceList());
+            } else {
+                res.json([]);
+            }
+        });
+    }
+};
+
+

package/nodes/symi-mqtt.html

@@ -0,0 +1,94 @@
+<script type="text/javascript">
+    RED.nodes.registerType('symi-mqtt', {
+        category: 'Symi Mesh',
+        color: '#DB4437',
+        defaults: {
+            name: { value: '' },
+            gateway: { value: '', type: 'symi-gateway', required: true },
+            mqttBroker: { value: 'mqtt://localhost:1883' },
+            mqttUsername: { value: '' },
+            mqttPassword: { value: '' },
+            mqttPrefix: { value: 'homeassistant' }
+        },
+        inputs: 0,
+        outputs: 0,
+        icon: 'bridge-dash.png',
+        label: function() {
+            return this.name || 'MQTT桥接';
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="symi-mqtt">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> 名称</label>
+        <input type="text" id="node-input-name" placeholder="MQTT桥接">
+    </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-mqttBroker"><i class="fa fa-rss"></i> MQTT地址</label>
+        <input type="text" id="node-input-mqttBroker" placeholder="mqtt://localhost:1883">
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-mqttUsername"><i class="fa fa-user"></i> 用户名</label>
+        <input type="text" id="node-input-mqttUsername" placeholder="可选">
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-mqttPassword"><i class="fa fa-lock"></i> 密码</label>
+        <input type="password" id="node-input-mqttPassword" placeholder="可选">
+    </div>
+    
+    <div class="form-row">
+        <label for="node-input-mqttPrefix"><i class="fa fa-folder-open"></i> HA前缀</label>
+        <input type="text" id="node-input-mqttPrefix" placeholder="homeassistant">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="symi-mqtt">
+    <p>MQTT桥接节点，用于Home Assistant集成</p>
+    
+    <h3>功能</h3>
+    <ul>
+        <li>自动发布HA MQTT Discovery配置</li>
+        <li>双向状态同步（Symi ↔ MQTT）</li>
+        <li>支持所有设备类型</li>
+    </ul>
+    
+    <h3>配置说明</h3>
+    <dl>
+        <dt>MQTT地址</dt>
+        <dd>MQTT Broker地址，格式：mqtt://ip:port</dd>
+        
+        <dt>用户名/密码</dt>
+        <dd>MQTT认证信息（如果Broker需要）</dd>
+        
+        <dt>HA前缀</dt>
+        <dd>Home Assistant Discovery前缀，默认homeassistant</dd>
+    </dl>
+    
+    <h3>工作原理</h3>
+    <ol>
+        <li>连接MQTT Broker</li>
+        <li>等待网关发现设备完成</li>
+        <li>为每个设备发布HA Discovery配置</li>
+        <li>订阅命令topic，接收HA控制</li>
+        <li>监听设备状态，发布到MQTT</li>
+    </ol>
+    
+    <h3>Home Assistant配置</h3>
+    <p>在HA的configuration.yaml中启用MQTT Discovery：</p>
+    <pre>mqtt:
+  broker: localhost
+  discovery: true
+  discovery_prefix: homeassistant</pre>
+    
+    <p>重启HA后，Symi设备会自动出现在设备列表中</p>
+</script>
+