zigpy-xbee is a Python library that enables communication with XBee radio devices for the zigpy project. It acts as a hardware-specific radio library for zigpy, allowing users to integrate Digi XBee Zigbee modules into a Zigbee Home Automation setup. The library is currently at version 0.21.1 and requires Python 3.8 or newer. It is actively maintained as part of the broader zigpy ecosystem, with updates typically coinciding with changes in zigpy or Home Assistant's ZHA component.
pip install zigpy-xbeeVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to initialize and start a `zigpy-xbee` controller application. It configures the serial port and baud rate, then starts the Zigbee network, optionally forming a new one if it doesn't exist. It also includes an example of enabling pairing mode for new devices to join. Ensure your XBee radio is pre-configured for API mode and the correct baud rate using Digi's XCTU tool.
Use Digi XCTU software to flash the latest Zigbee Coordinator API firmware and set ATAP2 (API mode) and ATBD6 (57600 baud) parameters, then write changes (ATWR).
Use a USB 2.0 port or a shielded USB extension cable (at least 1m long) to move the XBee coordinator away from the computer's USB port.
Change your Wi-Fi router's 2.4GHz channel to avoid overlap with your Zigbee channel (e.g., Zigbee channel 25 often avoids common Wi-Fi channels). Refer to Zigbee best practices for channel selection.
Monitor `zigpy` and `Home Assistant ZHA` release notes and discussions for updates on long-term support plans for XBee radios.