4.2.1　HAL库函数文件结构

4.2.1　HAL库函数文件结构

HAL库函数文件由HAL驱动程序文件和用户应用文件构成。

STM32CubeMX软件包附带现成的项目模板（从官网下载），每个项目都包含HAL驱动程序文件、用户应用文件和一个针对受支持工具链的预配置项目，HAL工程文件结构如图4.8所示。STM32F1的HAL库函数项目特点如下。

图4.8　HAL工程文件结构

（1）它包含HAL、CMSIS和BSP驱动程序的源代码。

（2）它包含所有固件组件的路径。

（3）它定义了支持的STM32器件，并允许相应地配置CMSIS和HAL驱动程序。

（4）它提供了预配置的现成用户文件，定义如下。

①HAL已初始化。

②用HAL_Delay（）函数实现的SysTick ISR。

③用最大设备频率配置的系统时钟。(https://www.daowen.com)

1.HAL驱动程序文件

HAL驱动程序文件如表4.2所示。HAL库的API中有两类函数：宏函数和普通函数。宏函数在扩展名为.h的文件中定义，普通函数在扩展名为.c的文件中定义。宏函数可分为两类：HAL库函数（__HAL_PPP*）和私有函数（PPP_*、IS_PPP*）。普通函数也分为两类：HAL库函数（HAL_PPP*）和私有函数（PPP_*）。HAL库函数是供用户代码调用的，私有函数主要是供HAL库函数调用的。

表4.2　HAL驱动程序文件

2.用户应用文件

用户应用文件需要单独存放在用户应用文件夹中，表4.3列出了使用HAL构建应用程序所需的用户应用文件。

表4.3　用户应用文件

续表