📚 课程目录第4章 GPIO低功耗配置

4. GPIO 低功耗配置：漏电流、上下拉与未使用引脚

各位做低功耗产品时，GPIO 这块儿往往是第一个坑。我见过不少工程师，代码写得飞起，一测功耗——好家伙，几百微安下不去。查到最后，多半是 GPIO 配置没伺候好。

今天咱们就把 GPIO 低功耗配置的底裤扒干净。说白了，就三件事：模式选对、上下拉算清、未用引脚管好。

4.1 GPIO 模式对漏电流的影响

先看这张图，你就明白不同模式下电流是怎么漏出去的。

我在项目中遇到过最典型的案例：一块电池供电的传感器板，Stop 模式功耗标称 2 µA，实测 15 µA。查了两天，最后发现是三个配置成输入浮动的引脚在作怪。改成模拟模式后，功耗直接掉到 2.3 µA。

核心原则：进入低功耗模式前，所有 GPIO 必须处于确定状态。浮动输入是漏电流的头号元凶。

4.2 上下拉电阻的功耗

上下拉电阻这东西，用好了是功臣，用不好就是电老虎。你想想看，一个 40 kΩ 的上拉电阻，在 3.3 V 下就是 82.5 µA 的静态电流。如果芯片有几十个引脚都开了上拉……嗯，电池会哭的。

上下拉类型	典型阻值	3.3V 下静态电流	适用场景	低功耗建议
内部上拉	40 kΩ	82.5 µA	按键输入、I²C 总线	休眠前关闭，或改用外部大电阻
内部下拉	40 kΩ	82.5 µA	默认低电平输入	休眠前关闭
外部上拉（常用）	10 kΩ	330 µA	开漏输出、复位引脚	评估是否必须常开
外部上拉（低功耗）	100 kΩ	33 µA	低速信号、唤醒引脚	推荐用于低功耗设计
外部上拉（超低功耗）	1 MΩ	3.3 µA	极低功耗唤醒	注意信号上升时间

我的习惯：在低功耗项目中，我一般不用内部上下拉。外部用 100 kΩ 或 1 MΩ 电阻，配合模拟模式或输出模式，能把引脚漏电流控制在 0.1 µA 以下。

为什么会这样？内部上下拉电阻是芯片设计时固定死的，你没法改。而外部电阻你可以根据功耗和信号完整性自由选择。我曾经在一个 NB-IoT 终端上，把所有内部上下拉都关了，换成 470 kΩ 外部上拉，整板休眠电流从 12 µA 降到了 4.5 µA。

4.3 未使用引脚的处理策略

未使用的引脚怎么处理？这个问题我问过不少工程师，答案五花八门。有人悬空不管，有人接地，有人接 VDD。其实标准答案只有一个——看你的功耗目标。

下面这张图总结了不同策略的优劣：

我曾经踩过的坑：有一款产品，PCB 上有个调试用的 SWD 接口，量产时没焊排针。结果 SWDIO 和 SWCLK 引脚悬空，进入 Stop 模式后这两个引脚在输入浮动状态，额外贡献了 8 µA 的漏电流。后来在代码里把这两个引脚在休眠前切到模拟模式，问题解决。

4.4 实战代码：GPIO 低功耗配置模板

下面给出一段我项目里常用的 GPIO 低功耗配置代码。你可以直接拿去用。

/**
  * @brief  进入低功耗前的 GPIO 配置
  * @note   在调用 HAL_PWR_EnterSTOPMode 之前执行
  */
void GPIO_LowPower_Config(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    // 1. 未使用引脚 → 模拟模式（最低漏电）
    //    假设 PA0-PA3, PB0-PB3 未使用
    __HAL_RCC_GPIOA_CLK_ENABLE();
    __HAL_RCC_GPIOB_CLK_ENABLE();

    GPIO_InitStruct.Mode = GPIO_MODE_ANALOG;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;

    GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3;
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

    GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3;
    HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

    // 2. 已使用但休眠时不需要的引脚 → 输出低电平
    //    比如 LED 控制引脚 PC13
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
    GPIO_InitStruct.Pin = GPIO_PIN_13;
    HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);
    HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET);

    // 3. 唤醒引脚保留输入模式，但加上外部上下拉
    //    PA0 作为唤醒源，外部已接 100kΩ 上拉到 VDD
    GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
    GPIO_InitStruct.Pull = GPIO_NOPULL;  // 使用外部电阻
    GPIO_InitStruct.Pin = GPIO_PIN_0;
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

    // 4. 关闭不用的外设时钟（减少数字漏电）
    __HAL_RCC_GPIOA_CLK_DISABLE();  // 注意：如果 PA0 还要用，不能关
    __HAL_RCC_GPIOB_CLK_DISABLE();
    // 保留 GPIOC 时钟（PC13 和唤醒引脚需要）
}

小技巧：在调试阶段，可以用一个 GPIO 输出方波，用示波器观察休眠前后的电流变化。我习惯在进入休眠前拉高一个测试引脚，唤醒后拉低，这样能精确测量休眠时长和电流。

4.5 常见误区与避坑指南

误区一：认为内部上下拉不耗电。实际上 40 kΩ 在 3.3 V 下就是 82.5 µA，十个引脚就是 0.8 mA。
误区二：把未用引脚直接接地。如果该引脚被意外配置为输出高，就是短路，轻则发热，重则烧引脚。
误区三：休眠前只关外设时钟，不管 GPIO 状态。数字电路的输入缓冲器在浮动时会产生贯穿电流。
误区四：所有引脚都用模拟模式。如果该引脚外部有上拉/下拉电阻，模拟模式会断开数字输入，但外部电阻的电流依然存在。

我曾经犯过的错：有一版设计，我把所有未用引脚都配置成输出低，但忘了关内部上拉。结果内部上拉和输出低形成了内部短路，每个引脚多耗了 80 µA。16 个引脚就是 1.28 mA——电池一晚上就没了。

嗯，GPIO 低功耗配置这块儿，说白了就是三个字：确定性。每个引脚在休眠时是什么电平、什么模式、有没有上下拉，你心里要有数。别让芯片在休眠时还处于「薛定谔的引脚」状态。