保姆级教程：在沁恒CH585蓝牙例程上，手把手教你添加Notify特征并实现数据回传

沁恒CH585蓝牙Notify特征开发实战：从协议原理到数据回传实现

刚接触沁恒CH585蓝牙开发板的工程师们，常常会遇到这样的困惑：明明已经跑通了官方例程，但当需要实现设备主动上报数据时，却不知从何入手。本文将带您深入蓝牙协议栈底层，通过添加Notify特征实现传感器数据回传的完整过程，让您真正掌握蓝牙从机设备主动通信的核心机制。

1. 理解Notify特征的技术本质

在开始修改代码之前，我们需要先弄清楚几个关键问题：为什么需要Notify特征？它与常规的读写操作有何本质区别？理解这些底层原理，才能避免"照猫画虎"式的开发。

蓝牙GATT协议中，Notify是一种服务器主动向客户端推送数据的机制。与传统的客户端轮询方式相比，它具有三个显著优势：

• 实时性：数据产生后立即推送，无需等待客户端查询
• 低功耗：减少不必要的通信次数，显著降低能耗
• 高效率：特别适合传感器数据等变化频繁的场景

实现Notify特征需要三个核心组件协同工作：

1. 特征属性：在属性表中声明GATT_PROP_NOTIFY标志
2. 客户端配置描述符(CCCD)：用于客户端启用/禁用通知
3. 服务端通知接口：实际执行数据发送的函数

注意：Notify与Indicate的区别在于前者不需要确认，传输更高效但不可靠；后者需要客户端确认，适合关键数据传输。

2. 开发环境准备与例程分析

2.1 硬件与软件基础配置

在开始编码前，请确保您的开发环境已正确设置：

• 硬件准备：

  • 沁恒CH585开发板
  • 支持BLE的手机或蓝牙嗅探器
  • 传感器模块（如需要实际数据源）

• 软件依赖：

  • MounRiver Studio开发环境
  • 沁恒BLE协议栈SDK
  • 手机端BLE调试工具（如nRF Connect）

建议先编译并运行官方SimpleProfile例程，确认基础通信功能正常。这个例程通常包含5个基本特征，我们将基于第5个特征进行扩展。

2.2 关键代码结构分析

官方例程中与特征相关的代码主要分布在三个位置：

1. 属性表定义：simpleProfileAttrTbl[]

   • 包含所有特征的定义和权限设置
   • 每个特征占用多个属性条目

2. 特征配置结构：simpleProfileCharXConfig

   • 存储每个连接的客户端配置
   • 用于管理Notify/Indicate的启用状态

3. 服务处理函数：SimpleProfile_前缀函数

   • 实现特征的读写操作
   • 需要添加新的通知发送接口

理解这个结构对后续修改至关重要，建议先用调试器单步跟踪一次特征读写的完整流程。

3. 分步实现Notify特征

3.1 修改特征属性与配置

首先找到特征5的属性定义位置，通常位于simpleProfile.c文件中：

// 原特征属性（通常只有READ） static uint8_t simpleProfileChar5Props = GATT_PROP_READ; // 修改为支持Notify static uint8_t simpleProfileChar5Props = GATT_PROP_READ | GATT_PROP_NOTIFY;

接着添加CCCD配置数组，每个BLE连接都需要独立的配置存储：

// 在文件顶部全局变量区域添加 static gattCharCfg_t simpleProfileChar5Config[PERIPHERAL_MAX_CONNECTION];

技术细节：PERIPHERAL_MAX_CONNECTION定义了设备支持的最大并行连接数，需要根据实际需求调整。

3.2 更新属性表结构

属性表是蓝牙协议栈的核心数据结构，我们需要插入CCCD描述符条目。找到特征5在属性表中的位置，在其值属性后添加：

// 原属性表片段 { {ATT_BT_UUID_SIZE, simpleProfilechar5UUID}, GATT_PERMIT_READ, 0, &simpleProfileChar5 }, // 添加CCCD描述符 { {ATT_BT_UUID_SIZE, clientCharCfgUUID}, GATT_PERMIT_READ | GATT_PERMIT_WRITE, 0, (uint8_t *)simpleProfileChar5Config },

关键点说明：

• clientCharCfgUUID是蓝牙标准定义的CCCD UUID
• 权限设置为可读写，允许客户端配置
• 指向我们之前定义的配置数组

3.3 初始化Notify配置

在协议栈初始化阶段（通常是SimpleProfile_Init函数），添加配置初始化：

void SimpleProfile_Init(void) { // 其他初始化代码... GATTServApp_InitCharCfg(INVALID_CONNHANDLE, simpleProfileChar5Config); }

同时需要在连接建立回调中初始化新连接的配置：

static void peripheralConnEvtCB(uint16_t connHandle) { // 其他连接处理代码... GATTServApp_InitCharCfg(connHandle, simpleProfileChar5Config); }

4. 实现数据通知功能

4.1 创建底层通知接口

添加实际的Notify发送函数，建议放在simpleProfile.c中：

bStatus_t simpleProfile5_Notify(uint16_t connHandle, uint8_t *pData, uint16_t len) { attHandleValueNoti_t noti; uint16_t cccdValue; // 检查通知是否被客户端启用 cccdValue = GATTServApp_ReadCharCfg(connHandle, simpleProfileChar5Config); if(!(cccdValue & GATT_CLIENT_CFG_NOTIFY)) { return bleDisabled; } // 准备通知数据 noti.handle = simpleProfileAttrTbl[SIMPLEPROFILE_CHAR5_VALUE_POS].handle; noti.len = len; noti.pValue = GATT_bm_alloc(connHandle, ATT_HANDLE_VALUE_NOTI, len, NULL, 0); if(!noti.pValue) { return bleNoResources; } memcpy(noti.pValue, pData, len); bStatus_t status = GATT_Notification(connHandle, &noti, FALSE); GATT_bm_free((gattMsg_t *)&noti, ATT_HANDLE_VALUE_NOTI); return status; }

4.2 封装应用层接口

为方便上层应用调用，可以创建一个更友好的接口：

void sendSensorDataViaNotify(uint16_t connHandle, sensor_data_t *data) { uint8_t buffer[20]; uint16_t len = packSensorData(data, buffer); if(simpleProfile5_Notify(connHandle, buffer, len) != SUCCESS) { PRINT("Notify发送失败\n"); // 实现重试或错误处理逻辑 } }

4.3 数据流测试与验证

实现一个简单的回传测试逻辑：

static void char1WriteCB(uint16_t connHandle, uint8_t *pValue, uint16_t len) { // 将接收到的数据通过Notify回传 simpleProfile5_Notify(connHandle, pValue, len); // 实际应用中可能是处理传感器数据 // processSensorData(pValue, len); }

测试步骤：

1. 使用手机APP连接设备
2. 找到特征5并启用Notify
3. 向特征1写入测试数据
4. 确认在特征5收到相同数据

5. 高级优化与调试技巧

5.1 MTU与数据分片处理

蓝牙4.0默认MTU为23字节，实际可用空间更少。需要处理大数据情况：

#define MAX_NOTIFY_SIZE (peripheralMTU - 3) void sendLargeData(uint16_t connHandle, uint8_t *data, uint32_t totalLen) { uint32_t sent = 0; while(sent < totalLen) { uint16_t chunkSize = MIN(MAX_NOTIFY_SIZE, totalLen - sent); if(simpleProfile5_Notify(connHandle, &data[sent], chunkSize) != SUCCESS) { // 错误处理 break; } sent += chunkSize; tmos_start_task(peripheralTaskID, SEND_DELAY_EVT, MS1_TO_SYSTEM_TIME(50)); } }

5.2 连接参数优化

适当的连接参数能提升Notify性能：

// 在连接参数更新请求回调中设置 static void peripheralConnParamUpdateCB(uint16_t connHandle) { gapUpdateConnParams_t params = { .intervalMin = 16, // 20ms .intervalMax = 32, // 40ms .latency = 0, .timeout = 400 // 4s }; GAPCentralRole_UpdateLink(connHandle, &params); }

5.3 常见问题排查

当Notify不工作时，可以按以下步骤检查：

1. 确认CCCD已配置：

   uint16_t cccdValue = GATTServApp_ReadCharCfg(connHandle, simpleProfileChar5Config); PRINT("CCCD值: 0x%04X\n", cccdValue); // 应为0x0001

2. 检查属性表位置：

   PRINT("特征5句柄: 0x%04X\n", simpleProfileAttrTbl[SIMPLEPROFILE_CHAR5_VALUE_POS].handle);

3. 验证协议栈返回码：

   bStatus_t status = GATT_Notification(...); PRINT("通知状态: 0x%02X\n", status); // 成功应为0x00

在实际项目中，Notify特征的实现只是蓝牙通信的基础。真正的挑战在于如何设计高效的数据协议、处理连接中断后的数据缓存，以及优化功耗表现。建议在掌握基础功能后，进一步研究蓝牙5.0的新特性如扩展广播、2M PHY等，这些都能显著提升数据传输效率。