Wio Terminal数据采集系统：模拟信号处理与SD卡存储实战

1. 项目概述：从传感器到屏幕与SD卡的数据之旅

最近在捣鼓一个环境监测的小玩意儿，核心是用Wio Terminal来采集一些模拟传感器的数据，比如光照强度、土壤湿度或者简单的电压变化，然后实时显示在屏幕上，同时把历史数据存到SD卡里，方便后续分析。这听起来像是一个典型的物联网数据终端原型，但真正动手做起来，你会发现从模拟信号读取、屏幕刷新到文件系统操作，每一步都有不少细节需要注意。Wio Terminal这块板子挺有意思，它集成了屏幕、按键、传感器接口和SD卡槽，几乎就是为了这种“感知-显示-记录”一体化的应用而生的。如果你正在寻找一个能快速搭建数据采集显示系统的硬件平台，或者对如何稳定处理模拟信号并兼顾实时性与存储可靠性有疑问，那这次的经验分享应该能给你一些直接的参考。

2. 硬件选型与核心思路解析

2.1 为什么是Wio Terminal？

选择Wio Terminal作为这个项目的核心，绝非偶然。市面上能跑Arduino的开发板很多，但像它这样“五脏俱全”的却不多见。其核心优势在于高度集成：

1. 显示部分：自带一块2.4英寸的LCD彩屏，分辨率320x240，驱动芯片是ILI9341。这意味着你不需要额外连接和调试屏幕，省去了接线和寻找兼容库的麻烦。
2. 存储扩展：板载一个MicroSD卡槽，支持SPI接口通信。对于数据记录项目，这是刚需。你可以直接将采集到的数据以文件形式（如CSV、TXT）写入SD卡，容量从几GB到几十GB，足以应对长时间的数据记录。
3. 模拟输入：提供了多个模拟输入引脚（A0~A8），分辨率是12位（0-4095对应0-3.3V）。这对于连接大多数模拟输出传感器（如光敏电阻、模拟土壤湿度传感器、电位器）来说完全够用。
4. 开发友好：基于ATSAMD51核心，兼容Arduino IDE和PlatformIO，生态成熟。同时，Seeed Studio提供了丰富的库和示例，极大降低了开发门槛。

这个项目的核心思路很清晰：在一个硬件上，实现数据的同步采集、实时可视化与异步可靠存储。这涉及到多任务协调——屏幕刷新不能影响数据采集的时序，文件写入操作不能阻塞主循环导致显示卡顿。因此，我们的方案设计需要围绕“分时处理”和“非阻塞”这两个关键词展开。

2.2 系统架构与数据流设计

在动手写代码前，先理清数据流和系统架构至关重要。一个糟糕的设计会导致数据丢失、显示闪烁或者存储文件损坏。

我的设计思路如下：

1. 数据采集层：在主循环中，以固定的时间间隔（例如每秒一次）读取模拟引脚的值。这里的关键是去抖动和滤波。模拟信号容易受到噪声干扰，简单的单次读取并不可靠。我通常会采用连续读取多次取中值或平均值的软件滤波方法。
2. 数据处理与显示层：读取到的原始ADC值（0-4095）需要根据传感器特性转换为有物理意义的单位（如勒克斯、百分比湿度、电压值）。转换后的数据，一部分立即送入显示模块。显示部分我设计为两个区域：一个区域用于显示当前实时数值（数字），另一个区域用于绘制历史数据曲线图，直观展示变化趋势。
3. 数据存储层：这是最容易出问题的环节。SD卡文件操作（打开、写入、关闭）相对较慢，且不能频繁进行。我的策略是缓存写入。不是在每次采集时都直接写文件，而是将数据先暂存在一个数组或队列中，当缓存达到一定数量（例如10条记录）时，再一次性写入SD卡。这能显著减少文件系统的操作次数，提高效率和稳定性。同时，每次上电时，程序会检查SD卡并创建一个带有时间戳的新文件，避免覆盖旧数据。

整个架构的核心是确保显示（实时性要求高）和存储（可靠性要求高）这两个任务互不干扰。通过状态机和缓存机制，让它们在主循环中“和谐共处”。

3. 核心细节解析与实操要点

3.1 模拟信号读取的稳定性处理

直接使用analogRead()函数读取Wio Terminal的模拟引脚，在大多数安静的电环境下或许可行，但在有电机、继电器或其他数字设备干扰时，读值可能会跳变。为了获得稳定的数据，软件滤波是必不可少的。

我常用的方法是移动平均滤波。它实现简单，效果显著。

// 定义滤波窗口大小 const int NUM_READINGS = 10; int readings[NUM_READINGS]; // 存储读值的数组 int readIndex = 0; // 当前读值索引 int total = 0; // 窗口内读值总和 int average = 0; // 平均值 void setup() { // 初始化数组 for (int thisReading = 0; thisReading < NUM_READINGS; thisReading++) { readings[thisReading] = 0; } } int readFilteredAnalog(int pin) { // 减去最早的读值，加上最新的读值 total = total - readings[readIndex]; readings[readIndex] = analogRead(pin); total = total + readings[readIndex]; // 移动到下一个位置 readIndex = readIndex + 1; if (readIndex >= NUM_READINGS) { readIndex = 0; } // 计算平均值 average = total / NUM_READINGS; return average; }

注意：窗口大小NUM_READINGS需要权衡。数值越大，滤波效果越好，但响应速度越慢（延迟增加）。对于缓慢变化的信号（如温度、湿度），取10-20次平均是合适的。对于快速变化的信号，可能需要减少到5次以内，或者改用中值滤波。

3.2 TFT屏幕驱动与高效刷新策略

Wio Terminal的屏幕使用TFT_eSPI库驱动，功能强大但使用不当极易导致屏幕闪烁或程序卡顿。

首先，正确的库配置是关键。你需要根据Wio Terminal修改TFT_eSPI库中的用户配置文件。通常，在Arduino IDE的库安装目录下找到TFT_eSPI文件夹，编辑User_Setup.h或User_Setup_Select.h文件，选择正确的驱动芯片和引脚定义（对于Wio Terminal，通常已有预配置）。

显示优化方面，有两大核心技巧：

1. 局部刷新，避免全屏清空：频繁调用tft.fillScreen(TFT_BLACK)会带来明显的闪烁。对于实时数值显示，我只在数值变化时，用背景色重写上一次数值的区域，然后再用新颜色绘制新数值。对于曲线图，我采用“滚动”绘制方式：不是重绘整条曲线，而是绘制最新的数据点，并将整个曲线图像向左平移一个像素，实现动态效果。
2. 将静态元素绘制放在setup()中：标题、坐标轴、固定标签等不变化的图形元素，只在程序启动时绘制一次。主循环中只处理动态变化的部分（数值和曲线）。这能大幅减少每帧的绘制工作量。

#include <TFT_eSPI.h> TFT_eSPI tft = TFT_eSPI(); // 在setup中绘制静态UI void setup() { tft.begin(); tft.setRotation(3); // 根据你的安装方向调整 tft.fillScreen(TFT_BLACK); tft.setTextColor(TFT_WHITE, TFT_BLACK); // 绘制标题 tft.drawString("Sensor Data Logger", 10, 10, 4); // 绘制数值标签 tft.drawString("Current Value:", 20, 60, 2); // 绘制坐标轴 tft.drawFastHLine(20, 180, 280, TFT_WHITE); // X轴 tft.drawFastVLine(20, 40, 140, TFT_WHITE); // Y轴 } // 在主循环中只更新动态部分 void loop() { int sensorValue = readFilteredAnalog(A0); // 只更新数值显示区域 tft.fillRect(150, 60, 100, 20, TFT_BLACK); // 清除旧值区域 tft.drawNumber(sensorValue, 150, 60, 2); // 绘制新值 // ... 更新曲线 }

3.3 SD卡文件系统的可靠操作

使用SD卡最常遇到的坑就是文件系统损坏和数据丢失。这通常是由于不当的写入时机或电源突然中断导致的。

首要原则：安全地打开和关闭文件。每次写入操作都打开和关闭文件是非常低效且危险的。我的做法是：

1. 在setup()中初始化并打开文件：检查SD卡是否存在，并创建一个以启动时间命名的唯一文件（例如DATA_20240515_143022.CSV）。
2. 使用缓存，批量写入：在主循环中，将数据追加到一个字符串缓冲区或结构体数组中。当数据条数达到缓存上限（比如10条），或者距离上次写入时间超过一定间隔（比如5秒），再将缓存中的所有数据一次性写入文件，并清空缓存。
3. 在loop()的每次迭代中检查写入条件，而不是在定时中断中。中断服务程序中执行文件操作是危险的，可能导致系统崩溃。
4. 重要：使用flush()和close()。在每次批量写入后，调用file.flush()确保数据从微控制器的缓冲区写入SD卡的物理扇区。在程序正常结束前（如果有这样的设计），务必调用file.close()。

#include <SD.h> File dataFile; String dataBuffer = ""; const int BUFFER_SIZE = 10; // 缓存10条数据后写入 int bufferCount = 0; void setup() { if (!SD.begin()) { tft.drawString("SD Card Fail!", 10, 200, 2); while (1); // 卡初始化失败，停止运行 } // 创建带时间戳的文件名 String filename = "/DATA_" + getTimestamp() + ".CSV"; dataFile = SD.open(filename, FILE_WRITE); if (dataFile) { dataFile.println("Timestamp, SensorValue"); // 写入表头 dataFile.flush(); } } void loop() { // ... 采集数据 sensorValue String dataLine = String(millis()) + "," + String(sensorValue); // 将数据加入缓存 dataBuffer += dataLine + "\n"; bufferCount++; // 检查缓存是否已满 if (bufferCount >= BUFFER_SIZE) { writeBufferToSD(); } // ... 其他处理 } void writeBufferToSD() { if (dataFile) { dataFile.print(dataBuffer); // 批量写入 dataFile.flush(); // 强制将数据写入物理介质 dataBuffer = ""; // 清空缓存 bufferCount = 0; } }

实操心得：SD卡对电源电压非常敏感。在由电池供电或使用电机等大电流设备时，务必确保SD卡供电稳定。一个大的电解电容（如100uF）并联在SD卡的VCC和GND之间，可以有效吸收电压波动，避免写入错误。

4. 完整代码实现与流程解析

下面我将一个简化但完整的核心流程串联起来。这个示例每秒读取一次A0引脚电压，在屏幕上显示实时值和最近30秒的趋势图，并每10条记录写入一次SD卡。

4.1 环境准备与库安装

在Arduino IDE中，你需要安装以下库（通过库管理器）：

• Seeed_Arduino_FS：Wio Terminal的文件系统抽象层。
• Seeed_Arduino_SFUD：串行Flash通用驱动，用于访问SD卡。
• TFT_eSPI：屏幕驱动库。安装后，需要按照前文所述配置用户设置文件。
• Free_Fonts.h（可选）：TFT_eSPI附带，用于更多字体。

在工具菜单中，选择开发板为 “Seeed Wio Terminal”，并选择正确的端口。

4.2 主程序结构与关键函数

#include <TFT_eSPI.h> #include <SD.h> #include <SPI.h> TFT_eSPI tft; // 模拟信号滤波相关 const int NUM_READINGS = 10; int readings[NUM_READINGS]; int readIndex = 0; long total = 0; int filteredValue = 0; // 显示相关 const int GRAPH_ORIGIN_X = 40; const int GRAPH_ORIGIN_Y = 80; const int GRAPH_WIDTH = 240; const int GRAPH_HEIGHT = 120; int graphData[GRAPH_WIDTH]; // 用于存储历史数据点（像素位置） int dataIndex = 0; // SD卡存储相关 File dataFile; String dataBuffer; const int BUFFER_LIMIT = 10; int bufferCounter = 0; void setup() { Serial.begin(115200); tft.begin(); tft.setRotation(3); tft.fillScreen(TFT_BLACK); initDisplay(); // 初始化显示静态元素 initSDCard(); // 初始化SD卡 initFilter(); // 初始化滤波数组 } void loop() { static unsigned long lastReadTime = 0; static unsigned long lastWriteCheck = 0; unsigned long currentMillis = millis(); // 任务1：定时读取传感器数据（每秒1次） if (currentMillis - lastReadTime >= 1000) { lastReadTime = currentMillis; int rawValue = analogRead(A0); filteredValue = updateMovingAverage(rawValue); // 滤波 float voltage = filteredValue * (3.3 / 4095.0); // 转换为电压 updateCurrentValueDisplay(voltage); // 更新屏幕数值显示 updateGraph(voltage); // 更新趋势图 // 准备存储数据 String timestamp = String(currentMillis / 1000); // 简化时间戳，单位秒 String dataLine = timestamp + "," + String(voltage, 3); // 保留3位小数 dataBuffer += dataLine + "\n"; bufferCounter++; } // 任务2：检查并执行SD卡写入（非阻塞检查） if (bufferCounter >= BUFFER_LIMIT) { writeDataBuffer(); } // 这里可以添加其他非阻塞任务，如按键检测 } // --- 功能函数实现 --- void initDisplay() { tft.setTextColor(TFT_WHITE, TFT_BLACK); tft.drawString("Wio Terminal Data Logger", 20, 10, 4); tft.drawString("Voltage (V):", 20, 50, 2); // 绘制图表框 tft.drawRect(GRAPH_ORIGIN_X - 1, GRAPH_ORIGIN_Y - 1, GRAPH_WIDTH + 2, GRAPH_HEIGHT + 2, TFT_WHITE); } void initSDCard() { pinMode(SDCARD_SS_PIN, OUTPUT); // Wio Terminal的SD卡片选引脚 digitalWrite(SDCARD_SS_PIN, HIGH); if (!SD.begin(SDCARD_SS_PIN)) { tft.drawString("SD Card Init FAIL", 20, 200, 2); Serial.println("SD Card Init FAIL"); return; } // 创建文件 String filename = "/LOG_" + String(millis()) + ".CSV"; dataFile = SD.open(filename.c_str(), FILE_WRITE); if (dataFile) { dataFile.println("Time(s),Voltage(V)"); dataFile.flush(); tft.drawString("Logging to SD...", 180, 200, 2); Serial.println("Logging to: " + filename); } else { Serial.println("Failed to open file!"); } } int updateMovingAverage(int newReading) { total = total - readings[readIndex]; readings[readIndex] = newReading; total = total + readings[readIndex]; readIndex = (readIndex + 1) % NUM_READINGS; return total / NUM_READINGS; } void updateCurrentValueDisplay(float val) { // 在固定位置清空旧值并绘制新值 tft.fillRect(150, 50, 100, 20, TFT_BLACK); tft.drawFloat(val, 3, 150, 50, 2); // 显示3位小数 } void updateGraph(float val) { // 将电压值映射到图表高度范围内 int graphY = GRAPH_ORIGIN_Y + GRAPH_HEIGHT - int((val / 3.3) * GRAPH_HEIGHT); graphY = constrain(graphY, GRAPH_ORIGIN_Y, GRAPH_ORIGIN_Y + GRAPH_HEIGHT); // 存储数据点（像素Y坐标） graphData[dataIndex] = graphY; // 绘制最新的线段 int xPos = GRAPH_ORIGIN_X + dataIndex; if (dataIndex > 0) { int prevX = GRAPH_ORIGIN_X + dataIndex - 1; tft.drawLine(prevX, graphData[dataIndex - 1], xPos, graphY, TFT_GREEN); } else { tft.drawPixel(xPos, graphY, TFT_GREEN); } // 移动索引，实现滚动效果 dataIndex++; if (dataIndex >= GRAPH_WIDTH) { // 当图表画满时，清空图表区域并重新开始 tft.fillRect(GRAPH_ORIGIN_X, GRAPH_ORIGIN_Y, GRAPH_WIDTH, GRAPH_HEIGHT, TFT_BLACK); tft.drawRect(GRAPH_ORIGIN_X - 1, GRAPH_ORIGIN_Y - 1, GRAPH_WIDTH + 2, GRAPH_HEIGHT + 2, TFT_WHITE); dataIndex = 0; } } void writeDataBuffer() { if (dataFile && dataBuffer.length() > 0) { dataFile.print(dataBuffer); dataFile.flush(); // 关键！确保数据写入物理存储 Serial.print("Wrote "); Serial.print(bufferCounter); Serial.println(" lines to SD."); } dataBuffer = ""; bufferCounter = 0; }

这个代码框架清晰地分离了数据采集、显示更新和存储逻辑。通过基于时间的状态判断 (millis()差值) 来执行不同任务，避免了使用delay()导致的阻塞，保证了系统的响应性。

5. 常见问题与排查技巧实录

在实际部署中，你几乎一定会遇到下面这些问题。这里是我踩过坑后总结的排查清单。

5.1 屏幕无显示或花屏

实操心得：如果屏幕初始化一直失败，尝试在setup()最开始加一个短暂的延时delay(500)。有时屏幕电源需要一点时间稳定，微控制器过快地发送初始化命令会导致失败。

5.2 SD卡无法识别或写入失败

5.3 模拟数据读数不稳定

5.4 系统整体运行卡顿

如果感觉显示刷新慢，或者按键响应迟钝，多半是主循环被某个耗时任务阻塞了。

排查思路：

1. 检查所有delay()：主循环中绝对避免使用长延时delay()。所有定时操作都应改用millis()进行非阻塞判断。
2. 优化SD卡写入：这是最可能的瓶颈。确保你使用的是缓存批量写入，而不是每次采样都写文件。将BUFFER_LIMIT适当调大（比如20或30），可以显著改善卡顿。
3. 简化图形绘制：检查updateGraph()函数。如果图表宽度GRAPH_WIDTH很大，并且每次都在重绘整条线段，会非常耗时。我提供的滚动绘图法只绘制最新的一段线段，效率很高。
4. 使用串口输出调试：在循环的不同阶段输出时间戳，可以精确找到是哪个环节耗时最长。

最后，分享一个我调试时的小技巧：在代码中定义一个调试标志，通过串口输出关键变量的值和函数执行时间。这能帮你直观地理解程序的运行状态，快速定位性能瓶颈或逻辑错误。硬件项目就是这样，理论和实践之间总有些沟壑，耐心调试和记录每一个发现，这些经验会比最终的成果更有价值。