简介本资源面向嵌入式初学者与STM32开发者提供一套基于HAL库实现红外循迹的智能小车完整工程帮助读者掌握GPIO输入、外部中断、定时器触发与电机控制等核心技能。压缩包共72个文件约515KB以45个h头文件与18个c源文件为主体涵盖HAL库配置、GPIO驱动、中断服务与主逻辑另含ioc配置、uvprojx工程、hex固件及启动汇编等工程结构完整可直接编译。资源围绕四路红外传感器检测黑线、读取GPIO状态并判断轨迹偏差展开涉及中断处理、周期性采样与简单控制算法并预留串口调试接口便于实时监控。目前已有5644人学习下载适合希望从零搭建循迹小车、理解HAL库外设操作与实时控制流程的读者参考实践。1. 从“能跑就行”到“跑得稳”STM32 HAL 库红外循迹到底在做什么很多人第一次做 STM32 智能小车电机转起来那一刻觉得已经赢了结果一上循迹赛道就翻车直道还行一进弯道就冲出去或者原地画龙。问题往往不在电机也不在 PID而在红外循迹这一层的信号采集和逻辑判断没做扎实。这份资源围绕 STM32 HAL 库展开把红外循迹从 GPIO 读取、传感器布局、阈值判断到电机差速控制串成一条完整链路适合已经点过灯、调过 PWM 但循迹总不稳的嵌入式新手也适合想把手头灰度传感器方案换成红外对管的熟手做参考。它解决的不是“怎么让车动”而是“怎么让车看着线走还不抖”。下面按我实际拆这套代码的顺序把原理、接线、参数和踩坑点一次讲透。2. 红外循迹的硬件层传感器选型、布局与 GPIO 配置2.1 为什么常见方案是 TCRT5000 这类红外对管循迹的本质是判断地面反射率。红外发射管发出红外光照到白色地面反射强照到黑色胶带反射弱接收管根据反射强度输出高低电平。TCRT5000 这类模块把发射和接收封装在一起数字输出脚直接给 MCU 一个 0 或 1省掉外部 ADC。相比灰度传感器它的优势是响应快、成本低、电路简单劣势是受环境光影响大检测距离短一般有效高度在 1 到 2 厘米之间。我一般会把传感器离地高度控制在 1.2 厘米左右太高了黑线识别不到太低了容易蹭到地面。模块上的电位器用来调比较器阈值这是整个硬件层最容易被忽略又最要命的地方。常见做法是先把车放在白底上调电位器让输出指示灯刚好灭再放到黑线上确认灯亮反复两次找到临界点。不要用万用表测完就完事实际赛道的光照和地面材质跟桌面不一样。2.2 五路传感器的布局逻辑与 GPIO 初始化常见布局是五路红外中间一路对准黑线中心左右各两路对称分布。间距取决于黑线宽度一般黑线 1.5 到 2 厘米宽时相邻传感器间距取 1 到 1.2 厘米。布局决定了你能分辨多少种偏差状态五路可以组合出“正中、微左、微右、大左、大右、丢线”等状态三路就只能分辨左中右过弯时容易反应不过来。HAL 库下 GPIO 初始化没什么玄学但要注意输入模式的选择。数字输出的红外模块直接接 GPIO 输入即可如果模块输出是开漏记得使能上拉。下面是我常用的初始化片段把五路传感器挂在 GPIOB 的 0 到 4 脚/* 红外循迹传感器 GPIO 初始化五路输入 */ void Track_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); /* 使能 GPIOB 时钟 */ GPIO_InitStruct.Pin GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 | GPIO_PIN_4; GPIO_InitStruct.Mode GPIO_MODE_INPUT; /* 数字输入模式 */ GPIO_InitStruct.Pull GPIO_PULLUP; /* 模块开漏输出时内部上拉 */ GPIO_InitStruct.Speed GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOB, GPIO_InitStruct); }逻辑说明这里把五路传感器一次性初始化避免逐个配置时漏掉时钟使能。参数上Pull选GPIO_PULLUP是因为多数红外模块输出为开漏不加上拉读出来一直是高阻态表现为“怎么读都是 1”。如果你用的模块是推挽输出改成GPIO_NOPULL也行但上拉不会坏事。Speed选低频足够循迹信号变化远没到需要高频采样的程度。2.3 读取函数与状态编码读五路传感器不要一个一个HAL_GPIO_ReadPin散落在主循环里封装成一个状态字更清晰。我习惯把黑线识别为 1白底为 0然后拼成一个 5 位二进制数/* 读取五路红外状态返回 0~31 的状态值黑线为 1 */ uint8_t Track_Read_State(void) { uint8_t state 0; state | HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0) 4; /* 最左 */ state | HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_1) 3; state | HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_2) 2; /* 中间 */ state | HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_3) 1; state | HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_4); /* 最右 */ return state; }逻辑说明把五路拼成一个字节后续判断用switch或查表都方便。参数上移位方向决定了哪一位对应哪一路接线时最好按物理顺序从左到右接否则状态值跟实际位置对不上调车时会怀疑人生。注意有些模块黑线输出低电平那就要在读取后取反这个在代码里加一行state ~state 0x1F;即可别等到上车才发现逻辑反了。3. 控制层从状态字到电机差速的映射策略3.1 状态判断的两种写法if-else 与查表拿到 0 到 31 的状态字后要把它翻译成电机动作。最直接的是 if-else 链比如state 0x04表示中间压线直行state 0x08表示偏左要右转。但五路有 32 种组合实际有效状态也就十来种写一长串 if-else 容易漏分支。我更推荐查表法把状态字映射成左右轮的速度修正量/* 状态到差速的查表索引为 0~31 状态值 */ /* 每项格式{左轮修正, 右轮修正}正为加速负为减速 */ const int8_t track_table[32][2] { { 0, 0}, /* 00000 丢线保持或停车 */ { 0, 0}, /* 00001 最右压线需右转 */ {-30, 30}, /* 00010 右二压线右转 */ /* ... 中间省略按实际标定填充 ... */ { 0, 0}, /* 00100 正中直行 */ /* ... */ {30, -30}, /* 01000 左二压线左转 */ { 0, 0}, /* 10000 最左压线需左转 */ };逻辑说明查表把“状态到动作”的映射显式化调车时改表就行不用翻逻辑代码。参数上修正量的大小决定转向力度30 只是示例实际要结合你的基础 PWM 占空比来定。如果基础速度是 60%修正 30 可能太猛车会画龙修正 10 又可能转不过来。常见做法是先给一个保守值上车跑看它过弯是冲出去还是反应迟钝再逐步加。3.2 差速控制与 PWM 输出STM32 HAL 库下电机控制一般用定时器 PWM左右轮各占一个通道。差速逻辑就是基础速度加减修正量然后限幅到 0 到 100/* 根据状态查表得到修正量计算左右轮占空比 */ void Track_Control(uint8_t state, int base_speed) { int left base_speed track_table[state][0]; int right base_speed track_table[state][1]; /* 限幅防止负数或超过 100 */ if (left 0) left 0; if (left 100) left 100; if (right 0) right 0; if (right 100) right 100; Motor_Set_PWM(MOTOR_LEFT, left); Motor_Set_PWM(MOTOR_RIGHT, right); }逻辑说明限幅是必须的否则修正量一大计算出的占空比变成负数__HAL_TIM_SET_COMPARE收到负值会回绕成很大的数电机直接满速冲出去这是新手最常见的翻车点之一。参数上base_speed建议从 40 到 50 开始试循迹不需要跑多快稳比快重要。Motor_Set_PWM内部就是调__HAL_TIM_SET_COMPARE注意左右轮方向如果装反了直行会变成原地转圈接线时先单独测每个轮子的正反转。3.3 采样周期与主循环节奏循迹对实时性有要求但也不是越快越好。主循环里如果只做循迹采样周期控制在 5 到 10 毫秒比较合适。太快了传感器机械响应跟不上读到的状态在临界点抖动太慢了过弯来不及反应。我一般用HAL_Delay(5)或者定时器中断来定节奏不要在循环里塞太多打印语句串口输出会拖慢节奏调车时看着正常一关串口就冲出去这种血泪经验不少人都遇到过。4. 避坑与排查红外循迹最常见的五个翻车现场4.1 现象直道正常一进弯就冲出去原因转向修正量太小或者传感器间距太大弯道时黑线从中间直接跳到最外侧中间状态没被捕捉到。解决先减小传感器间距让状态过渡更细再把修正量加大或者对“大偏差”状态给更大的修正。我一般会把最外侧状态的修正量设成中间状态的两倍以上。4.2 现象车在原地左右画龙原因修正量过大或者采样周期太短状态在临界点反复跳变。解决降低修正量同时给状态判断加一点迟滞比如连续两次读到同一状态才执行动作。另外检查电位器是不是调得太临界稍微往白底方向偏一点让黑线识别更干脆。4.3 现象同一段赛道上午跑得好下午就丢线原因环境光变化。红外对管对阳光和强光敏感下午光线角度变了接收管输出跟着变。解决给传感器加遮光罩或者改用调制式红外接收头。如果赛道固定最省事的办法是每次跑之前重新标定电位器别指望一次调好管一天。4.4 现象读到的状态一直是 0 或一直是 31原因接线问题或上拉配置不对。一直是 0 说明模块没供电或输出被拉死一直是 31 说明上拉没生效或模块输出推挽但逻辑反了。解决先用万用表量模块输出脚在黑白面上的电压变化确认模块本身正常再查 GPIO 配置和接线顺序。4.5 现象过弯时内侧轮反转车原地打转原因差速计算后某一侧占空比算成负数限幅没做或者做漏了。解决在Track_Control里强制限幅并且把“丢线”状态单独处理成停车或沿最后方向找线不要让它落到默认的直行分支。5. 进阶技巧用状态机替代纯查表让丢线也能救回来纯查表在正常循迹时够用但遇到丢线、十字路口、虚线这些情况就露怯。我后来习惯在查表外面包一层状态机把循迹分成“正常跟踪”“丢线搜索”“十字直行”三个状态。正常跟踪时走查表连续几次读到全 0 就进丢线搜索让车按最后已知偏差方向慢速旋转找线如果五路同时压线且持续超过一定时间判定为十字强制直行一段距离再恢复跟踪。/* 简化的循迹状态机骨架 */ typedef enum { TRACK_NORMAL, TRACK_LOST, TRACK_CROSS } TrackState; void Track_StateMachine(void) { static TrackState st TRACK_NORMAL; static uint8_t lost_cnt 0, cross_cnt 0; uint8_t s Track_Read_State(); switch (st) { case TRACK_NORMAL: if (s 0x00) { /* 全白丢线 */ if (lost_cnt 3) st TRACK_LOST; } else if (s 0x1F) { /* 全黑十字 */ if (cross_cnt 3) st TRACK_CROSS; } else { lost_cnt cross_cnt 0; Track_Control(s, 45); /* 正常查表控制 */ } break; case TRACK_LOST: Motor_Set_PWM(MOTOR_LEFT, 30); /* 原地慢转找线 */ Motor_Set_PWM(MOTOR_RIGHT, 0); if (s ! 0x00) { st TRACK_NORMAL; lost_cnt 0; } break; case TRACK_CROSS: Track_Control(0x04, 45); /* 强制直行通过十字 */ if (s ! 0x1F) { st TRACK_NORMAL; cross_cnt 0; } break; } }逻辑说明状态机把“异常情况”从正常逻辑里剥离出来避免丢线时车还傻傻按最后状态跑。参数上lost_cnt和cross_cnt的阈值决定反应灵敏度3 到 5 次比较稳妥太小了容易误判太大了车已经冲出去了。TRACK_LOST里的旋转方向最好根据丢线前最后一次偏差来定这里为了简洁固定了一个方向实际用的时候可以加一个变量记录最后偏差。验证这套逻辑有个笨办法但很有效把车拿在手里手动让传感器在黑白线上来回移动观察串口打印的状态字和电机反应确认每个状态都进得去、出得来。别一上来就放地上跑手里过一遍能省很多追车的时间。从那以后我每次调循迹都强制先做一遍手持状态验证再上车跑。希望帮到你。本文还有配套的精品资源点击获取