STM32库函数调用流程详解#

STM32 开发有两种主流库：标准外设库（StdPeriph） 和 HAL 库。理解库函数的调用架构是掌握 STM32 开发的关键。

库架构总览#

分层结构#

1
┌─────────────────────────────────┐
2
│         用户应用程序              │
3
├─────────────────────────────────┤
4
│     HAL库 / 标准外设库           │
5
├─────────────────────────────────┤
6
│     CMSIS（ARM内核接口层）        │
7
├─────────────────────────────────┤
8
│         寄存器操作                │
9
├─────────────────────────────────┤
10
│         硬件外设                  │
11
└─────────────────────────────────┘

CMSIS 层#

CMSIS（Cortex Microcontroller Software Interface Standard）是 ARM 定义的内核访问接口：

1
// core_cm3.h 中定义的内核访问函数
2
__enable_irq()      // 开启中断
3
__disable_irq()     // 关闭中断
4
NVIC_EnableIRQ()    // 使能指定中断
5
NVIC_SetPriority()  // 设置中断优先级
6
SysTick_Config()    // 配置系统滴答定时器

HAL 库调用流程#

初始化流程#

以 GPIO 为例，HAL 库的典型调用链：

1
// 1. 开启时钟
2
__HAL_RCC_GPIOA_CLK_ENABLE();
3

4
// 2. 配置 GPIO
5
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
6

7
// 3. 读写操作
8
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);
9
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
10
GPIO_PinState state = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0);

HAL 库函数命名规则#

1
HAL_外设名_操作类型()

操作类型	说明	示例
Init	初始化	HAL_GPIO_Init()
DeInit	反初始化	HAL_UART_DeInit()
Read	读取	HAL_ADC_GetValue()
Write	写入	HAL_DAC_SetValue()
Transmit	发送	HAL_UART_Transmit()
Receive	接收	HAL_UART_Receive()
Start	启动	HAL_TIM_Base_Start()
Stop	停止	HAL_TIM_Base_Stop()
MSPInit	底层初始化	HAL_UART_MspInit()

GPIO 完整调用流程#

配置结构体#

1
typedef struct {
2
    uint32_t Pin;       // 引脚号
3
    uint32_t Mode;      // 模式
4
    uint32_t Pull;      // 上下拉
5
    uint32_t Speed;     // 速度
6
    uint32_t Alternate; // 复用功能
7
} GPIO_InitTypeDef;

初始化流程详解#

1
void GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init) {
2
    // 1. 配置模式寄存器 (MODER)
3
    // 2. 配置输出类型寄存器 (OTYPER)
4
    // 3. 配置速度寄存器 (OSPEEDR)
5
    // 4. 配置上下拉寄存器 (PUPDR)
6
    // 5. 配置复用功能寄存器 (AFR)
7
}

实战：LED 闪烁#

1
#include "stm32f1xx_hal.h"
2

3
void LED_Init(void) {
4
    GPIO_InitTypeDef GPIO_InitStruct = {0};
5

6
    // 1. 开启 GPIOA 时钟
7
    __HAL_RCC_GPIOA_CLK_ENABLE();
8

9
    // 2. 配置 PA5 为推挽输出
10
    GPIO_InitStruct.Pin = GPIO_PIN_5;
11
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
12
    GPIO_InitStruct.Pull = GPIO_NOPULL;
13
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
14
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
15

16
    // 3. 初始状态关闭 LED
17
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);
18
}
19

20
int main(void) {
21
    HAL_Init();
22
    SystemClock_Config();
23
    LED_Init();
24

25
    while (1) {
26
        HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
27
        HAL_Delay(500);
28
    }
29
}

USART 完整调用流程#

配置结构体#

1
typedef struct {
2
    uint32_t BaudRate;      // 波特率
3
    uint32_t WordLength;    // 数据位
4
    uint32_t StopBits;      // 停止位
5
    uint32_t Parity;        // 校验位
6
    uint32_t Mode;          // 收发模式
7
    uint32_t HwFlowCtl;     // 硬件流控
8
    uint32_t OverSampling;  // 过采样
9
} UART_InitTypeDef;

初始化调用链#

1
HAL_UART_Init()
2
    └── UART_SetConfig()          // 配置波特率、数据位等
3
        └── UART_SetBaudRate()    // 计算并设置波特率寄存器
4
    └── HAL_UART_MspInit()        // 底层硬件初始化（用户重写）
5
        ├── __HAL_RCC_USART1_CLK_ENABLE()  // 开启时钟
6
        ├── GPIO 配置                        // TX/RX 引脚
7
        └── NVIC 配置                        // 中断优先级

实战：串口发送#

1
UART_HandleTypeDef huart1;
2

3
void USART1_Init(void) {
4
    huart1.Instance = USART1;
5
    huart1.Init.BaudRate = 115200;
6
    huart1.Init.WordLength = UART_WORDLENGTH_8B;
7
    huart1.Init.StopBits = UART_STOPBITS_1;
8
    huart1.Init.Parity = UART_PARITY_NONE;
9
    huart1.Init.Mode = UART_MODE_TX_RX;
10
    huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;
11
    huart1.Init.OverSampling = UART_OVERSAMPLING_16;
12
    HAL_UART_Init(&huart1);
13
}
14

15
// 底层初始化（重写 MSP 函数）
16
void HAL_UART_MspInit(UART_HandleTypeDef *huart) {
17
    if (huart->Instance == USART1) {
18
        GPIO_InitTypeDef GPIO_InitStruct = {0};
19

20
        __HAL_RCC_USART1_CLK_ENABLE();
21
        __HAL_RCC_GPIOA_CLK_ENABLE();
22

23
        // PA9 - TX
24
        GPIO_InitStruct.Pin = GPIO_PIN_9;
25
        GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
26
        GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
27
        HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
28

29
        // PA10 - RX
30
        GPIO_InitStruct.Pin = GPIO_PIN_10;
31
        GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
32
        GPIO_InitStruct.Pull = GPIO_NOPULL;
33
        HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
34
    }
35
}
36

37
// 发送字符串
38
void USART1_SendString(char *str) {
39
    HAL_UART_Transmit(&huart1, (uint8_t *)str, strlen(str), 100);
40
}
41

42
int main(void) {
43
    HAL_Init();
44
    SystemClock_Config();
45
    USART1_Init();
46

47
    while (1) {
48
        USART1_SendString("Hello STM32!\r\n");
49
        HAL_Delay(1000);
50
    }
51
}

定时器完整调用流程#

配置结构体层次#

1
TIM_HandleTypeDef htim;           // 句柄
2
  └── TIM_Base_InitTypeDef Init;  // 基础配置
3
        ├── Prescaler             // 预分频器
4
        ├── CounterMode           // 计数模式
5
        ├── Period                // 周期/重装值
6
        └── ClockDivision         // 时钟分频

初始化调用链#

1
HAL_TIM_Base_Init()
2
    └── TIM_Base_SetConfig()      // 配置 PSC、ARR、计数模式
3
    └── HAL_TIM_Base_MspInit()    // 底层初始化（用户重写）
4
        ├── 时钟使能
5
        ├── GPIO 配置（如需要）
6
        └── NVIC 配置（如需要中断）

实战：定时器中断#

1
TIM_HandleTypeDef htim2;
2

3
void TIM2_Init(void) {
4
    // 72MHz 主频，定时 1ms
5
    // 72MHz / (71+1) / (999+1) = 1kHz
6
    htim2.Instance = TIM2;
7
    htim2.Init.Prescaler = 71;
8
    htim2.Init.CounterMode = TIM_COUNTERMODE_UP;
9
    htim2.Init.Period = 999;
10
    htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
11
    htim2.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_ENABLE;
12
    HAL_TIM_Base_Init(&htim2);
13

14
    // 启动定时器中断
15
    HAL_TIM_Base_Start_IT(&htim2);
16
}
17

18
void HAL_TIM_Base_MspInit(TIM_HandleTypeDef *htim) {
19
    if (htim->Instance == TIM2) {
20
        __HAL_RCC_TIM2_CLK_ENABLE();
21
        HAL_NVIC_SetPriority(TIM2_IRQn, 1, 0);
22
        HAL_NVIC_EnableIRQ(TIM2_IRQn);
23
    }
24
}
25

26
// 中断服务函数
27
void TIM2_IRQHandler(void) {
28
    HAL_TIM_IRQHandler(&htim2);
29
}
30

31
// 定时器回调函数
32
volatile uint32_t tick = 0;
33
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) {
34
    if (htim->Instance == TIM2) {
35
        tick++;
36
        if (tick >= 1000) {  // 1秒
37
            tick = 0;
38
            HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
39
        }
40
    }
41
}

中断处理流程#

HAL 库中断处理机制#

1
硬件中断触发
2
    ↓
3
中断向量表 → IRQHandler()
4
    ↓
5
HAL_XXX_IRQHandler()
6
    ↓
7
检查中断标志位
8
    ↓
9
清除标志位 + 调用回调函数
10
    ↓
11
HAL_XXX_Callback()  ← 用户实现

回调函数列表#

外设	回调函数	触发条件
UART	HAL_UART_TxCpltCallback()	发送完成
UART	HAL_UART_RxCpltCallback()	接收完成
TIM	HAL_TIM_PeriodElapsedCallback()	定时器溢出
GPIO	HAL_GPIO_EXTI_Callback()	外部中断
ADC	HAL_ADC_ConvCpltCallback()	ADC转换完成
DMA	HAL_DMA_XferCpltCallback()	DMA传输完成

标准库 vs HAL 库对比#

GPIO 操作对比#

1
// 标准库
2
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);
3
GPIO_InitTypeDef GPIO_InitStruct;
4
GPIO_InitStruct.GPIO_Pin = GPIO_Pin_5;
5
GPIO_InitStruct.GPIO_Mode = GPIO_Mode_Out_PP;
6
GPIO_InitStruct.GPIO_Speed = GPIO_Speed_50MHz;
7
GPIO_Init(GPIOA, &GPIO_InitStruct);
8
GPIO_SetBits(GPIOA, GPIO_Pin_5);
9

10
// HAL 库
11
__HAL_RCC_GPIOA_CLK_ENABLE();
12
GPIO_InitTypeDef GPIO_InitStruct = {0};
13
GPIO_InitStruct.Pin = GPIO_PIN_5;
14
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
15
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
16
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
17
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);

函数映射表#

操作	标准库	HAL库
开启时钟	RCC_APB2PeriphClockCmd()	__HAL_RCC_XXX_CLK_ENABLE()
GPIO初始化	GPIO_Init()	HAL_GPIO_Init()
设置引脚	GPIO_SetBits()	HAL_GPIO_WritePin()
清除引脚	GPIO_ResetBits()	HAL_GPIO_WritePin()
读取引脚	GPIO_ReadInputDataBit()	HAL_GPIO_ReadPin()
串口发送	USART_SendData()	HAL_UART_Transmit()
定时器启动	TIM_Cmd()	HAL_TIM_Base_Start()

系统初始化流程#

HAL_Init() 做了什么#

1
HAL_StatusTypeDef HAL_Init(void) {
2
    // 1. 配置 Flash 预取缓冲区
3
    // 2. 设置中断优先级分组（默认 Group 4）
4
    // 3. 配置 SysTick 定时器（1ms 中断）
5
    // 4. 调用 HAL_MspInit()（用户可重写）
6
    return HAL_OK;
7
}

SystemClock_Config() 流程#

1
void SystemClock_Config(void) {
2
    // 1. 配置 Flash 等待周期
3
    __HAL_FLASH_SET_LATENCY(FLASH_LATENCY_2);
4

5
    // 2. 配置 HSE（外部高速晶振）
6
    RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
7
    RCC_OscInitStruct.HSEState = RCC_HSE_ON;
8

9
    // 3. 配置 PLL（锁相环）
10
    RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
11
    RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;  // 8MHz × 9 = 72MHz
12

13
    // 4. 配置总线时钟
14
    RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_PCLK1;
15
    RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;    // AHB = 72MHz
16
    RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;     // APB1 = 36MHz
17

18
    HAL_RCC_OscConfig(&RCC_OscInitStruct);
19
    HAL_RCC_ClockConfig(&RCC_ClkInitStruct);
20
}

常见问题#

HAL_Delay() 卡死#

原因：中断优先级问题，SysTick 中断被更高优先级中断阻塞

解决：

1
// 确保 SysTick 优先级为最低
2
HAL_NVIC_SetPriority(SysTick_IRQn, 15, 0);

MSP 函数不被调用#

原因：MSP 函数需要在 stm32f1xx_hal_msp.c 中定义，或在主文件中重新实现

解决：

1
// 确保函数名正确，且在 HAL 库调用前定义
2
void HAL_UART_MspInit(UART_HandleTypeDef *huart) {
3
    // 底层初始化代码
4
}

时钟配置错误#

检查清单：

HSE 晶振频率是否匹配
PLL 倍频系数是否正确
总线分频是否在允许范围内
Flash 等待周期是否匹配

总结#

层级	职责	示例函数
用户层	业务逻辑	main(), 应用函数
HAL库	统一接口	HAL_GPIO_Init()
MSP层	底层硬件	HAL_UART_MspInit()
CMSIS	内核访问	NVIC_EnableIRQ()
寄存器	直接操作	GPIOA->ODR

掌握 HAL 库的调用流程，重点理解：

初始化链：Init → SetConfig → MspInit
中断机制：IRQHandler → 回调函数
MSP 分离：硬件相关代码放在 MSP 函数中

わたしの部屋

STM32库函数调用流程详解#

库架构总览#

分层结构#

CMSIS 层#

HAL 库调用流程#

初始化流程#

HAL 库函数命名规则#

GPIO 完整调用流程#

配置结构体#

初始化流程详解#

实战：LED 闪烁#

USART 完整调用流程#

配置结构体#

初始化调用链#

实战：串口发送#

定时器完整调用流程#

配置结构体层次#

初始化调用链#

实战：定时器中断#

中断处理流程#

HAL 库中断处理机制#

回调函数列表#

标准库 vs HAL 库对比#

GPIO 操作对比#

函数映射表#

系统初始化流程#

HAL_Init() 做了什么#

SystemClock_Config() 流程#

常见问题#

HAL_Delay() 卡死#

MSP 函数不被调用#

时钟配置错误#

总结#