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

基于创建STM32WBA BLE_Custom工程经验分享

[复制链接]
STMCU小助手 发布时间:2023-11-30 16:54
01介绍0 ]$ W# z1 A; u4 c: T
STM32WBA 是 ST 最新一代的 BLE 芯片。该芯片已经获得 STM32CubeMX 工具的支持,用户可使用 STM32CubeMX 的图形化界面、快速生成具备 IO 配置、时钟配置、外设配置、中间件使用配置、BLE 服务配置等内容的基础源码工程。
; w  C6 F; G/ U% R& |# E( d1 Q$ J0 _8 [6 D
本文档将指导用户如何使用 STM32CubeMX 软件一步步生成基于 STM32WBA52MCU 的一个源码工程;该工程实现了 BLE 外设功能、并具有定制化的 BLE 服务。使用STM32WBA 系列其他芯片也可以参考此文档的步骤构建对应的基础源码工程。
! Q+ Q, p( E  y  a% L
2 [9 N2 W  v2 I9 N9 e+ [( N+ T7 s9 }6 t

4 f; i; h9 q1 k  K+ e02使用CubeMX在STM32WBA上构建 Bluetooth® Low Energy 应用" [" f  ?7 Y/ G$ }
将 STM32CubeMX 生成的源码工程进行简单修改后,便可运行在 STM32WBA Nucleo 板上、实现 BLE 外设功能。 . B$ q9 j7 Y6 @9 k# y# E# [2 P1 E
% l' S7 c8 v9 A- @! e2 S
BLE 外设充当 GATT 服务器角色,手机 APP(ST BLE ToolBox)充当 GATT 客户端角色,他们之间可以进行数据收发。( ]* B/ `6 Q, P9 h, I
4 Q8 _- {, v0 ^

# {' i0 u% y& m% i$ m7 j  t
微信图片_20231130163325.jpg
图1.通信示意图
2 s+ N" ?. S1 _! M
03服务和特征配置+ ~" C7 I  J' a# e5 D7 t1 j! a
该 GATT 服务器公开了一个定制化的服务(SerialPortService)并包含三个特征:" P' F6 O7 v! _' e3 x; x
⚫ 特征 1 具有 Notify 属性,可发送数据给手机
) v0 w' K, P3 [: v+ E ⚫ 特征 2 具有 Write without response 属性,可接收手机的数据 ( b' [8 \+ O6 y" ^2 C7 {% H3 O2 i' e
⚫ 特征 3 具有 Read 属性,可接受手机的读请求并发送响应数据包' F: V3 W- S# @$ H+ G. X' E5 u& U

6 V+ D; {( H; s8 w. O; j服务器的服务和特征配置列举如下 :2 `7 h3 n) o7 U
, b6 w  d8 E% b( }) G* L/ _
6 ]. m( Z$ ]' v3 Q) e" L
微信图片_20231130163322.jpg
表1. 服务和特征配置
* }& ?8 D8 M: V" z- J5 |# u
04工具" I9 p! r5 B# d2 f9 K* z
4.1. 软件工具% Q/ K& S7 n3 E. A+ C
要制作和使用这个项目,完成应用程序所需的软件工具是:# L6 p3 m/ ^. W+ |& \8 M! J( @% F
• STM32CubeMX 软件 (v6.8.0 以上) 9 m7 l) d2 n+ n
• STM32CubeWBA MCU Package (v1.0.0 以上)
+ z" _- K( Q4 M% d& P0 D5 z2 C• IDE: STM32CubeIDE or IAR * [) b, q7 }* j
• 串口终端 (TeraTerm)
% e/ b0 k+ Q! r) G• 手机应用程序 STBLEToolbox
* @/ [5 r  b: e8 P8 K% B; z7 ^) P1 A2 j$ I9 a
4.2. 硬件工具
: s/ H* G1 u* J6 q. `' f% a还需要一个 STM32WBA Nucleo 板和一个 micro-B 到 Type-A USB 电缆。' Z- c( u. R- m
/ _5 {3 w/ R4 Y. K+ p

7 H  X9 _& ~- t/ M. E+ F8 r
微信图片_20231130163319.jpg
图2.硬件工具
4 v8 _3 i, z3 `- {( K8 X& @7 f

& N5 D! Q7 M- O1 p1 |
" S6 ?: A( ?4 N$ h# j% N
05NUCLEO-WBA52CG 的 CubeMX 初始化
& T) @; W& R1 O+ z) ?5.1. CubeMX 初始化
2 k* k' D% s) b! ~9 f( U; V7 S% N打开 CubeMX 软件及 MCU 选择器,打开的过程可能会进行数据库更新,耐心等待更新完成即可。另外,确保 CubeMX 是 6.8.0 以上版本,否则将找不到 STM32WBA 系列芯片。; |# ^9 s$ L" Z7 {+ @) O

! _- b) B0 m% T' d2 I
( _! m7 L; h# m& c7 ~. N3 d6 A
微信图片_20231130163315.jpg
图3.芯片开始一个工程配置

) b# s0 H& W5 S2 o进入 MCU 选择器页面后,按照下图的步骤选中我们需要的开发板。' k( e. b+ m! u$ l
, M5 R, o2 |' [& F. ?8 B  x' O

5 N2 H) z5 L  h  y4 A" i8 e
微信图片_20231130163312.jpg
图4.选择对应的芯片型号
+ L) D  x. U  q% c

8 b. R' M3 ~0 L9 ]/ ^- W! L0 F) B! U. @  _4 F% N) o
1.选择系列分类
$ s# i1 B( ^3 v  y2.选择 STM32WBA 系列/ a. B4 K% U) S$ z" z' R( Y, S
3.选择对应的 STM32WBA 芯片型号% h3 A; H( m6 e! h- d1 J
4.选择 Start Project$ H: M5 y# |9 N/ ~6 X

! I! V9 m- k, [8 [8 U
# v8 j( @$ z. G$ x7 _  L. j
微信图片_20231130163309.jpg
图5. 根据应用需求选择是否使能 TrustZone

0 g* I/ n, s+ }+ ~3 v- N

& ]: E& }9 |8 s8 [
微信图片_20231130163306.jpg
图6. 切换到“Project Manager”页,命名工程和选择工程保存路径和设置堆栈
3 R9 `* x0 p9 m; j) p, i
用户可以根据自己的应用需求对工程名称路径,IDE 类型以及堆和栈等进行设置,上图给了一个参考示例。配置完成后,选中 File > Save Project 以保存工程配置(保存为.ioc 文件)。" L* g1 F" c2 S! y- A& i
4 B: K# o8 L; P+ W
5.2. 基本外设的配置; ^4 z* |( @% G( h' B& W4 \
5.2.1. 切换到配置 SW 调试口
( W7 E7 f/ b4 E+ p
$ v$ G6 b# d' b8 h8 P% c. U

; N8 O9 Z& w1 Z% a
微信图片_20231130163302.jpg
图7. 配置 SW 调试口

7 r4 B& @+ [3 k* R2 O- f

  G( S# v0 S/ V& J# W% k& s2 W$ D! m8 A% g' `: U$ r# {# t
5.2.2. 配置基本 RCC
1 x, q9 Q9 \% x( ]5 _) V
+ M. z  v  O/ C4 B! C! _

2 s- w* @' d$ e$ ?" ^, a
微信图片_20231130163258.jpg
图8. 配置 RCC
2 L* Q- i$ K: f. a
5.3. STM32_WPAN BLE 依赖的外设的配置
/ g2 W# A& y& I# K5 LSTM32WBA 的 STM32_WPAN(BLE)的依赖项比较多。在配置的时候,我们无需死记需要配置的项目,可以将鼠标移到 STM32_WPAN 模块中,停留 2 秒钟,则会出现提示信息,用户可根据这些提示信息来依次配置 STM32_WPAN BLE 需要的模块。
, g0 _, q: p! ~: p( g- p" j
& G7 x5 |% w& {% G. W/ b7 oSTM32_WPAN BLE 模块依赖的模块包括:ADC、CRC、RAMCFG、ICACHE、RNG、RF、和 RTC。当用户完成一个模块的配置后,鼠标光标回到 WPAN 模块时,提示信息会继续指导用户仍然需要配置的模块,直到全部模块配置完毕。8 Q' c6 c0 ^! c/ I- Y5 J

9 q8 z, Z2 r. _# i

$ E$ U7 W  [( _( {; R6 N
微信图片_20231130163256.jpg
图9. 根据提示信息来依次配置 STM32_WPAN

* J1 D. b1 i$ C0 T5.3.1. 配置 ADC& z7 q' ?+ p- A; h

: a2 L: A- O8 y$ Y

( ?. J2 Q$ ]4 f, a
微信图片_20231130163252.jpg
图10. 配置 ADC
$ U: H# P2 X" L+ b
5.3.2. 配置 CRC
: Y8 n  f0 C1 A4 J
* O+ T4 M8 T9 ?" F
/ q2 w8 J8 {& M
微信图片_20231130163249.jpg
图11. 根据提示配置下一个模块(CRC)

& y$ w3 T, _" Z+ F- s, U

, y( ~, C$ x* s9 _
微信图片_20231130163246.jpg
图12. 配置 CRC
/ m  @& O9 U+ B0 ]
5.3.3. 配置 RAMCFG( E3 K  ^" j9 r+ M/ i3 J/ h) f
: n/ a, \0 C  h

3 K6 ?; M4 x) W5 J3 d. Y
微信图片_20231130163243.jpg
图13. 配置 RAM
- W7 {6 l/ D% s$ c. T
5.3.4. 配置 ICACHE& q- C3 ]( F8 P+ \

4 [- X; n6 p: K: K$ w6 D, C

- P7 n) C5 F- @' [2 y6 z
微信图片_20231130163204.jpg
图14. 配置 ICACHE

8 Z  x. A4 I7 ]' h2 U- B. U6 X5.3.5. 配置 RNG
" N% j9 E- c, b. N7 J
- n) T+ Z1 o3 [. [; v* M7 r5 A9 \
" y* c5 D' H5 _9 L
微信图片_20231130163147.jpg
图15. 配置 RNG

: |0 k% x  D6 _  U, ?5.3.6. 配置 RF% K# y  K( s+ L3 b; z1 ~4 r3 Z
! v5 S, i, y" }6 n& j5 B% U

# [7 G; E) u# d7 N* a5 N6 |1 K; h: m
微信图片_20231130163143.jpg
图16. 配置 RF
+ v# d# V" u( t: q9 z7 A9 }. D
5.3.7. 配置 RTC* ]4 q1 ?0 J% Q

' y3 \! I  U0 N1 L0 i' Y  m8 w  x$ h
+ n) H+ ?" }  K, p" |) r5 J
微信图片_20231130163139.jpg
图17. 配置 RTC 部分 1
1 N0 \# a0 z/ B# G" @1 a) M
& n; i, n. k. n4 a! c8 m& j, |
微信图片_20231130163135.jpg
图18. 配置 RTC 部分 2
" v% l3 z, b/ A3 W, t# }& P
+ d, o$ {+ s  ~3 L
9 p2 }' u8 p( J7 G# ^
5.3.8. 配置 STM32_WPAN/ [8 [6 s/ W& z, b
当 WPAN 依赖的模块全部配置完毕,我们便可以开始 WPAN 的配置:
& }8 n1 a1 z& z% h6 b9 w/ N  Q4 F# `* y# t2 _9 p# R2 F
1 b; V0 c; s. K$ @% T# S
微信图片_20231130163129.jpg
图19. 配置 STM32_WPAN
2 q9 J8 o3 M1 |+ D# `: ]2 B

/ l: ^  ]! S/ c. f/ O5.4. BLE GAP 和 GATT 配置
" A8 @3 N. F( n" ?# {1 ?2 D: J- Q. ?5.4.1. 配置 GAP9 {# _5 T+ A+ h" c! v

6 m2 r* C5 _, M+ B* b

+ ^% E; f1 [+ A1 \
微信图片_20231130163053.jpg
图20. 配置广播数据

% V) l# N+ T5 q  j* i5.4.2. 配置 GATT 服务
* z: f- K, D1 B& Z- }8 r2 H
, V& s/ i; ?3 H6 \

5 {( |" X0 p: h  K2 @. f
微信图片_20231130163049.jpg
图21. 配置 GATT(添加服务)
8 f; S$ q/ d7 s% y1 S+ }
微信图片_20231130163044.jpg
图22. 配置 GATT(对服务进行定制化配置)

. y0 r; X. M8 a: ]5.4.3. 配置自定义服务的特征 1(上报数据特征)& V8 @6 I2 I/ m; }2 L% D) S2 F
" p; B! [- `0 T& z
7 N' y5 y+ H% V7 r; j% N. j
微信图片_20231130163041.jpg
图23. 配置上报数据特征
2 ^; M& H% p  X1 {3 t
5.4.4. 配置自定义服务的特征 2(写数据特征)' N  c5 f+ c; \% Z0 k, M% z+ l

) b& U, N1 c' z) \

/ Q+ p- n* z5 }  A% L5 C9 E
微信图片_20231130163038.jpg
图24. 配置写数据特征
5 y! H) ^& H1 t" t7 k7 ]6 b
5.4.5. 配置自定义服务的特征 3(读数据特征)
- Z. I' `$ H: V$ \  l
, G1 z! I' m" z. D

+ {  B+ [) X' ?9 W
微信图片_20231130163035.jpg
图25. 配置读数据特征
- c' K$ W* d. ?0 |. f
5.5. 其他配置与代码生成
* @: x# O, h5 F$ A6 I6 O) P5 w5.5.1. 进入“Clock Configuration”页面,按下图进行时钟配置
) ?6 L1 ]+ ~* ]3 a1 j; W5 g. c5 w7 c7 i

0 X$ w! U) N1 B
微信图片_20231130163029.jpg
图26. 配置时钟

  s5 ~6 i9 l" \% Z- y  M1 K$ P5.5.2. 配置初始化函数1 ?4 y1 p4 R- L" }$ _6 f" Z

3 u5 s, D. [: X: g" Q4 y5 G; A* y

* l  o; y) t- J  D$ L" c# ^
微信图片_20231130163025.jpg
图27. 配置初始化函数
/ `" E0 @1 _7 v4 E! Z
5.5.3. 根据配置生成工程代码,点击“GENERATE CODE”按钮,并等待源码工程的生成。点“Open Folder”后,可看到如下代码工程目录:) U# }! U4 l5 z& j! M

  V/ Z" i0 ~% ?" o$ c
' ~0 _  p! r  _. b& c/ i
微信图片_20231130163009.jpg
图28. 根据配置生成工程代码

/ ^7 R6 W7 G  q. i4 m0 e1 |

# J6 S! F2 ^+ \
& l% Z2 ^4 ]0 m2 y

3 F) G  F6 J- r3 G# H

8 d( ~8 ?. J- U06验证蓝牙基本连接5 w: c7 i" Q8 F4 `5 X, s, G
本文演示的是 IAR 工程的生成,用户也可生成 CUBEIDE 工程。 / f/ k: w2 o/ J1 B4 _
" a( ]: z3 y1 r. ~" |% a
打开 IAR 工程、用户还需要手工增加代码以开启广播,具体为:在 STM32_WPAN > App > app_ble.c > void APP_BLE_Init(void) 函数的尾部增加下图所示的函数:: a5 D! c5 z! p( I, p, D5 ?
' S% G; T7 f  R& K4 p
' y$ @7 i" V. q& U, ]* x) T5 M2 k
微信图片_20231130163004.jpg
) `. v7 `( B& q  Q2 r
然后编译、下载并复位,使代码运行起来。
7 k4 G* H8 z8 v- M  c/ a# a6 Y7 h/ z( u+ ~5 {% V4 C. h* }2 w
使用 ST BLE ToolBox 扫描,并连接该外设,可验证我们上面的服务配置是否正确:2 I; ^" d# F# j1 v; v  J
! n2 s& @$ Q* u  B* h$ N' b. x# ?4 i
微信图片_20231130162959.jpg
图29. 验证基本连接

- |$ H) G1 S5 v4 W' ~
9 F% c1 U' K1 Y

* ]* u$ J8 R1 r9 X% y( n. D
. a+ n4 h, |1 \, e8 f6 g( m8 M
' B# t# G' q1 A

4 j9 h& ]8 d+ Y( Q0 @  Z1 c07使能串口日志追踪
# E  G5 ^( f; \7.1. 当用户需要使能串口 LOG 输出功能时,可重新回到 CubeMX 的界面,进行串口的配置:  `9 T3 K* P# p
+ h$ Q. j" B, a7 f( D
. p& b  `7 n. u3 T
微信图片_20231130162948.jpg
图30. 配置串口

% e( y, P  q, ?  R" [
微信图片_20231130162945.jpg
图31. 配置串口 DMA

8 Z( {0 N  O: m2 B% `7.2. 为串口配置 GPDMA& A$ R7 T. L* s4 v- n0 \

4 R. I- ?0 y1 M" L6 N1 R/ z
! |. K2 \2 h# H8 `
微信图片_20231130162942.jpg
图32. 给串口配置 GPDMA TX

* A1 ~. s6 R" R1 i
微信图片_20231130162938.jpg
图33. 给串口配置 GPDMA RX

6 {( t+ r# C% U# [
微信图片_20231130162934.jpg
图34. 配置串口追踪 1

8 l' z  N; Q; `& \  j6 t8 J
微信图片_20231130162931.jpg
图35. 配置串口追踪 2
, [1 T% Z" J3 V. n
微信图片_20231130162928.jpg
图36. 使能串口中断
& L4 b: j) L) X6 I8 Q9 U
微信图片_20231130162925.jpg
图37. 配置串口注册 callback
$ c- X; `# k. U0 j8 e' X
完成以上配置后,可再次点击“GENERATE CODE”生成新的代码。新的代码会覆盖掉工程中旧的代码,但不会覆盖工程中的用户代码部分。4 {6 E( v, F  ~( R* c7 A4 F
) g; C" C# S# @
7.3. 添加代码、开启串口日志追踪. j1 n( R7 w+ y0 ?
新的代码生成后,还要再手工添加一些代码:
) v; W, H5 L3 l在 app_conf.h 中添加宏定义“CFG_DBG_SUPPORTED”以及在 main.c 中添加函数RNG_KERNEL_CLK_OFF()9 H& k# M! n4 D& Z4 w
' E$ Z: I1 L6 o* L; @4 n
" r+ s! ?# y3 f
微信图片_20231130162922.jpg
% i; [4 m$ d! q7 E
6 @5 p# I- m6 T- I3 H7.4. 验证串口日志追踪功能2 y5 ?% ^( m, T! @! {: |) k0 B& s# O
验证串口日志的方法比较简单,直接打开串口助手,选择好对应的串口,然后设置波特率为 115200,无奇偶校验,数据为 8bit,1 位停止位。6 H+ {+ S3 N" F4 M. }
8 |; r/ N2 }2 p4 j
& @- D7 d$ c7 D5 h& a; J
微信图片_20231130162919.jpg
图38. 配置串口终端
& V* m0 L2 v- C$ G9 F# d1 u
7.4.1. 验证读特征
. g0 C7 H0 v- x  G验证读特征可以在代码中添加如下代码(每次读取数据,将数值加一后发送出去)0 B: [, N% @6 T) }8 X; p

# m' C( W. V, j( y

' P7 x; K$ {$ s7 P9 b/ j
微信图片_20231130162915.jpg

+ q- w# H, o2 N3 |  T# y
微信图片_20231130162912.jpg

4 h5 N4 T- N( q! Q9 U) B7.4.2. 验证写和 Notify(上报数据)特征: N4 P2 r8 i" H: @0 ]5 m
验证写特征和上报数据特征可以一起进行。当收到写特征的数据时,直接将数据更新到上报数据特征中提交给 Client 端,如下图所示,其中主要修改了两个 case:
8 a8 x% X; P' I% g7 M6 E, F# S& ^) `( J9 f) j5 w, z

+ @( n+ x! \4 m) {& p/ B8 P一个是允许写,一个是将收到的数据写回去。
+ n3 l/ h9 z0 w
3 A5 ], e* w) D. v( @& [

# F$ j* {- A+ `& z
微信图片_20231130162908.jpg

7 V' }; b2 I5 U8 G
& T* Z* o/ `2 L' B$ e
7.4.3. 验证日志追踪9 O( k5 O1 n0 P" R

8 }  C0 ?; \8 Z! y* V  T7 ^' c0 R

* }8 s( H4 `! @. j8 e9 ]+ V
微信图片_20231130162903.jpg
图39. 验证蓝牙功能串口日志) g; x  @9 z7 G; e0 S9 h; T
3 ]- Y4 v& o; V. f5 N; i

# @+ L, d( R. }. M' Q7 W5 Y- A/ F/ x+ Z% r
0 e4 j, p2 j9 I# w4 X$ P  V
, u* R+ f2 f1 i2 n! Q

4 }3 ^5 b. ~/ x  q8 T' Y; e08小结8 f1 j/ Q4 M; x2 Z. k; P
本文介绍了如何从芯片开始一步一步配置一个 BLE 工程,实际用户在配置自己的项目时可以自行根据自己的项目需求而做相应的修改。
4 z+ n' H" T' m2 ]0 n* R! _# J& s  @( {
$ e$ C% N) K! ^- A- i, G5 i& K7 w
转载自: STM32单片机
: s1 R8 Z/ |) Z2 F, H4 ~3 ?. b; O2 A4 L8 I
如有侵权请联系删除
" e5 y: S9 j; ]. {3 N  W5 k
0 q) L. Y# ^* [3 [$ H1 x; g; g. [$ t+ r( f* B# p
赞 收藏 1 评论0 发布时间:2023-11-30 16:54

举报

0个回答

所属标签

相似技术帖

官网相关资源

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