概述

Home Assistant 当中各类智能家居设备以组件(Components)的形式接入,本文档整合了中国大陆地区常用的平台组件的接入及配置方法,并以符合中文逻辑的层级展现。

请至左侧栏或善用搜索寻找希望适配的设备。

设备分类

Home Assistant 以设备类型作为设备接入的参考及分类依据,目前支持以下类型:

  • Alarm - 警报
  • Automation - 自动化
  • Binary Sensor - 二进制传感器
  • Calendar - 日历
  • Camera - 摄像机
  • Climate - 气象
  • Cover - 屏障,如窗帘、车库门、卷帘门
  • DIY
  • Downloading - 下载工具
  • Energy - 能源
  • Fan - 风扇
  • Finance - 金融
  • Front End - 前端
  • Health - 健康
  • History - 历史记录
  • Hub - 中枢
  • Image Processing - 图像处理
  • Intent - 动机
  • Light - 灯具
  • Lock - 锁
  • Mailbox - 邮箱
  • Media Player - 媒体播放器
  • Notification - 通知推送
  • Organization - 组织
  • Presence Detection - 存在性监测
  • Remote - 遥控
  • Scene - 场景
  • Sensor - 传感器
  • Social - 社交媒体
  • Switch - 开关
  • System Monitor - 系统控制
  • Telegram chatbot
  • Text-to-speech - 文字转语音
  • Transport - 交通工具
  • Utility -
  • Vacuum - 吸尘器&扫地机
  • Voice - 语音
  • Weather - 天气
  • Other

接入原则

大部分的设备遵循 Home Assistant 的分类逻辑,配置时需要遵循分类原则,即

同类设备需包含在大类下,以枚举的方式加入平台。例如:

light:  #灯具
  - platform: yeelight  #yeelight 灯 
  •••
  - platform: xiaomi_miio #小米灯
  •••
  •••
media_player:       #媒体播放器
  - platform: kodi
  •••
  - platform: itunes
•••
•••

同时,同一大类在 configuration.yaml 中不可重复出现。如以下的错误示例

light:  #灯具
  - platform: yeelight  #yeelight 灯 
  •••
  •••
light:
  - platform: xiaomi_miio #小米灯

以上的配置是绝对错误的,出现了 2 次 light大类,将导致系统出错,设备接入失败。


特殊情况

部分设备的组件开发较早或者比较特殊,未纳入系统分类,可以独立配置。如 Hub 中枢内的大部分平台,都需要独立配置。例如:

xiaomi_aqara:
•••
alexa:
•••

本文档将帮助大家淡化 Home Assistant 杂乱无章的分类。

文档中所有『示例配置』都将包括所属大类,应用时请注意各设备间的内部整合。如果没有,则表明该设备独立成类。