2. STM32硬件最小系统与GPIO编程

STM32能跑起来，靠的不是芯片单独工作，而是一套“最小系统”在背后支撑：电源、时钟、复位、启动模式选择，再加上调试接口。把这四件事理顺，GPIO编程才有稳定的地基。本节围绕时钟树配置、复位与启动模式、GPIO输入输出模式、按键与LED驱动以及位带操作展开，目标是让你能独立点亮一颗LED、读到一个按键，并理解每一步背后的硬件依据。

一、时钟树：先给芯片一个“心跳”

STM32的时钟不是单一来源，而是一棵树。以常见的STM32F103为例，可选时钟源有四个：内部高速HSI（约8MHz）、外部高速HSE（通常接8MHz晶振）、内部低速LSI（约40kHz，供独立看门狗和RTC）、外部低速LSE（32.768kHz，供RTC）。系统时钟SYSCLK可以来自HSI、HSE或PLL倍频输出。

典型配置路径是：HSE 8MHz → PLL倍频×9 → SYSCLK 72MHz。PLL输出先经过AHB预分频器得到HCLK（72MHz），再经APB1预分频器（÷2）得到PCLK1=36MHz，经APB2预分频器（÷1）得到PCLK2=72MHz。注意APB1最高只能到36MHz，超了会不稳定；而GPIO挂在APB2上，所以PCLK2直接决定GPIO翻转速度上限。

配置顺序不能乱：先使能HSE并等待就绪（HSERDY置位），再配置Flash等待周期（72MHz下需2个等待周期），然后设置PLL源与倍频系数、使能PLL并等待锁定，最后切换SYSCLK到PLL并更新SystemCoreClock。若HSE起振失败，程序应能回退到HSI，否则会卡死在等待循环里。

二、复位与启动模式

STM32有三种复位：上电复位、系统复位和备份域复位。上电复位由内部POR/PDR电路在VDD上升时触发；系统复位可由NRST引脚拉低、看门狗溢出、软件复位（NVIC_SystemReset）等引起；备份域复位只影响RTC和备份寄存器。NRST引脚内部有上拉，外部通常接100nF电容到地，形成简单RC延时，保证电源稳定后再释放复位。

启动模式由BOOT0和BOOT1两个引脚在上电复位时刻的电平决定。BOOT0=0时从主Flash启动，这是正常运行模式；BOOT0=1、BOOT1=0时从系统存储器启动，即进入出厂Bootloader，可用串口下载程序；BOOT0=1、BOOT1=1时从内置SRAM启动，常用于调试。注意这两个引脚只在复位释放瞬间被采样，运行中改变无效。产品设计时BOOT0一般通过10k电阻下拉到地，需要下载时再跳线拉高。

三、GPIO的八种工作模式

STM32每个GPIO口可配置为输入或输出，共八种模式。输入方向有四种：浮空输入、上拉输入、下拉输入、模拟输入。输出方向有四种：开漏输出、开漏复用输出、推挽输出、推挽复用输出。

浮空输入引脚悬空时电平不确定，适合外部已有上下拉或由外部驱动的信号；上拉/下拉输入内部接通约40kΩ电阻，按键检测常用上拉输入配按键接地。模拟输入关闭施密特触发器，直接连到ADC，用于采集模拟量。推挽输出能主动输出高、低电平，驱动LED首选；开漏输出只能拉低，高电平需外部上拉，适合I2C总线和电平转换。复用模式则把引脚控制权交给片上外设，如USART、SPI。

配置时通过GPIOx_CRL（低8位）和GPIOx_CRH（高8位）寄存器，每个引脚占4位：MODE[1:0]决定输出速度或输入模式，CNF[1:0]决定具体类型。例如PA5推挽输出50MHz，CRL对应位写0b0011。使用标准外设库时，用GPIO_InitTypeDef结构体设置GPIO_Pin、GPIO_Mode、GPIO_Speed即可。

四、按键与LED驱动

LED驱动很简单：LED阳极经限流电阻接3.3V，阴极接GPIO，GPIO输出低电平点亮。限流电阻按R=(VDD−VF)/IF估算，红色LED VF约1.8V、IF取5mA，则R≈(3.3−1.8)/0.005=300Ω，实际取330Ω或470Ω均可。若LED接在GPIO与地之间，则输出高电平点亮，逻辑相反。

按键检测要处理抖动。机械按键按下和释放瞬间会有5～20ms的抖动，直接读会得到多次跳变。常用做法是：配置为上拉输入，按键一端接GPIO、另一端接地，按下读到0。软件消抖可在检测到低电平后延时10ms再读一次，仍为低才确认。更规范的做法是用定时器每5ms采样一次，连续两次相同才更新状态。

// 按键扫描（带消抖，示例）
uint8_t Key_Scan(void)
{
    if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET) {
        HAL_Delay(10);                       // 延时消抖
        if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET) {
            while (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET);
            return 1;                        // 等待释放，返回按下
        }
    }
    return 0;
}

注意上面这种“等待释放”的写法会阻塞CPU，实际产品中更推荐状态机或定时器扫描，把按键处理放到主循环里非阻塞执行。

五、位带操作：像51一样操作单个位

Cortex-M3支持位带（Bit-Band）特性，把SRAM和外设的两个“位带区”中的每一位，映射到位带别名区的一个32位字。写这个字就等于写那一位，读这个字就等于读那一位。STM32F103中，外设位带区基址0x40000000，别名区基址0x42000000；SRAM位带区基址0x20000000，别名区基址0x22000000。

映射公式为：别名地址 = 别名基址 + (字节偏移×32) + (位序号×4)。例如要操作GPIOA的ODR第5位（PA5），GPIOA基址0x40010800，ODR偏移0x0C，则字节偏移=(0x40010800+0x0C−0x40000000)=0x1080C，别名地址=0x42000000+0x1080C×32+5×4=0x4221019C。定义宏后即可用PAout(5)=1这样的写法直接置位，代码更直观，执行也是单周期位操作。

六、最小系统检查清单

把最小系统搭稳，再写GPIO代码就不会出现“程序下载了但灯不亮”的困惑。建议先用万用表和示波器确认电源、晶振、复位三处波形，再进入GPIO实验，这样排错路径最短。