1. 项目概述用LCD实时显示超声波测距数据如果你手头有一个Arduino、一块LCD屏幕和一个超声波传感器想做一个实时显示距离的小装置比如给盲人做个简易避障提示或者给小车做个倒车雷达原型那这个项目正合适。我最近刚用这套东西帮朋友做了个智能花盆的浇水提醒器当水位低于设定值时LCD会显示当前水位高度并报警核心原理就是今天要聊的超声波测距与显示。简单来说这个项目的目标就是让超声波传感器持续测量它前方物体的距离然后把测出来的厘米或毫米数实时、清晰地显示在那一小块通常是16x2字符的LCD屏幕上。整个过程完全由Arduino Uno这类开发板控制代码量不大但里面涉及的硬件接线、时序控制、单位换算和显示优化每一个环节都有值得琢磨的地方。搞明白了你就能举一反三把它应用到各种需要非接触式测距的场景里。2. 硬件选型与连接思路解析2.1 核心元件功能与选型考量这个项目硬件很简单就三样主控、传感器、显示器。但每一样选型都直接影响到最终效果和成本。Arduino开发板首选肯定是Arduino Uno R3。对于新手和大多数项目Uno的ATmega328P芯片性能足够14个数字I/O口和6个模拟输入口也完全能满足连接LCD和超声波传感器的需求。它的社区资源最丰富任何奇怪的问题几乎都能找到答案。如果项目对体积有要求可以考虑Nano它和Uno芯片一样只是体型小巧如果后续需要连接更多传感器或更复杂的显示设备如OLED那么端口更多、性能更强的Mega 2560会是更好的选择。HC-SR04超声波传感器这是市面上最经典、最廉价的模块。它工作原理是声纳触发引脚Trig发出一个10微秒的高电平脉冲模块会自动发射8个40kHz的超声波脉冲然后回声引脚Echo会输出一个高电平脉冲其宽度与超声波往返时间成正比。它的测量范围标称2cm-400cm精度大约3mm对于大多数业余项目完全够用。需要注意它需要5V供电但Echo引脚输出也是5V电平直接接Arduino的5V容忍I/O口如Uno的所有数字口没问题。如果追求更小体积或更窄的检测波束可以看看US-100它集成了温度补偿精度更高且支持串口和电平两种模式。1602A LCD屏幕带I2C接口这是关键选择。原始的1602 LCD需要连接多达6根线RS, EN, D4, D5, D6, D7才能进行数据通信非常占用I/O口且接线混乱。强烈建议使用带有I2C转接板的版本。这个蓝色的小板子焊在LCD背面通过I2C总线只需SDA、SCL两根数据线加上VCC和GND共4根线与Arduino通信极大简化了连接。I2C地址通常是0x27或0x3F购买时最好向卖家确认或者用扫描代码自己查一下。2.2 电路连接详解与避坑指南正确的连接是成功的一半。下面给出基于I2C LCD和HC-SR04的推荐接法并解释为什么这么接。接线清单Arduino Uno - I2C LCD5V - LCD VCCGND - LCD GNDA4 (SDA) - LCD SDAA5 (SCL) - LCD SCLArduino Uno - HC-SR045V - HC-SR04 VCCGND - HC-SR04 GND数字引脚 D9 - HC-SR04 Trig (触发)数字引脚 D10 - HC-SR04 Echo (回声)为什么这么接电源统一所有模块都从Arduino的5V和GND取电确保共地这是信号稳定的基础。Arduino Uno的USB口或外部电源适配器需要能提供至少500mA的电流以保证稳定运行。信号引脚选择Trig和Echo我们选用了D9和D10这只是个人习惯你可以选择任何空闲的数字引脚如D2-D13。但最好避开D0(RX)、D1(TX)因为它们默认用于串口通信如果连接了模块可能会干扰程序上传。也建议避开D11、D12、D13如果你未来可能用到SPI接口的设备如某些无线模块。I2C引脚固定在Arduino Uno上SDA固定是A4引脚SCL固定是A5引脚。这一点绝对不能接错。在Mega上SDA是20脚SCL是21脚。注意一个常见的“坑”有些教程或代码包括用户提供的原始代码会使用模拟引脚A0、A1来连接HC-SR04的Trig和Echo。虽然Arduino的模拟引脚A0-A5也可以作为数字引脚使用但这样命名和调用容易让人混淆特别是对于初学者。更规范、更清晰的做法是使用明确的数字引脚编号如D2-D13。原始代码中使用readUltrasonicDistance(A0, A1)在语法上可行但会降低代码可读性。我们后续的优化代码将纠正这一点。3. 代码深度解析与优化实现原始代码提供了一个最基础的框架但它存在一些可以改进的地方比如引脚定义不直观、没有单位显示、缺少异常处理等。我们来一步步拆解并优化。3.1 库的引入与对象初始化任何Arduino项目的第一步都是引入必要的库。对于I2C LCD我们使用LiquidCrystal_I2C.h库它比标准的LiquidCrystal.h更适用于I2C接口。#include Wire.h // I2C通信必备库 #include LiquidCrystal_I2C.h // I2C LCD控制库 // 初始化LCD对象 // 参数I2C地址列数行数 // 常见地址是0x27或0x3F如果屏幕不亮请尝试更换地址 LiquidCrystal_I2C lcd(0x27, 16, 2); // 假设地址为0x27的16列2行LCD // 定义超声波传感器引脚 const int trigPin 9; // 触发引脚连接到数字引脚9 const int echoPin 10; // 回声引脚连接到数字引脚10 // 定义变量 long duration; // 存储声音往返时间微秒 float distance; // 存储计算出的距离厘米关键点解析#include Wire.h这是Arduino内置的I2C库必须包含否则LiquidCrystal_I2C库无法工作。LiquidCrystal_I2C lcd(0x27, 16, 2);这行代码创建了一个名为lcd的对象。0x27是模块的I2C地址如果屏幕初始化后没有任何显示背光可能亮也可能不亮最常见的解决办法就是尝试将0x27改为0x3F。你可以运行一个I2C扫描程序来查找确切的地址。使用const int定义引脚而不是原始代码中的直接使用A0、A1。const关键字表示这些是常量程序运行中不会改变这样编译器能进行一些优化也更符合良好编程习惯。3.2 测距函数原理与优化原始代码中的readUltrasonicDistance函数是核心。我们来详细解释其每一步的物理意义和时序要求并编写一个更健壮的版本。long getSonarDistance() { // 1. 确保触发引脚为低电平并保持至少2微秒以清除任何残余信号 digitalWrite(trigPin, LOW); delayMicroseconds(2); // 短暂延时稳定信号 // 2. 产生一个至少10微秒的高电平脉冲触发传感器发射超声波 digitalWrite(trigPin, HIGH); delayMicroseconds(10); // HC-SR04要求的最小触发脉冲宽度 digitalWrite(trigPin, LOW); // 3. 读取回声引脚的高电平持续时间 // pulseIn函数会等待echoPin变为高电平开始计时直到其变回低电平返回持续的微秒数 // 参数引脚等待状态超时时间微秒。这里设置超时为30000微秒30ms对应大约5米距离。 duration pulseIn(echoPin, HIGH, 30000); // 4. 计算距离单位厘米 // 声速在常温20°C干燥空气中约为343米/秒即0.0343厘米/微秒。 // 距离 (时间 * 声速) / 2。因为时间是往返时间。 // 所以距离厘米 (duration * 0.0343) / 2 duration * 0.01715 // 原始代码使用的0.01723是一个近似值可能包含了温度补偿或校准系数我们沿用。 distance duration * 0.01723; // 处理异常情况如果超时超出测量范围或未检测到回波pulseIn返回0 if (duration 0) { // 返回一个错误值例如-1方便主程序判断 return -1; } return distance; }为什么是0.01723这个数字是声速公式的简化。声音在空气中传播速度受温度影响很大。公式为距离 (声速 * 时间) / 2。在25°C时声速约为346米/秒即0.0346厘米/微秒。代入公式得距离厘米 时间微秒 * 0.0346 / 2 时间 * 0.0173。用户代码中的0.01723是一个接近常温下约20°C的校准值。如果你需要更高精度可以添加一个温度传感器如DHT11或DS18B20实时计算声速声速厘米/微秒 0.0331 0.000606 * 温度摄氏度。3.3 主程序框架与显示优化setup()函数负责一次性初始化loop()函数则是不停循环的主体。void setup() { // 初始化串口通信用于调试输出原始数据到电脑 Serial.begin(9600); // 初始化LCD lcd.init(); lcd.backlight(); // 打开背光 // 在LCD上打印静态标题 lcd.setCursor(0, 0); // 将光标移动到第0列第0行左上角 lcd.print(Distance:); // 设置超声波传感器引脚模式 pinMode(trigPin, OUTPUT); pinMode(echoPin, INPUT); Serial.println(Ultrasonic Sensor with LCD - Initialized); } void loop() { // 调用测距函数 distance getSonarDistance(); // 在串口监视器显示用于调试 Serial.print(Distance: ); Serial.print(distance); Serial.println( cm); // 在LCD上显示 lcd.setCursor(0, 1); // 将光标移动到第0列第1行第二行 lcd.print( ); // 先清空第二行打印16个空格 lcd.setCursor(0, 1); // 再将光标移回第二行开头 if (distance -1) { // 如果测距失败返回-1 lcd.print(Out of Range); } else if (distance 2 || distance 400) { // HC-SR04的有效范围通常在2-400cm超出范围提示 lcd.print(Invalid); } else { // 正常显示距离并格式化输出 lcd.print(distance); // 显示浮点数 lcd.print( cm); } // 控制测量频率。延迟太短上次声波可能干扰下次测量延迟太长显示刷新慢。 // 100-200毫秒是一个不错的间隔。 delay(200); }显示优化技巧清行操作在更新第二行数据前先打印一串空格覆盖旧内容。这是因为lcd.print()不会自动清除后面的字符。例如上一次显示“12.34 cm”7个字符下一次显示“5.6 cm”6个字符如果不清理你会看到“5.6 cm4 cm”的残留。打印16个空格是最简单的清行方法。错误处理增加了对超范围和无回波distance -1的判断并在LCD上给出友好提示如“Out of Range”或“Invalid”这比显示一个0或极大值要直观得多。调试接口始终保留Serial.begin()和Serial.print()语句。在调试时你可以通过Arduino IDE的“串口监视器”查看原始的距离值和持续时间这对于排查硬件问题如是否收到回波信号至关重要。4. 完整代码整合与注释将上述所有部分整合形成一份完整、健壮、注释清晰的代码。/* * 项目超声波传感器距离LCD显示 * 硬件Arduino Uno, HC-SR04超声波传感器1602A I2C LCD * 功能持续测量前方障碍物距离并实时显示在LCD屏幕上超出范围提示。 * 连接 * LCD I2C - Arduino * SCL - A5 * SDA - A4 * VCC - 5V * GND - GND * HC-SR04 - Arduino * Trig - D9 * Echo - D10 * VCC - 5V * GND - GND */ #include Wire.h #include LiquidCrystal_I2C.h // 初始化LCD地址0x2716列2行 LiquidCrystal_I2C lcd(0x27, 16, 2); // 定义超声波传感器引脚 const int trigPin 9; const int echoPin 10; // 定义变量 long duration; float distance; void setup() { // 启动串口通信波特率9600 Serial.begin(9600); // 初始化LCD lcd.init(); lcd.backlight(); // 打开背光 // 打印静态标题 lcd.setCursor(0, 0); lcd.print(Distance:); // 设置超声波引脚模式 pinMode(trigPin, OUTPUT); pinMode(echoPin, INPUT); // 初始信息 Serial.println(System Ready.); } // 自定义函数获取超声波距离单位厘米 float getSonarDistance() { // 确保触发引脚起始为低电平 digitalWrite(trigPin, LOW); delayMicroseconds(2); // 发送10微秒的高电平触发脉冲 digitalWrite(trigPin, HIGH); delayMicroseconds(10); digitalWrite(trigPin, LOW); // 读取回声高电平持续时间设置超时30ms约对应5米 duration pulseIn(echoPin, HIGH, 30000); // 计算距离使用近似声速系数 distance duration * 0.01723; // 处理超时或无回波情况 if (duration 0) { return -1; // 返回-1表示测量失败 } return distance; } void loop() { // 获取距离值 distance getSonarDistance(); // 串口输出用于调试 Serial.print(Duration: ); Serial.print(duration); Serial.print( us | Distance: ); Serial.print(distance); Serial.println( cm); // LCD显示处理 lcd.setCursor(0, 1); // 定位到第二行 lcd.print( ); // 清空第二行 lcd.setCursor(0, 1); // 再次定位 if (distance -1) { lcd.print(No Echo/Error); } else if (distance 2 || distance 400) { // HC-SR04有效测量范围判断 lcd.print(Out of Range); } else { // 正常显示保留一位小数 lcd.print(distance, 1); // 显示一位小数 lcd.print( cm); } // 延时200毫秒控制刷新率 delay(200); }5. 常见问题排查与实战心得即使按照教程连接和烧录代码你也可能会遇到一些问题。下面是我在多次项目中总结出来的常见“坑点”和解决方法。5.1 LCD屏幕不显示任何内容这是最常见的问题症状是屏幕一片空白但背光可能亮也可能不亮。检查I2C地址这是头号嫌疑犯。模块的I2C地址可能是0x27或0x3F。在代码LiquidCrystal_I2C lcd(0x27, 16, 2);中尝试更换地址。最可靠的方法是运行一个I2C扫描程序来探测地址。检查对比度很多1602 LCD模块背面有一个蓝色的电位器用螺丝刀旋转它可以调节屏幕对比度。如果对比度设置不当即使有内容也看不见。在通电状态下慢慢旋转电位器直到字符出现。检查接线确保4根线VCC, GND, SDA, SCL没有接错或虚焊。特别是SCL和SDA不要接反。检查库文件确保Arduino IDE中已安装LiquidCrystal_I2C库。可以通过“工具” - “管理库”搜索安装。5.2 超声波传感器读数固定为0或极大值/无变化检查电源确保HC-SR04的VCC接的是5V而不是3.3V。接3.3V可能导致模块工作不稳定。检查Trig和Echo连接确认Trig和Echo的线没有接反。Trig是输出接Arduino的数字输出引脚Echo是输入接数字输入引脚。检查物体表面超声波对光滑、坚硬的表面如玻璃、瓷砖反射效果好。对柔软、多孔或倾斜角度过大的表面声波可能被吸收或散射导致无法收到回波。尝试用一本厚书或木板作为测试物体。检查测量间隔在loop()中如果两次测量之间没有足够的延迟delay上一次发射的声波余波可能会干扰下一次的接收。确保延迟至少60毫秒以上HC-SR04的周期建议值。我的代码用了200ms很稳定。查看串口监视器打开串口监视器查看duration持续时间的值。如果一直是0说明pulseIn没有收到高电平信号Echo引脚没反应。如果是一个很大的固定值可能是收到了干扰信号。通过串口数据可以快速定位是软件问题还是硬件信号问题。5.3 测量距离不准确、跳动大环境干扰避免在传感器附近有强烈的空气流动如风扇、空调出风口或者有其他同频率40kHz的声源干扰。供电不足如果使用USB供电且连接了多个模块可能导致Arduino板载电压不稳。尝试使用9V-12V的外部电源适配器给Arduino供电。温度补偿如前所述声速随温度变化。如果项目运行环境温度变化大可以考虑加入温度传感器动态计算声速系数替换掉固定的0.01723。多次采样取平均这是软件上滤除随机波动最有效的方法。在loop()中连续读取5-10次距离去掉最大最小值后求平均再将平均值显示出来读数会稳定得多。float getAverageDistance(int samples) { float sum 0; int validSamples 0; float readings[samples]; // 采集样本 for (int i 0; i samples; i) { float d getSonarDistance(); if (d 2 d 400) { // 只收集有效范围内的样本 readings[validSamples] d; validSamples; } delay(50); // 每次采样间隔50ms } // 简单冒泡排序找最大最小值如果样本数多可以用更优算法 if (validSamples 2) { // 这里可以添加排序代码去掉两端异常值... // 为了简化这里直接求所有有效样本的平均 for (int i 0; i validSamples; i) { sum readings[i]; } return sum / validSamples; } else { return -1; // 有效样本太少 } } // 在loop()中调用distance getAverageDistance(5);5.4 项目扩展思路这个基础项目就像一颗种子可以生长出很多有趣的应用。阈值报警设定一个安全距离如20cm当测量距离小于这个值时让LCD背光变红如果支持RGB背光或者让一个蜂鸣器响起来制作一个简易的防撞报警器。数据记录加上一个SD卡模块将距离数据连同时间戳一起保存到txt文件里用于分析物体运动轨迹。多传感器阵列使用多个超声波传感器分别指向不同角度在LCD上轮流显示或综合判断实现简单的环境扫描。无线传输接入一个蓝牙模块如HC-05或Wi-Fi模块如ESP8266将距离数据发送到手机App或电脑上实现远程监控。我最初做这个只是为了测一下鱼缸水位后来不断加入平均值滤波、温度补偿、手机报警变成了一个相当可靠的小系统。硬件项目最迷人的地方就在于从这几行简单的代码开始你可以根据自己的想法把它变得无比复杂和强大。关键是动手去做遇到问题就查代码烧进去不工作也别慌按照上面说的步骤一步步排查多半是某个接线松了或者地址没设对。祝你玩得开心。