STM32C8T6循迹避障小车实战：硬件选型、代码调试与PID调优

简介这是一份面向嵌入式初学者与电子竞赛选手的STM32循迹避障小车完整工程基于STM32F103C8T6最小系统板搭建采用L298N驱动两路直流电机12V供电通过Timer3输出两路PWM实现调速并集成四路红外循迹、超声波测距配合舵机自动转向的避障方案同时支持手机蓝牙调试助手远程控制小车运动方向。资源包共227个文件以c源码、h头文件、o目标文件、crf交叉引用文件及s启动文件为主另含hex烧录文件、uvprojx工程文件与map映射文件压缩包约7.38MB工程结构完整、代码注释详尽便于直接编译与二次开发。目前已有1677人学习下载适合希望系统掌握电机驱动、PWM调速、传感器融合与蓝牙通信等知识点的读者参考借鉴。1. 从一堆散件到能跑的车这套 STM32C8T6 循迹避障方案到底值不值得拆如果你手头正躺着一块 STM32C8T6 最小系统板、几个红外对管、一个超声波模块和两三个 TT 马达却迟迟没把它们拼成一台能自己巡线、遇障能拐的智能小车那这套资源就是冲着你来的。STM32 智能小车这个方向看着简单真动手才知道坑有多密PWM 频率设错马达尖叫、红外阈值调不好在黑白线之间反复横跳、超声波一发一收就卡死主循环。这套基于 STM32C8T6 的循迹避障小车方案把感知、决策、执行三层拆得比较清楚代码结构不绕适合刚摸完 GPIO 和定时器、想找一个完整项目练手的嵌入式新手也适合需要快速搭一台教学演示车的从业者。它解决的不是能不能跑而是怎么跑得稳、调得快、出了问题知道往哪看。2. 硬件选型与接线为什么是 C8T6 加红外加超声波2.1 主控为什么锁定 STM32C8T6STM32C8T6 属于 F103 系列里的 48 脚封装Flash 64KB、RAM 20KB、主频 72MHz。拿它做循迹避障小车资源刚好卡在够用但不浪费的位置。循迹需要至少两路外部中断或定时器输入捕获来读红外电平避障需要一路定时器输出触发超声波、一路输入捕获测回响再加上两路 PWM 驱动马达算下来 TIM1 到 TIM4 基本排满。C8T6 的定时器数量和通道数正好覆盖换成资源更少的型号就得做功能取舍换成 F4 系列又属于杀鸡用牛刀成本上不划算。另一个现实原因是生态。C8T6 的寄存器手册、标准外设库和 HAL 库资料都齐全社区里能搜到的例程多遇到问题不至于卡死。我一般建议新手先用标准库把定时器和中断跑通再决定要不要上 HAL因为 HAL 的抽象层在调试 PWM 占空比时反而多一层干扰。2.2 感知层红外对管与超声波的配合逻辑循迹用 TCRT5000 这类红外反射对管原理是发射管打光、接收管根据反射强度输出高低电平。白底反射强、黑线反射弱所以黑线对应一种电平、白底对应另一种。这里有个容易翻车的点红外对管的输出是数字量还是模拟量取决于模块上有没有带 LM393 比较器。带比较器的模块输出干净的数字高低电平直接进 MCU 的 GPIO 就行不带比较器的输出是模拟电压得走 ADC 采样再自己定阈值。这套方案默认用的是带比较器的数字输出模块接线简单但阈值电位器要现场调。避障用 HC-SR04 超声波模块Trig 发一个 10 微秒以上的高电平脉冲Echo 输出高电平高电平持续时间就是声波往返时间。距离换算公式是距离等于高电平时间乘以声速再除以二。声速取 340 米每秒换算成厘米每微秒就是 0.034。所以距离厘米数等于高电平微秒数乘以 0.034 再除以 2约等于微秒数除以 58。2.3 执行层L298N 与 TT 马达的接线要点L298N 是双 H 桥驱动能同时驱动两路直流马达每路需要两个方向控制脚加一个使能脚。使能脚接 MCU 的 PWM 输出方向脚接普通 GPIO。TT 马达工作电压一般 3 到 6 伏L298N 的逻辑供电 5 伏、马达供电可以单独给。这里必须注意共地L298N 的 GND、STM32 的 GND、电池负极要连在一起否则 PWM 信号没有参考电平马达会时转时不转这种玄学问题十有八九是地没共好。接线对照表如下实际以你手上的模块丝印为准模块引脚接到 STM32C8T6说明左红外OUTPA0循迹输入可配外部中断右红外OUTPA1循迹输入超声波TrigPB0定时器输出或普通 GPIO 触发超声波EchoPB1定时器输入捕获L298NENAPA8TIM1_CH1 PWML298NENBPA9TIM1_CH2 PWML298NIN1~IN4PB12~PB15方向控制提示接线前先用万用表确认红外模块在黑白面上的输出电平别等焊完了才发现阈值反了。3. 循迹与避障的代码落地定时器、中断和状态机怎么写3.1 PWM 驱动马达频率和占空比怎么定马达驱动最怕 PWM 频率选错。频率太低马达会听到明显的啸叫因为线圈在音频范围内被反复通断频率太高L298N 的开关损耗上去了马达力矩反而下降。常见做法是把 PWM 频率设在 1kHz 到 20kHz 之间我一般取 10kHz 左右既避开听觉敏感区又不会让驱动芯片太热。STM32C8T6 主频 72MHz定时器预分频和自动重装载值按下面算// TIM1 PWM 初始化目标频率 10kHz // 72MHz / (711) 1MHz 计数频率 // 1MHz / (991) 10kHz PWM 频率 void Motor_PWM_Init(void) { TIM_TimeBaseInitTypeDef tim; TIM_OCInitTypeDef oc; RCC_APB2PeriphClockCmd(RCC_APB2Periph_TIM1, ENABLE); tim.TIM_Prescaler 71; // 预分频得到 1MHz tim.TIM_Period 99; // 自动重装载10kHz tim.TIM_CounterMode TIM_CounterMode_Up; tim.TIM_ClockDivision TIM_CKD_DIV1; TIM_TimeBaseInit(TIM1, tim); oc.TIM_OCMode TIM_OCMode_PWM1; oc.TIM_OutputState TIM_OutputState_Enable; oc.TIM_Pulse 0; // 初始占空比 0 oc.TIM_OCPolarity TIM_OCPolarity_High; TIM_OC1Init(TIM1, oc); TIM_OC2Init(TIM1, oc); TIM_CtrlPWMOutputs(TIM1, ENABLE); // 高级定时器必须开这个 TIM_Cmd(TIM1, ENABLE); }逻辑说明预分频 71 表示计数时钟是 72MHz 除以 72得到 1MHz。自动重装载 99 表示计数器数到 99 归零一个周期 100 个计数1MHz 除以 100 就是 10kHz。占空比通过改 TIM_Pulse 实现范围 0 到 99对应 0% 到 99%。参数怎么改想要更高频率就减小 Period想要更低就加大 Prescaler但两者乘积别超过 65535否则要换 16 位以上的定时器。3.2 红外循迹中断读电平加状态判断循迹的核心逻辑不复杂两个红外传感器一共四种组合对应直行、左偏、右偏、停车或原地找线。用外部中断读电平的好处是不用轮询主循环能腾出来处理超声波。但中断里不要做耗时操作只置标志位判断放到主循环。volatile uint8_t track_state 0; // 外部中断服务函数PA0 和 PA1 各触发一次 void EXTI0_IRQHandler(void) { if (EXTI_GetITStatus(EXTI_Line0) ! RESET) { // 读两个红外电平组合成状态 uint8_t l GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0); uint8_t r GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_1); track_state (l 1) | r; // 00/01/10/11 四种 EXTI_ClearITPendingBit(EXTI_Line0); } } // 主循环里的循迹决策 void Track_Decide(void) { switch (track_state) { case 0x00: Motor_Forward(60); break; // 都在白底直行 case 0x01: Motor_TurnRight(50); break; // 右侧压线右转 case 0x02: Motor_TurnLeft(50); break; // 左侧压线左转 case 0x03: Motor_Stop(); break; // 都在黑线停车 } }逻辑说明track_state 用位运算把两个 IO 合成一个数switch 分支清晰。Motor_Forward 这类函数内部就是设置方向脚电平加改 PWM 占空比。参数说明60 和 50 是占空比百分比实际要按你的马达和地面摩擦调地面滑就加大转弯半径小就减小。注意中断里读电平前最好加几微秒延时去抖否则过黑线瞬间会抖出错误状态。3.3 超声波避障输入捕获测距与优先级处理超声波测距有两种写法一种是阻塞式发完 Trig 用 while 等 Echo 变高再变低简单但会卡住主循环另一种是输入捕获定时器自动记录上升沿和下降沿不占 CPU。这套方案建议用输入捕获因为循迹本身也在跑阻塞式会让小车在测距那几十毫秒里失明。volatile uint16_t echo_start 0, echo_end 0; volatile uint8_t echo_done 0; // TIM3 输入捕获中断 void TIM3_IRQHandler(void) { if (TIM_GetITStatus(TIM3, TIM_IT_CC1) ! RESET) { if (GPIO_ReadInputDataBit(GPIOB, GPIO_Pin_1)) { echo_start TIM_GetCapture1(TIM3); // 上升沿 } else { echo_end TIM_GetCapture1(TIM3); // 下降沿 echo_done 1; } TIM_ClearITPendingBit(TIM3, TIM_IT_CC1); } } // 距离换算定时器计数频率 1MHz 时 1 计数等于 1 微秒 float Get_Distance(void) { if (!echo_done) return 999.0f; // 没测到返回一个大值 uint16_t diff (echo_end echo_start) ? (echo_end - echo_start) : (65535 - echo_start echo_end); echo_done 0; return diff / 58.0f; // 微秒转厘米 }逻辑说明输入捕获在上升沿记下计数值下降沿再记一次差值就是高电平持续时间。定时器计数频率设成 1MHz 时一个计数就是一微秒除以 58 直接得厘米。参数说明如果定时器频率不是 1MHz换算系数要跟着变公式是距离等于时间乘以声速除以二。避障优先级要高于循迹主循环里先判断距离小于 20 厘米就强制转向再走循迹逻辑否则小车会贴着障碍物继续巡线。4. 调试避坑那些让小车原地打转的常见问题4.1 现象马达不转或只往一个方向转原因方向控制脚电平组合不对或者使能脚 PWM 没输出。L298N 的 IN1 和 IN2 必须一个高一个低才能正转两个都高是刹车两个都低是滑行。PWM 没输出常见于高级定时器忘了调 TIM_CtrlPWMOutputsTIM1 和 TIM8 这类高级定时器必须显式开启输出普通定时器不用。解决先用万用表量 IN1 到 IN4 的电平确认方向逻辑再量 ENA 脚有没有 PWM 波形没有就回去查 TIM_CtrlPWMOutputs 有没有调用。我一般会在初始化后先让马达正转两秒再反转两秒作为上电自检。4.2 现象循迹时小车在黑白交界处疯狂抖动原因红外模块阈值电位器没调好输出电平在临界点附近来回跳。或者中断去抖没做过线瞬间触发多次。解决把小车放在黑线上调电位器直到模块指示灯刚好亮再放到白底确认灯灭。软件上加 5 到 10 微秒延时去抖或者连续读三次电平一致才认。地面反光强的话红外对管离地高度也要调一般 1 到 2 厘米比较稳。4.3 现象超声波读数忽大忽小避障误触发原因超声波模块供电不稳或者 Trig 触发间隔太短。HC-SR04 两次测距之间至少要隔 60 毫秒否则上一次的回波还没消散下一次就发出去了读出来的数是乱的。解决在两次测距之间加延时或者用定时器周期触发。供电上给超声波模块单独加一个 100 微法左右的滤波电容能明显改善读数稳定性。另外 Echo 脚是 5 伏电平STM32 的 IO 是 3.3 伏耐受长期直连有风险常见做法是串一个电阻分压或者用电平转换。4.4 现象小车跑起来后程序跑飞或复位原因马达启动瞬间电流大电池电压被拉低导致 MCU 欠压复位。或者马达的换向火花通过电源线串扰进 MCU。解决马达供电和 MCU 供电分开走或者在马达电源两端并一个大电容储能。电机线尽量远离信号线实在避不开就双绞。程序里可以开独立看门狗跑飞了自动复位但调试阶段先关掉不然单步调试会被反复复位打断。4.5 现象PWM 占空比改了但车速没变化原因改的是 TIM_Pulse 但没重新使能输出或者改的定时器通道和实际接线的通道对不上。还有一种情况是占空比已经到 100%再往上加也没用。解决确认改的是对应通道的捕获比较寄存器改完不需要重新初始化硬件会自动生效。用示波器或者逻辑分析仪看一眼 PWM 脚的实际波形比盲猜快得多。没有仪器的话接一个 LED 加电阻看亮度变化也能判断。5. 进阶调优把循迹从能跑推到跑得顺5.1 用 PID 替代开关式循迹前面那套 switch 逻辑属于开关式控制结构简单但过弯会一顿一顿。想让小车走得顺可以上比例控制甚至比例积分微分控制。思路是把红外传感器的偏差量化成误差值比如两个红外都压线时误差为零只有左边压线时误差为负只有右边压线时误差为正然后输出等于比例系数乘以误差。// 简化比例控制error 范围 -1 到 1 float Kp 40.0f; // 比例系数先从小往大调 float base_speed 55.0f; // 基础占空比 void Track_PID(void) { float error 0.0f; uint8_t l GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0); uint8_t r GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_1); if (l !r) error -1.0f; // 偏左 else if (!l r) error 1.0f; // 偏右 else error 0.0f; // 居中或都压线 float adjust Kp * error; int left (int)(base_speed - adjust); int right (int)(base_speed adjust); // 限幅防止占空比越界 if (left 0) left 0; if (left 99) left 99; if (right 0) right 0; if (right 99) right 99; Motor_SetLeft(left); Motor_SetRight(right); }逻辑说明误差为正表示车偏右需要左轮加速右轮减速把车头拉回来所以左轮占空比是基础值减调整量、右轮是加。参数说明Kp 从 20 开始试车抖就减小车反应迟钝就加大。base_speed 决定整体车速太快过弯会冲出去建议先调 Kp 再调 base_speed。这套比例控制已经比开关式顺很多如果还想要更稳可以加微分项抑制超调但积分项在循迹里一般不用容易累积误差。5.2 用串口把关键数据打出来调车最痛苦的是不知道车看到了什么。我的习惯是开一路串口把红外状态、超声波距离、当前占空比按固定格式打出来用串口助手看。这样阈值调没调对、避障有没有误触发一眼就能看出来比盯着车猜快得多。// 每 100ms 打印一次调试信息 void Debug_Print(void) { printf(IR:%d%d DIST:%.1fcm L:%d R:%d\r\n, GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0), GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_1), Get_Distance(), current_left_pwm, current_right_pwm); }逻辑说明printf 要重定向到串口标准库需要实现 fputc。参数说明打印频率别太高100ms 一次够用太快会占满串口带宽还影响主循环。current_left_pwm 这类变量要在设置占空比的地方同步更新否则打出来的是旧值。5.3 电池电压监测不能省锂电池从满电 8.4 伏放到 6 伏出头马达力矩会明显下降循迹表现跟着变差。加一路 ADC 监测电池电压低于阈值就减速或者报警能避免上午调好的参数下午就不好使这种血泪经验。分压电阻选两个 10k 串联中点接 ADC 脚换算时乘二再乘参考电压。从那以后我每次调车都强制走一遍流程先上电自检看马达转向再看串口数据确认传感器读数正常最后才放地上跑。这套顺序能挡掉八成低级问题省下的时间够你多调两轮参数。希望帮到你。本文还有配套的精品资源点击获取