Apple Homekit - 内置组件

优质
小牛编辑
132浏览
2023-12-01

利用 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_panelSecuritySystem安防面板
binary_sensorSensor二元传感器,支持二氧化碳、门窗、烟雾、水浸、动作等
climateThermostat空调及恒温器
coverWindowCovering门帘
device_trackerSensor位置追踪,仅限二元判定,即是否在某地
fanFan风扇
lightLight灯,支持亮度、颜色、色温
lockDoorLock门锁
media_playerMediaPlayer媒体播放器
sensorTemperatureSensor温度计
sensorHumiditySensor湿度计
sensorAirQualitySensor空气质量数值
sensorCarbonDioxideSensor二氧化碳数值
sensorLightSensor光照度数值
automation/switch / remote / input_boolean / scriptswitch自动化、开关、遥控、脚本及开关选择器,均以开关形式呈现

使用排错

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