HC-SR04超声波测距模块在天空星GD32F407开发板上的移植与驱动开发实战最近在做一个智能小车的项目需要用到超声波传感器来避障。手头正好有HC-SR04模块和天空星的GD32F407开发板就想着把这两个东西结合起来用。网上资料虽然多但针对GD32标准库的完整驱动教程还真不好找。折腾了两天总算调通了把整个过程和代码整理出来给同样在用GD32的朋友们参考避免再踩我踩过的坑。这篇教程会手把手带你完成HC-SR04在GD32F407上的驱动移植。咱们不光是贴代码更重要的是讲清楚为什么要这么配置以及实际调试中会遇到哪些问题。就算你是嵌入式新手跟着步骤走也能让超声波模块在你的板子上跑起来。1. 认识你的硬件HC-SR04模块在写代码之前咱们得先搞清楚要驱动的对象是什么。HC-SR04是一个非常常见的超声波测距模块价格便宜用起来也简单。1.1 模块长啥样怎么工作HC-SR04模块有四个引脚VCC接电源正极3.3V到5V都能工作。GND接地。Trig触发信号输入引脚。你给这个脚一个高电平脉冲模块就会发射超声波。Echo回响信号输出引脚。模块收到返回的超声波后会通过这个脚输出一个高电平脉冲。它的工作原理很像蝙蝠你发出声音触发声音碰到物体反弹回来回波通过计算声音来回的时间就能知道距离有多远。具体操作流程是触发给Trig引脚一个至少**10微秒us**的高电平信号。发射模块自动发出8个40kHz的超声波脉冲。接收模块开始等待回波。回响一旦检测到回波Echo引脚就会从低电平变成高电平。计时结束回波信号完全接收后Echo引脚恢复低电平。关键点来了Echo引脚高电平持续的时间就是超声波从发射到返回所花费的总时间。我们用单片机测量出这个时间就能算出距离。1.2 核心计算公式与参数距离计算公式是距离 (高电平时间 × 声速) / 2为什么要除以2因为时间是超声波“跑个来回”的时间单程距离要除以2。声速在常温下我们一般取340米/秒m/s也就是34000厘米/秒cm/s。单位换算如果我们测出的高电平时间是t单位是微秒 us那么距离S单位是厘米 cm就是S(cm) (t(us) × 34000(cm/s)) / 2 / 1000000 t / 58.0对你没看错最后可以简化成距离(cm) 高电平时间(us) / 58。这个“58”就是咱们写代码时要用的魔法数字。模块的探测范围官方说是2cm到400cm有些能到600cm精度大概0.3cm左右。实际用的时候太近小于2cm可能测不准太远超过4米信号可能就收不回来了。注意当被测物体超出测量范围时Echo引脚可能会输出一个长达66ms左右的高电平。所以你的程序要能处理这种情况两次测量的间隔最好大于70ms避免误触发。2. 搭建开发环境与工程准备2.1 硬件连接首先把HC-SR04模块和天空星开发板连起来。这里我们参考原始代码使用GPIOC的10和11号引脚。HC-SR04引脚天空星GD32F407引脚对应宏定义VCC3.3V或5V电源引脚-GNDGND地-TrigPC10GPIO_TRIGEchoPC11GPIO_ECHO用杜邦线按上表接好就行。Trig是输出Echo是输入别接反了。2.2 软件工程准备假设你已经有一个基于GD32标准库的工程了比如从官方例程改的。我们需要在工程里添加两个文件bsp_ultrasonic.c– 驱动函数的实现文件。bsp_ultrasonic.h– 驱动函数的头文件包含引脚定义和函数声明。怎么添加文件取决于你用的IDEKeil、IAR等一般是右键工程目录选择“添加现有文件”或“新建文件”。这里就不赘述了咱们重点看代码。3. 驱动代码逐行解析下面我们来啃最核心的驱动代码。我会把每一部分拆开讲清楚它到底在干什么。3.1 头文件定义 (bsp_ultrasonic.h)头文件主要是做引脚映射和声明函数这样主程序调用起来就方便了。#ifndef _BSP_ULTRASONIC_H_ #define _BSP_ULTRASONIC_H_ #include gd32f4xx.h // 触发引脚Trig的配置使用GPIOC的第10脚 #define RCU_TRIG RCU_GPIOC // 对应GPIOC的时钟 #define PORT_TRIG GPIOC // 端口 #define GPIO_TRIG GPIO_PIN_10 // 引脚 // 回响引脚Echo的配置使用GPIOC的第11脚 #define RCU_ECHO RCU_GPIOC #define PORT_ECHO GPIOC #define GPIO_ECHO GPIO_PIN_11 // 函数声明 void Ultrasonic_Init(void); // 初始化超声波模块和定时器 float Hcsr04GetLength(void); // 执行一次测量并返回距离单位厘米 float Get_distance(void); // 获取上一次测量的距离值 #endif3.2 初始化函数 (Ultrasonic_Init)这个函数负责把用到的GPIO和定时器配置好是驱动能工作的基础。void Ultrasonic_Init(void) { timer_parameter_struct timer_initpara; // 定义定时器初始化结构体 // 1. 使能GPIO时钟 rcu_periph_clock_enable(RCU_TRIG); // 打开GPIOC的时钟 rcu_periph_clock_enable(RCU_ECHO); // 同上其实开一次就行这里为了清晰 // 2. 配置Trig引脚(PC10)为推挽输出 gpio_mode_set(PORT_TRIG, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_TRIG); gpio_output_options_set(PORT_TRIG, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_TRIG); gpio_bit_write(PORT_TRIG, GPIO_TRIG, RESET); // 初始化为低电平 // 3. 配置Echo引脚(PC11)为浮空输入 // 浮空输入是因为模块输出高电平我们只需要读取不需要内部上拉下拉 gpio_mode_set(PORT_ECHO, GPIO_MODE_INPUT, GPIO_PUPD_NONE, GPIO_ECHO); // 4. 配置定时器TIMER5用于高精度计时 rcu_periph_clock_enable(RCU_TIMER5); // 使能TIMER5时钟 rcu_timer_clock_prescaler_config(RCU_TIMER_PSC_MUL4); // 时钟4倍频到200MHz timer_deinit(TIMER5); // 复位定时器 // 配置定时器参数 timer_initpara.period 1000 - 1; // 自动重装载值决定计数周期 timer_initpara.prescaler 200 - 1; // 预分频器决定计数频率 timer_initpara.clockdivision TIMER_CKDIV_DIV1; // 时钟分频 timer_initpara.alignedmode TIMER_COUNTER_EDGE; // 边缘对齐模式 timer_initpara.counterdirection TIMER_COUNTER_UP; // 向上计数 timer_initpara.repetitioncounter 0; // 重复计数器高级定时器用 timer_init(TIMER5, timer_initpara); // 初始化定时器 // 5. 配置定时器中断用于计算超过1ms的时间 nvic_irq_enable(TIMER5_DAC_IRQn, 1, 1); // 使能TIMER5中断优先级1,1 timer_interrupt_enable(TIMER5, TIMER_INT_UP); // 使能更新中断 // 注意这里先不启动定时器测量时才启动 // timer_enable(TIMER5); }初始化部分有几个关键点定时器时钟rcu_timer_clock_prescaler_config(RCU_TIMER_PSC_MUL4)这一行把定时器时钟4倍频到了200MHz。这是GD32F4系列的特性为了获得更高的定时精度。定时器计数值系统时钟200MHz经过prescaler199分频定时器实际计数频率 200MHz / (1991) 1MHz。即每计数一次是1微秒us这对我们测量超声波时间非常完美。period999表示计数器从0数到999共1000个数会产生一次更新溢出结合1MHz的频率就是每1ms溢出一次。这个溢出中断用来记录“毫秒”部分的时间。中断的作用超声波测量时间可能长达几十毫秒而16位定时器最多计65535us约65ms。为了测量更长时间我们用中断来记录溢出的次数每溢出一次加1ms。3.3 定时器中断服务函数这个函数在定时器溢出计满1ms时被自动调用。void TIMER5_DAC_IRQHandler(void) { if(timer_interrupt_flag_get(TIMER5, TIMER_INT_UP) ! RESET) { msHcCount; // 全局变量记录溢出的毫秒数 timer_interrupt_flag_clear(TIMER5, TIMER_INT_UP); // 清除中断标志 } }很简单就是每次溢出把记录毫秒的变量msHcCount加1。3.4 核心测距函数 (Hcsr04GetLength)这是驱动最核心的部分完成了触发、等待回波、计时、计算距离的全过程。float Hcsr04GetLength(void) { float length 0; float t 0; float sum 0; unsigned int i 0; // 循环测量5次取平均值提高稳定性 while(i ! 5){ // 1. 发送触发信号一个至少10us的高脉冲 gpio_bit_write(PORT_TRIG, GPIO_TRIG, SET); // Trig拉高 delay_1us(20); // 持续20us确保大于10us gpio_bit_write(PORT_TRIG, GPIO_TRIG, RESET); // Trig拉低触发完成 // 2. 等待Echo引脚变为高电平回波开始 while(gpio_input_bit_get(PORT_ECHO, GPIO_ECHO) 0); // 空循环等待 // 3. 回波开始启动定时器计时 OpenTimer(); // 这个函数清零计数器并启动TIMER5 i i 1; // 成功开始一次测量计数加1 // 4. 等待Echo引脚变回低电平回波结束 while(gpio_input_bit_get(PORT_ECHO, GPIO_ECHO) 1); // 空循环等待 // 5. 回波结束关闭定时器 CloseTimer(); // 关闭TIMER5 // 6. 获取Echo高电平的持续时间单位微秒us t GetEchoTimer(); // 7. 计算单次距离时间(us) / 58 距离(cm) length (float)t / 58.0; sum length; // 累加 } // 8. 计算5次测量的平均值 length sum / 5.0; distance length; // 存入全局变量方便其他函数获取 return length; }这里有几个非常重要的细节和容易出错的地方触发脉冲宽度delay_1us(20)确保了20us的高电平满足模块要求。如果你的delay_1us函数不准可能导致触发失败。等待Echo的“死循环”代码里用了while循环等待引脚电平变化。如果模块没接好或者坏了程序会永远卡在这里实际产品中最好加一个超时判断。取平均值循环测5次取平均能有效滤除偶然误差让读数更稳定。GetEchoTimer()函数这是获取总时间的函数它结合了定时器溢出次数(msHcCount)和当前计数值。unsigned int GetEchoTimer(void) { unsigned int time 0; // 总时间 溢出次数 * 1000us 当前的计数值(us) time msHcCount * 1000; time timer_counter_read(TIMER5); timer_counter_value_config(TIMER5, 0); // 读完清零计数器为下次准备 delay_1ms(10); // 一个小延时确保模块恢复 return time; // 返回单位是微秒(us) }3.5 辅助函数打开和关闭定时器的函数很简单就是控制定时器的使能位并在打开前清零计数器和毫秒计数器。static void OpenTimer(void) { timer_counter_value_config(TIMER5, 0); // 计数器清零 msHcCount 0; // 溢出计数器清零 timer_enable(TIMER5); // 启动定时器 } static void CloseTimer(void) { timer_disable(TIMER5); // 关闭定时器 }4. 在主函数中调用与测试驱动写好了最后就是在主程序里用起来。#include gd32f4xx.h #include board.h #include bsp_usart.h #include stdio.h #include bsp_ultrasonic.h int main(void) { board_init(); // 开发板基础初始化时钟、延时等 bsp_uart_init(); // 初始化串口用于打印数据 nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2); // 设置中断优先级分组 Ultrasonic_Init(); // 初始化超声波模块 printf(HC-SR04 Test Start!\r\n); while(1) { // 获取距离并打印 float dist Hcsr04GetLength(); printf(Distance %.2f cm\r\n, dist); // 延时一段时间再进行下一次测量 delay_1ms(1000); // 延时1秒 } }下载程序到开发板打开串口助手波特率要和你的bsp_usart_init里设置的一致你就能看到每隔1秒打印一次的距离值了。你可以用手或书本在模块前方移动观察距离值的变化。放到大概20厘米的地方看看串口打印的值是不是差不多。5. 调试心得与常见问题读数一直是0或者某个固定值检查接线这是最常见的问题确保VCC、GND、Trig、Echo四根线都连接牢固没有虚接。特别是Trig和Echo有没有接反。检查电源用万用表量一下模块VCC和GND之间的电压确保在3.3V-5V之间。电源电流不足也可能导致工作不正常。检查触发信号用示波器或者逻辑分析仪看一下PC10Trig引脚在测量时有没有出现一个20us左右的高脉冲。如果没有检查GPIO初始化代码。读数波动很大取平均值代码里已经做了5次平均如果还波动可以尝试增加平均次数比如10次。环境干扰超声波对光滑的、角度倾斜的物体反射效果差尽量正对平整的物体测试。附近有强烈的空气流动如风扇也会干扰。延时两次测量之间确保有足够的间隔如70ms以上防止上一次的回波干扰下一次。测量距离不准公式校准公式t/58是基于声速340m/s和理想环境的。温度、湿度会影响声速。如果要求高精度可以引入温度补偿公式距离 (t * 331.4 * sqrt(1 温度/273)) / 2 / 10000。测量最小距离模块有约2cm的盲区太近的物体测不准。程序卡死在while循环里这就是前面说的“死循环”风险。最好给等待Echo高/低电平的循环加上超时退出机制。例如循环里累加一个延时计数器超过一定时间比如100ms还没等到就强制跳出并返回错误值。好了整个驱动从原理到代码再到调试都讲完了。代码我已经在实际的天空星GD32F407开发板上跑通了你可以直接拿去用。遇到问题先按上面“常见问题”的思路排查大部分都能解决。嵌入式开发就是这样一点点调出来成功了就很有成就感。祝你移植顺利