STM32F2系列LL库和HAL库文档资源-CSDN文库

STM32F2

需积分: 5 7 浏览量 2024-09-15 16:28:15 上传评论收藏 29.74MB PDF 举报

资源推荐

资源详情

资源评论

March 2017

DocID028236 Rev 2

1/1371

www.st.com

UM1940

User Manual

Description of STM32F2 HAL and Low Layer drivers

Introduction

STMCube

is STMicroelectronics's original initiative to ease developers' life by reducing development

efforts, time and cost. STM32Cube covers the STM32 portfolio.

STM32Cube Version 1.x includes:

The STM32CubeMX, a graphical software configuration tool that allows generating C initialization

code using graphical wizards.

A comprehensive embedded software platform, delivered per series (such asSTM32CubeF2

forSTM32F2 series)

The STM32Cube Hardware Abstraction Layer (HAL), an STM32 abstraction layer embedded

software, ensuring maximized portability across the STM32 portfolio

The Low Layer APIs (LL) offering a fast light-weight expert-oriented layer which is closer to the

hardware than the HAL. The LL APIs are available only for a set of peripherals.

A consistent set of middleware components such as RTOS, USB, TCP/IP, Graphics

All embedded software utilities coming with a full set of examples.

The HAL driver layer provides a generic multi instance simple set of APIs (application programming

interfaces) to interact with the upper layer (application, libraries and stacks).

The HAL driver APIs are split into two categories: generic APIs which provide common and generic

functions for all the STM32 series and extension APIs which include specific and customized functions

for a given line or part number. The HAL drivers include a complete set of ready-to-use APIs which

simplify the user application implementation. As an example, the communication peripherals contain

APIs to initialize and configure the peripheral, manage data transfers in polling mode, handle interrupts

or DMA, and manage communication errors.

The HAL drivers are feature-oriented instead of IP-oriented. As an example, the timer APIs are split into

several categories following the functions offered by the IP such as basic timer, capture, or pulse width

modulation (PWM). The HAL driver layer implements run-time failure detection by checking the input

values of all functions. Such dynamic checking contributes to enhance the firmware robustness. Run-

time detection is also suitable for user application development and debugging.

The LL drivers offer hardware services based on the available features of the STM32 peripherals. These

services reflect exactly the hardware capabilities and provide atomic operations that must be called

following the programming model described in the product line reference manual. As a result, the LL

services are not based on standalone processes and do not require any additional memory resources to

save their states, counter or data pointers: all operations are performed by changing the associated

peripheral registers content. Contrary to the HAL, the LL APIs are not provided for peripherals for which

optimized access is not a key feature, or for those requiring heavy software configuration and/or

complex upper level stack (such as FMC, USB, SDMMC).

The HAL and LL are complementary and cover a wide range of applications requirements:

The HAL offers high-level and feature-oriented APIs, with a high-portability level. They hide the

MCU and peripheral complexity to end-user.

The LL offers low-level APIs at registers level, with better optimization but less portability. They

require deep knowledge of the MCU and peripherals specifications.

The source code of HAL and LL drivers is developed in Strict ANSI-C which makes it independent from

the development tools. It is checked with CodeSonar™ static analysis tool. It is fully documented and is

MISRA-C 2004 compliant.

Contents

UM1940

2/1371

DocID028236 Rev 2

Contents

1 Acronyms and definitions ............................................................. 26

2 Overview of HAL drivers ............................................................... 28

2.1 HAL and user-application files......................................................... 28

2.1.1 HAL driver files ................................................................................. 28

2.1.2 User-application files ........................................................................ 30

2.2 HAL data structures ........................................................................ 31

2.2.1 Peripheral handle structures ............................................................ 31

2.2.2 Initialization and configuration structure ........................................... 33

2.2.3 Specific process structures .............................................................. 33

2.3 API classification ............................................................................. 33

2.4 Devices supported by HAL drivers .................................................. 34

2.5 HAL driver rules .............................................................................. 36

2.5.1 HAL API naming rules ...................................................................... 36

2.5.2 HAL general naming rules ................................................................ 37

2.5.3 HAL interrupt handler and callback functions ................................... 38

2.6 HAL generic APIs ............................................................................ 39

2.7 HAL extension APIs ........................................................................ 40

2.7.1 HAL extension model overview ........................................................ 40

2.7.2 HAL extension model cases ............................................................. 41

2.8 File inclusion model ......................................................................... 43

2.9 HAL common resources .................................................................. 43

2.10 HAL configuration ............................................................................ 44

2.11 HAL system peripheral handling ..................................................... 46

2.11.1 Clock ................................................................................................. 46

2.11.2 GPIOs ............................................................................................... 46

2.11.3 Cortex NVIC and SysTick timer ........................................................ 48

2.11.4 PWR ................................................................................................. 48

2.11.5 EXTI .................................................................................................. 48

2.11.6 DMA .................................................................................................. 49

2.12 How to use HAL drivers .................................................................. 51

2.12.1 HAL usage models ........................................................................... 51

2.12.2 HAL initialization ............................................................................... 52

2.12.3 HAL IO operation process ................................................................ 54

2.12.4 Timeout and error management ....................................................... 57

3 Overview of Low Layer drivers ..................................................... 61

UM1940

Contents

DocID028236 Rev 2

3/1371

3.1 Low Layer files ................................................................................ 61

3.2 Overview of Low Layer APIs and naming rules ............................... 63

3.2.1 Peripheral initialization functions ...................................................... 63

3.2.2 Peripheral register-level configuration functions .............................. 67

4 Cohabiting of HAL and LL ............................................................ 69

4.1 Low Layer driver used in standalone mode ..................................... 69

4.2 Mixed use of Low Layer APIs and HAL drivers ............................... 69

5 HAL System Driver ........................................................................ 70

5.1 HAL Firmware driver API description .............................................. 70

5.1.1 How to use this driver ....................................................................... 70

5.1.2 Initialization and de-initialization functions ....................................... 70

5.1.3 HAL Control functions....................................................................... 70

5.1.4 Detailed description of functions ...................................................... 71

5.2 HAL Firmware driver defines ........................................................... 75

5.2.1 HAL ................................................................................................... 75

6 HAL ADC Generic Driver ............................................................... 77

6.1 ADC Firmware driver registers structures ....................................... 77

6.1.1 ADC_InitTypeDef .............................................................................. 77

6.1.2 ADC_ChannelConfTypeDef ............................................................. 78

6.1.3 ADC_AnalogWDGConfTypeDef ....................................................... 79

6.1.4 ADC_HandleTypeDef ....................................................................... 80

6.2 ADC Firmware driver API description .............................................. 80

6.2.1 ADC Peripheral features................................................................... 80

6.2.2 How to use this driver ....................................................................... 81

6.2.3 Initialization and de-initialization functions ....................................... 83

6.2.4 IO operation functions ...................................................................... 83

6.2.5 Peripheral Control functions ............................................................. 83

6.2.6 Peripheral State and errors functions ............................................... 84

6.2.7 Detailed description of functions ...................................................... 84

6.3 ADC Firmware driver defines .......................................................... 89

6.3.1 ADC .................................................................................................. 89

7 HAL ADC Extension Driver ........................................................... 96

7.1 ADCEx Firmware driver registers structures ................................... 96

7.1.1 ADC_InjectionConfTypeDef ............................................................. 96

7.1.2 ADC_MultiModeTypeDef .................................................................. 97

7.2 ADCEx Firmware driver API description ......................................... 98

Contents

UM1940

4/1371

DocID028236 Rev 2

7.2.1 How to use this driver ....................................................................... 98

7.2.2 Extended features functions ............................................................. 99

7.2.3 Detailed description of functions .................................................... 100

7.3 ADCEx Firmware driver defines .................................................... 103

7.3.1 ADCEx ............................................................................................ 103

8 HAL CAN Generic Driver ............................................................. 105

8.1 CAN Firmware driver registers structures ..................................... 105

8.1.1 CAN_InitTypeDef ............................................................................ 105

8.1.2 CAN_FilterConfTypeDef ................................................................. 106

8.1.3 CanTxMsgTypeDef ......................................................................... 107

8.1.4 CanRxMsgTypeDef ........................................................................ 107

8.1.5 CAN_HandleTypeDef ..................................................................... 108

8.2 CAN Firmware driver API description ............................................ 108

8.2.1 How to use this driver ..................................................................... 108

8.2.2 Initialization and de-initialization functions ..................................... 109

8.2.3 IO operation functions .................................................................... 110

8.2.4 Peripheral State and Error functions .............................................. 110

8.2.5 Detailed description of functions .................................................... 110

8.3 CAN Firmware driver defines ........................................................ 114

8.3.1 CAN ................................................................................................ 114

9 HAL CORTEX Generic Driver ...................................................... 122

9.1 CORTEX Firmware driver registers structures .............................. 122

9.1.1 MPU_Region_InitTypeDef .............................................................. 122

9.2 CORTEX Firmware driver API description .................................... 123

9.2.1 How to use this driver ..................................................................... 123

9.2.2 Initialization and de-initialization functions ..................................... 123

9.2.3 Peripheral Control functions ........................................................... 124

9.2.4 Detailed description of functions .................................................... 124

9.3 CORTEX Firmware driver defines ................................................. 129

9.3.1 CORTEX ......................................................................................... 129

10 HAL CRC Generic Driver ............................................................. 132

10.1 CRC Firmware driver registers structures ..................................... 132

10.1.1 CRC_HandleTypeDef ..................................................................... 132

10.2 CRC Firmware driver API description ........................................... 132

10.2.1 How to use this driver ..................................................................... 132

10.2.2 Initialization and de-initialization functions ..................................... 132

10.2.3 Peripheral Control functions ........................................................... 133

UM1940

Contents

DocID028236 Rev 2

5/1371

10.2.4 Peripheral State functions .............................................................. 133

10.2.5 Detailed description of functions .................................................... 133

10.3 CRC Firmware driver defines ........................................................ 135

10.3.1 CRC ................................................................................................ 135

11 HAL CRYP Generic Driver ........................................................... 136

11.1 CRYP Firmware driver registers structures ................................... 136

11.1.1 CRYP_InitTypeDef ......................................................................... 136

11.1.2 CRYP_HandleTypeDef................................................................... 136

11.2 CRYP Firmware driver API description ......................................... 137

11.2.1 How to use this driver ..................................................................... 137

11.2.2 Initialization and de-initialization functions ..................................... 138

11.2.3 AES processing functions .............................................................. 138

11.2.4 DES processing functions .............................................................. 139

11.2.5 TDES processing functions ............................................................ 139

11.2.6 DMA callback functions .................................................................. 140

11.2.7 CRYP IRQ handler management ................................................... 140

11.2.8 Peripheral State functions .............................................................. 140

11.2.9 Detailed description of functions .................................................... 140

11.3 CRYP Firmware driver defines ...................................................... 155

11.3.1 CRYP .............................................................................................. 155

12 HAL DAC Generic Driver ............................................................. 159

12.1 DAC Firmware driver registers structures ..................................... 159

12.1.1 DAC_HandleTypeDef ..................................................................... 159

12.1.2 DAC_ChannelConfTypeDef ........................................................... 159

12.2 DAC Firmware driver API description ............................................ 160

12.2.1 DAC Peripheral features................................................................. 160

12.2.2 How to use this driver ..................................................................... 161

12.2.3 Initialization and de-initialization functions ..................................... 162

12.2.4 IO operation functions .................................................................... 162

12.2.5 Peripheral Control functions ........................................................... 162

12.2.6 Peripheral State and Errors functions ............................................ 162

12.2.7 Detailed description of functions .................................................... 163

12.3 DAC Firmware driver defines ........................................................ 167

12.3.1 DAC ................................................................................................ 167

13 HAL DAC Extension Driver ......................................................... 171

13.1 DACEx Firmware driver API description ....................................... 171

剩余1370页未读，继续阅读

评论收藏

内容反馈

GRshark

粉丝: 303
资源: 12

STM32 F2系列LL库和HAL库文档

最新资源

STM32 F2系列LL库和HAL库文档

STM32官方文档HAL&LL库相关

STM32F4xx系列官方资料包括固件库与手册（标准库）HAL库用户手册资料合集.zip

stm32F2XX固件库

ST 官方推出 STM32F2系列的驱动库啦 STM32F2xx_StdPeriph_Lib_V1.0.0

STM32F2和F3的固件库，pack

STM32F系列、STM32L系列固件库

STM32F2系列培训资料

STM32CubeF2_V1.8.0_20190904.zip STM32F2xx系列官方固件库驱动库板级支持包源代码，直接加入开发环境调用链接编译即可

STM32CubeF2固件库入门指南_ENV3_20170525.pdf STM32F2xx系列官方固件库驱动库板级支持包使用说明英文版

Keil.STM32F2xx_DFP.2.10.0.pack

STM32标准库全系列（包括L0F0F1F2F3F4）

STM32F2系列工程模版 基于STM32F2xx_StdPeriph_Lib_V1.0.0外设库

STM32 F2封装全系列集成库

STM32CubeF2_V1.7.0_20171218.zip STM32F2xx系列官方固件库驱动库板级支持包源代码，直接加入开发环境调用链接编译即可

STM32F2xx的库

STM32F2xx_StdPeriph_Lib_V1.1.0.zip

STM32F2xx系列固件库

stm32f2培训教材

STM32Cube_FW_F2_1.9.0.zip

STM32CubeF2_V1.9.0_20200226.zip STM32F2xx系列官方固件库驱动库板级支持包源代码，直接加入开发环境调用链接编译即可

STM32F2xx全部应用开发文档

Keil.STM32F0 F1 F2系列keil5库文件

STM32CubeF2_V1.4.0_20160809.zip STM32F2xx系列官方固件库驱动库板级支持包源代码，直接加入开发环境调用链接编译即可

stm32cube fw f2 v140 库文件

keil.stm32f2xx_dfp.1.0.4.rar

stm32封装 F0 F1 F2 F4 W全系列集成库

STM32官方资料.rar

stm32f2xx固件函数

STM32F2技术培训文档

最新资源

STM32F2系列工程模版基于STM32F2xx_StdPeriph_Lib_V1.0.0外设库