Zendure-HA项目对Solarflow系列设备的支持现状与技术解析

Zendure-HA项目对Solarflow系列设备的支持现状与技术解析

Zendure-HA Zendure Home Assistant Integration 项目地址: https://gitcode.com/gh_mirrors/ze/Zendure-HA

项目背景

Zendure-HA作为Home Assistant平台上的一个集成组件，旨在实现对Zendure太阳能储能系统的智能化控制。近期社区用户对Solarflow 2000和1200型号的支持需求日益增长，开发者团队对此进行了积极回应和技术适配。

设备支持现状

目前Zendure-HA项目已实现对Solarflow 800型号的完整支持。针对Hub 2000和Hub 1200设备，开发团队确认这些设备在技术实现上与现有支持设备相似，理论上可以实现兼容支持。

在最新发布的1.0.41预发布版本中，开发团队已初步加入了对Hub 1200和Hub 2000的支持。但根据用户反馈，目前仍存在以下技术问题：

1. Hub 1200的AC模式切换功能未正确响应控制指令
2. 功率限制参数设置可能存在偏差
3. 设备控制逻辑与官方APP存在差异

技术实现细节

设备控制模块差异

通过对比代码实现发现，不同型号的设备控制文件存在显著差异：

• Solarflow800.py实现了AC模式选择器(acMode)，支持输入/输出模式切换
• Hub1200.py则实现了不同的模式选择器(passMode)，提供自动/关闭/开启三种状态
• 功率限制参数设置也存在型号差异，Hub1200的输入/输出限制值与其他型号不同

服务器接入机制

项目采用智能服务器选择机制：

1. 优先尝试连接全球服务器(v2)
2. 若账户存在于欧盟服务器(eu)，则自动切换
3. 无需用户手动指定服务器区域

这种设计简化了用户配置流程，同时确保连接的正确性。

控制功能对比分析

Zendure官方APP提供四种控制模式，与HA集成的对应关系如下：

1. 电池优先模式：充电时段限制输出100W（目前HA集成中未明确实现）
2. 定时模式：自定义时段输出限制（可通过HA自动化实现）
3. 智能匹配模式：基于连接设备总和的动态输出（需配合P1电表传感器）
4. 智能CT模式：基于总用电监测的动态调节（需配合Shelly Pro 3EM等设备）

当前集成主要针对第3和第4种模式提供支持，通过sensor.power_actual获取实时功率数据实现动态调节。

已知问题与解决方案

1. 控制指令无响应：主要影响Hub1200/2000型号，需等待设备实测验证
2. 参数设置回滚：手动设置后自动恢复默认值，需检查API通信协议
3. 模式切换异常：因设备文件选择器实现不一致导致，已在代码中统一处理

未来优化方向

开发团队计划从以下方面进行改进：

1. 获取实际设备进行完整功能测试
2. 统一各型号设备的控制接口
3. 完善与官方APP控制模式的对等实现
4. 优化功率参数的自适应设置

对于希望深度定制的用户，建议通过Node-RED直接调用集成提供的实体和服务接口，绕过标准控制流程实现个性化场景。

Zendure-HA Zendure Home Assistant Integration 项目地址: https://gitcode.com/gh_mirrors/ze/Zendure-HA