上一次认真翻 GPIO 手册，是被一个按键误触发的现场逼回去的。设备在实验室好好的，装到现场就偶尔自己触发一次，前后折腾了两天，最后发现是按键引脚配成了浮空输入，线又走得长，边上继电器一动作就给它耦合进来一个窄脉冲。从那以后我形成了一个习惯：每隔一段时间，把 GPIO 这套东西重新过一遍，不是背寄存器，而是把“电气层—模式层—寄存器层—驱动层”这四层重新对齐一次。这篇就是我的复习笔记，从最基础的模式配置聊到软件模拟总线、低功耗引脚处理，把我踩过的坑和算过的参数都摊开写清楚。

这篇内容适合谁看？如果你刚开始接触单片机，正在被“推挽”“开漏”“上拉”“复用”这几个词绕晕，那可以顺着往下读，我把每个概念的物理含义都拆开了；如果你已经写过不少驱动，那更值得看，因为真正出问题的地方往往不在“会不会点灯”，而在电平匹配、时序余量、上电毛刺、低功耗漏电这些细节上。GPIO 是所有外设的地基，地基歪一寸，上层就歪一丈。

1. GPIO 复习到底该复什么

1.1 从“能点灯”到“能被看懂”的认知断层

很多人对 GPIO 的自信来自一个很朴素的体验：新建工程，找到引脚，配成输出，写个电平，灯亮了。这个闭环确实只需要十分钟，但它只验证了“数字逻辑层”这一层是通的，完全没有触碰电气层和时序层。真正的项目里，GPIO 出错的方式极少是“灯不亮”，更多是“大部分时候亮，偶尔闪一下”“接上负载就拉不低”“休眠电流比手册高两个数量级”“示波器一看上升沿是个大斜坡”。

我把 GPIO 的复习拆成四层来看，这个分层比按寄存器顺序背要有效得多。最底下是电气层，关心的是这个引脚内部到底是两个 MOS 管还是一个，能灌多少电流、能拉多少电流、悬空时是高阻还是有个弱上拉；往上是模式层，也就是输入浮空、输入上拉、模拟输入、推挽输出、开漏输出、复用推挽、复用开漏这七八种组合，每一种背后其实都是一组开关的通断；再往上是寄存器层，时钟、方向、输出值、复用选择、上下拉配置分散在四五个寄存器里，写的顺序不对就会产生毛刺；最上面是驱动层，也就是你写的那些gpio_set()、按键扫描、模拟总线时序。

这四层里最容易缺失的是电气层，因为它不像代码那样能单步调试。你写错一个寄存器位，编译器不会报错，运行起来也不一定立刻出问题，它可能在你量产第三百台的时候才出现。所以复习的重点不该是“记住有几个模式”，而是“知道每个模式在电路上等效能画成什么样”。

1.2 复习时优先补齐的三块短板

如果你时间有限，我建议按这个优先级补。第一块是输出驱动能力与限流计算，包括单个引脚的最大灌/拉电流、整个端口的电流总和限制、LED 限流电阻怎么算、驱动继电器或蜂鸣器为什么必须加三极管或 MOS。这些数字在数据手册的“Absolute Maximum Ratings”和“Output Driving Capability”章节里，很多人从来没翻过。

第二块是输入端的确定性。任何一个输入引脚，在任何时刻都必须处于一个确定的电平，不能悬空。这是硬件设计的基本纪律，但实际板子上经常能看到：按键一端接引脚，另一端接 GND，引脚没开内部上拉，外部也没电阻。这种设计在实验室桌面上可能“能用”，因为人体感应和空气湿度会给你一点漏电流，一旦环境干燥或者板子进了金属外壳，行为就完全不可预测。

第三块是配置顺序与时序。同一个引脚，先设方向还是先设电平，结果可能差出一个几十纳秒的毛刺；这个毛刺如果接到的是继电器、MOS 栅极或者别人的中断引脚上，就是一次真实的误动作。我在后面第 4 节会把这条链路完整走一遍。

2. 电气层：推挽与开漏的真实差别

2.1 推挽输出的等效电路与它的边界

推挽输出的内部结构可以理解成两个开关串联在电源和地之间，中间那个点引出来就是引脚。上面那个开关导通时，引脚被拉到接近电源电压；下面那个导通时，引脚被拉到接近地。关键在于它是“主动”输出高电平和低电平的，两个方向都有驱动能力。

这个结构带来两个直接后果。好处是驱动能力强、上升沿下降沿都比较陡，驱动 LED、驱动 CMOS 输入、跑几十兆的方波都没问题。限制是不能把两个推挽输出直接接在一起：一个想输出高，一个想输出低，中间就是一条从电源到地的低阻通路，轻则发热，重则烧掉其中一个。这就是为什么共享总线（比如多个器件的中断线、数据线）绝对不能用推挽。

还有一个容易被忽略的点：推挽输出高电平时的电压不是电源电压本身，而是电源电压减去上面那个开关的导通压降。当你需要灌或拉十几毫安的时候，这个压降会明显变大。手册里通常会给一张“输出电压 vs 输出电流”的曲线，做精密分压或者电平判断的时候要照着这张图算，不能想当然认为输出高就是 3.3V。

2.2 开漏输出：为什么总线和电平转换离不开它

开漏输出内部只有一个下拉器件（严格说是下拉能力强、上拉可选或没有），它只能主动把引脚拉低，高电平必须靠外部上拉电阻“拽”上去。这个不对称看起来很别扭，但正是它的价值所在。

第一个价值是线与。多个开漏输出接到同一根线上，只要有一个拉低，整条线就是低；全部释放时，上拉电阻把线拉高。I2C 的 SDA 和 SCL 就是这么工作的，主机和从机都能拉低，从而实现应答和时钟拉伸。如果用推挽，两个器件同时输出不同电平时就是短路。

第二个价值是电平转换。开漏输出只负责拉低，上拉电阻接到哪一路电源，高电平就是哪一路的电压。一颗 3.3V 的器件驱动 5V 侧的总线，只要外部上拉到 5V，并且引脚耐压允许，就能直接通信，不需要额外的转换芯片。这也是为什么很多传感器的中断输出、复位输出都做成开漏。

第三个价值是驱动高于自身电源的负载，比如驱动一颗共阳极的 LED 或者一个上拉到 12V 的继电器线圈，前提依然是引脚耐压允许。

开漏的代价是上升沿。上升沿本质是上拉电阻给线路电容充电的 RC 过程，电阻越大、电容越大，沿越缓。所以开漏跑高速总线时，上拉电阻的取值不是随便抓一个 10k 就行，需要算。

2.3 上拉电阻取值：把计算过程摊开

以常见的 400kHz 快速模式 I2C 为例，总线电容假设 200pF（走线加两三个器件的引脚电容，这个量级很常见）。规范要求上升时间不超过 300ns。

RC 充电从 0.3VDD 充到 0.7VDD 的时间约等于 0.8473 倍的 RC 时间常数，所以：

Rp(max) = tr / (0.8473 × C) = 300ns / (0.8473 × 200pF) ≈ 1.77kΩ

下限由灌电流能力决定。设 VOL 允许 0.4V，器件在低电平时能灌 3mA：

Rp(min) = (VDD - VOL) / IOL = (3.3V - 0.4V) / 3mA ≈ 967Ω

所以取值区间大概是 0.97k 到 1.77k，实际选 1.5k 或 1.8k 落在区间内。如果总线更长、器件更多，电容涨到 400pF，上限直接掉到 0.88k，这时候就得考虑降低速率或者加总线缓冲器了。

提示：很多模块板子上自带的 10k 上拉，在短距离、低速率下能用，一旦挂到 400kHz 或者长排线上就会出问题。排查 I2C 通信失败时，第一件事应该是量上升沿，而不是先怀疑地址。

按键的上拉是另一套逻辑。内部上拉通常在几十千欧量级，按键闭合时电流只有几十微安，完全够用，也省电。但如果按键线要走一米以上，内部这个弱上拉提供的抗干扰能力就不够了，外部加 4.7k 到 10k 更稳。反过来，如果这是一个电池供电、长期待机的设备，按键按下时上拉电阻上会持续消耗VDD/R的电流，10k 上拉在 3.3V 下就是 330μA，这在 μA 级待机电流里是灾难，这时候就要考虑把上拉接到一个可控制的引脚上，扫描时打开、扫完关掉。

2.4 驱动能力与整端口电流预算

单看一个引脚“最大 20mA”是不够的，因为手册里通常还有一条：整个端口（Port）的总灌/拉电流不超过某个值，整颗芯片又有一个更大的总和限制。这两条限制经常被人忽略，结果就是八个 LED 同时点亮，单个都不超，芯片却烫手或者电压塌陷。

做预算的方法很朴素：把每个引脚的电流列出来，按端口求和，再按芯片求和，对照手册的表格打勾。LED 这种负载我一般控制在 5mA 到 8mA，亮度足够，也不会把余量吃干净。真要驱动大电流负载，老老实实上三极管或者 MOS，GPIO 只负责给控制信号，那点电流只有微安级。

还需要注意转换速率（slew rate）配置。有些芯片允许把输出翻转速度调慢，好处是减少高频谐波和过冲，坏处是上升沿变缓。驱动长线或者排线时，慢速档往往比快速档更稳，因为快速沿在阻抗不匹配的线上会产生振铃，振铃叠加到阈值附近就可能被对方多采一次。

3. 模式配置：八种组合的场景对照

3.1 四种输入形态怎么选

浮空输入是把内部上下拉都断开，引脚呈高阻。它只在外部电路已经提供了确定电平的时候才该用，比如外部有明确的上拉或下拉电阻、或者前级是推挽输出。悬空状态下，引脚电压由漏电流和耦合决定，中间电平会让输入级的两个管子同时微导通，既增加功耗又增加噪声敏感度。我前面提到的那个现场误触发，根子就在这里。

上拉输入和下拉输入是内部接一个弱电阻，把默认状态钉死。按键接地的场景用上拉输入，按键接电源的场景用下拉输入。这里有个细节：内部上下拉的阻值通常是一个范围而不是精确值，手册给的可能是 30k 到 50k，做分压计算时不能拿它当精密电阻用。

模拟输入会把数字输入通路断开，让引脚直接连到 ADC 的采样网络。这个模式的意义在于防止数字缓冲器在中间电平附近来回翻转引入噪声，同时也避免输入保护结构对模拟信号造成非线性。凡是接 ADC、比较器、运放输入的引脚，都应该配成模拟模式，配成浮空输入再去采样，读数会飘。

复用功能输入是引脚被片上外设接管，比如定时器的输入捕获、串口的 RX。这个模式下引脚方向由外设决定，用户不用管，但复用编号必须配对，这一点在第 4 节展开。

3.2 四种输出形态的取舍

推挽输出是默认选择，驱动 LED、驱动 MOS 栅极、给别人提供数字信号都用它。开漏输出用于总线和电平转换。复用推挽和复用开漏则是把引脚交给片上外设（定时器 PWM、串口 TX、SPI 时钟）之后，由外设来控制电平，同时保留推挽或开漏的电气特性。

这里最常见的错误是：想让定时器输出 PWM，引脚配成了普通推挽输出，然后手动在中断里翻转电平，跑出来的波形抖动很大。正确的做法是把引脚配成复用推挽，复用编号选到对应定时器通道，然后只管配置定时器的周期和比较值。

另一个常见的错误是反过来：引脚配了复用，但复用编号选错了，或者外设时钟没开，结果引脚既不输出也不输入，量起来是高阻，人就开始怀疑硬件。

3.3 配置顺序里藏着的毛刺

一个推挽输出引脚从上电到稳定，中间会经过几个状态：复位后默认是输入（多数芯片如此，但并非所有芯片所有引脚都这样，有些调试引脚有特殊默认值），然后你打开端口时钟，配置方向为输出，此时输出数据寄存器的值是复位值 0，所以引脚会先被拉低；然后你再写 1，引脚才变高。

如果你的负载是低电平有效的，比如一个低电平导通的使能信号，那这个“先低后高”的过程就是一次完整的误使能。避免的办法是先把输出数据寄存器写成期望的电平，再切换方向为输出。很多芯片提供了置位/复位寄存器，可以一次性写目标电平而不影响其他位，用它来做这一步最干净。

还有一种情况是引脚从输出切回输入。如果这个引脚上挂着电容或者接在别人的驱动线上，切换的瞬间引脚变成高阻，电平由外部决定，如果外部也没人驱动，就会飘。切换前先把输出置为高阻对应的安全电平，再改方向，会更稳妥。

4. 寄存器视角：一次写操作背后的完整链路

4.1 时钟、复用、方向三步走

绝大多数 32 位 MCU 的 GPIO 配置都逃不出这个顺序：先开端口时钟，再配置复用功能编号，再配置方向和上下拉，最后写输出值。这个顺序不是随便定的。

不开时钟，后面所有寄存器写入都是无效的，因为时钟门控关着的时候寄存器根本不响应写操作。这时候你用调试器看寄存器，值一直是复位值，很容易误判成“写不进去”。我在带新人的时候，第一个要教的就是“先看时钟树，再看寄存器”。

复用编号决定了引脚内部那个多路选择器接到哪个外设。它和方向配置是两套独立的开关：复用编号选对了但方向还是输入，信号出不去；方向配成复用输出但复用编号是 0（通常对应普通 IO），那还是普通 IO 行为。这两个必须同时正确。

方向配置通常每个引脚占两位，可以表示输入、输出、复用、模拟四种。这里有个细节：从输出切到模拟或者从模拟切到输出，中间最好经过一次输入状态，让引脚先进入高阻，避免内部两个通路短暂同时导通。

4.2 置位/复位寄存器为什么能避免竞态

普通的输出数据寄存器是“读—改—写”语义。你在主循环里想点亮 3 号灯，代码是ODR |= (1<<3)，编译出来是先读整个寄存器，或上这一位，再写回去。如果这时候中断里刚好在改 5 号灯，中断打断了主循环的读和写之间，主循环写回去的值里 5 号灯还是旧的，中断的那次修改就被吃掉了。这就是典型的竞态。

置位/复位寄存器是“写 1 有效”的语义，写 1 到低半字就置位对应引脚，写 1 到高半字就复位，写 0 完全没影响。它是一次写操作完成，不需要读，天然原子。所以凡是在中断和主循环里都会操作的引脚，我都优先用置位/复位寄存器，而不是位运算。

4.3 锁存机制与意外改写

有些芯片提供配置锁存功能，把某个引脚的配置锁住，直到下次复位才能改。这个功能在安全相关的场合很有用，比如防止程序跑飞之后把电机的控制引脚改成别的模式。代价是调试的时候如果忘了自己锁过，会怎么改都不生效，怀疑人生。用之前一定要在代码里写清楚注释。

还有一个容易忽略的点：调试接口占用的引脚。复位后这些引脚默认是调试功能，你如果在代码里把它们配成普通 IO 并且拉低，下次就连不上调试器了。解决办法是在初始化最开始加一小段延时，或者在调试阶段先不碰这几个引脚。

5. 实操环节：从点灯到模拟总线

5.1 LED 限流电阻的计算与实测

拿一颗红色 LED，正向压降按 2.0V 算，电源 3.3V，目标电流 6mA：

R = (3.3 - 2.0) / 0.006 = 216Ω

取标准值 220Ω，实际电流约 5.9mA。如果换成蓝色 LED，正向压降 3.0V，同样的电阻只剩 1.4mA，亮度会明显偏暗，所以换 LED 颜色时电阻要重算，不能照抄。

接线方式有两种：引脚输出高电平点亮（灌出电流，引脚作为源），或者引脚输出低电平点亮（吸入电流，引脚作为 sink）。多数芯片的灌电流能力（输出低时吸入）比拉电流能力略强，所以从电学角度低电平点亮更划算。但要注意，低电平点亮意味着复位期间引脚是高阻，LED 不亮；如果配成低电平有效并且外部还有上拉，复位时可能微亮。

实测的时候不要只信计算。拿万用表串在回路里量一下实际电流，再用示波器看一下引脚波形。我遇到过算出来 6mA、实际只有 3mA 的情况，原因是引脚配置成了低速档，边沿太缓，万用表平均出来的值偏低，示波器一看占空比正常但上升沿有 200ns。

5.2 按键输入：上拉、消抖与唤醒

机械按键的抖动时间通常在 5ms 到 20ms 之间，这个区间内的电平是不确定的。软件消抖最稳的做法不是delay(20)，而是定时器每 5ms 采一次，连续三次采样一致才确认状态变化。这种状态机写法不阻塞主循环，也不会因为主循环某次执行时间变长而漏掉抖动。

如果按键要用来唤醒休眠，配置就完全不同了。休眠时引脚要配成带唤醒功能的方式（多数芯片是复用为 EXTI 的输入），触发边沿选下降沿，然后在进入休眠前清除挂起标志，否则一进休眠就立刻被之前残留的标志唤醒。唤醒之后第一件事是关掉中断或者改触发边沿，避免按键还按着的时候反复唤醒。

还有一类坑是按键和调试引脚复用。有些封装上按键刚好落在调试口附近，调试的时候按键动作会干扰通信，这种情况只能换引脚，没有软件解法。

5.3 软件模拟 I2C：时序余量比代码本身重要

在没有硬件 I2C 或者硬件 I2C 有 bug 的场合，软件模拟是常规操作。代码结构很简单：起始、写字节、读字节、应答、停止，每个基本动作里控制两根线的电平。难的是时序。

以 100kHz 为例，一个位周期 10μs，高电平时间和低电平时间各 5μs 左右。如果你的延时函数用空循环实现，编译器优化等级一变，延时就不准了；用系统滴答定时器做微秒延时，又可能因为中断打断而拉长。我的做法是用一个基于计数器的忙等延时，并且把延时参数留出 30% 以上的余量，宁可慢一点也不要在边界上跑。

另一个细节是引脚方向切换。读数据的时候要先释放 SDA（配成输入或者开漏输出写 1），如果一直是推挽输出，从机拉低的时候就是两个输出对打。很多模拟 I2C 的代码在这一点上偷懒，用推挽输出加“写 1”来假装释放，短时间能用，长时间会伤引脚。

上拉电阻依然不能省。模拟 I2C 也用开漏加外部上拉，内部弱上拉在 100kHz 下勉强能用，在 400kHz 下基本不行。

5.4 PWM 呼吸灯：周期与占空比的换算

用定时器输出 PWM，先确定频率。假设定时器时钟 72MHz，预分频 71，自动重装值 999：

PWM 频率 = 72MHz / ((71+1) × (999+1)) = 1kHz 占空比 = CCR / (ARR + 1)

1kHz 对人眼来说足够，不会有闪烁感。占空比从 0 到 1000 分 100 档做呼吸效果，每档停留 10ms，一个完整呼吸周期 2 秒。

调光曲线这里有个小经验：线性改变占空比，人眼看到的亮度变化并不线性，中间会显得“前半段变化快、后半段几乎没感觉”。想要顺滑的呼吸效果，可以对占空比做一次平方或者查表映射。这不是 GPIO 本身的问题，但做 LED 效果的时候绕不过去。

6. 常见问题排查实录

6.1 问题速查表

6.2 三个我踩过的坑

第一个坑是外部上拉和内部上拉打架。一块板子上按键既有内部上拉又有外部 4.7k 上拉，同时还并了一个 100nF 电容做硬件滤波。理论上没问题，实际上电时电容充电会让引脚缓慢上升，在阈值附近停留的时间比预期长，如果这颗引脚同时配了中断，就会在上电瞬间进一次中断。后来把电容降到 10nF，并且在初始化里先清一次中断标志，问题消失。

第二个坑是驱动继电器不加隔离。直接用 GPIO 推挽输出接继电器线圈，线圈电流几十毫安，超了引脚能力，同时线圈断开时的反电动势会把引脚打出负压。换成三极管加续流二极管之后一切正常。这个坑的教训是：GPIO 只适合给控制信号，任何感性负载都必须隔离。

第三个坑是调试时忘了自己改过复用。把调试用的两根线复用成了普通串口，烧完程序之后调试器再也连不上，只能靠复位时序抢连。后来养成习惯，调试引脚相关的代码单独放一个宏开关，量产版本才打开。

6.3 未用引脚的处理

没接任何东西的引脚，配成浮空输入是最省事的写法，也是最容易出问题的写法。悬空的输入级可能停在中间电平，让内部缓冲器同时微导通，静态电流从几微安涨到几十微安，在 μA 级待机的产品里这是致命的。

我的默认处理是：未用引脚全部配成模拟输入，这样数字通路完全断开，不会翻转也不会耗电。如果芯片不支持配模拟，就配成推挽输出并输出低电平，但要注意别和其他电路冲突。配成带内部上拉的输入是下策，因为只要引脚外部被拉低，上拉上就一直有电流。

7. 从裸机到系统：GPIO 在 Linux 侧的样子

在带操作系统的平台上复习 GPIO，思路要换一层。用户空间不再直接写寄存器，而是通过一套字符设备接口去申请和操作引脚，命令行工具提供查询、读取、写入的能力。第一次接触的时候最不习惯的是“用完要释放”，申请了不释放，下一个进程就用不了这根线，报的是“忙”。

设备树里描述引脚的方式也很关键，引脚控制器、引脚编号、复用功能、上下拉配置都写在一个属性里，编译成二进制之后由内核解析。这里的编号经常和芯片手册上的引脚编号对不上，因为操作系统用的是自己的全局编号空间，需要用工具查一次映射关系，不能拍脑袋换算。

内核驱动里操作 GPIO 的接口比较直观：申请、设置方向、设置初始值、注册中断、释放。有一个顺序上的细节值得记住，设置方向和设置初始值的先后，会影响输出瞬间的电平，跟裸机那边是一样的道理。中断处理里同样是先清状态再处理业务，否则会出现中断风暴。

还有一个容易被忽略的能力是引脚保持。有些平台允许在系统休眠时让某个引脚保持特定电平，用来维持外部器件的使能状态。这个特性在低功耗设计里很有用，但配置错了会导致休眠时某个电源一直开着，待机电流下不来。

8. 我个人在这些年攒下的几条习惯

写驱动之前先画一张引脚分配表，把每个引脚的功能、方向、默认电平、上下拉、是否复用、休眠时状态都填进去，这张表比任何注释都管用。我现在的项目里这张表是随代码一起维护的，改一个引脚就改一行，评审的时候直接看表。

初始化函数里永远先写电平再切方向，永远先开时钟再碰寄存器，永远在最后清一遍中断挂起标志。这三条看起来啰嗦，但每一条都对应过一次真实的故障。

任何超过 10cm 的引脚走线，都当成有噪声来处理：输入端加上拉或下拉，输出端考虑串一个小电阻抑制过冲，必要的加 RC 滤波。不要指望芯片内部的保护结构能扛住一切，它只是最后一道防线，不是设计手段。

最后一条是关于复习本身。GPIO 这套知识不看会忘，但忘掉的不是概念，而是那些数字：这个端口总电流多少、这个上拉的典型阻值多少、这个延时要留多少余量。所以我的笔记里不写原理，只写数字和对应的实测波形截图，下次翻的时候直接抄参数就行。