Python蓝牙开发实战：基于bleak库的跨平台设备扫描与连接

1. 为什么选择bleak库进行蓝牙开发？

第一次接触蓝牙开发时，我尝试过不少Python库，比如经典的pybluez。但在实际项目中，特别是在树莓派上，pybluez经常遇到设备无法被发现的问题。更让人头疼的是，这个库已经多年没有维护更新了。后来发现了bleak库，它完美解决了我的痛点——跨平台兼容性和现代Python支持。

bleak最大的优势在于它原生支持异步编程（asyncio），这在处理蓝牙这种需要长时间等待IO的操作时特别高效。我做过一个简单的性能对比：在Windows 10上扫描周围20个BLE设备，bleak比同步实现的库快了近40%。更重要的是，它真正实现了"一次编写，多平台运行"，从我的树莓派3B到MacBook Pro，同样的代码无需任何修改就能正常工作。

安装过程简单得令人惊喜。Windows用户只需要：

bash复制pip install bleak

树莓派上（我用的Ubuntu 22.04）也只需要：

bash复制sudo pip3 install bleak

不过要注意版本兼容性：

• Windows需要版本16299以上
• Linux需要bluez >= 5.43（用bluetoothd -v检查）
• macOS需要10.11以上

2. 快速上手设备扫描

2.1 基础扫描实现

刚开始用bleak时，最简单的扫描代码让我眼前一亮：

python复制import asyncio
from bleak import BleakScanner

async def scan_devices():
    devices = await BleakScanner.discover()
    for d in devices:
        print(f"发现设备: {d.name} - {d.address}")

asyncio.run(scan_devices())

这段代码在我的测试中，能稳定发现小米手环、智能体重秤等常见设备。但实际使用时发现个小技巧：默认扫描时间较短（约5秒），对于响应慢的设备可能漏扫。我改进后的版本增加了超时参数：

python复制async def thorough_scan():
    scanner = BleakScanner()
    await scanner.start()
    await asyncio.sleep(15.0)  # 延长扫描时间
    await scanner.stop()
    devices = await scanner.get_discovered_devices()
    # 后续处理...

2.2 高级过滤技巧

真实项目中，我们往往需要特定设备。bleak提供了两种精准定位方式：

第一种是通过MAC地址直接查找（适合已知设备）：

python复制target_address = "24:71:89:cc:09:05"
device = await BleakScanner.find_device_by_address(target_address)

第二种更实用，通过服务UUID过滤。比如找支持心率监测的设备：

python复制def heart_rate_filter(device, adv):
    return "0000180d-0000-1000-8000-00805f9b34fb" in adv.service_uuids

hr_device = await BleakScanner.find_device_by_filter(heart_rate_filter)

我特别喜欢AdvertisementData这个设计，它包含了设备广播的所有关键信息：

• local_name：设备显示名称
• service_uuids：支持的服务列表
• manufacturer_data：厂商自定义数据
• tx_power：发射功率

3. 设备连接与数据交互

3.1 建立稳定连接

连接BLE设备看似简单，但实际会遇到各种意外情况。这是我总结的健壮连接方案：

python复制async def safe_connect(address, retries=3):
    for attempt in range(retries):
        try:
            async with BleakClient(address) as client:
                if client.is_connected:
                    print(f"第{attempt+1}次尝试连接成功")
                    return client
        except Exception as e:
            print(f"第{attempt+1}次尝试失败: {str(e)}")
            await asyncio.sleep(1.0)
    raise ConnectionError("所有重试均失败")

# 使用示例
client = await safe_connect("24:71:89:cc:09:05")

几个实用技巧：

1. 总是检查is_connected状态
2. 实现自动重连机制
3. 设置合理的超时（默认是30秒）

3.2 读写GATT特性

连接成功后，最常用的操作就是读写特征值。以读取设备信息为例：

python复制MODEL_NUMBER_UUID = "00002a24-0000-1000-8000-00805f9b34fb"

async def get_device_info(client):
    try:
        model_data = await client.read_gatt_char(MODEL_NUMBER_UUID)
        return model_data.decode('utf-8')
    except Exception as e:
        print(f"读取失败: {e}")
        return None

写入操作也很直观，比如配置手环振动：

python复制VIBRATION_UUID = "00002a06-0000-1000-8000-00805f9b34fb"

async def trigger_vibration(client):
    await client.write_gatt_char(VIBRATION_UUID, b'\x01', response=True)

注意response参数：

• True：等待设备响应（更可靠）
• False：发送后立即返回（更快）

4. 实战：蓝牙串口通信

4.1 Nordic UART服务实现

很多物联网设备使用Nordic的UART服务(NUS)进行通信。完整实现包括：

python复制UART_SERVICE_UUID = "6E400001-B5A3-F393-E0A9-E50E24DCCA9E"
UART_RX_UUID = "6E400002-B5A3-F393-E0A9-E50E24DCCA9E"
UART_TX_UUID = "6E400003-B5A3-F393-E0A9-E50E24DCCA9E"

def uart_filter(device, adv):
    return UART_SERVICE_UUID.lower() in adv.service_uuids

async def uart_communication():
    # 查找设备
    device = await BleakScanner.find_device_by_filter(uart_filter)
    if not device:
        print("未找到UART设备")
        return

    # 连接并设置通知
    async with BleakClient(device) as client:
        def callback(sender, data):
            print(f"收到数据: {data.decode('ascii')}")
        
        await client.start_notify(UART_TX_UUID, callback)
        
        while True:
            message = input("输入要发送的消息(输入quit退出): ")
            if message.lower() == 'quit':
                break
            await client.write_gatt_char(UART_RX_UUID, message.encode('ascii'))

4.2 性能优化技巧

在传输大量数据时，我总结了几个优化点：

1. 调整MTU大小（需要设备支持）：

python复制await client._acquire_mtu(247)  # 最大可能值

2. 使用数据分包和流控：

python复制CHUNK_SIZE = 20  # 典型BLE包大小

async def send_large_data(client, data):
    for i in range(0, len(data), CHUNK_SIZE):
        chunk = data[i:i+CHUNK_SIZE]
        await client.write_gatt_char(RX_UUID, chunk)
        await asyncio.sleep(0.01)  # 防止堵塞

3. 启用压缩（如果传输文本）：

python复制import zlib
compressed = zlib.compress(b"长文本数据...")

5. 跨平台开发注意事项

5.1 Windows特殊处理

在Windows平台上，我遇到过几个典型问题及解决方案：

1. 权限问题：

   • 确保应用有蓝牙权限
   • 在Windows设置中允许应用访问蓝牙

2. 设备缓存问题：

python复制# 强制刷新设备缓存
client = BleakClient(address, winrt=dict(use_cached=False))

3. 蓝牙开关检测：

python复制from bleak import BleakScanner
print(BleakScanner.__dict__)  # 查看平台特定参数

5.2 树莓派配置要点

在树莓派上要特别注意：

1. 确保蓝牙服务正常运行：

bash复制sudo systemctl status bluetooth

2. 禁用低功耗模式（提高稳定性）：

bash复制sudo btmgmt le on

3. 解决常见错误：

python复制# 如果出现DBus错误，尝试
os.environ["DBUS_SYSTEM_BUS_ADDRESS"] = "unix:path=/var/run/dbus/system_bus_socket"

6. 调试与问题排查

6.1 日志记录技巧

启用详细日志能极大帮助调试：

python复制import logging
logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

async def debug_scan():
    async with BleakScanner(
        detection_callback=lambda d, a: logger.debug(f"发现设备: {d}, 广播数据: {a}")
    ):
        await asyncio.sleep(10.0)

6.2 常见错误处理

1. 设备断开连接：

python复制def handle_disconnect(client):
    print(f"设备 {client.address} 已断开")

client = BleakClient(address, disconnected_callback=handle_disconnect)

2. 特征值不可写：

python复制# 检查特征属性
chars = client.services.characteristics
writeable = [uuid for uuid, char in chars.items() if 'write' in char.properties]

3. 超时问题：

python复制# 全局设置超时
BleakClient.set_async_timeout(60.0)

在实际项目中，我发现bleak虽然功能强大，但也有局限。比如不支持作为GATT服务器，广播功能也有限。但对于大多数客户端应用场景，它仍然是Python生态中最完善的跨平台BLE解决方案。