单片机与物联网 / 系统课时
记录采样数据
记录采样数据
本节把周期采样的数据真正落到 ESP32 的文件系统中:每条记录同时保存时间戳和传感器值,并在重启后重新读出。示例使用 LittleFS,避免额外接线;掌握记录格式、写入节奏和验证方法后,同样可以迁移到 SD 卡。
学习目标
- 设计包含时间信息与采样值的简洁记录格式。
- 使用 LittleFS 追加保存采样数据,并避免重复写入表头。
- 通过串口回读文件,验证数据确实已经持久化。
设计记录格式
传感器日志最少需要回答两个问题:什么时候采的,以及采到了什么。本例使用 CSV,每行包含 elapsed_ms 和 adc_raw。elapsed_ms 来自 millis(),表示本次启动后的毫秒数;它适合分析采样间隔,但不能表示真实日期时间。

如果日志需要跨重启按真实时间排序,应先通过 NTP 或 RTC 得到 Unix 时间,再把 elapsed_ms 换成真实时间戳。不要把 millis() 误当成日期时间,因为设备复位后它会重新从零开始。
写入 LittleFS
下面示例按经典 ESP32 开发板使用 GPIO 34 作为 ADC 输入;如果你的板型没有该引脚,请替换为本板可用的 ADC 引脚。程序启动时挂载 LittleFS、创建表头、回读已有内容,然后每秒追加一条记录。
#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);
}预期输出
LittleFS ready, current log:
elapsed_ms,adc_raw
1000,<VALUE>
2000,<VALUE>
3000,<VALUE><VALUE> 取决于传感器和输入电压。第一次启动时只会回读表头;运行几秒后复位,程序会先打印之前保存的记录,再继续追加新数据,因此可以确认文件没有因重启而丢失。
控制写入频率与文件增长
每次采样都打开、追加并关闭文件,逻辑简单且掉电时丢失的数据较少,但高频写入会增加闪存擦写压力。温湿度、光照等秒级或分钟级采样通常可以直接使用;如果达到几十赫兹甚至更高,应该先在内存中缓存多条记录,再批量写入。
还要给日志设置容量策略。长期运行时可以按日期或文件大小轮转,或者只保留最近若干个文件;否则即使程序一直正常,最终也会因为 LittleFS 空间耗尽而无法继续追加。
什么时候改用 SD 卡
LittleFS 适合配置、少量事件和低频采样日志,优点是无需外接硬件。连续记录大量数据时,SD 卡容量更大,也便于把文件直接拿到电脑分析。迁移时记录格式和采样逻辑可以保持不变,只需把文件打开、写入和读取部分替换为 SD 库对应 API。
无论使用哪种介质,可靠记录的关键都不是“能写进去”这一点,而是让时间语义、追加方式、容量上限和重启后的验证都明确可检查。