简介本资源是一套完整的基于STM32的循迹避障小车嵌入式开发资料面向电子工程、自动化及嵌入式初学者与课程设计实践者解决智能小车硬件搭建、传感器数据采集、路径识别与动态避障等核心问题。压缩包共332个文件含120个头文件h与113个源码文件c覆盖STM32外设初始化、ADC模拟信号采集、红外循迹逻辑、超声波测距及PID闭环控制等关键模块另有5个原理图文件schdoc支持硬件理解3个Keil工程文件uvprojx与3个hex固件便于直接烧录验证整体仅3.66MB轻量易用。已有7945人学习下载资料结构清晰包含可运行的Proteus仿真工程、完整AD硬件设计说明及多版本调试配置dbgconf/uvoptx特别适合从仿真到实物调试的全流程学习是掌握ARM Cortex-M平台软硬协同开发的典型实践范例。 如果你在搜索栏敲下“基于STM32的循迹避障小车”大概率正被课程设计或者电子竞赛折腾得够呛。这个项目看起来遍地教程、人人都能做可真到自己动手要么小车冲下桌子要么原地打转要么一上电就重启最后往往卡在“代码照着抄了还是跑不起来”的尴尬阶段。这篇文章不打算从“什么是单片机”开始科普而是把我自己从样板工程到稳定跑完整条赛道的全过程拆开讲包括硬件怎么配、代码结构怎么搭、哪些地方最容易翻车、翻车以后怎么查。内容会围绕STM32F103这类入门主控展开覆盖五路灰度循迹、差速电机控制、超声波避障、PID调速、状态机设计和几个高频踩坑点。无论是做课程设计、准备电子竞赛还是单纯想给自己做一台能玩的小车这篇文章都可以直接当一份“从零到能跑”的参考资料。1. 立项先把账算清楚这套小车到底要堆多少硬件、多少代码很多人拿到这个题目第一反应是上网找现成代码找到一份就往下烧烧进去不跑就开始怀疑硬件坏了。我的建议恰恰相反先把硬件清单和开发环境定下来再谈代码。STM32小车的问题绝大多数不是代码逻辑难而是硬件配置互相打架、环境不一致导致的低级错误。1.1 硬件清单钱花在哪为什么这么配循迹避障小车的基础配置其实很固定核心就六块主控、循迹模块、电机驱动、电机、测距模块、电源。下面是我自己验证过的一套低预算方案总成本大概一百到两百块性能足够跑通绝大多数课设和校赛。模块型号/规格作用备注主控STM32F103C8T6最小系统板核心计算与控制72MHz主频64KB Flash20KB RAM完全够用循迹五路TCRT5000灰度传感器模块识别黑线必须选带AO模拟量输出的别只买DO数字量电机驱动TB6612FNG驱动直流电机比L298N轻压降小适合N20这类小电机电机N20减速电机带霍尔编码器×2动力输出减速比1:30或1:50电压3-6V测距HC-SR04超声波模块避障便宜、够用注意回波引脚电压问题显示0.96寸OLEDI2C调试参数显示强烈建议加调试效率提升一个档次下载调试ST-Link V2烧录、在线调试不要买那种几块钱的ST-Link很容易掉线电池2S锂电池7.4V或两节18650供电需配合降压模块给单片机供电这里最想提醒的是主控不要一开始就上F407甚至H7F103C8T6跑循迹避障绰绰有余。等以后要加摄像头视觉、复杂算法时再换平台。小车项目能不能跑起来和主控性能几乎没有关系反而是传感器信号干不干净、电源稳不稳定更关键。1.2 开发环境标准库还是HAL库Keil还是VSCode关于库的选择网上吵了很多年。我的观点很直接如果你是跟着某个教程走教程用什么库你就用什么库如果你是自己从头写标准库和HAL库都行但别在项目中途切换。标准库的优点是指针看得见、寄存器操作透明适合理解底层HAL库外设初始化封装度高写起来快但一旦出现问题排查链路更长。搜“stm32标准库新建工程”的朋友应该知道标准库工程需要手动添加startup文件、system_stm32f10x.c、stm32f10x_conf.h这些文件漏一个就编译报错。HAL库用STM32CubeMX生成工程则省心很多图形化配置时钟、ADC、定时器后面改引脚也方便。新手我建议直接用CubeMX生成HAL库工程省去手动配置时钟树的痛苦把时间花在真正需要理解的逻辑上。工具链方面Keil MDK依然是STM32开发的主流选择。如果你电脑上同时装了C51和STM32两套环境安装的时候注意选对设备型号Keil5本身能兼容两者装好Pack包以后在Device里选择STM32F103C8。VSCode配合EIDE或PlatformIO插件开发STM32现在也成熟了免费、代码提示好但调试配置相对繁琐适合有一定基础后再尝试。下载工具用ST-Link Utility它除了烧录还有后面会讲到的一个救命功能芯片锁死恢复。顺带说一句“stm32系统架构”这个高频搜索词STM32F103的系统时钟默认是72MHz内部总线分为APB1和APB2APB1上挂着TIM2/TIM3/TIM4这些通用定时器APB2上挂着ADC、TIM1等。所有外设配置第一步都是看它挂在哪个总线上这决定了时钟频率和PWM计算基准。后面讲PWM频率计算时会用到。1.3 选型误区L298N、电池、电机搭配的常见翻车点硬件配置有几个坑几乎每周都有人栽进去。第一个坑是电机驱动用L298N。L298N是老牌驱动但内部是双三极管达林顿结构饱和压降有1.5V到2V电池7.4V经过驱动输出到电机可能只有5V多发热还大。小车上更推荐TB6612FNG它是MOS管结构压降小能输出1.2A持续电流驱动N20绰绰有余。如果你看到教程里用L298N可以跟着用但要意识到压降问题会影响速度。第二个坑是电池电压和电机额定电压不匹配。N20电机通常额定电压3V或6V你如果用2S锂电7.4V直接接VM电机转速会偏高PWM稍微给大一点电流就超限。简单做法是通过降压模块把7.4V降到5V或6V再接TB6612的VM或者直接在程序里把PWM最大占空比限制在70%以内。还有一种玩法是用单节18650的3.7V直接驱动额定3V的N20牺牲一点极速换来稳定性。第三个坑是电源没共地。电机驱动电源和单片机电源如果不共GNDPWM信号无法构成回路电机会出现完全不动、微抖或者乱转的诡异现象。这个问题放在第六节详细讲但选型阶段就要记住所有模块的GND最终都要接到同一个参考点。2. 循迹模块灰度值不是读出来就能用的循迹是整个项目里最需要“磨数据”的部分。很多人以为循迹就是读几个传感器的数字值检测到黑线就转弯实际上这种做法只能应付光线恒定、路径简单的场地。稍微复杂一点的赛道必须处理模拟量、噪声和阈值漂移。2.1 传感器工作原理为什么一定要选带模拟量输出的TCRT5000是红外反射式传感器内部有一个红外发射管和一个光电接收管。红外光发射后被不同颜色的表面反射回来接收管感受到的反射光强不同。黑色表面吸收红外光反射光弱白色表面反射强。模块输出信号的强弱就反映了黑白差异。市面上五路循迹模块有的只引出DO数字量内部用比较器把模拟量转成0或1阈值靠电位器手动拧。这种模块接线简单但代价是丢失了过渡带的灰度信息行驶到黑白边缘时判断非常粗糙。而带AO模拟量输出的模块可以直接把五路灰度值读到ADC里软件里做阈值判断、归一化、加权计算灵活性高得多。选模块务必认准“模拟量输出”这一条如果已经有数字量模块也可以自己飞线引出比较器前的模拟信号。2.2 ADC多通道DMA采集别让读取占用CPU五路灰度传感器一般接到STM32的ADC引脚比如PA0到PA4。如果每一路都在主循环里单独调用HAL_ADC_GetValueCPU会频繁等待转换而且五路之间会有明显的相位差。更优的方案是“stm32 adc多通道扫描循环采样dma”这种组合ADC配置为扫描模式连续模式DMA配置为循环模式转换结果自动搬运到内存数组里CPU零负担。以HAL库为例核心配置思路是ADC1开启ScanConvMode、ContinuousConvMode、DMAContinuousRequests配置5个通道然后启动DMA循环传输。初始化完成后主循环只需要直接读adc_buf数组就能拿到五路灰度值无需再触发任何转换。采集频率由ADC时钟和采样时间决定不用单独开定时器。注意ADC输入引脚不要浮空传感器模拟输出如果超过3.3V必须分压否则可能烧坏ADC输入。F103的ADC输入范围是0到3.3V部分模块AO输出最大到5V这种情况需要在引脚前加两个电阻分压比如1k和2k串联中点接ADC引脚。另外采样时间也不要一味设最大。五路通道切换时如果采样时间太短相邻通道会有串扰数值看起来像毛刺。我通常把采样时间设为55.5个周期左右平衡速度和稳定性实测五路之间基本不会互相污染。2.3 阈值自校准与滤波把环境光的影响减到最小同一套传感器上午十点在窗边跑和下午五点在实验室跑读出的灰度值可能完全不一样。如果程序里写死一个阈值很容易一场地一变就失效。解决思路是开机自校准上电后让小车先停在赛道上程序分两次采样——一次读白底区域基准值一次故意压到黑线上读黑线基准值然后阈值取两者中点。更细一点的做法是对原始灰度值做滑动窗口滤波比如连续采五次排序取中值丢掉突变的毛刺。灰度传感器本身反应不慢但赛道上的灰尘、反光点会造成瞬时干扰中值滤波能有效抑制这种“坏点”。标定完的阈值最好写进Flash保存下次开机直接读取省去每次重新标定。STM32F103的操作Flash需要先解锁、擦除、写入、再上锁流程不复杂网上搜“stm32中flash”有大量现成代码。怕麻烦也可以每次上电自动标定只要程序里留一个标定模式就行。2.4 循迹策略从开关量思维升级到误差量思维很多初学者写的循迹逻辑是检测到最左边传感器压线就往左打死检测到最右边压线就往右打死。这种策略在小车速度慢、传感器间隔大的时候勉强能用速度一快就会画龙因为转向量没有连续变化。更好的做法是把五路传感器数据换算成一个带符号的“误差量”E。假设中间传感器压线时E为0左侧2号传感器压线时E为-2右侧2号压线时E为2取值可以按传感器位置线性化。伪代码如下int get_line_error(void) { int err 0; if (line[0]) err - 2; // 最左 if (line[1]) err - 1; // 左内 if (line[3]) err 1; // 右内 if (line[4]) err 2; // 最右 return err; }有了误差量E之后转向控制就变成一个连续函数E越大说明车偏离赛道越远转向增量越大。用PD控制让转向量随E线性变化而不是一旦压线就猛打方向小车走线会顺滑很多。这个逻辑后面接PID章节正好顺路。还有一个常见问题是十字路口五路传感器同时压线时说明车头正对一条横向黑线。如果赛道不允许左转/右转直接默认直行如果场地设计了交叉路口就需要在这里做方向判断和计数。判断逻辑通常放在状态机里避免和正常循迹混淆。3. 电机控制是底盘灵魂PWM、差速与编码器测速循迹算法算得再好最终都要通过电机执行出来。底盘控制不稳误差量算得再准也没用。这一节讲清楚驱动选型、PWM参数、差速转向以及编码器测速属于底盘部分的硬核内容。3.1 电机驱动选型TB6612为什么是小车最优解先看一张驱动方案对比表驱动方案压降最大电流体积适用场景L298N1.5-2V2A大大电机、教学演示TB6612FNG0.3-0.5V1.2A小N20等小电机DRV88330.4V左右1.5A小小电机注意逻辑电平分立MOS H桥可控制到很低受MOS决定中需要大功率或者想自己折腾小车项目推荐TB6612理由很实际压降小、模块上自带逻辑电平转换、PWM输入兼容3.3V直连STM32很省事。N20减速电机额定电流一般几百毫安TB6612的1.2A余量足够。TB6612接线时要特别注意STBY引脚这个引脚是待机控制必须接到高电平否则驱动不工作。A通道方向由AIN1和AIN2控制PWM由PWMA输入B通道同理。VM接电机电源正极VCC接3.3V或5V逻辑电源GND必须和单片机共地。如果你在网上搜“stm32光偶电路”通常是在考虑电机和单片机之间的隔离但一个小车项目做好共地和电源去耦就够了没必要上光耦——光耦的响应延迟反而可能让PWM波形变形。3.2 PWM频率怎么选10kHz不是玄学直流电机的PWM频率选择很讲究。频率太低比如几十赫兹电机会发出明显的啸叫转速波动大频率太高比如几百千赫电机线圈的感抗在高频下会对电流形成阻抗导致实际电流上不去驱动管也容易发热。对小体积直流减速电机来说10kHz左右是黄金区间既听不到噪声又能保证电流连续。以STM32F103的定时器为例如果系统时钟72MHz配置PSC71、ARR99那么PWM频率就是f_pwm 72MHz / ((711) * (991)) 10kHz占空比则由CCR寄存器决定CCR/(ARR1)就是占空比。使用定时器的PWM输出时GPIO必须配置为复用推挽模式不是普通的推挽输出否则引脚不会有波形。很多新手卡在“PWM口没有输出”十有八九是因为GPIO复用模式没配。3.3 差速转向与电机控制封装把底层细节藏起来两轮差速小车的运动学很简单左右轮速度相同时直行右轮比左轮快时向左转左轮比右轮快时向右转。严格来说线速度是左右轮速度的平均值角速度与速度差成正比但循迹小车通常不需要做精确里程计解算只需要封装一个带符号的电机控制函数。void set_motor_speed(int left, int right) { // left/right 单位可以是占空比千分比正数前进负数后退 motor_left_set(left); motor_right_set(right); }封装后上层循迹逻辑只需要根据误差量E生成左右轮的基础速度差。比如基础速度是base_speed转向增量为delta那么left_speed base_speed - delta; right_speed base_speed delta;这样写的好处是以后无论换电机还是换驱动只改底层函数不需要动上层逻辑。还有一个容易忽略的细节是软启动上电瞬间不要让PWM直接从0跳到100%应该用斜坡或者限幅逐渐增加。否则电机启动瞬间的反电动势和电流冲击容易把单片机电平拉低导致复位。3.4 编码器测速用定时器编码器模式而不是外部中断计数N20减速电机尾部的霍尔编码器输出两路正交信号A和B相位差90度。STM32定时器的编码器模式可以同时检测两路信号自动根据相位判断方向并增减计数相当于硬件四倍频分辨率直接翻四倍。接线时A相接定时器CH1B相接CH2比如TIM4的PB6和PB7。如果只有一路脉冲信号也可以把STM32定时器配置成外部计数模式但方向判断只能靠额外的IO效果不如硬件编码器模式。另外一个高频搜索词是“stm32定时器捕获测频率”这个功能更适合用来测PWM波的频率比如调试超声波或者遥控信号不是小车测速的首选。测速公式是这样的速度(cm/s) (本次CNT值 - 上次CNT值) / (倍频系数 * 编码器线数) * 轮子周长 / 间隔时间举例来说本文还有配套的精品资源点击获取
