05Home Assistant (HA) 中添加绿米（Aqara/Lumi）设备主要有两种主流方案

admin

Home Assistant (HA) 中添加绿米（Aqara/Lumi）设备主要有两种主流方案，取决于你拥有什么样的硬件设施。

请根据你的情况选择以下一种方案：

• 方案 A：拥有 Aqara 官方网关（如 M1S, M2, E1, 空调伴侣 P3 等）。

  
  

  • 核心思路：通过 HomeKit 反向接入 HA。

    
    

• 方案 B：拥有通用 Zigbee 适配器（如 Sonoff ZBDongle, SkyConnect 等 USB 棒）。

  
  

  • 核心思路：通过 ZHA 或 Zigbee2MQTT 直接控制设备（推荐，完全本地化，摆脱网关限制）。

    
    
  
  

---

方案 A：使用 Aqara 官方网关 (通过 HomeKit Controller)

这是最简单的方案，适合不想折腾硬件、且已经购买了 Aqara 网关的用户。目前的 Aqara 网关大多支持 HomeKit，HA 可以通过局域网“模拟”成 iOS 设备来接管网关及其子设备。

步骤：

• 在 Aqara App 中配网：

  
  

  • 手机下载“Aqara Home” App（尽量不要用米家 App，Aqara Home 对 HomeKit 支持更好）。

  • 将网关及子设备（传感器、开关等）添加到 Aqara Home App 中，确保固件已更新到最新。

  • 注意： 如果你使用的是 iPhone，不要在 iOS 的“家庭”App 中添加这个网关。如果已经添加了，请在 iOS 家庭 App 中删除该网关（解绑），因为一个 HomeKit 设备通常只能被一个控制器（手机或 HA）独占。

    
    

• 在 Home Assistant 中发现设备：

  
  

  • 打开 Home Assistant 网页。

  • 进入 配置 (Settings) -> 设备与服务 (Devices & Services)。

  • 通常 HA 会自动发现局域网内的 HomeKit 设备，你会看到“HomeKit Device”下的发现提示。

  • 如果没有自动发现，点击右下角 添加集成，搜索 HomeKit Device（注意不是 HomeKit Bridge）。

    
    

• 配对：

  
  

  • 点击配置，系统会要求输入 配对码 (Pairing Code)。

  • 配对码通常印在网关的底部或包装盒上（格式为 XXX-XX-XXX）。

  • 输入后等待几秒，网关及其下挂的所有子设备就会自动出现在 HA 中了。

    
    
  
  

优点： 简单，官方 App 可升级固件。
缺点： 依赖网关，部分特殊属性（如光照感应器的具体数值刷新率）可能受限于 HomeKit 协议。

---

方案 B：使用 Zigbee USB 适配器 (推荐：Zigbee2MQTT)

这是高阶玩家和追求稳定性的首选方案。你需要购买一个 Zigbee USB Dongle（推荐 Sonoff ZBDongle-P 或 -E 版本）。这种方式不需要 Aqara 网关，所有设备直接连到 HA，响应速度最快。

这里介绍最强大的 Zigbee2MQTT (Z2M) 方法，虽然比 ZHA 稍微复杂一点，但对绿米设备的私有协议支持最好。

准备工作：

• 将 Zigbee USB 棒插入运行 HA 的设备（树莓派/NAS/迷你主机）。最好使用 USB 延长线，避免 USB 3.0 干扰。

  
  

步骤 1：安装 MQTT Broker (Mosquitto)

• 在 HA 中，进入 配置 -> 加载项 (Add-ons) -> 加载项商店。

• 搜索并安装 Mosquitto broker。

• 启动它，并确保打开“启动时运行”和“看门狗”。

• 回到 配置 -> 设备与服务，HA 应该会自动发现 MQTT，点击配置并提交。

  
  

步骤 2：安装 Zigbee2MQTT

• 进入 配置 -> 加载项 -> 加载项商店。

• 点击右上角菜单（三个点） -> 仓库，添加 Z2M 的仓库地址：https://github.com/zigbee2mqtt/hassio-zigbee2mqtt (如果搜不到官方的，请先添加这个)。

• 刷新后，安装 Zigbee2MQTT。

  
  

步骤 3：配置 Zigbee2MQTT

• 在 Z2M 加载项页面，点击 配置 (Configuration) 标签。

• MQTT 设置：

  
  

  • server: mqtt://core-mosquitto:1883

  • user: (通常留空，或者输入你 HA 的用户名)

  • password: (同上)

    
    

• Serial 设置 (关键)：

  
  

  • 你需要知道 USB 棒的端口路径（例如 /dev/ttyUSB0）。可以在 配置 -> 系统 -> 硬件 -> 全部硬件 中查找。

  • 在配置里添加：

    codeYaml
    
    serial:  port: /dev/ttyUSB0  # 根据实际情况修改
    

• 启动 Zigbee2MQTT 加载项，并查看 日志 确保启动成功（没有红色报错）。

• 点击“打开 WEB UI”。

  
  

步骤 4：添加绿米设备

• 在 Zigbee2MQTT 的 Web 界面上方，点击 允许加入 (Permit join)（开始倒计时）。

• 重置绿米设备：

  
  

  • 大多数绿米传感器（人体、门窗、温湿度）：长按设备上的重置按钮 5-10秒，直到蓝色指示灯闪烁。

  • 此时松手，如果设备支持，它会再闪一下，表示正在连接。

    
    

• 观察 Z2M 界面，你会看到设备通过面试（Interview），并显示为“Lumi”开头的型号。

• 你可以点击设备名称旁边的蓝色铅笔图标，修改一个友好的名字（如“客厅人体传感器”），并勾选“更新 Home Assistant 实体 ID”。

  
  

优点：

• 本地化：完全脱离云端。

• 兼容性：不仅能连绿米，还能混搭宜家、涂鸦等其他品牌的 Zigbee 设备。

• 功能全：绿米很多设备有隐藏参数（如人体传感器的灵敏度、断电记忆状态），Z2M 可以直接修改这些参数，而网关模式往往不行。

  
  

---

方案 C：使用 ZHA (Zigbee Home Automation) - 简易版 USB 棒方案

如果你觉得方案 B 太复杂，可以使用 HA 原生的 ZHA 集成，同样需要 USB 棒。

• 插入 USB 棒。

• 进入 配置 -> 设备与服务。

• HA 通常会自动发现 USB 棒，询问是否设置 Zigbee Home Automation。

• 点击配置，选择正确的串口，创建网络。

• 设置完成后，点击 ZHA 集成卡片上的 配置 -> 添加设备。

• 长按绿米设备重置键配对即可。

  
  

注：ZHA 对绿米设备的支持也不错，但针对一些新型号或特殊参数的调整，不如 Zigbee2MQTT 灵活。

---

总结与建议

• 新手/不想折腾硬件：使用 方案 A (Aqara 网关 + HomeKit)。最稳妥，App 还能用来升级设备固件。

• 进阶/追求响应速度/设备多：使用 方案 B (Zigbee2MQTT)。这是目前 HA 社区最推崇的方式，彻底释放绿米设备的潜力。

  
  

常见问题 Troubleshooting

• 设备经常掉线？

  
  

  • 绿米的老款 Zigbee 设备（非 T1 系列）不太符合标准 Zigbee 3.0 协议，容易掉线。

  • 解决： 增加 Zigbee 路由器设备（也就是零火供电的设备，如绿米墙壁开关零火版、智能插座），不要让传感器直接连 USB 棒太远。

    
    

• 配对不上？

  
  

  • 尽量靠近 USB 棒或网关配对。

  • 对于绿米设备，长按重置键灯闪后，建议每隔 1 秒短按一下按钮，保持设备唤醒，直到配对成功。

    
    

• 能接入米家 App 的网关怎么接？

  
  

  • 如果是旧款的小米多模网关，可以使用 Xiaomi Gateway 3 集成（HACS 安装）。但目前新设备推荐走 HomeKit 通道，因为米家协议经常变动且封堵本地接口。

    
    
  
  

发帖者介绍-莱特智能成立于2010年，专注智能家居整体解决方案，Now ALL IN HA，欢迎淘宝搜索！