BLE Serial 技术文档

BLE Serial 技术文档

ble-serial "RFCOMM for BLE" a UART over Bluetooth low energy (4+) bridge for Linux, Mac and Windows 项目地址: https://gitcode.com/gh_mirrors/bl/ble-serial

BLE Serial 是一个强大的工具，它旨在连接 Bluetooth 4.0 及更高版本的低功耗设备到 UART 模块以及标准的 PC、笔记本电脑或 Raspberry Pi。本文档提供了详尽的指导，从安装到使用的每一步，确保您能够顺利地通过这个工具操作蓝牙低能耗设备。

安装指南

标准安装（通过 Python Package Index）

对于大多数用户，使用 pip 是安装 BLE Serial 的最快捷方法：

pip install ble-serial

完成后，系统将添加两个可执行脚本：ble-scan 和主程序 ble-serial。Linux 和 Mac 用户可以直接跳至“使用说明”部分；Windows 用户需参照以下“额外的 Windows 步骤”。

从源代码安装（开发者适用）

开发者可以选择克隆仓库并手动管理依赖：

git clone https://github.com/Jakeler/ble-serial.git
cd ble-serial
python -m venv ble-venv
source ble-venv/bin/activate
pip install -r requirements.txt

之后，可以使用 -m 参数直接运行或者通过 pip install . 来安装并作为模块使用。

额外的 Windows 步骤

由于 Windows 不自带创建虚拟串口的功能，需要安装 com0com 软件来模拟串口。下载并安装签名版本后，运行项目内提供的 ble-com-setup 工具以配置必要的 COM 端口对，例如 BLE <-> COM9。

项目的使用说明

寻找设备

首先确认蓝牙适配器开启，然后运行扫描命令：

ble-scan

这将列出附近可见的设备，MAC地址、信号强度和设备名（如果可用）。

连接设备

一旦选择好设备，利用 ble-serial 命令指定设备地址和其他参数进行连接，例如：

ble-serial -d 设备MAC地址 -w 写UUID -r 读UUID

这里，写UUID 和 读UUID 可以通过深入扫描设备得到。

API使用文档

虽然直接的API使用说明没有在 README 中详细提供，但命令行接口(CLI)的参数和选项构成了非正式的API，允许高级用户通过脚本或自动化流程控制连接、发送和接收数据。例如：

• 使用 -v 增加日志级别以调试。
• 通过 -t 设置连接超时时间。
• 指定 -m 来调整蓝牙包的最大尺寸。

具体的UUID和服务参数应当根据设备的特性和深扫结果来设置。

项目安装方式总结

本节再次强调了多种安装方式，着重于方便性与开发者需求。不论是通过Python包还是源码编译，皆旨在使不同背景的用户都能简便集成 BLE Serial 到其项目中。特别注意Windows平台需要的额外配置，确保 BLE 连接能够成功映射到虚拟串口上，从而实现与传统应用程序的兼容。

ble-serial "RFCOMM for BLE" a UART over Bluetooth low energy (4+) bridge for Linux, Mac and Windows 项目地址: https://gitcode.com/gh_mirrors/bl/ble-serial