Extremely simple! Based on callback. Communication with BluetoothLE(BLE) device as easy as HTTP communication. One Device, One connection, One LiteBluetooth Instance.
But One connection can has many callback: One LiteBluetooth Instance can add many BluetoothGattCallback.
##Usage
###1. scan device
private static int TIME_OUT_SCAN = 10000;
liteBluetooth.startLeScan(new PeriodScanCallback(TIME_OUT_SCAN) {
@Override
public void onScanTimeout() {
dialogShow(TIME_OUT_SCAN + " Millis Scan Timeout! ");
}
@Override
public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord) {
BleLog.i(TAG, "device: " + device.getName() + " mac: " + device.getAddress()
+ " rssi: " + rssi + " scanRecord: " + Arrays.toString(scanRecord));
}
});###2. scan and connect
private static String MAC = "00:00:00:AA:AA:AA";
liteBluetooth.scanAndConnect(MAC, false, new BleGattCallback() {
@Override
public void onConnectSuccess(BluetoothGatt gatt, int status) {
// discover services !
gatt.discoverServices();
}
@Override
public void onServicesDiscovered(BluetoothGatt gatt, int status) {
BluetoothUtil.printServices(gatt);
dialogShow(MAC + " Services Discovered SUCCESS !");
}
@Override
public void onConnectFailure(BleException exception) {
bleExceptionHandler.handleException(exception);
dialogShow(MAC + " Services Discovered FAILURE !");
}
});###3. get state of litebluetooth
BleLog.i(TAG, "liteBluetooth.getConnectionState: " + liteBluetooth.getConnectionState());
BleLog.i(TAG, "liteBluetooth isInScanning: " + liteBluetooth.isInScanning());
BleLog.i(TAG, "liteBluetooth isConnected: " + liteBluetooth.isConnected());
BleLog.i(TAG, "liteBluetooth isServiceDiscoered: " + liteBluetooth.isServiceDiscoered());
if (liteBluetooth.getConnectionState() >= LiteBluetooth.STATE_CONNECTING) {
BleLog.i(TAG, "lite bluetooth is in connecting or connected");
}
if (liteBluetooth.getConnectionState() == LiteBluetooth.STATE_SERVICES_DISCOVERED) {
BleLog.i(TAG, "lite bluetooth is in connected, services have been found");
}###4. add(remove) new callback to an existing connection.
/**
* add(remove) new callback to an existing connection.
* One Device, One {@link LiteBluetooth}.
* But one device( {@link LiteBluetooth}) can add many callback {@link BluetoothGattCallback}
*
* {@link LiteBleGattCallback} is a extension of {@link BluetoothGattCallback}
*/
private void addNewCallbackToOneConnection() {
BluetoothGattCallback liteCallback = new BluetoothGattCallback() {
@Override
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {}
@Override
public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {
}
@Override
public void onCharacteristicWrite(BluetoothGatt gatt,
BluetoothGattCharacteristic characteristic, int status) {
}
@Override
public void onReadRemoteRssi(BluetoothGatt gatt, int rssi, int status) {}
};
if (liteBluetooth.isConnectingOrConnected()) {
liteBluetooth.addGattCallback(liteCallback);
liteBluetooth.removeGattCallback(liteCallback);
}
}###5. refresh bluetooth device cache
liteBluetooth.refreshDeviceCache();###6. close connection
if (liteBluetooth.isConnectingOrConnected()) {
liteBluetooth.closeBluetoothGatt();
}###7. write data to characteritic
LiteBleConnector connector = liteBluetooth.newBleConnector();
connector.withUUIDString(UUID_SERVICE, UUID_CHAR_WRITE, null)
.writeCharacteristic(new byte[]{1, 2, 3}, new BleCharactCallback() {
@Override
public void onSuccess(BluetoothGattCharacteristic characteristic) {
BleLog.i(TAG, "Write Success, DATA: " + Arrays.toString(characteristic.getValue()));
}
@Override
public void onFailure(BleException exception) {
BleLog.i(TAG, "Write failure: " + exception);
bleExceptionHandler.handleException(exception);
}
});###8. write data to descriptor
LiteBleConnector connector = liteBluetooth.newBleConnector();
connector.withUUIDString(UUID_SERVICE, UUID_CHAR_WRITE, UUID_DESCRIPTOR_WRITE)
.writeDescriptor(new byte[]{1, 2, 3}, new BleDescriptorCallback() {
@Override
public void onSuccess(BluetoothGattDescriptor descriptor) {
BleLog.i(TAG, "Write Success, DATA: " + Arrays.toString(descriptor.getValue()));
}
@Override
public void onFailure(BleException exception) {
BleLog.i(TAG, "Write failure: " + exception);
bleExceptionHandler.handleException(exception);
}
});###9. read data from characteritic
LiteBleConnector connector = liteBluetooth.newBleConnector();
connector.withUUIDString(UUID_SERVICE, UUID_CHAR_READ, null)
.readCharacteristic(new BleCharactCallback() {
@Override
public void onSuccess(BluetoothGattCharacteristic characteristic) {
BleLog.i(TAG, "Read Success, DATA: " + Arrays.toString(characteristic.getValue()));
}
@Override
public void onFailure(BleException exception) {
BleLog.i(TAG, "Read failure: " + exception);
bleExceptionHandler.handleException(exception);
}
});###10. enable notification of characteristic
LiteBleConnector connector = liteBluetooth.newBleConnector();
connector.withUUIDString(UUID_SERVICE, UUID_CHAR_READ, null)
.enableCharacteristicNotification(new BleCharactCallback() {
@Override
public void onSuccess(BluetoothGattCharacteristic characteristic) {
BleLog.i(TAG, "Notification characteristic Success, DATA: " + Arrays
.toString(characteristic.getValue()));
}
@Override
public void onFailure(BleException exception) {
BleLog.i(TAG, "Notification characteristic failure: " + exception);
bleExceptionHandler.handleException(exception);
}
});###11. enable notification of descriptor
LiteBleConnector connector = liteBluetooth.newBleConnector();
connector.withUUIDString(UUID_SERVICE, UUID_CHAR_READ, UUID_DESCRIPTOR_READ)
.enableDescriptorNotification(new BleDescriptorCallback() {
@Override
public void onSuccess(BluetoothGattDescriptor descriptor) {
BleLog.i(TAG,
"Notification descriptor Success, DATA: " + Arrays.toString(descriptor.getValue()));
}
@Override
public void onFailure(BleException exception) {
BleLog.i(TAG, "Notification descriptor failure : " + exception);
bleExceptionHandler.handleException(exception);
}
});###12. read RSSI of device
liteBluetooth.newBleConnector()
.readRemoteRssi(new BleRssiCallback() {
@Override
public void onSuccess(int rssi) {
BleLog.i(TAG, "Read Success, rssi: " + rssi);
}
@Override
public void onFailure(BleException exception) {
BleLog.i(TAG, "Read failure : " + exception);
bleExceptionHandler.handleException(exception);
}
});##More Detail, See The Sample
Website : http://litesuits.com
Email : litesuits@qq.com