4.1   初学者重要提示
, x# ]4 L# n! C2 p5 P7 E- K KEIL官方有一个专门的MDK上手文档mdk5-getting-started，在MDK的安装目录里面。
MDK5的工程创建过程还是比较重要的，务必实际上手操作一遍。
; C  {7 D9 \: _% A; |5 {' Y
4.2   第1步，创建工程文件夹
# e+ ?  ?/ X0 j4 ?/ |; {4 l; a创建一个文件夹，里面包含如下文件（直接将跑马灯例子的Project文件里面内容全部删除，然后整个工程复制进来即可）。

3 V, {; {5 s  R

Doc文件夹
用于记录例程的修改记录和例子简介。

Libraries文件夹
7 R" n7 N& \9 ?4 e7 C在第一章详细介绍从官网的下载方法。
7 [/ K. t4 [  D8 I+ b
4 t: W0 j2 M, P& B2 g. Q" p Project文件夹
这个是本章的重点，在这个文件夹里面再建立两个文件夹，MDK-ARM(uV5)文件夹里面用于存放MDK工程，EWARMv8文件夹用于存放IAR工程，方便以后创建IAR的工程。

User文件夹
这个是要用户提供的，开发板已经都提供好，bsp文件夹里面是开发板各个外设的驱动，segger文件夹是硬件异常分析代码。

3 P! T, e. d9 k" x' }: J/ T 删除目标文件.bat
9 Q2 x3 t) M6 A" s0 [这个是批处理文件，用于删除MDK和IAR工程编译后生成的obj和list临时文件。
2 d- j* y: n3 F
4 n% Q- U" M9 x/ y8 V4.3   第2步，创建新工程
打开MDK，选择Project ->New uVision Project：

工程名设置为project：

- u' t6 I$ s; ^1 R

选择器件：STM32H743XIHx
* p: V: K' p- T) H4 G
1 E  d' P8 L1 z, I

  l* ?/ @6 S/ B, @5 |, j点击OK后弹出如下界面，点击Cancel取消，当前我们还不使用RTE环境创建，
8 W1 ?+ H2 G1 \( b8 ^* ?

$ M+ Y& g  f9 Y# P: K
9 p! z" @$ Q, r4.4   第3步，设置工程名和工程分组名
默认新建的工程是下面这样的：

打开Manage Project Items，双击Targer1修改名字为Flash，或者任何其它方便自己管理的名称，设置完毕后点击OK。

' Z2 I. O  Z" N/ S9 [6 R

3 s' H! l$ @' X$ D0 E5 D2 U' B' G
& ]+ R2 O- W9 `$ |可以看到已经修改为Flash：
; _0 T# O( W; C+ q% X

' N! e& y+ l* X" o! D) j再次打开Manage Project Items，添加如下分组内容：
5 B0 ~' `* `& x

3 z* m0 o" z" h- |  A
可以看到左侧工程列表已经更新：
8 Z2 C8 n7 G, |. m; F
$ r  B9 b* R5 q/ n. S

3 ]. [8 i; Z) [5 X+ y& l" h
4.5   第4步，添加工程文件
$ _! ~# v, I7 v6 c  ^1 Z/ C添加方法跟第2步，第3步一样，可以通过Manage Project Items添加：
% [% N% Q* o- G" s* l) b+ V9 z
5 [& H) h1 V# N4 o5 f9 I( t

6 p+ Z' _  o1 @6 C% D, l
也可以直接双击工程列表里面的分组添加（注意文件类型里面推荐设置为ALL files所有文件）：
- s) x- i& s8 V7 [) B, \

3 ]2 x# j( y3 c4 K
5 N2 {# O0 R6 O% n) X5 f& X 添加User分组需要的文件
1 s3 \; Z! g$ U% M1 U1 X
1 N( N* z1 v! f. `- B

main.c文件位于文件夹User，实现了一个简单的跑马灯效果。
4 e3 }4 i5 ?; j
添加BSP分组需要的内容

* ]% I" O) K5 m& }/ t

4 Z" n+ c" A5 e% P
bsp.c 位于路径\User\bsp，主要用于MPU、Cache、时钟和外设初始化。
+ ]  B9 Y0 d# t5 `0 B; I
5 U+ r4 ^8 `+ B6 [1 {# Ibsp.h位于路径\User\bsp，此文件是各种头文件的集中汇总贴，方便管理。
; J$ f6 ~& o" M/ V% ]
bsp_led.c位于路径\User\bsp\src，用于LED驱动。
4 Q& a8 f7 S  C( y! @( q. Y
bsp_key.c位于路径\User\bsp\src，用于按键驱动。
% @1 K9 P: Z' b9 `$ C
bsp_timer.c位于路径\User\bsp\src，用于软件定时器组和微妙级单次延迟。

) `- G  X! g& L+ k0 x$ @  Q/ Z. s4 W# obsp_fmc_io.c位于路径\User\bsp\src，用于IO扩展，这里LED要用到。
! L; S. \: u3 U
7 k$ |8 W0 o* C2 u. qbsp_uart_fifo.c位于路径\User\bsp\src，用于8串口FIFO驱动。
) X7 k* Z' w0 j9 l
stm32h7xx_it.c位于路径User\bsp，用于部分系统中断服务程序。
# e1 Q2 b' U3 n$ ]7 j
, n: f  m4 l: i! w) k& @. k, u添加MDK-ARM分组需要的内容

) N; \: R: z( }1 ^
startup_stm32h743xx.s 位于路径\Libraries\CMSIS\Device\ST\STM32H7xx\Source\Templates\arm，主要用于堆和栈空间设置，中断向量表也在这个文件。

' u# m2 g( [4 U  \/ b0 P添加HAL_Driver分组需要的内容

7 Z2 g" `- K. G
stm32h7xx_hal_conf.h位于路径\User\bsp，主要用于HAL库的配置。
, w. J; @8 Y+ c. K$ ]5 G! H
       其它文件路径：\Libraries\STM32H7xx_HAL_Driver\Src，用到什么外设添加什么驱动文件即可，有些外设驱动跟DMA也有关联，直接添加进来即可。
! I! q8 L% Y% |" j" V4 o# O
添加CMSIS分组需要的内容
6 Q- s$ V( y" v' k7 M

6 m! f! d  w' e$ R3 V
system_stm32h7xx.c位于路径\Libraries\CMSIS\Device\ST\STM32H7xx\Source\Templates，主要用于复位RCC相关寄存器和中断向量表位置设置。

# o6 G- |% _3 @) l! [; O' E4 Q添加SEGGER/HardFault分组需要的内容
# ?  U( u! Q9 y7 S: K
- N( e3 ~! C8 ~

这两个文件位于路径：\User\segger\HardFaultHandlerMDK，主要用于硬件异常分析。
: u  o; s1 l7 X2 J1 o" z% g" R
添加Doc分组需要的内容

1 L1 V% v+ g5 q2 K0 H6 f
% R5 i5 u9 N( Z8 p这两个文件位于Doc文件夹，主要用于说明例程的功能和更新记录。
. f$ r, Y( m( z4 e- _7 W3 N/ t7 L
) `8 f$ [7 m, R: D2 k4.6   第5步，Target Options配置
2 l8 [6 ]. v" ~4 M# @6 P4 LMDK的配置基本都集中在Target Options对话框里面：

4.6.1      Device选项
, W" Q! r- x- q这个选项不用管，因为我们在创建的时候已经选择了STM32H743XIHx
6 K& S7 q; C! Z: l# K8 {5 ]" P( ]2 d

4.6.2      Target选项
+ a9 U% l3 ?/ k- D
% S" w) ~6 Y( [) e3 h/ H" I7 q

; h% O2 V( K6 k- }: E% }  g( s
' G! G( g# C% Q( H0 i; Q' \$ z2 R因为我们一般不用软件仿真，这个选项不用管，也不推荐大家用MDK提供的软件仿真，问题比较多。
' o! H5 q0 _$ q2 l( _2 D% O8 ?选择编译器，使用默认的AC5即可。当前AC6支持的还不够好，仅MDK自家的软件都支持了，第三方的问题稍多。
" W% s/ \- v$ s* e$ y0 U1 }我们这里使用微库MicroLib，这个库针对嵌入式应用，MicroLIB做了深度优化，比使用C标准库所需的RAM和FLASH空间都大大减小。比如调用：<math.h>，<stdlib.h>，<stdio.h>，<string.h>。
% H: K/ S3 [  N+ C" `

7 X' I; u9 x$ k" ?1 T* }
STM32H7支持双精度浮点，所以这里选择Double Precision双精度浮点。
- j8 v  F! W+ Z9 ^0 a4 D# t  o: `STM32H743XIH的Flash首地址是0x0800 0000，大小0x200000，即2MB。
默认的RAM空间选择DTCM，首地址0x2000 0000，大小0x20000，即128KB。
! B3 c8 R+ S9 l& Z* r地址0x2400 0000，大小0x80000，即512KB是AXI SRAM的空间。
. C7 }, V$ A% H: _+ P2 z8 M- Z" ^" t
( n1 K3 L9 d- E- L6 T4.6.3      Output选项
3 a+ O8 f5 V; K6 V( \8 N

; h: A. ]" o; Y# S- m& Y
4 j$ p/ G& Z, Y- p% K用于存放MDK编译过程中生成的obj临时文件路径，MDK在创建的时候已经帮我们创建好文件夹Objects，这里无需修改，使用默认即可。
! h' Z& \" ~+ G2 z6 W8 ]3 RDebug Information表示调试信息，选上。
7 P4 X& \; T5 w4 N% L9 g9 ~' P( VCreate HEX File表示是否生成hex文件，选上。
Browse Information表示是需要go to def的支持，使用HAL库话，推荐先不要选上，因为MDK5使用AC5编译HAL库时间比较长.

7 I9 Q4 e% H% k, I$ c6 Z6 v3 s

) ?# [7 `* _8 [) r2 P. r4.6.4      Listing选项

2 r0 z5 W, W: i' R+ `用于存放MDK编译过程中生成的list临时文件路径，MDK在创建的时候已经帮我们创建好文件夹Listings，这里无需修改，使用默认即可。
' Y7 k; c0 p: y: y/ S- _/ J- b; \是否生成*.lst文件，选上。
' g/ V! _+ Y; {3 A查看MAP文件要用上，全部选上。
, H- r0 z9 Z4 E7 ^1 e, D7 E' [5 Y, L4.6.5      User选项

. O' v- w% ^5 ?( n5 p2 c
8 T8 k2 }: E: t3 Q  q这个选项基本用不上，可以不用管，主要是用来指定编译之前和编译之后执行的用户程序。对于本教程配套的例子来说在这里添加了一个批处理功能，用来实现Objects文件夹里面的hex文件复制到路径Project\MDK-ARM(uV5)里面，方便查找。

3 Z- q  {* j! M  U! w4 D5 W4.6.6      C/C++选项
) ?( r8 O/ }( F* G& n) z$ g
" s6 m, I6 v+ t$ C

9 X0 f1 E! _6 K0 u* x
预定义宏
USE_HAL_DRIVER 表示使用HAL库。
3 c; U1 c& u- I0 p7 }" a. nSTM32H743xx 表示使用H743系列。

% A% Q4 ?8 R5 _+ D4 {/ Y0 l* ^- `选择0级优化，优化等级低，方便调试。
如何做MDK编译器的代码最小优化和性能最佳优化
选项One ELF Section per Function用于删除工程中没有用到的冗余函数。

9 z; G7 q8 L+ U, x' P7 T使用C99规范，在第9章有介绍。
添加路径，把用到的头文件路径包含进来，点击最右侧的小按钮，弹出如下界面进行添加即可：
2 P! I1 G7 ^- S  d8 t

1 s1 S; [& b5 [, D
3 w, O$ c5 o% W0 m! P, O; o# |4.6.7      Asm选项
/ B0 B1 p5 e9 Y% o) s" |3 M: f
# _' s: Y6 w8 E; Q0 g' t

! H' y9 v% Z  a
1 A2 s' ^7 f4 B  Q* w* {% _1 d这个选项用不到，不用管。
( F) z9 L9 X, S4 H, {5 X
6 N* \/ H: |# j: Q; J4.6.8      Linker选项

这个选项用不到，不用管。
, {9 B  I; t) |
5 u% B$ `* p5 D) D5 n% F0 S4.6.9      Debug选项
) `6 _+ o7 k+ A- M
; n9 X0 f# b8 o

软件仿真不推荐大家用，问题比较多。
硬件仿真，这里选择的STLINK，大家根据自己用的那种调试器选择相应型号即可。

3 k9 |% E/ R2 R. P4 S

具体的调试设置在下一章有详细说明，本章主要是保证创建的工程能够正常编译。

. I4 w, c7 H, z. l4.6.10 Utilities选项
9 l6 Q& U# Q  w  ~, m/ @, F4 w

* L" _. g  K* k
这个选项主要用于编程工具选择，大家根据自己用的那种下载器选择相应型号即可。
2 Y  N! W( G8 n! r% |9 u; U2 U) u" V
Update Target before Debugging表示调试前更新芯片的程序。
; P3 f  H+ H% k) e8 Z
4.7   第6步，最后一步验证是否创建成功
7 M" D# S' a) Q% ]点击全编译：

! L9 `! u2 P* s  r7 h7 P+ _

- I. M- O1 i! u' [/ l$ ]
( ]: E2 L+ T( k- \5 M9 f, T  H/ |. h) p编译结果：0错误，0警告，编译成功。
2 V  a; @! Q# q2 l* \0 y
, x, `6 w  L! F9 b8 o; j

  X* k# V6 b# T+ e
9 x$ l, w- |5 z; _$ [4 y* l2 M4.8   MDK的字体，多核并行编译，语法提示等设置
这里将MDK经常用到的设置做个说明。

' L3 O4 H6 ], t" h$ Z2 `" j) c" x4.8.1      Tab Size设置
, l% ?$ y  I( c  ~0 ]( s( ~教程配套例子的Tab size要设置为4，否则代码显示不整齐：
8 W9 V, a) K4 S* l5 S
选择此图标：

& K/ b. e. G6 i3 T: h" t, |2 j7 E

4 o5 ]: x( f6 C. e6 R1 ?, e3 K3 W; Q弹出的窗口里面设置Tab size为4：

- z- k8 W- J, A' c" h
4.8.2      使能多核并行编译
电脑有几个核，都选上，加快编译速度。
# n! A5 h) l' M7 w$ G" S8 y
选择此图标：

% X; |- S7 }. V/ D0 k: w( C( R1 L

$ q  s- K& K% U% M& c; h9 S
我这里是四核：

' A7 `( y  c+ q$ Q0 _& F

4.8.3      字体设置
推荐大家用下微软雅黑，而且可以防止复制粘贴的时候出现乱码问题。
6 R  d: \( I) f1 X安装微软雅黑的时候要注意，电脑端默认自带了一个微软雅黑，安装的时候会出现字体是躺着的。

选择此图标：

& G3 B2 I( A& Z, @. N9 R( x
7 H; Z, T, d5 k5 ^" s选择中文简体：
( {+ _  _7 P+ E" d6 ]
; F0 V* W$ F; M" M' \

- T* `8 F9 W  n3 U' F3 G* p选择安装微软雅黑字体：
0 N! b4 `% N2 t" ^" ]8 e

" c% A4 [% w; l# `! C5 M- z
效果如下：
3 S& J8 G- {: C/ c$ B8 Q

. {# S) v  p' p) \( d* D
4.8.4      语法提示和语法检测功能
  I& q  Y! B! o, X选择此图标：
/ V" n1 ^. J6 X4 t- ~/ O5 l
0 T7 W) y' z3 `: D

; n* z- O, v4 o& b* t- r
  _- j' i2 d4 h& R7 S# m  CMDK的语法提示和语法检测功能还行，大家可以根据需要开启：

+ V- t! _! \, d) H% _, @) n3 D! k0 W9 u

3 J, ^) e* k  R4 O/ N
4.9   总结
+ u. |% q* A/ j& @+ _2 x, u对于初学者来说，务必要实际动手操作一遍，以后移植其它程序代码大有裨益。
. }- \  z5 L4 ~- B! l/ |
1 H0 [' W3 H$ ^* s
9 `, P9 x$ ?. L( A  T* P
+ K2 C. z7 Z# t8 J