TechTitan1. ESP32蓝牙服务器项目概述
在物联网和智能设备开发领域，ESP32凭借其出色的性能和丰富的功能集成为了开发者的首选。今天我要分享的是一个基于ESP-IDF框架的蓝牙服务器实现，它能够与手机等蓝牙客户端设备建立稳定通信。这个项目特别适合需要实现设备间无线数据交换的场景，比如智能家居控制、传感器数据采集或者远程控制应用。
ESP32的蓝牙功能非常强大，支持经典蓝牙和低功耗蓝牙(BLE)两种模式。本项目中我们使用的是BLE模式，因为它功耗更低，更适合电池供电的设备。通过这个项目，你将学习到如何配置ESP32作为GATT服务器，创建自定义服务，以及处理来自客户端的读写请求。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 开发环境搭建与准备
2.1 硬件准备
首先你需要准备以下硬件设备：
- ESP32开发板（推荐使用官方ESP32-DevKitC）
- 微型USB数据线（用于供电和编程）
- 智能手机（Android或iOS，用于测试蓝牙连接）
ESP32开发板的选择很重要，市面上有些廉价开发板可能使用了劣质天线，会导致蓝牙信号不稳定。我推荐使用乐鑫官方的开发板，或者知名厂商如Adafruit、SparkFun的产品。
2.2 软件环境配置
开发环境搭建步骤如下：
- 安装VS Code（推荐）或其他你喜欢的代码编辑器
- 安装ESP-IDF插件（在VS Code扩展商店搜索"Espressif IDF"）
- 通过插件安装ESP-IDF工具链（选择最新稳定版本）
- 安装必要的驱动程序（CP210x或CH340，取决于你的开发板使用的USB转串口芯片）
注意：安装过程中可能会遇到Python环境问题，建议使用ESP-IDF插件自带的Python环境，而不是系统全局的Python。
安装完成后，可以通过运行以下命令验证安装是否成功：
bash复制idf.py --version
如果安装正确，这将显示ESP-IDF的版本信息。
2.3 项目创建与配置
创建一个新的ESP-IDF项目：
bash复制idf.py create-project ble_spp_server
cd ble_spp_server
然后运行menuconfig进行必要的配置：
bash复制idf.py menuconfig
在配置界面中，你需要：
- 选择正确的串口端口
- 设置蓝牙相关参数（在Component config → Bluetooth下）
- 配置项目名称和设备名称
3. 蓝牙协议基础与架构设计
3.1 BLE协议栈解析
蓝牙低功耗(BLE)协议栈由多个层次组成：
- 物理层(PHY)：工作在2.4GHz ISM频段，使用40个信道，每个信道间隔2MHz
- 链路层(LL)：负责广播、扫描、建立和维护连接
- 主机控制器接口(HCI)：主机和控制器之间的标准通信接口
- 逻辑链路控制与适配协议(L2CAP)：提供数据封装服务
- 属性协议(ATT)：定义客户端-服务器结构的通信方式
- 通用属性规范(GATT)：建立在ATT之上，定义服务、特征值等高级概念
- 通用访问规范(GAP)：处理设备发现、连接建立和安全相关功能
3.2 GATT服务设计
在我们的项目中，我们实现了一个简单的串口协议(SPP)服务，UUID为0xABF0。这个服务包含一个特征值(UUID:0xABF1)，具有读、写和通知属性。
服务设计考虑：
- 特征值需要支持写入，以便接收来自客户端的数据
- 需要支持通知，以便向客户端推送数据
- 需要足够的MTU大小来保证数据传输效率
4. 核心代码实现解析
4.1 蓝牙服务初始化
蓝牙系统的初始化在app_main()函数中完成：
c复制void app_main(void) {
// 初始化NVS存储
esp_err_t ret = nvs_flash_init();
if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
ESP_ERROR_CHECK(nvs_flash_erase());
ret = nvs_flash_init();
}
ESP_ERROR_CHECK(ret);
// 初始化NimBLE蓝牙堆栈
ret = nimble_port_init();
if (ret != ESP_OK) {
MODLOG_DFLT(ERROR, "Failed to init nimble %d \n", ret);
retur