BLE-Serial 项目下载及安装教程

BLE-Serial 项目下载及安装教程

1. 项目介绍

BLE-Serial 是一个用于将蓝牙 4.0+ 低功耗（BLE）连接到 UART 模块以及普通 PC、笔记本电脑或 Raspberry Pi 的工具。它实现了与旧版蓝牙 2.0 的 rfcomm bind 相同的功能，创建了一个虚拟串行端口（如 /dev/pts/x），使其可以与任何终端或应用程序一起使用。在 Windows 上，它提供了一个 COM 端口，类似于 Microsoft 的“标准串行蓝牙”驱动程序。

2. 项目下载位置

项目源代码托管在 GitHub 上，可以通过以下命令进行克隆：

git clone https://github.com/Jakeler/ble-serial.git

3. 项目安装环境配置

3.1 系统要求

• Linux、Mac 或 Windows 操作系统
• Python 3.6 或更高版本
• 蓝牙适配器支持 BLE 4.0+

3.2 环境配置步骤

3.2.1 安装 Python 和 pip

确保系统中已安装 Python 和 pip。可以通过以下命令检查：

python --version
pip --version

如果未安装，请根据操作系统安装 Python 和 pip。

3.2.2 创建虚拟环境（可选）

为了隔离项目依赖，建议创建一个虚拟环境：

python -m venv ble-venv
source ble-venv/bin/activate  # 在 Windows 上使用 `ble-venv\Scripts\activate`

3.2.3 安装依赖

在项目根目录下，运行以下命令安装依赖：

pip install -r requirements.txt

3.3 环境配置示例

4. 项目安装方式

4.1 通过 pip 安装

可以直接使用 pip 安装 BLE-Serial：

pip install ble-serial

安装完成后，你将拥有两个新的脚本：ble-scan 和 ble-serial。

4.2 从源代码安装

如果你需要对项目进行修改或开发，可以从源代码安装：

git clone https://github.com/Jakeler/ble-serial.git
cd ble-serial
pip install .

5. 项目处理脚本

5.1 ble-scan

用于扫描附近的 BLE 设备：

ble-scan

5.2 ble-serial

主要工具，用于创建 BLE 到串行端口的桥接：

ble-serial -d DEVICE_MAC -s SERVICE_UUID

5.3 ble-com-setup（仅限 Windows）

在 Windows 上，需要安装额外的驱动程序来创建虚拟串行端口。ble-com-setup 脚本可以帮助你完成这一配置：

ble-com-setup.exe

总结

通过以上步骤，你可以成功下载并安装 BLE-Serial 项目，并配置好相应的环境。希望这篇教程对你有所帮助！