Zigbee

以米家多功能网关为中枢的 Zigbee 设备使用 xiaomi_aqara 组件接入网关。网关接入后,所有配对子设备皆会自动识别添加。 支持的设备包括:

  • 绿米(Aqara) 空调伴侣增强版,米家及前代空调伴侣暂不支持(需 0.69.0 及以上版本 HA)
  • 2017年下半年后出厂的新版墙壁开关、墙贴开关及 86 插座(需 0.65.0 及以上版本 HA)
  • 温度湿度传感器(新旧版)
  • 人体运动传感器 (新旧版)
  • 门窗传感器 (新旧版)
  • 无线开关 (新旧版)
  • 智能插座 Zigbee 版本 (反馈耗电、电力负载、通电、开关状态)
  • 墙壁开关 (反馈耗电、电力负载、 通电状态)
  • 绿米(Aqara)全系列墙壁开关,包括单、双键;单、零火
  • 绿米 (Aqara)无线开关单、双键
  • 魔方控制器
  • 天然气泄漏传感器 (反馈警报和浓度信息)
  • 烟雾报警器 (反馈警报和浓度信息)
  • 多功能网关 (支持网关灯、亮度传感器及铃声播放)
  • 绿米智能窗帘器
  • 浸水传感器
  • 各设备电量

不支持:

  • 网关广播
  • 网关按钮
  • 墙壁开关独立使用状态
  • 烟雾及天然气报警器的其他警报事件,包括:模拟警报、电池错误警报、灵敏度警报及 I2C 通信失败警报。

接入前,请先打开设备局域网通讯协议并获取密码:

多功能网关:请在米家 app 中与网关配对,之后进入详细页,点选右上角“……” —— 关于

  • iOS 客户端:空白处点多下 —— 局域网通信协议 —— 打开并获取密码;
  • 安卓客户端:下方插件版本号多次点击 —— 局域网通信协议 —— 打开并获取密码;

空调伴侣:请在米家 app 中与网关配对,之后进入详细页,点选右上角“……”

  • iOS 客户端:关于 —— 空白处点多下 —— 局域网通信协议 —— 打开并获取密码;
  • 安卓客户端:使用帮助 —— 关于 —— 下方插件版本号多次点击 —— 局域网通信协议 —— 打开并获取密码;

iOS 客户端获取的密码为大写,安卓客户端获取的密码为小写,配置时请保留大小写,原样照搬。


示例配置

单个网关

# 使用单网关前提下,可不填 mac, mac 不带冒号
xiaomi_aqara:
  gateways:
    - mac:
      key: xxxxxxxxxxxxxxxx

多个网关

# 多个网关必须填入 mac,mac 不带冒号
xiaomi_aqara:
  gateways:
    - mac: xxxxxxxxxxxx
      key: xxxxxxxxxxxxxxxx
    - mac: xxxxxxxxxxxx
      key: xxxxxxxxxxxxxxxx

搜寻固定 IP 的网关

提高响应速度,但不适用于多网关。

xiaomi_aqara:
  interface: '192.168.0.1'
  gateways:
    - mac: xxxxxxxxxxxx
      key: xxxxxxxxxxxxxxxx

变量说明:

  • mac (可选): 网关 mac 地址,使用多个网关则必须填写,不带冒号
  • key (可选): 网关通信协议密码。如果想要控制网关灯和开关,则必须填写;传感器在无密码情况下仍可正常运作。
  • discovery_retry (可选): 连接失败重试次数,默认为 3。
  • interface (可选): 所使用的接口,默认为全部(all)。

专有指令

HA 支持网关铃声的两个操作:播放 xiaomi.play_ringtone 和停止xiaomi.stop_ringtone。网关铃声的播放需要 1.4.1_145 及以上网关固件支持。 同时必须提供铃声 ID ringtone_id 和网关 Mac gw_mac。 铃声音量控制 ringtone_vol 是可选的。全部铃声 IDringtone_id 有:

  • alarm ringtones 警报 [0-8]
  • doorbell ring 门铃[10-13]
  • alarm clock 闹钟[20-29]
  • custom ringtones 自定义声音(通过 app 上传)编号从 10001 开始

(译者注:更具体的中文对应名称大家可前往米家 app 中查询)

自动化示例

- alias: Let a dog bark on long press #长按开关后网关发出狗叫
  trigger:
    platform: event
    event_type: click
    event_data:
      entity_id: binary_sensor.switch_158d000xxxxxc2
      click_type: long_click_press
  action:
    service: xiaomi_aqara.play_ringtone
    data:
      gw_mac: xxxxxxxxxxxx
      ringtone_id: 8
      ringtone_vol: 8

- alias: Stop barking immediately on single click
  trigger:
    platform: event
    event_type: click
    event_data:
      entity_id: binary_sensor.switch_158d000xxxxxc2
      click_type: single
  action:
    service: xiaomi_aqara.stop_ringtone
    data:
      gw_mac: xxxxxxxxxxxx

故障排除

连接错误

2017-08-20 16:51:19 ERROR (SyncWorker_0) [homeassistant.components.xiaomi] No gateway discovered
2017-08-20 16:51:20 ERROR (MainThread) [homeassistant.setup] Setup failed for xiaomi: Component failed to initialize.

这个错误表示 HA 无法从网关获取响应,有可能是由于内网网络问题或防火墙屏蔽,解决方法有:

  • 请确保你的内网通畅
  • 关闭 HA 所在系统的防火墙
  • 尝试在设置中将 mac: 留空
  • 尝试增加设置 discovery_retry: 10 (译者注:设置网关嗅探失败的重启间隔)
  • 尝试断网重连
  • 尝试重置网关