STM32Cube生态系统是ST为STM32开发者打造的软件生态，是嵌入式开发的利器。

6 m8 G5 a8 r; b, ]$ I5 _+ l8 `% V% \为提升功能丰富且高能效的STM32系列微控制器的易用性，2019年，意法半导体在STM32Cube软件生态系统中增加了一个免费的多功能STM32开发工具：STM32CubeIDE。
  j) V# |4 Y, |2 Z! r. x
STM32CubeIDE是ST官方提供的免费软件开发工具，也是STM32Cube生态系统的一员大将。它基于Eclipse®/CDT框架，GCC编译工具链和GDB调试工具，支持添加第三方功能插件。同时，STM32CubeIDE还集成了部分STM32CubeMX和STM32CubeProgrammer的功能，是一个 “多合一”的STM32开发工具。

( P3 @/ Z, u2 v6 _+ Y0 m" _& f* ?

       用户只需要STM32CubeIDE这一个工具，就可以完成从芯片选型，项目配置，代码生成，到代码编辑，编译，调试和烧录的所有工作。



0 C$ x* s+ m  S# I( ~5 S
STM32CubeIDE 是基于 Eclipse 的框架，它继承了 Eclipse 所特有的一些对用户来说还不太熟悉的特性，比如透视图，工作空间等。
! M8 K/ @* w3 i, }$ X6 n
( c7 E6 H( I3 b) T* {1 j工作空间（Workspace）：STM32CubeIDE通过工作空间（workspace）对工程进行管理，打开STM32Cube时，它会新建一个默认的工作空间，用户也可以通过Browse按钮另外选择一个文件夹作为工作空间，之后新建或者导入的工程就都属于前面选择的这个工作空间。同一个工作空间下的工程具有相同的IDE层面的配置（在Window→Preferences中进行设置），比如显示和编辑的风格设置等。从文件系统的角度，工作空间就是一个文件夹，里面包含了多个工程的文件夹和一个名为“.metadata”的文件夹，“.metadata”文件夹下包含了该工作空间内的所有工程的信息。用户可以通过File→Switch Workspace菜单，切换不同的工作空间。
, ^) z0 [7 K# _
透视图（Perspective）：透视图是一系列和某类功能相关的窗口的组合。常用的有C/C++编辑透视图，调试透视图和CubeMX配置透视图。
% m; L  x* M6 V+ ~% B
5 l0 \& c9 y) y" O' u; M& GC/C++编辑透视图包括了项目管理器，编辑窗口，Outline窗口等。在项目管理器中可以查看和操作当前工作空间中的所有项目。双击打开项目中的文件，文件内容会显示在编辑窗口，在编辑窗口可以对
0 n1 ?! |, N2 p1 t$ u
9 y8 F8 F) N6 t; M- h" A2 I在Window Show View菜单中可以打开和关闭需要显示在C/C++编辑透视图中的窗口。
% n# w* V; ]* r; Q
通过右上方的图标可以在不同的透视图之间切换，比如点击爬虫图标，就可以切换到调试透视图。在C/C++编辑透视图下点击工具栏的Debug按钮启动调试后，也会自动切换到调试透视图。

% v0 x* h9 b, o0 N3 O
1. 新建和导入工程
( y) W0 i- Z# y  Z- I. u; b" }
/ e8 [( ^- ~9 {& v. N. T使用STM32CubeIDE，用户可以通过多种方法来开始新建一个项目。在STM32CubeIDE的欢迎界面上，列出了创建/导入工程的快捷入口，分别对应下面的四种场景。也可以通过File菜单下的New和Import实现对应的功能。
) k" l! ]! x& O/ x# C- |! i
• 从零开始新建一个STM32工程
: A5 w) K1 m" `2 q) i2 _
• 已有STM32CubeMX的配置文件(*.ioc文件 )，希望根据该ioc文件新建一个STM32工程
$ |: ^- U+ d9 R, Z
. g7 I& \+ D. _• 已有SW4STM32或者TrueSTUDIO工程，希望转换成STM32CubeIDE工程
1 T! s* o3 l! h: u
• 基于STM32Cube库中的例程创建新工程
+ s- I+ g* m/ p- O/ ~# J9 g
6 v2 C, p( R; e( ]6 y* X$ H
& {. n. k" u9 q
STM32CubeIDE工程结构




单核的MCU都是扁平结构。

对于双核架构的MCU或者安全MCU，比如STM32H7，STM32L5和STM32MP1系列，STM32CubeIDE工程是分层结构。以STM32H7为例，创建或者导入STM32H7工程后，在Project Explorer栏看到的是一个三层的工程结构：最上面一层是“根”工程，然后是两个分别对应CM7和CM4内核的“子”工程，“子”工程下面才是工程文件。这两个CM7和CM4“子”工程才是真正的可编译和调试的工程，而“根”工程只是作为一个“容器”，包含了CM7和CM4这两个“子”工程。AN5361，AN5394，AN5360和AN5564分别描述了在STM32CubeIDE中如何创建，导入，编译和调试STM32H7双核，STM32L5，STM32MP1以及STM32WL的工程
) U, d6 k0 |7 N* z$ @. K  K
1 U2 F0 E! H/ a2 P( `, M打开/关闭/删除/切换/导出STM32CubeIDE工程
& l( N; Q. U) j; [. c
在Project Explorer窗口中可以看到当前工作空间下的所有工程。用户可以对这里面的任一工程进行打开/关闭/删除/导入/导出/更名等操作。

固件库管理
% i: \8 y; o; W! ?. v, I) F9 V
STM32CubeIDE集成了STM32CubeMX的部分功能，可以直接选择芯片/开发板型号，或者选择例程来生成一个新工程。STM32CubeIDE生成工程所需要的驱动和例程代码都来自各个STM32系列的固件库。

在Help→Manage Embedded Software Packages里，可以对所有的STM32固件库以及其他的插件进行管理（安装/删除固件库）。
) {' p' J; M/ E7 v$ \
用户可以通过Install Now按钮让STM32CubeIDE自动从网络进行下载安装，也可以通过From Local按钮来安装已经预先下载好的固件库。

- ^' t0 E0 k7 o) p! u# i- R& l- y9 e$ _& E通过Remove Now按钮可以删除选中的固件库。
: c+ n: D6 x# {% [& I, k6 T


# S3 F4 p4 {; T& ?5 l1 P8 g 在Window Preferences窗口的STM32Cube Firmware Updater标签页下，可以设置固件库安装的路径和更新的方式。
: o8 C* Y! i8 `9 s+ G* i

; `- v# \5 h1 J
: v! ]# t* w" [* N* j默认STM3CubeIDE在打开和新建工程的时候，都会尝试连接网络。用户也可以选择“Off Line Mode”,不让STM32CubeIDE去联网。但是需要通过上一张图中Embedded Software Packages Manager窗口的From Local按钮来安装已经预先下载好的固件库，否则将不能自动为新建的STM32工程生成代码。

点击Check Connection按钮可以检测当前的网络连接状态。检测结束如果出现一个红色的×，则说明网络配置有问题，需要我们到Network Connection页面去进行设置。

+ X! K- Z- y) C  l8 `除了前面主动检测网络状态，如果出现固件下载失败的情况，也请检查STM32CubeIDE的网络配置是否正确。

9 R2 O4 Y: n# k  s' J配置步骤见下图：
# A: g, U+ Z) I  e
* E7 b1 c( O) g6 K- i. @- F4 [1.进入 Window Preferences菜单，选择General Network Connections标签页
$ `7 e/ p0 D& v, ~0 o; Z1 o5 R
8 `6 k/ l8 `' g& q. A' g2.选择 Manual方式

3.选择HTTP，双击打开编辑窗口，设置网络连接参数。

& {" x# ?9 J  L& ~


代码编辑

STM32CubeIDE基于Eclipse，Eclipse的一些常用快捷键和编辑技巧一样适用于STM32CubeIDE。熟练掌握这些小技巧可以提高开发效率，使得程序开发的工作事半功倍。

代码编译
' Q% ~5 ~! U' g4 Z
' T2 o" ]8 M0 e; Q' _工程属性设置及编译

在Project Explorer中选中一个工程，点击右键后进入properties菜单，在其中就可以对编译项进行配置。常用配置的操作细节，请查看“STM32CubeIDE工程属性配置技巧”。

- T0 O  s# d; S& e" b配置完成之后就可以进行编译了。用户可以通过下面三种方式启动编译：
" v* ]! T. l4 N/ G0 e$ n& _8 o
. Q7 \2 o3 o9 _# ~: _0 a• 方法一：选中工程，点击右键，然后选择“Build Project”
  \) A9 E  A. q. Z2 W7 Z
3 g# p# v" ]: w- V% p( {! l• 方法二：选中工程，从Project菜单进入，然后选择“Build Project”

• 方法三：选中工程，直接点击工具栏里的Build图标


5 y$ d0 S1 ?4 l" r# d. H
提高编译速度

' }, {) [% d& G5 O+ Y' u9 }通过使能并行编译，可以提高STM32CubeIDE的编译速度。

1 g/ ^; y3 [2 b! `选中工程，点击右键后进入properties菜单，选择“C/C++ Build”，在Behavior标签页下，勾选“Enable parallel build”功能。
3 z  L7 I. G4 Z1 d



  @, g# v! D  Q2 j 编译相关辅助工具
1 I. Q( |) I+ W
工程编译完成以后，在“Build Analyzer”窗口可以看到链接文件中定义的所有内存区域（memory region）和段(section)的使用情况，包括加载地址，运行地址，有多少字节已经被占用，还剩余多少字节等。
1 Q4 x% R. u) V1 E# p' ^
9 {7 h8 {) w7 E* T! i在“Static Stack Analyzer”窗口中显示了静态堆栈的使用情况。

& j" x2 U9 G  Z; rSTM32CubeIDE还提供了Headless Build功能，可以不打开CubeIDE的图形界面，通过命令行就可以进行编译。

1 {. k# U: P1 a! f& a

代码调试及烧录
0 o0 m$ ]9 q6 A2 _# E
1 C" c0 u5 T* @$ ^) f9 j
调试及运行配置
# R) L6 }8 d# U/ u
! `+ a& \2 b6 u- o" h! k9 nSTM32CubeIDE工程编译完成且无任何错误，就可以进行调试和下载了。

在C/C++透视图的工具栏中有三个和下载调试相关的按钮：调试，运行和外部工具。

通过“调试”按钮旁边的小三角，可以打开Debug Configurations菜单，进行调试参数的配置，比如调试器的选择，GDB连接的设置，ST-LINK的设置，外部Flash Loader的设定等，并启动调试。
- U0 P& G3 S- U; `. T
  ~$ V- ]$ Y9 a& P1 a( z8 T通过“运行”按钮，可以仅下载程序不启动调试。
+ j/ W! B7 ~- c% n3 G
通过“外部工具”按钮，可以调用外部的命令行工具。

有关调试参数配置及调试技巧的内容，请参考“STM32CubeIDE工程调试配置及技巧”（马上推出，敬请期待）。
. N) [0 t6 ^/ q
# F3 `: M% y" T5 O  E- [
4 L1 B- z2 S$ ~7 ^
启动调试
5 C& R) p1 P' h- K6 v' q. w
STM32CubeIDE使用GDB进行调试，支持STLink和SEGGER J-Link调试器，支持通过SWD或JTAG接口连接目标MCU。

STM32CubeIDE工程编译完成之后，直接点击工具栏的爬虫图标或者通过选择菜单Run-->Debug，可以启动调试。
! a& H0 I% x! i% J0 ?: n; Y
如果是第一次对当前工程进行调试，STM32CubeIDE会先编译工程，然后打开调试配置窗口。调试配置窗口包含：调试接口的选择，STLink的设置，复位设置和外部flash loader的设置等选项，用户可以检查或者修改各项配置。确认所有的配置都正确无误，就可以点击OK，启动调试。
1 K( A8 L( c% ^; I
然后STM32CubeIDE会先将程序下载到MCU，然后从链接文件（*.ld）中指定的程序入口开始执行。程序默认从Reset_Handler开始执行，并暂停在main函数的第一行，等待接下来的调试指令。



基本调试操作

% T( s. P/ i- {! b3 p3 J启动调试后，STM32CubeIDE将自动切换到调试透视图，在调试透视图的工具栏中，列出了调试操作按钮。如下图所示。


- R" D' l0 z0 D( D
- u% l3 ]+ ]4 `
插件的使用
' x! c9 u# v: n9 ?9 q
  s' R5 Y6 C/ M5 k3 SSTM32CubeIDE同样支持Eclipse插件。

) o% I) S  J2 h2 ~! Z' S可以通过Help菜单下的“Eclipse Marketplace”，在Eclipse市场中查找并安装插件；
- w8 m% s; n) t; e2 s8 ?, J6 e7 B
或者通过Help菜单下的“Install New Software”，从指定的网址安装插件。
  y( Z* y  n6 q; A. ]
7 X. \7 g7 L- n* h' j8 y

, k& A5 Q( w# S/ |  s+ z9 [
STM32CubeIDE使用例程

下面我们通过一个LED闪灯的例程，来体验一下使用STM32CubeIDE进行软件开发的流程。

( y  ~+ \5 T7 f% ^; ?" r/ ]0 }例程使用NUCLEO-H743ZI开发板，通过STM32CubeIDE从零开始新建工程。该工程就实现一个简单的功能：板载的LED1以500ms的间隔自动翻转。

5 j5 T* g1 ?7 J+ j通过这个例程，可以了解到以下内容：

$ a8 |4 n4 |. U2 ~• 新建一个STM32CubeIDE工程
: `7 P4 S" i* f7 l! D
• 对STM32芯片进行配置
6 U1 N* k0 P; A, G) T7 s
• 添加用户代码并编译
5 f8 ~$ N+ _; @  e8 S
• 设置调试参数

+ E' l# \0 p5 x% {• 调试代码（查看变量及寄存器）
, \) @* ~5 {0 C/ z3 n  E, M
• 设置断点

首先，选择File-->New-->STM32 Project，STM32CubeIDE会打开MCU选择窗口。在这个窗口下，可以选择某个型号的芯片，也可以选择某个ST开发板或者例程。这里我们在搜索框里输入STM32H743ZI，就可以直接选择这个芯片了，然后点击Next。
. h% W" Z0 K* P5 |7 g4 q
2 W- y* j/ ^  e

在接下来弹出的窗口中，需要设置项目的名称，类型和工程保存的位置。默认情况下，新建的工程会保存在当前的workspace中，用户也可以按下图所示，取消“Use default location”，然后自定义工程保存的位置。需要注意的是，如果你试图将两个工程放在同一个路径下，在后面的创建过程中可能会报错。所以你可以在路径中加上工程名，以区别不同的工程。
) J2 W3 i4 h5 J7 u$ i# `& A
( [7 B: p- R) R9 w+ C设置完成后，点击Finish，STM32CubeIDE将为我们创建一个工程，并打开芯片的配置界面，这个界面和STM32CubeMX是一样的。
: X% e3 D2 t4 |- [) w
期间可能会弹出将要打开CubeMX配置透视图的提示，点击Yes就可以了。
8 X- W+ y. g2 @
- T5 @3 @) i% O7 Q; h% T
- g, q: c: h. Z- e
2 S  v" @6 B1 |接下来要做的是，在芯片配置界面，按功能需求对时钟，GPIO，外设，中间件等进行配置。在这个例程中，我们只用到了PB0，作为输出控制LED1，所以只需要配置它就可以了。时钟就使用默认配置。
) x+ n2 N) }; _8 l, p9 U$ f" _
5 J4 k; K/ H0 D8 M! o; K在Pinout视图下，通过搜索栏，可以在快速在芯片封装图上找到要配置的引脚。
  |: q# B) g) F" `! u
: M2 U' c# Y0 e2 }) l选择该引脚，点击右键，选择GPIO_Output功能。
7 B( Y0 G+ Q3 Q% S
然后转到System视图，点击GPIO模块，然后就可以看到刚刚配置的PB0引脚。这个窗口中，还可以继续调整PB0的其他参数，比如上/下拉，速度等。还可以为其定义一个用户标签LDE1，方便在代码中进行引用。
5 b( d1 s+ H7 H" K
$ X( ^2 \  P. r2 j; R8 ~2 H

所有的配置结束后，选择Project-->Generate Code重新生成代码。这时STM32Cube会切换到C/C++透视图，然后可以添加用户的文件或对某个C文件进行修改。

在这里，我们添加了一段翻转PB0的代码。这里要注意，所有用户添加的代码必须放在“USER CODE BEGIN xxx”和“USER CODE END xxx”这一对声明之间。这样当再次重新生成代码的时候，才不会丢失这部分代码。
6 D0 U! C, d5 s5 F
" U' d( x. y( [+ s# ~2 H代码添加完成后，点击“Build”开始编译。

+ C. l3 \( m- a
4 _. @4 r+ a- m8 \
1 l3 }& N( l/ E! m如果编译结束并且没有任何报错。就可以点击Debug，启动调试。

第一次启动调试，会先弹出调试参数配置窗口，确认好所有的参数无误，点击OK，STM32CubeIDE就会自动从编辑界面切换到调试界面了。如下图所示。

0 k5 _" K8 k' L在调试界面下，通过工具栏的操作按钮，可以进行单步调试。
+ D7 b( B: |7 ^1 l2 p$ P
  B% R* U! f9 n9 ^  `2 U5 X双击某一行代码最左边的标记栏处，就可以在这行代码处添加断点。
3 h# z: R3 s# H: z, Q2 O, ~$ ~
右侧打开了多个调试窗口，包括：局部变量，断点，全局变量和寄存器等等。这些窗口可以在Window-->Show View菜单中打开或者关闭。


6 W7 h& m' ?- a3 g! S+ O
# l! H  g) X& q$ ?————————————————
版权声明：Steven&Aileen
: ~- S" B) n; e2 e