STM32外设库文件分析(V3.5)
加入技术交流群
1._htmresc 里面有两个logo,没用，删除。
2.Release_Notes.html 发行版本，可以看到各个版本的发行时间，修改内容。
3.Utilities 里面是一些测试C文件，评估使用。
4.stm32f10x_stdperiph_lib_um.chm 帮助文件。
5.Project 文件夹有个模版和一个例程。以工程模式提供。
6.Libraries 文件夹下面包括两个文件夹：
CMSIS Cortex Microcontroller Software Interface Standard
CM3
CoreSupport：core_cm3.c core_cm3.h
DeviceSupport
ST
STM32F10x：stm32f10x.h，system_stm32f10x.c，system_stm32f10x.h startup
arm：启动文件
Documentation：Cortex Microcontroller Software Interface Standard 发行版本记录
STM32F10x_StdPeriph_Driver
根据需要和开发环境对文件进行了一些精简，精简后的内容：
CMSIS Cortex Microcontroller Software Interface Standard
CoreSupport
Core_cm3.c:
STM32从3.0库开始引入了CMSIS，CMSIS是Cortex微控制器软件接口标准（Cortex MicroController Software Interface Standard）的缩写，
这个是ARM定制的一个用于Cortex-M系列的一个标准，主要是为了提供通用api接口来访问内核和一些片上外设，提高代码的可移植性。
CMSIS有三个层：
核内外设访问层 Core Peripheral Access Layer（CPAL），
中间件访问层 Middleware Access Layer（MWAL），
设备访问层 Device Peripheral Access Layer（DPAL）。
CPAL用于访问内核的寄存器和组件，如NVIC，调试系统等。该层是由ARM实现的。
MWAL用于对中间件的访问，现在该层还未实现。（也不知道所谓的中间层是什么东西）。
DPAL用于定义一些硬件寄存器的地址和一些外设访问函数，由芯片制造商实现。
CPAL层的实现就是Core_cm3.c文件，DPAL层的实现就是system_stm32f10x.c文件（似乎还应该加上外设的函数库）。
接下来就来了解一下Core_cm3.c里面有什么东东：
首先是汇编关键字__ASM和__INLINE的宏定义，支持不同的编译器。由于使用的是Keil，所以就只看第一种，__CC_ARM。
这里面的函数调用都只符合ARM过程调用标准的，如R0到R3用作参数和返回值传递，这也是这里面唯一用到的。
此外，在Keil中使用了__asm关键字后，编译器不会为函数增加返回指令，所以需要自己编写返回命令，也就是每个函数后面的 bx lr。
1. __ASM uint32_t __get_PSP(void)：获取进程堆栈指针PSP。
2. __ASM void __set_PSP(uint32_t topOfProcStack)：设置PSP。
3. __ASM uint32_t __get_MSP(void)：获取主堆栈指针MSP。
4. __ASM void __set_MSP(uint32_t mainStackPointer)：设置MSP。
5. __ASM uint32_t __REV16(uint16_t value)：反转半字中字节顺序，如0xABCD反转后得到0xCDAB。
6. __ASM int32_t __REVSH(int16_t value)：反转字节顺序，并做符号拓展。
就是在__REV16函数得到的结果上再进行一次符号拓展。这两个函数主要是方便进行大小端的切换。
7. __ASM void __CLREX(void)：清除由LDREX指令造成的互斥锁。LDREX和STREX是Cortex用来实现互斥访问，
保护临界资源的指令，LDREX执行后，只有离它最近的一条存储指令（STR，STREX）才能执行，其他的存储指令都会被驳回，
而CLREX就是用于清除互斥访问状态的标记。
8. __ASM uint32_t __get_BASEPRI(void)：获取BASEPRI寄存器的值，
优先级号高于该寄存器的中断都会被屏蔽（优先级号越大，优先级越低），为零时不屏蔽任何中断。
9. __ASM void __set_BASEPRI(uint32_t basePri)：设置BASEPRI的值。
10. __ASM uint32_t __get_PRIMASK(void)：PRIMASK是一个只有一位的寄存器，置位时屏蔽绝大部分的异常中断，
只剩下NMI和HardFault可以响应。
11. __ASM void __set_PRIMASK(uint32_t priMask)：设置PRIMASK的值。
12. __ASM uint32_t __get_FAULTMASK(void)：FAULTMASK也是一个只有一位的寄存器，为1时只有NMI才能响应，
其他异常与中断全部被屏蔽。
13. __ASM void __set_FAULTMASK(uint32_t faultMask)：设置FAULTMASK的值。
14. __ASM uint32_t __get_CONTROL(void)：获取CONTROL的值。寄存器CONTROL只有两位。
CONTROL[0]选择特权级别，0为特权级，1为敌用户级。CONTROL[1]用于选择堆栈指针，0为MSP，1为PSP。
15. __ASM void __set_CONTROL(uint32_t control)：设置CONTROL寄存器的值。
BASEPRI，PRIMASK，FAULTMASK，CONTROL都只能在特权模式下被修改。
C++的关键字 asm
微软详述:
__asm关键字启动内联汇编并且能写在任何c/c++合法语句之处.它不能单独出现.
它必须接汇编指令、一组被大括号包含的指令或一对空括号.术语“__asm 块”在这里是任意一个指令或一组指令无论是否在括号内。
以下代码片段是在括号内的一个简单的__asm块。
__asm
{
mov al, 2
mov dx, 0xD007
out al, dx
}
另一种方法是，你可以在每个汇编指令前放置__asm
__asm mov al, 2
__asm mov dx, 0xD007
__asm out al, dx
因为__asm关键字是一个语句分隔符，你也可以将汇编指令放在同一行：
__asm mov al, 2 __asm mov dx, 0xD007 __asm out al, dx
以上三个的例子产生相同的代码，但是第一种风格（把__asm块用括号括起来）有一些优势。
括号可以清晰的将C或C++代码和汇编代码分开，并且避免了不必要的重复__asm关键字。括号也能避免模糊性。
如果你想在__asm块的同一行放置一个C或C++语句，你必须将块用括号括起来。
没有括号，编译器不能告诉汇编代码在哪里停止而C或C++代码在哪里开始。
最后，因为在括号的文字有和原始MASM一样的格式，你能轻松的从一个已有的MASM源文件里剪切和黏贴文字到文件来。
不同于C和C++的括号，包含__asm块的括号对变量的作用域并没有效果。你也能嵌套__asm块，嵌套对变量作用域也没有效果。
core_cm3.h：里面包含了一些内联函数，数据结构，这些数据结构都是核心的外设数据结构，大概包括：NVIC，SCB，ITM，CoreDebug，SysTick.
对以上设备进行设置的函数也在这个头文件里，以静态内联函数的形式出现，例如 static __INLINE uint32_t NVIC_GetPriority(IRQn_Type IRQn)，
其中，__INLINE 是__inline 的替代。 静态函数 static 声明。
Core_cm3.c 文件中定义的函数声明也在这个文件中。
invlude包含指令不仅仅限于.h头文件，可以包含任何编译器能识别的C/C++代码文件，包括.c,.hpp,.cpp,.hxx,.cxx等，甚至.txt,.abc等等都可以。
预处理器发现 #include 指令后，就会寻找后跟的文件名并把这个文件的内容包含到当前文件中。
被包含文件中的文本将替换源代码文件中的#include 指令，
就像你把被包含文件中的全部内容键入到源文件中的这个位置一样。
DeviceSupport
stm32f10x.h：
新版的固件库V3.0以上 main等源文件中不再直接包含stm32f10x_conf.h，
而是stm32f10x.h，stm32f10x.h则定义了启动设置，以及所有寄存器宏定义，
此文件中需要注意的有：
1、device选择
#if !defined (STM32F10X_LD) && !defined (STM32F10X_LD_VL) && !defined (STM32F10X_MD)
&& !defined (STM32F10X_MD_VL)&& !defined (STM32F10X_HD) && !defined (STM32F10X_HD_VL)
&& !defined (STM32F10X_XL) && !defined (STM32F10X_CL)
/* #define STM32F10X_LD */ /*!< STM32F10X_LD: STM32 Low density devices */
/* #define STM32F10X_LD_VL */ /*!< STM32F10X_LD_VL: STM32 Low density Value Line devices */
/* #define STM32F10X_MD */ /*!< STM32F10X_MD: STM32 Medium density devices */
/* #define STM32F10X_MD_VL */ /*!< STM32F10X_MD_VL: STM32 Medium density Value Line devices */
/* #define STM32F10X_HD */ /*!< STM32F10X_HD: STM32 High density devices */
/* #define STM32F10X_HD_VL */ /*!< STM32F10X_HD_VL: STM32 High density value line devices */
/* #define STM32F10X_XL */ /*!< STM32F10X_XL: STM32 XL-density devices */
/* #define STM32F10X_CL */ /*!< STM32F10X_CL: STM32 Connectivity line devices */
#endif
#if !defined (STM32F10X_LD) && !defined (STM32F10X_LD_VL)
&& !defined (STM32F10X_MD) && !defined (STM32F10X_MD_VL)
&& !defined (STM32F10X_HD) && !defined (STM32F10X_HD_VL)
&& !defined (STM32F10X_XL) && !defined (STM32F10X_CL)
#error "Please select first the target STM32F10x device used in your application (in stm32f10x.h file)"
#endif
如果都没有定义，编译器会报错。
2、外设宏定义USE_STDPERIPH_DRIVER
#if !defined USE_STDPERIPH_DRIVER
#endif
注意stm32f10x.h文件的后面有这样的代码，大概8300行左右：
#ifdef USE_STDPERIPH_DRIVER
#include "stm32f10x_conf.h"
#endif
stm32f10x_conf.h中包含了所有外设的头文件，因此任意源文件只要包含了stm32f10x.h，就可以在源文件调用任意外设的函数。
3、外部时钟频率选择
#if !defined HSE_VALUE
#ifdef STM32F10X_CL
#define HSE_VALUE ((uint32_t)25000000)
#else
#define HSE_VALUE ((uint32_t)8000000)
#endif
#endif
注意STM32F10X_CL，STM32F10X_CL是stm32f105 和stm32f107 互联型的device，
用到此器件外部要选用25MHz的晶体，此处默认的外部8MHz的晶体
4.stm32f10x.h包含了这些头文件，include"stm32f10x.h",就不用包含下面这些了。
#include "core_cm3.h"
#include "system_stm32f10x.h"
#include
system_stm32f10x.c:
这个文件中包含系统上电复位之后时钟设置要调用的函数:
SystemInit()系统初始化,系统上电复位,main()在启动其它分支程序以前调用的函数。
SetSysClock()，被SystemInit()函数调用，设置系统时钟频率，根据宏定义选择系统运行的时钟频率。
SetSysClockTo24
SetSysClockTo36
SetSysClockTo48
SetSysClockTo56
SetSysClockTo72
SetSysClockToHSE
system_stm32f10x.h 源文件函数声明的头文件。
startup文件夹包含各个系列的启动代码，用户应该根据自己的芯片类型来选择启动代码。
STM32F10x_StdPeriph_Driver
inc：头文件没什么好说的了，一个头文件对用一个源文件，包括函数，数据结构的的一些声明
src：这一层就是Device Peripheral Access Layer（DPAL）了，看看名字就知道是关于哪个设备的，没什么
说的。唯一有一个例外就是misc.c文件，STM32 V3.5版本的库函数中没有原来版本中单独对于NVIC(中断向量嵌套)的外设驱动，
把NVIC的外设驱动放在了misc.c中，实际上是代替原来的stm32f10x_nvic.c.
评论