小米智能家居集成
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 版本 | |
|---|---|
| 最低操作系统版本 | |
| 安装方式 | |
| 登录方式 | |
| 控制模式 | |
| 支持区域 | |
| 设备协议 | |
| 本地控制硬件 |
项目资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Home Assistant | 1 | — | 需 Core ≥ 2024.4.4 |
| 小米中枢网关 | 1 | — | 用于本地控制模式 |
| 小米智能设备 | 若干 | — | 需支持 MIoT 协议 |
所需工具
| 工具 | 用途 | 是否必需 |
|---|---|---|
| Home Assistant | 运行集成组件的平台 | ✅ 是 |
| Git（可选） | 通过 Git clone 安装 | ▢ 推荐 |
| HACS（可选） | 一键安装集成 | ▢ 推荐 |
| Samba/FTPS（可选） | 手动安装文件传输 | ▢ 推荐 |
能力画像
记忆与知识检索
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 中创建自动化场景，控制小米设备
多账户家庭共享智能设备控制