本文介绍一种简洁可靠的方案，使用 btfpy 库让树莓派作为 ble 外设（gatt server），自动响应手机端连接请求、按周期推送传感器数据，并支持自定义设备名——无需复杂配置，50 行代码即可运行。
本文介绍一种简洁可靠的方案，使用 btfpy 库让树莓派作为 ble 外设（gatt server），自动响应手机端连接请求、按周期推送传感器数据，并支持自定义设备名——无需复杂配置，50 行代码即可运行。
要在树莓派上实现一个稳定、低开销的 BLE 数据发送服务（例如向 Flutter App 实时传输温湿度、加速度等传感器数据），关键在于：以 GATT Server 模式运行、暴露可通知（Notify）的特征值（Characteristic）、自动处理连接/断连事件，并设置可被识别的设备名称。bluepy 虽常用，但其 Peripheral 类侧重于作为 BLE 中心设备（Central）主动扫描与连接，不适合作为被发现的外设；而 btfpy（基于 BlueZ 的轻量封装）专为构建 BLE 外设服务设计，配置直观、逻辑清晰，是本场景的理想选择。
✅ 快速部署步骤
-
安装依赖
sudo apt update sudo apt install bluetooth bluez libbluetooth-dev libudev-dev pip3 install btfpy
-
配置设备名与服务结构（devices.txt）
创建 devices.txt 文件，定义设备标识、GATT 服务及可通知的特征值：# DEVICE 名将显示在手机 BLE 扫描列表中（解决“N/A”问题） DEVICE = MyRpiSensor TYPE=MESH NODE=1 ADDRESS = B8:27:EB:F1:50:C3 PRIMARY_SERVICE = 1800 LECHAR = Device name PERMIT=06 SIZE=06 UUID=2A00 ; 系统服务：设备名（可选） PRIMARY_SERVICE = 00001122-3344-5566-7788-99AABBCCDDEE LECHAR = SensorData PERMIT=16 SIZE=32 UUID=ABCD ; 自定义服务：索引1，支持 Notify⚠️ 注意：DEVICE = MyRpiSensor 即为手机扫描时显示的设备名；ADDRESS 可留空或填树莓派蓝牙 MAC（hciconfig hci0 | grep "BD Address" 查看），非必需但建议填写。
-
编写核心服务脚本（ble_server.py）
提示词大师-python版下载图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
立即学习“Python免费学习笔记（深入）”；
import btfpy def ble_callback(clientnode, operation, cticn): if operation == btfpy.LE_CONNECT: print(f"[INFO] Client {clientnode} connected") elif operation == btfpy.LE_DISCONNECT: print(f"[INFO] Client {clientnode} disconnected") return btfpy.SERVER_EXIT # 断连后退出服务（可选） elif operation == btfpy.LE_TIMER: # 每5秒触发一次（timerds=50 → 50×0.1s=5s） # 此处替换为真实传感器读取逻辑，例如： # import json; data = json.dumps({"temp": 23.5, "hum": 45}) sensor_data = b"TEMP:23.5,HUM:45" # 示例二进制数据 btfpy.Write_ctic(btfpy.Localnode(), 1, sensor_data, 0) # 写入索引1的Characteristic return btfpy.SERVER_CONTINUE # 初始化蓝牙栈（加载 devices.txt） if btfpy.Init_blue("devices.txt") != 0: print("[ERROR] Failed to initialize Bluetooth") exit(1) # 启动BLE服务器：callback处理事件，50表示5秒定时器（单位：0.1秒） btfpy.Le_server(ble_callback, 50) btfpy.Close_all() -
运行与验证
sudo python3 ble_server.py
使用手机安装 nRF Connect（Android）或 LightBlue（iOS），扫描并连接 MyRpiSensor，启用 SensorData 特征值的 Notify 功能，即可实时接收每5秒推送的数据。
? 关键要点说明
- 设备名可见性：树莓派默认 BLE 名称由系统 bluetoothctl 中的 set-alias 或 /etc/machine-info 控制，但 btfpy 通过 devices.txt 中的 DEVICE 字段强制覆盖，确保扫描列表中显示指定名称。
- 连接自动管理：LE_CONNECT/LE_DISCONNECT 回调由 btfpy 自动触发，无需手动 accept/reject；客户端断连后服务持续运行，等待新连接。
- 数据推送机制：Write_ctic(..., 1, data, 0) 向索引为1的特征值写入数据，并自动触发 Notify（前提是客户端已启用该特征值的 Notify 属性）。
- 安全性提示：生产环境建议添加数据校验、连接数限制及异常捕获；传感器读取部分需根据实际硬件（如 DHT22、BME280）补充驱动逻辑。
此方案摒弃了传统 BLE 库的冗余抽象，以声明式配置 + 事件驱动回调为核心，兼顾简洁性与可靠性，是物联网边缘节点 BLE 上报的理想实践。
