HAL库常用函数

一、通用函数

  • 系统初始化:

HAL_Init(): 初始化HAL库和系统时钟(调用前需配置系统时钟源)。

HAL_Delay(uint32_t Delay): 毫秒级阻塞延时(基于SysTick定时器)。

HAL_GetTick(): 获取系统运行时间(毫秒计数器)。

  • 中断管理:

HAL_NVIC_SetPriority(IRQn_Type IRQn, uint32_t PreemptPriority, uint32_t SubPriority): 设置中断优先级。

HAL_NVIC_EnableIRQ(IRQn_Type IRQn): 使能指定中断。

HAL_NVIC_DisableIRQ(IRQn_Type IRQn): 禁用指定中断。

二、GPIO控制

  • 基本操作:

HAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init): 初始化GPIO引脚模式(输入/输出/复用等)。

HAL_GPIO_WritePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState): 设置引脚电平(高/低)。

HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin): 读取引脚电平。

HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin): 翻转引脚电平。

  • 中断相关:

HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin): EXTI中断服务函数中调用,处理引脚中断事件。

HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin): 用户需重写的EXTI中断回调函数。

三、 定时器(TIM)

  • 基础模式:

HAL_TIM_Base_Init(TIM_HandleTypeDef *htim): 初始化定时器基本模式。

HAL_TIM_Base_Start(TIM_HandleTypeDef *htim): 启动定时器(无中断)。

HAL_TIM_Base_Start_IT(TIM_HandleTypeDef *htim): 启动定时器并开启中断。

  • PWM模式:

HAL_TIM_PWM_Start(TIM_HandleTypeDef *htim, uint32_t Channel): 启动PWM输出。

HAL_TIM_PWM_Stop(TIM_HandleTypeDef *htim, uint32_t Channel): 停止PWM输出。

__HAL_TIM_SET_COMPARE(TIM_TypeDef *TIMx, uint32_t Channel, uint32_t Compare): 动态修改PWM占空比。

  • 中断回调:

HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim): 定时器溢出中断回调函数(需用户实现)。

四、 串口通信(UART)

  • 阻塞模式:

HAL_UART_Transmit(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout): 阻塞发送数据。

HAL_UART_Receive(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout): 阻塞接收数据。

  • 中断模式:

HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size): 中断发送数据。

HAL_UART_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size): 中断接收数据。

  • DMA模式:

HAL_UART_Transmit_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size): DMA发送数据。

HAL_UART_Receive_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size): DMA接收数据。

  • 回调函数:

HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart): 发送完成回调函数。

HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart): 接收完成回调函数。

五、ADC模数转换

  • 单次转换:

HAL_ADC_Start(ADC_HandleTypeDef *hadc): 启动ADC转换。

HAL_ADC_PollForConversion(ADC_HandleTypeDef *hadc, uint32_t Timeout): 等待转换完成。

HAL_ADC_GetValue(ADC_HandleTypeDef *hadc): 获取转换结果。

  • 连续扫描模式:

HAL_ADC_Start_IT(ADC_HandleTypeDef *hadc): 启动ADC连续转换(中断模式)。

HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef *hadc): 转换完成回调函数。

六、DMA直接内存访问

  • 数据传输:

HAL_DMA_Start(DMA_HandleTypeDef *hdma, uint32_t SrcAddress, uint32_t DstAddress, uint32_t DataLength): 启动DMA传输。

HAL_DMA_PollForTransfer(DMA_HandleTypeDef *hdma, uint32_t Timeout): 阻塞等待DMA完成。

  • 回调函数:

HAL_DMA_TransferCpltCallback(DMA_HandleTypeDef *hdma): DMA传输完成回调函数。

七、I2C通信

  • 主模式操作:

HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout): 主设备发送数据。

HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout): 主设备接收数据。

  • 中断/DMA模式:

HAL_I2C_Master_Transmit_IT() / HAL_I2C_Master_Transmit_DMA(): 中断或DMA发送。

HAL_I2C_Master_Receive_IT() / HAL_I2C_Master_Receive_DMA(): 中断或DMA接收。

八、SPI通信

  • 主从通信:

HAL_SPI_Transmit(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout): 阻塞发送数据。

HAL_SPI_Receive(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout): 阻塞接收数据。

HAL_SPI_TransmitReceive(): 同时发送和接收数据。

  • 中断/DMA模式:

HAL_SPI_Transmit_IT() / HAL_SPI_Transmit_DMA(): 中断或DMA发送。

九、 系统时钟(RCC)

  • 时钟配置:
    HAL_RCC_ClockConfig(RCC_ClkInitTypeDef *RCC_ClkInitStruct, uint32_t FLatency): 配置系统时钟源和分频。
    HAL_RCC_OscConfig(RCC_OscInitTypeDef *RCC_OscInitStruct): 配置振荡器(HSE/HSI/PLL等)。

十、 看门狗(WWDG/IWDG)

  • 独立看门狗(IWDG):
    HAL_IWDG_Start(IWDG_HandleTypeDef *hiwdg): 启动看门狗。
    HAL_IWDG_Refresh(IWDG_HandleTypeDef *hiwdg): 喂狗操作。
相关推荐
悠哉悠哉愿意4 天前
【单片机学习笔记】串口、超声波、NE555的同时使用
笔记·单片机·学习
Lester_11014 天前
STM32霍尔传感器输入口设置为复用功能输入口时,还能用GPIO函数直接读取IO的状态吗
stm32·单片机·嵌入式硬件·电机控制
LCG元4 天前
低功耗显示方案:STM32L0驱动OLED,动态波形绘制与优化
stm32·嵌入式硬件·信息可视化
三佛科技-187366133974 天前
120W小体积碳化硅电源方案(LP8841SC极简方案12V10A/24V5A输出)
单片机·嵌入式硬件
z20348315204 天前
STM32F103系列单片机定时器介绍(二)
stm32·单片机·嵌入式硬件
古译汉书4 天前
【IoT死磕系列】Day 7:只传8字节怎么控机械臂?学习工业控制 CANopen 的“对象字典”(附企业级源码)
数据结构·stm32·物联网·http
Alaso_shuang4 天前
STM32 核心输入、输出模式
stm32·单片机·嵌入式硬件
脚后跟4 天前
AI助力嵌入式物联网项目全栈开发
嵌入式硬件·物联网·ai编程
2501_918126914 天前
stm32死锁是怎么实现的
stm32·单片机·嵌入式硬件·学习·个人开发
z20348315204 天前
STM32F103系列单片机定时器介绍(一)
stm32·单片机