Arduino超声波水位监测系统：从传感器到彩色显示的完整实现

1. 项目概述与核心思路

水位监测这件事，听起来简单，但真要做好，里面门道不少。传统的水位计要么是机械浮球，容易卡住，要么是电极式，容易腐蚀。这几年，非接触式的超声波方案越来越流行，因为它不直接接触液体，安装灵活，寿命也长。我手头正好有个项目，需要监控一个户外储水箱的水位，就决定用Arduino和超声波传感器自己做一个带彩色屏幕的数字水位计。最终做出来的东西，不仅能实时显示水位百分比，还能用不同颜色的柱状图直观展示水位高低，放在家里或者小型工农业场景里，既实用又有科技感。

这个项目的核心，其实就是把超声波传感器测到的“距离”数据，转换成我们容易理解的“水位百分比”和“柱状图”，并通过一块彩屏显示出来。整个过程涉及硬件连接、电平转换、数据采集、算法处理和图形显示几个环节。对于刚接触Arduino和传感器应用的朋友来说，这是一个非常好的综合练习项目，能让你一次性把传感器数据采集、简单数据处理和图形界面显示都串起来。下面，我就把从硬件选型到代码调试的完整过程，以及我踩过的坑和总结的经验，毫无保留地分享给你。

2. 硬件选型与电路设计解析

2.1 核心元件功能剖析

这个项目用到的硬件不多，但每一件都有其不可替代的作用，选对了才能事半功倍。

Arduino开发板：这里说的“Any arduino board”通常指的是以ATmega328P为核心的Arduino Uno，或者兼容板。它是整个系统的大脑，负责给传感器发指令、接收回波信号、计算距离、换算百分比，最后驱动屏幕显示。选择Uno是因为其引脚数量足够，5V工作电压与多数传感器兼容，且社区资源丰富，遇到问题容易找到答案。如果你手头是Nano、Mega等，也完全没问题，只需注意引脚定义的对应调整。

HC-SR04超声波传感器：这是最常用的一款超声波测距模块。它工作原理很简单：Trig引脚接收一个至少10微秒的高电平脉冲，模块就会自动发射一组8个40kHz的超声波。当超声波遇到障碍物（比如水面）反射回来，模块通过Echo引脚输出一个高电平脉冲，脉冲的宽度与声波往返时间成正比。我们通过测量这个高电平的持续时间，就能算出距离。它的测量范围在2cm到400cm之间，精度能达到3mm，对于水箱水位测量来说完全够用。

ILI9341 TFT显示屏：这是一款2.8英寸、分辨率240x320的彩色LCD屏幕，通过SPI接口与Arduino通信。它显示色彩丰富，能绘制图形和文字，非常适合用来做可视化界面。但有一个关键点：它的逻辑电平是3.3V，而Arduino Uno的IO口输出是5V。直接连接，过高的电压可能会损坏屏幕的控制器。这就是为什么项目中需要电平转换电路。

电阻网络（电平转换）：这是硬件部分的一个小难点，也是保证屏幕稳定工作的关键。ILI9341的通信引脚（如DC、CS、MOSI等）只能耐受3.3V输入。我们用电阻分压的原理，将Arduino的5V信号降低到约3.3V。具体是用一个2.2kΩ和一个3.3kΩ的电阻串联。根据分压公式 V_out = V_in * (R2 / (R1 + R2))，当V_in=5V，R1=2.2k，R2=3.3k时，V_out ≈ 5V * (3.3 / (2.2+3.3)) ≈ 3.0V，这是一个安全的电平。每个需要从Arduino传输数据到屏幕的引脚，都需要这样一组分压电路。

2.2 电路连接与分压原理详解

连接图是项目的骨架，理解每一根线的作用至关重要。

屏幕连接与电平转换： 屏幕通常有多个引脚，核心的SPI引脚包括：

• CS (Chip Select)：片选，接Arduino的Pin 8。每个SPI设备都需要一个CS引脚，用于控制器选择与哪个设备通信。
• DC (Data/Command)：数据/命令选择，接Arduino的Pin 10。告诉屏幕控制器接下来发送的是命令（如设置地址）还是显示数据（如颜色值）。
• RST (Reset)：复位，接Arduino的Pin 9。用于硬件复位屏幕。
• MOSI (Master Out Slave In)：主机输出从机输入，接Arduino的Pin 11。这是Arduino向屏幕发送数据的主通道。
• SCK (Serial Clock)：时钟信号，接Arduino的Pin 13。SPI通信的同步时钟。

对于CS、DC、MOSI、SCK这四个从Arduino输出到屏幕的引脚，都需要加上之前提到的2.2kΩ+3.3kΩ分压电路。具体接法是：Arduino引脚 → 2.2kΩ电阻 →（连接点引出线到屏幕引脚）→ 3.3kΩ电阻 → GND。屏幕的VCC接3.3V，GND接公共地。注意：RST引脚有些屏幕可以直接接3.3V，但接在Arduino引脚上并通过代码控制复位更可靠，这个引脚也需要分压。

超声波传感器连接： 这个就简单多了，它工作电压是5V。

• VCC→ Arduino 5V
• GND→ Arduino GND
• Trig→ Arduino Pin 5 (需通过代码设置为输出)
• Echo→ Arduino Pin 6 (需通过代码设置为输入)

注意：网上有些教程会将Echo引脚也通过电阻分压，因为HC-SR04的Echo输出是5V电平。但大多数现代Arduino的IO口（包括ATmega328P）的引脚可以容忍5V输入（所谓“5V耐受”），在作为输入时，接收5V信号会被识别为高电平。因此，Echo引脚可以直接连接Arduino的Pin 6，无需分压。这简化了电路。如果你使用的是工作电压为3.3V的开发板（如ESP8266），则Echo引脚也必须分压。

3. 软件逻辑与代码逐行解读

代码是将硬件赋予灵魂的关键。我们提供的代码主要包含库引入、引脚定义、屏幕初始化、距离测量和图形绘制几个部分。

3.1 库依赖与全局变量声明

#include <Adafruit_GFX.h> // 核心图形库 #include <Adafruit_ILI9341.h> // ILI9341屏幕专用驱动库 // 超声波传感器引脚定义 const int trigPin = 5; const int echoPin = 6; // 屏幕SPI引脚定义 (使用软件SPI，可自由定义引脚) #define TFT_CS 8 #define TFT_RST 9 #define TFT_DC 10 // 初始化屏幕对象 Adafruit_ILI9341 tft = Adafruit_ILI9341(TFT_CS, TFT_DC, TFT_RST); // 测量相关变量 long duration; // 存储高电平脉冲时间（微秒） int distance; // 计算出的距离（厘米） int percentage = 0; // 水位百分比 int tankHeight = 130; // 你的水箱高度（厘米），这是最重要的一个参数！

关键点解析：

1. Adafruit_GFX和Adafruit_ILI9341库可以通过Arduino IDE的库管理器直接搜索安装。它们是Adafruit公司维护的，对自家屏幕兼容性最好。
2. tankHeight这个变量至关重要，它代表从超声波传感器探头到水箱底部的垂直距离。所有百分比计算都基于此值。你必须在安装好传感器后，实际测量这个高度并修改代码中的数值。

3.2 初始化设置（setup函数）

void setup() { Serial.begin(9600); // 启动串口监视器，用于调试输出 Serial.println("ILI9341 Test!"); // 初始化屏幕 tft.begin(); // 以下是一段可选的诊断代码，可以读取屏幕的配置信息，帮助判断屏幕是否正常连接 uint8_t x = tft.readcommand8(ILI9341_RDMODE); Serial.print("Display Power Mode: 0x"); Serial.println(x, HEX); // ... 其他诊断信息读取 // 设置超声波传感器引脚模式 pinMode(trigPin, OUTPUT); pinMode(echoPin, INPUT); Serial.println(F("Done!")); }

实操心得：tft.begin()之后的那段诊断代码，在初次调试时非常有用。如果屏幕连接或电平转换有问题，这里读出的信息会是乱码或者全0。一旦系统稳定，可以注释掉这段代码以节省空间和加快启动速度。

3.3 核心测量函数（waterlevel函数）

这是整个项目的算法核心，我把它拆解开详细说。

void waterlevel() { tft.fillScreen(ILI9341_BLACK); // 清屏为黑色 tft.drawRect(18, 18, 84, 284, ILI9341_GREEN); // 画一个绿色的空水箱边框 while(true) { // 进入无限循环，持续测量和显示 // 1. 触发超声波测量 digitalWrite(trigPin, LOW); delayMicroseconds(2); // 确保低电平稳定 digitalWrite(trigPin, HIGH); delayMicroseconds(10); // 维持10微秒高电平，触发发射 digitalWrite(trigPin, LOW); // 2. 读取回波时间 duration = pulseIn(echoPin, HIGH); // 等待并测量Echo引脚高电平持续时间 // 3. 计算距离（核心公式） distance = duration * 0.034 / 2; // 单位：厘米 Serial.println(distance); // 输出原始距离到串口，用于校准 // 4. 数据清洗与校准（非常重要！） if(distance < 6) { distance = 0; } // 过滤掉过近的无效回波（可能是传感器自身干扰） distance = distance - 5; // 减去传感器盲区补偿（假设盲区约5cm） if(distance < 0) { distance = 0; } // 确保距离非负 if(distance > tankHeight) { distance = tankHeight; } // 限制最大距离为水箱高度 // 5. 计算水位百分比 percentage = distance * 100 / tankHeight; // 计算空余空间百分比 percentage = 100 - percentage; // 转换为水位百分比 // 6. 在屏幕上显示百分比数字 tft.setCursor(130, 130); // 设置文本起始坐标 tft.fillRect(120, 120, 120, 50, ILI9341_BLACK); // 用黑色矩形清除旧数字区域（避免重叠） tft.setTextColor(ILI9341_GREEN); tft.setTextSize(4); if(percentage != 100){ tft.print(percentage); tft.print(" %"); } else { tft.print(percentage); // 显示100%时可能格式特殊处理 } // 7. 绘制彩色水位柱状图 // 先清除旧的水柱 tft.fillRect(20, 20, 80, 280, ILI9341_BLACK); // 计算水柱的起始Y坐标和高度 int barStartY = 20 + (100 - percentage) * 2.8; // 2.8 = 280像素 / 100% int barHeight = percentage * 2.8; // 根据水位选择颜色 uint16_t barColor; if(percentage < 10) { barColor = ILI9341_RED; // 水位极低，红色警报 } else if(percentage < 30) { barColor = ILI9341_YELLOW; // 水位较低，黄色警告 } else if(percentage < 80) { barColor = ILI9341_BLUE; // 正常水位，蓝色 } else { barColor = ILI9341_GREEN; // 水位很高，绿色安全 } // 绘制填充矩形代表水位 tft.fillRect(20, barStartY, 80, barHeight, barColor); delay(1000); // 每秒更新一次 } }

算法与参数调整深度解析：

1. 声速与公式：duration * 0.034 / 2是灵魂公式。声波在25℃空气中的速度约为343米/秒，即0.034厘米/微秒。duration是往返时间，所以单程距离要除以2。这个0.034是一个近似值，温度变化会影响声速。对于要求不高的室内应用可以忽略，如果用于户外或高精度场合，可以考虑加入温度传感器进行补偿。
2. 盲区补偿：distance = distance - 5这一行是经验值。HC-SR04传感器在物体距离太近时（通常2-3cm内）无法准确测量，回波信号会混乱。我们假设这个盲区是5cm，将测量值减去5cm来补偿。这个值需要你根据实测校准：让传感器正对一个已知距离（如10cm）的平面，测量输出值，计算差值即为你的传感器盲区。
3. 百分比与像素映射：屏幕上的水箱边框高284像素，我们留了上下各2像素的边距，所以用于显示水柱的有效高度是280像素。2.8这个系数就是280像素 / 100%得来的。计算水柱顶部Y坐标的公式20 + (100 - percentage) * 2.8是关键：因为屏幕坐标原点(0,0)在左上角，百分比越大（水位越高），水柱应该从越靠下的位置开始画，所以用100 - percentage。
4. 颜色逻辑：用不同颜色表示水位状态，这是非常好的人机交互设计。阈值（10%， 30%， 80%）可以根据你的实际需求调整。比如，对于饮用水箱，你可能希望80%以上就提示即将满溢。

4. 组装、校准与调试全流程

4.1 硬件组装步骤与要点

1. 焊接分压电阻：这是最需要耐心的一步。建议使用面包板先进行原型测试。将5组（CS, DC, MOSI, SCK, RST）2.2kΩ和3.3kΩ电阻按分压电路焊好，或者使用现成的电平转换模块（如TXS0108E）会更方便可靠。确保焊接牢固，无虚焊短路。
2. 连接屏幕：将屏幕的VCC接Arduino的3.3V输出引脚，GND接GND。然后将经过分压后的CS、DC、MOSI、SCK、RST信号线分别连接到Arduino的8、10、11、13、9引脚。屏幕的MISO引脚（如果存在）可以不接，因为我们不需要从屏幕读数据。
3. 连接传感器：将HC-SR04的VCC、GND、Trig、Echo分别连接到Arduino的5V、GND、5、6引脚。
4. 供电：整个系统可以通过Arduino的USB口供电，或者通过Vin引脚接入7-12V直流电源。如果水箱环境较远，可以考虑用电池组或太阳能板供电。

重要提示：在通电前，务必用万用表检查一遍所有电源连接（5V、3.3V、GND）是否短路，电平转换电路的输出是否在3.3V左右。接反或电压过高是烧毁屏幕的最常见原因。

4.2 软件烧录与初步测试

1. 在Arduino IDE中安装好必要的库（Adafruit_GFX和Adafruit_ILI9341）。
2. 将完整的代码复制到IDE中。
3. 修改关键参数：找到代码中int tankHeight = 130;这一行，将130替换为你实际测量的、从传感器安装面到水箱底部的垂直距离（单位：厘米）。
4. 选择正确的开发板型号和端口，点击上传。
5. 上传成功后，打开串口监视器（波特率9600）。你应该能看到“ILI9341 Test!”以及后续的屏幕诊断信息（如果代码未注释）。这证明Arduino和屏幕通信基本正常。

4.3 传感器校准与系统调试

这是让水位计准确工作的最关键一步。

1. 空水箱校准：确保水箱是空的。打开串口监视器，你会看到不断打印的distance值。这个值应该大致等于你设置的tankHeight（因为测的是到箱底的距离）。记录下这个稳定后的数值，比如是128cm。
2. 满水箱校准：向水箱中加满水。再次观察串口监视器的distance值。此时应该是一个很小的值，代表水面到传感器的距离。但由于水面波动和传感器盲区，这个值可能不稳定。记录一个典型值，比如8cm。
3. 校准代码参数：
   • tankHeight：理论上应该等于空水箱距离。但如果空水箱实测为128cm，你可以将代码中的tankHeight改为128。这样，当距离为128cm时，百分比就是0%。
   • 盲区补偿：满水箱时，我们期望传感器读数是“0”（水面在探头处），但实际可能读到8cm。这个8cm包含了传感器自身的盲区以及水面到探头安装位置的距离。你可以调整distance = distance - 5;这行代码中的5。如果满水读数是8，你可以尝试改为distance = distance - 8;，这样满水时计算出的distance就更接近0。
   • 百分比公式：公式percentage = distance * 100 / tankHeight; percentage = 100 - percentage;在修改了tankHeight和盲区补偿后，会自动适应。
4. 分段验证：在水箱中注入25%、50%、75%的水，观察屏幕显示的百分比和柱状图高度是否准确。如果不准，微调tankHeight和盲区补偿值，直到线性度满意为止。

调试技巧：在waterlevel()函数的计算部分，可以临时增加一些串口打印，例如：

Serial.print("Raw Distance: "); Serial.print(duration * 0.034 / 2); Serial.print(", Adjusted Distance: "); Serial.print(distance); Serial.print(", Percentage: "); Serial.println(percentage);

这样你可以清晰地看到每一步计算的结果，便于定位问题。

5. 常见问题排查与进阶优化

5.1 硬件连接问题排查表

5.2 软件与逻辑问题

• 百分比计算错误：首先检查tankHeight值是否设置正确。其次，检查公式percentage = distance * 100 / tankHeight;中的变量都是整数（int），在Arduino中整数除法会截断小数。例如，distance=65,tankHeight=130，计算结果是50，正确。但如果tankHeight=135，65*100/135在整数运算中等于48，会有误差。如果追求精度，可以将变量定义为float，或者将计算顺序改为percentage = (distance * 100L) / tankHeight;利用长整型提高中间计算精度。
• 屏幕刷新闪烁：代码中先清空旧水柱区域再画新水柱，如果清空和绘制之间有延时，可能会看到闪烁。解决方法是使用“双缓冲”或局部更新。但ILI9341本身刷新不算快，简单的做法是减少delay(1000)的时间，比如改为500ms，让视觉暂留感觉更流畅。
• 程序卡在while(true)循环：原代码的waterlevel()函数内是一个while(true)无限循环，这意味着进入这个函数后就再也出不来了，无法执行其他任务（比如响应按钮）。这是一个设计上的简化。在实际应用中，更好的方法是将测量和显示逻辑放在主loop()中，通过状态机或定时器来控制，从而保持系统的可扩展性。

5.3 项目进阶优化方向

这个基础版本已经可以工作，但如果你想让它更实用、更专业，可以考虑以下优化：

1. 增加温度补偿：如前所述，声速受温度影响。可以增加一个DS18B20温度传感器，实时测量环境温度，用修正后的声速公式速度 = 331.4 + 0.6 * 温度(℃)米/秒 来计算距离，精度会显著提升。
2. 数据平滑滤波：水面波动会导致读数跳动。可以在代码中实现一个滑动平均滤波：连续采样10次距离值，去掉最大最小值后求平均，再将这个平均值用于计算。这能极大提升显示稳定性。
3. 增加无线传输与报警：加入一个ESP8266或ESP32模块，将水位数据通过Wi-Fi发送到手机APP（如Blynk、Home Assistant）或云平台。可以设置水位下限（如10%）和上限（如90%），触发时发送推送通知或控制水泵开关。
4. 低功耗设计：如果使用电池供电，需要优化功耗。可以将测量间隔从1秒延长到30秒或1分钟；在间隔期间，让Arduino和屏幕进入休眠模式；使用硬件定时器唤醒，这样可以大大延长电池寿命。
5. 美化用户界面：利用Adafruit_GFX库的强大功能，可以绘制更精美的界面，比如模拟的水箱图案、历史水位曲线图、电池电量图标等。

这个基于Arduino的数字水位计项目，从硬件焊接、软件编程到现场校准，完整地走通了一个物联网传感节点的开发流程。它最宝贵的价值不在于测量本身，而在于提供了将物理世界信号（声波）转化为数字信息，再转化为直观视觉反馈的完整方法论。当你成功调试出第一个准确的百分比读数时，那种对系统各个环节都了然于胸的掌控感，是任何现成产品都无法给予的。希望这份详细的拆解，能帮你绕过我当初踩过的那些坑，更顺畅地完成自己的创作。