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

记录采样数据

记录采样数据

本节把周期采样的数据真正落到 ESP32 的文件系统中:每条记录同时保存时间戳和传感器值,并在重启后重新读出。示例使用 LittleFS,避免额外接线;掌握记录格式、写入节奏和验证方法后,同样可以迁移到 SD 卡。

学习目标

  • 设计包含时间信息与采样值的简洁记录格式。
  • 使用 LittleFS 追加保存采样数据,并避免重复写入表头。
  • 通过串口回读文件,验证数据确实已经持久化。

设计记录格式

传感器日志最少需要回答两个问题:什么时候采的,以及采到了什么。本例使用 CSV,每行包含 elapsed_ms 和 adc_raw。elapsed_ms 来自 millis(),表示本次启动后的毫秒数;它适合分析采样间隔,但不能表示真实日期时间。

采样数据从传感器写入 LittleFS 的数据流

如果日志需要跨重启按真实时间排序,应先通过 NTP 或 RTC 得到 Unix 时间,再把 elapsed_ms 换成真实时间戳。不要把 millis() 误当成日期时间,因为设备复位后它会重新从零开始。

写入 LittleFS

下面示例按经典 ESP32 开发板使用 GPIO 34 作为 ADC 输入;如果你的板型没有该引脚,请替换为本板可用的 ADC 引脚。程序启动时挂载 LittleFS、创建表头、回读已有内容,然后每秒追加一条记录。

cpp
#include <Arduino.h>
#include <LittleFS.h>

constexpr int ADC_PIN = 34;
constexpr uint32_t SAMPLE_INTERVAL_MS = 1000;

uint32_t lastSampleMs = 0;

void dumpLog() {
  File file = LittleFS.open("/samples.csv", FILE_READ);
  if (!file) {
    Serial.println("Cannot open log for reading");
    return;
  }

  while (file.available()) {
    Serial.write(file.read());
  }
  file.close();
}

bool ensureLogFile() {
  if (LittleFS.exists("/samples.csv")) {
    return true;
  }

  File file = LittleFS.open("/samples.csv", FILE_WRITE);
  if (!file) {
    return false;
  }

  file.println("elapsed_ms,adc_raw");
  file.close();
  return true;
}

void appendSample(uint32_t elapsedMs, int raw) {
  File file = LittleFS.open("/samples.csv", FILE_APPEND);
  if (!file) {
    Serial.println("Cannot open log for append");
    return;
  }

  file.printf("%lu,%d\n", static_cast<unsigned long>(elapsedMs), raw);
  file.close();
}

void setup() {
  Serial.begin(115200);
  delay(500);

  if (!LittleFS.begin(true)) {
    Serial.println("LittleFS mount failed");
    return;
  }

  if (!ensureLogFile()) {
    Serial.println("Cannot create log file");
    return;
  }

  Serial.println("LittleFS ready, current log:");
  dumpLog();
}

void loop() {
  const uint32_t now = millis();

  // 无符号差值写法在 millis() 回绕时仍能正确判断周期。
  if (now - lastSampleMs < SAMPLE_INTERVAL_MS) {
    return;
  }
  lastSampleMs = now;

  const int raw = analogRead(ADC_PIN);
  appendSample(now, raw);
  Serial.printf("%lu,%d\n", static_cast<unsigned long>(now), raw);
}

预期输出

text
LittleFS ready, current log:
elapsed_ms,adc_raw
1000,<VALUE>
2000,<VALUE>
3000,<VALUE>

<VALUE> 取决于传感器和输入电压。第一次启动时只会回读表头;运行几秒后复位,程序会先打印之前保存的记录,再继续追加新数据,因此可以确认文件没有因重启而丢失。

控制写入频率与文件增长

每次采样都打开、追加并关闭文件,逻辑简单且掉电时丢失的数据较少,但高频写入会增加闪存擦写压力。温湿度、光照等秒级或分钟级采样通常可以直接使用;如果达到几十赫兹甚至更高,应该先在内存中缓存多条记录,再批量写入。

还要给日志设置容量策略。长期运行时可以按日期或文件大小轮转,或者只保留最近若干个文件;否则即使程序一直正常,最终也会因为 LittleFS 空间耗尽而无法继续追加。

什么时候改用 SD 卡

LittleFS 适合配置、少量事件和低频采样日志,优点是无需外接硬件。连续记录大量数据时,SD 卡容量更大,也便于把文件直接拿到电脑分析。迁移时记录格式和采样逻辑可以保持不变,只需把文件打开、写入和读取部分替换为 SD 库对应 API。

无论使用哪种介质,可靠记录的关键都不是“能写进去”这一点,而是让时间语义、追加方式、容量上限和重启后的验证都明确可检查。

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

目录与阅读设置

阅读设置

17

记录一个想法

记录采样数据

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

登录哪都通