给HC-SR04超声波模块加个OLED显示屏：用STM32F103做个简易测距仪完整项目

用STM32F103打造智能超声波测距仪从硬件搭建到UI设计全攻略在创客圈里超声波测距项目一直是最受欢迎的入门实践之一。它不仅涵盖了GPIO控制、定时器、中断等嵌入式开发核心知识点还能快速做出看得见摸得着的成果。今天我们要做的不是简单的距离测量而是一个带有OLED显示屏、单位切换、极值记录和声音报警的完整测距系统。这个项目的特别之处在于使用常见的STM32F103C8T6最小系统板蓝色药丸板整合了0.96寸OLED显示告别串口调试的繁琐通过按键实现厘米/英寸单位切换自动记录测量过程中的最大/最小值当物体接近设定阈值时触发蜂鸣器报警整体成本控制在50元以内1. 硬件准备与电路设计1.1 所需材料清单组件型号/参数数量备注主控板STM32F103C8T61蓝色药丸开发板超声波模块HC-SR041工作电压5V显示屏SSD1306 0.96寸OLED1I2C接口蜂鸣器有源5V1用于报警提示按键轻触开关2单位切换/功能选择电阻10KΩ2按键上拉杜邦线母对母若干建议使用不同颜色1.2 电路连接方案核心连接关系STM32F103C8T6 -- 外设模块 ----------------------------- PA0 -- HC-SR04 Trig PA1 -- HC-SR04 Echo PB6(SCL) -- OLED SCL PB7(SDA) -- OLED SDA PA4 -- 蜂鸣器 PA5 -- 按键1(单位切换) PA6 -- 按键2(极值重置) GND -- 所有模块GND注意HC-SR04的VCC接5V但Echo信号输出是3.3V电平可直接连接STM32的IO口。OLED和蜂鸣器建议使用3.3V供电。1.3 硬件布局技巧电源处理在VCC和GND之间并联一个100μF电容稳定电源每个模块的电源引脚附近加0.1μF去耦电容信号完整性超声波模块尽量远离MCU减少高频干扰I2C信号线保持平行走线长度一致人机交互设计OLED屏幕朝向用户操作方向按键位置符合人体工学便于单手操作2. 开发环境搭建与基础驱动2.1 STM32CubeMX工程配置关键配置步骤时钟设置HSE选择Crystal/Ceramic Resonator系统时钟设置为72MHzGPIO配置// HC-SR04 PA0: Output Push Pull (Trig) PA1: Input with External Interrupt (Echo) // 按键 PA5: Input Pull-up (单位切换) PA6: Input Pull-up (极值重置) // 蜂鸣器 PA4: Output Push Pull定时器配置TIM2: 基本定时器预分频(PSC)71计数周期(ARR)65535这样配置后定时器每1μs计数一次I2C配置I2C1标准模式(100kHz)PB6: I2C1_SCL PB7: I2C1_SDA2.2 OLED显示驱动移植推荐使用经过优化的OLED驱动库// oled.h 中的关键函数声明 void OLED_Init(void); void OLED_Clear(void); void OLED_ShowString(uint8_t x,uint8_t y,char *str,uint8_t size); void OLED_ShowNum(uint8_t x,uint8_t y,uint32_t num,uint8_t len,uint8_t size); void OLED_Refresh(void);移植步骤将oled.c和oled.h添加到工程修改I2C写函数适配你的硬件void OLED_I2C_WriteByte(uint8_t addr, uint8_t data) { HAL_I2C_Mem_Write(hi2c1, 0x78, addr, I2C_MEMADD_SIZE_8BIT, data, 1, 100); }在main.c中初始化OLEDOLED_Init(); OLED_Clear(); OLED_ShowString(0, 0, Distance:, 16);3. 超声波测距核心算法实现3.1 时序控制与距离计算HC-SR04的工作流程触发信号(Trig)至少10μs的高电平脉冲回波信号(Echo)高电平持续时间与距离成正比精准测距的实现代码// sr04.h typedef struct { float distance_cm; float distance_inch; float max_distance; float min_distance; } SR04_Data; void SR04_StartMeasure(void); SR04_Data SR04_GetData(void); // sr04.c static TIM_HandleTypeDef *sr04_tim; static uint32_t pulse_width 0; static SR04_Data sr04_data {0}; void SR04_Init(TIM_HandleTypeDef *htim) { sr04_tim htim; sr04_data.max_distance 0; sr04_data.min_distance 999; } void SR04_StartMeasure(void) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET); delay_us(12); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET); } void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if(GPIO_Pin GPIO_PIN_1) { if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_1)) { // 上升沿 __HAL_TIM_SET_COUNTER(sr04_tim, 0); HAL_TIM_Base_Start(sr04_tim); } else { // 下降沿 HAL_TIM_Base_Stop(sr04_tim); pulse_width __HAL_TIM_GET_COUNTER(sr04_tim); // 计算距离声速340m/s单位cm sr04_data.distance_cm pulse_width * 0.017; sr04_data.distance_inch sr04_data.distance_cm / 2.54; // 更新极值 if(sr04_data.distance_cm sr04_data.max_distance) { sr04_data.max_distance sr04_data.distance_cm; } if(sr04_data.distance_cm sr04_data.min_distance) { sr04_data.min_distance sr04_data.distance_cm; } } } } SR04_Data SR04_GetData(void) { return sr04_data; }3.2 测量误差分析与滤波处理常见误差来源及解决方案温度影响声速随温度变化V 331.4 0.6*TT为摄氏温度可添加温度传感器DS18B20进行补偿多次测量取平均#define SAMPLE_TIMES 5 float get_filtered_distance(void) { float sum 0; for(int i0; iSAMPLE_TIMES; i) { SR04_StartMeasure(); HAL_Delay(50); // 每次测量间隔50ms sum SR04_GetData().distance_cm; } return sum / SAMPLE_TIMES; }异常值剔除设置合理范围HC-SR04有效距离2cm-400cm采用中值滤波算法4. 用户界面与功能扩展4.1 OLED界面设计界面布局方案------------------- | Distance: 123.4cm | | Max: 150.0cm | | Min: 10.2cm | | | | *INCH MODE* | -------------------实现代码示例void update_display(SR04_Data data, uint8_t unit_mode) { OLED_Clear(); // 标题 OLED_ShowString(0, 0, Distance:, 16); // 距离显示 if(unit_mode 0) { // cm模式 char buf[16]; sprintf(buf, %.1fcm, data.distance_cm); OLED_ShowString(60, 0, buf, 16); // 极值显示 OLED_ShowString(0, 2, Max:, 16); sprintf(buf, %.1fcm, data.max_distance); OLED_ShowString(40, 2, buf, 16); OLED_ShowString(0, 4, Min:, 16); sprintf(buf, %.1fcm, data.min_distance); OLED_ShowString(40, 4, buf, 16); } else { // inch模式 // 类似cm模式的显示逻辑 } // 模式指示 if(unit_mode 1) { OLED_ShowString(0, 6, *INCH MODE*, 16); } OLED_Refresh(); }4.2 按键功能实现按键处理状态机// 在main.c中 uint8_t unit_mode 0; // 0:cm, 1:inch void check_buttons(void) { static uint8_t last_state1 1; static uint8_t last_state2 1; uint8_t current1 HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_5); uint8_t current2 HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_6); // 按键1按下单位切换 if(last_state1 1 current1 0) { HAL_Delay(20); // 消抖 if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_5) 0) { unit_mode !unit_mode; } } last_state1 current1; // 按键2按下重置极值 if(last_state2 1 current2 0) { HAL_Delay(20); if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_6) 0) { sr04_data.max_distance 0; sr04_data.min_distance 999; } } last_state2 current2; }4.3 蜂鸣器报警功能实现接近报警功能#define ALARM_DISTANCE 20.0 // 报警阈值20cm void check_alarm(float distance) { if(distance ALARM_DISTANCE distance 2) { // 间歇鸣响 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET); HAL_Delay(100); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET); HAL_Delay(100); } else { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET); } }5. 系统整合与性能优化5.1 主程序逻辑框架int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); MX_TIM2_Init(); SR04_Init(htim2); OLED_Init(); uint32_t last_measure 0; while(1) { // 每100ms进行一次测量 if(HAL_GetTick() - last_measure 100) { SR04_StartMeasure(); last_measure HAL_GetTick(); } // 检查按键 check_buttons(); // 获取数据并更新显示 SR04_Data data SR04_GetData(); update_display(data, unit_mode); // 检查报警 check_alarm(data.distance_cm); } }5.2 低功耗优化技巧动态调整测量频率当距离稳定时降低采样率检测到物体移动时提高采样率OLED局部刷新void OLED_PartialRefresh(uint8_t x, uint8_t y, char *str, uint8_t size) { // 只刷新特定区域减少I2C通信量 }睡眠模式利用在两次测量之间让MCU进入Sleep模式使用定时器唤醒5.3 项目扩展方向添加蓝牙模块通过HC-05将数据发送到手机实现远程监控和数据记录数据记录功能添加SPI Flash存储历史数据支持通过按键查看历史记录激光辅助瞄准增加激光指示器精确定位测量点通过PWM控制激光强度外壳设计与3D打印使用Fusion 360设计专用外壳3D打印实现产品级外观在实际项目中我发现最影响测量精度的因素是环境温度和测量表面的材质。光滑的金属表面反射效果好测量距离远而柔软多孔的材料如布料则容易导致测量失败。解决方法是适当提高触发信号的脉冲宽度15-20μs并在软件中增加超时处理机制。