项目概述
项目地址: https://gitcode.com/gh_mirrors/xia/XiaomiGateway3 Xiaomi Gateway 3是一款专为Home Assistant设计的自定义组件，支持在原始固件下通过局域网控制小米多模网关、小米多模网关2以及Aqara Hub E1等设备。该项目无需额外操作即可实现对Zigbee、BLE和Mesh设备的全面管理。
支持的网关设备
该项目兼容多种小米和Aqara网关设备，包括：
- 小米多模网关（中国版）：ZNDMWG03LM
- 小米多模网关（欧洲版）：ZNDMWG02LM、YTC4044GL
- 小米多模网关2（中国版）：DMWG03LM
- 小米多模网关2（欧洲版）：ZNDMWG04LM、BHR6765GL
- Aqara Hub E1（中国版）：ZHWG16LM
安装方法
方法一：HACS安装
通过HACS（Home Assistant Community Store）进行安装是最简单的方式：
- 进入HACS > 集成
- 点击右下角"+"按钮
- 搜索"XiaomiGateway3"
- 点击安装
方法二：手动安装
如需手动安装，请按以下步骤操作：
- 进入Home Assistant配置目录的custom_components文件夹
- 克隆项目到指定目录：
git clone https://gitcode.com/gh_mirrors/xia/XiaomiGateway3 xiaomi_gateway3
- 重启Home Assistant服务
配置步骤
配置过程分为两个主要步骤：
第一步：云集成配置 用于从云端加载设备的令牌和名称信息。如果你已经知道网关的令牌，可以跳过此步骤。
第二步：网关配置 添加你的网关以及所有连接的Zigbee、BLE和Mesh设备。如果有多个网关，需要为每个网关重复此步骤。
网络配置要求
为确保网关稳定运行，请确保满足以下网络条件：
- 网关与Home Assistant服务器在同一局域网内
- 路由器对网关开放ICMP协议
- 在路由器上为网关设置固定IP地址
- Wi-Fi路由器设置：固定信道1-11，信道宽度20MHz，认证方式WPA2
支持的设备类型
Zigbee设备
网关的Zigbee芯片支持三种工作模式：
1. 米家模式（默认）
- 支持在米家应用和Home Assistant中同时使用小米/Aqara Zigbee设备
- 在Home Assistant中支持部分其他品牌的Zigbee设备
2. Zigbee家庭自动化模式
- 支持数百个品牌的Zigbee设备
3. Zigbee2MQTT模式
- 通过MQTT支持数百个品牌的Zigbee设备
BLE和Mesh设备
小米BLE和Mesh设备可以在米家应用和Home Assistant中同时工作，不受Zigbee模式的影响。
高级配置功能
设备配置选项
在configuration.yaml文件中可以配置以下设备选项：
覆盖设备型号
xiaomi_gateway3:
devices:
"0x00158d0001d82999":
model: 01MINIZB
更改实体域
xiaomi_gateway3:
devices:
"0x00158d0001d82999":
entities:
channel_1: light
占用超时设置
对于人体移动传感器，可以配置不同的超时模式：
- 简单定时器：每次检测到人体移动时启动
- 渐进定时器：每次新的移动都会启动新的定时器值
- 快速返回定时器：如果人在定时器关闭后立即移动，则以双倍值启动
蓝牙锁处理
支持处理蓝牙门锁设备，包括动作检测、电池状态监控等功能。
统计表格功能
通过启用统计传感器，可以监控网络质量、设备连接状态等关键指标。
故障排除
调试模式
在集成配置中启用调试日志，可以更详细地查看组件运行状态：
logger:
logs:
custom_components.xiaomi_gateway3: debug
常见问题
- 设备无法连接：检查网络配置和网关固件版本
- 实体不显示：确认设备令牌和密钥配置正确
- 连接不稳定：优化Wi-Fi路由器设置
多网关支持
集成支持在同一个米家账户下使用多个网关。建议将Zigbee网络分割到多个网关中，这样可以提高网络稳定性。
固件要求
推荐使用的固件版本：
- 小米多模网关（中国/欧洲版）：1.5.4 - 1.5.6
- 小米多模网关2（中国/欧洲版）：1.0.6 - 1.0.7
- Aqara Hub E1（中国版）：4.0.1
对于需要密钥的固件版本（1.5.5及以上），请参考相关文档获取密钥。
自动化应用
通过Home Assistant界面或自动化规则，可以创建各种智能场景：
- 门磁传感器触发灯光
- 人体传感器控制空调温度
- 环境监测设备联动其他智能设备
技术特点
- 本地控制，无需云端连接
- 实时响应，无延迟
- 支持多种通信协议
- 灵活的配置选项
本集成组件为智能家居爱好者提供了一个强大而灵活的工具，能够将小米生态链设备完美集成到Home Assistant系统中。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
