ESP32深度睡眠唤醒必须使用RTC GPIO（如GPIO0、GPIO2、GPIO4、GPIO12–GPIO15、GPIO25–GPIO27、GPIO32–GPIO39），普通GPIO无法触发中断；需硬件去抖、唤醒后重初始化外设与UART、用RTC_DATA_ATTR保存关键变量，并通过esp_sleep_get_wakeup_cause()校验唤醒源。
ESP32深度睡眠唤醒必须用RTC GPIO
普通GPIO在深度睡眠时无法触发中断，只有标记为RTC GPIO的引脚才能作为唤醒源。ESP32芯片的RTC模块独立供电，仅这些引脚（如GPIO0、GPIO2、GPIO4、GPIO12–GPIO15、GPIO25–GPIO27、GPIO32–GPIO39）能保持电平检测能力。非RTC GPIO（比如GPIO5、GPIO18）即使配置了中断，深度睡眠后也完全失效。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 优先选用
GPIO34或GPIO39——它们是输入专用RTC引脚，无内部上拉/下拉，更适合接按键（需外接上下拉电阻） - 若用
GPIO0或GPIO2，注意它们可能被bootloader或串口下载电路干扰，上电时悬空易误唤醒 - 务必调用
rtc_gpio_hold_en()防止唤醒后引脚状态跳变导致二次触发
如何配置按键唤醒并避免抖动误触发
硬件去抖是必须的，ESP32的RTC GPIO中断不支持软件消抖（无FIFO、无延时配置），一旦电平变化就上报。常见错误是只靠esp_sleep_enable_ext1_wakeup()就认为“搞定”，结果按键按一次唤醒多次。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 硬件上：按键一端接RTC GPIO，另一端接GND；GPIO加10kΩ上拉电阻（唤醒源为低电平有效）
- 软件上：使用
esp_sleep_enable_ext1_wakeup()，传入EXT1_WAKEUP_ALL_LOW（推荐）或EXT1_WAKEUP_ANY_HIGH，不要用边沿触发模式（RTC不支持） - 唤醒后立刻调用
rtc_gpio_isolate()断开RTC与GPIO连接，再读取gpio_get_level()确认真实按键状态，排除噪声干扰
唤醒后必须重初始化GPIO和外设
深度睡眠会关闭APB总线、禁用所有非RTC外设，唤醒后GPIO寄存器回到复位态，之前配置的输出模式、中断回调、ADC通道等全部丢失。常见错误是唤醒后直接调用ledc_write()或i2c_master_cmd_begin()导致崩溃或无响应。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 把所有外设初始化逻辑（如
ledc_timer_config_t、i2c_param_config()）封装成函数，在app_main()开头和唤醒返回后都调用一次 - 不要依赖全局变量保存状态——深度睡眠中RAM默认掉电（除非启用RTC fast memory），需用
RTC_DATA_ATTR修饰关键变量，例如：RTC_DATA_ATTR static uint32_t wake_count = 0;
- 唤醒后首次执行前，调用
esp_sleep_get_wakeup_cause()确认确实是EXT1唤醒，再决定是否执行业务逻辑
为什么唤醒后串口打印乱码或没输出
深度睡眠期间UART控制器断电，唤醒后Uart driver未重置，但波特率寄存器可能残留旧值，尤其在使用uart_set_pin()自定义引脚时更易出问题。这不是代码bug，而是电源域切换导致的硬件状态不一致。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 唤醒后第一件事：调用
uart_driver_delete(UART_NUM_0)+uart_driver_install()完整重建UART驱动 - 如果使用
printf()，确保console_config()类初始化也在唤醒流程中执行，否则stdout仍指向已失效的硬件句柄 - 避免在
esp_sleep_start()前关闭UART电源（periph_module_disable(PERIPH_UART0_MODULE)），这会让唤醒后恢复更困难
