Java Bluetooth

The USB BLE adapter for Java

Dongl is a USB Bluetooth Low Energy adapter you drive from Java and the JVM with SimpleJavaBLE. Scan, connect, and pair through its own radio on Windows, macOS, and Linux, from one JAR.

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 SimpleJavaBLE

    Add org.simpleble:simplejavable to Gradle or Maven.

  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 org.simplejavable.Adapter;
import org.simplejavable.Backend;

List<Adapter> adapters = Backend.getDongl().getAdapters();
if (adapters.isEmpty()) {
    System.err.println("No Dongl found.");
    return;
}

Adapter adapter = adapters.get(0);
System.out.println(adapter.getIdentifier() + " [" + adapter.getAddress() + "]");
In Java today

What Java uses today

The JVM has no Bluetooth API of its own, and most Java BLE libraries are built on Linux's BlueZ.

bluez-dbus

bluez-dbus lists the BlueZ adapters and selects one by address, on Linux only.

Blessed for BlueZ

Blessed for BlueZ runs on Linux and picks the adapter with the highest index on its own.

TinyB

Intel's TinyB reached BlueZ from C++ and Java. Its repository is archived.

Why Dongl

What a Dongl gives your Java code

Adapters

Several radios, one JVM

Each Dongl is another adapter with its own radio. Plug in one per test fixture and drive each from its own thread.

Builds

One dependency, no JNI to write

The JAR carries the native library for every desktop platform. Add it to Gradle or Maven and select the Dongl.

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 Java code

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

JVM

Any JVM language

Kotlin, Scala, and other JVM languages call SimpleJavaBLE directly, with the same Dongl support.

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 Java 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, add SimpleJavaBLE to Gradle or Maven, and take the adapters of the Dongl backend with Backend.getDongl().getAdapters(). Each Dongl is an adapter with its own radio, and it works through the same API as the computer's Bluetooth.

All three. SimpleJavaBLE drives a Dongl on Windows, macOS, and Linux with the same code. On Linux, add your user to the dialout group so it can open the Dongl, as the SimpleBLE docs describe.

Yes. Each Dongl is a separate adapter, and getAddress() tells them apart across restarts and USB ports. Drive each one from its own thread to test several devices in parallel.

No. The SimpleJavaBLE JAR carries the native library for each desktop platform, so your code stays plain Java.

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.