Arduino EEPROM:put/get存配置断电不丢

2026-11-16 13:42:13 51阅读 所属项目:ESP32 开发板

Arduino EEPROM 掉电存储实操:AT24LC256 系列 I2C EEPROM 芯片

断电就失忆,是大多数新项目的通病

调试了一下午的阈值、校准偏移、开机次数,插头一拔全归零——这种事每个玩单片机的人都干过一次,然后才想起来板上还躺着一块没用过的存储: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 上。

EEPROM 的擦写寿命与数据保持时间:典型 10 万到 200 万次重写

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

AT24LC256 芯片与常见 I2C EEPROM 模块,Uno 上 A4/A5 即可挂载

换板子和换思路的几句提醒

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 这三招学会,你的项目才算真正记住了自己是谁。


作者:野生极客一枚
链接:https://www.aiddithome.com/p/461f78b62739f.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
周五下班搞一搞
1楼 · 2026-11-16 13:43:57

断电重上电 boot 计数还涨,这个示例拿去给同事演示掉电存储,比讲十遍原理都管用

锡点
2楼 · 2026-11-16 13:43:56

这个账我替你算过一遍才服气:Uno 那 1KB EEPROM 每单元标称 10 万次擦写,你把 put 塞进 loop 裸跑的话,16MHz 下一秒几千圈,几小时都撑不到就写穿了。所以真正要记住的是 update 那一行——先读后写,值没变就跳过。我那个温湿度记录仪现在改成每 10 分钟才落一次盘,加上 10 地址轮转,理论上够跑到板子退休。另外 struct 里千万别放 String 这条是血泪教训,指针存进去重启读出来就是乱码,换定长 char 数组才老实。

参数党小马
3楼 · 2026-11-16 13:43:56

magic number 这招是真香,第一次上电和固件升级后的脏数据一招全防住

下班才有空
4楼 · 2026-11-16 13:43:56

上次为了存两个 float 自己手搓高低字节拆分,写完才知道有 EEPROM.put,白掉一把头发