【亲测免费】 XiaoMiGateway3 自定义组件在Home Assistant中的安装与配置指南

1. 项目目录结构及介绍

该项目的目录结构如下：

.
├── assets                 # 资源文件夹
└── custom_components      # 自定义组件文件夹
   └── xiaomi_gateway3      # XiaoMiGateway3组件的核心代码
      ├── __init__.py       # 组件初始化文件
      ├── ...
      ├── test              # 测试文件夹
      ├── gitignore         # Git忽略文件列表
      ├── LICENSE           # 许可证文件
      ├── README.md         # 项目读我文件
      ├── hacs.json         # HACS配置文件
      ├── print_models.py    # 打印设备模型文件
      └── ...                # 其他相关文件

custom_components/xiaomi_gateway3 文件夹包含了该自定义组件的所有核心代码，用于与小米多功能网关进行交互。

2. 项目启动文件介绍

组件的主启动文件是 custom_components/xiaomi_gateway3/__init__.py。这个文件定义了组件的功能，如发现和控制连接到网关的设备。它也负责处理与Home Assistant的集成，接收和响应事件以及执行服务调用。

3. 项目配置文件介绍

XiaoMiGateway3组件的配置主要通过Home Assistant的全局配置文件或UI进行。以下是一些关键设置示例：

xiaomi_gateway3:
  logger:
    filename: xiaomi_gateway3.log
    propagate: False
    max_bytes: 100000000
    backup_count: 3
    
  devices:
    "0x00158d0003456789":
      occupancy_timeout: 180
    "0x00158d0003456788":
      occupancy_timeout: -120
    "0x00158d0003456787":
      occupancy_timeout: [-120, 240, 300]
    "0x00158d0003456786":
      occupancy_timeout: 1
      invert_state: 1
      
  default_transition: 5

• logger: 配置日志记录器，包括日志文件名、是否传播到Home Assistant日志、文件大小限制和备份文件计数。
• devices: 设备特定配置，例如传感器的占用超时设置，occupancy_timeout 可以调整为不同模式，如简单的超时时间，快速返回模式或渐进定时器。
• invert_state: 对于接触传感器，设置非空值（如1）可以反转状态逻辑。
• default_transition: 设置默认的过渡时间，例如Zigbee灯泡的开关速度。

在Home Assistant中添加此组件，首先通过HACS或者手动将xiaomi_gateway3文件夹复制到/config/custom_components目录下，然后在Home Assistant的配置页面添加Integration，选择XiaoMiGateway3并按步骤配置云版本（获取令牌和设备名称）和网关（用于本地控制）。确保清空浏览器缓存以便列出新组件。

完成上述配置后，组件会在启动时自动识别和控制你的小米网关及其连接的设备。如果有任何疑问或需要进一步帮助，请查阅GitHub仓库的README文件和相关讨论。