STM32 HAL库常用函数学习指南（初阶篇）

STM32 HAL（硬件抽象层）库为STM32微控制器提供了一套丰富的API，用于简化硬件访问和配置。由于HAL库中的函数数量众多，这里将列举一些常用的函数，并对其进行简要解释。请注意，由于篇幅限制，无法列出HAL库中的所有函数，但将涵盖多个关键领域，如GPIO、定时器、串口、ADC等。

1. GPIO相关函数

HAL_GPIO_Init()

功能：初始化GPIO引脚。

参数：GPIO端口指针和GPIO初始化结构体指针。

返回值：HAL状态。

HAL_GPIO_WritePin()

功能：设置GPIO引脚电平。

参数：GPIO端口指针、引脚编号、引脚状态（高电平或低电平）。

返回值：无。

HAL_GPIO_ReadPin()

功能：读取GPIO引脚电平。

参数：GPIO端口指针、引脚编号。

返回值：引脚状态（高电平或低电平）。

HAL_GPIO_TogglePin()

功能：翻转GPIO引脚电平。

参数：GPIO端口指针、引脚编号。

返回值：无。

2. 定时器相关函数

HAL_TIM_Base_Start()

功能：启动定时器基础计数。

参数：定时器句柄指针。

返回值：HAL状态。

HAL_TIM_Base_Stop()

功能：停止定时器基础计数。

参数：定时器句柄指针。

返回值：HAL状态。

HAL_TIM_Base_Start_IT()

功能：启动定时器基础计数并启用中断。

参数：定时器句柄指针。

返回值：HAL状态。

HAL_TIM_Base_Stop_IT()

功能：停止定时器基础计数并禁用中断。

参数：定时器句柄指针。

返回值：HAL状态。

HAL_TIM_PWM_Start()

功能：启动定时器的PWM输出。

参数：定时器句柄指针、PWM通道。

返回值：HAL状态。

HAL_TIM_PWM_Stop()

功能：停止定时器的PWM输出。

参数：定时器句柄指针、PWM通道。

返回值：HAL状态。

3. 串口（USART）相关函数

HAL_UART_Init()

功能：初始化串口。

参数：串口句柄指针。

返回值：HAL状态。

HAL_UART_Transmit()

功能：以阻塞模式发送数据。

参数：串口句柄指针、数据指针、数据长度、超时时间。

返回值：HAL状态。

HAL_UART_Receive()

功能：以阻塞模式接收数据（不推荐，可能阻塞程序）。

参数：串口句柄指针、数据缓冲区指针、数据长度、超时时间。

返回值：HAL状态。

HAL_UART_Transmit_IT()

功能：以中断模式发送数据。

参数：串口句柄指针、数据指针、数据长度。

返回值：HAL状态。

HAL_UART_Receive_IT()

功能：以中断模式接收数据。

参数：串口句柄指针、数据缓冲区指针、数据长度。

返回值：HAL状态。

4. ADC相关函数

HAL_ADC_Start()

功能：启动ADC转换（阻塞模式）。

参数：ADC句柄指针。

返回值：HAL状态。

HAL_ADC_Stop()

功能：停止ADC转换。

参数：ADC句柄指针。

返回值：HAL状态。

HAL_ADC_Start_IT()

功能：启动ADC转换（中断模式）。

参数：ADC句柄指针。

返回值：HAL状态。

HAL_ADC_Stop_IT()

功能：停止ADC转换（中断模式）。

参数：ADC句柄指针。

返回值：HAL状态。

HAL_ADC_GetValue()

功能：获取ADC转换结果。

参数：ADC句柄指针。

返回值：转换结果。

5. 系统相关函数

HAL_Init()

功能：初始化HAL库。

参数：无。

返回值：无。

HAL_Delay()

功能：实现毫秒级延时。

参数：延时时间（毫秒）。

返回值：无。

HAL_GetTick()

功能：获取系统启动以来的毫秒数。

参数：无。

返回值：毫秒数。

请注意，上述函数列表和解释仅涵盖了STM32 HAL库中的一小部分常用函数。HAL库还包含许多其他函数，用于配置和管理STM32微控制器的各种外设和功能。为了全面了解HAL库，建议参考STMicroelectronics官方文档或HAL库参考手册。

作者：科创工作室li