单片机与物联网 / 系统课时
HAL、LL 与寄存器开发
HAL、LL 与寄存器开发
STM32 外设既可以通过 HAL 调用,也可以使用 LL 或直接操作寄存器。本课用同一个 GPIO 点亮任务对比三种写法,帮助你根据可读性、实时性、移植成本和维护风险选择合适的开发层级。
学习目标
- 理解 HAL、LL 与寄存器编程的抽象层级和调用路径。
- 比较三种方式在可读性、控制粒度、性能与维护成本上的差异。
- 在同一工程中安全地选择或组合不同开发方式。
三种方式的抽象层级
HAL 提供较完整的外设抽象,常用结构体、句柄和状态码组织配置,适合快速开发与团队协作。LL 以接近寄存器的一组内联函数和常量封装位操作,代码更轻、控制更直接。寄存器编程则直接读写 CMSIS 设备头文件定义的寄存器字段,最接近硬件,但也最依赖具体芯片。

| 维度 | HAL | LL | 直接寄存器 |
|---|---|---|---|
| 抽象程度 | 高 | 中 | 低 |
| 可读性与一致性 | 较高 | 较高 | 依赖作者经验 |
| 控制粒度 | 常规功能充分 | 接近硬件 | 完全直接 |
| 迁移成本 | 同系列内较低 | 中等 | 较高 |
| 典型用途 | 初始化、通用业务 | 高频路径、精细控制 | 启动代码、特殊时序、极限优化 |
不能简单地把 HAL 等同于“慢”、寄存器等同于“快”。实际差异取决于函数是否被内联、编译优化等级、调用频率和外设等待时间。对于低频配置代码,HAL 的额外开销通常不重要;对于高频中断或严格时序路径,LL 或寄存器方式更容易控制每一步操作。
选择依据与工程取舍
优先选择能满足需求的最高抽象层。普通 GPIO、UART、I2C 和初始化流程通常使用 HAL 更容易维护;需要减少函数层级、精确控制标志位或缩短中断路径时,可以使用 LL;只有在库未覆盖特殊功能、启动阶段尚未初始化库,或必须控制特定位序列时,才考虑直接寄存器。
三种方式可以共存,但必须明确“谁拥有这个外设”。若 HAL 正在维护某个外设状态机,另一个模块又直接改写同一寄存器,句柄状态与硬件状态可能失去同步。混合开发时应按外设或功能边界划分层级,并优先使用 CMSIS 提供的寄存器名和位掩码,避免难以审查的魔法数字。
同一 GPIO 功能的三种实现
下面的 main.c 面向 NUCLEO-F103RB,目标是把 PA5 配置为推挽输出并置高,使板载 LD2 常亮。工程需要包含 STM32F1 HAL、LL 和 CMSIS 头文件。每次只把一个实现宏设为 1,即可分别编译三种路径。
#include "stm32f1xx_hal.h"
#include "stm32f1xx_ll_bus.h"
#include "stm32f1xx_ll_gpio.h"
#define USE_HAL 1
#define USE_LL 0
#define USE_REGISTER 0
#if (USE_HAL + USE_LL + USE_REGISTER) != 1
#error "Exactly one implementation must be enabled"
#endif
volatile uint32_t g_gpioa_odr;
static void LED_Init_HAL(void);
static void LED_Init_LL(void);
static void LED_Init_Register(void);
int main(void)
{
#if USE_HAL
LED_Init_HAL();
#elif USE_LL
LED_Init_LL();
#else
LED_Init_Register();
#endif
/* 读取输出寄存器,便于在调试器中验证 PA5 状态。 */
g_gpioa_odr = GPIOA->ODR;
while (1)
{
}
}
static void LED_Init_HAL(void)
{
GPIO_InitTypeDef gpio = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();
gpio.Pin = GPIO_PIN_5;
gpio.Mode = GPIO_MODE_OUTPUT_PP;
gpio.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOA, &gpio);
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);
}
static void LED_Init_LL(void)
{
LL_GPIO_InitTypeDef gpio = {0};
LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_GPIOA);
gpio.Pin = LL_GPIO_PIN_5;
gpio.Mode = LL_GPIO_MODE_OUTPUT;
gpio.Speed = LL_GPIO_SPEED_FREQ_LOW;
gpio.OutputType = LL_GPIO_OUTPUT_PUSHPULL;
LL_GPIO_Init(GPIOA, &gpio);
LL_GPIO_SetOutputPin(GPIOA, LL_GPIO_PIN_5);
}
static void LED_Init_Register(void)
{
/* STM32F1 的 GPIOA 时钟位于 APB2 总线。 */
RCC->APB2ENR |= RCC_APB2ENR_IOPAEN;
/* 清除 PA5 原配置,再设置为 2 MHz 推挽输出。 */
GPIOA->CRL &= ~(GPIO_CRL_MODE5 | GPIO_CRL_CNF5);
GPIOA->CRL |= GPIO_CRL_MODE5_1;
GPIOA->BSRR = GPIO_BSRR_BS5;
}预期结果
无论启用哪一种实现,烧录后板载 LD2 都应常亮,调试器中的 g_gpioa_odr 第 5 位为 1。由于没有串口输出,验证结果以 LED 状态和寄存器值为准。
LD2:常亮
GPIOA->ODR bit 5 = 1
USE_HAL、USE_LL、USE_REGISTER 中仅有一个值为 1验证方法与常见错误
第一类错误是没有开启 GPIO 外设时钟。STM32F1 的 GPIOA 位于 APB2,而许多后续系列把 GPIO 放在 AHB 总线上,复制代码时必须查目标芯片的 RCC 章节。第二类错误是直接给整个寄存器赋值,意外清除同一寄存器中的其他位;除非确实要覆盖全部字段,否则应使用位掩码读改写,或使用 BSRR 这类原子置位寄存器。
第三类错误是在 HAL 已接管外设后,又绕过 HAL 修改关键状态位。例如,直接清除中断标志可能让 HAL 回调逻辑失效。调试混合代码时,应同时观察外设寄存器、HAL 句柄状态和中断调用链,确认软件状态与硬件状态一致。
本课总结
- HAL、LL 和寄存器编程不是互相排斥的阵营,而是不同抽象层级的工具。
- 工程中应优先选择可维护的最高层级,只在关键路径或特殊硬件需求中逐步下沉。
- 混合开发的核心是明确外设所有权,并避免多个层级同时修改同一状态机或寄存器。
下一课预告
下一阶段可以继续学习中断、异常与外设驱动,把本课的访问方式应用到事件响应、时序控制和驱动调试中。