Zendure Home Assistant 集成最佳实践指南

1. 项目介绍

Zendure Home Assistant Integration 是一个开源项目，旨在将 Zendure 的电源站和能量存储设备与 Home Assistant 智能家居系统相连接。通过该集成，用户可以直接在 Home Assistant 中监控和控制 Zendure 设备，包括电池电量、功率输入/输出、充电设置等，从而实现家庭自动化和能源管理。

2. 项目快速启动

环境准备

• Home Assistant 安装环境
• HACS (Home Assistant Community Store) 安装与配置

安装步骤

1. 克隆或下载项目代码：

git clone https://github.com/FireSon/Zendure-HA.git

2. 将项目添加到 HACS：

   • 打开 Home Assistant 的 HACS 插件。
   • 选择“存储库”选项卡。
   • 点击“添加存储库”并输入以下信息：
     • 名称：Zendure Home Assistant Integration
     • URL：<项目文件路径> （从克隆的文件夹中选择）
   • 确认并添加存储库。

3. 安装集成：

   • 在 HACS 中找到“zendure_ha”集成。
   • 点击“安装”按钮。

4. 配置集成：

   • 在 Home Assistant 设置中找到“集成”部分。
   • 选择“配置”并找到“zendure_ha”。
   • 输入 Zendure 账户凭证。
   • 确认配置并保存。

3. 应用案例和最佳实践

配置智能匹配传感器

为了使智能匹配功能正常工作，需要配置一个功率传感器，该传感器：

• 报告的单位为瓦特（W）。
• 当有剩余能量（例如来自太阳能发电）时报告负值。
• 当家庭从电网中抽取功率时报告正值。

如果现有的功率表传感器不符合这些要求，可以创建一个模板传感器来适当地转换值。

示例：转换 DSMR 集成值

如果使用 DSMR 集成，该集成报告的值为千瓦时（kWh），分为“送出”和“返回”传感器，可以使用以下模板来组合和转换它们：

{{ (states("sensor.dsmr_reading_electricity_currently_delivered") | float - states("sensor.dsmr_reading_electricity_currently_returned") | float) * 1000 }}

设置模板传感器

1. 进入 Home Assistant 设置的“设备和服务”部分。
2. 点击“添加助手”并选择“模板”。
3. 选择“传感器”作为模板类型。
4. 输入上述模板代码。
5. 配置名称、图标和单位（W）。
6. 保存助手。

4. 典型生态项目

在 Home Assistant 生态中，Zendure Home Assistant Integration 可以与以下项目配合使用，以实现更完整的智能家居解决方案：

• Home Assistant: 核心智能家居平台。
• HACS: 管理社区插件的工具。
• DSMR: 电力表集成，用于监控家庭电力使用情况。
• MQTT: 消息队列遥测传输，用于设备间通信。

通过以上最佳实践，您可以有效地将 Zendure 设备集成到 Home Assistant 中，并实现智能能源管理。