【免费开源】STM32F103 八路灰度循迹小车:从零搭建到 PID 调参的完整指南

原创2026-10-31 23:30:561,905 阅读
文章标签:嵌入式物联网智能硬件硬件开发机器人

【免费开源】STM32F103 八路灰度循迹小车:从零搭建到 PID 调参的完整指南

本指南基于开源项目「STM32八路灰度循迹小车资源文件」整理,面向刚接触单片机与小车循迹的爱好者。这套方案以 STM32F103 为主控,搭配八路灰度传感器实时探测地面灰度差,再通过 PID 算法修正左右轮速,让小车自动贴合赛道行驶。硬件原理图、PCB 文件、元器件清单、C 语言源码和调试文档都在仓库里,照着流程走就能做出自己的循迹小车。

先搞懂八路灰度循迹是怎么工作的

灰度循迹的核心思路很简单:小车底部安装一排红外灰度传感器(本项目为 8 路),每个传感器持续检测正下方地面的明暗——白色底面反射多、黑色赛道线反射少,传感器输出随之变化。

STM32F103 把 8 路信号读进来后,就能判断出两种关键信息:

  • 小车相对赛道线的横向位置:哪几路传感器落在黑线上,偏差方向就清楚了;
  • 偏差程度:命中黑线的传感器越多、越靠外侧,说明偏得越远。

接下来 PID 算法接管:它根据位置偏差计算出左右两侧轮子该跑多快(比如左侧轮减速、右侧轮加速,车就往左回正)。偏差大修正快、偏差小微调,这样小车才能在弯道里既不脱线也不左右晃。八路比常见的三路、五路排布更密,对弯道和急转弯的分辨能力更强,这也是"八路"的价值所在。

仓库里有什么:硬件、代码、文档三部分

打开仓库,内容按"硬件 + 软件 + 文档"三条线组织,对应的原始资源打包在 小车8路灰度传感器循迹版.zip 中:

  • 硬件设计资料:电路原理图、PCB 布局文件、元器件清单(BOM)。有 PCB 文件意味着你可以直接打板,而不必从零画电路。
  • 软件代码:基于 STM32 HAL 库编写的 C 语言工程,覆盖三类核心功能——灰度传感器数据采集、PID 控制算法、小车运动(双轮速)控制。
  • 配套文档:项目说明、硬件设计指南、软件开发指南,以及一步步的调试说明,新手遇到卡点基本都能在文档里找到答案。

硬件搭建:照原理图制作并装好电路

硬件环节的目标是把电路做出来并装到小车上:

  1. 以仓库中的电路原理图为依据准备元器件,对照元器件清单逐一核对型号和数量;
  2. 参考 PCB 布局文件完成布线打板(或手工焊接);
  3. 安装完成后逐个检查连接,重点确认灰度传感器、电机驱动、电源这几条链路没有虚焊或接错。

装好硬件后,先用万用表或最基础的测试确认各模块上电正常,再进入软件环节,能省下大量排查时间。

软件开发:CubeMX 配引脚,CubeIDE 编译下载

代码部分的开发流程按官方推荐的两件套来走:

  1. 配置芯片:用 STM32CubeMX 打开工程,按硬件接线配置 STM32F103 的引脚和外设(传感器输入、电机 PWM 输出、通信接口等),确认无误后生成工程代码;
  2. 导入与编译:把仓库提供的 C 语言代码导入 STM32CubeIDE,完成工程组织后直接编译,再下载到开发板。

如果只是想先跑起来看效果,建议先以最小改动原则操作:保持原有工程结构,先烧录、再验证传感器读数是否正确,最后才动算法参数。

调参要点:先校准传感器,再动 PID

这是整个项目最容易卡住新手的阶段,顺序不能乱:

  • 第一步,灰度传感器校准。在目标赛道(黑线、白底的实际场地)上按照文档的调试步骤校准每路传感器的阈值,保证传感器在白、黑两个状态下的读数区分度足够大。场地光线变了,阈值往往也要跟着微调。
  • 第二步,PID 参数整定。从文档给出的初始参数出发,按"先比例、后积分、再微分"的常规节奏小幅调整:比例项决定修正力度,积分项用来消除长期偏差,微分项抑制过冲和震荡。每次只动一个参数,跑完一轮再动下一个。
  • 第三步,整体验证。让小车跑预定轨迹,观察三种典型表现——直线是否跑偏、弯道是否脱线、过弯后能否快速回正。稳定后还可以故意加一点扰动(轻推车身)检验自恢复能力。

调参没有"万能参数",最终效果取决于轮径、电压、赛道线宽和传感器离地高度,务必以自己车体的实测为准。

常见问题与可以继续折腾的方向

新手常遇到的坑:

  • 小车原地打转或单侧不动 → 先确认电机接线和 PWM 通道有没有搞反;
  • 传感器读数乱跳 → 检查供电纹波和传感器离地距离,光线环境变化也要纳入考虑;
  • 过弯脱线 → 优先提高比例增益并检查赛道线宽是否在八路的分辨范围内。

进阶方向:更换不同线宽的赛道测试极限、优化传感器排布间距以匹配特定场地、增加 OLED 显示或串口输出观测 PID 过程量,都适合作为下一步练习。

项目采用 MIT 许可证(详见 LICENSE),可以自由学习、修改与扩展。如果你在复现过程中发现问题或有改进想法,欢迎通过 Issue 或 Pull Request 参与贡献。

登录后查看全文
STM32八路灰度循迹小车资源文件