GPIO基础与寄存器映射：从点亮LED开始
各位同学，欢迎来到《STM32外设驱动开发完全手册》的第一章。
说实话，GPIO是嵌入式开发里最基础、也最容易被忽视的外设。很多人觉得不就是点个灯嘛，有什么好讲的？但我在项目中遇到过太多次因为GPIO配置不当导致的诡异问题——比如IO口烧了、电平不对、功耗异常。嗯，这章我们就把GPIO彻底讲透。
1. GPIO工作模式详解
STM32的GPIO，说白了就是一组可编程的引脚。你可以把它配置成输入、输出、模拟或者复用功能。但具体到每种模式，细节还挺多的。
1.1 四种基本模式
| 模式 | 说明 | 典型应用 |
|---|---|---|
| 输入模式 | 读取引脚电平 | 按键检测、传感器输入 |
| 输出模式 | 驱动外部器件 | LED、蜂鸣器、继电器 |
| 复用功能模式 | 由片上外设控制引脚 | USART、SPI、I2C等 |
| 模拟模式 | 模拟信号输入/输出 | ADC、DAC |
你想想看，如果只是点个LED，输出模式就够了。但如果你要用串口通信，就必须配置成复用功能模式。我刚开始学的时候，就犯过把USART引脚配成普通输出的错误——结果数据死活发不出去。
1.2 输出模式的细节
输出模式又分推挽输出和开漏输出。推挽输出能主动拉高拉低，驱动能力强。开漏输出只能拉低，拉高要靠外部上拉电阻。
我个人习惯：驱动LED、蜂鸣器这类器件，用推挽输出。做I2C总线时，必须用开漏输出。这个千万别搞混。
1.3 输入模式的细节
输入模式有四种：浮空输入、上拉输入、下拉输入、模拟输入。浮空输入最常用，但引脚悬空时电平不确定。上拉/下拉输入可以固定默认电平。
2. GPIO寄存器结构体映射
寄存器映射，说白了就是把芯片的物理地址映射成C语言里的结构体。这样操作寄存器就像操作结构体成员一样方便。
2.1 为什么需要映射？
STM32的GPIO寄存器，每个端口有一组寄存器。比如GPIOA的基地址是0x40020000，CRL寄存器偏移0x00，CRH偏移0x04，等等。如果直接写地址，代码会变成这样：
*(uint32_t*)0x40020000 = 0x44444444; // 配置GPIOA所有引脚为输入这种写法，你看着不难受吗？反正我受不了。所以STM32的固件库和HAL库都帮我们做了结构体映射。
2.2 映射的实现原理
在STM32的标准外设库中，GPIO_TypeDef结构体是这样定义的：
typedef struct {
__IO uint32_t CRL; // 端口配置低寄存器，偏移0x00
__IO uint32_t CRH; // 端口配置高寄存器，偏移0x04
__IO uint32_t IDR; // 输入数据寄存器，偏移0x08
__IO uint32_t ODR; // 输出数据寄存器，偏移0x0C
__IO uint32_t BSRR; // 置位/复位寄存器，偏移0x10
__IO uint32_t BRR; // 复位寄存器，偏移0x14
__IO uint32_t LCKR; // 锁定寄存器，偏移0x18
} GPIO_TypeDef;然后通过宏定义，把GPIOA映射到基地址：
#define GPIOA ((GPIO_TypeDef *) GPIOA_BASE)这样，操作GPIOA的ODR寄存器就变成了：
GPIOA->ODR = 0x0001; // 让PA0输出高电平是不是清爽多了？
3. 位带操作原理
位带操作，是Cortex-M3内核的一个特性。它允许你把一个位映射到一个32位的地址上。说白了，就是可以用读写32位数据的方式，来单独操作一个位。
3.1 为什么需要位带操作？
普通的C语言操作位，需要读-改-写三步：
GPIOA->ODR &= ~(1 << 0); // 读ODR，改第0位，写回ODR这三步不是原子的。如果在多任务环境下，可能会被中断打断，导致数据不一致。位带操作是原子操作，一条指令搞定。
3.2 位带映射公式
位带区有两个：SRAM区（0x20000000-0x200FFFFF）和外设区（0x40000000-0x400FFFFF）。每个位对应一个别名地址，公式如下：
别名地址 = 位带基地址 + (字节偏移 * 32 + 位号 * 4)举个例子，GPIOA的ODR寄存器地址是0x4002000C，第0位对应的别名地址是：
别名地址 = 0x42000000 + (0x2000C * 32 + 0 * 4) = 0x42018030然后直接写这个地址：
*(uint32_t*)0x42018030 = 1; // PA0输出高电平
*(uint32_t*)0x42018030 = 0; // PA0输出低电平#define PAout(n) *(uint32_t*)(0x42000000 + (0x2000C * 32 + (n) * 4))
PAout(0) = 1; // 点亮LED4. 使用寄存器点亮LED
好了，理论讲完了，我们来实战。用寄存器点亮一个LED，这是嵌入式开发的"Hello World"。
4.1 硬件连接
假设LED接在PA0引脚，高电平点亮。电路很简单：PA0 -> 电阻 -> LED -> GND。
4.2 代码实现
步骤很简单：
- 使能GPIOA时钟
- 配置PA0为推挽输出
- 设置PA0输出高电平
#include "stm32f10x.h"
int main(void) {
// 1. 使能GPIOA时钟
// RCC_APB2ENR寄存器的第2位控制GPIOA时钟
RCC->APB2ENR |= (1 << 2);
// 2. 配置PA0为推挽输出，50MHz
// CRL寄存器的[3:0]位控制PA0模式
GPIOA->CRL &= ~(0x0F << 0); // 先清零
GPIOA->CRL |= (0x03 << 0); // 设置CNF0=00, MODE0=11
// 3. 设置PA0输出高电平
GPIOA->ODR |= (1 << 0);
while(1) {
// 主循环，LED常亮
}
}4.3 代码解析
这里有几个关键点：
- 时钟使能： 不使能时钟，寄存器写不进去。我见过有人忘了这一步，折腾了半天。
- CRL寄存器： 每4位控制一个引脚。MODE位设置速度，CNF位设置模式。
- ODR寄存器： 写1输出高电平，写0输出低电平。
5. 本章知识体系
下面这张图，是我画的本章知识结构。你可以看到，GPIO的四个核心知识点是如何串联起来的。
这张图把本章的四个核心知识点串起来了。工作模式是基础，寄存器映射是工具，位带操作是进阶技巧，点亮LED是实战验证。你想想看，是不是这个逻辑？
6. 避坑指南
最后，分享几个我踩过的坑：
- 时钟没使能： 寄存器写不进去，但读出来是0。我曾经调试了半天，才发现是忘了开时钟。
- 配置顺序： 先配置模式，再配置输出值。反过来可能导致引脚瞬间输出错误电平。
- 位带操作地址： 不同型号的STM32，外设基地址可能不同。比如F1系列和F4系列就不一样。
好了，这一章就到这里。记住，GPIO是嵌入式开发的基础，基础打牢了，后面学什么都快。