STM32 HAL库全面指南：1166页最新API详解

需积分: 10 101 浏览量更新于2024-07-17 收藏 25.01MB PDF 举报

STM32 HAL 是 STM32 微控制器系列的高级库接口，由 STMicroelectronics 提供，旨在简化开发过程，减少时间和成本。这个最新版本的文档（DocID027328Rev2，发布于 April 2017）涵盖了 1166 页的内容，是 STM32 开发者不可或缺的参考资料。 STM32 Cube 是 ST 的一个创新项目，它为 STM32 整个产品线提供了全面的软件平台支持。STM32 Cube 包括了以下几个关键组件： 1. **STM32CubeMX**：这是一个图形化配置工具，通过直观的图形界面帮助用户自动生成针对特定 STM32 系列的初始化代码，极大地方便了硬件配置。 2. **STM32 HAL**（硬件抽象层）：作为嵌入式软件的基础层，它提供了一套标准化、跨系列的 API，确保了代码在不同 STM32 微控制器上的兼容性。它设计简洁，易于理解和使用，适合于广大应用程序开发者。 3. **低层 APIs (LL)**：对于特定的外围设备，LL APIs 提供了一个轻量级且高度优化的专家级接口，更加接近硬件底层，性能往往优于 HAL，但支持范围较窄。 4. **中间件组件**：包括实时操作系统（RTOS）、USB、TCP/IP、图形处理等，这些组件为用户提供了一系列完整的解决方案，便于快速实现各种功能。 5. **嵌入式软件实用工具**：文档还包含了丰富的示例代码，开发者可以通过这些例子学习和实践如何利用 HAL 和 LL API 进行编程。 STM32 HAL 提供了一种通用、易用且可扩展的编程接口，使得开发者能够专注于应用程序逻辑，而不必过多关注底层硬件细节。这对于快速开发、维护和移植 STM32 项目来说具有重要意义。无论是初学者还是经验丰富的工程师，理解并掌握 HAL API 都能显著提升工作效率。

Contents

UM1850

16/1166

DocID027328 Rev 2

44.1.2 USART_HandleTypeDef ................................................................ 596

44.2 USART Firmware driver API description ....................................... 597

44.2.1 How to use this driver ..................................................................... 597

44.2.2 Initialization and Configuration functions ........................................ 599

44.2.3 IO operation functions .................................................................... 600

44.2.4 Peripheral State and Errors functions ............................................ 601

44.2.5 Detailed description of functions .................................................... 601

44.3 USART Firmware driver defines .................................................... 609

44.3.1 USART............................................................................................ 609

45 HAL WWDG Generic Driver ........................................................ 615

45.1 WWDG Firmware driver registers structures ................................. 615

45.1.1 WWDG_InitTypeDef ....................................................................... 615

45.1.2 WWDG_HandleTypeDef ................................................................ 615

45.2 WWDG Firmware driver API description ....................................... 615

45.2.1 WWDG specific features ................................................................ 615

45.2.2 How to use this driver ..................................................................... 616

45.2.3 Initialization and Configuration functions ........................................ 616

45.2.4 IO operation functions .................................................................... 617

45.2.5 Detailed description of functions .................................................... 617

45.3 WWDG Firmware driver defines .................................................... 618

45.3.1 WWDG............................................................................................ 618

46 LL ADC Generic Driver ................................................................ 621

46.1 ADC Firmware driver registers structures ..................................... 621

46.1.1 LL_ADC_CommonInitTypeDef ....................................................... 621

46.1.2 LL_ADC_InitTypeDef ...................................................................... 621

46.1.3 LL_ADC_REG_InitTypeDef ............................................................ 621

46.1.4 LL_ADC_INJ_InitTypeDef .............................................................. 622

46.2 ADC Firmware driver API description ............................................ 623

46.2.1 Detailed description of functions .................................................... 623

46.3 ADC Firmware driver defines ........................................................ 669

46.3.1 ADC ................................................................................................ 669

47 LL BUS Generic Driver ................................................................ 697

47.1 BUS Firmware driver API description ............................................ 697

47.1.1 Detailed description of functions .................................................... 697

47.2 BUS Firmware driver defines ........................................................ 709

47.2.1 BUS ................................................................................................ 709

UM1850

Contents

DocID027328 Rev 2

17/1166

48 LL CORTEX Generic Driver ......................................................... 712

48.1 CORTEX Firmware driver API description .................................... 712

48.1.1 Detailed description of functions .................................................... 712

48.2 CORTEX Firmware driver defines ................................................. 719

48.2.1 CORTEX ......................................................................................... 719

49 LL CRC Generic Driver ................................................................ 722

49.1 CRC Firmware driver API description ........................................... 722

49.1.1 Detailed description of functions .................................................... 722

49.2 CRC Firmware driver defines ........................................................ 723

49.2.1 CRC ................................................................................................ 723

50 LL DAC Generic Driver ................................................................ 725

50.1 DAC Firmware driver registers structures ..................................... 725

50.1.1 LL_DAC_InitTypeDef ...................................................................... 725

50.2 DAC Firmware driver API description ............................................ 725

50.2.1 Detailed description of functions .................................................... 725

50.3 DAC Firmware driver defines ........................................................ 739

50.3.1 DAC ................................................................................................ 739

51 LL DMA Generic Driver ............................................................... 745

51.1 DMA Firmware driver registers structures ..................................... 745

51.1.1 LL_DMA_InitTypeDef ..................................................................... 745

51.2 DMA Firmware driver API description ........................................... 746

51.2.1 Detailed description of functions .................................................... 746

51.3 DMA Firmware driver defines ........................................................ 779

51.3.1 DMA ................................................................................................ 779

52 LL EXTI Generic Driver ............................................................... 783

52.1 EXTI Firmware driver registers structures ..................................... 783

52.1.1 LL_EXTI_InitTypeDef ..................................................................... 783

52.2 EXTI Firmware driver API description ........................................... 783

52.2.1 Detailed description of functions .................................................... 783

52.3 EXTI Firmware driver defines ........................................................ 796

52.3.1 EXTI ................................................................................................ 796

53 LL GPIO Generic Driver .............................................................. 798

53.1 GPIO Firmware driver registers structures .................................... 798

53.1.1 LL_GPIO_InitTypeDef .................................................................... 798

53.2 GPIO Firmware driver API description .......................................... 798

Contents

UM1850

18/1166

DocID027328 Rev 2

53.2.1 Detailed description of functions .................................................... 798

53.3 GPIO Firmware driver defines ....................................................... 831

53.3.1 GPIO ............................................................................................... 831

54 LL I2C Generic Driver .................................................................. 835

54.1 I2C Firmware driver registers structures ....................................... 835

54.1.1 LL_I2C_InitTypeDef ........................................................................ 835

54.2 I2C Firmware driver API description .............................................. 835

54.2.1 Detailed description of functions .................................................... 835

54.3 I2C Firmware driver defines .......................................................... 866

54.3.1 I2C .................................................................................................. 866

55 LL I2S Generic Driver .................................................................. 871

55.1 I2S Firmware driver registers structures ....................................... 871

55.1.1 LL_I2S_InitTypeDef ........................................................................ 871

55.2 I2S Firmware driver API description .............................................. 871

55.2.1 Detailed description of functions .................................................... 871

55.3 I2S Firmware driver defines .......................................................... 885

55.3.1 I2S .................................................................................................. 885

56 LL IWDG Generic Driver .............................................................. 887

56.1 IWDG Firmware driver API description ......................................... 887

56.1.1 Detailed description of functions .................................................... 887

56.2 IWDG Firmware driver defines ...................................................... 890

56.2.1 IWDG .............................................................................................. 890

57 LL PWR Generic Driver ............................................................... 892

57.1 PWR Firmware driver API description ........................................... 892

57.1.1 Detailed description of functions .................................................... 892

57.2 PWR Firmware driver defines ....................................................... 897

57.2.1 PWR ............................................................................................... 897

58 LL RCC Generic Driver ................................................................ 899

58.1 RCC Firmware driver registers structures ..................................... 899

58.1.1 LL_RCC_ClocksTypeDef ............................................................... 899

58.2 RCC Firmware driver API description ........................................... 899

58.2.1 Detailed description of functions .................................................... 899

58.3 RCC Firmware driver defines ........................................................ 921

58.3.1 RCC ................................................................................................ 921

59 LL RTC Generic Driver ................................................................ 927

UM1850

Contents

DocID027328 Rev 2

19/1166

59.1 RTC Firmware driver registers structures ..................................... 927

59.1.1 LL_RTC_InitTypeDef ...................................................................... 927

59.1.2 LL_RTC_TimeTypeDef................................................................... 927

59.1.3 LL_RTC_AlarmTypeDef ................................................................. 927

59.2 RTC Firmware driver API description ............................................ 928

59.2.1 Detailed description of functions .................................................... 928

59.3 RTC Firmware driver defines ........................................................ 944

59.3.1 RTC ................................................................................................ 944

60 LL SPI Generic Driver .................................................................. 947

60.1 SPI Firmware driver registers structures ....................................... 947

60.1.1 LL_SPI_InitTypeDef ....................................................................... 947

60.2 SPI Firmware driver API description ............................................. 948

60.2.1 Detailed description of functions .................................................... 948

60.3 SPI Firmware driver defines .......................................................... 965

60.3.1 SPI .................................................................................................. 965

61 LL SYSTEM Generic Driver ......................................................... 967

61.1 SYSTEM Firmware driver API description .................................... 967

61.1.1 Detailed description of functions .................................................... 967

61.2 SYSTEM Firmware driver defines ................................................. 975

61.2.1 SYSTEM ......................................................................................... 975

62 LL TIM Generic Driver ................................................................. 977

62.1 TIM Firmware driver registers structures ....................................... 977

62.1.1 LL_TIM_InitTypeDef ....................................................................... 977

62.1.2 LL_TIM_OC_InitTypeDef................................................................ 977

62.1.3 LL_TIM_IC_InitTypeDef ................................................................. 978

62.1.4 LL_TIM_ENCODER_InitTypeDef ................................................... 979

62.1.5 LL_TIM_HALLSENSOR_InitTypeDef ............................................. 980

62.1.6 LL_TIM_BDTR_InitTypeDef ........................................................... 980

62.2 TIM Firmware driver API description ............................................. 981

62.2.1 Detailed description of functions .................................................... 981

62.3 TIM Firmware driver defines........................................................ 1043

62.3.1 TIM ................................................................................................ 1043

63 LL USART Generic Driver ......................................................... 1054

63.1 USART Firmware driver registers structures ............................... 1054

63.1.1 LL_USART_InitTypeDef ............................................................... 1054

63.1.2 LL_USART_ClockInitTypeDef ...................................................... 1054

Contents

UM1850

20/1166

DocID027328 Rev 2

63.2 USART Firmware driver API description ..................................... 1055

63.2.1 Detailed description of functions .................................................. 1055

63.3 USART Firmware driver defines .................................................. 1099

63.3.1 USART.......................................................................................... 1099

64 LL UTILS Generic Driver ........................................................... 1103

64.1 UTILS Firmware driver registers structures ................................. 1103

64.1.1 LL_UTILS_PLLInitTypeDef .......................................................... 1103

64.1.2 LL_UTILS_ClkInitTypeDef ............................................................ 1103

64.2 UTILS Firmware driver API description ....................................... 1103

64.2.1 System Configuration functions .................................................... 1103

64.2.2 Detailed description of functions .................................................. 1104

64.3 UTILS Firmware driver defines .................................................... 1106

64.3.1 UTILS............................................................................................ 1106

65 LL WWDG Generic Driver ......................................................... 1108

65.1 WWDG Firmware driver API description ..................................... 1108

65.1.1 Detailed description of functions .................................................. 1108

65.2 WWDG Firmware driver defines .................................................. 1112

65.2.1 WWDG.......................................................................................... 1112

66 Correspondence between API registers and API low-layer driver

functions ............................................................................................. 1113

66.1 ADC ............................................................................................ 1113

66.2 BUS ............................................................................................. 1117

66.3 CORTEX ..................................................................................... 1125

66.4 CRC ............................................................................................ 1126

66.5 DAC ............................................................................................ 1126

66.6 DMA ............................................................................................ 1128

66.7 EXTI ............................................................................................ 1131

66.8 GPIO ........................................................................................... 1131

66.9 I2C .............................................................................................. 1132

66.10 I2S ............................................................................................... 1136

66.11 IWDG .......................................................................................... 1137

66.12 PWR ............................................................................................ 1138

66.13 RCC ............................................................................................ 1138

66.14 RTC ............................................................................................. 1141

66.15 SPI .............................................................................................. 1142

剩余1165页未读，继续阅读

xingpeng_89

粉丝: 82
资源: 2

STM32 HAL库全面指南：1166页最新API详解

STM32入门教程(HAL库).pdf

STM32F1HAL库手册英文版.pdf

STM32HAL库函数用户手册.pdf

stm32 hal库入门pdf

stm32f4hal库开发手册pdf

stm32 hal教程 pdf

stm32hal库开发手册pdf

正点原子stm32资料

[野火embedfire]《stm32 hal库开发实战指南——f103系列》.pdf

stm32 f1系列hal库使用手册文档翻译.pdf

最新资源