Home Connect Alt 集成教程
1. 项目介绍
Home Connect Alt 是一个为 Home Assistant 设计的替代集成,专门用于支持由 BSH 制造的 Home Connect 启用家电,包括 Bosch、Siemens、Constructa 和 Neff 品牌。该项目通过官方的 Home Connect API 探索每个设备的可用选项,并自动将其作为适当的 Home Assistant 实体暴露出来。
2. 项目快速启动
安装步骤
使用 HACS 安装
- 打开 Home Assistant 的 HACS 页面。
- 点击“集成”部分。
- 搜索“Home Connect Alt”并点击安装。
- 按照提示完成安装。
手动安装
- 克隆项目仓库到本地:
git clone https://github.com/ekutner/home-connect-hass.git
- 将
custom_components/home_connect_alt
目录复制到 Home Assistant 的custom_components
目录下。 - 在 Home Assistant 的
configuration.yaml
文件中添加以下配置:home_connect_alt: client_id: YOUR_CLIENT_ID client_secret: YOUR_CLIENT_SECRET
- 重启 Home Assistant。
配置步骤
- 打开 Home Assistant 的“设置” -> “设备与服务”页面。
- 点击右上角的三个点菜单,选择“应用程序凭证”。
- 添加新的凭证,输入你在 Home Connect 开发者平台上创建的应用程序的
client_id
和client_secret
。 - 返回“设备与服务”页面,点击“添加集成”。
- 搜索“Home Connect Alt”并选择它。
- 选择你的 Home Connect 服务器(中国或默认)。
- 完成登录流程。
3. 应用案例和最佳实践
案例1:多设备管理
如果你有多个 Home Connect 设备,可以通过创建多个集成实例来管理它们。每个实例可以负责一部分设备,从而避免 API 速率限制问题。
案例2:自动化场景
利用 Home Connect Alt 提供的传感器和开关,可以轻松创建自动化场景。例如,当烤箱完成烹饪时,自动发送通知。
4. 典型生态项目
Home Assistant
Home Assistant 是一个开源的家庭自动化平台,支持多种设备和协议。Home Connect Alt 是其生态系统中的一个重要组成部分,提供了对 Home Connect 设备的全面支持。
HACS
HACS(Home Assistant Community Store)是一个社区驱动的集成和插件管理工具,用户可以通过 HACS 轻松安装和管理 Home Connect Alt 等第三方集成。
Home Connect API
Home Connect API 是 BSH 提供的官方 API,允许开发者访问和控制 Home Connect 设备。Home Connect Alt 通过该 API 实现了与 Home Assistant 的无缝集成。
通过以上步骤,你可以轻松地将 Home Connect Alt 集成到你的 Home Assistant 系统中,并开始管理你的 Home Connect 设备。