内置组件

利用 homekit 原生组件,Home Assistant 可直接接入 Homekit,无需安装额外软件。


使用方法

  • 安装系统依赖:sudo apt-get install libavahi-compat-libdnssd-dev

  • configuration.yaml 文件中添加相关配置,所有子项皆为可选配置

完整配置:

homekit:
  auto_start: true  #启动 HA 后自动启动 homekit 服务,默认开启
  port: 51827  #运行端口,默认51827
  filter:  #设备过滤
    include_domains:  #指定包含设备类型
    include_entities:  #指定包含设备
    exclude_domains:  #指定排除设备类型
    exclude_entities:  #指定排除设备
  entity_config:  #特殊设备设置
    alarm_control_panel:  #警报面板
      code:  #密码,这个密码不!是!PIN!码!

最简配置:

homekit:
  • 配置成功后,系统将自动生成 pin 码显示在前端页面上;如果没有出现,则表示配置错误,请检查配置;
  • 打开 iOS 客户端『家庭』App —— 添加配件——没有代码或无法扫描?—— 手动代码 —— 输入 pin 码 —— HA 设备自动匹配添加完成

支持设备

homekit 组件已基本支持全部类型设备,以下是支持设备列表:

设备类型 Homekit名称 说明
alarm_control_panel SecuritySystem 安防面板
binary_sensor Sensor 二元传感器,支持二氧化碳、门窗、烟雾、水浸、动作等
climate Thermostat 空调及恒温器
cover WindowCovering 门帘
device_tracker Sensor 位置追踪,仅限二元判定,即是否在某地
fan Fan 风扇
light Light 灯,支持亮度、颜色、色温
lock DoorLock 门锁
media_player MediaPlayer 媒体播放器
sensor TemperatureSensor 温度计
sensor HumiditySensor 湿度计
sensor AirQualitySensor 空气质量数值
sensor CarbonDioxideSensor 二氧化碳数值
sensor LightSensor 光照度数值
automation/switch / remote / input_boolean / script switch 自动化、开关、遥控、脚本及开关选择器,均以开关形式呈现

使用排错

初次启用内置 homekit 组件后,HA 主页会出现 PIN 码,若没有出现,请删除配置文件夹下 .homekit.state 重试。