HC-SR04超声波测距原理与STM32硬件捕获实战-育师

1. HC-SR04超声波传感器原理与工程建模

HC-SR04不是简单的“测距模块”，而是一个基于物理时间差测量的精密模拟前端系统。其核心价值不在于输出一个数字，而在于将不可见的声波传播过程转化为可精确计量的电平持续时间。理解这一点，是避免在实际项目中陷入“读数跳变”、“距离归零”、“响应延迟”等典型问题的前提。

该器件内部集成了超声波发射驱动电路、回波信号放大比较电路以及基础时序控制逻辑。它不执行任何距离计算，所有运算必须由主控MCU完成。这种设计决定了其接口本质是单脉冲触发+单脉冲宽度捕获的纯硬件交互模式，而非SPI/I2C类寄存器访问协议。因此，任何试图用I2C扫描地址或读取内部寄存器的操作都是徒劳的——HC-SR04根本没有寄存器。

工作电压标称为DC 5V，这是其内部振荡器和驱动电路的基准。若接入3.3V系统（如STM32F103C8T6的GPIO），必须注意：其Trigger输入引脚为标准TTL电平兼容，可直接由3.3V MCU驱动；但ECHO输出引脚在空载时可被拉高至5V，若直接连接至3.3V耐压的MCU GPIO，存在长期可靠性风险。工程实践中，应在ECHO输出端串联一个1kΩ限流电阻，并在MCU GPIO与地之间并联一个3.3V稳压二极管（TVS）或使用电阻分压网络（如10kΩ上拉至3.3V，20kΩ下拉至地），以确保输入电压钳位在安全范围内。忽略此点，在批量产品中极易导致MCU IO口批量击穿。

探测范围标称2cm–600cm，但该指标具有强条件依赖性。2cm是理论最小值，实际受限于发射脉冲宽度与接收电路盲区。当目标距离小于10cm时，发射波与反射波在时间域严重重叠，导致比较器无法准确识别上升沿，此时读数通常失效或剧烈跳变。600cm则是理想开阔环境下的极限值，实测中受空气温湿度、目标材质（吸声/散射）、表面倾角影响极大。一块毛玻璃与一面光滑金属板，在相同距离下回波强度可能相差20dB以上。因此，工程设计中必须将“标称参数”视为参考上限，而非保证指标。

精度标称±3mm，这仅在特定条件下成立：环境温度20℃±2℃、相对湿度50%±10%、目标为垂直于声束的刚性平板、表面粗糙度Ra<1μm。声速在空气中并非恒定343m/s，其计算公式为：
$$ c = 331.3 + 0.606 \times T $$
其中 $ c $ 为声速（m/s），$ T $ 为摄氏温度（℃）。在10℃环境下，声速约为337m/s；在30℃时则升至350m/s。这意味着，若固守343m/s常数进行距离换算，在30℃环境下将引入约2%的系统误差。对于要求毫米级精度的应用（如液位监控），必须引入温度传感器（如DS18B20）进行实时声速补偿。

2. 时序规范与硬件接口设计

HC-SR04的时序图是整个系统可靠性的基石，其关键参数不容妥协：

Trigger脉冲：必须为≥10μs的高电平脉冲。低于此阈值，内部状态机无法完成初始化，模块将无任何响应。实践中，为规避噪声干扰与MCU时序抖动，普遍采用20μs脉冲。该脉冲并非“持续使能”，而是一次性触发事件，脉冲结束后模块即进入自主工作状态。
ECHO脉冲宽度：代表超声波往返总时间 $ T_{round} $，单位为微秒（μs）。其宽度范围对应距离：2cm → 116μs（2×2cm×58μs/cm），600cm → 34800μs（2×600cm×58μs/cm）。因此，ECHO高电平宽度理论区间为116–34800μs。
测量周期：两次Trigger触发之间必须间隔≥60ms。这是模块内部压电陶瓷振子的机械阻尼恢复时间。若周期过短，前一次发射的余振尚未衰减完毕，便开始下一次发射，将导致回波信号严重失真，表现为距离读数异常偏小或固定为0。

硬件连接需严格遵循电气特性：
-Trigger引脚：接MCU任意GPIO，配置为推挽输出。因仅需输出，无电平匹配问题，3.3V MCU可直接驱动。
-ECHO引脚：接MCU具备输入捕获（Input Capture）功能的定时器通道（如STM32的TIM2_CH1、TIM3_CH2等）。该引脚输出为开漏结构，内部上拉至5V，故必须通过电平转换保障MCU安全。
-VCC与GND：必须使用独立、低噪声的5V电源供电。严禁与MCU的3.3V电源共用LDO或开关电源的同一路输出。超声波发射瞬间电流尖峰可达15mA，会通过电源地线耦合噪声，导致MCU复位或ADC采样错误。最佳实践是使用专用LDO（如AMS1117-5.0）为HC-SR04单独供电，并在VCC与GND间放置100nF陶瓷电容+10μF电解电容进行高频与低频去耦。

3. STM32定时器输入捕获实现机制

在STM32平台，精确测量ECHO脉冲宽度的核心是输入捕获（Input Capture）功能，而非软件延时循环。后者在中断密集或任务繁重时，极易因MCU响应延迟导致计时误差达数十微秒，完全丧失毫米级精度意义。

以STM32F103C8T6为例，推荐使用TIM2或TIM3（因其具备完整的输入捕获通道），而非字幕中提到的TIM4。TIM4在F103系列中资源有限，且常被用于SysTick或PWM输出，易引发资源冲突。输入捕获的本质是利用定时器计数器（CNT）在指定边沿（上升沿/下降沿）到来时，自动将当前CNT值锁存至捕获/比较寄存器（CCR）。整个过程由硬件完成，无需CPU干预，精度等于定时器时钟周期。

具体配置流程如下：
1.时钟使能：开启APB1总线时钟RCC_APB1PeriphClockCmd(RCC_APB1PERIPH_TIM2, ENABLE)；
2.GPIO复用配置：将ECHO连接的GPIO（如PA0）配置为复用推挽输出GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING，并映射至TIM2_CH1；
3.定时器基础配置：
c TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_TimeBaseStructure.TIM_Period = 0xFFFF; // 自动重装载值，决定计数范围 TIM_TimeBaseStructure.TIM_Prescaler = 71; // 预分频系数，72MHz/(71+1)=1MHz，即1μs/计数 TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, &TIM_TimeBaseStructure);
此处预分频设为71，是关键。F103主频72MHz，经72分频后，定时器计数频率为1MHz，即每个计数代表1μs。这使得后续对CCR寄存器的读数可直接视为微秒值，极大简化计算。
4.输入捕获通道配置：
c TIM_ICInitTypeDef TIM_ICInitStructure; TIM_ICInitStructure.TIM_Channel = TIM_Channel_1; TIM_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Rising; // 捕获上升沿（ECHO变高） TIM_ICInitStructure.TIM_ICSelection = TIM_ICSelection_DirectTI; TIM_ICInitStructure.TIM_ICPrescaler = TIM_ICPSC_DIV1; TIM_ICInitStructure.TIM_ICFilter = 0x0; // 滤波器关闭，依赖硬件抗抖 TIM_ICInit(TIM2, &TIM_ICInitStructure);
5.中断使能与启动：
c TIM_ITConfig(TIM2, TIM_IT_CC1, ENABLE); // 使能捕获中断 NVIC_EnableIRQ(TIM2_IRQn); // 使能NVIC中断 TIM_Cmd(TIM2, ENABLE); // 启动定时器 TIM_CCxCmd(TIM2, TIM_Channel_1, ENABLE); // 使能捕获通道

中断服务函数（ISR）需处理两个边沿：
-首次中断（上升沿）：记录CNT值作为起始时间ic1_val = TIM_GetCapture1(TIM2);
-二次中断（下降沿）：再次读取CNT值ic2_val = TIM_GetCapture1(TIM2);，计算差值pulse_width = ic2_val - ic1_val;。若结果为负，说明发生溢出，需加上自动重装载值pulse_width += 0x10000;

此方法硬件级捕获，误差稳定在±1个计数（±1μs），对应距离误差±0.017cm，远优于软件循环的不确定性。

4. 距离换算模型与温度补偿策略

将捕获到的脉冲宽度 $ T_{\mu s} $（单位：微秒）转换为物理距离 $ D $（单位：厘米），存在两种等效数学模型，其本质相同，但适用场景不同：

4.1 基于声速常数的直接模型

最常用公式为：
$$ D = \frac{T_{\mu s}}{58} $$
此式源于声速 $ c = 343 $ m/s = 34300 cm/s，单程时间 $ t = T_{\mu s}/2 $ μs = $ T_{\mu s}/2 \times 10^{-6} $ s，则：
$$ D = c \times t = 34300 \times \frac{T_{\mu s}}{2} \times 10^{-6} = \frac{T_{\mu s}}{58.3} \approx \frac{T_{\mu s}}{58} $$
因此，“除以58”是343m/s声速下的近似，其物理含义是：每58微秒的往返时间，对应1厘米的距离。该模型简洁高效，适用于环境温度稳定在20℃±5℃的室内应用。

4.2 基于实时声速的动态模型

当精度要求高于±1cm，或工作环境温度波动大（如户外、工业现场）时，必须引入温度补偿。声速 $ c $ 与温度 $ T $ 的关系为：
$$ c = 331.3 + 0.606 \times T $$
则距离公式修正为：
$$ D = \frac{c \times T_{\mu s} \times 10^{-6}}{2} \times 100 = \frac{(331.3 + 0.606 \times T) \times T_{\mu s}}{20000} $$
其中 $ T $ 为摄氏温度（℃），$ T_{\mu s} $ 为捕获脉宽（μs）。此式虽稍复杂，但可在嵌入式系统中通过定点运算高效实现。例如，使用Q15格式（16位整数，小数点后15位）计算，避免浮点运算开销。

4.3 工程中的鲁棒性增强

无论采用何种模型，实际部署中必须加入数据滤波与异常剔除：
-多次采样均值滤波：连续采集5–10次，剔除最大与最小值后取平均。此举可有效抑制单次回波丢失或噪声干扰导致的野值。
-距离有效性校验：对计算结果 $ D $ 设置硬性边界。若 $ D < 2 $ 或 $ D > 500 $，判定为无效数据，返回错误码或维持上次有效值。这比盲目显示一个荒谬数值（如-999或9999）更具工程意义。
-变化率限制（Rate Limiting）：对距离值施加一阶低通滤波或最大变化率约束。例如，设定每100ms内距离变化不得超过5cm。这能有效抑制因手部快速晃动或风扇气流扰动引起的虚假跳变，使数据显示更符合人眼观察习惯。

5. HAL库与标准外设库的工程选择

字幕中提及使用“红利液”（应为“HAL库”的语音误识），这触及一个关键的工程决策点：在STM32项目中，究竟应选用HAL库、LL库还是标准外设库（StdPeriph）？

HAL库（Hardware Abstraction Layer）：优势在于高度抽象与跨系列移植性，HAL_TIM_IC_Start_IT()等API封装了底层寄存器操作。但其代码体积大、执行效率低、中断响应延迟高（函数调用开销+参数检查），对于需要微秒级精确捕获的HC-SR04，HAL的HAL_TIM_ReadCapturedValue()在高负载下可能引入不可预测的延迟。
LL库（Low-Layer）：是ST官方推荐的轻量级替代方案。它提供接近寄存器操作的性能，同时保持一定抽象，LL_TIM_IC_EnableIT()直接操作位带，无函数调用开销。对于F1系列，LL库支持完备，是输入捕获类应用的优选。
标准外设库（StdPeriph）：虽已停止更新，但其代码精炼、时序确定性强，TIM_ICInit()配置直观，TIM_GetCapture1()返回即用。在F103等成熟平台上，其稳定性与性能经过大量项目验证，仍是许多工程师的首选。

本例中，若坚持使用HAL库，则必须绕过高层API，直接操作寄存器以确保时序：

// 在HAL_TIM_IC_CaptureCallback()中，避免调用HAL_TIM_ReadCapturedValue() // 改为直接读取CCR寄存器 uint32_t cap_val = __HAL_TIM_GET_COUNTER(&htim2); // 获取当前计数 uint32_t ic_val = READ_REG(htim2.Instance->CCR1); // 直接读CCR1

否则，HAL的回调函数本身可能耗时超过10μs，导致捕获失效。

6. 完整驱动代码实现与调试要点

以下为基于STM32F103C8T6与LL库的HC-SR04驱动核心代码，省略了OLED与串口部分，聚焦于超声波测量本体：

#include "stm32f1xx_ll_tim.h" #include "stm32f1xx_ll_gpio.h" #include "stm32f1xx_ll_rcc.h" #define TRIG_GPIO_PORT LL_GPIO_PORT_A #define TRIG_GPIO_PIN LL_GPIO_PIN_2 #define ECHO_GPIO_PORT LL_GPIO_PORT_A #define ECHO_GPIO_PIN LL_GPIO_PIN_0 static uint32_t pulse_start = 0; static uint32_t pulse_width = 0; static volatile uint8_t capture_flag = 0; void HC_SR04_Init(void) { // 使能GPIOA与TIM2时钟 LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_GPIOA); LL_APB1_GRP1_EnableClock(LL_APB1_GRP1_PERIPH_TIM2); // 配置TRIG为推挽输出 LL_GPIO_SetPinMode(GPIOA, LL_GPIO_PIN_2, LL_GPIO_MODE_OUTPUT); LL_GPIO_SetPinOutputType(GPIOA, LL_GPIO_PIN_2, LL_GPIO_OUTPUT_PUSHPULL); LL_GPIO_SetPinSpeed(GPIOA, LL_GPIO_PIN_2, LL_GPIO_SPEED_FREQ_HIGH); LL_GPIO_ResetOutputPin(GPIOA, LL_GPIO_PIN_2); // 配置ECHO为浮空输入（复用功能由TIM配置） LL_GPIO_SetPinMode(GPIOA, LL_GPIO_PIN_0, LL_GPIO_MODE_FLOATING); // 配置TIM2：1MHz计数频率（72MHz / 72） LL_TIM_SetPrescaler(TIM2, 71); LL_TIM_SetAutoReload(TIM2, 0xFFFF); LL_TIM_SetCounterMode(TIM2, LL_TIM_COUNTERMODE_UP); LL_TIM_EnableARRPreload(TIM2); // 配置TIM2_CH1为输入捕获（ECHO接PA0） LL_TIM_IC_SetPolarity(TIM2, LL_TIM_CHANNEL_CH1, LL_TIM_IC_POLARITY_RISING); LL_TIM_IC_SetFilter(TIM2, LL_TIM_CHANNEL_CH1, LL_TIM_IC_FILTER_FDIV1); LL_TIM_IC_SetPrescaler(TIM2, LL_TIM_CHANNEL_CH1, LL_TIM_ICPSC_DIV1); LL_TIM_IC_SetActiveInput(TIM2, LL_TIM_CHANNEL_CH1, LL_TIM_ACTIVEINPUT_DIRECTTI); // 使能捕获中断与更新中断 LL_TIM_EnableIT_CC1(TIM2); LL_TIM_EnableIT_UPDATE(TIM2); // 使能TIM2 LL_TIM_EnableCounter(TIM2); } void HC_SR04_Trigger(void) { LL_GPIO_SetOutputPin(GPIOA, LL_GPIO_PIN_2); LL_mDelay(20); // 20μs高电平 LL_GPIO_ResetOutputPin(GPIOA, LL_GPIO_PIN_2); } uint32_t HC_SR04_GetDistanceCM(void) { uint32_t distances[5]; uint32_t sum = 0; uint32_t min, max, avg; for (int i = 0; i < 5; i++) { capture_flag = 0; HC_SR04_Trigger(); // 等待捕获完成，超时保护 uint32_t timeout = 10000; while (!capture_flag && timeout--) { __NOP(); } if (timeout == 0) { distances[i] = 0; // 超时，无效 } else { distances[i] = pulse_width / 58; // 标准换算 } } // 简单排序求中值（剔除极值） for (int i = 0; i < 4; i++) { for (int j = 0; j < 4 - i; j++) { if (distances[j] > distances[j + 1]) { uint32_t tmp = distances[j]; distances[j] = distances[j + 1]; distances[j + 1] = tmp; } } } return distances[2]; // 返回中值 } // TIM2中断服务函数 void TIM2_IRQHandler(void) { uint32_t isr = LL_TIM_ReadReg(TIM2, SR); uint32_t cnt = LL_TIM_ReadReg(TIM2, CNT); if (LL_TIM_IsActiveFlag_CC1(TIM2) && LL_TIM_IsEnabledIT_CC1(TIM2)) { if (LL_TIM_IC_GetPolarity(TIM2, LL_TIM_CHANNEL_CH1) == LL_TIM_IC_POLARITY_RISING) { // 上升沿：记录起始时间 pulse_start = LL_TIM_IC_ReadCaptureCH1(TIM2); LL_TIM_IC_SetPolarity(TIM2, LL_TIM_CHANNEL_CH1, LL_TIM_IC_POLARITY_FALLING); } else { // 下降沿：计算脉宽 uint32_t pulse_end = LL_TIM_IC_ReadCaptureCH1(TIM2); if (pulse_end >= pulse_start) { pulse_width = pulse_end - pulse_start; } else { pulse_width = (0x10000 - pulse_start) + pulse_end; } capture_flag = 1; LL_TIM_IC_SetPolarity(TIM2, LL_TIM_CHANNEL_CH1, LL_TIM_IC_POLARITY_RISING); } LL_TIM_ClearFlag_CC1(TIM2); } if (LL_TIM_IsActiveFlag_UPDATE(TIM2) && LL_TIM_IsEnabledIT_UPDATE(TIM2)) { LL_TIM_ClearFlag_UPDATE(TIM2); } }

关键调试要点：
-示波器验证：务必使用示波器观测TRIG脉冲宽度是否严格≥20μs，ECHO脉冲是否在TRIG发出后约500μs（对应10cm）出现，且宽度随距离增加而线性增长。这是排除硬件连接与电源问题的第一步。
-中断优先级：确保TIM2中断优先级高于其他非关键中断（如串口接收），防止高优先级中断抢占导致捕获丢失。在NVIC中设置为NVIC_SetPriority(TIM2_IRQn, 1);。
-全局中断开关：在HC_SR04_GetDistanceCM()的等待循环中，若系统启用了FreeRTOS，__NOP()可能被调度器打断。此时应使用临界区保护：taskENTER_CRITICAL(); ... taskEXIT_CRITICAL();。
-电源纹波测试：用示波器直流耦合观测HC-SR04的VCC引脚，确认无超过50mV的高频纹波。若存在，增加π型滤波（100nF + 10μH + 100nF）。