使用Keil MDK以及标准外设库创建STM32工程

1.1使用Keil MDK以及标准外设库创建STM32工程

通过上一节对标准外设库的介绍，想必各位读者对标准外设库已经有了基本的认识，然而由于标准外设库中文件众多，很多初学者在开始很长一段时间内甚至都无法完全自己建立一个工程，很多人只是依赖标准外设库或给定的工程模板。本节就介绍怎样利用Keil MDK开发环境和标准外设库来搭建自己的工程。

建立一个基于标准外设库其实并不复杂，网络上也有很多关于怎样在Keil MDK下建立工程的教程，方法也各异，本节所介绍的方法本着少改动、便于使用、方便更换器件等原则，给大家介绍怎样在Keil中创建一个工程，并以一个最简单的例子来说明怎样下载和调试程序。

本节所使用Keil MDK为目前的最新版V4.21，具体版本信息如图5?6所示。其他版本差别不大，读者可以根据自己使用的版本进行操作或者从Keil的官网下载新版本。使用的标准外设库为目前最新的V3.5版本。使用的开发调试工具为JLINK-V8，使用的驱动版本为V4.08l。

图5?6MDK详细版本信息

首先先建立一个用于存放工程的文件夹，此处命名为STM32，在文件夹下分别建立LIB、USER、MDK三个文件夹，分别用于存放标准外设库文件、用户程序文件、工程目录。在MDK文件夹下建立List、Obj两个文件夹，分别用于存放在编译过程中产生的临时文件和输出文件。

接下来拷贝标准外设库和相应的文件到工程目录中，首先拷贝STM32F10x_StdPeriph_Lib_V3.5.0Libraries文件夹下的两个文件夹CMSIS和STM32F10x_StdPeriph_Driver到刚刚新建的STM32LIB目录下，接下来拷贝用户编写程序的程序文件，此文件可以从标准外设库自带的例程中拷贝，这里从STM32F10x_StdPeriph_Lib_V3.5.0ProjectSTM32F10x_StdPeriph_ExamplesADC3ADCs_DMA目录下拷贝main.c、stm32f10x_conf.h、stm32f10x_it.c、stm32f10x_it.h四个文件，这四个文件是在编程的时候用户往往需要根据实际需求进行修改的。因此拷贝至STM32USER目录下，system_stm32f10x.c文件定义了系统时钟等参数并完成微控制器的初始化，标准外设库中已经有了，这里可以不拷贝。这样所需要的文件都已经具备了，如图5?7所示。

图5?7工程目录文件夹结构

首先启动Keil uVision4，点击菜单栏Project-New uVision Project，选择工程的保存位置，保存位置选择在之前建立的MDK文件夹下，如图5?8所示。

图5?8保存路径的选择

在弹出的界面中选择所使用的芯片信号，笔者使用的芯片型号为STM32F103ZET6，所以选择STM32F103ZE，如图5?9所示。

图5?9选择芯片型号

芯片选择完成后软件会弹出一条提示，提示是否要拷贝STM32大容量启动代码并添加到工程，由于我们使用新版本标准外设库中提供的启动代码，因此此处选择否。如图5?10所示。

图5?10拷贝启动代码选择

接下来就出现了一个空的工程窗口，建立了一个新的工程。

在左侧Project一栏中对Target 1两次点击之后可以重命名，这里命名为STM32，然后右击，如所示，单击Manage Comoonents。出现如所图5?11示界面。

图5?11选择Manage Comoonents

在这个界面里可以更为方便的添加工程的相关文件。也可以在对应的Group上右键Add Group和Add Files to Group只是这种方式更方便集中的添加和管理。按照图5?12所示，建立四个Group，点击Groups一栏右上角图标，依次新建USER、CMSIS、LIB、StartUp四个组，点击对应的组在点击右下方Add Files添加相应的文件到对应的组中。USER组中添加USER文件夹下的文件，CMSIS组中添加STM32 PJSTM32LIBCMSISCM3CoreSupport文件夹下core_cm3.c文件和STM32LIBCMSISCM3DeviceSupportSTSTM32F10x文件夹下system_stm32f10x.c文件。在LIB组下添加STM32LIBSTM32F10x_StdPeriph_Driversrc下的所有文件，这个组的文件也可以根据后面的程序功能添加对应的功能文件。StartUp组下添加STM32LIBCMSISCM3DeviceSupportSTSTM32F10xstartuparm文件夹下startup_stm32f10x_hd.s文件，此文件根据芯片的所属类型来选择，STM32F103ZE为大容量器件所以选择hd结尾的启动文件。至此，已经将对应的文件全部加入工程中。

图5?12编辑组并添加对应文件

文件添加完成后的工程管理窗口如图5?13所示。其中CMSIS和LIB组中的文件图标上由个钥匙图案，表示该文件当前为只读属性，工程编译完成后前面会出现一个加号，点击展开可以显示当前文件所调用的文件。

图5?13工程管理文件列表

接下来需要对工程进行一些参数设置，在中STM32上右击，选择第一项Options for Target ‘STM32’，如图5?14所示。

图5?14选择进行参数设置

弹出窗口如图5?15所示。在这个窗口中共有10个选项卡，第一个选项卡Device用于选择使用的器件，由于在新建工程的时候已经选择这里可以不用在选择，当前的工程如果在后期要更换使用的芯片时可以在这个选项卡中更换芯片，同时还要注意更换对应的启动文件。在Target选项卡中，一般只需要填上使用的晶振频率即可，其他都可以保持默认。

图5?15Target选项设置

在如图5?16所示Output选项卡中主要注意两项，一是选择输出文件夹，选择之前工程目录中MDK文件夹下的Obj文件夹，在下面还有一个Create HEX File选项，用于选择是否生成hex文件，如果编译好的程序要写片，或者要提供给别人下载到芯片中而不希望别人知道源码时可以提供HEX文件。

图5?16Output选项设置

在Listing选项卡下同样可以选择Listing对应的文件夹，这里选择STM32MDKList文件夹，下方的复选框可以选择需要生成的调试信息，这里保持默认即可，如图5?17所示。

图5?17Listing选项设置

C/C++选项卡中的设置比较重要，如图5?18所示，选项卡中主要有两个地方需要注意，首先是整个工程的宏定义，在前面标准外设库部分已经有过介绍，标准外设库中很多功能都是通过宏定义来实现的，由于标准外设库针对STM32一系列芯片，因此需要通过宏定义来进行针对性的选择。这种选择有两种方式，有的人是直接改动宏定义部分的库文件，缺点是需要更改一些功能时不是很方便，而且笔者建议在尽量不更改库文件的方式下实现功能的配置和使用，另一种方式就是在工程的设置中添加宏定义，这儿添加了两个宏定义，USE_STDPERIPH_DRIVER表示使用标准外设库进行程序开发，STM32F10X_HD表示使用的是STM32F10X系列大容量器件，本例中中使用的是STM32F103ZET6故填写此项。

需要说明的是在程序开发过程中不光库文件可以通过宏定义的方式进行程序功能配置，用户程序也可以仿照库文件的这种形式，通过相关的宏定义进行一些参数配置。STM32的标准外设库在程序组织性、层次性、规范性等方面都值得我们去学习的。在“Target”的选项卡中进行的宏定义是这对当前“Target”有效的，在每一个“Group”同样可以设置作用于Group的宏定义。

Language/Code Generation一栏中主要是针对程序语言所所的一些优化和配置，默认情况下保持默认即可。

图5?18C/C++选项设置

接下来一个重要的设置就是设置工程所包含的头文件目录，如图5?19所示，点击Include Paths一栏右侧图标，弹出如所示的对话框。点击对话框右上角图标，添加工程所包括的头文件路径，添加头文件路径的时候要把当前工程目录中包含头文件的路径都添加进去，如所示，添加了以下几个路径：

..USER

..LIBSTM32F10x_StdPeriph_Driverinc

..LIBCMSISCM3CoreSupport

..LIBCMSISCM3DeviceSupportSTSTM32F10x

图5?19添加头文件包含路径

如果有用户自己编写的头文件也要相应的加上引用路径。仔细观察可以发现在标注外设库中头文件的引用为：#include "stm32f10x.h"，在C语言的学习中我们知道双引号表示编译器从用户目录开始搜索，如果未找到才回去系统目录去查找，MDK的安装目录中同样存在对应的库文件，路径为KeilARMINCSTSTM32F10x，但是由于不同的版本所内含的库文件不同，如目前最新的V4.21版本中则内置了V3.4版本的库文件，而之前的版本中很多内置了V2.0版本的库文件，因此为了保持工程所使用的库文件和引用的头文件的一致性，同时也方便工程文件拷贝到其他电脑上运行，建议大家都按照本书介绍的方式都从自己的目录中引用头文件。

头文件引用路径添加完成后，就可以进行相关的编译工作了，在进行这一步工作之前，我们还要完成有关程序调试和下载的相关设置，有关调试的设置在Debug选项卡中，之前的Asm和Linker选项卡保持默认。Debug选项卡如图 5?20所示。在此选项卡中主要完成程序调试的相关设置，选项卡主要分为两个部分，左侧是使用模拟器进行仿真与调试的方式，点选后软件会进入模拟器调试。右侧是使用仿真器连接硬件开发平台进行调试，首先从右侧选择所使用的仿真器，这里使用的是J-Link仿真器，故在下拉框中选择Cortex-M/R J-LINK/J-