1. 项目概述树莓派作为一款性价比极高的微型计算机在嵌入式开发和物联网项目中广受欢迎。HC-SR04超声波测距模块因其价格低廉、使用简单、测量精度较高等特点常被用于机器人避障、液位检测等场景。本文将详细介绍如何使用C语言在树莓派上驱动HC-SR04模块实现距离测量特别适合刚接触树莓派开发的新手学习。注意本文使用的是树莓派4B型号但方法同样适用于其他版本的树莓派。不同型号的主要区别在于GPIO引脚排列使用时需注意核对引脚定义。2. 硬件准备与连接2.1 所需材料清单树莓派主板任何型号均可HC-SR04超声波模块母对母杜邦线4条5V/2A电源适配器可选面包板方便接线2.2 HC-SR04模块详解HC-SR04模块有4个引脚VCC电源正极5VTrig触发信号输入Echo回波信号输出GND地线模块工作原理向Trig引脚发送至少10μs的高电平脉冲模块自动发送8个40kHz的超声波脉冲模块检测回波并通过Echo引脚输出高电平高电平持续时间与距离成正比2.3 树莓派GPIO引脚说明树莓派有多个GPIO编号系统本文使用wiringPi编号方式。以下是关键引脚定义wiringPi编号物理引脚BCM编号功能41623Trig输出51824Echo输入-2-5V电源-6-GND2.4 接线示意图HC-SR04 树莓派 VCC ---- 物理引脚2 (5V) Trig ---- 物理引脚16 (wiringPi 4) Echo ---- 物理引脚18 (wiringPi 5) GND ---- 物理引脚6 (GND)重要提示Echo引脚输出是5V电平而树莓派GPIO只能承受3.3V。长期使用建议添加分压电路如1kΩ和2kΩ电阻组成分压器避免损坏树莓派。3. 软件环境配置3.1 安装wiringPi库wiringPi是树莓派最常用的GPIO控制库之一提供简洁的C语言接口。安装步骤如下# 更新软件源 sudo apt-get update # 安装git和编译工具 sudo apt-get install git-core gcc make # 下载wiringPi源码 git clone https://github.com/WiringPi/WiringPi.git # 编译安装 cd WiringPi ./build验证安装是否成功gpio -v gpio readall3.2 创建项目文件新建一个C语言源文件如ultrasonic.cnano ultrasonic.c4. C语言代码实现4.1 完整代码#include wiringPi.h #include stdio.h #include sys/time.h // 定义引脚 #define TRIG_PIN 4 #define ECHO_PIN 5 // 初始化函数 void initUltrasonic() { pinMode(TRIG_PIN, OUTPUT); pinMode(ECHO_PIN, INPUT); // 初始状态设置 digitalWrite(TRIG_PIN, LOW); delay(30); // 确保模块稳定 } // 测距函数 float getDistance() { struct timeval start, stop; long micros_start, micros_end; float distance_cm; // 发送触发信号 digitalWrite(TRIG_PIN, HIGH); delayMicroseconds(10); digitalWrite(TRIG_PIN, LOW); // 等待回波开始 while(digitalRead(ECHO_PIN) LOW); gettimeofday(start, NULL); // 等待回波结束 while(digitalRead(ECHO_PIN) HIGH); gettimeofday(stop, NULL); // 计算时间差微秒 micros_start start.tv_sec * 1000000 start.tv_usec; micros_end stop.tv_sec * 1000000 stop.tv_usec; // 计算距离厘米 // 声速340m/s 34000cm/s // 时间差单位转换为秒除以2往返距离 distance_cm (float)(micros_end - micros_start) / 1000000 * 34000 / 2; return distance_cm; } int main() { // 初始化wiringPi if(wiringPiSetup() -1) { printf(wiringPi初始化失败\n); return 1; } initUltrasonic(); while(1) { float dist getDistance(); printf(距离: %.2f cm\n, dist); delay(500); // 适当延时避免频繁测量 } return 0; }4.2 代码编译与运行编译命令gcc -o ultrasonic ultrasonic.c -lwiringPi运行程序需要root权限sudo ./ultrasonic正常运行时终端会每0.5秒输出一次测量距离。5. 关键代码解析5.1 时间测量原理超声波测距的核心是精确测量时间差。我们使用gettimeofday()函数获取微秒级时间戳struct timeval { time_t tv_sec; // 秒 suseconds_t tv_usec; // 微秒 };时间差计算micros tv.tv_sec * 1000000 tv.tv_usec;5.2 距离计算公式距离计算基于声速和传播时间距离 (时间差 × 声速) / 2其中时间差单位秒声速340m/s 34000cm/s除以2是因为超声波是往返距离5.3 延时控制关键延时参数delayMicroseconds(10): 触发脉冲宽度delay(500): 两次测量间隔提示HC-SR04模块需要至少60ms的测量周期。过高的测量频率会导致读数不稳定。6. 常见问题与调试技巧6.1 返回值为0或异常大可能原因Echo引脚未正确连接物体超出测量范围2cm-450cm电源供电不足解决方法检查所有接线确保被测物体在有效范围内使用独立5V电源给HC-SR04供电6.2 测量值波动大优化方法多次测量取平均值增加测量间隔时间避免测量表面过于光滑的物体改进代码示例#define SAMPLE_TIMES 5 float getAverageDistance() { float sum 0; for(int i0; iSAMPLE_TIMES; i) { sum getDistance(); delay(100); } return sum / SAMPLE_TIMES; }6.3 wiringPi初始化失败可能原因未安装wiringPi未使用sudo运行GPIO被其他进程占用解决方法确认wiringPi安装正确使用sudo权限运行检查是否有其他程序在使用GPIO7. 进阶应用7.1 添加温度补偿声速随温度变化精确测量需补偿float getDistanceWithTemp(float temperature) { // 声速 331.4 0.6 * 温度(℃) m/s float speed (331.4 0.6 * temperature) * 100; // cm/s float time (micros_end - micros_start) / 1000000.0; return (time * speed) / 2; }7.2 使用中断提高精度改进Echo检测方式volatile long start_time, end_time; void echoInterrupt() { if(digitalRead(ECHO_PIN) HIGH) { start_time micros(); } else { end_time micros(); } } // 在init中添加 wiringPiISR(ECHO_PIN, INT_EDGE_BOTH, echoInterrupt);7.3 可视化显示结合Python实现数据可视化import matplotlib.pyplot as plt import subprocess distances [] for i in range(100): output subprocess.check_output([./ultrasonic]) dist float(output.split()[-2]) distances.append(dist) plt.plot(distances) plt.show()8. 项目扩展思路智能避障小车结合电机驱动模块实现自动避障液位监测系统用于水箱或油箱的液位测量手势识别多个超声波模块组合实现简单手势识别安防报警检测区域内是否有物体移动经验分享在实际项目中超声波模块易受环境因素影响。建议在关键应用中加入红外、激光等其他传感器进行数据融合提高系统可靠性。9. 安全注意事项避免长时间短路GPIO引脚不要带电插拔模块测量液体时注意防水工业环境使用时考虑添加隔离电路通过这个项目我们不仅学会了超声波测距的基本原理还掌握了树莓派GPIO编程的基本方法。建议读者尝试修改代码参数观察测量结果的变化这对深入理解超声波测距原理很有帮助。