ble-java is a java library for building BLE GATT peripherals role application in JAVA.

ble-java is based on BlueZ, the Linux Bluetooth stack implemented on D-Bus.

Features

Create GATT Services
Create GATT Characteristic
Customize the Peripheral name
JAVA library with minimal JNI interfaces to BlueZ over D-Bus

Dependencies

Java 8 or better
BlueZ 5.43 or better
libunixsocket-java (apt-get install libsocket-java)
d-bus Java library libdbus-java

Raspbian install:

sudo apt-get install libdbus-java

you may also have to do run

sudo ldconfig

Install

Clone the repository and build with Gradle:

./gradlew build

Example

MainExample.java in src/test/java/example demonstrates a sample main that creates a BLE Application with one Service and 2 Characteristics.

Before running the example, copy example.conf to /etc/dbus-1/system.d/

To run from command line: sudo ./gradlew runExample

Press ctrl-c to stop service.

BlueZ compatibility

Tested with BlueZ 5.46 on Raspbian distribution.

ble-java usees the GattManager and LEAdvertising that was marked "Experimental" since 5.47. You need to enable the Experimental features with the --experimental parameter in the BlueZ startup service.

For Raspbian and Ubuntu /lib/systemd/system/bluetooth.service

...
bluetoohd --experimental
...

If you are using BlueZ 5.48, the --experimental tag may not be needed for LEAdvertising features. But we have not tried this yet.

For more info about BlueZ see http://www.bluez.org.

Help