代码讲解: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. 小结与优化建议
- 修正笔误 :
TIM_DeInit(TIM2)改为TIM_DeInit(TIM4)。 - 补全宏定义 :
TRIG_Send、ECHO_Reci需在头文件中定义。 - 加超时保护 :
while (ECHO_Reci == 0)和while (ECHO_Reci == 1)是死等,若模块无响应会卡死,建议加超时退出。 - 触发脉宽 :HC-SR04 要求 Trig 高电平至少 10 µs,代码中被注释掉的
delay_us(20)建议恢复,否则部分模块可能不响应。 - 测量范围: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 |
常见踩坑清单
- 忘了开时钟 :GPIOB 用
RCC_APB2PeriphClockCmd,TIM4 用RCC_APB1PeriphClockCmd,两者总线不同,别写错。 - Echo 接错模式:Echo 必须配成输入,配成输出永远读不到高电平。
- Trig 脉宽太短 :HC-SR04 要求至少 10 µs,代码里
delay_us(20)被注释掉了,建议恢复。 - 死等卡住程序 :
while(ECHO_Reci == 0)没有超时,模块没接好时程序会一直停在这里。 - 定时器没清零 :每次测量前
TIM_SetCounter(TIM4, 0)和msHcCount = 0都要做,否则数据会累加。
一句话理解定时器计时原理
定时器就像一个每 1 µs 走一格的水表 ,TIM_GetCounter 读的是当前格数,msHcCount 记录的是「水表转满一圈(1000 格)转了几圈」。所以总时间 = 圈数 × 1000 + 当前格数,单位正好是 µs。