Skip to main content

Bluetooth Stack for Apps, Emulation, Test and Experimentation

Project description

 _                 _     _
| |               | |   | |
| |__  _   _ ____ | |__ | | _____
|  _ \| | | |    \|  _ \| || ___ |
| |_) ) |_| | | | | |_) ) || ____|
|____/|____/|_|_|_|____/ \_)_____)

Bluetooth Stack for Apps, Emulation, Test and Experimentation

Logo

Bumble is a full-featured Bluetooth stack written entirely in Python. It supports most of the common Bluetooth Low Energy (BLE) and Bluetooth Classic (BR/EDR) protocols and profiles, including GAP, L2CAP, ATT, GATT, SMP, SDP, RFCOMM, HFP, HID and A2DP. The stack can be used with physical radios via HCI over USB, UART, or the Linux VHCI, as well as virtual radios, including the virtual Bluetooth support of the Android emulator.

Documentation

Browse the pre-built Online Documentation, or see the documentation source under docs/mkdocs/src, or build the static HTML site from the markdown text with:

mkdocs build -f docs/mkdocs/mkdocs.yml

Usage

Getting Started

For a quick start to using Bumble, see the Getting Started guide.

Dependencies

To install package dependencies needed to run the bumble examples, execute the following commands:

python -m pip install --upgrade pip
python -m pip install ".[test,development,documentation]"

Examples

Refer to the Examples Documentation for details on the included example scripts and how to run them.

The complete list of Examples, and what they are designed to do is here.

There are also a set of Apps and Tools that show the utility of Bumble.

Using Bumble With a USB Dongle

Bumble is easiest to use with a dedicated USB dongle. This is because internal Bluetooth interfaces tend to be locked down by the operating system. You can use the usb_probe tool (all platforms) or lsusb (Linux or macOS) to list the available USB devices on your system.

See the USB Transport page for details on how to refer to USB devices. Also, if your are on a mac, see these instructions.

License

Licensed under the Apache 2.0 License.

Disclaimer

This is not an official Google product.

This library is in alpha and will be going through a lot of breaking changes. While releases will be stable enough for prototyping, experimentation and research, we do not recommend using it in any production environment yet. Expect bugs and sharp edges. Please help by trying it out, reporting bugs, and letting us know what you think!

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

bumble-0.0.202.tar.gz (2.3 MB view details)

Uploaded Source

Built Distribution

bumble-0.0.202-py3-none-any.whl (662.9 kB view details)

Uploaded Python 3

File details

Details for the file bumble-0.0.202.tar.gz.

File metadata

  • Download URL: bumble-0.0.202.tar.gz
  • Upload date:
  • Size: 2.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for bumble-0.0.202.tar.gz
Algorithm Hash digest
SHA256 d9345f8df7ca4e6265ffddbc4235e482d8a7ee67e29ff7dde534a6f85de248c8
MD5 66dfa48e4aab6f3d2b7a15860b25ad3f
BLAKE2b-256 c4a68becc8b289b5b680bd5556d9f7c713d87fd0cb45d08523bf5836165ae10e

See more details on using hashes here.

File details

Details for the file bumble-0.0.202-py3-none-any.whl.

File metadata

  • Download URL: bumble-0.0.202-py3-none-any.whl
  • Upload date:
  • Size: 662.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for bumble-0.0.202-py3-none-any.whl
Algorithm Hash digest
SHA256 91be3078582b8b09aad7bb6ffd08791fb58cd48056592eb9e691de5285e8cf73
MD5 27ebf2bb027e3cf4d8a3c90cd2345db1
BLAKE2b-256 c1a4ed2b0dc8c41c86af155df0d29cd9bc5454ee5faa940d10ec52f837b7050d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page