完整指南：XiaoMiGateway3在Home Assistant中的快速安装与终极配置
项目地址: https://gitcode.com/gh_mirrors/xia/XiaomiGateway3 XiaoMiGateway3是专为Home Assistant设计的自定义组件，让你无需刷机即可直接控制小米多功能网关及其连接的Zigbee、蓝牙和Mesh设备。本指南将手把手教你从零开始完成整个安装配置过程，让你轻松打造智能家居系统。
🚀 最快安装方法：一键部署XiaoMiGateway3
HACS自动安装（推荐）
这是最简单快捷的安装方式，只需几个步骤：
- 确保已安装HACS（Home Assistant Community Store）
- 进入HACS > 集成 > 加号 > 搜索"XiaomiGateway3"
- 点击安装并重启Home Assistant
手动安装方法
如果无法使用HACS，可以手动安装：
- 下载项目文件：
git clone https://gitcode.com/gh_mirrors/xia/XiaomiGateway3 - 将
custom_components/xiaomi_gateway3文件夹复制到Home Assistant的/config/custom_components目录 - 重启Home Assistant服务
🔑 核心配置步骤：获取网关令牌和密钥
配置过程分为两个关键步骤：
第一步：云版本配置
- 用于从云端获取设备令牌和设备名称
- 需要小米账户登录
- 自动识别你账户中的所有网关设备
第二步：网关本地配置
- 添加具体的网关设备
- 支持本地控制所有连接的设备
- 如果你有多个网关，需要为每个网关重复此步骤
⚙️ 网络环境优化：确保稳定连接
稳定的网络环境是XiaoMiGateway3正常工作的基础：
- 同一局域网：网关和Home Assistant服务器必须在同一网络子网
- 固定IP地址：在路由器中为网关分配固定IP
- WiFi设置：使用2.4GHz频段，固定信道1-11，信道宽度20MHz
- 认证方式：使用WPA2，避免WPA3
📊 设备统计与监控：实时掌握设备状态
启用统计传感器功能，让你全面了解网络状况：
- 进入集成设置 > Xiaomi Gateway 3 > 选项 > 添加统计传感器
- 安装Flex Table卡片（通过HACS）
- 在Lovelace中添加统计面板
🎯 高级设备配置：个性化定制
在configuration.yaml中进行设备级配置：
占用超时设置
适用于人体传感器，可根据不同场景灵活配置：
xiaomi_gateway3:
devices:
"0x00158d0003456789":
occupancy_timeout: 180 # 简单定时器
"0x00158d0003456788":
occupancy_timeout: -120 # 快速返回模式
"0x00158d0003456787":
occupancy_timeout: [-120, 240, 300] # 渐进定时器
状态反转功能
适用于门窗传感器，反转逻辑状态：
xiaomi_gateway3:
devices:
"0x00158d0003456789":
invert_state: 1 # 任何非空值都会反转逻辑
默认过渡时间
控制Zigbee灯泡的开关速度：
xiaomi_gateway3:
devices:
"0x86bd7fffe0000000":
default_transition: 5
🔧 网关控制功能：全方位管理
通过网关实体可以执行多种操作：
- Zigbee配对：添加新的Zigbee设备
- 网关重启：重新启动网关设备
- FTP服务：在网关上启用FTP文件传输
📱 支持设备范围：广泛的兼容性
XiaoMiGateway3支持多种设备类型：
支持的网关
- 小米多功能网关（中欧版）
- 小米多功能网关2（中欧版）
- Aqara Hub E1（中国版）
设备类型支持
- Zigbee设备：小米/绿米及其他品牌设备
- 蓝牙设备：门锁、传感器等
- Mesh设备：智能开关、灯具等
❗ 常见问题与解决方案
集成不显示
如果添加集成时找不到XiaomiGateway3，请清空浏览器缓存后重试。
设备离线
检查网络设置，确保网关和Home Assistant在同一子网，网关能够ping通路由器。
获取密钥困难
- 旧固件（1.5.4及以下）：仅需令牌
- 新固件（1.5.5及以上）：需要令牌和密钥
💡 实用技巧与小贴士
- 多网关配置：支持在同一个小米账户下配置多个网关
- 设备迁移：Zigbee设备不能在不同网关间直接迁移
- 固件建议：使用推荐固件版本以获得最佳稳定性
通过本指南，你已掌握了XiaoMiGateway3在Home Assistant中的完整安装配置流程。现在就可以开始打造属于你自己的智能家居系统了！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
