打印
[其他ST产品]

STM32 HAL库详解

[复制链接]
2428|65
手机看帖
扫描二维码
随时随地手机跟帖
跳转到指定楼层
楼主
原来是wjc|  楼主 | 2023-8-27 16:20 | 只看该作者 回帖奖励 |倒序浏览 |阅读模式
1. HAL库文件结构

对于开发人员而言,首先要清楚 HAL 库的文件结构。

根据文件类型可认为以下两大类:

库文件:
        stm32f2xx_hal_ppp.c/.h                        // 主要的外设或者模块的驱动源文件,包含了该外设的通用API
        stm32f2xx_hal_ppp_ex.c/.h                // 外围设备或模块驱动程序的扩展文件。这组文件中包含特定型号或者系列的芯片的特殊API。以及如果该特定的芯片内部有不同的实现方式,则该文件中的特殊API将覆盖_ppp中的通用API。
        stm32f2xx_hal.c/.h                                // 此文件用于HAL初始化,并且包含DBGMCU、重映射和基于systick的时间延迟等相关的API
        其他库文件
用户级别文件:
        stm32f2xx_hal_msp_template.c        // 只有.c没有.h。它包含用户应用程序中使用的外设的MSP初始化和反初始化(主程序和回调函数)。使用者复制到自己目录下使用模板。
        stm32f2xx_hal_conf_template.h        // 用户级别的库配置文件模板。使用者复制到自己目录下使用
        system_stm32f2xx.c                                // 此文件主要包含SystemInit()函数,该函数在刚复位及跳到main之前的启动过程中被调用。 **它不在启动时配置系统时钟(与标准库相反)**。 时钟的配置在用户文件中使用HAL API来完成。
        startup_stm32f2xx.s                                // 芯片启动文件,主要包含堆栈定义,终端向量表等
        stm32f2xx_it.c/.h                                // 中断服务函数的相关实现
        main.c/.h                                                //


使用特权

评论回复
沙发
原来是wjc|  楼主 | 2023-8-27 16:20 | 只看该作者
与我们密切相关的有

主函数: main.c/.h
MSP初始化: stm32f2xx_hal_msp_template.c
中断服务函数: stm32f2xx_it.c/.h

使用特权

评论回复
板凳
原来是wjc|  楼主 | 2023-8-27 16:20 | 只看该作者
2. HAL库用户代码
HAL 库对底层进行了抽象,在此结构下,用户代码处理可分为三大部分:

句柄
MSP
回调函数
关于这三点,也可参考这里进行理解,

使用特权

评论回复
地板
原来是wjc|  楼主 | 2023-8-27 16:20 | 只看该作者
1、关于句柄

HAL库在结构上,对每个外设抽象成了一个称为ppp_HandleTypeDef的结构体,其中ppp就是每个外设的名字。

与标准库中的结构体相比,HAL 库中的结构体包含了其可能出现的所有定义,比如用户想要使用ADC,只要定义一个ADC_HandleTypeDef的全局变量,针对不同的应用场景配置不同结构体成员就可以满足使用要求。

使用特权

评论回复
5
原来是wjc|  楼主 | 2023-8-27 16:21 | 只看该作者
2、MSP
MSP(MCU Specific Package,单片机的具体方案),是指和MCU相关的初始化

初始化函数包含的内容可分为两部分:

一部分是与MCU无关的,通信协议;
一部分是与MCU相关的,引脚功能。
这里可以结合博主关于串口的说明USART and UART进行理解。

使用特权

评论回复
6
原来是wjc|  楼主 | 2023-8-27 16:21 | 只看该作者
以串口为例,在 MX_USART1_UART_Init(void) 函数中初始化串口的波特率、停止位、奇偶校验等,这部分代码是与串口协议相关的,并未涉及到具体的引脚,因此与 MCU 是无关的,是抽象的。

使用特权

评论回复
7
原来是wjc|  楼主 | 2023-8-27 16:21 | 只看该作者
static void MX_USART1_UART_Init(void)
{

  huart1.Instance = USART1;
  huart1.Init.BaudRate = 115200;  
  huart1.Init.WordLength = UART_WORDLENGTH_8B;
  huart1.Init.StopBits = UART_STOPBITS_1;
  huart1.Init.Parity = UART_PARITY_NONE;
  huart1.Init.Mode = UART_MODE_TX_RX;
  huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;
  huart1.Init.OverSampling = UART_OVERSAMPLING_16;
  huart1.Init.OneBitSampling = UART_ONE_BIT_SAMPLE_DISABLE;
  huart1.AdvancedInit.AdvFeatureInit = UART_ADVFEATURE_NO_INIT;
  if (HAL_UART_Init(&huart1) != HAL_OK)
  {
    _Error_Handler(__FILE__, __LINE__);
  }
    __HAL_UART_ENABLE_IT(&huart1, UART_IT_IDLE);

}

使用特权

评论回复
8
原来是wjc|  楼主 | 2023-8-27 16:21 | 只看该作者
在 stm32f0xx_hal_msp.c 文件中的 HAL_UART_MspInit(UART_HandleTypeDef* huart) 函数中将串口所时用的 MCU 引脚模式进行配置,这部分是与 MCU 具体相关的。

使用特权

评论回复
9
原来是wjc|  楼主 | 2023-8-27 16:21 | 只看该作者
在 stm32f0xx_hal_msp.c 文件中的 HAL_UART_MspInit(UART_HandleTypeDef* huart) 函数中将串口所时用的 MCU 引脚模式进行配置,这部分是与 MCU 具体相关的。

使用特权

评论回复
10
原来是wjc|  楼主 | 2023-8-27 16:21 | 只看该作者
void HAL_UART_MspInit(UART_HandleTypeDef* huart)
{
  // 关于 GPIO 引脚初始化的流程与上面介绍的“四步”相同
  GPIO_InitTypeDef GPIO_InitStruct;
  if(huart->Instance==USART2)   // USART 2
  {
  /* USER CODE BEGIN USART2_MspInit 0 */

  /* USER CODE END USART2_MspInit 0 */
    /* Peripheral clock enable */
    __HAL_RCC_USART2_CLK_ENABLE(); // 使能串口时钟
  
    /**USART2 GPIO Configuration   
    PA2     ------> USART2_TX
    PA3     ------> USART2_RX
    */
    GPIO_InitStruct.Pin = USART2_TX_Pin|USART2_RX_Pin;  // 收发引脚
    GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;  // 复用推挽输出
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
    GPIO_InitStruct.Alternate = GPIO_AF1_USART2;  // 复用功能配置
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);  // 结构体初始化

    /* USART2 DMA Init */    // DMA 方式收发初始化
    /* USART2_RX Init */
    hdma_usart2_rx.Instance = DMA1_Channel3;
    hdma_usart2_rx.Init.Direction = DMA_PERIPH_TO_MEMORY;
    hdma_usart2_rx.Init.PeriphInc = DMA_PINC_DISABLE;
    hdma_usart2_rx.Init.MemInc = DMA_MINC_ENABLE;
    hdma_usart2_rx.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE;
    hdma_usart2_rx.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE;
    hdma_usart2_rx.Init.Mode = DMA_NORMAL;
    hdma_usart2_rx.Init.Priority = DMA_PRIORITY_LOW;
    if (HAL_DMA_Init(&hdma_usart2_rx) != HAL_OK)
    {
      _Error_Handler(__FILE__, __LINE__);
    }

    __HAL_DMA1_REMAP(HAL_DMA1_CH3_USART2_RX);

    __HAL_LINKDMA(huart,hdmarx,hdma_usart2_rx);

    /* USART2_TX Init */
    hdma_usart2_tx.Instance = DMA1_Channel4;
    hdma_usart2_tx.Init.Direction = DMA_MEMORY_TO_PERIPH;
    hdma_usart2_tx.Init.PeriphInc = DMA_PINC_DISABLE;
    hdma_usart2_tx.Init.MemInc = DMA_MINC_ENABLE;
    hdma_usart2_tx.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE;
    hdma_usart2_tx.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE;
    hdma_usart2_tx.Init.Mode = DMA_NORMAL;
    hdma_usart2_tx.Init.Priority = DMA_PRIORITY_LOW;
    if (HAL_DMA_Init(&hdma_usart2_tx) != HAL_OK)
    {
      _Error_Handler(__FILE__, __LINE__);
    }

    __HAL_DMA1_REMAP(HAL_DMA1_CH4_USART2_TX);

    __HAL_LINKDMA(huart,hdmatx,hdma_usart2_tx);

    /* USART2 interrupt Init */
    HAL_NVIC_SetPriority(USART2_IRQn, 0, 0);
    HAL_NVIC_EnableIRQ(USART2_IRQn);
  /* USER CODE BEGIN USART2_MspInit 1 */

  /* USER CODE END USART2_MspInit 1 */
  }
}

使用特权

评论回复
11
原来是wjc|  楼主 | 2023-8-27 16:22 | 只看该作者
3、回调函数
在标准库中,串口中断了以后,我们要先在中断中判断是否是接收中断,然后读出数据,顺便清除中断标志位,然后再是对数据的处理。这样如果我们在一个中断函数中写这么多代码,就会显得很混乱。

而在HAL库中,以GPIO为例,进入中断后,直接由HAL库中断函数HAL_GPIO_EXTI_IRQHandler() 进行托管。

使用特权

评论回复
12
原来是wjc|  楼主 | 2023-8-27 16:22 | 只看该作者
而该函数主要完成两项任务:

清除中断标志位
调用回调函数处理中断
// EXIT 外部中断服务函数
void EXTI0_1_IRQHandler(void)
{
  HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_10);
}


// HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_10)函数如下
void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin)
{
  /* EXTI line interrupt detected */
  if(__HAL_GPIO_EXTI_GET_IT(GPIO_Pin) != RESET)
  {
    __HAL_GPIO_EXTI_CLEAR_IT(GPIO_Pin);
    HAL_GPIO_EXTI_Callback(GPIO_Pin);
  }
}

使用特权

评论回复
13
原来是wjc|  楼主 | 2023-8-27 16:22 | 只看该作者
在回调函数内对中断进行处理,这种方式增强了代码的逻辑性,但也增加了文件的嵌套程度。

使用特权

评论回复
14
原来是wjc|  楼主 | 2023-8-27 16:22 | 只看该作者
3. HAL库编程方式
在 HAL 库中对外设模型进行了统一,支持三种编程方式:

轮询模式/阻塞模式
中断方式
DMA模式

使用特权

评论回复
15
原来是wjc|  楼主 | 2023-8-27 16:23 | 只看该作者
以IIC为例,三种编程模式对应的函数如下:

1、轮询模式/阻塞模式

HAL_I2C_Master_Transmit();  
HAL_I2C_Master_Receive();  
HAL_I2C_Slave_Transmit();  
HAL_I2C_Slave_Receive()
HAL_I2C_Mem_Write();      
HAL_I2C_Mem_Read();   
HAL_I2C_IsDeviceReady()

使用特权

评论回复
16
原来是wjc|  楼主 | 2023-8-27 16:23 | 只看该作者
2、中断模式
HAL_I2C_Master_Transmit_IT();    
HAL_I2C_Master_Receive_IT();  
HAL_I2C_Slave_Transmit_IT()
HAL_I2C_Slave_Receive_IT();   
HAL_I2C_Mem_Write_IT();      
HAL_I2C_Mem_Read_IT()

使用特权

评论回复
17
原来是wjc|  楼主 | 2023-8-27 16:23 | 只看该作者
3、DMA模式
HAL_I2C_Master_Transmit_DMA();   
HAL_I2C_Master_Receive_DMA();   
HAL_I2C_Slave_Transmit_DMA();   
HAL_I2C_Slave_Receive_DMA();   
HAL_I2C_Mem_Write_DMA();     
HAL_I2C_Mem_Read_DMA()

使用特权

评论回复
18
Stahan| | 2023-9-2 23:43 | 只看该作者
感觉HAL里面好多都是判断,逻辑很严谨但是太冗杂了

使用特权

评论回复
19
fengm| | 2023-9-5 10:19 | 只看该作者
HAL库提供了抽象化的硬件接口,屏蔽了底层硬件差异,使得开发者可以更方便地编写可移植的代码。

使用特权

评论回复
20
linfelix| | 2023-9-5 10:59 | 只看该作者
STM32 HAL库是一种基于HAL的软件开发库,提供了丰富的驱动程序和API,可以帮助开发者快速设计和调试STM32应用程序。

使用特权

评论回复
发新帖 我要提问
您需要登录后才可以回帖 登录 | 注册

本版积分规则

78

主题

994

帖子

0

粉丝