ST标准外设库文件解析以及工程建立

第二章ST标准外设库和工程文件的建立在本章我们是基于ST公司 3.5版本的标准外设库来讲解，其它半导体公司的库函数是不一样的，所以不能完全的照搬，不过工程的建立需要哪些文件可以做一个参考。

2.1标准外设库文件介绍首先我们要先介绍一下这个ST公司这个官方的 3.5版本的标准外设库，了解其架构，便于我们以后学习利用。

知道其结构之后，在我们的学习过程中会方便很多。

首先我们要从官网下载其 3.5版本的外设库文件，然后解压。

打开标准外设库文件，如图2-1所示，我们看到四个文件夹，一个网页文件和一个chm文件（后面我们会称之为帮助文件）。

首先我们打开这个网页，我们可以看到是关于ST公司标准外设库各个版本的简单介绍，简单的介绍了不同的版本做了哪些改动，可以大概的浏览一下。

那个帮助文件，我们后边再做详细介绍。

图2-1接下来介绍这四个文件夹，第一个_htmresc文件夹里面是ARM和ST公司的两个logo，对于我们没用。

第二个文件是Libraries，这个文件夹比较重要，我们的外设库和内核的库文件都在这个里面。

打开Libraries，里面有两个文件夹，CMSIS和STM32F10x_StdPeriph_Driver。

CMSIS文件夹中存放的是内核的库文件，CMSIS文件夹中东西比较碎，后面我们要用到的文件后面会介绍。

STM32F10x_StdPeriph_Driver里面存放的是芯片外设的库文件，其中库文件分为源文件和头文件，分别存在src和inc文件夹。

第三个文件夹Project，里面有两个文件夹，STM32F10x_StdPeriph_Examples和STM32F10x_StdPeriph_Template，其中Examples文件夹中是基于STM32F10x各个外设的官方给的例程，当我们用到这些外设时，可以参考这些例程里面的外设的配置。

Template文件夹中是ST公司建的一个工程文件，基于五种开发环境建立的工程模板，我们常用的是MDK 和EWARM。

打开MDK文件夹，里面有一个建好的工程文件。

最后一个文件夹Utilities，里面是基于ST官方出的一些开发板封装成库的一些驱动文件（只针对他官方的开发板可以用）。

所以我们要用到的就是第二个和第三个文件夹，里面有我们需要的一些文件。

2.2 keil工程的建立首先我们在你要放置工程的盘符下面，要建立一个文件夹，文件名可以随便命名，在该文件夹下再创建四个文件夹分别是Libraries，Project，User，Doc。

文件夹名字也是随意的，可自由命名。

首先我们要把3.5版本库文件中的Libraries文件夹下的STM32F10x_StdPeriph_Driver文件夹放到我们建立的Libraries文件夹下。

在我们自己建的Libraries再建一个文件夹CMSIS，同时在CMSIS文件夹下创建Startup文件夹，把以下路径的文件放到CMSIS文件夹下。

STM32F10x_StdPeriph_Lib_V3.5.0\Libraries\CMSIS\CM3\CoreSupport中的两个文件(core_cm3.c和core_cm3.h)。

STM32F10x_StdPeriph_Lib_V3.5.0\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x下的三个文件(system_stm32f10x.c、system_stm32f10x.h、stm32f10x.h)。

把这五个文件放进我们自己创建的CMSIS文件夹下，STM32F10x_StdPeriph_Lib_V3.5.0\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x\ startup\arm把该路径下的所有文件放入我们在CMSIS文件夹下的Startup文件夹下。

接下来是Project文件夹，在该文件夹下创建两个文件夹List和obj，用来存放产生的编译和链接文件。

同时Project文件夹存放的是我们的工程文件。

User文件夹下创建一个Main的文件，Main文件夹用来存放我们的主函数和中断服务程序以及配置文件。

在以后的工程中我们可以把我们自己编写的模块的驱动文件放在User文件夹下面。

我们要把库文件中Project\STM32F10x_StdPeriph_Template路径下的main.c、stm32f10x_conf.h、stm32f10x_it.c、stm32f10x_it.h四个文件放在上面的Main文件夹下。

Doc文件夹下创建一个TXT文档，命名为Readme.txt，用以记录程序的说明和修改。

最后的文件结构如图2-2所示，图2-2前期准备工作已经完成，接下来就开始新建我们的工程文件，打开keil软件，点击project，新建工程。

如图2-3所示图2-3接下来选择工程文件保存的路径，选择我们刚才建立的工程文件夹下的project文件夹。

点击保存，工程名字可以随便写，可根据你要编写的程序的功能来命名你的工程名字，比较方便记忆，在这里我们命名为project。

如图2-4所示图2-4然后是添加对应的芯片型号，我们的开发板使用的是STM32F103ZET6，所以在这里我们选择STM32F103ZE，我们可以看到左边是芯片的型号选择，右边是该芯片的一些信息，包含有什么外设以及内存大小等信息。

如图2-5所示图2-5点击OK之后，会提示你是否添加启动文件，在这里我们选择否，因为后面我们会自己添加。

如图2-6图2-6接下来就要添加各种文件，如图2-7所示，右键点击左侧上边的工程名字然后点击下面列表中的Manage Components选项，或者右上角的图标都可以。

图2-7接下来会弹出如图2-8所示的界面，我们在该界面中添加需要的各种文件。

图2-8我们可以看到在图2-8中，最右边是我们的工程名字，双击工程名，修改为project，中间的大方框是我们的工程的文件夹，为了方便我们文件分类，当我们的文件多了之后，需要建立文件夹进行分类，以便于管理。

可以看到上面的两个小图标，第一个是添加新文件夹，第二个是删除，后面的两个是移动文件夹的位置的。

在这里说明一下，这里我们添加的文件夹的名字和我们之前在电脑上建立的文件夹的名字是没有什么关系的，只不过为了方便记忆等原因，我们可能会采取命名方式差不多，大家根据自己的习惯可以自由命名。

最后一个大的方框是需要添加的文件。

在第二个方框中添加以下文件夹名字CMSIS，StdPeriph_Driver，Main，Doc。

对这四个文件夹做一个说明，第一个CMSIS里面存放的是内核文件，第二个StdPeriph_Driver是STM32的外设驱动库函数，第三个Main是用户文件，第四个Doc是程序的说明文件。

添加之后如图2-9所示图2-9首先选定第一个文件夹CMSIS，然后点击第三个方框下的Add Files，添加启动文件和一些内核文件。

选择刚才我们建立的工程文件路径Libraries\CMSIS\startup，如图2-10所示，下边的文件类型要选择All files，才可以显示出里面的文件。

我们可以看到有8个文件，我们只需要其中一个。

Ld是小容量的，flash大小为16-32KMd是中容量的，flash大小为64-128KHd是大容量的，flash大小为256-512KXl是超大容量的，flash大小为1M的Cl指的是互联型的，比如105，107系列等Vl指的是超值型系列的，这个只有STM32F100XX才用的我们用的芯片是STM32F103ZET6，在上面芯片选型的时候，从图2-5里面可以看出Flash大小为512KB，所以在这里我们选择hd，点击Add添加。

图2-10然后返回到上一级文件夹Libraries\CMSIS，添加system_stm32f10x.c和core_m3.c文件，如图2-11所示，双击文件名也可以添加。

图2-11点击close关闭，接下来首先选定图2-9界面中第二个方框中的第二个文件夹StdPeriph_Driver，然后点击Add File按钮，把上面所建立的工程文件夹的Libraries\STM32F10x_StdPeriph_Driver\src路径下的所有文件都添加进去，添加之后如图2-12所示。

这里的文件是STM32外设的驱动库函数，这里我们选择了全部添加。

以后熟练了，可以有选择性的添加，用到什么外设模块只添加对应的外设驱动函数，可以节省编译的时间。

图2-12然后选定第三个文件夹Main，点击Add Files，添加User\Main路径下的源文件(main.c和stm32f10x_it.c)，如图2-13所示。

main.c是我们的所要写的主程序，stm32f10x_it.c文件里面是我们所要用到的中断服务函数。

图2-13最后选定第四个文件夹Doc，点击Add Files，添加Doc文件夹中的Readme.txt文件，主要是描述程序的修改和使用说明。

添加完毕，点击图2-8下方的的OK 按钮，则keil左侧的工程结构如图2-14所示。

图2-14源文件添加完毕之后，我们要添加头文件也就是.h文件。

点击工具栏中的Target Options 按钮，出现设置选项框，在弹出的对话框中选择Output选项卡，如图2-15所示，下面的复选框是选择是否产生hex文件，根据需要生成，没需要的话，可以不用选择。

然后点击上面的按钮，选择编译产生的文件存放的路径，这里我们选择Project\obj路径，然后点击下方的Ok按钮就可以了这里主要是为了让工程文件看起来比较有条理，把编译产生的文件放在一个文件夹中，不至于看起来工程文件比较乱，同时我们上面提到的hex文件也在该文件夹中，用到的时候我们可以在这个文件夹中找。

图2-15然后选择Listing选项卡，如图2-16所示，点击红色方框内的图标选择链接产生的文件存放的路径，这里我们选择Project\List。

图2-16然后选择C/C++的选项卡，如图2-17所示。

第一个方框中是宏定义的选项，在这里宏定义和在程序里面进行宏定义效果是一样的，后面会有用到。

再往下看红色方框是keil对程序的优化级别，一般我们选择不优化，当代码量较大时，可以选择优化，但是优化之后可能会造成程序不能正常运行，所以要慎重选择。

最下面的红色方框就是我们的头文件的路径。

点击最右边的按钮开始添加路径。

图2-17如图2-18所示，点击添加按钮，下面会出现添加路径的输入框，然后点击输入框右边的添加按钮会弹出路径窗口，然后依次添加图中标示的1、2、3三个文件夹路径，因为这三个文件家中存放的有我们要用的头文件。

图2-18添加完成之后，如图2-19所示图2-19点击OK键，添加完成。