HAL库是STM32 最新推出的底层库,主要用于cube的自动代码生成,标准库甚至不会再维护,所以按照趋势,HAL是未来的方向。
HAL库用于Cube自动化图形界面代码生成工具,但是任然有必要对HAL库有一个文件层次上的清晰认知,比较未来和它打交道的机会非常多。随着MCU主频越来越高,复杂的驱动库会逐渐出现。易用,快速开发的需求会变得更加紧迫。

STM32CubeH7GettingStarted.pdf 这是官方对HAL库的说明文档在每个HAL库中都有包含,

STM32MP257 目标检测_arm


内容非常多各种开发板 BSP 中间件占据了大量的空间。

STM32MP257 目标检测_头文件_02

HAL库的基本组成是
stm32h7xx_hal_adc.c
stm32h7xx_hal_XXX.c
XXX代表各个模块

模块内部第一步是include stm32h7xx_hal.h
/* Includes ------------------------------------------------------------------*/
#include “stm32h7xx_hal.h”

因此,HAL库 的 stm32h7xx_hal_XXX.c 都依赖 stm32h7xx_hal.h

#ifdef HAL_ADC_MODULE_ENABLED
所有的外设库文件 开头都有模块的ENABLE 宏定义
位于 stm32h7xx_hal_conf.h
所以HAL库 的 stm32h7xx_hal_XXX.c 都依赖 stm32h7xx_hal_conf.h

STM32MP257 目标检测_单片机_03


在userapp中使用HAL库一般是引用include 相关模块的头文件,头文件引用了相关模块的C文件从而提供函数实体。XXXXhal_lib.h 是什么

STM32MP257 目标检测_arm_04


stm32h7xx_hal_XXX.c 除了对应的H文件外还需要HAL库文件中其他很多的头文件。这个是库函数的依赖,库函数的头文件库。

模块C函数在整个HAL库中是高度耦合的,依赖非常多的头文件。在移植的时候指定H文件的地址。

打开例子中的main文件 STM32Cube_FW_H7_V1.9.1\Projects\STM32H743I-EVAL\Templates\Src

STM32MP257 目标检测_arm_05


mai函数中需要执行HAL_Init ,systemclock_Config

HAL_Init 定义在 stm32h7xx_hal.c 任然存放在HAL库中模块文件中。

STM32MP257 目标检测_头文件_06

STM32MP257 目标检测_stm32_07


官方例程的结构如上所示

使用HAL库就是使用模块的C文件。基本上弄清模块的依赖关系就可以构建项目。

在HAL 库中 stm32h7xx_hal_conf_template.h 后缀为template 的文件

This file should be copied to the application folder and renamed

to stm32h7xx_hal_conf.h.

复制到用户文件夹然后改名,实际上是一个配置文件

STM32MP257 目标检测_头文件_08