wrapper around different bluetooth low energy backends
Project description
btlewrap
====
Bluetooth LowEnergy wrapper for different python backends. This gives you a nice API so that you can use different Bluetooth implementations on different platforms.
This library was initially implemented as part of the `miflora <https://github.com/open-homeautomation/miflora>`_ library, but then refactored out, so that it can be used on other projects as well.
contribution
============
.. image:: https://travis-ci.org/ChristianKuehnel/btlewrap.svg?branch=master
:target: https://travis-ci.org/ChristianKuehnel/btlewrap
.. image:: https://coveralls.io/repos/github/ChristianKuehnel/btlewrap/badge.svg?branch=master
:target: https://coveralls.io/github/ChristianKuehnel/btlewrap?branch=master
Backends
========
As there is unfortunately no universally working Bluetooth Low Energy library for Python, the project currently
offers support for three Bluetooth implementations:
* bluepy library (recommended library)
* bluez tools (via a wrapper around gatttool)
* pygatt for Bluegiga BLED112-based devices
bluepy
------
To use the `bluepy <https://github.com/IanHarvey/bluepy>`_ library you have to install it on your machine, in most cases this can be done via:
::
pip3 install bluepy
This is the recommended backend to be used. In comparision to the gatttool wrapper, it is much faster in getting the data and also more stable.
bluez/gatttool wrapper
----------------------
To use the bluez wrapper, you need to install the bluez tools on your machine. No additional python
libraries are required. Some distrubutions moved the gatttool binary to a separate package. Make sure you have this
binaray available on your machine.
pygatt
------
If you have a Blue Giga based device that is supported by `pygatt <https://github.com/peplin/pygatt>`_, you have to
install the bluepy library on your machine. In most cases this can be done via:
::
pip3 install pygatt
Usage
=====
See the depending projects below on how to use the library.
Depending projects
==================
These projects are using btlewrap:
* `miflora <https://github.com/open-homeautomation/miflora>`_
* `mitemp <https://github.com/flavio20002/mitemp_bt>`_
====
Bluetooth LowEnergy wrapper for different python backends. This gives you a nice API so that you can use different Bluetooth implementations on different platforms.
This library was initially implemented as part of the `miflora <https://github.com/open-homeautomation/miflora>`_ library, but then refactored out, so that it can be used on other projects as well.
contribution
============
.. image:: https://travis-ci.org/ChristianKuehnel/btlewrap.svg?branch=master
:target: https://travis-ci.org/ChristianKuehnel/btlewrap
.. image:: https://coveralls.io/repos/github/ChristianKuehnel/btlewrap/badge.svg?branch=master
:target: https://coveralls.io/github/ChristianKuehnel/btlewrap?branch=master
Backends
========
As there is unfortunately no universally working Bluetooth Low Energy library for Python, the project currently
offers support for three Bluetooth implementations:
* bluepy library (recommended library)
* bluez tools (via a wrapper around gatttool)
* pygatt for Bluegiga BLED112-based devices
bluepy
------
To use the `bluepy <https://github.com/IanHarvey/bluepy>`_ library you have to install it on your machine, in most cases this can be done via:
::
pip3 install bluepy
This is the recommended backend to be used. In comparision to the gatttool wrapper, it is much faster in getting the data and also more stable.
bluez/gatttool wrapper
----------------------
To use the bluez wrapper, you need to install the bluez tools on your machine. No additional python
libraries are required. Some distrubutions moved the gatttool binary to a separate package. Make sure you have this
binaray available on your machine.
pygatt
------
If you have a Blue Giga based device that is supported by `pygatt <https://github.com/peplin/pygatt>`_, you have to
install the bluepy library on your machine. In most cases this can be done via:
::
pip3 install pygatt
Usage
=====
See the depending projects below on how to use the library.
Depending projects
==================
These projects are using btlewrap:
* `miflora <https://github.com/open-homeautomation/miflora>`_
* `mitemp <https://github.com/flavio20002/mitemp_bt>`_
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
btlewrap-0.0.4.tar.gz
(11.8 kB
view hashes)