RTC慢速内存是ESP32中由RTC控制器供电、Deep Sleep时仍保持数据的8 KB片上RAM,需用RTC_NOINIT_ATTR或RTC_DATA_ATTR声明静态变量才能存入,非此方式定义的变量睡眠后必丢失。

RTC慢速内存是什么,为什么能防睡眠丢失 ESP32 的 RTC 慢速内存(RTC Slow Memory)是片上 RAM 的一部分,由 RTC 控制器供电,在 Deep Sleep 模式下仍保持供电(只要 VDD_RTC 未断电),因此变量存这里不会因睡眠而清空。它和 RTC 快速内存(RTC Fast Memory)不同:后者只能用于存放代码(如唤醒 ISR),不能随便放普通变量;而 RTC 慢速内存专为数据保留设计,但访问速度略慢、容量有限(约 8 KB,具体看芯片型号,ESP32-WROOM-32 是 8192 字节)。
关键点:rtc_slow_mem 不是靠「手动 memcpy」维持的,而是靠链接器脚本 + 编译属性让变量**直接落在 RTC 慢速内存段里**。单纯用 malloc 或栈变量,哪怕在睡眠前赋值,醒来后也全丢了。
怎么声明一个变量到 RTC 慢速内存
最可靠的方式是使用 ESP-IDF 提供的 RTC_NOINIT_ATTR 宏(推荐)或 RTC_DATA_ATTR,二者区别在于初始化行为:
-
RTC_NOINIT_ATTR:变量不被初始化(保留上次掉电前的值),适合计数器、状态标记等需要“断电延续”的场景
-
RTC_DATA_ATTR:变量会在每次启动时按定义的初值初始化一次(类似全局变量),但之后睡眠/唤醒全程保值
RTC_NOINIT_ATTR:变量不被初始化(保留上次掉电前的值),适合计数器、状态标记等需要“断电延续”的场景RTC_DATA_ATTR:变量会在每次启动时按定义的初值初始化一次(类似全局变量),但之后睡眠/唤醒全程保值示例:
// 放在 .cpp 或 .c 文件全局作用域(不能在函数内) RTC_NOINIT_ATTR static uint32_t sleep_counter = 0; RTC_DATA_ATTR static uint8_t last_sensor_mode = 1;
注意:必须是 静态存储期 变量(static 或全局),不能是局部自动变量;类型支持所有基本类型和 POD 结构体(不含虚函数、非平凡构造/析构)。
常见错误:变量没生效、醒来还是 0
这是高频踩坑点,原因往往不是宏写错,而是以下几类:
- 变量定义在函数内部(比如写在
app_main()里),即使加了static,也可能被编译器优化进栈或普通 RAM 段 - 用了
const修饰 ——const变量默认进只读段(.rodata),不在 RTC 内存范围内,加RTC_DATA_ATTR也无效 - 结构体里含指针或 STL 容器(如
std::vector)—— RTC 内存只保存二进制位,指针指向的堆内存必然失效 - 变量大小超过 RTC 慢速内存剩余空间(尤其多个大数组叠加),链接时报
region `rtc_slow' overflowed
验证是否真进去了:编译后查看 map 文件(build/),搜索变量名,确认其地址落在 rtc_slow 段(通常是 0x50000000 附近)。
配合 Deep Sleep 使用的注意事项
RTC 慢速内存只是“存得住”,但要真正防丢,还需确保:
- 启用 RTC 慢速内存供电:默认开启,但若你调过
esp_sleep_pd_config()并传入ESP_PD_OPTION_OFF给ESP_PD_DOMAIN_RTC_SLOW_MEM,就会关掉——别这么干 - 避免在唤醒后立即读取未初始化的
RTC_NOINIT_ATTR变量:首次上电时内容是随机的,建议加校验字段或用RTC_DATA_ATTR初始化默认值 - 若用 ULP 协处理器读写该内存,需注意 ULP 访问的是同一块物理地址,但 ULP 程序必须用
ulp_rtc_mem_read/write函数,不能直接解引用
复杂点在于:RTC 慢速内存没有硬件 ECC 或自动校验,长期掉电后个别 bit 可能翻转。如果存的是关键状态(如设备开关机标志),建议加 1 字节校验和或用双缓冲+比对机制,而不是无脑依赖“它不会丢”。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











