STM32官方库文件分析及使用

本文以STM32F10x_StdPeriph_Lib_V3.5.0版本库文件为例

1、解压在官网下载的库文件，文件夹内容详解如下图所示

2、下面逐个文件夹分析一下，首先打开“Libraries”文件夹，“CMSIS”文件夹中

   是一些Cortex-M3内核文件及一些启动文件这里我们先不理会它，一会建立工程

   的时候我们添加他们就可以

  “STM32F10x_StdPeriph_Driver”文件夹中是一些库源码，我们来分析一下其中

    的内容，如下图

3、我们返回到库文件的根目录，在来看一下“Project”文件夹，打开该文件夹，如

   下图

4、我们打开工程模板文件夹“STM32F10x_StdPeriph_Template”，来分析一下在我

   们建立工程的时候都需要做些什么。

文件夹EWARM，HiTOP，RIDE，TrueSTUDIO用于不同开发环境使用，详情查询各文件夹下的文件readme.txt。

上面我们只对库文件做一个简单的介绍，具体的大家可以百度或者参考ST官网的一些说明加上库文件的帮助文件来具体了解一下。

下面我们来利用库文件来建立一个属于我们自己的模板项目

1、首先我们建立一个模板文件夹，在此文件夹中新建3个文件夹，分别为Doc、

   Output、Project，再将库文件中的Libraries文件夹复制到该目录下。

2、在模板文件夹中新建一个文本文档，在文档中输入如下内容，并更改文件名称为

  “删除MDK产生的过程文件.bat”（一定要将扩展名更改为.bat）

   （此部分代码是从神舟开发板文件中摘录过来的，非原创）

del *.bak /s 
::/S 处理当前文件夹及其子文件夹中的匹配文件。 
del *.ddk /s
del *.edk /s
del *.lst /s
del *.lnp /s
del *.mpf /s
del *.mpj /s
del *.obj /s
del *.omf /s
::del *.opt /s  ::不允许删除JLINK的设置
del *.plg /s
del *.rpt /s
del *.tmp /s
del *.__i /s
del *.crf /s
del *.o /s
del *.d /s
::del *.axf /s
::del *.hex /s
::del *.bin /s
del *.tra /s
del *.dep /s           
del JLinkLog.txt /s


del *.iex /s
del *.htm /s
del *.sct /s
del *.map /s
 
exit

3、将库函数STM32F10x_StdPeriph_Lib_V3.5.0\Project\STM32F10x_StdPeriph_Template

   目录下的main.c、stm32f10x_conf.h、stm32f10x_it.c、stm32f10x_it.h这4个文件复制

   到“模板\Project”文件夹中。

4、打开UVision4，在“模板\Project”文件夹下新建一个工程，取名叫Demo。

  （如果是第一次使用的话会打开一个自带的工程文件，我们可以通过工具栏

   Project->Close Project 选项把它关掉）

5、选择芯片类型，这里我们以STM32F103ZET6为例

6、选择好芯片之后，点击OK，系统会弹出提示询问是否添加启动文件，为了保持库

   的完整性，我们就不需要开发环境为我们自带的启动代码了，这里我们点否

7、接下来我们为工程添加必要的文件，在UVision4的项目管理器中，右键单击

   Target 1，选择“管理组件”

8、在组件窗口中，双击最左侧Target 1，更改名称为Demo，在Groups中删除原有

   组，新建User、StdPeriph_Driver、CMSIS、MDK-ARM、Doc这几个组。

9、下面我们向组中添加文件，点击选中User，在最后面一栏Files栏下方点击添加文件，添加文

   件路径如下

模板\Project文件夹下的：main.c、stm32f10x_it.c

main.c：用户主函数

stm32f10x_it.c：中断服务函数

10、点击选中StdPeriph_Driver，点击添加文件，添加文件路径如下

模板\Libraries\STM32F10x_StdPeriph_Driver\src中的所有文件

这些文件是ST标准外设驱动函数

11、点击选中CMSIS，点击添加文件，添加文件路径如下

模板\Libraries\CMSIS\CM3\CoreSupport文件夹中的core_cm3.c

模板\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x文件夹中的system_stm32f10x.c

core_cm3.c：Cortex-M3内核及其设备文件

─ 访问Cortex-M3内核及其设备：NVIC，SysTick等

─ 访问Cortex-M3的CPU寄存器和内核外设的函数

system_stm32f10x.c：微控制器专用系统文件

─ 函数SystemInit，用来初始化微控制器

─ 函数Sysem_ExtMemCtl，用来配置外部存储器控制器。它位于文件 startup_stm32f10x_xx.s /.c，在跳转到main前调用

─SystemFrequncy，该值代表系统时钟频率

12、点击选中MDK-ARM，点击添加文件，添加文件路径如下

模板\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x\startup\arm文件夹中startup_stm32f10x_hd.s

这些文件都是一些系统启动文件

startup_stm32f10x_cl.s 互联型的器件，STM32F105xx，STM32F107xx
startup_stm32f10x_hd.s 大容量的STM32F101xx，STM32F102xx，STM32F103xx
startup_stm32f10x_hd_vl.s 大容量的STM32F100xx
startup_stm32f10x_ld.s 小容量的STM32F101xx，STM32F102xx，STM32F103xx
startup_stm32f10x_ld_vl.s 小容量的STM32F100xx
startup_stm32f10x_md.s 中容量的STM32F101xx，STM32F102xx，STM32F103xx
startup_stm32f10x_md_vl.s 中容量的STM32F100xx
startup_stm32f10x_xl.s FLASH在512K到1024K字节的STM32F101xx，STM32F102xx，STM32F103xx

至此，文件添加完毕了，下面我们来解释一下，具体这些文件的作用

最后我们需要对MDK环境进行一下设置

1、点击MDK环境中的目标选项按钮

2、我们首先选择输出文件的文件夹，我们选择Output文件夹，再填写你要输出的文

   件命名，最后勾选产生exe文件

3、点击C/C++选项卡，在Define 里面输入添加USE_STDPERIPH_DRIVER, 

   STM32F10X_HD。添加USE_STDPERIPH_DRIVER 是为了屏蔽编译器的

   默认搜索路径，转而使用我们添加到工程中的ST的库，添加STM32F10X_HD 

   是因为我们用的芯片是大容量的，添加了STM32F10X_HD 这个宏之后，

   库文件里面为大容量定义的寄存器我们就可以用了。芯片是小或中容

   量的时候宏要换成STM32F10X_LD或者STM32F10X_MD。其实不管是什么

   容量的，我们只要添加上STM32F10X_HD 这个宏即可，当你用小或者中

   容量的芯片时，那些为大容量定义的寄存器我不去访问就是了，反正也

   访问不了。

4、在“包含文件路径”栏点击，在这里添加库文件的搜索路径，这样就可以屏蔽掉

   默认的搜索路径。

添加路径为：

模板\Project

模板\Libraries\CMSIS\CM3\CoreSupport

模板\Libraries\STM32F10x_StdPeriph_Driver\inc

模板\Libraries\CMSIS\CM3\DeviceSupport\ST\STM32F10x

至此，我们的模板工程就建立完毕！

本人新手一枚，文章中可能存在一些错误，如有发现请及时指出，我们共同讨论进步！