Bleak库在BlueZ后端下的蓝牙设备扫描问题分析

问题背景

在使用Bleak库（版本0.22.3）配合BlueZ后端（版本5.66）进行BLE设备扫描时，用户遇到了一个典型问题：ESP32设备能够在bluetoothctl和btmon工具中显示，但无法通过Bleak的默认扫描模式发现。这个问题出现在Raspberry Pi 5设备上，运行的是Raspberry Pi OS Bookworm系统。

问题现象分析

通过btmon工具的输出可以看到，ESP32设备确实在广播以下信息：

• 设备类型：可连接的无定向广播(ADV_IND)
• 地址类型：公共地址
• 广播数据包含：可发现模式标志、不支持BR/EDR、TX功率级别、128位服务UUID等

然而，Bleak的默认扫描模式却无法发现该设备。经过进一步测试发现，当系统同时运行2.4GHz WiFi热点和蓝牙时，只有被动扫描模式能够工作，而主动扫描模式无法获取设备名称或建立连接。

技术原理

蓝牙与WiFi的频段冲突

2.4GHz WiFi和蓝牙工作在相同的ISM频段(2.4-2.4835GHz)，这会导致两种无线技术之间的干扰：

1. 频段重叠：WiFi信道与蓝牙信道有部分重叠，特别是当WiFi使用20MHz带宽时
2. 共享天线资源：在Raspberry Pi等设备上，WiFi和蓝牙通常共享同一个无线芯片和天线
3. 时序冲突：两种协议的时间调度机制可能互相干扰

扫描模式差异

Bleak支持两种扫描模式：

1. 主动扫描(active)：扫描器发送扫描请求，设备回应扫描响应包（包含更完整的设备信息）
2. 被动扫描(passive)：仅监听广播包，不发送任何请求

在干扰环境下，主动扫描可能因为请求包丢失或响应包丢失而失败，而被动扫描由于不需要双向通信，成功率相对较高。

解决方案

临时解决方案

使用被动扫描模式并配置接受所有设备的匹配模式：

from bleak.backends.bluezdbus.scanner import BlueZScannerArgs
from bleak.backends.bluezdbus.advertisement_monitor import OrPattern
from bleak.assigned_numbers import AdvertisementDataType

PASSIVE_SCANNER_ARGS = BlueZScannerArgs(
    or_patterns=[
        OrPattern(0, AdvertisementDataType.FLAGS, b"\x06"),
        OrPattern(0, AdvertisementDataType.FLAGS, b"\x1a"),
    ]
)

devices = await BleakScanner.discover(
    return_adv=True,
    scanning_mode="passive",
    bluez=PASSIVE_SCANNER_ARGS
)

根本解决方案

1. 关闭WiFi热点：停止2.4GHz WiFi可以减少对蓝牙的干扰
2. 使用5GHz WiFi：如果设备支持，改用5GHz频段的WiFi
3. 外接蓝牙适配器：使用独立的USB蓝牙dongle，避免与WiFi共享射频资源
4. 调整天线位置：优化天线布局可以减少干扰

最佳实践建议

1. 在开发BLE应用时，建议先关闭不必要的无线服务
2. 对于关键应用，实现扫描模式切换逻辑，在主动扫描失败时自动尝试被动扫描
3. 在Raspberry Pi等资源受限设备上，考虑使用有线连接替代WiFi
4. 定期检查系统日志和btmon输出，了解无线环境状况

总结

这个案例展示了在嵌入式开发中常见的无线干扰问题。通过理解蓝牙和WiFi的工作原理，开发者可以更好地诊断和解决类似问题。Bleak库提供了灵活的扫描配置选项，可以帮助开发者在复杂无线环境中实现可靠的设备发现功能。