单片机与物联网 / 系统课时

保存配置数据

保存配置数据

本课使用 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 可以查看当前值。重新上电后,之前保存的配置会被恢复。

cpp
#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");
  }
}

预期输出

text
Config loaded
brightness=50, interval_ms=1000
Commands: b=<0-100>, i=<ms>, show

第一次启动且还没有这些键时,getUChar() 和 getUInt() 会返回代码中给出的默认值。输入 b=80、i=2000 后,再执行 show,预期得到:

text
brightness saved
interval saved
brightness=80, interval_ms=2000

重新启动 ESP32 后,启动信息中的配置仍应为 brightness=80, interval_ms=2000,这就证明参数已经从 NVS 恢复。

把写入控制在必要时

NVS 适合“偶尔修改、经常读取”的配置数据。不要在 loop() 中每次循环都调用 put...(),也不要在每次传感器采样后都写入闪存。更好的做法是只在用户修改参数、设备配网成功或校准完成时写一次。

读写类型也应保持一致。例如使用 putUInt() 保存的数据,应继续用 getUInt() 读取。若后续升级固件改变了配置结构,可以增加一个版本键,再按版本执行迁移,而不是直接假设旧数据一定符合新格式。

当配置项数量不多、结构简单且需要跨重启保留时,Preferences 是 ESP32 上最直接的方案;把写入时机和数据类型控制好,就能得到稳定的设备参数持久化机制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

保存配置数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通