https://github.com/christiankuehnel/btlewrap

Bluetooth LowEnergy wrapper for different python backends.
https://github.com/christiankuehnel/btlewrap

bluepy bluetooth bluetooth-le bluetooth-low-energy gatttool hacktoberfest python python3

Last synced: 6 months ago
JSON representation

Bluetooth LowEnergy wrapper for different python backends.

• Host: GitHub
• URL: https://github.com/christiankuehnel/btlewrap
• Owner: ChristianKuehnel
• License: mit
• Created: 2018-03-10T12:31:06.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2022-05-15T09:41:52.000Z (over 3 years ago)
• Last Synced: 2025-04-15T22:53:37.472Z (6 months ago)
• Topics: bluepy, bluetooth, bluetooth-le, bluetooth-low-energy, gatttool, hacktoberfest, python, python3
• Language: Python
• Homepage:
• Size: 99.6 KB
• Stars: 35
• Watchers: 6
• Forks: 19
• Open Issues: 6
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
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 `_ 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 `_ 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 `_, 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 `_

* `mitemp `_