简介面向STM32单片机学习者和电子设计竞赛选手的智能遥控循迹避障灭火小车完整工程包涵盖从硬件底层驱动到上层控制逻辑的典型实现方案。包内共197个文件、压缩后约6.9MB以C语言源码.c/.h为核心包含大量STM32标准外设驱动文件与头文件同时提供Keil工程配置.uvprojx/.uvoptx、编译链接生成的映射/映像文件.map/.axf以及清理脚本keilkill.bat便于直接打开工程查看外设初始化、理解代码组织或重新编译调试。项目实现了红外循迹、超声波避障、无线遥控及灭火触发等多模块协同控制涉及GPIO、定时器、ADC、串口等外设的综合使用能直观学习PWM调速、传感器采样、无线数据接收和电机驱动等关键编程技巧适合作为课程设计、毕业设计或竞赛备战的参考原型。已有445人学习下载对希望快速上手STM32综合项目、理解模块化编程与硬件资源分配的读者具有实用价值。1. 项目概述与整体架构1.1 这个项目到底能干什么先把这个小车能做的事情说清楚。这辆基于STM32的智能小车集成了四大核心功能遥控驾驶、循迹行驶、自主避障和自动灭火。遥控模式适合人工干预的场景比如你让它去某个角落灭火但不想改程序循迹模式适合固定路线的巡逻任务沿着黑线跑避障模式是让它在未知环境里自己找路灭火则是整个系统的终极目标——检测到火源后自动靠近并扑灭。四个功能不是孤立存在的而是在一个状态机里互相切换。比如灭火过程中前方突然出现障碍物系统要先避障再继续逼近火源而不是傻乎乎撞上去。这就是整车的核心价值把多传感器信息融合到一颗STM32里用一套逻辑协调所有动作。适合什么人做如果你是电子相关专业的学生这几乎是毕业设计和课程设计的标配题目如果你是自学嵌入式的爱好者这个项目能一次打通GPIO、定时器、PWM、ADC、串口、中断这些STM32的核心外设。做完这个项目再去看其他单片机应用基本是降维打击。F103C8T6这颗芯片的Flash是64KBRAM是20KB整个工程编译完大约占用30KB左右留给后续扩展的空间还算充裕。1.2 系统模块怎么划分整个系统从物理结构上可以拆成五个部分主控板、感知层、执行层、动力层和电源层。主控板就是STM32最小系统板负责跑逻辑、做决策。感知层包含三路循迹传感器模块、一个超声波避障模块和两路火焰传感器模块。执行层是灭火执行机构我用的是一路5V直流水泵加喷头也可以用风扇吹灭小火苗看你们比赛或课设的具体要求。动力层就是两个直流减速电机加一个万向轮配合L298N或TB6612驱动模块实现差速转向。电源层我用的是两节18650锂电池串联供电经降压模块输出5V给单片机、传感器和驱动逻辑供电。模块之间通过排母和杜邦线连接方便检修。整套系统在Protel里画的PCB是四层板但你在面包板上搭也完全跑得起来。核心就在STM32那一颗芯片上所有传感器的数据进来经过判断逻辑输出PWM波控制电机转速和转向同时控制灭火机构动作。2. 硬件选型与电路设计思路2.1 主控芯片和电机驱动的选型逻辑STM32F103C8T6也就是大家常说的蓝丸板几乎是这类小车的默认选择。为什么选它而不是51原因很简单51的GPIO翻转速度、定时器资源、PWM输出能力都勉强跑循迹和电机控制就吃力再挂灭火逻辑就更紧张。STM32F103有4个16位定时器、多达12通道PWM输出、3个USART、2个I2C、2个SPI还有多路ADC——这些资源在后期扩展蓝牙模块、摄像头模块时完全不需要换芯片。选完主控就是电机驱动L298N和TB6612FNG是两大主流方案。L298N便宜、皮实、驱动电流大但它内部用的是三极管达林顿结构导通压降大概在2V左右这意味着6V供电的电机实际拿到手的可能只有4V转速和扭矩都会打折。TB6612FNG是MOSFET结构压降只有0.3V左右同样电压下电机输出功率明显更高而且PWM频率响应更好。实测下来同样的电机和电池TB6612驱动的小车在相同占空比下速度能快10%左右电池续航也更久。TB6612唯一的劣势是最大连续驱动电流只有1.2A超出会过热保护——如果你用的是大扭矩电机还是乖乖用L298N。PWM频率我设的是10kHz这个值听不到电机啸叫也不容易触发驱动板的过流保护。如果频率太低比如100Hz电机会发出刺耳的嗡鸣声太高比如50kHz以上驱动板的开关损耗会加大发热严重。10kHz是折中里最稳的。2.2 传感器选型与接线要点循迹模块用的是一体化红外反射传感器TCRT5000原理是红外发射管发射光线红外接收管接收反射光。黑线吸光反射回来的红外线少接收管输出高电平白底反射强输出低电平。每个模块上有一个电位器可以调节比较器阈值。安装方式我建议做三路排布左、中、右各一个间隔1.5到2厘米。太密了转弯时两个传感器会同时压线导致判断混乱太疏了遇到小曲率弯道容易丢线。超声波避障用HC-SR04它的原理是发送一串40kHz的超声波脉冲然后计算回波返回的时间距离时间×声速(340m/s)÷2。接线四根VCC接5V、GND接地、Trig接PA0、Echo接PA1。Echo引脚返回的是与距离成正比的高电平脉宽所以必须用STM32的输入捕获功能来测量脉宽不能简单用GPIO电平判断。我用的库函数方法是在上升沿开启定时器计数下降沿读取计数值换算成微秒再除以58得到厘米数——58这个系数是经验值等于声速走1厘米往返所耗微秒数的倒数。火焰检测用两路模拟输出的火焰传感器模块核心是红外接收管对火焰中红外光谱敏感的特性。模块输出模拟电压火焰越近电压越低数字输出模式则相反越近输出低电平通过ADC采集。安装时我特意让两路探头朝左右前方各偏30度这样不仅能判断有没有火还能大致知道火在左边还是右边灭火时可以直接决策往哪边转向。注意探头不要正对地面或强光不然会误判。电源部分要重点说一下。电机启动瞬间电流可能到1A以上如果主控和电机共用一组电源且中间没有隔离电机的电压跌落会直接拉低单片机VDD导致STM32复位——这几乎是所有初学者踩过的坑。我的方案是电池出来先进一个5V/3A的DCDC降压模块我用的是MP1584降压后给单片机、传感器供电再单独用电池直接给L298N供电。驱动板的逻辑电源取5V和电机电源分开实测再没有出现过系统受电机干扰复位的问题。3. 软件核心逻辑与代码实战3.1 系统软件框架与初始化软件部分我用的标准外设库配合Keil MDK5开发环境。工程文件按功能模块拆分main.c主逻辑、motor.c电机控制、track.c循迹逻辑、avoid.c避障逻辑、fire.c灭火逻辑、adc.c传感器采集、delay.c延时函数。系统上电后先做一轮外设初始化GPIO、定时器2PWM输出定时器3编码器测速我后来加了但基础版可不加、ADC1火焰传感器采集、USART1调试用、NVIC中断优先级配置。初始化完成后进入while主循环在主循环里通过状态变量决定执行哪种模式。// 定时器2配置PWM输出核心代码PA0/PA1/PA2分别接左轮、右轮PWM和方向控制 void TIM2_GPIO_Config(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_2; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); }这里一定要注意GPIO模式必须设成GPIO_Mode_AF_PP复用推挽输出如果设成普通推挽输出PWM信号根本出不来。我见过太多人栽在这个坑里。3.2 循迹算法与PWM调速循迹的判定逻辑是核心。三路传感器的状态组合成8种情况我写了一个查表函数根据状态输出对应的左右轮速度设定值。下面这段是标准逻辑void Track_Handle(void) { uint8_t sensor_status 0; sensor_status | (GPIO_ReadInputDataBit(GPIOB, GPIO_Pin_12) 2); // 左 sensor_status | (GPIO_ReadInputDataBit(GPIOB, GPIO_Pin_13) 1); // 中 sensor_status | GPIO_ReadInputDataBit(GPIOB, GPIO_Pin_14); // 右 switch (sensor_status) { case 0b000: // 全白丢线处理 Motor_SetSpeed(0, 0); break; case 0b001: // 只有右传感器压线左转 Motor_SetSpeed(BASE_SPEED - 30, BASE_SPEED 30); break; case 0b010: // 中间压线直行 Motor_SetSpeed(BASE_SPEED, BASE_SPEED); break; case 0b100: // 只有左传感器压线右转 Motor_SetSpeed(BASE_SPEED 30, BASE_SPEED - 30); break; case 0b011: // 右中压线轻度左转 Motor_SetSpeed(BASE_SPEED - 15, BASE_SPEED 15); break; case 0b110: // 左中压线轻度右转 Motor_SetSpeed(BASE_SPEED 15, BASE_SPEED - 15); break; case 0b111: // 全压线可能是十字路口直行 Motor_SetSpeed(BASE_SPEED, BASE_SPEED); break; default: break; } }BASE_SPEED这个宏我设在500PWM周期为1000即50%占空比加减30就是转向力度。实际比赛时可以根据场地摩擦力调地面粗糙就调大转向差值光滑就调小。这个小细节直接影响过弯的稳定性——差值太小转不过弯直接冲出赛道差值太大车身晃动循迹传感器抖动误判。PWM设置上左轮和右轮的通道输出用TIM_SetCompare函数设定比较值。我在电机控制层做了一层速度映射把逻辑速度值映射到PWM比较值这样上层逻辑只需要传一个速度概念值而不用关心PWM寄存器的具体位宽。3.3 避障状态机与灭火决策避障逻辑是用一个有限状态机实现的比傻乎乎一检测到障碍物就转弯要稳定得多。状态机的状态定义如下typedef enum { AVOID_NONE 0, // 无障碍直行 AVOID_LEFT, // 左转 AVOID_RIGHT, // 右转 AVOID_FORWARD // 前方通过 } Avoid_State;主循环里先检测前方障碍物距离小于30cm才触发避障大于30cm就直行。避障执行中再扫描左前方和右前方的距离哪边空间大优先往哪边转。这个逻辑解决了超声波探头只测一个方向导致的原地卡死问题。void Avoid_Handle(void) { uint8_t front_distance Get_Distance(0); // 前方距离 if (front_distance 30) { uint8_t left_distance Get_Distance(1); // 左前方 uint8_t right_distance Get_Distance(2); // 右前方 if (left_distance right_distance) { Motor_SetSpeed(-BASE_SPEED / 2, BASE_SPEED / 2); // 原地左转 } else { Motor_SetSpeed(BASE_SPEED / 2, -BASE_SPEED / 2); // 原地右转 } } else { Motor_SetSpeed(BASE_SPEED, BASE_SPEED); // 无障碍直行 } }灭火逻辑是最有意思的部分。火焰传感器的ADC值反映红外光强度我设置了一个阈值超过阈值就说明检测到火焰。然后先判断是左边火焰大还是右边火焰大朝火焰更大的一侧转向并前进接近到一定距离后启动水泵喷射。水泵通过继电器控制喷射时间3秒之后继续扫描确认火焰是否熄灭。整个过程只用了一个while循环加延时逻辑简单但效果稳定。void Fire_Handle(void) { uint16_t left_fire ADC_Read(CH0); // 左火焰传感器 uint16_t right_fire ADC_Read(CH1); // 右火焰传感器 if (left_fire FIRE_THRESHOLD right_fire FIRE_THRESHOLD) { // 没检测到火继续搜索 Motor_SetSpeed(0, 0); return; } if (left_fire right_fire) { Motor_SetSpeed(0, BASE_SPEED / 2); // 向右偏转 } else { Motor_SetSpeed(BASE_SPEED / 2, 0); // 向左偏转 } if (left_fire FIRE_NEAR_THRESHOLD || right_fire FIRE_NEAR_THRESHOLD) { Motor_SetSpeed(0, 0); // 足够近了停车 Relay_On(); // 开泵灭火 Delay_Ms(3000); Relay_Off(); } }ADC读到的火焰强度值越小表示火越大因为传感器检测到红外光后输出电压会降低。这点刚接触的人容易理解反我调试时就因为参数写反小车离火越近反而越不转向差点把车烧了。4. 常见问题与排查技巧实录4.1 烧录报错怎么处理这个错误是STM32开发最著名的拦路虎之一提示信息大致是Error: Flash Download failed - Cortex-M3或者No STM32 target found网上搜这个关键词能找到一整个类目的求助帖。我第一次遇到也懵了半天后来总结出三大原因按概率排序第一BOOT0跳线帽没有拨对。STM32F103的BOOT0引脚必须保持低电平才能正常烧录如果BOOT0悬空或拉高了芯片会被引导进系统存储器而不是用户Flash烧录器自然找不到目标。解决办法是检查跳线帽BOOT0接GND。第二供电问题。ST-Link/V2的3.3V输出能力有限如果你用ST-Link给整块板子供电电机一启动、电流一拉高电压跌落导致调试器直接断开连接。我的建议是外接5V电源供电ST-Link只负责SWDIO、SWCLK信号线。第三接线问题。SWD接口只接3根线就行——SWDIO、SWCLK、GND但很多人会把3.3V也接上。如果目标板本身有外部电源3.3V两个源直接怼在一起轻则通信失败重则烧毁器件。4.2 小车跑起来左右横跳或原地打转这是循迹小车最容易出现的毛病。两个常见原因一是循迹传感器安装高度和位置不对。TCRT5000的最佳检测距离是1到2厘米装高了反射光太弱装低了探头被地面磨损安装位置如果两两间距太大遇到弯道时会出现盲目状态——没有任何一个传感器压到黑线。二是在弯道处速度过快传感器采样频率跟不上车身移动速度。通常的解法是把主循环里的延时控制在10ms以内循迹判断频率至少50Hz同时把弯道处的BASE_SPEED调小一点。如果是急弯可以考虑加一个比例项让转向力度随压线位置平滑变化而不是固定的加减30。超声波避障原地打转的问题比较隐蔽。HC-SR04的测距周期最短也要60ms算上声波往返的最远量程时间如果你的主循环里连续扫描三个方向避障决策的周期就拉长到200ms左右小车在这段时间里已经跑出去十几厘米转向精度自然差。我的做法是分时扫描主循环只测前方距离前方有障碍时才依次扫描两侧。这样多数情况下决策周期能保持60ms以内。4.3 灭火逻辑误动作或漏检火焰传感器在室内灯光下经常误报特别是LED灯和阳光强烈的场景。我调试时发现最有效的办法是两路传感器做与逻辑判断只有两路同时检测到火焰信号才启动灭火流程单独一路触发大概率是环境红外干扰。另外传感器的响应时间在毫秒级但灭火决策需要连续读到3次有效信号才确认火源存在这能滤掉偶发的红外脉冲干扰。还有一类问题是水泵喷水方向偏了。火焰传感器探头安装在车头两侧而水泵喷头在车头中央如果转向不到位、车身没有正对火焰水就喷不到火源上。我在代码里加了一步对准校正当两路火焰传感器读数差不小于设定值时认为车身没对准先原地旋转让两路读数趋于一致再启动水泵。实测灭火成功率从70%左右提升到95%以上。4.4 电机的死区问题直流减速电机不是一给PWM就会转的当占空比低于某个值我实测是20%左右电机驱动力矩克服不了静摩擦力和齿轮箱阻力完全不动。这在循迹时表现得很诡异你设置左轮速度差值为15但实际左轮纹丝不动右轮却在跑小车直接画了一个大圆而不是小幅左转。解决办法有两种一种是在初始化时做一个死区补偿把低于死区的PWM值直接截断到0或钳位到最低启动值另一种是把转向差值做得大一些确保越过死区。我后来采用了第二种方案把转向差值提高到25到35之间并在代码注释里标清楚如果换了不同型号的电机这个参数必须重新标定。5. 调试工具与效率提升技巧5.1 串口打印是调试的第一利器我强烈建议任何一个做单片机项目的人都优先调通USART串口打印。不用接任何屏幕就可以看到传感器的实时值、状态机的跳转记录、PWM的设定值和电机反馈值。这套组合拳能解决80%的疑难问题。// 串口发送一个字符串的简单封装 void Debug_SendString(char *str) { while (*str) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); USART_SendData(USART1, *str); } }串口引脚是PA9TX和PA10RX用USB转TTL模块接到电脑上波特率设115200。我在循迹和避障函数的关键路径上都加了调试输出实际跑起来后通过波形看数据变化很快就定位到了丢线误判和避障方向错误的问题。5.2 用逻辑分析仪看PWM波形如果你手头有逻辑分析仪接在PWM输出引脚上能直接看到占空比是否随代码变化频率是否准确。有一次我改了定时器分频系数代码逻辑没动但小车突然一侧轮子不转用逻辑分析仪一测发现PWM频率从10k变成了1.25k输出比较值对应的占空比没变但驱动板在低频下响应迟钝。这种问题靠肉眼是看不出来的。5.3 模块化测试比整车联调更高效整车联调时一旦出问题很难定位是哪一块的锅——是循迹避障还是动力不足我的习惯是每个模块独立写一个测速函数在main里用宏开关切换测试模式。比如#define TEST_MODE_MOTOR只测电机转速#define TEST_MODE_TRACK只测循迹传感器状态。全部通过后再把宏开关关掉进入综合模式。这个方法帮我节省了大量排查时间因为问题永远被限制在一个模块内部。6. 项目扩展思路与个人体会这个项目的天花板远不止于此。如果你有精力以下几个方向都值得试试加蓝牙模块HC-05或HC-06在串口2上挂一个蓝牙透传模块手机APP直接发指令控制小车运动就变成了手机遥控灭火小车。加OLED显示屏把传感器状态、电池电压、模式信息实时显示出来演示效果立刻拉满。加灰度传感器阵列从三路升级成八路循迹精度会有质的飞跃。换摄像头模块做视觉识别用K210或OpenMV识别火源和障碍物——这基本就进入机器视觉的领域了复杂度会高不少。也可以加无刷电机或闭环PID控制让小车在斜坡和负载变化时保持稳定速度。最后分享一个我的个人习惯每做一次硬件改动就把代码和接线图在文档里记录下来版本号递增。别嫌麻烦你改了三轮硬件之后就会明白一个烧录了程序却忘了接线版本的板子有多折磨人。做这个项目最大的收获不是跑通了那一刻的成就感而是学会了怎么系统性地定位问题先复现、再隔离、后修复。这套方法论放在任何嵌入式项目里都好使。希望这篇总结能帮你少踩几个我踩过的坑做出属于你自己的智能小车。本文还有配套的精品资源点击获取