单片机与物联网 / 系统课时

创建 BLE 服务

创建 BLE 服务

广播只能让手机“找到”ESP32,真正的读写与通知要依靠 GATT 服务和特征值。本节会创建一个自定义 Service,并在其中放置控制特征与通知特征,让手机能够读取状态、写入命令,并订阅 ESP32 主动推送的数据。

学习目标

  • 理解 GATT Server、Service、Characteristic 与 UUID 的层级关系。
  • 能为特征值正确配置 Read、Write 和 Notify 属性。
  • 能用手机完成读取、写入与通知订阅,并根据串口结果验证数据链路。

GATT 对象如何组织

ESP32 在这个例子中充当 GATT Server。Server 下可以有多个 Service,每个 Service 再包含若干 Characteristic;客户端并不是按“变量名”找数据,而是按 UUID 定位服务和特征值。

读取和写入适合请求响应式交互,通知则由 ESP32 在值变化时主动推送。支持 Notify 的特征还需要客户端订阅对应的 CCCD,只有客户端真正开启通知后,推送数据才会送到它。

ESP32 GATT 服务与特征值层级

建立可读写和可通知特征

下面的示例把职责拆成两个特征:CONTROL_UUID 用于读取和写入命令,TELEMETRY_UUID 用于读取当前计数并每两秒发送一次通知。这样可以避免一个特征同时被业务写入和周期更新时互相覆盖。

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

static const char* SERVICE_UUID =
    "4fafc201-1fb5-459e-8fcc-c5c9c331914b";
static const char* CONTROL_UUID =
    "beb5483e-36e1-4688-b7f5-ea07361b26a8";
static const char* TELEMETRY_UUID =
    "9f7c4d80-8a6b-4f29-9d26-0a41f0d4b6c2";

BLECharacteristic* telemetryCharacteristic = nullptr;
bool deviceConnected = false;
uint32_t counterValue = 0;

class ServerCallbacks : public BLEServerCallbacks {
  void onConnect(BLEServer* server) override {
    deviceConnected = true;
  }

  void onDisconnect(BLEServer* server) override {
    deviceConnected = false;
    // 断开后重新广播,允许手机再次发现并连接。
    BLEDevice::startAdvertising();
  }
};

class ControlCallbacks : public BLECharacteristicCallbacks {
  void onWrite(BLECharacteristic* characteristic) override {
    String value = characteristic->getValue().c_str();
    Serial.printf("Control write: %s\n", value.c_str());
  }
};

void setup() {
  Serial.begin(115200);
  BLEDevice::init("ESP32-GATT");

  BLEServer* server = BLEDevice::createServer();
  server->setCallbacks(new ServerCallbacks());

  BLEService* service = server->createService(SERVICE_UUID);

  BLECharacteristic* controlCharacteristic =
      service->createCharacteristic(
          CONTROL_UUID,
          BLECharacteristic::PROPERTY_READ |
              BLECharacteristic::PROPERTY_WRITE);
  controlCharacteristic->setValue("ready");
  controlCharacteristic->setCallbacks(new ControlCallbacks());

  telemetryCharacteristic =
      service->createCharacteristic(
          TELEMETRY_UUID,
          BLECharacteristic::PROPERTY_READ |
              BLECharacteristic::PROPERTY_NOTIFY);

  // CCCD 由客户端写入,用来表示是否订阅 Notify。
  telemetryCharacteristic->addDescriptor(new BLE2902());
  telemetryCharacteristic->setValue("count=0");

  service->start();

  BLEAdvertising* advertising = BLEDevice::getAdvertising();
  advertising->addServiceUUID(SERVICE_UUID);
  advertising->setScanResponse(true);
  BLEDevice::startAdvertising();

  Serial.println("BLE GATT server ready");
}

void loop() {
  if (!deviceConnected) {
    delay(500);
    return;
  }

  String payload = "count=" + String(counterValue++);
  telemetryCharacteristic->setValue(payload.c_str());
  telemetryCharacteristic->notify();

  Serial.printf("Notify: %s\n", payload.c_str());
  delay(2000);
}

预期输出(手机连接、订阅通知并向控制特征写入 hello 后)

text
BLE GATT server ready
Notify: count=0
Control write: hello
Notify: count=1

计数值和日志出现顺序会受连接与操作时机影响,但控制写入内容应与手机发送的数据一致,通知值则会持续递增。

用手机逐项验收

连接名称为 ESP32-GATT 的设备后,先发现服务 4fafc201-1fb5-459e-8fcc-c5c9c331914b。读取控制特征应得到初始值 ready;向它写入 hello 后,串口应出现 Control write: hello,再次读取通常也会得到客户端刚写入的值。

再对 Telemetry 特征开启 Notify。客户端应每隔约两秒收到 count=0、count=1、count=2 等数据。若串口持续打印 Notify: 但手机没有收到更新,优先检查客户端是否真的开启了通知订阅,而不是先怀疑 notify() 调用本身。

属性与权限的边界

PROPERTY_READ、PROPERTY_WRITE 和 PROPERTY_NOTIFY 描述的是特征值支持哪些 GATT 操作,不等于已经完成访问控制。若设备要传输敏感数据,还需要继续配置配对、加密和认证策略,不能把“能读写”误认为“安全地读写”。

同时不要为所有特征无差别开启全部属性。命令入口只需要 Read/Write,传感器上报通常只需要 Read/Notify;按职责最小化属性,不仅让客户端更容易理解,也能减少误操作和后续权限设计的复杂度。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 BLE 服务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通