开源小车巡线是嵌入式入门里综合度很高的项目它把传感器、电机控制、控制算法和机械调试放在同一个小系统里。刚开始接触时很多人以为巡线的难点在“识别黑线”真正上手后才发现线放在那里不动难的是把“线在左边还是右边”这个物理现象换算成“左右电机各转多快”的PWM值还要保证小车在弯道、十字路口和高速状态下不冲出赛道。这里记录一辆真实跑起来的开源巡线小车完整过程从硬件选型、传感器读取、偏差算法、PD控制到实地整定覆盖TCRT5000红外阵列和OpenMV摄像头两种方案。读完后可以直接照着搭一辆能巡线的小车也能根据文中排查清单处理大部分常见故障。1. 巡线小车要解决的技术问题不是“看见线”1.1 巡线的本质是偏差测量与纠偏从控制角度看巡线小车是一个典型的闭环控制系统。系统输入是“线在当前车道中的位置”输出是“小车当前行进方向”执行机构是左右两个驱动轮。它并不需要理解“这是一条黑色油漆线”只需要回答一个问题当前偏差是多少该往哪个方向纠正多少。把巡线拆成三个环节检测传感器持续读取地面反射信息找出线和车体的相对位置。决策根据位置偏差计算纠正量常见做法是PD控制。执行把纠正量转成左右轮差速由电机驱动完成转向。这三个环节各自独立又相互影响。前期调试时最忌讳一边改传感器一边调算法变量太多。建议按“检测到执行再到决策”的顺序逐级验证先用固定输出确认电机方向再打印传感器原始值确认检测有效最后才让算法闭环。1.2 开源巡线小车的完整技术链路一个可维护的开源巡线项目软件上应该分成三层感知层读取模拟量或摄像头图像输出归一化后的线位置偏差。决策层接收偏差运行Bang-Bang或PD控制输出左右轮速度。执行层把速度值映射成PWM和方向信号驱动电机。硬件上则是主控板、传感器、电机驱动、直流电机和电源五大部分。网络上有大量开源项目可以直接参考常见仓库通常包含原理图、Arduino或STM32代码、3D打印车架文件和调参记录。使用开源项目时要先确认主控型号、传感器型号和引脚定义是否和本地硬件一致不能直接把别人的代码烧录进去就期望跑通。2. 硬件选型先确定传感器方案再组装车架2.1 红外阵列与OpenMV视觉方案怎么选巡线传感器主流有两类TCRT5000红外反射阵列和OpenMV摄像头。两者的原理完全不同。TCRT5000的原理是红外发射管发射红外光接收管收到地面反射光后输出变化的电压。黑线吸收红外光反射少输出值低浅色地面反射强输出值高。把多个TCRT5000并排组成5路或8路阵列就能得到“线在阵列的哪个位置”的离散信息。OpenMV方案的原理是摄像头拍摄地面图像通过二值化把黑线和背景分开再用回归算法求出线段的中心点和画面中心做差得到连续偏差。它不再受“探头只有5个”的限制但对光照、曝光和帧率更敏感。对比项TCRT5000红外阵列OpenMV摄像头单套成本低约20到80元高约200到400元安装要求离地高度必须稳定通常1到2厘米离地高度和俯仰角影响视野范围抗光照能力基本不受环境光影响受强光和反光影响明显定位精度取决于探头数量5路输出离散值输出连续像素偏差精度更高赛道适应性适合规则黑线复杂路口需要额外逻辑可识别颜色、形状、标志扩展性强调试难度简单串口打印阈值即可需要图像调试工具门槛更高选型建议学习入门和预算有限时先用5路TCRT5000把检测、决策、执行整条链路走通等需要处理复杂赛道时再引入OpenMV把视觉偏差通过串口发给主控。2.2 一套可以直接照抄的硬件清单以下是常见开源巡线项目里比较省心的组合实际采购时以店铺参数为准部件推荐型号说明主控Arduino Nano / ESP32 / STM32F103C8T6学习用Arduino最省事ESP32方便后续加蓝牙传感器TCRT5000 5路红外阵列模块模块自带比较器或直出模拟量均可优先选模拟量输出电机驱动TB6612FNG 或 DRV8833比L298N压降小发热低适合小车电机TT直流减速电机带霍尔编码器带编码器方便后续做速度闭环车架亚克力双层板或3D打印底盘注意留传感器安装孔和电池位电源7.4V 2S锂电池或两节18650电机电源和主控电源建议分开或做滤波车轮普通橡胶轮直径65mm左右抓地力太差会导致高速丢线这里要特别说明电源问题。电机启动瞬间电流很大如果主控和电机共用一个电源会导致ADC参考电压波动传感器数值跳动表现就是小车在直道上莫名其妙跑偏。入门时可以让电池直接给驱动板供电主控用驱动板上的5V输出并在传感器电源脚并联一个100uF电容能明显改善数值稳定性。2.3 学习环境与比赛环境的差异学习环境里赛道通常是浅色地板上的黑色电工胶带速度慢、弯道平缓控制逻辑用最简单的对称差速就能跑。比赛环境则完全不同需要更高速度、S弯、直角弯、十字路口、断线衔接甚至要识别红绿灯和停车标志。因此在实际规划时要有版本概念V1只做直线和缓弯V2加入PD和弯道减速V3再上OpenMV做标志识别。不要一开始就把所有功能堆进同一套代码否则任何一个环节出问题都很难定位。3. 传感器读取与偏差计算把物理量变成控制量3.1 红外阵列的原始值与阈值处理TCRT5000模块接入Arduino后用analogRead可以读到0到1023的原始值。不同地面、不同模块、不同安装高度下数值差异很大所以第一步不是写巡线算法而是把原始值通过串口打印出来。const int sensorPins[5] {A0, A1, A2, A3, A4}; int rawValue[5]; void setup() { Serial.begin(115200); for (int i 0; i 5; i) { pinMode(sensorPins[i], INPUT); } } void loop() { for (int i 0; i 5; i) { rawValue[i] analogRead(sensorPins[i]); Serial.print(rawValue[i]); Serial.print(\t); } Serial.println(); delay(50); }把小车放在黑线上记录每个探头在黑线和白地上的数值然后取中间值作为阈值。因为每个探头灵敏度不完全一致不要用一个全局阈值要给每个探头独立阈值。int threshold[5] {512, 512, 512, 512, 512}; bool lineValue[5]; void readSensors() { for (int i 0; i 5; i) { rawValue[i] analogRead(sensorPins[i]); lineValue[i] (rawValue[i] threshold[i]) ? 1 : 0; } }这里还要约定一个关键问题线是黑线还是白线。大多数教程默认“深色线上检测到低反射值”也就是黑线时rawValue小于阈值。但有些模块输出的是数字量或者逻辑相反写代码前务必先确认线颜色和传感器输出方向否则后面所有判断都会反过来。3.2 加权平均把离散探针变成连续偏差5路探头从左到右分别给权重-2、-1、0、1、2。读到线的探头取它们的平均权重作为当前偏差。偏差为正说明线在右侧偏差为负说明线在左侧。int sensorWeight[5] {-2, -1, 0, 1, 2}; int lastError 0; int getError() { int sum 0; int activeCount 0; for (int i 0; i 5; i) { if (lineValue[i] 1) { sum sensorWeight[i]; activeCount; } } if (activeCount 0) { return lastError; } lastError sum / activeCount; return lastError; }activeCount为0代表全部探头都没检测到线此时不应该返回-2或2这类固定偏差而应该沿用上一次偏差并在主循环里做丢线处理比如降低速度或原地寻找。这个细节是很多小车冲线的原因全部丢线时错误地认为线在最左或最右电机全速往一边打车直接飞出赛道。3.3 OpenMV视觉巡线的基本思路OpenMV的方案是把“5个探头”换成“一整幅图像”。流程是灰度图二值化提取黑色区域用线性回归求线段中心输出中心相对画面中心的像素差。import sensor, image, time from pyb import UART sensor.reset() sensor.set_pixformat(sensor.GRAYSCALE) sensor.set_framesize(sensor.QQVGA) sensor.skip_frames(30) sensor.set_auto_gain(False) sensor.set_auto_whitebal(False) uart UART(3, 115200) black_threshold (0, 60) while True: img sensor.snapshot().binary([black_threshold]) line img.get_regression([(255, 255)], robustTrue) if line: error line.x() - sensor.width() // 2 uart.write(str(error) \n) else: uart.write(999\n)这里的关键点有三个。一是要关闭自动增益和自动白平衡否则光线变化时二值化效果会剧烈波动。二是摄像头视野里只能看到路面安装俯仰角要调整到画面下方1/3处是近处轨道。三是串口协议要约定丢线标志示例里的999代表“当前没有找到线”主控收到后要走丢线处理而不是把它当成一个巨大偏差。4. 核心控制代码把偏差换算成电机速度4.1 电机驱动先封装成可复用函数写巡线逻辑前先把左右电机封装成两个函数。函数接收带符号的速度值正数正转、负数反转内部负责处理PWM和方向引脚。这样上层控制只关心“左轮要转多少”不用反复处理方向逻辑。const int pwmPinL 5; const int dirPinL1 6; const int dirPinL2 7; const int pwmPinR 9; const int dirPinR1 8; const int dirPinR2 10; void motorControl(int pwmPin, int dir1, int dir2, int speedPwm) { speedPwm constrain(speedPwm, -255, 255); if (speedPwm 0) { digitalWrite(dir1, HIGH); digitalWrite(dir2, LOW); } else { digitalWrite(dir1, LOW); digitalWrite(dir2, HIGH); speedPwm -speedPwm; } analogWrite(pwmPin, speedPwm); } void motorLeft(int speedPwm) { motorControl(pwmPinL, dirPinL1, dirPinL2, speedPwm); } void motorRight(int speedPwm) { motorControl(pwmPinR, dirPinR1, dirPinR2, speedPwm); }封装完成后先写一个最简单的自检程序左轮正转2秒、反转2秒右轮同样操作。确认两个电机的正方向一致并且PWM越大轮子转得越快才开始接巡线算法。否则后面出现“小车往反方向打”时会浪费大量排查时间。4.2 从Bang-Bang到PD控制最简单的巡线控制是Bang-Bang偏差大于0时右轮减速偏差小于0时左轮减速。它逻辑简单但会产生明显的左右摆动速度稍高就冲出赛道。PD控制在Bang-Bang基础上加入了比例项和微分项。比例项P让纠正力度和偏差大小成正比微分项D根据偏差变化率抑制过冲让转向更平滑。float kp 1.2; float kd 0.6; int baseSpeed 120; int lastErrorPD 0; void lineFollowPD() { int error getError(); int diff error - lastErrorPD; lastErrorPD error; int correction (int)(kp * error kd * diff); int leftSpeed baseSpeed - correction; int rightSpeed baseSpeed correction; motorLeft(leftSpeed); motorRight(rightSpeed); }注意这里的correction单位是偏差乘系数和PWM速度直接相加。实际项目中左右电机特性可能不一致需要加一个balance参数微调直道例如leftSpeed baseSpeed - correction - balance。不要迷信一套kp和kd能适配所有场地换一个环境就要重新整定。4.3 完整主循环和丢线保护把读取、决策、执行串起来的主循环如下void setup() { Serial.begin(115200); for (int i 0; i 5; i) { pinMode(sensorPins[i], INPUT); pinMode(dirPinL1, OUTPUT); // 其余引脚初始化略 } } void loop() { readSensors(); int error getError(); if (lostLine()) { motorLeft(0); motorRight(0); delay(100); // 可以在这里加入原地搜索逻辑 return; } lineFollowPD(); delay(10); }lostLine函数判断所有探头都没有读到线并且保持了一段时间。丢线后最简单的处理是停车进阶做法是记录丢线前的偏差方向向该方向原地旋转搜索找回线后再恢复巡线。注意不要在丢线后直接把速度置为最大并沿用旧偏差这样小车大概率会朝一个方向冲出去。先停车或低速搜索再恢复巡线是稳定性的关键。5. 参数整定与实地验证5.1 阈值标定流程阈值标定不要在强光直射或阴影交界处做尽量在赛道实际环境光下进行。操作流程把小车放在黑线上串口打印5个探头的原始值记录黑线值。把小车放在白色地面上同样记录白地值。每个探头的阈值取黑线值和白地值的中间数。将阈值写入数组再次打印lineValue验证黑线上探头输出1、白地上输出0。改变环境光观察数值漂移必要时重新标定。5.2 PD参数整定顺序参数整定遵循“先P后D、先低速后高速”的顺序不要第一次就跑全速。步骤操作预期现象1kd置0kp从小值开始逐步增大小车开始能跟线但车速高时会摆动2继续增大kp找到“摆动明显”的临界点摆动频率加快说明P过大3把kp回调到摆动不明显的位置直道稳定弯道偏慢4逐步增大kd弯道转向变平滑摆动减少5提高baseSpeed观察是否过冲若高速丢线适当降低D或增加减速逻辑这里给出的是调试方法而不是固定参数。不同车架、轮距、传感器高度下的最优参数差别很大最有效的做法是在代码里把kp、kd、baseSpeed定义成变量通过串口或蓝牙实时修改避免每次改参数都重新编译烧录。注意PD参数不是“调完就不用管”的值。更换地面、更换电池、调整传感器高度后都需要重新验证否则之前调好的参数可能突然失效。5.3 巡线验证清单在正式让小车自己跑之前按下面清单逐项验证能省下大量排查时间电机正方向一致PWM增大时转速提高。传感器在黑白地面上的输出与代码判断一致。阈值在目标环境光下标定过不是沿用默认值。电池电压充足电机启动时传感器数值不剧烈跳动。在低速直道上能稳定走完一段距离。在缓弯上不摆振、不冲线。在直角弯处能完成转向不卡死在弯心。丢线时小车能停车或搜索而不是全速冲出。所有引脚定义与实际接线图一致无虚焊和接触不良。6. 常见问题与排查路径6.1 小车完全不走线或方向混乱先检查“检测层”。用串口打印rawValue和lineValue观察黑线上探头是否判为1、白地上是否判为0。如果无论怎么放都输出同一个值优先检查传感器供电和接线其次是模块离地高度。再检查“执行层”写固定输出程序确认左右轮转向是否符合认知。常见坑包括电机正负接反、左右轮PWM引脚写反、驱动板使能引脚没有拉高。6.2 左右摆振严重摆振通常来自两类原因P过大或者传感器安装不稳定。P过大时纠正量会过冲小车从左摆到右再摆回来。先调小kp观察是否改善。传感器安装不稳则表现为数值跳变可以用串口打印观察同一位置重复读数是否稳定。如果摆动来自机械调参数没有意义。6.3 高速丢线或冲出赛道高速丢线的本质是“控制周期跟不上车速”。车速越快单位时间走过距离越远同一套PD参数下的反应距离就越长。解决方向有三个提高主循环频率减少代码里的Serial打印和delay在弯道前根据偏差变化率自动降速提高D项抑制过冲但D太大会引入高频噪声需要结合传感器滤波。6.4 十字路口和断线处理TCRT5000阵列在十字路口会读到所有探头都为1此时如果还按正常加权计算偏差会趋于0小车直行多数情况下符合预期。但如果路口需要转弯就要加入标志逻辑比如主动让小车直行一小段再按预设方向转弯。断线的处理则依赖丢线检测和搜索策略原则是“低速搜索找回即走”。问题现象优先检查常见解决完全不走线传感器原始值和阈值重新标定阈值确认线色判断方向反电机正反转和左右定义统一左右轮定义写自检测试左右摆动kp和机械稳定性减小kp固定传感器安装高速冲线主循环频率和弯道速度减少delay增加弯道减速数值乱跳供电和接地独立供电并联滤波电容丢线后乱冲丢线处理逻辑停车或按旧偏差低速搜索7. 工程化改进和扩展方向7.1 从“能跑”到“稳定跑”的工程化改进开源巡线小车最大的价值不是“跑起来一次”而是能稳定复现。实际项目里建议做四件事把阈值、kp、kd、baseSpeed全部提取成配置数组放在程序开头统一管理用串口协议输出传感器原始值和偏差值方便记录分析增加看门狗或超时停车逻辑防止程序异常时小车失控传感器安装使用固定支架不要用胶带临时固定避免每次拆装后参数全部失效。代码层面最重要的习惯是分层。感知、决策、执行各自独立成函数不要全堆在loop里。这样后续从Arduino迁移到STM32或者把红外阵列换成OpenMV只需要替换感知层决策和执行层可以复用。7.2 可以继续深入的方向巡线项目做完后可以按下面方向继续扩展速度闭环给电机加霍尔编码器用PID把左右轮实际速度控制到目标速度差速更稳定。弯道规划根据偏差和偏差变化率预测弯道提前减速出弯再加速。OpenMV视觉增强识别颜色、二维码、红绿灯实现路口决策和任务调度。无线调试用蓝牙或Wifi把实时偏差和参数上传到上位机在线整定PD参数。多任务设计加入状态机让小车在不同赛道片段切换不同控制策略。从学习路径看巡线小车是连接“单片机基础”和“自动控制实战”的桥梁。把检测、决策、执行三个环节彻底理解后再去接触ROS、SLAM、视觉导航等更高阶内容会顺利很多。最值得投入时间的地方是把传感器数据和控制参数调明白而不是急着加更多外设。