简介HC-SR04超声波测距模块资料包针对电子爱好者、单片机初学者及机器人/物联网项目开发者围绕40kHz超声波收发原理整理了TRIG与ECHO引脚时序、回波时间计算距离的方法及多场景应用说明。包内共有61个文件RAR压缩包仅1.8MB包含Keil工程源码.c/.hex/.uv2、PIC单片机C程序、接线示意图.jpg及PDF数据手册并细分为LCD1602、LCD12864、数码管、串口四种显示方案每种方案均配有完整工程和脉宽测量示例方便直接烧录验证。资料还收入了串口通信与显示模块的接线说明以及2cm-400cm量程、物体材质影响等使用注意事项可帮助读者理解如何将传感器接入不同主控处理常见噪声和多目标测量问题。目前已有1120人学习下载适合作为课堂实验、课程设计或DIY避障小车的参考包。1. HC-SR04 到底值不值得下一个 5 块钱模块引发的测距暗战在 IOT 和机器人小车项目里HC-SR04 几乎是唯一一个不用看芯片手册就能上手的测距方案。四根杜邦线一插GPIO 拉高触发脚 10 微秒回波脚高电平持续时间除以 58 微秒就是厘米数这套逻辑我闭着眼都能背出来。可真正把模块放进液位报警器和避障小车里跑起来你会发现所谓“误差 3mm”的字面参数和实测数据完全是两回事。超声波模块的资料包看似满网都是但多数只给时序图和示例代码硬件极限、供电纹波、反射面材质对结果的干扰没人提前告诉你。这份 HC-SR04 资料包解决的问题不是“帮你把模块点亮”而是“让你在真实环境里拿到稳定、可解释、可复现的距离数据”。它适合两类人一类是刚接触单片机、想看明白回波时序的新手另一类是已经在用模块但总被跳变数值折磨想系统排查问题根源的爱好者或工程师。哪怕只是临时做一个水位监测原型里面关于声速补偿和噪声滤波的整理也能少走一大截弯路。2. 测距原理与参数边界为什么 3mm 是实验室数据而不是实测数据2.1 超声波测距的核心逻辑与回波判断难点超声波测距的本质是测时间发射探头发出 40kHz 的脉冲串声波碰到障碍物反射回来接收探头把声压变化转成电信号单片机测量“发出到收到”的时间差 t再用声速 c 计算距离 d c × t / 2。除 2 是因为声波走了一个来回这个大家都懂。难点在于回波的判断。障碍物表面不可能是理想平面声波打到倾斜表面、软性表面或边缘时返回的波形会被拉长、衰减甚至切割成一个不完整脉冲。HC-SR04 模块内部比较器是按照信号幅值是否超过固定阈值来输出高电平的所以同一次测量里箭头指向的第一个波峰不一定能被识别成“有效回波”。这也是为什么对着墙角测量结果很准对着人腿或泡沫板测量数值会忽大忽小的原因。模块上的两颗圆柱体一个是发射探头 T一个是接收探头 R中间那块黑色隔音棉是为了减小直达声干扰。两个探头旁边通常有一排 4 个排针总共四个引脚VCC供电、Trig触发、Echo回波输出、GND地。资料包里有清楚标注但我见过很多人把 Trig 和 Echo 接反模块不工作还以为是硬件坏了。2.2 关键参数表与两种工作模式的取舍拿到手后先看背面丝印HC-SR04 有好几个版本老款是双引脚直插探头新款有的把探头换成金属外壳封闭式。资料包里整理的参数表通常是这样的参数数值实际使用说明工作电压5V DC低于 4.5V 时输出幅值下降远距测量易丢波静态电流 2mA待机时电平状态不影响触发测量范围2cm - 400cm靠近盲区小于 2cm大于 4m 数据不可靠测量角度 15°超过 15° 回波减弱强反射面可以放宽分辨率1cm 档位实际受声速补偿和计时精度影响精度±3mm实验室实测受温漂、供电、反射面影响更大触发信号10μs TTL 高电平低于 8μs 不产生发射脉冲回波信号与距离成比例的高电平高电平宽度约 150μs 到 25ms工作频率40kHz不建议与其他 40kHz 设备同时运行选购时如果用在室外、水管水位或者有蒸汽的环境建议直接换 JSN-SR04T 这类探头分离的防水版本。HC-SR04 的开放式探头防尘不防水湿度大时声波在探头表面的衰减会直接拉低回波幅值。资料包里若附带两种模块的对照通常还会给出接线差异JSN-SR04T 用的是 5V 三线制Trig 和 Echo 合并在一根线上读法也完全不同不能照搬 HC-SR04 的代码。2.3 声速不是常量温漂带来的系统误差绝大多数示例代码把声速固定成 340m/s但 0℃ 时声速约 331m/s30℃ 时约 349m/s差别接近 5%。在一个 2m 的测量距离上这个误差会带来约 3cm 的偏差比模块本身标称的 ±3mm 大了整整一个数量级。资料包里的补偿公式通常是c 331.4 0.6 * TT 为摄氏温度如果你的单片机系统里恰好有温湿度传感器比如 DHT11、BME280把温度读进来再做声速修正非常简单。没有温度传感器时至少把声速写成一个可配置的全局变量方便在季节变化时手动校调而不是改完重新编译。这个细节很多教程不写但真做长时间数据记录时影响很明显。3. 接线与采集代码一份能直接烧录进三种平台的驱动流程3.1 引脚定义与供电选择先解决电平兼容问题HC-SR04 的 Trigger 是输入引脚逻辑高电平触发Echo 是输出引脚高电平持续时间代表声波飞行时间。Echo 在 5V 供电时输出高电平幅度接近 5V如果你的主控是 3.3V 的 ESP32、STM32F1 系列或树莓派 GPIO直连会存在超压风险。常见的处理方式是给 Echo 脚串联一个 1kΩ 电阻再做分压到 3.3V或者在中间加一片电平转换芯片。我一般习惯用分压Echo 串联 1kΩ再接一个 2kΩ 电阻到 GND分压点接 MCU GPIO这样 5V 电平被削到约 3.3V。Trigger 脚从 3.3V MCU 输出高电平 3.3V 对 HC-SR04 来说识别没问题实测触发可靠不需要额外放大。接线顺序建议是先把 VCC 和 GND 接好再插 Trigger 和 Echo避免接反烧掉模块。VCC 供电必须干净如果从电机驱动板的同一路取电电机转动瞬间的纹波会让 Echo 输出抖动距离数据随机跳 2cm 到 5cm。我从一个避障小车的项目里得来的血泪经验单独用一片 LM1117-5.0 给传感器供电跳变立刻消失。3.2 最短可运行代码Arduino 平台下的采集与滤波资料包里最常见的示例是 Arduino 版本因为 pulseIn 函数把繁琐的脉冲计时封装好了。一个能直接烧录的最小系统如下#define TRIG_PIN 9 #define ECHO_PIN 10 void setup() { pinMode(TRIG_PIN, OUTPUT); pinMode(ECHO_PIN, INPUT); Serial.begin(9600); } float readDistance() { // 清空引脚电平确保触发前为低 digitalWrite(TRIG_PIN, LOW); delayMicroseconds(2); // 产生至少 10us 的高电平触发脉冲 digitalWrite(TRIG_PIN, HIGH); delayMicroseconds(10); digitalWrite(TRIG_PIN, LOW); // 高电平宽度就是声波往返时间单位 us long duration pulseIn(ECHO_PIN, HIGH, 30000); if (duration 0) { return -1; // 超时未收到回波 } // duration / 58 是常见的厘米换算实际是声速与往返的简化 float cm duration / 58.0; return cm; } void loop() { float d readDistance(); if (d 0 d 400) { Serial.print(Distance: ); Serial.print(d); Serial.println( cm); } else { Serial.println(Out of range); } delay(200); // 测量间隔至少 20ms留足声波衰减时间 }这里需要解释两点第一pulseIn 第三个参数是超时微秒数30ms 对应约 5m 距离超过这个时间没有跳变就返回 0第二delay(200) 不是随便写的超声波发射后余振会持续一段时间两次测量间隔太短会让接收探头把上一次的残余振铃当成新回波出现“穿墙”的假数据。间隔 200ms 保守但稳定。3.3 STM32 平台的实现不用阻塞也能读距离Arduino 代码方便但在 STM32 上用 HAL 库时pulseIn 没了很多人卡在计时方式上。最直接的做法是用定时器输入捕获或者像我一样用 DWT数据观察点与跟踪单元的内核周期计数器不需要额外配置定时器通道// 先使能 DWT 计数器 CoreDebug-DEMCR | CoreDebug_DEMCR_TRCENA_Msk; DWT-CYCCNT 0; DWT-CTRL | DWT_CTRL_CYCCNTENA_Msk; void HC_SR04_Trigger(void) { HAL_GPIO_WritePin(TRIG_PORT, TRIG_PIN, GPIO_PIN_RESET); delay_us(2); HAL_GPIO_WritePin(TRIG_PORT, TRIG_PIN, GPIO_PIN_SET); delay_us(10); HAL_GPIO_WritePin(TRIG_PORT, TRIG_PIN, GPIO_PIN_RESET); } float HC_SR04_ReadCm(void) { HC_SR04_Trigger(); // 等 Echo 拉高 while (HAL_GPIO_ReadPin(ECHO_PORT, ECHO_PIN) GPIO_PIN_RESET); uint32_t start DWT-CYCCNT; // 等 Echo 拉低 while (HAL_GPIO_ReadPin(ECHO_PORT, ECHO_PIN) GPIO_PIN_SET); uint32_t duration DWT-CYCCNT - start; // 根据内核频率把周期数换算成微秒 float us (float)duration / (SystemCoreClock / 1000000.0); return us / 58.0; }DWT 计数的关键点是 Unit 是 CPU 主频周期数比如 72MHz 下 1us 等于 72 个计数换算成微秒后再按 /58 折算成厘米。这里有个隐蔽问题在中断频繁的系统中Echo 等待循环里面如果被中断打断测得的脉冲宽度会被拉长所以最好屏蔽最高优先级中断或在定时器中断里独立处理。ST 的免费工具链里通常集成了 DWT 相关库资料包若基于标准外设库也是同样的思路。3.4 数据滤波中值滤波比平均值更抗突发干扰拿到一串距离值之后最常见的处理是先算平均。但平均值对离群点很敏感一个突然的 400cm 假回波会把均值拉得很难看。我一般用滑动中值滤波取连续 5 次采样排序后取中间值再对中间值做一次轻量 EMA 平滑。#define FILTER_SIZE 5 float filterBuffer[FILTER_SIZE]; int filterIndex 0; float medianFilter(float newValue) { filterBuffer[filterIndex] newValue; filterIndex (filterIndex 1) % FILTER_SIZE; // 复制数组并排序 float temp[FILTER_SIZE]; for (int i 0; i FILTER_SIZE; i) temp[i] filterBuffer[i]; for (int i 0; i FILTER_SIZE - 1; i) { for (int j i 1; j FILTER_SIZE; j) { if (temp[j] temp[i]) { float t temp[i]; temp[i] temp[j]; temp[j] t; } } } return temp[FILTER_SIZE / 2]; }这段代码直接放在 budget 型单片机上也没问题5 个数排序只有十几次比较耗时在微秒级。实际效果是倾斜反射面带来的偶发跳变被完全过滤而真实距离变化因为连续采样仍然能跟上。资料包里如果附带的是 Python 上位机处理脚本原理也相同只是把数组写成 list。4. HC-SR04 实战排错六个高频事故与解决路径4.1 近距离数值偏大发射拖尾掩盖了首波现象障碍物离探头 3cm 时读到 10cm 甚至 25cm但距离拉远到 30cm 以上就准确了。原因声波发射时探头自身有机械余振接收电路在前几百微秒内会被强信号锁住短距离内回波到达得太快混在发射拖尾里比较器无法准确触发。解决遇到必须测近距的场景要么把模块倾斜安装让回波路径加长要么直接把小于 5cm 的输出值剔除这是绝大多数方案的做法。靠近盲区的数据本来就不可信不值得为了它去改硬件阈值。4.2 数据跳变但供电正常反射面材质和角度在作怪现象对着瓷砖墙面测量非常稳对着布料沙发或圆柱形水桶数值每秒跳 3cm 以上。原因软性表面吸收声波回波幅值低于模块内部的触发阈值圆柱面把声波反射到其他方向只有少量散射波能回到接收头。解决改用更大反射板做辅助或者调整模块安装角度让声波垂直打到目标表面。如果是液位测量浮子或金属导波管是可选方向。软件层面把上一小节的中值滤波窗口从 5 加到 9能明显抑制偶发跳变。4.3 Echo 一直低电平触发脉宽不足或电平不匹配现象Trig 给了高电平但 Echo 始终为低串口打印超时。原因触发脉冲宽度不足 10μs尤其是用循环延时实现的用户最高优先级中断抢走一段时间后脉宽被压缩另一种可能是 Trig 电平没有真正拉高到模块识别的阈值。解决先用示波器或逻辑分析仪抓 Trig 引脚波形确认高电平宽度。常见做法是把触发宽度加长到 15μs留出余量。我见过有人在一个实时系统中反复用 HAL_Delay(1) 代替微秒延时结果脉宽变成 1ms 或更乱触发反而失败用 DWT 精确延时后稳定。4.4 多个模块同时工作串扰回波张冠李戴现象两个 HC-SR04 并排放置同时触发左边模块读出的距离明显受到右边方向障碍物的影响。原因两个模块都以 40kHz 发射脉冲接收端无法区分是自己的回波还是对方模块的发射波。解决让各模块的触发时间错开 50ms 以上。代码里做成一个简单的调度器按顺序触发每个模块避免同一时刻两个模块都在飞行等待。50ms 对应 17m 的测量距离普通场景足够隔离。4.5 3.3V 主控直接接 Echo引脚烧毁或者读数飘现象ESP32 开发板读取 HC-SR04 时某个 GPIO 偶发损坏或者读数一直偏大 2cm。原因Echo 输出高电平在 5V 供电时约为 5VESP32 的 GPIO 耐压上限接近 3.6V虽然没有立刻烧毁但长时间电平过压会让引脚内部保护二极管漏电电平阈值漂移。解决加 1kΩ 串联电阻分压再并联 2kΩ 到地把电平限制在 3.3V 左右。这是最便宜的方案也最容易被人忽略。4.6 一上电就读数异常且串口乱码模块供电电流不够现象连接好之后打开串口距离值乱飞且夹杂乱码手靠近传感器也没有稳定响应。原因USB 转 TTL 或开发板上的 LDO 最大输出电流不足HC-SR04 在发射瞬间电流可达 20mA多个模块同时触发时峰值电流更高电压被拉低主控也受牵连。解决外部接一路 5V 稳压给模块单独供电GND 与主控共地。测量一下 VCC 引脚纹波超过 100mV 就要处理。5. 进阶调校把 HC-SR04 从玩具变成测量工具5.1 声速温度补偿的工程落地前面提到声速公式这里给出一个实际可用的校准流程先在同一位置放一把卷尺模块对准 100cm 处的平面反射板读取原始时间值用于换算再用一个温度传感器读取当前温度用公式 c 331.4 0.6 × T 实时计算声速。把代码里的 /58 改成浮点变量后不同温度下的误差能压到 1cm 左右。float temperature readTemperature(); // 来自 BME280 或 DHT11 float speedOfSound 331.4f 0.6f * temperature; float distance (duration_us / 1000000.0f) * speedOfSound / 2.0f * 100.0f;用这个逻辑替换固定声速换算后测量 3m 处的墙面夏天和冬天的数据一致性明显提升。没有温湿度传感器时在菜单里保留一个人工输入温度的变量也能解决一部分季节误差。5.2 回波波形观察示波器比串口更诚实模块的 Echo 引脚输出只有高电平时间看不到回波幅值变化。如果想确认是“模块坏了”还是“环境太差”直接测接收探头两端是最直观的发射后约几百微秒会出现一串振荡波形幅值越高代表回波越强。我通常把示波器时基调到 5ms/div触发模式设为单次再对着模块前方拍手能清楚看到回波幅度逐渐衰减的过程。注意功率别超过探头承受范围HC-SR04 的发射强度在空气中没有危险性但不要拿耳朵贴近发射探头持续听毕竟是 40kHz 高频声波虽然人耳不敏感长时间高强度的超声暴露也不建议。5.3 多传感器轮询的时序优化在小车防撞场景里前向、左向、右向各装一个模块很常见。轮询逻辑不要写在 main loop 里靠 delay 硬等因为每个模块的飞行时间最长可达 30ms三个模块串行轮询会让响应变慢。我习惯用一个 50ms 周期定时器每个周期触发一个模块读取结果后立即进入下一个模块的等待这样整体刷新率约 20Hz并且不会出现两个模块同时发射的问题。typedef enum { SENSOR_FRONT, SENSOR_LEFT, SENSOR_RIGHT, SENSOR_COUNT } sensor_id_t; sensor_id_t current_sensor SENSOR_FRONT; void timer_callback(void) { // 每次只触发当前传感器测量完切换下一个 HC_SR04_Trigger(current_sensor); uint32_t t HC_SR04_ReadRaw(); distance_cache[current_sensor] t / 58.0f; current_sensor (current_sensor 1) % SENSOR_COUNT; }实际上手时给每个模块的 Echo 接独立 GPIOTrig 也独立控制互不影响。三模块同时安装时夹角尽量大于 30°减少边缘衍射造成的反射重叠。5.4 模块的“体检”新批次到货先跑一遍基准测试买了一批模块有些焊点工艺不一致同一个位置测出来的值能差 1cm。我的检验方法很简单固定一个 100cm 的反射板每个模块连续测 30 次计算平均值和标准差平均值偏离超过 1.5cm 或方差超过 0.4cm² 的模块直接标记为“只能做粗略接近开关用”不参与精确测距。批量测试时会顺便把触发最小脉宽也测了逐步降脉宽到 8μs、5μs看哪一颗模块在 8μs 以下仍能稳定触发。对用电池供电的低功耗设备来说缩短触发脉宽能省下若干微安电流虽然有限但蚊子腿也是肉。从那以后我每次拿到新批次 HC-SR04 模块都会先跑一遍这个 100cm 基准测试把表现最好的模块分配给关键测距点剩下的留给避障这类“差不多就行”的场景。材料里整理的标准测试步骤和判定阈值下载后可以直接拿来当验收清单希望帮到你。本文还有配套的精品资源点击获取