📚 课程目录第2章 GPIO基础与寄存器映射

GPIO基础与寄存器映射：从模块框图到位操作

GPIO，说白了就是单片机跟外界打交道的最基本通道。我刚开始学单片机时，第一个实验就是点亮LED，用的就是GPIO。那时候只觉得拉高拉低就能控制灯，根本没想过背后还有这么多门道。

但后来做项目多了，踩的坑也多了，才明白——不懂寄存器映射，你写出来的GPIO代码就是碰运气。今天这一章，咱们就把GPIO的底裤扒干净。

GPIO模块框图：先看清内部结构

先看一张图，这是GPIO模块的内部结构。别被一堆方块吓到，其实就几个关键部分。

核心要点：GPIO内部由输入驱动、输出驱动、上下拉电阻、复用功能选择器、以及寄存器接口组成。每个引脚背后都有一套完整的信号路径。

从这张图你能看到什么？我总结三个关键点：

输入路径：外部信号经过输入驱动器、施密特触发器，最终到达IDR寄存器。你读IDR，读到的就是引脚电平。
输出路径：你写ODR寄存器，数据经过输出驱动器，最终体现在引脚电平上。
上下拉与复用：这两个功能是独立于输入输出的，配置错了，信号就乱了。

我的经验：有一次调试I2C总线，死活拉不低SCL线。查了半天，发现是内部上拉电阻没配置对，输出模式也设错了。从那以后，我每次配置GPIO都会先画一遍内部路径图，确保信号走对了。

GPIO寄存器描述：七个寄存器，一个都不能少

STM32的GPIO有7个核心寄存器。别被数量吓到，其实每个寄存器只干一件事。我习惯把它们分成三组：

寄存器	全称	位宽	作用
MODER	端口模式寄存器	32位	配置输入/输出/复用/模拟
OTYPER	输出类型寄存器	32位	推挽/开漏输出
OSPEEDR	输出速度寄存器	32位	低速/中速/高速/极速
PUPDR	上拉/下拉寄存器	32位	无/上拉/下拉/保留
IDR	输入数据寄存器	16位	读取引脚电平（只读）
ODR	输出数据寄存器	16位	设置输出电平
BSRR	位设置/复位寄存器	32位	原子操作置位/复位
LCKR	锁定寄存器	32位	锁定配置防误改

嗯，这里要注意——IDR和ODR都是16位，但其他寄存器是32位。为什么？因为GPIO最多16个引脚，16位就够了。但MODER这些寄存器每个引脚占2位，所以需要32位。

MODER：模式寄存器

每个引脚占2位，共16个引脚，刚好32位。取值如下：

MODER[1:0]	模式	说明
00	输入模式	复位后的默认模式
01	通用输出模式	普通推挽或开漏输出
10	复用功能模式	由AFR寄存器选择具体功能
11	模拟模式	ADC等模拟信号输入

我曾经踩过的坑：配置ADC时忘了把引脚设为模拟模式，结果ADC读数一直跳。查了两天，才发现MODER还是默认的输入模式。模拟模式下，施密特触发器是禁用的，输入模式会引入噪声。

OTYPER：输出类型寄存器

这个寄存器简单，每个引脚只占1位：

0：推挽输出（Push-Pull）——既能输出高电平，也能输出低电平
1：开漏输出（Open-Drain）——只能输出低电平，高电平靠外部上拉

你想想看，什么时候用开漏？I2C总线、多个设备共享一根线的时候。推挽输出速度快，但多个设备同时驱动会打架。

OSPEEDR：输出速度寄存器

每个引脚占2位，控制输出驱动器的响应速度：

OSPEEDR[1:0]	速度等级	适用场景
00	低速（2MHz）	普通GPIO、低频信号
01	中速（10MHz）	SPI、UART等
10	高速（50MHz）	高速SPI、定时器输出
11	极速（100MHz）	高速通信接口

我个人的习惯：能用低速就不用高速。高速意味着更大的电磁干扰和功耗。有一次做EMC测试，就是因为所有GPIO都设成了极速，辐射超标了。降成中速后，问题解决。

PUPDR：上拉/下拉寄存器

每个引脚占2位：

00：无上下拉
01：上拉（接VDD）
10：下拉（接VSS）
11：保留

这里有个细节——上下拉只在输入模式下有效。输出模式下配置上下拉，等于白配。我见过有人输出模式配了上拉，以为能提高驱动能力，其实根本没起作用。

IDR与ODR：输入输出数据寄存器

这两个寄存器最直观：

IDR：只读，读对应位就知道引脚电平。0是低，1是高。
ODR：读写，写对应位控制输出电平。

但ODR有个问题——读-改-写操作不是原子的。比如你想只改第3位，先读ODR，改第3位，再写回去。如果中间来了个中断，也改了ODR，那就乱套了。

所以就有了BSRR。

BSRR：位设置/复位寄存器

这个寄存器是神器。32位分成两部分：

低16位（位0~15）：写1置位对应引脚（输出高）
高16位（位16~31）：写1复位对应引脚（输出低）

关键是——写0不影响。你只需要写你要改的位，其他位保持原样。而且这是硬件原子操作，不会被中断打断。

// 设置PA5输出高电平（原子操作）
GPIOA->BSRR = (1 << 5);

// 设置PA5输出低电平（原子操作）
GPIOA->BSRR = (1 << (5 + 16));

// 同时设置PA5高、PA6低
GPIOA->BSRR = (1 << 5) | (1 << (6 + 16));

核心原则：凡是需要修改单个引脚输出电平的，一律用BSRR，不要用ODR。这是我在一个电机控制项目里用血泪换来的教训——中断里用ODR改引脚，结果电机抖动得像抽风。

LCKR：锁定寄存器

这个寄存器用得少，但关键时刻能救命。它可以把GPIO配置锁死，防止意外修改。

用法有点特殊：写0x1C0E + 对应位，再写0x1C0E + 对应位，再读一次，再写0x1C0E + 对应位。只有这一套序列才能解锁。

// 锁定PA5的配置
GPIOA->LCKR = 0x00010000 | (1 << 5);  // 第一次写
GPIOA->LCKR = 0x00010000 | (1 << 5);  // 第二次写
(void)GPIOA->LCKR;                      // 读一次
GPIOA->LCKR = 0x00010000 | (1 << 5);  // 第三次写

注意：锁定后，只有复位才能解锁。所以别在调试阶段乱锁，否则只能按复位键。

寄存器地址映射与位操作

好了，寄存器功能都清楚了。但它们在内存里到底在哪？怎么访问？

STM32的GPIO外设挂载在AHB总线上，基地址是固定的。以STM32F4为例：

外设	基地址	偏移范围
GPIOA	0x4002 0000	0x00 ~ 0x24
GPIOB	0x4002 0400	0x00 ~ 0x24
GPIOC	0x4002 0800	0x00 ~ 0x24
...	...	...

每个寄存器的偏移地址是固定的：

MODER  偏移 0x00
OTYPER 偏移 0x04
OSPEEDR 偏移 0x08
PUPDR  偏移 0x0C
IDR    偏移 0x10
ODR    偏移 0x14
BSRR   偏移 0x18
LCKR   偏移 0x1C

所以GPIOA的MODER地址就是：0x4002 0000 + 0x00 = 0x4002 0000。

在代码里，我们通常用结构体指针来访问：

// GPIO寄存器结构体定义
typedef struct {
    volatile uint32_t MODER;    // 0x00
    volatile uint32_t OTYPER;   // 0x04
    volatile uint32_t OSPEEDR;  // 0x08
    volatile uint32_t PUPDR;    // 0x0C
    volatile const uint32_t IDR;  // 0x10 (只读)
    volatile uint32_t ODR;      // 0x14
    volatile uint32_t BSRR;     // 0x18
    volatile uint32_t LCKR;     // 0x1C
} GPIO_TypeDef;

// 定义GPIOA指针
#define GPIOA ((GPIO_TypeDef *) 0x40020000UL)

有了这个结构体，访问寄存器就直观了：

// 配置PA5为推挽输出，中速，无上下拉
GPIOA->MODER   &= ~(0x3 << 10);  // 先清空PA5的模式位
GPIOA->MODER   |=  (0x1 << 10);  // 设为输出模式 (01)
GPIOA->OTYPER  &= ~(0x1 << 5);   // 推挽输出
GPIOA->OSPEEDR &= ~(0x3 << 10); // 清空速度位
GPIOA->OSPEEDR |=  (0x1 << 10);  // 中速
GPIOA->PUPDR   &= ~(0x3 << 10); // 无上下拉

// 输出高电平
GPIOA->BSRR = (1 << 5);

位操作技巧：清位用 &= ~(mask)，置位用 |= mask。mask = (0x3 << (pin * 2)) 是2位字段的常用写法。我习惯把这种操作封装成宏，避免每次手算位移量。

实战：点亮一个LED

说了这么多，来点实际的。假设PA5接了一个LED，正极接VCC，负极接PA5（低电平点亮）。

// 完整配置：点亮PA5的LED
void LED_Init(void) {
    // 1. 使能GPIOA时钟（RCC寄存器，后面章节会细讲）
    RCC->AHB1ENR |= (1 << 0);  // 使能GPIOA时钟
    
    // 2. 配置PA5为输出模式
    GPIOA->MODER &= ~(0x3 << 10);
    GPIOA->MODER |=  (0x1 << 10);
    
    // 3. 推挽输出
    GPIOA->OTYPER &= ~(0x1 << 5);
    
    // 4. 中速
    GPIOA->OSPEEDR &= ~(0x3 << 10);
    GPIOA->OSPEEDR |=  (0x1 << 10);
    
    // 5. 无上下拉
    GPIOA->PUPDR &= ~(0x3 << 10);
    
    // 6. 初始输出高电平（LED灭）
    GPIOA->BSRR = (1 << 5);
}

void LED_On(void) {
    GPIOA->BSRR = (1 << (5 + 16));  // 低电平点亮
}

void LED_Off(void) {
    GPIOA->BSRR = (1 << 5);         // 高电平熄灭
}

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

注意顺序：先使能时钟，再配置寄存器。不使能时钟，写寄存器等于白写。我刚开始学的时候经常忘这一步，LED死活不亮，还以为是硬件坏了。

好了，GPIO的基础就这些。记住：框图帮你理解信号流向，寄存器描述告诉你每个位干什么，地址映射让你知道怎么访问。这三样东西搞明白了，任何单片机的GPIO你都能快速上手。