4、开发环境搭建：Arduino IDE与ESP-IDF的配置，以及必要的硬件准备（电池、电流表等）

ESP32 的 Deep Sleep 优化工作，本质上是在“功耗测量—代码调整—再次测量”的闭环中反复迭代。因此，开发环境的搭建不能只停留在“能编译、能烧录”的层面，还必须为后续的电流采集、电池放电曲线记录、唤醒源逻辑验证提供稳定的工具链支撑。本章将围绕 Arduino IDE 与 ESP-IDF 两套主流开发框架的配置要点展开，同时详细说明电池、电流表、杜邦线、面包板等硬件准备工作的具体规格与连接方法。无论你选择哪套框架，最终目标都是建立一个可重复、可量化、低干扰的功耗测试平台。

上图展示了本章的核心脉络：左侧是开发框架的选择，中间是硬件准备清单，右侧是测量链路的连接方式。在实际操作中，这三部分并非独立推进，而是相互影响。例如，使用 Arduino IDE 时，其默认的 esp_sleep_enable_timer_wakeup() 函数与 ESP-IDF 中的行为略有差异，这会影响唤醒源配置的代码写法；而电池类型和电流表精度则直接决定了你能测到的最小休眠电流值。因此，建议按照“先搭硬件测量链路，再配置开发环境，最后编写测试代码”的顺序进行。

4.1 开发框架选型：Arduino IDE 与 ESP-IDF 的定位差异

对于 Deep Sleep 优化这一特定任务，两套框架各有不可替代的优势。Arduino IDE 的优势在于抽象层完善，开发者无需关心底层寄存器操作，几行代码即可进入 Deep Sleep；而 ESP-IDF 则提供了更细粒度的电源管理接口，例如 esp_pm_configure() 可以动态调节 CPU 频率，esp_sleep_pd_config() 可以控制外设电源域，这些在 Arduino 核心库中并未完全暴露。从课程实践角度看，建议初学者先用 Arduino IDE 跑通基本流程，再用 ESP-IDF 进行深度调优。

选择框架时还需考虑团队协作因素。如果项目后续需要集成其他传感器库或云服务 SDK，Arduino 的库生态更丰富；如果追求极致功耗（例如休眠电流低于 10μA），则必须使用 ESP-IDF 手动关闭不必要的 RTC 外设和 IO 上拉电阻。

4.2 Arduino IDE 环境配置与 Deep Sleep 基础代码

Arduino IDE 的配置流程相对直观，但有几个关键步骤容易被忽略。首先，在“开发板管理器”中安装 esp32 by Espressif Systems 时，建议选择 2.0.x 以上版本，因为旧版本对 Deep Sleep 的 GPIO 唤醒支持不完整。其次，安装完成后需要手动选择开发板型号，例如 ESP32 Dev Module 或 ESP32-WROOM-DA Module，不同型号的 Flash 大小和 PSRAM 配置会影响编译结果。

// Arduino IDE 下的 Deep Sleep 最小示例
#include <esp_sleep.h>

void setup() {
  Serial.begin(115200);
  delay(1000);
  
  // 配置定时器唤醒：10 秒后唤醒
  esp_sleep_enable_timer_wakeup(10 * 1000000); // 单位：微秒
  
  // 配置 GPIO 唤醒：GPIO0 下降沿触发
  esp_sleep_enable_ext0_wakeup(GPIO_NUM_0, 0);
  
  Serial.println("进入 Deep Sleep");
  esp_deep_sleep_start();
}

void loop() {
  // 唤醒后从这里继续执行
  Serial.println("已唤醒");
  delay(2000);
  esp_deep_sleep_start(); // 再次休眠
}

这段代码展示了最基本的定时器唤醒和外部 GPIO 唤醒组合。需要注意的是，esp_sleep_enable_ext0_wakeup() 只能使用 RTC GPIO（即 GPIO0、GPIO2、GPIO4、GPIO12-15、GPIO25-27、GPIO32-39），普通 GPIO 无法唤醒。此外，在进入 Deep Sleep 前，建议调用 esp_wifi_stop() 和 esp_bt_controller_disable() 关闭无线模块，否则休眠电流会额外增加 20-30mA。

4.3 ESP-IDF 环境配置与电源管理接口

ESP-IDF 的安装相对复杂，推荐使用 v5.x 版本，因为它引入了新的电源管理框架。安装完成后，需要设置环境变量 IDF_PATH 并运行 export.sh 脚本。对于 Deep Sleep 优化，ESP-IDF 提供了 esp_sleep_pd_config() 函数，可以单独控制 RTC 域内各个外设的电源状态。

// ESP-IDF 下的 Deep Sleep 配置示例
#include "esp_sleep.h"
#include "esp_pm.h"
#include "driver/rtc_io.h"

void app_main() {
    // 配置电源管理策略
    esp_pm_config_esp32_t pm_config = {
        .max_freq_mhz = 240,
        .min_freq_mhz = 80,
        .light_sleep_enable = false
    };
    esp_pm_configure(&pm_config);
    
    // 关闭 RTC 域内不需要的外设
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_SLOW_MEM, ESP_PD_OPTION_OFF);
    esp_sleep_pd_config(ESP_PD_DOMAIN_RTC_FAST_MEM, ESP_PD_OPTION_OFF);
    
    // 配置 GPIO 唤醒（仅限 RTC GPIO）
    rtc_gpio_pullup_dis(GPIO_NUM_4);
    rtc_gpio_pulldown_en(GPIO_NUM_4);
    esp_sleep_enable_ext0_wakeup(GPIO_NUM_4, 1);
    
    // 进入 Deep Sleep
    esp_deep_sleep_start();
}

这段代码展示了 ESP-IDF 的精细控制能力。通过 esp_sleep_pd_config() 关闭 RTC 慢速存储器和快速存储器，可以额外节省约 5μA 电流。但需要注意，关闭 RTC 存储器后，唤醒后无法保留 Deep Sleep 前的变量值，只能通过 RTC 寄存器或 NVS 存储关键数据。

4.4 硬件准备：电池、电流表与测试链路搭建

硬件准备的核心目标是构建一条低干扰的电流测量链路。首先，电池选择上，推荐使用 18650 锂电池（标称 3.7V，容量 2000-3500mAh）或 3.7V LiPo 电池。避免使用 9V 碱性电池，因为其内阻较大，在 ESP32 唤醒瞬间（电流可达 500mA）会造成电压跌落，导致复位。如果使用 USB 供电进行测试，必须注意 USB 的 5V 电压会绕过板载 LDO 直接进入 3.3V 电路，导致测量结果完全失真。

连接方式上，务必采用“电池正极 → 电流表 → ESP32 VIN”的串联结构，电池负极直接连接 ESP32 GND。如果使用万用表，需要将红表笔插入电流测量孔（通常标有 10A 或 mA/μA），黑表笔插入 COM 孔。测量 Deep Sleep 电流时，建议将万用表档位拨到 200μA 档，因为 ESP32 在 Deep Sleep 下的典型电流为 5-20μA，使用 10A 档会因分辨率不足而显示为 0。

4.5 常见误区与工程复盘

在搭建开发环境和硬件测试链路时，有几个高频误区需要特别警惕。第一个误区是使用 USB 供电进行功耗测量，这会导致测量结果完全无效，因为 USB 的 5V 电压经过板载 AMS1117 稳压器后，静态电流约 1-2mA，且稳压器在空载时仍有功耗。第二个误区是忽略 GPIO 的上拉或下拉电阻，例如 ESP32 的 GPIO12 默认有内部上拉，如果悬空，在 Deep Sleep 期间会额外消耗约 10μA 电流。第三个误区是使用面包板进行测量，面包板的簧片接触电阻和分布电容会影响微安级电流的稳定性。

• 误区一：使用 USB 供电测量 Deep Sleep 电流。正确做法是使用电池供电，并断开 USB 线。
• 误区二：未配置 GPIO 状态。所有未使用的 GPIO 应设置为 INPUT_PULLDOWN 或 OUTPUT_LOW，避免浮空。
• 误区三：电流表直接并联在电池两端。电流表必须串联，否则会短路。
• 误区四：忽略环境温度影响。锂电池在低温下内阻增大，会导致 ESP32 唤醒时电压跌落，建议在室温下测试。