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

【经验分享】STM32CubeIDE使用说明 —— Keil项目迁移到STM32CubeIDE

[复制链接]
STMCU小助手 发布时间:2022-5-19 11:20
        对于初学者来说,刚开始学习STM32时候都使用的是Keil,很多项目都是在Keil环境下编译和调试的,这一章将描述如何将Keil工程迁移到STM32CubeIDE中。5 J: U3 r6 I$ |! S

$ k8 c1 ^/ M! z5 z  G7 t; @          对照Keil下的新建工程步骤,创建工程、引入工程文件、添加预处理指令、添加头文件包含路径等步骤,STM32CubeIDE中也大同小异。 为了便于说明,我用STM32CubeMX生成了一个Keil5环境下的STM32F103C8T6亮灯程序,然后将其迁移到STM32CubeIDE中。9 k9 y+ S' c6 G2 S8 x
(7[HULSY5M5PEDSVH0SCNGJ.png

6 F, d, p* h- t" r) u7 w1 |5 r5 `0 Q1 ?8 n! T: q5 D; P
STM32F103C8T6亮灯程序
3 H& r0 Y. D: x3 `; C9 a/ B

- K& L. E0 c- x$ E* h- A  A. Y3 [, J# U/ n8 B( b3 A  }- q, ~
        如图所示,该文件夹内容是STM32CubeMX自动生成的,我们在该路径下面创建一个STM32CubeIDE_Test文件夹,用来存放STM32CubeIDE相关工程文件。
  u" y1 w. s% z( K9 s! C5 ^$ ~  D6 q6 H9 p/ {9 f' `
LQZK{H7EQAWA61RTUWK%V.png

4 s6 I. x& C( f6 h+ [7 U0 }' e8 W3 z8 ]/ }6 `. G/ D, v
创建工程文件夹
. y+ u5 s  P8 E

7 X( @/ `2 g, o' r( q  ^  j7 X. z7 Z) A% M
        参照上一章,先使用STM32CubeIDE创建一个STM32F103C8T6的工程,STM32CubeIDE的Workspace中的这三个文件就是我们需要的,这三个文件记录了STM32F103C8T6芯片的一些相关信息,我们可以直接拿来用,很方便。将其拷贝到上面在STM32CubeMX中创建的文件夹内。; O' v5 d& I* }) `5 O; E

  b6 K1 p! ~; U5 l( W: d9 B6 [" N: Z
8TEZDA$)K%9UMIWWPVN9ETF.png
6 U* f3 y& ^6 c2 v( {& `- ~

" n) D8 r, }9 T; X- u
STM32CubeIDE默认生成的文件
: O$ S# a, n- _; C# v' z

2 L$ a' n" {, [6 L( `- d
* ?# K. k/ d8 v" T; z这里简单介绍下这三个文件:
  J$ J5 K1 x6 D0 o/ T9 r
/ f- _# e1 P5 z9 v.cproject : 该文件是CDT插件的工程描述,CDT是Eclipse 的 C/C++ 开发工具。: b7 l. u5 Z9 K
9 u, j/ y0 r" q6 A" M' V
.project:    该文件是Eclipse的工程描述,毕竟STM32CubeIDE就是基于Eclipse的。+ ?' y/ x. {& Y. ]; u$ F  `
1 a" b  u# G. T7 J
STM32F103C8TX_FLASH.ld  :该文件定义了程序入口地址,定义Flash、RAM中代码和数据的存放位置,将来搞Bootloader的时候就可以在这文件里面修改代码存放的起始地址。
5 U& z/ H( t( X- h6 o
5 K4 z  U! k- Z' C9 [
I`V)S98ZS_$KWFM(~TWT_GR.png
2 H+ _/ w$ U* ?+ x7 ^& Y% ^9 R- t
/ x- E5 ?: ?9 e
拷贝文件到文件夹

: R+ v& d% G  \+ ~( I2 r0 I: g  l+ A. c2 _2 ^
        然后删除STM32CubeIDE中刚刚创建的工程,因为STM32CubeIDE只能存在一个相同名称的工程。在工程名上右键然后Delete,软件会提示是否删除硬盘上的数据,这里我们先不删除。% J( V' b- G8 g) n/ I; Y8 {
+ c# ^- k( R3 |
T027`8H%TGTW(@$GRR}6PMT.png

5 c* {, {3 f* h; A9 |1 \+ I- q3 y$ @2 g
删除工程
- B9 J; z! g1 g: o$ D  [$ H7 s
, |! _2 ^$ `2 L$ D

" `0 w) b# [, f/ W        进入我们在STM32CubeMX下创建的文件夹,点击.project,稍微等待一下就可以看到STM32CubeIDE已经导入了该工程。
/ a* W2 V  f' m
4 X: H7 H: A, J+ _1 g% e
S46$GH6(T@P7OI1T3Y45CHN.png
4 y- X9 A! s- M" j% R

9 H  ~5 ?( j5 G3 W; S
导入工程
) o! e' c  U4 a, r$ N, r
        STM32CubeIDE默认会加载和工程文件同一路径下的所有文件,这时候工程里面全是空的,我们只能看见刚刚三个文件中的STM32F103C8TX_FLASH.Id文件,我们需要做一些操作。9 y& ]  {2 b1 `( d+ x1 D

/ ]6 `+ T, F7 M6 L. G  U
J4N[77]P9GFMSI0FA88[G51.png

/ ]% M* o5 l0 H6 y$ Y' G; }6 A4 S
空工程

& e. `9 a4 M& `1 y' s/ x( P" F* C' p6 e6 T- q
) G0 A3 l' n$ I
         像Keil一样,我们先将工程文件引入进来,如图所示,先选中工程,然后打开工程属性。2 ^, }: m4 D- p3 P" a: _. b
! K  `* x+ N, W; f6 N
4PORY)@%5RH[@6XRM4%2`EX.png

6 C1 p  p- ]9 [' o) n1 r& g1 r- n% H
打开工程属性

6 A4 G- s1 Z% I+ Y# }& Q
) L+ j9 y% D3 [2 H: t2 N/ Z$ a7 t5 [& ~! f7 `' B6 Q
        依次按下图所示步骤,将Core文件夹和Drivers文件夹链接到工程中,这两个文件夹存放了STM32的相关代码,而MDK-ARM主要存放了Keil5的相关工程文件,我们不链接。需要注意的是,链接路径里不能再次包含工程文件,如果这里我们直接链接这个目录的上层文件夹目录的话,将不能链接。3 }$ d5 t# f/ ^2 U

: W$ v4 e* x* S) v
@2)JR(2@}FYZR8C$S_(I5.png

- n% X! O4 s( ]4 x$ }% F/ {: k: _* P' Z" {  r6 g9 U- k7 S
引入文件

8 k3 k. P- S/ {# l& K        链接信息确认退出后就能在右侧看到引入的工程文件吗,而且外链的文件夹下面有个小箭头区分。4 J4 f7 L  I  ?( O' _( [. W! w
4 P5 t9 b2 d8 P
0XSZEA_]~9E1831BOK)13TR.png

4 ?% X% R/ Z4 p
# L  ~7 v9 j1 s/ Y
添加文件到工程目录

2 w, N1 ^; E9 M' x7 D$ }
3 {/ y0 p% n- X+ X, J2 P& N  @* U. r+ A4 h  |6 y) E3 v
        在Keil中,我们需要设置头文件包含路径,在STM32CubeIDE中也一样,注意这张图里已有的是上一个工程自带的,我们把全部删除后再添加。
+ X* G  Z) v0 F6 y2 q- f% z9 @9 N7 |: j# V) i" q0 c, F& m/ r1 S) i  S
%4N[(O9GS)PF8)KT{8K(W}4.png

+ X& x8 K) ~7 N" _# b
: [/ n* g  h& S9 E6 ^1 C' k5 `
添加包含路径

9 M" X. f, ?% \* t9 C+ B9 ]* m# D0 s" O1 @2 P4 j

, u, j0 N7 y6 E) {3 [) ^        添加完成后如下图所示,主要为HAL库的头文件、ARM内核的头文件。5 ?  G# V5 A5 P" D% h0 b
3 H7 b+ R' q# g- @& @! h
@H`V2L@ZMIU~8`4QX(C$(A7.png

! J% ^+ a. |% O! S" c/ l( \0 Y  J5 ~7 J. E5 _
头文件路径
5 {3 \* p! ]. n3 K, u9 U) \6 x
" T* N( z& H! ?: K3 f% ]7 D% ~

' a/ J' T1 @+ u# ^        添加预处理符号,在Keil5中也有该设置,声明一些全局的宏定义,主要是给HAL库使用,这里创建工程的时候已经包含了所需要的USE_HAL_DRIVER和STM32F103xB两个关键预处理,如果还有别的预处理,在此处新增即可。1 \' T5 k! C$ e

: j  k' w7 k8 [7 R+ Y9 Q1 D
E(X3}HN71FN2$%5~Y@U8PYE.png

, e3 y5 y2 @8 W0 J1 _% w2 B" P3 k! p5 M& W
5 T/ P8 i: ~/ E! y) |$ E9 G
预处理符号

' ?' t" Q# N* m6 m$ G! w' B! z! C3 K
, T! f. T) q) ^( c2 v
        此时可以尝试编译一下,毫不意外,会有很多报错,由于STM32CubeIDE的特性,会将文件夹下所有的文件引入进来,而有一些不是我们需要的,这些不需要的文件都进行了编译,当然会报很多错误,我们可以通过删除不需要的文件或者排除文件在工程外两种方式,去掉不需要的文件。
( a. t0 B" K0 ~) e' U! l/ I* Z, m; q) e( u
        第一种是删除,例如下图这些文件,都是STM32CubeMX多余生成的,此处无用,直接右键删除。此处删除将会直接删除硬盘上的文件,谨记。4 O4 F9 f8 }7 u  R

% s7 W" @; U' Z7 O! k
QK6JV~FV841NN5IC5_WP3TX.png

, \' M4 I5 o) C3 h  T- c$ @$ \- v, o# y
删除不需要的文件

% @  h/ s5 m4 }8 y1 Z
; D3 h8 u7 C$ ^; o" i; ~  O) S7 k7 h6 d
- U5 G* K2 t: z        而对于一些其他文件,例如下图中STM32CubeMX生成的不同编译器下的汇编启动文件,如果我们要实现Keil5和STM32CubeIDE都可以编译的话,则不能删除,我们可以将不需要的文件排除在工程外。如下图所示,对着文件夹或者文件右键。6 I2 o; \" o( f; S2 P/ L$ g7 p
- l% |; s, I) `  n- A$ q: b
1X[4G7}`U8A}GLRJ)U2`4S0.png
  N- l* |7 X. k3 C

/ R, e4 h7 A8 R2 @
排除文件夹

7 j8 @' w" y( q& T3 y$ S) l0 k6 _/ V: ~9 n% U5 D2 m
1 {% r% F7 W9 l$ M" X3 }; ~
        然后在弹出的窗口全选,也可以用该方法来切换不同配置下工程编译包含文件,此处的Debug和Release就是两个不同的配置。
" r$ `7 U/ c; M+ D% q& Z7 e4 u
9 c6 I- v4 `, p  ^& c5 N0 p5 [+ ~
{TH`}RR2](L1@QC07D%X8PT.png
0 n2 k2 J; M* n: Z+ G/ C+ }. @$ K
" s& G. P6 y0 B' L
排除文件夹选项
& }- Q/ P0 N$ q7 W5 k" n
' u2 g/ F% @* U1 X6 Q

$ T& U4 P5 W  R- R        注意到这时候被排除的文件就会有特别的标志显示。
) g% m& D) @' Q- O
( F1 g: O7 w& F/ x+ w
~6V)0DQ[NITU@XKKVE1``]C.png

" ]+ u0 \0 Z# X; E4 p5 Y0 L. B$ O+ z+ {
排除的文件夹
: t8 T" g1 T$ T) K
, _2 p2 h8 j1 t

# z$ H7 r, J2 P; |6 C$ j$ a        为了便于说明,对比删除和排除后目录差异。,Core文件夹下删除了system_stm32f1xx.c,该文件在Drivers文件夹下也有一份,两者只能存在一份,否则编译器会报错,也可以保留Core文件夹下的,看个人习惯。
% `( b2 x- b# v' e) A/ L8 v8 R; v5 P/ C+ O% U/ f
X1L955JB{4QB57PVS()39]L.png

5 S5 q: G: d# J5 {2 k
0 t9 r" D! [- b8 U' l; W
Core文件夹对比

+ _" i, c! |( W1 y5 `
, Z* P$ G  g, r% v+ @3 t3 N" t" i+ T4 d( L- J
        Drivers下第一级目录,没使用到的全部删除。
* x8 @6 W  n3 l% W; M' i4 Q0 H1 Y/ o1 q0 U( P7 m9 t
D_RA2IDV@QBUWP5BK4E2S[F.png

7 d' q4 B; C( F6 c
( H# e; o; q8 A+ M- H
Drivers文件夹对比

, B8 E0 m5 ]: D/ n5 X# j' `
% N' e: ^, q& F3 ]1 v; r5 J% P6 r0 R% v0 h1 U
        CMSIS文件夹下,删除了Core文件夹下的Template,删除了其他系列芯片的启动文件和.h文件。而Keil使用的汇编文件存放路径arm,IAR使用的汇编文件存放路径iar,则将其排除。9 s; o% ~$ K8 @& s

0 C- V' u: \* V% P/ Z* \
E[5RZZ0MBEZ2M(1])VZ_7_A.png

7 ]+ N% y. q, a
7 [2 j* z. G- G8 Y! d
CMSIS文件夹对比

* d% I# {( f% |/ H3 F2 k2 f) N
9 k7 @* D7 t; Y6 N; r/ j8 j0 {' O
        STM32F1xx_HAL_Driver文件夹,Inc文件不用动,因为都是.h文件,Src文件夹下除了使用下图所示使用到的HAL文件,其他全部排除。
# G2 f) u/ t8 H) n5 N
0 F" w6 p; K2 `
}~YY~Z6Z[R_F65RU071Q13U.png
; G: K* K& ?7 ?/ I

0 H0 u6 k1 R9 a, j5 ~5 @8 G$ S
HAL Driver文件夹

$ e, B; j; c- |/ T4 F4 U5 A; `8 \* }* f' C4 E

# B$ U: @1 I, n  e; p$ L        经过以上步骤,此时再尝试编译,编译通过,生成了Debug文件夹,参照上一章内容,此时下载就可以运行。
2 i0 ^( L" i  W+ F7 R1 h; k* d- R, L
BWTOV(`)SVF2DW0~U35_}W4.png
6 ]3 m) v3 |3 {5 _4 B
3 N3 o" E0 F* l. T
STM32CubeIDE编译通过
( U' W( f) D) S( W

. z' Z' |& b" b) z9 D  ^( \: e6 j) _1 j" B6 ?/ z
        此时切回到Keil尝试编译,编译器报错找不到Core文件夹下的system_stm32f1xx.c文件,因为前面已经把他删除了,重新将Drivers文件下的system_stm32f1xx.c文件引入,此时Keil也能编译通过。
. ]/ c1 Z0 N% i) s
7 R8 t8 L% c/ I, G& {
Q~I4GG({CFUKFJX2BP`5~2P.png
5 d; x$ i! ^& |1 D9 c

, |8 `& p% M! ^' U9 Y
Keil编译

8 u% V! z4 C9 F  i. e( M) U9 q; R* [; ]

! D3 }& ]4 I& H& }  s        如果需要调整优化等级,则可以再下图所示位置调整。
' f. q2 y' c( e, ]/ q
1 k: k* c$ I( Q% V9 j
WSF@(%LYTF21TEC}ZRV7POD.png
, P2 x' ~( r* d5 w2 I
! a- B7 v, m' i9 D# a
调整优化等级
- |5 r0 y6 }7 n+ s
8 w1 U" j# p/ @
- L( Z) b  l( V+ z# Y
        除了以上内容以外,我们还需要将工程内所有路径设置成相对路径,这样才可以像Keil那样,随意将代码放到任何位置都能编译,按下图所示步骤,将路径从绝对路径转换为相对路径。3 @+ c! b" w+ e. x

8 N* i/ J6 c+ I2 g1 E: R
(LQYD3L6@%}5B`RH(WO_P.png

6 ]# j: R: V  e+ T
5 B- N+ ~) P5 J2 Q2 i
Linked Resources设置为相对路径
5 y7 k8 R  C0 |6 q8 D

7 d6 G( G' j+ ]) L' f4 q
- {- d3 d1 X! [# X        前文提到的Id文件,此时已经是相对路径,如果不是的话也需要修改为相对路径。
4 [  F5 K+ x! }
3 S7 v) C( g/ e
{]W[95T3]KZ~A}RDZY`%(QC.png

  j% O2 a( c* s) t$ h3 A/ R
7 |) g& j- [) W( v% G
Id文件路径
* J: V0 C# {, v$ E' P
, o; X+ z) |, Q+ N/ F/ d. ~/ A- X3 W

) F* f6 W. X/ `2 w! q0 Z9 w        查看工程文件夹内,除了最开始拷贝过来的这三个文件,其余都是编译过程中产生的文件,提交代码或者拷贝到别处时都可以删除。
7 }' c/ v; a: l7 x* m" k
7 U3 i% P3 z5 U- m" j4 F        额外需要注意的是,STM32CubeIDE只能存在一个相同名称的工程,所有拷贝到别处时还需要删除已有工程,只删除工程但是不删除硬盘数据,然后在别的路径下打开就可以自动导入。
% A5 u6 J; J  g* V, c0 S  v$ T: G' L
        针对一个相同名称的工程问题,工程取名时最好也有些讲究。
# b: q. I9 u- m3 ~
7 A* |  B* w- R- f/ o! D% Q
[Z`XCM(304V`$GI_]Q5~3%V.png

" j6 I& c( ^4 A0 I* Y% G5 \  ~* f1 A$ L+ z. f
编译后文件夹内容
8 y6 T9 ?: r2 L; E  E6 I

* F4 g+ Z- _7 V6 g( |
% G+ P' z$ O& W        这样,通过外链文件夹、排除文件和设置相对路径,就可以不改变原有工程目录的情况下,将已有工程迁移到STM32CubeIDE中。 " H! D' X0 w6 M7 O3 l
+ L' [5 P& Z( w% A; i% d
9 ?3 y5 y+ n, A" q
赞 收藏 评论0 发布时间:2022-5-19 11:20

举报

0个回答

所属标签

相似技术帖

官网相关资源

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