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

" n0 F3 s# o6 `9 u/ [9 c为提升功能丰富且高能效的STM32系列微控制器的易用性，2019年，意法半导体在STM32Cube软件生态系统中增加了一个免费的多功能STM32开发工具：STM32CubeIDE。

STM32CubeIDE是ST官方提供的免费软件开发工具，也是STM32Cube生态系统的一员大将。它基于Eclipse®/CDT框架，GCC编译工具链和GDB调试工具，支持添加第三方功能插件。同时，STM32CubeIDE还集成了部分STM32CubeMX和STM32CubeProgrammer的功能，是一个 “多合一”的STM32开发工具。
  b# p& Y8 A0 f5 H8 t) d& l, q
; W3 K: j7 Z) V3 f$ f

9 b6 j7 B9 {* ^3 j. Y2 c       用户只需要STM32CubeIDE这一个工具，就可以完成从芯片选型，项目配置，代码生成，到代码编辑，编译，调试和烧录的所有工作。




STM32CubeIDE 是基于 Eclipse 的框架，它继承了 Eclipse 所特有的一些对用户来说还不太熟悉的特性，比如透视图，工作空间等。

工作空间（Workspace）：STM32CubeIDE通过工作空间（workspace）对工程进行管理，打开STM32Cube时，它会新建一个默认的工作空间，用户也可以通过Browse按钮另外选择一个文件夹作为工作空间，之后新建或者导入的工程就都属于前面选择的这个工作空间。同一个工作空间下的工程具有相同的IDE层面的配置（在Window→Preferences中进行设置），比如显示和编辑的风格设置等。从文件系统的角度，工作空间就是一个文件夹，里面包含了多个工程的文件夹和一个名为“.metadata”的文件夹，“.metadata”文件夹下包含了该工作空间内的所有工程的信息。用户可以通过File→Switch Workspace菜单，切换不同的工作空间。
' f, E0 W& Q. \. q9 h1 x
# ^, _* N  B6 i3 i, X+ v$ B透视图（Perspective）：透视图是一系列和某类功能相关的窗口的组合。常用的有C/C++编辑透视图，调试透视图和CubeMX配置透视图。

' c( ^4 J2 Z+ ]# C; K3 dC/C++编辑透视图包括了项目管理器，编辑窗口，Outline窗口等。在项目管理器中可以查看和操作当前工作空间中的所有项目。双击打开项目中的文件，文件内容会显示在编辑窗口，在编辑窗口可以对
5 ?% ?# E' W  M6 v2 C
在Window Show View菜单中可以打开和关闭需要显示在C/C++编辑透视图中的窗口。

通过右上方的图标可以在不同的透视图之间切换，比如点击爬虫图标，就可以切换到调试透视图。在C/C++编辑透视图下点击工具栏的Debug按钮启动调试后，也会自动切换到调试透视图。


' a  L$ V5 p' c) ], ]1. 新建和导入工程

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

• 从零开始新建一个STM32工程

• 已有STM32CubeMX的配置文件(*.ioc文件 )，希望根据该ioc文件新建一个STM32工程

• 已有SW4STM32或者TrueSTUDIO工程，希望转换成STM32CubeIDE工程
* i- t" {  T# r7 ~
• 基于STM32Cube库中的例程创建新工程
3 a  W" m) P8 }4 t

  a$ \. s; {8 k* @7 J4 r0 o& \4 i3 t
$ C2 N8 Z$ q2 d' f& ?* f8 Q STM32CubeIDE工程结构

8 ]% ?( t: q( f
) d8 F. j- {  H5 i5 n5 m1 [
/ j8 W% S2 v8 q* N" o
! E" n% T* \+ z( n* Z' o! b% U单核的MCU都是扁平结构。

. U+ x; U' F. W: }' h/ e- r( p对于双核架构的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的工程
6 E# o4 U* p: @
+ W# ~4 E8 M5 ?3 C, ^打开/关闭/删除/切换/导出STM32CubeIDE工程
+ r3 |" k, K, l4 b3 b# B- P  i* y
+ L1 R! o: N( {% c: }5 e) g在Project Explorer窗口中可以看到当前工作空间下的所有工程。用户可以对这里面的任一工程进行打开/关闭/删除/导入/导出/更名等操作。
0 l) [% r2 F. k/ R( Q: U
4 m% P# F2 d- u& e2 o固件库管理
; e9 O/ t. u7 V0 h+ j
6 E! o: U& D, O- j0 p. {* USTM32CubeIDE集成了STM32CubeMX的部分功能，可以直接选择芯片/开发板型号，或者选择例程来生成一个新工程。STM32CubeIDE生成工程所需要的驱动和例程代码都来自各个STM32系列的固件库。

在Help→Manage Embedded Software Packages里，可以对所有的STM32固件库以及其他的插件进行管理（安装/删除固件库）。
* L) W) H9 i5 D8 b2 n- n$ B
3 R7 D, O6 {& O: @7 u) V) L# L用户可以通过Install Now按钮让STM32CubeIDE自动从网络进行下载安装，也可以通过From Local按钮来安装已经预先下载好的固件库。

通过Remove Now按钮可以删除选中的固件库。
" ~; _7 K2 h! d8 g, W  h, y6 J; q# L
3 E* d. ~6 H: r  @' G; A8 H

2 p& B  ?% g/ K" ~- ~- a, c  g 在Window Preferences窗口的STM32Cube Firmware Updater标签页下，可以设置固件库安装的路径和更新的方式。
) o) U, ^* U% l+ F% @: D


" P! d7 n* y$ E5 {& R" ]+ y默认STM3CubeIDE在打开和新建工程的时候，都会尝试连接网络。用户也可以选择“Off Line Mode”,不让STM32CubeIDE去联网。但是需要通过上一张图中Embedded Software Packages Manager窗口的From Local按钮来安装已经预先下载好的固件库，否则将不能自动为新建的STM32工程生成代码。

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

除了前面主动检测网络状态，如果出现固件下载失败的情况，也请检查STM32CubeIDE的网络配置是否正确。
% A2 _& H. I7 l3 A% _9 H
% d6 L. x% B$ t! a$ a- S3 ^配置步骤见下图：

1.进入 Window Preferences菜单，选择General Network Connections标签页
3 ]5 [) k* ^" g! w
4 v% f2 h' h) B5 h% s2.选择 Manual方式
' M5 ?( f1 n- @
! i( u, {1 K9 g- x+ K/ |9 n3.选择HTTP，双击打开编辑窗口，设置网络连接参数。


1 y& M0 M+ @' q+ N) T" v* c

代码编辑
8 `4 ?& z1 t+ K3 {: q3 C9 ?
STM32CubeIDE基于Eclipse，Eclipse的一些常用快捷键和编辑技巧一样适用于STM32CubeIDE。熟练掌握这些小技巧可以提高开发效率，使得程序开发的工作事半功倍。
( Y! b; b2 A# c1 F
代码编译

工程属性设置及编译
( ?; |' ]' W4 g7 A( H: Y- Q9 J- r
  |2 Y& F( P  w9 I4 t$ H0 V+ M( {在Project Explorer中选中一个工程，点击右键后进入properties菜单，在其中就可以对编译项进行配置。常用配置的操作细节，请查看“STM32CubeIDE工程属性配置技巧”。

" I! |/ f8 o& n% B8 Z0 w, }配置完成之后就可以进行编译了。用户可以通过下面三种方式启动编译：
8 F: B+ ]7 W: U+ y
/ Z( o# [; Q' N5 ?• 方法一：选中工程，点击右键，然后选择“Build Project”
+ u0 ^. ^% i* j3 w6 l- H* q. g
• 方法二：选中工程，从Project菜单进入，然后选择“Build Project”

/ L* Q5 s8 {8 n& w9 d• 方法三：选中工程，直接点击工具栏里的Build图标
, D9 J; ]& F, E1 ]3 n" l. U7 I* x# s9 y! M


提高编译速度

通过使能并行编译，可以提高STM32CubeIDE的编译速度。
5 l1 i6 n1 Y# D  z8 I# V9 |1 P7 ~
' _' H7 m! E( I* _0 f选中工程，点击右键后进入properties菜单，选择“C/C++ Build”，在Behavior标签页下，勾选“Enable parallel build”功能。
7 X) x  r/ L  Q$ I
- x' u7 [1 p$ g4 a4 t

+ y) f, U! U5 D0 C
( q+ M5 g6 I4 K* J" U6 S- ]# ? 编译相关辅助工具

工程编译完成以后，在“Build Analyzer”窗口可以看到链接文件中定义的所有内存区域（memory region）和段(section)的使用情况，包括加载地址，运行地址，有多少字节已经被占用，还剩余多少字节等。
+ P8 O  r" F8 ?  I) b
1 M: G) t$ t8 l在“Static Stack Analyzer”窗口中显示了静态堆栈的使用情况。

/ {$ \" _7 [7 O3 l4 cSTM32CubeIDE还提供了Headless Build功能，可以不打开CubeIDE的图形界面，通过命令行就可以进行编译。
, U6 `' g0 D- @, U$ v) o

3 l/ }6 e- F& ]0 N* D! x% m) j
代码调试及烧录
6 g: N$ H( R! K0 z+ Z1 A

7 S6 r* Y% B, ^+ G调试及运行配置

STM32CubeIDE工程编译完成且无任何错误，就可以进行调试和下载了。
+ Z  R3 A2 ~5 k& P
* C! p$ M3 W) O, p在C/C++透视图的工具栏中有三个和下载调试相关的按钮：调试，运行和外部工具。

" f: v' M8 l7 e0 \通过“调试”按钮旁边的小三角，可以打开Debug Configurations菜单，进行调试参数的配置，比如调试器的选择，GDB连接的设置，ST-LINK的设置，外部Flash Loader的设定等，并启动调试。
- V& q4 G% h1 l
7 {$ B: m* {4 F& f  O4 A3 g6 `* u通过“运行”按钮，可以仅下载程序不启动调试。
% |7 G6 t5 a4 k+ d+ Z8 F1 _
通过“外部工具”按钮，可以调用外部的命令行工具。
# Z) D5 o. g$ M8 k1 f0 Q+ p
1 C, K# Q9 ?: k4 N有关调试参数配置及调试技巧的内容，请参考“STM32CubeIDE工程调试配置及技巧”（马上推出，敬请期待）。

" i! |4 X! J& m* ^6 u
0 M* o  s5 T5 B( L/ Q* K  D8 v
启动调试
2 r5 w/ o& `# x
' r$ g0 @5 R! \& ]STM32CubeIDE使用GDB进行调试，支持STLink和SEGGER J-Link调试器，支持通过SWD或JTAG接口连接目标MCU。

STM32CubeIDE工程编译完成之后，直接点击工具栏的爬虫图标或者通过选择菜单Run-->Debug，可以启动调试。
3 u# F5 n7 _) }& [7 `
$ Q8 R3 x' X  t0 C- s, ^$ Y如果是第一次对当前工程进行调试，STM32CubeIDE会先编译工程，然后打开调试配置窗口。调试配置窗口包含：调试接口的选择，STLink的设置，复位设置和外部flash loader的设置等选项，用户可以检查或者修改各项配置。确认所有的配置都正确无误，就可以点击OK，启动调试。
5 q1 |/ \7 @& f: W" G
- @: A2 z3 d3 ?# I$ `3 C8 N然后STM32CubeIDE会先将程序下载到MCU，然后从链接文件（*.ld）中指定的程序入口开始执行。程序默认从Reset_Handler开始执行，并暂停在main函数的第一行，等待接下来的调试指令。
: R# S# c" V4 U- d% {: j0 I+ a
& V' _* U" o1 h- c, @) X' T
( T# g7 |* @% m& Q" i; ]
基本调试操作
6 y$ p( M* t0 @# Y* O9 X, ?# I
启动调试后，STM32CubeIDE将自动切换到调试透视图，在调试透视图的工具栏中，列出了调试操作按钮。如下图所示。
& H) }6 w8 v3 L: P8 }7 o
" L, Q3 w3 {' Y  H3 o
  r$ |- ]5 c$ l1 p

插件的使用

STM32CubeIDE同样支持Eclipse插件。
8 c. r& _( ?" Q0 T* A
可以通过Help菜单下的“Eclipse Marketplace”，在Eclipse市场中查找并安装插件；

或者通过Help菜单下的“Install New Software”，从指定的网址安装插件。
6 w: W' Q. Z$ Z
/ U4 R' b8 _% t  j1 j
' u. J4 d& Z* Z9 K$ h6 n5 s& l- @
; g  D$ w8 z1 `& K9 T: b! e; N
  h7 n7 z" u2 ^! w' x; k, Y; B+ hSTM32CubeIDE使用例程

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

" y. ?4 K: Z: [& V7 e例程使用NUCLEO-H743ZI开发板，通过STM32CubeIDE从零开始新建工程。该工程就实现一个简单的功能：板载的LED1以500ms的间隔自动翻转。

通过这个例程，可以了解到以下内容：

• 新建一个STM32CubeIDE工程
' x" Y" G; K% @+ j
- e" o& V) w$ b6 S• 对STM32芯片进行配置
6 `6 g! L& M/ g  j, W
. p  k) |6 ~8 k# {) C( o" _• 添加用户代码并编译

9 P/ I6 N5 J7 U5 l1 X, X9 T! y• 设置调试参数
* z  E4 y6 f0 H) U: Q
9 t$ i6 \8 ]; ]7 u0 I( i: z• 调试代码（查看变量及寄存器）
5 D5 E1 M( r9 X( E) Z8 ^
8 w& J) Y) Q& V• 设置断点
5 ]- J0 q' u, P) v
首先，选择File-->New-->STM32 Project，STM32CubeIDE会打开MCU选择窗口。在这个窗口下，可以选择某个型号的芯片，也可以选择某个ST开发板或者例程。这里我们在搜索框里输入STM32H743ZI，就可以直接选择这个芯片了，然后点击Next。

3 w: w2 g" i+ o9 S2 S
6 [" C& r) L3 a9 o+ Y& g4 N
# c. D4 E. c* }+ d在接下来弹出的窗口中，需要设置项目的名称，类型和工程保存的位置。默认情况下，新建的工程会保存在当前的workspace中，用户也可以按下图所示，取消“Use default location”，然后自定义工程保存的位置。需要注意的是，如果你试图将两个工程放在同一个路径下，在后面的创建过程中可能会报错。所以你可以在路径中加上工程名，以区别不同的工程。
9 M" }* \: J/ T
设置完成后，点击Finish，STM32CubeIDE将为我们创建一个工程，并打开芯片的配置界面，这个界面和STM32CubeMX是一样的。

期间可能会弹出将要打开CubeMX配置透视图的提示，点击Yes就可以了。
; e' U3 C3 u) r2 |. i: z
& B' S1 P% t1 `" p8 T: \. A! V

接下来要做的是，在芯片配置界面，按功能需求对时钟，GPIO，外设，中间件等进行配置。在这个例程中，我们只用到了PB0，作为输出控制LED1，所以只需要配置它就可以了。时钟就使用默认配置。
) K- `! o# e/ A4 r0 b4 I
在Pinout视图下，通过搜索栏，可以在快速在芯片封装图上找到要配置的引脚。

- L0 ^9 s/ P' G; Q  j4 ]3 _4 x选择该引脚，点击右键，选择GPIO_Output功能。
6 @/ H) K! t/ L( D1 A- L$ @( A
然后转到System视图，点击GPIO模块，然后就可以看到刚刚配置的PB0引脚。这个窗口中，还可以继续调整PB0的其他参数，比如上/下拉，速度等。还可以为其定义一个用户标签LDE1，方便在代码中进行引用。
2 T* h: f6 E# s6 s% x: H6 T! R

; O0 `5 b" C2 E+ E$ B
) G; [  H7 Q& ?1 W: g  Q7 @所有的配置结束后，选择Project-->Generate Code重新生成代码。这时STM32Cube会切换到C/C++透视图，然后可以添加用户的文件或对某个C文件进行修改。

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

代码添加完成后，点击“Build”开始编译。
! [. c6 d- ]6 g: X# H) e' C

% ?) V; p! W7 i: h0 e; C6 M* i2 F
如果编译结束并且没有任何报错。就可以点击Debug，启动调试。
) K# A& J  Q( G( F! V/ [
) H: d* u9 Z9 _( s4 I* E- _/ {2 ]0 o. Z第一次启动调试，会先弹出调试参数配置窗口，确认好所有的参数无误，点击OK，STM32CubeIDE就会自动从编辑界面切换到调试界面了。如下图所示。
, {8 a; ]' v. m6 u& B4 c) A
# x6 x5 ^' |- t4 }! [在调试界面下，通过工具栏的操作按钮，可以进行单步调试。

双击某一行代码最左边的标记栏处，就可以在这行代码处添加断点。
* h" U- J" c& P* I" k* w
右侧打开了多个调试窗口，包括：局部变量，断点，全局变量和寄存器等等。这些窗口可以在Window-->Show View菜单中打开或者关闭。
3 x4 E1 m8 ]0 a: Q
$ U! v  h% q, f6 E: }

$ ]1 S: g* P) ^6 z————————————————
版权声明：Steven&Aileen
" w3 W5 `4 y1 B5 |4 T* A$ D: ~$ k/ q
. {8 z& G6 ^, p% R6 M5 [