/*
* Copyright 2015 Junk Chen
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.junkchen.blelib;
import android.Manifest;
import android.app.Service;
import android.bluetooth.BluetoothAdapter;
import android.bluetooth.BluetoothDevice;
import android.bluetooth.BluetoothGatt;
import android.bluetooth.BluetoothGattCallback;
import android.bluetooth.BluetoothGattCharacteristic;
import android.bluetooth.BluetoothGattDescriptor;
import android.bluetooth.BluetoothGattService;
import android.bluetooth.BluetoothManager;
import android.bluetooth.BluetoothProfile;
import android.bluetooth.le.ScanCallback;
import android.bluetooth.le.ScanResult;
import android.content.Context;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.os.Binder;
import android.os.Build;
import android.os.Handler;
import android.os.IBinder;
import android.util.Log;
import java.util.ArrayList;
import java.util.List;
import java.util.UUID;
/**
* Created by JunkChen on 2015/9/11 0009.
*/
public class BleService extends Service implements Constants, BleListener {
//Debug
private static final String TAG = BleService.class.getName();
//Member fields
private BluetoothManager mBluetoothManager;
private BluetoothAdapter mBluetoothAdapter;
private BluetoothGatt mBluetoothGatt;
private List<BluetoothDevice> mScanLeDeviceList = new ArrayList<>();
private boolean isScanning;
private boolean isConnect;
private String mBluetoothDeviceAddress;
private int mConnState = STATE_DISCONNECTED;
// Stop scanning after 10 seconds.
private static final long SCAN_PERIOD = 10 * 1000;
private long mScanPeriod;
private OnLeScanListener mOnLeScanListener;
private OnConnectionStateChangeListener mOnConnectionStateChangeListener;
private OnServicesDiscoveredListener mOnServicesDiscoveredListener;
private OnDataAvailableListener mOnDataAvailableListener;
private OnReadRemoteRssiListener mOnReadRemoteRssiListener;
private OnMtuChangedListener mOnMtuChangedListener;
private final IBinder mBinder = new LocalBinder();
private static BleService instance = null;
public BleService() {
instance = this;
Log.d(TAG, "BleService initialized.");
}
public static BleService getInstance() {
if (instance == null) throw new NullPointerException("BleService is not bind.");
return instance;
}
@Override
public IBinder onBind(Intent intent) {
return mBinder;
}
@Override
public boolean onUnbind(Intent intent) {
close();
instance = null;
return super.onUnbind(intent);
}
public class LocalBinder extends Binder {
public BleService getService() {
return BleService.this;
}
}
/**
* Check for your device to support Ble
*
* @return true is support false is not support
*/
public boolean isSupportBle() {
return getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE);
}
/**
* Initializes a reference to the local Bluetooth adapter.
*
* @return If return true, the initialization is successful.
*/
public boolean initialize() {
//For API level 18 and above, get a reference to BluetoothAdapter through BluetoothManager.
if (mBluetoothManager == null) {
mBluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE);
if (mBluetoothManager == null) {
Log.e(TAG, "Unable to initialize BluetoothManager.");
return false;
}
}
mBluetoothAdapter = mBluetoothManager.getAdapter();
if (mBluetoothAdapter == null) {
Log.e(TAG, "Unable to initialize BluetoothAdapter.");
return false;
}
return true;
}
/**
* Turn on or off the local Bluetooth adapter;do not use without explicit
* user action to turn on Bluetooth.
*
* @param enable if open ble
* @return if ble is open return true
*/
public boolean enableBluetooth(boolean enable) {
if (enable) {
if (!mBluetoothAdapter.isEnabled()) {
return mBluetoothAdapter.enable();
}
return true;
} else {
if (mBluetoothAdapter.isEnabled()) {
return mBluetoothAdapter.disable();
}
return false;
}
}
/**
* Return true if Bluetooth is currently enabled and ready for use.
*
* @return true if the local adapter is turned on
*/
public boolean isEnableBluetooth() {
return mBluetoothAdapter.isEnabled();
}
/**
* Scan Ble device.
*
* @param enable If true, start scan ble device.False stop scan.
* @param scanPeriod scan ble period time
*/
public void scanLeDevice(final boolean enable, long scanPeriod) {
if (enable) {
if (isScanning) return;
//Stop scanning after a predefined scan period.
new Handler().postDelayed(new Runnable() {
@Override
public void run() {
isScanning = false;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
mBluetoothAdapter.getBluetoothLeScanner().stopScan(mScanCallback);
} else {
mBluetoothAdapter.stopLeScan(mLeScanCallback);
}
broadcastUpdate(ACTION_SCAN_FINISHED);
mScanLeDeviceList.clear();
}
}, scanPeriod);
mScanLeDeviceList.clear();
isScanning = true;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
mBluetoothAdapter.getBluetoothLeScanner().startScan(mScanCallback);
} else {
mBluetoothAdapter.startLeScan(mLeScanCallback);
}
} else {
isScanning = false;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
mBluetoothAdapter.getBluetoothLeScanner().stopScan(mScanCallback);
} else {
mBluetoothAdapter.stopLeScan(mLeScanCallback);
}
broadcastUpdate(ACTION_SCAN_FINISHED);
mScanLeDeviceList.clear();
}
}
/**
* Scan Ble device.
*
* @param enable If true, start scan ble device.False stop scan.
*/
public void scanLeDevice(boolean enable) {
this.scanLeDevice(enable, SCAN_PERIOD);
}
/**
* If Ble is scaning return true, if not return false.
*
* @return ble whether scanning
*/
public boolean isScanning() {
return isScanning;
}
/**
* Connects to the GATT server hosted on the Bluetooth LE device.
*
* @param address The device address of the destination device.
* @return Return true if the connection is initiated successfully. The connection result
* is reported asynchronously through the BluetoothGattCallback#onConnectionStateChange.
*/
public boolean connect(final String address) {
if (isScanning) scanLeDevice(false);
close();
if (mBluetoothAdapter == null || address == null) {
Log.w(TAG, "BluetoothAdapter not initialized or unspecified address.");
return false;
}
//Previously connected device. Try to reconnect.
if (mBluetoothGatt != null && mBluetoothDeviceAddress != null
&& address.equals(mBluetoothDeviceAddress)) {
Log.d(TAG, "Trying to use an existing mBluetoothGatt for connection.");
if (mBluetoothGatt.connect()) {
mConnState = STATE_CONNECTING;
return true;
} else {
return false;
}
}
final BluetoothDevice device = mBluetoothAdapter.getRemoteDevice(address);
if (device == null) {
Log.w(TAG, "Device not found. Unable to connect.");
return false;
}
//We want to directly connect to the device, so we are setting the autoConnect
// parameter to false.
mBluetoothGatt = device.connectGatt(this, false, mGattCallback);
Log.d(TAG, "Trying to create a new connection.");
mBluetoothDeviceAddress = address;
mConnState = STATE_CONNECTING;
return true;
}
/**
* Disconnects an existing connection or cancel a pending connection. The disconnection result
* is reported asynchronously through the BluetoothGattCallback#onConnectionStateChange.
*/
public void disconnect() {
if (mBluetoothAdapter == null || mBluetoothGatt == null) {
Log.e(TAG, "BluetoothAdapter not initialized.");
return;
}
mBluetoothGatt.disconnect();
}
/**
* After using a given BLE device, the app must call this method to ensure resources are
* released properly.
*/
public void close() {
isConnect = false;
if (mBluetoothGatt == null) {
return;
}
mBluetoothGatt.close();
mBluetoothGatt = null;
}
/**
* Request a read on a given {@code BluetoothGattCharacteristic}. The read result is reported
* asynchronously through the BluetoothGattCallback#onCharacteristicRead.
*
* @param characteristic The characteristic to read from.
*/
public void readCharacteristic(BluetoothGattCharacteristic characteristic) {
if (mBluetoothAdapter == null || mBluetoothGatt == null) {
Log.w(TAG, "BluetoothAdapter not initialized.");
return;
}
mBluetoothGatt.readCharacteristic(characteristic);
}
/**
* Request a read on a given {@code BluetoothGattCharacteristic}, specific service UUID
* and characteristic UUID. The read result is reported asynchronously through the
* {@code BluetoothGattCallback#onCharacteristicRead(android.bluetooth.BluetoothGatt,
* android.bluetooth.BluetoothGattCharacteristic, int)} callback.
*
* @param serviceUUID remote device service uuid
* @param characteristicUUID remote device characteristic uuid
*/
public void readCharacteristic(String serviceUUID, String characteristicUUID) {
if (mBluetoothGatt != null) {
BluetoothGattService service =
mBluetoothGatt.getService(UUID.fromString(serviceUUID));
BluetoothGattCharacteristic characteristic =
service.getCharacteristic(UUID.fromString(characteristicUUID));
mBluetoothGatt.readCharacteristic(characteristic);
}
}
public void readCharacteristic(String address, String serviceUUID, String characteristicUUID) {
if (mBluetoothGatt != null) {
BluetoothGattService service =
mBluetoothGatt.getService(UUID.fromString(serviceUUID));
BluetoothGattCharacteristic characteristic =
service.getCharacteristic(UUID.fromString(characteristicUUID));
mBluetoothGatt.readCharacteristic(characteristic);
}
}
/**
* Write data to characteristic, and send to remote bluetooth le device.
*
* @param serviceUUID remote device service uuid
* @param characteristicUUID remote device characteristic uuid
* @param value Send to remote ble device data.
*/
public void writeCharacteristic(String serviceUUID, String characteristicUUID, String value) {
if (mBluetoothGatt != null) {
BluetoothGattService service =
mBluetoothGatt.getService(UUID.fromString(serviceUUID));
BluetoothGattCharacteristic characteristic =
service.getCharacteristic(UUID.fromString(characteristicUUID));
characteristic.setValue(value);
mBluetoothGatt.writeCharacteristic(characteristic);
}
}
public boolean writeCharacteristic(String serviceUUID, String characteristicUUID, byte[] value) {
if (mBluetoothGatt != null) {
BluetoothGattService service =
mBluetoothGatt.getService(UUID.fromString(serviceUUID));
BluetoothGattCharacteristic characteristic =
service.getCharacteristic(UUID.fromString(characteristicUUID));
characteristic.setValue(value);
return mBluetoothGatt.writeCharacteristic(characteristic);
}
return false;
}
/**
* Write value to characteristic, and send to remote bluetooth le device.
*
* @param characteristic remote device characteristic
* @param value New value for this characteristic
* @return if write success return true
*/
public boolean writeCharacteristic(BluetoothGattCharacteristic characteristic, String value) {
return writeCharacteristic(characteristic, value.getBytes());
}
/**
* Writes a given characteristic and its values to the associated remote device.
*
* @param characteristic remote device characteristic
* @param value New value for this characteristic
* @return if write success return true
*/
public boolean writeCharacteristic(BluetoothGattCharacteristic characteristic, byte[] value) {
if (mBluetoothGatt != null) {
characteristic.setValue(value);
return mBluetoothGatt.writeCharacteristic(characteristic);
}
return false;
}
/**
* Enables or disables notification on a give characteristic.
*
* @param characteristic Characteristic to act on.
* @param enabled If true, enable notification. False otherwise.
*/
public void setCharacteristicNotification(BluetoothGattCharacteristic characteristic,
boolean enabled) {
if (mBluetoothAdapter == null || mBluetoothGatt == null) {
Log.w(TAG, "BluetoothAdapter not initialized");
return;
}
mBluetoothGatt.setCharacteristicNotification(characteristic, enabled);
BluetoothGattDescriptor descriptor = characteristic.getDescriptor(
UUID.fromString(GattAttributes.DESCRIPTOR_CLIENT_CHARACTERISTIC_CONFIGURATION));
descriptor.setValue(enabled ? BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE :
BluetoothGattDescriptor.DISABLE_NOTIFICATION_VALUE);
mBluetoothGatt.writeDescriptor(descriptor);
}
public void setCharacteristicNotification(String serviceUUID, String characteristicUUID,
boolean enabled) {
if (mBluetoothAdapter == null || mBluetoothGatt == null) {
Log.w(TAG, "BluetoothAdapter not initialized");
return;
}
BluetoothGattService service =
mBluetoothGatt.getService(UUID.fromString(serviceUUID));
BluetoothGattCharacteristic characteristic =
service.getCharacteristic(UUID.fromString(characteristicUUID));
mBluetoothGatt.setCharacteristicNotification(characteristic, enabled);
BluetoothGattDescriptor descriptor = characteristic.getDescriptor(
UUID.fromString(GattAttributes.DESCRIPTOR_CLIENT_CHARACTERISTIC_CONFIGURATION));
descriptor.setValue(enabled ? BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE :
BluetoothGattDescriptor.DISABLE_NOTIFICATION_VALUE);
mBluetoothGatt.writeDescriptor(descriptor);
}
/**
* Reads the value for a given descriptor from the associated remote device.
*
* <p>Once the read operation has been completed, the
* {@link BluetoothGattCallback#onDescriptorRead} callback is
* triggered, signaling the result of the operation.
*
* <p>Requires {@link android.Manifest.permission#BLUETOOTH} permission.
*
* @param descriptor Descriptor value to read from the remote device
* @return true, if the read operation was initiated successfully
*/
public boolean readDescriptor(BluetoothGattDescriptor descriptor) {
if (mBluetoothGatt == null) {
Log.w(TAG, "BluetoothGatt is null");
return false;
}
return mBluetoothGatt.readDescriptor(descriptor);
}
/**
* Reads the value for a given descriptor from the associated remote device.
*
* @param serviceUUID remote device service uuid
* @param characteristicUUID remote device characteristic uuid
* @param descriptorUUID remote device descriptor uuid
* @return true, if the read operation was initiated successfully
*/
public boolean readDescriptor(String serviceUUID, String characteristicUUID,
String descriptorUUID) {
if (mBluetoothGatt == null) {
Log.w(TAG, "BluetoothGatt is null");
return false;
}
// try {
BluetoothGattService service =
mBluetoothGatt.getService(UUID.fromString(serviceUUID));
BluetoothGattCharacteristic characteristic =
service.getCharacteristic(UUID.fromString(characteristicUUID));
BluetoothGattDescriptor descriptor =
characteristic.getDescriptor(UUID.fromString(descriptorUUID));
return mBluetoothGatt.readDescriptor(descriptor);
// } catch (Exception e) {
// Log.e(TAG, "read descriptor exception", e);
// return false;
// }
}
/**
* Read the RSSI for a connected remote device.
*
* <p>The {@link BluetoothGattCallback#onReadRemoteRssi} callback will be
* invoked when the RSSI value has been read.
*
* <p>Requires {@link android.Manifest.permission#BLUETOOTH} permission.
*
* @return true, if the RSSI value has been requested successfully
*/
public boolean readRemoteRssi() {
if (mBluetoothGatt == null) return false;
return mBluetoothGatt.readRemoteRssi();
}
/**
* Request an MTU size used for a given connection.
*
* <p>When performing a write request operation (write without response),
* the data sent is truncated to the MTU size. This function may be used
* to request a larger MTU size to be able to send more data at once.
*
* <p>A {@link BluetoothGattCallback#onMtuChanged} callback will indicate
* whether this operation was successful.
*
* <p>Requires {@link Manifest.permission#BLUETOOTH} permission.
*
* @param mtu mtu
* @return true, if the new MTU value has been requested successfully
*/
public boolean requestMtu(int mtu) {
if (mBluetoothGatt == null) return false;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {//Android API level >= 21
return mBluetoothGatt.requestMtu(mtu);
} else {
return false;
}
}
public boolean isConnect() {
return isConnect;
}
public BluetoothDevice getConnectDevice() {
if (mBluetoothGatt == null) return null;
return mBluetoothGatt.getDevice();
}
public BluetoothGatt getBluetoothGatt() {
return mBluetoothGatt;
}
/**
* Retrieves a list of supported GATT services on the connected device. This should be
* invoked only after {@code BluetoothGatt#discoverServices()} completes successfully.
*
* @return A {@code List} of supported services.
*/
public List<BluetoothGattService> getSupportedGattServices() {
if (mBluetoothGatt == null) return null;
return mBluetoothGatt.getServices();
}
public List<BluetoothDevice> getConnectDevices() {
if (mBluetoothManager == null) return null;
return mBluetoothManager.getConnectedDevices(BluetoothProfile.GATT);
}
/**
* Device scan callback.
* <p>
* Use mScanCallback if Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP,
* else use mLeScanCallback.
*/
private ScanCallback mScanCallback;
private BluetoothAdapter.LeScanCallback mLeScanCallback;
{
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
mScanCallback = new ScanCallback() {
@Override
public void onScanResult(int callbackType, ScanResult result) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
if (mScanLeDeviceList.contains(result.getDevice())) return;
mScanLeDeviceList.add(result.getDevice());
if (mOnLeScanListener != null) {
mOnLeScanListener.onLeScan(result.getDevice(), result.getRssi(), result.getScanRecord().getBytes());
}
broadcastUpdate(ACTION_BLUETOOTH_DEVICE, result.getDevice());
Log.i(TAG, "onScanResult: name: " + result.getDevice().getName() +
", address: " + result.getDevice().getAddress() +
", rssi: " + result.getRssi() + ", scanRecord: " + result.getScanRecord());
}
}
};
} else {
mLeScanCallback = new BluetoothAdapter.LeScanCallback() {
@Override
public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord) {
Log.i(TAG, "device name: " + device.getName() + ", address: " + device.getAddress());
if (device == null || mScanLeDeviceList.contains(device)) return;
mScanLeDeviceList.add(device);
if (mOnLeScanListener != null) {
mOnLeScanListener.onLeScan(device, rssi, scanRecord);
}
broadcastUpdate(ACTION_BLUETOOTH_DEVICE, device);
}
};
}
}
/**
* Implements callback methods for GATT events that the app cares about. For example,
* connection change and services discovered.
*/
private final BluetoothGattCallback mGattCallback = new BluetoothGattCallback() {
@Override
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
if (mOnConnectionStateChangeListener != null) {
mOnConnectionStateChangeListener.onConnectionStateChange(gatt, status, newState);
}
String intentAction;
String address = gatt.getDevice().getAddress();
if (newState == BluetoothProfile.STATE_DISCONNECTED) {
Log.i(TAG, "onConnectionStateChange: DISCONNECTED: " + getConnectDevices().size());
intentAction = ACTION_GATT_DISCONNECTED;
isConnect = false;
mConnState = STATE_DISCONNECTED;
Log.i(TAG, "Disconnected from GATT server.");
broadcastUpdate(intentAction, address);
close();
} else if (newState == BluetoothProfile.STATE_CONNECTING) {
Log.i(TAG, "onConnectionStateChange: CONNECTING: " + getConnectDevices().size());
isConnect = false;
intentAction = ACTION_GATT_CONNECTING;
mConnState = STATE_CONNECTING;
Log.i(TAG, "Connecting to GATT server.");
broadcastUpdate(intentAction, address);
} else if (newState == BluetoothProfile.STATE_CONNECTED) {
Log.i(TAG, "onConnectionStateChange: CONNECTED: " + getConnectDevices().size());
intentAction = ACTION_GATT_CONNECTED;
isConnect = true;
mConnState = STATE_CONNECTED;
broadcastUpdate(intentAction, address);
Log.i(TAG, "Connected to GATT server.");
// Attempts to discover services after successful connection.
Log.i(TAG, "Attempting to start service discovery:" +
mBluetoothGatt.discoverServices());
} else if (newState == BluetoothProfile.STATE_DISCONNECTING) {
Log.i(TAG, "onConnectionStateChange: DISCONNECTING: " + getConnectDevices().size());
isConnect = false;
intentAction = ACTION_GATT_DISCONNECTING;
mConnState = STATE_DISCONNECTING;
Log.i(TAG, "Disconnecting from GATT server.");
broadcastUpdate(intentAction, address);
}
}
// New services discovered
@Override
public void onServicesDiscovered(BluetoothGatt gatt, int status) {
if (mOnServicesDiscoveredListener != null) {
mOnServicesDiscoveredListener.onServicesDiscovered(gatt, status);
}
if (status == BluetoothGatt.GATT_SUCCESS) {
broadcastUpdate(ACTION_GATT_SERVICES_DISCOVERED);
} else {
Log.w(TAG, "onServicesDiscovered received: " + status);
}
}
// Result of a characteristic read operation
@Override
public void onCharacteristicRead(BluetoothGatt gatt,
BluetoothGattCharacteristic characteristic, int status) {
if (mOnDataAvailableListener != null) {
mOnDataAvailableListener.onCharacteristicRead(gatt, characteristic, status);
}
}
@Override
public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
super.onCharacteristicWrite(gatt, characteristic, status);
String address = gatt.getDevice().getAddress();
for (int i = 0; i < characteristic.getValue().length; i++) {
Log.i(TAG, "address: " + address + ",Write: " + characteristic.getValue()[i]);
}
}
@Override
public void onCharacteristicChanged(BluetoothGatt gatt,
BluetoothGattCharacteristic characteristic) {
if (mOnDataAvailableListener != null) {
mOnDataAvailableListener.onCharacteristicChanged(gatt, characteristic);
}
}
@Override
public void onDescriptorRead(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) {
if (mOnDataAvailableListener != null) {
mOnDataAvailableListener.onDescriptorRead(gatt, descriptor, status);
}
}
@Override
public void onReadRemoteRssi(BluetoothGatt gatt, int rssi, int status) {
if (mOnReadRemoteRssiListener != null) {
mOnReadRemoteRssiListener.onReadRemoteRssi(gatt, rssi, status);
}
}
@Override
public void onMtuChanged(BluetoothGatt gatt, int mtu, int status) {
if (mOnMtuChangedListener != null) {
mOnMtuChangedListener.onMtuChanged(gatt, mtu, status);
}
}
};
private void broadcastUpdate(final String action) {
final Intent intent = new Intent(action);
sendBroadcast(intent);
}
private void broadcastUpdate(final String action, final String address) {
final Intent intent = new Intent(action);
intent.putExtra("address", address);
sendBroadcast(intent);
}
private void broadcastUpdate(final String action, BluetoothDevice device) {
final Intent intent = new Intent(action);
intent.putExtra("name", device.getName());
intent.putExtra("address", device.getAddress());
sendBroadcast(intent);
}
public void setOnLeScanListener(OnLeScanListener l) {
mOnLeScanListener = l;
}
public void setOnConnectListener(OnConnectionStateChangeListener l) {
mOnConnectionStateChangeListener = l;
}
public void setOnServicesDiscoveredListener(OnServicesDiscoveredListener l) {
mOnServicesDiscoveredListener = l;
}
public void setOnDataAvailableListener(OnDataAvailableListener l) {
mOnDataAvailableListener = l;
}
public void setOnReadRemoteRssiListener(OnReadRemoteRssiListener l) {
mOnReadRemoteRssiListener = l;
}
public void setOnMtuChangedListener(OnMtuChangedListener l) {
mOnMtuChangedListener = l;
}
}
