Skip to content

Latest commit

 

History

History
56 lines (43 loc) · 1.44 KB

README.md

File metadata and controls

56 lines (43 loc) · 1.44 KB

ble-java logo

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.

Features

  • Create GATT Services
  • Create GATT Characteristic
  • Customize the Peripheral name
  • Pure JAVA library

Dependencies

  1. Java 8 or better
  2. BlueZ 5.43 or better
  3. d-bus Java library libdbus-java Raspbian example:
sudo apt-get install

you may also have to do run

sudo ldconfig

Install

Clone the repository and build with Gradle (4.5 or higher):

gradle build

Example

You could see the main MainExample.java in src/test/java/example. It's a sample main that create a BLE Application with one Service and 2 Characteristic.

BlueZ compatibility

Until now is tested with BlueZ 5.46 on Raspbian distribution.

ble-java use the GattManager and LEAdvertising that was marked "Experimental" since 5.47, so you have to enable the Experimental features with the --experimental parameter in the BlueZ startup service.

Example for Raspbian /lib/systemd/system/bluetooth.service

...
bluetoohd --experimental
...

In the BlueZ 5.48 seem to be removed the experimental tag on the LEAdvertising features, but it was not yet tried.

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

Help

If you need help you can write me an email or you can open a new issue.