在STM32开发中，HAL库与标准库（SPL）在硬件抽象层（HAL）的本质区别/前者移植性更强的原因（嵌入式初级打手）-CSDN博客

本文链接：https://blog.csdn.net/2402_85133798/article/details/147432563

作为嵌入式初级打手，让我来为你通俗易懂又专业的讲解——在STM32开发中，HAL库与标准库（SPL）在硬件抽象层（HAL）的本质区别可概括为"硬件差异的中间层隔离"与"硬件特征的统一接口表达"，具体体现在以下四方面：

一、寄存器访问的抽象级别

也可从硬件抽象层理解
标准库（硬件直连模式）：

寄存器映射直译：用C结构体直接对应物理寄存器（如RCC->CR |= RCC_CR_HSEON）
代码示例：

// F1系列GPIO配置（直接暴露CRL/CRH寄存器差异）
GPIO_InitTypeDef init;
init.GPIO_Pin = GPIO_Pin_5;      // 物理引脚编号
init.GPIO_Mode = GPIO_Mode_Out_PP; // F1特有模式定义
GPIO_Init(GPIOA, &init);

问题：F4系列需改用GPIO_MODER寄存器，代码完全重写

HAL库（中间层隔离模式）：

统一参数映射：通过中间层自动转换物理差异（
代码示例：

GPIO_InitTypeDef init;
init.Pin = GPIO_PIN_5;           // 抽象引脚标识
init.Mode = GPIO_MODE_OUTPUT_PP; // 跨系列统一模式
HAL_GPIO_Init(GPIOA, &init);     // 内部自动选择CRL/CRH或MODER

优势：同一代码在F1/F4/H7等系列可直接运行

插入一个小知识点，嵌入式系统中的硬件抽象层级 (HAL) 概念及组成

硬件抽象层定义
硬件抽象层（Hardware Abstraction Layer, HAL）是一种软件结构，用于隐藏底层硬件的具体细节并提供统一的接口给上层应用程序调用。这种设计方法使得开发者无需深入了解具体的硬件实现即可完成程序开发。

HAL 的主要作用
1. 屏蔽硬件差异：不同型号的微控制器可能具有不同的寄存器布局和工作方式，通过 HAL 可以把这些差异封装起来，在应用层面呈现一致的行为。
2. 提高代码重用率：由于 HAL 提供了一组标准化 API 接口，因此可以在多个项目之间共享相同的驱动代码。
3. 简化开发流程：减少了直接操作硬件所需的知识量和技术难度，使更多精力集中在算法实现或者用户体验优化等方面。

二、外设管理机制

典型场景：
使用HAL库发送UART数据时，通过句柄机制自动管理TC（传输完成）标志和DMA联动，而标准库需手动清除标志位并处理竞态条件。

三、中断处理架构

标准库的中断裸奔模式：

void USART1_IRQHandler(void) {
  if(USART_GetITStatus(USART1, USART_IT_RXNE) != RESET) {
    uint8_t data = USART_ReceiveData(USART1); // 直接读DR寄存器
    // 业务处理...
  }
}

缺陷：业务代码与硬件中断强耦合，移植时需重写整个ISR

插入一个小知识点嵌入式开发中的标准库中断裸奔模式

在嵌入式开发中，“裸奔”通常指不依赖于操作系统的环境下运行程序，即直接基于硬件资源进行编程而无需借助实时操作系统（RTOS）。在这种情况下，使用标准外设库来管理设备的功能是一种常见的方式。例如，在STM32系列微控制器中，开发者可以选择使用ST公司提供的标准外设库（Standard Peripheral Library, SPL），而不是更高级别的HAL库。

HAL库的回调分层架构：

// 硬件相关层（自动适配系列差异）
void HAL_UART_IRQHandler(UART_HandleTypeDef *huart) {
  if(__HAL_UART_GET_FLAG(huart, UART_FLAG_RXNE)) {
    uint8_t data = (uint8_t)(huart->Instance->DR); 
    HAL_UART_RxCpltCallback(huart); // 触发回调
  }
}

// 应用层（跨平台通用）
__weak void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
  // 用户可重写此函数，无需接触寄存器
}

优势：更换芯片系列时只需保证HAL_UART_IRQHandler正确实现，应用层代码完全复用

插入一个小知识点，关于HAL库回调分层架构的设计

1. 分层架构概述
嵌入式系统中的分层架构是一种将软件划分为不同层次的方法，每一层负责特定的功能和服务。这种架构能够降低软件的复杂度和耦合度，提高其可移植性和可维护性。

在STM32嵌入式开发中，通常采用三层结构：内核层、驱动层和业务层。其中，HAL（Hardware Abstraction Layer）库位于内核层，主要作用是对底层硬件进行抽象，使得开发者可以更方便地操作外设而无需关心具体的寄存器细节。

2. HAL库的作用及其特点
HAL库是由ST官方提供的硬件抽象层，它屏蔽了芯片内部复杂的寄存器操作，提供了统一的API接口供用户调用。通过这些API，可以直接访问各种外设资源，如GPIO、UART、SPI等。此外，HAL库还支持中断模式以及DMA传输等功能。

3. 回调机制简介
为了进一步增强程序灵活性并减少主线程负担，在现代嵌入式编程实践中广泛采用了基于事件驱动模型下的回调技术。当某个条件满足或者外部触发信号到来时，则会自动执行预先注册好的相应处理函数——即所谓的“回调”。

具体到STM32 HAL库而言，其实现了一套完善的回调框架来管理各类异步事件的通知过程。例如对于串口接收数据完毕这一场景来说，我们可以通过设置`__weak`修饰符定义默认版本的RxCompleteCallback方法；如果项目中有特殊需求的话也可以重写该方法来自定义行为逻辑。

以下是关于如何自定义一个简单的串口中断服务例程并通过回调通知上层应用的例子：

// 用户定义的全局变量用于存储接收到的数据缓冲区指针及长度信息
uint8_t RxBuffer[64];
volatile uint16_t ReceivedLength;

/**
 * @brief UART 接收完成后的回调函数
 */
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
    /* 检查当前实例是否为目标设备句柄 */
    if(huart->Instance == USARTx){
        // 更新已接收字节数量统计值
        ReceivedLength += huart->hdmarx->Instance->NDTR;
        
        // 调整剩余空间大小重新启动新一轮 DMA 请求直到达到最大容量为止
        if(ReceivedLength < sizeof(RxBuffer)){
            __HAL_DMA_DISABLE(&hdma_usart_rx);
            hdma_usart_rx.Init.NbData = sizeof(RxBuffer)-ReceivedLength;
            __HAL_LINKDMA(huart,hdmarx,&hdma_usart_rx);
            HAL_DMA_Start_IT(&hdma_usart_rx,(uint32_t)&USARTx->DR,(uint32_t)(RxBuffer+ReceivedLength),sizeof(RxBuffer)-ReceivedLength);
            __HAL_DMA_ENABLE(&hdma_usart_rx);
            
            // 清除标志位以便下次判断使用
            __HAL_UART_CLEAR_FLAG(huart,UART_FLAG_TC);
            __HAL_UART_ENABLE_IT(huart,UART_IT_RXNE);
        }
        else {
            // 如果已经填满整个缓存则停止继续采集新消息直至被读取走一部分腾出位置后再恢复工作流程
            __HAL_UART_DISABLE_IT(huart,UART_IT_IDLE);
        }
    }
}
```