ZHA Quirks 项目使用教程

ZHA Quirks 项目使用教程

zha_quirks All quirks in one place 项目地址: https://gitcode.com/gh_mirrors/zh/zha_quirks

1. 项目介绍

ZHA Quirks 项目是一个开源库，旨在为 Home Assistant 中的 ZHA（Zigbee Home Automation）组件提供自定义的设备处理程序（quirks）。这些 quirks 用于处理制造商在 Zigbee 设备中实现的非标准行为，确保这些设备能够与 Home Assistant 无缝集成并正常工作。

2. 项目快速启动

2.1 安装依赖

首先，确保你已经安装了 Home Assistant，并且 ZHA 组件已经启用。

2.2 创建自定义 Quirks 目录

在 Home Assistant 的配置目录中创建一个自定义 quirks 目录，例如：

mkdir -p /config/custom_zha_quirks

2.3 配置 ZHA 组件

在 configuration.yaml 文件中，添加以下配置以指向自定义 quirks 目录：

zha:
  custom_quirks_path: /config/custom_zha_quirks/

2.4 下载并放置 Quirks 文件

从 ZHA Quirks GitHub 仓库 下载所需的 quirks 文件，并将其放置在 /config/custom_zha_quirks/ 目录中。

2.5 重启 Home Assistant

重启 Home Assistant 以应用更改。

2.6 启用调试日志

为了更好地调试和排查问题，可以在 configuration.yaml 中启用调试日志：

logger:
  default: info
  logs:
    homeassistant.components.zha: debug
    zigpy: debug
    zhaquirks: debug

重启 Home Assistant 后，重复可能导致错误的操作，并等待至少 5 分钟。然后下载 Home Assistant 日志，并在新问题中附上这些日志。

3. 应用案例和最佳实践

3.1 支持的设备

ZHA Quirks 项目支持多种 TRV（Thermostatic Radiator Valves）和恒温器设备。以下是一些支持的设备示例：

• trv_saswell.py: 支持多个型号的 Saswell TRV。
• ts0601_temphumid.py: 支持温度和湿度传感器。
• ts0601_thermostat_avatto.py: 支持多个型号的 Avatto 恒温器。

3.2 最佳实践

• 定期更新 Quirks: 由于 Zigbee 设备的固件和功能可能会更新，建议定期检查并更新 ZHA Quirks 项目，以确保兼容性。
• 报告问题: 如果在使用过程中遇到问题，可以通过 GitHub 仓库提交问题，并附上详细的日志信息。

4. 典型生态项目

4.1 Zigpy

Zigpy 是一个用于与 Zigbee 设备通信的 Python 库，ZHA 组件依赖于 Zigpy 来实现 Zigbee 支持。ZHA Quirks 项目与 Zigpy 紧密集成，提供了对非标准 Zigbee 设备的支持。

4.2 Home Assistant

Home Assistant 是一个开源的家庭自动化平台，支持多种协议和设备。ZHA 组件是 Home Assistant 的一部分，通过 ZHA Quirks 项目，可以扩展对更多 Zigbee 设备的支持。

4.3 ZHA Network Card

ZHA Network Card 是一个自定义的 Lovelace 卡片，用于在 Home Assistant 中显示 ZHA 网络和设备信息。通过 ZHA Quirks 项目，可以更好地管理和监控 Zigbee 设备。

通过以上步骤和指南，你可以轻松地在 Home Assistant 中使用 ZHA Quirks 项目，扩展对更多 Zigbee 设备的支持。

zha_quirks All quirks in one place 项目地址: https://gitcode.com/gh_mirrors/zh/zha_quirks