玩转BLE(2)_使用bluepy扫描BLE的广播数据

时间:2023-01-27 11:21:47

1. 前言

在linux平台下,bluez是一个很不错的软件,提供了很多基于命令行的测试工具,如hciconfig、hcitool、hcidump、bluetoothctl等。利用这些工具,我们可以方便的测试、demo各种蓝牙功能。例如,在“玩转BLE(1)_Eddystone beacon”中,我们利用hcitool命令,演示了将手机变成一个Beacon设备的神奇效果。

Beacon的演示,从本质上看,是BLE Advertising(广播)功能的测试和验证。自然而然的,我们会好奇:怎么接收这些广播数据呢(其实就是BLE Scanning功能)?这就是本文要介绍的内容。

虽然hcitool(以及后来的bluetoothctl)可以进行简单的LE scan操作,但返回的结果仅包括简单的地址和名称,显然无法满足我们的需求(要知道,BLE的广播数据可能包含其它内容哦,如我们的Beacon演示)。怎么办呢?不着急,强大的python出马了。

2. bluepy[1]介绍

bluepy是linux平台中,用python脚本封装的BLE接口。为什么用python呢?说实话,在写这篇文章之前,我对python的印象是极其平淡的,但此时却好感大增。以蓝牙的测试为例:

在linux下,bluez提供的原生接口是一个C库(bluetooth lib),我们想利用这个接口,在命令行里面玩转一些功能,几乎不可能;

提供C库的同时,为了图形界面操作方便,bluez又封装出来了一层dbus API。虽然从理论上讲,使用dbus-send等命令,可以满足我们在命令行的测试需求。但是,我觉得没有人喜欢dbus-send后面带的那长长的一串参数……

在开源的世界里,有需求就有动力,因此就出现了很多有python封装的蓝牙API。以BLE为例,bluepy是一个比较好的一个。有了该接口之后,蓝牙功能的测试,真的是很爽!

3. bluepy安装

bluepy的安装非常简单,开始之前先交代一下我的测试环境:

硬件环境是树莓派2(大家随便用一个运行linux的PC、开发板应该都okay);

OS是raspbian(Ubuntu),版本应该不是很重要;

bluez的版本是5.23(比较新的一个版本了,不过旧版本应该也没有问题)。


安装bluepy只需要两个命令,如下:

#安装python的包管理工具—pip

sudo apt-get install python-pip libglib2.0-dev

#使用pip安装bluepy

sudo pip install bluepy


4. 使用bluepy

本章我们将使用bluepy的Scanner class,扫描正在广播的BLE设备。bluepy的文档中有sample code:
http://ianharvey.github.io/bluepy-doc/scanner.html

在本地新建一个python脚本(ble_scan.py),将sample code中的代码拷贝进去即可,如下:
from bluepy.btle import Scanner, DefaultDelegate

class ScanDelegate(DefaultDelegate): 
    def __init__(self): 
        DefaultDelegate.__init__(self)

def handleDiscovery(self, dev, isNewDev, isNewData): 
        if isNewDev: 
            print "Discovered device", dev.addr 
        elif isNewData: 
            print "Received new data from", dev.addr

scanner = Scanner().withDelegate(ScanDelegate()) 
devices = scanner.scan(10.0)

for dev in devices: 
    print "Device %s (%s), RSSI=%d dB" % (dev.addr, dev.addrType, dev.rssi) 
    for (adtype, desc, value) in dev.getScanData(): 
        print "  %s = %s" % (desc, value)

按照“玩转BLE(1)_Eddystone beacon”中的说明,将自己的手机变成一个Eddystone Beacon设备。然后执行python脚本,扫描:

sudo python ble_scan.py

结果如下:

pi@raspberrypi:~$ sudo python ble_scan.py 
Discovered device cb:07:c8:52:ce:d6 
Discovered device 18:dc:56:a6:25:6f 
Device 18:dc:56:a6:25:6f (public), RSSI=-59 dB 
  Flags = 06 
  Complete 16b Services = aafe 
  16b Service Data = aafe00f0000102030405060708090a0b0e0f000000 
Device cb:07:c8:52:ce:d6 (random), RSSI=-85 dB 
  Complete Local Name = My Mambo 
  Complete 16b Services = e7fe 
  Manufacturer = 0000cb07c852ced6 
  128b Service Solicitation = d0002d121e4b0fa4994eceb531f40579 
  Flags = 06

对比一下我们在“玩转BLE(1)_Eddystone beacon”中广播的数据(对应三个颜色):

1e 02 01 06 03 03 aa fe 17 16 aa fe 00 -10 00 01 02 03 04 05 06 07 08 09 0a 0b 0e 0f 00 00 00 00

成功了!

5. 总结

本文简单的介绍了利用bluepy功能,扫描BLE的广播包的过程。并没有对bluepy的软件逻辑,以及BLE Advertising的细节,做过多的说明,感兴趣的同学可以自行阅读,不理解的地方可以留言讨论。

另外,后续BLE Advertising & Scanning有关的分析文章中,会借助该工具,以帮助理解。

6. 参考文档

[1] bluepy github主页,https://github.com/IanHarvey/bluepy
 
原创文章,转发处蜗窝科技,www.wowotech.net。