ESP32 Arduino 经典蓝牙 SPP 通信实战：双节点自动配对与LED控制

1. 硬件准备与环境搭建

在开始ESP32经典蓝牙通信项目前，我们需要准备以下硬件组件：

• ESP32开发板×2（推荐使用NodeMCU-32S或ESP32 DevKitC）
• LED灯×1（用于服务端状态指示）
• 220Ω电阻×1（限流保护LED）
• 面包板和杜邦线若干

开发环境配置步骤如下：

1. 安装Arduino IDE（1.8.x或更高版本）

2. 添加ESP32开发板支持：

   • 打开Arduino IDE，进入"文件 > 首选项"
   • 在"附加开发板管理器网址"中添加：https://dl.espressif.com/dl/package_esp32_index.json
   • 打开"工具 > 开发板 > 开发板管理器"，搜索并安装"esp32"

3. 安装必要库文件：

   • BluetoothSerial库（ESP32 Arduino核心已内置）
   • 可选：PlatformIO插件（VS Code用户）

硬件连接示意图：

ESP32客户端： 无需外接元件 ESP32服务端： GPIO2 ----[220Ω]----LED----GND

2. 蓝牙SPP通信基础原理

经典蓝牙SPP（Serial Port Profile）通过模拟传统串口通信实现设备间数据传输。ESP32的蓝牙协议栈架构如下：

关键参数对比：

实测传输性能：

• 开放环境双向传输速率：1.2-1.5Mbps
• 有效通信距离：10-20米（无遮挡）

3. 服务端完整实现

服务端代码负责创建蓝牙服务、处理连接请求并响应客户端指令：

#include "BluetoothSerial.h" #include <Arduino.h> #if !defined(CONFIG_BT_SPP_ENABLED) #error Serial Bluetooth not available or not enabled. It is only available for the ESP32 chip. #endif // 硬件配置 #define LED_PIN 2 BluetoothSerial SerialBT; // 安全配置 const char *pin = "1597"; // 配对密码 String device_name = "ESP32-LED-CTRL"; // 设备名称 // 连接状态检测 unsigned long lastConnectTime = 0; const unsigned long CONNECT_TIMEOUT = 15000; // 15秒超时 void setup() { Serial.begin(115200); pinMode(LED_PIN, OUTPUT); digitalWrite(LED_PIN, LOW); // 蓝牙初始化 SerialBT.begin(device_name); SerialBT.setPin(pin); Serial.printf("设备\"%s\"已启动，等待配对...\n", device_name.c_str()); Serial.println("配对密码: " + String(pin)); } void loop() { // 连接状态监控 if(!SerialBT.connected()) { if(millis() - lastConnectTime > CONNECT_TIMEOUT) { Serial.println("等待客户端连接..."); lastConnectTime = millis(); } return; } // 数据处理 if(SerialBT.available()) { char command = SerialBT.read(); processCommand(command); } } void processCommand(char cmd) { switch(cmd) { case 'A': // 开灯 digitalWrite(LED_PIN, HIGH); SerialBT.println("STATUS:LED_ON"); Serial.println("LED已开启"); break; case 'B': // 关灯 digitalWrite(LED_PIN, LOW); SerialBT.println("STATUS:LED_OFF"); Serial.println("LED已关闭"); break; case '?': // 状态查询 SerialBT.print("STATUS:"); SerialBT.println(digitalRead(LED_PIN) ? "ON" : "OFF"); break; default: SerialBT.println("ERROR:INVALID_CMD"); Serial.print("未知命令: 0x"); Serial.println(cmd, HEX); } }

关键功能说明：

1. 安全配对机制：

   • 设置4位数字配对码（1597）
   • 首次连接需在手机/客户端输入配对码
   • 防止未经授权的设备连接

2. 状态监控：

   • 定期检查连接状态
   • 超时未连接输出提示信息
   • 保持连接稳定性

3. 指令集设计：

   • 'A'：开启LED
   • 'B'：关闭LED
   • '?'：查询当前状态
   • 扩展指令可自行添加

4. 客户端完整实现

客户端代码负责自动搜索并连接服务端，定期发送控制指令：

#include "BluetoothSerial.h" #include <Arduino.h> BluetoothSerial SerialBT; // 目标设备配置 const char *target_name = "ESP32-LED-CTRL"; const char *pin = "1597"; bool connected = false; // 指令发送间隔 const unsigned long CMD_INTERVAL = 3000; unsigned long lastCmdTime = 0; bool ledState = false; void setup() { Serial.begin(115200); SerialBT.begin("ESP32-Client", true); SerialBT.setPin(pin); Serial.println("正在搜索服务端设备..."); // 自动连接逻辑 if(!autoConnect()) { Serial.println("初始化连接失败，请检查设备是否可用"); } } bool autoConnect() { Serial.print("尝试连接设备: "); Serial.println(target_name); // 两种连接方式对比 // connected = SerialBT.connect(target_name); // 通过设备名连接（较慢） connected = SerialBT.connect("24:0A:C4:12:34:56"); // 通过MAC连接（更快） if(!connected) { Serial.println("连接失败，10秒后重试..."); delay(10000); return autoConnect(); // 递归重试 } Serial.println("连接成功！"); return true; } void loop() { // 保持连接 if(!SerialBT.connected()) { connected = false; Serial.println("连接断开，尝试重新连接..."); autoConnect(); return; } // 定时发送指令 if(millis() - lastCmdTime > CMD_INTERVAL) { char cmd = ledState ? 'A' : 'B'; SerialBT.write(cmd); Serial.print("发送指令: "); Serial.println(cmd); ledState = !ledState; // 切换状态 lastCmdTime = millis(); // 请求状态反馈 SerialBT.write('?'); } // 处理响应 if(SerialBT.available()) { String response = SerialBT.readStringUntil('\n'); Serial.println("收到响应: " + response); } }

优化策略：

1. 双模式连接：

   • 提供设备名和MAC两种连接方式
   • 注释切换即可更改连接策略
   • MAC连接速度提升3倍以上

2. 自动重连机制：

   • 连接失败自动延迟重试
   • 断线检测与自动恢复
   • 递归实现简洁可靠

3. 交互设计：

   • 定时发送切换指令
   • 主动请求状态反馈
   • 串口输出完整日志

5. 高级功能扩展

5.1 安全增强配置

在服务端setup()中添加以下代码：

// 设置安全参数 esp_bt_sp_param_t param_type = ESP_BT_SP_IOCAP_MODE; esp_bt_io_cap_t iocap = ESP_BT_IO_CAP_IO; esp_bt_gap_set_security_param(param_type, &iocap, sizeof(uint8_t)); // 启用安全连接 esp_bt_sp_param_t sec_param = ESP_BT_SP_ONLY_ACCEPT_SPECIFIED_AUTH_DISABLE; esp_bt_gap_set_security_param(sec_param, NULL, 0);

安全等级对比：

5.2 多客户端管理

扩展服务端代码支持多连接：

#include <vector> std::vector<uint8_t> clientList; // 存储客户端MAC地址 void handleNewConnection() { uint8_t mac[6]; esp_bt_gap_get_remote_device_bdaddr(mac); if(std::find(clientList.begin(), clientList.end(), mac) == clientList.end()) { clientList.push_back(mac); Serial.printf("新客户端连接，MAC: %02X:%02X:%02X:%02X:%02X:%02X\n", mac[0], mac[1], mac[2], mac[3], mac[4], mac[5]); } } void broadcastMessage(const String &msg) { for(auto &client : clientList) { // 实际发送逻辑需根据蓝牙API调整 SerialBT.write(client, msg.c_str(), msg.length()); } }

5.3 数据传输优化

使用高效数据封装格式：

#pragma pack(push, 1) typedef struct { uint8_t header = 0xAA; uint8_t command; uint16_t payload_len; uint8_t checksum; uint8_t footer = 0x55; } BT_CommandPacket; #pragma pack(pop) void sendPacket(uint8_t cmd, const uint8_t* data, uint16_t len) { BT_CommandPacket pkt; pkt.command = cmd; pkt.payload_len = len; // 计算校验和 uint8_t sum = 0; for(int i=0; i<len; i++) sum ^= data[i]; pkt.checksum = sum; // 发送数据 SerialBT.write((uint8_t*)&pkt, sizeof(pkt)); if(len > 0) SerialBT.write(data, len); }

6. 常见问题排查

6.1 连接失败诊断

检查步骤：

1. 确认服务端蓝牙已启用

   if(!SerialBT.begin(device_name)) { Serial.println("蓝牙初始化失败！"); while(1); }

2. 验证设备可见性

   # Linux系统使用hcitool扫描 hcitool scan

3. 检查配对密码匹配

   // 两端必须设置相同PIN码 SerialBT.setPin("1597");

4. 查看ESP32蓝牙MAC地址

   Serial.print("本机MAC: "); const uint8_t* mac = esp_bt_dev_get_address(); for(int i=0; i<6; i++) { Serial.printf("%02X", mac[i]); if(i<5) Serial.print(":"); }

6.2 性能优化技巧

1. 调整MTU大小（默认536字节）

   esp_ble_gatt_set_local_mtu(1024); // 设置更大MTU

2. 优化连接参数

   esp_bt_connection_params_t params = { .interval_min = 0x20, // 最小间隔 40ms .interval_max = 0x40, // 最大间隔 80ms .latency = 0, // 无延迟 .timeout = 400 // 超时4s }; esp_bt_gap_set_connection_params(&params);

3. 数据压缩传输

   #include <zlib.h> void sendCompressed(const String &data) { unsigned long compressedSize = compressBound(data.length()); uint8_t* compressed = new uint8_t[compressedSize]; compress(compressed, &compressedSize, (uint8_t*)data.c_str(), data.length()); SerialBT.write(compressed, compressedSize); delete[] compressed; }

7. 项目进阶方向

7.1 物联网集成方案

结合WiFi实现蓝牙网关：

#include <WiFi.h> #include <HTTPClient.h> const char* ssid = "your_SSID"; const char* password = "your_PASSWORD"; void setup() { // 初始化蓝牙 SerialBT.begin("BT-Gateway"); // 连接WiFi WiFi.begin(ssid, password); while(WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } Serial.println("WiFi连接成功"); } void forwardDataToCloud() { if(SerialBT.available()) { String data = SerialBT.readString(); HTTPClient http; http.begin("http://api.iot.com/data"); http.addHeader("Content-Type", "application/json"); String payload = "{\"bt_data\":\"" + data + "\"}"; int httpCode = http.POST(payload); if(httpCode > 0) { Serial.printf("数据上传成功，状态码: %d\n", httpCode); } else { Serial.printf("上传失败，错误: %s\n", http.errorToString(httpCode).c_str()); } http.end(); } }

7.2 移动端配合开发

Android蓝牙连接示例代码（Java）：

// AndroidManifest.xml添加权限 <uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> // 主要连接逻辑 BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter(); BluetoothDevice device = adapter.getRemoteDevice("24:0A:C4:12:34:56"); UUID sppUUID = UUID.fromString("00001101-0000-1000-8000-00805F9B34FB"); BluetoothSocket socket = device.createRfcommSocketToServiceRecord(sppUUID); try { socket.connect(); OutputStream outStream = socket.getOutputStream(); outStream.write('A'); // 发送开灯指令 InputStream inStream = socket.getInputStream(); byte[] buffer = new byte[1024]; int bytes = inStream.read(buffer); String response = new String(buffer, 0, bytes); } catch (IOException e) { e.printStackTrace(); }

7.3 工业级应用改进

1. 抗干扰设计：

   • 采用跳频算法避开拥堵频道
   • 增加信号强度检测

   int rssi = esp_bt_gap_get_rssi(remote_bda); if(rssi < -80) { Serial.println("信号弱，可能影响通信质量"); }

2. 数据完整性校验：

   bool verifyChecksum(const uint8_t* data, size_t len) { uint8_t sum = 0; for(size_t i=0; i<len-1; i++) { sum ^= data[i]; } return sum == data[len-1]; }

3. 看门狗保护：

   #include <esp_task_wdt.h> void setup() { esp_task_wdt_init(5, true); // 5秒看门狗 esp_task_wdt_add(NULL); // 添加当前任务 } void loop() { esp_task_wdt_reset(); // 喂狗 // ...其他代码 }