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文件和相关讨论。