STM32外设开发库函数手册资源-CSDN文库

需积分: 17 197 浏览量 2015-06-25 10:57:39 上传评论收藏 8.23MB PDF 举报

STM32微控制器是由意法半导体（STMicroelectronics）开发的一系列32位ARM Cortex-M微控制器产品线。在这些产品线中，外设开发库函数手册是开发者们编写程序时不可或缺的资源，它提供了丰富的API来简化硬件抽象层（HAL）的编程，使得开发者能够更高效地开发各种应用程序。文档标题所提及的“STM32外设开发库函数手册”通常指的是针对STM32系列微控制器的固件库（ Firmware Library），它是对硬件寄存器操作的高级封装，提供了一系列函数，供开发者在开发软件时调用。这些库函数主要包括： 1. 标准外设库（Standard Peripheral Library）：提供了一系列函数，用于访问STM32的外设功能。这些函数通过一套共同的API来标准化驱动结构、函数及其参数名称，实现了代码的高度可重用性。 2. 硬件寄存器地址映射：手册中会提供完整的寄存器地址映射，包括所有位、位字段和寄存器的声明，全部用C语言编写。这样做的好处是避免了繁琐的任务，并提供了一个无bug的参考映射文件，加快了项目的初期阶段。 3. 驱动函数与数据结构集合：涵盖了所有外设功能的例程和数据结构，可以直接用作参考框架。它还包含了支持核心相关内置功能的宏、通用常量和数据类型的定义。 4. 示例代码：提供了所有可用外设的示例代码，包括模板项目，供最常用的开发工具使用。配合硬件评估板，可以在几个小时内开始使用全新的微控制器进行开发。 5. 严格的ANSI C标准：库的开发遵循“Strict ANSI-C”标准（对于项目和示例文件使用relaxed ANSI-C），保证了与开发工具的独立性。仅有启动文件依赖于特定的开发工具。 6. MISRA-C2004合规性：STM32的外设开发库严格遵守MISRA-C 2004编程规范，这是业界公认的嵌入式C语言编程标准。 7. 运行时错误检测：库函数实现了运行时故障检测功能，通过检查所有库函数的输入值来增强软件的健壮性。这对于用户应用程序的开发和调试非常合适。 STM32系列微控制器支持的外设非常广泛，手册中会对各种外设的使用进行详细介绍，并且会为每个功能提供相应的库函数。例如，对于定时器（Timer）、通用输入输出（GPIO）、串行外设接口（SPI）、通用同步/异步收发器（USART）等，开发者都能找到相应的函数和设置步骤。这些库函数大大简化了编程工作，使得开发者不需要深入理解底层硬件就可以控制外设工作。此外，STM32固件库是基于模块化设计的，使得开发者能够轻松地根据需要启用或禁用特定的模块。这种结构使得代码易于在不同的STM32微控制器之间迁移，并且能够快速地将产品线扩展到市场上，无需重新设计。由于库函数已经高度优化，开发者可以专注于应用层的设计，而不需要担心硬件层面的细节。

资源推荐

资源详情

资源评论

October 2012

DocID023800 Rev 1

1/584

www.st.com

UM1581

User manual

Description of STM32F30xx/31xx Standard Peripheral Library

Introduction

The STM32F30xx and STM32F31xx Standard Peripheral Library covers 3 abstraction levels, and

includes:

 A complete register address mapping with all bits, bitfields and registers declared in C. This avoids

a cumbersome task and more important, it brings the benefits of a bug free reference mapping file,

speeding up the early project phase.

 A collection of routines and data structures covering all peripheral functions (drivers with common

API). It can directly be used as a reference framework, since it also includes macros for supporting

core-related intrinsic features, common constants, and definition of data types.

 A set of examples covering all available peripherals with template projects for the most common

development tools. With the appropriate hardware evaluation board, this allows to get started with

a brand-new micro within few hours.󳘪

Each driver consists of a set of functions covering all peripheral features. The development of each

driver is driven by a common API (application programming interface) which standardizes the driver

structure, the functions and the parameter names.The driver source code is developed in „Strict ANSI-C‟

(relaxed ANSI-C for projects and example files). It is fully documented and is MISRA-C 2004 compliant.

Writing the whole library in „Strict ANSI-C‟ makes it independent from the development tools. Only the

start-up files depend on the development tools. Thanks to the Standard Peripheral Library, low-level

implementation details are transparent so that reusing code on a different MCU requires only to

reconfigure the compiler. As a result, developers can easily migrate designs across the STM32 series to

quickly bring product line extensions to market without any redesign. In addition, the library is built

around a modular architecture that makes it easy to tailor and run it on the same MCU using hardware

platforms different from ST evaluation boards.

The Standard Peripheral Library implements run-time failure detection by checking the input values for

all library functions. Such dynamic checking contributes towards enhancing the robustness of the

software. Run-time detection is suitable for user application development and debugging. It adds an

overhead which can be removed from the final application code to minimize code size and execution

speed. For more details refer to Section 1.1.5: "Run-time checking".󳘪

Since the Standard Peripheral Library is generic and covers all peripheral features, the size and/or

execution speed of the application code may not be optimized. For many applications, the library may

be used as is. 󳘪

The firmware library user manual is structured as follows:

 Document conventions, rules, architecture and overview of the Library package.

 How to use and customize the Library (step by step).

 Detailed description of each peripheral driver: configuration structure, functions and how to use the

provided API to build your application.󳘪

The STM32F30xx and STM32F31xx Standard Peripheral Library will be referred to as STM32F30xx

Library throughout the document, unless otherwise specified.

Table 1: Applicable products

Type

Part numbers

Microcontrollers

STM32F30xx and STM32F31xx

STM32F30xx Standard Peripheral Library

UM1581

2/584

DocID023800 Rev 1

Contents

1 STM32F30xx Standard Peripheral Library ...................... 14

1.1 Coding rules and conventions ............................................. 14

1.1.1 Acronyms ....................................................................................... 14

1.1.2 Naming conventions ...................................................................... 14

1.1.3 Coding rules .................................................................................. 15

1.1.4 Bit-Banding .................................................................................... 18

1.1.5 Run-time checking ......................................................................... 19

1.1.6 MISRA-C 2004 compliance ........................................................... 21

1.2 Architecture ......................................................................... 23

1.3 Package description ............................................................ 24

1.3.1 Library folder structure ................................................................... 24

1.3.2 Project folder ................................................................................. 27

1.3.3 Utilities folder ................................................................................. 29

1.4 Supported devices and development tools .......................... 31

1.4.1 Supported devices ......................................................................... 31

1.4.2 Supported development tools and compilers ................................ 31

2 How to use and customize the library ............................ 32

2.1 Library configuration parameters ......................................... 32

2.2 Library programming model ................................................. 34

2.3 Peripheral initialization and configuration ............................ 35

2.4 How to run your first example .............................................. 36

2.4.1 Prerequisites .................................................................................. 36

2.4.2 Run your first example ................................................................... 37

2.4.3 Run a peripheral example ............................................................. 38

2.5 STM32F30/31xx programming model using the library ....... 39

2.6 How to develop your first application ................................... 41

2.6.1 Starting point ................................................................................. 41

2.6.2 Library configuration parameters ................................................... 42

2.6.3 system_stm32f30x.c ...................................................................... 42

2.6.4 main.c ............................................................................................ 43

2.6.5 stm32f30x_it.c ............................................................................... 44

3 Analog-to-digital converter (ADC) ................................... 46

3.1 ADC Firmware driver registers structures ............................ 46

3.1.1 ADC_Common_TypeDef ............................................................... 46

3.1.2 ADC_CommonInitTypeDef ............................................................ 46

UM1581

STM32F30xx Standard Peripheral Library

DocID023800 Rev 1

3/584

3.1.3 ADC_InitTypeDef ........................................................................... 47

3.1.4 ADC_InjectedInitTypeDef .............................................................. 48

3.1.5 ADC_TypeDef ............................................................................... 48

3.2 ADC Firmware driver API description .................................. 51

3.2.1 How to use this driver .................................................................... 51

3.2.2 Initialization and Configuration functions ....................................... 51

3.2.3 Analog Watchdog configuration functions ..................................... 52

3.2.4 Temperature Sensor - Vrefint (Internal Reference Voltage) and

VBAT management functions .................................................................. 53

3.2.5 Regular Channels Configuration functions .................................... 53

3.2.6 Regular Channels DMA Configuration functions ........................... 54

3.2.7 Injected channels Configuration functions ..................................... 54

3.2.8 Interrupts and flags management functions .................................. 55

3.2.9 Initialization and Configuration functions ....................................... 57

3.2.10 Analog Watchdog configuration functions ..................................... 65

3.2.11 Temperature Sensor- Vrefint (Internal Reference Voltage) and

VBAT management function .................................................................... 69

3.2.12 Regular Channels Configuration functions .................................... 71

3.2.13 Regular Channels DMA Configuration functions ........................... 81

3.2.14 Injected channels Configuration functions ..................................... 82

3.2.15 Interrupts and flags management functions .................................. 84

3.3 ADC Firmware driver defines .............................................. 90

3.3.1 ADC ............................................................................................... 90

4 Controller area network (bxCAN) .................................. 105

4.1 CAN Firmware driver registers structures .......................... 105

4.1.1 CAN_TypeDef ............................................................................. 105

4.1.2 CAN_FIFOMailBox_TypeDef ...................................................... 106

4.1.3 CAN_TxMailBox_TypeDef .......................................................... 107

4.1.4 CAN_FilterRegister_TypeDef ...................................................... 107

4.1.5 CAN_InitTypeDef ......................................................................... 107

4.1.6 CAN_FilterInitTypeDef ................................................................. 109

4.1.7 CanRxMsg ................................................................................... 110

4.1.8 CanTxMsg ................................................................................... 110

4.2 CAN Firmware driver API description ................................ 111

4.2.1 How to use this driver .................................................................. 111

4.2.2 Initialization and Configuration functions ..................................... 112

4.2.3 CAN Frames Transmission functions .......................................... 112

4.2.4 CAN Frames Reception functions ............................................... 112

4.2.5 CAN Operation modes functions ................................................. 112

STM32F30xx Standard Peripheral Library

UM1581

4/584

DocID023800 Rev 1

4.2.6 CAN Bus Error management functions ....................................... 113

4.2.7 Interrupts and flags management functions ................................ 113

4.2.8 Initialization and Configuration functions ..................................... 115

4.2.9 CAN Frames Transmission functions .......................................... 118

4.2.10 CAN Frames Reception functions ............................................... 119

4.2.11 CAN Operating mode functions ................................................... 120

4.2.12 CAN Bus Error management functions ....................................... 121

4.2.13 Interrupts and flags management functions ................................ 123

4.3 CAN Firmware driver defines ............................................ 126

4.3.1 CAN ............................................................................................. 126

5 Comparators (COMP) ..................................................... 137

5.1 COMP Firmware driver registers structures ...................... 137

5.1.1 COMP_TypeDef .......................................................................... 137

5.1.2 COMP_InitTypeDef ..................................................................... 137

5.2 COMP Firmware driver API description ............................. 138

5.2.1 COMP Peripheral features .......................................................... 138

5.2.2 How to use this driver .................................................................. 140

5.2.3 Initialization and Configuration functions ..................................... 140

5.2.4 Window mode control function .................................................... 140

5.2.5 Initialization and Configuration functions ..................................... 141

5.2.6 Write mode control functions ....................................................... 144

5.2.7 COMP configuration locking function .......................................... 144

5.3 COMP Firmware driver defines ......................................... 145

5.3.1 COMP .......................................................................................... 145

6 CRC calculation unit (CRC) ............................................ 152

6.1 CRC Firmware driver registers structures ......................... 152

6.1.1 CRC_TypeDef ............................................................................. 152

6.2 CRC Firmware driver API description ................................ 152

6.2.1 How to use this driver .................................................................. 152

6.2.2 CRC configuration functions ........................................................ 153

6.2.3 CRC computation functions ......................................................... 153

6.2.4 CRC Independent Register (IDR) access functions .................... 153

6.2.5 CRC Independent Register (IDR) access functions .................... 153

6.2.6 CRC computation of one/many 32-bit data functions .................. 156

6.2.7 CRC Independent Register (IDR) access functions .................... 158

6.3 CRC Firmware driver defines ............................................ 158

6.3.1 CRC ............................................................................................. 158

UM1581

STM32F30xx Standard Peripheral Library

DocID023800 Rev 1

5/584

7 Digital-to-analog converter (DAC) ................................. 160

7.1 DAC Firmware driver registers structures .......................... 160

7.1.1 DAC_TypeDef ............................................................................. 160

7.1.2 DAC_InitTypeDef ......................................................................... 161

7.2 DAC Firmware driver API description ................................ 161

7.2.1 DAC Peripheral features ............................................................. 161

7.2.2 How to use this driver .................................................................. 162

7.2.3 DAC channels configuration: trigger, output buffer, data format . 163

7.2.4 DMA management functions ....................................................... 163

7.2.5 Interrupts and flags management functions ................................ 163

7.2.6 DAC channels configuration ........................................................ 163

7.2.7 DAC management functions ....................................................... 168

7.2.8 Interrupts and flags management functions ................................ 169

7.3 DAC Firmware driver defines ............................................ 171

7.3.1 DAC ............................................................................................. 171

8 Debug support (DBGMCU) ............................................. 176

8.1 DBGMCU Firmware driver registers structures ................. 176

8.1.1 DBGMCU_TypeDef ..................................................................... 176

8.2 DBGMCU Firmware driver API description ........................ 176

8.2.1 Device and Revision ID management functions ......................... 176

8.2.2 Peripherals Configuration functions ............................................ 176

8.2.3 Device and Revision ID management functions ......................... 177

8.2.4 Peripherals Configuration functions ............................................ 177

8.3 DBGMCU Firmware driver defines .................................... 179

8.3.1 DBGMCU ..................................................................................... 179

9 DMA controller (DMA) ..................................................... 182

9.1 DMA Firmware driver registers structures ......................... 182

9.1.1 DMA_Channel_TypeDef.............................................................. 182

9.1.2 DMA_TypeDef ............................................................................. 182

9.1.3 DMA_InitTypeDef ........................................................................ 182

9.2 DMA Firmware driver API description ................................ 184

9.2.1 How to use this driver .................................................................. 184

9.2.2 Initialization and Configuration functions ..................................... 184

9.2.3 Data Counter functions ................................................................ 185

9.2.4 Interrupts and flags management functions ................................ 185

9.2.5 Initialization and Configuration functions ..................................... 186

9.2.6 Data counter functions................................................................. 188

剩余583页未读，继续阅读

评论收藏

内容反馈

lvxingweiding

粉丝: 0
资源: 8

STM32外设开发库函数手册

stm32f0xx_stdperiph_lib_um(STM32F0标准外设函数库手册)

STM32F0标准外设函数库手册

stm32F0资料，库函数手册，参考手册等

STM32F0XX标准外设库

STM32固件库函数说明手册（中文版），STM32F10xxxx数据手册（中文版）

STM32F0系列的参考手册

STM32F0中文资料

STM32F0中文参考手册

STM32库函数开发

STM32 F2XX 参考手册，库函数开发手册，很详细

STM32开发指南库函数版本

stm32f4标准库函数开发手册

STM32F4开发指南-库函数版本_V1_STM32F4开发指南_STM32F4开发手册_stmf4库函数_stm32f4库函数

STM32F4开发指南-库函数版本_V1.1,stm32f4库函数中文手册,C,C++

STM32F4 HAL库函数手册(英文版)

STM32F7HAL库函数开发手册

STM32 开发指南（库函数+寄存器）

STM32库函数手册的中文版.zip

STM32固件库函数手册.pdf

STM32F429 库函数手册

STM32官方3.5库函数及手册

STM32 HAL库函数说明手册

stm32库函数中文使用手册

STM32F4 数据手册、参考手册、HAL库函数手册 2022年最新版

STM32开发指南V1.0 库函数版本

STM32参考手册（库函数）(STM32 不完全手册 V V 3.1 - - 库函数版本)

最新资源