STM32WB用Custom Template从零定制私有BLE GATT服务

做BLE产品开发这几年被问得最多的问题之一就是标准服务跑通了但我要做的是客户自己的私有协议怎么搞如果你用的是STM32WB答案就在ST的LAT1197应用笔记里——用Custom Template从零定制一套GATT服务把Battery Service、Device Information这些你用不上的标准Profile全部丢掉只保留自己定义的读写通道和通知通道。我按这个思路在STM32WB55上完整落地过一套设备配网协议中间踩了不少坑也把整个流程跑通了。这篇文章就是完整复盘适合正在评估STM32WB、或者已经被标准BLE Profile束缚到想换方案的嵌入式开发者参考。1. 整体设计思路为什么选Custom Template1.1 STM32WB的双核分工先搞清楚协议栈在哪跑STM32WB55内部其实有两个核Cortex-M4主核跑你的应用Cortex-M0从核跑无线协议栈。M0上跑的是ST的BLE协议栈固件对外的接口是HCI命令对应用层来说你调一条HCI命令和调一个本地函数没区别底层通过IPCC核间通信控制器和共享内存完成数据交换。这个架构对做私有协议非常友好所有射频时序、链路层状态机、GATT表的管理全在M0里M4上你的业务代码再复杂都不会把蓝牙状态机拖垮。反过来如果协议栈和应用跑在同一个核上一旦应用里有阻塞操作比如长时间刷Flash、等传感器响应BLE链路就很容易超时断开。所以STM32WB这种双核分工本质上就是给应用无脑跑、射频稳如狗提供了一块独立舞台这对需要承载自定义业务逻辑的私有协议来说是天然的加分项。有一点要提醒M0上的协议栈固件不是CubeMX帮你烧的。拿到NUCLEO-WB55或者自研板卡后第一次上手要先通过STM32CubeProgrammer把FUS固件升级服务和BLE协议栈bin文件烧进去。这一步网上教程很多但很多人第一次没做导致代码编译下载后手机永远扫不到设备还以为是工程配置错了。建议拿到板子先把这一步确认好后面的开发会顺畅很多。1.2 Custom Template相比标准模板到底差在哪STM32CubeMX里配置BLE时模板有好几种Full Template、Custom Template、以及带特定服务比如心率、电池的模板。Full Template会帮你把GATT服务、电池服务、设备信息服务全部注册好编译出来就能和手机连上Demo跑起来很有成就感但到了产品阶段这些服务一个都用不上反而碍事。Custom Template的思路正好相反它给你一个空的GATT表服务、特征值、描述符全部由你定义。看起来多写了几行代码换来的是三个实打实的好处一是代码体积和RAM占用更小嵌入式上的每一K Flash都宝贵二是启动更快服务注册数量少了M0初始化GATT表的耗时自然短三是GATT结构完全可控不会出现客户用手机App一扫描看到一堆莫名奇妙的Service影响体验也显得不专业。还有一点值得说如果是做真正的私有协议语义层面必须和标准Profile隔离。比如你要做一把智能锁用标准Battery Service提供电量再用一个自定义Service下发开锁指令这在协议栈层面没问题但产品逻辑会非常别扭开关锁的状态机、电量上报、配网流程散落在不同服务里调试和后期维护都是灾难。Custom Template能让你把整条业务线收敛到一个私有Service里所有状态都在你自己的特征值上表达这才叫协议而不是拼服务。2. 环境准备与Custom Template配置实操2.1 工具链选型我用的是这套组合开发STM32WB我目前的组合是STM32CubeIDE 1.15.0集成CubeMX、STM32CubeWB固件包V1.18.0、ST-LINK/V2或板载ST-LINK外加一个nRF Connect手机App用于日常调试。固件包版本建议用较新的因为ST会持续修复BLE协议栈的bug尤其是M0侧的问题新版本稳定很多。需要重点说明的是固件包里的BLE协议栈和App工程是分开的。CubeMX生成的工程只是M4侧的代码M0侧的BLE协议栈固件在固件包目录的Utilities/BLE_Stack下格式是.bin。你在CubeIDE里正常编译烧写M4工程并不会更新M0协议栈。如果协议栈版本和工程依赖的版本不一致运行时会出各种奇怪问题。我的习惯是新建工程前先把协议栈bin一次性烧进板子然后在整个开发周期内不轻易换协议栈版本。另外建议把抓包工具也提前备好。我强烈推荐nRF Connect软件配合nRF52840 DK做BLE嗅探或者用ST自家的STM32CubeMonitor-RF。不是说手机App调试够了就不需要抓包很多问题比如广播包格式、连接参数协商、ATT层交互只有抓包才能看清楚。工具备齐了后面排坑能省一半时间。2.2 CubeMX里从零定义一个私有GATT服务在CubeMX中选中STM32WB55RG左侧Categories里找到Connectivity → RF勾选BLE然后进BLE Parameters页面。这里关键的一步是Template选择下拉菜单里选Custom Template。选完后页面下方会出现一个Custom Services面板点Add可以添加自己的Service。定义Service主要填四类信息服务名称后面生成代码的变量名基于它、服务UUID类型16位或128位、UUID值、以及服务下的特征值列表。我给那套配网协议定义的结构是Service用128位UUID3个特征值分别是CommandWrite属性下发指令、ResponseNotify属性上报结果、StatusRead属性查询当前状态。这样手机端逻辑非常直观发指令走Command收结果走Response想知道当前状态直接读Status。特征值定义里重点看三个参数Properties读/写/通知/指示、Value Length单包数据最大长度、以及是否需要附加Descriptor。对Notify特征值ST会自动生成CCCD描述符但你要确认生成代码里有没有正确处理CCCD