ESP32 BLE 详解与开发实战

最新推荐文章于 2025-03-31 15:11:02 发布

跑起来总会有风

最新推荐文章于 2025-03-31 15:11:02 发布

阅读量1.8k

点赞数 30

文章标签：后端嵌入式硬件 c语言

本文链接：https://blog.csdn.net/weixin_47393733/article/details/145974439

版权

文章目录

随着物联网（IoT）的发展， 低功耗蓝牙（BLE） 成为连接智能硬件与移动终端的关键技术之一。ESP32 模组则以其 高性能、低功耗、集成 Wi-Fi & BLE 的特性，广受开发者青睐。本文将介绍 ESP32 的 BLE 功能、开发环境和典型应用示例，帮助你快速上手。

一、ESP32 简介

ESP32 是乐鑫（Espressif）推出的高性价比 SoC，集成了：

双核 Tensilica LX6 处理器（或单核版本）
2.4GHz Wi-Fi
蓝牙（Dual-mode）：包括 BLE（Bluetooth Low Energy）与传统 Bluetooth BR/EDR
丰富的外设接口，如 UART、I2C、SPI、ADC 等

在低功耗蓝牙方面，ESP32 支持BLE 4.2 规范（部分功能可兼容 5.x），可以快速用于智能家居、可穿戴设备、数据传感等领域。

二、BLE 基本概念与特征

1. BLE 与传统蓝牙的区别

功耗低：BLE 主要针对低速、低数据量的场景，耗能大幅下降；
数据传输：BLE 通常以短包传输、间歇式广播和连接；
角色分工：常见角色包括 Central（中心设备）、Peripheral（外设设备）、Broadcaster、Observer 等；
Profile/GATT：BLE 使用通用属性协议（GATT）来组织数据，实现互操作性。

2. BLE 协议栈简述

Controller：处理物理层（PHY）和链路层（LL）等底层通信；
Host：实现上层协议，包括 L2CAP、ATT、GATT、SM（安全管理）等；
Application：具体的用户逻辑，例如智能灯、心率监测等。

在 ESP32 的软件框架中，这些协议栈由官方 IDF 或 ArduinoCore 提供并封装了大部分复杂性。

三、ESP32 BLE 开发环境

ESP-IDF（官方开发框架）
- 优势：原厂支持、API 完整，适合高级用法和自定义功能；
- 缺点：需要熟悉 CMake/Make 以及部分底层概念，学习曲线略陡。
Arduino Core for ESP32
- 优势：Arduino 生态下开发简单、库资源丰富；
- 缺点：底层配置能力相对弱，如果需要非常底层的 BLE 特性，需要自己封装或者使用 IDF API。
开发板选择
- ESP32-DevKitC（官方开发板）
- NodeMCU-32S、Wemos D1 R32 等常见的第三方开发板

在 CSDN 或乐鑫官方文档中，可以找到大量入门教程、环境搭建指引。

四、常用 BLE 开发流程示例

以下以 Arduino 环境 为例，展示如何让 ESP32 作为 BLE 外设，通过 GATT 提供一个简单服务和特征（Characteristic）。如果你使用 ESP-IDF，API 结构类似，只是封装方式和编译方式不同。

1. 代码示例：建立 BLE 外设

下面的示例，将 ESP32 配置为 Peripheral 角色，定义一个名为 BLE_Test 的服务，并在其中创建一个可读写的特征。

#include <BLEDevice.h>
#include <BLEServer.h>
#include <BLEUtils.h>
#include <BLE2902.h>

// 自定义UUID，随意生成或使用在线工具
#define SERVICE_UUID           "12345678-1234-1234-1234-1234567890AB"
#define CHARACTERISTIC_UUID_RX "12345678-1234-1234-1234-1234567890AC"
#define CHARACTERISTIC_UUID_TX "12345678-1234-1234-1234-1234567890AD"

BLEServer* pServer = NULL;
BLECharacteristic* pCharacteristicTx = NULL;
bool deviceConnected = false;

// 回调函数：连接、断开时的处理
class MyServerCallbacks: public BLEServerCallbacks {
  void onConnect(BLEServer* pServer) {
    deviceConnected = true;
    Serial.println("BLE device connected.");
  }

  void onDisconnect(BLEServer* pServer) {
    deviceConnected = false;
    Serial.println("BLE device disconnected.");
  }
};

void setup() {
  Serial.begin(115200);

  // 1. 初始化 BLE
  BLEDevice::init("ESP32-BLE-Peripheral");

  // 2. 创建BLE服务器
  pServer = BLEDevice::createServer();
  pServer->setCallbacks(new MyServerCallbacks());

  // 3. 创建服务
  BLEService* pService = pServer->createService(SERVICE_UUID);

  // 4. 在该服务下创建一个可读写的Characteristic
  pCharacteristicTx = pService->createCharacteristic(
                       CHARACTERISTIC_UUID_TX,
                       BLECharacteristic::PROPERTY_READ   |
                       BLECharacteristic::PROPERTY_NOTIFY |
                       BLECharacteristic::PROPERTY_WRITE  
                     );

  // 5. 为Characteristic添加描述（可选）
  pCharacteristicTx->addDescriptor(new BLE2902());

  // 6. 启动服务
  pService->start();

  // 7. 设为可被Central发现、连接
  BLEAdvertising* pAdvertising = BLEDevice::getAdvertising();
  pAdvertising->addServiceUUID(SERVICE_UUID);
  pAdvertising->setScanResponse(true);
  BLEDevice::startAdvertising();

  Serial.println("BLE Peripheral set up. Waiting for connections...");
}

void loop() {
  // 简单示例：每隔5秒向已连接设备Notify一次计数
  static unsigned long lastMillis = 0;
  static int count = 0;

  if(millis() - lastMillis > 5000) {
    lastMillis = millis();
    if(deviceConnected) {
      count++;
      String data = "Msg count: " + String(count);
      pCharacteristicTx->setValue(data.c_str());
      pCharacteristicTx->notify();
      Serial.println("Notify data: " + data);
    }
  }
}

代码要点

BLEDevice::init：初始化 BLE 模块，并指定设备名；
createServer & createService：创建 GATT 服务器与自定义服务；
createCharacteristic：在服务下声明一个可读写的特征；
Notify：向已连接的 Central 主动推送数据；
onConnect/onDisconnect：在连接/断开时执行回调。

2. 测试与验证

使用一款 BLE App（如 nRF Connect 或 LightBlue）在手机上扫描“ESP32-BLE-Peripheral”设备；
连接后，即可查看到服务及其特征值，尝试读写或接收 Notify 数据；
如果需要安全加密特性，可在创建服务、特征时增加安全选项（ESP-IDF 支持更灵活的安全层配置）。

五、ESP-IDF 下的 BLE 功能

如果使用 ESP-IDF：

Menuconfig 中可配置蓝牙协议栈、功耗模式；
esp_bt.h、esp_gap_ble_api.h、esp_gattc_api.h 等头文件提供更底层的 API；
通过官方示例（ESP-IDF 提供了 gatt_server、gatt_client 等多种示例）可快速进行二次开发。

相较于 Arduino 封装，ESP-IDF 更灵活，可定制化程度高，亦可利用其事件回调机制处理断连、配对、加密等行为。

六、进阶功能

广播数据（Advertisement）
- 可发送自定义广播包，包含如设备厂商信息、服务UUID等；
- 低功耗场景下仅广播，不保持长连接。
多服务、多特征
- 在同一设备中创建多个服务与特征，以满足复杂业务需求；
- 同一特征也可设置多种属性，如可读、可写、可通知等。
配对与加密
- BLE 通常支持 Just Works、Passkey、OOB 等方式进行配对；
- ESP32 支持加密通信，提升数据安全性。
Mesh & 其它协议
- 也可通过 BLE Mesh 等方案实现多节点组网；
- 或使用 Wi-Fi + BLE 双模互补，构建完整物联网系统。

七、常见问题与排查

扫描不到设备
- 检查是否开启广播，或者距离过远；
- 不同手机与蓝牙版本兼容性；
- 代码逻辑中是否设置了正确的广播参数。
连接后读写失败
- 是否正确设置了特征的读写属性；
- 检查 onConnect/onDisconnect 回调中是否有异常处理；
- 有无添加描述符（如 BLE2902）以支持 Notify/Indicate。
功耗过高
- 默认广播间隔较短会导致功耗偏高，可在配置中调大广播间隔；
- 关闭不必要的 Wi-Fi 功能或使用轻量化模式。
延迟或速度不理想
- BLE 本身带宽有限，适合小数据量传输；
- 如果需高吞吐，可考虑 Wi-Fi 或经典蓝牙 BR/EDR。