zigpy-znp

What it is and what it does

zigpy-znp is a Python driver that bridges Texas Instruments ZNP (Zigbee Network Processor) radio modules to the zigpy Zigbee stack. It enables direct communication with Zigbee devices like Philips Hue, IKEA Tradfri, Xiaomi/Aqara, and others through compatible home automation software, most commonly Home Assistant's ZHA (Zigbee Home Automation) integration.

The package provides both a library interface for programmatic control and command-line tools for network management, firmware flashing, and diagnostics. It supports a range of TI hardware from older CC2531 sticks to newer CC2652 and CC1352 modules, though newer hardware is recommended for larger networks. Installation is straightforward via pip, and the package integrates transparently with Home Assistant when the ZHA component is installed.

Use it for:

• Control Zigbee smart home devices (lights, switches, sensors) through Home Assistant without a separate Zigbee hub.
• Flash and manage firmware on TI CC2531 or CC2652 Zigbee radio adapters using built-in tools.
• Back up and restore Zigbee network configuration and device information via JSON export/import.
• Perform network diagnostics such as energy scans to detect interference or active beacon scans for network discovery.
• Integrate custom Zigbee automation logic with zigpy in a Python environment.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Adds support for Texas Instruments ZNP Zigbee radio modules to the zigpy stack, enabling control of Zigbee devices through compatible home automation software.

Yes, if you have a compatible TI Zigbee radio adapter and want to use it with Home Assistant or a zigpy-based application. The package is actively maintained, has no known vulnerabilities, and integrates seamlessly with Home Assistant's ZHA. The GPL-3.0 copyleft license is standard for home automation projects. Install friction is low and dependencies are minimal. Not applicable if you use a different Zigbee radio vendor or do not need Zigbee support.

Install

zigpy-znp on PyPI

pip install zigpy-znp

uv add zigpy-znp

poetry add zigpy-znp

Installing zigpy-znp

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release; the package is part of the broader zigpy ecosystem used by Home Assistant's ZHA integration.

License in practice

GPL-3.0 copyleft license requires derivative works and modifications to be released under the same license. Acceptable for home automation and personal use, but review obligations apply if you redistribute or embed this code.

Quickstart

pip install zigpy-znp

import zigpy_znp
# Use with zigpy or Home Assistant ZHA integration
# Command-line tools: python -m zigpy_znp.tools.network_scan

Requires Python 3.11 or later. Needs a compatible Texas Instruments Zigbee radio adapter (CC2652, CC1352, CC2538, or CC2531) connected via USB or GPIO.

Verify before relying

• Whether the package works with Home Assistant versions prior to its release date or only with versions released after.
• Performance characteristics or latency guarantees for real-time Zigbee device control.
• Compatibility matrix with specific firmware versions on different TI chip models.

Package facts

Evidence: zigpy_znp-1.1.0-py3-none-any.whl

Tags

More Networking packages