小米网关3 Home Assistant集成
XiaomiGateway3
智能家居
3/5
🧩 软硬件结合
已发布
项目简介
Home Assistant custom component for control Xiaomi Multimode Gateway (aka Gateway 3), Xiaomi Multimode Gateway 2, Aqara
XiaomiGateway3 是一个专为 Home Assistant 设计的开源自定义组件，旨在通过局域网直接控制小米多模网关（包括小米多模网关1代、2代以及Aqara Hub E1）的默认固件。该项目解决了智能家居用户的核心痛点：无需破解或刷写第三方固件，即可将小米网关及其连接的Zigbee和蓝牙设备无缝接入Home Assistant生态，实现本地化、低延迟的智能家居控制。
标签
项目特点
支持小米多模网关（Gateway 3）的完整控制，包括 Zigbee、BLE 和 Wi-Fi 设备
兼容 Aqara 设备，无需额外网关即可接入 Home Assistant
原生支持 HACS 安装，更新和维护非常方便
支持 Matter 协议，未来兼容性更强
提供丰富的传感器和设备实体，可直接用于自动化场景
开源社区活跃，持续更新和修复问题
技术规格
| 支持网关型号 | Xiaomi Multimode Gateway (Gateway 3) |
|---|---|
| 协议支持 | Zigbee 3.0, BLE, Wi-Fi, Matter |
| 兼容设备 | Aqara 设备、小米 Zigbee 设备、BLE 传感器 |
| 集成方式 | Home Assistant Custom Component |
| 安装方式 | HACS 或手动复制文件 |
| 最低 Home Assistant 版本 | 2023.x 及以上 |
| 开发语言 | Python |
| 配置方式 | YAML 配置文件或 UI 集成 |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| 小米多模网关 (Gateway 3) | 1 | — | 必须设备 |
| 小米/Aqara Zigbee 设备 | 若干 | — | 可选，根据需求添加 |
| BLE 传感器 | 若干 | — | 可选，如温湿度计 |
| Home Assistant 服务器 | 1 | — | 运行 Home Assistant 的主机 |
| HACS 插件 | 1 | — | 用于安装自定义组件 |
能力画像
**记忆与知识检索**：3/5 — 需要了解 Home Assistant 和 Zigbee 协议的基本知识，但文档和社区资源丰富
**动手与操作**：4/5 — 需要动手配置网关、安装组件和调试设备，操作步骤较多
**编程与算法**：2/5 — 主要依赖 YAML 配置，无需编写复杂代码，但理解 Python 有一定帮助
**设计与建模**：1/5 — 不涉及硬件设计或建模，主要是软件集成
**实验与调试**：4/5 — 设备接入后需要反复测试和调试自动化场景，日志排查常见
**协作与分享**：3/5 — 可以通过 GitHub Issue 和社区论坛交流，但主要是个体项目
**学习与研究**：4/5 — 需要学习 Home Assistant 集成机制、Zigbee 协议和 BLE 通信原理
**系统集成**：5/5 — 核心能力就是系统集成，将多种协议和设备统一到 Home Assistant 中
项目图库
所需技能
熟悉 Home Assistant 的基本操作和配置
了解 Zigbee 和 BLE 无线协议的基本原理
能够阅读和编写 YAML 配置文件
具备基础的网络知识（IP 地址、端口等）
会使用 Git 进行代码克隆和更新
有排查日志和调试设备的能力
适用场景
想把小米/Aqara 智能设备接入 Home Assistant 的智能家居玩家
需要统一管理 Zigbee、BLE 和 Wi-Fi 设备的家庭自动化场景
希望摆脱米家 App 限制，实现更复杂自动化逻辑的用户
搭建全屋智能系统，需要多协议网关集成的技术爱好者
研究 Home Assistant 自定义组件开发的学习者