Home Assistant 接入米家设备完整指南

为什么要把米家设备接入 Home Assistant？

米家（Mi Home）拥有丰富的智能设备生态，但其 App 功能封闭、自动化能力有限。通过将米家设备接入 Home Assistant（HA），你可以：

• 实现跨品牌设备联动（如米家灯 + 非米家传感器）
• 使用更强大的自动化逻辑和脚本
• 摆脱对云服务的依赖，提升响应速度与隐私安全
• 统一管理所有智能设备于一个界面

接入方式概览

根据设备类型和网络协议，主要有以下几种接入方法：

1. Miio 协议（Wi-Fi 设备）：适用于支持局域网控制的米家设备（如空气净化器、部分插座）。
2. Xiaomi Gateway（Zigbee 设备）：通过小米多功能网关接入 Zigbee 子设备（如门窗传感器、人体传感器）。
3. 蓝牙网关/蓝牙设备：需配合支持 BLE 的主机（如树莓派 + 蓝牙适配器）或第三方蓝牙网关。
4. 本地 API / 第三方集成：如使用 xiaomi_miot_raw 或 miot 自定义组件。

方法一：使用78TP Miio 集成（推荐 Wi-Fi 设备）

适用于支持局域网通信的米家设备（需在米家 App 中开启“局域网控制”）。

在 Home Assistant 中添加配置：

# configuration.yaml

fan:

  - platform: xiaomi_miio

    name: Xiaomi Air Purifier

    host: 192.168.1.100

    token: YOUR_DEVICE_TOKEN

获取 Token 方法：使用工具如 miio-cli 或通过旧版米家 App 抓包。

方法二：通过小米多功能网关（Zigbee 设备）

适用于连接在小米网关下的 Zigbee 设备（如温湿度计、门磁）。

1. 在米家 App 中找到网关设备，进入设置 → 关于 → 连续点击“固件版本”直到出现“局域网通信协议”
2. 开启协议并设置密码（即为 key）
3. 在 Home Assistant 中配置：

# configuration.yaml

binary_sensor:

  - platform: xiaomi_aqara

    gateways:

      - key: "YOUR_GATEWAY_KEY"

        host: "192.168.1.101"

重启 HA 后，子设备将自动发现。

常见问题与注意事项

• 部分新型米家设备（如采用蓝牙 Mesh 的灯）不支持直接接入，需借助蓝牙网关或改用 custom_components。
• Token 获取失败？建议使用 Android 模拟器 + 旧版米家 App（v5.4.54）导出。
• 若设备频繁离线，请检查路由器是否隔离了 IoT 设备或 HA 主机防火墙设置。
• 推荐使用 hass-xiaomi-miot 组件支持更多新型设备。

结语

将米家设备接入 Home Assistant 不仅能释放设备潜力，还能构建真正开放、私有、可定制的智能家居系统。虽然初期配置略复杂，但一旦完成，你将获得前所未有的控制自由度。

持续关注社区更新，善用 GitHub 和 Home Assistant 论坛资源，让智能生活更进一步！