第3章 GPIO基础：从框图到实战
各位同学，今天我们来聊聊GPIO。说实话，GPIO是MCU外设里最基础、也最容易被忽视的模块。我见过不少工程师，写了几年代码，对GPIO的理解还停留在「点灯」阶段。嗯，这其实挺可惜的。
我个人习惯把GPIO比作MCU的「手脚」——它负责和外界打交道。你想想看，一个芯片再强大，如果没法跟外部设备通信，那它就是一块废铁。所以，把GPIO吃透，是嵌入式开发的基本功。
3.1 GPIO模块框图
先看一张典型的GPIO模块框图（我这里用文字描述，大家脑补一下）。
从芯片引脚往里走，第一层是ESD保护二极管，然后是上下拉电阻，接着是施密特触发器（输入路径）和输出驱动器（输出路径）。再往里，就是数据寄存器、方向寄存器、复用功能选择寄存器这些。
为什么我要提这个框图？因为我在项目中遇到过一个问题：某个引脚在输入模式下，读到的电平总是乱的。排查了半天，最后发现是施密特触发器没使能。你看，不懂框图，连问题出在哪都找不到。
核心要点：GPIO框图里的每个模块都有它的作用。ESD保护防静电，施密特触发器做信号整形，上下拉电阻确定默认电平。一个都不能少。
3.2 输入输出模式
GPIO的模式，说白了就两种：输入和输出。但每种模式下面还有细分。
3.2.1 输入模式
输入模式就是读引脚电平。MCU内部通过施密特触发器把外部信号转换成0或1。
这里有个坑：浮空输入。如果引脚什么都没接，电平是不确定的。我曾经有个项目，按键检测时好时坏，最后发现是引脚浮空了，外部干扰信号导致误触发。
警告：浮空输入模式下，引脚电平由外部环境决定。如果外部没驱动，电平会随机跳变。一定要配合上拉或下拉电阻使用。
3.2.2 输出模式
输出模式就是写引脚电平。MCU内部通过输出驱动器把数据送到引脚上。
输出模式又分两种：推挽输出和开漏输出。这个我们下一节细讲。
3.3 推挽与开漏
这两个概念，很多初学者容易搞混。我试着用最直白的方式讲清楚。
3.3.1 推挽输出
推挽输出，内部有两个MOS管：一个P-MOS（上管），一个N-MOS（下管）。输出高电平时，上管导通，下管截止，引脚直接连到VCC。输出低电平时，上管截止，下管导通，引脚直接连到GND。
说白了，推挽输出能主动拉高和拉低电平。驱动能力强，速度快。我一般用推挽输出驱动LED、蜂鸣器这类负载。
小技巧：推挽输出不能「线与」——两个推挽输出直接连在一起，一个输出高一个输出低，会短路。我在一个多机通信项目里吃过这个亏，烧了一个引脚。
3.3.2 开漏输出
开漏输出，内部只有一个N-MOS（下管）。输出低电平时，下管导通，引脚接地。输出高电平时，下管截止，引脚处于高阻态——这时候需要外部上拉电阻把电平拉高。
开漏输出的好处是什么？可以「线与」。多个开漏输出可以共用一个上拉电阻，任何一个输出低电平，总线就是低电平。I2C总线就是典型的开漏应用。
| 特性 | 推挽输出 | 开漏输出 |
|---|---|---|
| 驱动能力 | 强（主动拉高拉低） | 弱（只能拉低，拉高靠外部电阻） |
| 速度 | 快 | 慢（受上拉电阻影响） |
| 线与能力 | 不支持 | 支持 |
| 电平转换 | 不支持 | 支持（通过选择不同上拉电压） |
| 典型应用 | LED、蜂鸣器、普通IO | I2C、多机通信、电平转换 |
3.4 上下拉电阻
上下拉电阻，是GPIO里最容易忽略、但最影响稳定性的东西。
3.4.1 上拉电阻
上拉电阻把引脚默认电平拉到高。比如按键检测，按键没按下时，引脚通过上拉电阻保持高电平；按键按下时，引脚接地变成低电平。
上拉电阻的阻值怎么选？我一般用4.7kΩ到10kΩ。阻值太小，功耗大；阻值太大，信号上升沿变缓，高速通信容易出错。
经验值：普通IO口上拉用10kΩ，I2C总线用4.7kΩ。这是我多年项目积累下来的「黄金比例」。
3.4.2 下拉电阻
下拉电阻把引脚默认电平拉到低。应用场景相对少一些，比如某些传感器默认输出高电平，MCU这边就需要下拉。
下拉电阻的阻值选择和上拉类似，也是4.7kΩ到10kΩ。
3.4.3 内部上下拉 vs 外部上下拉
现在的MCU基本都内置了可配置的上下拉电阻。好处是省元件、省PCB空间。但内部电阻的精度和温度稳定性不如外部电阻。
我个人习惯：低速、非关键的信号用内部上下拉；高速、关键的信号用外部上下拉。比如I2C总线，我从来不用内部上拉，因为内部电阻的一致性不好，会导致总线时序偏差。
注意：内部上下拉电阻的阻值因MCU型号而异。有的MCU内部上拉是30kΩ，有的是50kΩ。用之前一定要看数据手册。我曾经在一个项目中，换了MCU型号忘了改配置，结果按键灵敏度完全变了。
3.5 实战代码示例
说了这么多理论，来点实际的。下面是一个STM32的GPIO配置示例，涵盖了推挽输出、开漏输出、上下拉配置。
// 推挽输出模式 - 驱动LED
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; // 低速
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
// 开漏输出模式 - I2C SCL引脚
GPIO_InitStruct.Pin = GPIO_PIN_6;
GPIO_InitStruct.Mode = GPIO_MODE_AF_OD; // 复用开漏输出
GPIO_InitStruct.Pull = GPIO_PULLUP; // 内部上拉（实际I2C建议外部上拉）
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
// 输入模式 - 按键检测（带上拉）
GPIO_InitStruct.Pin = GPIO_PIN_13;
GPIO_InitStruct.Mode = GPIO_MODE_INPUT; // 输入模式
GPIO_InitStruct.Pull = GPIO_PULLUP; // 内部上拉
HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);这段代码看起来简单，但每个参数都有讲究。比如推挽输出配无上下拉，是因为LED本身有外部限流电阻，不需要内部上下拉。而按键输入配上拉，是为了防止浮空。
3.6 避坑指南
最后，我总结几个GPIO开发中常见的坑，都是我用真金白银换来的教训。
- 输出模式读引脚：推挽输出模式下读引脚，读到的其实是输出数据寄存器的值，不是引脚实际电平。要读实际电平，得先切换到输入模式。
- 开漏输出忘加上拉：开漏输出高电平时，如果没加上拉电阻，引脚就是高阻态。用万用表量，电平是乱的。
- 上下拉电阻和负载不匹配：上拉电阻太小，低电平驱动电流大，可能烧引脚。上拉电阻太大，高电平驱动能力弱，信号不稳定。
- 复用功能配置错误：GPIO的复用功能（比如UART、SPI）需要配置对应的复用模式。我见过有人把UART的TX配成了推挽输出，结果通信时好时坏。
我的习惯：每次配置GPIO前，先看数据手册的「Alternate function mapping」表，确认引脚支持哪些复用功能。然后对照原理图，确认外部电路。最后才写代码。这个流程虽然慢，但能避免90%的问题。
好了，GPIO的基础知识就讲到这里。下一章我们讲中断——GPIO最常用的进阶功能。到时候我会分享一个我调试中断时遇到的「灵异事件」，保证让你印象深刻。