代码讲解:STM32F103C8T6 驱动 HC-SR04 超声波测距

代码讲解:STM32F103C8T6 驱动 HC-SR04 超声波测距

下面按模块拆解这份代码,说明每一部分的作用与关键细节。

1. 头文件与硬件接口定义

c 复制代码
#include "delay.h"
#include "led.h"
#include "key.h"

#define HCSR04_PORT     GPIOB
#define HCSR04_CLK      RCC_APB2Periph_GPIOB
#define HCSR04_TRIG     GPIO_Pin_11
#define HCSR04_ECHO     GPIO_Pin_10
  • delay.h 提供 delay_init()、delay_ms() 等延时函数。
  • 三个宏把超声波模块的引脚集中定义:Trig 接 PB11(输出) ,Echo 接 PB10(输入)。后续代码全部通过宏访问引脚,换引脚时只改这里即可。

2. 全局计数变量

c 复制代码
u16 msHcCount = 0;

msHcCount 记录定时器 4 溢出的次数。定时器每溢出一次代表经过 1 ms,用它配合当前计数值就能算出 Echo 高电平的持续时间。

3. 中断优先级配置 hcsr04_NVIC()

c 复制代码
NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);
NVIC_InitStructure.NVIC_IRQChannel = TIM4_IRQn;
NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 0;
NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0;
NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;
  • 优先级分组设为 2,即 2 位抢占优先级 + 2 位子优先级。
  • 把 TIM4 中断设为最高优先级(抢占 0、子 0),保证测距计时不被其他中断打断,提高测量精度。

4. 初始化函数 Hcsr04Init()

c 复制代码
RCC_APB2PeriphClockCmd(HCSR04_CLK, ENABLE);

GPIO_InitStructure.GPIO_Pin = HCSR04_TRIG;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_Init(HCSR04_PORT, &GPIO_InitStructure);
GPIO_ResetBits(HCSR04_PORT, HCSR04_TRIG);

GPIO_InitStructure.GPIO_Pin = HCSR04_ECHO;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING;
GPIO_Init(HCSR04_PORT, &GPIO_InitStructure);
  • 使能 GPIOB 时钟,Trig 配置为推挽输出 并默认拉低;Echo 配置为浮空输入,用于读取模块返回的高电平脉宽。
  • 接着配置定时器 4:
c 复制代码
RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM4, ENABLE);

TIM_TimeBaseStructure.TIM_Period = (1000 - 1);
TIM_TimeBaseStructure.TIM_Prescaler = (72 - 1);
TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1;
TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up;
TIM_TimeBaseInit(TIM4, &TIM_TimeBaseStructure);

TIM_ClearFlag(TIM4, TIM_FLAG_Update);
TIM_ITConfig(TIM4, TIM_IT_Update, ENABLE);
hcsr04_NVIC();
TIM_Cmd(TIM4, DISABLE);
  • 系统时钟 72 MHz,预分频 72-1 后计数频率为 1 MHz ,即每个计数 1 µs;周期 1000-1 表示计到 1000 溢出,也就是每 1 ms 溢出一次。
  • 使能更新中断,最后先关闭定时器,等真正测距时再打开。

注意:这里有一处笔误 TIM_DeInit(TIM2);,实际应写成 TIM_DeInit(TIM4);,否则不会复位 TIM4 的寄存器。

5. 定时器开关与中断服务函数

c 复制代码
static void OpenTimerForHc()
{
   TIM_SetCounter(TIM4, 0);
   msHcCount = 0;
   TIM_Cmd(TIM4, ENABLE);
}

static void CloseTimerForHc()
{
   TIM_Cmd(TIM4, DISABLE);
}

void TIM4_IRQHandler(void)
{
   if (TIM_GetITStatus(TIM4, TIM_IT_Update) != RESET)
   {
       TIM_ClearITPendingBit(TIM4, TIM_IT_Update);
       msHcCount++;
   }
}
  • 打开定时器前先清零计数器与溢出计数,保证每次测量从 0 开始。
  • 中断里只做一件事:清标志位并让 msHcCount 自增,逻辑极简,避免占用过多中断时间。

6. 读取计时值 GetEchoTimer()

c 复制代码
u32 GetEchoTimer(void)
{
   u32 t = 0;
   t = msHcCount * 1000;
   t += TIM_GetCounter(TIM4);
   TIM4->CNT = 0;
   return t;
}
  • 总时间 = 溢出次数 × 1000 µs + 当前计数值,单位是 µs。
  • 读取后把计数器清零,为下一次测量做准备。

7. 测距主逻辑 Hcsr04GetLength()

c 复制代码
while (i != 5)
{
   TRIG_Send = 1;
   TRIG_Send = 0;
   while (ECHO_Reci == 0);
   OpenTimerForHc();
   i = i + 1;
   while (ECHO_Reci == 1);
   CloseTimerForHc();
   t = GetEchoTimer();
   lengthTemp = ((float)t / 58.0); // cm
   sum = lengthTemp + sum;
}
lengthTemp = sum / 5.0;
  • 先给 Trig 一个高电平脉冲触发测距,然后等待 Echo 变高(开始计时),再等待 Echo 变低(结束计时)。
  • 声速换算:距离(cm) = 时间(µs) / 58,这是 HC-SR04 常用的经验公式(往返声程 + 声速 340 m/s 推导而来)。
  • 循环 5 次取平均值,降低单次测量的抖动误差。

提示:TRIG_Send、ECHO_Reci 这两个宏在本文件中未定义,通常需要在头文件里写成 PBout(11)、PBin(10) 之类的位带操作宏,否则编译会报错。

8. 主函数

c 复制代码
int main(void)
{
   float length;
   delay_init();
   Hcsr04Init();

   while (1)
   {
      length = Hcsr04GetLength();
      delay_ms(1000);
   }
}
  • 初始化延时函数与超声波模块,然后每秒测一次距离。
  • 实际使用时可以把 length 通过串口打印出来,或根据距离做避障判断。

9. 小结与优化建议

  1. 修正笔误 :TIM_DeInit(TIM2) 改为 TIM_DeInit(TIM4)。
  2. 补全宏定义 :TRIG_Send、ECHO_Reci 需在头文件中定义。
  3. 加超时保护 :while (ECHO_Reci == 0) 和 while (ECHO_Reci == 1) 是死等,若模块无响应会卡死,建议加超时退出。
  4. 触发脉宽 :HC-SR04 要求 Trig 高电平至少 10 µs,代码中被注释掉的 delay_us(20) 建议恢复,否则部分模块可能不响应。
  5. 测量范围:HC-SR04 有效量程约 2 cm ~ 400 cm,超出范围时读数不可信,可加范围判断过滤。

10. 小白笔记:一图看懂整个流程

如果你刚接触 STM32,可以先用一句话记住这份代码在干什么:给 Trig 一个脉冲 → 等 Echo 变高 → 开始计时 → 等 Echo 变低 → 停止计时 → 用时间算距离。
#mermaid-svg-QOvWz68Jwv9gxpxk{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-QOvWz68Jwv9gxpxk .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-QOvWz68Jwv9gxpxk .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-QOvWz68Jwv9gxpxk .error-icon{fill:#552222;}#mermaid-svg-QOvWz68Jwv9gxpxk .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-QOvWz68Jwv9gxpxk .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-QOvWz68Jwv9gxpxk .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-QOvWz68Jwv9gxpxk .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-QOvWz68Jwv9gxpxk .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-QOvWz68Jwv9gxpxk .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-QOvWz68Jwv9gxpxk .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-QOvWz68Jwv9gxpxk .marker{fill:#333333;stroke:#333333;}#mermaid-svg-QOvWz68Jwv9gxpxk .marker.cross{stroke:#333333;}#mermaid-svg-QOvWz68Jwv9gxpxk svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-QOvWz68Jwv9gxpxk p{margin:0;}#mermaid-svg-QOvWz68Jwv9gxpxk .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-QOvWz68Jwv9gxpxk .cluster-label text{fill:#333;}#mermaid-svg-QOvWz68Jwv9gxpxk .cluster-label span{color:#333;}#mermaid-svg-QOvWz68Jwv9gxpxk .cluster-label span p{background-color:transparent;}#mermaid-svg-QOvWz68Jwv9gxpxk .label text,#mermaid-svg-QOvWz68Jwv9gxpxk span{fill:#333;color:#333;}#mermaid-svg-QOvWz68Jwv9gxpxk .node rect,#mermaid-svg-QOvWz68Jwv9gxpxk .node circle,#mermaid-svg-QOvWz68Jwv9gxpxk .node ellipse,#mermaid-svg-QOvWz68Jwv9gxpxk .node polygon,#mermaid-svg-QOvWz68Jwv9gxpxk .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-QOvWz68Jwv9gxpxk .rough-node .label text,#mermaid-svg-QOvWz68Jwv9gxpxk .node .label text,#mermaid-svg-QOvWz68Jwv9gxpxk .image-shape .label,#mermaid-svg-QOvWz68Jwv9gxpxk .icon-shape .label{text-anchor:middle;}#mermaid-svg-QOvWz68Jwv9gxpxk .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-QOvWz68Jwv9gxpxk .rough-node .label,#mermaid-svg-QOvWz68Jwv9gxpxk .node .label,#mermaid-svg-QOvWz68Jwv9gxpxk .image-shape .label,#mermaid-svg-QOvWz68Jwv9gxpxk .icon-shape .label{text-align:center;}#mermaid-svg-QOvWz68Jwv9gxpxk .node.clickable{cursor:pointer;}#mermaid-svg-QOvWz68Jwv9gxpxk .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-QOvWz68Jwv9gxpxk .arrowheadPath{fill:#333333;}#mermaid-svg-QOvWz68Jwv9gxpxk .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-QOvWz68Jwv9gxpxk .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-QOvWz68Jwv9gxpxk .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-QOvWz68Jwv9gxpxk .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-QOvWz68Jwv9gxpxk .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-QOvWz68Jwv9gxpxk .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-QOvWz68Jwv9gxpxk .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-QOvWz68Jwv9gxpxk .cluster text{fill:#333;}#mermaid-svg-QOvWz68Jwv9gxpxk .cluster span{color:#333;}#mermaid-svg-QOvWz68Jwv9gxpxk div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-QOvWz68Jwv9gxpxk .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-QOvWz68Jwv9gxpxk rect.text{fill:none;stroke-width:0;}#mermaid-svg-QOvWz68Jwv9gxpxk .icon-shape,#mermaid-svg-QOvWz68Jwv9gxpxk .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-QOvWz68Jwv9gxpxk .icon-shape p,#mermaid-svg-QOvWz68Jwv9gxpxk .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-QOvWz68Jwv9gxpxk .icon-shape .label rect,#mermaid-svg-QOvWz68Jwv9gxpxk .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-QOvWz68Jwv9gxpxk .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-QOvWz68Jwv9gxpxk .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-QOvWz68Jwv9gxpxk :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} main 初始化 delay_init + Hcsr04Init
Hcsr04GetLength 循环 5 次
Trig 输出高电平脉冲
等待 Echo 变高
OpenTimerForHc 启动 TIM4 计时
等待 Echo 变低
CloseTimerForHc 停止计时
GetEchoTimer 读取脉宽 us
距离 = t / 58 cm
5 次求和取平均
返回距离并延时 1s

小白必记的 5 个关键点
关键点 说明 对应代码
引脚方向 Trig 是输出,Echo 是输入 GPIO_Mode_Out_PP / GPIO_Mode_IN_FLOATING
定时器频率 72 MHz ÷ 72 = 1 MHz,即 1 个计数 = 1 µs TIM_Prescaler = 72-1
溢出周期 计到 1000 溢出,即 1 ms 溢出一次 TIM_Period = 1000-1
总脉宽 溢出次数 × 1000 + 当前计数值 msHcCount*1000 + TIM_GetCounter
距离公式 距离(cm) = 脉宽(µs) / 58 lengthTemp = t / 58.0
常见踩坑清单
  1. 忘了开时钟 :GPIOB 用 RCC_APB2PeriphClockCmd,TIM4 用 RCC_APB1PeriphClockCmd,两者总线不同,别写错。
  2. Echo 接错模式:Echo 必须配成输入,配成输出永远读不到高电平。
  3. Trig 脉宽太短 :HC-SR04 要求至少 10 µs,代码里 delay_us(20) 被注释掉了,建议恢复。
  4. 死等卡住程序 :while(ECHO_Reci == 0) 没有超时,模块没接好时程序会一直停在这里。
  5. 定时器没清零 :每次测量前 TIM_SetCounter(TIM4, 0) 和 msHcCount = 0 都要做,否则数据会累加。
一句话理解定时器计时原理

定时器就像一个每 1 µs 走一格的水表 ,TIM_GetCounter 读的是当前格数,msHcCount 记录的是「水表转满一圈(1000 格)转了几圈」。所以总时间 = 圈数 × 1000 + 当前格数,单位正好是 µs。

相关推荐
编程小白菜1232 小时前
STM32L0 ADC串扰揭秘:充电电压如何“伪造”压力数据
stm32·单片机·嵌入式硬件
Zw-awa12 小时前
两路信号,两种滤波:角速度走低通滤波,加速度走卡尔曼滤波
stm32
橘为己有44116 小时前
STM32:USART 串口(2)
stm32·单片机·嵌入式硬件
少司府19 小时前
嵌入式外设篇(一)GPIO·一:认识GPIO
linux·单片机·嵌入式硬件·mcu·系统·rtos·嵌入式软件
jianqiang.xue19 小时前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
国科安芯21 小时前
星载姿轨控单元RISC-V MCU的存储、时基与辐射韧性——AS32S601ZIT2在商业卫星控制与配电单元中的应用
单片机·嵌入式硬件·mcu·risc-v·低轨卫星·抗辐射
希和20271 天前
江科大 51 单片机课程笔记:XPT2046 触摸/AD 采集与 LCD1602 显示
笔记·单片机·mongodb
en.en..2 天前
STM32 定时器预分频器 TIMx_PSC 详解
单片机·嵌入式硬件
Zw-awa2 天前
滤波是什么:限幅、滑动平均、中位值、一阶低通怎么选?嵌入式传感器滤波算法原理与C源码
stm32