ST BlueNRG-MS BLE模块特征值通知长度与单服务特征数限制问题咨询
BlueNRG-MS 模块两类异常问题定位与解决方案
遇到的核心现象
- 32字节长度特征值的读操作可完整获取全部数据,但触发特征值通知(更新)时,仅传输20字节数据,暂未找到对应配置逻辑,公开资料可验证该现象普遍存在
- 单个GATT服务下仅能成功添加2个特征值,尝试添加第3个特征时,前2个可正常注册,调用
aci_gatt_add_char()接口返回ERR_UNSPECIFIED_ERROR,调试全程使用STM LightBlue App作为测试工具,已有其他开发者反馈过同类报错。
问题根因解析
1. 通知传输仅20字节的设计逻辑
该现象属于模块默认的规范兼容行为,并非运行异常
- BLE 4.0核心规范规定,连接建立前的默认ATT_MTU为23字节,扣除ATT帧的操作码(1字节)、特征值句柄(2字节)开销,单包通知可承载的有效数据上限恰好为20字节
- 读操作可读取完整32字节数据的原因是,ATT读流程支持分段传输(Read Blob Request/Response),可通过多包拆分返回长数据,而默认配置下的通知/指示不会自动触发分段传输逻辑,因此单包仅能传输20字节
- 若需要实现单包传输超过20字节的通知,需在连接建立后走MTU交换流程,协商更大的MTU值——BlueNRG-MS最高支持247字节的MTU,协商完成后通知的单包传输上限会随MTU值同步提升
2. 单服务添加第3个特征返回错误的原因
该问题不存在“单服务最多2个特征”的硬件设计限制,报错根因可从三个维度排查:
- 首先是服务注册时的属性空间配置问题:调用
aci_gatt_add_service()传入的max_attr_size参数设置过小。每个特征值除了特征声明本身外,还包含特征值属性、客户端特征配置描述符(若开启通知/指示),每新增1个特征至少需要占用数十字节的GATT属性表空间,空间不足时模块会直接抛出ERR_UNSPECIFIED_ERROR,无更细分的错误提示 - 其次是全局GATT属性表剩余空间不足:BlueNRG-MS内置RAM划分的GATT属性表总容量为固定值,若前期注册的其他服务、特征、描述符已经占用了大部分空间,新增特征时也会因为无可用空间触发报错
- 最后是
aci_gatt_add_char()的入参配置不合法:若特征长度超过模块单特征上限、权限配置不符合寄存器要求、额外要求了不被支持的描述符,也会触发该未指定错误。
快速排查步骤
- 针对通知20字节限制:在连接建立事件回调中主动发起MTU交换请求,打印协商完成后的实际MTU值,确认通知传输长度是否和协商值匹配
- 针对特征添加失败报错:
- 逐行对比前两个正常注册的特征和第3个特征的入参差异,重点核对权限、长度、描述符配置
- 临时调大
aci_gatt_add_service()接口的max_attr_size参数值,确认是否为单服务属性空间不足导致的报错 - 通过固件编译输出的属性表内存占用统计,确认全局剩余GATT空间是否满足新增特征的存储需求
注:调试时可使用STM LightBlue App的属性表扫描功能,核对已注册的服务和特征是否和代码配置一致,排除注册逻辑未真正执行的问题
内容的提问来源于stack exchange,提问作者po.pe
相关产品推荐
相关产品推荐

