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

1. 项目基础介绍和主要编程语言

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

该项目主要使用 Python 编程语言编写，并且作为一个 Python 模块进行打包，便于通过 pip 进行安装和管理。

2. 项目使用的关键技术和框架

BLE-Serial 项目主要使用了以下关键技术和框架：

• Python 3: 项目的主要编程语言，用于实现 BLE 连接和串行通信。
• BlueZ: Linux 上的蓝牙协议栈，用于 BLE 设备的扫描和连接。
• pySerial: 用于在不同操作系统上实现串行通信的 Python 库。
• com0com: 在 Windows 上用于创建虚拟串行端口的驱动程序。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统: Linux、Mac 或 Windows。
• Python 3.x: 确保您的系统上安装了 Python 3.x。
• pip: Python 的包管理工具，用于安装 Python 模块。
• 蓝牙适配器: 确保您的计算机上有一个支持 BLE 的蓝牙适配器，并且已经启用。

安装步骤

3.1 安装 BLE-Serial

您可以通过 pip 直接安装 BLE-Serial 模块：

pip install ble-serial

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

3.2 在 Linux/Mac 上的使用

在 Linux 或 Mac 上，安装完成后您可以直接使用 ble-serial 工具。以下是一些基本的使用命令：

• 扫描附近的 BLE 设备:

  ble-scan
  

• 连接到 BLE 设备并创建虚拟串行端口:

  ble-serial -d <设备MAC地址> -s <服务UUID> -c <特征UUID>
  

3.3 在 Windows 上的额外步骤

在 Windows 上，由于系统不支持内置的虚拟串行端口创建功能，您需要安装一个额外的驱动程序 com0com。

1. 下载并安装 com0com:

   • 下载 com0com 驱动程序，并按照安装向导进行安装。
   • 安装完成后，确保驱动程序已正确加载。

2. 配置虚拟串行端口:

   • 使用 ble-com-setup 脚本配置虚拟串行端口对：

     ble-com-setup.exe
     

   • 该脚本将自动创建一个名为 BLE 的虚拟串行端口，并将其与一个 COM 端口配对。

3. 使用 ble-serial:

   • 配置完成后，您可以使用 ble-serial 连接到 BLE 设备，并通过创建的 COM 端口进行通信：

     ble-serial -d <设备MAC地址> -s <服务UUID> -c <特征UUID>
     

4. 总结

通过以上步骤，您已经成功安装并配置了 BLE-Serial 项目。您现在可以使用该工具将 BLE 设备连接到您的计算机，并通过虚拟串行端口进行通信。如果在安装或配置过程中遇到任何问题，请参考项目的 GitHub 页面或相关文档以获取更多帮助。

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