4. GPIO功耗管理：别让浮空引脚偷走你的电量
做低功耗设计，GPIO这块儿其实是个“隐形杀手”。很多人把精力都放在关外设、降主频上，结果一测电流，还是高得离谱。我早年有个项目就是这样——明明进了睡眠模式，电流却比数据手册多了几十微安。查了半天，最后发现是三个没用的GPIO引脚浮空着，在那儿“抖”个不停。
说白了，浮空引脚就像一扇没关紧的门。外界一点点电磁干扰，就能让引脚电平来回跳变。每次跳变，内部CMOS管的P管和N管会短暂同时导通，形成贯通电流。这个电流虽然单次很小，但引脚一多、频率一高，累积起来就很可观了。
核心原则：未使用的GPIO引脚，绝不能悬空。必须给它们一个确定的电平状态。
4.1 三种处理方式，你选哪种？
GD32V的GPIO引脚，处理未使用引脚主要有三种方式。我按推荐程度排了个序：
| 处理方式 | 功耗表现 | 抗干扰能力 | 适用场景 |
|---|---|---|---|
| 模拟输入模式 | 最低（无数字噪声） | 强 | 所有未使用的引脚，首选 |
| 上拉/下拉输入 | 较低（有微弱电流） | 强 | 需要保留数字功能的引脚 |
| 推挽输出（固定电平） | 低（取决于负载） | 最强 | 已连接外部电路的引脚 |
我个人习惯，只要引脚没有特殊用途，一律先配成模拟输入模式。为什么？因为模拟输入模式下，数字输入部分的施密特触发器被关闭了，不会因为电平跳变产生额外的开关电流。这是最干净的做法。
4.2 模拟输入模式：最省心的选择
把GPIO配置为模拟输入，其实就是告诉MCU：“这个引脚我不看它的数字电平，你把它当模拟通道用。” 这样一来，数字输入通路完全断开，漏电路径被彻底切断。
配置代码很简单，以GD32V的GPIOA的未使用引脚为例：
/* 将PA0配置为模拟输入模式 */
gpio_mode_set(GPIOA, GPIO_MODE_ANALOG, GPIO_PUPD_NONE, GPIO_PIN_0);
/* 如果是一组引脚，可以批量操作 */
gpio_mode_set(GPIOA, GPIO_MODE_ANALOG, GPIO_PUPD_NONE,
GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3);注意这里我用了 GPIO_PUPD_NONE。模拟模式下，上拉和下拉电阻都不需要开，开了反而多耗电。
小技巧：在系统初始化函数里，专门写一个 gpio_unused_pins_init() 函数，把所有未使用的引脚统一配置。这样代码结构清晰，也方便后期维护。
4.3 上拉/下拉输入：当模拟模式不能用时
有些场景下，你不能把引脚设为模拟模式。比如这个引脚被复用了，或者硬件设计上已经接了外部电路。这时候，上拉或下拉输入就是次优选择。
为什么是“上拉/下拉输入”而不是“输出”？因为输出模式如果电平设置不当，可能会和外部电路打架，轻则多耗电，重则烧引脚。输入模式加个上拉或下拉，电平是确定的，而且电流被内部电阻限制住了，很安全。
配置示例：
/* 将PB5配置为上拉输入，默认高电平 */
gpio_mode_set(GPIOB, GPIO_MODE_INPUT, GPIO_PUPD_PULLUP, GPIO_PIN_5);
/* 将PB6配置为下拉输入，默认低电平 */
gpio_mode_set(GPIOB, GPIO_MODE_INPUT, GPIO_PUPD_PULLDOWN, GPIO_PIN_6);这里有个细节：上拉和下拉电阻的阻值通常在30kΩ~50kΩ之间。以3.3V供电计算，上拉时的漏电流大约是：
I = 3.3V / 40kΩ ≈ 82.5μA
一个引脚80多微安，十个就是0.8mA。虽然比浮空时的尖峰电流小，但相比模拟模式的近乎0漏电，还是差了不少。所以，能用模拟模式就别犹豫。
我曾经踩过的坑：有个批次的板子，生产出来后静态电流比样机大了0.3mA。查了两天，发现是BOM里某个引脚的上拉电阻没焊，导致引脚浮空。从那以后，我坚持在软件里做双重保险——不管硬件有没有外部上拉，软件里也配成内部上拉。多花一行代码，省去无数排查时间。
4.4 推挽输出模式：特殊情况下的选择
如果引脚已经连到了外部器件，而且那个器件需要被驱动到固定电平，那就用推挽输出。比如某个使能引脚，你希望它一直保持高电平或低电平。
/* 将PC1配置为推挽输出，输出低电平 */
gpio_mode_set(GPIOC, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO_PIN_1);
gpio_output_options_set(GPIOC, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_1);
gpio_bit_reset(GPIOC, GPIO_PIN_1);注意输出速度的设置。对于固定电平的引脚，用最低的速率档位就行。我一般用 GPIO_OSPEED_2MHZ，没必要开50MHz去驱动一个静态电平，白白增加动态功耗。
4.5 一个完整的初始化示例
下面是我在实际项目中常用的初始化片段。它把未使用的引脚统一处理，同时保留了调试接口（SWD）的引脚：
void gpio_unused_pins_init(void)
{
/* 使能所有GPIO时钟 */
rcu_periph_clock_enable(RCU_GPIOA);
rcu_periph_clock_enable(RCU_GPIOB);
rcu_periph_clock_enable(RCU_GPIOC);
rcu_periph_clock_enable(RCU_GPIOD);
/* 保留SWD调试引脚：PA13(SWDIO), PA14(SWCLK) */
/* 其余PA引脚全部设为模拟输入 */
gpio_mode_set(GPIOA, GPIO_MODE_ANALOG, GPIO_PUPD_NONE,
GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7 |
GPIO_PIN_8 | GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 |
GPIO_PIN_12 | GPIO_PIN_15);
/* PB0-PB7设为模拟输入 */
gpio_mode_set(GPIOB, GPIO_MODE_ANALOG, GPIO_PUPD_NONE,
GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7);
/* PC13(板载LED)保持输出模式，其余PC引脚模拟输入 */
gpio_mode_set(GPIOC, GPIO_MODE_ANALOG, GPIO_PUPD_NONE,
GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7 |
GPIO_PIN_8 | GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 |
GPIO_PIN_12 | GPIO_PIN_14 | GPIO_PIN_15);
}4.6 知识结构图：GPIO功耗管理决策流程
下面这张图，是我做GPIO功耗管理时的决策路径。每次画板子或写初始化代码，我都会过一遍这个流程：
4.7 避坑指南：我踩过的那些雷
做GPIO功耗管理，有几个坑特别容易踩。我一个个说：
- 复位后的默认状态：GD32V上电复位后，GPIO默认是浮空输入模式。也就是说，从复位到你的初始化代码执行之间，有一段“真空期”。如果这段期间功耗敏感，你需要在硬件上做处理——比如加外部下拉电阻。
- 调试接口别乱动：PA13（SWDIO）和PA14（SWCLK）这两个引脚，如果你把它们配成模拟输入，调试器就再也连不上了。我建议保留它们的默认功能，或者至少配成上拉输入。
- 外部中断引脚：如果某个引脚同时被用作了外部中断源，即使它当前没在用，也别轻易改成模拟输入。因为模拟模式下，中断触发逻辑可能失效。这种情况，我一般配成上拉输入，并关闭中断使能。
- 唤醒引脚：用于从低功耗模式唤醒的引脚，必须保持数字输入功能。模拟输入模式不支持唤醒。所以这类引脚只能配成上拉/下拉输入。
我曾经遇到最诡异的问题：有一款产品，批量生产后有2%的板子静态电流超标。排查了整整一周，最后发现是PCB布局导致相邻的两个浮空引脚之间产生了串扰，一个引脚的电平变化通过寄生电容耦合到了另一个引脚。两个引脚都在跳变，电流自然下不来。解决方案很简单——把这两个引脚都配成模拟输入，问题立刻消失。
4.8 实测数据：不同配置下的功耗对比
最后，我放一组实测数据。这是我在GD32VF103开发板上测的，只改变一个未使用引脚的状态，其他条件完全一致：
| 引脚配置 | 静态电流 (μA) | 相对浮空状态的改善 |
|---|---|---|
| 浮空输入（默认） | 12.5 | — |
| 上拉输入 | 3.2 | ↓ 74% |
| 下拉输入 | 3.1 | ↓ 75% |
| 推挽输出（低电平） | 2.8 | ↓ 78% |
| 模拟输入 | 0.3 | ↓ 98% |
看到没？一个引脚从浮空改成模拟输入，电流从12.5μA降到0.3μA。如果板子上有十几个未用引脚，这个差距就是上百微安。对于电池供电的产品来说，这可能是待机时间从30天变成35天的关键。
嗯，GPIO功耗管理这块，说白了就是一句话：别让任何引脚悬空。至于具体用哪种方式，按我上面那张决策图走一遍，基本不会出错。