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_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
重试。