android -- 蓝牙 bluetooth （三）搜索蓝牙

2022-01-18 22:20:05

接上篇打开蓝牙继续，来一起看下蓝牙搜索的流程，触发蓝牙搜索的条件形式上有两种，一是在蓝牙设置界面开启蓝牙会直接开始搜索，另一个是先打开蓝牙开关在进入蓝牙设置界面也会触发搜索，也可能还有其它触发方式，但最后都要来到BluetoothSettngs.java的startScanning()，我们分析的起点也从这里开始，起步代码如下

  1. private void updateContent(int bluetoothState, boolean scanState) {
  2. if (numberOfPairedDevices == 0) {
  3. preferenceScreen.removePreference(mPairedDevicesCategory);
  4. if (scanState == true) {
  5. mActivityStarted = false;
  6. startScanning();
  7. } else<span style="font-family: Arial, Helvetica, sans-serif;">    ........</span>
  8. }
  9. private void startScanning() {
  10. if (!mAvailableDevicesCategoryIsPresent) {
  11. getPreferenceScreen().addPreference(mAvailableDevicesCategory);
  12. }
  13. mLocalAdapter.startScanning(true);
  14. }

其实在这里蓝牙搜索和打开流程是结构上是一致的，利用LocalBluetoothAdapter.java过渡到BluetoothAdapter.java再跳转至AdapterService.java要稍微留意下的是在这个过渡中startScaning()方法变成了startDiscovery()方法，看下代码：packages/apps/Settings/src/com/android/settings/bluetooth/LocalBluetoothAdapter.java

  1. void startScanning(boolean force) {
  2. if (!mAdapter.isDiscovering()) {
  3. if (!force) {
  4. // Don't scan more than frequently than SCAN_EXPIRATION_MS,
  5. // unless forced
  6. if (mLastScan + SCAN_EXPIRATION_MS > System.currentTimeMillis()) {
  7. return;
  8. }
  9. // If we are playing music, don't scan unless forced.
  10. A2dpProfile a2dp = mProfileManager.getA2dpProfile();
  11. if (a2dp != null && a2dp.isA2dpPlaying()) {
  12. return;
  13. }
  14. }
  15. //这里才是我们最关注的，前面限制条件关注一下就行了
  16. if (mAdapter.startDiscovery()) {
  17. mLastScan = System.currentTimeMillis();
  18. }
  19. }

BluetoothAdapter.java的那一段，路径 /frameworks/base/core/java/android/bluetooth/BluetoothAdapter.java

  1. public boolean startDiscovery() {
  2. .............................
  3. AdapterService service = getService();
  4. if (service == null) return false;
  5. return service.startDiscovery();
  6. }

这个service代码写得很明白AdapterService，转了一圈从framework又回到packages了，

下面的代码路径自然是 :packages/apps/Bluetooth/src/com/android/bluetooth/btservice/AdapterService.java，

  1. boolean startDiscovery() {
  2. enforceCallingOrSelfPermission(BLUETOOTH_ADMIN_PERM,
  3. "Need BLUETOOTH ADMIN permission");
  4. return startDiscoveryNative();
  5. }

和打开蓝牙根本就是一个套路，上面的流程略过一小步，很简单的不写了，下面要怎么走，估计大家也都猜到了，JNI应该出场了，

路径：/packages/apps/Bluetooth/jni/com_android_bluetooth_btservice_AdapterService.cpp

  1. static jboolean startDiscoveryNative(JNIEnv* env, jobject obj) {
  2. ALOGV("%s:",__FUNCTION__);
  3. jboolean result = JNI_FALSE;
  4. if (!sBluetoothInterface) return result;
  5. int ret = sBluetoothInterface->start_discovery();
  6. result = (ret == BT_STATUS_SUCCESS) ? JNI_TRUE : JNI_FALSE;
  7. return result;
  8. }

在下面要去哪？稍微要动下脑筋，不过我们在上一篇android -- 蓝牙 bluetooth （二） 打开蓝牙已经说过怎么找了，注意android.mk文件，先找头文件，再找对应的实现C文件代码。就是现在回顾下，蓝牙打开和搜索的代码流程我们都看了，跳转都是一个套路，settings界面发起，LocalBluetoothAdapter.java过渡，去framework的转转（BluetoothAdapter.java）后回到packages的AdapterService.java，再走JNI来的external。流程就是这样的，相信类似的功能跳转(比如蓝牙配对，关闭蓝牙，停止扫描这些)大家都应该熟悉了，后面再有类似的功能就写函数名一笔带过了，还有这里要注意的就是这个start_discovery()实现代码的寻找，留意mk文件就是了，不复杂。小结结束，继续看代码    路径：/external/bluetooth/bluedroid/btif/src/bluetooth.c

  1. static int start_discovery(void)
  2. {
  3. /* sanity check */
  4. if (interface_ready() == FALSE)
  5. return BT_STATUS_NOT_READY;
  6. return btif_dm_start_discovery();
  7. }

下面代码直接跳转就可以找到，路径external/bluetooth/bluedroid/btif/src/btif_dm.c

这个代码有点多，不过里面的信息也很多，所以连注释也一起保留的贴出来了，蓝牙的搜索实现并没有像蓝牙打开那样交由vendor厂商实现，在这里已经写出来了，仔细看下那些#if和#else，都是一些查询条件的调置，#if (BLE_INCLUDED == TRUE)   这个应该就google为蓝牙4.0 LE作的准备了，也算是今年google I/O大会上宣布即将支持蓝牙4.0低能耗版一个佐证吧，对于代码里面那些字符串的含义看这里好了external/bluetooth/bluedroid/bta/include/bta_api.h，一个头文件，大部分字符串和结构体的定义都在这了，多少还有些注释。

  1. bt_status_t btif_dm_start_discovery(void)
  2. {
  3. tBTA_DM_INQ inq_params;
  4. tBTA_SERVICE_MASK services = 0;
  5. BTIF_TRACE_EVENT1("%s", __FUNCTION__);
  6. /* TODO: Do we need to handle multiple inquiries at the same time? */
  7. /* Set inquiry params and call API */
  8. #if (BLE_INCLUDED == TRUE)
  9. inq_params.mode = BTA_DM_GENERAL_INQUIRY|BTA_BLE_GENERAL_INQUIRY;
  10. #else
  11. inq_params.mode = BTA_DM_GENERAL_INQUIRY;
  12. #endif
  13. inq_params.duration = BTIF_DM_DEFAULT_INQ_MAX_DURATION;
  14. inq_params.max_resps = BTIF_DM_DEFAULT_INQ_MAX_RESULTS;
  15. inq_params.report_dup = TRUE;
  16. inq_params.filter_type = BTA_DM_INQ_CLR;
  17. /* TODO: Filter device by BDA needs to be implemented here */
  18. /* Will be enabled to TRUE once inquiry busy level has been received */
  19. btif_dm_inquiry_in_progress = FALSE;
  20. /* find nearby devices */
  21. BTA_DmSearch(&inq_params, services, bte_search_devices_evt);
  22. return BT_STATUS_SUCCESS;
  23. }
 

BTA_DmSearch()方法是看起来是要搜索了，不过里面这个家伙bte_search_devices_evt才是真正干活的主力，所以我们先看它，在这个函数里

  1. static void bte_search_devices_evt(tBTA_DM_SEARCH_EVT event, tBTA_DM_SEARCH *p_data)                                                                      {
  2. UINT16 param_len = 0;
  3. if (p_data)
  4. param_len += sizeof(tBTA_DM_SEARCH);
  5. /* Allocate buffer to hold the pointers (deep copy). The pointers will point to the end of the tBTA_DM_SEARCH */
  6. switch (event)
  7. {
  8. case BTA_DM_INQ_RES_EVT:
  9. {
  10. if (p_data->inq_res.p_eir)
  11. param_len += HCI_EXT_INQ_RESPONSE_LEN;
  12. }
  13. break;
  14. ..............................
  15. }
  16. BTIF_TRACE_DEBUG3("%s event=%s param_len=%d", __FUNCTION__, dump_dm_search_event(event), param_len);
  17. /* if remote name is available in EIR, set teh flag so that stack doesnt trigger RNR */
  18. if (event == BTA_DM_INQ_RES_EVT)
  19. p_data->inq_res.remt_name_not_required = check_eir_remote_name(p_data, NULL, NULL);
  20. btif_transfer_context (btif_dm_search_devices_evt , (UINT16) event, (void *)p_data, param_len,
  21. (param_len > sizeof(tBTA_DM_SEARCH)) ? search_devices_copy_cb : NULL);
  22. }

在上面的这个函数里又有这个bte_search_devices_evt，在它里我们能看一个 HAL_CBACK，这是要往回发消息了，看下这个函数的全貌，说是全貌，不过还是只贴出一个case分支，太长了，大家还是自行还源码吧。到这里已经可以知道扫描到蓝牙设备的mac地址和设备名，那个bdcpy函数就是在解析mac地址，有了这些，蓝牙搜索是到应该在界面展示成果的时候了，开始回调，忘记代码路径了，这个函数都在这个文件里：  /external/bluetooth/bluedroid/btif/src/btif_dm.c

  1. static void btif_dm_search_devices_evt (UINT16 event, char *p_param)
  2. tBTA_DM_SEARCH *p_search_data;
  3. BTIF_TRACE_EVENT2("%s event=%s", __FUNCTION__, dump_dm_search_event(event));
  4. switch (event)
  5. {
  6. case BTA_DM_DISC_RES_EVT:
  7. {
  8. p_search_data = (tBTA_DM_SEARCH *)p_param;
  9. /* Remote name update */
  10. if (strlen((const char *) p_search_data->disc_res.bd_name))
  11. {
  12. bt_property_t properties[1];
  13. bt_bdaddr_t bdaddr;
  14. bt_status_t status;
  15. properties[0].type = BT_PROPERTY_BDNAME;
  16. properties[0].val = p_search_data->disc_res.bd_name;
  17. properties[0].len = strlen((char *)p_search_data->disc_res.bd_name);
  18. bdcpy(bdaddr.address, p_search_data->disc_res.bd_addr);
  19. status = btif_storage_set_remote_device_property(&bdaddr, &properties[0]);
  20. ASSERTC(status == BT_STATUS_SUCCESS, "failed to save remote device property", status);
  21. HAL_CBACK(bt_hal_cbacks, remote_device_properties_cb,
  22. status, &bdaddr, 1, properties);
  23. }
  24. /* TODO: Services? */
  25. }
  26. break;

一小段log，下面的文字就在上面的函数里打出来的，即便上面的写的函数没有，肯定也在附近了。

05-30 13:52:14.890  1578  2612 D bt-btif : bte_search_devices_evt event=BTA_DM_INQ_RES_EVT param_len=524
05-30 13:52:14.890  1578  2612 D bt-btif : search_devices_copy_cb: event=BTA_DM_INQ_RES_EVT
05-30 13:52:14.890  1578  2584 I bt-btif : btif_dm_search_devices_evt event=BTA_DM_INQ_RES_EVT
05-30 13:52:14.890  1578  2584 D bt-btif : btif_dm_search_devices_evt() ec:89:f5:ba:fb:03 device_type = 0x1
 
        当然回过头我们还要看下那个BTA_DmSearch()，看它的实现，更应该是起消息发送的作用，代码在/external/bluetooth/bluedroid/bta/dm/bta_dm_api.c，这个函数具体流程并没有看多少，当工具方法看了，有时间看看还是没坏处的。
  1. void BTA_DmSearch(tBTA_DM_INQ *p_dm_inq, tBTA_SERVICE_MASK services, tBTA_DM_SEARCH_CBACK *p_cback)
  2. {  tBTA_DM_API_SEARCH    *p_msg;
  3. if ((p_msg = (tBTA_DM_API_SEARCH *) GKI_getbuf(sizeof(tBTA_DM_API_SEARCH))) != NULL)
  4. {
  5. memset(p_msg, 0, sizeof(tBTA_DM_API_SEARCH));
  6. p_msg->hdr.event = BTA_DM_API_SEARCH_EVT;
  7. memcpy(&p_msg->inq_params, p_dm_inq, sizeof(tBTA_DM_INQ));
  8. p_msg->services = services;
  9. p_msg->p_cback = p_cback;
  10. p_msg->rs_res  = BTA_DM_RS_NONE;
  11. bta_sys_sendmsg(p_msg);
  12. }
  13. }

看了上面方法后我们 要回去了看看，代码通过JNI下来的，回去也是看JNI的回调方法

  1. method_deviceFoundCallback = env->GetMethodID(jniCallbackClass, "deviceFoundCallback", "([B)V");

deviceFoundCallback方法最后会来java层的/packages/apps/Bluetooth/src/com/android/bluetooth/btservice/RemoteDevices.java

  1. void deviceFoundCallback(byte[] address) {
  2. // The device properties are already registered - we can send the intent
  3. // now
  4. BluetoothDevice device = getDevice(address);
  5. debugLog("deviceFoundCallback: Remote Address is:" + device);
  6. DeviceProperties deviceProp = getDeviceProperties(device);
  7. if (deviceProp == null) {
  8. errorLog("Device Properties is null for Device:" + device);
  9. return;
  10. }
  11. Intent intent = new Intent(BluetoothDevice.ACTION_FOUND);
  12. intent.putExtra(BluetoothDevice.EXTRA_DEVICE, device);
  13. intent.putExtra(BluetoothDevice.EXTRA_CLASS,
  14. new BluetoothClass(Integer.valueOf(deviceProp.mBluetoothClass)));
  15. intent.putExtra(BluetoothDevice.EXTRA_RSSI, deviceProp.mRssi);
  16. intent.putExtra(BluetoothDevice.EXTRA_NAME, deviceProp.mName);
  17. mAdapterService.sendBroadcast(intent, mAdapterService.BLUETOOTH_PERM);
  18. }

到这里就是给界面发广播，应用层收到广播显示出来，通过这个handle，这个handle可以在BluetoothEventManager.java的构造函数里找到，

  1. addHandler(BluetoothDevice.ACTION_FOUND, new DeviceFoundHandler());
  2. private final BroadcastReceiver mBroadcastReceiver = new BroadcastReceiver() {
  3. @Override
  4. public void onReceive(Context context, Intent intent) {
  5. String action = intent.getAction();
  6. BluetoothDevice device = intent
  7. .getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
  8. Handler handler = mHandlerMap.get(action);
  9. if (handler != null) {
  10. handler.onReceive(context, intent, device);
  11. }
  12. }
  13. };

这里handle对应要看DeviceFoundHandler，也就是下面贴出来的代码，

  1. private class DeviceFoundHandler implements Handler {
  2. public void onReceive(Context context, Intent intent,
  3. BluetoothDevice device) {
  4. ........................
  5. // TODO Pick up UUID. They should be available for 2.1 devices.
  6. // Skip for now, there's a bluez problem and we are not getting uuids even for 2.1.
  7. CachedBluetoothDevice cachedDevice = mDeviceManager.findDevice(device);
  8. if (cachedDevice == null) {
  9. cachedDevice = mDeviceManager.addDevice(mLocalAdapter, mProfileManager, device);
  10. Log.d(TAG, "DeviceFoundHandler created new CachedBluetoothDevice: "
  11. + cachedDevice);
  12. // callback to UI to create Preference for new device
  13. dispatchDeviceAdded(cachedDevice);
  14. }
  15. ......................
  16. }
  17. }

在if语句中dispatchDeviceAdded()向界面分发消息，最后处理消息的地方在这里，已经到settings应用里了

  1. public void onDeviceAdded(CachedBluetoothDevice cachedDevice) {
  2. if (mDevicePreferenceMap.get(cachedDevice) != null) {
  3. return;
  4. }
  5. // Prevent updates while the list shows one of the state messages
  6. if (mLocalAdapter.getBluetoothState() != BluetoothAdapter.STATE_ON) return;
  7. if (mFilter.matches(cachedDevice.getDevice())) {
  8. createDevicePreference(cachedDevice);
  9. }
  10. }

上面代码中最后一个分支就是界面显示要做的事了，从settings界面开始再到settings界面显示出搜索到蓝牙结束，后面的代码不再写了，本文关心的东东到此结束。

  1. void createDevicePreference(CachedBluetoothDevice cachedDevice) {
  2. BluetoothDevicePreference preference = new BluetoothDevicePreference(
  3. getActivity(), cachedDevice);
  4. initDevicePreference(preference);
  5. mDeviceListGroup.addPreference(preference);
  6. mDevicePreferenceMap.put(cachedDevice, preference);
  7. }

到目前为止，包括前面的打开流程分析，还仅是针对代码流程做的分析，对于蓝牙协议方面东西还没有涉及，比如蓝牙是如何发现其它蓝牙设备，这个流程究竟是怎么工作还不是很清楚，后续会尽量关注这些问题，估计看起来就没那么容易，欢迎有经验的朋友指点一二，当然对于本文不足，欢迎拍砖讨论。分享是快乐的，谢谢！

上一篇：Chapter6_访问权限控制_访问权限修饰词


下一篇：android -- 蓝牙 bluetooth （四）OPP文件传输