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

* _# `% ~9 [, o- }$ e为提升功能丰富且高能效的STM32系列微控制器的易用性，2019年，意法半导体在STM32Cube软件生态系统中增加了一个免费的多功能STM32开发工具：STM32CubeIDE。
* W, b5 b' ]9 K2 o) Q' h  s
8 |8 X; k( o+ Q. ^, fSTM32CubeIDE是ST官方提供的免费软件开发工具，也是STM32Cube生态系统的一员大将。它基于Eclipse®/CDT框架，GCC编译工具链和GDB调试工具，支持添加第三方功能插件。同时，STM32CubeIDE还集成了部分STM32CubeMX和STM32CubeProgrammer的功能，是一个 “多合一”的STM32开发工具。
% n/ f7 D7 V5 a0 E9 `


       用户只需要STM32CubeIDE这一个工具，就可以完成从芯片选型，项目配置，代码生成，到代码编辑，编译，调试和烧录的所有工作。
: \. z8 b+ i. u, K) i' R
1 h, G) e: m; v& [
" Z0 t" j3 D4 x) K$ c1 e
! `3 q+ l% g* g7 p' H7 h( W2 }% n# e
7 [7 k& N- Q& K1 p* S8 }: d% {+ r/ ESTM32CubeIDE 是基于 Eclipse 的框架，它继承了 Eclipse 所特有的一些对用户来说还不太熟悉的特性，比如透视图，工作空间等。

工作空间（Workspace）：STM32CubeIDE通过工作空间（workspace）对工程进行管理，打开STM32Cube时，它会新建一个默认的工作空间，用户也可以通过Browse按钮另外选择一个文件夹作为工作空间，之后新建或者导入的工程就都属于前面选择的这个工作空间。同一个工作空间下的工程具有相同的IDE层面的配置（在Window→Preferences中进行设置），比如显示和编辑的风格设置等。从文件系统的角度，工作空间就是一个文件夹，里面包含了多个工程的文件夹和一个名为“.metadata”的文件夹，“.metadata”文件夹下包含了该工作空间内的所有工程的信息。用户可以通过File→Switch Workspace菜单，切换不同的工作空间。

透视图（Perspective）：透视图是一系列和某类功能相关的窗口的组合。常用的有C/C++编辑透视图，调试透视图和CubeMX配置透视图。
5 h0 q6 N7 L/ x/ ]: a
7 c! y2 c3 g6 g5 q. V6 U2 RC/C++编辑透视图包括了项目管理器，编辑窗口，Outline窗口等。在项目管理器中可以查看和操作当前工作空间中的所有项目。双击打开项目中的文件，文件内容会显示在编辑窗口，在编辑窗口可以对
4 G. N9 v  [" h9 N' N& N
, e% Q" K- I3 Y+ Y! _4 }' A在Window Show View菜单中可以打开和关闭需要显示在C/C++编辑透视图中的窗口。
4 Z# ]. a* q$ s8 |  h1 {
通过右上方的图标可以在不同的透视图之间切换，比如点击爬虫图标，就可以切换到调试透视图。在C/C++编辑透视图下点击工具栏的Debug按钮启动调试后，也会自动切换到调试透视图。

5 b: `. ]( P2 E6 n/ k
1. 新建和导入工程

使用STM32CubeIDE，用户可以通过多种方法来开始新建一个项目。在STM32CubeIDE的欢迎界面上，列出了创建/导入工程的快捷入口，分别对应下面的四种场景。也可以通过File菜单下的New和Import实现对应的功能。

• 从零开始新建一个STM32工程
3 U. k5 n# l, D) k( r$ v- d
• 已有STM32CubeMX的配置文件(*.ioc文件 )，希望根据该ioc文件新建一个STM32工程

• 已有SW4STM32或者TrueSTUDIO工程，希望转换成STM32CubeIDE工程

• 基于STM32Cube库中的例程创建新工程



7 R+ r( P* x; q/ J2 O! |6 V$ v STM32CubeIDE工程结构
1 j5 c& V8 S' \: j

- H6 W  z) H7 }6 f/ P  b8 |

单核的MCU都是扁平结构。
. r; f; }* ?! `, b# V" |. k
! k8 a& f' y5 E4 A2 n- M" @对于双核架构的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的工程

  _* s. C8 m+ L  Y打开/关闭/删除/切换/导出STM32CubeIDE工程

在Project Explorer窗口中可以看到当前工作空间下的所有工程。用户可以对这里面的任一工程进行打开/关闭/删除/导入/导出/更名等操作。
9 `4 y4 D! l9 w2 F* P
/ q0 h! F* J' W8 R  v; u: ~/ A" E固件库管理
& T; ~4 {* [' q8 o
STM32CubeIDE集成了STM32CubeMX的部分功能，可以直接选择芯片/开发板型号，或者选择例程来生成一个新工程。STM32CubeIDE生成工程所需要的驱动和例程代码都来自各个STM32系列的固件库。
- V& e: R  U, a7 t* m9 w& ?6 p
在Help→Manage Embedded Software Packages里，可以对所有的STM32固件库以及其他的插件进行管理（安装/删除固件库）。
6 H7 _7 d& h- e- E9 Z
; f% G$ |: N! u5 |  H8 r% v用户可以通过Install Now按钮让STM32CubeIDE自动从网络进行下载安装，也可以通过From Local按钮来安装已经预先下载好的固件库。
. T* e+ q2 y! Y
  S# q3 h5 {* ~7 g, R- Z通过Remove Now按钮可以删除选中的固件库。
9 a- B- L; |  ]- v
) E& r1 V! v3 H
# U4 Y# E- s) f" a. t" y
8 D7 m! u% e! y- E 在Window Preferences窗口的STM32Cube Firmware Updater标签页下，可以设置固件库安装的路径和更新的方式。
* Q% u. i' D/ @9 t5 [
1 e" b) Q2 m; [4 b% i2 {
2 j4 i1 @/ c5 j+ z2 g
默认STM3CubeIDE在打开和新建工程的时候，都会尝试连接网络。用户也可以选择“Off Line Mode”,不让STM32CubeIDE去联网。但是需要通过上一张图中Embedded Software Packages Manager窗口的From Local按钮来安装已经预先下载好的固件库，否则将不能自动为新建的STM32工程生成代码。
0 x8 e% g% A/ X4 Q6 q  e5 i: ?
点击Check Connection按钮可以检测当前的网络连接状态。检测结束如果出现一个红色的×，则说明网络配置有问题，需要我们到Network Connection页面去进行设置。
& o4 K# e% E  ~- o) [
除了前面主动检测网络状态，如果出现固件下载失败的情况，也请检查STM32CubeIDE的网络配置是否正确。
6 X) W8 r5 z/ \  x( O" {# O) y4 o7 n& A
& R7 I7 @4 Y8 r8 r7 s" D配置步骤见下图：
2 R5 e& \$ f  N/ z" _8 q+ [, O
# R' h1 {( m, O% I1.进入 Window Preferences菜单，选择General Network Connections标签页
  L( m3 E5 @- m+ G4 y" \  X! B# i
  L& ]6 V( B& s2.选择 Manual方式
. a+ `6 u, K1 d3 e, X' d9 f
3.选择HTTP，双击打开编辑窗口，设置网络连接参数。
- r& d5 ~2 D6 T+ ~6 D2 `

1 U# E- l, \) f# _8 i

- w8 E8 B. G4 T/ L3 V代码编辑

2 w# _1 i: ^6 L! y, ^6 ^' ESTM32CubeIDE基于Eclipse，Eclipse的一些常用快捷键和编辑技巧一样适用于STM32CubeIDE。熟练掌握这些小技巧可以提高开发效率，使得程序开发的工作事半功倍。

( H% A+ x8 r/ |- t! W1 b代码编译

( n6 ^' k; r! r( ~工程属性设置及编译
# M1 i, Z/ y8 K) y* @
在Project Explorer中选中一个工程，点击右键后进入properties菜单，在其中就可以对编译项进行配置。常用配置的操作细节，请查看“STM32CubeIDE工程属性配置技巧”。
$ Y& `6 U/ ~. X' U
; b, B% d  K5 m5 E/ x: N配置完成之后就可以进行编译了。用户可以通过下面三种方式启动编译：
% y2 h6 z7 j3 }3 v* A# }$ k
• 方法一：选中工程，点击右键，然后选择“Build Project”
2 J& R: O7 q5 s
• 方法二：选中工程，从Project菜单进入，然后选择“Build Project”
3 u7 t0 P: H( M+ h: C
! f) Q; v. L! E; I" u• 方法三：选中工程，直接点击工具栏里的Build图标
( z# Q* S: ]0 H/ `

, }/ G% I0 r. X
0 |) n% W; Y; g* q& g 提高编译速度

% ]( N; N5 ~5 c% N$ E通过使能并行编译，可以提高STM32CubeIDE的编译速度。

选中工程，点击右键后进入properties菜单，选择“C/C++ Build”，在Behavior标签页下，勾选“Enable parallel build”功能。



  j# c* L& @/ n% c) k- k* I# L
. v$ u/ Z+ i- L+ `2 P/ w 编译相关辅助工具
6 `% M! R" }# K! G
工程编译完成以后，在“Build Analyzer”窗口可以看到链接文件中定义的所有内存区域（memory region）和段(section)的使用情况，包括加载地址，运行地址，有多少字节已经被占用，还剩余多少字节等。

; U( k0 B+ @$ e在“Static Stack Analyzer”窗口中显示了静态堆栈的使用情况。

/ t( @0 H. g  `4 n, k+ gSTM32CubeIDE还提供了Headless Build功能，可以不打开CubeIDE的图形界面，通过命令行就可以进行编译。


; M! {9 n# s* c+ |3 h% X
3 K. d- t8 Q; I% D代码调试及烧录
- S- K3 k1 i1 J7 L- D0 i
. D* F' s! x/ ~
% G' u5 a  x6 c( h调试及运行配置
$ {. p, n9 k6 g3 V! w
STM32CubeIDE工程编译完成且无任何错误，就可以进行调试和下载了。

" V6 ]  Y6 m" g4 F6 r6 x在C/C++透视图的工具栏中有三个和下载调试相关的按钮：调试，运行和外部工具。

通过“调试”按钮旁边的小三角，可以打开Debug Configurations菜单，进行调试参数的配置，比如调试器的选择，GDB连接的设置，ST-LINK的设置，外部Flash Loader的设定等，并启动调试。

/ o( M0 e, P# j5 j2 y  ~通过“运行”按钮，可以仅下载程序不启动调试。

通过“外部工具”按钮，可以调用外部的命令行工具。
8 F0 @; j2 _& w% h, R8 K
% U* I2 Z$ ]$ _2 Q有关调试参数配置及调试技巧的内容，请参考“STM32CubeIDE工程调试配置及技巧”（马上推出，敬请期待）。
" `: G% k# J5 o/ P5 ~) ^( I
1 ^" y; i; P; G7 F
4 g9 Y( y3 }* O
启动调试
1 T+ o+ z# ^7 ?; Z7 n' n$ |5 H5 W
6 j) G7 ~7 w# t' S7 U: A! s/ d9 RSTM32CubeIDE使用GDB进行调试，支持STLink和SEGGER J-Link调试器，支持通过SWD或JTAG接口连接目标MCU。

* S0 b" w- p5 a. GSTM32CubeIDE工程编译完成之后，直接点击工具栏的爬虫图标或者通过选择菜单Run-->Debug，可以启动调试。
( U7 X9 l. H6 l! B' B1 U- M
2 y& F8 v; H  ?& L如果是第一次对当前工程进行调试，STM32CubeIDE会先编译工程，然后打开调试配置窗口。调试配置窗口包含：调试接口的选择，STLink的设置，复位设置和外部flash loader的设置等选项，用户可以检查或者修改各项配置。确认所有的配置都正确无误，就可以点击OK，启动调试。

然后STM32CubeIDE会先将程序下载到MCU，然后从链接文件（*.ld）中指定的程序入口开始执行。程序默认从Reset_Handler开始执行，并暂停在main函数的第一行，等待接下来的调试指令。



基本调试操作
  y) R( u/ s% D
启动调试后，STM32CubeIDE将自动切换到调试透视图，在调试透视图的工具栏中，列出了调试操作按钮。如下图所示。
; o) v# P& ~0 G( w5 U
; H+ a6 Z/ K: ?& |


1 B) ^# W5 u+ p1 k% Q插件的使用

+ o5 z4 J/ _! G+ _+ T3 C, gSTM32CubeIDE同样支持Eclipse插件。
" N. {' u  f) ]4 {) @
可以通过Help菜单下的“Eclipse Marketplace”，在Eclipse市场中查找并安装插件；

3 O+ E; W& Q; r8 p% ^, i" g或者通过Help菜单下的“Install New Software”，从指定的网址安装插件。
( N9 I1 c4 ~5 J0 F9 c


8 @! g! S# }$ {. M4 k% K' u4 Q, n, c
STM32CubeIDE使用例程
: o7 M+ |. C! n8 s+ f( ^7 z
下面我们通过一个LED闪灯的例程，来体验一下使用STM32CubeIDE进行软件开发的流程。

: q' c; T  ]8 d- m% c7 a8 v例程使用NUCLEO-H743ZI开发板，通过STM32CubeIDE从零开始新建工程。该工程就实现一个简单的功能：板载的LED1以500ms的间隔自动翻转。
( r4 K# q! O" b3 s8 I9 j, f
; p6 l, L- }, f0 A  g3 A通过这个例程，可以了解到以下内容：
- I+ N5 i0 G4 I3 I: C
( L/ L* S6 s+ u) ]2 x1 {• 新建一个STM32CubeIDE工程

• 对STM32芯片进行配置
$ s8 k4 Z  B, G, ^9 z( C
& f: \  A9 q' x( F$ m+ z• 添加用户代码并编译

• 设置调试参数

• 调试代码（查看变量及寄存器）
* B2 Z% d1 e# N- u& u
• 设置断点

9 x/ L1 Z" B1 m% A+ d& {8 q首先，选择File-->New-->STM32 Project，STM32CubeIDE会打开MCU选择窗口。在这个窗口下，可以选择某个型号的芯片，也可以选择某个ST开发板或者例程。这里我们在搜索框里输入STM32H743ZI，就可以直接选择这个芯片了，然后点击Next。

' r1 V; Z3 ^- F: s0 h, e& R5 U" z( G

在接下来弹出的窗口中，需要设置项目的名称，类型和工程保存的位置。默认情况下，新建的工程会保存在当前的workspace中，用户也可以按下图所示，取消“Use default location”，然后自定义工程保存的位置。需要注意的是，如果你试图将两个工程放在同一个路径下，在后面的创建过程中可能会报错。所以你可以在路径中加上工程名，以区别不同的工程。
. G" n. R5 w% B  n' u( u* G# _0 y
设置完成后，点击Finish，STM32CubeIDE将为我们创建一个工程，并打开芯片的配置界面，这个界面和STM32CubeMX是一样的。
- T: B* x5 X% ^4 Y) V
* H7 S4 h) U* ]期间可能会弹出将要打开CubeMX配置透视图的提示，点击Yes就可以了。
( \9 X, D9 g, ^9 F$ _# L( [

  x) Z0 E, i# r. y" W! U2 K
接下来要做的是，在芯片配置界面，按功能需求对时钟，GPIO，外设，中间件等进行配置。在这个例程中，我们只用到了PB0，作为输出控制LED1，所以只需要配置它就可以了。时钟就使用默认配置。
% T8 b6 A6 h9 o$ K" n
  W2 @9 y0 T, F1 P2 O& \在Pinout视图下，通过搜索栏，可以在快速在芯片封装图上找到要配置的引脚。

" b$ F3 X/ z" _" V, `选择该引脚，点击右键，选择GPIO_Output功能。

3 m* }, ]) Q2 R/ A$ ^然后转到System视图，点击GPIO模块，然后就可以看到刚刚配置的PB0引脚。这个窗口中，还可以继续调整PB0的其他参数，比如上/下拉，速度等。还可以为其定义一个用户标签LDE1，方便在代码中进行引用。
( _. V* u* {6 c% w; j

8 ?% `; \* i5 i6 f$ G7 V
8 F4 X5 m1 O8 t所有的配置结束后，选择Project-->Generate Code重新生成代码。这时STM32Cube会切换到C/C++透视图，然后可以添加用户的文件或对某个C文件进行修改。

在这里，我们添加了一段翻转PB0的代码。这里要注意，所有用户添加的代码必须放在“USER CODE BEGIN xxx”和“USER CODE END xxx”这一对声明之间。这样当再次重新生成代码的时候，才不会丢失这部分代码。

代码添加完成后，点击“Build”开始编译。

/ O4 S* [' I; u1 g; Y+ u$ A8 _

% l6 W0 e! H' \: x/ x如果编译结束并且没有任何报错。就可以点击Debug，启动调试。
3 Q; V6 o; J( v7 z# r# [
$ ^. j# R2 \# T# b5 {4 z第一次启动调试，会先弹出调试参数配置窗口，确认好所有的参数无误，点击OK，STM32CubeIDE就会自动从编辑界面切换到调试界面了。如下图所示。

* S, U3 p1 U7 ~0 M- g5 G" O1 Q. x在调试界面下，通过工具栏的操作按钮，可以进行单步调试。

8 ~/ w' U- F9 t+ j3 d! @9 Z双击某一行代码最左边的标记栏处，就可以在这行代码处添加断点。
0 m% {+ N- m* }& U% l
右侧打开了多个调试窗口，包括：局部变量，断点，全局变量和寄存器等等。这些窗口可以在Window-->Show View菜单中打开或者关闭。
3 k- |5 s+ {2 X) E0 o
# y+ D( c8 G; ~: \  S8 K" b$ i
9 X' {& M3 `+ H9 k8 S
————————————————
1 E4 P6 L2 F  M6 a0 t$ h版权声明：Steven&Aileen
4 [2 v6 W9 ]* a  j% w

5 E+ t9 i' h1 P1 ?