打印
[STM32F1]

STM32HAL库使用详解

[复制链接]
593|33
手机看帖
扫描二维码
随时随地手机跟帖
跳转到指定楼层
楼主
1. 文档和库规范本
用户手册和固态函数库按照以下章节所描述的规范编写。

1.1缩写
Table1 本文档所有缩写定义
缩写        外设/单元
ADC        模数转换器
BKP        备份寄存器
CAN        控制器局域网模块
DMA        直接内存存取控制器
EXTI        外部中断事件控制器
FLASH        闪存存储器
GPIO        通用输入输出
I2C        内部集成电路
IWDG        独立看门狗
NVIC        嵌套中断向量列表控制器
PWR        电源/功耗控制
RCC        复位与时钟控制器
RTC        实时时钟
SPI        串行外设接口
SysTick        系统嘀嗒定时器
TIM        通用定时器
TIM1        高级控制定时器
USART        通用同步异步接收发射端
WWDG        窗口看门狗


1.2命名规则
固态函数库遵从以下命名规则 PPP表示任一外设缩写,例如:ADC。更多缩写相关信息参阅章节1.1 缩写

系统、源程序文件和头文件命名都以“stm32f10x_hal”作为开头,例如:stm32f10x_hal_conf.h。

常量仅被应用于一个文件的,定义于该文件中;被应用于多个文件的,在对应头文件中定义。所有常量都由英文字母大写书写。寄存器作为常量处理。他们的命名都由英文字母大写书写。

在大多数情况下,他们采用与缩写规范与本用户手册一致。

外设函数的命名以HAL加该外设的缩写加下划线为开头。每个单词的第一个字母都由英文字母大写书写,例如:HAL_I2C_Master_Transmit。在函数名中,以HAL开头加下划线加外设缩写,用以分隔外设缩写和函数名的其它部分。名为HAL_PPP_Init的函数,其功能是根据HAL_StatusTypeDef中指定的参数,初始化外设PPP,例如HAL_I2C_Init.

2. HAL函数库文件结构
2.1压缩包描述
STM32Fxx HAL函数库被压缩在一个zip文件中。解压该文件会产生一个文件夹:STM32Cube_FW_F1_V1.0.0,包含如下所示的子文件夹:

STM32 HAL固件库是Hardware Abstraction Layer的缩写,中文名称是:硬件抽象层。HAL库是ST公司为STM32的MCU最新推出的抽象层嵌入式软件,为更方便的实现跨STM32产品的最大可移植性。HAL库的推出,可以说ST也慢慢的抛弃了原来的标准固件库,这也使得很多老用户不满。但是HAL库推出的同时,也加入了很多第三方的中间件,有RTOS,USB,TCP / IP和图形等等。

和标准库对比起来,STM32的HAL库更加的抽象,ST最终的目的是要实现在STM32系列MCU之间无缝移植,甚至在其他MCU也能实现快速移植。


使用特权

评论回复
沙发
yiyigirl2014|  楼主 | 2022-7-25 10:58 | 只看该作者
2.2HAL 库文件调用结构

3.HAL的初始化
HAL层被调用前要先运行初始化函数HAL_init(),它包含在针对HAL自身的全局操作操作的源文件hal.c里。
HAL全局结构


4.STM32 HAL库句柄、MSP函数、Callback函数
4.1.句柄
句柄(handle),有多种意义,其中第一种是指程序设计,第二种是指Windows编程。现在大部分都是指程序设计/程序开发这类。

第一种解释:句柄是一种特殊的智能指针 。当一个应用程序要引用其他系统(如数据库、操作系统)所管理的内存块或对象时,就要使用句柄。
第二种解释:整个Windows编程的基础。一个句柄是指使用的一个唯一的整数值,即一个4字节(64位程序中为8字节)长的数值,来标识应用程序中的不同对象和同类中的不同的实例,诸如,一个窗口,按钮,图标,滚动条,输出设备,控件或者文件等。应用程序能够通过句柄访问相应的对象的信息,但是句柄不是指针,程序不能利用句柄来直接阅读文件中的信息。如果句柄不在I/O文件中,它是毫无用处的。 句柄是Windows用来标志应用程序中建立的或是使用的唯一整数,Windows大量使用了句柄来标识对象。
STM32的标准库中,句柄是一种特殊的指针,通常指向结构体!

在STM32的标准库中,假设我们要初始化一个外设(这里以USART为例),我们首先要初始化他们的各个寄存器。在标准库中,这些操作都是利用固件库结构体变量+固件库Init函数实现的:


可以看到,要初始化一个串口,需要:

1、对六个位置进行赋值,
2、然后引用Init函数,
USART_InitStructure并不是一个全局结构体变量,而是只在函数内部的局部变量,初始化完成之后,USART_InitStructure就失去了作用。

而在HAL库中,同样是USART初始化结构体变量,我们要定义为全局变量。


右键查看结构体成员

我们发现,与标准库不同的是,该成员不仅:

1、包含了之前标准库就有的六个成员(波特率,数据格式等),
2、还包含过采样、(发送或接收的)数据缓存、数据指针、串口 DMA 相关的变量、各种标志位等等要在整个项目流程中都要设置的各个成员。
该 UART1_Handler就被称为串口的句柄,它被贯穿整个USART收发的流程,比如开启中断:
HAL_UART_Receive_IT(&UART1_Handler, (u8 *)aRxBuffer, RXBUFFERSIZE);


比如后面要讲到的MSP与Callback回调函数:
<div>void HAL_UART_MspInit(UART_HandleTypeDef *huart);</div><div>void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart);</div>

在这些函数中,只需要调用初始化时定义的句柄UART1_Handler就好。
4.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);



入口参数仅仅需要一个串口句柄,这样有能看出句柄的方便。





使用特权

评论回复
板凳
yiyigirl2014|  楼主 | 2022-7-25 10:59 | 只看该作者
4.3.Callback函数
类似于MSP函数,个人认为Callback函数主要帮助用户应用层的代码编写。

还是以USART为例,在标准库中,串口中断了以后,我们要先在中断中判断是否是接收中断,然后读出数据,顺便清除中断标志位,然后再是对数据的处理,这样如果我们在一个中断函数中写这么多代码,就会显得很混乱:

<p>void USART3_IRQHandler(void)                <span style="white-space:pre">        </span>//串口1中断服务程序</p><p>{</p><p><span style="white-space:pre">        </span>u8 Res;</p><p><span style="white-space:pre">        </span>if(USART_GetITStatus(USART3, USART_IT_RXNE) != RESET)  //接收中断(接收到的数据必须是0x0d 0x0a结尾)</p><p><span style="white-space:pre">        </span>{</p><p><span style="white-space:pre">                </span>Res =USART_ReceiveData(USART3);<span style="white-space:pre">        </span>//读取接收到的数据</p><p><span style="white-space:pre">                </span>/*数据处理区*/</p><p><span style="white-space:pre">                </span>}   <span style="white-space:pre">                </span> </p><p>     } </p><p>} </p>


而在HAL库中,进入串口中断后,直接由HAL库中断函数进行托管:

<p>void USART1_IRQHandler(void)                <span style="white-space:pre">        </span></p><p>{ </p><p><span style="white-space:pre">        </span>HAL_UART_IRQHandler(&UART1_Handler);<span style="white-space:pre">        </span>//调用HAL库中断处理公用函数</p><p><span style="white-space:pre">        </span>/***************省略无关代码****************/<span style="white-space:pre">        </span></p><p>}</p>


HAL_UART_IRQHandler这个函数完成了判断是哪个中断(接收?发送?或者其他?),然后读出数据,保存至缓存区,顺便清除中断标志位等等操作。
比如我提前设置了,串口每接收五个字节,我就要对这五个字节进行处理。
在一开始我定义了一个串口接收缓存区:

<p>/*HAL库使用的串口接收缓冲,处理逻辑由HAL库控制,接收完这个数组就会调用HAL_UART_RxCpltCallback进行处理这个数组*/</p><p>/*RXBUFFERSIZE=5*/</p><p>u8 aRxBuffer[RXBUFFERSIZE];</p>


在初始化中,我在句柄里设置好了缓存区的地址,缓存大小(五个字节)

<p>/*该代码在HAL_UART_Receive_IT函数中,初始化时会引用*/</p><p><span style="white-space:pre">        </span>huart->pRxBuffPtr = pData;//aRxBuffer</p><p>    huart->RxXferSize = Size;//RXBUFFERSIZE</p><p>    huart->RxXferCount = Size;//RXBUFFERSIZE</p>


则在接收数据中,每接收完五个字节,HAL_UART_IRQHandler才会执行一次Callback函数:
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart);

在这个Callback回调函数中,我们只需要对这接收到的五个字节(保存在aRxBuffer[]中)进行处理就好了,完全不用再去手动清除标志位等操作。
所以说Callback函数是一个应用层代码的函数,我们在一开始只设置句柄里面的各个参数,然后就等着HAL库把自己安排好的代码送到手中就可以了~
综上,就是HAL库的三个与标准库不同的地方之个人见解。
个人觉得从这三个小点就可以看出HAL库的可移植性之强大,并且用户可以完全不去理会底层各个寄存器的操作,代码也更有逻辑性。但与此带来的是复杂的代码量,极慢的编译速度,略微低下的效率。看怎么取舍了。


使用特权

评论回复
地板
yiyigirl2014|  楼主 | 2022-7-25 10:59 | 只看该作者
本帖最后由 yiyigirl2014 于 2022-7-25 11:01 编辑

5.HAL库编程方式
在 HAL 库中对外设模型进行了统一,支持三种编程方式:

轮询模式/阻塞模式
中断方式
DMA模式
以IIC为例,三种编程模式对应的函数如下:

使用特权

评论回复
5
yiyigirl2014|  楼主 | 2022-7-25 11:02 | 只看该作者
6.例程和帮助文档
STM32 HAL库包含大量的库函数的使用例程和库函数API接口帮助文档,在开发过程中如果遇到任何问题可以通过库文件自带的例程和帮助文档获得帮助。
6.1 例程文档结构图

6.2 HAL用户手册



使用特权

评论回复
6
麻花油条| | 2022-7-25 14:43 | 只看该作者
讲解详细,感谢分享

使用特权

评论回复
7
天灵灵地灵灵| | 2022-7-25 16:05 | 只看该作者
简单明了,通俗易懂,感谢分享

使用特权

评论回复
8
Uriah| | 2022-10-3 07:07 | 只看该作者

USART1可以有多个时钟源

使用特权

评论回复
9
Bblythe| | 2022-10-3 10:06 | 只看该作者

通过访问寄存器来控制I2C1工作时钟的开启。

使用特权

评论回复
10
mnynt121| | 2022-10-10 21:21 | 只看该作者
如何配置stm32f1的hal库  

使用特权

评论回复
11
ingramward| | 2022-10-10 21:36 | 只看该作者
STM32CubeMX如何返回操作      

使用特权

评论回复
12
iyoum| | 2022-10-10 22:01 | 只看该作者
stm32库函数算hal层吗   

使用特权

评论回复
13
vivilyly| | 2022-10-11 21:21 | 只看该作者
如何直接利用STM32的硬件I2C操控  

使用特权

评论回复
14
alvpeg| | 2022-10-11 22:01 | 只看该作者
stm32初学者是应该学寄存器好还是学库函数好

使用特权

评论回复
15
leesie| | 2022-10-13 15:37 | 只看该作者
初来乍到,进来逛逛

使用特权

评论回复
16
tian111| | 2022-10-13 22:31 | 只看该作者
I2C1的时钟可以自行选择HSI或者SYSCLK

使用特权

评论回复
17
mollylawrence| | 2022-10-17 20:55 | 只看该作者
《stm32自学笔记》这本书好吗  

使用特权

评论回复
18
sesefadou| | 2022-10-17 22:02 | 只看该作者
stm32的hal库为什么编译变慢  

使用特权

评论回复
19
zerorobert| | 2022-10-18 11:22 | 只看该作者
stm32HAL库串口回调函数怎么判断帧头  

使用特权

评论回复
20
jtracy3| | 2022-10-18 12:16 | 只看该作者
stm32的hal库怎么清除外部中断

使用特权

评论回复
发新帖 我要提问
您需要登录后才可以回帖 登录 | 注册

本版积分规则

213

主题

3538

帖子

10

粉丝