ESP32蓝牙开发新突破：BluetoothSerial 4.4版设备搜索功能深度解析

最近在PlatformIO 4.4环境中更新ESP32开发支撑包时，意外发现BluetoothSerial库新增了蓝牙设备搜索API。这个看似微小的改动，实际上解决了ESP32作为蓝牙主机开发时的一个长期痛点——不再需要硬编码从机MAC地址就能实现设备发现与连接。本文将带你全面探索这一新功能的技术细节和实际应用价值。

1. 新旧版本功能对比：从硬编码到动态发现

在BluetoothSerial 3.1及更早版本中，ESP32作为蓝牙主机连接从机时，开发者必须预先知道从机的MAC地址并通过 connect() 方法直接连接。这种方式存在几个明显局限：

• 开发效率低 ：每次更换从机设备都需要重新获取并修改MAC地址
• 部署不灵活 ：无法应对从机设备可能更换的场景
• 调试困难 ：无法直观查看周围可用的蓝牙设备

// 旧版必须硬编码MAC地址的典型代码
uint8_t slaveAddress[6] = {0x30,0x83,0x98,0xC3,0x50,0xDA}; 
SerialBT.connect(slaveAddress);

BluetoothSerial 4.4版本新增的关键API包括：

函数名	参数	返回值	功能描述
discoverAsync()	-	bool	开始异步搜索周边蓝牙设备
discover()	int timeoutMs	int	同步搜索设备，返回发现设备数
getDiscoverResults()	int maxDevices	BTDeviceInfo*	获取搜索到的设备信息
isDiscovering()	-	bool	检查是否正在搜索设备

注意： discoverAsync() 是非阻塞调用，适合在事件驱动架构中使用，而 discover() 会阻塞当前线程直到超时或发现设备。

2. 设备搜索功能实战：从理论到代码实现

让我们通过一个完整示例来演示如何使用新版搜索功能。这个例子将展示如何扫描周边蓝牙设备并列出它们的基本信息。

#include "BluetoothSerial.h"

BluetoothSerial SerialBT;
const int scanTime = 5000; // 扫描时长5秒

void setup() {
  Serial.begin(115200);
  SerialBT.begin("ESP32_Scanner", true); // 初始化为主机模式
  
  Serial.println("开始扫描蓝牙设备...");
  int foundDevices = SerialBT.discover(scanTime);
  
  if(foundDevices > 0) {
    BTDeviceInfo devices[foundDevices];
    SerialBT.getDiscoverResults(foundDevices, devices);
    
    Serial.printf("发现 %d 个设备:\n", foundDevices);
    for(int i=0; i<foundDevices; i++) {
      Serial.printf("%d. 名称: %s, MAC: %s, RSSI: %d\n", 
                   i+1,
                   devices[i].getName().c_str(),
                   devices[i].getAddress().toString().c_str(),
                   devices[i].getRSSI());
    }
  } else {
    Serial.println("未发现任何蓝牙设备");
  }
}

void loop() {
  // 主循环保持空置
}

这段代码执行后会输出类似以下结果：

开始扫描蓝牙设备...
发现 3 个设备:
1. 名称: Mi Band 4, MAC: 30:AE:A4:80:1E:21, RSSI: -65
2. 名称: ESP32_SLAVE, MAC: 24:0A:C4:EE:05:1A, RSSI: -42
3. 名称: WH-1000XM4, MAC: 94:DB:56:EE:5F:21, RSSI: -78

关键点解析：

1. discover() 方法会阻塞当前线程直到超时，期间ESP32会持续扫描周边蓝牙信号
2. 搜索结果包含设备名称、MAC地址和信号强度(RSSI)等关键信息
3. RSSI值(负值)越小表示信号越强，这对后续设备筛选很有参考价值

3. 智能连接方案：动态搜索+自动配对

结合搜索功能，我们可以实现更智能的连接策略。以下示例展示如何自动搜索并连接指定名称前缀的设备：

#include "BluetoothSerial.h"

BluetoothSerial SerialBT;
const char* targetPrefix = "ESP32_SLAVE"; // 目标设备名称前缀
const int scanInterval = 10000; // 每10秒重试一次

void connectToSlave() {
  int found = SerialBT.discover(5000); // 5秒扫描
  if(found <= 0) return;
  
  BTDeviceInfo devices[found];
  SerialBT.getDiscoverResults(found, devices);
  
  for(int i=0; i<found; i++) {
    String devName = devices[i].getName();
    if(devName.startsWith(targetPrefix)) {
      Serial.printf("尝试连接 %s [%s]\n", 
                   devName.c_str(), 
                   devices[i].getAddress().toString().c_str());
      
      if(SerialBT.connect(devices[i].getAddress())) {
        Serial.println("连接成功!");
        return;
      }
    }
  }
}

void setup() {
  Serial.begin(115200);
  SerialBT.begin("ESP32_SMART_MASTER", true);
  SerialBT.register_callback([](esp_spp_cb_event_t event, esp_spp_cb_param_t* param) {
    if(event == ESP_SPP_OPEN_EVT) {
      Serial.println("蓝牙连接已建立");
    } else if(event == ESP_SPP_CLOSE_EVT) {
      Serial.println("蓝牙连接断开，将尝试重新连接");
      connectToSlave();
    }
  });
  
  connectToSlave(); // 首次连接尝试
}

void loop() {
  static unsigned long lastScan = 0;
  if(!SerialBT.connected() && millis()-lastScan > scanInterval) {
    lastScan = millis();
    connectToSlave();
  }
  
  if(SerialBT.connected()) {
    SerialBT.write('P'); // 心跳包
    delay(1000);
  }
}

这个进阶方案实现了几个重要改进：

1. 名称过滤 ：只连接符合命名规则的设备，避免误连其他蓝牙设备
2. 断线重连 ：通过回调函数自动检测连接状态变化并触发重连
3. 周期性扫描 ：在未连接状态下定期搜索目标设备
4. 心跳机制 ：连接后定期发送数据保持链路活跃

4. 性能优化与最佳实践

在实际项目中应用蓝牙搜索功能时，有几个关键因素需要考虑：

搜索参数调优：

• 扫描间隔 ：频繁扫描会显著增加功耗，需根据应用场景平衡响应速度和能耗
• 扫描时长 ：通常3-5秒足够发现大多数设备，特殊场景可能需要更长时间
• 过滤策略 ：结合设备名称、RSSI和服务UUID等多维度筛选目标设备

功耗管理技巧：

1. 连接成功后立即停止持续扫描
2. 根据RSSI值优选信号最强的设备连接
3. 在低功耗场景下，可以采用间隔扫描策略（如每分钟扫描5秒）

稳定性增强方案：

// 增强版连接逻辑示例
bool connectWithRetry(const BTAddress& addr, int maxAttempts=3) {
  for(int i=1; i<=maxAttempts; i++) {
    if(SerialBT.connect(addr)) return true;
    
    Serial.printf("连接尝试 %d/%d 失败，等待重试...\n", i, maxAttempts);
    delay(1000 * i); // 指数退避
  }
  return false;
}

多设备管理策略：

当需要管理多个从机设备时，可以采用以下模式：

1. 维护一个已知设备列表，存储名称与MAC地址的映射关系
2. 每次扫描后更新设备状态（在线/离线、信号强度等）
3. 实现优先级连接逻辑，确保关键设备优先连接

struct KnownDevice {
  String name;
  BTAddress address;
  int minRSSI = -70; // 最低可接受信号强度
  int priority = 1;
};

KnownDevice myDevices[] = {
  {"ESP32_SLAVE_1", BTAddress("24:0A:C4:EE:05:1A"), -65, 2},
  {"ESP32_SLAVE_2", BTAddress("30:AE:A4:80:1E:21"), -70, 1}
};

void connectBestAvailable() {
  BTDeviceInfo found[10];
  int count = min(SerialBT.discover(5000), 10);
  SerialBT.getDiscoverResults(count, found);
  
  for(auto &known : myDevices) {
    for(int i=0; i<count; i++) {
      if(found[i].getAddress() == known.address && 
         found[i].getRSSI() >= known.minRSSI) {
        if(SerialBT.connect(known.address)) {
          Serial.printf("已连接优先设备 %s\n", known.name.c_str());
          return;
        }
      }
    }
  }
}

BluetoothSerial 4.4的搜索功能为ESP32蓝牙应用开发打开了新可能。在实际项目中，我发现结合适当的过滤策略和连接管理，可以构建出远比硬编码MAC地址方案更健壮、更灵活的蓝牙通信系统。特别是在设备可能更换或移动的场景下，动态搜索功能几乎成为必备特性。