Python Bluetooth

The USB BLE adapter for Python

Dongl is a USB Bluetooth Low Energy adapter you drive from Python with SimplePyBLE. Scan, connect, and pair through its own radio on Windows, macOS, and Linux, and plug in several to test devices in parallel.

Kober Engineering
InsuLearn
Meta
Fender
Honeywell
Bionic Labs
Sona
SWT
Moon Smart Focus
Lewitt
Medra
Desko
g.tec
IXI
Innovision
Moonlighting Industries
Kober Engineering
InsuLearn
Meta
Fender
Honeywell
Bionic Labs
Sona
SWT
Moon Smart Focus
Lewitt
Medra
Desko
g.tec
IXI
Innovision
Moonlighting Industries
Kober Engineering
InsuLearn
Meta
Fender
Honeywell
Bionic Labs
Sona
SWT
Moon Smart Focus
Lewitt
Medra
Desko
g.tec
IXI
Innovision
Moonlighting Industries
Get started

Set up in three steps

  1. Get an adapter

    Pre-order a Dongl, or flash the free Dongl firmware onto a Nordic nRF52840 Dongle or DK you already own.

  2. Install SimplePyBLE

    Run pip install simplepyble.

  3. Select the adapter

    A plugged-in Dongl appears as its own adapter, next to the computer's Bluetooth. Take the adapters of the Dongl backend and your code runs on the Dongl.

Select the Dongl, then scan, connect, and read. This is the code for each step.

import simplepyble

adapters = simplepyble.Backend.get_dongl().adapters()
if not adapters:
    raise SystemExit("No Dongl found.")

adapter = adapters[0]
print(adapter.identifier(), adapter.address())
In Python today

What Python uses today

Most Python BLE code runs on the computer's built-in Bluetooth, and the Bluetooth stack in Windows supports one radio. These are the usual routes.

Bleak

Bleak drives the operating system's Bluetooth with asyncio. Choosing an adapter is a BlueZ option, so on Windows and macOS a script runs on the computer's default radio.

BleuIO

BleuIO is a USB dongle driven by AT commands over a serial port, with its own Python library.

pygatt and pc-ble-driver-py

pygatt drove BLED112 dongles over BGAPI, and Nordic's pc-ble-driver-py drove nRF52 dongles. Both repositories are archived, and Silicon Labs no longer makes the BLED112.

Why Dongl

What a Dongl gives your Python code

Adapters

Several radios, one script

Each Dongl is another adapter with its own radio. Plug in one per device under test.

Threads

Parallel without asyncio

SimplePyBLE releases the GIL during blocking calls, so one thread per Dongl scans and connects in parallel.

Addresses

Real addresses on macOS

Scans report each device's real address, so a Mac test station matches devices by the address on their label.

Pairing

Pairing from your Python code

Your code answers passkey and numeric-comparison prompts, with no system dialog. Bonds stay on the Dongl.

Consistency

The same Bluetooth everywhere

Your script behaves the same on every Windows PC, Mac, and Linux machine, and in a Docker container on Linux.

Support

A direct line to the engineers

Commercial customers work directly with the team that builds SimpleBLE and the Dongl firmware.

Plug in a Dongl and run your Python code

Dongl hardware ships with the firmware installed and includes a commercial license to use SimpleBLE through the Dongl backend.

Frequently
asked questions

Plug in a Dongl, install SimplePyBLE with pip, and take the adapters of the Dongl backend with simplepyble.Backend.get_dongl().adapters(). Each Dongl is an adapter with its own radio, and it works through the same API as the computer's Bluetooth.

Yes. Each Dongl is a separate adapter. SimplePyBLE releases the GIL during blocking calls, so one thread per Dongl scans, connects, and reads in parallel. A Dongl keeps its address across restarts and USB ports, so each one maps to a fixed test fixture.

Yes. The Dongl backend works the same on all three. On Linux, add your user to the dialout group so it can open the Dongl, as the SimpleBLE docs describe.

SimplePyBLE drives both the computer's Bluetooth and Dongls, with blocking calls or asyncio. Move scanning, connections, and reads one flow at a time. The Bleak migration guide in the SimpleBLE docs maps each call.

No. The free Dongl firmware runs on a Nordic nRF52840 Dongle or DK for prototyping, testing, and non-commercial validation. Dongl hardware ships with the firmware installed and includes a commercial license to use SimpleBLE through the Dongl backend.

SimpleBLE is source-available under the Business Source License 1.1 and free for non-commercial use. Evaluation needs no license. Commercial use needs a license, and one agreement covers your whole company, with no per-seat, per-device, or royalty fees. Each Dongl hardware unit includes a commercial license to use SimpleBLE through the Dongl backend.