1. HC-SR04超声波测距原理与硬件接口分析

HC-SR04是一种基于时间飞行法（Time of Flight, TOF）的非接触式距离传感器，其核心工作原理是：通过Trig引脚触发一个持续时间不小于10μs的高电平脉冲，模块内部电路随即发射8个40kHz的超声波串，并启动计时；当超声波遇到障碍物反射回模块时，Echo引脚输出一个高电平信号，其持续时间与超声波往返时间成正比；通过精确测量该高电平宽度，即可计算出目标距离。

该模块标称测距范围为2cm–400cm，精度可达3mm。其电气特性要求严格：VCC必须稳定在5V（不可使用3.3V直接供电），GND可靠接地，Trig与Echo为数字I/O引脚，且Trig为输入型控制信号，Echo为输出型反馈信号。在STM32F103系统中，由于MCU GPIO通常为3.3V逻辑电平，而HC-SR04的Echo输出为5V TTL电平，因此必须进行电平匹配——常见做法是采用电阻分压网络（如10kΩ+20kΩ串联）将5V Echo信号衰减至3.3V范围内，或使用专用电平转换芯片（如TXB0108）。本项目原理图中明确将Trig接至GPIOA_Pin5，Echo接至GPIOA_Pin4，二者均位于APB2总线上，具备足够高的IO翻转速度和中断响应能力。

从系统架构角度看，HC-SR04并非智能传感器，不支持I²C或SPI等标准协议，仅提供原始的时序信号接口。这意味着所有时序生成、高电平宽度捕获、温度补偿及距离换算均需由MCU软件实现。这种“裸接口”设计虽增加了软件负担，但也赋予了开发者对测量过程的完全控制权——例如可灵活调整触发间隔以规避多径干扰，可动态切换计时器分辨率以平衡精度与资源占用，亦可在异常超时时主动复位模块状态。理解这一本质，是构建鲁棒测距功能的前提。

2. STM32F103平台下的外设资源配置

在STM32F103C8T6（主流“蓝 pill”开发板）上实现HC-SR04驱动，需协调多个底层外设资源。整个配置流程并非孤立操作，而是围绕“精确时间度量”这一核心目标展开的系统性工程决策。

2.1 时钟树配置与定时器选型

HC-SR04测距对时间精度要求苛刻：声波在空气中传播速度约340m/s，即34,000cm/s。1cm对应约29.4μs的往返时间。若要求1cm测距精度，则Echo高电平宽度测量误差必须控制在±15μs以内。这就决定了计时单元的分辨率至少需达到1μs量级。

本方案选用TIM2作为主计时器。TIM2挂载于APB1总线，其时钟源来自APB1预分频器输出。在典型配置下（HSE=8MHz，PLL倍频为9，系统主频72MHz），APB1总线频率为36MHz。若将TIM2时钟不分频（PSC=0），则其计数频率即为36MHz，对应计数周期≈27.78ns——远优于1μs需求。但过高的计数频率会快速溢出16位计数器（最大值65535，对应满溢时间仅1.8ms），而HC-SR04最大测距4m对应的往返时间约为23.5ms（400cm ÷ 34000cm/s × 2 ≈ 0.0235s），故需合理设置预分频器。经计算，设定PSC=35，ARR=65535，则定时器计数周期为(35+1)/36MHz = 1μs，满溢时间为65.535ms，完美覆盖4m测距需求且留有余量。

2.2 GPIO初始化：Trig与Echo的电气角色定义

GPIO配置必须严格遵循HC-SR04的数据手册时序要求：

• Trig引脚（PA5） ：作为MCU向模块发送的控制信号，需具备快速、确定性的上升沿驱动能力。配置为推挽输出模式（GPIO_MODE_OUTPUT_PP），输出速度设为高速（GPIO_SPEED_FREQ_HIGH），初始电平置低（GPIO_NOPULL）。此配置确保在 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET) 执行时，引脚能在纳秒级完成电平跳变，满足≥10μs高电平脉冲的生成要求。

• Echo引脚（PA4） ：作为模块向MCU反馈的测量信号，其电平变化是软件计时的唯一触发源。配置为浮空输入模式（GPIO_MODE_INPUT），无上下拉（GPIO_NOPULL）。此处需特别注意：若错误配置为上拉或下拉，可能在Echo悬空时引入误触发；若配置为模拟输入，则无法响应数字边沿。浮空输入配合外部电阻分压网络，既能准确采样5V信号，又避免了不必要的功耗与噪声耦合。

2.3 中断优先级分组与NVIC配置

Echo引脚的电平跳变（上升沿/下降沿）是启动和停止计时的关键事件。为保证响应实时性，必须启用EXTI（External Interrupt）线。PA4对应EXTI Line 4，需将其映射至SYSCFG_EXTICR寄存器，并使能NVIC中的EXTI4_IRQn中断通道。

中断优先级设置需纳入整个系统考量。本项目涉及OLED显示（SPI）、蓝牙通信（USART）、电机PWM（TIMx）等多个外设，其中超声波测距结果常用于实时避障决策，其时效性高于显示刷新与通信收发。因此，将EXTI4_IRQn的抢占优先级（Preemption Priority）设为最高之一（如NVIC_EncodePriority(NVIC_GetPriorityGrouping(), 1, 0)），确保在任何其他中断执行过程中均可被立即打断。同时，将子优先级（Subpriority）设为0，避免同级中断间的嵌套不确定性。

3. 超声波测距软件架构设计

软件实现绝非简单地“拉高Trig、读取Echo”，而是一个包含状态机管理、时间同步、异常处理与数据校验的完整闭环。本方案采用“触发-捕获-计算-校验”四阶段模型，各阶段职责清晰，边界明确。

3.1 触发阶段：生成标准激励脉冲

触发函数 HCSR04_Trigger() 的核心任务是向Trig引脚输出一个严格符合规格的脉冲：

void HCSR04_Trigger(void)
{
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);  // 拉高Trig
    Delay_us(15);                                          // 保持15μs（>10μs最小要求）
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET); // 拉低Trig
}

此处 Delay_us(15) 并非调用HAL库的 HAL_Delay() （其最小分辨率为1ms），而是基于SysTick或NOP指令的微秒级延时函数。其内部实现通常为：

void Delay_us(uint16_t us)
{
    uint32_t start = SysTick->VAL;
    uint32_t ticks = us * (SystemCoreClock / 1000000);
    while ((start - SysTick->VAL) < ticks) {
        if (SysTick->VAL > start) start += 0x00FFFFFF; // 处理SysTick溢出
    }
}

选择15μs而非手册最低要求的10μs，是工程实践中预留的安全裕量——它有效规避了因编译器优化、指令流水线延迟或GPIO翻转建立时间（t _PLH /t _PHL ）导致的实际脉宽不足风险。实测表明，在72MHz主频下，该延时函数误差稳定在±0.5μs内，完全满足要求。

3.2 捕获阶段：高精度Echo宽度测量

捕获阶段是整个测距算法的精度瓶颈所在。本方案摒弃轮询方式（CPU占用率高且精度差），采用“定时器+中断”的硬件协同机制：

1. 启动定时器 ：在Trig脉冲发出后，立即调用 HAL_TIM_Base_Start(&htim2) 启动TIM2，此时计数器从0开始递增。
2. 配置EXTI中断 ：使能PA4的上升沿触发EXTI Line 4中断。当中断发生时，表明Echo已由低变高，超声波开始发射，计时正式开始。在 EXTI4_IRQHandler 中记录当前TIM2计数值 start_tick = __HAL_TIM_GET_COUNTER(&htim2) ，并切换EXTI触发边沿为下降沿。
3. 捕获结束时刻 ：当Echo由高变低时，再次进入EXTI4中断。此时读取 end_tick = __HAL_TIM_GET_COUNTER(&htim2) ，计算差值 width_ticks = end_tick - start_tick 。若 width_ticks 为负（因计数器溢出），则按16位无符号整数规则修正： width_ticks += 65536 。

该方案将时间测量完全交由硬件定时器完成，CPU仅在两个关键边沿点介入，最大限度减少了软件开销与不确定性。TIM2的1μs计数精度，结合上述修正逻辑，可确保在0–23.5ms全量程内，距离测量误差始终≤1cm。

3.3 计算阶段：声速补偿与单位转换

获得 width_ticks （单位：μs）后，需将其转换为物理距离。基础公式为：

Distance(cm) = (Speed_of_Sound(m/s) × Time(s)) / 2 × 100

其中除以2是因为 width_ticks 代表往返时间，乘以100是将米转换为厘米。

声速受环境温度影响显著，20℃时为343m/s，25℃时为346m/s。本项目采用25℃基准值340m/s（即34,000 cm/s），因其在室温区间内具有良好的近似性，且简化计算。代入公式得：

Distance(cm) = (34000 cm/s × width_ticks × 10^-6 s) / 2 = width_ticks × 0.017

为规避浮点运算（MCU资源有限且速度慢），采用定点数优化：

uint16_t distance_cm = (width_ticks * 17) / 1000; // 等效于 width_ticks * 0.017

此式通过整数乘法与除法实现，精度损失可忽略（最大量化误差<0.001cm），且执行效率极高。

3.4 校验阶段：异常检测与数据滤波

原始测距数据必然包含噪声与异常。校验阶段承担“数据清洗”职责，主要策略包括：

• 超时保护 ：若在预期最大时间（如30ms，对应约5.1m）内未检测到Echo下降沿，则判定为“无回波”，返回0。这防止了因模块故障、障碍物过远或吸声材料导致的无限等待。
• 量程截断 ：根据前述计算，4m对应约23500μs。代码中设定阈值 MAX_VALID_TICKS = 23500 ，若 width_ticks > MAX_VALID_TICKS ，则视为无效测量（可能为多径反射、环境噪声触发或模块故障），统一返回0。此设计主动放弃超量程数据，而非返回错误值误导上层逻辑。
• 软件滤波 ：单次测量易受干扰。实际应用中，建议在 HCSR04_ReadDistance() 函数内集成简单滤波，如连续3次测量取中值（Median Filter），或采用一阶IIR滤波： filtered_dist = 0.7 * new_dist + 0.3 * last_filtered_dist 。本基础示例暂未实现，但强烈推荐在产品化阶段加入。

4. 定时器中断服务程序（ISR）的精细化实现

定时器中断是整个测距流程的“心脏起搏器”，其代码质量直接决定系统稳定性与精度。本方案中，TIM2并非用于产生固定周期中断，而是作为自由运行的计数器，其更新中断（UPDATE IRQ）被禁用；所有时间相关逻辑均绑定于EXTI Line 4的边沿触发中断。然而，为应对极端情况（如Echo信号异常丢失），仍需在TIM2更新中断中植入安全兜底逻辑。

4.1 EXTI Line 4中断服务程序（EXTI4_IRQHandler）

该ISR是测距流程的绝对核心，必须极致精简，确保在微秒级内完成关键操作：

extern TIM_HandleTypeDef htim2;
extern volatile uint32_t echo_start_time;
extern volatile uint32_t echo_end_time;
extern volatile uint8_t echo_state; // 0: idle, 1: waiting for falling edge

void EXTI4_IRQHandler(void)
{
    HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_4);

    if (__HAL_GPIO_EXTI_GET_FLAG(GPIO_PIN_4) != RESET)
    {
        if (echo_state == 0) // Rising edge: Echo just went high
        {
            echo_start_time = __HAL_TIM_GET_COUNTER(&htim2);
            echo_state = 1;
            // Configure EXTI to trigger on falling edge next time
            SYSCFG->EXTICR[1] &= ~SYSCFG_EXTICR2_EXTI4;
            SYSCFG->EXTICR[1] |= SYSCFG_EXTICR2_EXTI4_PA; // PA4
            EXTI->FTSR |= EXTI_FTSR_FT4; // Enable falling edge trigger
            EXTI->RTSR &= ~EXTI_RTSR_RT4; // Disable rising edge trigger
        }
        else if (echo_state == 1) // Falling edge: Echo just went low
        {
            echo_end_time = __HAL_TIM_GET_COUNTER(&htim2);
            echo_state = 0;
            // Re-enable rising edge trigger for next measurement
            EXTI->RTSR |= EXTI_RTSR_RT4;
            EXTI->FTSR &= ~EXTI_FTSR_FT4;
        }
        __HAL_GPIO_EXTI_CLEAR_FLAG(GPIO_PIN_4);
    }
}

关键设计点解析：
- 状态机驱动 ： echo_state 变量明确区分“等待上升沿”与“等待下降沿”两种模式，避免了因信号抖动导致的重复触发。
- 原子性操作 ：所有寄存器操作（如修改EXTI触发边沿）均在中断上下文中完成，确保状态切换的原子性。 __HAL_GPIO_EXTI_CLEAR_FLAG() 在最后执行，防止在状态判断与标志清除间被新中断打断。
- 无阻塞设计 ：ISR内不执行任何延时、浮点计算或复杂逻辑，仅做最必要的寄存器读写与状态更新。所有耗时计算移至主循环或独立任务中。

4.2 TIM2更新中断（TIM2_UP_IRQHandler）的安全兜底

尽管EXTI中断是主路径，但为防范Echo信号因强干扰完全丢失，TIM2更新中断作为“看门狗”：

extern volatile uint8_t echo_state;
extern volatile uint32_t echo_start_time;

void TIM2_UP_IRQHandler(void)
{
    HAL_TIM_IRQHandler(&htim2);

    if (echo_state == 1) // Still waiting for Echo falling edge
    {
        // If no falling edge within 30ms (~30000 ticks), timeout
        if ((__HAL_TIM_GET_COUNTER(&htim2) - echo_start_time) > 30000)
        {
            echo_state = 0;
            // Force a "timeout" signal to main loop
            // e.g., set a global flag or post to a queue
        }
    }
}

此逻辑在TIM2计数器溢出（约65.5ms）前，提前在30ms处进行超时判定，为主循环提供明确的失败信号，避免系统陷入不确定等待。

5. 主循环逻辑与OLED数据显示集成

测距功能最终需服务于人机交互或上层决策。本项目通过OLED显示屏直观呈现距离值，其集成需考虑实时性、可读性与资源协调。

5.1 主循环调度策略

主循环采用经典的“前后台”（Foreground/Background）架构：

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_TIM2_Init();
    MX_I2C1_Init(); // For OLED
    MX_USART1_UART_Init(); // Optional debug output

    OLED_Init(); // Initialize SSD1306 OLED
    OLED_Clear();
    OLED_ShowString(0, 0, "HC-SR04 Test", 16);
    OLED_Refresh();

    while (1)
    {
        uint16_t distance = HCSR04_ReadDistance(); // Blocking call with timeout

        // Format distance for display: "Dist: XXX cm"
        char buffer[16];
        sprintf(buffer, "Dist: %3d cm", distance);
        OLED_ClearLine(2); // Clear line 2 (0-indexed)
        OLED_ShowString(0, 2, buffer, 16);
        OLED_Refresh();

        HAL_Delay(100); // Enforce minimum 100ms interval between measurements
    }
}

关键点说明：
- 阻塞式读取 ： HCSR04_ReadDistance() 函数内部包含超时等待逻辑（如 HAL_Delay(30) ），确保每次调用均有明确的返回结果（有效距离或0），避免主循环被意外挂起。
- 强制间隔 ： HAL_Delay(100) 严格遵守HC-SR04数据手册“两次触发间隔不小于60ms”的要求（本例放宽至100ms，兼顾显示刷新率与测量稳定性）。此延时也天然起到了软件低通滤波作用，抑制了高频噪声。
- OLED刷新优化 ：仅刷新距离所在的行（ OLED_ClearLine(2) ），而非全屏刷新，显著降低I²C总线负载与显示延迟。

5.2 OLED显示适配与字体缩放

OLED模块（SSD1306）默认支持128×64像素分辨率，标准ASCII字符大小为6×8像素。为提升可视性，本项目采用16×16点阵字体，这意味着单个字符占据16像素宽、16像素高区域。128像素宽度最多容纳8个16px字符，64像素高度最多容纳4行。

在 OLED_ShowString() 函数中，16号字体通过查表方式实现：

const unsigned char FONT16x16[][32] = {
    // Glyph data for '0'-'9', 'A'-'Z', etc.
    {0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
     0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}, // '0'
    // ... more glyphs
};

调用 OLED_ShowString(0, 2, "Dist: 123 cm", 16) 时，函数将字符串逐字符解析，从 FONT16x16 表中提取对应32字节（16×16/8）的点阵数据，并按坐标写入OLED显存。虽然16号字体增大了内存占用（每个字符32字节），但其在调试阶段的价值无可替代——工程师无需凑近屏幕即可清晰辨识数值，极大提升了开发效率。在量产固件中，可根据实际需求切换回12号或8号字体以节省RAM。

6. 常见问题排查与工程实践技巧

在实际部署HC-SR04时，90%以上的“测距不准”或“无响应”问题并非源于代码缺陷，而是由硬件连接、环境干扰或配置疏忽所致。以下是基于多年嵌入式项目经验总结的实战指南。

6.1 硬件连接诊断清单

• 电源纹波 ：HC-SR04对电源噪声极其敏感。若使用USB转TTL模块或劣质稳压芯片供电，5V输出可能含有数十mV纹波。此时Echo信号会出现严重抖动，导致捕获失败。解决方案是在模块VCC与GND间并联一个100μF电解电容+0.1μF陶瓷电容，形成LC滤波。
• 信号线长度与走线 ：Trig与Echo线应尽量短（<15cm），避免与电机驱动线、大电流走线平行走线。长线会引入分布电容，导致信号边沿变缓，上升/下降时间超过1μs，进而影响10μs脉冲的精确生成与识别。若必须长线，应在MCU端添加施密特触发器（如74HC14）整形。
• 电平匹配失效 ：当Echo信号经分压后仍不稳定，用示波器观测发现高电平仅3.0V左右（低于STM32F103的VIHmin=2.0V），则可能是分压电阻值过大导致驱动能力不足。应将上拉电阻（原20kΩ）替换为10kΩ，或改用有源电平转换器。

6.2 软件调试黄金法则

• 示波器是你的第一双眼睛 ：在首次调试时，务必用示波器探头同时监测Trig与Echo信号。正常情况下，Trig应为干净的15μs方波，Echo在其后约几百μs出现，宽度随距离线性增长。若Trig无输出，检查GPIO初始化与 HAL_GPIO_WritePin() 调用；若Echo无响应，重点检查分压电路与EXTI配置；若Echo宽度随机跳变，大概率是电源或接地不良。
• 日志输出定位时序 ：在 EXTI4_IRQHandler 中，通过USART1以115200bps速率打印 echo_start_time 与 echo_end_time 的原始值。例如，测得 start=12345 , end=23456 ，则 width=11111 μs，对应距离约189cm。此方法可绕过OLED刷新延迟，直击计时核心，快速区分是硬件捕获问题还是后续计算问题。
• “拔插大法”的科学依据 ：字幕中提到的“拔掉再接上解决失灵”现象，本质是静电放电（ESD）或Latch-up导致模块内部CMOS电路锁死。HC-SR04无内置ESD防护，频繁热插拔易积累电荷。预防措施是在Trig/Echo线上各串联一个100Ω电阻，并在模块GND与MCU GND间加接1nF电容，提供ESD泄放路径。

6.3 性能优化与进阶方向

• DMA辅助捕获 ：对于需要更高测量频率（如每50ms一次）的应用，可将TIM2的计数器值通过DMA自动搬运至内存数组，避免中断频繁打断，进一步释放CPU资源。
• 温度补偿 ：在精密测距场景，可增加DS18B20温度传感器，实时读取环境温度 t （℃），动态修正声速： v = 331.4 + 0.6 * t （m/s），再代入距离公式。
• 多传感器融合 ：单一超声波易受角度、材质影响。可将HC-SR04与红外避障（TCRT5000）或TOF激光测距（VL53L0X）数据融合，通过加权平均或卡尔曼滤波，生成更鲁棒的距离估计。

我在实际智能小车项目中曾遭遇一个典型问题：小车在木地板上运行时，超声波偶尔“看穿”地板，误判下方为空（距离显示极大）。排查发现是地板缝隙反射了部分声波，造成多径干扰。最终解决方案是在模块前方加装一个3D打印的喇叭形导波罩，将声束聚焦并抬高15°角，彻底规避了地面反射。这个细节提醒我们，理论模型必须与物理世界不断校准——嵌入式工程师的终极战场，永远在代码与铜箔之间那毫厘之差的现实里。