STM32 HAL库 结构

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

STM32CubeH7GettingStarted.pdf 这是官方对HAL库的说明文档在每个HAL库中都有包含，
内容非常多各种开发板 BSP 中间件占据了大量的空间。

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

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

XXXXhal_lib.h 是什么

stm32h7xx_hal_XXX.c 除了对应的H文件外还需要HAL库文件中其他很多的头文件。这个是库函数的依赖，库函数的头文件库。
模块C函数在整个HAL库中是高度耦合的，依赖非常多的头文件。在移植的时候指定H文件的地址。

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

mai函数中需要执行HAL_Init ，systemclock_Config
HAL_Init 定义在 stm32h7xx_hal.c 任然存放在HAL库中模块文件中。

官方例程的结构如上所示
使用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.
  

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