Homebridge-homeassistant 插件

本插件可以帮助你对接 Home Assistant 与 Apple Homekit,从而实现使用 Siri 控制设备。

使用前请保证 Homebridge 的正确安装与运行,相关安装与配置说明详见『智能家居百科』。

使用方法

安装

确保 Homebridge 已正确安装及运行后,安装此插件:

sudo npm install -g homebridge-homeassistant

配置

修改 Homebridge 的配置文件 config.json,添加如下内容并保存:

"platforms": [
  {
    "platform": "HomeAssistant",
    "name": "HomeAssistant",
    "host": "http://127.0.0.1:8123",
    "password": "yourapipassword",
    "supported_types": ["automation", "binary_sensor", "climate", "cover", "device_tracker", "fan", "group", "input_boolean", "light", "lock", "media_player", "remote", "scene", "script", "sensor", "switch", "vacuum"],
    "default_visibility": "visible",
    "logging": true,
    "verify_ssl": true
  }
]

变量说明:

  • host: Home Assistant 的完整访问地址
  • password: Home Assistant 的密码
  • supported_types: 支持设备类型,默认请勿修改
  • default_visibility: 默认可视状态,建议设为 visible,否则在 HA 中新添加的设备将不在 HB 中显示
  • logging: 日志记录,默认 true
  • verify_ssl:默认 true,使用自签名 SSL 证书的用户请改为 false

更新

sudo npm upgrade -g homebridge-homeassistant

设备支持列表

中文名 HA中组件类型 支持功能
自动化 Automation 开、关
警报面板 Alarm Control Panel 警戒、解除警戒
二元传感器 Binary Sensor 门窗、天然气、烟雾、水浸等
空调与恒温器 Climate 当前温度、目标温度、模式
门帘 Cover 开、合
设备追踪 Device Tracker 地理位置,以传感器的形式显示
风扇 Fan 开、关、转速
群组 Group 开、关
二元控制器 Input boolean 开、关
Light 开、关、亮度、颜色、色温
Lock 开、关
媒体播放器 Media  Player 以『开关』的形式显示
遥控 Remote 以『开关』的形式显示
场景 Scene 以『开关』的形式显示
脚本 Script 以『开关』的形式显示
数值传感器 Sensor 空气质量、一氧化碳浓度、温湿度及光照度
开关 Switch 开、关
吸尘器 Vacuum 开、关

Home Assistant 相关设置

在 Home Assistant 的自定义(customize)模块中可对接入设备进行 Homebridge 的相关设置

全局配置

  • 在 Homebridge 中显示设备,使用示例配置时,默认设备均显示在 Homebridge 中,无需额外配置:
customize:
  switch.example:
    homebridge_visible: true
  • 在 Homebridge 中隐藏设备:
customize:
  switch.example:
    homebridge_hidden: true
  • 设备初次接入的相关信息:
customize:
  switch.a_switch:
    homebridge_name: 家庭 App 中显示名称 
    homebridge_mfg: Leviton     //设备制造商
    homebridge_model: DZMX1-1LZ    //设备型号
    homebridge_serial: 123456789    //设备序列号

注意

该设置仅限 初次接入 Homebridge 的设备有效。设备接入 HB 之后,必须手动在家庭 App 中设定相关信息或清除设备缓存。


各类特殊配置

警报面板

如果你的警报面板在 HA 中设为使用密码,则必须在 HA 的 customize 设置中声明该密码:

customize:
  alarm_control_panel.example:
    homebridge_alarm_code: 123456

二元传感器

由于二元传感器涵盖的子设备类型众多,因此必须在 HA 的customize 模块中声明传感器的类别以正确显示,具体支持的类型有: gas 气体, moisture 湿度(水浸), motion(动作), occupancy(占用情况), opening (开关)以及 smoke(烟雾)。具体声明方法为:

customize:
  binary_sensor.example:
    device_class: motion

其中 gas 可增加配置 co (一氧化碳)与co2 (二氧化碳),opening 可增加配置为 window (窗户)与 door (门),具体配置方法为:

customize:
  binary_sensor.example:
    device_class: gas
    homebridge_gas_type: co
customize:
  binary_sensor.example:
    device_class: opening
    homebridge_opening_type: window

数值传感器

目前本插件仅支持空气质量、二氧化碳、湿度、温度以及光线传感器。

  • 空气质量传感器如单位被设定为 aqi 则会被自动识别,否则请手动设定:
customize:
  sensor.air:
    homebridge_sensor_type: air_quality
  • 光线传感器如单位被设定为 lux 则会被自动识别,否则请手动设定:
customize:
  sensor.air:
    homebridge_sensor_type: light
  • 温度传感器如单位被设定为 °C, ℃, °F, ℉ 则会被自动识别。
  • 湿度传感器如单位被设定为 % 则会被自动识别,否则请手动设定:
customize:
  sensor.air:
    homebridge_sensor_type: humidity
  • 二氧化碳传感器如单位被设定为 ppm 或设备 ID 含有 co2则会被自动识别,否则请手动设定:
customize:
  sensor.air:
    homebridge_sensor_type: co2

门帘控制

可以在 customize 模块声明门帘的类型,有 rollershutter 与 garage_door,具体配置为:

customize:
  cover.lounge_main:
    homebridge_cover_type: rollershutter
  cover.garage:
    homebridge_cover_type: garage_door

插件默认接入 Homebridge 的灯色温为 50 - 400,可在 customize 模块内设定此值:

customize:
  light.xxxxx:
    homebridge_min_mireds: 30
    homebridge_max_mireds: 500

如果你的锁在 HA 中设为使用密码,则必须在 HA 的customize 模块中声明该密码:

customize:
   lock.example:
    homebridge_lock_code: 123456

开关

Homekit 默认将开关识别为『开关』类型,如果想识别为『插座』,可在 customize 模块中声明:

customize:
  lock.example:
    homebridge_switch_type: outlet

媒体播放器

Homebridge 将根据具体设备识别『开关』所映射的播放器控制操作,默认为『开、关』;在支持『播放、暂停』的设备中则映射为『播放、暂停』,你也可以手动设定此映射:

 customize:
   media_player.example:
    homebridge_media_player_switch: play_pause 或 on_off 或 play_stop