小米多模网关3是Home Assistant中一个功能强大的自定义组件，专为控制小米多模网关（Gateway 3）、小米多模网关2及Aqara Hub E1等设备设计。通过本地局域网连接，无需修改原厂固件即可实现对Zigbee、BLE和Mesh设备的全面管理，为智能家居爱好者提供了一个稳定可靠的控制中枢。
项目地址: https://gitcode.com/gh_mirrors/xia/XiaomiGateway3 核心功能亮点
多协议设备支持：该组件能够同时管理Zigbee、蓝牙BLE和Mesh三种通信协议的设备，实现真正的多协议兼容。
本地控制优势：所有设备控制都在局域网内完成，无需依赖云端服务，响应速度更快，隐私保护更安全。
固件兼容性强：支持多种固件版本，从早期的1.5.0到最新的1.5.6版本都能稳定运行。
快速安装步骤
方法一：通过HACS安装（推荐）
- 打开Home Assistant的HACS界面
- 进入"集成" > "浏览并下载存储库"
- 搜索"XiaomiGateway3"并点击安装
- 重启Home Assistant服务
方法二：手动安装
如需手动安装，请将项目文件下载到Home Assistant的custom_components目录：
cd /config/custom_components
git clone https://gitcode.com/gh_mirrors/xia/XiaomiGateway3 xiaomi_gateway3
详细配置流程
第一步：获取网关信息
在开始配置前，您需要准备以下信息：
- 网关IP地址（固定IP推荐）
- 网关Token（设备令牌）
- 网关Key（部分固件需要）
第二步：添加集成
- 进入Home Assistant设置 > 集成
- 点击"添加集成"按钮
- 搜索"Xiaomi Gateway3"
- 按照向导填写网关信息
第三步：设备发现与配对
配置完成后，组件会自动发现已连接到网关的设备。如需添加新设备：
- 在网关实体中选择"Zigbee配对"
- 按照设备说明书进行配对操作
- 新设备将自动出现在Home Assistant中
网络配置要点
为确保网关稳定运行，请遵循以下网络配置建议：
共享局域网：确保网关和Home Assistant服务器在同一网络子网内。
固定IP地址：在路由器中为网关设置固定IP地址。
Wi-Fi设置：
- 信道：1-11（固定信道）
- 信道宽度：20MHz
- 认证方式：WPA2
高级配置选项
设备个性化配置
您可以通过YAML配置文件对单个设备进行深度定制：
xiaomi_gateway3:
devices:
"0x00158d0001d82999":
model: 01MINIZB
entities:
channel_1: light
occupancy_timeout: 180
统计传感器启用
通过启用统计传感器，您可以监控网关和设备的运行状态：
- 进入集成设置 > 选项
- 勾选"添加统计传感器"
- 安装Flex Table卡片进行可视化展示
实用场景应用
自动化规则示例
创建智能照明自动化，当门磁传感器检测到开门时自动开启灯光：
automation:
- alias: '进门自动开灯'
trigger:
platform: state
entity_id: binary_sensor.door_window_sensor
to: 'on'
action:
service: light.turn_on
entity_id: light.entrance_light
人体感应器配置
针对人体存在传感器，可设置不同的占用超时策略：
xiaomi_gateway3:
devices:
"0x00158d0003456789":
occupancy_timeout: 180 # 简单定时器
occupancy_timeout: -120 # 快速返回模式
常见问题解决
连接不稳定问题
如果遇到网关连接不稳定的情况，请检查：
- 网络子网是否一致
- Ping功能是否开启
- Wi-Fi设置是否符合要求
设备无法发现
如果某些设备无法被发现，请尝试：
- 检查设备是否已成功配对到网关
- 确认设备固件版本是否支持
- 查看调试日志获取详细信息
调试与日志
启用调试日志可帮助诊断问题：
logger:
logs:
custom_components.xiaomi_gateway3: debug
通过本指南，您应该能够顺利配置并使用小米多模网关3组件，构建属于自己的智能家居系统。记得定期检查项目更新，以获取最新功能和改进。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
