adafruit-blinka-bleio 0.9.3

`_bleio` for Blinka based on `bleak`

Introduction

_bleio for Blinka based on bleak and bluez.

Dependencies

This driver depends on:

• bleak

It also depends on these Debian packages not install on Raspbian by default:

• bluez-hcidump

Installing from PyPI

On supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally from PyPI. To install for current user:

pip3 install adafruit-blinka-bleio

To install system-wide (this may be required in some cases):

sudo pip3 install adafruit-blinka-bleio

To install in a virtual environment in your current project:

mkdir project-name && cd project-name
python3 -m venv .env
source .env/bin/activate
pip3 install adafruit-blinka-bleio

Permissions

For comprehensive scanning we use hcidump and hcitool. By default, only root has enough privileges to do what we need.

So, to get permissions we use capabilities to grant hcitool and hcidump raw network access. This is very powerful! So, to limit access we change file execution permissions to restrict it to users in the bluetooth group.

To add your user to the bluetooth group do:

sudo usermod -a -G bluetooth <your username>

To set permissions do:

sudo chown :bluetooth /usr/bin/hci*
sudo chmod o-x /usr/bin/hci*
sudo setcap 'cap_net_raw,cap_net_admin+eip' /usr/bin/hcitool
sudo setcap 'cap_net_raw,cap_net_admin+eip' /usr/bin/hcidump

Usage Example

Do not use this library directly. Use CircuitPython BLE instead: https://github.com/adafruit/Adafruit_CircuitPython_BLE/

Contributing

Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.

Documentation

For information on building library documentation, please check out this guide.

Troubleshooting

Raspberry Pi 3b Rev 1.2

The Raspberry Pi 3b’s BLE chip is connected over UART to the main processor without flow control. This can cause unreliability with BLE. To improve reliability, we can slow the UART. To do so, edit /usr/bin/btuart and replace the 921600 with 460800.