官方下载的HAL库内容包括:STM32Cube HAL库文件、中间件(RTOS、USB、TCP/IP、Graphics)、一系列的外设应用例程。
HAL驱动建立在一套通用的体系结构之上,主要提供一套API接口以便更好地与上层应用进行通信;HAL驱动函数严格按照ANSI-C标准编写,因此可独立于开发工具。
HAL库的特点主要有:
1、抽象于硬件之上的结构体赋值初始化操作,基于功能的分类
2、三种编程模式 —— 轮询方式、中断方式、DMA方式
3、可供用户进行重载的API函数
4、用于轮询方式的系统超时设置
5、完善的对象锁定机制,提供安全的硬件资源访问
HAL驱动层中的回调函数主要有三种类型:
- 外设的Init和Deinit回调函数 —— HAL_PPPMspInit(),HAL_PPP_MspDeInit()
- 处理完成回调函数 —— HAL_PPP_ProcessCpltCallback
- 发生错误时的处理回调函数 —— HAL_PPP_ErrorCallback
HAL驱动文件:
文件 | 描述 |
stm32f0xx_hal_ppp.c/h | 外设驱动文件 |
stm32f0xx_hal_ppp_ex.c/h | 外设模块扩展驱动文件 |
stm32f0xx_hal.c/h | hal初始化、DBGMCU、重映射、系统延时 |
stm32f0xx_hal_msp_template.c/h | 可复制到用户应用文件夹,MSP Init和Deinit(主要回调函数) |
stm32f0xx_hal_def.h | 公用的HAL资源,如结构体、枚举变量等 |
用户应用文件:
文件 | 描述 |
system_stm32f0xx.c | 包含SystemInit函数,重定位中断向量在SRAM中(如果需要),但不完成系统时钟的配置(在HAL文件完成) |
startup_stm32f0xx.s | 包含Reset Handler处理函数、堆栈的初始化等 |
stm32f0xx_hal_msp.c | MSP的初始化和复位 |
stm32f0xx_flash.icf | 链接工具,可选 |
stm32f0xx_hal_conf.h | 允许用户对其进行配置以选择特定的外设 |
stm32f0xx_it.c/h | 外设中断服务函数,其中每个PPP_IRQHandler里都调用了相应的HAL_PPP_IRQHandler |
HAL中三种主要的数据结构是:外设句柄、初始化和配置结构体和具体
外设句柄结构体 PPP_HandleTypeDef *handle,主要特点有:
- 1、支持多实例、同一结构体内部可共享资源
- 2、存储/管理全局变量,减少外部全局变量的使用,增加程序的稳定性
- 3、当外设可以使用DMA通道时,相应的DMA接口句柄会添加到PPP_HandlerTypeDef中
- 4、对于通用的外设,如GPIO、NVIC、SYSTick等,没有实例句柄
HAL 库文件之间的关系: