单片机与物联网 / 系统课时
发布 BLE 广播
发布 BLE 广播
手机要发现 ESP32,前提不是先建立连接,而是 ESP32 先周期性发送 BLE 广播包。本节用 Arduino-ESP32 的 BLE API 设置设备名称、发布一个服务 UUID 并启动广播,最后用手机扫描结果确认设备已经对外可见。
学习目标
- 理解 BLE 广播与连接之间的关系,以及名称、服务 UUID 在发现阶段的作用。
- 能在 ESP32 上配置设备名称并启动可被扫描的广播。
- 能根据串口与手机扫描结果定位“设备搜不到”的常见原因。
广播阶段发生了什么
BLE 外设会在未连接时持续发送广播,手机作为 Central 扫描这些广播后,才能知道附近有哪些设备。广播包适合携带少量“发现信息”,例如设备名称、Flags 和服务 UUID;真正的业务数据通常在建立连接后通过 GATT 特征值交换。
本节使用的是常见的传统 BLE 广播。其主广播数据空间有限,因此设备名不宜过长;当名称、服务 UUID 等字段放不下时,可以缩短名称,或把部分信息放到 Scan Response,而不是不断往一个广播包里塞数据。

配置并启动广播
前提是 Arduino IDE 已安装 Arduino-ESP32 开发板支持,并且当前开发板能够正常烧录。下面的完整示例创建一个空的 BLE 服务,仅用于让广播中的服务 UUID 与设备实际提供的服务保持一致;后续可以继续在这个服务下添加特征值。
#include <Arduino.h>
#include <BLEDevice.h>
#include <BLEServer.h>
#include <BLEUtils.h>
static const char* DEVICE_NAME = "ESP32-ANYSTACK";
static const char* SERVICE_UUID = "4fafc201-1fb5-459e-8fcc-c5c9c331914b";
void setup() {
Serial.begin(115200);
// init() 同时初始化 BLE 协议栈并设置 GAP 设备名称。
BLEDevice::init(DEVICE_NAME);
BLEServer* server = BLEDevice::createServer();
BLEService* service = server->createService(SERVICE_UUID);
service->start();
// 广播服务 UUID,便于扫描器按服务筛选设备。
BLEAdvertising* advertising = BLEDevice::getAdvertising();
advertising->addServiceUUID(SERVICE_UUID);
advertising->setScanResponse(true);
BLEDevice::startAdvertising();
Serial.println("BLE advertising started");
Serial.printf("Device name: %s\n", DEVICE_NAME);
}
void loop() {
delay(1000);
}预期输出
BLE advertising started
Device name: ESP32-ANYSTACK串口信息只说明程序已经执行到启动广播这一步。真正的发现验证还要在手机端完成,因为射频权限、扫描过滤或手机系统策略都可能影响最终结果。
用手机验证设备可见
使用任意支持 BLE 扫描的手机工具开始扫描,查找名称为 ESP32-ANYSTACK 的设备。若工具能展开广播详情,还应能看到服务 UUID 4fafc201-1fb5-459e-8fcc-c5c9c331914b;RSSI 会显示为 <VALUE> dBm 一类的动态值,距离和环境变化都会使它波动。
不要只依赖手机系统自带的“蓝牙配对”页面判断结果。很多 BLE 外设并不以传统配对设备的形式出现,而专业 BLE 扫描器会直接展示附近广播中的 Peripheral。
扫不到设备时怎么查
先确认串口出现 BLE advertising started,排除程序未运行或反复重启。然后关闭手机扫描过滤条件,确认蓝牙与必要的附近设备权限已经开启,并让手机靠近开发板重新扫描。
如果能看到其他 BLE 设备但始终看不到 ESP32,重点检查设备名是否被改动、是否实际调用了 BLEDevice::startAdvertising(),以及广播字段是否过多。修改广播内容后重新烧录并复位设备,再用扫描器刷新列表,通常可以很快区分是代码问题还是手机扫描侧问题。