企业官网建设流程全解析

简介：该压缩包为基于STM32 HAL库的智能小车红外循迹例程，面向嵌入式初学者与智能小车爱好者，覆盖从CubeMX工程配置、传感器接入到循迹控制代码的完整流程。包内共72个文件，压缩后约515KB，以45个.h头文件和18个.c源文件为主体，并包含.ioc工程配置、.uvprojx工程文件及可烧录的.hex文件，便于直接导入开发环境编译调试。目前已吸引5634人学习浏览。资源按照标准HAL库工程目录组织，主控逻辑位于main.c与gpio.c，可清晰看到GPIO初始化、传感器状态读取、定时器周期检测及电机纠偏控制等模块；配套txt说明与批量整理脚本，便于对照硬件接线与重新组织项目。适合希望深入理解STM32中断、实时数据采集与小车循迹闭环控制的开发者作为参考模板，也可在此基础上扩展避障、调速等功能。 把小车做成遥控功能之后，我第一件想做的事就是让它离线自己跑。红外循迹应该是所有感知方案里成本最低、见效最快的一个——几个反射式传感器贴在底盘前面，白底黑线或者黑底白线，小车就能沿着轨迹自己走。STM32加上HAL库这套开发方式，配合TCRT5000这类红外模块，在学校课程设计、电子设计竞赛甚至物流小车赛项里都很常见。这篇文章是智能小车系列的第二篇，重点讲红外循迹的完整实现：从传感器原理、CubeMX配置、循迹算法到现场标定，最后把实测中遇到的几个典型故障一起列出来。适用对象是已经跑通PWM电机控制、想给小车上感知能力的同学，全文基于STM32F103C8T6和HAL库，其他型号逻辑完全一致。

1. 红外循迹的原理与器件选型：为什么第一反应就是TCRT5000

1.1 红外反射率差异就是循迹的物理基础

要写循迹代码，先得弄清楚传感器到底在干什么。TCRT5000本质上是一个反射式光电传感器，模块上集成了一颗红外发射管和一颗光电接收管。发射管持续发出红外光，红外光照射到物体表面后发生反射，反射回来的光被接收管接收。关键差异在于，不同颜色的表面对红外光的吸收程度完全不同——白色或浅色表面反射率高，红外光大部分被弹回来；黑色表面正好相反，黑色材料会吸收包括红外波段在内的大部分光，反射回来的能量极低。

接收管收到的光强不同，输出的电流就不同，模块上的LM393比较器再把这个电流变化转化成稳定的高低电平，最终从DO引脚输出。那个蓝色电位器就是用来调节比较器翻转阈值的，具体怎么调在第4节细说。

这里还要提醒一句：别把红外循迹模块和红外避障模块搞混。避障模块通常利用障碍物反射回来的红外光，检测距离在几十厘米级别，适合做前方障碍物判断。循迹模块的检测距离只有几毫米到几厘米，安装时几乎贴着地面。你要是买的模块能隔老远检测到东西，大概率是买错类型了。

1.2 数字量模块比模拟量模块更适合入门

市面上的循迹模块分两种，一种带比较器直接输出数字电平，一种不带比较器只输出模拟电压。我的建议很明确：新手用数字量模块，省事且可靠。

数字信号直接进GPIO，代码里调用一次HAL_GPIO_ReadPin就拿到结果，不需要处理ADC采样、不需要做电压阈值判断。模拟量模块确实能做灰度判断——比如检测到灰色地面时输出中间电压，从而区分灰度的深浅——但循迹的核心任务是位置判断而不是灰度判断，模拟量带来的计算复杂度和光线波动问题，对入门阶段的稳定性没有任何好处。

1.3 传感器数量选5路而不是3路

传感器数量有一个很现实的选择问题。有人用两路循迹，两个传感器骑在线的两侧，也能跑，但本质上只能做左转、右转、直行三态切换，小车在赛道上会走出明显的Z字形。三路多了一个中间传感器，能区分左偏、右偏、居中，好一些，但转向仍然是离散的，速度稍微一快就会出现来回打摆子。

我强烈建议直接上五路。中间三路负责精细位置判断，左右两路负责大角度弯道，配合比例控制算法，小车才能走出一条相对平滑的轨迹。模块的传感器间距也要和赛道线宽匹配，常见黑线宽度是20mm左右，五路模块的探测区域正好能覆盖整个线宽加一定余量。如果线特别窄，模块间距太宽，中间传感器反而压不到线上，就会出现盲区。

2. 硬件接线与CubeMX配置：GPIO上拉、低压供电和电机电源隔离

2.1 五路传感器的引脚接线

先给一张最常用的接线表，我用的是PA0到PA4，你可以按自己的板子调整，但记得在CubeMX里对应好引脚名。

传感器排线不要太长，我试过用20cm以上的杜邦线连接，压降加上线间干扰会让信号毛刺明显变多，建议控制在10cm以内，尽量用短排线或者直接焊在转接板上。

2.2 CubeMX里GPIO配置的两个关键选择

在CubeMX里把这5个引脚全部配置成GPIO_Input，这一步基本没有难度。容易踩坑的是上拉电阻的选择。

数字量循迹模块的输出级有两种常见设计：一种是推挽输出，一种是比较器加开漏输出。推挽输出直接输出高或低电平，内部上拉开不开无所谓；开漏输出就需要外部上拉电阻，否则引脚读到的一直是低电平，传感器状态完全失灵。我习惯在CubeMX里统一把这几个GPIO配置成Pull-up输入，这样两种输出级都能兼容，实测下来最稳。

第二个关键选择是给引脚设置用户标签。CubeMX里把标签改成SENSOR_L1、SENSOR_L2、SENSOR_C、SENSOR_R2、SENSOR_R1，生成代码后就能直接用这些名字调用，比对着PA0、PA1这样记不知道清晰多少倍。

2.3 供电安排：3.3V、电源隔离和那个不起眼的坑

循迹模块的VCC接3.3V还是5V，我的答案是优先3.3V。TCRT5000本身能在5V下工作，但STM32的GPIO是3.3V电平系统，虽然很多引脚标称容忍5V，但没必要给自己挖坑。3.3V供电下红外发射管的光强会稍微弱一点，只要标定做对了完全不影响使用。如果你测试发现模块在3.3V下比较器翻转不干脆，再换5V也不迟。

真正的深坑是电源隔离。电机启动瞬间电流能到几百毫安甚至更大，母线电压会被瞬间拉低，如果传感器和单片机跟电机共用同一路电源，比较器阈值就会跟着电压波动，GPIO出现随机误判。最典型的故障现象是：小车静止时传感器读数一切正常，一启动电机就乱拐。

正确做法是：电池先接到驱动板电源端，单片机和传感器从稳压后的3.3V取电，在靠近电池负极的地方建立单点共地。这样电机的大电流走自己的回路，逻辑电路的电平不会被拖垮。我见过不止一辆“一加速就乱拐”的小车，最后查出来都是电源问题而不是代码问题。

3. 循迹算法：从“打方向盘式转向”到“误差比例控制”

3.1 直觉式的if-else转向为什么跑不出直线

很多人第一次写循迹逻辑就是if-else三连：左边检测到就左转，中间检测到就直行，右边检测到就右转。这个逻辑在小车速度很慢、赛道很直的时候能跑，但上了弯道就会原形毕露——小车像喝多了酒一样左右摆动。

原因在于转向量是阶跃的，要么不转，要么全速转，没有中间值。你想象一个新手开车，方向盘永远只有左打死、右打死、回正三档，那是没法正常过弯的。解决思路是：别把五个传感器当成五个独立开关，而是把它们看成一个能连续输出位置误差的一维数组。

3.2 加权误差：把离散的传感器读数变成连续的位置偏差

给五个传感器从最左到最右赋权重{-2,-1,0,1,2}，检测到黑线的传感器就把对应权重累加起来。比如只有最左传感器压线，误差是-2；最左和左中同时压线，误差是-3；只有中间传感器压线，误差是0；右侧压线则误差为正。

这个加权和能反映车体相对黑线的偏离方向和程度。误差越负说明黑线偏向车体左边，误差越正说明黑线偏向右边。五路全压线时，因为正负权重互相抵消，误差恰好回到0，这和特殊情况处理里“全压线按直行处理”的直觉是一致的。

3.3 比例转向和控制量合成

有了连续误差，转向量就很简单：steer = Kp * error。Kp是比例系数，物理含义是“误差每变化1，左右电机速度差增加多少”。当误差为正，也就是黑线偏右边、车体偏左边时，左轮加速、右轮减速，车头向右修正；误差为负则反过来。完整的控制循环示例代码：

uint8_t sensor[5]; sensor[0] = (HAL_GPIO_ReadPin(SENSOR_L1_GPIO_Port, SENSOR_L1_Pin) == GPIO_PIN_SET); sensor[1] = (HAL_GPIO_ReadPin(SENSOR_L2_GPIO_Port, SENSOR_L2_Pin) == GPIO_PIN_SET); sensor[2] = (HAL_GPIO_ReadPin(SENSOR_C_GPIO_Port, SENSOR_C_Pin) == GPIO_PIN_SET); sensor[3] = (HAL_GPIO_ReadPin(SENSOR_R2_GPIO_Port, SENSOR_R2_Pin) == GPIO_PIN_SET); sensor[4] = (HAL_GPIO_ReadPin(SENSOR_R1_GPIO_Port, SENSOR_R1_Pin) == GPIO_PIN_SET); int8_t weight[5] = {-2, -1, 0, 1, 2}; int16_t error = 0; uint8_t active = 0; for (int i = 0; i < 5; i++) { if (sensor[i]) { error += weight[i]; active++; } } int16_t steer; if (active == 0) { steer = last_steer; // 全丢线时保持上一帧转向，做兜底 } else { steer = KP * error; last_steer = steer; } // 误差大时降低基础速度，相当于弯道减速 int16_t base = BASE_SPEED - abs(steer) / 4; if (base < MIN_SPEED) base = MIN_SPEED; // 电机速度合成，左右映射关系以你的接线为准 __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, base + steer); __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_2, base - steer);

这里有几个非常重要的实操细节。

符号方向必须实测确认。误差正负和转向方向的配合取决于传感器排列顺序和电机接线，代码里加号和减号如果反了，小车会往错误的方向修正，直接跑出一个大圆。我第一次搭这套逻辑时就因为左右轮定义反了，折腾了小半天才发现是符号问题。建议第一次下地时把速度调到最低，观察它往赛道中心修还是往赛道外偏，再决定要不要交换加减号。

弯道减速很有必要。高速入弯是循迹小车最常见的失控场景，物理原因是修正量跟不上弯道曲率变化。通过误差绝对值动态降低基础速度，小车能在入弯时自动慢下来，出弯后误差减小速度又回来了。这个逻辑看着简单，但能解决大量稳定性问题，强烈建议保留。

控制周期建议10ms一次。主循环里用HAL_Delay(10)能做到，但更规范的做法是开一个10ms定时器中断置标志位，主循环检测到标志再执行一次循迹逻辑。定时器方案的好处是控制周期稳定，不随代码路径变化而抖动。

3.4 死区和特殊位型：直线抖动与十字路口的处理

误差为0时不需要修正，这是天然的死区。但如果Kp偏大，直线上传感器只要在黑白边界抖一下，误差就会瞬间变成-1或1，转向量跟着跳，小车表现为轻微S形。处理办法很简单：当abs(error)小于等于1时，把steer直接置为0，按直行处理。

特殊位型主要指两种：全丢线和全压线。全丢线说明小车冲出赛道或者面前没有黑线，我通常用last_steer保持上一帧转向让小车自行搜索赛道，如果连续几十毫秒仍然找不到线再停车报警。全压线则出现在十字路口或者停车线，此时加权和是0，按直行处理即可。如果比赛规则要求识别终点线停车，就需要在全压线分支里加计数器，连续检测到N次全压线后执行停车动作。

4. 标定：不调好灵敏度前面都白搭

4.1 蓝色电位器到底在调什么

模块上那个蓝色电位器，调的是LM393比较器的翻转阈值，可以理解为给传感器设定一个“黑白分界线”。调法不复杂，但很多人调完还是乱跑，多半是方法不对。

先把小车架空或者把模块拆下来，让传感器贴在白色表面上，高度保持在实际安装的状态。然后拿小螺丝刀慢慢旋转电位器，同时观察模块上的输出指示灯。你会找到一个临界位置，LED状态在这里翻转，这就说明比较器阈值正好卡在白底的反射光强附近。再把模块挪到黑色线上，确认输出状态能明显翻转。反复切换几次，直到黑线状态和白底状态判若分明。

别小看这一步。如果阈值调得离临界点太近，传感器在黑白边界会长时间处于抖动状态，代码里的死区都救不回来。我习惯把阈值稍微推向“偏向黑色的一侧”，让白底判断更可靠一些，牺牲一点点对深色地面的敏感度，换来整体稳定。

4.2 反逻辑问题：先实测电平再写代码

不同厂商的TCRT5000模块，压线时对应的输出电平不一定相同。有的模块压黑线输出高电平，有的输出低电平，这取决于比较器的接法。很多人的代码出问题，不是因为算法不行，而是把压线判断写反了。

建议编译前先用串口打印这5个引脚的原始电平，把模块分别放在白底和黑线上观察，确认“压线时是高还是低”。我在代码里用一个读引脚宏来封装这个判断，真遇到反逻辑只需要改这一处。千万不要在GPIO读取那里直接写判断，更不要五个引脚各写各的，后面排查起来非常痛苦。

4.3 安装高度和强光环境：两个容易被忽略的边界条件

TCRT5000的最佳检测距离是0.5到2厘米，推荐安装高度8到10毫米。装得太低容易扫到地面上的突起杂物，装得太高接收管收到的反射光太弱，比较器翻转就变得很不干脆。更关键的是，标定时的安装高度必须和实际跑车时一致，否则现场调好的参数换个高度又重新失效。

强光直射是另一个隐蔽问题。阳光或者大功率灯光直接照射地面时，环境光中的红外成分会淹没传感器自己的红外信号，导致所有传感器都处于“满偏”状态，车直接失控。解决办法只有物理遮挡，给传感器阵列加一个遮光罩，或者选择阴影区域跑车。这一点

本文还有配套的精品资源，点击获取