【亲测免费】 XiaomiGateway3 项目使用教程

1. 项目介绍

XiaomiGateway3 是一个 Home Assistant 的自定义组件，用于控制小米多模网关（也称为 Gateway 3）、小米多模网关 2 和 Aqara Hub E1。该项目允许用户在 Home Assistant 中通过局域网控制这些网关及其连接的 Zigbee、BLE 和 Mesh 设备。

主要功能

• 支持小米多模网关（CN/EU）
• 支持小米多模网关 2（CN/EU）
• 支持 Aqara Hub E1（CN）
• 支持通过局域网控制 Zigbee、BLE 和 Mesh 设备
• 支持多种 Zigbee 工作模式（Mi Home、Zigbee Home Automation、Zigbee2MQTT）

2. 项目快速启动

安装步骤

1. 通过 HACS 安装

   • 打开 Home Assistant 的 HACS 界面。
   • 导航到“集成”部分。
   • 点击右上角的“+”按钮。
   • 搜索“XiaomiGateway3”并点击安装。

2. 手动安装

   • 下载最新版本的 xiaomi_gateway3 文件夹。
   • 将文件夹复制到 Home Assistant 配置目录下的 custom_components 文件夹中。

配置步骤

1. 添加集成

   • 打开 Home Assistant 的“配置”页面。
   • 导航到“集成”部分。
   • 点击“添加集成”按钮。
   • 搜索“Xiaomi Gateway3”并添加。

2. 输入网关信息

   • 在弹出的窗口中输入网关的 IP 地址和 Mi Home 的 Token。
   • 如果需要，输入网关的 Key（仅适用于特定固件版本）。

示例配置代码

xiaomi_gateway3:
  devices:
    "0x00158d0003456789":
      occupancy_timeout: 180
    "0x00158d0003456788":
      occupancy_timeout: -120
    "0x00158d0003456787":
      occupancy_timeout: [-120, 240, 300]
    "0x00158d0003456786":
      occupancy_timeout: 1
    "0x00158d0003456789":
      invert_state: 1
    "0x86bd7fffe0000000":
      default_transition: 5

3. 应用案例和最佳实践

应用案例

• 智能家居自动化：通过 Home Assistant 控制小米多模网关及其连接的设备，实现自动化场景，如灯光控制、温度监测、安防系统等。
• 远程控制：结合 Home Assistant 的远程访问功能，实现对家中设备的远程控制。

最佳实践

• 网络配置：确保网关和 Home Assistant 服务器在同一局域网内，并使用固定 IP 地址。
• 固件选择：选择推荐的固件版本以确保最佳兼容性和稳定性。
• 调试日志：在配置过程中启用调试日志，以便更好地排查问题。

4. 典型生态项目

• Home Assistant：XiaomiGateway3 是 Home Assistant 的一个自定义组件，用于扩展其功能。
• Zigbee2MQTT：支持将 Zigbee 设备通过 MQTT 协议接入 Home Assistant。
• ZHA（Zigbee Home Automation）：支持将 Zigbee 设备通过 ZHA 协议接入 Home Assistant。

通过这些生态项目，用户可以构建一个完整的智能家居系统，实现对各种设备的统一管理和自动化控制。