单片机与物联网 / 系统课时
推送传感器数据
推送传感器数据
传感器数据持续变化时,如果手机反复主动读取特征值,会增加交互次数。更合适的方式是让手机订阅 Notify,由 ESP32 在新数据到来时主动推送。本课用 ADC 采样值演示通知特征值、订阅过程和发送频率控制。
学习目标
- 创建支持
NOTIFY的 BLE 特征值并配置通知描述符 - 在连接状态下周期采样传感器并主动推送
- 在手机端订阅通知并判断数据是否持续到达
Notify 为什么适合实时数据
Read 是“手机请求一次,ESP32 返回一次”;Notify 则是手机先订阅,随后由 ESP32 主动发送更新。手机开启通知时会配置该特征值的客户端配置描述符,之后每次 notify() 都把当前值推给已订阅客户端,因此更适合温度、光照、ADC 等连续数据。

创建可通知特征值
示例使用经典 ESP32 DevKit 常见的 GPIO 34 作为 ADC 输入;若你的芯片或开发板没有该引脚,请改成可用的 ADC 引脚。手机收到的是短文本 adc=<VALUE>,便于直接观察。
#include <Arduino.h>
#include <BLEDevice.h>
#include <BLEServer.h>
#include <BLEUtils.h>
#include <BLE2902.h>
#include <cstring>
const uint8_t SENSOR_PIN = 34;
const char* SERVICE_UUID = "7d2e1001-7a2b-4d7e-a8f1-2d3a4b5c6d7e";
const char* SENSOR_UUID = "7d2e1002-7a2b-4d7e-a8f1-2d3a4b5c6d7e";
BLECharacteristic* sensorCharacteristic = nullptr;
// 只在存在连接时采样并通知,避免无意义发送。
bool deviceConnected = false;
class ServerCallbacks : public BLEServerCallbacks {
void onConnect(BLEServer* server) override {
deviceConnected = true;
Serial.println("Client connected");
}
void onDisconnect(BLEServer* server) override {
deviceConnected = false;
Serial.println("Client disconnected");
}
};
void setup() {
Serial.begin(115200);
pinMode(SENSOR_PIN, INPUT);
// 创建 GATT Server,并在客户端断开后自动恢复广播。
BLEDevice::init("ESP32-Sensor");
BLEServer* server = BLEDevice::createServer();
server->setCallbacks(new ServerCallbacks());
server->advertiseOnDisconnect(true);
BLEService* service = server->createService(SERVICE_UUID);
sensorCharacteristic = service->createCharacteristic(
SENSOR_UUID,
BLECharacteristic::PROPERTY_READ | BLECharacteristic::PROPERTY_NOTIFY
);
// 0x2902 CCCD 让客户端能够启用或关闭通知。
sensorCharacteristic->addDescriptor(new BLE2902());
sensorCharacteristic->setValue("adc=0");
service->start();
BLEAdvertising* advertising = BLEDevice::getAdvertising();
advertising->addServiceUUID(SERVICE_UUID);
BLEDevice::startAdvertising();
Serial.println("BLE sensor ready");
}
void loop() {
static unsigned long lastNotify = 0;
// 用非阻塞时间判断限制发送频率,主循环仍可处理其他任务。
if (deviceConnected && millis() - lastNotify >= 1000) {
lastNotify = millis();
int raw = analogRead(SENSOR_PIN);
// 使用短文本便于手机客户端直接观察,生产协议可改为二进制。
char payload[24];
snprintf(payload, sizeof(payload), "adc=%d", raw);
sensorCharacteristic->setValue(
reinterpret_cast<uint8_t*>(payload),
strlen(payload)
);
sensorCharacteristic->notify();
Serial.printf("notify: %s\n", payload);
}
delay(10);
}预期输出:连接手机并启用该特征值的 Notify 后,串口会每秒打印一次采样值;<VALUE> 会随传感器输入变化。
BLE sensor ready
Client connected
notify: adc=<VALUE>
notify: adc=<VALUE>手机端也应持续收到类似 adc=<VALUE> 的通知内容。
在手机端订阅并验证
扫描并连接 ESP32-Sensor,定位服务 UUID 7d2e1001-7a2b-4d7e-a8f1-2d3a4b5c6d7e 和特征值 UUID 7d2e1002-7a2b-4d7e-a8f1-2d3a4b5c6d7e,然后对该特征值启用 Notify。只连接而不订阅时,ESP32 即使调用 notify(),手机端也不会按预期显示持续更新。
改变传感器输入后,串口与手机两侧的数值都应变化。若串口持续发送而手机没有数据,优先检查是否真正启用了 Notify;若连接很快断开,再检查供电稳定性和发送频率,而不是先修改 UUID。
控制推送频率和负载
通知不应直接放在无节制的高速循环中。本例用 millis() 把周期限制为 1 秒,既不会阻塞主循环,也避免高频通知造成拥塞。实际项目应根据传感器变化速度和业务需求决定周期,必要时只在数值变化超过阈值后发送。
单次通知可承载的数据量受协商 MTU 等因素影响,结构化数据较长时应压缩字段、分包或设计二进制协议。Notify 本身不提供应用层确认;如果业务必须知道客户端已经确认收到,可评估 Indicate 或在应用协议中增加确认机制。