用两块ESP32玩转蓝牙：手把手搭建双向数据透传系统（基于ESP-IDF GATT例程）

用两块ESP32玩转蓝牙手把手搭建双向数据透传系统基于ESP-IDF GATT例程在物联网开发中蓝牙低功耗BLE技术因其低功耗、低成本的特点成为设备间短距离通信的首选方案之一。ESP32作为一款集成了Wi-Fi和蓝牙双模通信的微控制器凭借其丰富的开发资源和强大的性能在智能家居、可穿戴设备等领域广受欢迎。本文将带你深入探索如何利用两块ESP32开发板基于ESP-IDF框架的GATT协议构建一个完整的双向数据透传系统。不同于常见的ESP32-手机通信模式本方案专注于两块ESP32之间的直接交互。一块作为GATT Server负责采集传感器数据并主动推送另一块作为GATT Client接收数据的同时也能发送控制指令。这种设备间直接通信的方案在需要构建本地无线传感器网络或分布式控制系统的场景中尤为实用。1. 系统架构与核心概念1.1 GATT角色定义在BLE通信中GATT通用属性协议定义了两种基本角色GATT Server存储数据并提供服务维护一个属性表Attribute Table响应Client的读写请求可以主动发送通知Notify或指示IndicateGATT Client发现并访问Server上的数据发起连接请求发现服务和特征读写特征值订阅通知两块ESP32分别承担这两种角色形成对等通信架构。这种设计比传统的主从模式更灵活允许双向数据流动。1.2 通信流程概览完整的交互过程包括以下几个关键阶段广播与发现Server端广播自身存在Client端扫描并识别目标设备连接建立Client发起连接请求协商通信参数服务发现Client查询Server提供的服务及其特征特征配置Client订阅感兴趣的特征通知数据交换双向的数据传输Server通知/Client写入1.3 关键数据结构在ESP-IDF中BLE通信主要涉及以下核心数据结构// 服务定义 esp_gatts_attr_db_t gatt_db[] { // 服务声明 [IDX_SVC] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)primary_service_uuid, ESP_GATT_PERM_READ, sizeof(uint16_t), sizeof(heart_rate_svc_uuid), (uint8_t *)heart_rate_svc_uuid}}, // 特征声明 [IDX_CHAR_A] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)character_declaration_uuid, ESP_GATT_PERM_READ, CHAR_DECLARATION_SIZE, CHAR_DECLARATION_SIZE, (uint8_t *)char_prop_read_write_notify}}, // 特征值 [IDX_CHAR_VAL_A] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)char_a_uuid, ESP_GATT_PERM_READ | ESP_GATT_PERM_WRITE, GATTS_DEMO_CHAR_VAL_LEN_MAX, sizeof(char_value_a), (uint8_t *)char_value_a}}, // 特征描述符客户端特征配置 [IDX_CHAR_CFG_A] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)character_client_config_uuid, ESP_GATT_PERM_READ | ESP_GATT_PERM_WRITE, sizeof(uint16_t), sizeof(heart_rate_ccc), (uint8_t *)heart_rate_ccc}}, };2. Server端实现详解2.1 服务与特征定义首先需要为Server定义服务和特征。一个服务可以包含多个特征每个特征代表一个具体的数据点或功能。以下是定义温湿度服务的示例// 自定义UUID避免与标准服务冲突 #define SERVICE_UUID 0x00FF #define CHAR_TEMP_UUID 0xFF01 #define CHAR_HUMID_UUID 0xFF02 #define CHAR_CTRL_UUID 0xFF03 // 属性表定义 static const esp_gatts_attr_db_t gatt_db[] { // 服务声明 [IDX_SERVICE] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)PRIMARY_SERVICE_UUID, ESP_GATT_PERM_READ, sizeof(uint16_t), sizeof(SERVICE_UUID), (uint8_t *)SERVICE_UUID}}, // 温度特征声明 [IDX_CHAR_TEMP] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)CHARACTER_DECLARE_UUID, ESP_GATT_PERM_READ, CHAR_DECLARATION_SIZE, CHAR_DECLARATION_SIZE, (uint8_t *)char_prop_read_notify}}, // 温度特征值 [IDX_CHAR_VAL_TEMP] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)CHAR_TEMP_UUID, ESP_GATT_PERM_READ, sizeof(temp_value), sizeof(temp_value), (uint8_t *)temp_value}}, // 温度特征描述符客户端特征配置 [IDX_CHAR_CFG_TEMP] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)CHAR_CLIENT_CONFIG_UUID, ESP_GATT_PERM_READ | ESP_GATT_PERM_WRITE, sizeof(uint16_t), sizeof(temp_ccc), (uint8_t *)temp_ccc}}, // 控制特征用于接收Client指令 [IDX_CHAR_CTRL] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)CHARACTER_DECLARE_UUID, ESP_GATT_PERM_READ, CHAR_DECLARATION_SIZE, CHAR_DECLARATION_SIZE, (uint8_t *)char_prop_write}}, [IDX_CHAR_VAL_CTRL] {{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)CHAR_CTRL_UUID, ESP_GATT_PERM_WRITE, CTRL_CMD_LEN, sizeof(ctrl_cmd), (uint8_t *)ctrl_cmd}}, };2.2 事件处理逻辑Server需要处理各种GATT事件以下是关键事件的处理示例void gatts_event_handler(esp_gatts_cb_event_t event, esp_gatt_if_t gatts_if, esp_ble_gatts_cb_param_t *param) { switch (event) { case ESP_GATTS_REG_EVT: // 注册应用完成保存接口ID gl_profile_tab[PROFILE_APP_IDX].gatts_if gatts_if; break; case ESP_GATTS_READ_EVT: // 处理读取请求 handle_read_event(gatts_if, param-read); break; case ESP_GATTS_WRITE_EVT: // 处理写入请求 handle_write_event(gatts_if, param-write); break; case ESP_GATTS_CONF_EVT: // 确认通知已发送 if (param-conf.status ! ESP_GATT_OK) { ESP_LOGE(GATTS_TAG, Notify failed); } break; default: break; } }2.3 数据更新与通知机制要实现实时数据推送Server需要定期更新特征值并发送通知void update_sensor_data(void *arg) { while (1) { // 模拟读取传感器数据 float temp read_temperature(); float humid read_humidity(); // 更新特征值 esp_ble_gatts_set_attr_value(gl_profile_tab[PROFILE_APP_IDX].char_handle, sizeof(temp), (uint8_t *)temp); // 检查客户端是否启用通知 if (is_notify_enabled()) { esp_ble_gatts_send_indicate(gl_profile_tab[PROFILE_APP_IDX].gatts_if, gl_profile_tab[PROFILE_APP_IDX].conn_id, gl_profile_tab[PROFILE_APP_IDX].char_handle, sizeof(temp), (uint8_t *)temp, false); } vTaskDelay(pdMS_TO_TICKS(2000)); // 2秒更新一次 } }注意在实际应用中应根据传感器特性和功耗要求合理设置数据更新频率。过高的频率会导致功耗增加而过低的频率则可能无法满足实时性需求。3. Client端实现详解3.1 设备扫描与连接Client端首先需要扫描附近的BLE设备识别目标Server后建立连接void gap_event_handler(esp_gap_ble_cb_event_t event, esp_ble_gap_cb_param_t *param) { switch (event) { case ESP_GAP_BLE_SCAN_RESULT_EVT: // 处理扫描结果 if (param-scan_rst.search_evt ESP_GAP_SEARCH_INQ_RES_EVT) { // 检查设备名称或服务UUID是否匹配 if (strlen(device_name) param-scan_rst.adv_data_len memcmp(device_name, param-scan_rst.ble_adv, param-scan_rst.adv_data_len) 0) { // 停止扫描 esp_ble_gap_stop_scanning(); // 发起连接 esp_ble_gap_connect(param-scan_rst.bda); } } break; case ESP_GAP_BLE_SCAN_PARAM_SET_COMPLETE_EVT: // 扫描参数设置完成开始扫描 esp_ble_gap_start_scanning(SCAN_DURATION); break; case ESP_GAP_BLE_SCAN_START_COMPLETE_EVT: if (param-scan_start_cmpl.status ! ESP_BT_STATUS_SUCCESS) { ESP_LOGE(GATTC_TAG, Scan start failed); } break; default: break; } }3.2 服务发现与特征配置连接建立后Client需要发现Server提供的服务并配置感兴趣的特征void gattc_event_handler(esp_gattc_cb_event_t event, esp_gatt_if_t gattc_if, esp_ble_gattc_cb_param_t *param) { switch (event) { case ESP_GATTC_SEARCH_RES_EVT: // 发现服务 if (param-search_res.srvc_id.uuid.len ESP_UUID_LEN_16 param-search_res.srvc_id.uuid.uuid.uuid16 SERVICE_UUID) { // 保存服务信息 gl_profile_tab[PROFILE_APP_IDX].service_start_handle param-search_res.start_handle; gl_profile_tab[PROFILE_APP_IDX].service_end_handle param-search_res.end_handle; gl_profile_tab[PROFILE_APP_IDX].service_id param-search_res.srvc_id; } break; case ESP_GATTC_SEARCH_CMPL_EVT: // 服务发现完成 if (param-search_cmpl.status ! ESP_GATT_OK) { ESP_LOGE(GATTC_TAG, Search service failed); break; } // 获取特征 esp_ble_gattc_get_characteristic(gattc_if, gl_profile_tab[PROFILE_APP_IDX].conn_id, gl_profile_tab[PROFILE_APP_IDX].service_id, NULL); break; case ESP_GATTC_GET_CHAR_EVT: // 处理获取到的特征 if (param-get_char.char_uuid.uuid.uuid16 CHAR_TEMP_UUID) { // 保存温度特征句柄 gl_profile_tab[PROFILE_APP_IDX].char_handle param-get_char.char_handle; // 获取特征描述符 esp_ble_gattc_get_descriptor(gattc_if, gl_profile_tab[PROFILE_APP_IDX].conn_id, gl_profile_tab[PROFILE_APP_IDX].service_id, param-get_char.char_uuid, NULL); } break; case ESP_GATTC_REG_FOR_NOTIFY_EVT: // 注册通知成功 esp_ble_gattc_write_char_descr(gattc_if, gl_profile_tab[PROFILE_APP_IDX].conn_id, gl_profile_tab[PROFILE_APP_IDX].descr_handle, sizeof(enable_notify), (uint8_t *)enable_notify, ESP_GATT_WRITE_TYPE_RSP, ESP_GATT_AUTH_REQ_NONE); break; default: break; } }3.3 数据接收与处理Client需要处理从Server接收到的通知数据void gattc_event_handler(esp_gattc_cb_event_t event, esp_gatt_if_t gattc_if, esp_ble_gattc_cb_param_t *param) { // ... 其他事件处理 case ESP_GATTC_NOTIFY_EVT: // 处理通知数据 if (param-notify.handle gl_profile_tab[PROFILE_APP_IDX].char_handle) { // 解析温度数据 float temperature; memcpy(temperature, param-notify.value, param-notify.value_len); // 处理数据如显示、存储或转发 process_temperature_data(temperature); } break; case ESP_GATTC_WRITE_CHAR_EVT: // 写入特征值完成 if (param-write.status ! ESP_GATT_OK) { ESP_LOGE(GATTC_TAG, Write char failed); } break; }4. 双向通信实战4.1 Server向Client发送传感器数据实现Server定期采集并推送传感器数据的完整流程Server端初始化传感器接口创建定时任务读取传感器数据更新特征值检查通知是否启用发送指示或通知Client端连接Server并发现服务订阅温度特征通知在通知回调中处理接收到的数据4.2 Client向Server发送控制指令实现Client控制Server端设备的完整流程Server端定义可写特征在写入事件处理函数中解析指令执行相应操作如控制GPIOClient端获取控制特征句柄构造控制指令写入特征值示例代码Client发送LED控制指令void send_led_control(uint8_t state) { if (gl_profile_tab[PROFILE_APP_IDX].char_handle 0) { ESP_LOGE(GATTC_TAG, Control characteristic not found); return; } uint8_t cmd state ? 0x01 : 0x00; esp_ble_gattc_write_char(gl_profile_tab[PROFILE_APP_IDX].gatts_if, gl_profile_tab[PROFILE_APP_IDX].conn_id, gl_profile_tab[PROFILE_APP_IDX].char_handle, sizeof(cmd), cmd, ESP_GATT_WRITE_TYPE_RSP, ESP_GATT_AUTH_REQ_NONE); }4.3 通信稳定性优化在实际应用中需要考虑以下优化措施连接参数协商合理设置连接间隔、从机延迟和监督超时// 建议的连接参数单位1.25ms #define CONN_MIN_INTERVAL 16 // 20ms #define CONN_MAX_INTERVAL 32 // 40ms #define CONN_LATENCY 0 #define SUPERVISION_TIMEOUT 400 // 5s esp_ble_gap_update_conn_params(conn_params);错误处理与重连机制监控连接状态变化实现自动重连逻辑处理各种异常情况数据校验与重传添加简单的校验机制如CRC实现重要数据的确认与重传5. 调试技巧与常见问题5.1 常用调试工具开发过程中以下工具能极大提高效率nRF Connect功能强大的BLE调试APP可用于扫描和查看广播数据连接设备并浏览GATT表读写特征值订阅通知Wireshark BLE嗅探器用于深度分析BLE协议交互捕获空中传输的BLE数据包分析连接参数、数据时序等ESP-IDF Monitor查看设备日志输出实时查看调试信息捕获崩溃堆栈5.2 典型问题排查以下是开发中可能遇到的常见问题及解决方案问题现象可能原因解决方案无法建立连接广播参数不匹配检查Server的广播数据和Client的扫描过滤条件服务发现失败UUID定义不一致确认两端使用相同的服务UUID通知不工作客户端未启用通知检查是否成功写入CCC描述符值数据乱码字节序或格式不一致统一两端的数据格式如都使用小端序连接不稳定连接参数不合理优化连接参数考虑环境干扰5.3 性能优化建议减少广播数据量只包含必要信息缩短广播间隔优化MTU大小协商更大的MTU以提高吞吐量// 在连接建立后协商MTU esp_ble_gattc_send_mtu_req(gattc_if, conn_id, 247);批量数据传输对于大量数据考虑分片传输功耗优化根据应用场景调整连接参数和工作周期在实际项目中两块ESP32通过BLE实现双向通信的方案已经成功应用于多个场景。比如在智能农业监测系统中一块ESP32作为数据采集节点Server另一块作为网关Client既实现了传感器数据的定期上报又支持远程配置参数的更新。调试过程中发现合理设置连接参数对系统稳定性和功耗影响很大特别是在多节点组网时需要仔细平衡实时性和能耗。