Android Open Source - MovisensGattSensorExample Bluetooth Le Service






From Project

Back to project page MovisensGattSensorExample.

License

The source code is released under:

GNU General Public License

If you think the Android project MovisensGattSensorExample listed in this page is inappropriate, such as containing malicious code/tools or violating the copyright, please email info at java2s dot com, thanks.

Java Source Code

/*
 * Copyright (C) 2013 The Android Open Source Project
 */*from  w w  w .  jav a  2s  . co m*/
 * 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.movisens.gattsensorexample.services;

import java.util.List;

import android.annotation.TargetApi;
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.content.Context;
import android.content.Intent;
import android.os.Binder;
import android.os.IBinder;
import android.os.ParcelUuid;
import android.util.Log;

import com.movisens.gattsensorexample.utils.BleQueue;
import com.movisens.smartgattlib.Descriptor;

/**
 * Service for managing connection and data communication with a GATT server
 * hosted on a given Bluetooth LE device.
 */
@TargetApi(18)
public class BluetoothLeService extends Service {
  private final static String TAG = BluetoothLeService.class.getSimpleName();

  private BluetoothManager mBluetoothManager;
  private BluetoothAdapter mBluetoothAdapter;
  //private String mBluetoothDeviceAddress;
  private BluetoothGatt mBluetoothGatt;
  private int mConnectionState = STATE_DISCONNECTED;
  private BleQueue bleQueue;

  private static final int STATE_DISCONNECTED = 0;
  private static final int STATE_CONNECTING = 1;
  private static final int STATE_CONNECTED = 2;

  public final static String ACTION_GATT_CONNECTED = "com.movisens.rmssdtrigger.services.BluetoothLeService.ACTION_GATT_CONNECTED";
  public final static String ACTION_GATT_DISCONNECTED = "com.movisens.rmssdtrigger.services.BluetoothLeService.ACTION_GATT_DISCONNECTED";
  public final static String ACTION_GATT_SERVICES_DISCOVERED = "com.movisens.rmssdtrigger.services.BluetoothLeService.ACTION_GATT_SERVICES_DISCOVERED";
  public final static String ACTION_DATA_AVAILABLE = "com.movisens.rmssdtrigger.services.BluetoothLeService.ACTION_DATA_AVAILABLE";
  public final static String EXTRA_DATA = "com.movisens.rmssdtrigger.services.BluetoothLeService.EXTRA_DATA";
  public final static String EXTRA_CHARACTERISTIC = "com.movisens.rmssdtrigger.services.BluetoothLeService.EXTRA_CHARACTERISTIC";
  public final static String ACTION_GATT_SERVICES_ERROR = "com.movisens.rmssdtrigger.services.BluetoothLeService.GATT_SERVICES_ERROR";

  // 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) {
      String intentAction;
      if (status == BluetoothGatt.GATT_SUCCESS) {
        if (newState == BluetoothProfile.STATE_CONNECTED) {
          intentAction = ACTION_GATT_CONNECTED;
          mConnectionState = STATE_CONNECTED;
          broadcastUpdate(intentAction);
          Log.i(TAG, "Connected to GATT server.");
          // Attempts to discover services after successful
          // connection.
          Log.i(TAG,
              "Attempting to start service discovery:"
                  + gatt.discoverServices());

        } else if (newState == BluetoothProfile.STATE_DISCONNECTED) {
          intentAction = ACTION_GATT_DISCONNECTED;
          mConnectionState = STATE_DISCONNECTED;
          Log.i(TAG, "Disconnected from GATT server.");
          broadcastUpdate(intentAction);

          // Necessary to disconnect and close because of Android bug:
          // https://code.google.com/p/android/issues/detail?id=58381#c17
          // http://stackoverflow.com/a/18889509/2616544
          disconnect();
          // close();
        }

      } else {
        // disconnect();
        // close();

        intentAction = ACTION_GATT_SERVICES_ERROR;
        mConnectionState = STATE_DISCONNECTED;
        Log.i(TAG, "Gatt server error, status: " + status
            + ", newState: " + newState);
        broadcastUpdate(intentAction);
      }
    }

    @Override
    public void onServicesDiscovered(BluetoothGatt gatt, int status) {
      if (status == BluetoothGatt.GATT_SUCCESS) {
        broadcastUpdate(ACTION_GATT_SERVICES_DISCOVERED);
      } else {
        Log.w(TAG, "onServicesDiscovered received: " + status);
      }
    }

    @Override
    public void onCharacteristicRead(BluetoothGatt gatt,
        BluetoothGattCharacteristic characteristic, int status) {
      bleQueue.onCharacteristicRead(gatt, characteristic, status);
      if (status == BluetoothGatt.GATT_SUCCESS) {
        broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic);
      }
    }

    @Override
    public void onCharacteristicWrite(BluetoothGatt gatt,
        BluetoothGattCharacteristic characteristic, int status) {
      bleQueue.onCharacteristicWrite(gatt, characteristic, status);
      if (status == BluetoothGatt.GATT_SUCCESS) {
        Log.d(TAG, "Characteristic writing successful");
      } else if (status == BluetoothGatt.GATT_INSUFFICIENT_AUTHENTICATION) {
        // this is where the tricky part comes

        if (gatt.getDevice().getBondState() == BluetoothDevice.BOND_NONE) {
          Log.e(TAG, "Bonding required!!!");
        } else {
          // this situation happens when you try to connect for the
          // second time to already bonded device
          // it should never happen, in my opinion
          Log.e(TAG,
              "The phone is trying to read from paired device without encryption. Android Bug?");
          // I don't know what to do here
          // This error was found on Nexus 7 with KRT16S build of
          // Andorid 4.4. It does not appear on Samsung S4 with
          // Andorid 4.3.
        }
      } else {
        Log.e(TAG, "Error writing characteristic, status: " + status);
      }
    }

    @Override
    public void onDescriptorWrite(BluetoothGatt gatt,
        BluetoothGattDescriptor descriptor, int status) {
      if (status == BluetoothGatt.GATT_SUCCESS) {
        Log.d(TAG, "Discriptor writing successful");
      } else if (status == BluetoothGatt.GATT_INSUFFICIENT_AUTHENTICATION) {
        // this is where the tricky part comes

        if (gatt.getDevice().getBondState() == BluetoothDevice.BOND_NONE) {
          Log.e(TAG, "Bonding required!!!");
        } else {
          // this situation happens when you try to connect for the
          // second time to already bonded device
          // it should never happen, in my opinion
          Log.e(TAG,
              "The phone is trying to read from paired device without encryption. Android Bug?");
          // I don't know what to do here
          // This error was found on Nexus 7 with KRT16S build of
          // Andorid 4.4. It does not appear on Samsung S4 with
          // Andorid 4.3.
        }
      } else {
        Log.e(TAG, "Error writing descriptor, status: " + status);
      }
      bleQueue.onDescriptorWrite(gatt, descriptor, status);
    };

    @Override
    public void onCharacteristicChanged(BluetoothGatt gatt,
        BluetoothGattCharacteristic characteristic) {
      broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic);
    }
  };

  private void broadcastUpdate(final String action) {
    final Intent intent = new Intent(action);
    sendBroadcast(intent);
  }

  private void broadcastUpdate(final String action,
      final BluetoothGattCharacteristic characteristic) {
    final Intent intent = new Intent(action);
    intent.putExtra(EXTRA_DATA, characteristic.getValue());
    intent.putExtra(EXTRA_CHARACTERISTIC,
        new ParcelUuid(characteristic.getUuid()));
    sendBroadcast(intent);
  }

  public class LocalBinder extends Binder {
    public BluetoothLeService getService() {
      return BluetoothLeService.this;
    }
  }

  @Override
  public IBinder onBind(Intent intent) {
    return mBinder;
  }

  @Override
  public boolean onUnbind(Intent intent) {
    // After using a given device, you should make sure that
    // BluetoothGatt.close() is called
    // such that resources are cleaned up properly. In this particular
    // example, close() is
    // invoked when the UI is disconnected from the Service.
    close();
    return super.onUnbind(intent);
  }

  private final IBinder mBinder = new LocalBinder();

  /**
   * Initializes a reference to the local Bluetooth adapter.
   * 
   * @return Return true if 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 obtain a BluetoothAdapter.");
      return false;
    }

    return true;
  }

  /**
   * 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
   *         {@code BluetoothGattCallback#onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int)}
   *         callback.
   */
  public boolean connect(final String address) {
    if (mBluetoothAdapter == null || address == null) {
      Log.w(TAG,
          "BluetoothAdapter not initialized or unspecified address.");
      return false;
    }

    // Previously connected device. Try to reconnect.
    // if (mBluetoothDeviceAddress != null
    // && address.equals(mBluetoothDeviceAddress)
    // && mBluetoothGatt != null) {
    // Log.d(TAG,
    // "Trying to use an existing mBluetoothGatt for connection.");
    // if (mBluetoothGatt.connect()) {
    // mConnectionState = STATE_CONNECTING;
    // return true;
    // } else {
    // return false;
    // }
    // }// else
    // if (mBluetoothDeviceAddress != null
    // && !address.equals(mBluetoothDeviceAddress)
    // && mBluetoothGatt != null) {
    // Log.d(TAG, "Clearing out existing connection");
    // disconnect();
    // close();
    // }

    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);
    bleQueue = new BleQueue(mBluetoothGatt);
    Log.d(TAG, "Trying to create a new connection.");
    //mBluetoothDeviceAddress = address;
    mConnectionState = STATE_CONNECTING;
    return true;
  }

  /**
   * Disconnects an existing connection or cancel a pending connection. The
   * disconnection result is reported asynchronously through the
   * {@code BluetoothGattCallback#onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int)}
   * callback.
   */
  public void disconnect() {
    if (mBluetoothAdapter == null || mBluetoothGatt == null) {
      Log.w(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() {
    if (mBluetoothGatt == null) {
      return;
    }
    mBluetoothGatt.close();
    mBluetoothGatt = null;
  }

  /**
   * Request a read on a given {@code BluetoothGattCharacteristic}. The read
   * result is reported asynchronously through the
   * {@code BluetoothGattCallback#onCharacteristicRead(android.bluetooth.BluetoothGatt, android.bluetooth.BluetoothGattCharacteristic, int)}
   * callback.
   * 
   * @param characteristic
   *            The characteristic to read from.
   */
  public void readCharacteristic(BluetoothGattCharacteristic characteristic) {
    if (mBluetoothAdapter == null || mBluetoothGatt == null) {
      Log.w(TAG, "BluetoothAdapter not initialized");
      return;
    }
    bleQueue.readCharacteristic(characteristic);
  }

  /**
   * Request a read on a given {@code BluetoothGattCharacteristic}. The read
   * result is reported asynchronously through the
   * {@code BluetoothGattCallback#onCharacteristicRead(android.bluetooth.BluetoothGatt, android.bluetooth.BluetoothGattCharacteristic, int)}
   * callback.
   * 
   * @param characteristic
   *            The characteristic to read from.
   */
  public void writeCharacteristic(BluetoothGattCharacteristic characteristic) {
    if (mBluetoothAdapter == null || mBluetoothGatt == null) {
      Log.w(TAG, "BluetoothAdapter not initialized");
      return;
    }
    bleQueue.writeCharacteristic(characteristic);
  }

  /**
   * 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);

    // Is this specific to Heart Rate Measurement?
    BluetoothGattDescriptor descriptor = characteristic
        .getDescriptor(Descriptor.CLIENT_CHARACTERISTIC_CONFIGURATION);
    if (descriptor != null) {
      descriptor
          .setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);
      bleQueue.writeDescriptor(descriptor);
    }
  }

  /**
   * Enables or disables notification on a give characteristic.
   * 
   * @param characteristic
   *            Characteristic to act on.
   * @param enabled
   *            If true, enable notification. False otherwise.
   */
  public void setCharacteristicIndication(
      BluetoothGattCharacteristic characteristic, boolean enabled) {
    if (mBluetoothAdapter == null || mBluetoothGatt == null) {
      Log.w(TAG, "BluetoothAdapter not initialized");
      return;
    }
    mBluetoothGatt.setCharacteristicNotification(characteristic, enabled);

    // Is this specific to Heart Rate Measurement?
    BluetoothGattDescriptor descriptor = characteristic
        .getDescriptor(Descriptor.CLIENT_CHARACTERISTIC_CONFIGURATION);
    if (descriptor != null) {
      descriptor
          .setValue(BluetoothGattDescriptor.ENABLE_INDICATION_VALUE);
      bleQueue.writeDescriptor(descriptor);
    }
  }

  /**
   * 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 boolean isConnected() {
    return mConnectionState == STATE_CONNECTED;
  }

  public static boolean setBluetooth(boolean enable) {
    BluetoothAdapter bluetoothAdapter = BluetoothAdapter
        .getDefaultAdapter();
    boolean isEnabled = bluetoothAdapter.isEnabled();
    if (enable && !isEnabled) {
      return bluetoothAdapter.enable();
    } else if (!enable && isEnabled) {
      return bluetoothAdapter.disable();
    }
    // No need to change bluetooth state
    return true;
  }

  @Override
  public void onDestroy() {
    super.onDestroy();

    disconnect();
    close();
  }
}




Java Source Code List

com.movisens.gattsensorexample.activities.DeviceScanActivity.java
com.movisens.gattsensorexample.activities.Preferences.java
com.movisens.gattsensorexample.activities.SensorConnected.java
com.movisens.gattsensorexample.activities.SensorDisconnected.java
com.movisens.gattsensorexample.activities.StartActivity.java
com.movisens.gattsensorexample.activities.TimePreference.java
com.movisens.gattsensorexample.application.App.java
com.movisens.gattsensorexample.events.BLEEvent.java
com.movisens.gattsensorexample.events.MeasurementStatus.java
com.movisens.gattsensorexample.events.SensorStatusEvent.java
com.movisens.gattsensorexample.model.CurrentSensorData.java
com.movisens.gattsensorexample.receivers.SystemStateReceiver.java
com.movisens.gattsensorexample.receivers.UpdateAppReceiver.java
com.movisens.gattsensorexample.sensors.MovisensSensor.java
com.movisens.gattsensorexample.services.BluetoothLeService.java
com.movisens.gattsensorexample.services.SamplingService.java
com.movisens.gattsensorexample.utils.BleQueue.java
com.movisens.gattsensorexample.utils.BleUtils.java