Home Assistant MySkoda 集成项目启动和配置教程

1. 项目目录结构及介绍

Home Assistant MySkoda 集成项目的目录结构如下：

homeassistant-myskoda/
├── .github/
├── .vscode/
├── config/
├── custom_components/
│   └── myskoda/
├── docs/
├── scripts/
├── .devcontainer.json
├── .gitattributes
├── .gitignore
├── .pre-commit-config.yaml
├── LICENSE
├── README.md
├── SECURITY.md
├── crowdin.yml
├── hacs.json
├── pyproject.toml
└── uv.lock

• .github/: 包含与 GitHub 仓库相关的配置文件。
• .vscode/: 包含 Visual Studio Code 的项目配置。
• config/: 存放配置文件。
• custom_components/myskoda/: 自定义组件的源代码所在目录。
• docs/: 存放项目文档。
• scripts/: 包含项目运行脚本。
• .devcontainer.json: 定义开发容器配置。
• .gitattributes: 配置 Git 属性。
• .gitignore: 定义 Git 忽略的文件。
• .pre-commit-config.yaml: 配置 pre-commit 钩子。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。
• SECURITY.md: 安全策略文件。
• crowdin.yml: 翻译配置文件。
• hacs.json: HACS（Home Assistant Community Store）集成配置。
• pyproject.toml: Python 项目配置文件。
• uv.lock: 可能是项目锁定文件。

2. 项目的启动文件介绍

项目的启动主要依赖于 Home Assistant 系统的集成。在 custom_components/myskoda/ 目录中，包含了实现集成的 Python 代码。以下是一些核心文件：

• init.py: 初始化自定义组件，定义组件的入口。
• myskoda.py: 实现与 MySkoda API 交互的核心逻辑。
• binary_sensor.py, sensor.py, switch.py, ...: 定义不同的实体类型，如二进制传感器、传感器、开关等。

在 Home Assistant 中，可以通过 HACS 或手动安装方式添加这个自定义组件。安装后，需要重启 Home Assistant 以加载新的组件。

3. 项目的配置文件介绍

配置文件主要用于设置集成所需的参数，如登录凭证、轮询间隔等。以下是一些重要的配置选项：

• login: MySkoda 账户的登录用户名。
• password: MySkoda 账户的登录密码。
• polling_interval: 轮询间隔，默认为30分钟，可以设置为1到1440分钟（1天）。
• S-PIN: 用于执行某些操作的 PIN 码。

配置文件通常位于 Home Assistant 的配置目录中，名为 configuration.yaml。以下是一个配置示例：

myskoda:
  login: your_username
  password: your_password
  polling_interval: 30
  S-PIN: your_S-PIN

确保在修改配置文件后重启 Home Assistant，使配置生效。

以上是 Home Assistant MySkoda 集成项目的启动和配置基础教程。按照这些步骤，您可以成功集成并开始使用 MySkoda 服务。