android 蓝牙 le only,GitHub - litesuits/android-lite-bluetoothLE: BLE Framework. Based on Bluetooth 4....

LiteBle: Android Bluetooth Framework

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