STM32实战指南：HY-SRF05超声波模块从硬件对接到精准测距

引言

第一次拿到HY-SRF05超声波模块时，看着那五个神秘的引脚和不到巴掌大的电路板，我完全没料到这个小东西会成为我嵌入式开发路上的重要里程碑。作为STM32开发中最常用的距离检测方案之一，超声波模块以其成本低廉、使用简单的特点，成为新手接触硬件交互的理想起点。但看似简单的"发射-接收"原理背后，藏着不少需要特别注意的硬件细节和代码技巧。

本文将带你从最基础的电路连接开始，逐步深入到定时器中断与信号处理的代码实现。不同于单纯复制粘贴的示例代码，我会重点分享在实际项目中积累的调试经验——比如为什么同样的代码昨天测距准确今天却飘忽不定？为什么模块偶尔会输出明显错误的超大数值？这些实战中才会遇到的问题，往往才是真正阻碍项目进展的关键。

1. 硬件连接与模块工作原理

1.1 HY-SRF05引脚功能解析

打开静电防护袋取出HY-SRF05模块，首先映入眼帘的是五个金属引脚：VCC、GND、TRIG、ECHO和OUT。虽然市面上不同批次的模块可能引脚排列顺序略有差异，但功能定义基本一致：

重要提示：模块对电源波动极为敏感。我的经验是，当使用USB供电的开发板时，务必在VCC和GND之间并联一个100μF的电解电容，这能显著减少因电源噪声导致的测量误差。

1.2 硬件连接实战

根据STM32F103C8T6核心板的引脚布局，推荐以下连接方案：

c复制// 推荐连接方式（以STM32F103C8T6为例）
HY-SRF05 VCC  -> 开发板5V输出
HY-SRF05 GND  -> 开发板GND
HY-SRF05 TRIG -> PB8 (通用推挽输出)
HY-SRF05 ECHO -> PB9 (浮空输入，开启中断)

连接时需要特别注意的操作顺序：

1. 先断开开发板电源
2. 连接GND线确保共地
3. 再接VCC电源线
4. 最后连接信号线(TRIG/ECHO)

我曾因为带电插拔烧毁过两个模块，后来发现是因为热插拔时引脚间瞬时电位差导致了内部电路击穿。这个教训价值60元，现在免费送给你。

2. 超声波测距核心原理

2.1 时序逻辑深度解析

HY-SRF05的工作流程就像声纳系统的小型化版本，整个过程可以分为三个阶段：

1. 触发阶段：给TRIG引脚至少10μs的高电平脉冲
2. 发射阶段：模块自动发射8个40kHz的超声波脉冲
3. 回波检测：模块监听反射波并计算时间差

这个过程的精确时序控制是测距准确的关键。通过示波器捕获的实际信号显示，从TRIG上升沿到ECHO上升沿的延迟通常在500μs左右（对应模块内部电路启动时间），而ECHO高电平持续时间与距离成正比。

2.2 距离计算公式的物理本质

教科书上给出的距离公式看起来简单：

code复制距离 = (高电平时间 × 声速) / 2

但实际应用中需要考虑三个重要因素：

1. 声速的温度补偿：声速在空气中约为343m/s（25℃时），但会随温度变化：

   code复制v = 331.4 + 0.6 × T （T为摄氏温度）
   

2. 信号处理延迟：模块内部电路约有0.3ms的固定处理时间
3. 多次测量滤波：由于声波反射的不确定性，建议采用中值滤波算法

在我的智能小车项目中，加入温度传感器实时校正声速后，测距精度从±1cm提升到了±3mm。

3. 代码实现与优化

3.1 基础驱动代码

先实现最基本的触发和测量功能，使用HAL库可以这样编写：

c复制// 超声波模块初始化
void Ultrasonic_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    
    // TRIG引脚配置（输出模式）
    GPIO_InitStruct.Pin = GPIO_PIN_8;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
    HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
    
    // ECHO引脚配置（输入模式）
    GPIO_InitStruct.Pin = GPIO_PIN_9;
    GPIO_InitStruct.Mode = GPIO_MODE_IT_RISING_FALLING;
    GPIO_InitStruct.Pull = GPIO_PULLDOWN;
    HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
    
    // 配置NVIC中断
    HAL_NVIC_SetPriority(EXTI9_5_IRQn, 0, 0);
    HAL_NVIC_EnableIRQ(EXTI9_5_IRQn);
    
    // 初始化定时器2用于时间测量
    htim2.Instance = TIM2;
    htim2.Init.Prescaler = 72-1; // 1MHz计数频率
    htim2.Init.CounterMode = TIM_COUNTERMODE_UP;
    htim2.Init.Period = 0xFFFFFFFF;
    HAL_TIM_Base_Init(&htim2);
}

3.2 中断服务程序实现

ECHO引脚的中断处理是整个系统的核心，需要精确捕获上升沿和下降沿：

c复制volatile uint32_t start_time = 0;
volatile uint32_t end_time = 0;
volatile float distance_cm = 0;

void EXTI9_5_IRQHandler(void)
{
    if(__HAL_GPIO_EXTI_GET_IT(GPIO_PIN_9) != RESET)
    {
        if(HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_9) == GPIO_PIN_SET) 
        {
            // 上升沿（开始计时）
            start_time = TIM2->CNT;
            __HAL_TIM_SetCounter(&htim2, 0);
            HAL_TIM_Base_Start(&htim2);
        }
        else 
        {
            // 下降沿（停止计时）
            end_time = TIM2->CNT;
            HAL_TIM_Base_Stop(&htim2);
            
            // 计算距离（单位：cm）
            uint32_t pulse_width = end_time - start_time;
            distance_cm = pulse_width * 0.034 / 2;
            
            // 有效距离范围检测
            if(distance_cm < 2 || distance_cm > 450) {
                distance_cm = 0; // 超出量程视为无效
            }
        }
        __HAL_GPIO_EXTI_CLEAR_IT(GPIO_PIN_9);
    }
}

3.3 高级优化技巧

经过多次项目迭代，我总结出几个显著提升稳定性的编码技巧：

1. 动态超时检测：添加超时机制避免死等回波

   c复制#define ECHO_TIMEOUT 30000 // 30ms超时（对应约5m距离）
   
   uint32_t timeout = 0;
   while(HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_9) && (timeout++ < ECHO_TIMEOUT));
   

2. 移动平均滤波：消除单次测量误差

   c复制#define FILTER_SIZE 5
   float distance_buffer[FILTER_SIZE] = {0};
   
   // 在获取新值后调用
   float apply_filter(float new_value)
   {
       static uint8_t index = 0;
       distance_buffer[index++ % FILTER_SIZE] = new_value;
       
       float sum = 0;
       for(uint8_t i=0; i<FILTER_SIZE; i++) {
           sum += distance_buffer[i];
       }
       return sum / FILTER_SIZE;
   }
   

3. 自动重试机制：当检测到异常值时自动重新触发

   c复制uint8_t retry_count = 0;
   do {
       HAL_GPIO_WritePin(GPIOB, GPIO_PIN_8, GPIO_PIN_SET);
       delay_us(20);
       HAL_GPIO_WritePin(GPIOB, GPIO_PIN_8, GPIO_PIN_RESET);
       
       delay_ms(60); // 等待测量完成
       retry_count++;
   } while(distance_cm == 0 && retry_count < 3);
   

4. 常见问题与调试技巧

4.1 典型故障排查表

4.2 示波器调试技巧

当遇到难以解释的测量误差时，示波器是最强大的调试工具：

1. 将通道1接TRIG引脚，通道2接ECHO引脚
2. 设置触发模式为TRIG通道的上升沿
3. 观察以下关键时间点：
   • TRIG脉冲宽度是否≥10μs
   • ECHO上升沿相对于TRIG上升沿的延迟
   • ECHO高电平持续时间是否稳定

我曾用这个方法发现过一个隐蔽的问题：当开发板其他外设（如无线模块）同时工作时，TRIG脉冲会被压缩到不足10μs，导致模块无法正常启动。解决方案是提高TRIG控制的GPIO速度等级。

4.3 环境因素影响

超声波测距在实际环境中会受到多种干扰：

• 表面材质：柔软材料（如布料）会吸收大部分声波
• 环境噪声：其他40kHz左右的声源会造成干扰
• 温度梯度：室内外温差导致的空气密度变化
• 多径反射：狭窄空间内的多次反射波叠加

在智能家居项目中，我发现窗帘会导致测量值随机跳动，最终通过软件滤波结合最小距离阈值解决了这个问题。这提醒我们：好的嵌入式开发不仅要会写代码，还要理解物理世界的运行规律。