深入PHY6222蓝牙协议栈：从simpleBLEPeripheral看GATT属性表的组织与交互逻辑-平芜编程栈

深入PHY6222蓝牙协议栈：从simpleBLEPeripheral看GATT属性表的组织与交互逻辑

在低功耗蓝牙（BLE）开发中，GATT（通用属性配置文件）层的数据交互机制往往是调试的深水区。当我们基于PHY6222这类高度集成的蓝牙SoC进行开发时，理解ROM代码与应用程序如何协同管理属性表，将成为解决通信异常、优化数据吞吐的关键突破口。本文将以simpleBLEPeripheral例程为解剖对象，揭示属性表在内存中的真实布局、读写回调的触发链路，以及特征值与描述符的动态关联方式——这些知识不仅能帮助开发者快速定位"特征值读写无响应"、"通知无法触发"等典型问题，更能为自定义复杂服务提供底层设计依据。

1. GATT属性表的内存结构与组织逻辑

属性表（gattAttribute_t数组）是PHY6222协议栈中GATT服务的物理载体，其本质是一段由开发者声明、ROM代码管理的连续内存区域。每个属性包含四个核心字段：

typedef struct gattAttribute_t { gattAttrType_t type; // UUID类型标识 uint8_t permissions; // 访问权限掩码 uint16_t handle; // 动态分配的句柄 uint8_t* pValue; // 指向属性值的指针 } gattAttribute_t;

在gapgattserver.c中，GAP服务的属性表示例揭示了典型的三层嵌套结构：

服务声明（Service Declaration）
- UUID固定为0x2800（主服务）或0x2801（次要服务）
- 值字段指向该服务使用的16位或128位UUID
特征声明（Characteristic Declaration）
- UUID固定为0x2803
- 值字段包含特征属性（可读/可写/可通知等）和特征值句柄
特征值及其描述符
- 自定义UUID（如设备名称使用0x2A00）
- 可能附带客户端特征配置描述符（CCCD，UUID=0x2902）

表：GAP服务属性表片段解析

属性类型	UUID	权限	值内容示例	作用
服务声明	0x2800	READ	0x1800（GAP服务UUID）	声明服务类型
特征声明	0x2803	READ	0x02（可读）+特征值句柄	声明设备名称特征
特征值	0x2A00	READ	"PHY6222_Device"	存储实际设备名称
描述符	0x2902	READ+WRITE	0x0000（通知禁用）	CCCD控制通知功能

这种结构的关键在于：

动态句柄分配：ROM代码在GATTServApp_AddService()时会遍历属性表，为每个属性分配唯一句柄
跨层关联：特征声明中的值句柄必须指向后续的特征值属性
权限分离：特征声明描述操作能力，特征值属性定义实际访问权限

2. 读写回调的触发路径与数据流

当BLE主机发起读/写请求时，PHY6222的ROM代码会按以下路径处理数据包：

射频层到协议栈：
- 基带硬件接收空中数据包
- ROM中的链路层解析LL Header
- L2CAP层拆解通道ID和长度

GATT层路由：

graph TD A[ATT请求包] --> B{操作类型} B -->|READ_REQ| C[查找属性表匹配句柄] B -->|WRITE_REQ| D[校验权限掩码] C --> E[调用注册的读回调] D --> F[调用注册的写回调]

实际代码中，回调触发发生在simpleProfile_ReadAttrCB和simpleProfile_WriteAttrCB：

// 读回调示例 uint8_t simpleProfile_ReadAttrCB(uint16_t handle, void *pValue) { if (handle == simpleProfileChar6ValHandle) { // 匹配特征值句柄 memcpy(pValue, &char6Value, sizeof(char6Value)); return SUCCESS; } return ATT_ERR_ATTR_NOT_FOUND; } // 写回调示例 uint8_t simpleProfile_WriteAttrCB(uint16_t handle, void *pValue) { if (handle == simpleProfileChar6ConfigHandle) { // CCCD句柄 uint16_t cccdValue = BUILD_UINT16((uint8_t*)pValue); GATTServApp_ProcessCCCWriteReq(connHandle, handle, cccdValue); } return SUCCESS; }

权限验证机制：
- ROM代码会先检查属性表的permissions字段
- 写操作需同时满足特征声明和特征值的权限要求
- 加密连接时会验证GAPBOND_AUTHEN等安全标志

调试提示：若回调未触发，建议检查：
属性表句柄是否与回调参数匹配
权限掩码是否包含对应操作（如写属性需含GATT_PERMIT_WRITE）
连接参数是否满足安全要求

3. 特征值与描述符的动态关联技术

在simpleBLEPeripheral中，通知功能的实现展示了属性间的动态绑定：

CCCD配置流程：
- 主机向CCCD（UUID=0x2902）写入0x0001启用通知
- 写回调中调用GATTServApp_ProcessCCCWriteReq()
- ROM代码更新内部状态机
通知发送机制：
```
// 当需要主动通知时 GATTServApp_NotifyValue(connHandle, char6ValHandle, sizeof(data), data);
```
底层实际通过ATT_HANDLE_VALUE_NOTI报文发送数据，其帧结构为：
- 操作码：0x1B
- 属性句柄：2字节
- 属性值：N字节
内存管理技巧：
- 特征值指针pValue可指向静态或动态内存
- 对于频繁更新的数据，建议使用osal_mem_alloc()动态分配
- 描述符通常使用共享内存池以减少碎片

表：特征值更新策略对比

策略	适用场景	优点	风险
静态内存	只读配置项	零拷贝开销	无法动态修改
动态单次分配	大块数据（如OTA包）	灵活控制生命周期	需手动释放防泄漏
环形缓冲区	高频传感器数据	避免分配开销	需要同步机制

4. 实战：构建自定义服务的黄金法则

基于PHY6222开发自定义服务时，建议遵循以下设计模式：

属性表声明模板：

static uint8_t charValue[20] = {0}; static gattAttribute_t customServAttrTbl[] = { // 服务声明 { { ATT_BT_UUID_SIZE, primaryServiceUUID }, GATT_PERMIT_READ, 0, (uint8_t *)&customServUUID }, // 特征1声明 { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, (uint8_t *)&(uint8_t[]){ PROP_READ|PROP_NOTIFY, 0x00, 0x00 } }, // 特征1值 { { ATT_BT_UUID_SIZE, char1UUID }, GATT_PERMIT_READ|GATT_PERMIT_WRITE, 0, charValue }, // 特征1CCCD { { ATT_BT_UUID_SIZE, clientCharCfgUUID }, GATT_PERMIT_READ|GATT_PERMIT_WRITE, 0, (uint8_t *)&(uint16_t){0} } };

回调函数最佳实践：
- 使用句柄比对而非UUID判断目标特征（效率更高）
- 对写操作实现超时检查（防止主设备频繁写）
- 在通知前验证CCCD状态（避免无效空中包）
性能优化技巧：
- 将高频访问的特征集中在属性表前端
- 对只读特征使用const修饰避免误修改
- 使用#pragma pack(1)确保结构体紧凑对齐