给BLE从机‘加耳朵’：手把手在沁恒CH585上添加Write特征并接收手机数据

给BLE从机‘加耳朵’：手把手在沁恒CH585上实现手机数据接收

蓝牙设备之间的单向通信就像一个人只会说话却听不见回应——这在很多场景下显然不够用。想象一下，如果你的智能手环只能上传数据却无法接收运动目标设置，或者温控器只能报告温度而不能接受调节指令，这样的产品体验将大打折扣。这正是为什么为BLE从机添加写特征（Write Characteristic）如此重要，它让设备真正获得了"听觉"能力。

沁恒CH585作为一款高性价比的蓝牙5.0芯片，在IoT领域应用广泛。本文将带你完整实现从"单向广播"到"双向对话"的升级，重点解决三个核心问题：如何在现有GATT服务中安全添加写特征、如何正确处理写入的数据流，以及如何用常见调试工具验证功能。整个过程就像给设备安装一套精密的听觉系统，让它不仅能"说"，还能"听懂"指令。

1. 理解蓝牙GATT中的Write特性

在蓝牙低功耗(BLE)的GATT协议中，特征(Characteristic)是数据交互的基本单元。每个特征都有一组属性(Properties)定义它能做什么——比如读(Read)、写(Write)、通知(Notify)等。当我们说"添加写特征"时，实际上是在现有服务(Service)下扩展一个新的数据通道。

为什么需要Write特性？

• 配置下发：让APP可以设置设备参数（如报警阈值）
• 指令控制：发送操作命令（如重启、模式切换）
• 固件升级：用于OTA时的数据传输
• 双向同步：实现设备与APP的状态同步

CH585的协议栈已经封装了大部分底层细节，我们需要关注的是几个关键配置点：

// 典型的特征属性定义示例 #define SIMPLEPROFILE_CHAR5_PROPS (GATT_PROP_WRITE | GATT_PROP_READ) #define SIMPLEPROFILE_CHAR5_PERM (GATT_PERM_WRITE | GATT_PERM_READ)

这里PROPS决定特征支持哪些操作，PERM则设置访问权限。常见的权限组合包括：

提示：权限设置过松会导致安全风险，过严又影响用户体验。建议根据数据敏感度分级设置。

2. 在CH585上添加Write特征的全流程

2.1 修改MAC地址（可选步骤）

虽然与添加写特征无直接关系，但开发阶段自定义MAC地址能方便设备识别。CH585的地址配置在CH58x_BLEInit()函数中：

void CH58x_BLEInit(void) { // ...其他初始化代码... uint8_t customMac[6] = {0x11, 0x22, 0x33, 0x44, 0x55, 0x66}; for(int i=0; i<6; i++) { cfg.MacAddr[i] = customMac[i]; // 直接赋值自定义地址 } // ...协议栈初始化... }

注意地址字节序问题——BLE协议使用小端模式，即最低有效字节先传输。修改后可用以下工具验证：

• LightBlue：连接后查看设备信息页
• Wireshark：抓包分析广播数据
• 芯片日志：通过串口打印当前地址

2.2 在GATT服务中添加Write特征

假设我们已有UUID为0xFFE5的服务，现在要为其添加写功能：

1. 修改特征定义
   在profile头文件中扩展特征属性：

   // 原只读特征 #define SIMPLEPROFILE_CHAR5_UUID 0xFFE5 #define SIMPLEPROFILE_CHAR5_PROPS GATT_PROP_READ // 改为可写 #define SIMPLEPROFILE_CHAR5_PROPS (GATT_PROP_READ | GATT_PROP_WRITE)

2. 更新权限设置
   在服务初始化代码中找到属性表(Attribute Table)，修改对应特征的权限：

   { {ATT_BT_UUID_SIZE, simpleProfileChar5_UUID}, // UUID GATT_PERM_READ | GATT_PERM_WRITE, // 新增写权限 SIMPLEPROFILE_CHAR5_LEN, // 值长度 (uint8_t *)&simpleProfileChar5 // 值指针 }

3. 实现写回调函数
   这是数据接收的核心处理逻辑：

   static bStatus_t simpleProfile_WriteAttrCB(uint16_t connHandle, gattAttribute_t *pAttr, uint8_t *pValue, uint16_t len, uint16_t offset, uint8_t method) { if(pAttr->type.len == ATT_BT_UUID_SIZE) { uint16_t uuid = BUILD_UINT16(pAttr->type.uuid[0], pAttr->type.uuid[1]); if(uuid == SIMPLEPROFILE_CHAR5_UUID) { PRINT("Received %d bytes:\n", len); for(uint16_t i=0; i<len; i++){ PRINT("[%02X] ", pValue[i]); // 十六进制打印 } // 这里添加业务逻辑处理... return SUCCESS; } } return ATT_ERR_INVALID_HANDLE; }

注意：回调函数中不要执行耗时操作，建议只做数据暂存，通过消息队列等方式交给其他任务处理。

3. 调试与验证技巧

3.1 使用通用蓝牙工具测试

无需开发专用APP，这些工具就能验证写功能：

LightBlue操作步骤：

1. 扫描并连接CH585设备
2. 进入0xFFE5服务详情页
3. 点击"Write new value"按钮
4. 输入测试数据（如"Hello"）并发送
5. 观察设备串口打印

nRF Connect进阶用法：

• 保存常用指令为预设
• 使用"Hex"模式直接发送二进制数据
• 设置自动重发间隔测试稳定性

3.2 常见问题排查指南

调试小技巧：

• 在simpleProfile_WriteAttrCB开始处添加日志，确认回调是否被调用
• 使用ATT_MTU优化数据传输效率（默认23字节）
• 对于长数据，实现分段写入处理逻辑

4. 从功能实现到产品级代码

基础功能验证通过后，还需要考虑以下增强点：

4.1 数据协议设计

建议采用TLV(Type-Length-Value)格式：

#pragma pack(1) typedef struct { uint8_t cmdType; // 指令类型 uint16_t dataLen; // 数据长度 uint8_t payload[]; // 可变长度数据 } BLE_Command_t;

这种结构便于扩展且能有效防止缓冲区溢出。在回调函数中的处理示例：

if(len >= sizeof(BLE_Command_t)) { BLE_Command_t *cmd = (BLE_Command_t *)pValue; if(cmd->dataLen == (len - 3)) { process_command(cmd->cmdType, cmd->payload, cmd->dataLen); } }

4.2 安全增强措施

1. 连接加密：
   在BLE_LibInit中配置加密参数：

   cfg.smConfig = SM_FLAG_LE_ENCRYPT | SM_FLAG_IO_CAP_DISPLAY_ONLY;

2. 数据校验：
   添加CRC校验或签名机制：

   bool verify_signature(uint8_t *data, uint16_t len) { // 实现签名验证逻辑 }

3. 速率限制：
   防止恶意频繁写入：

   static uint32_t lastWriteTime = 0; if(GetSysTick() - lastWriteTime < 100) { // 100ms间隔 return ATT_ERR_UNLIKELY; } lastWriteTime = GetSysTick();

4.3 功耗优化策略

蓝牙通信是功耗大户，可以：

• 在无数据传输时降低连接间隔
• 使用GATT_PERM_WRITE_NO_RSP属性避免确认包
• 批量接收数据而非频繁小数据包
• 在回调中快速处理并返回休眠

// 在连接参数更新请求中设置较长间隔 gapLinkUpdateEvent_t param = { .intervalMin = 80, // 100ms .intervalMax = 800 // 1s }; GAPRole_UpdateLinkParamReq(connHandle, &param);

在CH585上成功添加写特征后，你的设备就从"单向喇叭"变成了能听会说的智能终端。这为各种交互场景打开了大门——从简单的参数配置到复杂的指令控制，甚至实现完整的双向协议通信。