Xiaomi Gateway 3 控制组件教程

最新推荐文章于 2024-08-09 08:07:12 发布

尚学红Vandal

最新推荐文章于 2024-08-09 08:07:12 发布

阅读量581

点赞数 19

本文链接：https://blog.csdn.net/gitblog_00953/article/details/141045836

版权

Xiaomi Gateway 3 控制组件教程

XiaomiGateway3Control Zigbee, BLE and Mesh devices from Home Assistant with Xiaomi Gateway 3 on original firmware项目地址:https://gitcode.com/gh_mirrors/xia/XiaomiGateway3

项目介绍

Xiaomi Gateway 3 是一个专为 Home Assistant 设计的自定义组件，旨在通过局域网控制小米多模网关（也称作 Gateway 3）、小米多模网关2及Aqara Hub E1等设备，在默认固件下无需额外破解。此项目由 AlexxIT 开发维护，允许用户无缝集成这些小米智能家居设备到他们的Home Assistant系统中，实现对Zigbee、BLE和Mesh设备的有效管理。

项目快速启动

要快速启动并运行 Xiaomi Gateway 3 组件，首先确保你的环境已满足以下条件：

Home Assistant 已经安装并运行。
你的小米网关连接至同一局域网内。

安装步骤

添加自定义组件: 进入Home Assistant的配置目录，创建或进入 custom_components 文件夹。
```
cd /your/homeassistant/config/custom_components/
```
克隆仓库: 使用Git或者手动下载ZIP文件并解压至 custom_components 中的 xiaomi_gateway3 目录。
```
git clone https://github.com/AlexxIT/XiaomiGateway3.git xiaomi_gateway3
```

配置Home Assistant: 在 configuration.yaml 添加以下配置：

sensor:
  - platform: xiaomi_gateway3
    host: 192.168.1.XXX # 替换为你的小米网关IP地址
    token: 'YOUR_GATEWAY_TOKEN' # 如果需要，填写你的网关Token

重启Home Assistant: 保存更改后，重启Home Assistant以载入新组件。
查看日志与调试: 为了方便调试，可以增加日志配置：
```
logger:
  logs:
    custom_components.xiaomi_gateway3: debug
```

应用案例与最佳实践

应用此组件后，你可以通过Home Assistant界面或自动化规则来管理诸如智能灯泡、传感器、开关等多种小米生态链设备。例如，创建自动化以当某门磁传感器检测到开门时自动开启门口的灯：

automation:
  - alias: 'Door Open, Light On'
    trigger:
      platform: state
      entity_id: binary_sensor.door_window_sensor_XXX
      to: 'on'
    action:
      service: light.turn_on
      entity_id: light.bedroom_light