海尔智能家居集成完整使用指南
海尔智能家居集成是专为 HomeAssistant 用户设计的强大插件,能够将您的海尔智家设备无缝接入智能家居系统。无论您拥有空调、热水器还是其他海尔智能产品,这个集成都能提供完整的控制和管理功能。
项目核心亮点
全设备兼容性 - 理论上支持所有海尔智家平台下的智能设备,实现统一管理和控制。
简单配置流程 - 通过直观的配置向导,无需编写复杂代码即可完成设备连接。
多类型实体支持 - 提供开关、传感器、数值调节、模式选择等多种实体类型,满足不同设备的控制需求。
快速安装步骤
方法一:手动安装
将项目中的 custom_components/haier 文件夹复制到您的 HomeAssistant 根目录下的 custom_components 文件夹中即可完成安装。
方法二:HACS 安装
如果您已安装 HACS,可以通过 HACS 界面搜索并安装海尔 Haier 集成。
详细配置流程
- 进入集成界面 - 打开 HomeAssistant,导航至'配置 > 设备与服务 > 集成'
- 添加新集成 - 点击'添加集成'按钮,在搜索框中输入'haier'
- 完成认证 - 根据提示输入您的 Client ID 和 Refresh Token 信息
- 设备发现 - 系统将自动扫描并发现您账户下的所有海尔智能设备
支持设备类型详解
开关控制 - 通过 Switch 实体控制设备的开关状态,实现远程电源管理。
数值调节 - 使用 Number 实体精确调整设备参数,如温度、风速等设置。
模式选择 - Select 实体提供快速切换设备工作模式的功能。
状态监测 - Sensor 实体实时显示设备的运行数据和状态信息。
状态检测 - Binary Sensor 实体监控设备的状态变化,及时反馈异常情况。
空调控制 - Climate 实体提供完整的空调控制功能,包括温度、模式、风速等调节。
热水器管理 - Water Heater 实体专门用于热水器的智能控制和管理。
高级功能配置
设备筛选机制
通过 custom_components/haier/core/config.py 文件中的设备筛选配置,您可以选择性地接入特定设备,或者排除不需要的设备类型。
实体过滤设置
在 custom_components/haier/config_flow.py 中提供了灵活的实体过滤选项,让您只显示需要的控制项,保持界面简洁。
事件处理系统
集成内置了强大的事件处理机制,通过 custom_components/haier/core/event.py 实现设备状态变化的实时响应和智能联动。
实用技巧分享
定期更新 - 集成会持续优化和更新,建议定期检查新版本以获得更好的使用体验。
配置备份 - 在进行重要配置更改前,建议备份当前的集成设置,防止意外数据丢失。
日志调试 - 如果遇到连接问题,可以在 HomeAssistant 配置文件中启用调试日志来排查问题:
logger:
default:

