Skip to main content

A library which communicates with XBee radios for zigpy

Project description

zigpy-xbee

Build Status Coverage

zigpy-xbee is a Python implementation for the Zigpy project to implement XBee based Zigbee radio devices from Digi.

Digi XBee is the brand name of a family of form factor compatible radio modules from Digi International.

The XBee radios can all be used with the minimum number of connections — power (3.3 V), ground, data in and data out (UART), with other recommended lines being Reset and Sleep.[5] Additionally, most XBee families have some other flow control, input/output (I/O), analog-to-digital converter (A/D) and indicator lines built in.

Zigbee Home Automation integration with zigpy allows you to connect one of many off-the-shelf Zigbee adapters using one of the available Zigbee radio library modules compatible with zigpy to control Zigbee based devices, including this zigpy-xbee library for Xbee based Zigbee radio modules.

zigpy** currently has support for controlling Zigbee device types such as binary sensors (e.g., motion and door sensors), sensors (e.g., temperature sensors), lightbulbs, switches, and fans. A working implementation of zigbe exist in Home Assistant (Python based open source home automation software) as part of its ZHA component

Compatible hardware

zigpy works with separate radio libraries which can each interface with multiple USB and GPIO radio hardware adapters/modules over different native UART serial protocols. Such radio libraries includes zigpy-xbee (which communicates with XBee based Zigbee radios), bellows (which communicates with EZSP/EmberZNet based radios), and as zigpy-deconz for deCONZ serial protocol (for communicating with ConBee and RaspBee USB and GPIO radios from Dresden-Elektronik). There are also an experimental radio library called zigpy-zigate for communicating with ZiGate based radios.

Known working XBee based Zigbee radio modules for Zigpy

These are XBee Zigbee based radios that have been tested with the zigpy-xbee library for zigpy

  • Digi XBee Series 2C (S2C) modules
  • Digi XBee Series 2 (S2) modules. Note: These will need to be manually flashed with the Zigbee Coordinator API firmware via XCTU.
  • Digi XBee Series 3 (xbee3-24) modules

Releases of zigpy-xbee via PyPI

Tagged versions of zigpy-xbee are also released via PyPI

How to contribute

If you are looking to make a contribution to this project we suggest that you follow the steps in these guides:

Some developers might also be interested in receiving donations in the form of hardware such as Zigbee modules or devices, and even if such donations are most often donated with no strings attached it could in many cases help the developers motivation and indirect improve the development of this project.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zigpy-xbee-0.12a1.tar.gz (16.7 kB view hashes)

Uploaded Source

Built Distribution

zigpy_xbee-0.12a1-py3-none-any.whl (29.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page