Home Assistant Goodwe 逆变器集成项目教程

1. 项目的目录结构及介绍

home-assistant-goodwe-inverter/
├── custom_components/
│   └── goodwe/
│       ├── __init__.py
│       ├── manifest.json
│       ├── sensor.py
│       └── services.yaml
├── github/
│   └── workflows/
├── .gitignore
├── LICENSE
├── README.md
├── hacs.json
├── info.md
├── inverter_scan.py
└── inverter_test.py

目录结构说明

• custom_components/goodwe/: 包含Home Assistant自定义组件的核心代码。
  • __init__.py: 组件的初始化文件。
  • manifest.json: 组件的元数据文件。
  • sensor.py: 传感器相关的代码。
  • services.yaml: 服务配置文件。
• github/workflows/: GitHub Actions的工作流配置文件。
• .gitignore: Git忽略文件配置。
• LICENSE: 项目许可证。
• README.md: 项目说明文档。
• hacs.json: HACS（Home Assistant Community Store）配置文件。
• info.md: 项目额外信息文档。
• inverter_scan.py: 逆变器扫描脚本。
• inverter_test.py: 逆变器测试脚本。

2. 项目的启动文件介绍

inverter_test.py

该脚本用于测试逆变器是否正确响应UDP请求。在Python 3.8+环境中执行该脚本即可进行测试。

inverter_scan.py

该脚本用于在本地网络中发现逆变器。执行该脚本可以扫描并发现网络中的逆变器。

3. 项目的配置文件介绍

manifest.json

该文件包含组件的元数据，如名称、版本、依赖等。

{
  "domain": "goodwe",
  "name": "Goodwe",
  "version": "1.0",
  "documentation": "https://github.com/mletenay/home-assistant-goodwe-inverter",
  "dependencies": [],
  "codeowners": ["@mletenay"],
  "requirements": ["goodwe==0.1.0"]
}

services.yaml

该文件定义了组件提供的服务。

services:
  goodwe:
    update_data:
      description: "Update data from Goodwe inverter"
      fields:
        force:
          description: "Force update"
          example: true

以上是Home Assistant Goodwe 逆变器集成项目的详细教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助！