BTLE 项目使用教程

1. 项目介绍

BTLE 是一个基于软件定义无线电（SDR）的蓝牙低功耗（BLE）软件套件，旨在提供一个开源的解决方案来进行 BLE 数据包的嗅探和传输。该项目不仅支持标准的 BLE 协议，还支持非标准的（原始比特）模式，使得开发者可以测试和实现各种自定义的 BLE 协议。BTLE 项目的主要目标是推动 BLE 技术的开放性和创新性，特别是在物联网（IoT）和无线传感器网络（WSN）领域。

2. 项目快速启动

2.1 环境准备

在开始之前，请确保你的 SDR 硬件环境（驱动/库）已经正确设置。BTLE 项目支持 HackRF 和 bladeRF 硬件。

2.2 安装步骤

1. 克隆项目仓库：

   git clone https://github.com/JiaoXianjun/BTLE.git
   

2. 进入项目目录：

   cd BTLE/host
   

3. 创建构建目录并进入：

   mkdir build
   cd build
   

4. 使用 CMake 配置构建环境（默认使用 HackRF）：

   cmake ..
   

   如果你使用的是 bladeRF，请使用以下命令：

   cmake .. -DUSE_BLADERF=1
   

5. 编译项目：

   make
   

2.3 运行示例

1. 运行 BLE 嗅探器（默认在通道 37）：

   ./btle-tools/src/btle_rx
   

2. 运行 BLE 数据包发送器（示例：在 ADV 通道发送发现数据包）：

   ./btle-tools/src/btle_tx 37-DISCOVERY-TxAdd-1-RxAdd-0-AdvA-010203040506-LOCAL_NAME09-SDR/Bluetooth/Low/Energy
   

3. 应用案例和最佳实践

3.1 室内定位

BTLE 可以用于实现室内定位系统（IPS），通过嗅探 BLE 信标的数据包，结合信号强度（RSSI）和通道信息，可以计算出设备的位置。

3.2 物联网设备调试

开发者可以使用 BTLE 来调试和验证自定义的 BLE 设备，特别是在开发阶段，通过嗅探和发送数据包，可以快速定位和解决通信问题。

3.3 安全测试

BTLE 可以用于安全测试，通过嗅探和分析 BLE 数据包，可以发现潜在的安全漏洞，并进行相应的防护措施。

4. 典型生态项目

4.1 HackRF

HackRF 是一款开源的软件定义无线电（SDR）平台，广泛用于无线通信的研究和开发。BTLE 项目与 HackRF 结合，可以实现强大的 BLE 数据包嗅探和传输功能。

4.2 bladeRF

bladeRF 是另一款开源的 SDR 平台，BTLE 项目也支持 bladeRF，提供了更多的硬件选择和灵活性。

4.3 GNU Radio

GNU Radio 是一个开源的软件无线电框架，BTLE 项目可以与 GNU Radio 结合，进一步扩展其功能和应用场景。

通过以上步骤，你可以快速上手 BTLE 项目，并利用其强大的功能进行 BLE 相关的开发和研究。