首页 > 代码库 > BLE
BLE
android4.3 nei内置了ble并为上层app提供相应的接口来使用BLE功能。
BLE主要涉及的协议及术语：
GenericAttribute Profile (GATT)
BLE上层的协议都是基于GATT，它是一个通用的规范，通过BLE连接发送/接收属性值。
bluetoothSIG定义了很多的ble协议。
AttributeProtocol (ATT)
GATT是建立在ATT之上。也被称为GATT/ATT。
ATT运行在ble设备上，所以被优化，尽可能的占用较少的字节。
每一个属性被指定一个UUID，通过ATT传输的属性被格式化位特性（characteristics）或服务（services）。
Characteristic
一个特性包含一个单一的值和0-n个描述符（Descriptor）来描述这个特性值。一个特性可以被看作一个类型。
Descriptor
描述符被定义为属性，这些属性用来描述特性的值。
例如：规定特性值的取值范围，特性值的单位等
Service
服务是一组特性的集合。例如：“心率检测”服务包含“心速测量”的特性。
角色和职责
中心与外围：被应用于BLE连接本身，中心角色设备扫描/寻找广播，外围设备角色发出广播。
GATTserver vs. GATT client：
这个决定了两个设备在建立连接之后如何交互。
android手机和BLE设备的区别：手机支持中心角色（centralrole），BLE设备支持peripheralrole。
一旦建立连接，他们就开始相互传输gatt数据，根据传输的数据的种类其中的一个可能作为服务器。
如果BLE设备想报告数据给手机，它可能让BLE设备的传感器作为服务器。如果BLE设备准备接收来自手机的数据，手机的传感器就作为服务端。
以上例子说明：androidapp 是GATT client，GATTclient 从GATT server 获取数据。也可以设计android app 作为GATTserver。
BLE权限：
<uses-permission android:name="android.permission.BLUETOOTH"/><uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/><uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/> |
如果想把app提供给不支持BLE的设备需要设置android:required="fasle",然后在运行时进行判断：
if (!getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)) { Toast.makeText(this, R.string.ble_not_supported, Toast.LENGTH_SHORT).show(); finish();} |
设置BLE
1：获取BluetoothAdapter
BluetoothAdapter是所有蓝牙功能所必需的，整个系统只有一个BluetoothAdapter，获取BluetoothAdapter之后就可以进行各种蓝牙的操作了。
// Initializes Bluetooth adapter.final BluetoothManager bluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE);mBluetoothAdapter = bluetoothManager.getAdapter(); |
2：启动蓝牙
通过isEnabled（）判断是否启动，如果没有启动，通过下面的方式启动：
private BluetoothAdapter mBluetoothAdapter;...// Ensures Bluetooth is available on the device and it is enabled. If not,// displays a dialog requesting user permission to enable Bluetooth.if (mBluetoothAdapter == null || !mBluetoothAdapter.isEnabled()) { Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE); startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);} |
3：查找BLE设备
通过startLeScan查找LE设备，并实现LeScanCallback作为参数。
注意事项：1：一旦找到所查找的设备，立即停止扫描
2：设置扫描超时，避免循环扫描。
public class DeviceScanActivity extends ListActivity { private BluetoothAdapter mBluetoothAdapter; private boolean mScanning; private Handler mHandler; // Stops scanning after 10 seconds. private static final long SCAN_PERIOD = 10000; ... private void scanLeDevice(final boolean enable) { if (enable) { // Stops scanning after a pre-defined scan period. mHandler.postDelayed(new Runnable() { @Override public void run() { mScanning = false; mBluetoothAdapter.stopLeScan(mLeScanCallback); } }, SCAN_PERIOD); mScanning = true; mBluetoothAdapter.startLeScan(mLeScanCallback); } else { mScanning = false; mBluetoothAdapter.stopLeScan(mLeScanCallback); } ... }...} |
如果需要查找特定类型的LE设备，需要使用startLeScan(UUID[],BluetoothAdapter.LeScanCallback()),提供一个你的设备支持的服务的UUID数组。
LeScanCallback的实现：
private LeDeviceListAdapter mLeDeviceListAdapter;...// Device scan callback.private BluetoothAdapter.LeScanCallback mLeScanCallback = new BluetoothAdapter.LeScanCallback() { @Override public void onLeScan(final BluetoothDevice device, int rssi, byte[] scanRecord) { runOnUiThread(new Runnable() { @Override public void run() { mLeDeviceListAdapter.addDevice(device); mLeDeviceListAdapter.notifyDataSetChanged(); } }); }}; |
注意：要么搜索经典蓝牙，要么搜索BLE，两者不能同时搜索。
连接GATTserver
使用connectGatt连接到BLE设备的ＧＡＴＴ ｓｅｒｖｅｒ，
mBluetoothGatt = device.connectGatt(this, false, mGattCallback);
|
将会返回一个BluetoothGatt实例，通过这个实例可以进行Gattclient的各种操作。调用者（androidapp）是Gattclient。GattCallback用来提供结果给客户端。
读取BLE的属性
如果androidapp已经连接了Gatt server并且发现了服务，就能够进行属性的读写了。
收取Gatt的通知
通常BLEapp需要被通知，如果BLE设备的特性发生了改变。
使用setCharacteristicNotification方法为一个特性设置通知：
private BluetoothGatt mBluetoothGatt;BluetoothGattCharacteristic characteristic;boolean enabled;...mBluetoothGatt.setCharacteristicNotification(characteristic, enabled);...BluetoothGattDescriptor descriptor = characteristic.getDescriptor( UUID.fromString(SampleGattAttributes.CLIENT_CHARACTERISTIC_CONFIG));descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE);mBluetoothGatt.writeDescriptor(descriptor); |
一旦一个特性被设置为通知可用，远端设备的特性发生改变就会触发onCharacteristicChanged
回调。
@Override// Characteristic notificationpublic void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) { broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic);} |
关闭clientapp
结束和BLE设备的通讯后，需要释放资源：
public void close() { if (mBluetoothGatt == null) { return; } mBluetoothGatt.close(); mBluetoothGatt = null;}
|