org.eclipse.kura.bluetooth

Interface BluetoothGatt

public interface BluetoothGatt

The BluetoothGatt service is the main communication interface with the Bluettoth LE device. The service will provide information about available services and mechanisms for reading and writing to available characteristics.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	checkConnection() Check if the device is connected.
boolean	connect() Connect to devices GATT server.
void	disconnect() Disconnect from devices GATT server.
List<BluetoothGattCharacteristic>	getCharacteristics(String startHandle, String endHandle) Get a list of GATT characteristics based on start and end handles.
BluetoothGattService	getService(UUID uuid) Return a GATT service based on a UUID.
List<BluetoothGattService>	getServices() Get a list of GATT services offered by the device.
String	readCharacteristicValue(String handle) Read characteristic value from handle.
String	readCharacteristicValueByUuid(UUID uuid) Read value from characteristic by UUID.
void	setBluetoothLeNotificationListener(BluetoothLeNotificationListener listener) Sets the listener by which asynchronous actions of the GATT server will be communicated.
void	writeCharacteristicValue(String handle, String value) Write value to characteristic.

Method Detail

connect

boolean connect()

Connect to devices GATT server.

Returns:

If connection was successful

disconnect

void disconnect()

Disconnect from devices GATT server.

checkConnection

boolean checkConnection()

Check if the device is connected.

setBluetoothLeNotificationListener

void setBluetoothLeNotificationListener(BluetoothLeNotificationListener listener)

Sets the listener by which asynchronous actions of the GATT server will be communicated.

Parameters:

listener - BluetoothLeListener

getService

BluetoothGattService getService(UUID uuid)

Return a GATT service based on a UUID.

Parameters:

uuid - UUID of service

Returns:

BluetoothGattService

getServices

List<BluetoothGattService> getServices()

Get a list of GATT services offered by the device.

Returns:

List of services

getCharacteristics

List<BluetoothGattCharacteristic> getCharacteristics(String startHandle,
                                                   String endHandle)

Get a list of GATT characteristics based on start and end handles. Handle boundaries can be obtained from the getServices method.

Parameters:

startHandle - Start handle

endHandle - End handle

Returns:

List of GATT characteristics

readCharacteristicValue

String readCharacteristicValue(String handle)

Read characteristic value from handle.

Parameters:

handle - Characteristic handle

Returns:

Characteristic value

readCharacteristicValueByUuid

String readCharacteristicValueByUuid(UUID uuid)

Read value from characteristic by UUID.

Parameters:

uuid - UUID of Characteristic

Returns:

Characteristic value

writeCharacteristicValue

void writeCharacteristicValue(String handle,
                            String value)

Write value to characteristic.

Parameters:

handle - Handle of Characteristic

value - Value to write to Characteristic