简介本资源是一套基于STM32F103C8T6的嵌入式雷达系统实战项目面向单片机初学者与嵌入式进阶学习者解决超声波测距、舵机协同控制与TFT图形化显示等典型综合应用问题。项目完整实现180°扫描式雷达功能SG90舵机驱动HC-SR04模块旋转测距数据实时映射至2.4寸TFT-LCD320×240生成动态雷达图并标注物体角度与距离高度还原真实雷达工作逻辑。压缩包含1024个文件主体为563个C源码与250个头文件实现SPI驱动LCD、TIM1/TIM2定时器捕获测距、TIM3 PWM舵机控制及雷达坐标转换算法辅以IAR工程配置.icf/.uvprojx、原理图PDF及ARM CMSIS-DSP数学库支持文件整体23.84MB。已有270人学习下载提供从CubeMX初始化配置、硬件引脚定义到雷达绘图算法的全链路代码与设计文档特别适合掌握外设协同开发与嵌入式图形界面实践。1. 项目概述与核心价值最近在捣鼓一个挺有意思的小项目用一块经典的“蓝板”——STM32F103C8T6最小系统板结合超声波模块和舵机做了一个简易的雷达扫描系统并且把扫描到的物体信息实时显示在一块2.4寸的TFT-LCD屏幕上。这个项目听起来可能有点复杂但拆解开来其实就是几个常见模块的组合应用非常适合想从点灯、按键这些基础操作进阶到综合项目实战的朋友。我自己在做这个项目的过程中踩了不少坑也积累了一些CubeMX配置和模块驱动上的心得今天就来详细聊聊怎么一步步把它实现出来。这个项目的核心目标很简单让舵机带着超声波模块旋转像雷达一样扫描前方扇形区域。超声波模块HC-SR04负责测量前方障碍物的距离舵机SG90的角度则代表了障碍物的方向。最后我们需要在屏幕上把这些信息直观地画出来形成一个动态的“雷达图”屏幕上会有一个扫描线在转动当探测到物体时就在对应的角度和距离上画一个点。这不仅仅是一个简单的数据采集显示更涉及到定时器PWM控制舵机、外部中断或输入捕获测量超声波回波时间、以及LCD图形绘制等多个单片机核心技能的融合。对于STM32的初学者来说这是一个绝佳的练手项目能让你对CubeMXHAL库的开发流程、外设协同工作有一个非常立体和深刻的理解。2. 硬件选型与电路设计思路2.1 主控芯片为什么是STM32F103C8T6选择STM32F103C8T6这块芯片几乎是所有STM32入门者的共同起点原因非常实在。首先它性价比极高市面上核心板价格低廉资源却足够丰富。它基于ARM Cortex-M3内核主频72MHz对于我们这个项目来说绰绰有余。我们需要用到的关键外设它都具备多个通用定时器用于产生PWM波驱动舵机、一个高级定时器可用于更精确的PWM或输入捕获、足够多的GPIO口连接屏幕、超声波模块、以及SPI或FSMC接口用于驱动TFT-LCD虽然F103C8T6没有FSMC但驱动2.4寸屏用模拟SPI或硬件SPI完全足够。注意STM32F103C8T6的Flash是64KBRAM是20KB。在开启较多外设和可能使用小型GUI库或大量图形缓冲区时需要留意RAM的使用情况。如果后续想显示更复杂的界面或加入更多功能可以考虑STM32F103CBT6128KB Flash。在电路连接上最小系统板通常已经集成了复位电路、晶振电路和USB转串口电路。我们主要需要关注的是其与各个模块的引脚连接。规划引脚时一个核心原则是优先满足硬件外设的专用功能。例如硬件SPI的SCK、MISO、MOSI引脚是固定的必须连接到对应的引脚上。对于PWM输出要查看芯片数据手册的“Alternate function mapping”表格选择具有定时器通道输出功能的引脚。2.2 执行与感知模块SG90舵机与HC-SR04超声波模块SG90舵机是一种位置伺服舵机工作电压通常在4.8V-6V控制信号是周期为20ms50Hz的PWM波通过高电平的脉宽0.5ms-2.5ms来控制输出角度0°-180°。这意味着我们需要STM32的一个定时器产生一路PWM信号。舵机的供电需要特别注意尤其是当舵机开始转动时电流可能会瞬间达到几百毫安如果直接使用STM32开发板上的3.3V或5V输出很可能导致电压被拉低单片机复位。最稳妥的做法是使用独立的外接电源如5V/2A的适配器为舵机供电并且确保舵机电源的地GND与STM32系统的地连接在一起。HC-SR04超声波模块是经典的测距模块它包含超声波发射器、接收器和控制电路。其工作原理是给Trig引脚一个至少10us的高电平脉冲触发测距模块会自动发射8个40kHz的超声波脉冲并检测回波。当接收到回波时Echo引脚会输出一个高电平其持续时间与距离成正比距离 (高电平时间 * 声速340m/s) / 2。因此我们需要STM32的一个GPIO输出Trig信号另一个GPIO最好支持外部中断或输入捕获来测量Echo高电平的持续时间。这里有一个关键点HC-SR04的Echo引脚输出是5V TTL电平而STM32的GPIO引脚耐受电压通常是3.3V。直接连接有烧毁引脚的风险。必须进行电平转换最简单的方案是使用一个由两个电阻组成的分压电路将5V电压分压至约3.3V。例如使用1kΩ和2kΩ电阻串联从Echo连接到STM32 IO口的电压就是 5V * (2k/(1k2k)) ≈ 3.3V。2.3 显示模块2.4寸TFT-LCD屏幕320x240我们使用的2.4寸TFT-LCD屏分辨率是320*240驱动芯片常见的是ILI9341或ST7789。这类屏幕通常通过并行8080接口或SPI接口与主控通信。对于STM32F103C8T6我更推荐使用SPI接口因为它占用的引脚少SCK, MOSI, MISO, CS, DC, RESET虽然刷屏速度比并行接口慢但对于我们这个雷达图应用主要是画线、画点而非整屏高速刷新已经完全足够而且接线和编程都更简单。屏幕的背光通常需要一个GPIO单独控制。在电路连接时务必仔细阅读屏幕供应商提供的资料确认其接口电压是3.3V还是5V。大多数这类屏幕的逻辑接口是3.3V兼容的但背光LED的供电可能是5V。如果屏幕需要5V供电同样需要为其提供独立的5V电源。2.4 整体电路连接规划基于以上分析我们可以规划出大致的连接方案STM32F103C8T6最小系统板提供3.3V和GND。SG90舵机信号线橙色 - STM32的某个定时器通道引脚如TIM2_CH1 - PA0。电源线红色 - 外部5V电源正极。地线棕色 - 外部5V电源负极且与STM32的GND相连。HC-SR04超声波模块VCC - 外部5V电源正极。Trig - STM32的某个GPIO输出引脚如PA1。Echo - 经分压电路5V转3.3V后连接到STM32的某个支持外部中断/输入捕获的引脚如PA2。GND - 外部5V电源负极且与STM32的GND相连。2.4寸 TFT-LCDVCC - 3.3V (如果逻辑电压是3.3V)。GND - GND。SCK - STM32的SPI1_SCK (PA5)。MOSI - STM32的SPI1_MOSI (PA7)。RESET - 某个GPIO (如PB0)。DC (数据/命令选择) - 某个GPIO (如PB1)。CS (片选) - 某个GPIO (如PA4)。BL (背光) - 通过一个限流电阻接3.3V或另一个GPIO控制。实操心得在面包板上搭建电路时强烈建议先分模块调试。先单独调试LCD显示一些静态图形或文字再单独调试舵机让它能平滑转动到指定角度最后再调试超声波测距。这样一旦出现问题排查范围会小很多。电源部分一定要处理好电机类负载的干扰很大可以在电源正负极之间并联一个100uF的电解电容和一个0.1uF的瓷片电容来滤波。3. CubeMX工程配置详解使用STM32CubeMX进行初始化配置可以极大简化外设的初始化过程避免底层寄存器操作的繁琐和错误。我们的配置将围绕几个核心外设展开。3.1 时钟树RCC配置系统时钟是单片机运行的基石。对于STM32F103C8T6我们通常使用外部高速时钟HSE并通过PLL倍频到最高的72MHz系统时钟SYSCLK。在“Pinout Configuration”标签页找到“RCC”设置。将“High Speed Clock (HSE)”选择为“Crystal/Ceramic Resonator”。假设你的核心板焊接了8MHz外部晶振。切换到“Clock Configuration”标签页。在这里进行图形化配置。输入源选择HSE。将PLL Source Mux选择为HSE。设置PLL倍频因子使PLL输出时钟为72MHz。对于8MHz的HSE倍频因子设为9即可8MHz * 9 72MHz。将系统时钟源SYSCLK选择为PLLCLK。设置APB1总线预分频器为2这样APB1的时钟PCLK1为36MHz。APB2总线时钟PCLK2保持72MHz。定时器挂在不同的APB总线上其时钟可能还会被倍频但CubeMX会自动计算好。3.2 定时器配置产生舵机PWM波我们使用一个通用定时器如TIM2来产生控制SG90的PWM信号。在“Pinout”视图找到TIM2。选择通道1Channel1为“PWM Generation CH1”。此时对应的引脚PA0会自动被配置为复用推挽输出模式。在“Parameter Settings”选项卡中配置定时器Prescaler (预分频器) 71。定时器时钟来源于APB1经过内部倍频后为72MHz。预分频71则计数器时钟为 72MHz / (711) 1MHz。Counter Mode (计数模式) Up向上计数。Counter Period (自动重装载值) 19999。我们希望产生周期为20ms的PWM波。计数器时钟为1MHz即每计数一次为1us。周期20ms对应20000us。由于计数器从0开始计数所以Period设置为19999。Pulse (脉冲值) 初始值可设为1500对应1.5ms脉宽舵机中位90度。这个值后续在代码中动态修改。CH Polarity (通道极性) High。即有效电平为高电平。这样配置后PWM频率 1MHz / (19999 1) 50Hz周期20ms。脉宽 (Pulse 1) * 1us。通过修改__HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, pulse_width)即可控制舵机角度其中pulse_width范围约为5000.5ms0度到25002.5ms180度。3.3 GPIO与外部中断配置超声波模块驱动HC-SR04需要两个GPIO一个输出Trig一个输入Echo。配置Trig引脚如PA1为“GPIO_Output”模式默认推挽输出无上下拉。配置Echo引脚如PA2为“GPIO_EXTI2”外部中断2。因为PA2对应EXTI2。模式选择为“上升沿和下降沿触发”Rising/Falling edge trigger。这样Echo引脚的电平变化都会触发中断。在“NVIC Settings”中使能对应的外部中断线如EXTI line2 interrupt并设置合适的优先级。3.4 SPI配置驱动TFT-LCD屏幕我们使用SPI1与屏幕通信。在“Pinout”视图找到SPI1。选择模式为“Full-Duplex Master”或“Transmit Only Master”如果屏幕只接收数据。硬件NSS信号通常不用选择“Disable”。对应的引脚PA5-SCK PA6-MISO PA7-MOSI会自动配置。在“Parameter Settings”中配置SPIBaud Rate 可以先设置为较低速度如“FPCLK / 8”以确保通信稳定调试成功后再尝试提高。Clock Polarity (CPOL) Low。Clock Phase (CPHA) 1 Edge。具体需要根据你的LCD驱动芯片数据手册确定ILI9341通常为CPOLLow CPHA1Edge。Data Size 8 Bits。First Bit MSB First。配置屏幕的其他控制引脚RESET, DC, CS为“GPIO_Output”。3.5 生成工程代码在“Project Manager”标签页设置好工程名称、路径、IDE如MDK-ARM V5。在“Code Generator”中建议选择“Copy only necessary library files”以减小工程体积并勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”以便于管理。 点击“GENERATE CODE”CubeMX会生成完整的初始化代码。我们需要做的就是在生成的工程框架中添加自己的应用逻辑。4. 核心驱动与功能实现4.1 SG90舵机角度控制函数在main.c或单独的驱动文件中我们可以编写一个函数来控制舵机角度。HAL库提供了便捷的PWM设置函数。// 定义舵机PWM脉宽范围对应0.5ms - 2.5ms 1MHz时钟下计数值 #define SERVO_MIN_PULSE 500 // 0度 #define SERVO_MAX_PULSE 2500 // 180度 #define SERVO_MID_PULSE 1500 // 90度 /** * brief 设置SG90舵机角度 * param angle: 目标角度范围0-180 * retval None */ void Servo_SetAngle(uint16_t angle) { uint16_t pulse_width; // 将角度线性映射到脉宽计数值 if(angle 180) angle 180; pulse_width SERVO_MIN_PULSE (SERVO_MAX_PULSE - SERVO_MIN_PULSE) * angle / 180; // 使用HAL库函数设置比较寄存器的值 __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, pulse_width); }在main函数的初始化部分while(1)之前需要启动PWM输出HAL_TIM_PWM_Start(htim2, TIM_CHANNEL_1); Servo_SetAngle(90); // 初始置于90度位置4.2 HC-SR04超声波测距实现超声波测距的核心是精确测量Echo高电平的持续时间。我们使用外部中断的方式来实现。首先在stm32f1xx_it.c中找到外部中断服务函数EXTI2_IRQHandler假设Echo接PA2对应EXTI2。// 定义全局变量用于测量 volatile uint32_t ultrasonic_rising_time 0; volatile uint32_t ultrasonic_falling_time 0; volatile uint32_t ultrasonic_distance_mm 0; volatile uint8_t ultrasonic_measure_done 0; void EXTI2_IRQHandler(void) { if(__HAL_GPIO_EXTI_GET_IT(GPIO_PIN_2) ! RESET) { // 判断是上升沿还是下降沿 if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_2) SET) // 上升沿 { ultrasonic_rising_time HAL_GetTick(); // 记录开始时间使用毫秒计时 // 或者使用定时器计数器获取更精确的微秒级时间 // ultrasonic_rising_time __HAL_TIM_GET_COUNTER(htim3); } else // 下降沿 { ultrasonic_falling_time HAL_GetTick(); uint32_t pulse_duration ultrasonic_falling_time - ultrasonic_rising_time; // 单位ms // 计算距离距离(mm) (时间(ms) * 声速(340m/s0.34mm/us) * 1000) / 2 // 简化距离(mm) 时间(ms) * 340 * 1000 / 2 / 1000 时间(ms) * 170 ultrasonic_distance_mm pulse_duration * 170; // 注意此计算基于毫秒精度有限 ultrasonic_measure_done 1; // 标记测量完成 } __HAL_GPIO_EXTI_CLEAR_IT(GPIO_PIN_2); } }重要提示使用HAL_GetTick()毫秒定时器测量脉宽精度很低因为HC-SR04的Echo脉宽在几毫秒以内对应几米距离毫秒级的误差会导致几十厘米的测距误差。正确做法是使用一个定时器的输入捕获功能或者直接读取定时器计数器的值来获取微秒级时间。例如可以配置一个定时器如TIM3以1MHz计数1us计数一次在上升沿中断时记录计数器值TIM3-CNT在下降沿中断时再次记录并计算差值。这里为了简化示例使用了毫秒定时器实际项目务必改进。然后我们编写触发测距的函数/** * brief 触发一次HC-SR04测距 * retval None */ void Ultrasonic_StartMeasure(void) { ultrasonic_measure_done 0; ultrasonic_distance_mm 0; HAL_GPIO_WritePin(TRIG_GPIO_Port, TRIG_Pin, SET); // Trig拉高 HAL_Delay(1); // 延迟至少10us这里用1ms保证足够 HAL_GPIO_WritePin(TRIG_GPIO_Port, TRIG_Pin, RESET); // Trig拉低 }在main函数的循环中可以周期性地调用Ultrasonic_StartMeasure()然后检查ultrasonic_measure_done标志当其为1时读取ultrasonic_distance_mm即为测得的距离。4.3 TFT-LCD屏幕驱动与图形绘制驱动TFT-LCD需要先实现底层的SPI发送数据和命令的函数然后根据驱动芯片如ILI9341的数据手册编写初始化序列、设置窗口、写像素等函数。网上有大量开源的驱动代码通常叫ili9341.c/.h或st7789.c/.h我们可以直接移植。这里给出关键函数的思路底层通信函数void LCD_WriteCommand(uint8_t cmd) { LCD_DC_CMD(); // DC引脚拉低表示命令 LCD_CS_LOW(); HAL_SPI_Transmit(hspi1, cmd, 1, HAL_MAX_DELAY); LCD_CS_HIGH(); } void LCD_WriteData(uint8_t data) { LCD_DC_DATA(); // DC引脚拉高表示数据 LCD_CS_LOW(); HAL_SPI_Transmit(hspi1, data, 1, HAL_MAX_DELAY); LCD_CS_HIGH(); } void LCD_WriteData_16bit(uint16_t data) { uint8_t buf[2]; buf[0] data 8; buf[1] data 0xFF; LCD_DC_DATA(); LCD_CS_LOW(); HAL_SPI_Transmit(hspi1, buf, 2, HAL_MAX_DELAY); LCD_CS_HIGH(); }初始化函数按照驱动芯片数据手册依次发送一系列初始化命令和参数。这部分代码较长通常是固定的。设置绘图窗口函数告诉屏幕接下来要写入像素数据的区域。void LCD_SetWindow(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1) { // 发送设置列地址命令和参数 LCD_WriteCommand(0x2A); LCD_WriteData_16bit(x0); LCD_WriteData_16bit(x1); // 发送设置行地址命令和参数 LCD_WriteCommand(0x2B); LCD_WriteData_16bit(y0); LCD_WriteData_16bit(y1); // 发送写内存命令 LCD_WriteCommand(0x2C); }画点函数这是最基本的图形函数雷达图上每一个物体点都通过它绘制。void LCD_DrawPoint(uint16_t x, uint16_t y, uint16_t color) { if(x LCD_WIDTH || y LCD_HEIGHT) return; // 边界检查 LCD_SetWindow(x, y, x, y); LCD_WriteData_16bit(color); // 发送颜色值RGB565格式 }画线函数用于绘制雷达的扫描线和坐标轴。可以使用Bresenham算法实现。void LCD_DrawLine(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint16_t color) { int16_t dx abs(x1 - x0), sx x0 x1 ? 1 : -1; int16_t dy -abs(y1 - y0), sy y0 y1 ? 1 : -1; int16_t err dx dy, e2; // 误差项 while(1){ LCD_DrawPoint(x0, y0, color); if (x0 x1 y0 y1) break; e2 2 * err; if (e2 dy) { err dy; x0 sx; } // 水平步进 if (e2 dx) { err dx; y0 sy; } // 垂直步进 } }有了这些基础函数我们就可以在屏幕上绘制雷达界面了。5. 雷达扫描系统整合与主程序逻辑5.1 坐标系统转换雷达图通常以极坐标形式显示一个点由角度θ和距离r确定。而我们的屏幕是直角坐标系x, y。因此需要进行坐标转换。 假设我们将屏幕中心(160, 120)设为雷达扫描中心即舵机位置。扫描最大半径设为R_max例如100像素对应超声波最大量程如4米。那么对于一个探测到的物体其极坐标为(angle, distance_mm)在屏幕上的位置(x, y)可以计算为// 将实际距离毫米映射到屏幕像素半径 float scale (float)R_max / MAX_DETECT_DISTANCE_MM; // MAX_DETECT_DISTANCE_MM是最大检测距离如4000mm float r_pixel distance_mm * scale; // 极坐标转直角坐标 // 注意雷达扫描角度0-180度需要转换为数学上的角度0-180度但屏幕Y轴向下为正。 // 我们假设舵机0度对应屏幕正上方12点钟方向。 float theta_rad (angle 90) * 3.14159265f / 180.0f; // 90是为了将0度转到上方并转换为弧度 int16_t x 160 (int16_t)(r_pixel * cosf(theta_rad)); int16_t y 120 - (int16_t)(r_pixel * sinf(theta_rad)); // 屏幕Y轴向下所以用减号这里angle是舵机当前角度0-180distance_mm是测量距离。我们通过90将舵机的0度可能是左极限映射到了屏幕的90度方向正上方。你可以根据实际的舵机安装方向调整这个偏移量。5.2 主循环程序设计主程序需要一个状态机来控制舵机扫描、触发测距、处理数据并刷新显示。一个简单的非阻塞式扫描逻辑如下// 定义全局状态变量 typedef enum { SCAN_MOVING, SCAN_MEASURING, SCAN_WAITING } ScanState_t; ScanState_t scan_state SCAN_MOVING; uint16_t current_angle 0; uint8_t scan_direction 0; // 0: 0-180, 1: 180-0 uint32_t last_operation_time 0; int main(void) { // HAL初始化、外设初始化... LCD_Init(); LCD_Clear(BLACK); Draw_Radar_Background(); // 绘制雷达背景同心圆、角度线等 Servo_SetAngle(current_angle); while (1) { switch(scan_state) { case SCAN_MOVING: // 控制舵机步进到下一个角度 if(HAL_GetTick() - last_operation_time 20) // 每20ms移动一步让舵机有足够时间到位 { if(scan_direction 0) { current_angle; if(current_angle 180) { current_angle 180; scan_direction 1; scan_state SCAN_MEASURING; } } else { current_angle--; if(current_angle 0) { current_angle 0; scan_direction 0; scan_state SCAN_MEASURING; } } Servo_SetAngle(current_angle); last_operation_time HAL_GetTick(); scan_state SCAN_MEASURING; // 移动到新角度后进入测量状态 } break; case SCAN_MEASURING: // 触发一次超声波测距 Ultrasonic_StartMeasure(); scan_state SCAN_WAITING; last_operation_time HAL_GetTick(); break; case SCAN_WAITING: // 等待测量完成 if(ultrasonic_measure_done) { // 测量完成处理数据 if(ultrasonic_distance_mm 50 ultrasonic_distance_mm 4000) // 有效距离范围 { // 坐标转换 int16_t obj_x, obj_y; PolarToCartesian(current_angle, ultrasonic_distance_mm, obj_x, obj_y); // 在雷达图上画点可以用一个醒目的颜色比如红色 LCD_DrawPoint(obj_x, obj_y, RED); // 也可以选择将点存储到数组中实现轨迹残留效果 } ultrasonic_measure_done 0; scan_state SCAN_MOVING; // 准备移动到下一个角度 } // 增加超时处理防止卡死 else if(HAL_GetTick() - last_operation_time 100) // 等待超时100ms { ultrasonic_measure_done 0; scan_state SCAN_MOVING; } break; } // 绘制扫描线从中心指向当前角度方向 Draw_Scanning_Line(current_angle); // 其他任务如按键处理、显示刷新等 // ... } }Draw_Radar_Background函数用于绘制静态的雷达背景如以屏幕中心为圆心的几个同心圆表示距离以及从中心出发的几条射线表示角度如0°45°90°等。Draw_Scanning_Line函数则根据current_angle实时绘制一条从中心指向边缘的线这条线会随着舵机转动而旋转形成扫描效果。注意在画新线之前需要擦除旧的扫描线。一个简单的方法是在绘制新扫描线之前在上一个角度的位置上用背景色黑色再画一次旧线然后再画新线。5.3 显示优化与数据平滑直接绘制原始测量点可能会因为超声波数据的抖动而在屏幕上显示为跳跃的、分散的点。为了显示效果更稳定可以考虑加入简单的数据滤波算法。移动平均滤波存储最近几次的测量距离取平均值作为当前显示值。这能有效平滑随机噪声。#define FILTER_SIZE 5 uint32_t distance_history[FILTER_SIZE] {0}; uint8_t history_index 0; uint32_t Apply_Filter(uint32_t new_distance) { distance_history[history_index] new_distance; history_index (history_index 1) % FILTER_SIZE; uint32_t sum 0; for(int i0; iFILTER_SIZE; i) { sum distance_history[i]; } return sum / FILTER_SIZE; }轨迹残留效果如果不希望物体点一闪而过可以将探测到的点存储在一个环形缓冲区中每一帧都重绘缓冲区中的所有点。还可以让点的颜色随时间逐渐变淡直至消失模拟真实雷达的PPI显示效果。这会增加对RAM和CPU的需求需要根据单片机资源权衡。6. 调试技巧与常见问题排查6.1 舵机不转动或抖动问题现象舵机毫无反应或者发出“吱吱”声但不转动或转动不顺畅。排查思路供电不足这是最常见的原因。确保使用独立、功率足够至少1A的5V电源为舵机供电并且共地。可以用万用表测量舵机电源引脚处的电压在舵机转动时是否跌落到5V以下。信号问题用示波器或逻辑分析仪检查STM32输出的PWM波形。确认周期是否为20ms50Hz脉宽是否在0.5ms-2.5ms之间变化。如果没有仪器可以尝试用HAL_Delay做一个简单的测试在一个循环里交替输出0.5ms高电平和19.5ms低电平模拟0度再交替输出2.5ms高电平和17.5ms低电平模拟180度看舵机是否在两个极限位置摆动。接线错误检查信号线是否接错。SG90的线序通常是棕色(GND)红色(VCC)橙色(Signal)。6.2 超声波测距不准或无返回值问题现象距离值固定为0、一个极大值或非常不稳定。排查思路电平转换首要检查确认Echo引脚是否通过分压电路连接到了STM32。直接用5V连接会损坏IO口。测量Echo引脚连接到STM32之前的电压确保是3.3V左右。中断冲突或丢失如果使用外部中断确保中断服务函数中清除了中断标志位。检查是否有其他更高优先级的中断长时间阻塞导致丢失Echo的上升沿或下降沿。可以尝试在中断函数里翻转一个测试用的GPIO用示波器看中断响应是否及时。测量时序精度如前所述使用HAL_GetTick()测量微秒级脉宽误差太大。必须改用定时器输入捕获或直接读取高速运行的定时器计数器。配置一个1MHz的定时器在上升沿和下降沿记录TIMx-CNT的值差值即为微秒数。物理因素超声波对被测物体表面材质、角度敏感。确保被测物体表面平整、面积足够大、且正对模块。避免在狭窄空间或有强声波干扰的环境测试。6.3 TFT-LCD白屏或花屏问题现象屏幕全白、全黑、出现彩色条纹或显示错乱。排查思路初始化序列90%的问题出在初始化代码。仔细核对驱动芯片型号ILI9341/ST7789等确保发送的初始化命令和参数序列完全正确。不同厂家、不同批次的屏幕初始化序列可能有细微差别。SPI时序检查SPI的时钟极性(CPOL)和相位(CPHA)设置是否与屏幕驱动芯片要求一致。通常模式0CPOL0 CPHA0或模式3CPOL1 CPHA1是常用的。可以尝试切换模式。通信速度初期先将SPI波特率设到最低确保通信稳定。显示正常后再逐步提高速度。复位和延时确保上电后给屏幕的RESET引脚一个足够长的低电平脉冲比如100ms。在发送初始化命令之间特别是软复位命令后增加足够的延时HAL_Delay。电源检查屏幕的VCC和背光电压是否满足要求。逻辑电压是3.3V还是5V背光是否需要串联限流电阻6.4 系统整合后运行异常问题现象单个模块测试都正常但整合后单片机频繁复位、舵机乱转、屏幕闪烁。排查思路电源干扰这是电机和数字电路共存的典型问题。确保电机电源与单片机电源在源头如稳压芯片输入端就分开或者使用大电容如470uF电解电容并联0.1uF瓷片电容在电机电源引脚处进行退耦。地线环路确保所有模块的“地”是单点连接在一起的避免形成地线环路引入噪声。堆栈溢出如果使用了中断并在中断中调用了耗时的函数如HAL_Delay或通过SPI向屏幕发送大量数据可能导致中断嵌套或堆栈溢出。确保中断服务函数快进快出仅做标志位设置、时间记录等简单操作复杂处理放到主循环中。定时器冲突检查使用的定时器资源是否冲突。例如用于PWM的TIM2用于输入捕获的TIM3以及系统滴答定时器Systick它们的中断优先级设置是否合理。这个项目从硬件连接到软件逻辑涵盖了嵌入式开发的多个基础且重要的环节。调试过程虽然会遇到各种问题但每一个问题的解决都会让你对单片机的理解更深一层。当你最终看到屏幕上那个随着真实物体移动而动态变化的雷达光点时那种成就感绝对是单纯的点灯无法比拟的。最重要的是通过这个项目积累的模块驱动、多任务调度、数据处理和调试经验可以无缝地应用到更复杂的嵌入式项目中去。本文还有配套的精品资源点击获取