STM32智能小车制作全攻略：八大功能模块实现与源码解析

简介本资源是一套基于STM32平台的多功能智能小车完整开发套件面向嵌入式初学者、课程设计学生及电子竞赛备赛者系统解决循迹、跟随、避障、测速、蓝牙遥控、Wi-Fi通信、4G远程控制与语音识别等八大核心功能的软硬件协同实现问题。压缩包含2000个文件总计75.35MB其中C/H源码文件共1214个含HAL库驱动与应用逻辑编译中间文件.o/.d/.crf/.axf等超千个另有CubeMX配置文件.ioc/.mxproject、Keil工程文件.uvprojx/.uvoptx、链接脚本.sct及说明文档.md/.txt代码全程采用HAL库开发注释详尽结构清晰支持向标准库移植。目前已有2775人学习下载配套博文详细解析各模块原理与调试要点可直接用于课程实践、毕业设计或创新项目快速原型开发。 “造一辆能跑、能看、能听、能联网的STM32小车”这件事我前前后后折腾了两个多月从一块裸板到所有功能稳定跑通中间踩坑无数。这篇总结我把循迹、跟随、避障、测速、蓝牙、WiFi、4G、语音识别这八块功能的实现思路、硬件选型、代码框架、问题排查全部整理出来源码和硬件清单都在文内给准备做类似项目的朋友一个完整的参考。做这个项目的初衷其实很简单手里有一块吃灰的STM32F103C8T6最小系统板想把它利用起来。但只点亮LED没什么意思于是决定直接上一台功能尽可能全的小车——把常见的传感器、通信模块、执行机构都集成到一起。这样做的好处是一台车就把单片机最常见的外设接口GPIO、定时器、ADC、USART、I2C、PWM全部实践了一遍学完这台车基本就能独立做大部分嵌入式项目了。无论你是刚学完STM32基础外设的在校学生还是想拿一个完整项目练手的开发者这篇文章都能让你少走不少弯路。我不会只贴代码会把每个模块为什么这么选、接线怎么设计、代码结构怎么组织、实际调试遇到过什么问题都讲清楚。1. 整体设计与方案选型1.1 为什么选STM32F103C8T6作为主控主控选择STM32F103C8T6也就是大家常说的“蓝 pills”核心板。这颗芯片虽然是入门级型号但72MHz主频、64KB Flash、20KB SRAM的资源跑小车这种中低复杂度项目绰绰有余。更重要的是它的外设资源分配非常合适多个定时器可以同时处理PWM输出和编码器测速3路USART刚好够蓝牙、WiFi、语音模块分线使用配合软件模拟串口还能再扩展10路ADC通道可以接多个红外传感器。综合下来这颗芯片的性价比极高坏了换一块也就几块钱适合反复折腾。对比过一些人的方案用ESP32做主控我也认同ESP32自带WiFi蓝牙更方便但如果想系统学习STM32的寄存器操作和中断机制F103还是更经典的选择。而且后期把WiFi功能做成外挂模块反而更灵活——想用ESP8266就用ESP8266想换4G模块就换4G模块主控完全不受影响。1.2 八大功能模块的选型思路功能模块的选型逻辑是能用现成模块解决的绝不自己搭电路模块之间尽量用标准接口UART、GPIO、I2C连接减少调试难度。循迹采用4路红外对管模块TCRT5000比2路在十字路口和S弯的判断上更从容价格也非常便宜。跟随采用HC-SR04超声波模块测距原理简单代码实现方便作为跟随测距传感器比红外测距稳定得多不受环境光干扰。避障同样是超声波 一个舵机云台做180度扫描。这是最经典的低成本避障方案比单纯靠红外避障可靠能提前感知障碍物距离。测速采用带霍尔编码器的直流减速电机常见的是MG310或GA12-N20。两个电机各带一个编码器通过定时器计数脉冲计算实时速度和里程。蓝牙HC-05主从一体模块。这是最普及的蓝牙串口模块手机端APP用现成的“蓝牙串口”就能连接适合快速验证。WiFiESP8266-01S模块通过AT指令控制成本不到10元可以让小车接入局域网后续也能做MQTT远程控制。4GEC200S或Air724UG模块同样是串口AT指令通信。这个模块是后面为了验证“脱离局域网也能远程控制”而加的成本略高但确实能让小车变身真正的物联网终端。语音识别LD3320离线语音识别模块支持自定义命令词不需要联网识别准确率在安静的室内环境下可以达到90%以上。如果预算充足也可以换成SU-03T离线或讯飞在线识别方案。1.3 底盘结构与电机驱动设计底盘我直接买的是3.3元包邮的亚克力三轮车架前轮万向轮、后轮双电机驱动。这种底盘便宜、结实、改装空间大而且两轮差速转向的实现逻辑最简单。驱动部分用的是L298N模块虽然它的压降大、发热明显但胜在皮实、用过的人多、资料丰富。对于入门项目来说完全够用。如果想让小车跑得更快更顺滑可以换TB6612FNG驱动模块它的MOS管压降小、体积小、效率高而且可以直接用单片机的PWM做速度控制不需要额外的使能跳线帽。供电方案是很多新手容易翻车的地方。我最终的方案是8节5号充电电池约9.6V给L298N供电L298N板载5V输出给STM32和传感器供电另外单独用一个AMS1117-3.3模块给ESP8266和LD3320供电。为什么要单独供电3.3V因为ESP8266工作时电流峰值能到300mA甚至更高如果直接从STM32板载的3.3V引脚取电会把主控的LDO拖垮导致频繁复位。2. 硬件清单、接线设计与电源系统2.1 完整硬件清单下面是这台车完整的硬件清单所有模块都能在电商平台直接买到总成本大概在300-400元之间4G模块不含流量卡费用。模块型号/规格数量备注主控板STM32F103C8T6最小系统板1蓝 pills 或兼容板电机驱动L298N 模块1或 TB6612FNG直流减速电机带霍尔编码器GA12-N202带测速码盘小车底盘3轮亚克力车架1万向轮双后驱电池5号镍氢充电电池8节总压约9.6V循迹模块TCRT5000 4路红外1或 5路超声波模块HC-SR041测距舵机云台SG90 舵机1超声波左右扫描蓝牙模块HC-051主从一体WiFi模块ESP8266-01S1需要转接板4G模块EC200S-A 或 Air724UG1可选语音识别LD3320 模块1离线识别降压模块AMS1117-3.31WiFi/语音供电杜邦线公对公/公对母若干建议多备面包板400孔1扩展接线用2.2 电源分配系统设计电源是整个项目最容易出问题的地方我在这里烧过一个STM32板子也经历过无数次复位所以单独拿出来说。L298N模块上有一个5V输出引脚这个引脚在电机不转时大概能输出稳定的5V但当电机启动瞬间电流冲击会让这个5V跌到4.5V甚至更低导致STM32复位。解决方法是在L298N的5V输出端和STM32的5V引脚之间串一个1N5819肖特基二极管正向压降仅0.2V同时并联一个470uF电解电容和104陶瓷电容做储能和滤波。ESP8266和LD3320的供电从AMS1117-3.3模块单独取输入端接电池电压9.6V输出端接模块的3.3V引脚。注意ESP8266的使能引脚EN/CH_PD必须接一个10K电阻上拉到3.3V否则模块不会工作这个问题我排查了很久。L298N的逻辑电源5V和驱动电源9.6V必须共地否则PWM信号无法形成回路电机会不受控制。所有模块的GND最终都要汇到一起这是接线时最容易漏掉的一步。2.3 传感器布局与安装位置传感器布局直接影响功能的稳定性和调试难度分享几个实测下来的布局经验。循迹模块安装在小车前方底部距离地面2-3cm最合适。太近会被地面不平干扰太远红外反射信号会衰减。4路传感器的间距建议和赛道的黑线宽度匹配我用的赛道是2cm宽的黑胶带4路传感器均匀分布在10cm宽度的支架上中间两路刚好覆盖黑线区域两边两路覆盖到白色地面。超声波模块接在SG90舵机上舵机安装在小车正前方高度约8-10cm。这个高度能让超声波波束中心基本对准障碍物的中部避免波束打到地面或天花板造成误判。注意舵机臂和超声波模块之间要用热熔胶固定否则车辆震动会导致角度漂移避障算法就会乱套。LD3320语音模块的麦克风要尽量避开电机和驱动模块的散热片最好加一个海绵防喷罩。电机转动时的电磁干扰会让识别率直线下降实测在电机转动时识别率从90%降到60%左右。如果条件允许给电机并联104陶瓷电容和电感做EMI抑制会有明显改善。3. 各功能模块的实现细节与代码框架3.1 循迹模块从电压比较到边界判断循迹的原理不复杂——TCRT5000红外对管发射红外光黑色表面吸收红外光反射少白色表面反射红外光反射多。模块上的电位器可以调节灵敏度阈值输出的是数字电平检测到黑线输出高电平或低电平取决于模块型号检测到白底输出相反电平。代码层面的核心是“差速转向”。当小车偏离黑线时通过对两侧电机速度的调整让小车回到黑线上。我用的策略是中间两路都检测到黑线 - 直行左右电机同速左偏左侧两路检测到黑线 - 左轮减速、右轮加速向右修正右偏右侧两路检测到黑线 - 右轮减速、左轮加速向左修正四路全白 - 保持上一个状态防止在路口丢线时失控关键代码示例如下使用HAL库// 4路循迹传感器读取假设检测到黑线输出0 uint8_t track_value 0; track_value | (HAL_GPIO_ReadPin(TRACK1_GPIO_Port, TRACK1_Pin) GPIO_PIN_RESET) ? 0x01 : 0; track_value | (HAL_GPIO_ReadPin(TRACK2_GPIO_Port, TRACK2_Pin) GPIO_PIN_RESET) ? 0x02 : 0; track_value | (HAL_GPIO_ReadPin(TRACK3_GPIO_Port, TRACK3_Pin) GPIO_PIN_RESET) ? 0x04 : 0; track_value | (HAL_GPIO_ReadPin(TRACK4_GPIO_Port, TRACK4_Pin) GPIO_PIN_RESET) ? 0x08 : 0; switch(track_value) { case 0x06: // 中间两路在黑线上 set_motor_speed(LEFT_MOTOR, 150, FORWARD); set_motor_speed(RIGHT_MOTOR, 150, FORWARD); break; case 0x02: case 0x03: // 偏向左侧 set_motor_speed(LEFT_MOTOR, 110, FORWARD); set_motor_speed(RIGHT_MOTOR, 170, FORWARD); break; case 0x04: case 0x0C: // 偏向右侧 set_motor_speed(LEFT_MOTOR, 170, FORWARD); set_motor_speed(RIGHT_MOTOR, 110, FORWARD); break; case 0x0F: case 0x00: // 全黑或全白保持 // 保持上一次的速度设置 break; default: break; }这里有个细节为什么中间两路都检测到黑线时还要区分是0x06而不是0x0A即第2路和第4路因为传感器的物理布局决定了第1-2路偏左、第3-4路偏右不能只看二进制值要结合实际安装顺序定义枚举。3.2 跟随模块超声波测距与PID调速跟随功能要求小车和前方目标保持一个固定距离比如20cm距离大了加速追上去距离小了减速甚至倒退。如果只是简单用“太远加速、太近减速”的开关量控制小车会来回震荡体验非常差。这里我用了比例控制P控制而非完整PID因为跟随场景下积分和微分作用不明显反而会带来超调。超声波测距的原理是发射40kHz的超声波脉冲接收信号后计算往返时间距离 时间 × 声速 / 2。代码中需要注意温度补偿声速约为331.4 0.6 × Tm/s在25℃室温下约346m/s。如果不补偿1米距离误差约3cm对跟随来说可以接受但追求精确可以加一个温度传感器。测距代码// 发送10us高电平触发脉冲 HAL_GPIO_WritePin(TRIG_GPIO_Port, TRIG_Pin, GPIO_PIN_SET); delay_us(10); HAL_GPIO_WritePin(TRIG_GPIO_Port, TRIG_Pin, GPIO_PIN_RESET); // 等待ECHO引脚拉高记录高电平持续时间 while(HAL_GPIO_ReadPin(ECHO_GPIO_Port, ECHO_Pin) GPIO_PIN_RESET); timer_start(); while(HAL_GPIO_ReadPin(ECHO_GPIO_Port, ECHO_Pin) GPIO_PIN_SET); duration timer_stop(); // 距离cm 时间us / 58 distance_cm duration / 58.0f;为什么除以58因为声速346m/s换算成us往返距离d v × t / 2 0.0346cm/us × t / 2 t / 57.8 ≈ t / 58。控制部分就是最简单的P控制int error target_distance - current_distance; int speed_adjust KP * error; // KP 实测取 2.5 左右 int base_speed 130; int left_speed base_speed - speed_adjust; int right_speed base_speed speed_adjust;注意跟随模式下两个电机方向要相反吗不需要跟随是前后运动两个电机同向只是速度不同来微调方向。如果误差值过大比如目标丢失要设置一个超时值让小车停下来避免一直往前冲。3.3 避障模块状态机设计与舵机云台避障功能是这八个模块里逻辑最复杂的我用了状态机来实现。状态机的好处是逻辑清晰、容易调试、不易出bug。状态包括前进、左转、右转、后退、扫描、停止。逻辑是这样默认前进超声波每隔50ms测一次前方距离。如果前方距离小于30cm进入扫描状态。扫描状态舵机转到左90度测左侧距离舵机转到右-90度测右侧距离舵机回正0度。比较左右距离哪边远就往哪边转。如果左右都小于20cm后退并原地掉头。舵机控制用的是50Hz的PWM信号0度对应0.5ms高电平90度对应1.5ms高电平180度对应2.5ms高电平。在STM32上可以通过定时器输出比较功能精确控制// 舵机控制TIM2_CH150Hz PWMarr1999CCR高电平时间/1us void servo_set_angle(int angle) { // 0度 - 0.5ms - CCR500 // 90度 - 1.5ms - CCR1500 // 180度 - 2.5ms - CCR2500 uint32_t ccr 500 (uint32_t)(angle * 2000 / 180); __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, ccr); }这里有个容易踩的坑舵机PWM周期必须是20ms50Hz不能像电机驱动那样用10kHz以上的PWM。如果频率不对舵机会发出嗡嗡声或者剧烈抖动因为舵机内部的电路是根据脉宽来定位的频率只是载体。超声波放在舵机上扫描时要注意给舵机一个稳定时间。舵机转到目标角度后要等待300ms以上再测距否则超声波还在晃动测出来的距离会忽远忽近。3.4 测速模块编码器与定时器计数直流减速电机的霍尔编码器GA12-N20通常输出A、B两路正交脉冲。通过读取脉冲数可以计算电机转速通过比较A和B的相位关系可以判断转动方向。STM32的定时器有编码器模式可以硬件处理正交解码不需要占用CPU中断去计数。我用TIM3的通道1和通道2接左电机编码器的A、B相TIM4接右电机编码器。初始化如下TIM_Encoder_InitTypeDef enc_config; enc_config.EncoderMode TIM_ENCODERMODE_TI12; // 双沿计数4倍频 enc_config.IC1Polarity TIM_ICPOLARITY_RISING; enc_config.IC2Polarity TIM_ICPOLARITY_RISING; enc_config.IC1Selection TIM_ICSELECTION_DIRECTTI; enc_config.IC2Selection TIM_ICSELECTION_DIRECTTI; enc_config.IC1Prescaler 0; enc_config.IC2Prescaler 0; enc_config.IC1Filter 10; enc_config.IC2Filter 10; HAL_TIM_Encoder_Start(htim3, TIM_CHANNEL_ALL);读取当前计数值直接访问寄存器int16_t encoder_count (int16_t)TIM3-CNT; // 计数值可以是负的表示反转换算成实际速度需要知道几个参数电机减速比GA12-N20常见是1:30或1:120、编码器线数一般每圈输出13个脉冲、轮子直径65mm。公式轮子周长 PI * 65mm 204.2mm 电机输出轴每转编码器脉冲数 13 * 减速比比如1:30就是390 轮子每转一圈编码器脉冲数 390 * 44倍频 1560 速度(mm/s) 脉冲数/秒 / 1560 * 204.2在小车控制中速度环用PID控制。我实际用的是PD控制去掉积分因为积分的滞后会让小车启动时容易超调int pid_speed_control(int target_speed, int current_speed) { static int last_error 0; int error target_speed - current_speed; int output KP * error KD * (error - last_error); last_error error; return output; }测速数据还可以用来做里程统计显示在小屏幕上或者配合蓝牙/WiFi把实时速度上传到手机/电脑监控非常直观。3.5 蓝牙模块HC-05配对与透传协议HC-05默认是AT模式可以通过按键/引脚进入波特率38400通信模式透传波特率默认9600。所谓透传就是蓝牙连接建立后你发送什么数据模块就原样转发给单片机单片机发什么数据模块就发给手机端。模块初始化和配置按住HC-05上的按键上电进入AT模式板上LED慢闪。串口助手连接发送AT收到OK表示进入AT模式。设置名称ATNAMECar设置配对码ATPSWD1234设置匹配模式ATROLE1主模式或ATROLE0从模式一般手机连接小车用从模式即可。设置通信波特率ATUART115200,0,0重新上电进入通信模式。代码端就是标准的USART2中断接收。我设计了一个简单的协议用来区分指令类型头部(0xAA) 功能码(1字节) 数据(1字节) 校验(1字节) 尾部(0x55)例前进 AA 01 64 C9 5501是前进64是速度100C9是0x010x64的校验和。蓝牙调试的小技巧如果手机搜不到HC-05大概率是模块没有进入可配对状态未上电时按住按键上电。如果连上了但发数据单片机没反应先检查波特率是否一致很多HC-05默认是9600我改了115200再检查是否共地。3.6 WiFi模块ESP8266-01S与AT指令框架ESP8266作为WiFi模块用AT指令控制。我需要做的是让小车连接家庭路由器然后通过手机APP或电脑上位机通过局域网发UDP/TCP控制指令。几个常用的AT指令ATCWMODE1 // 设置Station模式 ATCWJAPssid,password // 连接WiFi ATCIPSTARTUDP,192.168.1.100,8080 // 建立UDP连接 ATCIPSEND5 // 发送5字节数据 ATCIPCLOSE // 关闭连接注意ESP8266-01S只有2个GPIO可用GPIO0和GPIO2RXD/TXD用来与STM32通信用所以它只能当纯粹的WiFi透传模块用不能同时控制其他东西。另外ESP8266-01S的供电要求较高上电瞬间电流可能到400mA必须用外部3.3V电源不能用STM32板载LDO。代码上串口1分配给了调试信息输出串口2给蓝牙串口3软件模拟给ESP8266串口4硬件USART3给4G模块和语音识别共用。WiFi接收的数据处理和蓝牙共用一套协议解析函数这样可以保持代码统一。用ESP8266做一个简单的网页控制端可以让任何手机浏览器直接控制小车不需要装APP。ESP8266工作在SoftAP模式ATCWMODE2手机连接它创建的WiFi热点然后访问192.168.4.1通过HTTP GET请求控制。虽然这个方案不适合大范围部署但非常适合演示。3.7 4G模块EC200S与远程物联网控制加了4G模块之后小车的“远程控制”就不再局限于局域网了。无论小车在哪个城市只要插了SIM卡有流量配合服务器中转就能在手机端随时控制。EC200S模块通过串口和STM32通信AT指令格式和ESP8266类似但指令集不同。典型操作ATCGDCONT1,IP,cmnet // 定义PDP上下文 ATCGACT1,1 // 激活PDP ATCSTTcmnet,, // 设置APN ATCIICR // 连接网络 ATCIFSR // 获取IP地址 ATCIPSTARTTCP,120.25.100.200,8080 // 连接TCP服务器 ATCIPSEND5 // 发送数据4G模块的调试难度比WiFi高得多因为它的AT指令执行有延迟需要处理各种错误码。我的做法是写了一个AT指令发送和超时重试的框架uint8_t send_at_cmd(const char* cmd, const char* expected_resp, uint32_t timeout_ms) { uint8_t rx_buffer[256]; uint16_t rx_len 0; HAL_UART_Transmit(huart3, (uint8_t*)cmd, strlen(cmd), 1000); uint32_t start HAL_GetTick(); while(HAL_GetTick() - start timeout_ms) { if (HAL_UART_Receive(huart3, rx_buffer rx_len, 1, 100) HAL_OK) { rx_len; if (rx_len 250) break; if (strstr((char*)rx_buffer, expected_resp) ! NULL) { return 1; // 成功 } } } return 0; // 超时或未收到期望应答 }4G模块上电后需要几秒钟时间注册网络不能立刻AT最好等待10秒以上再初始化。模块工作电流较大瞬间可以到2A电源设计上必须用独立的降压模块比如MP1584或LM2596不能和主控共用同一路电源。4G作为选配功能如果只是学习用可以先不加但加上了之后整个项目的档次和可玩性都会提升一个级别——比如能通过服务器远程给小车下发路径指令实现“人在工位车在实验室”的效果。3.8 语音识别模块LD3320命令词自定义LD3320语音识别模块内置了语音识别引擎不需要联网也不需要训练模型只需要通过串口配置要识别的命令词列表然后模块就会持续监听麦克风输入识别到对应的命令词后通过串口或GPIO告诉MCU。模块的使用有几个关键点命令词列表在代码里通过特定格式写入例如// 设置识别命令词以拼音或不带声调的方式写入 uint8_t cmd_buf[] { 0x01, q, i, a, n, j, i, n, 0x00, // 前进 0x02, h, o, u, t, u, i, 0x00, // 后退 0x03, z, u, o, z, h, u, a, n, 0x00, // 左转 0x04, y, o, u, z, h, u, a, n, 0x00, // 右转 0x05, t, i, n, g, z, h, i, 0x00, // 停止 };每次识别完成后模块会返回结果索引1、2、3、4、5需要在中断里及时读取避免下一次识别覆盖掉上一次的结果。识别过程中模块的LED会有状态提示监听中、识别中、识别完成调试时注意观察。实际体验发现LD3320对环境安静程度要求较高。在正常的办公室环境下它的识别率还可以接受但如果旁边有人说话或者电机在转识别率会明显下降。我后来把识别词改短比如“前进”改成“走”识别率有所回升。另外语音模块和蓝牙共用USART3时要注意数据冲突建议用不同的命令前缀区分或者通过一个GPIO引脚做硬件切换。4. 核心代码框架与关键源码4.1 主循环与状态机架构整个小车程序不是把八个功能一锅乱炖而是用了一个统一的“功能模式 状态机”架构。每次上电后通过蓝牙或串口选择运行模式循迹模式、跟随模式、避障模式、语音控制模式、远程控制模式。不同模式下主循环执行不同的逻辑。伪代码如下int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_USART1_UART_Init(); // 调试串口 MX_USART2_UART_Init(); // 蓝牙 MX_USART3_UART_Init(); // 4G/语音 MX_TIM2_Init(); // 舵机PWM MX_TIM3_Encoder_Init();// 左编码器 MX_TIM4_Encoder_Init();// 右编码器 MX_ADC1_Init(); // 电池电压检测可选 ble_init(); servo_set_angle(90); // 舵机回正 HAL_Delay(500); uint8_t mode 0; // 0停止, 1循迹, 2跟随, 3避障, 4语音 while(1) { // 从蓝牙/WiFi/4G/语音接收模式切换指令 mode get_control_mode(); switch(mode) { case 1: track_line(); break; // 循迹 case 2: follow_target(); break; // 跟随 case 3: avoid_obstacle(); break; // 避障 case 4: voice_control(); break; // 语音控制 default: stop_car(); break; } // 心跳函数每50ms更新一次实时测速数据并上报 if (HAL_GetTick() - last_report 50) { report_speed_via_ble(); last_report HAL_GetTick(); } } }这种架构的好处是功能解耦每个模式一个函数互不干扰新增功能只需要添加一个case和一个函数。实际开发时我还为每个模式写了独立的调试打印和指示灯指示方便定位问题。4.2 电机PWM控制封装写一个统一的电机控制函数可以减少代码重复。我封装了左右电机的方向、速度控制void set_motor_speed(uint8_t motor, int speed, uint8_t direction) { // speed: 0~255 // motor: LEFT_MOTOR 或 RIGHT_MOTOR // direction: FORWARD 或 BACKWARD if (motor LEFT_MOTOR) { if (direction FORWARD) { HAL_GPIO_WritePin(IN1_GPIO_Port, IN1_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(IN2_GPIO_Port, IN2_Pin, GPIO_PIN_RESET); } else { HAL_GPIO_WritePin(IN1_GPIO_Port, IN1_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(IN2_GPIO_Port, IN2_Pin, GPIO_PIN_SET); } __HAL_TIM_SET_COMPARE(htim1, TIM_CHANNEL_1, speed); // PWM调速 } else { // 右电机逻辑类似IN3、IN4 TIM1_CH2 } }这里有一点容易出错L298N的ENA和ENB引脚如果接的是跳线帽PWM调速无效因为ENA/ENB被直接拉高为100%使能了。必须拔掉跳线帽把ENA接到STM32的PWM引脚上才能实现调速。如果发现调speed值但车速没变化优先检查这里。4.3 数据上报与调试通道调试是开发过程中最耗时的环节。我把USART1作为调试串口接USB转TTL连接电脑串口助手所有模块的状态信息都通过格式化字符串打印出来。比如循迹模式下的传感器状态、跟随模式下的距离值、测速模式下的实时速度等全部在30ms间隔内输出。自己在调试时就是靠这些打印信息定位问题的。有一次避障小车一直原地转圈打印信息显示左侧距离一直是0后来说是因为传感器需要时间稳定加了一个延时之后问题就解决了。如果还有这种怪问题打开串口看数据变化趋势比盲目改代码高效得多。5. 常见问题与排查技巧实录5.1 常见问题速查表现象可能原因排查方法/解决方案小车按键没反应主控板供电不足或程序没烧进去检查BOOT0跳线运行模式应为0重新烧录并确认串口输出电机不转L298N使能跳线帽没接PWM引脚配置错误检查ENA/ENB跳线帽用万用表测量IN1/IN2是否随代码变化蓝牙搜不到设备HC-05没进入可配对模式拔掉电源按住模块按键再上电直到LED慢闪蓝牙连上但发数据没反应波特率不匹配或未共地确认波特率配置一致检查HC-05和STM32是否共GNDWiFi连接不上ESP8266供电不足或AT指令语法错误单独用AMS1117-3.3供电串口助手逐条测试AT指令超声波测距一直为0ECHO引脚没有接对测距时序错误检查TRIG是否接对、测距间隔是否大于60ms舵机抖动PWM频率不是50Hz舵机供电不足确认TIM频率配置为50Hz舵机单独5V供电编码器读数为0编码器电源没接或A/B相接反检查编码器VCC/GND交换A/B相试试语音识别率低供电噪声大或命令词发音不标准扩大麦克风与电机距离调整命令词拼音4G模块AT无响应模块没完全启动或波特率不对等待10秒以上再发AT恢复默认波特率自动探测5.2 独立避坑经验非文档常见第一坑STM32最小系统板的3.3V LDO不能给ESP8266供电。我一开始图省事直接把ESP8266的VCC接到了STM32板载3.3V引脚结果模块偶尔能启动、偶尔不能而且一启动就导致主控屏闪。后来用万用表一测ESP8266高功耗时把3.3V拉低到2.8V直接让STM32跑飞。解决方案就是文前说的独立AMS1117-3.3模块。第二坑HC-SR04超声波测距必须在两次测距之间留出至少60ms间隔。超声波模块的硬件设计决定了它需要时间处理回声信号如果连续触发第二次测距数据会异常偏大或偏小。我加了50ms定时触发状态反而稳定了很多。第三坑循迹传感器的阈值调节不要在地毯上调。我一开始在办公室地毯上调试循迹模块灵敏度调得正好但小车上了光滑瓷砖地面之后完全失灵——黑色胶带在光滑地面的反射特性和在地毯上不一样。后来在真实比赛跑道上重新调节并把左右两边传感器的阈值微调后才解决问题。第四坑4G模块天线必须接好否则不仅连不上网还可能烧模块。EC200S模块对天线阻抗匹配要求很高我试过用普通杜邦线当天线模块虽然能启动但始终无法注册网络。换了标准天线后立即正常。如果天线接触不良网络不工作还是小事射频功率反射可能损坏功放电路。第五坑电池电压监测一定要做。镍氢电池放电到后期电压下降很快小车会出现“能跑但越跑越慢”的情况。我给ADC1加了分压电阻采集电池电压当低于7.2V时程序自动停止所有PWM输出并报警避免电池过放损坏。第六坑软件开发要学会“踢狗”。这在STM32上对应的是IWDG独立看门狗。如果程序某个模式进入死循环看门狗会在2秒内强制复位系统。我加了看门狗之后即使代码有未知问题小车最多卡2秒就会自己恢复不会一直保持失控状态。5.3 调参经验PID参数怎么试对于速度环和跟随环的PID我分享一个适合自己的调参流程先只保留P项从小到大加。观察小车是否震荡。如果震荡说明P过大了降到震荡值的一半留下约50%余量。加入D项消除超调。D的作用是“阻尼”在误差变化率为正时减少输出变化率为负时增加输出。D参数从P参数的1/10起步观察启动时的尖峰被抑制的程度。如果系统有稳态误差且响应太慢再考虑I项。但在小车速度环中因为存在摩擦力I项有时候反而会导致停车时抖动我最终选择不用I。这里的经验是参数不需要“精确最优”只需要让系统行为稳定可接受即可。很多新手盯着公式和仿真器反复调参其实实际测试才是最直接的——观察小车跑出来的状态比看曲线图更直观。6. 源码工程结构与后续扩展建议6.1 源码目录怎么组织我的工程是基于STM32CubeMX生成的HAL库工程代码目录结构如下Project/ ├── Core/ │ ├── Inc/ // 头文件 │ │ ├── main.h │ │ ├── motor.h │ │ ├── track.h │ │ ├── ultrasonic.h │ │ ├── encoder.h │ │ ├── ble.h │ │ ├── wifi.h │ │ ├── g4.h │ │ └── voice.h │ └── Src/ // 源文件 │ ├── main.c │ ├── motor.c │ ├── track.c │ ├── ultrasonic.c │ ├── encoder.c │ ├── ble.c │ ├── wifi.c │ ├── g4.c │ └── voice.c ├── Drivers/ │ ├── CMSIS/ │ └── STM32F1xx_HAL_Driver/ ├── Middlewares/ └── .ioc // CubeMX配置工程每个功能模块一个.c和.h文件接口统一。比如motor.h里暴露set_motor_speed、motor_init等接口track.c里封装track_line函数。这样调整单一模块时不需要翻动其他代码编译速度也更快。6.2 代码的移植性考虑移植性是小项目容易被忽略但很重要的一点。我在写代码时做了几件事所有引脚定义集中在头文件里用宏定义。换一块板子只需要改几行宏不用动逻辑代码。不依赖特定库版本只用HAL库标准接口。对每个模块都做了硬件抽象比如超声波测距函数返回距离值不关心底层是什么定时器。如果你拿到代码后需要移植到其他型号比如STM32F407或者G431只要把HAL库换成对应型号的库再调整一下引脚映射基本可以做到无缝迁移。6.3 后续扩展方向这台小车做到这里已经完成了“大而全”的目标。如果继续扩展我个人建议往这几个方向走加摄像头做视觉循迹或视觉避障。可以用OpenMV或者树莓派Zero通过串口和STM32通信。视觉方案能处理更复杂的环境比如识别红绿灯、箭头指示。加GPS模块做室外导航。4G通信和GPS定位结合起来小车就能变成一台简单的巡检机器人按预设坐标运行。加OLED屏幕显示状态信息。实时显示电量、速度、当前模式、WiFi连接状态非常实用。换成RTOSFreeRTOS管理多任务。目前主循环是顺序执行各个模块之间靠时间片轮转如果功能继续增多、实时性要求变高就得上RTOS。RTOS版本的代码我后续也会分享。7. 写在最后做这个项目的一些体会你真正开始做一台完整的小车之后会发现难点从来不是某个模块单独能不能工作而是所有模块怎么和谐共存。电源分配、串口冲突、中断优先级、时序配合这些才是真正耗时的地方。我自己最大的收获是养成了“模块化思维”——每个外设都当做一个独立组件定义好接口先单独验证再联调。这个思维模式在后来做更复杂的嵌入式项目包括工业设备、物联网网关时都帮了我大忙。另外一个很实在的建议调试时多做数据记录。别只靠眼睛看小车跑得好不好用串口把关键变量打印出来用Excel画个曲线往往能发现一些直觉上看不出来的问题。比如跟随小车为什么一直抖动把距离值和PWM输出值记录下来一看发现是传感器本身就有噪声P控制对噪声太敏感加一个简单的低通滤波就解决了。整个项目从零开始到完全跑通大概花了我六周的业余时间。如果你手上有现成的STM32开发板和小车底盘建议你按模块逐个做每做完一个功能就装上实车测试不要等全部写完再上电——那样如果出了问题排查范围会非常大。最后再分享一个调试技巧准备一个USB转TTL模块和两个串口调试助手一个接调试串口一个接蓝牙/4G这样可以同时看到单片机内部状态和模块返回的数据很多“数据对不上”的问题一眼就能看出来。代码工程和硬件清单我整理成了一个打包文件里面包含了完整的STM32CubeMX工程、所有源代码、接线图和使用说明。有需要的话可以直接拿去用有问题欢迎在评论区交流。本文还有配套的精品资源点击获取