海尔智能家居接入 HomeAssistant 完整配置指南
准备工作与环境检查
在开始安装前,请确保你的智能家居系统满足以下基本条件:
系统兼容性清单:
- HomeAssistant 版本 2023.1.0 或更高
- 海尔智家 APP 中设备运行正常
- 稳定的网络连接环境
- 有效的海尔智家账号
验证操作步骤:
- 登录 HomeAssistant 后台确认系统版本
- 在海尔智家 APP 中检查设备在线状态
- 确保网络连接质量可靠
三种安装方法对比选择
HACS 可视化安装(新手首选)
如果你已经安装了 HACS 组件,这是最快捷的安装方式:
- 打开 HACS 管理面板
- 进入"集成"功能选项卡
- 搜索"Haier"关键词
- 点击安装按钮并重启服务
手动文件部署(技术用户适用)
对于熟悉命令行操作的用户,推荐使用传统部署方式:
git clone <project_repo_url>
cp -r haier/custom_components/haier /config/custom_components/
压缩包安装(无 Git 环境)
直接下载项目压缩包,解压后将 custom_components/haier 文件夹完整复制到 HomeAssistant 的 custom_components 目录中。
账号配置与设备连接
第一步:添加集成服务
进入 HomeAssistant 配置界面,选择"设备与服务",点击"添加集成"按钮,搜索"haier"并选择相应选项。
第二步:账号认证流程
输入你的海尔智家账号和密码,系统会自动完成认证授权过程,确保设备访问权限正常。
第三步:设备发现验证
耐心等待设备自动扫描和发现,确认列表中显示所有预期设备,检查设备状态是否正常同步。
核心功能模块深度解析
设备通信核心
custom_components/haier/core/client.py- 负责与海尔云平台的实时数据交换custom_components/haier/core/device.py- 设备信息管理和状态同步机制
实体控制实现
custom_components/haier/climate.py- 空调温度、模式、风速全方位控制custom_components/haier/water_heater.py- 热水器温度设定和加热模式管理custom_components/haier/switch.py- 智能开关状态控制和监测custom_components/haier/sensor.py- 各类传感器数据实时采集
用户交互设计
custom_components/haier/config_flow.py- 引导式配置流程custom_components/haier/entity.py- 统一实体基础框架

