`_bleio` for Blinka based on `bleak`
Project description
Introduction
_bleio for Blinka based on bleak and bluez.
Dependencies
This driver depends on:
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-bleioTo install system-wide (this may be required in some cases):
sudo pip3 install adafruit-blinka-bleioTo 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-bleioPermissions
For comprehensive scanning we use hcidump and hcitool. By default, only root has enough privileges though.
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/hcidumpUsage 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.
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
File details
Details for the file adafruit-blinka-bleio-0.9.1.tar.gz.
File metadata
- Download URL: adafruit-blinka-bleio-0.9.1.tar.gz
- Upload date:
- Size: 22.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.8.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6e25047f14c69c42752372b4ba3077e16d8627cda1ca867c9b3de6d245b84af0 |
|
| MD5 | 83f83a39d26a4fb063bdc9f01c98f8ce |
|
| BLAKE2b-256 | 2ee3aabe6c14f0b4d90fd4c2b7ae135a12a6bf53e380bc1b4a4684ec685b7948 |
