设备及服务 - 概述

优质

小牛编辑

135浏览

2023-12-01

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

注意：配置文件修改保存后，请至 配置 —— 通用 —— 配置检查 检查文件格式的正确性！！

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

设备分类

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 杂乱无章的分类。