2. STM32基础与GPIO外设：时钟树、模式配置、寄存器与HAL库操作、点亮LED实战

好，咱们正式开始动手了。这一章我带你搞定两件事：时钟树和GPIO。这两样东西，说白了就是STM32的“心跳”和“手脚”。时钟不给对，芯片跑不起来；GPIO配不对，外设动不了。我在项目里见过太多人卡在时钟配置上，一卡就是半天。咱们今天就把这块硬骨头啃下来。

2.1 时钟树——STM32的“心脏”

时钟是什么？你可以把它想象成芯片的“心跳”。CPU、外设、总线，每一步操作都得靠时钟来同步。STM32的时钟树比51单片机复杂得多，但别怕，咱们拆开看。

2.1.1 时钟源有哪些？

STM32有四个时钟源，我习惯把它们分成两类：

时钟源	类型	典型频率	用途
HSI（高速内部）	RC振荡器	8 MHz	上电默认，精度一般
HSE（高速外部）	晶振	4~16 MHz	高精度，常用主时钟
LSI（低速内部）	RC振荡器	32 kHz	独立看门狗、RTC
LSE（低速外部）	晶振	32.768 kHz	RTC精准计时

嗯，这里要注意：HSI上电默认启用，但精度不够。如果你做串口通信或者USB，必须切到HSE。我曾经有个项目，量产时发现有几块板子串口乱码，查了两天——原来是HSI频率漂了，换HSE立马解决。

2.1.2 PLL与系统时钟路径

系统时钟（SYSCLK）怎么来的？流程是这样的：

1. 选择一个时钟源（HSI/HSE）
2. 经过PLL倍频（可选）
3. 输出到SYSCLK
4. 再分频给AHB、APB1、APB2总线

举个例子，我用F103时，常用配置是：HSE 8 MHz → PLL 9倍频 → SYSCLK 72 MHz。这个频率下，Flash需要配2个等待周期，不然CPU跑太快，Flash跟不上。

你想想看，如果PLL_M、PLL_N、PLL_P这三个参数配错一个，频率就全歪了。我建议你刚开始时直接用CubeMX生成，然后对着生成的代码看一遍，理解每个参数的含义。

2.2 GPIO模式配置——不只是输入输出

很多人以为GPIO就是“高电平”和“低电平”。其实STM32的GPIO有8种模式，选错了，外设就不干活。

2.2.1 八种模式一览

模式	缩写	典型场景
浮空输入	IN_FLOATING	按键检测（外部电平不确定）
上拉输入	IPU	按键检测（默认高电平）
下拉输入	IPD	按键检测（默认低电平）
模拟输入	AIN	ADC采样
推挽输出	PP	LED、普通IO
开漏输出	OD	I2C总线、电平转换
复用推挽	AF_PP	USART_TX、SPI_SCK
复用开漏	AF_OD	I2C_SCL/SDA

我个人习惯：输出用推挽，总线用开漏，输入看外部电路。比如驱动LED，推挽输出直接拉高拉低就行。但如果是I2C，必须用开漏，因为总线需要“线与”功能。

2.3 寄存器与HAL库操作——两种思路

操作GPIO有两种方式：直接操作寄存器和调用HAL库函数。我建议你两种都学，但初期先用HAL库上手，等熟悉了再去看寄存器。

2.3.1 寄存器方式

每个GPIO端口有7个寄存器，最常用的是这几个：

• GPIOx_CRL/CRH：配置模式（F103用）
• GPIOx_MODER：配置模式（F4/F7用）
• GPIOx_ODR：输出数据寄存器
• GPIOx_BSRR：位设置/复位寄存器（推荐用这个）
• GPIOx_IDR：输入数据寄存器

举个例子，点亮LED的寄存器写法：

// 开启GPIOB时钟（F103）
RCC->APB2ENR |= (1 << 3);

// 配置PB0为推挽输出，50MHz
GPIOB->CRL &= ~(0x0F << 0);  // 先清零
GPIOB->CRL |= (0x03 << 0);   // 设置为推挽输出

// 输出高电平（点亮LED）
GPIOB->BSRR = (1 << 0);      // 用BSRR，比ODR快

为什么推荐BSRR？因为它原子操作，不会被中断打断。ODR需要读-改-写，中间可能被中断插一脚，导致输出错误。

2.3.2 HAL库方式

HAL库把寄存器操作封装成了函数，代码更易读：

// 初始化GPIO
GPIO_InitTypeDef GPIO_InitStruct = {0};

__HAL_RCC_GPIOB_CLK_ENABLE();   // 开启时钟

GPIO_InitStruct.Pin = GPIO_PIN_0;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;   // 推挽输出
GPIO_InitStruct.Pull = GPIO_NOPULL;           // 无上下拉
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; // 高速
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

// 输出高电平
HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET);

你看，HAL库的代码更“人类可读”。但代价是代码体积大、执行速度慢。在RTOS中，如果对实时性要求高，我有时会混合使用：初始化用HAL库，运行时直接操作寄存器。

2.4 点亮LED实战——从原理图到代码

好，理论说完了，咱们动手。点亮LED是嵌入式界的“Hello World”，但别小看它——这里面包含了时钟配置、GPIO模式、输出操作三个核心步骤。

2.4.1 硬件连接

假设我们的开发板上，LED接在PB0，阳极通过一个330Ω电阻连到VCC（3.3V），阴极连到PB0。也就是说：PB0输出低电平时，LED亮；输出高电平时，LED灭。

嗯，这里要注意：低电平点亮和高电平点亮，代码正好相反。我见过有人把逻辑搞反，灯死活不亮，还以为是硬件坏了。

2.4.2 完整代码（HAL库版）

#include "stm32f4xx_hal.h"

void LED_Init(void)
{
    __HAL_RCC_GPIOB_CLK_ENABLE();   // 开启GPIOB时钟

    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.Pin = GPIO_PIN_0;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;  // LED不需要高速
    HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

    // 初始状态：灭（输出高电平）
    HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET);
}

void LED_On(void)
{
    HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_RESET);  // 低电平点亮
}

void LED_Off(void)
{
    HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET);    // 高电平熄灭
}

void LED_Toggle(void)
{
    HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0);
}

int main(void)
{
    HAL_Init();         // 初始化HAL库
    LED_Init();         // 初始化LED

    while (1)
    {
        LED_On();
        HAL_Delay(500); // 亮500ms
        LED_Off();
        HAL_Delay(500); // 灭500ms
    }
}

2.4.3 完整代码（寄存器版）

#include "stm32f4xx.h"

void LED_Init(void)
{
    RCC->AHB1ENR |= (1 << 1);          // 开启GPIOB时钟

    GPIOB->MODER &= ~(0x03 << (0*2)); // 清零PB0模式位
    GPIOB->MODER |= (0x01 << (0*2));  // 设置为输出模式

    GPIOB->OTYPER &= ~(1 << 0);       // 推挽输出
    GPIOB->OSPEEDR &= ~(0x03 << (0*2)); // 低速

    GPIOB->BSRR = (1 << 0);           // 初始灭
}

void LED_On(void)
{
    GPIOB->BSRR = (1 << (0 + 16));    // BR0置位，输出低电平
}

void LED_Off(void)
{
    GPIOB->BSRR = (1 << 0);           // BS0置位，输出高电平
}

void LED_Toggle(void)
{
    GPIOB->ODR ^= (1 << 0);           // 异或翻转
}

int main(void)
{
    LED_Init();

    while (1)
    {
        LED_On();
        for(volatile uint32_t i=0; i<500000; i++); // 简单延时
        LED_Off();
        for(volatile uint32_t i=0; i<500000; i++);
    }
}

2.5 本章知识体系

下面这张图，把本章的核心知识点串起来了。你可以把它当作一个“思维导图”，复习时对照着看。

这张图里，左边是时钟树，右边是GPIO，中间靠“时钟使能”连接。你想想看，如果GPIOB的时钟没开，后面所有操作都是白费。这就是为什么我总说：调试时先检查时钟。

好，这一章的内容就到这儿。时钟树和GPIO是STM32的基石，后面所有外设驱动都离不开它们。你把这一章吃透了，后面的路就好走了。