Python玩转蓝牙数据：从设备发现到特征值读取全攻略315

各位科技爱好者，编程达人们！
你是否曾设想，让你的Python程序也能拥有一双“数字之眼”，去感知和读取身边那些无处不在的蓝牙设备发出的“心跳”数据？从智能手环的心率，到环境传感器的温湿度，再到各种IoT设备的实时状态——蓝牙技术，作为物联网世界里不可或缺的短距离无线通信桥梁，正以前所未有的速度渗透进我们的生活。
今天，作为你的中文知识博主，我就来手把手教你，如何利用强大的Python编程语言，优雅地“解锁”蓝牙设备的秘密，实现数据的读取与交互。准备好了吗？让我们一起踏上这场充满“感知力”的编程之旅吧！

在深入代码之前，我们先来快速温习一下蓝牙技术的基础知识，特别是Python编程中最常打交道的“低功耗蓝牙”（Bluetooth Low Energy, BLE）。与传统蓝牙（Bluetooth Classic）不同，BLE以其超低的功耗、快速连接和简化协议栈的优势，成为物联网设备的首选。

理解BLE，关键在于理解两个核心概念：GAP（Generic Access Profile）和GATT（Generic Attribute Profile）。GAP描述了设备如何通过广播（Advertising）和扫描（Scanning）来发现彼此，并建立连接。你可以把它想象成蓝牙设备之间的“相亲会”，设备通过广播自己的“简历”（包含设备名称、服务UUID等信息），其他设备则通过扫描来寻找“心仪的对象”。

而GATT则是在设备连接后，描述数据组织和交互方式的协议。GATT将数据组织成服务（Services）、特征（Characteristics）和描述符（Descriptors）的层次结构。你可以把服务想象成图书馆的不同“分区”（如“心率区”、“温湿度区”），每个分区里有许多“书籍”（特征），每本书又可能有“备注”（描述符）。我们要读取的数据，通常就存储在这些“特征”的值（Value）中。每个服务和特征都有一个唯一的标识符，称为UUID（Universally Unique Identifier），这在编程中是定位数据的关键。

Python作为一门以简洁、高效著称的语言，拥有丰富的第三方库生态系统。在蓝牙编程领域，虽然有`pybluez`、`bluepy`（Linux特有）等选择，但对于现代BLE应用，我强烈推荐使用`bleak`。`bleak`是一个异步、跨平台的BLE客户端库，支持Windows、Linux和macOS，能够优雅地处理BLE设备的发现、连接和数据交互，是实现我们目标的不二之选。

首先，我们来安装`bleak`库。确保你的Python环境已准备就绪，并在终端或命令提示符中运行以下命令：
pip install bleak asyncio
注意，`bleak`是基于Python的`asyncio`异步框架构建的，因此在编写代码时，我们需要使用异步函数（`async def`）和等待操作（`await`）。

第一步：扫描和发现蓝牙设备
就像前文提到的“相亲会”，我们要做的第一件事就是扫描周围的蓝牙设备。`bleak`让这个过程变得异常简单。

import asyncio
from bleak import BleakScanner
async def scan_devices():
print("开始扫描蓝牙设备...")
# 扫描30秒，你可以调整这个时间
devices = await (timeout=30.0)

if not devices:
print("未发现任何蓝牙设备。")
return
print("发现以下蓝牙设备：")
for i, device in enumerate(devices):
print(f"[{i}] { if else '未知设备'} (地址: {})")
if __name__ == "__main__":
(scan_devices())

运行这段代码，它会列出你附近所有正在广播的蓝牙设备，包括它们的名称和MAC地址。记下你想要连接的设备的名称或地址，这在下一步中会用到。

第二步：连接到目标设备
找到目标设备后，下一步就是建立连接。这里我们将使用`BleakClient`类。

import asyncio
from bleak import BleakClient, BleakScanner
import sys
# 假设你要连接的设备名称或地址
TARGET_DEVICE_NAME = "你的设备名称" # 例如 "ESP32_BLE_Sensor" 或 "MySmartWatch"
# 或者使用设备的MAC地址
# TARGET_DEVICE_ADDRESS = "XX:XX:XX:XX:XX:XX"
async def connect_to_device(target_identifier):
print(f"尝试连接到设备: {target_identifier}...")

# 查找设备
device = None
devices = await (timeout=10.0)
for d in devices:
if == target_identifier or == target_identifier:
device = d
break

if not device:
print(f"未找到目标设备: {target_identifier}")
return
# 建立连接
async with BleakClient() as client:
if client.is_connected:
print(f"成功连接到 {} (地址: {})")
# 在这里可以进行后续的数据读取操作
# 例如：await read_characteristics(client)
else:
print(f"无法连接到 {} (地址: {})")
if __name__ == "__main__":
# 请替换为你的目标设备名称或地址
(connect_to_device(TARGET_DEVICE_NAME))
# 或者 (connect_to_device(TARGET_DEVICE_ADDRESS))

成功连接后，`client.is_connected`将为`True`。现在，我们已经与蓝牙设备建立了通信桥梁！

第三步：发现服务和特征
连接成功后，我们需要知道设备提供了哪些服务和特征，以便找到我们想要读取的数据。

import asyncio
from bleak import BleakClient, BleakScanner
import sys
TARGET_DEVICE_NAME = "你的设备名称"
async def discover_services_and_characteristics(client):
print("发现设备的服务和特征...")
for service in :
print(f" 服务: {} ({})")
for char in :
print(f" 特征: {} ({}) - 属性: {}")
for descriptor in :
print(f" 描述符: {} ({})")
async def main():
device = None
devices = await (timeout=10.0)
for d in devices:
if == TARGET_DEVICE_NAME:
device = d
break

if not device:
print(f"未找到目标设备: {TARGET_DEVICE_NAME}")
return
async with BleakClient() as client:
if client.is_connected:
print(f"成功连接到 {}")
await discover_services_and_characteristics(client)
else:
print(f"无法连接到 {}")
if __name__ == "__main__":
(main())

这段代码会打印出设备支持的所有服务、特征及其UUID。这些UUID是后续读取特征值的关键标识。通常，设备的制造商会提供BLE服务的文档，其中包含各个特征的UUID及其含义。

第四步：读取特征值
这是我们最期待的一步！有了特征的UUID，我们就可以使用`client.read_gatt_char()`方法来读取其值。

import asyncio
from bleak import BleakClient, BleakScanner
import sys
TARGET_DEVICE_NAME = "你的设备名称"
# 替换为你要读取的特征UUID，例如：心率服务的心率测量特征UUID
# 这个UUID需要根据你的具体蓝牙设备文档来查找
TARGET_CHARACTERISTIC_UUID = "00002a37-0000-1000-8000-00805f9b34fb" # 举例：心率测量UUID
async def read_specific_characteristic(client, char_uuid):
try:
# 读取特征值，返回的是bytes类型
value = await client.read_gatt_char(char_uuid)
print(f"成功读取特征 {char_uuid} 的值: {value}")

# 根据特征值的具体含义进行解析
# 例如，如果是一个表示温度的2字节整数：
# temperature = int.from_bytes(value, byteorder='little', signed=True) / 100
# print(f"解析后的温度: {temperature}°C")

# 如果是字符串：
# my_string = ('utf-8')
# print(f"解析后的字符串: {my_string}")

except Exception as e:
print(f"读取特征 {char_uuid} 失败: {e}")
async def main_read():
device = None
devices = await (timeout=10.0)
for d in devices:
if == TARGET_DEVICE_NAME:
device = d
break

if not device:
print(f"未找到目标设备: {TARGET_DEVICE_NAME}")
return
async with BleakClient() as client:
if client.is_connected:
print(f"成功连接到 {}")
await read_specific_characteristic(client, TARGET_CHARACTERISTIC_UUID)
else:
print(f"无法连接到 {}")
if __name__ == "__main__":
(main_read())

重要提示： `read_gatt_char()`返回的是`bytes`类型的数据。你需要根据你设备的特征定义（通常在设备的技术文档中）来解析这些字节，将其转换为有意义的数据类型，例如整数、浮点数或字符串。示例代码中提供了一些常见的解析方式。

第五步：订阅通知（Notifications）和指示（Indications）
有些蓝牙设备并不会让你主动去“拉取”数据，而是会在数据变化时主动“推送”给你，这便是通知（Notifications）和指示（Indications）。它们在概念上类似，只是指示会要求接收方发送确认。对于实时数据流（如心率、运动传感器数据），订阅通知是更常见和高效的方式。

import asyncio
from bleak import BleakClient, BleakScanner
from datetime import datetime
TARGET_DEVICE_NAME = "你的设备名称"
TARGET_NOTIFY_CHAR_UUID = "你的通知特征UUID" # 例如心率测量UUID
# 回调函数，当收到通知时会被调用
def notification_handler(sender, data):
# sender 是特征的UUID，data 是bytes类型的值
print(f"[{().strftime('%H:%M:%S')}] 从 {sender} 收到数据: {data}")
# 解析数据...
# 例如，如果心率是第二个字节，表示一个整数
if len(data) >= 2:
heart_rate = int(data[1])
print(f"解析的心率: {heart_rate} bpm")

async def subscribe_to_notifications():
device = None
devices = await (timeout=10.0)
for d in devices:
if == TARGET_DEVICE_NAME:
device = d
break

if not device:
print(f"未找到目标设备: {TARGET_DEVICE_NAME}")
return
async with BleakClient() as client:
if client.is_connected:
print(f"成功连接到 {}，开始订阅通知...")
await client.start_notify(TARGET_NOTIFY_CHAR_UUID, notification_handler)
print("正在监听通知，按 Ctrl+C 停止...")

# 让程序持续运行，直到用户中断
await (600) # 监听10分钟，或直到手动停止

await client.stop_notify(TARGET_NOTIFY_CHAR_UUID)
print("停止订阅通知。")
else:
print(f"无法连接到 {}")
if __name__ == "__main__":
(subscribe_to_notifications())

在回调函数`notification_handler`中，你可以对接收到的`data`进行实时解析和处理。这是一个强大的功能，让你的Python程序能够成为蓝牙设备的实时数据仪表盘。

编程提示与注意事项：
1. 操作系统权限： 在Windows上，你可能需要确保你的蓝牙适配器驱动是最新版本。在Linux上，`bleak`通常需要使用`sudo`权限或正确的`udev`规则来访问蓝牙硬件。macOS通常开箱即用。
2. UUID查找： 最可靠的方式是查阅你的蓝牙设备制造商提供的开发文档或BLE服务规范。此外，有些手机APP（如Nordic nRF Connect、LightBlue）也可以帮助你扫描并查看设备的GATT结构。
3. 异步编程： `asyncio`是`bleak`的基石。如果你不熟悉异步编程，可能需要花一些时间理解`async def`和`await`的工作方式。
4. 错误处理： 蓝牙通信可能受距离、干扰、设备电量等因素影响。在实际项目中，务必加入`try...except`块来捕获`BleakError`或其他异常，提高程序的健壮性。
5. 数据解析： `bytes`到有意义数据的转换是蓝牙编程的常见挑战。请务必对照设备文档，了解每个特征值的字节顺序（大端/小端）、数据类型（int8、uint16、float等）和比例因子。

好了，通过这篇详细的教程，你已经掌握了使用Python `bleak`库读取蓝牙设备数据的核心技能。从发现设备、建立连接，到解析服务特征，再到读取静态值和订阅实时通知，你的Python代码现在拥有了“感知”物理世界的能力。

现在，拿起你的Python解释器，连接你的蓝牙设备，开始探索这个充满数据的无线世界吧！无论是DIY智能家居、健康监测，还是工业自动化，Python与蓝牙的结合都将为你开启无限可能。如果你在实践中遇到任何问题，欢迎在评论区留言交流，我们一起学习，共同进步！

2026-04-03

---

上一篇：Python硬件编程实践：解锁树莓派与MicroPython的智能世界

下一篇：Python 界面编程：Tkinter、PyQt、Kivy与WxPython，打造你的第一个桌面应用！