STM32智能小车源码剖析：驱动、循迹避障与PID调试

简介这套源代码包围绕STM32智能小车开发面向嵌入式初学者、电子竞赛选手与毕设学生覆盖硬件驱动、传感器集成、控制算法、通信协议等完整环节可帮助理解小车从感知、决策到执行的系统设计。包内共2000个文件以C源码、H头文件及Icf/Ld链接脚本为主包含Keil工程配置与常见外设驱动TIM、I2C等另辅以大量HTML页面、JS脚本和PNG示意图便于查阅说明和查看运行效果整体大小约10.12MB。已有4439人学习下载在同类小车源码中热度较高。内容上可重点参考超声波测距避障、陀螺仪姿态检测、PID调速、寻迹等经典模块从初始化、中断处理到上层控制均有对应实现结合FreeRTOS任务调度思路和无线通信代码读者不仅能掌握HAL库调用与外设配置流程还能基于这些源码快速复现、改造或迁移到自己的小车项目中适合作为毕设、课设或竞赛备赛的实用模板。1. 基于STM32的智能小车源代码.zip 到手先解决三件事基于STM32的智能小车源代码.zip 这类压缩包在网上流传的版本比跑过赛道的实车还多。解压开是一个 Keil 工程、几组 .c/.h 源文件外加一份可能只有三行的使用说明内容大多是把一辆四轮小车动起来电机驱动、红外循迹、超声波避障、PWM 调速外送一颗蓝牙模块标准毕业设计骨架。但骨架固定反而容易漏掉真正重要的东西。源码跟硬件怎么对上、控制逻辑放在哪个文件、下载到板子上跑通需要哪几步这三个问题回答不了代码能编译也跑不出效果。这篇把它当作一份普通嵌入式工程来拆读者是拿源码去参加比赛、做毕设或者做产品原型的人不是来看一遍 while(1) 怎么写的人。2. STM32智能小车的硬件映射与底层驱动实现拿到任何一份源码第一件事不是打开 main.c 去看 while 循环而是把所有与硬件相关的引脚定义列出来。智能小车常见的外设是四路红外循迹、一颗超声波避障模块、L298N 电机驱动以及可选配的 OLED 和蓝牙。源码里这些外设一般分散在 bsp 目录或者 user 目录但引脚配置几乎都集中在两处其一是 stm32f1xx_hal_msp.c如果用 HAL 库其二是 GPIO 初始化函数里的一堆 GPIO_InitStruct 结构体。2.1 先从源代码和原理图里对出一张引脚分配表用全局搜索功能在工程里检索 GPIO_PIN 和对应的宏定义可以快速还原这张表。例如一份常见的底盘方案是这样的功能引脚连接对象说明电机A PWMPA8L298N ENA定时器 TIM1_CH1电机A方向PB12 / PB13L298N IN1/IN2高低电平决定正反转电机B PWMPA11L298N ENB定时器 TIM1_CH4电机B方向PB14 / PB15L298N IN3/IN4同上循迹传感器PC0-PC3TCRT5000 输出数字量触底为 0超声波 TrigPA2HC-SR0410us 高电平触发超声波 EchoPA3HC-SR04返回脉宽表里最容易出错的是定时器通道复用。PA8 做 PWM 时得确认 TIM1_CH1 的复用功能已经开启如果直接把 GPIO 初始化为 push-pull 输出而 AFIO 没有配置代码能编译但电机没反应。这类问题不做一张表还真排查不出来。对照引脚表还有个额外收益当工程里找不到某个功能对应的初始化代码时说明这个模块是悬空的烧进去大概率不会工作。2.2 从 main.c 找到芯片初始化的顺序智能小车源码的 main 函数结构高度相似顺序大致是HAL_Init() 先设置 SysTick然后时钟树、GPIO、定时器、ADC、串口各自初始化。只要在这几步里有一个模块初始化失败并且代码在 Error_Handler() 内部写了死循环小车表现就是上电后完全不动作。int main(void) { HAL_Init(); /* 必须最先设置 SysTick 与优先级分组 */ SystemClock_Config(); /* 外部晶振 8M系统跑 72M */ MX_GPIO_Init(); /* 全部输入输出引脚的初始化 */ MX_TIM1_Init(); /* 产生 20kHz 的 PWM给电机调速 */ MX_USART2_Init(); /* 调试串口波特率 115200 */ HAL_TIM_PWM_Start(htim1, TIM_CHANNEL_1); HAL_TIM_PWM_Start(htim1, TIM_CHANNEL_4); while (1) { Car_Forward(600); /* 速度映射到比较寄存器 */ HAL_Delay(1000); } }这段代码的逻辑很直白PWM 通道启动前定时器只是配置好了并不会输出波形。Car_Forward(600) 把 0-1000 的给定值换算成 CCR 寄存器里的计数值占空比大约 60%。如果速度给得过高电机驱动芯片 L298N 的使能脚会过热保护所以很多源码里看到的是 300-700 这个区间的使用频率。给这个函数传负数或者超过 1000 的值不同源码的处理方式差别很大建议在调用前夹逼一次避免溢出的正数被当成反向速度。2.3 电机驱动的写入函数实现与参数边界大多数源码不会用现成的电机库而是直接在 motor.c 里写四个 GPIO 和一个 PWM 通道的控制。下面这段是典型的双电机控制片段注意方向脚和使能脚的关系void Motor_SetSpeed(uint8_t motor, int16_t speed) { if (motor MOTOR_LEFT) { if (speed 0) { HAL_GPIO_WritePin(L_IN1_GPIO_Port, L_IN1_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(L_IN2_GPIO_Port, L_IN2_Pin, GPIO_PIN_RESET); } else { HAL_GPIO_WritePin(L_IN1_GPIO_Port, L_IN1_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(L_IN2_GPIO_Port, L_IN2_Pin, GPIO_PIN_SET); speed -speed; } __HAL_TIM_SET_COMPARE(htim1, TIM_CHANNEL_1, (uint16_t)speed); } }关键点在于 speed 的绝对值上限必须和定时器 ARR 保持一致。假如 TIM1 的 Period 配的是 999那么 CCR 的合法范围就是 0-999。给 1000 或者更大的数HAL 库不会报错但输出的占空比和期望值会不一致这在电机调速时表现为左右轮速度差小车跑不了直线。另一个容易被忽略的参数是通道极性如果 TIM_OCPolarity 配置成了反转PWM 占空比会反过来表现为速度越高轮子越慢。提示改动硬件接线后不要只在 motor.c 里改引脚宏还要检查 GPIO 时钟是否使能。STM32F103C8 的 PB、PC 端口时钟没开引脚电平会一直保持初始浮动状态烧录后电机抖一下再不动多半是这个原因。3. 从源码走通智能小车核心循迹跟随与避障算法智能小车的“智能”不在于跑得快而在于能根据传感器反馈修正自己的行为。源码里最值得读的不是那些读按键和点灯代码而是循迹和避障两条控制链路。每条链路都遵循“读取传感值、计算控制量、输出到电机”三步先找到这三步对应哪几个函数整个工程就通了一半。3.1 循迹误差量的计算从离散到连续红外循迹传感器模块比如四路 TCRT5000输出的是数字电平黑线区域和白色跑道电平相反。大多数源码的做法是直接把四路电平读出来拼成一个 4 位二进制数再查表得到误差 e。这个误差不是真实的物理偏差只是一个离散档位但足够让 PID 控制器使用。int8_t Read_Track_Error(void) { uint8_t val 0; val | HAL_GPIO_ReadPin(TRACK1_GPIO_Port, TRACK1_Pin) 3; /* 最左 */ val | HAL_GPIO_ReadPin(TRACK2_GPIO_Port, TRACK2_Pin) 2; val | HAL_GPIO_ReadPin(TRACK3_GPIO_Port, TRACK3_Pin) 1; val | HAL_GPIO_ReadPin(TRACK4_GPIO_Port, TRACK4_Pin); /* 最右 */ switch (val) { case 0b1000: return -3; /* 左偏多 */ case 0b1100: return -2; case 0b0100: return -1; case 0b0110: return 0; /* 车身居中 */ case 0b0010: return 1; case 0b0011: return 2; case 0b0001: return 3; /* 右偏多 */ default: return 0; /* 全黑或全白保持原方向 */ } }val 变量中每一比特对应一个传感器的电平bit3 对应最左边、bit0 对应最右边查表顺序和实际布局一致。这里的 default 分支是源码里最常见的隐患。当四路都在黑线外面时返回 0 会让小车以为自己是直的继续走直冲出赛道。更可靠的做法是先判断全白或全黑保留上一次误差值或者在小车循迹丢线时直接执行原地寻线动作。3.2 增量式 PID 在转向控制中的落地知道误差值之后典型的源码会用一个增量式 PID 输出左右轮差速。比例项让转向响应快积分项消除稳定偏差微分项抑制抖动。小车这种惯性系统不适合纯比例控制因为传感器离散输出会让转向表现为一顿一顿的抖动。int16_t pid_update(int8_t error) { static float integral 0; static int8_t last_error 0; float output; float kp 25.0f, ki 0.02f, kd 8.0f; integral error; if (integral 100.0f) integral 100.0f; /* 抗积分饱和 */ if (integral -100.0f) integral -100.0f; output kp * error ki * integral kd * (error - last_error); last_error error; return (int16_t)output; }三个系数不像数值看起来那么随意。给转向电机加差速时output 的物理意义是“左右轮速度差”正数表示右轮比左轮快负数反过来。调整顺序建议按表格里的来参数典型范围作用调大的后果Kp15-40快速回到中线转向过冲、震荡Ki0.01-0.1消除稳态偏移低频抖动Kd3-15抑制突变转弯迟钝积分项在这个场景里不能给大。四路传感器的输出是离散的error 跳变频繁积分项会把历史误差的累计值放大导致直线阶段车身左右晃。如果场地是平整的白底黑线很多时候 Ki 直接给 0 也能跑留一个很小的值只是为了过连续弯时不丢线。3.3 避障逻辑用状态机比用 if 嵌套可靠超声波避障的常用实现是 HC-SR04 测距加上一个简单状态机直行、倒车、转弯、恢复直行。为什么不用连续几层 if因为 if 嵌套在测距值突变比如超声波来回反射出现跳变时会瞬间进入不合理的分支而状态机把动作和条件解耦每一步只允许一个行为发生。void obstacle_state_machine(float distance) { static uint8_t state STATE_FORWARD; switch (state) { case STATE_FORWARD: if (distance 20.0f) { Car_Stop(); Car_Backward(400); state STATE_BACKING; } break; case STATE_BACKING: if (distance 30.0f) { Car_Stop(); Car_TurnLeft(500); state STATE_TURNING; } break; case STATE_TURNING: if (distance 40.0f) { Car_Stop(); Car_Forward(500); state STATE_FORWARD; } break; } }阈值参数 20cm、30cm、40cm 是按小车的响应时间估出来的。低速小车从检测到障碍到刹停需要 1.5-2.5 个控制周期每周期 20-50ms速度越快三个阈值都要整体上调。源码里如果只给一组参数那通常是直线慢速测试得到的实际比赛或复杂场地里要自己重新标定。超声波测距本身还有一个已知坑声波打到斜面上会反射到别处返回值跳变成零或者满量程状态机里最好加一道滤波例如连续三次读数不一致就丢弃本次值。4. STM32智能小车源码的工程编译、烧录与串口调试源码逻辑上看得明白落到开发板上是另一道关卡。这一章流程基于最常见的技术栈Keil MDK 编译、ST-Link 烧录、串口打印调试信息。三个环节各有一个高发坑芯片包版本不匹配、烧录时找不到内核、串口读到乱码。4.1 Keil5 里芯片包与目标芯片的匹配关系绝大多数下载的 STM32 智能小车源码是基于 STM32F103C8T6 或 STM32F103ZET6 写的。打开工程如果弹出 Device not found或者编译时报 unrecognized device十有八九是 Keil 的芯片支持包没装。MDK5 之后芯片型号的内核描述不再是自带的必须从 Pack 里单独安装相关型号的 sfd 文件。# Keil 的 Pack Installer 操作路径 # 菜单 Project Manage Pack Installer # 左侧 Search 框输入 STM32F1 # 找到 STMicroelectronics STM32F1 Series Device Support # 点击 Install等待进度条结束 # 这里没法用命令行替代Pack 安装器本身没有 CLI 入口安装完成后回到工程在 Options for Target 的 Device 页里重新选择芯片型号。这里有个容易踩的差异源码工程按 STM32F103C8 建而板子上是 STM32F103ZET6虽然内核相同、引脚封装不同编译器不会报错但很多复用引脚会不工作。我一般会先看工程里定义的芯片型号再决定是改工程还是换板子。如果芯片包里装的是最新的 1.8.x 版本部分老工程用到的寄存器定义可能在新头文件里有细微差异编译报错时优先看报错行属于哪个外设头文件。4.2 ST-Link 烧录报错 STM32 target not found 的排查烧录环节最常见的错误信息是 “Error: STM32 target not found”。这句英文直接说明调试器没能和目标芯片建立握手跟代码本身没有关系。排查顺序是固定的检查项操作说明ST-Link 驱动打开设备管理器看 ST-Link 是否枚举成功带感叹号说明驱动异常接线SWDIO、SWCLK、GND、3.3V 四条线是否都接只接三条会连不上复位电路确认 NRST 上没有强下拉电容电容过大导致复位拉不住烧录模式按住复位键点烧录松手看进度常用于代码关掉了调试口还有一个极少被提及的原因如果代码里把 PA13/PA14SWDIO/SWCLK 复用脚初始化成了普通 GPIO并且工程设置了烧录后复位运行第二次烧录就断不开。此时需要把 BOOT0 接 3.3V 进入 ISP 模式用串口擦除旧程序再拨回 BOOT0 接 GND。很多智能小车源码直接用全部 GPIO 做外设特别容易踩这个坑。排查时先看引脚分配表里有没有 PA13/PA14 的影子有就直接进入 ISP 擦除流程不用反复试烧录。4.3 在源码里加一段串口调试代码确认控制链路智能小车跑起来之后纯粹看轮子转不转只能判断有没有电判断控制量是否正确最直接的办法是把误差值和控制输出通过串口发出来。多数源码默认会用 USART1 或 USART2 打印启动日志如果没有加上一段并不复杂。#include stdio.h int fputc(int ch, void *stream) { HAL_UART_Transmit(huart2, (uint8_t *)ch, 1, 100); return ch; } /* 在 while(1) 循环里调用 */ printf(error%d output%d distance%.1f\r\n, track_error, pid_output, obstacle_cm);重定向 printf 之后有两个约束。一是波特率要在 CubeMX 生成代码时设成和串口工具一致115200 是常见值二是编码方式STM32 的串口工具一般选 UTF-8Windows 自带的超级终端识别中文会乱码调试字符串先用纯英文最省事。如果 printf 打出来全是乱码先看波特率是否匹配再看 VCP 驱动是不是系统自动装的假驱动最后确认串口线有没有接反 TX/RX。提示在 while 循环里直接加 printf 会因为阻塞式串口发送拖慢控制周期。调试完记得用宏整体关掉或者把调试输出放到一个只在按键触发时才执行的函数里保留这段代码比删掉更利于后续维护。5. 在智能小车源码上扩展一个 OLED 实时状态屏的写法5.1 扩展接线与代码插入位置最后这部分给一个具体可复用的扩展路径在现有源码基础上加一块 0.96 寸 OLEDI2C 接口把调试信息直接显示在车上。SSD1306 是最常见的主控源码里一般已经带驱动文件如果没有找一份适配 HAL 库的 ssd1306.c 即可。I2C 引脚如果被其他外设占用就用软件模拟 I2C任意两个 GPIO 都能工作典型选 PB8/PB9 或者 PB6/PB7。初始化代码插入位置在 main 函数里顺序放在 USART 初始化之后、PWM 启动之前。显示刷新放到 while(1) 循环里用节拍控制间隔#include ssd1306.h /* 在 USART 初始化之后调用一次 */ SSD1306_Init(); /* 在 while(1) 循环里用 HAL_GetTick 控制刷新频率 */ static uint32_t last_refresh 0; if (HAL_GetTick() - last_refresh 100) { char line_buf[24]; SSD1306_Clear(); sprintf(line_buf, Err:%d Out:%d, track_error, pid_output); SSD1306_GotoXY(0, 0); SSD1306_Puts(line_buf, Font_7x10, 1); sprintf(line_buf, Dist:%.0fcm, obstacle_cm); SSD1306_GotoXY(0, 20); SSD1306_Puts(line_buf, Font_7x10, 1); SSD1306_UpdateScreen(); last_refresh HAL_GetTick(); }SSD1306 的显存是 1024 字节I2C 在 400kHz 波特率下传完整帧大约需要 20ms加上字体渲染时间如果放在 10ms 的控制周期里会给主循环带来明显卡顿。所以刷新频率不要追高100ms 一帧对观察 PID 输出变化绰绰有余。5.2 用 OLED 验证控制链路是否健康这套扩展跑起来之后不需要示波器也能验证整个控制链路。上电后 OLED 亮起显示版本号说明电源和 I2C 通道是通的小车过弯时 Err 数值在负和正之间交替而 Out 数值连续变化说明误差计算和 PID 输出都在正常链路里用手把小车推到左边再松开OLED 数值会在 1-2 秒内回归到接近零的稳定值说明 Ki 没有过大导致积分发散Kd 也没有把微分项放得过大。如果 OLED 亮但某个数值一直不动大概率是传感器接线悬空或者上拉电阻配置问题如果数字跳得飞快先检查显示刷新铁定没放错位置。顺手把这个改造后的工程另存为一个新版本下次再调试时直接对比原包能最快定位是哪次改动引入了回归问题。本文还有配套的精品资源点击获取