You need to enable JavaScript to run this app. ST BlueNRG-MS BLE模块特征值通知长度与单服务特征数限制问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 10:06:11