android Ble开发的那些事(二)

前一篇文章说到要贴自己的相关代码,这篇开始会结合代码一起和大家一起分享。要开始讲数据的传输了,先讲讲GATT吧。

什么是GATT?

GATT的全名是Generic Attribute Profile(暂且翻译成:普通属性协议),它定义两个BLE设备通过叫做ServiceCharacteristic的东西进行通信。GATT就是使用了ATT(Attribute Protocol)协议,ATT协议把Service、 Characteristic遗迹对应的数据保存在一个查找表中,次查找表使用16 bit ID作为每一项的索引。一旦两个设备建立起了连接,GATT就开始起作用了,这也意味着,你必需完成前面的GAP协议。这里需要说明的是,GATT连接,必需先经过GAP协议。实际上,我们在Android开发中,可以直接使用设备的MAC地址发起连接,可以不经过扫描的步骤。这并不意味不需要经过GAP,实际上在芯片级别已经给你做好了,蓝牙芯片发起连接,总是先扫描设备,扫描到了才会发起连接。

GATT 连接需要特别注意的是:GATT连接是独占的。也就是一个 BLE 外设同时只能被一个中心设备连接。一旦外设被连接,它就会马上停止广播,这样它就对其他设备不可见了。当设备断开,它又开始广播。中心设备和外设需要双向通信的话,唯一的方式就是建立GATT连接。

android Ble开发的那些事(二)_第1张图片

由上图可以看出:
* 一个低功耗蓝牙(ble)可以包括多个Profile
* 一个Profile中有多个Service(通过uuid就可以找到对应的Service)
* 一个Service中有多个Characteristic(通过uuid就可以找到对应的Characteristic)
* 一个Characteristic中包括一个value和多个Descriptor(通过uuid就可以找到对应的Descriptor)

如何开发Ble?

在整个Ble开发中,我有使用别人比较优秀的第三方库辅助开发,推荐这个库:https://github.com/litesuits/android-lite-bluetoothLE , 开发起来真的很方便,使用也比较简单。

1. 准备工作

(1) 声明权限


<uses-permission android:name="android.permission.BLUETOOTH" />

<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

(2) 添加lite-ble-0.9.2.jar库到工程中
这步应该不用讲解怎么添加了吧。

(3) 检测蓝牙是否打开并且创建蓝牙操作的对象

private LiteBluetooth liteBluetooth;
 // 检查当前手机是否支持ble 蓝牙,如果不支持退出程序
if (!getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)) {
            Toast.makeText(this, "ble_not_supported", Toast.LENGTH_SHORT).show();
}        
// 初始化 Bluetooth adapter, 通过蓝牙管理器得到一个参考蓝牙适配器(API必须在以上android4.3或以上和版本)        
// 1.获取bluetoothAdapter        
final BluetoothManager bluetoothManager = (BluetoothManager)getSystemService(Context.BLUETOOTH_SERVICE);        
mBluetoothAdapter = bluetoothManager.getAdapter();        
// 2.检查设备上是否支持并开启蓝牙        
if (mBluetoothAdapter == null) {
            Toast.makeText(this, "ble_not_supported", Toast.LENGTH_SHORT).show();
return;   
}        
//创建liteBluetooth的单例对象,(BleUtil是自己写的类,实现单例的)
if (liteBluetooth == null)            
   liteBluetooth = BleUtil.getInstance(getApplicationContext());        
// 为了确保设备上蓝牙能使用, 如果当前蓝牙设备没启用,弹出对话框向用户要求授予权限来启用
//liteBluetooth.enableBluetoothIfDisabled(activity,REQUEST_ENABLE_BT);

2. 搜索设备

private void scanDevicesPeriod() {
    //liteBluetooth = new LiteBluetooth(getBaseContext());
    liteBluetooth.startLeScan(new PeriodScanCallback(SCAN_PERIOD) {
        @Override
        public void onScanTimeout() {
            //超过搜索时间后的相关操作
        }
        @Override
        public void onLeScan(BluetoothDevice device, int rssi, byte[] scanRecord) {
            //搜到的设备
            if (Math.abs(rssi) <= 90 ){//过滤掉信号强度小于-90的设备
                Log.i("test scan", "device: " + device.getName() + "  mac: "+ device.getAddress()
                  + "  rssi: " + rssi + "  scanRecord: " + DeviceBytes.byte2hex(scanRecord));
            }
        }
    });
}
  • SCAN_PERIOD:搜索的时长,毫秒数
  • ble的mac地址:通过device.getAddress()就可以得到了
  • scanRecord:Ble广播的数据(DeviceBytes是自己写的工具类,有空分享出来)
    这就搜索到设备啦,而且还打印出来了,是不是so easy啊~

3. 连接设备(首次连接)

一旦获取到GATT的Services,就可以读写他们的属性了

private void  connect(final BluetoothDevice device){
    liteBluetooth.connect(device, false, new LiteBleGattCallback() {
        @Override
        public void onConnectSuccess(BluetoothGatt bluetoothGatt, int i) {
            bluetoothGatt.discoverServices();
            //连接成功后,还需要发现服务成功后才能进行相关操作
        }
        @Override
        public void onServicesDiscovered(BluetoothGatt bluetoothGatt, int i) {
            BluetoothUtil.printServices(bluetoothGatt);//把服务打印出来
            //服务发现成功后,我们就可以进行数据相关的操作了,比如写入数据、开启notify等等
        }
        @Override
        public void onConnectFailure(BleException e) {
            bleExceptionHandler.handleException(e);
        }
        @Override
        public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {
            //开启notify之后,我们就可以在这里接收数据了。
            //处理数据也是需要注意的,在我们项目中需要进行类似分包的操作,感兴趣的我以后分享
            Log.i("notify", "onCharacteristicChanged: "+ DeviceBytes.byte2hex(characteristic.getValue()));
            super.onCharacteristicChanged(gatt, characteristic);
        }
        @Override
        public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
            //当我们对ble设备写入相关数据成功后,这里也会被调用
            Log.i("test", "onCharacteristicWrite: "+ DeviceBytes.byte2hex(characteristic.getValue()));
            super.onCharacteristicWrite(gatt, characteristic, status);
        }
    });
}

4. 连接设备(二次重连)

实现二次重连也挺简单的,在第一次连接成功的会掉函数中,我们把设备的mac地址保存下来,二次重连的时候直接把mac地址传进去就好了。

private void scanAndConnect(final String mac) {
    liteBluetooth.scanAndConnect(mac, false, new LiteBleGattCallback() {//默认搜20s
        @Override
        public void onConnectSuccess(BluetoothGatt bluetoothGatt, int i) {
            bluetoothGatt.discoverServices();
            //连接成功后,还需要发现服务成功后才能进行相关操作
        }
        @Override
        public void onServicesDiscovered(BluetoothGatt bluetoothGatt, int i) {
            BluetoothUtil.printServices(bluetoothGatt);//把服务打印出来
            //服务发现成功后,我们就可以进行数据相关的操作了,比如写入数据、开启notify等等
        }
        @Override
        public void onConnectFailure(BleException e) {
            bleExceptionHandler.handleException(e);
        }
        @Override
        public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {
            //开启notify之后,我们就可以在这里接收数据了。
            //处理数据也是需要注意的,在我们项目中需要进行类似分包的操作,感兴趣的我以后分享
            Log.i("notify", "onCharacteristicChanged: "+ DeviceBytes.byte2hex(characteristic.getValue()));
            super.onCharacteristicChanged(gatt, characteristic);
        }
        @Override
        public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {
            //当我们对ble设备写入相关数据成功后,这里也会被调用
            Log.i("test", "onCharacteristicWrite: "+ DeviceBytes.byte2hex(characteristic.getValue()));
            super.onCharacteristicWrite(gatt, characteristic, status);
        }
    });
}

5. 开启notify接收数据

如果设备主动给手机发信息,则可以通过notification的方式,这种方式不用手机去轮询地读设备上的数据。手机可以用如下方式给设备设置notification功能。如果notificaiton方式对于某个Characteristic是enable的,那么当设备上的这个Characteristic改变时,手机上的onCharacteristicChanged()回调就会被促发。

我尝试调用那个库的方法来开启notify,但始终没有成功,所以索性自己写了。原理不难,也是一步步的通过uuid找到服务、在服务中通过uuid找Characteristic、再通过uuid找到Descriptor。有没有觉得很熟悉?就是文章一开始放的那张图!嘿嘿~是不是就理解了~

//uuid需要替换成项目中使用的uuid,这只是举个例子
private static final String serviceid = "0000fee7-0000-1000-8000-00805f9b34fb";
private static final String charaid   = "0000feaa-0000-1000-8000-00805f9b34fb";
private static final String notifyid  = "00001202-0000-1000-8000-00805f9b34fb";
private void enableNotificationOfCharacteristic(final boolean enable) {
    UUID ServiceUUID = UUID.fromString(serviceid);
    UUID CharaUUID = UUID.fromString(charaid);
    if(!mBluetoothGatt.equals(null)){
        BluetoothGattService service = mBluetoothGatt.getService(ServiceUUID);
        if(service != null){
            BluetoothGattCharacteristic chara= service.getCharacteristic(CharaUUID);
            if(chara != null){
                boolean success = mBluetoothGatt.setCharacteristicNotification(chara,enable);
                Log.i("success", "setCharactNotify: "+success);
                BluetoothGattDescriptor descriptor = chara.getDescriptor(UUID.fromString(notifyid));
                if (descriptor != null){
                    if (enable) {
                        descriptor.setValue(BluetoothGattDescriptor.ENABLE_INDICATION_VALUE);
                    } else {
                        descriptor.setValue(BluetoothGattDescriptor.DISABLE_NOTIFICATION_VALUE);
                    }
                    SystemClock.sleep(200);
                    mBluetoothGatt.writeDescriptor(descriptor);
                }
            }
        }
    }
}

6. 写入数据

    private void writeDataToCharacteristic(byte[] value) {
        if (liteBluetooth.isServiceDiscoered()){
            LiteBleConnector connector = liteBluetooth.newBleConnector();
            connector.withUUIDString(serviceid, get_write_charaid, null)
                    .writeCharacteristic(connector.getCharacteristic(), value, new BleCharactCallback() {
                        @Override
                        public void onSuccess(BluetoothGattCharacteristic characteristic) {
//                        BleLog.i(TAG, "Write Success, DATA: " + DeviceBytes.byte2hex(characteristic.getValue()));
                        }
                        @Override
                        public void onFailure(BleException exception) {
                            BleLog.i(TAG, "Write failure: " + exception);
                            bleExceptionHandler.handleException(exception);
                        }
                    });
        }else {
            return;
        }
    }

7. 关闭连接

if (liteBluetooth.isConnectingOrConnected()) {
        liteBluetooth.closeBluetoothGatt();
}

在蓝牙的数据收发过程中,几乎都是用byte[]数组来进行的,那么我们调试保存的数据难免会为数据格式的转换而各种百度,下面和大家分享下我项目中用到的一些方法~

数据格式转化的工具类

1. 两个byte –>int

private  int byteToInt(byte b, byte c) {//计算总包长,两个字节表示的
    short s = 0;
    int ret;
    short s0 = (short) (c & 0xff);// 最低位
    short s1 = (short) (b & 0xff);
    s1 <<= 8;
    s = (short) (s0 | s1);
    ret = s;
    return ret;
}

2. int –>两个byte

private byte[] int2byte(int res) {
    byte[] targets = new byte[2];
    targets[1] = (byte) (res & 0xff);// 最低位
    targets[0] = (byte) ((res >> 8) & 0xff);// 次低位
    return targets;
}

3. 16进制字符串 –>byte[ ]

public static byte[] hexStringToByte(String hex) {
    int len = (hex.length() / 2);
    byte[] result = new byte[len];
    char[] achar = hex.toCharArray();
    for (int i = 0; i < len; i++) {
        int pos = i * 2;
        result[i] = (byte) (toByte(achar[pos]) << 4 | toByte(achar[pos + 1]));
    }
    return result;
}
private static byte toByte(char c) {
    byte b = (byte) "0123456789ABCDEF".indexOf(c);
    return b;
}

4. byte[ ] –>16进制字符串

 public static String byte2hex(byte [] buffer){
        String h = "";
        for(int i = 0; i < buffer.length; i++){
            String temp = Integer.toHexString(buffer[i] & 0xFF);
            if(temp.length() == 1){
                temp = "0" + temp;
            }
            h = h + temp;
        }
        return h;
  }

Ble基本的操作几乎都列出来了,下篇和大家分享低耗蓝牙空中升级,网上的demo都太庞大了,下次分享我实现的demo,代码一定最少~嘿嘿。还有就是数据分包那部分,如果感兴趣的可以留言给我,我看是否需要分享。谢谢观看~

原创作品,如需转载,请与作者联系,否则将追究法律责任。

你可能感兴趣的:(android,ble)