3. GPIO基础：从模块框图到HAL库实战
各位同学，今天我们来聊聊GPIO。说实话，GPIO是嵌入式开发中最基础、也最容易被忽视的外设。我见过不少工程师，上来就调用HAL_GPIO_WritePin，结果灯不亮、按键不灵，折腾半天才发现是模式配错了。嗯，咱们今天就把它彻底讲透。
3.1 GPIO模块框图——先看明白硬件长啥样
先看这张图（我习惯在脑子里画框图）。GPIO模块的核心，说白了就是一堆引脚，每个引脚都连着一条“数据通道”。这条通道上，有几个关键部件：
- 输入驱动器：负责把引脚上的电平读进来
- 输出驱动器：负责把数据写到引脚上
- 复用功能选择器：决定这个引脚是当GPIO用，还是当串口、I2C、SPI用
- 上下拉电阻：内部集成的，省得你外接电阻
你想想看，每个引脚其实就是一个“多面手”。它既能读，又能写，还能干别的活。NXP的芯片在这方面做得挺细，每个引脚都有独立的控制逻辑。
核心要点：GPIO模块框图里，最关键的其实是“数据路径”。输入路径从引脚到输入数据寄存器，输出路径从输出数据寄存器到引脚。搞清楚数据怎么流，你就掌握了GPIO的一半。
3.2 GPIO工作模式——四种模式，各有各的脾气
NXP的GPIO有四种工作模式：输入、输出、复用、模拟。我刚开始用的时候，总觉得复用和模拟差不多，后来踩了坑才明白区别。
3.2.1 输入模式
这个最简单。引脚上的电平，直接读到寄存器里。你可以配置是否使能上下拉，是否用施密特触发器。我在项目中遇到过一个问题：按键没按下时电平乱跳，后来发现是没开内部上拉，引脚悬空了。嗯，这种低级错误，犯过一次就记住了。
3.2.2 输出模式
输出模式分两种：推挽输出和开漏输出。
- 推挽输出：既能输出高电平，也能输出低电平。驱动能力强，适合控制LED、蜂鸣器。
- 开漏输出：只能输出低电平，高电平要靠外部上拉。我建议你在I2C总线上用开漏，因为这是协议要求的。
个人经验：推挽输出时，注意电流限制。NXP的GPIO一般能承受±25mA，但整颗芯片的总电流有限。我曾经一口气点亮8个LED，结果芯片发热严重——后来加了限流电阻才解决。
3.2.3 复用模式
复用模式，说白了就是把引脚的控制权交给其他外设。比如你想用UART，就把TX、RX引脚配成复用模式，然后选AF1、AF2之类的功能号。这里有个坑：复用功能号不能配错。我见过有人把UART的TX配成了AF3，结果数据死活发不出去。
3.2.4 模拟模式
模拟模式用于ADC、DAC、比较器。这时候引脚直接连到模拟电路，数字输入输出通路都被断开了。为什么要这样？因为数字电路会引入噪声，影响模拟信号的精度。你想想看，ADC采样时如果数字信号还在那里跳，采样值肯定不准。
| 模式 | 典型用途 | 注意事项 |
|---|---|---|
| 输入 | 按键、传感器 | 注意上下拉配置 |
| 输出 | LED、蜂鸣器 | 注意电流限制 |
| 复用 | UART、SPI、I2C | 功能号不能配错 |
| 模拟 | ADC、DAC | 断开数字通路 |
3.3 GPIO寄存器详解——直接操作寄存器的底气
虽然HAL库封装好了，但我建议你还是看看寄存器。为什么？因为调试的时候，寄存器值能告诉你真相。NXP的GPIO寄存器主要有这几个：
- GPIOx_PDOR：输出数据寄存器。写1输出高，写0输出低。
- GPIOx_PSOR：输出置位寄存器。写1对应位输出高，不影响其他位。
- GPIOx_PCOR：输出清零寄存器。写1对应位输出低，不影响其他位。
- GPIOx_PTOR：输出翻转寄存器。写1对应位翻转。
- GPIOx_PDIR：输入数据寄存器。读这个寄存器就知道引脚电平。
- GPIOx_PDDR：方向寄存器。1是输出，0是输入。
我个人习惯用PSOR和PCOR来操作输出，因为它们是原子操作，不会影响其他位。你想想看，如果用PDOR，你得先读再改再写，中间可能被中断打断，导致其他引脚被误操作。
避坑指南：我曾经在中断服务函数里用PDOR操作GPIO，结果因为读-改-写不是原子的，导致另一个中断修改的位被覆盖了。从那以后，我只要涉及多任务或中断，一律用PSOR/PCOR。
3.4 HAL库GPIO初始化结构体——从寄存器到结构体的封装
HAL库把寄存器操作封装成了结构体，用起来方便多了。以NXP的HAL库为例，GPIO初始化结构体长这样：
typedef struct {
uint32_t pin; // 引脚号，可以是GPIO_PIN_0到GPIO_PIN_15
uint32_t mode; // 模式：输入、输出、复用、模拟
uint32_t pull; // 上下拉：无、上拉、下拉
uint32_t speed; // 速度：低速、中速、高速、极速
uint32_t alternate; // 复用功能号：AF0到AF7
} GPIO_InitTypeDef;初始化一个GPIO的步骤很简单：
- 使能GPIO时钟（这个最容易忘）
- 填充结构体成员
- 调用HAL_GPIO_Init函数
举个例子，初始化一个LED引脚：
GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_GPIOB_CLK_ENABLE(); // 使能GPIOB时钟
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; // 低速就够了
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);个人建议：speed参数别乱设。LED、按键这种低速信号，用LOW就够了。设成HIGH会增加功耗和EMI。我见过有人把所有GPIO都设成极速，结果板子辐射超标，折腾了好久才找到原因。
再举个例子，初始化一个按键引脚：
GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();
GPIO_InitStruct.pin = GPIO_PIN_0;
GPIO_InitStruct.mode = GPIO_MODE_INPUT; // 输入模式
GPIO_InitStruct.pull = GPIO_PULLUP; // 内部上拉
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);这里要注意，按键按下时引脚接地，所以用内部上拉。如果按键按下时接VCC，那就用下拉。嗯，这个逻辑别搞反了。
3.5 总结——GPIO虽小，门道不少
GPIO看似简单，但每个细节都影响系统稳定性。从模块框图到寄存器，再到HAL库结构体，我希望你不仅会用，还能理解背后的原理。下次遇到GPIO问题，先检查时钟有没有使能，再检查模式配没配对，最后看看上下拉对不对——这三个地方，80%的问题都出在这里。
好了，这一章就到这里。下一章我们讲GPIO的中断和事件，那才是真正有意思的地方。