文档介绍：STM32的函数说明(中文)
UM0427 用户手册
32位基于 ARM 微控制器 STM32F101xx 与 STM32F103xx
固件函数库
介绍本手册介绍了 32 位基于 ARM 微控制器 STM32F101xx 与 STM32F103xx 的固件函数库。
该函数库是一个固件函数包,它由程序、数据结构和宏组成,包括了微控制器所有外设的性能特征。该函
数库还包括每一个外设的驱动描述和应用实例。通过使用本固件函数库,无需深入掌握细节,用户也可以
轻松应用每一个外设。因此,使用本固态函数库可以大大减少用户的程序编写时间,进而降低开发成本。
每个外设驱动都由一组函数组成,这组函数覆盖了该外设所有功能。每个器件的开发都由一个通用 API
application programming interface 应用编程界面驱动,API 对该驱动程序的结构,函数和参数名称都进行
了标准化。
所有的驱动源代码都符合“Strict ANSI-C”标准(项目于范例文件符合扩充 ANSI-C 标准)。我们已经把驱动
源代码文档化,他们同时兼容 MISRA-C 2004 标准(根据需要,我们可以提供兼容矩阵)。由于整个固态
函数库按照“Strict ANSI-C”标准编写,它不受不同开发环境的影响。仅对话启动文件取决于开发环境。
该固态函数库通过校验所有库函数的输入值来实现实时错误检测。该动态校验提高了软件的鲁棒性。实时
检测适合于用户应用程序的开发和调试。但这会增加了成本,可以在昀终应用程序代码中移去,以优化代
码大小和执行速度。想要了解更多细节,请参阅 Section 。
因为该固件库是通用的,并且包括了所有外设的功能,所以应用程序代码的大小和执行速度可能不是昀优
的。对大多数应用程序来说,用户可以直接使用之,对于那些在代码大小和执行速度方面有严格要求的应
用程序,该固件库驱动程序可以作为如何设置外设的一份参考资料,根据实际需求对其进行调整。
此份固件库用户手册的整体架构如下:定义,文档约定和固态函数库规则。固态函数库概述(包的内容,库的架构),安装指南,库使用实例。固件库具体描述:设置架构和每个外设的函数。
STM32F101xx 和 STM32F103xx 在整个文档中被写作 STM32F101x。 1/368
译文英文原版为 UM0427 Oct. 2007 Rev 2, 译文仅供参考,与英文版冲突的,以英文版为准目录
目录
缩写27
命名规则 27
编码规则 28
变量. 28
布尔型 28
标志位状态类型. 29
功能状态类型29
错误状态类型29
外设 29
压缩包描述32
文件夹Examples. 32
文件夹Library32
文件夹Project33
固件函数库文件描述. 33
外设的初始化和设置. 34
位段(Bit-Banding). 35
映射公式. 35
应用实例. 35
运行时间检测. 36
ADC寄存器结构. 39
ADC库函数 40
函数ADC_DeInit 42
函数ADC_Init42
函数ADC_StructInit. 44
函数ADC_Cmd 44
函数ADC_DMACmd45
函数ADC_ITConfig45
函数ADC_ResetCalibration46
函数ADC_GetResetCalibrationStatus. 46
函数ADC_StartCalibration 46
函数ADC_GetCalibrationStatus47
函数ADC_SoftwareStartConvCmd 47
函数ADC_GetSoftwareStartConvStatus48
函数ADC_DiscModeChannelCountConfig 48
函数ADC_DiscModeCmd49
函数ADC_RegularChannelConfig. 49
函数ADC_ExternalTrigConvConfig. 51
函数ADC_GetConversionValue51