STM32学习笔记——新建工程模板步骤（向原子哥学习）

1、  在创建工程之前，先在电脑的某个目录下面建立一个文件夹，我们先把它命名为Template，后面建立的工程可以放在这个文件夹下。在 Template 工程目录下面，新建 3 个文件夹USER ， CORE ， OBJ  以及STM32F10x_FWLib 。代码工程文件都是放在 USER 目，录CORE 用来存放核心文件和启动文件， OBJ 是用来存放编译过程文件以及 hex 文件， STM32F10x_FWLib 文件夹顾名思义用来存放 ST 官方提供的库函数源码文件。已有的 USER 目录除了用来放工程文件外，还用来存放主函数文件main.c,以及其他包括 system_stm32f10x.c等等。

2、  在MDK主界面，点击 Keil 的菜单：Project -> New Uvision Project  ，然后将目录定位到刚才建立的文件夹Template 之下，然后定位到 USER 目录下面，我们的工程文件就都保存到 USER 文件夹下面。工程命名为 Template ，点击保存。

3、  接下来会出现一个选择 Device 的界面，就是选择我们的芯片型号，这里我们定位到

STMicroelectronics 下面的 STM32F103ZE 。弹出对话框“Copy STM32 Startup Code to project ….”，询问是否添加启动代码到我们的工程中，这里我们选择“否”，因为我们使用的 ST 固件库文件已经包含了启动文件。此时，USER 目录下面包含三个文件。

4、  将官方的固件库包里的源码文件复制到我们的工程目录文件夹下面。打开官方固件库包，定位到我们之前准备好的固件库包的目录：

STM32F10x_StdPeriph_Lib_V3.5.0\Libraries\STM32F10x_StdPeriph_Driver 下面，将目录下面的 src,inc 文件夹 copy 到我们刚才建立的 STM32F10x_FWLib 文件夹下面。src 存放的是固件库的.c 文件，inc 存放的是对应的.h 文件。

5、  将固件库包里面相关的启动文件复制到我们的工程目录 CORE 之下。打开官方固件库包，定位到目录：

STM32F10x_StdPeriph_Lib_V3.5.0\Libraries\CMSIS\CM3\CoreSupport 下面，将文件  core_cm3.c和文件 core_cm3.h  复制到 CORE 下 面 去 。 然 后 定 位 到 目 录：

STM32F10x_StdPeriph_Lib_V3.5.0\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x\startup\arm 下面，将里面 startup_stm32f10x_hd.s 文件复制到 CORE 下面。不同容量的芯片使用不同的启动文件，我们的芯片 STM32F103ZET6 是大容量芯片，所以选择这个启动文件。

6、  定位到目录：

STM32F10x_StdPeriph_Lib_V3.5.0\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x 下面将里面的三个文件 stm32f10x.h， system_stm32f10x.c， system_stm32f10x.h，复制到我们的 USER目录之下。然后将

STM32F10x_StdPeriph_Lib_V3.5.0\Project\STM32F10x_StdPeriph_Template 下面的 4 个文件

main.c，stm32f10x_conf.h，stm32f10x_it.c，stm32f10x_it.h 复制到 USER 目录下面。

7、  前面步骤，我们将需要的固件库相关文件复制到了我们的工程目录下面，下面我们将

这些文件加入我们的工程中去。右键点击Target1，选择 Manage Components 。在

Project Targets 一栏，我们将 Target 名字修改为 Template，然后在 Groups 一栏删掉一个 Source Group1，建立三个Groups：USER，CORE，FWLIB。然后点击 OK。

8、  往Group里面添加我们需要的文件。右键点击点击Tempate，选择选择Manage Components 。然后选择需要添加文件的 Group，这里第一步我们选择 FWLIB ， 然后点击右边的 Add Files, 定 位 到 我 们 刚 才 建 立 的 目 录 STM32F10x_FWLib/src 下面，将里面所有的文件选中(Ctrl+A)，然后点击 Add，然后 Close。可以看到 Files 列表下面包含我们添加的文件。

这里需要说明一下，对于我们写代码，如果我们只用到了其中的某个外设，我们就可以不用添加没有用到的外设的库文件。例如我只用 GPIO，我可以只用添加 stm32f10x_gpio.c 而其他的可以不用添加。这里我们全部添加进来是为了后面方便，不用每次添加，当然这样的坏处是工程太大，编译起来速度慢，用户可以自行选择。

9、  将 Groups 定位到 CORE 和 USER 下面，添加需要的文件。这里我们的 CORE 下面需要添加的文件为 core_cm3.c， startup_stm32f10x_hd.s， USER 目录下面需要添加的文件为 main.c，stm32f10x_it.c，system_stm32f10x.c 。这样我们需要添加的文件已经添加到我们的工程中去了，最后点击 OK，回到工程主界面。

10、接下来我们要编译工程，在编译之前我们首先要选择编译中间文件编译后存放目录。方法是点击魔术棒，然后选择“Output”选项下面的“Select folder for objects…”,然后选择目录为我们上面新建的 OBJ 目录。下面我们点击编译按钮编译工程，可以看到很多报错，因为找不到库文件。

11、下面我们要告诉 MDK，在哪些路径之下搜索需要的头文件，也就是头文件目录。回到工程主菜单，点击魔术棒 ，出来一个菜单，然后点击  c/c++选项.然后点击 Include Paths右边的按钮。弹出一个添加 path 的对话框，然后我们将图上面的 3 个目录添加进去。记住，keil 只会在一级目录查找，所以如果你的目录下面还有子目录，记得 path 一定要定位到最后一级子目录。然后点击 OK。

12、接下来，我们再来编译工程，可以看到又报了很多同样的错误。为什么呢??

因为 3.5 版本的库函数在配置和选择外设的时候通过宏定义来选择的，所以我们需要配置一个全局的宏定义变量。定位到 c/c++界面，然后填写“STM32F10X_HD,USE_STDPERIPH_DRIVER”到  Define 输入框里面。这里解释一下，如果你用的是中容量那么 STM32F10X_HD 修改为 STM32F10X_MD，小容量修改为 STM32F10X_LD.  然后点击 OK。

13、这次在编译之前，我们记得打开工程 USER 下面的 main.c，复制下面代码到 main.c 覆盖已有代码，然后进行编译。（记得在代码的最后面加上一个回车，否则会有警告）,可以看到，这次编译已经成功了。

14、这样一个工程模版建立完毕。下面还需要配置，让编译之后能够生成 hex 文件。同样点击魔术棒，进入配置菜单，选择 Output。然后勾上下三个选项。其中 Create HEX file 是编译生成 hex 文件，Browser Information 是可以查看变量和函数定义。还有就是我们要选择生产的 hex 文件和项目中间文件放在哪个目录，点击“Select folder for Objects…”定位目录，我们的选择定位到上面建立的 OBJ 目录下面。

15、重新编译代码，可以看到生成了 hex 文件在 OBJ 目录下面，这个文件我们用 mcuisp 下载到 mcu 即可。

到这里，一个基于固件库 V3.5 的工程模板就建立了。

16、实际上经过前面 21 个步骤，我们的工程模板已经建立完成。但是在我们 ALIENTEK 提供的实验中，每个实验都有一个 SYSTEM 文件夹，下面有 3 个子目录分别为 sys，usart，delay，存放的是我们每个实验都要使用到的共用代码，该代码是由我们 ALIENTEK 编写，该代码的原理在我们第五章会有详细的讲解，我们这里只是引入到工程中，方便后面的实验建立工程。

首先，找到我们实验光盘，打开任何一个固件库的实验，可以看到下面有一个 SYSTEM 文件夹，可以看到有一个 SYSTEM 文件夹，进入 SYSTEM 文件夹，里面有三个子文件夹分别为delay，sys，usart，每个子文件夹下面都有相应的.c 文件和.h 文件。我们接下来要将这三个目录下面的代码加入到我们工程中去。在工程中新建一个组，命名为 SYSTEM，然后加入这三个文件夹下面的.c 文件分别为 sys.c，delay.c，usart.c 。然后点击“OK”之后可以看到工程中多了一个 SYSTEM 组，下面有 3 个.c 文件。

接下来我们将对应的三个目录（sys,usart,delay）加入到 PATH 中去，因为每个目录下面都有相应的.h 头文件。最后点击 OK。

这样我们的工程模板就彻底完成了。