当前位置：首页 > news >正文

从手机APP反推ESP32-C3蓝牙开发：看懂这些GATT数据，你就能改任何例程

news 2026/4/24 22:33:52

从手机APP反推ESP32-C3蓝牙开发：解码GATT数据与代码映射实战

当你用nRF Connect或LightBlue成功连接到ESP32-C3开发板时，手机屏幕上那些密密麻麻的Service、Characteristic和UUID是否让你感到无从下手？本文将以逆向工程视角，带你逐项解析APP中的GATT数据结构，并揭示它们与ESP-IDF代码的对应关系。掌握这套方法后，你将能自由修改任何GATT Server例程，打造专属蓝牙服务。

1. 手机APP界面与GATT数据库的映射关系

打开蓝牙调试APP连接设备后，你会看到类似如下的层级结构：

[Device Name] └── Generic Access (0x1800) ├── Device Name (0x2A00, Read) └── Appearance (0x2A01, Read) └── Generic Attribute (0x1801) └── Service Changed (0x2A05, Indicate) └── Custom Service (0xFFE0) ├── RX Characteristic (0xFFE1, Write/Notify) └── TX Characteristic (0xFFE2, Read)

每个条目都对应着ESP32-C3代码中的特定数据结构。关键字段解析：

APP显示字段	代码对应项	作用说明
Service UUID	`esp_bt_uuid_t`结构体	服务唯一标识符
Characteristic UUID	`esp_gatts_attr_db_t`中的uuid	特征值标识符
Properties	`esp_gatt_char_prop_t`	读写/通知等权限设置
Handle	`gatts_if`事件返回的handle	属性操作句柄

示例代码片段 - 属性表定义：

static const esp_gatts_attr_db_t gatt_db[HRS_IDX_NB] = { [IDX_SVC] = { .attr_type = ESP_GATT_AUTO_RSP, .att_desc = { .uuid_length = ESP_UUID_LEN_16, .uuid_p = (uint8_t *)&primary_service_uuid, .perm = ESP_GATT_PERM_READ, .max_length = sizeof(heart_rate_service_uuid), .length = sizeof(heart_rate_service_uuid), .value = (uint8_t *)&heart_rate_service_uuid, } }, // 更多特征值定义... };

2. 逆向解析：从APP数据到代码修改

2.1 识别自定义服务与特征值

当APP显示非标准UUID（如0xFFE0）时，说明这是开发者自定义服务。在代码中需要定位到对应的服务初始化部分：

查找服务声明：在工程中搜索ESP_UUID_LEN_16和UUID值
验证权限设置：对比APP显示的Properties与代码中的esp_gatt_char_prop_t
定位特征值操作：通过Handle值匹配gatts_cb中的事件处理

关键数据结构对照：

typedef struct { uint16_t attr_handle; // 对应APP中的Handle uint16_t uuid_len; // UUID长度(2/16字节) uint8_t *uuid; // 指向UUID的指针 esp_gatt_perm_t perm; // 权限设置(读/写等) uint16_t max_length; // 最大数据长度 uint16_t length; // 当前数据长度 uint8_t *value; // 特征值数据指针 } esp_attr_desc_t;

2.2 修改特征值属性实战

假设需要将某个特征值改为"Write + Notify"模式：

修改属性表：更新esp_gatts_attr_db_t中的权限字段

.perm = ESP_GATT_PERM_WRITE | ESP_GATT_PERM_READ,

更新特征值属性：

.char_prop = ESP_GATT_CHAR_PROP_BIT_WRITE | ESP_GATT_CHAR_PROP_BIT_NOTIFY,

添加通知发送代码：

esp_ble_gatts_send_indicate( gatts_if, conn_id, handle, data_len, data, false);

注意：修改后需重新注册服务，调用esp_ble_gatts_app_register()生效

3. 典型调试问题与数据流分析

3.1 数据收发异常排查流程

检查MTU大小：

# 在ESP-IDF日志中查找 I (1024) GATTS_DEMO: MTU size updated: 256

验证属性权限：
- 写操作失败 → 检查ESP_GATT_PERM_WRITE
- 读操作失败 → 检查ESP_GATT_PERM_READ
数据格式匹配：
- APP发送Hex数据时，代码需做二进制解析
- 字符串数据需注意终止符处理

3.2 特征值交互时序图

+------------+ +---------------+ +-----------+ | Client | | ESP32-C3 | | GATT Server| +------------+ +---------------+ +-----------+ | Write Request | | |------------------->| | | | GATTS_WRITE_EVT | | |--------------------->| | | Handle Data | | |<---------------------| | Write Response | | |<-------------------| | | | Notification | |<------------------------------------------|

4. 高级技巧：动态服务构建

对于需要运行时修改的服务，可采用动态创建方式：

基础服务框架：

esp_err_t create_dynamic_service() { esp_ble_gatts_create_service(gatts_if, &service_uuid, 5); // 添加特征值... esp_ble_gatts_add_char(service_handle, &char_uuid, perm, property, &char_val, NULL); }

动态更新特征值：

void update_characteristic(uint16_t handle, uint8_t *data, size_t len) { esp_ble_gatts_set_attr_value(handle, len, data); if (need_notify) { esp_ble_gatts_send_indicate(...); } }