STM32学习日记2.固件函数库

STM32F10x固件函数库被压缩在一个zip文件中。解压该文件会产生一个文件夹：STM32F10xFWLib\FWLib，下有3个子文件。

1.文件夹Examplcs:对每一个STM32外设都包含有一个子文件夹，这些文件夹包含整套文件组成典型的例子，用来示范如何使用对应的外设。

readme.txt:每一个例子的简单描述和使用说明。

stm32f10x_conf.h:设置所有使用到外设，由不同的“DEFINE”语句组成。

stm32f10x_it.c:包含所有的中断处理程序，如果未使用中断，则所有的函数体都为空。

stm32f10x.it.h:包含所有的中断处理程序的原形。

main.c:例程代码。

2.文件夹Library：包含组成固件函数库核心的所有子文件夹和文件。

，2个子文件夹。

Inc文件夹：包含了固件函数库所需的头文件，无需修改该文件夹。

stm32f10x_type.h:所有其他文件使用的通用数据类型和枚举。

stm32f10x_map.h:外设存储器映像和寄存器数据结构。

stm32f10x_lib.h:主头文件夹，包含了其他头文件。

stm32f10x_ppp.h:每一个外设对应一个头文件，包含了该外设使用的函数原形，数据结构和枚举。

stm32f10x_macro.h:头文件crtcxm3_macro.s对应的头文件。

src文件夹包含固件函数库所需的源文件，无需修改该文件夹

stm32f10x_ppp.c:每一个外设对应一个源文件，包含该外设使用的函数体。

stm32f10x_lib.c:初始化所有外设的指针。

3.Project包含一个标准的程序项目模板，包括库文件的编译和所有用户可修改的文件，可用以建立新的工程。

stm32f10x_conf.h:项目配置头文件，默认为设置了所有的外设。

stm32f10x_it.c:该源文件包含了只有的中断处理程序，所有函数体默认为空。

stm32f10x_it.h:该头文件包含了所有的中断处理程序的原形。

main.c:主函数体。

固件函数库文件描述

stm32f10x_conf.h:参数设置文件，用户必须在运行自己的程序之前修改该文件，可以利用模板使能或者失能外设，也可以修改外部晶振的参数，也可以用该文件在编译前使能Debug或者rclcasc模式。

main.c:主函数体示例

stm32f10x_it.h:头文件，包含所有中断处理函数原形。

stm32f10x_it.c:外设中断函数文件，用户可以加入自己的中断代码。

stm32f10x_lib.h:包含了所有外设的头文件的头文件。

stm32f10x_lib.c:Dcbug模式初始化文件。

stm32f10x_map.h:包含存储器映像和所有寄存器物理地址的声明，既可以用于Dcbug模式也可以用于rclcasc模式。

stm32f10x_type.h:通用声明文件。

stm32f10x_ppp.c:由C语言编写的外设PPP的驱动源程序文件。

stm32f10x_ppp.h:外设PPP的头文件。

cortcxm3_macro.h:文件cortcxm3_macro.s的头文件

cortcxm3_macro.s:Cortex M3内核特殊指令的指令包装。

外设初始化和设置：

1.在主应用文件中，声明一个结构体PPP_InitTypeDcf.

2.为变量PPP_InitStructurc的各个结构体成员填入允许的值.

3.调用函数PPP_Init(……)来初始化外设PPP.

4.外设已被初始化，调用PPP_Cmd(……)来使能.

位段：

Cortcx M3 存储器映像包括两个位段区，这两个位段将别名存储器区中的每一个字映射到位段存储器区的一个位，在别名存储区写入一个字具有对位段区的目标执行读写改操作的相同效果。

映射公式

bit_word_offsct是目标位在存取器位段中的位置。

bit_word_addr是别名存储器区中字的地址，它映射到某个目标位。

bit_band_basc是别名区的起始地址。

bit_offsct是包含目标位的字节在位段里的序号。

bit_number是目标所在位置。

函数描述格式

函数名 外设函数的名称

函数原形 原形声明

功能描述 简要解释函数是如何执行的

输入参数{x} 输入参数描述

输出参数{x} 输出参数描述

返回值 函数的返回值

先决条件 调用函数前应满足的要求

被调用函数 其他被该函数调用的库函数