📚 课程目录第1章 HAL库概述

1. HAL库概述：从标准外设库到HAL的演进

做STM32开发的朋友，一定绕不开HAL库。但说实话，很多人用了好几年HAL库，却不太清楚它到底解决了什么问题。今天我就从HAL库的诞生背景讲起，带你看看它和标准外设库的区别，再拆解一下它的层次结构。

2014年以前，STM32开发主要靠标准外设库（Standard Peripheral Library，简称SPL）。那时候我刚开始做嵌入式，用的还是STM32F103。标准外设库用起来挺顺手，寄存器操作都封装好了，直接调用函数就行。

但问题来了——芯片型号越来越多。从F1到F4，再到F7、H7，外设寄存器布局变了，中断向量表变了，时钟树也变了。你写好的F1代码，想移植到F4上？基本等于重写。我在一个项目中就吃过这个亏：客户要求从F103换到F407，结果底层驱动改了整整两周。

ST官方也意识到了这个问题。2014年，他们推出了HAL库（Hardware Abstraction Layer）。说白了，就是再加一层抽象，把硬件差异挡在下面。你上层调用的API，不管是F1还是F4，接口都一样。

核心目标：一次编写，全系通用。HAL库让代码在不同STM32系列之间移植时，只需要修改底层配置，上层逻辑几乎不用动。

我经常被问到："HAL库比标准库好在哪？" 这个问题不能简单回答"好"或"不好"。咱们直接看对比：

你看，标准库的优势在"小而快"，HAL库的优势在"通用和易移植"。我个人习惯是：产品定型、追求极致性能时用标准库或直接操作寄存器；需要快速开发、频繁换芯片时用HAL库。

注意：标准外设库在2016年就已经停止更新了。新出的STM32G0、G4、L5等系列，官方只提供HAL库。如果你还在用标准库做新项目，建议尽快迁移。

HAL库不是一堆散乱的函数，它有清晰的层次。我画了一张图，你看完就明白了：

从这张图你能看到，HAL库一共分了5层。我重点讲一下中间三层：

HAL API层 是你最常打交道的。比如初始化一个UART：

// HAL API风格
UART_HandleTypeDef huart1;
HAL_UART_Init(&huart1);
HAL_UART_Transmit(&huart1, data, len, 1000);

这些函数内部做了很多事：检查参数、处理超时、管理状态机。你只管调用，不用操心底层细节。但代价就是——慢。每次调用都要经过好几层函数跳转。

LL层 是后来加的，算是HAL库的"瘦身版"。它直接操作寄存器，但保留了统一的接口命名。比如：

// LL层风格
LL_USART_Init(USART1, LL_USART_BAUDRATE_115200);
LL_USART_TransmitData8(USART1, data);

LL层没有状态机，没有超时处理，你调什么它就干什么。我一般在中断服务函数里用LL层，因为HAL API在中断里容易出问题。

我的建议：主流程用HAL API，中断和DMA回调里用LL层。这样既保证了代码可读性，又不会在关键路径上损失性能。

寄存器层 就是CMSIS定义的结构体和宏。比如 USART1->DR、GPIOA->ODR。这一层HAL库和标准库是共用的，底层都是同一套东西。

我曾经在一个项目里混用了HAL和LL来操作同一个UART。初始化用HAL，发送用LL。结果发现发送完数据后，HAL的状态机卡住了。查了半天才发现——LL层发送完不会更新HAL的 gState 标志位。HAL以为还在发送中，后续调用全部返回超时。

所以记住：同一个外设，要么全用HAL，要么全用LL。混用时要手动同步状态。

我列了一个简单的决策清单：