面包芯语

深入浅出理解STM32HAL库的底层逻辑

芯片之家 2024-07-13 12:15
 AI开发的实战机会来了！ 热管理技术新标杆：ST维也纳PFC与FOC控制方案深度解析

前言

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

STM32三种开发方式

  通常新手在入门STM32的时候，首先都要先选择一种要用的开发方式，不同的开发方式会导致你编程的架构是完全不一样的。一般大多数都会选用标准库和HAL库，而极少部分人会通过直接配置寄存器进行开发。
  网上关于标准库、HAL库的描述相信是数不胜数。可是一个对于很多刚入门的朋友还是没法很直观的去真正了解这些不同开发发方式彼此之间的区别，所以笔者想以一种非常直白的方式，用自己的理解去将这些东西表述出来，如果有描述的不对的地方或者是不同意见的也可以大家提出。

1、直接配置寄存器

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

2、标准库

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

3、HAL库

  HAL库是ST公司目前主力推的开发方式，全称就是Hardware Abstraction Layer（抽象印象层）。库如其名，很抽象，一眼看上去不太容易知道他的作用是什么。
  它的出现比标准库要晚，但其实和标准库一样，都是为了节省程序开发的时期，而且HAL库尤其的有效，如果说标准库把实现功能需要配置的寄存器集成了，那么HAL库的一些函数甚至可以做到某些特定功能的集成。也就是说，同样的功能，标准库可能要用几句话，HAL库只需用一句话就够了。
  并且HAL库也很好的解决了程序移植的问题，不同型号的stm32芯片它的标准库是不一样的，例如在F4上开发的程序移植到F3上是不能通用的，而使用HAL库，只要使用的是相通的外设，程序基本可以完全复制粘贴，注意是相通外设，意思也就是不能无中生有，例如F7比F3要多几个定时器，不能明明没有这个定时器却非要配置，但其实这种情况不多，绝大多数都可以直接复制粘贴。是而且使用ST公司研发的STMcube软件，可以通过图形化的配置功能，直接生成整个使用HAL库的工程文件，可以说是方便至极，但是方便的同时也造成了它执行效率的低下，在各种论坛帖子真的是被吐槽的数不胜数。

HAL库固件库安装与用户手册

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

  设置如下

2、根据芯片选择所需固件

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

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

3、寻找用户帮助手册

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

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

STM32 HAL库与标准库的区别

1、句柄

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

  • 第一种解释：句柄是一种特殊的智能指针 。当一个应用程序要引用其他系统（如数据库、操作系统）所管理的内存块或对象时，就要使用句柄。

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

STM32的标准库中，句柄是一种特殊的指针，通常指向结构体！
  在STM32的标准库中，假设我们要初始化一个外设（这里以USART为例），我们首先要初始化他们的各个寄存器。在标准库中，这些操作都是利用固件库结构体变量+固件库Init函数实现的：
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就好。

2、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);
3、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安装教程。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 ().
  • 注意：
  目前LL库是和HAL库捆绑发布的，所以在HAL库源码中，还有一些名为 stm32f2xx_ll_ppp的源码文件，这些文件就是新增的LL库文件。使用CubeMX生产项目时，可以选择LL库。
  HAL库最大的特点就是对底层进行了抽象。在此结构下，用户代码的处理主要分为三部分：
  • 处理外设句柄（实现用户功能）
  • 处理MSP
  • 处理各种回调函数
相关知识如下：

1、外设句柄定义

  用户代码的第一大部分：对于外设句柄的处理。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 地址以及其初始化参数即可。

2、 三种编程方式

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 __)：检查中断源

3、 三大回调函数

  在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)
当外设或者DMA工作完成后时，触发中断，该回调函数会在外设中断处理函数或者DMA的中断处理函数中被调用错误处理回调函数：
HAL_PPP_ErrorCallback
例如：
__weak void HAL_SPI_ErrorCallback(SPI_HandleTypeDef hspi)*
  • 3、当外设或者DMA出现错误时，触发终端，该回调函数会在外设中断处理函数或者DMA的中断处理函数中被调用
错误处理回调函数：
HAL_PPP_ErrorCallback
例如：
__weak void HAL_SPI_ErrorCallback(SPI_HandleTypeDef hspi)*
  当外设或者DMA出现错误时，触发终端，该回调函数会在外设中断处理函数或者DMA的中断处理函数中被调用。
  绝大多数用户代码均在以上三大回调函数中实现。
  HAL库结构中，在每次初始化前（尤其是在多次调用初始化前），先调用对应的反初始化（DeInit）函数是非常有必要的。
某些外设多次初始化时不调用返回会导致初始化失败。完成回调函数有多中，例如串口的完成回调函数有
HAL_UART_TxCpltCallbackHAL_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，在其中实现上文所说明的三大回调函数中的完成回调函数和错误回调函数

参考文档及网文链接

ST - Description of STM32F4 HAL and LL drivers.pdf
 ST - en.stm32_embedded_software_offering.pdf
作者：ZCShoucsdn 来源：CSDN 原文：https://blog.csdn.net/zcshoucsdn/article/details/55213616
作者：ZCShoucsdn 来源：CSDN 原文：https://blog.csdn.net/zcshoucsdn/article/details/55213616
作者：Error_4O4 来源：CSDN 原文：https://blog.csdn.net/weixin_43186792/article/details/88759321
作者：csdnpapa 来源：CSDN 原文：https://blog.csdn.net/csdnpapa/article/details/79309937
来源：STM32嵌入式，开发如有侵权，请联系删除！
往期推荐

深度长文：STM32是如何软硬件结合，编译后怎么样一步步运行起来的


一份很棒的外设驱动库！基于STM32F4


STM32夺命100问，收藏夹吃灰走起~


干货 | 一文讲透STM32串口DMA收发机制


登录阅读全文
免责声明： 该内容由专栏作者授权发布或作者转载，目的在于传递更多信息，并不代表本网赞同其观点，本站亦不保证或承诺内容真实性等。若内容或图片侵犯您的权益，请及时联系本站删除。侵权投诉联系：  nick.zong@aspencore.com！
芯片之家
评论 （0）
  • 定制软件开发公司推荐：做软件找什么公司好呢
    　　定制软件开发公司推荐清单 　　在企业数字化转型加速的2025年，定制软件开发需求愈发多元复杂。不同行业、技术偏好与服务模式的企业，对开发公司的要求大相径庭。以下从技术赛道、服务模式及行业场景出发，为您提供适配的定制软件开发公司推荐及选择建议。 　　华盛恒辉科技有限公司：是一家专注于高端软件定制开发服务和高端建设的服务机构，致力于为企业提供全面、系统的开发制作方案。在部队政企开发、建设到运营推广领域拥有丰富经验，在教育，工业，医疗，APP，管理，商城，人工智能，部队软件、工业软件、数字化转
    华盛恒辉l58ll334744 2025-05-12 15:55 14浏览
  • 信创背景下的算力建设风险
            信创产业含义的“信息技术应用创新”一词，最早公开信息见于2019年3月26日，在江苏南京召开的信息技术应用创新研讨会。本次大会主办单位为江苏省工业和信息化厅和中国电子工业标准化技术协会安全可靠工作委员会。        2019年5月16日，美国将华为列入实体清单，在未获得美国商务部许可的情况下，美国企业将无法向华为供应产品。       2019年6
    天涯书生 2025-05-11 10:41 87浏览
  • 厨电AI化狂欢：万得厨wan AiOS 1.0是破局钥匙还是营销噱头？
    在 AI 浪潮席卷下，厨电行业正经历着深刻变革。AWE 2025期间，万得厨对外首次发布了wan AiOS 1.0组织体超智能系统——通过AI技术能够帮助全球家庭实现从健康检测、膳食推荐，到食材即时配送，再到一步烹饪、营养总结的个性化健康膳食管理。这一创新之举并非偶然的个案，而是整个厨电行业大步迈向智能化、数字化转型浪潮的一个关键注脚，折射出全行业对 AI 赋能的热切渴求。前有标兵后有追兵，万得厨面临着高昂的研发成本与技术迭代压力，稍有懈怠便可能被后来者赶
    用户1742991715177 2025-05-11 22:44 28浏览
  • 战火中的启示：质量为王的时代已然来临
    在印度与巴基斯坦的军事对峙情境下，歼10C的出色表现如同一颗投入平静湖面的巨石，激起层层涟漪，深刻印证了“质量大于数量”这一铁律。军事领域，技术优势就是决定胜负的关键钥匙。歼10C凭借先进的航电系统、强大的武器挂载能力以及卓越的机动性能，在战场上大放异彩。它能够精准捕捉目标，迅速发动攻击，以一敌多却毫不逊色。与之形成鲜明对比的是，单纯依靠数量堆砌的军事力量，在面对先进技术装备时，往往显得力不从心。这一现象绝非局限于军事范畴，在当今社会的各个领域，“质量大于数量”都已成为不可逆转的趋势。在科技行业
    curton 2025-05-11 19:09 149浏览
  • 数字隔离器，如何高效赋能工业自动化？
    在工业自动化领域中，PLC（可编程逻辑控制器）和 DCS（分布式控制系统）是两种最为常见的控制技术。它们凭借着高可靠性、高灵活性与高自动化程度等显著优势，在工业自动化行业中发挥着不可替代的作用，并已被广泛应用于机械臂自动装配、发电机功率调节、石油炼制、化工生产、交通信号控制与地铁轻轨控制等众多工控场景之中。一种典型的现代工业总线控制系统而数字隔离器，作为工业自动化领域中低压控制系统与高压设备进行信息传输的“安全桥梁”，其不仅能有效阻断高压电气向低压控制系统的传导路径，保障操作人员与控制系统的安全
    华普微HOPERF 2025-05-09 17:08 16浏览
  • 【拆解】一款某公司的开关电源，用料相当过硬了
    体积大小：14*11*2.6CM，电气参数：输入100V-240V/10A，输出16V24A。PCB 正面如下图。PCB 背面如下图。根据实际功能可以将PCB分成几部分：EMI滤波，PFC电路，LLC电路。EMI滤波区域，两级共模电感，LN各用了保险丝加压敏电阻，继电器（HF32FV-G）用来切除NTC的，为了提高效率点，如下图。PFC电路区域，如下图。LLC电路区域，如下图。详细分析一下该电源用的主要IC还有功率器件。AC侧采用了两颗整流桥进行并联，器件增加电流应力，如下图。共模电感都有放电针
    liweicheng 2025-05-10 20:03 16浏览
  • 【拆解】+自动喷香机拆解
    【拆解】+自动喷香机拆解 家里之前买了从PDD买了一个小型自动喷香机放在厕所里。来增加家里的温馨感，这东西看着确实小巧，精致。可是这东西吧，耗电就是快，没过几天就没电了。今个就让我拆开看看什么在捣鬼。如下是产品的实物和宣传图： 由于螺丝孔太小和限位很深。对于我的螺丝刀套装没用。只能使用那种螺丝刀细头，同时又长的小螺丝刀进行拆解 拧下三颗螺丝钉，用一字螺丝刀撬开外壳，内部结构就呈现在眼前。 内部构造相当简单，部件没多少。就是锂电池供电，通过MCU实现按键控制，段码屏控制，LE
    zhusx123 2025-05-10 19:55 21浏览
  • 【拆解】一款 Dacom Athlete运动蓝牙耳机 ，从浅到深的认识
    蓝牙耳机是长这个样子，如下图。背部图，如下图。拆开L耳的一侧，有NFC和电池包（501230 3.7V 150mAh）如下图。电池包（501230 3.7V 150mAh）如下图。NFC正面，如下图。NFC背面，如下图。如何理解NFC的工作原理呢，搜集一下相关的资料，如下图。拆开R耳的一侧，PCB正面，如下图。PCB背面，如下图。有两组红黑的线，一组连接到了喇叭，另一组连接到了MIC头上，MIC头参数如下图。蓝牙模块（CSR 8635），有蛇形PCB走线做成天线，节约了天线成本，如下图。该IC介
    liweicheng 2025-05-10 00:45 11浏览
  • 如何优化系统启动时间--基于米尔瑞萨MYD-YG2LX开发板
    1.概述MYD-YG2LX采用瑞萨RZ/G2L作为核心处理器，该处理器搭载双核Cortex-A55@1.2GHz+Cortex-M33@200MHz处理器，其内部集成高性能3D加速引擎Mail-G31 GPU(500MHz)和视频处理单元（支持H.264硬件编解码）,16位的DDR4-1600 / DDR3L-1333内存控制器、千兆以太网控制器、USB、CAN、SD卡、MIPI-CSI等外设接口，在工业、医疗、电力等行业都得到广泛的应用。米尔基于瑞萨RZ/G2L开发板本文主要介绍基于MYD-Y
    米尔电子嵌入式 2025-05-09 17:38 15浏览
  • 什么是磁光克尔效应
    ‌磁光克尔效应（Magneto-Optic Kerr Effect, MOKE）‌ 是指当线偏振光入射到磁性材料表面并反射后，其偏振状态（偏振面旋转角度和椭偏率）因材料的磁化强度或方向发生改变的现象。具体表现为：1、‌偏振面旋转‌：反射光的偏振方向相对于入射光发生偏转（克尔旋转角 θK）。2、‌椭偏率变化‌：反射光由线偏振变为椭圆偏振（克尔椭偏率 εK）。这一效应直接关联材料的磁化状态，是表征磁性材料（如铁磁体、反铁磁体）磁学性质的重要非接触式光学探测手段，广泛用于
    锦正茂科技 2025-05-12 11:02 28浏览
  • 营收狂奔，亏损狂飙！曹操出行IPO是一场豪赌！
    递交招股书近一年后，曹操出行 IPO 进程终于迎来关键节点。从 2024 年 4 月首次递表，到 2025 年 4 月顺利通过中国证监会境外发行上市备案，并迅速更新招股书。而通过上市备案也标志着其赴港IPO进程进入实质性推进阶段，曹操出行最快有望于2025年内完成港股上市，成为李书福商业版图中又一关键落子。行路至此，曹操出行面临的挑战依然不容忽视。当下的网约车赛道，早已不是当年群雄逐鹿的草莽时代，市场渐趋饱和，竞争近乎白热化。曹操出行此时冲刺上市，既是背水一战，也是谋篇布局。其招股书中披露的资金
    用户1742991715177 2025-05-10 21:18 25浏览
  • 【拆解】行车记录仪，从浅到深的认识
    行车记录仪是长这个样子的，如下图。从前面拆去玻璃挡板，可以清晰的看见里面的部件，5个按键电路板，液晶显示屏，摄像头，喇叭，电池包，还有一块主电路板。液晶显示屏正面，如下图。液晶显示屏背面，如下图。喇叭，如下图。5个按键的电路板，MENU，DOWN，POWER，UP，OK总共5个按键功能，导线连接到主电路板上，如下图。电池包，303040聚合物锂电池，3.7V，300mAH,如下图。如下图。摄像头，如下图。拿去摄像头外壳，如下图。分离广角聚集镜头和PCB板，如下图。广角聚焦镜头，具体结构如下图。P
    liweicheng 2025-05-09 22:50 16浏览
  • 石头科技Q1净利润暴跌背后：昌敬心思“在别处”
    文/Leon编辑/cc孙聪颖‍在新能源汽车赛道的残酷洗牌中，威马、爱驰等数十个品牌黯然退场，极越、哪吒汽车也深陷经营困局，“跨界造车” 早已褪去曾经的光环，成为吞噬企业资金与精力的风险泥潭，尤其对上市公司而言，稍有不慎便会被拖入业绩泥沼。当行业共识已清晰显现 —— 新能源汽车市场这片红海正上演着惨烈的生存之战，石头科技创始人昌敬却逆势入局，掌舵极石汽车，其押注造车的抉择，正让本就面临挑战的石头科技主业雪上加霜。2025 年 4 月中旬，昌敬突然清空微博、抖音等社交媒体账号的举动，迅速引爆舆论场。
    华尔街科技眼 2025-05-09 20:53 15浏览
  • 【拆解】+CamFi卡菲单反无线传输器拆解
    【拆解】+CamFi卡菲单反无线传输器拆解 对于单反爱好者，想要通过远程控制自拍怎么办呢。一个远程连接，远程控制相机拍摄的工具再合适不过了。今天给大伙介绍的是CamFi卡菲单反无线传输器。 CamFi 是专为数码单反相机打造的无线传输控制器，自带的 WiFi 功能（无需手机流量），不但可通过手机、平板、电脑等设备远程连接操作单反相机进行拍摄，而且还可实时传输相机拍摄的照片到 iPad 和电视等大屏设备进行查看和分享。 CamFi 支持大部分佳能和尼康单反相机，内置可充电锂离子电池，无需相机供电。
    zhusx123 2025-05-11 14:14 28浏览
我要评论
0
0
点击右上角，分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦