你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

STM32WB基于Custom Template实现客户定制BLE私有协议

[复制链接]
STMCU小助手 发布时间:2023-10-15 19:34
01引言
+ C7 G+ X9 g$ s, R& U
: 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是能实现上述功能的。
8 A: O! O3 W  L& R% c
7 c! q4 O8 g& L- n, P+ J" J
本文的目的旨在使用STM32CubeMX以及Custom Template例程基于STM32WB55-Nucleo实现基于BLE私有协议的通用通信框架,使客户快速上手进行产品开发,且可以直接应用在产品上,应用框架的设计如下图所示。另外,本文还对BLE协议栈的下载和升级注意事项做了详细指导,如果读者不熟悉这些内容,可以先行阅读。
6 @1 H+ @! H2 a% x

2 F1 M4 t& ^2 c* J" N
微信图片_20231015193351.png ( C+ J: ^+ B& N
0 H5 ~- K  M/ x; o' E
如上图所示,使用手机APP与STM32WB进行BLE私有协议通信,一共设计了4种类型的数据访问:读/写、只写、只读、通知,这4种访问类型基本可以覆盖大部分数据访问场景
) k: e3 l3 s2 m! j2 _
! V/ W" E2 Y8 j

. y9 j4 Y0 y" y% `: l; x! o
02STM32CubeMX实现步骤; O3 |& A: C& J; \
4 R) ~: f3 r. _/ a
2.1 创建BLE工程添加并配置外设
& W2 Z# C# Q/ x5 N8 Q! ^3 d- m
请在搭建工程之前,下载安装最新的STM32CubeMX和STM32CubeWB4 ~/ b+ r! O3 V0 I$ z$ ~  Y; a6 x

5 W: o* I% A# `! E1 K, Z, @
2.1.1 在STM32CubeMX中点击“File”/“New Project”在弹出对话框中输入“STM32WB55RG”创建一个新工程# B$ q. e) b1 m% n
6 c5 s. l. a# ?
微信图片_20231015193348.png : y- k2 i* l6 S7 N# e) X5 k

$ ?7 r$ n& f8 D- t$ T. Z6 h
2.1.2 工程配置如下图所示,配置工程名字、保存路径、选择编译工具、调整堆栈大小和选择需要的STM32CubeWB的库文件(缺省为已安装的最新版本)。
$ `/ ^4 Q* X6 P: x6 \$ A

1 h3 \  h3 n, y7 v7 r9 \6 N
微信图片_20231015193343.png
% N& [$ [& w2 ?( r* y; r

5 G! m  W0 y5 w' x& b
2.1.3 系统配置:调试口

: v# X  U3 h2 Q# t8 B8 a; a8 Z! Z. q' L4 ]1 K* r0 d* \5 x* G8 O
微信图片_20231015193339.png
$ J& K" O: |% K: H0 c2 Z

, t- g* {) ]' j- h" m4 e
2.1.4 外设配置:添加外部高速晶振(HSE)和低速晶振(LSE), P8 Z4 F' [+ G; d( j7 k2 C
/ _0 C/ Z; c4 l
微信图片_20231015193336.png
( L+ o$ q' B4 u! s% W  Z: }  c% E! {% e6 d6 t8 B# q5 o8 S
  Q1 k- {* m# X% x
2.1.5 外设配置:调试打印串口USART,手动将USART1引脚重映射到PB6/PB7
7 G7 L5 {* V/ @& w0 R( t8 E

) Q( R5 F' U' B/ F3 }/ ?
微信图片_20231015193332.png : n# B  D. F( d4 T
使能USART1的TX的DMA功能和USART1的全局中断: F; G/ z3 Y+ D  A7 o

  v3 T/ v$ x3 O" \4 h1 }
微信图片_20231015193329.png
, n6 `( u( c5 B% G/ Q
2 s5 t- [$ a& d+ r: i5 x9 ~% M
2.1.6 外设配置:使能HESM,它完全由BLE stack管理
; e; C$ W, _) V
6 s1 ?4 p' I! z$ C% B
微信图片_20231015193326.png
% h) Z; z8 o2 X4 l$ ~. i

; U4 y* c, v& a  C1 L- x" _$ y/ [

5 J* K6 z. z, A: w# k
2.1.7 外设配置:使能RF,它完全由BLE stack管理。
- I: ?; _2 a0 e: ]

& ^0 q/ O( E6 i1 V. f+ z2 C
微信图片_20231015193320.png
2 S5 s$ B; i" U

* W( F1 Z& Z$ y' `) q
2.1.8 外设配置:使能IPCC,它完全由BLE stack管理。只需同时使能它的RX/TX中断即可。$ b0 Y: U/ @/ ^: k

* U& f) j) T* a: R# E0 D  k' Z9 @$ h
微信图片_20231015193316.png
2 H' I' j) |; [) {$ a$ 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
微信图片_20231015193313.png 9 F# ~. w- o" r  B8 u) Q
) J4 L% S1 d6 k0 k
2.1.10 外设配置:配置时钟; [4 Q. g4 W  P$ j' E: x

/ ~" _9 E3 \! l# q  D
微信图片_20231015193308.png # q( J( [% d  m9 F9 Y  _5 j! ?0 H9 i
4 \& E0 v6 _/ \9 S" H5 ]
2.1.11 外设配置:NVIC的配置# Z6 @1 ^0 R5 i5 p5 z% T

% J5 r  k' d# D* N* Z
微信图片_20231015193305.png
8 O' K" F' s5 r! M) A' }& Q8 w

9 v; _; J1 G' C! p# G/ |
至此,外设的配置和添加部分已经完成。
( o. @8 [0 f  \
$ i  B9 Z8 w  h# ?- y! v( f% C1 d1 N

% d& ^; j9 g; m  P3 \0 v5 _
2.2 BLE协议栈的添加及配置) p" h8 t; r; W" j; \  h
2.2.1 协议栈配置:使能BLE协议栈
' }; [; B. ?" v6 _1 t/ r
8 W- a" W! q' N! C5 j1 p/ m
微信图片_20231015193301.png   m; S+ ?9 v* w% S% I' |. [7 ^& Z, y

" M! B: O0 f# r; X' D; O
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  _
微信图片_20231015193258.png
9 q- T; ]8 O" X8 o8 w% |
2.2.3 协议栈配置:新建一个GATT服务,其名称为“My_Data_Server"7 H5 K5 R$ S& J3 N' g* i

% n; @" |+ v, u6 Q8 l
微信图片_20231015193255.png
$ U. R1 c. g% j/ b7 u
- ?' m" E1 F- ?) T
2.2.4 协议栈配置:GATT服务基本配置
4 g" C. y8 I! h; }, ?1 c) j1 ]: A
7 t$ T1 w  \% s) V7 A- d1 L7 l
微信图片_20231015193251.png
) H& h$ Y" U- D/ o* t! X

  N2 ]4 @6 L0 |. T9 v8 m3 A4 Q; \$ z! A  {
2.2.5 协议栈配置:配置GATT读&写 服务特征及属性值. p- W( Y: J8 W0 r
& e% y) b& c* Q. C% w3 P
微信图片_20231015193247.png
' S8 L1 c! h, P& ?, u

# D% `- z* |' x2 r" _9 Z. R5 B- x
2.2.6 协议栈配置:配置GATT写 服务特征及属性值
9 d* d% |7 S% D1 A. @1 r; M6 N0 Y" l$ R( q
微信图片_20231015193244.png
3 h( ^5 P$ `: J% z6 c8 u  z
) r/ G+ W! x. s2.2.7 协议栈配置:配置GATT读 服务特征及属性值9 E& H4 Y2 o9 ~$ N8 ~1 M

& j1 m9 _1 ^& {  A
微信图片_20231015193240.png
3 V, m2 `2 W" Y. h$ {# l) W
' R* p. L+ c- k( ^6 N2.2.8 协议栈配置:配置GATT通知 服务特征及属性值3 R( P2 H7 f" j, u) X
( P- t) Y! t/ O6 B( O* [; c
微信图片_20231015193238.png . A, A8 [- u9 p+ y/ P# k' i
/ Y8 c) [/ ^2 f* J) P- E3 e& g. D: Y/ _
2.2.9 协议栈配置:配置GATT广播参数配置
- k  n+ s) a' a4 D* J
/ J* R: j+ u$ X! `: T! Y
微信图片_20231015193234.png
3 Q2 I0 \* \1 s3 Z

0 [! z. \  J/ `6 S8 i4 n; X1 f- Y
2.2.10 协议栈配置:BLE配对参数设置
# t' [* |6 `& F  d) E) N) ^
+ r4 o8 U* ~8 L' O& |# C
微信图片_20231015193232.png
; R* L7 J: m! @7 v$ K* V  ^0 Z( W* K

, E6 U% \6 U% a0 }
2.2.11 协议栈配置:BLE协议栈调试及打印配置(需依次序配置)# z9 Q' `7 m7 M# i5 `
% Q4 s0 s8 x" m3 \6 c0 W
微信图片_20231015193229.png
7 n/ o8 C8 h3 m* F# `

* a$ X/ \9 C9 p5 A+ V
2.3 生成工程代码并初步测试
* S, P) Q( [$ H' p  }, Z; w3 ^
2.3.1 点击“GENERATE CODE”生成工程代码+ F" t5 \4 Z5 e4 D
8 N3 U/ W/ E6 Y& ^5 x
微信图片_20231015193225.png 9 e1 B5 y0 e4 N
) S) U9 H9 _* B5 T  t3 z8 z& t0 M
2.3.2 在生成的代码中添加BLE Trace&Debug初始化代码
* N* q5 q9 [8 Q+ w; G2 \8 G, G& W0 k

2 ^( n' m: n2 O# _* L$ J& P
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()”。
& Q5 i! s1 m# a; i2 w5 w
/ X; S) i1 [3 Y; \' x
微信图片_20231015193223.png
/ M) I$ \# P7 |5 l$ I# ?; N5 ~: v

" v8 p$ J0 S1 p" M0 P
2.3.5 下载代码到STM32WB55-NUCLEO中运行。此时,在手机的蓝牙列表中,已经能成功地搜索添加的BLE设备。说明Debug和BLE协议栈已经成功运行。
, i7 p/ j- s1 I1 P

7 G6 t$ U- e0 c+ E& v$ {( w
微信图片_20231015193220.png % b% U2 l7 N* ]! K( c$ c( k. m
, 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()中。
2 \' l! L8 J1 n. J/ J
, A% [2 `, i' w$ }  G# r" h, d
微信图片_20231015193217.png
  B9 j" U+ x4 S2 }

3 }# f: D! Q' N, `( T! e% n& u7 C9 Q
BLE应用代码添加:定义用户数据缓存。
* Y( {+ k1 \, U. F
在“custom_app.c”文件中定义4个用户缓存区数组。
, |: b) A$ k$ m, v
  e- X" |3 g3 R) b4 F
微信图片_20231015193214.png # r" l. }: Q8 S! }: x

& [  R1 B$ _" t9 ~
BLE事件驱动代码添加:

; ?6 T8 Q. m; a  d
在“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

2 k0 q# a; z- W. B: }% B
添加特征1 Events:WRITE_READ_DATA_BUF(即User_Write_Read_Data[]对应的写&读操作句柄)请求驱动代码。6 g# F6 @- q' X5 z: I
+ Z' ^* G6 |* M% _/ H
微信图片_20231015193211.png " a0 e+ T* s' f* w! F* {- K% u- q5 O

7 j" l, E9 V! O# h# v$ E
上图对应的代码文本如下所示:/ B1 ^# K4 ^6 s: T3 g

5 l& o" o0 f# }5 X8 l. }
微信图片_20231015193208.png
' E$ h* z# a$ v: ~: L; z/ V- R9 V  H3 B# J
微信图片_20231015193205.png
9 y7 |) x6 N7 k3 L  K" P
0 v- q! C5 {5 z0 s7 d) S# |2 _
" V" t7 k4 n8 P/ b' O5 ~; v/ ^
上图对应的代码文本如下图所示:
. [) V3 e5 _2 z* {. c

. h% d. {- `$ F0 I. f- J; U
微信图片_20231015193202.png
5 ~& t, w: F3 \5 G

/ _7 i% k$ A* W' X% W
添加特征2 Events驱动:WRITE_DATA_BUF(即User_Write_Data []对应的写操作句柄)代码。3 }  ^5 G: z8 z

8 z1 W2 W6 |' D
微信图片_20231015193159.png
4 g) c0 |! F$ n6 i' k

& O" }4 r  ~+ P: u# I* e4 p4 z
上图对应的代码文本如下图所示:/ l8 G6 f/ z3 ]
1 P7 ^! U' ?) d$ `
微信图片_20231015193157.png # {$ P& v# n& x+ r

( ]! o$ [; Y, Q5 }" l  _
添加特征3 Events驱动:READ_DATA_BUF(即User_Read_Data[]对应的写操作句柄)代码
( l# B8 K) N, K* L
5 a$ f8 d0 W6 h" y& A
微信图片_20231015193154.png ! X/ \0 z; X9 l

) W; w" o: {& c+ D. a
上图对应的代码文本如下图所示:
% c5 A8 y7 K- z+ H  i+ S1 U4 `
  P+ N3 [, Y) @! _# o
微信图片_20231015193151.png ' i  B. k7 v/ x# n2 |4 u

- u) i' K% k, z7 S
添加特征4 Events驱动:NOTIFY_DATA_BUF(即User_Notify_Data[]对应的写操作句柄)请求驱动已经由STM32CubeMX自动完成了。NOTIFY_DATA_BUF不用再手动添加。* L0 ]- k+ b" c+ n  s% K# f* B% {

! L  R2 t& N9 T0 P
微信图片_20231015193147.png / ~$ ^: D3 r! Y% R6 N
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

# E5 m! d/ E2 n$ o$ K2 l4 D
微信图片_20231015193144.png 0 b+ ^+ W5 K( k( @* l
8 g5 M3 v) P: Y( \
2.5 修改BLE最大数据包传输长度

- X, J% `+ Q3 h
如果不修改,BLE单包长度最大仅为23字节+ _7 s/ n( f6 k
1. 在“app_conf.h”中修改BLE stack最大数据包长度(CFG_BLE_MAX_ATT_MTU)& E# {& w1 I7 _; f: |* P! B

3 w7 p6 O3 n2 A+ B7 t1 D
微信图片_20231015193141.png
( J9 ^0 \2 r8 O# X! ^9 x
2 ?) z8 O% P7 A5 M+ A! I
2. 在“app_ble.c”文件SVCCTL_UserEvtFlowStatus_t_SVC CTL_App_Notification(void*pckt)中添加红色部分代码。
. v0 }0 j( L) s2 \, Z6 A

! O8 g) n7 K8 `0 K$ R0 C, Q! ]1 D" L
微信图片_20231015193138.png 8 I9 k7 Y: m  Y5 G7 E
' j; y! b0 c/ ^$ c& Z! \+ J. V+ G! S
至此,所有代码更改完成。
% T( w. j( T+ C" O: S% D& N" M9 Q9 d/ c  P! ^0 V; v0 A

2 @1 e& K% o. C) 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

+ C! V1 l; C& s# w" z1 {
升级ST-LINK固件以保证与STM32CubeProgrammer驱动是匹配的4 b1 m# ~7 W( Q; ?6 Q7 R

- F5 L. J* y  s- F
微信图片_20231015193134.png
( _5 W( x! x5 p0 b- O, ~
0 a' b+ v$ H6 B8 `0 f% ]/ e
查看当前FUS版本,并将FUS升级到最新版本4 S) \% {  g* \
) _+ o9 Z3 [! N( [0 R
微信图片_20231015193131.png # b+ N7 A- ^. s" _& a! G2 u

5 X& C4 t5 a9 c1 h/ a  K
如果当前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

' i1 J6 n; t: @3 z) l7 C- t
微信图片_20231015193128.png # ?# J' f! ^5 `

  L  ~5 ~* u  ?' A* ?
升级(安装)BLE协议栈,根据MCU型号选择相应的固件和下载地址5 I: H; j/ O" u

3 H' F+ I# u7 W5 j" A& E& @
微信图片_20231015193124.png ; Z6 o6 Y! i0 J5 D
/ q, z9 n3 V+ o/ P5 I2 g
3.2 测试平台搭建及验证2 @- G8 Z5 y. }/ K

2 |) X% D2 i2 m" p
3.2.1 在Android安卓应用市场下载安装“BLE调试助手”
+ r. b4 |: K( e# I$ \' K! }& }* `

) x) c. ?; X1 Y" B; k. U+ z
微信图片_20231015193121.png % _$ I% X- v& q2 a# P7 |6 H' @7 U

  l: a% ^8 R# L0 m0 Q
3.2.2 可发现设备“MY_STM32WB”,并点击“CONNECT”后可以发现application特征和属性访问服务,如下图所示。
$ K% ^0 E$ T6 H3 E* y- N3 v+ R) l
7 z5 b; ~8 o: ^7 h
微信图片_20231015193118.png $ V5 k/ L0 P2 H0 a" y- x

# s, u, ]2 k. O8 `, E3.2.3 设置BLE最大单包传输长度为256字节,否则L2CAP层传输超过23字节将自动分包。
$ H& S+ e# l) W4 @! n/ k6 R/ X" V/ W6 ]( p
微信图片_20231015193115.png
( A+ c) o# D' P" B

' \; M" f9 b* i' V
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
微信图片_20231015193104.png
; _* e; W/ `% G- u

/ B; v9 b; u2 h" S- w0 p
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
微信图片_20231015193101.png
8 |" s; [/ k+ H- h" O3 ]3 e
) }* 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/ ~
微信图片_20231015193057.png 8 m% I" l$ u3 x* s; ^* v

; F5 v) A2 Z# G/ B7 P3 B
3.2.7 手机App读User_Read_Data[64]测试。% I( n/ P6 S( a3 K1 c! O1 t* G
" R  ~3 g) z& k  e
微信图片_20231015193054.png # @0 t3 X3 @2 f4 N: H+ X1 L3 i/ b! w

0 z3 m9 \, j7 d" R
3.2.8 通知数据访问(User_Notify_Data[64])测试
7 q/ h5 O3 Y% \$ [) s0 W9 {

$ [4 I. F3 P4 V8 A; `
微信图片_20231015193051.png
1 C" A8 A# i  R  J1 G+ C6 l6 f$ e& e
( 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小结
- O7 V1 d2 E+ |
BLE经过多年的发展和迭代,BLE协议本身已是一个很复杂和庞大的协议族,如果希望开发自定义Service和GATT应用时,若对底层协议不熟悉的话还是较为困难的。但是由于STM32良好的生态,特别是借助于我们的STM32CubeMX+STM32Cube_FW_ WB固件包,使得我们可以快速、高效地开发出各种BLE应用。
" Z5 h1 i* q3 K9 Z5 ~6 L4 Z2 b5 i" i  M' k+ E

8 T3 O2 p; x3 f- X1 E
6 r8 i/ k9 m# f1 ]7 W) K: ~$ P
转载自: STM32单片机; q+ a# a$ n% [
& m( [; P& O7 A0 [( {
赞 1 收藏 评论1 发布时间:2023-10-15 19:34

举报

1个回答
ZJU_Tom 回答时间:2024-11-11 19:16:05

谢谢分享,是否有其他的custom template案例来参考

所属标签

相似技术帖

官网相关资源

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版