单片机与物联网 / 系统课时
创建 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,只有客户端真正开启通知后,推送数据才会送到它。

建立可读写和可通知特征
下面的示例把职责拆成两个特征:CONTROL_UUID 用于读取和写入命令,TELEMETRY_UUID 用于读取当前计数并每两秒发送一次通知。这样可以避免一个特征同时被业务写入和周期更新时互相覆盖。
#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 后)
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;按职责最小化属性,不仅让客户端更容易理解,也能减少误操作和后续权限设计的复杂度。