单片机与物联网 / 系统课时
保存配置数据
保存配置数据
本课使用 ESP32 Arduino Core 自带的 Preferences 库,把亮度、采样间隔等设备参数写入 NVS 非易失性存储。程序重启后会重新读取这些键值,因此无需外接 EEPROM,也不必把运行时配置硬编码回固件。
学习目标
- 理解
Preferences、命名空间与键值数据在 NVS 中的关系。 - 能保存并读取整数配置,让参数在断电或重启后继续保留。
- 能避免高频写入、类型不一致和误清空等常见问题。
用 Preferences 组织持久化配置
Preferences 是 ESP32 Arduino Core 对 NVS 的封装。使用时先通过 begin() 打开一个命名空间,再用 get...() 和 put...() 读写键值;如果后续不再访问该命名空间,再调用 end() 释放句柄。
适合保存的内容包括 Wi-Fi 配置标志、采样周期、亮度、校准参数和模式选择。持续变化的传感器数据或日志不适合逐条写入 NVS,因为闪存写入次数有限。
保存参数并在重启后恢复
下面的完整示例在启动时读取 brightness 和 interval_ms。如果串口收到 b=80 或 i=2000,程序会立即把新值写入 NVS;输入 show 可以查看当前值。重新上电后,之前保存的配置会被恢复。
#include <Arduino.h>
#include <Preferences.h>
Preferences prefs;
uint8_t brightness = 50;
uint32_t intervalMs = 1000;
void printConfig() {
Serial.printf("brightness=%u, interval_ms=%lu\n",
brightness,
static_cast<unsigned long>(intervalMs));
}
void setup() {
Serial.begin(115200);
Serial.setTimeout(200);
prefs.begin("device", false);
brightness = prefs.getUChar("brightness", 50);
intervalMs = prefs.getUInt("interval_ms", 1000);
Serial.println("Config loaded");
printConfig();
Serial.println("Commands: b=<0-100>, i=<ms>, show");
}
void loop() {
if (!Serial.available()) {
delay(10);
return;
}
String command = Serial.readStringUntil('\n');
command.trim();
if (command.startsWith("b=")) {
int value = command.substring(2).toInt();
if (value >= 0 && value <= 100) {
brightness = static_cast<uint8_t>(value);
prefs.putUChar("brightness", brightness);
Serial.println("brightness saved");
} else {
Serial.println("brightness must be 0-100");
}
} else if (command.startsWith("i=")) {
long value = command.substring(2).toInt();
if (value >= 100 && value <= 60000) {
intervalMs = static_cast<uint32_t>(value);
prefs.putUInt("interval_ms", intervalMs);
Serial.println("interval saved");
} else {
Serial.println("interval must be 100-60000 ms");
}
} else if (command == "show") {
printConfig();
} else {
Serial.println("unknown command");
}
}预期输出
Config loaded
brightness=50, interval_ms=1000
Commands: b=<0-100>, i=<ms>, show第一次启动且还没有这些键时,getUChar() 和 getUInt() 会返回代码中给出的默认值。输入 b=80、i=2000 后,再执行 show,预期得到:
brightness saved
interval saved
brightness=80, interval_ms=2000重新启动 ESP32 后,启动信息中的配置仍应为 brightness=80, interval_ms=2000,这就证明参数已经从 NVS 恢复。
把写入控制在必要时
NVS 适合“偶尔修改、经常读取”的配置数据。不要在 loop() 中每次循环都调用 put...(),也不要在每次传感器采样后都写入闪存。更好的做法是只在用户修改参数、设备配网成功或校准完成时写一次。
读写类型也应保持一致。例如使用 putUInt() 保存的数据,应继续用 getUInt() 读取。若后续升级固件改变了配置结构,可以增加一个版本键,再按版本执行迁移,而不是直接假设旧数据一定符合新格式。
当配置项数量不多、结构简单且需要跨重启保留时,Preferences 是 ESP32 上最直接的方案;把写入时机和数据类型控制好,就能得到稳定的设备参数持久化机制。