Arduino实战：Xadow加速度计数据采集、滤波与OLED波形显示-开发者社区

1. 项目概述：从零开始玩转Xadow加速度检测器

如果你手头有一块Xadow加速度检测器模块，正琢磨着怎么让它动起来，把那些看不见的加速度数据变成屏幕上跳动的数字或者触发一些好玩的动作，那你来对地方了。这个项目就是带你一步步搞定它。Xadow是Seeed Studio推出的一套模块化电子积木系统，接口统一，用起来像拼乐高一样方便。我们今天的主角——加速度检测器，本质上就是一个三轴加速度计，它能感知物体在X、Y、Z三个方向上的运动变化，无论是静止时的重力分量，还是晃动、跌落时的动态加速度，都能被它捕捉到。

这东西能干嘛？想象一下，你可以用它做个计步器，揣在口袋里记录步数；或者做个姿态感应器，控制屏幕上的物体随着你的手势翻转；再进阶一点，配合振动马达做个防丢报警器，设备一被移动就“嗡嗡”响。它的核心就是通过I2C或SPI这类数字接口，把模拟世界的物理运动，翻译成微控制器（比如Arduino）能读懂的数值。整个过程涉及硬件连接、库函数调用、数据读取、滤波处理以及最终的应用呈现（比如在OLED上显示）。对于刚接触传感器和Arduino的朋友来说，这是一个绝佳的入门项目，既有明确的物理意义，又能快速看到交互效果。而对于有经验的开发者，如何优化数据、降低噪声、实现精准的姿态解算，则是更深层次的挑战。接下来，我就以最常用的Arduino Uno开发板和一块0.96英寸OLED屏幕为例，带你从开箱到实现一个实时加速度波形显示器。

2. 核心硬件与连接解析

2.1 认识你的Xadow加速度检测器模块

拿到模块，首先得认清引脚。大多数Xadow加速度计模块（例如基于ADXL345或MPU6050芯片）都采用Xadow标准的Grove兼容接口，但内部通信协议通常是I2C。这意味着你需要连接四根线：电源（VCC）、地（GND）、串行时钟线（SCL）和串行数据线（SDA）。有些模块可能还留有中断引脚，用于触发紧急事件，但基础数据读取用不上。关键是要查看模块的说明书或丝印，确认其工作电压。常见的有3.3V和5V逻辑电平，虽然Xadow接口设计上考虑了兼容性，但为稳妥起见，最好用万用表量一下VCC引脚电压，或者查阅资料。用5V Arduino（如Uno）驱动3.3V传感器，长期可能损坏传感器；反之，则可能无法正确读取数据。

注意：在连接任何传感器前，务必断开电源。先接GND，再接VCC，最后接信号线，这是一个好习惯，能避免因电势差导致的意外短路。

2.2 硬件连接实战：构建最小系统

我们的目标是构建一个“Arduino Uno + Xadow加速度计 + OLED屏幕”的最小系统。这里假设你的OLED屏幕也是I2C接口的，这非常常见。这就引出一个关键问题：Arduino Uno的I2C引脚（A4-SDA, A5-SCL）只有一组，如何连接两个I2C设备？答案是：并联。I2C总线支持多设备，每个设备有唯一的地址，主设备（Arduino）通过地址来区分它们。

具体接线如下：

电源部分：将Arduino Uno的5V引脚连接到面包板的正极排，GND连接到负极排。然后将Xadow模块的VCC和GND分别连接到正、负极排。同样，OLED的VCC和GND也如此连接。务必确认你的模块支持5V输入，如果只支持3.3V，则需要从Arduino的3.3V引脚取电，或者使用电平转换模块。
信号线部分：这是核心。将Arduino的A4（SDA）引脚，用杜邦线同时连接到Xadow模块的SDA引脚和OLED屏幕的SDA引脚。同理，将Arduino的A5（SCL）引脚，同时连接到两个设备的SCL引脚。这样，两条总线就搭建好了。
地址冲突检查：I2C设备必须有不同地址。通常，ADXL345加速度计的默认地址是0x53（或0x1D，取决于ALT ADDRESS引脚），而常见的SSD1306 OLED屏幕地址是0x3C。它们一般不会冲突。但如果你用的设备地址相同，就需要通过修改硬件（如焊接地址选择电阻）或软件来改变其中一个的地址。

连接好后，硬件部分就准备好了。一个整洁的布线有助于后续调试。你可以先用简单的I2C扫描程序（Arduino IDE示例里有）上传到板子，打开串口监视器，看看是否能正确扫描到两个设备的地址，这是验证硬件连接是否成功的第一步。

3. 软件环境搭建与库安装

3.1 Arduino IDE基础配置与必备库

硬件就绪后，我们需要让软件认识它们。首先确保你安装了最新版的Arduino IDE（1.8.x或2.0+均可）。对于Xadow模块，Seeed Studio通常提供了对应的Arduino库，这大大简化了开发。我们需要安装两个核心库：加速度计驱动库和OLED显示库。

以常见的ADXL345加速度计和SSD1306 OLED为例：

安装加速度计库：打开Arduino IDE，点击“工具” -> “管理库…”。在库管理器中搜索“ADXL345”。你会看到多个结果，选择由Seeed Studio维护的或者通用的“Adafruit ADXL345”库（Adafruit的库通常质量很高）。点击安装。这个库封装了与ADXL345芯片通信的所有底层细节，你只需要调用简单的函数如readXYZ()就能获取数据。
安装OLED显示库：同样在库管理器中搜索“SSD1306”或“Adafruit SSD1306”。安装Adafruit SSD1306库。注意，这个库依赖于Adafruit GFX图形库，库管理器通常会提示你一并安装，务必确认安装。GFX库提供了画点、线、圆、文字等基本图形功能。
安装依赖库：上述Adafruit的库通常还依赖于“Adafruit BusIO”库，用于处理I2C/SPI通信。如果安装过程中有提示或后续编译报错找不到相关头文件，记得也搜索安装这个库。

实操心得：库的版本有时会导致兼容性问题。如果遇到编译错误，可以尝试在库管理器中查看已安装库的版本，或者到GitHub上查看库的说明文档和Issue。对于新手，我建议先使用库管理器安装的稳定版，而不是直接从GitHub下载最新的开发版。

3.2 编写第一个测试程序：读取原始数据

库安装好后，我们来写一个最简单的程序，验证传感器是否工作，并把原始数据打印到串口。这个步骤至关重要，是后续所有高级应用的基础。

#include <Wire.h> // Arduino I2C库，必须包含 #include <Adafruit_Sensor.h> // Adafruit传感器抽象层，某些库需要 #include <Adafruit_ADXL345_U.h> // 我们安装的ADXL345库 // 创建一个传感器对象，使用I2C总线 Adafruit_ADXL345_Unified accel = Adafruit_ADXL345_Unified(12345); // 参数是传感器ID，可任意 void setup() { Serial.begin(9600); // 初始化串口通信，波特率9600 Serial.println("ADXL345加速度计测试"); // 尝试初始化传感器 if(!accel.begin()) { Serial.println("未检测到ADXL345传感器，请检查连接！"); while(1); // 初始化失败，程序停在这里 } // 设置传感器的量程，可选2G, 4G, 8G, 16G。量程越大，分辨率越低，但能测的加速度越大。 accel.setRange(ADXL345_RANGE_16_G); Serial.print("量程设置为: "); switch(accel.getRange()) { case ADXL345_RANGE_2_G: Serial.println("+-2G"); break; case ADXL345_RANGE_4_G: Serial.println("+-4G"); break; case ADXL345_RANGE_8_G: Serial.println("+-8G"); break; case ADXL345_RANGE_16_G: Serial.println("+-16G"); break; } } void loop() { // 获取一个传感器事件（包含X,Y,Z数据） sensors_event_t event; accel.getEvent(&event); // 将数据打印到串口监视器 Serial.print("X: "); Serial.print(event.acceleration.x); Serial.print(" "); Serial.print("Y: "); Serial.print(event.acceleration.y); Serial.print(" "); Serial.print("Z: "); Serial.print(event.acceleration.z); Serial.print(" "); Serial.println("m/s^2"); delay(100); // 延时100毫秒，控制数据输出频率 }

将代码上传到Arduino Uno。打开串口监视器（右上角放大镜图标），将波特率设置为9600。如果一切正常，你会看到每秒10组“X: xx.xx Y: yy.yy Z: zz.zz m/s^2”格式的数据流。把模块平放在桌面上，Z轴应该接近9.8 m/s²（重力加速度），X和Y轴接近0。轻轻晃动模块，数值会相应变化。这个测试成功，意味着你的传感器硬件、连接和基础驱动都是OK的。

4. 核心数据处理与滤波算法

4.1 理解原始数据：从ADC值到物理量

串口打印出来的已经是库函数帮我们转换好的、以m/s²为单位的物理值。但了解其背后的转换过程有助于调试和理解误差。传感器内部的核心是一个微机电系统（MEMS），加速度会导致内部微结构电容变化，进而被转化为电压，再经过模数转换器（ADC）变成数字值。库函数getEvent()帮你完成了这两步：1. 通过I2C读取ADC原始值（一个整数）；2. 根据你设置的量程和传感器的灵敏度（LSB/g），将这个整数转换为加速度值。

例如，设置量程为±16g，灵敏度可能是256 LSB/g（具体查芯片手册）。这意味着每1g的重力加速度，ADC会输出256个数字单位。如果读到的Z轴原始值是2560，那么对应的加速度就是2560 / 256 = 10 g，再乘以重力常数9.8，就是98 m/s²。库函数隐藏了这些细节，但在需要高性能或自定义处理时，你可以直接读取原始值进行计算。

4.2 噪声过滤与数据平滑实战

直接从传感器读出的数据往往是“毛躁”的，包含高频噪声。直接使用这样的数据会导致显示跳动、阈值判断不稳定。因此，滤波是必须的。对于实时性要求高的嵌入式系统，移动平均滤波和低通滤波是最简单有效的方法。

移动平均滤波：取最近N次采样值的算术平均值作为当前输出。N越大，曲线越平滑，但响应延迟也越大。

#define FILTER_N 10 // 滤波窗口大小 float xBuffer[FILTER_N], yBuffer[FILTER_N], zBuffer[FILTER_N]; int bufferIndex = 0; float filteredX = 0, filteredY = 0, filteredZ = 0; void applyMovingAverage(sensors_event_t event) { // 移除旧数据，加入新数据 filteredX -= xBuffer[bufferIndex] / FILTER_N; filteredY -= yBuffer[bufferIndex] / FILTER_N; filteredZ -= zBuffer[bufferIndex] / FILTER_N; xBuffer[bufferIndex] = event.acceleration.x; yBuffer[bufferIndex] = event.acceleration.y; zBuffer[bufferIndex] = event.acceleration.z; filteredX += xBuffer[bufferIndex] / FILTER_N; filteredY += yBuffer[bufferIndex] / FILTER_N; filteredZ += zBuffer[bufferIndex] / FILTER_N; bufferIndex = (bufferIndex + 1) % FILTER_N; // 循环覆盖缓冲区 }

在loop()中，先调用applyMovingAverage(event)，然后使用filteredX, filteredY, filteredZ进行后续处理。

一阶低通滤波（指数加权平均）：这种方法计算量更小，更适合资源紧张的场合。公式为：当前输出 = α * 当前输入 + (1-α) * 上一次输出。α是滤波系数（0<α≤1），α越大，对新数据响应越快，但平滑效果越差；α越小，越平滑，但延迟越大。

float alpha = 0.2; // 滤波系数，根据实际情况调整 float lpfX = 0, lpfY = 0, lpfZ = 0; void applyLowPassFilter(sensors_event_t event) { lpfX = alpha * event.acceleration.x + (1 - alpha) * lpfX; lpfY = alpha * event.acceleration.y + (1 - alpha) * lpfY; lpfZ = alpha * event.acceleration.z + (1 - alpha) * lpfZ; }

注意事项：选择滤波算法和参数是一个权衡。对于计步器，你需要检测快速的冲击信号，α值可以大一些（如0.5），或者使用移动平均配合较小的窗口（N=5）。对于显示平滑波形，α可以小一些（如0.1）。最好的方法是在串口绘图器（工具->串口绘图器）里观察原始数据和滤波后数据的曲线，直观地调整参数。

5. OLED屏幕显示系统实现

5.1 初始化与基础图形绘制

数据处理好后，我们要把它展示出来。OLED屏幕显示需要用到之前安装的Adafruit SSD1306和GFX库。首先在代码开头包含它们并初始化对象。

#include <Adafruit_GFX.h> #include <Adafruit_SSD1306.h> #define SCREEN_WIDTH 128 // OLED显示宽度，像素 #define SCREEN_HEIGHT 64 // OLED显示高度，像素 #define OLED_RESET -1 // 重置引脚，如果共享Arduino复位引脚则填-1 // 创建OLED对象，参数：宽度，高度，I2C指针，复位引脚 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET); void setup() { // ... 之前的串口、传感器初始化代码 ... // 初始化OLED，I2C地址一般为0x3C或0x3D if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(F("SSD1306分配失败")); for(;;); // 死循环，阻止程序继续 } display.display(); // 显示Adafruit的启动Logo delay(2000); display.clearDisplay(); // 清屏 }

初始化成功后，就可以使用GFX库丰富的函数进行绘制了。基础操作包括：

display.setTextSize(n): 设置文字大小。
display.setTextColor(WHITE): 设置文字颜色（单色OLED通常是白色）。
display.setCursor(x, y): 设置文本起始坐标（左上角为0,0）。
display.print(“text”)或display.println(variable): 打印文本或变量。
display.drawLine(x0, y0, x1, y1, WHITE): 画线。
display.display():最重要，所有绘制命令都在内存中，必须调用此函数才能更新到屏幕。

5.2 设计并实现实时波形显示界面

我们要实现一个经典的示波器式波形显示：屏幕左侧显示实时的X/Y/Z加速度数值，右侧用滚动波形图展示加速度随时间的变化。

首先，规划屏幕布局。将屏幕垂直分为两部分：左侧1/3区域用于显示数字，右侧2/3区域用于绘制波形。波形绘制采用“滚动”方式：新数据点从右侧加入，所有旧数据点向左移动一个像素。

// 全局变量定义 #define GRAPH_START_X 45 // 波形区起始X坐标 #define GRAPH_WIDTH (SCREEN_WIDTH - GRAPH_START_X) // 波形区宽度 int graphXHistory[GRAPH_WIDTH]; // 存储X轴加速度对应的Y坐标历史 int graphYHistory[GRAPH_WIDTH]; int graphZHistory[GRAPH_WIDTH]; void drawWaveform(float xVal, float yVal, float zVal) { // 1. 清空旧波形区域（只清右侧图形区，避免整个屏幕闪烁） display.fillRect(GRAPH_START_X, 0, GRAPH_WIDTH, SCREEN_HEIGHT, BLACK); // 2. 将新的物理值映射为屏幕Y坐标。假设量程为±20 m/s²，屏幕顶部为-20，底部为+20。 // 屏幕Y坐标从上到下增加，所以是反向映射。 int newY_X = map(constrain(xVal, -20, 20), -20, 20, SCREEN_HEIGHT-1, 0); int newY_Y = map(constrain(yVal, -20, 20), -20, 20, SCREEN_HEIGHT-1, 0); int newY_Z = map(constrain(zVal, -20, 20), -20, 20, SCREEN_HEIGHT-1, 0); // 3. 历史数据左移 for (int i=0; i < GRAPH_WIDTH-1; i++) { graphXHistory[i] = graphXHistory[i+1]; graphYHistory[i] = graphYHistory[i+1]; graphZHistory[i] = graphZHistory[i+1]; } // 将新数据点放入数组末尾 graphXHistory[GRAPH_WIDTH-1] = newY_X; graphYHistory[GRAPH_WIDTH-1] = newY_Y; graphZHistory[GRAPH_WIDTH-1] = newY_Z; // 4. 绘制三条波形线 for (int i=0; i < GRAPH_WIDTH-1; i++) { // 绘制X轴数据线（白色） display.drawLine(GRAPH_START_X+i, graphXHistory[i], GRAPH_START_X+i+1, graphXHistory[i+1], WHITE); // 绘制Y轴数据线（为了区分，可以用画点或其他方式，这里简单用画线） // 实际中可以只用一条线，或通过不同颜色区分（如果OLED支持） // display.drawLine(GRAPH_START_X+i, graphYHistory[i], GRAPH_START_X+i+1, graphYHistory[i+1], WHITE); // 同理绘制Z... } // 5. 在左侧区域绘制实时数值 display.setTextSize(1); display.setTextColor(WHITE); display.setCursor(0, 0); display.print(“X:”); display.println(xVal, 1); // 显示1位小数 display.print(“Y:”); display.println(yVal, 1); display.print(“Z:”); display.println(zVal, 1); // 可以再加一个合加速度 sqrt(x*x + y*y + z*z) float total = sqrt(xVal*xVal + yVal*yVal + zVal*zVal); display.print(“T:”); display.println(total, 1); // 6. 更新屏幕 display.display(); }

在loop()函数中，读取并滤波传感器数据后，调用drawWaveform(filteredX, filteredY, filteredZ)即可。为了控制波形刷新速度，可以在loop末尾加一个固定的delay(50)，这样每秒刷新约20帧，既能保证流畅度，又不会给处理器太大负担。

实操心得：直接调用display.clearDisplay()和display.display()全屏刷新会导致明显的闪烁。优化方法是只刷新需要改变的区域，就像上面代码中只清除右侧图形区一样。另外，map()和constrain()函数在嵌入式图形编程中非常常用，前者进行数值映射，后者将数值限制在范围内，防止绘图越界导致程序崩溃。

6. 高级应用：姿态判断与事件触发

6.1 实现简单的姿态识别（水平/倾斜）

加速度计一个最基本的应用就是检测模块的静态姿态。当模块静止时，加速度计测到的主要是重力加速度分量。通过分析三个轴上的重力分量比例，可以判断模块的朝向。

例如，判断模块是否水平（Z轴朝上）：

bool isLevel(float x, float y, float z, float threshold) { // 水平时，X和Y轴重力分量接近0，Z轴接近9.8或-9.8（取决于正反） // 计算X、Y轴的合成倾斜加速度 float tilt = sqrt(x*x + y*y); // 如果倾斜度小于阈值，则认为水平 return (tilt < threshold); }

判断模块是否垂直（比如Y轴朝上）：

bool isVerticalYUp(float x, float y, float z, float threshold) { // 垂直且Y轴朝上时，Y轴接近9.8，X和Z接近0 return (abs(y - 9.8) < threshold && abs(x) < threshold && abs(z) < threshold); }

这里的threshold是一个容错阈值，因为传感器有噪声，且完全精确的姿态很难达到。通常可以设为0.5到1.5 m/s²。你可以在OLED上显示一个简单的图标或文字来指示当前姿态。

6.2 振动检测与报警触发

另一个常见应用是检测振动或撞击。这需要通过计算合加速度，并观察其是否超过一个动态阈值。

#define IMPACT_THRESHOLD 15.0 // 撞击阈值，单位 m/s²，需要根据实验调整 #define VIBRATION_TIMEOUT 500 // 振动事件后，500ms内不再重复触发 unsigned long lastVibrationTime = 0; void checkVibration(float x, float y, float z) { float totalAccel = sqrt(x*x + y*y + z*z); unsigned long currentTime = millis(); // 如果合加速度超过阈值，且距离上次触发已超过静默时间 if (totalAccel > IMPACT_THRESHOLD && (currentTime - lastVibrationTime) > VIBRATION_TIMEOUT) { lastVibrationTime = currentTime; triggerAlarm(); // 触发报警函数 Serial.println(“检测到撞击或强烈振动！”); } } void triggerAlarm() { // 这里可以控制一个蜂鸣器响，或者让一个LED闪烁 // 例如：digitalWrite(BUZZER_PIN, HIGH); delay(100); digitalWrite(BUZZER_PIN, LOW); }

这个checkVibration函数可以放在loop里，每次读取数据后调用。阈值IMPACT_THRESHOLD需要根据你的应用场景实测调整：轻轻敲击桌面和用力摔打设备，产生的合加速度差异很大。VIBRATION_TIMEOUT用于去抖，防止一次振动事件被误判为多次。

更进一步，你可以实现一个计步器算法。计步的核心是检测周期性出现的、超过阈值的加速度峰值。算法通常包括：带通滤波（只保留人体步行频率范围内的信号）、寻找波峰、设置波峰间的最小时间间隔（防止一步被算成多步）。这是一个更复杂的信号处理话题，但基于我们已有的滤波和阈值检测基础，你已经具备了实现的起点。

7. 系统优化与深度调试技巧

7.1 功耗优化与采样率调整

如果你的项目需要电池供电，功耗就是关键。加速度计本身有不同的工作模式。以ADXL345为例：

测量模式：全功耗，全速采样。
待机模式：低功耗，不进行测量。
睡眠模式：功耗更低，唤醒时间稍长。

通过库函数，你可以动态切换模式。例如，一个环境监测设备可能每10秒才需要采样一次，那么在其他时间可以将传感器设置为待机模式。

// 进入待机模式 accel.writeRegister(ADXL345_REG_POWER_CTL, 0x00); // 唤醒并进入测量模式 accel.writeRegister(ADXL345_REG_POWER_CTL, 0x08);

此外，降低采样率也能显著省电。ADXL345支持从0.1Hz到3200Hz的多种输出数据速率（ODR）。在setup中初始化后，可以通过库函数或直接写寄存器来设置更低的速率，比如1Hz。

// 设置数据速率为1Hz (带宽0.5Hz) accel.setDataRate(ADXL345_DATARATE_1_HZ);

对于Arduino主控，在loop中尽量使用delay()而非忙等待，并考虑在长时间空闲时让Arduino自己也进入睡眠模式（需要额外的库支持，如LowPower）。

7.2 校准与精度提升实战

没有传感器是绝对完美的，通常存在零点偏移和灵敏度误差。校准的目的就是补偿这些系统误差。一个简单的静态零点校准方法是：将传感器静止在水平位置，采集一段时间（如5秒）内X、Y、Z轴的数据并求平均，得到的平均值就是各轴的零点偏移量（Offset）。在后续所有读数中，减去这个偏移量。

float offsetX = 0, offsetY = 0, offsetZ = 0; void calibrateSensor(int samples) { float sumX=0, sumY=0, sumZ=0; for(int i=0; i<samples; i++) { sensors_event_t event; accel.getEvent(&event); sumX += event.acceleration.x; sumY += event.acceleration.y; sumZ += event.acceleration.z; delay(10); } offsetX = sumX / samples; offsetY = sumY / samples; offsetZ = sumZ / samples; Serial.print(“校准偏移量 - X:”);Serial.print(offsetX);Serial.print(“ Y:”);Serial.print(offsetY);Serial.print(“ Z:”);Serial.println(offsetZ); } // 在setup中，初始化传感器后调用一次 calibrateSensor(500); // 读取数据后，使用 event.acceleration.x - offsetX 得到校准后数据

灵敏度校准需要已知的精确加速度输入（如精确的1g重力场），对于多数创客项目，零点校准已能大幅提升静态精度。此外，确保传感器安装牢固，避免因外壳或线缆振动引入额外噪声。电路板上尽量远离电机、电源等噪声源。

8. 常见问题排查与解决方案实录

在实际操作中，你几乎一定会遇到下面这些问题。这里我把它们和解决方案整理出来，希望能帮你快速排雷。

问题现象	可能原因	排查步骤与解决方案
串口无数据输出或提示“未检测到传感器”	1. 电源接错或电压不匹配。 2. I2C线（SDA, SCL）接反或接触不良。 3. I2C地址不正确。 4. 库不兼容或损坏。	1. 用万用表检查VCC和GND间电压是否为预期值（3.3V或5V）。 2. 交换SDA和SCL试试，并确保杜邦线插紧。 3. 运行I2C扫描示例程序，查看扫描到的地址。根据地址修改代码中的设备地址（如`accel.begin(0x53)`）。 4. 尝试卸载重装库，或换用另一个库（如通用`Wire`库直接读写寄存器）。
OLED屏幕不亮或白屏	1. 电源或I2C线连接问题。 2. I2C地址错误。 3. 初始化失败或复位引脚配置错误。 4. 屏幕本身损坏。	1. 同传感器，检查电源和连线。 2. 常见地址是0x3C或0x3D，在初始化`display.begin()`中尝试更改。 3. 确认`OLED_RESET`引脚定义是否正确。如果屏幕无复位引脚，使用`-1`。 4. 运行Adafruit SSD1306库中的示例代码`ssd1306_128x64_i2c`进行最简测试。
加速度数据跳动（噪声）非常大	1. 传感器未固定牢固，受环境振动影响。 2. 电源噪声大。 3. 未进行软件滤波。 4. 量程设置过小，导致数据饱和。	1. 将模块用胶带或螺丝固定在稳固的基板上。 2. 在传感器电源引脚附近并联一个0.1uF的陶瓷电容到地，进行去耦。 3. 务必应用本章第4节介绍的移动平均或低通滤波算法。 4. 尝试使用更大的量程（如16G），虽然分辨率下降，但能避免饱和失真。
波形显示闪烁严重	1. 全屏刷新导致。 2.`loop`循环周期不稳定，刷新过快或过慢。	1. 采用局部刷新策略，只重绘数据变化的区域，如`drawWaveform`函数所示。 2. 在`loop`末尾使用固定的`delay()`来控制帧率，如`delay(30)`实现约30FPS。避免使用`millis()`做复杂定时，除非你熟悉非阻塞编程。
姿态判断不准确	1. 零点偏移未校准。 2. 阈值设置不合理。 3. 模块非绝对静止时进行判断。	1. 执行第7.2节的校准程序，获取准确的零点偏移量。 2. 通过串口打印静止时的各轴数据，观察波动范围，将阈值设置为波动范围的2-3倍。 3. 在判断姿态前，先判断模块是否处于静止状态（合加速度接近9.8且变化很小）。
程序运行一段时间后死机	1. 内存泄漏（动态内存分配导致）。 2. 数组越界。 3. 库函数冲突或硬件中断问题。	1. 避免在`loop`中频繁使用`String`类或`malloc`。 2. 检查所有数组访问索引是否可能超出范围，特别是波形历史数组。 3. 简化程序，逐步添加功能，定位问题代码段。检查是否同时使用了可能冲突中断的库（如某些软件串口库）。

最后，分享一个我调试时的小技巧：善用Arduino IDE的串口绘图器。它不仅能看到波形，还能同时绘制多个通道的数据。将滤波前和滤波后的数据一起发送绘图，能非常直观地看到滤波效果，帮助你快速调整滤波参数。发送格式为用逗号或制表符分隔的数据行，例如：Serial.print(rawX); Serial.print(“,”); Serial.println(filteredX);。这个小工具能极大提升你的调试效率。