HomeAssistant SmartRent 组件使用教程

1. 项目目录结构及介绍

HomeAssistant SmartRent 组件的目录结构如下所示：

config/
├── ...
├── configuration.yaml
├── secrets.yaml
├── custom_components/
│   └── smartrent/
│       ├── climate.py
│       ├── lock.py
│       ├── manifest.json
│       ├── ...

• config/：这是 HomeAssistant 的配置目录，包含 HomeAssistant 的配置文件以及自定义组件的目录。
• custom_components/smartrent/：这是 SmartRent 组件的目录，包含了所有与 SmartRent 相关的文件。
  • climate.py：用于处理和 SmartRent 系统相关的温度控制（Thermostats）功能。
  • lock.py：用于处理和 SmartRent 系统相关的门锁（Locks）功能。
  • manifest.json：这是一个必须的文件，用于定义组件的元数据，如名称、版本和支持的域。

2. 项目的启动文件介绍

SmartRent 组件的启动主要是通过在 HomeAssistant 中添加集成来完成。以下是启动组件的基本步骤：

1. 将组件文件放入 custom_components/smartrent/ 目录。
2. 重启 HomeAssistant 实例。
3. 在 HomeAssistant 的配置界面中，导航到“配置 > 设备与服务 > 添加集成”。
4. 搜索 SmartRent 并按照提示操作。

组件启动后，将在 HomeAssistant 中注册 SmartRent 相关的设备和服务。

3. 项目的配置文件介绍

SmartRent 组件的配置主要通过两个文件来进行：

• configuration.yaml：这是 HomeAssistant 的主配置文件，可以在其中添加 SmartRent 组件的配置信息。例如：

smartrent:
  email: '[e-mail]'
  password: 'your_password'

在这里，你需要替换 [e-mail] 和 your_password 为你的 SmartRent 账户的邮箱和密码。

• manifest.json：组件的配置文件，它定义了组件的元数据和 HomeAssistant 如何集成该组件。一个简单的 manifest.json 文件可能如下所示：

{
  "domain": "smartrent",
  "name": "SmartRent",
  "version": "0.5.2",
  "dependencies": [],
  "configuration": {
    "config_flow": true
  }
}

在这里，domain 是组件的域名，name 是组件的名称，version 是组件的版本号。dependencies 可以列出组件依赖的其他组件。configuration 部分表明组件支持配置流程。