跳转到主要内容
用 BLE 嗅探器 Net 抓取低功耗蓝牙空口流量。嗅探器是一个运行 Nordic nRF Sniffer for Bluetooth LE 固件的 nRF52840 Dongle。抓包在脚本自己的进程中运行,并在整个时长内阻塞。

导入

方法

Net.get(name, type=NetType.BleSniffer)

capture(duration=10.0, follow=None, address_type=None, follow_by_name=None, only_advertising=False, coded=False, rssi_cut_off=None, out=None)

附加运行的 lager python 在 300 秒时结束(包括启动时间),所以附加运行中的抓包应少于约 280 秒,更长的抓包请分离运行。pcap 先写到 <out>.part,抓包结束时再重命名为 out。在开始阶段就失败的抓包不会改动已有的 out。 返回: 一个 dict,包含以下键: 异常:
  • ValueError:某个选项类型错误或超出范围,或两个选项冲突。此时不会访问嗅探器。
  • BleSnifferBusyError(来自 lager.protocols.ble_sniffer):另一次抓包占用着嗅探器。
  • BleSnifferBackendError(来自 lager.exceptions):抓包失败。嗅探器不在 USB 上、另一个程序占用了其串口,或在 2 秒内没有应答。没有应答的嗅探器需要拔下并重新插入。抓包中途停止应答时,之前记录的包保留在 out 中,消息会给出包数。
在 lager python 下,默认文件位于本次运行的输出文件夹中,所以 --download 会把它取回你的电脑。

status()

返回一个 dict,包含 serial、port(嗅探器不在 USB 上时为 None)、present 和 busy。它不会打开嗅探器。

示例

超过 300 秒的抓包需要分离运行:lager python sniff.py --detach。

说明

  • pcap 的链路类型是 NORDIC_BLE(272)。Wireshark 和 tshark 都能解码。
  • 刷写 Dongle 和添加 Net 的方法参见 CLI 参考。