【08】STM32·HAL库开发-HAL库介绍 | STM32Cube固件库介绍 | HAL库框架结构 | 如何使用HAL库及使用注意事项

已于 2023-07-31 22:23:58 修改
阅读量1.4w 收藏 185
点赞数 41
分类专栏： # STM32-HAL库 文章标签： stm32 嵌入式硬件 单片机 HAL库 FreeRTOS
于 2023-07-03 23:32:59 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_52162042/article/details/131386528
版权
文章详细介绍了STM32的HAL库和CMSIS，包括它们的用途、结构和关键文件。STM32Cube固件包的获取和文件夹结构被解析，强调了CMSIS在中间层的作用。HAL库的API函数命名规则和使用方法，如初始化、读写和控制函数，以及回调函数的弱函数特性也进行了说明。此外，提到了如何配置和裁剪HAL库，以及使用时的注意事项，如避免修改库源码和注意函数效率。
摘要由CSDN通过智能技术生成

目录

1.初识HAL库（了解）

1.1CMSIS简介

  CMSIS (微控制器软件接口标准)：Cortex Microcontroller Software Interface Standard，是由ARM和与其合作的芯片厂商（比如ST、NXP公司等）、软件工具厂商（Keil、IAR公司等），共同制定的标准。如果没有此标准，ARM公司的产品兼容性非常差。
  下图中分为三层，第一层是用户层，主要是用户代码、在线调试；第二层是中间层（CMISIS），具体CMSIS体现到用户手册是CMSIS-Pack，每个公司提供的包可能不太一样，会根据自己的产品制作CMSIS包，其中HAL库（Peripheral HAL）属于其内容；第三层是硬件层。用户想要去开发硬件层，需要经过中间层，中间层的CMSIS包由众多厂商提供。
在这里插入图片描述

1.2HAL库简介

  ST 为了方便用户开发 STM32芯片开发提供了三种库：

  1. 标准外设库 (Standard Peripheral Libraries)，也就是“标准库”。
  2. HAL库(硬件抽象层)：Hardware Abstraction Layer
  3. LL库：Low Layer，也就是“底层库”，更加接近硬件，也就是更加接近寄存器。

  下图是直接操作寄存器、标准库、HAL库（不同系列兼容性好，具体表现是不同外设初始化都是使用一个函数，只是结构体、变量不一样，但是函数接口一样，移植方便。HAL库是抽象层的库，经过很多次的封装，导致效率比较低）、LL库（弥补了HAL库执行效率低的缺点，在HAL库内部一些API函数就会调用LL库中内容，但是LL库也有其缺点，不匹配部分复杂外设，比如USB）的特点：
在这里插入图片描述

2.STM32Cube固件包浅析（了解）

  Cube固件包其实就说CMSIS-Pack，STM32Cube固件包是ST公司根据标准提供的CMSIS-Pack。

2.1如何获取STM32Cube固件包？

  之前文章中已经总结如何获取，具体查看【07】STM32·HAL库开发-新建寄存器版本MDK工程 |下载STM32Cube固件包 | 新建MDK工程步骤中的第1.1小节。

2.2STM32Cube固件包文件夹简介

【_htmresc】文件夹中包含了一些图片之类的，对我们来说没任何作用；
【Documentation】文件夹中为固件包说明文档；
【Drivers】文件夹比较重要是驱动源码，新建工程时需要用到；
【Middlewares】中为中间文件，保存的是ST或者第三方的一些中间文件，后续会用到，新建工程可能暂时用不到；
【Projects】为ST官方开发板例程，参考作用；
【Utilities】为ST关方开发板例程提供公共组件，一般用不到，可以用作参考；
License.md文件包含了软件许可、软件版本信息；
package.xml为固件包版本信息；
Readme.md为自述文件；
Release_Notes.html为补充或更新说明的链接，可用浏览器打开。

在这里插入图片描述

2.3CMSIS文件夹关键文件

  F1系列【Drivers】文件夹中包含了三个文件夹【BSP】、【CMSIS】、HAL库驱动【STM32F1xx_HAL_Driver】。【BSP】中为板级驱动源码，也就是板级支持包，适配ST官方的开发板板级驱动（针对外设、或者板子上面的资源做的驱动），不同开发板板级驱动是不一样的，所以此文件更多是参考意义；【CMSIS】文件夹包含符合CMSIS的组件，包括：DSP库、Cortex-M内核及其设备文件、微控制器专用头文件、启动文件、专用系统文件等，创建工程时会复制其中部分文件；【STM32F1xx_HAL_Driver】为F1系列HAL库外设驱动源码，创建工程时会复制其中部分文件。
在这里插入图片描述
  【Middlewares】中包含了【ST】和【Third_Party】两个文件夹。
在这里插入图片描述
  在【CMSIS】文件夹中主要关注【Device】和【include】两个文件夹，新建工程时也是用到这两个文件夹；【Device】文件夹中包含微控制器专用头文件、启动文件、专用系统文件；【include】文件夹中包含Cortx-M内核及其设备文件、编译器相关头文件。

在这里插入图片描述

2.3.1CMSIS标准规定软件包目录

   CMSIS标准规定软件包目录也就是STM32Cube固件库文件夹所包含的内容。用到的有【Driver】和【Include】文件夹。
在这里插入图片描述

2.3.2Device和Include文件夹的关键文件介绍

   【Device】文件夹中用到的文件包含以下文件，以下文件是简略后的文件。
在这里插入图片描述
   stm32f103后面的xe是根据FLASH容量进行选择，在【include】文件夹中保存3个文件：stm32f1xx.h、stm32f103xe.h、system_stm32f1xx.h。
在这里插入图片描述
   以下目录中保留文件system_stm32f1xx.c，因为编译器是ARM，所以保留【arm】文件夹中的启动文件，并根据型号和容量来选择保留哪个启动文件。
在这里插入图片描述
在这里插入图片描述
   【include】文件夹中用到以下文件：cmsis_armcc.h（针对AC5编译器）、cmsis_armclang.h（针对AC6编译器）、cmsis_compiler.h（AC5和AC6编译器共用）、cmsis_version.h（编译器版本，也是共用的）、core_cm3.h （Cortex-M3内核，重点关注此文件）、 mpu_armv7.h（mpu内存保护）。
在这里插入图片描述

3.HAL库框架结构（了解）

3.1HAL库文件夹结构

   F1系列的HAL库被保存到【STM32F1xx_HAL_Driver】文件夹中，Src(Source)：外设驱动源码；Inc(Include)：外设驱动源码头文件。前面提到HAL库和LL库是捆绑发布的，就体现在驱动源码包含在【Inc】和【Src】文件夹中。【Inc】和【Src】文件夹中的【Legacy】文件夹是补充源文件，并不是所有系列都需要。
在这里插入图片描述

3.2HAL库文件介绍

   文件名中有hal的就是hal库文件，有ll的就是LL库文件。stm32f1xx_hal_conf.h文件可用于裁剪HAL库中用不到的功能，减少编译后得文件大小。
在这里插入图片描述

3.3HAL库API函数和变量命名规则

   用户一般不会直接调用LL库，而是通过调用HAL库间接使用LL库，所以不必深入学习LL库。
在这里插入图片描述
  可以将以下初始化函数中的PPP替换成GPIO，反初始化函数很少用到，主要用于失能时钟、恢复默认配置等。

初始化/反初始化函数:HAL_PPP_Init(), HAL_PPP_DeInit()
外设读写函数:HAL_PPP_Read(),HAL_PPP_Write(),HAL_PPP_Transmit(), HAL_PPP_Receive()
控制函数:HAL_PPP_Set (),HAL_PPP_Get ()
状态和错误:HAL_PPP_GetState (), HAL_PPP_GetError ()

3.3.1HAL库对寄存器位操作的相关宏定义

在这里插入图片描述

3.3.2HAL库回调函数

在这里插入图片描述
  此类回调函数通常被_weak修饰（弱函数），允许用户重新定义该函数。

4.如何使用HAL库（熟悉）

4.1基于CMSIS应用程序文件描述

  CMSIS核心层文件就是将【CMSIS】文件夹中的【Device】和【Include】文件夹中裁剪后剩的11个文件，这11个文件对于新建MDK工程是必须包含的；设备驱动层就是HAL库及LL库的源码，也就是【STM32F1xx_HAL_Driver】文件夹中的源码；用户程序文件，正点原子例程都将main.h、stm32f1xx_hal_msp.c删除掉了，放到了例如初始化UART就将UART的在stm32f1xx_hal_msp.c中的回调函数放到usart.c中，stm32f1xx_it.c和stm32f1xx_it.h里面本身就定义了一些中断，所以选择保留，如果写串口中断，推荐写到usart.c中。。
在这里插入图片描述

4.1.1STM32开发文件结构分布

在这里插入图片描述

4.2HAL 库的用户配置文件

  如果是F1系列那么就修改stm32f1xx_hal_conf.h。获取此文件可以从STM32官方例程中获取，也可以从HAL库驱动源码中获取，只是名称不同，复制时只需要将template删除即可。
在这里插入图片描述
在这里插入图片描述

4.2.1裁剪HAL库外设驱动源码（不进行编译）

  STM32HAL库裁剪就是将stm32f1xx_hal_conf.h中用不到的宏定义注释掉，因为在HAL库驱动源码中都是用的ifdef判断宏是否被定义。以GPIO为例如下所示：
在这里插入图片描述
  通过对工程中用到什么外设就加什么驱动文件，也是起到裁剪作用。如下所示，是部分HAL库驱动文件：
在这里插入图片描述

4.2.2设置外部高速晶振频率（根据开发板实际情况设置）

  以下代码是设置高速外部晶振，宏USE_STM3210C_EVAL判断是否使用ST官方开发板，默认为25MHz，否则为8MHz。要根据开发板实际情况进行设置。如果要省事可以简化以下代码为：#define HSE_VALUE 8000000U

#if !defined  (HSE_VALUE) 
#if defined(USE_STM3210C_EVAL)
  #define HSE_VALUE    25000000U /*!< Value of the External oscillator in Hz */
#else
  #define HSE_VALUE    8000000U /*!< Value of the External oscillator in Hz */
#endif
#endif /* HSE_VALUE */

  高速内部晶振和低速内部晶振可以根据芯片手册进行设置：

#if !defined  (HSI_VALUE)
  #define HSI_VALUE              8000000U  
#endif /* HSI_VALUE */
#if !defined  (LSI_VALUE) 
 #define LSI_VALUE               40000U  
#endif /* LSI_VALUE */

4.2.3设置外部低速晶振频率（根据开发板实际情况设置）

#if !defined  (LSE_VALUE)
 #define LSE_VALUE               32768U    
#endif /* LSE_VALUE */

在这里插入图片描述

4.3stm32f1xx_hal.c 文件

  使用HAL库最关心的就说HAL库初始化函数HAL_Init()，不同系列可能有些小区别，但是核心代码如下：

HAL_StatusTypeDef  HAL_Init(void) 
{ 
	__HAL_FLASH_PREFETCH_BUFFER_ENABLE(); 	                    /* 使能FLASH预取缓冲 */ 

	HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_2); /* 配置中断优先级分组 */ 

	/* 使用滴答定时器作为时钟基准，配置 1ms 滴答（重置后默认的时钟源为 HSI） */ 
	HAL_InitTick(TICK_INT_PRIORITY); 

	HAL_MspInit(); 	/* 初始化其它底层硬件（如果必要） */ 

	return HAL_OK; 	/* 返回函数状态 */ 
}

   第一段程序作用是使能FLASH预取缓冲，STM32是32位的，每次读取的指令也是32位的，FLASH存在预取缓冲区，预取缓冲区由2个64位组成，CPU每次读取指令，将指令放在预取缓冲区，就可以起到程序加快运行的效果。

__HAL_FLASH_PREFETCH_BUFFER_ENABLE(); 	                    /* 使能FLASH预取缓冲 */

   第二段程序是设置中断优先级分组，默认情况下设置位为4，正点原子默认设置成2。

HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_2); /* 配置中断优先级分组 */

  第三段是使能系统滴答定时器，并且配置为1ms。正点原子实际配置滴答定时器在delay.c中的delay_Init()函数中。

/* 使用滴答定时器作为时钟基准，配置 1ms 滴答（重置后默认的时钟源为 HSI） */ 
	HAL_InitTick(TICK_INT_PRIORITY);

  HAL_MspInit()为空函数，不用管它。

HAL_MspInit(); 	/* 初始化其它底层硬件（如果必要） */

5.HAL库使用注意事项（了解）

1，使用HAL库出现问题，还是得通过参考手册检查是否硬件操作是否有问题；
2，尽量不通过修改库源码实现功能，这样不方便库更新；
3，HAL库可能会存在错误，要有质疑精神；
4，有些HAL库API函数执行效率偏低，我们可能会直接通过操作寄存器的方式代替。

6.总结（了解）

在这里插入图片描述

花落指尖❀
关注
专栏目录
STM32HAL库++ESP8266+cJSON连接阿里云物联网平台
04-27
实验首先从物联网的基本概念、架构和阿里云物联网平台入手。物联网是将日常物品通过网络连接起来，使它们能够相互通信和交换数据，从而实现智能化管理和控制。物联网架构包括感知层、网络层、平台层和应用层。阿里云物联网平台提供了设备管理、数据安全通信、消息订阅和数据服务等功能，支持海量设备的连接。 接下来详细讲解了MQTT协议的工作原理和WIFI模块的硬件连接、固件烧录和AT指令使用。MQTT协议是一种轻量级的、基于发布/订阅模式的消息传输协议，适合在物联网设备之间进行数据传输。WIFI模块通过串口和WIFI之间的数据转换传输，可以实现远程控制。 然后介绍了使用STM32HAL库进行硬件开发，包括CubeMX创建工程、移植传感器和显示屏模块、以及WiFi模块的使用。CubeMX是STM32芯片图形化配置工具，可以帮助生成C初始化代码。移植了传感器和显示屏模块，以及WiFi模块，用于数据采集和上传。
STM32 HAL 库开发实战指南—基于 F7
11-29
本书参考资料为：《 STM32F76xxx 参考手册》和《 Cortex®-M7 内核编程手册》，这 两本是 ST 官方的手册，属于精华版，面面俱到，无所不包。限于篇幅问题，本书不可能 面面具到，着重框图分析和代码讲解，有关寄存器的详细描述则略过，在学习本书的时候，涉及到寄存器描述部分还请参考这两本手册，这样学习效果会更佳
STM32-HAL库开发快速入门
xuhc_zd的博客
09-06 1802
STM32-HAL库开发：记录使用HAL库开发时候如何配置STM32的各个外设-
STM32 HAL库开发教程
06-12
STM32 HAL库开发教程，首家
ST的固件库如何下载？
初出茅庐的小李
03-26 1426
ST的固件库如何下载
STM32串口通信的三种方式———HAL库实现
最新发布
ctt15703065585的博客
09-22 1710
以上3种方式各有千秋，要根据具体开发要求来选择实现方式。对于阻塞在对实时性要求不高的开发中可以使用，反之对实时要求较高的可以用到中断，和DMA。
STM32系列之HAL库开发
参商
04-04 5231
STM32 HAL库开发笔记，STM32CUBEIDE开发
Stm32学习（基于HAL库）
热门推荐
龙晨天的博客
07-26 1万+
目录 MDK软件的使用 MDK编译结果里面的几个数据的意义： MDK头文件包含 警告解决 HAL库的理解 重要的文件： HAL库特点 时钟系统 时钟树 时钟使能 时钟禁用 端口复用和重映射 MCO 输出 NVIC中断 GPIO模块 串口通信 外部中断 独立看门狗 窗口看门狗 普通定时器 普通定时器配置步骤： PWM 捕获模块 FSMC RTC时钟配置 PWR唤醒 配置步骤 ADC 配置过程 DAC 配置步骤 DMA 配置步骤： IIC 配
STM32—HAL库
sinat_22993681的博客
04-07 662
以stm32f4xx.h举例，HAL库是和CubeMX软件来互相配合使用。用CubeMx来配置STM32芯片的时钟、管脚、各个外设的底层配置，再用HAL库去调用这些底层配置文件来实现快速开发的目的。让我们省去了配置大量底层驱动的工作，集中精力专注于应用层实现功能的目的。 stm32f4xx_hal.h：stm32f4xx_hal.c/h 主要实现HAL库的初始化、系统滴答相关函数、及CPU的调试...
STM32创建HAL库工程 （手把手教）
2301_80262474的博客
04-10 3184
HAL库是ST公司目前主力推行的开发方式，全称就是Hardware Abstraction Layer（抽象印象层）。库如其名，很抽象，一眼看上去不太容易知道他的作用是什么。但它相对于标准库来说更加简洁高效，同样的功能，标准库可能要用几句话，HAL库只需用一句话就够了。并且HAL库也很好的解决了程序移植的问题。因此HAL库是ST未来主推的库。
STM32的HAL库分析及使用
hxsln11的博客
08-30 780
用户代码的第一大部分：对于外设句柄的处理。HAL库在结构上，对每个外设抽象成了一个称为ppp_HandleTypeDef的结构体，其中ppp就是每个外设的名字。*所有的函数都是工作在ppp_HandleTypeDef指针之下。多实例支持：每个外设/模块实例都有自己的句柄。因此，实例资源是独立的下面，以ADC为例外围进程相互通信：该句柄用于管理进程例程之间的共享数据资源。/***//*!/*!/*!/*!/*!/*!/*!
STM32 HAL库官方详解
11-07
很难得的Hal库驱动文件详解 可以查询Hal库函数 方便STM32 HAL开发
stm32l0系列HAL库
11-17
这是stm32l0 hal库的串口例程，自己通过cubemx生成配置工程文件，供大家学习交流
《STM32 HAL 库开发实战指南—基于F7》
01-29
《STM32 HAL 库开发实战指南—基于F7》
STM32Cube HAL库-MPU6050 DMP姿态解算源码（STM32F405）
03-21
该文档是STM32使用HAL库编程的资源,使用的单片机是STM32F405. 实现MPU6050 DMP姿态解算，内容包含Cube MX配置和Cube IDE编程。文档内包含DMP解算姿态的源码文件，HAL库编程者可进行代码移植，文档注释较为完整，阅读...
STM32HAL库RFID-RC522驱动
11-10
将原有的固件库移植到HAL库，主要是为了利用HAL库的通用性和模块化特性，提高代码的可复用性和可移植性。移植过程中，主要涉及配置GPIO、SPI接口、中断处理等相关代码的转换，确保RC522的初始化、数据传输和中断...
《STM32 HAL 库开发实战指南—基于F103霸道_V2》_hal库_stm32开发指南_V2_STM32HAL库开发实战指
10-01
《STM32 HAL库开发实战指南—基于F103霸道_V2》是一本专注于STM32微控制器的开发教程，特别关注了STM32F103系列，并且使用了STM32的HAL（Hardware Abstraction Layer）库。HAL库是意法半导体官方推出的一种全新的、...
STM32F103单片机HAL库例程-STM32Cube-FW-F1-V1.6.0-HAL库模板.rar
03-22
2、代码使用KEIL HAL库开发，当前在STM32F103运行，如果是STM32F103其他型号芯片，依然适用，请自行更改KEIL芯片型号以及FLASH容量即可。 3、软件下载时，请注意keil选择项是jlink还是stlink。 4、技术v：349014857;...
STM32STM32Cube HAL库-GPIO输入输出的介绍及应用（按键控制灯的闪烁）配套学习代码
07-17
STM32STM32Cube HAL库是ST Microelectronics公司为STM32微控制器提供的一款强大的软件开发工具，它简化了底层硬件驱动的编程，让开发者能够更专注于应用程序的逻辑。HAL库提供了统一的API接口，使得在不同系列的STM...
stmHAL库测占空比
07-27
抱歉，根据提供的引用内容，我无法理解你的问题。请提供更多的上下文或明确的问题，我将尽力帮助你。 #### 引用[.reference_title] - *1* *2* *3* [STM32——IIC总线（MPU6050应用）](https://blog.csdn.net/qq_52479948/article/details/129763752)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control_2,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

花落指尖❀

您的认可是小浪宝宝最大的动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值