从零构建STM32F103C8T6五路红外循迹小车：CubeMX配置与实战避坑指南
第一次拿到STM32开发板时，看着密密麻麻的引脚和复杂的寄存器配置，我完全不知道从何下手。直到用CubeMX完成第一个LED闪烁项目后，才发现原来嵌入式开发可以如此直观。今天，我们就用这个神奇的工具，从焊接第一根杜邦线开始，完整实现一个能识别复杂路径的五路红外循迹小车。
1. 硬件准备与电路设计
在淘宝搜索"STM32小车套件"会出现上百种选择，但核心部件其实就几样。我建议优先选购带金属齿轮箱的TT马达（转速在200RPM左右），比塑料齿轮的更耐用。去年帮学弟调试时，他们的塑料齿轮马达在三天内就出现了打滑现象。
1.1 必备材料清单
| 部件名称 | 推荐型号 | 数量 | 注意事项 |
|---|---|---|---|
| 主控板 | STM32F103C8T6 | 1 | 注意要买带USB转串口的版本 |
| 电机驱动 | L298N双路模块 | 1 | 建议选带散热片的改良版 |
| 红外传感器 | TCRT5000五路模块 | 1 | 检查有无可调电位器 |
| 供电系统 | 18650电池+盒 | 3串 | 带保护板更安全 |
| 车体结构 | 亚克力底盘套件 | 1 | 注意马达安装孔位匹配 |
最容易忽略的细节：红外模块的安装高度。通过实验发现，传感器距地面1.2cm时检测效果最佳。太高会漏检黑线，太低则容易刮擦地面。可以用螺母作为垫片来微调高度。
1.2 关键电路连接图
L298N的接线常让新手困惑，其实记住两个要点：
- 使能端ENA/ENB需要接PWM信号
- 电机接口采用对角控制原则
// 典型接线对应关系： STM32 PA0 -> L298N IN1 (左电机正极) STM32 PA1 -> L298N IN2 (左电机负极) STM32 PA2 -> L298N IN3 (右电机正极) STM32 PA3 -> L298N IN4 (右电机负极) STM32 PA6 -> L298N ENA (左电机PWM) STM32 PA7 -> L298N ENB (右电机PWM)警告：初次通电前务必用万用表检查所有电源线路，我曾因5V和3.3V短路烧毁过两块芯片。
2. CubeMX工程配置详解
打开CubeMX时，很多同学会直接点"Generate Code"，其实前期配置才是项目的灵魂。我们重点看三个关键配置：
2.1 GPIO引脚分配策略
五路红外传感器建议使用连续的GPIO端口，这样代码会更整洁。比如全部接在GPIOB的PB0-PB4：
// 在main.h中定义更直观的别名 #define SENSOR1_Pin GPIO_PIN_0 #define SENSOR2_Pin GPIO_PIN_1 #define SENSOR3_Pin GPIO_PIN_2 #define SENSOR4_Pin GPIO_PIN_3 #define SENSOR5_Pin GPIO_PIN_4配置技巧：在Pinout视图右键点击引脚，选择"Enter User Label"可以添加自定义标签，生成代码时会自动生成对应的宏定义。
2.2 PWM电机调速配置
使用TIM3的CH1和CH4生成两路PWM，关键参数设置：
- Clock Source选择Internal
- Prescaler设为71（72MHz/(71+1)=1MHz）
- Counter Period设为999（1MHz/(999+1)=1kHz）
- Pulse初始值设为300（占空比30%）
实测发现1kHz的PWM频率既能保证电机平稳运行，又不会产生可闻噪音。
2.3 定时器中断配置
添加一个基本定时器用于系统心跳，比如TIM6配置：
- Prescaler: 7199
- Counter Period: 9999 这样产生的中断频率是72MHz/(7200*10000)=1Hz，适合用于调试信息输出。
3. 循迹算法深度优化
原始代码只能处理简单直线，我们引入状态机机制应对复杂路径。先定义传感器组合模式：
typedef enum { LINE_STRAIGHT, // 00100 LINE_LEFT, // 01100 LINE_RIGHT, // 00110 LINE_T_LEFT, // 11100 LINE_T_RIGHT, // 00111 LINE_CROSS, // 11111 LINE_LOST // 00000 } LineState;3.1 自适应速度控制算法
直行时全速，转弯时外侧轮加速：
void adjustSpeed(LineState state) { switch(state) { case LINE_LEFT: TIM3->CCR1 = 700; // 左轮70%占空比 TIM3->CCR4 = 300; // 右轮30% break; case LINE_RIGHT: TIM3->CCR1 = 300; TIM3->CCR4 = 700; break; default: TIM3->CCR1 = 500; TIM3->CCR4 = 500; } }3.2 十字路口处理策略
遇到全黑线（LINE_CROSS）时，根据前次转向方向决定：
if(currentState == LINE_CROSS) { if(lastTurn == LEFT) { smoothTurn(LEFT, 45); // 45度左转 } else { smoothTurn(RIGHT, 45); } delay_ms(200); // 确保完全通过路口 }4. 调试技巧与性能优化
用STM32的SWD接口配合ST-Link调试器，可以实时查看变量值。在Keil中设置Watch窗口监控关键参数：
- 传感器原始值（GPIO输入状态）
- PWM占空比（CCR寄存器值）
- 当前状态机状态
4.1 常见问题排查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 电机抖动不转 | PWM频率过高 | 调整Prescaler降低频率 |
| 误检测黑线 | 环境光干扰 | 加装传感器遮光罩 |
| 转弯不灵敏 | 占空比差太小 | 加大左右轮速差 |
| 供电不稳定 | 电池电量不足 | 更换电池或增加电容 |
4.2 卡尔曼滤波应用
对于抖动严重的传感器信号，可以添加简单滤波：
#define FILTER_GAIN 0.2f float filteredValue = 0; void updateFilter(uint8_t raw) { filteredValue = FILTER_GAIN * raw + (1-FILTER_GAIN)*filteredValue; }记得在CubeMX中开启浮点运算支持（FPU Settings）。
