stm32固件库使用使用指南的中文翻译.doc

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 2.5。 因为该固件库是通用的，并且包括了所有外设的功能，所以应用程序代码的大小和执行速度 可能不是最优的。对大多数应用程序来说，用户可以直接使用之，对于那些在代码大小和执 行速度方面有严格要求的应用程序，该固件库驱动程序可以作为如何设置外设的一份参考资 料，根据实际需求对其进行调整。 此份固件库用户手册的整体架构如下： ? 定义，文档约定和固态函数库规则。 ? 固态函数库概述（包的内容，库的架构），安装指南，库使用实例。 ? 固件库具体描述：设置架构和每个外设的函数。 STM32F101xx和STM32F103xx在整个文档中被写作STM32F101x。 译文英文原版为 UM0427 Oct. 2007 Rev 2, 译文仅供参考，与英文版冲突的，以英文版为准 文档和库规范 1.文档和库规范 本用户手册和固态函数库按照以下章节所描述的规范编写。 1.1缩写 Table 1. 本文档所有缩写定义 缩写 外设/单元 ADC 模数转换器 BKP 备份寄存器 CAN 控制器局域网模块 DMA 直接内存存取控制器 EXTI 外部中断事件控制器 FLASH 闪存存储器 GPIO 通用输入输出 I2C 内部集成电路 IWDG 独立看门狗 NVIC 嵌套中断向量列表控制器 PWR 电源/功耗控制 RCC 复位与时钟控制器 RTC 实时时钟 SPI 串行外设接口 SysTick 系统嘀嗒定时器 TIM 通用定时器 TIM1 高级控制定时器 USART 通用同步异步接收发射端 WWDG 窗口看门狗 1.2命名规则 固态函数库遵从以下命名规则： PPP表示任一外设缩写，例如：ADC。更多缩写相关信息参阅章节1.1 缩写。 系统、源程序文件和头文件命名都以“stm32f10x_”作为开头，例如：stm32f10x_conf.h。 常量仅被应用于一个文件的，定义于该文件中；被应用于多个文件的，在对应头文件中定 义。所有常量都由英文字母大写书写。 寄存器作为常量处理。他们的命名都由英文字母大写书写。在大多数情况下，他们采用与 缩写规范与本用户手册一致。 外设函数的命名以该外设的缩写加下划线为开头。每个单词的第一个字母都由英文字母大 译文英文原版为 UM0427 Oct. 2007 Rev 2, 译文仅供参考，与英文版冲突的，以英文版为准 文档和库规范 写书写，例如：SPI_SendData。在函数名中，只允许存在一个下划线，用以分隔外设缩写 和函数名的其它部分。 名为PPP_Init的函数，其功能是根据PPP_InitTypeDef中指定的参数，初始化外设PPP，例 如TIM_Init. 名为PPP_DeInit的函数，其功能为复位外设PPP的所有寄存器至缺省值，例如TIM_DeInit. 名为PPP_StructInit的函数，其功能为通过设置PPP_InitTypeDef 结构中的各种参数来定义 外设的功能，例如：USART_StructInit. 名为PPP_Cmd的函数，其功能为使能或者失能外设PPP，例如： SPI_Cmd. 名为PPP_ITConfig的函数，其功能为使能或者失能来自外设PPP某中断源，例如： RCC_ITConfig. 名为PPP