|build_status_badge| |pypi_badge| |py_versions_badge|
.. |build_status_badge| image:: https://travis-ci.org/nioinnovation/python-xbee.svg?branch=master
:target: https://travis-ci.org/nioinnovation/python-xbee
.. |pypi_badge| image:: https://img.shields.io/pypi/v/XBee.svg
:target: https://pypi.python.org/pypi/XBee
.. |py_versions_badge| image:: https://img.shields.io/pypi/pyversions/XBee.svg
:target: https://pypi.python.org/pypi/XBee
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:
.. code:: python
#! /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')
::
pip install xbee
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.
::
pip install xbee[tornado]
See the python-xbee project on Read the Docs <https://python-xbee.readthedocs.io/en/latest/>
_.
To build the documentation yourself, ensure that Sphinx <http://sphinx-doc.org/>
_ 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.
PySerial pip >= 6.0 setuptools >= 8.0
If wanting to use the Tornado IOLoop: Tornado <http://www.tornadoweb.org/>
_
To run automated tests: pytest <https://docs.pytest.org>
_
To build the documentation: Sphinx <http://sphinx-doc.org/>
_
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.