Zendure-HA 项目启动与配置教程

1. 项目目录结构及介绍

Zendure-HA 是一个开源项目，它可以将 Zendure 的电源站和能源存储设备与 Home Assistant 智能家居系统集成。以下是项目的目录结构及其简单介绍：

Zendure-HA/
├── .github/             # GitHub 仓库配置文件
├── .gitattributes       # Git 属性文件
├── .gitignore           # Git 忽略文件
├── custom_components/   # Home Assistant 定制组件目录
│   └── zendure_ha/      # Zendure 集成组件
├── devcontainer.json    # 开发容器配置文件
├── hacs.json            # HACS 配置文件
├── LICENSE              # MIT 许可证文件
├── README.md            # 项目说明文件
├── requirements.txt     # 项目依赖文件
├── scripts/             # 脚本目录
└── ...                  # 其他相关文件

• .github/：包含 GitHub 仓库的配置文件，如 Actions 工作流等。
• .gitattributes：定义 Git 的一些属性，如文件的编码格式。
• .gitignore：定义在版本控制中应该忽略的文件和目录。
• custom_components/：包含自定义的 Home Assistant 组件。
• devcontainer.json：用于配置开发容器，提供开发环境。
• hacs.json：用于 HACS (Home Assistant Community Store) 的配置。
• LICENSE：项目的 MIT 许可证。
• README.md：项目的说明文档，包含项目介绍、安装方法和使用说明。
• requirements.txt：项目的依赖文件，列出项目所需的库和版本。
• scripts/：包含项目的脚本文件。

2. 项目的启动文件介绍

项目的启动主要是通过 Home Assistant 的自定义组件来完成的。在 custom_components/zendure_ha/ 目录下，主要的启动文件是 __init__.py。

# __init__.py
from . import (
   ZendureDevice,
    ZendureManager,
)

# 向 Home Assistant 注册组件和设备
def setup(hass, config):
    # 初始化 ZendureManager
    zendure_manager = ZendureManager(hass)
    hass.data['zendure'] = zendure_manager

    # 其他设置...
    return True

这个文件负责初始化 ZendureManager，并将其存储在 Home Assistant 的数据字典中，以便在系统中其他地方使用。

3. 项目的配置文件介绍

项目的配置主要通过 Home Assistant 的配置文件 configuration.yaml 来完成。以下是一个基本的配置示例：

# configuration.yaml
homeassistant:
  # 其他配置...

# 向 Home Assistant 添加自定义组件
custom_components:
  zendure_ha:
    # Zendure 账户凭证
    username: your_zendure_username
    password: your_zendure_password
    # 其他配置...

在这个配置文件中，你需要提供你的 Zendure 账户的用户名和密码，这样 Home Assistant 就可以连接到 Zendure 云 API 并自动发现你的设备。

确保在配置后保存文件，并重新加载 Home Assistant 以使配置生效。