小米智能家居集成
ha_xiaomi_home
3/5
🧩 软硬件结合
已发布
项目简介
Xiaomi Home Integration for Home Assistant
Xiaomi Home Integration 是小米官方为 Home Assistant 开发的一款集成组件，旨在让用户将小米 IoT 智能设备无缝接入 Home Assistant 平台。该项目解决了智能家居生态碎片化的问题，使用户能够在 Home Assistant 的统一界面中管理和控制小米智能设备，无需在多个 App 之间切换。核心功能包括：通过小米账号登录后，自动同步并导入用户家中的设备列表，支持多账号登录，允许不同账号下的设备归属于同一区域，极大提升了多用户家庭的设备管理便利性。此外，项目还提供了调试模式，支持手动发送 Action 命令，便于高级用户进行设备调试。
标签
项目特点
**官方支持**：由小米官方提供，安全可靠，持续更新
**多账户支持**：支持多个小米账号同时登录，设备可跨账户管理
**云端与本地双模式**：支持云端控制和本地控制（需小米中枢网关）
**广泛设备兼容**：支持大部分小米智能设备类别（蓝牙、红外、虚拟设备除外）
**多区域可用**：支持中国大陆、欧洲、印度、俄罗斯、新加坡、美国等区域
**OAuth 2.0 安全登录**：不保存密码，仅使用令牌认证
**MIoT-Spec-V2 协议映射**：自动将设备属性和事件转换为 Home Assistant 实体
技术规格
| 最低 Home Assistant 版本 | Core ≥ 2024.4.4 |
|---|---|
| 最低操作系统版本 | Operating System ≥ 13.0 |
| 安装方式 | Git clone、HACS、手动安装 |
| 登录方式 | OAuth 2.0 |
| 控制模式 | 云端控制 / 本地控制（需中枢网关） |
| 支持区域 | 中国大陆、欧洲、印度、俄罗斯、新加坡、美国 |
| 设备协议 | MIoT-Spec-V2 |
| 本地控制硬件 | 小米中枢网关（固件 ≥ 3.3.0_0023）或内置中枢网关设备（软件 ≥ 0.8.9） |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Home Assistant | 1 | — | 需 Core ≥ 2024.4.4 |
| 小米中枢网关 | 1 | — | 用于本地控制模式 |
| 小米智能设备 | 若干 | — | 需支持 MIoT 协议 |
能力画像
⚪ 记忆与知识检索: 1/5
🔵 逻辑推演: 1/5
⚪ 表达与交流: 1/5
⚪ 感知与观察: 1/5
⚪ 数理与计算: 1/5
🔵 动手与操作: 3/5
⚪ 狂热与坚持: 1/5
⚪ 创造与创新: 1/5
项目图库
所需技能
🔧 **动手能力**：需要能够安装和配置 Home Assistant 系统，以及通过 Git 或 HACS 安装集成组件
💻 **编程能力**：无需编程能力，但熟悉命令行操作有助于 Git 安装方式
⚡ **电子电路**：无需电子电路知识
适用场景
将小米智能家居设备接入 Home Assistant 统一管理
实现跨品牌智能设备联动（通过 Home Assistant）
在 Home Assistant 中创建自动化场景，控制小米设备
多账户家庭共享智能设备控制