单片机与物联网 / 系统课时
管理蓝牙连接
管理蓝牙连接
BLE 外设真正投入运行后,重点不再是“能连上”,而是让连接、断开、重新广播与数据长度协商形成可预测的闭环。本节用 NimBLE-Arduino 2.x 构建一个最小服务器,并把关键运行状态放进回调中观察和处理。
学习目标
- 用服务器回调识别连接、断开与 MTU 变化
- 在断开后自动恢复广播,避免设备变成“不可发现”
- 区分 ATT MTU 与链路层 Data Length,避免把两者当成同一个参数
把连接看成状态机
对单连接 BLE 外设,可以把运行过程理解为“广播 → 建链 → 参数协商与 GATT 通信 → 断链 → 重新广播”。广播通常在建立连接后停止,因此断开事件不是流程终点,而是决定设备能否继续被下一次发现的关键转折点。

连接句柄是一次连接的临时标识。需要主动踢下客户端时,可以用当前句柄调用 NimBLEServer::disconnect();连接结束后句柄会失效,不应保存下来用于下一次连接。
用回调接管连接与断开
下面示例创建一个可读写、可通知的 GATT 特征,并注册服务器回调。advertiseOnDisconnect(true) 负责断开后自动恢复广播;连接建立时请求 251 字节的链路层 Data Length,同时通过串口记录实际 MTU。
#include <Arduino.h>
#include <NimBLEDevice.h>
static const char* SERVICE_UUID = "12345678-1234-1234-1234-1234567890ab";
static const char* CHAR_UUID = "12345678-1234-1234-1234-1234567890ac";
class ServerCallbacks : public NimBLEServerCallbacks {
void onConnect(NimBLEServer* server, NimBLEConnInfo& info) override {
const uint16_t handle = info.getConnHandle();
Serial.printf("connected handle=%u mtu=%u\n", handle, info.getMTU());
// DLE 只改变链路层数据 PDU 长度,不等于把 ATT MTU 改成 251。
server->setDataLen(handle, 251);
}
void onMTUChange(uint16_t mtu, NimBLEConnInfo& info) override {
Serial.printf("mtu changed handle=%u mtu=%u\n",
info.getConnHandle(), mtu);
}
void onDisconnect(NimBLEServer* server,
NimBLEConnInfo& info,
int reason) override {
Serial.printf("disconnected handle=%u reason=%d\n",
info.getConnHandle(), reason);
}
};
void setup() {
Serial.begin(115200);
NimBLEDevice::init("ESP32-Link");
NimBLEDevice::setMTU(247); // 本机偏好值,最终 MTU 仍由双方协商决定。
NimBLEServer* server = NimBLEDevice::createServer();
server->setCallbacks(new ServerCallbacks());
server->advertiseOnDisconnect(true);
NimBLEService* service = server->createService(SERVICE_UUID);
NimBLECharacteristic* characteristic = service->createCharacteristic(
CHAR_UUID,
NIMBLE_PROPERTY::READ |
NIMBLE_PROPERTY::WRITE |
NIMBLE_PROPERTY::NOTIFY);
characteristic->setValue("ready");
server->start();
NimBLEAdvertising* advertising = NimBLEDevice::getAdvertising();
advertising->addServiceUUID(SERVICE_UUID);
advertising->setName("ESP32-Link");
advertising->start();
Serial.println("advertising started");
}
void loop() {
delay(1000);
}预期输出如下。连接句柄、实际 MTU 和断开原因码取决于客户端与当次连接,因此用占位值表示。
advertising started
connected handle=<ID> mtu=<VALUE>
mtu changed handle=<ID> mtu=<VALUE>
disconnected handle=<ID> reason=<VALUE>手机断开后,无需在 loop() 中轮询连接状态,服务器会重新进入广播状态。如果业务需要主动断开,例如鉴权失败或会话超时,应在持有有效连接句柄时调用 server->disconnect(connHandle),随后仍让断开回调完成清理。
区分 MTU 与数据长度
ATT MTU 决定单个 ATT 协议数据单元的上限;对常见通知、写命令等操作,可承载的 Attribute Value 通常还要扣除 ATT 头部。NimBLEDevice::setMTU(247) 设置的是本机期望值,实际值不能超过对端接受的大小,因此应以 onMTUChange() 或连接信息中的实际 MTU 为准。
Data Length Extension 位于更低的链路层。setDataLen(handle, 251) 请求增大 Link Layer Data PDU 的负载能力,它可以减少大数据传输时的链路层分片开销,但不会自动把 GATT 一次读写变成 251 字节。应用层分包仍应依据实际 ATT MTU 和所用 GATT 操作设计。
让连接管理更稳健
回调应只完成状态更新、轻量日志和必要的协议动作,不要在 BLE 回调里执行长时间阻塞的网络请求、Flash 擦写或大计算。复杂业务可以把“已连接”“已断开”等事件投递给主循环或独立任务处理。
还应把“当前是否有连接”和“当前连接句柄”视为运行态,而不是永久配置。多连接项目则不能简单套用单连接策略,应结合 getConnectedCount()、最大连接数和广播策略决定是否继续对外可发现。
稳定的 BLE 连接管理,本质上是把广播、连接参数、数据传输和断开恢复放进同一套状态闭环:每次连接都重新确认实际参数,每次断开都清理本次会话,并明确下一步是否恢复广播。