STMCU小助手
发布时间:2023-10-15 19:34
|
01引言 : d' o+ Q9 y0 i" [) A" N; M- G STM32WB55是一款支持BLE5.x的双核高性能MCU,针对BLE的应用固件包STM32Cube_FW_WB_V1.xx.xx\Projects\P-NUCLEO-WB55.Nucleo\Applications\BLE里面也提供了大量的例程,目前支持的标准GAP服务例程在STM32CubeMX中已有列出,或可以在固件包STM32Cube_FW_WB_V1.xx.xx \Middleware\ST\STM32_WPAN\ble\svc中找到。然而,在实际的STM32WB意向客户中,使用BLE私有协议来开发Profile非标产品的客户占了绝大部分。读者可以去查看BLE_p2pServer、BLE_Custom等例程,对于需要添加自定义ATT属性和服务的应用,现有例程里面STM32CubeMX是无法自定义添加ATT属性和服务。但笔者发现,其实使用STM32CubeMX的Custom Template是能实现上述功能的。 7 c! q4 O8 g& L- n, P+ J" J 本文的目的旨在使用STM32CubeMX以及Custom Template例程基于STM32WB55-Nucleo实现基于BLE私有协议的通用通信框架,使客户快速上手进行产品开发,且可以直接应用在产品上,应用框架的设计如下图所示。另外,本文还对BLE协议栈的下载和升级注意事项做了详细指导,如果读者不熟悉这些内容,可以先行阅读。
0 H5 ~- K M/ x; o' E 如上图所示,使用手机APP与STM32WB进行BLE私有协议通信,一共设计了4种类型的数据访问:读/写、只写、只读、通知,这4种访问类型基本可以覆盖大部分数据访问场景 ! V/ W" E2 Y8 j 02STM32CubeMX实现步骤; O3 |& A: C& J; \ 4 R) ~: f3 r. _/ a 2.1 创建BLE工程添加并配置外设 请在搭建工程之前,下载安装最新的STM32CubeMX和STM32CubeWB4 ~/ b+ r! O3 V0 I$ z$ ~ Y; a6 x 2.1.1 在STM32CubeMX中点击“File”/“New Project”在弹出对话框中输入“STM32WB55RG”创建一个新工程# B$ q. e) b1 m% n 6 c5 s. l. a# ?
2.1.2 工程配置如下图所示,配置工程名字、保存路径、选择编译工具、调整堆栈大小和选择需要的STM32CubeWB的库文件(缺省为已安装的最新版本)。
2.1.3 系统配置:调试口 ' L4 ]1 K* r0 d* \5 x* G8 O
2.1.4 外设配置:添加外部高速晶振(HSE)和低速晶振(LSE), P8 Z4 F' [+ G; d( j7 k2 C / _0 C/ Z; c4 l
! {% e6 d6 t8 B# q5 o8 S Q1 k- {* m# X% x 2.1.5 外设配置:调试打印串口USART,手动将USART1引脚重映射到PB6/PB7
使能USART1的TX的DMA功能和USART1的全局中断: F; G/ z3 Y+ D A7 o
2 s5 t- [$ a& d+ r: i5 x9 ~% M 2.1.6 外设配置:使能HESM,它完全由BLE stack管理 6 s1 ?4 p' I! z$ C% B
2.1.7 外设配置:使能RF,它完全由BLE stack管理。
2.1.8 外设配置:使能IPCC,它完全由BLE stack管理。只需同时使能它的RX/TX中断即可。$ b0 Y: U/ @/ ^: k
$ I7 M8 w( U1 h/ v7 V n 2.1.9 外设配置:使能RTC,同时选择WakeUp为“Internal WakeUp”和WakeUp中断。$ q+ y7 O% F2 l2 [2 ?- p) ?9 G 9 \2 ~: k% H- F2 W8 t9 i
) J4 L% S1 d6 k0 k 2.1.10 外设配置:配置时钟; [4 Q. g4 W P$ j' E: x
4 \& E0 v6 _/ \9 S" H5 ] 2.1.11 外设配置:NVIC的配置# Z6 @1 ^0 R5 i5 p5 z% T
至此,外设的配置和添加部分已经完成。 $ i B9 Z8 w h# ?- y! v( f% C1 d1 N 2.2 BLE协议栈的添加及配置) p" h8 t; r; W" j; \ h 2.2.1 协议栈配置:使能BLE协议栈 8 W- a" W! q' N! C5 j1 p/ m
2.2.2 协议栈配置:禁止“Custom P2P Server”并使能“Custom Template”自定义GATT通用模板2 n! q, m5 a, D+ y: i9 u. `! } 5 `7 N. P9 @5 j- K. |; H _
2.2.3 协议栈配置:新建一个GATT服务,其名称为“My_Data_Server"7 H5 K5 R$ S& J3 N' g* i
- ?' m" E1 F- ?) T 2.2.4 协议栈配置:GATT服务基本配置
2.2.5 协议栈配置:配置GATT读&写 服务特征及属性值. p- W( Y: J8 W0 r & e% y) b& c* Q. C% w3 P
2.2.6 协议栈配置:配置GATT写 服务特征及属性值 . @1 r; M6 N0 Y" l$ R( q
2.2.7 协议栈配置:配置GATT读 服务特征及属性值9 E& H4 Y2 o9 ~$ N8 ~1 M
2.2.8 协议栈配置:配置GATT通知 服务特征及属性值3 R( P2 H7 f" j, u) X ( P- t) Y! t/ O6 B( O* [; c
/ Y8 c) [/ ^2 f* J) P- E3 e& g. D: Y/ _ 2.2.9 协议栈配置:配置GATT广播参数配置 / J* R: j+ u$ X! `: T! Y
2.2.10 协议栈配置:BLE配对参数设置 + r4 o8 U* ~8 L' O& |# C
2.2.11 协议栈配置:BLE协议栈调试及打印配置(需依次序配置)# z9 Q' `7 m7 M# i5 ` % Q4 s0 s8 x" m3 \6 c0 W
2.3 生成工程代码并初步测试 2.3.1 点击“GENERATE CODE”生成工程代码+ F" t5 \4 Z5 e4 D 8 N3 U/ W/ E6 Y& ^5 x
) S) U9 H9 _* B5 T t3 z8 z& t0 M 2.3.2 在生成的代码中添加BLE Trace&Debug初始化代码 2.3.3 在“main.c”文件中取消“MX_UART_Init(void)”的“static”属性5 U, [4 V+ C; _ # v4 U7 T5 l0 D3 l! T( k5 Y& O+ L 2.3.4 在“app_entry.c”文件中增加“Debug”模块的初始化代码“APPD_Init()”。 / X; S) i1 [3 Y; \' x
2.3.5 下载代码到STM32WB55-NUCLEO中运行。此时,在手机的蓝牙列表中,已经能成功地搜索添加的BLE设备。说明Debug和BLE协议栈已经成功运行。
, s7 i9 k9 V) I+ O, H 2.4 添加BLE Stack应用代码* d7 F% O! X c3 O& t! n* [" M- P 为了便于对后续添加代码的理解,我们先将Central(手机)与STM32WB进行BLE通信的数据交互概括如下。所以需要将用户代码添加到Custom_STM_Event_Handler()、Custom_STM_App_Notification()中。 , A% [2 `, i' w$ } G# r" h, d
BLE应用代码添加:定义用户数据缓存。 在“custom_app.c”文件中定义4个用户缓存区数组。 e- X" |3 g3 R) b4 F
BLE事件驱动代码添加: 在“custom_stm.c”文件中的“Custom_STM_Event_Handle r(void*Event)”中依次为WRITE_READ_DATA_BUF、WRITE_DATA_BUF、NOTIFY_DATA_BUF特征和属性添加stack层的事件驱动代码,以使BLE数据从stack层传递到app层。$ e5 r, ~" X+ k' K& C+ K! n; v 添加特征1 Events:WRITE_READ_DATA_BUF(即User_Write_Read_Data[]对应的写&读操作句柄)请求驱动代码。6 g# F6 @- q' X5 z: I + Z' ^* G6 |* M% _/ H
上图对应的代码文本如下所示:/ B1 ^# K4 ^6 s: T3 g
: L; z/ V- R9 V H3 B# J
上图对应的代码文本如下图所示:
添加特征2 Events驱动:WRITE_DATA_BUF(即User_Write_Data []对应的写操作句柄)代码。3 } ^5 G: z8 z
上图对应的代码文本如下图所示:/ l8 G6 f/ z3 ] 1 P7 ^! U' ?) d$ `
添加特征3 Events驱动:READ_DATA_BUF(即User_Read_Data[]对应的写操作句柄)代码 5 a$ f8 d0 W6 h" y& A
上图对应的代码文本如下图所示: P+ N3 [, Y) @! _# o
添加特征4 Events驱动:NOTIFY_DATA_BUF(即User_Notify_Data[]对应的写操作句柄)请求驱动已经由STM32CubeMX自动完成了。NOTIFY_DATA_BUF不用再手动添加。* L0 ]- k+ b" c+ n s% K# f* B% {
3 I6 M( Q" c9 V2 \- d0 M8 a. d BLE应用数据代码添加:% ?2 g# c0 n5 O8 f3 Q+ Y 在“custom_app.c”文件中的Custom_STM_App_Notification(Custom_STM_App_Notification_evt_t*pNotification)”添加代码,以将BLE数据上传到4个User_xxx_Data[]缓冲区,依次添加代码如下。! E; ]* @: _" `$ O3 H' k
8 g5 M3 v) P: Y( \ 2.5 修改BLE最大数据包传输长度 如果不修改,BLE单包长度最大仅为23字节+ _7 s/ n( f6 k 1. 在“app_conf.h”中修改BLE stack最大数据包长度(CFG_BLE_MAX_ATT_MTU)& E# {& w1 I7 _; f: |* P! B
2 ?) z8 O% P7 A5 M+ A! I 2. 在“app_ble.c”文件SVCCTL_UserEvtFlowStatus_t_SVC CTL_App_Notification(void*pckt)中添加红色部分代码。
' j; y! b0 c/ ^$ c& Z! \+ J. V+ G! S 至此,所有代码更改完成。 9 Q9 d/ c P! ^0 V; v0 A 03测试平台搭建及功能测试, g( j# ?- O" Y+ N, z. w : f# Z$ Q2 b# _! N 3.1 使用STM32CubeProgrammer BLE协议栈安装(升级)9 |1 v+ S7 `( X, l& g% S 升级ST-LINK固件以保证与STM32CubeProgrammer驱动是匹配的4 b1 m# ~7 W( Q; ?6 Q7 R
0 a' b+ v$ H6 B8 `0 f% ]/ e 查看当前FUS版本,并将FUS升级到最新版本4 S) \% { g* \ ) _+ o9 Z3 [! N( [0 R
如果当前FUS版本是0.5.3,FUS固件使用“stm32wb5x_FUS_fw_for_fus_0_5_3.bin”,否则FUS固件使用“stm32wb5x_FUS_fw.bin”,强烈建议阅读BLE协议栈及FUS升级详细说明“STM32Cube_FW_WB_V1.13.3\Projects\ STM32WB_Copro_Wireless_Binaries\STM32WB5x\Release_Notes.html”。& g$ _. h$ m+ H& i; {/ u
升级(安装)BLE协议栈,根据MCU型号选择相应的固件和下载地址5 I: H; j/ O" u
/ q, z9 n3 V+ o/ P5 I2 g 3.2 测试平台搭建及验证2 @- G8 Z5 y. }/ K 3.2.1 在Android安卓应用市场下载安装“BLE调试助手”
3.2.2 可发现设备“MY_STM32WB”,并点击“CONNECT”后可以发现application特征和属性访问服务,如下图所示。 7 z5 b; ~8 o: ^7 h
3.2.3 设置BLE最大单包传输长度为256字节,否则L2CAP层传输超过23字节将自动分包。 ! n/ k6 R/ X" V/ W6 ]( p
3.2.4 手机app写数据访问(User_Write_Read_Data[64])测试7 y E) S& T! M9 ^& G7 g3 U 7 q8 |0 T7 x0 X; B6 B# s' [/ c U. m
3.2.5 手机App读数据访问(User_Write_Read_Data[64])测试( a. {7 d7 c9 C1 L# G | . Z5 w! f6 E9 M k4 b5 Y$ L
) }* S0 l: p+ v2 G$ k 3.2.6 手机App写User_Write_Data[64]测试. b. J, n, D: e0 J2 R- O- |8 t + x( @$ Z- U) ^; V/ ~
3.2.7 手机App读User_Read_Data[64]测试。% I( n/ P6 S( a3 K1 c! O1 t* G " R ~3 g) z& k e
3.2.8 通知数据访问(User_Notify_Data[64])测试
( i& s' H4 h/ |" p( C 至此,整个验证和测试过程完成。1 P3 o' m3 k# K 9 e4 d4 S: b X* u' x" T+ W ; r3 W( R2 G E 04小结 BLE经过多年的发展和迭代,BLE协议本身已是一个很复杂和庞大的协议族,如果希望开发自定义Service和GATT应用时,若对底层协议不熟悉的话还是较为困难的。但是由于STM32良好的生态,特别是借助于我们的STM32CubeMX+STM32Cube_FW_ WB固件包,使得我们可以快速、高效地开发出各种BLE应用。 4 Z2 b5 i" i M' k+ E 6 r8 i/ k9 m# f1 ]7 W) K: ~$ P 转载自: STM32单片机; q+ a# a$ n% [ & m( [; P& O7 A0 [( { |
【STM32WB55MM-DK | Zephyr】1、创建zephyr_shell工程
低功耗蓝牙无线升级:STM32WB OTA 固件更新技术解析
STM32WB Zigbee 自定义集群开发实战:AN5491 应用笔记深度解读
吃透:STM32WB 上 Zigbee 睡眠终端设备开发攻略
STM32 无线 MCU HSE 频率与启动时间精确调谐实战指南
深度解读:STM32WB 2.4GHz 低成本 PCB 蛇形天线设计实战指南
经验分享 | STM32WB 双核无线 MCU 开发全流程实战指南
STM32WB 基于 Custom Template 实现 BLE 私有协议 实操开发指南
详解STM32单片机的堆栈
STM32单片机进行除零运算,为何程序不崩溃?
微信公众号
手机版
谢谢分享,是否有其他的custom template案例来参考