一文搞懂 HAL 库

一文搞懂 HAL 库是什么，以及如何使用。

相比较早几年使用标准库开发来讲，最近几年 HAL 库的使用是越来越多，那么我们开发应当使用哪一种呢，本文着重介绍常用的几种开发方式及相互之间的区别，白猫也好、黑猫也好，抓到耗子就是好猫。

STM32 的三种开发方式

通常新手在入门 STM32 的时候，首先都要先选择一种要用的开发方式，不同的开发方式会导致你编程的架构是完全不一样的。一般大多数都会选用标准库和 HAL 库，而极少部分人会通过直接配置寄存器进行开发。

网上关于标准库、HAL 库的描述相信是数不胜数。可是一个对于很多刚入门的朋友还是没法很直观的去真正了解这些不同开发发方式彼此之间的区别，所以笔者想以一种非常直白的方式，用自己的理解去将这些东西表述出来，如果有描述的不对的地方或者是不同意见的也可以大家提出。

直接配置寄存器

不少先学了 51 的朋友可能会知道，会有一小部分人或是教程是通过汇编语言直接操作寄存器实现功能的，这种方法到了 STM32 就变得不太容易行得通了，因为 STM32 的寄存器数量是 51 单片机的十数倍，如此多的寄存器根本无法全部记忆，开发时需要经常的翻查芯片的数据手册，此时直接操作寄存器就变得非常的费力了。但还是会有很小一部分人，喜欢去直接操作寄存器，因为这样更接近原理，知其然也知其所以然。

标准库

上面也提到了，STM32 有非常多的寄存器，而导致了开发困难，所以为此 ST 公司就为每款芯片都编写了一份库文件，也就是工程文件里 stm32F1xx… 之类的。在这些 .c .h 文件中，包括一些常用量的宏定义，把一些外设也通过结构体变量封装起来，如 GPIO 口时钟等。所以我们只需要配置结构体变量成员就可以修改外设的配置寄存器，从而选择不同的功能。也是目前最多人使用的方式，也是学习 STM32 接触最多的一种开发方式，我也就不多阐述了。

HAL库

HAL 库是 ST 公司目前主力推的开发方式，全称就是 Hardware Abstraction Layer（抽象硬件层）。库如其名，很抽象，一眼看上去不太容易知道他的作用是什么。

它的出现比标准库要晚，但其实和标准库一样，都是为了节省程序开发的时期，而且 HAL 库尤其的有效，如果说标准库把实现功能需要配置的寄存器集成了，那么 HAL 库的一些函数甚至可以做到某些特定功能的集成。也就是说，同样的功能，标准库可能要用几句话，HAL 库只需用一句话就够了。

并且 HAL 库也很好的解决了程序移植的问题，不同型号的 stm32 芯片它的标准库是不一样的，例如在 F4 上开发的程序移植到 F3 上是不能通用的，而使用 HAL 库，只要使用的是相同的外设，程序基本可以完全复制粘贴，注意是相同外设，意思也就是不能无中生有，例如 F7 比 F3 要多几个定时器，不能明明没有这个定时器却非要配置，但其实这种情况不多，绝大多数都可以直接复制粘贴。是而且使用 ST 公司研发的 STMcube 软件，可以通过图形化的配置功能，直接生成整个使用 HAL 库的工程文件，可以说是方便至极，但是方便的同时也造成了它执行效率的低下，在各种论坛帖子真的是被吐槽的数不胜数。

HAL库固件库安装

Cube 中选择 updater Settings

首先设置让 Cube 可以自动联网下载相关固件库，选择 updater Settings。

设置如下：

根据芯片选择所需固件

版本是向下兼容的，可以直接选择最新版。但如果觉得最新版太大，可以阅读下面的Main Changes。能够支持你目前的芯片就好。

选好了，点击 Install Now 就行，过程可能有点长。建议直接官网下载到本地，再安装文件会被下载到如下位置，建议更改此目录，不要选在 C 盘！！！

寻找用户帮助手册

进入固件所在文件夹，里面包含很多内容。

比如说，官方提供的开发板程序，每个型号下面都有对应功能的实现，用户手册就在Drivers文件夹下面。

HAL 库与标准库的区别

从 句柄、MSP 函数、Callback 函数这三点谈不同之处。

句柄

句柄（handle），有多种意义，其中第一种是指程序设计，第二种是指 Windows 编程。现在大部分都是指程序设计/程序开发这类。

• 第一种解释：句柄是一种特殊的智能指针。当一个应用程序要引用其他系统（如数据库、操作系统）所管理的内存块或对象时，就要使用句柄。
• 第二种解释：整个 Windows 编程的基础。一个句柄是指使用的一个唯一的整数值，即一个 4 字节(64 位程序中为 8 字节)长的数值，来标识应用程序中的不同对象和同类中的不同的实例，诸如，一个窗口，按钮，图标，滚动条，输出设备，控件或者文件等。应用程序能够通过句柄访问相应的对象的信息，但是句柄不是指针，程序不能利用句柄来直接阅读文件中的信息。如果句柄不在 I/O 文件中，它是毫无用处的。句柄是 Windows 用来标志应用程序中建立的或是使用的唯一整数，Windows 大量使用了句柄来标识对象。

STM32 的标准库中，句柄是一种特殊的指针，通常指向结构体！

在 STM32 的标准库中，假设我们要初始化一个外设（这里以 USART 为例），我们首先要初始化他们的各个寄存器。在标准库中，这些操作都是利用固件库结构体变量 + 固件库 Ini t函数实现的：

USART_InitTypeDef USART_InitStructure;

USART_InitStructure.USART_BaudRate = bound;//串口波特率
USART_InitStructure.USART_WordLength = USART_WordLength_8b;//字长为8位数据格式
USART_InitStructure.USART_StopBits = USART_StopBits_1;//一个停止位
USART_InitStructure.USART_Parity = USART_Parity_No;//无奇偶校验位
USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None;//无硬件数据流控制
USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; //收发模式

USART_Init(USART3, &USART_InitStructure); //初始化串口1

可以看到，要初始化一个串口，需要：

1. 对六个位置进行赋值
2. 然后引用 Init 函数

USART_InitStructure 并不是一个全局结构体变量，而是只在函数内部的局部变量，初始化完成之后，USART_InitStructure 就失去了作用。而在 HAL 库中，同样是 USART 初始化结构体变量，我们要定义为全局变量。

UART_HandleTypeDef UART1_Handler;

右键查看结构体成员

typedef struct
{
   USART_TypeDef                 *Instance;        /*!< UART registers base address        */
   UART_InitTypeDef              Init;             /*!< UART communication parameters      */
   uint8_t                       *pTxBuffPtr;      /*!< Pointer to UART Tx transfer Buffer */
   uint16_t                      TxXferSize;       /*!< UART Tx Transfer size              */
   uint16_t                      TxXferCount;      /*!< UART Tx Transfer Counter           */
   uint8_t                       *pRxBuffPtr;      /*!< Pointer to UART Rx transfer Buffer */
   uint16_t                      RxXferSize;       /*!< UART Rx Transfer size              */
   uint16_t                      RxXferCount;      /*!< UART Rx Transfer Counter           */  
   DMA_HandleTypeDef             *hdmatx;          /*!< UART Tx DMA Handle parameters      */ 
   DMA_HandleTypeDef             *hdmarx;          /*!< UART Rx DMA Handle parameters      */
   HAL_LockTypeDef               Lock;             /*!< Locking object                     */
   __IO HAL_UART_StateTypeDef    State;            /*!< UART communication state           */
   __IO uint32_t                 ErrorCode;        /*!< UART Error code                    */
}UART_HandleTypeDef;

我们发现，与标准库不同的是，该成员不仅:

1. 包含了之前标准库就有的六个成员（波特率，数据格式等），
2. 还包含过采样、（发送或接收的）数据缓存、数据指针、串口 DMA 相关的变量、各种标志位等等要在整个项目流程中都要设置的各个成员。

该 UART1_Handler 就被称为串口的句柄，它被贯穿整个 USART 收发的流程，比如开启中断：

HAL_UART_Receive_IT(&UART1_Handler, (u8 *)aRxBuffer, RXBUFFERSIZE);

比如后面要讲到的 MSP 与 Callback 回调函数：

void HAL_UART_MspInit(UART_HandleTypeDef *huart);
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart);

在这些函数中，只需要调用初始化时定义的句柄 UART1_Handler 就好。

MSP函数

MSP: MCU Specific Package 单片机的具体方案

MSP 是指和 MCU 相关的初始化，引用一下正点原子的解释，个人觉得说的很明白：

我们要初始化一个串口，首先要设置和 MCU 无关的东西，例如波特率，奇偶校验，停止位等，这些参数设置和 MCU 没有任何关系，可以使用 STM32F1，也可以是 STM32F2/F3/F4/F7上的串口。而一个串口设备它需要一个 MCU 来承载，例如用 STM32F4 来做承载，PA9 做为发送，PA10 做为接收，MSP 就是要初始化 STM32F4 的 PA9,PA10，配置这两个引脚。所以 HAL驱动方式的初始化流程就是：

• HAL_USART_Init() —> HAL_USART_MspInit() ，先初始化与 MCU 无关的串口协议，再初始化与 MCU 相关的串口引脚。
• 在 STM32 的 HAL 驱动中 HAL_PPP_MspInit() 作为回调，被 HAL_PPP_Init() 函数所调用。当我们需要移植程序到 STM32F1 平台的时候，我们只需要修改 HAL_PPP_MspInit 函数内容而不需要修改 HAL_PPP_Init 入口参数内容。

在HAL库中，几乎每初始化一个外设就需要设置该外设与单片机之间的联系，比如 IO 口，是否复用等等，可见，HAL 库相对于标准库多了 MSP 函数之后，移植性非常强，但与此同时却增加了代码量和代码的嵌套层级。可以说各有利弊。

同样，MSP 函数又可以配合句柄，达到非常强的移植性：

void HAL_UART_MspInit(UART_HandleTypeDef *huart);

Callback函数

类似于 MSP 函数，个人认为 Callback 函数主要帮助用户应用层的代码编写。

还是以 USART 为例，在标准库中，串口中断了以后，我们要先在中断中判断是否是接收中断，然后读出数据，顺便清除中断标志位，然后再是对数据的处理，这样如果我们在一个中断函数中写这么多代码，就会显得很混乱：

void USART3_IRQHandler(void)                 //串口1中断服务程序
{
   u8 Res;

   if(USART_GetITStatus(USART3, USART_IT_RXNE) != RESET)  //接收中断(接收到的数据必须是0x0d 0x0a结尾)
   {
      Res =USART_ReceiveData(USART3); //读取接收到的数据
      /*数据处理区*/
   }      
} 

而在 HAL 库中，进入串口中断后，直接由 HAL 库中断函数进行托管：

void USART1_IRQHandler(void)                 
{ 
    HAL_UART_IRQHandler(&UART1_Handler); //调用HAL库中断处理公用函数
    /***************省略无关代码****************/ 
}

HAL_UART_IRQHandler 这个函数完成了判断是哪个中断（接收？发送？或者其他？），然后读出数据，保存至缓存区，顺便清除中断标志位等等操作。

比如我提前设置了，串口每接收五个字节，我就要对这五个字节进行处理。在一开始我定义了一个串口接收缓存区：

/*HAL 库使用的串口接收缓冲,处理逻辑由 HAL 库控制，接收完这个数组就会调用 HAL_UART_RxCpltCallback 进行处理这个数组*/
/*RXBUFFERSIZE = 5*/
u8 aRxBuffer[RXBUFFERSIZE];

在初始化中，我在句柄里设置好了缓存区的地址，缓存大小（五个字节）

    /*该代码在 HAL_UART_Receive_IT 函数中，初始化时会引用*/
    huart->pRxBuffPtr = pData;//aRxBuffer
    huart->RxXferSize = Size;//RXBUFFERSIZE
    huart->RxXferCount = Size;//RXBUFFERSIZE

则在接收数据中，每接收完五个字节，HAL_UART_IRQHandler 才会执行一次 Callback 函数：

void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart);

在这个 Callback 回调函数中，我们只需要对这接收到的五个字节（保存在 aRxBuffer[] 中）进行处理就好了，完全不用再去手动清除标志位等操作。

所以说 Callback 函数是一个应用层代码的函数，我们在一开始只设置句柄里面的各个参数，然后就等着HAL库把自己安排好的代码送到手中就可以了~

综上，就是 HAL 库的三个与标准库不同的地方之个人见解。个人觉得从这三个小点就可以看出 HAL 库的可移植性之强大，并且用户可以完全不去理会底层各个寄存器的操作，代码也更有逻辑性。但与此带来的是复杂的代码量，极慢的编译速度，略微低下的效率。看怎么取舍了。

STM32 HAL库结构

说到 STM32 的 HAL 库，就不得不提 STM32CubeMX，其作为一个可视化的配置工具，对于开发者来说，确实大大节省了开发时间。STM32CubeMX 就是以 HAL 库为基础的，且目前仅支持 HAL 库及 LL 库！首先看一下，官方给出的 HAL 库的包含结构：

1. stm32f4xx.h主要包含 STM32 同系列芯片的不同具体型号的定义，是否使用 HAL 库等的定义，接着，其会根据定义的芯片信号包含具体的芯片型号的头文件：

   #if defined(STM32F405xx)
     #include "stm32f405xx.h"
   #elif defined(STM32F415xx)
     #include "stm32f415xx.h"
   #elif defined(STM32F407xx)
     #include "stm32f407xx.h"
   #elif defined(STM32F417xx)
     #include "stm32f417xx.h"
   #else
    #error "Please select first the target STM32F4xx device used in your application (in stm32f2xx.h file)"
   #endif
   

   紧接着，其会包含 stm32f4xx_hal.h。
2. stm32f4xx_hal.h：stm32f4xx_hal.c/h 主要实现 HAL 库的初始化、系统滴答相关函数、及 CPU 的调试模式配置
3. stm32f4xx_hal_conf.h ：该文件是一个用户级别的配置文件，用来实现对 HAL 库的裁剪，其位于用户文件目录，不要放在库目录中。
   接下来对于 HAL 库的源码文件进行一下说明，HAL 库文件名均以 stm32f4xx_hal 开头，后面加上_外设或者模块名（如：stm32f4xx_hal_adc.c）：
4. 库文件：

   stm32f4xx_hal_ppp.c/.h      // 主要的外设或者模块的驱动源文件，包含了该外设的通用 API
   stm32f4xx_hal_ppp_ex.c/.h   // 外围设备或模块驱动程序的扩展文件。这组文件中包含特定型号或者系列的芯片的特殊 API。以及如果该特定的芯片内部有不同的实现方式，则该文件中的特殊 API 将覆盖 _ppp 中的通用 API。  
   stm32f4xx_hal.c/.h          // 此文件用于HAL初始化，并且包含 DBGMCU、重映射和基于 systick 的时间延迟等相关的 API
   

5. 其他库文件
   用户级别文件：

   stm32f4xx_hal_msp_template.c    // 只有.c没有.h。它包含用户应用程序中使用的外设的MSP初始化和反初始化（主程序和回调函数）。使用者复制到自己目录下使用模板。
   stm32f4xx_hal_conf_template.h   // 用户级别的库配置文件模板。使用者复制到自己目录下使用
   system_stm32f4xx.c              // 此文件主要包含SystemInit()函数，该函数在刚复位及跳到main之前的启动过程中被调用。它不在启动时配置系统时钟（与标准库相反）。时钟的配置在用户文件中使用HAL API来完成。
   startup_stm32f4xx.s             // 芯片启动文件，主要包含堆栈定义，中断向量表等
   stm32f4xx_it.c/.h               // 中断处理函数的相关实现
   

6. main.c/.h

根据 HAL 库的命名规则，其 API 可以分为以下几类：

• 初始化/反初始化函数：

  HAL_PPP_Init() 
  HAL_PPP_DeInit()
  

• IO 操作函数：

  HAL_PPP_Read(),
  HAL_PPP_Write(),
  HAL_PPP_Transmit(), 
  HAL_PPP_Receive()
  

• 控制函数：

  HAL_PPP_Set (), 
  HAL_PPP_Get ().
  

• 状态和错误:

  HAL_PPP_GetState (), 
  HAL_PPP_GetError ().
  

Tip

目前 LL 库是和 HAL 库捆绑发布的，所以在 HAL 库源码中，还有一些名为 stm32f2xx_ll_ppp 的源码文件，这些文件就是新增的 LL 库文件。使用 CubeMX 生产项目时，可以选择 LL 库。

HAL 库最大的特点就是对底层进行了抽象。在此结构下，用户代码的处理主要分为三部分：

• 处理外设句柄（实现用户功能）
• 处理 MSP
• 处理各种回调函数

外设句柄定义

用户代码的第一大部分：对于外设句柄的处理。HAL 库在结构上，对每个外设抽象成了一个称为 ppp_HandleTypeDef 的结构体，其中 ppp 就是每个外设的名字。

所有的函数都是工作在 ppp_HandleTypeDef 指针之下。

• 多实例支持：每个外设/模块实例都有自己的句柄。因此，实例资源是独立的
• 外围进程相互通信：该句柄用于管理进程例程之间的共享数据资源。

下面，以ADC为例

/** 
 * @brief  ADC handle Structure definition
 */ 
typedef struct
{
    ADC_TypeDef                   *Instance;                   /*!< Register base address */
    ADC_InitTypeDef               Init;                        /*!< ADC required parameters */
    __IO uint32_t                 NbrOfCurrentConversionRank;  /*!< ADC number of current conversion rank */
    DMA_HandleTypeDef             *DMA_Handle;                 /*!< Pointer DMA Handler */
    HAL_LockTypeDef               Lock;                        /*!< ADC locking object */
    __IO uint32_t                 State;                       /*!< ADC communication state */
    __IO uint32_t                 ErrorCode;                   /*!< ADC Error code */
}ADC_HandleTypeDef;

从上面的定义可以看出，ADC_HandleTypeDef 中包含了 ADC 可能出现的所有定义，对于用户想要使用 ADC 只要定义一个 ADC_HandleTypeDef 的变量，给每个变量赋好值，对应的外设就抽象完了。接下来就是具体使用了。

当然，对于那些共享型外设或者说系统外设来说，他们不需要进行以上这样的抽象，这些部分与原来的标准外设库函数基本一样。例如以下外设：

• GPIO
• SYSTICK
• NVIC
• RCC
• FLASH

以 GPIO 为例，对于 HAL_GPIO_Init() 函数，其只需要 GPIO 地址以及其初始化参数即可。

三种编程方式

HAL 库对所有的函数模型也进行了统一。在 HAL 库中，支持三种编程模式：轮询模式、中断模式、DMA 模式（如果外设支持）。其分别对应如下三种类型的函数（以 ADC 为例）：

HAL_StatusTypeDef HAL_ADC_Start(ADC_HandleTypeDef* hadc);
HAL_StatusTypeDef HAL_ADC_Stop(ADC_HandleTypeDef* hadc);

HAL_StatusTypeDef HAL_ADC_Start_IT(ADC_HandleTypeDef* hadc);
HAL_StatusTypeDef HAL_ADC_Stop_IT(ADC_HandleTypeDef* hadc);

HAL_StatusTypeDef HAL_ADC_Start_DMA(ADC_HandleTypeDef* hadc, uint32_t* pData, uint32_t Length);
HAL_StatusTypeDef HAL_ADC_Stop_DMA(ADC_HandleTypeDef* hadc);

其中，带 _IT 的表示工作在中断模式下；带 _DMA 的工作在 DMA 模式下（注意：DMA 模式下也是开中断的）；什么都没带的就是轮询模式（没有开启中断的）。至于使用者使用何种方式，就看自己的选择了。

此外，新的 HAL 库架构下统一采用宏的形式对各种中断等进行配置（原来标准外设库一般都是各种函数）。针对每种外设主要由以下宏：

__HAL_PPP_ENABLE_IT(HANDLE, INTERRUPT)： 使能一个指定的外设中断
__HAL_PPP_DISABLE_IT(HANDLE, INTERRUPT)：失能一个指定的外设中断
__HAL_PPP_GET_IT (HANDLE, __ INTERRUPT __)：获得一个指定的外设中断状态
__HAL_PPP_CLEAR_IT (HANDLE, __ INTERRUPT __)：清除一个指定的外设的中断状态
__HAL_PPP_GET_FLAG (HANDLE, FLAG)：获取一个指定的外设的标志状态
__HAL_PPP_CLEAR_FLAG (HANDLE, FLAG)：清除一个指定的外设的标志状态
__HAL_PPP_ENABLE(HANDLE) ：使能外设
__HAL_PPP_DISABLE(HANDLE) ：失能外设
__HAL_PPP_XXXX (HANDLE, PARAM) ：指定外设的宏定义
__HAL_PPP_GET IT_SOURCE (HANDLE, __ INTERRUPT __)：检查中断源

三大回调函数

在 HAL 库的源码中，到处可见一些以 __weak 开头的函数，而且这些函数，有些已经被实现了，比如：

__weak HAL_StatusTypeDef HAL_InitTick(uint32_t TickPriority)
{
    /*Configure the SysTick to have interrupt in 1ms time basis*/
    HAL_SYSTICK_Config(SystemCoreClock/1000U);
    /*Configure the SysTick IRQ priority */
    HAL_NVIC_SetPriority(SysTick_IRQn, TickPriority ,0U);
    /* Return function status */
    return HAL_OK;
}

有些则没有被实现，例如：

__weak void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi)
{
    /* Prevent unused argument(s) compilation warning */
    UNUSED(hspi);
    /* NOTE : This function should not be modified, when the callback is needed,the HAL_SPI_TxCpltCallback should be implemented in the user file*/
}

所有带有 __weak 关键字的函数表示，就可以由用户自己来实现。如果出现了同名函数，且不带 __weak 关键字，那么连接器就会采用外部实现的同名函数。

通常来说，HAL 库负责整个处理和 MCU 外设的处理逻辑，并将必要部分以回调函数的形式给出到用户，用户只需要在对应的回调函数中做修改即可。HAL 库包含如下三种用户级别回调函数（PPP 为外设名）：

1. 外设系统级初始化/解除初始化回调函数（用户代码的第二大部分：对于 MSP 的处理）：

   HAL_PPP_MspInit()
   HAL_PPP_MspDeInit()
   

   例如：
   

   __weak void HAL_SPI_MspInit(SPI_HandleTypeDef *hspi)
   

   在 HAL_PPP_Init() 函数中被调用，用来初始化底层相关的设备（GPIOs, clock, DMA, interrupt）
2. 处理完成回调函数：HAL_PPP_ProcessCpltCallback()（Process 指具体某种处理，如 UART 的 Tx），
   例如：
   

   __weak void HAL_SPI_RxCpltCallback(SPI_HandleTypeDef *hspi)
   

3. 当外设或者 DMA 工作完成后时，触发中断，该回调函数会在外设中断处理函数或者 DMA 的中断处理函数中被调用错误处理回调函数：

   HAL_PPP_ErrorCallback()
   

   例如：
   

   __weak void HAL_SPI_ErrorCallback(SPI_HandleTypeDef hspi)
   

绝大多数用户代码均在以上三大回调函数中实现。 HAL 库结构中，在每次初始化前（尤其是在多次调用初始化前），先调用对应的反初始化（DeInit）函数是非常有必要的。

某些外设多次初始化时不调用返回会导致初始化失败。完成回调函数有多种，例如串口的完成回调函数有

HAL_UART_TxCpltCallback 
HAL_UART_TxHalfCpltCallback

用户代码的第三大部分：对于上面第二点和第三点的各种回调函数的处理。在实际使用中，发现 HAL 仍有不少问题，例如在使用 USB 时，其库配置存在问题。

HAL库移植使用

基本步骤：

1. 复制 stm32f2xx_hal_msp_template.c，参照该模板，依次实现用到的外设的 HAL_PPP_MspInit() 和 HAL_PPP_MspDeInit。
2. 复制 stm32f2xx_hal_conf_template.h，用户可以在此文件中自由裁剪，配置 HAL 库。
3. 在使用 HAL 库时，必须先调用函数：HAL_StatusTypeDef HAL_Init(void)（该函数在 stm32f2xx_hal.c 中定义，也就意味着第一点中，必须首先实现 HAL_MspInit(void) 和 HAL_MspDeInit(void)）
4. HAL 库与 STD 库不同，HAL 库使用 RCC 中的函数来配置系统时钟，用户需要单独写时钟配置函数（STD 库默认在 system_stm32f2xx.c 中）
5. 关于中断，HAL 提供了中断处理函数，只需要调用 HAL 提供的中断处理函数。用户自己的代码，不建议先写到中断中，而应该写到 HAL 提供的回调函数中。
6. 对于每一个外设，HAL 都提供了回调函数，回调函数用来实现用户自己的代码。整个调用结构由 HAL 库自己完成。

例如： Uart 中，HAL 提供了

void HAL_UART_IRQHandler(UART_HandleTypeDef *huart);

用户只需要触发中断后，调用该函数即可，同时，自己的代码写在对应的回调函数中即可！如下：

void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart);
void HAL_UART_TxHalfCpltCallback(UART_HandleTypeDef *huart);
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart);
void HAL_UART_RxHalfCpltCallback(UART_HandleTypeDef *huart);
void HAL_UART_ErrorCallback(UART_HandleTypeDef *huart);

使用了哪种就用哪个回调函数即可！

基本结构

综上所述，使用 HAL 库编写程序（针对某个外设）的基本结构（以串口为例）如下：

1. 配置外设句柄 例如，建立 UartConfig.c，在其中定义串口句柄 UART_HandleTypeDef huart; 接着使用初始化句柄 (HAL_StatusTypeDef HAL_UART_Init(UART_HandleTypeDef huart))
2. 编写 Msp 例如，建立 UartMsp.c，在其中实现 void HAL_UART_MspInit(UART_HandleTypeDef huart) 和 void HAL_UART_MspDeInit(UART_HandleTypeDef* huart)
3. 实现对应的回调函数 例如，建立 UartCallBack.c，在其中实现上文所说明的三大回调函数中的完成回调函数和错误回调函数。