04HomeAssistant 中如何使用小米设备Xiaomi Miot和Xiaomi Cloud两个集成有什么区别

admin

在 Home Assistant (HA) 中接入小米设备，目前最主流、最好用的方案是通过 HACS 安装 Xiaomi Miot Auto 集成。

Xiaomi Miot 和 Xiaomi Cloud（通常指官方集成或通过云端获取信息的集成），这两者有本质的区别。

以下是详细的对比和教程。

---

第一部分：两者的区别1. Xiaomi Miot Auto (推荐)

这是由国人大神（al-one）开发的第三方插件，目前是接入小米设备最强大、最通用的方案。

• 原理：基于小米最新的 MIoT 协议（小米物联网协议）。

• 优点：

  
  

  • 支持设备极多：几乎支持所有接入米家 APP 的设备（包括蓝牙 Mesh 网关下的设备）。

  • 本地控制：只要设备在同一局域网，它会优先尝试本地局域网控制（反应快、断网可用），无法本地时才走云端。

  • 功能全：能读取设备的各种属性（如电量、温湿度、详细状态）。

    
    

• 缺点：需要安装 HACS（Home Assistant 社区商店）。

  
  

2. Xiaomi Miio (官方集成) / Xiaomi Cloud

HA 官方自带有一个 Xiaomi Miio 集成，有时也被用户笼统称为 Xiaomi Cloud 集成。

• 原理：基于较旧的 Miio 协议。

• 优点：系统自带，无需安装 HACS，稳定性高。

• 缺点：

  
  

  • 支持设备少：主要支持扫地机、空气净化器、老款网关。对新款的插座、开关、传感器支持很差。

  • 配置麻烦：往往需要手动提取设备的 Token 才能接入。

    
    
  
  

结论： 请无脑选择 。它是目前的终极解决方案。

---

第二部分：详细安装教程 (Xiaomi Miot Auto)前置条件

• 你的 Home Assistant 已经安装并运行。

• 必须安装 HACS。如果你还没有安装 HACS，请先搜索“Home Assistant 安装 HACS”完成这一步（这是玩 HA 的必经之路）。

• 你需要有小米账号，并且设备已经添加到了手机上的“米家”APP 中。

  
  

步骤一：在 HACS 中下载集成

• 打开 Home Assistant 左侧菜单栏的 HACS。

• 点击 Integrations (集成)。

• 点击右下角的 Explore & Download Repositories (浏览并下载存储库)。

• 在搜索框输入：Xiaomi Miot Auto。

• 点击搜索结果中的 Xiaomi Miot Auto。

• 点击右下角的 Download (下载)。

• 下载完成后，必须重启 Home Assistant (配置 -> 系统 ->右上角电源按钮 -> 重新启动 Home Assistant)。

  
  

步骤二：添加集成并登录

• 重启完成后，点击左侧菜单栏的 配置 (Settings)。

• 点击 设备与服务 (Devices & Services)。

• 点击右下角的 + 添加集成 (+ ADD INTEGRATION)。

• 在搜索框输入 Xiaomi Miot，点击出现的 Xiaomi Miot Auto 图标。

• 配置方式选择：

  
  

  • 你会看到几个选项，选择第一个 账号集成 (Add devices using Mi Account)。这是最简单的方式，它会自动从云端拉取你的设备列表。

    
    

• 输入账号信息：

  
  

  • Username: 小米账号（手机号或ID）。

  • Password: 小米账号密码。

  • Server: 选择 CN (中国大陆) —— 除非你的米家APP区域选的是其他国家。

  • 点击 提交 (Submit)。

    
    
  
  

步骤三：筛选设备 (可选)

登录成功后，集成会列出你米家账号下的所有设备。

• Exclude devices (排除设备)：如果你有些设备不想接入 HA，可以在这里勾选。

• Filter devices (筛选设备)：通常保持默认（Include all devices）即可。

• Connection mode (连接模式)：

  
  

  • 建议选择 Automatic (自动)。

  • 解释：它会自动检测设备是否在局域网内。如果在，就走本地控制（秒响应）；如果不在（比如蓝牙设备或不在同一WiFi），就走云端控制。

    
    

• 点击 提交 (Submit)。

  
  

步骤四：完成与使用

• 点击完成后，你会在“设备与服务”列表中看到 Xiaomi Miot Auto。

• 点击它，你会看到“XX 个设备”。点击进入即可看到你的台灯、插座、传感器等。

• 建议：

  
  

  • 点击某个设备，查看其 实体 (Entities)。

  • 你可以将这些实体添加到你的 HA 仪表盘 (Lovelace) 中进行控制。

    
    
  
  

---

第三部分：常见问题与进阶技巧

1. 关于本地控制 (Local) vs 云端控制 (Cloud)

• 如何判断？ 在 HA 的设备页面，点击该设备，查看属性。如果你看到 sub_type 或连接模式显示为 local，说明是本地控制。

• 为什么重要？ 本地控制不依赖互联网，反应速度极快，且保护隐私。

• 注意：要实现本地控制，你的 HA 主机和小米设备必须在同一个局域网（同一个网段）。如果你有复杂的 VLAN 设置，可能需要开启跨网段的 mDNS 广播。

  
  

2. 蓝牙设备 (温湿度计、门锁)

• 蓝牙设备本身不连 WiFi，它们通过“蓝牙网关”连接到米家云端。

• Xiaomi Miot Auto 接入这些设备通常是走云端 (Cloud) 的（因为 HA 无法直接通过 WiFi 连蓝牙设备）。

• 进阶玩法：如果你想本地接入蓝牙设备，需要购买一个支持刷 ESPHome 的蓝牙接收器，或者利用 HA 主机自带的蓝牙功能配合 Passive BLE Monitor 集成（那是另一个话题了）。但对于新手，用 Xiaomi Miot Auto 走云端读取温湿度已经足够。

  
  

3. 设备实体名称乱码/过长

• 接入后，实体 ID 可能会很长（例如 switch.xiaomi_plug_v3_xxxx）。

• 建议在“设备”页面点击具体的实体，点击右上角齿轮图标，修改 Entity ID 和 名称，方便后续在自动化中调用。

  
  

总结
不要纠结于区别，直接使用 HACS 安装 Xiaomi Miot Auto，选择账号登录模式，这是目前接入小米全家桶最稳妥、最简单的“保姆级”方案。

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