Zigpy-ZNP 项目教程

凤尚柏Louis

于 2024-09-15 07:56:57 发布

阅读量1.2k

点赞数 24

本文链接：https://blog.csdn.net/gitblog_00202/article/details/142273666

版权

Zigpy-ZNP 项目教程

zigpy-znp TI CC2531, CC13x2, CC26x2 radio support for Zigpy and ZHA 项目地址: https://gitcode.com/gh_mirrors/zi/zigpy-znp

1. 项目介绍

Zigpy-ZNP 是一个 Python 库，旨在为 Zigpy 项目添加对 Texas Instruments ZNP（Zigbee Network Processors）Zigbee 无线电模块的支持。Zigpy 是一个 Python Zigbee 堆栈项目，通过 Zigpy-ZNP，用户可以直接控制多种 Zigbee 设备，如 Philips Hue、GE、OSRAM LIGHTIFY、Xiaomi/Aqara、IKEA Tradfri、Samsung SmartThings 等。

Zigpy-ZNP 支持多种 Texas Instruments 的 Zigbee 无线电模块，包括 CC2531、CC13x2、CC26x2 等。该项目通过与 Zigpy 和 Home Assistant 的 ZHA（Zigbee Home Automation）集成组件配合使用，提供了一个强大的 Zigbee 设备控制解决方案。

2. 项目快速启动

安装

首先，创建一个虚拟环境并激活它：

$ virtualenv -p python3.8 venv
$ source venv/bin/activate

然后，安装 Zigpy-ZNP 库：

(venv) $ pip install zigpy-znp

或者，从 GitHub 安装最新开发版本：

(venv) $ pip install git+https://github.com/zigpy/zigpy-znp/

配置

在 Home Assistant 中，Zigpy-ZNP 的稳定版本会自动安装。如果你需要手动配置，可以在 configuration.yaml 文件中添加以下内容：

zha:
  zigpy_config:
    znp_config:
      tx_power: 19  # 仅当你的设备有内置功率放大器时设置
      led_mode: off  # 仅当你的设备有可控 LED 时设置

启动

在 Home Assistant 中启动 ZHA 组件，确保 Zigpy-ZNP 已经正确安装并配置。

3. 应用案例和最佳实践

案例1：控制 Philips Hue 灯泡

通过 Zigpy-ZNP，你可以轻松地将 Philips Hue 灯泡集成到 Home Assistant 中，并使用自动化脚本控制灯光的开关、亮度和颜色。

案例2：监控 Xiaomi 传感器

Xiaomi 的 Zigbee 传感器（如温度传感器、湿度传感器和运动传感器）可以通过 Zigpy-ZNP 集成到 Home Assistant 中，实现实时监控和自动化控制。

最佳实践

硬件选择：推荐使用 CC2652P/CC2652R/CC2652RB 等新一代无线电模块，以获得更好的性能和稳定性。
固件更新：定期检查并更新 Zigbee 设备的固件，以确保兼容性和安全性。
网络优化：通过 Zigpy-ZNP 提供的工具（如 network_scan 和 energy_scan）优化 Zigbee 网络，减少干扰和提高稳定性。