引言

本篇 LAT 介绍使用 CubeMX 创建基于 STM32WL 的 LoRa 应用。

STM32Cube_FW_WL_V1.0.0\Projects\NUCLEO-WL55JC 中的例程都是基于 STM32WL BGA73 的，CubeMX 无法直接创建基于 STM32WL QFN48 的例程。

: n6 H1 l3 L' N' x# Q3 i

同时介绍如何参考STM32Cube_FW_WL_V1.0.0\Projects\NUCLEOWL55JC\Applications\SubGHz_Phy\SubGHz_Phy_PingPong 创建一个 WLEx_PingPong 的例

子。

; K% B* ^4 s' O; ^0 a: y3 T6 d

关于不同 MCU 间的移植可参考

UM1718 11.9 Switching to another MCU

UM1718 15 Tutorial 5: Exporting current project configuration to a compatible MCU

需要提前准备的环境：

1.配置 CubeMX

1.1 配置 CubeMX 并下载 CubeWL

/ ]$ S8 l* |) E5 j

可以使用 CubeMX 默认安装的仓库目录也可以自定义仓库目录，本例使用自定义的仓库目录C:\Users\gongw\STM32Cube\Repository\CubeWL，如下Help=>Updater Settings=>Repository Forlder=>C:\Users\gongw\STM32Cube\Repository\CubeWL=>OK

1 C8 ?+ s! b6 x& T' q

选择 Manage software installations 中的 Install or remove embedded software packages 下的

“INSTALL / REMOVE”

点Refresh 更新数据库

* W+ q2 A1 \! |& t6 ^7 Y: E

Fresh 结束后，点开 STM32WL 左侧的黑色三角，选中 STM32WL 下版本 1.0.0 的 STM32Cube

MCU Package for STM32WL Series，点 Install Now

) N+ n, W* g0 q8 O6 M: @' W

点击 Close

# p! n3 H, N1 p4 c0 o$ W/ ]* t

0 Y: B4 `- e% ]

1.2 CubeMX 新建项目

4 k4 I: v- t) f% i' x+ V" d5 [

打开 STM32CubeMX，在 New Project 下有三中选择, 请根据需求选择 New Project 的方式！

1.2.1 Start My project from MCU

第 1 种可使用于所有的 WL 产品，只能生成和配置的用户自定义(User Defined)的LoRaWAN/SigFox/SUBGHZ 应用，不能生成 CubeWL 中 AT_Slave/EndNode/PingPong demo

& w7 j$ x" B! x7 T9 T, y

1.2.2 Start My project from BOARD

第 2 种适用于 NUCLEO-WL55JC1 和 NUCLEO-WL55JC1 两种 Demo 板，只能生成和配置的用户自定义(User Defined)的LoRaWAN/SigFox/SUBGHZ 应用，不能生成 CubeWL 中AT_Slave/EndNode/PingPong demo

4 r$ d0 W) \! Z) u

1.2.3 Start My project from EXAMPLES

第 3 种适用于生成 CubeWL 中 NUCLEO-WL55JC1 和 NUCLEO-WL55JC1 的 Examples，可生成和配置 CubeWL 中AT_Slave/EndNode/PingPong demo

' @+ l9 I  `# q+ W! C

选择 NUCLEO-WL55JC 对应的 STM32WL55JC

. ?3 ]2 [4 l& v6 R- ]8 ?7 x- j$ E

1.3 CubeMX 导入参考项目

8 F1 H0 @- R, M0 v. m0 _/ w' b

0 \" E: B6 F1 f7 A

此时再查看 File =>Import Project 选项，变为灰色，表示新项目已被配置，不能再 import 参考项目。

, }. \; i- S: Q$ T" F) x

: H9 c$ \" l; L: z+ b& @" w

1.4 CubeMX 配置项目

1.4.1 CubeMX 配置 Project Manager

选择 Project Manager

1.4.1.1 配置 Project

选择右侧 Project 并配置如下：

注意：

通过 Browse 选择 Project 保存的目录

⚫ 项目名称 WLEx_AT_Slave 创建在STM32Cube_FW_WL_V1.0.0\Projects\NUCLEO-

WL55JC\Applications\LoRaWAN 下，和LoRaWAN_End_Node 同级目录，即

C:\Users\gongw\STM32Cube\Repository\CubeWL\STM32Cube_FW_WL_V1.0.0\Projects\NUCLEO-WL55JC\Applications\LoRaWAN\WLEx_PingPong，以 便于与 LoRaWAN_End_Node 进行比较

& l* j( f9 {. |6 ]) t6 C2 H

⚫ 配置 Application Structure 为 Advanced 与 basic 有什么区别?

Application Structure 为 Advanced 时目录结构分类分级目录更清晰。

Application Structure 为 Basic 时，所有的*.h 都在 WLEx_PingPong\Inc 目录下，所有的*.c 在

WLEx_PingPong\Src 目录下。

一旦生成过一次代码后目录结构就无法更改了！！！

选择右侧 Code Generator 并配置如下，选择”Add necessary library files as reference in the toolchain project configuration file “，这样将不生成 Drivers 和 Middlewares 目录。

选择 Generated files 下的“Generate peripheral initialization as a pair of ‘.c/.h’ per peripheral”

注意:

⚫ Copy all used library Package (如复制 Drivers\STM32WLxx_HAL_Driver 下的所有驱动)

WLEx_PingPong 复制到其他目录下，还能工作

⚫ Copy only the necessary library files(如仅复制 Drivers\STM32WLxx_HAL_Driver 下使用到的驱动)WLEx_PingPong复制到其他目录下，还能工作

0 C# {% |8 J3 L+ d& n( S

⚫ Add necessary library files as reference in the toolchain project configuration file(不生成 Drivers 和Middlewares 目录，仅参考Drivers\STM32WLxx_HAL_Driver 下的所有驱动)

WLEx_PingPong 复制到其他目录下，不能工作

+ V$ h( i- e$ j  d  Q! {

参考 UM1718 4.9 Project Manager view

- V8 m# S$ V* M- o8 M

3. 配置外设

2.1 使能外设

! j. h' a, C( m5 }+ m' F# @; K

2.1.1 Middleware=>SUBGHZ_PHY 使能

2.1.2 Timers=>RTC 使能

Timers=>RTC=>勾选 Activate Clock Source

2.2 RTC

Clock Configuration => RTC Clock Mux=>LSE

在 Clock Configuration 中检查 RTC Clock Mux 是否配置为 LSE

Timer =>RTC=>Users Constants

Timer =>RTC=>Parameter Settings

Timer =>RTC=>NVIC Settings

Middleware => LORAWAN => Platform Settings => Timer Server => RTC

2 A" v7 k# i9 g+ x* c* c) l$ l

2.3 DebugLine

2.3.1Middleware => SUBGHZ_PHY => SubGHz_Phy middleware =>

radio_board_if =>Actovate Debug Line

, |# k4 [, D1 g0 n. t! G4 E

' \( }% i9 a0 H) W* F* `

2.3.2. Platform Settings => VCOM => USART2

4.3.3. Clock Configuration => UART2 Clock Mux => SYSCLK

Platform Settings => VCOM => LPUART1

7 Y5 B. x- e* b2 D+ V3 w

2.4 System Core => GPIO (RF SW CTRL / BUTTON / LED)

2.4.1 RF_CTRL

System Core => GPIO => PA8 (customizable)

Platform Settings => Radio => RF SW CTRL

% J. A7 |$ N, z5 T: P

2.4.2 LED
9 M# L  D1 t* W" A

System Core => GPIO => PB2 (customizable)

Platform Settings => Board resources => LED

3 STM32WL Templates Patches for CubeMX
" s/ w7 Z6 e6 b9 ?; H

% c' v1 G+ N) P

STM32WL Templates 在如下目录，如需要可自行定制自己的 Templates

针对不同的客户定制化的板子，硬件外设配置不一致，客户可根据需要定制化自己的外设配置。

从 NUCLEO-WL55JC(BGA73) 移植到STM32WLExCxUx(QFN48)定制化的板子上，射频开关(RF SW CTRL)，按键(BUTTON), LED 的配置会不一样，可能导致编译错误，如想生成的代码不会产生编译错误，需要编辑一下 STM32WL的 template。

3.1 CubeMX template patches for stm32wl

请参考

3.2 CubeMX Updates from v6.1.1 to v6.2.0

4.验证

4.1 参考工程

4.2 编译并下载

用 IAR 打开STM32Cube_FW_WL_V1.0.0\Projects\NUCLEOWL55JC\Applications\LoRaWAN\WLEx_PingPong\EWARM\Project.eww

( y4 {' g$ ^* ^8 |" l7 z( k

如果 IAR 之前已经打开了 WLEx_PingPong，在每次重新生成代码时都如有如下提示，选择“Yes to All”

按 F7 或选择 Project=>Make(F7)来编译工程，如果编译无错误，选择Project=>Download=>Download Active Application 下载WLEx_PingPong 应用