dinislage/Bluetooth-LE-Library-Android
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Started rewriting the Gatt Screen UI

Browse Source
This commit is contained in:
Alexandros Schillings
2014-04-28 16:42:12 +01:00
parent cf48721d77
commit 131ab06bfb
5 changed files with 550 additions and 536 deletions
Download Patch File Download Diff File Expand all files Collapse all files
sample_app/res/layout/activity_gatt_services.xml
+76 -50
View File
@@ -14,86 +14,112 @@
See the License for the specific language governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.
--> -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent" android:layout_width="match_parent"
android:layout_height="wrap_content" android:layout_height="match_parent"
android:layout_margin="10dp" android:orientation="vertical"
android:orientation="vertical" > android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin" >
<LinearLayout <GridLayout
android:id="@+id/deviceInformation"
android:layout_width="match_parent" android:layout_width="match_parent"
android:layout_height="wrap_content" android:layout_height="wrap_content"
android:layout_margin="10dp" android:layout_alignParentTop="true"
android:orientation="horizontal" > android:columnCount="2"
android:useDefaultMargins="true" >
<TextView <TextView
style="@style/GridLayoutTitleTextView"
android:layout_width="wrap_content" android:layout_width="wrap_content"
android:layout_height="wrap_content" android:layout_height="wrap_content"
android:text="@string/label_device_address" android:text="@string/label_device_address" />
android:textSize="18sp" />
<Space
android:layout_width="5dp"
android:layout_height="wrap_content" />
<TextView <TextView
android:id="@+id/device_address" android:id="@+id/device_address"
android:layout_width="match_parent" style="@style/GridLayoutDataTextView" />
android:layout_height="wrap_content"
android:textSize="18sp" />
</LinearLayout>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_margin="10dp"
android:orientation="horizontal" >
<TextView <TextView
style="@style/GridLayoutTitleTextView"
android:layout_width="wrap_content" android:layout_width="wrap_content"
android:layout_height="wrap_content" android:layout_height="wrap_content"
android:text="@string/label_state" android:text="@string/label_state" />
android:textSize="18sp" />
<Space
android:layout_width="5dp"
android:layout_height="wrap_content" />
<TextView <TextView
android:id="@+id/connection_state" android:id="@+id/connection_state"
android:layout_width="match_parent" style="@style/GridLayoutDataTextView" />
android:layout_height="wrap_content" </GridLayout>
android:text="@string/disconnected"
android:textSize="18sp" />
</LinearLayout>
<LinearLayout <View
android:id="@+id/upperSepparator"
android:layout_width="match_parent"
android:layout_height="1dp"
android:layout_below="@id/deviceInformation"
android:background="@android:color/holo_blue_dark" />
<GridLayout
android:id="@+id/gattInformation"
android:layout_width="match_parent" android:layout_width="match_parent"
android:layout_height="wrap_content" android:layout_height="wrap_content"
android:layout_margin="10dp" android:layout_alignParentBottom="true"
android:orientation="horizontal" > android:columnCount="2"
android:useDefaultMargins="true" >
<TextView <TextView
style="@style/GridLayoutTitleTextView"
android:layout_width="wrap_content" android:layout_width="wrap_content"
android:layout_height="wrap_content" android:layout_height="wrap_content"
android:text="@string/label_data" android:text="@string/label_uuid" />
android:textSize="18sp" />
<Space
android:layout_width="5dp"
android:layout_height="wrap_content" />
<TextView <TextView
android:id="@+id/data_value" android:id="@+id/uuid"
android:layout_width="match_parent" style="@style/GridLayoutDataTextViewMonospace" />
<TextView
style="@style/GridLayoutTitleTextView"
android:layout_width="wrap_content"
android:layout_height="wrap_content" android:layout_height="wrap_content"
android:text="@string/no_data" android:text="@string/label_desc" />
android:textSize="18sp" />
</LinearLayout> <TextView
android:id="@+id/description"
style="@style/GridLayoutDataTextViewMonospace" />
<TextView
style="@style/GridLayoutTitleTextView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/label_as_string" />
<TextView
android:id="@+id/data_as_string"
style="@style/GridLayoutDataTextViewMonospace" />
<TextView
style="@style/GridLayoutTitleTextView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/label_as_array" />
<TextView
android:id="@+id/data_as_array"
style="@style/GridLayoutDataTextViewMonospace" />
</GridLayout>
<View
android:id="@+id/lowerSepparator"
android:layout_width="match_parent"
android:layout_height="1dp"
android:layout_above="@id/gattInformation"
android:background="@android:color/holo_blue_dark" />
<ExpandableListView <ExpandableListView
android:id="@+id/gatt_services_list" android:id="@+id/gatt_services_list"
android:layout_width="match_parent" android:layout_width="match_parent"
android:layout_height="wrap_content" /> android:layout_height="fill_parent"
android:layout_above="@id/lowerSepparator"
android:layout_below="@id/upperSepparator" />
</LinearLayout> </RelativeLayout>
sample_app/res/layout/list_item_view_adrecord.xml
+2 -2
View File
@@ -23,7 +23,7 @@
style="@style/GridLayoutTitleTextView" style="@style/GridLayoutTitleTextView"
android:layout_width="wrap_content" android:layout_width="wrap_content"
android:layout_height="wrap_content" android:layout_height="wrap_content"
android:text="As String:" /> android:text="@string/label_as_string" />
<TextView <TextView
android:id="@+id/data_as_string" android:id="@+id/data_as_string"
@@ -33,7 +33,7 @@
style="@style/GridLayoutTitleTextView" style="@style/GridLayoutTitleTextView"
android:layout_width="wrap_content" android:layout_width="wrap_content"
android:layout_height="wrap_content" android:layout_height="wrap_content"
android:text="As Array:" /> android:text="@string/label_as_array" />
<TextView <TextView
android:id="@+id/data_as_array" android:id="@+id/data_as_array"
sample_app/res/values/strings.xml
+3
View File
@@ -51,5 +51,8 @@
<string name="header_device_info">Device Info</string> <string name="header_device_info">Device Info</string>
<string name="invalid_device_data">Invalid Device Data!</string> <string name="invalid_device_data">Invalid Device Data!</string>
<string name="unknown">unknown</string> <string name="unknown">unknown</string>
<string name="label_as_string">As String:</string>
<string name="label_as_array">As Array:</string>
<string name="label_desc">Desc:</string>
</resources> </resources>
sample_app/src/uk/co/alt236/btlescan/activities/DeviceControlActivity.java
+260 -234
View File
@@ -19,8 +19,10 @@ package uk.co.alt236.btlescan.activities;
import java.util.ArrayList; import java.util.ArrayList;
import java.util.HashMap; import java.util.HashMap;
import java.util.List; import java.util.List;
import java.util.Map;
import uk.co.alt236.bluetoothlelib.resolvers.GattAttributeResolver; import uk.co.alt236.bluetoothlelib.resolvers.GattAttributeResolver;
import uk.co.alt236.bluetoothlelib.util.ByteUtils;
import uk.co.alt236.btlescan.R; import uk.co.alt236.btlescan.R;
import uk.co.alt236.btlescan.services.BluetoothLeService; import uk.co.alt236.btlescan.services.BluetoothLeService;
import android.app.Activity; import android.app.Activity;
@@ -41,6 +43,8 @@ import android.view.View;
import android.widget.ExpandableListView; import android.widget.ExpandableListView;
import android.widget.SimpleExpandableListAdapter; import android.widget.SimpleExpandableListAdapter;
import android.widget.TextView; import android.widget.TextView;
import butterknife.ButterKnife;
import butterknife.InjectView;
/** /**
* For a given BLE device, this Activity provides the user interface to connect, display data, * For a given BLE device, this Activity provides the user interface to connect, display data,
@@ -49,264 +53,286 @@ import android.widget.TextView;
* Bluetooth LE API. * Bluetooth LE API.
*/ */
public class DeviceControlActivity extends Activity { public class DeviceControlActivity extends Activity {
private final static String TAG = DeviceControlActivity.class.getSimpleName(); private final static String TAG = DeviceControlActivity.class.getSimpleName();
public static final String EXTRAS_DEVICE_NAME = "DEVICE_NAME"; public static final String EXTRAS_DEVICE_NAME = "DEVICE_NAME";
public static final String EXTRAS_DEVICE_ADDRESS = "DEVICE_ADDRESS"; public static final String EXTRAS_DEVICE_ADDRESS = "DEVICE_ADDRESS";
private TextView mConnectionState; private static final String LIST_NAME = "NAME";
private TextView mDataField; private static final String LIST_UUID = "UUID";
private String mDeviceName;
private String mDeviceAddress;
private ExpandableListView mGattServicesList;
private BluetoothLeService mBluetoothLeService;
private ArrayList<ArrayList<BluetoothGattCharacteristic>> mGattCharacteristics =
new ArrayList<ArrayList<BluetoothGattCharacteristic>>();
private boolean mConnected = false;
private BluetoothGattCharacteristic mNotifyCharacteristic;
private final String LIST_NAME = "NAME"; private BluetoothGattCharacteristic mNotifyCharacteristic;
private final String LIST_UUID = "UUID"; private BluetoothLeService mBluetoothLeService;
private List<List<BluetoothGattCharacteristic>> mGattCharacteristics = new ArrayList<List<BluetoothGattCharacteristic>>();
private String mDeviceAddress;
private String mDeviceName;
// Code to manage Service lifecycle. @InjectView(R.id.gatt_services_list) ExpandableListView mGattServicesList;
private final ServiceConnection mServiceConnection = new ServiceConnection() { @InjectView(R.id.connection_state) TextView mConnectionState;
@Override @InjectView(R.id.uuid) TextView mGattUUID;
public void onServiceConnected(ComponentName componentName, IBinder service) { @InjectView(R.id.description) TextView mGattUUIDDesc;
mBluetoothLeService = ((BluetoothLeService.LocalBinder) service).getService(); @InjectView(R.id.data_as_string) TextView mDataAsString;
if (!mBluetoothLeService.initialize()) { @InjectView(R.id.data_as_array) TextView mDataAsArray;
Log.e(TAG, "Unable to initialize Bluetooth");
finish();
}
// Automatically connects to the device upon successful start-up initialization.
mBluetoothLeService.connect(mDeviceAddress);
}
@Override private boolean mConnected = false;
public void onServiceDisconnected(ComponentName componentName) {
mBluetoothLeService = null;
}
};
// Handles various events fired by the Service. // Code to manage Service lifecycle.
// ACTION_GATT_CONNECTED: connected to a GATT server. private final ServiceConnection mServiceConnection = new ServiceConnection() {
// ACTION_GATT_DISCONNECTED: disconnected from a GATT server. @Override
// ACTION_GATT_SERVICES_DISCOVERED: discovered GATT services. public void onServiceConnected(ComponentName componentName, IBinder service) {
// ACTION_DATA_AVAILABLE: received data from the device. This can be a result of read mBluetoothLeService = ((BluetoothLeService.LocalBinder) service).getService();
// or notification operations. if (!mBluetoothLeService.initialize()) {
private final BroadcastReceiver mGattUpdateReceiver = new BroadcastReceiver() { Log.e(TAG, "Unable to initialize Bluetooth");
@Override finish();
public void onReceive(Context context, Intent intent) { }
final String action = intent.getAction(); // Automatically connects to the device upon successful start-up initialization.
if (BluetoothLeService.ACTION_GATT_CONNECTED.equals(action)) { mBluetoothLeService.connect(mDeviceAddress);
mConnected = true; }
updateConnectionState(R.string.connected);
invalidateOptionsMenu();
} else if (BluetoothLeService.ACTION_GATT_DISCONNECTED.equals(action)) {
mConnected = false;
updateConnectionState(R.string.disconnected);
invalidateOptionsMenu();
clearUI();
} else if (BluetoothLeService.ACTION_GATT_SERVICES_DISCOVERED.equals(action)) {
// Show all the supported services and characteristics on the user interface.
displayGattServices(mBluetoothLeService.getSupportedGattServices());
} else if (BluetoothLeService.ACTION_DATA_AVAILABLE.equals(action)) {
displayData(intent.getStringExtra(BluetoothLeService.EXTRA_DATA));
}
}
};
// If a given GATT characteristic is selected, check for supported features. This sample @Override
// demonstrates 'Read' and 'Notify' features. See public void onServiceDisconnected(ComponentName componentName) {
// http://d.android.com/reference/android/bluetooth/BluetoothGatt.html for the complete mBluetoothLeService = null;
// list of supported characteristic features. }
private final ExpandableListView.OnChildClickListener servicesListClickListner = };
new ExpandableListView.OnChildClickListener() {
@Override
public boolean onChildClick(ExpandableListView parent, View v, int groupPosition,
int childPosition, long id) {
if (mGattCharacteristics != null) {
final BluetoothGattCharacteristic characteristic =
mGattCharacteristics.get(groupPosition).get(childPosition);
final int charaProp = characteristic.getProperties();
if ((charaProp | BluetoothGattCharacteristic.PROPERTY_READ) > 0) {
// If there is an active notification on a characteristic, clear
// it first so it doesn't update the data field on the user interface.
if (mNotifyCharacteristic != null) {
mBluetoothLeService.setCharacteristicNotification(
mNotifyCharacteristic, false);
mNotifyCharacteristic = null;
}
mBluetoothLeService.readCharacteristic(characteristic);
}
if ((charaProp | BluetoothGattCharacteristic.PROPERTY_NOTIFY) > 0) {
mNotifyCharacteristic = characteristic;
mBluetoothLeService.setCharacteristicNotification(
characteristic, true);
}
return true;
}
return false;
}
};
private void clearUI() { // Handles various events fired by the Service.
mGattServicesList.setAdapter((SimpleExpandableListAdapter) null); // ACTION_GATT_CONNECTED: connected to a GATT server.
mDataField.setText(R.string.no_data); // ACTION_GATT_DISCONNECTED: disconnected from a GATT server.
} // ACTION_GATT_SERVICES_DISCOVERED: discovered GATT services.
// ACTION_DATA_AVAILABLE: received data from the device.
// this can be a result of read or notification operations.
private final BroadcastReceiver mGattUpdateReceiver = new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
final String action = intent.getAction();
if (BluetoothLeService.ACTION_GATT_CONNECTED.equals(action)) {
mConnected = true;
updateConnectionState(R.string.connected);
invalidateOptionsMenu();
} else if (BluetoothLeService.ACTION_GATT_DISCONNECTED.equals(action)) {
mConnected = false;
updateConnectionState(R.string.disconnected);
invalidateOptionsMenu();
clearUI();
} else if (BluetoothLeService.ACTION_GATT_SERVICES_DISCOVERED.equals(action)) {
// Show all the supported services and characteristics on the user interface.
displayGattServices(mBluetoothLeService.getSupportedGattServices());
} else if (BluetoothLeService.ACTION_DATA_AVAILABLE.equals(action)) {
final String noData = getString(R.string.no_data);
final String uuid = intent.getStringExtra(BluetoothLeService.EXTRA_UUID_CHAR);
final byte[] dataArr = intent.getByteArrayExtra(BluetoothLeService.EXTRA_DATA_RAW);
@Override mGattUUID.setText(tryString(uuid, noData));
public void onCreate(Bundle savedInstanceState) { mGattUUIDDesc.setText(GattAttributeResolver.getAttributeName(uuid, getString(R.string.unknown)));
super.onCreate(savedInstanceState); mDataAsArray.setText(ByteUtils.byteArrayToHexString(dataArr));
setContentView(R.layout.activity_gatt_services); mDataAsString.setText(new String(dataArr));
}
}
};
final Intent intent = getIntent(); // If a given GATT characteristic is selected, check for supported features. This sample
mDeviceName = intent.getStringExtra(EXTRAS_DEVICE_NAME); // demonstrates 'Read' and 'Notify' features. See
mDeviceAddress = intent.getStringExtra(EXTRAS_DEVICE_ADDRESS); // http://d.android.com/reference/android/bluetooth/BluetoothGatt.html for the complete
// list of supported characteristic features.
private final ExpandableListView.OnChildClickListener servicesListClickListner = new ExpandableListView.OnChildClickListener() {
@Override
public boolean onChildClick(ExpandableListView parent, View v, int groupPosition, int childPosition, long id) {
if (mGattCharacteristics != null) {
final BluetoothGattCharacteristic characteristic = mGattCharacteristics.get(groupPosition).get(childPosition);
final int charaProp = characteristic.getProperties();
if ((charaProp | BluetoothGattCharacteristic.PROPERTY_READ) > 0) {
// If there is an active notification on a characteristic, clear
// it first so it doesn't update the data field on the user interface.
if (mNotifyCharacteristic != null) {
mBluetoothLeService.setCharacteristicNotification(mNotifyCharacteristic, false);
mNotifyCharacteristic = null;
}
mBluetoothLeService.readCharacteristic(characteristic);
}
if ((charaProp | BluetoothGattCharacteristic.PROPERTY_NOTIFY) > 0) {
mNotifyCharacteristic = characteristic;
mBluetoothLeService.setCharacteristicNotification(characteristic, true);
}
return true;
}
return false;
}
};
// Sets up UI references.
((TextView) findViewById(R.id.device_address)).setText(mDeviceAddress);
mGattServicesList = (ExpandableListView) findViewById(R.id.gatt_services_list);
mGattServicesList.setOnChildClickListener(servicesListClickListner);
mConnectionState = (TextView) findViewById(R.id.connection_state);
mDataField = (TextView) findViewById(R.id.data_value);
getActionBar().setTitle(mDeviceName); private void clearUI() {
getActionBar().setDisplayHomeAsUpEnabled(true); mGattServicesList.setAdapter((SimpleExpandableListAdapter) null);
Intent gattServiceIntent = new Intent(this, BluetoothLeService.class); mGattUUID.setText(R.string.no_data);
bindService(gattServiceIntent, mServiceConnection, BIND_AUTO_CREATE); mGattUUIDDesc.setText(R.string.no_data);
} mDataAsArray.setText(R.string.no_data);
mDataAsString.setText(R.string.no_data);
@Override }
protected void onResume() {
super.onResume();
registerReceiver(mGattUpdateReceiver, makeGattUpdateIntentFilter());
if (mBluetoothLeService != null) {
final boolean result = mBluetoothLeService.connect(mDeviceAddress);
Log.d(TAG, "Connect request result=" + result);
}
}
@Override // Demonstrates how to iterate through the supported GATT Services/Characteristics.
protected void onPause() { // In this sample, we populate the data structure that is bound to the ExpandableListView
super.onPause(); // on the UI.
unregisterReceiver(mGattUpdateReceiver); private void displayGattServices(List<BluetoothGattService> gattServices) {
} if (gattServices == null) return;
String uuid = null;
final String unknownServiceString = getResources().getString(R.string.unknown_service);
final String unknownCharaString = getResources().getString(R.string.unknown_characteristic);
final List<Map<String, String>> gattServiceData = new ArrayList<Map<String, String>>();
final List<List<Map<String, String>>> gattCharacteristicData = new ArrayList<List<Map<String, String>>>();
mGattCharacteristics = new ArrayList<List<BluetoothGattCharacteristic>>();
@Override // Loops through available GATT Services.
protected void onDestroy() { for (BluetoothGattService gattService : gattServices) {
super.onDestroy(); final Map<String, String> currentServiceData = new HashMap<String, String>();
unbindService(mServiceConnection); uuid = gattService.getUuid().toString();
mBluetoothLeService = null; currentServiceData.put(LIST_NAME, GattAttributeResolver.getAttributeName(uuid, unknownServiceString));
} currentServiceData.put(LIST_UUID, uuid);
gattServiceData.add(currentServiceData);
@Override final List<Map<String, String>> gattCharacteristicGroupData = new ArrayList<Map<String, String>>();
public boolean onCreateOptionsMenu(Menu menu) { final List<BluetoothGattCharacteristic> gattCharacteristics = gattService.getCharacteristics();
getMenuInflater().inflate(R.menu.gatt_services, menu); final List<BluetoothGattCharacteristic> charas = new ArrayList<BluetoothGattCharacteristic>();
if (mConnected) {
menu.findItem(R.id.menu_connect).setVisible(false);
menu.findItem(R.id.menu_disconnect).setVisible(true);
} else {
menu.findItem(R.id.menu_connect).setVisible(true);
menu.findItem(R.id.menu_disconnect).setVisible(false);
}
return true;
}
@Override // Loops through available Characteristics.
public boolean onOptionsItemSelected(MenuItem item) { for (final BluetoothGattCharacteristic gattCharacteristic : gattCharacteristics) {
switch(item.getItemId()) { charas.add(gattCharacteristic);
case R.id.menu_connect: final Map<String, String> currentCharaData = new HashMap<String, String>();
mBluetoothLeService.connect(mDeviceAddress); uuid = gattCharacteristic.getUuid().toString();
return true; currentCharaData.put(LIST_NAME, GattAttributeResolver.getAttributeName(uuid, unknownCharaString));
case R.id.menu_disconnect: currentCharaData.put(LIST_UUID, uuid);
mBluetoothLeService.disconnect(); gattCharacteristicGroupData.add(currentCharaData);
return true; }
case android.R.id.home: mGattCharacteristics.add(charas);
onBackPressed(); gattCharacteristicData.add(gattCharacteristicGroupData);
return true; }
}
return super.onOptionsItemSelected(item);
}
private void updateConnectionState(final int resourceId) { final SimpleExpandableListAdapter gattServiceAdapter = new SimpleExpandableListAdapter(
runOnUiThread(new Runnable() { this,
@Override gattServiceData,
public void run() { android.R.layout.simple_expandable_list_item_2,
mConnectionState.setText(resourceId); new String[] {LIST_NAME, LIST_UUID},
} new int[] { android.R.id.text1, android.R.id.text2 },
}); gattCharacteristicData,
} android.R.layout.simple_expandable_list_item_2,
new String[] {LIST_NAME, LIST_UUID},
new int[] { android.R.id.text1, android.R.id.text2 }
);
mGattServicesList.setAdapter(gattServiceAdapter);
}
private void displayData(String data) { @Override
if (data != null) { public void onCreate(Bundle savedInstanceState) {
mDataField.setText(data); super.onCreate(savedInstanceState);
} setContentView(R.layout.activity_gatt_services);
}
// Demonstrates how to iterate through the supported GATT Services/Characteristics. final Intent intent = getIntent();
// In this sample, we populate the data structure that is bound to the ExpandableListView mDeviceName = intent.getStringExtra(EXTRAS_DEVICE_NAME);
// on the UI. mDeviceAddress = intent.getStringExtra(EXTRAS_DEVICE_ADDRESS);
private void displayGattServices(List<BluetoothGattService> gattServices) {
if (gattServices == null) return;
String uuid = null;
String unknownServiceString = getResources().getString(R.string.unknown_service);
String unknownCharaString = getResources().getString(R.string.unknown_characteristic);
ArrayList<HashMap<String, String>> gattServiceData = new ArrayList<HashMap<String, String>>();
ArrayList<ArrayList<HashMap<String, String>>> gattCharacteristicData
= new ArrayList<ArrayList<HashMap<String, String>>>();
mGattCharacteristics = new ArrayList<ArrayList<BluetoothGattCharacteristic>>();
// Loops through available GATT Services. ButterKnife.inject(this);
for (BluetoothGattService gattService : gattServices) {
HashMap<String, String> currentServiceData = new HashMap<String, String>();
uuid = gattService.getUuid().toString();
currentServiceData.put(
LIST_NAME, GattAttributeResolver.getAttributeName(uuid, unknownServiceString));
currentServiceData.put(LIST_UUID, uuid);
gattServiceData.add(currentServiceData);
ArrayList<HashMap<String, String>> gattCharacteristicGroupData = // Sets up UI references.
new ArrayList<HashMap<String, String>>(); ((TextView) findViewById(R.id.device_address)).setText(mDeviceAddress);
List<BluetoothGattCharacteristic> gattCharacteristics = mGattServicesList.setOnChildClickListener(servicesListClickListner);
gattService.getCharacteristics();
ArrayList<BluetoothGattCharacteristic> charas =
new ArrayList<BluetoothGattCharacteristic>();
// Loops through available Characteristics. getActionBar().setTitle(mDeviceName);
for (BluetoothGattCharacteristic gattCharacteristic : gattCharacteristics) { getActionBar().setDisplayHomeAsUpEnabled(true);
charas.add(gattCharacteristic);
HashMap<String, String> currentCharaData = new HashMap<String, String>();
uuid = gattCharacteristic.getUuid().toString();
currentCharaData.put(
LIST_NAME, GattAttributeResolver.getAttributeName(uuid, unknownCharaString));
currentCharaData.put(LIST_UUID, uuid);
gattCharacteristicGroupData.add(currentCharaData);
}
mGattCharacteristics.add(charas);
gattCharacteristicData.add(gattCharacteristicGroupData);
}
SimpleExpandableListAdapter gattServiceAdapter = new SimpleExpandableListAdapter( final Intent gattServiceIntent = new Intent(this, BluetoothLeService.class);
this, bindService(gattServiceIntent, mServiceConnection, BIND_AUTO_CREATE);
gattServiceData, }
android.R.layout.simple_expandable_list_item_2,
new String[] {LIST_NAME, LIST_UUID},
new int[] { android.R.id.text1, android.R.id.text2 },
gattCharacteristicData,
android.R.layout.simple_expandable_list_item_2,
new String[] {LIST_NAME, LIST_UUID},
new int[] { android.R.id.text1, android.R.id.text2 }
);
mGattServicesList.setAdapter(gattServiceAdapter);
}
private static IntentFilter makeGattUpdateIntentFilter() { @Override
final IntentFilter intentFilter = new IntentFilter(); public boolean onCreateOptionsMenu(Menu menu) {
intentFilter.addAction(BluetoothLeService.ACTION_GATT_CONNECTED); getMenuInflater().inflate(R.menu.gatt_services, menu);
intentFilter.addAction(BluetoothLeService.ACTION_GATT_DISCONNECTED); if (mConnected) {
intentFilter.addAction(BluetoothLeService.ACTION_GATT_SERVICES_DISCOVERED); menu.findItem(R.id.menu_connect).setVisible(false);
intentFilter.addAction(BluetoothLeService.ACTION_DATA_AVAILABLE); menu.findItem(R.id.menu_disconnect).setVisible(true);
return intentFilter; } else {
} menu.findItem(R.id.menu_connect).setVisible(true);
menu.findItem(R.id.menu_disconnect).setVisible(false);
}
return true;
}
@Override
protected void onDestroy() {
super.onDestroy();
unbindService(mServiceConnection);
mBluetoothLeService = null;
}
@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch(item.getItemId()) {
case R.id.menu_connect:
mBluetoothLeService.connect(mDeviceAddress);
return true;
case R.id.menu_disconnect:
mBluetoothLeService.disconnect();
return true;
case android.R.id.home:
onBackPressed();
return true;
}
return super.onOptionsItemSelected(item);
}
@Override
protected void onPause() {
super.onPause();
unregisterReceiver(mGattUpdateReceiver);
}
@Override
protected void onResume() {
super.onResume();
registerReceiver(mGattUpdateReceiver, makeGattUpdateIntentFilter());
if (mBluetoothLeService != null) {
final boolean result = mBluetoothLeService.connect(mDeviceAddress);
Log.d(TAG, "Connect request result=" + result);
}
}
private void updateConnectionState(final int resourceId) {
runOnUiThread(new Runnable() {
@Override
public void run() {
final int colourId;
switch(resourceId){
case R.string.connected:
colourId = android.R.color.holo_green_dark;
break;
case R.string.disconnected:
colourId = android.R.color.holo_red_dark;
break;
default:
colourId = android.R.color.black;
break;
}
mConnectionState.setText(resourceId);
mConnectionState.setTextColor(getResources().getColor(colourId));
}
});
}
private static IntentFilter makeGattUpdateIntentFilter() {
final IntentFilter intentFilter = new IntentFilter();
intentFilter.addAction(BluetoothLeService.ACTION_GATT_CONNECTED);
intentFilter.addAction(BluetoothLeService.ACTION_GATT_DISCONNECTED);
intentFilter.addAction(BluetoothLeService.ACTION_GATT_SERVICES_DISCOVERED);
intentFilter.addAction(BluetoothLeService.ACTION_DATA_AVAILABLE);
return intentFilter;
}
private static String tryString(String string, String fallback){
if(string == null){
return fallback;
} else{
return string;
}
}
} }
sample_app/src/uk/co/alt236/btlescan/services/BluetoothLeService.java
+209 -250
View File
@@ -17,16 +17,13 @@
package uk.co.alt236.btlescan.services; package uk.co.alt236.btlescan.services;
import java.util.List; import java.util.List;
import java.util.UUID;
import uk.co.alt236.bluetoothlelib.resolvers.GattAttributeResolver;
import android.app.Service; import android.app.Service;
import android.bluetooth.BluetoothAdapter; import android.bluetooth.BluetoothAdapter;
import android.bluetooth.BluetoothDevice; import android.bluetooth.BluetoothDevice;
import android.bluetooth.BluetoothGatt; import android.bluetooth.BluetoothGatt;
import android.bluetooth.BluetoothGattCallback; import android.bluetooth.BluetoothGattCallback;
import android.bluetooth.BluetoothGattCharacteristic; import android.bluetooth.BluetoothGattCharacteristic;
import android.bluetooth.BluetoothGattDescriptor;
import android.bluetooth.BluetoothGattService; import android.bluetooth.BluetoothGattService;
import android.bluetooth.BluetoothManager; import android.bluetooth.BluetoothManager;
import android.bluetooth.BluetoothProfile; import android.bluetooth.BluetoothProfile;
@@ -41,280 +38,242 @@ import android.util.Log;
* given Bluetooth LE device. * given Bluetooth LE device.
*/ */
public class BluetoothLeService extends Service { public class BluetoothLeService extends Service {
private final static String TAG = BluetoothLeService.class.getSimpleName(); private final static String TAG = BluetoothLeService.class.getSimpleName();
private BluetoothManager mBluetoothManager; private BluetoothManager mBluetoothManager;
private BluetoothAdapter mBluetoothAdapter; private BluetoothAdapter mBluetoothAdapter;
private String mBluetoothDeviceAddress; private String mBluetoothDeviceAddress;
private BluetoothGatt mBluetoothGatt; private BluetoothGatt mBluetoothGatt;
private int mConnectionState = STATE_DISCONNECTED; private int mConnectionState = STATE_DISCONNECTED;
private static final int STATE_DISCONNECTED = 0; private static final int STATE_DISCONNECTED = 0;
private static final int STATE_CONNECTING = 1; private static final int STATE_CONNECTING = 1;
private static final int STATE_CONNECTED = 2; private static final int STATE_CONNECTED = 2;
public final static String ACTION_GATT_CONNECTED = public final static String ACTION_GATT_CONNECTED = "com.example.bluetooth.le.ACTION_GATT_CONNECTED";
"com.example.bluetooth.le.ACTION_GATT_CONNECTED"; public final static String ACTION_GATT_DISCONNECTED = "com.example.bluetooth.le.ACTION_GATT_DISCONNECTED";
public final static String ACTION_GATT_DISCONNECTED = public final static String ACTION_GATT_SERVICES_DISCOVERED = "com.example.bluetooth.le.ACTION_GATT_SERVICES_DISCOVERED";
"com.example.bluetooth.le.ACTION_GATT_DISCONNECTED"; public final static String ACTION_DATA_AVAILABLE = "com.example.bluetooth.le.ACTION_DATA_AVAILABLE";
public final static String ACTION_GATT_SERVICES_DISCOVERED = public final static String EXTRA_DATA_RAW = "com.example.bluetooth.le.EXTRA_DATA_RAW";
"com.example.bluetooth.le.ACTION_GATT_SERVICES_DISCOVERED"; public final static String EXTRA_UUID_CHAR = "com.example.bluetooth.le.EXTRA_UUID_CHAR";
public final static String ACTION_DATA_AVAILABLE =
"com.example.bluetooth.le.ACTION_DATA_AVAILABLE";
public final static String EXTRA_DATA =
"com.example.bluetooth.le.EXTRA_DATA";
public final static UUID UUID_HEART_RATE_MEASUREMENT = // Implements callback methods for GATT events that the app cares about. For example,
UUID.fromString(GattAttributeResolver.HEART_RATE_MEASUREMENT); // connection change and services discovered.
private final BluetoothGattCallback mGattCallback = new BluetoothGattCallback() {
@Override
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) {
String intentAction;
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:" + mBluetoothGatt.discoverServices());
// Implements callback methods for GATT events that the app cares about. For example, } else if (newState == BluetoothProfile.STATE_DISCONNECTED) {
// connection change and services discovered. intentAction = ACTION_GATT_DISCONNECTED;
private final BluetoothGattCallback mGattCallback = new BluetoothGattCallback() { mConnectionState = STATE_DISCONNECTED;
@Override Log.i(TAG, "Disconnected from GATT server.");
public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) { broadcastUpdate(intentAction);
String intentAction; }
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:" +
mBluetoothGatt.discoverServices());
} else if (newState == BluetoothProfile.STATE_DISCONNECTED) { @Override
intentAction = ACTION_GATT_DISCONNECTED; public void onServicesDiscovered(BluetoothGatt gatt, int status) {
mConnectionState = STATE_DISCONNECTED; if (status == BluetoothGatt.GATT_SUCCESS) {
Log.i(TAG, "Disconnected from GATT server."); broadcastUpdate(ACTION_GATT_SERVICES_DISCOVERED);
broadcastUpdate(intentAction); } else {
} Log.w(TAG, "onServicesDiscovered received: " + status);
} }
}
@Override @Override
public void onServicesDiscovered(BluetoothGatt gatt, int status) { public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
if (status == BluetoothGatt.GATT_SUCCESS) { if (status == BluetoothGatt.GATT_SUCCESS) {
broadcastUpdate(ACTION_GATT_SERVICES_DISCOVERED); broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic);
} else { }
Log.w(TAG, "onServicesDiscovered received: " + status); }
}
}
@Override @Override
public void onCharacteristicRead(BluetoothGatt gatt, public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {
BluetoothGattCharacteristic characteristic, broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic);
int status) { }
if (status == BluetoothGatt.GATT_SUCCESS) { };
broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic);
}
}
@Override private void broadcastUpdate(final String action) {
public void onCharacteristicChanged(BluetoothGatt gatt, final Intent intent = new Intent(action);
BluetoothGattCharacteristic characteristic) { sendBroadcast(intent);
broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic); }
}
};
private void broadcastUpdate(final String action) { private void broadcastUpdate(final String action, final BluetoothGattCharacteristic characteristic) {
final Intent intent = new Intent(action); final Intent intent = new Intent(action);
sendBroadcast(intent); intent.putExtra(EXTRA_UUID_CHAR, characteristic.getUuid().toString());
}
private void broadcastUpdate(final String action, // Always try to add the RAW value
final BluetoothGattCharacteristic characteristic) { final byte[] data = characteristic.getValue();
final Intent intent = new Intent(action); if (data != null && data.length > 0) {
intent.putExtra(EXTRA_DATA_RAW, data);
}
// This is special handling for the Heart Rate Measurement profile. Data parsing is sendBroadcast(intent);
// carried out as per profile specifications: }
// http://developer.bluetooth.org/gatt/characteristics/Pages/CharacteristicViewer.aspx?u=org.bluetooth.characteristic.heart_rate_measurement.xml
if (UUID_HEART_RATE_MEASUREMENT.equals(characteristic.getUuid())) {
int flag = characteristic.getProperties();
int format = -1;
if ((flag & 0x01) != 0) {
format = BluetoothGattCharacteristic.FORMAT_UINT16;
Log.d(TAG, "Heart rate format UINT16.");
} else {
format = BluetoothGattCharacteristic.FORMAT_UINT8;
Log.d(TAG, "Heart rate format UINT8.");
}
final int heartRate = characteristic.getIntValue(format, 1);
Log.d(TAG, String.format("Received heart rate: %d", heartRate));
intent.putExtra(EXTRA_DATA, String.valueOf(heartRate));
} else {
// For all other profiles, writes the data formatted in HEX.
final byte[] data = characteristic.getValue();
if (data != null && data.length > 0) {
final StringBuilder stringBuilder = new StringBuilder(data.length);
for(byte byteChar : data)
stringBuilder.append(String.format("%02X ", byteChar));
intent.putExtra(EXTRA_DATA, new String(data) + "\n" + stringBuilder.toString());
}
}
sendBroadcast(intent);
}
public class LocalBinder extends Binder { public class LocalBinder extends Binder {
public BluetoothLeService getService() { public BluetoothLeService getService() {
return BluetoothLeService.this; return BluetoothLeService.this;
} }
} }
@Override @Override
public IBinder onBind(Intent intent) { public IBinder onBind(Intent intent) {
return mBinder; return mBinder;
} }
@Override @Override
public boolean onUnbind(Intent intent) { public boolean onUnbind(Intent intent) {
// After using a given device, you should make sure that BluetoothGatt.close() is called // 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 // such that resources are cleaned up properly. In this particular example, close() is
// invoked when the UI is disconnected from the Service. // invoked when the UI is disconnected from the Service.
close(); close();
return super.onUnbind(intent); return super.onUnbind(intent);
} }
private final IBinder mBinder = new LocalBinder(); private final IBinder mBinder = new LocalBinder();
/** /**
* Initializes a reference to the local Bluetooth adapter. * Initializes a reference to the local Bluetooth adapter.
* *
* @return Return true if the initialization is successful. * @return Return true if the initialization is successful.
*/ */
public boolean initialize() { public boolean initialize() {
// For API level 18 and above, get a reference to BluetoothAdapter through // For API level 18 and above, get a reference to BluetoothAdapter through
// BluetoothManager. // BluetoothManager.
if (mBluetoothManager == null) { if (mBluetoothManager == null) {
mBluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE); mBluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE);
if (mBluetoothManager == null) { if (mBluetoothManager == null) {
Log.e(TAG, "Unable to initialize BluetoothManager."); Log.e(TAG, "Unable to initialize BluetoothManager.");
return false; return false;
} }
} }
mBluetoothAdapter = mBluetoothManager.getAdapter(); mBluetoothAdapter = mBluetoothManager.getAdapter();
if (mBluetoothAdapter == null) { if (mBluetoothAdapter == null) {
Log.e(TAG, "Unable to obtain a BluetoothAdapter."); Log.e(TAG, "Unable to obtain a BluetoothAdapter.");
return false; return false;
} }
return true; return true;
} }
/** /**
* Connects to the GATT server hosted on the Bluetooth LE device. * Connects to the GATT server hosted on the Bluetooth LE device.
* *
* @param address The device address of the destination device. * @param address The device address of the destination device.
* *
* @return Return true if the connection is initiated successfully. The connection result * @return Return true if the connection is initiated successfully. The connection result
* is reported asynchronously through the * is reported asynchronously through the
* {@code BluetoothGattCallback#onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int)} * {@code BluetoothGattCallback#onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int)}
* callback. * callback.
*/ */
public boolean connect(final String address) { public boolean connect(final String address) {
if (mBluetoothAdapter == null || address == null) { if (mBluetoothAdapter == null || address == null) {
Log.w(TAG, "BluetoothAdapter not initialized or unspecified address."); Log.w(TAG, "BluetoothAdapter not initialized or unspecified address.");
return false; return false;
} }
// Previously connected device. Try to reconnect. // Previously connected device. Try to reconnect.
if (mBluetoothDeviceAddress != null && address.equals(mBluetoothDeviceAddress) if (mBluetoothDeviceAddress != null
&& mBluetoothGatt != null) { && address.equals(mBluetoothDeviceAddress)
Log.d(TAG, "Trying to use an existing mBluetoothGatt for connection."); && mBluetoothGatt != null) {
if (mBluetoothGatt.connect()) {
mConnectionState = STATE_CONNECTING;
return true;
} else {
return false;
}
}
final BluetoothDevice device = mBluetoothAdapter.getRemoteDevice(address); Log.d(TAG, "Trying to use an existing mBluetoothGatt for connection.");
if (device == null) { if (mBluetoothGatt.connect()) {
Log.w(TAG, "Device not found. Unable to connect."); mConnectionState = STATE_CONNECTING;
return false; return true;
} } else {
// We want to directly connect to the device, so we are setting the autoConnect return false;
// parameter to false. }
mBluetoothGatt = device.connectGatt(this, false, mGattCallback); }
Log.d(TAG, "Trying to create a new connection.");
mBluetoothDeviceAddress = address;
mConnectionState = STATE_CONNECTING;
return true;
}
/** final BluetoothDevice device = mBluetoothAdapter.getRemoteDevice(address);
* Disconnects an existing connection or cancel a pending connection. The disconnection result if (device == null) {
* is reported asynchronously through the Log.w(TAG, "Device not found. Unable to connect.");
* {@code BluetoothGattCallback#onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int)} return false;
* callback. }
*/ // We want to directly connect to the device, so we are setting the autoConnect
public void disconnect() { // parameter to false.
if (mBluetoothAdapter == null || mBluetoothGatt == null) { mBluetoothGatt = device.connectGatt(this, false, mGattCallback);
Log.w(TAG, "BluetoothAdapter not initialized"); Log.d(TAG, "Trying to create a new connection.");
return; mBluetoothDeviceAddress = address;
} mConnectionState = STATE_CONNECTING;
mBluetoothGatt.disconnect(); return true;
} }
/** /**
* After using a given BLE device, the app must call this method to ensure resources are * Disconnects an existing connection or cancel a pending connection. The disconnection result
* released properly. * is reported asynchronously through the
*/ * {@code BluetoothGattCallback#onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int)}
public void close() { * callback.
if (mBluetoothGatt == null) { */
return; public void disconnect() {
} if (mBluetoothAdapter == null || mBluetoothGatt == null) {
mBluetoothGatt.close(); Log.w(TAG, "BluetoothAdapter not initialized");
mBluetoothGatt = null; return;
} }
mBluetoothGatt.disconnect();
}
/** /**
* Request a read on a given {@code BluetoothGattCharacteristic}. The read result is reported * After using a given BLE device, the app must call this method to ensure resources are
* asynchronously through the {@code BluetoothGattCallback#onCharacteristicRead(android.bluetooth.BluetoothGatt, android.bluetooth.BluetoothGattCharacteristic, int)} * released properly.
* callback. */
* public void close() {
* @param characteristic The characteristic to read from. if (mBluetoothGatt == null) {
*/ return;
public void readCharacteristic(BluetoothGattCharacteristic characteristic) { }
if (mBluetoothAdapter == null || mBluetoothGatt == null) { mBluetoothGatt.close();
Log.w(TAG, "BluetoothAdapter not initialized"); mBluetoothGatt = null;
return; }
}
mBluetoothGatt.readCharacteristic(characteristic);
}
/** /**
* Enables or disables notification on a give 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)}
* @param characteristic Characteristic to act on. * callback.
* @param enabled If true, enable notification. False otherwise. *
*/ * @param characteristic The characteristic to read from.
public void setCharacteristicNotification(BluetoothGattCharacteristic characteristic, */
boolean enabled) { public void readCharacteristic(BluetoothGattCharacteristic characteristic) {
if (mBluetoothAdapter == null || mBluetoothGatt == null) { if (mBluetoothAdapter == null || mBluetoothGatt == null) {
Log.w(TAG, "BluetoothAdapter not initialized"); Log.w(TAG, "BluetoothAdapter not initialized");
return; return;
} }
mBluetoothGatt.setCharacteristicNotification(characteristic, enabled); mBluetoothGatt.readCharacteristic(characteristic);
}
// This is specific to Heart Rate Measurement. /**
if (UUID_HEART_RATE_MEASUREMENT.equals(characteristic.getUuid())) { * Enables or disables notification on a give characteristic.
BluetoothGattDescriptor descriptor = characteristic.getDescriptor( *
UUID.fromString(GattAttributeResolver.CLIENT_CHARACTERISTIC_CONFIG)); * @param characteristic Characteristic to act on.
descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE); * @param enabled If true, enable notification. False otherwise.
mBluetoothGatt.writeDescriptor(descriptor); */
} public void setCharacteristicNotification(BluetoothGattCharacteristic characteristic, boolean enabled) {
} if (mBluetoothAdapter == null || mBluetoothGatt == null) {
Log.w(TAG, "BluetoothAdapter not initialized");
return;
}
mBluetoothGatt.setCharacteristicNotification(characteristic, enabled);
}
/** /**
* Retrieves a list of supported GATT services on the connected device. This should be * Retrieves a list of supported GATT services on the connected device. This should be
* invoked only after {@code BluetoothGatt#discoverServices()} completes successfully. * invoked only after {@code BluetoothGatt#discoverServices()} completes successfully.
* *
* @return A {@code List} of supported services. * @return A {@code List} of supported services.
*/ */
public List<BluetoothGattService> getSupportedGattServices() { public List<BluetoothGattService> getSupportedGattServices() {
if (mBluetoothGatt == null) return null; if (mBluetoothGatt == null) return null;
return mBluetoothGatt.getServices(); return mBluetoothGatt.getServices();
} }
} }