HomeAssistant 接入海尔智家设备的实操笔记
海尔这套集成更像是给 HomeAssistant 补了一块拼图。设备能不能都吃进来,取决于你家里接了哪些海尔智家产品,但就现有能力看,空调、热水器这类常见设备已经能走完整控制链路了。
这个集成能做什么
它把海尔智家平台下的设备接进 HomeAssistant,统一放到同一个界面里管理。常见的实体类型也都给到了:
Switch:开关控制Number:数值调节,比如温度、风速Select:模式切换Sensor:状态和数据展示Binary Sensor:状态检测Climate:空调控制Water Heater:热水器管理
如果你家里海尔设备比较杂,这种统一入口会省掉不少来回切换 App 的麻烦。
安装方式
手动安装
把项目里的 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
实际用下来,最有价值的还是 Climate 和 Water Heater 这两类,控制粒度够细,联动也方便。
高级一点的配置
custom_components/haier/core/config.py 里有设备筛选配置,可以只接入特定设备,也可以把不想看到的设备排掉。这个对设备多的人比较有用,不然集成页会显得乱。
custom_components/haier/config_flow.py 提供了实体过滤选项,作用很直接:只保留你真会用的控制项。界面不会被一堆不常碰的实体撑满。
事件处理放在 custom_components/haier/core/event.py 里,设备状态变化后能比较及时地响应联动。做自动化时,这部分比看上去更重要,很多'能不能稳定触发'都靠它兜底。
调试时可以先看日志
如果连接不上,先开调试日志,通常能很快定位是凭证问题、网络问题,还是设备本身没在线:
logger:

