STM32 HAL库函数中文参考手册.pdfVIP

STM32HAL库函数中文参考手册

概述

STM32HAL库是STMicroelectronics推出的硬件抽象层库，为STM32

系列微控制器提供统一的编程接口。本手册系统整理HAL库常用函数的中文说

明，涵盖GPIO、定时器、串口等主要外设模块，帮助开发者快速掌握HAL库

的使用方法。

通用外设控制结构

HAL库采用统一的句柄机制管理外设。以UART为例，典型控制结构包含

以下要素：

UART_HandleTypeDef结构体包含串口工作参数，如波特率、数据位、

停止位等配置项。初始化时应先填充该结构体，再调用HAL_UART_Init函数

完成硬件配置。所有HAL库函数均返回HAL_StatusTypeDef枚举值，指示操

作状态（成功/超时/错误等）。

GPIO控制函数

基本IO操作

HAL_GPIO_WritePin函数用于设置指定引脚电平。该函数接收GPIO端

口基地址、引脚编号和电平值（GPIO_PIN_SET/GPIO_PIN_RESET）三个参

数。实际开发中建议使用宏定义封装引脚编号，提高代码可读性。

HAL_GPIO_ReadPin函数读取引脚当前状态。需注意该函数返回值为

GPIO_PinState类型，应与具体电平常量比较而非直接当作布尔值使用。在高

速采样场景下，建议配合缓存机制减少函数调用开销。

中断控制

HAL_GPIO_EXTI_IRQHandler处理外部中断请求。该函数自动清除中断

标志位并调用对应的回调函数。典型应用场景包括按键检测和外部事件触发。

HAL_GPIO_EXTI_Callback是弱定义的中断回调函数，用户应在工程中重

写该函数实现具体业务逻辑。多引脚共享中断时，需在回调函数内通过

HAL_GPIO_ReadPin区分触发源。

表1GPIO常用函数说明

函数原型功能描述典型应用

voidHAL_GPIO_Init(GPIO_TypeDef,初始化配置引脚工

GPIO_InitTypeDef)GPIO引作模式/上

脚下拉

HAL_StatusTypeDef锁定引脚防止意外修

HAL_GPIO_LockPin(GPIO_TypeDef*,uint16_t)配置改关键引脚

voidHAL_GPIO_TogglePin(GPIO_TypeDef*,翻转引脚LED闪烁/

uint16_t)电平信号生成

定时器控制函数

基础定时功能

HAL_TIM_Base_Init初始化定时器基本参数。需配合

HAL_TIM_Base_Start启动定时器。在PWM应用场景中，应改用

HAL_TIM_PWM_Init系列函数。

HAL_TIM_PeriodElapsedCallback是定时器溢出回调函数。实际工程中

常在此函数内实现软件定时、任务调度等功能。需注意回调函数执行时间应小

于定时周期。

高级控制功能

HAL_TIM_OC_Start_IT开启输出比较中断模式。该模式可用于精确时间测

量和脉冲生成。配合HAL_TIM_OC_DelayElapsedCallback回调函数实现可变

占空比控制。

HAL_TIM_