设备及服务 - 小米生态链 - Zigbee

优质

小牛编辑

132浏览

2023-12-01

以米家多功能网关为中枢的 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 （译者注：设置网关嗅探失败的重启间隔）
尝试断网重连
尝试重置网关