企业官网建设流程全解析

STM32 HAL库驱动HC-SR04：从轮询到中断的工程实践升级

在嵌入式开发中，超声波测距模块HC-SR04因其低成本、易用性成为距离检测的热门选择。但很多开发者止步于基础的轮询实现方式，忽略了实时系统中更优雅的中断驱动方案。本文将带你从底层原理到代码架构，彻底重构HC-SR04的驱动方式。

1. 轮询方案的致命缺陷与中断驱动优势

初学STM32时，我们常这样实现超声波测距：

// 典型轮询实现（反面教材） HAL_GPIO_WritePin(TRIG_GPIO_Port, TRIG_Pin, GPIO_PIN_SET); delay_us(10); HAL_GPIO_WritePin(TRIG_GPIO_Port, TRIG_Pin, GPIO_PIN_RESET); while(HAL_GPIO_ReadPin(ECHO_GPIO_Port, ECHO_Pin) == GPIO_PIN_RESET); uint32_t start = HAL_GetTick(); while(HAL_GPIO_ReadPin(ECHO_GPIO_Port, ECHO_Pin) == GPIO_PIN_SET); uint32_t duration = HAL_GetTick() - start;

这种实现存在三个致命问题：

1. CPU资源浪费：while循环持续占用CPU周期
2. 实时性丧失：在等待ECHO期间无法响应其他事件
3. 精度受限：依赖系统滴答定时器，分辨率通常只有1ms

对比之下，输入捕获中断方案具有显著优势：

2. 定时器输入捕获的硬件原理

STM32的通用定时器提供专业的输入捕获功能，其工作原理可分为三个关键阶段：

1. 边沿检测：通过极性配置寄存器(TIMx_CCER)选择捕获上升沿或下降沿
2. 时间戳记录：当指定边沿到来时，当前计数器值(TIMx_CNT)被锁存到捕获/比较寄存器(TIMx_CCRx)
3. 中断触发：可配置在捕获事件时产生中断请求

对于HC-SR04的ECHO信号测量，我们需要：

1. 上升沿触发时记录T1
2. 切换为下降沿捕获模式
3. 下降沿触发时记录T2
4. 计算高电平持续时间T2-T1

特别要注意定时器溢出处理：当信号脉宽超过定时器自动重载值时，需要通过溢出中断计数器进行补偿。

3. CubeMX工程配置实战

使用STM32CubeMX进行正确配置是成功的第一步：

3.1 定时器基础配置

1. 选择TIMx（建议TIM2/TIM3/TIM4）
2. 时钟源选择内部时钟
3. Prescaler设置为(APB1时钟频率/1000000)-1（实现1us计数）
4. Counter Period设置为最大值65535（16位定时器）
5. 开启定时器全局中断

3.2 输入捕获通道配置

1. 选择对应通道的输入捕获模式
2. IC Filter建议设置为0x0（超声波信号无需滤波）
3. IC Polarity初始配置为Rising Edge
4. 开启捕获中断

注意：不同STM32系列中，定时器通道对应的GPIO引脚可能不同，需查阅对应型号的Datasheet

3.3 触发引脚配置

1. 配置一个GPIO作为Trig输出
2. 初始电平设置为Low
3. 输出模式推挽输出
4. 无需上下拉电阻

配置完成后生成代码，我们得到基础的定时器和GPIO初始化代码。

4. 模块化驱动代码实现

优秀的嵌入式代码应该具备高内聚、低耦合特性。我们设计如下的模块结构：

hc_sr04/ ├── hc_sr04.h // 接口声明 ├── hc_sr04.c // 实现代码 └── hc_sr04_conf.h // 硬件配置

4.1 核心数据结构

typedef struct { TIM_HandleTypeDef* htim; // 定时器句柄 uint32_t channel; // 捕获通道 uint32_t overflow_count; // 溢出计数器 uint32_t rise_time; // 上升沿时间戳 uint32_t fall_time; // 下降沿时间戳 float distance_cm; // 计算结果 uint8_t state; // 状态机 } hc_sr04_t;

4.2 初始化函数

void hc_sr04_init(hc_sr04_t* dev, TIM_HandleTypeDef* htim, uint32_t channel) { dev->htim = htim; dev->channel = channel; dev->state = 0; // 启动定时器和输入捕获 HAL_TIM_Base_Start_IT(dev->htim); HAL_TIM_IC_Start_IT(dev->htim, dev->channel); // 初始配置为上升沿捕获 TIM_RESET_CAPTUREPOLARITY(dev->htim, dev->channel); TIM_SET_CAPTUREPOLARITY(dev->htim, dev->channel, TIM_ICPOLARITY_RISING); }

4.3 中断处理逻辑

void hc_sr04_capture_callback(hc_sr04_t* dev, TIM_HandleTypeDef* htim) { if(htim != dev->htim) return; switch(dev->state) { case 0: // 等待上升沿 dev->rise_time = HAL_TIM_ReadCapturedValue(dev->htim, dev->channel); dev->overflow_count = 0; // 切换为下降沿捕获 TIM_RESET_CAPTUREPOLARITY(dev->htim, dev->channel); TIM_SET_CAPTUREPOLARITY(dev->htim, dev->channel, TIM_ICPOLARITY_FALLING); dev->state = 1; break; case 1: // 等待下降沿 dev->fall_time = HAL_TIM_ReadCapturedValue(dev->htim, dev->channel); // 计算高电平持续时间（考虑溢出） uint32_t duration = dev->fall_time + (dev->overflow_count * 65536) - dev->rise_time; // 计算距离（声速340m/s） dev->distance_cm = (duration / 1000000.0f) * 34000.0f / 2.0f; // 重置为上升沿捕获 TIM_RESET_CAPTUREPOLARITY(dev->htim, dev->channel); TIM_SET_CAPTUREPOLARITY(dev->htim, dev->channel, TIM_ICPOLARITY_RISING); dev->state = 0; break; } } void hc_sr04_overflow_callback(hc_sr04_t* dev, TIM_HandleTypeDef* htim) { if(htim == dev->htim) { dev->overflow_count++; } }

4.4 触发测量函数

void hc_sr04_trigger(hc_sr04_t* dev) { // 发送10us高电平脉冲 HAL_GPIO_WritePin(TRIG_GPIO_Port, TRIG_Pin, GPIO_PIN_SET); delay_us(10); HAL_GPIO_WritePin(TRIG_GPIO_Port, TRIG_Pin, GPIO_PIN_RESET); }

5. 实际应用中的进阶技巧

5.1 多模块协同工作

当需要同时使用多个HC-SR04时：

1. 为每个模块分配独立的定时器通道
2. 在中断回调中通过htim参数区分不同实例
3. 错开触发时间（建议间隔>60ms）

hc_sr04_t sonar1, sonar2; void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef* htim) { if(htim == htim1) hc_sr04_capture_callback(&sonar1, htim); else if(htim == htim2) hc_sr04_capture_callback(&sonar2, htim); }

5.2 测量超时处理

增加超时机制防止长时间无响应：

// 在数据结构中添加 uint32_t last_trigger_time; // 触发时更新 dev->last_trigger_time = HAL_GetTick(); // 在主循环中检查 if(HAL_GetTick() - dev->last_trigger_time > 100) { dev->state = 0; // 重置状态机 // 可选的错误处理 }

5.3 数字滤波算法

针对测量噪声，可采用移动平均滤波：

#define FILTER_SIZE 5 float filter_buffer[FILTER_SIZE]; uint8_t filter_index = 0; float filtered_distance(float new_value) { filter_buffer[filter_index] = new_value; filter_index = (filter_index + 1) % FILTER_SIZE; float sum = 0; for(int i=0; i<FILTER_SIZE; i++) { sum += filter_buffer[i]; } return sum / FILTER_SIZE; }

6. 性能优化与调试技巧

6.1 定时器配置优化

1. 时钟源选择：使用APB1总线上的定时器可获得最高时钟频率

2. 预分频计算：确保定时器时基满足测量范围需求

   • 1us分辨率：72MHz/(72 prescaler) = 1MHz
   • 最大测量距离：65535us * 340m/s /2 ≈ 11m

3. DMA应用：对于高频采样需求，可配置DMA将捕获值直接传输到内存

6.2 调试输出配置

添加调试信息帮助问题定位：

printf("[HC-SR04] State:%d Rise:%lu Fall:%lu OVF:%lu Dist:%.1fcm\n", dev->state, dev->rise_time, dev->fall_time, dev->overflow_count, dev->distance_cm);

6.3 常见问题排查

1. 无捕获中断：

   • 检查定时器时钟是否使能
   • 验证GPIO复用功能配置
   • 确认中断优先级设置

2. 测量值不稳定：

   • 增加硬件滤波电容（ECHO引脚对地100nF）
   • 检查电源稳定性（建议并联100uF电容）
   • 避免物理振动干扰

3. 超范围测量：

   • 增加定时器溢出处理逻辑
   • 设置合理的超时机制

移植到不同STM32系列时，需特别注意定时器特性的差异。例如在STM32F0系列中，输入捕获需要额外配置CCMR寄存器。