Skip to content
Python tools for working with XBee radios
Branch: master
Clone or download
Latest commit b91be3d May 1, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Bump version to 2.3.2 Apr 3, 2018
examples Remove pytest, add documentation Jul 5, 2017
scripts
xbee
.gitignore
.hgignore
.travis.yml Add Support for timeout on the tornado IOLoop Apr 2, 2018
CHANGES.txt
LICENSE.txt Bump to version 2.2.5 Apr 25, 2017
MANIFEST.in Bump version to 2.2.3 Oct 21, 2015
README.rst
requirements.txt Add requirement file with pyserial dependency Aug 17, 2016
setup.py

README.rst

XBee

build_status_badge pypi_badge py_versions_badge

XBee provides an implementation of the XBee serial communication API. It allows one to easily access advanced features of one or more XBee devices from an application written in Python. An example use case might look like this:

#! /usr/bin/python

# Import and init an XBee device
from xbee import XBee, ZigBee
import serial

ser = serial.Serial('/dev/ttyUSB0', 9600)

# Use an XBee 802.15.4 device
xbee = XBee(ser)
# To use with an XBee ZigBee device, replace with:
# xbee = ZigBee(ser)

# Set remote DIO pin 2 to low (mode 4)
xbee.remote_at(
    dest_addr=b'\x56\x78',
    command='D2',
    parameter=b'\x04')

xbee.remote_at(
    dest_addr=b'\x56\x78',
    command='WR')

Installation

pip install xbee

Install from Source

Extract the source code to your computer, then run the following command in the root of the source tree:

python setup.py install

This will automatically install the package for you.

Install with Tornado Support

pip install xbee[tornado]

Documentation

See the python-xbee project on Read the Docs.

To build the documentation yourself, ensure that Sphinx is installed. Then cd into the docs folder, and run ‘make html’. The documentation can then be opened in any modern web browser at docs/build/html/index.html.

For more information about building or modifying this project's documentation, see the documentation for the Sphinx project.

Dependencies

PySerial pip >= 6.0 setuptools >= 8.0

Additional Dependencies

If wanting to use the Tornado IOLoop: Tornado

To run automated tests: pytest

To build the documentation: Sphinx

XBee Firmware

Please ensure that your XBee device is programmed with the latest firmware provided by Digi. Using an old firmware revision is not supported and may result in unspecified behavior.

Contributors

You can’t perform that action at this time.