NimBLE-Arduino 项目教程

1. 项目目录结构及介绍

NimBLE-Arduino 项目的目录结构如下：

NimBLE-Arduino/
├── examples/
│   ├── BLE_Beacon_Scanner/
│   ├── BLE_EddystoneTLM_Beacon/
│   ├── BLE_EddystoneURL_Beacon/
│   ├── NimBLE_Client/
│   ├── NimBLE_Server/
│   └── Refactored_original_examples/
├── src/
│   ├── NimBLEDevice.h
│   ├── nimconfig.h
│   └── ...
├── .gitignore
├── CHANGELOG.md
├── LICENSE
├── README.md
└── library.properties

目录结构介绍

• examples/: 包含多个示例项目，展示了如何使用 NimBLE-Arduino 库进行蓝牙低功耗（BLE）通信。

  • BLE_Beacon_Scanner/: 扫描 BLE Beacon 的示例。
  • BLE_EddystoneTLM_Beacon/: 使用 Eddystone TLM Beacon 的示例。
  • BLE_EddystoneURL_Beacon/: 使用 Eddystone URL Beacon 的示例。
  • NimBLE_Client/: 作为 BLE 客户端的示例。
  • NimBLE_Server/: 作为 BLE 服务器的示例。
  • Refactored_original_examples/: 重构的原始示例，展示了与原始库的差异。

• src/: 包含 NimBLE-Arduino 库的核心源代码文件。

  • NimBLEDevice.h: 主要的库头文件，包含初始化和设备配置的函数。
  • nimconfig.h: 配置文件，用于自定义 NimBLE 的设置，如最大连接数等。

• .gitignore: Git 忽略文件，指定哪些文件和目录不需要被版本控制。

• CHANGELOG.md: 记录项目的变更日志，包含每个版本的更新内容。

• LICENSE: 项目的开源许可证文件，采用 Apache-2.0 许可证。

• README.md: 项目的介绍文件，包含项目的基本信息、安装指南和使用说明。

• library.properties: Arduino 库的属性文件，包含库的名称、版本号等信息。

2. 项目启动文件介绍

项目的启动文件主要是 src/NimBLEDevice.h。这个文件包含了初始化 BLE 设备和配置 BLE 服务的主要函数。

主要函数

• NimBLEDevice::init(const char deviceName)*: 初始化 BLE 设备，deviceName 是设备的名称。
• NimBLEDevice::setPower(int8_t power): 设置 BLE 设备的传输功率。
• NimBLEDevice::setScanParams(uint16_t interval, uint16_t window): 设置扫描参数，interval 是扫描间隔，window 是扫描窗口。

示例代码

#include "NimBLEDevice.h"

void setup() {
    // 初始化 BLE 设备
    NimBLEDevice::init("MyDevice");

    // 设置传输功率
    NimBLEDevice::setPower(4);

    // 设置扫描参数
    NimBLEDevice::setScanParams(100, 100);
}

void loop() {
    // 主循环代码
}

3. 项目的配置文件介绍

项目的配置文件是 src/nimconfig.h。这个文件允许用户自定义 NimBLE 的配置，如最大连接数、扫描参数等。

主要配置项

• CONFIG_BT_NIMBLE_MAX_CONNECTIONS: 设置最大连接数，默认值为 3。
• CONFIG_BT_NIMBLE_MAX_BONDS: 设置最大绑定数。
• CONFIG_BT_NIMBLE_MAX_SCAN_FILTERS: 设置最大扫描过滤器数。
• CONFIG_BT_NIMBLE_MAX_PERIODIC_SYNCS: 设置最大周期同步数。

示例配置

#define CONFIG_BT_NIMBLE_MAX_CONNECTIONS 5
#define CONFIG_BT_NIMBLE_MAX_BONDS 4
#define CONFIG_BT_NIMBLE_MAX_SCAN_FILTERS 3
#define CONFIG_BT_NIMBLE_MAX_PERIODIC_SYNCS 2

通过修改 nimconfig.h 文件中的配置项，用户可以根据项目需求调整 NimBLE 的行为。