本文以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内核及其设备文件
system_stm32f10x.c:微控制器专用系统文件
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
至此,文件添加完毕了,下面我们来解释一下,具体这些文件的作用
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
至此,我们的模板工程就建立完毕!
本人新手一枚,文章中可能存在一些错误,如有发现请及时指出,我们共同讨论进步!