
断电就失忆,是大多数新项目的通病
调试了一下午的阈值、校准偏移、开机次数,插头一拔全归零——这种事每个玩单片机的人都干过一次,然后才想起来板上还躺着一块没用过的存储:EEPROM。
把 Flash、SRAM、EEPROM 一句话说清:Flash 存程序(ATmega328P 有 32KB),SRAM 存运行变量(只有 2KB,断电即失),EEPROM 按字节读写、掉电保持,Uno 上有 1KB。今天这 1KB,就是给配置和计数器准备的。
先把两个冷知识放前面:空片(出厂态)的 EEPROM 读出来是 255,也就是 0xFF,别假设它默认是 0;另外上传新程序不会清掉 EEPROM,旧固件留下的脏数据会原样留给你,这个坑后面细说。
write/read 是底层接口,update 是省寿命的写法
Arduino 的 EEPROM.h 提供了两套接口。老的一套是 EEPROM.write(addr, byte) 和 EEPROM.read(addr),一次一个字节,写一次大约耗时 3.3ms,这是 ATmega 数据手册给的量级。新项目更该记住的是第三个函数:EEPROM.update(addr, value),它先读出旧值比较,不一样才真正写入,一样就跳过。
为什么要计较这一次写入?因为 EEPROM 的擦写寿命按次数算,ATmega328P 数据手册标称每单元 10 万次擦写,read 随便读不损耗,寿命全花在 write 上。下面这段按键控制 LED 状态掉电记忆的示例,我把它从原教程逐字符搬过来:
#include "EEPROM.h"
const int BTN = 10, LED = 13, ADDR = 0;
bool state;
void setup() {
pinMode(BTN, INPUT_PULLUP); pinMode(LED, OUTPUT);
state = EEPROM.read(ADDR) == 1; // restore last state (blank EEPROM reads 255 = off)
digitalWrite(LED, state);
}
void loop() {
if (digitalRead(BTN) == LOW) {
state = !state;
digitalWrite(LED, state);
EEPROM.update(ADDR, state ? 1 : 0); // save only if it changed
delay(300); // crude debounce
}
}逻辑不复杂:开机时 read 地址 0 恢复上次状态,按键翻转状态后 update 写回。因为用了 update,连续按很多次但状态没变的场景不会消耗擦写次数。接线就两根:D10 到按键、按键另一端接 GND,靠 INPUT_PULLUP 上拉,板载 L LED 做指示。
put/get:struct 和 float 直接整块塞进去
一个字节一个字节拼 int、拼 float 是老派写法,累而且容易错位。EEPROM.put(addr, obj) 和 EEPROM.get(addr, obj) 支持任意类型——int、float、struct 都行,而且 AVR 库里 put 内部对每个字节用的就是 update 语义,只写变了的部分,寿命友好。真正要靠你自己操心的是两件事:结构体里别放 String,指针存进去重启就是野指针,要用定长 char 数组;以及怎么判断 EEPROM 里的数据是有效配置还是出厂垃圾。
答案是在结构体里埋一个 magic number。下面这个示例我觉得是整个 EEPROM 库最值得抄的模板:magic 校验 + 开机次数计数器 + 串口改配置,一件事没耽误,代码不长:
#include "EEPROM.h"
struct Settings {
uint16_t magic; // 0xCAFE means "these are valid"
uint16_t boots; // how many times the board has started
int threshold; // e.g. an alarm level
float calOffset; // e.g. a sensor correction
bool ledOn;
};
const uint16_t MAGIC = 0xCAFE;
const int ADDR = 0;
Settings cfg;
void save() { EEPROM.put(ADDR, cfg); } // writes only bytes that changed
void load() {
EEPROM.get(ADDR, cfg);
if (cfg.magic != MAGIC) { // first boot (or corrupted): defaults
cfg = { MAGIC, 0, 500, 0.0, false };
save();
}
}
void setup() {
Serial.begin(9600);
load();
cfg.boots++; // count this start-up
save();
Serial.print("boot #"); Serial.println(cfg.boots);
Serial.print("threshold "); Serial.println(cfg.threshold);
Serial.print("calOffset "); Serial.println(cfg.calOffset, 3);
}
void loop() {
// change a setting from the Serial Monitor: type t=700 or c=1.25
if (Serial.available()) {
String s = Serial.readStringUntil('\n'); s.trim();
if (s.startsWith("t=")) cfg.threshold = s.substring(2).toInt();
if (s.startsWith("c=")) cfg.calOffset = s.substring(2).toFloat();
save();
Serial.println("saved");
}
}烧进去打开串口监视器,每次复位 boot # 加一——这就是最朴素的掉电记忆计数器。串口里敲 t=700 或 c=1.25 回车,阈值和校准偏移立即写进 EEPROM,断电重启后照样回来。第一次上电时 magic 对不上,代码自动写默认值进去,不会拿 0xFF 拼出来的垃圾数据当配置用。
10 万次擦写的工程账怎么算
10 万次听着吓人,算笔账就知道大多数场景根本不用慌。同一地址每秒写一次,100000 ÷ (86400 × 365) ≈ 3.2 年写穿;每分钟才写一次,约 190 年,等于无限寿命。真正危险的是把 put 塞进 loop() 裸跑:loop 一秒几千圈,几分钟就把寿命挥霍完。
有一条实测数据值得记:有玩家用按键触发写一个 18 字节的 struct,串口打出总耗时 46.6ms、每字节约 2.6ms——和手册的 3.3ms 量级对得上,也说明批量写 struct 该挂在按键、串口指令这类显式动作后面,别在中断里抢时间。另外常温下断电保持的量级,课件上写的是约 10 年,做产品的话别把唯一一份关键数据只押在 EEPROM 上。

省寿命三板斧:一是 update/put 替代 write;二是只在数据真的变化、且有用户动作时才写;三是同一字节高频写入时做磨损均衡,比如用 10 个地址轮流记一个计数器,寿命直接乘 10。要求更高就换外挂芯片——Uno 上 A4/A5 两条线就能挂 I2C EEPROM,DS3231 时钟模块上常见的 AT24C32 也是这一族。

换板子和换思路的几句提醒
ESP32/ESP8266 上 EEPROM 库是拿 flash 模拟的假 EEPROM,必须先 EEPROM.begin(size) 分配、写完 EEPROM.commit() 才落盘,少了 commit 一切白干;ESP32 上官方更推荐 Preferences 库,键值存储自带磨损均衡。Mega2560 板载 EEPROM 是 4KB,跨板移植时用 EEPROM.length() 拿实际大小,别把 1024 写死。
最后说说那个"上传不清 EEPROM"的双面性。好处是配置能跨固件升级存活,坏处是旧固件的脏数据会让新固件第一次跑就抽风。所以 magic number 不只是防出厂垃圾,改了结构体布局时把 MAGIC 换个值,旧数据就会被识别为无效、干净地重置成默认值。
1KB 不大,但配置、校准值、开机计数这些东西本来就该住在这里。把 put/get、update、magic number 这三招学会,你的项目才算真正记住了自己是谁。











断电重上电 boot 计数还涨,这个示例拿去给同事演示掉电存储,比讲十遍原理都管用
这个账我替你算过一遍才服气:Uno 那 1KB EEPROM 每单元标称 10 万次擦写,你把 put 塞进 loop 裸跑的话,16MHz 下一秒几千圈,几小时都撑不到就写穿了。所以真正要记住的是 update 那一行——先读后写,值没变就跳过。我那个温湿度记录仪现在改成每 10 分钟才落一次盘,加上 10 地址轮转,理论上够跑到板子退休。另外 struct 里千万别放 String 这条是血泪教训,指针存进去重启读出来就是乱码,换定长 char 数组才老实。
magic number 这招是真香,第一次上电和固件升级后的脏数据一招全防住
上次为了存两个 float 自己手搓高低字节拆分,写完才知道有 EEPROM.put,白掉一把头发