简介这是一份面向嵌入式初学者与课程设计者的STM32雷达模拟系统实战项目资源基于STM32F103C8T6主控融合舵机控制、超声波测距与TFT-LCD图形显示三大核心技能完整复现简易机械扫描雷达的工作原理。资源包共1024个文件涵盖563个C源码含驱动与算法实现、250个头文件定义外设配置与LCD绘图接口、51个汇编启动文件及Keil/IAR工程配置文件.uvprojx、.ioc、.icf等并包含关键的PDF原理图与雷达图像算法模块如线性插值、DCT初始化等数学库支持。目前已有270人学习下载适合用于单片机综合实训、电子设计竞赛备赛或毕业设计参考。读者可直接部署运行在2.4寸SPI接口TFT屏上实时绘制极坐标雷达图同步显示物体角度与距离并深入理解定时器PWM输出、输入捕获测距、LCD点阵绘图及坐标映射等关键技术实现细节。1. 项目概述一个嵌入式雷达扫描系统的诞生最近在整理工作室的旧项目翻出来一个几年前用STM32F103C8T6做的超声波雷达扫描仪感觉挺有意思的。这个项目的核心目标很简单让一个SG90舵机带着HC-SR04超声波模块旋转像雷达一样扫描前方区域然后把探测到的物体位置角度和距离实时显示在一块2.4寸的TFT-LCD屏幕上画出一个动态的“雷达图”。听起来是不是有点像简易版的自动驾驶感知demo或者扫地机器人的避障预览其实它的应用场景可以很广比如作为小型机器人的环境感知前端、智能小车的避障演示教具或者就是一个很酷的桌面交互装置。为什么选STM32F103C8T6这块经典的“蓝桥杯”神片原因无他就是性价比高、资料多、生态成熟。对于这种需要同时处理舵机PWM、超声波测距时序、LCD刷屏以及坐标计算的中等复杂度项目C8T6的72MHz主频、64KB Flash和20KB RAM完全够用而且引脚数量也刚好满足我们的需求。整个开发流程基于STM32CubeMX进行图形化配置配合HAL库能极大降低底层驱动的开发难度让我们把精力集中在应用逻辑上。SG90舵机负责提供0-180度的扫描角度HC-SR04超声波模块负责测量距离最后通过SPI或FSMC接口驱动那块320x240分辨率的TFT-LCD将极坐标角度、距离转换为屏幕上的直角坐标点一幅动态的雷达扫描图就跃然屏上了。无论你是想学习STM32多外设协同、实时系统概念还是想做一个有趣的实物这个项目都是一个不错的起点。2. 硬件选型与核心电路设计解析2.1 主控芯片STM32F103C8T6的引脚分配策略STM32F103C8T6属于STM32F1系列的“中等容量”产品48个引脚资源对于本项目来说需要精打细算。使用CubeMX配置时清晰的引脚规划是成功的第一步。首先SG90舵机需要一路PWM信号。舵机的控制信号是一个周期为20ms50Hz脉宽在0.5ms到2.5ms之间的PWM波对应0到180度的位置。我们可以使用定时器TIM的PWM输出通道来生成。这里我选择了TIM2的通道1PA0因为PA0是5V容忍的引脚虽然SG90信号线一般是3.3V兼容但这样更稳妥。在CubeMX中需要将TIM2的通道1配置为PWM Generation CH1模式预分频器和自动重载值ARR的设置需要计算以达到20ms的周期。假设系统时钟是72MHz经过适当分频让计数器频率为1MHz那么ARR设置为20000-1即可得到20ms的周期。脉宽则由捕获比较寄存器CCR的值控制500对应0.5ms0度2500对应2.5ms180度。其次HC-SR04超声波模块需要两个GPIO一个用于触发Trig一个用于回波Echo。Trig引脚输出一个至少10us的高电平脉冲我选择了PA1配置为推挽输出。Echo引脚用于检测高电平的持续时间这个时间与距离成正比。这里有个关键点HC-SR04的Echo脚输出是5V电平而STM32的IO口通常只耐受3.3V。绝对不能直接连接常见的解决方案是使用一个简单的电阻分压电路例如1kΩ和2kΩ串联将5V分压到约3.3V后再接入STM32的引脚。我选择了PA2并将其配置为输入模式同时开启上升沿/下降沿中断用于精确测量高电平脉宽。最后是2.4寸TFT-LCD屏幕。这类屏幕通常使用SPI接口或8位/16位并行接口。为了获得更快的刷屏速度这对动态雷达图很重要我强烈推荐使用并口。STM32F103C8T6没有专用的FSMCFlexible Static Memory Controller控制器但我们可以用GPIO模拟8位并口或者使用它的“FSMC”功能实际上C8T6没有但一些兼容屏的驱动芯片支持8080时序我们可以用GPIO模拟8080时序。为了简化我选择了SPI接口虽然速度稍慢但对于320*240分辨率、仅更新变化点的雷达图来说优化后完全可以接受。我使用了SPI1PA5-SCK PA6-MISO PA7-MOSI以及一个额外的GPIOPA4作为片选CS另一个PB0作为数据/命令选择线DC还有一个PB1作为复位线RST。注意电源是关键SG90舵机在转动时电流可能达到数百mA绝对不能直接用STM32开发板上的3.3V或5V引脚供电否则极易导致芯片复位或损坏。必须为舵机提供独立的外接电源例如5V/2A的适配器并将此电源地与STM32的地GND连接在一起确保共地。2.2 外设模块特性与接口要点SG90舵机这是一个180度模拟舵机。其内部有一个基准电路、一个比较器、一个电机驱动和一个位置反馈电位器。PWM信号的本质是提供一个基准电压舵机内部通过比较来决定转动方向和幅度。除了PWM控制线橙色/黄色还有电源线红色5V和地线棕色。控制的关键是精度和稳定性。定时器产生的PWM波需要非常稳定周期抖动会导致舵机抖动。在软件上我们通常以1度为最小单位改变CCR值对应脉宽变化约11us。扫描时可以让舵机以固定步长如1度或2度从0度移动到180度再返回形成一个周期性的扫描运动。HC-SR04超声波模块它通过Trig引脚触发一次测距然后从Echo引脚输出一个与距离成正比的高电平脉冲。距离计算公式为距离 (高电平时间 * 声速) / 2。声速在常温下可取340m/s或343m/s。高电平时间单位是微秒us除以58即可得到厘米数除以58000得到米数。这个“58”的由来就是 (34000 cm/s) / (2 * 1000000 us/s) ≈ 0.017 cm/us取倒数约为58.8。测量时需要注意模块的盲区通常2-3cm以及声波的散射角。对于雷达扫描我们假设探测到的物体是一个点但实际上超声波波束是有宽度的这会影响角度分辨率。2.4寸 TFT-LCD我使用的是一款常见的驱动芯片为ILI9341的屏幕。它支持SPI和8位并行模式。SPI模式下需要向屏幕写入命令和数据来初始化、设置窗口、写入像素颜色。颜色格式通常是RGB56516位色即一个像素点用两个字节表示5位红6位绿5位蓝。绘制雷达图时我们需要频繁地进行画点操作。为了提高效率可以先将整个屏幕清空为背景色如黑色然后在每个扫描角度根据测得的距离在对应的极坐标位置画一个亮色的点如绿色。为了有“扫描线”效果可以在当前角度画线并逐渐擦除之前角度的线。3. CubeMX工程配置与HAL库驱动搭建3.1 系统时钟与关键外设的CubeMX图形化配置打开STM32CubeMX选择STM32F103C8T6芯片。首先配置时钟树Clock Configuration。我们的目标是将系统时钟SYSCLK设置为72MHz这是F103系列在外部8MHz晶振HSE下的标准最高速度。在图形界面中选择HSE作为时钟源经过PLL倍频将PLLCLK设置为72MHz然后作为SYSCLK。APB1总线时钟PCLK1最高36MHzAPB2总线时钟PCLK2最高72MHz。定时器挂在不同的APB总线上时钟可能会被倍频CubeMX会帮你计算好我们只需确保最终定时器的计数时钟是我们期望的频率如1MHz用于舵机PWM。接下来配置引脚Pinout ConfigurationTIM2 CH1 (PWM输出)在左侧“Timers”中找到TIM2选择“Clock Source”为“Internal Clock”然后在“Channel1”中选择“PWM Generation CH1”。此时PA0会被自动配置。转到“Parameter Settings”选项卡设置预分频器Prescaler和计数器周期Counter Period。为了得到1MHz的计数频率如果APB1的TIM2时钟是72MHz则预分频器应设为7172MHz/(711)1MHz。计数器周期ARR设为19999这样PWM周期就是20000个时钟周期即20ms。脉冲宽度Pulse先设为1500对应1.5ms90度中间位置。注意将“PWM Generation CH1”的“Mode”设置为“PWM mode 1”极性Polarity根据舵机要求设置通常为高电平有效。GPIO for HC-SR04找到PA1设置为“GPIO_Output”命名为“Trig”。找到PA2设置为“GPIO_Input”并开启外部中断。在“NVIC Settings”中使能EXTI line2中断。SPI for LCD在“Connectivity”中选择SPI1。模式设置为“Full-Duplex Master”硬件NSS选择“Disable”。参数设置中波特率可以设高一些比如18Mbits/s需要看屏幕芯片支持情况。数据大小8位时钟极性低时钟相位第1边沿。引脚会自动分配为PA5(SCK) PA6(MISO) PA7(MOSI)。然后手动配置PA4为“GPIO_Output”作为CSPB0作为DCPB1作为RST。SYS将“Debug”改为“Serial Wire”这样可以使用ST-LINK进行调试和下载。Project Manager设置好项目名称、路径、IDEMDK-ARM或STM32CubeIDE在“Code Generator”中选择“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”这样代码结构更清晰。生成代码后一个包含所有初始化代码的工程就创建好了。3.2 HAL库超声波测距与舵机控制代码实现在生成的工程中我们主要编写应用层代码。舵机角度控制函数// 设置舵机角度angle范围0-180 void Servo_SetAngle(TIM_HandleTypeDef *htim, uint32_t Channel, uint8_t angle) { if(angle 180) angle 180; // 将角度转换为PWM脉宽单位us // 0度-500us, 180度-2500us线性映射 // CCR值 脉宽(us) * 定时器计数频率(MHz) // 假设定时器计数频率为1MHz即1us计数1次 uint32_t pulse_width_us 500 angle * (2000 / 180); // 简化计算避免浮点 // 更精确的公式pulse 500 angle * 2000.0 / 180.0; __HAL_TIM_SET_COMPARE(htim, Channel, pulse_width_us); }这个函数封装了角度到PWM占空比的转换。在主循环或定时器中断中我们可以周期性地调用此函数改变角度值让舵机匀速转动。超声波测距模块驱动 超声波测距需要精确计时我们利用Echo引脚的外部中断和定时器来实现。// 全局变量用于存储高电平开始和结束的时间戳 volatile uint32_t ultrasonic_rising_tick 0; volatile uint32_t ultrasonic_falling_tick 0; volatile uint32_t distance_cm 0; volatile uint8_t ultrasonic_measure_done 0; // Echo引脚外部中断回调函数在stm32f1xx_it.c中声明或在main.c中重写弱函数 void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if(GPIO_Pin GPIO_PIN_2) { // PA2 if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_2) GPIO_PIN_SET) { // 上升沿记录开始时间 ultrasonic_rising_tick HAL_GetTick(); // 使用毫秒定时器精度不够 // 为了更高精度应该使用一个定时器的计数器值例如TIM3的CNT ultrasonic_rising_tick __HAL_TIM_GET_COUNTER(htim3); } else { // 下降沿记录结束时间计算距离 ultrasonic_falling_tick __HAL_TIM_GET_COUNTER(htim3); uint32_t pulse_width_ticks ultrasonic_falling_tick - ultrasonic_rising_tick; // 假设TIM3的计数频率为1MHz1个tick1us // 距离 脉宽(us) / 58.0 (cm) distance_cm pulse_width_ticks / 58; ultrasonic_measure_done 1; } } } // 触发一次测距的函数 void Ultrasonic_StartMeasure(void) { HAL_GPIO_WritePin(Trig_GPIO_Port, Trig_Pin, GPIO_PIN_SET); HAL_Delay_us(12); // 需要实现一个微秒级延时函数可以用定时器或NOP循环 HAL_GPIO_WritePin(Trig_GPIO_Port, Trig_Pin, GPIO_PIN_RESET); }这里的关键是高精度计时。HAL_GetTick()是毫秒级对于超声波测距厘米级精度对应几十微秒的脉宽来说误差太大。因此我使用了一个额外的定时器如TIM3将其时钟配置为1MHz在中断中读取它的计数器值CNT精度可以达到1微秒。微秒延时函数HAL_Delay_us可以用一个简单的循环实现或者用另一个定时器。实操心得中断的优化。在Echo中断回调函数中不要做复杂计算或调用耗时的HAL函数。最好只记录时间戳设置标志位把距离计算放到主循环中。同时注意中断嵌套和优先级避免超声波中断被其他高优先级中断阻塞导致计时错误。4. 雷达扫描逻辑与坐标变换算法4.1 扫描策略与数据采集的时序控制一个完整的雷达扫描周期是舵机从0度匀速运动到180度同时在每个角度或每隔几个角度触发超声波测距并记录数据。这里涉及到多任务协调舵机控制PWM更新、超声波触发与读取、LCD刷新。一个简单可靠的架构是利用定时器中断来构建一个时间片轮询系统。我们可以设置一个基础定时器如TIM4每10ms产生一次中断。在这个中断服务函数中维护一个状态机状态0 - 移动舵机每进入中断若干次比如2次即20ms后更新一次舵机目标角度步进1度。这样舵机大约每20ms移动1度从0到180度需要3.6秒速度比较平滑。状态1 - 触发测距在更新舵机角度后立即触发一次超声波测距调用Ultrasonic_StartMeasure。状态2 - 等待结果等待ultrasonic_measure_done标志被置位。由于超声波测距本身需要几十毫秒最大测距对应的时间这个等待过程是非阻塞的我们只是在下一次中断时检查标志位。状态3 - 处理数据当标志位为1时读取distance_cm结合当前的舵机角度计算物体在屏幕上的坐标并标记该点需要刷新。然后清除标志位准备下一个角度的测量。这样舵机的运动、超声波的触发和数据的处理就被一个定时器中断有序地串联起来避免了在主循环中使用HAL_Delay导致的阻塞使得LCD刷新和其他逻辑如按键扫描可以同时在主循环中运行。4.2 从极坐标到屏幕直角坐标的映射与绘图超声波测得的距离r和舵机角度θ构成了一个极坐标系下的数据点。我们需要将其映射到320x240的LCD直角坐标系上。通常我们将雷达的扫描中心舵机旋转轴映射到屏幕底部中间假设为点(X0, Y0)。例如令X0 160屏幕水平中心Y0 220靠近屏幕底部留出一些空间显示信息。那么屏幕上点的坐标(x, y)可以通过以下公式计算x X0 r * sin(θ) * scale_factor; y Y0 - r * cos(θ) * scale_factor; // 注意屏幕y轴向下为正所以用减法其中θ需要从角度转换为弧度rad θ * π / 180.0。scale_factor是一个缩放因子因为超声波测距的单位是厘米而屏幕像素有限。例如如果最大显示距离为100cm我们希望它映射到屏幕上方约100像素的范围那么scale_factor可以设为 1.0即1像素代表1厘米或者根据布局调整。sin和cos计算在STM32上如果直接使用标准库的sinf和cosf函数计算浮点数开销较大。对于这种实时性要求不极端高的应用可以接受。如果追求效率可以预先计算好0-180度每个角度的sin和cos值存入数组直接查表。绘图策略背景每次扫描开始前可以用一种颜色如黑色或深蓝色清除整个屏幕绘制固定的雷达刻度线和角度标识。扫描线绘制一条从中心(X0, Y0)到当前角度对应最大半径处的线段颜色为亮色如青色表示当前正在扫描的方向。历史轨迹点将每个有效测距点距离在合理范围内如2cm-400cm根据上述公式计算坐标并在该坐标画一个点。为了有“余晖”效果可以不用立即擦除旧点而是让旧点随着时间慢慢变暗或消失。一个简单实现是在绘制新点前将整个“扫描区域”一个扇形用半透明的背景色重绘一次这样旧点就会变淡新点最亮。物体突出显示如果某个点的距离突然很近可能是障碍物可以用更醒目的颜色如红色绘制一个稍大的点或圆圈。// 示例将一个极坐标点绘制到LCD上 void Radar_PlotPoint(float angle_deg, float distance_cm) { if(distance_cm 2 || distance_cm 200) return; // 过滤无效数据 float rad angle_deg * 3.1415926f / 180.0f; float scale 1.0f; // 1 pixel per cm int16_t x0 160, y0 220; int16_t x x0 (int16_t)(distance_cm * sinf(rad) * scale); int16_t y y0 - (int16_t)(distance_cm * cosf(rad) * scale); // 注意是减法 // 确保坐标在屏幕范围内 if(x 0 x 320 y 0 y 240) { ILI9341_DrawPixel(x, y, RGB565_GREEN); // 假设这是你的画点函数 } }5. TFT-LCD显示驱动与图形界面优化5.1 ILI9341 SPI驱动实现与优化对于SPI接口的ILI9341我们需要实现基本的写命令、写数据函数以及初始化序列。// 定义控制引脚 #define LCD_CS_LOW() HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_RESET) #define LCD_CS_HIGH() HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_SET) #define LCD_DC_CMD() HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_RESET) #define LCD_DC_DATA() HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_SET) #define LCD_RST_LOW() HAL_GPIO_WritePin(LCD_RST_GPIO_Port, LCD_RST_Pin, GPIO_PIN_RESET) #define LCD_RST_HIGH() HAL_GPIO_WritePin(LCD_RST_GPIO_Port, LCD_RST_Pin, GPIO_PIN_SET) // SPI发送一个字节封装HAL_SPI_Transmit static void SPI_SendByte(uint8_t data) { HAL_SPI_Transmit(hspi1, data, 1, HAL_MAX_DELAY); } // 写命令 void LCD_WriteCommand(uint8_t cmd) { LCD_DC_CMD(); LCD_CS_LOW(); SPI_SendByte(cmd); LCD_CS_HIGH(); } // 写数据 void LCD_WriteData(uint8_t data) { LCD_DC_DATA(); LCD_CS_LOW(); SPI_SendByte(data); LCD_CS_HIGH(); } // 初始化函数需要按照ILI9341数据手册的序列发送一系列命令和参数 void ILI9341_Init(void) { // 硬件复位 LCD_RST_LOW(); HAL_Delay(100); LCD_RST_HIGH(); HAL_Delay(100); // 发送初始化命令序列例如设置像素格式、内存访问控制、睡眠模式退出等 LCD_WriteCommand(0xCF); // 示例命令 LCD_WriteData(0x00); LCD_WriteData(0xC1); LCD_WriteData(0X30); // ... 更多初始化命令 LCD_WriteCommand(0x11); // 退出睡眠 HAL_Delay(120); LCD_WriteCommand(0x29); // 开启显示 }关键优化批量像素写入。单点绘制函数ILI9341_DrawPixel效率很低因为它每次都要设置一次坐标窗口发送4个命令再发送2个字节的颜色数据。绘制雷达图时我们可能需要连续绘制多个点如扫描线。优化方法是实现一个设置绘图窗口的函数然后连续发送颜色数据。// 设置绘图窗口x1,y1到x2,y2的矩形区域 void ILI9341_SetWindow(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2) { LCD_WriteCommand(0x2A); // 列地址设置 LCD_WriteData(x1 8); LCD_WriteData(x1 0xFF); LCD_WriteData(x2 8); LCD_WriteData(x2 0xFF); LCD_WriteCommand(0x2B); // 行地址设置 LCD_WriteData(y1 8); LCD_WriteData(y1 0xFF); LCD_WriteData(y2 8); LCD_WriteData(y2 0xFF); LCD_WriteCommand(0x2C); // 内存写入命令 } // 然后可以连续调用LCD_WriteData发送颜色数据屏幕会自动递增地址。对于雷达扫描线我们可以用ILI9341_SetWindow设置一个1像素宽的矩形从中心到目标点然后连续发送一种颜色的数据效率远高于逐点绘制。5.2 动态雷达图界面设计与绘制技巧一个直观的雷达界面应该包含以下元素静态背景绘制同心圆或圆弧作为距离刻度线如每50cm一个圈绘制从中心发出的射线作为角度刻度线如每30度一条。这些在初始化时绘制一次即可。动态扫描线一条从中心指向当前扫描角度的线段。需要在每次角度更新时重绘。为了不闪烁可以采用“先擦后画”的方式记住上一次扫描线的角度用背景色重绘那条线然后用前景色绘制新的扫描线。动态轨迹点物体探测点。如前所述可以采用“余晖”效果。一个高效的实现是维护一个二维数组对应屏幕的极坐标网格存储每个“格子”的“亮度”或“存在时间”。每次扫描到新点对应格子的值刷新为最大值。在每次屏幕刷新时遍历所有格子根据其值绘制不同亮度或颜色的点并将值衰减。这样就能实现点迹慢慢消失的效果而无需重绘整个背景。信息显示区在屏幕角落用文字显示当前角度、最近障碍物距离、系统状态等。需要实现一个字符显示函数可以基于位模库如ASCII字库。避坑指南SPI速度与屏幕刷新率。SPI的时钟速度在CubeMX中设置会影响刷屏速度。如果设置过高可能导致屏幕驱动芯片无法正确识别数据。ILI9341的SPI时钟最高通常支持几十MHz但受限于STM32的GPIO速度和布线可能需要适当降低。如果发现屏幕显示花屏或不稳定首先检查SPI时钟分频尝试降低速度。另外在连续发送大量数据时确保片选CS信号在数据传输期间保持低电平而不是每字节都翻转。6. 系统集成、调试与性能优化实战6.1 多任务协同与中断管理的平衡本项目实质上是一个简单的实时系统定时中断驱动舵机和超声波采样主循环负责LCD刷新和界面更新。处理好它们之间的协同和资源共享是关键。中断服务函数ISR要短小精悍。以10ms定时器中断为例void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim-Instance TIM4) { static uint8_t servo_step_counter 0; static uint8_t scan_angle 0; static uint8_t scan_direction 0; // 0: 0-180, 1: 180-0 // 每2次中断20ms更新一次舵机角度 if(servo_step_counter 2) { servo_step_counter 0; if(scan_direction 0) { scan_angle; if(scan_angle 180) { scan_angle 180; scan_direction 1; // 可以在这里触发一次全屏背景刷新 } } else { scan_angle--; if(scan_angle 0) { scan_angle 0; scan_direction 0; } } Servo_SetAngle(htim2, TIM_CHANNEL_1, scan_angle); Ultrasonic_StartMeasure(); // 触发测距 } // 检查超声波测量是否完成 if(ultrasonic_measure_done) { // 将数据存入缓冲区供主循环处理。避免在中断内进行复杂计算和LCD操作。 g_angle_buffer scan_angle; g_distance_buffer distance_cm; g_new_data_ready 1; ultrasonic_measure_done 0; } } }主循环则不断检查g_new_data_ready标志处理数据并更新显示。共享变量的保护g_angle_buffer、g_distance_buffer这类在中断和主循环间共享的变量虽然在本例中一个字节写一个字节读可能不会出问题但好的习惯是使用volatile关键字声明或者关中断进行读写操作以防编译器优化导致意外。6.2 常见问题排查与系统稳定性提升在实际焊接和调试中你肯定会遇到各种问题。下面是一个快速排查清单现象可能原因排查步骤与解决方案舵机不转或乱转1. 电源功率不足。2. PWM信号频率或脉宽不对。3. 信号线接触不良。1. 用万用表测量舵机供电电压转动时是否跌落到5V以下务必使用独立电源。2. 用逻辑分析仪或示波器测量PA0引脚波形检查周期是否为20ms脉宽是否随角度变化0.5ms-2.5ms。3. 检查接线确保信号线连接正确。超声波一直返回0或超大值1. Echo引脚电平转换电路问题。2. 计时不准确。3. 模块硬件故障。1. 用示波器测量Echo引脚波形看是否有高电平脉冲。如果没有检查Trig触发信号和模块供电。2. 检查用于计时的定时器配置确保计数频率准确1MHz。检查中断优先级确保Echo中断能及时响应。3. 更换一个HC-SR04模块测试。LCD白屏或花屏1. 初始化序列错误。2. SPI时序或速度问题。3. 电源或复位信号问题。1. 仔细核对ILI9341数据手册的初始化命令序列特别是电源相关和像素格式命令。2. 降低SPI波特率如降到9Mbps测试。用示波器看SCK、MOSI波形是否清晰。3. 检查屏幕的VCC、GND、复位引脚电平。确保复位信号有正确的下拉-上拉过程。雷达图刷新闪烁严重1. 刷新策略问题全屏刷新太慢。2. SPI速度太慢。3. 主循环被其他任务阻塞。1. 采用局部刷新和“余晖”算法避免频繁清屏。只更新变化的区域扫描线和新的点。2. 在屏幕芯片允许范围内提高SPI时钟频率。优化SPI发送函数使用DMA传输如果SPI支持。3. 检查主循环中是否有耗时操作如浮点计算、延时。将sin/cos查表化将浮点运算转换为定点整数运算。物体位置显示不准确1. 舵机角度与PWM脉宽非线性。2. 超声波模块有测量误差和盲区。3. 坐标映射公式或参数有误。1. 对舵机进行校准记录0度和180度对应的准确CCR值中间角度线性插值。2. 对固定距离如10cm, 50cm, 100cm进行多次测量取平均建立一个简单的误差补偿表。3. 在屏幕上打印出原始的angle和distance值与实际物体位置对比调试映射公式和缩放因子。稳定性提升技巧电源去耦在STM32的每个电源引脚附近放置一个0.1uF的陶瓷电容靠近舵机电源输入端放置一个100uF以上的电解电容可以有效抑制电机转动引起的电源噪声。软件滤波对超声波测距值进行软件滤波例如取连续3次测量的中值或进行滑动平均可以消除偶然的跳变。看门狗启用STM32的独立看门狗IWDG在主循环中定期喂狗。当程序跑飞或陷入死循环时系统会自动复位提高抗干扰能力。7. 项目扩展与进阶玩法思路这个基础框架搭建好后你可以尝试很多有趣的扩展增加交互接入一个旋转编码器或按键用于手动控制扫描启停、切换显示模式如原始数据、图形、调整扫描速度。数据输出通过串口UART将实时的角度-距离数据发送到电脑用上位机软件如Python的Matplotlib绘制更精美的雷达图甚至进行数据记录和分析。多传感器融合在舵机云台上再加一个红外测距或TOF传感器与超声波数据互补。超声波适合远距离、大物体红外/TOF精度更高但可能受环境影响。引入RTOS使用FreeRTOS将舵机控制、超声波采样、LCD刷新、用户接口等任务模块化分别放在不同的任务中通过队列和信号量通信使程序结构更清晰更容易扩展复杂功能。算法升级实现简单的目标跟踪。连续几帧扫描中如果相邻角度的点距离相近可以将其聚类认为是一个物体并估算其大小和运动趋势。结构改造设计一个3D打印的外壳将整个系统封装起来做成一个真正的桌面雷达摆件通过USB供电更加美观实用。这个项目麻雀虽小五脏俱全涵盖了嵌入式开发的硬件接口、定时器、中断、SPI通信、图形显示、坐标变换等多个核心知识点。调试过程中遇到的每一个问题都是加深你对STM32和嵌入式系统理解的机会。希望这份详细的解析和实操指南能帮你少走弯路顺利做出属于自己的超声波雷达。本文还有配套的精品资源点击获取 基于STM32的超声波雷达扫描系统：硬件设计、驱动开发与图形显示实战
简介这是一份面向嵌入式初学者与课程设计者的STM32雷达模拟系统实战项目资源基于STM32F103C8T6主控融合舵机控制、超声波测距与TFT-LCD图形显示三大核心技能完整复现简易机械扫描雷达的工作原理。资源包共1024个文件涵盖563个C源码含驱动与算法实现、250个头文件定义外设配置与LCD绘图接口、51个汇编启动文件及Keil/IAR工程配置文件.uvprojx、.ioc、.icf等并包含关键的PDF原理图与雷达图像算法模块如线性插值、DCT初始化等数学库支持。目前已有270人学习下载适合用于单片机综合实训、电子设计竞赛备赛或毕业设计参考。读者可直接部署运行在2.4寸SPI接口TFT屏上实时绘制极坐标雷达图同步显示物体角度与距离并深入理解定时器PWM输出、输入捕获测距、LCD点阵绘图及坐标映射等关键技术实现细节。1. 项目概述一个嵌入式雷达扫描系统的诞生最近在整理工作室的旧项目翻出来一个几年前用STM32F103C8T6做的超声波雷达扫描仪感觉挺有意思的。这个项目的核心目标很简单让一个SG90舵机带着HC-SR04超声波模块旋转像雷达一样扫描前方区域然后把探测到的物体位置角度和距离实时显示在一块2.4寸的TFT-LCD屏幕上画出一个动态的“雷达图”。听起来是不是有点像简易版的自动驾驶感知demo或者扫地机器人的避障预览其实它的应用场景可以很广比如作为小型机器人的环境感知前端、智能小车的避障演示教具或者就是一个很酷的桌面交互装置。为什么选STM32F103C8T6这块经典的“蓝桥杯”神片原因无他就是性价比高、资料多、生态成熟。对于这种需要同时处理舵机PWM、超声波测距时序、LCD刷屏以及坐标计算的中等复杂度项目C8T6的72MHz主频、64KB Flash和20KB RAM完全够用而且引脚数量也刚好满足我们的需求。整个开发流程基于STM32CubeMX进行图形化配置配合HAL库能极大降低底层驱动的开发难度让我们把精力集中在应用逻辑上。SG90舵机负责提供0-180度的扫描角度HC-SR04超声波模块负责测量距离最后通过SPI或FSMC接口驱动那块320x240分辨率的TFT-LCD将极坐标角度、距离转换为屏幕上的直角坐标点一幅动态的雷达扫描图就跃然屏上了。无论你是想学习STM32多外设协同、实时系统概念还是想做一个有趣的实物这个项目都是一个不错的起点。2. 硬件选型与核心电路设计解析2.1 主控芯片STM32F103C8T6的引脚分配策略STM32F103C8T6属于STM32F1系列的“中等容量”产品48个引脚资源对于本项目来说需要精打细算。使用CubeMX配置时清晰的引脚规划是成功的第一步。首先SG90舵机需要一路PWM信号。舵机的控制信号是一个周期为20ms50Hz脉宽在0.5ms到2.5ms之间的PWM波对应0到180度的位置。我们可以使用定时器TIM的PWM输出通道来生成。这里我选择了TIM2的通道1PA0因为PA0是5V容忍的引脚虽然SG90信号线一般是3.3V兼容但这样更稳妥。在CubeMX中需要将TIM2的通道1配置为PWM Generation CH1模式预分频器和自动重载值ARR的设置需要计算以达到20ms的周期。假设系统时钟是72MHz经过适当分频让计数器频率为1MHz那么ARR设置为20000-1即可得到20ms的周期。脉宽则由捕获比较寄存器CCR的值控制500对应0.5ms0度2500对应2.5ms180度。其次HC-SR04超声波模块需要两个GPIO一个用于触发Trig一个用于回波Echo。Trig引脚输出一个至少10us的高电平脉冲我选择了PA1配置为推挽输出。Echo引脚用于检测高电平的持续时间这个时间与距离成正比。这里有个关键点HC-SR04的Echo脚输出是5V电平而STM32的IO口通常只耐受3.3V。绝对不能直接连接常见的解决方案是使用一个简单的电阻分压电路例如1kΩ和2kΩ串联将5V分压到约3.3V后再接入STM32的引脚。我选择了PA2并将其配置为输入模式同时开启上升沿/下降沿中断用于精确测量高电平脉宽。最后是2.4寸TFT-LCD屏幕。这类屏幕通常使用SPI接口或8位/16位并行接口。为了获得更快的刷屏速度这对动态雷达图很重要我强烈推荐使用并口。STM32F103C8T6没有专用的FSMCFlexible Static Memory Controller控制器但我们可以用GPIO模拟8位并口或者使用它的“FSMC”功能实际上C8T6没有但一些兼容屏的驱动芯片支持8080时序我们可以用GPIO模拟8080时序。为了简化我选择了SPI接口虽然速度稍慢但对于320*240分辨率、仅更新变化点的雷达图来说优化后完全可以接受。我使用了SPI1PA5-SCK PA6-MISO PA7-MOSI以及一个额外的GPIOPA4作为片选CS另一个PB0作为数据/命令选择线DC还有一个PB1作为复位线RST。注意电源是关键SG90舵机在转动时电流可能达到数百mA绝对不能直接用STM32开发板上的3.3V或5V引脚供电否则极易导致芯片复位或损坏。必须为舵机提供独立的外接电源例如5V/2A的适配器并将此电源地与STM32的地GND连接在一起确保共地。2.2 外设模块特性与接口要点SG90舵机这是一个180度模拟舵机。其内部有一个基准电路、一个比较器、一个电机驱动和一个位置反馈电位器。PWM信号的本质是提供一个基准电压舵机内部通过比较来决定转动方向和幅度。除了PWM控制线橙色/黄色还有电源线红色5V和地线棕色。控制的关键是精度和稳定性。定时器产生的PWM波需要非常稳定周期抖动会导致舵机抖动。在软件上我们通常以1度为最小单位改变CCR值对应脉宽变化约11us。扫描时可以让舵机以固定步长如1度或2度从0度移动到180度再返回形成一个周期性的扫描运动。HC-SR04超声波模块它通过Trig引脚触发一次测距然后从Echo引脚输出一个与距离成正比的高电平脉冲。距离计算公式为距离 (高电平时间 * 声速) / 2。声速在常温下可取340m/s或343m/s。高电平时间单位是微秒us除以58即可得到厘米数除以58000得到米数。这个“58”的由来就是 (34000 cm/s) / (2 * 1000000 us/s) ≈ 0.017 cm/us取倒数约为58.8。测量时需要注意模块的盲区通常2-3cm以及声波的散射角。对于雷达扫描我们假设探测到的物体是一个点但实际上超声波波束是有宽度的这会影响角度分辨率。2.4寸 TFT-LCD我使用的是一款常见的驱动芯片为ILI9341的屏幕。它支持SPI和8位并行模式。SPI模式下需要向屏幕写入命令和数据来初始化、设置窗口、写入像素颜色。颜色格式通常是RGB56516位色即一个像素点用两个字节表示5位红6位绿5位蓝。绘制雷达图时我们需要频繁地进行画点操作。为了提高效率可以先将整个屏幕清空为背景色如黑色然后在每个扫描角度根据测得的距离在对应的极坐标位置画一个亮色的点如绿色。为了有“扫描线”效果可以在当前角度画线并逐渐擦除之前角度的线。3. CubeMX工程配置与HAL库驱动搭建3.1 系统时钟与关键外设的CubeMX图形化配置打开STM32CubeMX选择STM32F103C8T6芯片。首先配置时钟树Clock Configuration。我们的目标是将系统时钟SYSCLK设置为72MHz这是F103系列在外部8MHz晶振HSE下的标准最高速度。在图形界面中选择HSE作为时钟源经过PLL倍频将PLLCLK设置为72MHz然后作为SYSCLK。APB1总线时钟PCLK1最高36MHzAPB2总线时钟PCLK2最高72MHz。定时器挂在不同的APB总线上时钟可能会被倍频CubeMX会帮你计算好我们只需确保最终定时器的计数时钟是我们期望的频率如1MHz用于舵机PWM。接下来配置引脚Pinout ConfigurationTIM2 CH1 (PWM输出)在左侧“Timers”中找到TIM2选择“Clock Source”为“Internal Clock”然后在“Channel1”中选择“PWM Generation CH1”。此时PA0会被自动配置。转到“Parameter Settings”选项卡设置预分频器Prescaler和计数器周期Counter Period。为了得到1MHz的计数频率如果APB1的TIM2时钟是72MHz则预分频器应设为7172MHz/(711)1MHz。计数器周期ARR设为19999这样PWM周期就是20000个时钟周期即20ms。脉冲宽度Pulse先设为1500对应1.5ms90度中间位置。注意将“PWM Generation CH1”的“Mode”设置为“PWM mode 1”极性Polarity根据舵机要求设置通常为高电平有效。GPIO for HC-SR04找到PA1设置为“GPIO_Output”命名为“Trig”。找到PA2设置为“GPIO_Input”并开启外部中断。在“NVIC Settings”中使能EXTI line2中断。SPI for LCD在“Connectivity”中选择SPI1。模式设置为“Full-Duplex Master”硬件NSS选择“Disable”。参数设置中波特率可以设高一些比如18Mbits/s需要看屏幕芯片支持情况。数据大小8位时钟极性低时钟相位第1边沿。引脚会自动分配为PA5(SCK) PA6(MISO) PA7(MOSI)。然后手动配置PA4为“GPIO_Output”作为CSPB0作为DCPB1作为RST。SYS将“Debug”改为“Serial Wire”这样可以使用ST-LINK进行调试和下载。Project Manager设置好项目名称、路径、IDEMDK-ARM或STM32CubeIDE在“Code Generator”中选择“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”这样代码结构更清晰。生成代码后一个包含所有初始化代码的工程就创建好了。3.2 HAL库超声波测距与舵机控制代码实现在生成的工程中我们主要编写应用层代码。舵机角度控制函数// 设置舵机角度angle范围0-180 void Servo_SetAngle(TIM_HandleTypeDef *htim, uint32_t Channel, uint8_t angle) { if(angle 180) angle 180; // 将角度转换为PWM脉宽单位us // 0度-500us, 180度-2500us线性映射 // CCR值 脉宽(us) * 定时器计数频率(MHz) // 假设定时器计数频率为1MHz即1us计数1次 uint32_t pulse_width_us 500 angle * (2000 / 180); // 简化计算避免浮点 // 更精确的公式pulse 500 angle * 2000.0 / 180.0; __HAL_TIM_SET_COMPARE(htim, Channel, pulse_width_us); }这个函数封装了角度到PWM占空比的转换。在主循环或定时器中断中我们可以周期性地调用此函数改变角度值让舵机匀速转动。超声波测距模块驱动 超声波测距需要精确计时我们利用Echo引脚的外部中断和定时器来实现。// 全局变量用于存储高电平开始和结束的时间戳 volatile uint32_t ultrasonic_rising_tick 0; volatile uint32_t ultrasonic_falling_tick 0; volatile uint32_t distance_cm 0; volatile uint8_t ultrasonic_measure_done 0; // Echo引脚外部中断回调函数在stm32f1xx_it.c中声明或在main.c中重写弱函数 void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if(GPIO_Pin GPIO_PIN_2) { // PA2 if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_2) GPIO_PIN_SET) { // 上升沿记录开始时间 ultrasonic_rising_tick HAL_GetTick(); // 使用毫秒定时器精度不够 // 为了更高精度应该使用一个定时器的计数器值例如TIM3的CNT ultrasonic_rising_tick __HAL_TIM_GET_COUNTER(htim3); } else { // 下降沿记录结束时间计算距离 ultrasonic_falling_tick __HAL_TIM_GET_COUNTER(htim3); uint32_t pulse_width_ticks ultrasonic_falling_tick - ultrasonic_rising_tick; // 假设TIM3的计数频率为1MHz1个tick1us // 距离 脉宽(us) / 58.0 (cm) distance_cm pulse_width_ticks / 58; ultrasonic_measure_done 1; } } } // 触发一次测距的函数 void Ultrasonic_StartMeasure(void) { HAL_GPIO_WritePin(Trig_GPIO_Port, Trig_Pin, GPIO_PIN_SET); HAL_Delay_us(12); // 需要实现一个微秒级延时函数可以用定时器或NOP循环 HAL_GPIO_WritePin(Trig_GPIO_Port, Trig_Pin, GPIO_PIN_RESET); }这里的关键是高精度计时。HAL_GetTick()是毫秒级对于超声波测距厘米级精度对应几十微秒的脉宽来说误差太大。因此我使用了一个额外的定时器如TIM3将其时钟配置为1MHz在中断中读取它的计数器值CNT精度可以达到1微秒。微秒延时函数HAL_Delay_us可以用一个简单的循环实现或者用另一个定时器。实操心得中断的优化。在Echo中断回调函数中不要做复杂计算或调用耗时的HAL函数。最好只记录时间戳设置标志位把距离计算放到主循环中。同时注意中断嵌套和优先级避免超声波中断被其他高优先级中断阻塞导致计时错误。4. 雷达扫描逻辑与坐标变换算法4.1 扫描策略与数据采集的时序控制一个完整的雷达扫描周期是舵机从0度匀速运动到180度同时在每个角度或每隔几个角度触发超声波测距并记录数据。这里涉及到多任务协调舵机控制PWM更新、超声波触发与读取、LCD刷新。一个简单可靠的架构是利用定时器中断来构建一个时间片轮询系统。我们可以设置一个基础定时器如TIM4每10ms产生一次中断。在这个中断服务函数中维护一个状态机状态0 - 移动舵机每进入中断若干次比如2次即20ms后更新一次舵机目标角度步进1度。这样舵机大约每20ms移动1度从0到180度需要3.6秒速度比较平滑。状态1 - 触发测距在更新舵机角度后立即触发一次超声波测距调用Ultrasonic_StartMeasure。状态2 - 等待结果等待ultrasonic_measure_done标志被置位。由于超声波测距本身需要几十毫秒最大测距对应的时间这个等待过程是非阻塞的我们只是在下一次中断时检查标志位。状态3 - 处理数据当标志位为1时读取distance_cm结合当前的舵机角度计算物体在屏幕上的坐标并标记该点需要刷新。然后清除标志位准备下一个角度的测量。这样舵机的运动、超声波的触发和数据的处理就被一个定时器中断有序地串联起来避免了在主循环中使用HAL_Delay导致的阻塞使得LCD刷新和其他逻辑如按键扫描可以同时在主循环中运行。4.2 从极坐标到屏幕直角坐标的映射与绘图超声波测得的距离r和舵机角度θ构成了一个极坐标系下的数据点。我们需要将其映射到320x240的LCD直角坐标系上。通常我们将雷达的扫描中心舵机旋转轴映射到屏幕底部中间假设为点(X0, Y0)。例如令X0 160屏幕水平中心Y0 220靠近屏幕底部留出一些空间显示信息。那么屏幕上点的坐标(x, y)可以通过以下公式计算x X0 r * sin(θ) * scale_factor; y Y0 - r * cos(θ) * scale_factor; // 注意屏幕y轴向下为正所以用减法其中θ需要从角度转换为弧度rad θ * π / 180.0。scale_factor是一个缩放因子因为超声波测距的单位是厘米而屏幕像素有限。例如如果最大显示距离为100cm我们希望它映射到屏幕上方约100像素的范围那么scale_factor可以设为 1.0即1像素代表1厘米或者根据布局调整。sin和cos计算在STM32上如果直接使用标准库的sinf和cosf函数计算浮点数开销较大。对于这种实时性要求不极端高的应用可以接受。如果追求效率可以预先计算好0-180度每个角度的sin和cos值存入数组直接查表。绘图策略背景每次扫描开始前可以用一种颜色如黑色或深蓝色清除整个屏幕绘制固定的雷达刻度线和角度标识。扫描线绘制一条从中心(X0, Y0)到当前角度对应最大半径处的线段颜色为亮色如青色表示当前正在扫描的方向。历史轨迹点将每个有效测距点距离在合理范围内如2cm-400cm根据上述公式计算坐标并在该坐标画一个点。为了有“余晖”效果可以不用立即擦除旧点而是让旧点随着时间慢慢变暗或消失。一个简单实现是在绘制新点前将整个“扫描区域”一个扇形用半透明的背景色重绘一次这样旧点就会变淡新点最亮。物体突出显示如果某个点的距离突然很近可能是障碍物可以用更醒目的颜色如红色绘制一个稍大的点或圆圈。// 示例将一个极坐标点绘制到LCD上 void Radar_PlotPoint(float angle_deg, float distance_cm) { if(distance_cm 2 || distance_cm 200) return; // 过滤无效数据 float rad angle_deg * 3.1415926f / 180.0f; float scale 1.0f; // 1 pixel per cm int16_t x0 160, y0 220; int16_t x x0 (int16_t)(distance_cm * sinf(rad) * scale); int16_t y y0 - (int16_t)(distance_cm * cosf(rad) * scale); // 注意是减法 // 确保坐标在屏幕范围内 if(x 0 x 320 y 0 y 240) { ILI9341_DrawPixel(x, y, RGB565_GREEN); // 假设这是你的画点函数 } }5. TFT-LCD显示驱动与图形界面优化5.1 ILI9341 SPI驱动实现与优化对于SPI接口的ILI9341我们需要实现基本的写命令、写数据函数以及初始化序列。// 定义控制引脚 #define LCD_CS_LOW() HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_RESET) #define LCD_CS_HIGH() HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_SET) #define LCD_DC_CMD() HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_RESET) #define LCD_DC_DATA() HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_SET) #define LCD_RST_LOW() HAL_GPIO_WritePin(LCD_RST_GPIO_Port, LCD_RST_Pin, GPIO_PIN_RESET) #define LCD_RST_HIGH() HAL_GPIO_WritePin(LCD_RST_GPIO_Port, LCD_RST_Pin, GPIO_PIN_SET) // SPI发送一个字节封装HAL_SPI_Transmit static void SPI_SendByte(uint8_t data) { HAL_SPI_Transmit(hspi1, data, 1, HAL_MAX_DELAY); } // 写命令 void LCD_WriteCommand(uint8_t cmd) { LCD_DC_CMD(); LCD_CS_LOW(); SPI_SendByte(cmd); LCD_CS_HIGH(); } // 写数据 void LCD_WriteData(uint8_t data) { LCD_DC_DATA(); LCD_CS_LOW(); SPI_SendByte(data); LCD_CS_HIGH(); } // 初始化函数需要按照ILI9341数据手册的序列发送一系列命令和参数 void ILI9341_Init(void) { // 硬件复位 LCD_RST_LOW(); HAL_Delay(100); LCD_RST_HIGH(); HAL_Delay(100); // 发送初始化命令序列例如设置像素格式、内存访问控制、睡眠模式退出等 LCD_WriteCommand(0xCF); // 示例命令 LCD_WriteData(0x00); LCD_WriteData(0xC1); LCD_WriteData(0X30); // ... 更多初始化命令 LCD_WriteCommand(0x11); // 退出睡眠 HAL_Delay(120); LCD_WriteCommand(0x29); // 开启显示 }关键优化批量像素写入。单点绘制函数ILI9341_DrawPixel效率很低因为它每次都要设置一次坐标窗口发送4个命令再发送2个字节的颜色数据。绘制雷达图时我们可能需要连续绘制多个点如扫描线。优化方法是实现一个设置绘图窗口的函数然后连续发送颜色数据。// 设置绘图窗口x1,y1到x2,y2的矩形区域 void ILI9341_SetWindow(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2) { LCD_WriteCommand(0x2A); // 列地址设置 LCD_WriteData(x1 8); LCD_WriteData(x1 0xFF); LCD_WriteData(x2 8); LCD_WriteData(x2 0xFF); LCD_WriteCommand(0x2B); // 行地址设置 LCD_WriteData(y1 8); LCD_WriteData(y1 0xFF); LCD_WriteData(y2 8); LCD_WriteData(y2 0xFF); LCD_WriteCommand(0x2C); // 内存写入命令 } // 然后可以连续调用LCD_WriteData发送颜色数据屏幕会自动递增地址。对于雷达扫描线我们可以用ILI9341_SetWindow设置一个1像素宽的矩形从中心到目标点然后连续发送一种颜色的数据效率远高于逐点绘制。5.2 动态雷达图界面设计与绘制技巧一个直观的雷达界面应该包含以下元素静态背景绘制同心圆或圆弧作为距离刻度线如每50cm一个圈绘制从中心发出的射线作为角度刻度线如每30度一条。这些在初始化时绘制一次即可。动态扫描线一条从中心指向当前扫描角度的线段。需要在每次角度更新时重绘。为了不闪烁可以采用“先擦后画”的方式记住上一次扫描线的角度用背景色重绘那条线然后用前景色绘制新的扫描线。动态轨迹点物体探测点。如前所述可以采用“余晖”效果。一个高效的实现是维护一个二维数组对应屏幕的极坐标网格存储每个“格子”的“亮度”或“存在时间”。每次扫描到新点对应格子的值刷新为最大值。在每次屏幕刷新时遍历所有格子根据其值绘制不同亮度或颜色的点并将值衰减。这样就能实现点迹慢慢消失的效果而无需重绘整个背景。信息显示区在屏幕角落用文字显示当前角度、最近障碍物距离、系统状态等。需要实现一个字符显示函数可以基于位模库如ASCII字库。避坑指南SPI速度与屏幕刷新率。SPI的时钟速度在CubeMX中设置会影响刷屏速度。如果设置过高可能导致屏幕驱动芯片无法正确识别数据。ILI9341的SPI时钟最高通常支持几十MHz但受限于STM32的GPIO速度和布线可能需要适当降低。如果发现屏幕显示花屏或不稳定首先检查SPI时钟分频尝试降低速度。另外在连续发送大量数据时确保片选CS信号在数据传输期间保持低电平而不是每字节都翻转。6. 系统集成、调试与性能优化实战6.1 多任务协同与中断管理的平衡本项目实质上是一个简单的实时系统定时中断驱动舵机和超声波采样主循环负责LCD刷新和界面更新。处理好它们之间的协同和资源共享是关键。中断服务函数ISR要短小精悍。以10ms定时器中断为例void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim-Instance TIM4) { static uint8_t servo_step_counter 0; static uint8_t scan_angle 0; static uint8_t scan_direction 0; // 0: 0-180, 1: 180-0 // 每2次中断20ms更新一次舵机角度 if(servo_step_counter 2) { servo_step_counter 0; if(scan_direction 0) { scan_angle; if(scan_angle 180) { scan_angle 180; scan_direction 1; // 可以在这里触发一次全屏背景刷新 } } else { scan_angle--; if(scan_angle 0) { scan_angle 0; scan_direction 0; } } Servo_SetAngle(htim2, TIM_CHANNEL_1, scan_angle); Ultrasonic_StartMeasure(); // 触发测距 } // 检查超声波测量是否完成 if(ultrasonic_measure_done) { // 将数据存入缓冲区供主循环处理。避免在中断内进行复杂计算和LCD操作。 g_angle_buffer scan_angle; g_distance_buffer distance_cm; g_new_data_ready 1; ultrasonic_measure_done 0; } } }主循环则不断检查g_new_data_ready标志处理数据并更新显示。共享变量的保护g_angle_buffer、g_distance_buffer这类在中断和主循环间共享的变量虽然在本例中一个字节写一个字节读可能不会出问题但好的习惯是使用volatile关键字声明或者关中断进行读写操作以防编译器优化导致意外。6.2 常见问题排查与系统稳定性提升在实际焊接和调试中你肯定会遇到各种问题。下面是一个快速排查清单现象可能原因排查步骤与解决方案舵机不转或乱转1. 电源功率不足。2. PWM信号频率或脉宽不对。3. 信号线接触不良。1. 用万用表测量舵机供电电压转动时是否跌落到5V以下务必使用独立电源。2. 用逻辑分析仪或示波器测量PA0引脚波形检查周期是否为20ms脉宽是否随角度变化0.5ms-2.5ms。3. 检查接线确保信号线连接正确。超声波一直返回0或超大值1. Echo引脚电平转换电路问题。2. 计时不准确。3. 模块硬件故障。1. 用示波器测量Echo引脚波形看是否有高电平脉冲。如果没有检查Trig触发信号和模块供电。2. 检查用于计时的定时器配置确保计数频率准确1MHz。检查中断优先级确保Echo中断能及时响应。3. 更换一个HC-SR04模块测试。LCD白屏或花屏1. 初始化序列错误。2. SPI时序或速度问题。3. 电源或复位信号问题。1. 仔细核对ILI9341数据手册的初始化命令序列特别是电源相关和像素格式命令。2. 降低SPI波特率如降到9Mbps测试。用示波器看SCK、MOSI波形是否清晰。3. 检查屏幕的VCC、GND、复位引脚电平。确保复位信号有正确的下拉-上拉过程。雷达图刷新闪烁严重1. 刷新策略问题全屏刷新太慢。2. SPI速度太慢。3. 主循环被其他任务阻塞。1. 采用局部刷新和“余晖”算法避免频繁清屏。只更新变化的区域扫描线和新的点。2. 在屏幕芯片允许范围内提高SPI时钟频率。优化SPI发送函数使用DMA传输如果SPI支持。3. 检查主循环中是否有耗时操作如浮点计算、延时。将sin/cos查表化将浮点运算转换为定点整数运算。物体位置显示不准确1. 舵机角度与PWM脉宽非线性。2. 超声波模块有测量误差和盲区。3. 坐标映射公式或参数有误。1. 对舵机进行校准记录0度和180度对应的准确CCR值中间角度线性插值。2. 对固定距离如10cm, 50cm, 100cm进行多次测量取平均建立一个简单的误差补偿表。3. 在屏幕上打印出原始的angle和distance值与实际物体位置对比调试映射公式和缩放因子。稳定性提升技巧电源去耦在STM32的每个电源引脚附近放置一个0.1uF的陶瓷电容靠近舵机电源输入端放置一个100uF以上的电解电容可以有效抑制电机转动引起的电源噪声。软件滤波对超声波测距值进行软件滤波例如取连续3次测量的中值或进行滑动平均可以消除偶然的跳变。看门狗启用STM32的独立看门狗IWDG在主循环中定期喂狗。当程序跑飞或陷入死循环时系统会自动复位提高抗干扰能力。7. 项目扩展与进阶玩法思路这个基础框架搭建好后你可以尝试很多有趣的扩展增加交互接入一个旋转编码器或按键用于手动控制扫描启停、切换显示模式如原始数据、图形、调整扫描速度。数据输出通过串口UART将实时的角度-距离数据发送到电脑用上位机软件如Python的Matplotlib绘制更精美的雷达图甚至进行数据记录和分析。多传感器融合在舵机云台上再加一个红外测距或TOF传感器与超声波数据互补。超声波适合远距离、大物体红外/TOF精度更高但可能受环境影响。引入RTOS使用FreeRTOS将舵机控制、超声波采样、LCD刷新、用户接口等任务模块化分别放在不同的任务中通过队列和信号量通信使程序结构更清晰更容易扩展复杂功能。算法升级实现简单的目标跟踪。连续几帧扫描中如果相邻角度的点距离相近可以将其聚类认为是一个物体并估算其大小和运动趋势。结构改造设计一个3D打印的外壳将整个系统封装起来做成一个真正的桌面雷达摆件通过USB供电更加美观实用。这个项目麻雀虽小五脏俱全涵盖了嵌入式开发的硬件接口、定时器、中断、SPI通信、图形显示、坐标变换等多个核心知识点。调试过程中遇到的每一个问题都是加深你对STM32和嵌入式系统理解的机会。希望这份详细的解析和实操指南能帮你少走弯路顺利做出属于自己的超声波雷达。本文还有配套的精品资源点击获取