Python interface to Bluetooth LE on Linux

This is a project to provide an API to allow access to Bluetooth Low Energy devices from Python. At present it runs on Linux only; I've mostly developed it using a Raspberry Pi, but it will also run on x86 Debian Linux.

There is also code which uses this to talk to a TI SensorTag (www.ti.com/sensortag).

This is beta-quality code, not all LE functions are implemented.

The code needs an executable 'bluepy-helper' to be compiled from C source. You can do this by running 'make' in the bluepy/ subdirectory. Currently the Makefile is configured to build for ARM Linux; you will need to set the ARCH variable in it appropriately for other platforms.

The sources need glib and dbus headers to compile. On the Pi you can get these with: sudo apt-get install libglib2.0-dev libdbus-1-dev

Once 'bluepy-helper' is built, you can copy it and the two .py files to somewhere convenient on your Python path (e.g. /usr/local/lib/python2.7/site-packages/).

This project uses code from the bluez project, which is available under the GPL.

The Python files are released into the public domain by their author, Ian Harvey.

TODO list 19-Oct-2013:

• Make accurate build and install instructions
• Implement 'hcitool lescan' functionality
• Implement notifications (and with it SensorTag key press service)
• better demo code and function documentation

Update 5-Jan-2013

• Now works with Bluez-5.13 gatt_connect needs error variable gatt_find_info was renamed to gatt_discover_char_desc
• Remove directory for Blue-5.4