简介一套完整的智能车辆设计源码包面向嵌入式/单片机方向的竞赛选手、毕设学生及智能车爱好者覆盖循迹、过路口修复、超声波避障、光强检测、NRF24L01无线通信、红绿识别与红外发射等核心功能。包内共55个文件包含17个C源文件、16个头文件、3个Markdown文档、3个批处理脚本、3个Keil工程构建文件以及Git配置与开源协议文件压缩包仅609KBC代码与头文件按模块拆分如HC_SR04、BH1750、NRF24L01、PWM、DHT11、LCD1602等方便对照学习与二次开发。已有355人学习浏览适合用来搭建完整的智能车控制原型或作为课程设计参考。除源码外还附带编译中间文件清理脚本、工程配置文件、循迹hex固件与一张设计效果图读者可借助这些材料快速验证模块逻辑、理解无线通信与避障联动机制从而缩短项目落地时间。1. 一台循迹小车为什么要把七个传感器拧成一股绳智能车设计里常见的方向是“一个传感器负责一个功能”但实践中你会发现真正难的不是让某个模块工作而是让循迹、避障、红绿识别这些能力在同一颗 MCU 上同时跑起来时不互相打架。这个标题给出的是一条完整的工程路径用循迹作为底层运动基准用路口修复处理十字线和丢线用超声波做近距避险用光强检测判断环境亮度并调节传感器阈值用 NRF24L01 做无线遥控和状态回传用红绿识别模拟交通规则最后用红外发射去联动外部设备。适合已经在玩 STM32、想从“单功能 demo”跨到“整车状态机”的人也适合要把这些代码复用到竞赛或课程设计里的场景。我针对标题展开的实现方案是以 STM32F103 为主控按“感知—决策—执行—回传”四层来组织代码。传感器数据不直接驱动电机而是统一进一个状态机由状态机决定直行、转弯、停车、绕行或者发射红外码。下面按传感器逐层拆解每一层都给出可直接下载到工程里的初始化代码、参数说明和避坑点。2. 循迹、过路口修复与红绿识别把“看路”做成分层信号2.1 为什么五路循迹是大多数智能车的首选方案标题里没有直接写“五路循迹”但“循迹 过路口修复”这两个词组合在一起基本就锁定了红外对管阵列。摄像头循迹、电磁循迹都在实际项目中存在但五路循迹传感器的优点是阈值简单、响应确定性高、移植成本低五路数字输出直接映射到 PWM 转向环不需要跑图像算法对 STM32F103 的 CPU 占用率几乎可以忽略。2.1.1 五路信号的语义比四路多一个“稳定态”四路循迹在直线上的状态是“中间两路压线”一旦车身略偏内侧一路出线控制器就要做较大修正。五路的中间三路都可以作为“直行有效区”左右各留一路做边界探测。这在过十字路口时有本质区别四路在十字路口大概率全丢而五路可以利用中间三路同时压线时的“全亮”状态判断正对路口而不是直接进入丢线处理。代码上五路循迹模块比如 TCRT5000 阵列通常输出数字信号直接接在 GPIO 上。读取函数很简单下面这段适用于任何 HAL 库工程// 假设五路依次接在 PD0-PD4 #define TRACK_PORT GPIOD uint8_t track_state_read(void) { uint8_t state 0; state | HAL_GPIO_ReadPin(TRACK_PORT, GPIO_PIN_0) ? 0x01 : 0; // 最左 state | HAL_GPIO_ReadPin(TRACK_PORT, GPIO_PIN_1) ? 0x02 : 0; // 左中 state | HAL_GPIO_ReadPin(TRACK_PORT, GPIO_PIN_2) ? 0x04 : 0; // 中间 state | HAL_GPIO_ReadPin(TRACK_PORT, GPIO_PIN_3) ? 0x08 : 0; // 右中 state | HAL_GPIO_ReadPin(TRACK_PORT, GPIO_PIN_4) ? 0x10 : 0; // 最右 return state; }这段代码把五路输出打包成一个 uint8_t方便用 switch 或者位掩码做状态判断。需要注意的是模块输出是“白线为 0 还是黑线为 0”取决于模块是输出高电平表示检测到反射还是低电平表示检测到反射不同厂家模块逻辑相反所以状态映射表要在实际赛道上标定后确定。2.2 过路口修复的核心逻辑丢线计数器与策略切换“过路口修复”本质上是在回答一个问题当五路循迹全部丢失时车到底遇到了什么可能是十字路口中间的黑线断开、可能是急弯甩出赛道、也可能是车身已经骑到线外。修复策略不能统一处理要用“丢线时长 丢线前的状态”来区分。2.2.1 短时全丢按“直行穿越”处理长时全丢按“掉线搜索”处理十字路口最常见的形态是入口处五路全亮压过路口中心后中间的黑线中断一小段五路突然全灭。如果这时候立即触发“原地掉头找线”逻辑车会在路口中心反复打转。更合理的做法是引入一个丢线计数器例如丢线时间小于 250ms 时保持上次的转向输出继续前进超过 250ms 才启用搜索模式。这个逻辑写成代码就是一个带时间阈值的状态判断uint8_t last_state 0; uint32_t lost_tick 0; uint8_t missed 0; void track_process(uint8_t curr_state, uint32_t tick_now) { if (curr_state 0) { missed 1; lost_tick tick_now; // 只记录首次全丢的时刻 // 注意这里要判断是首次进入全丢而不是每帧刷新 } if (missed (tick_now - lost_tick 250)) { // 进入搜索模式小角度左右摆动找线 search_mode_trigger(); } }这里有一个关键点250ms 是经验值与车速相关。车速 0.8m/s 时250ms 对应 0.2m 的行驶距离在十字路口宽度为 15cm 的前提下足够穿越断线区又不至于冲出赛道。如果你的场地十字路口很宽这个值要放大到 400~500ms。搜索模式的摆动角度也要控制建议 PWM 占空比在 20% 以内否则即使找到线也因为速度过冲再次冲出。2.2.2 单侧丢线不等于过路口不要触发修复五路循迹在转弯时经常出现“左边两路全丢、右边两路压线”的非对称状态这属于正常转向过程不是路口。很多初学者在写修复逻辑时只判断“全丢则修复”忽略了对单侧全丢的处理结果表现为小车在连续 S 弯里不断进入搜索模式速度上不去。判断方式是如果状态值最低位或最高位为 0且其余位非 0保持正常转向环输出。只有状态值为 0 是才允许进入修复流程。这个约束也解决了“五路循迹传感器的优点”里最重要的一个中间三路压线时的冗余判断不会因为单侧脱离触发误修复。2.3 红绿识别TCS3200 频率测量与“红停绿行”状态机红绿识别在智能车上有两个常见落地方式一是用带补光的 TCS3200 颜色传感器识别贴在地面的色卡二是用摄像头的色彩分割。标题没有指定型号在 STM32F103 裸机工程的约束下TCS3200 是最稳的选择废弃 OpenMV 是因为它会给整车代码引入 OS 依赖和内存压力。2.3.1 TCS3200 测频率的核心是“采样窗口内的脉冲计数”TCS3200 输出的频率取决于颜色通道红、绿、蓝、无滤波和光强。颜色通道由 S2、S3 两个引脚的电平组合控制频率缩放由 S0、S1 控制。常规接法是 S0、S1 接高电平100% 频率输出S2、S3 通过 GPIO 切换红绿通道输出的方波接到 STM32 的定时器输入捕获引脚。// 使用 TIM2_CH1PA0做输入捕获测量 50ms 内的脉冲数 // S2GPIOB0, S3GPIOB1 uint32_t tcs3200_read_freq(uint8_t color) { switch (color) { case RED: HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_RESET); // S20 HAL_GPIO_WritePin(GPIOB, GPIO_PIN_1, GPIO_PIN_RESET); // S30 break; case GREEN: HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET); // S21 HAL_GPIO_WritePin(GPIOB, GPIO_PIN_1, GPIO_PIN_SET); // S31 break; } // 延时等待传感器输出稳定 HAL_Delay(10); // 清零计数并开启捕获 __HAL_TIM_SET_COUNTER(htim2, 0); __HAL_TIM_ENABLE(htim2); HAL_Delay(50); __HAL_TIM_DISABLE(htim2); return __HAL_TIM_GET_COUNTER(htim2); }我在实际使用中会把 50ms 窗口内的计数换算成 Hz但比赛场景更常用的是比较两个颜色的计数比。红绿识别的阈值不应该固定因为环境光影响非常大——这正好和标题里“光强检测”形成配合光强低于某个值时识别阈值要整体压低或者干脆开启传感器自带的补光 LED。2.3.2 红绿状态与循迹状态机的优先级红绿识别的独立状态不应该直接控制电机而是作为循迹状态机的“门控信号”。整车状态机里我一般定义三级优先级超声波避障 红绿识别停车 循迹正常行驶。当检测到红色时无论循迹输出什么PWM 输出都被强制置零检测到绿色时恢复循迹输出。这个优先级设计解决了一个实际场面红色识别区恰好画在十字路口中央如果循迹的“过路口修复”优先于颜色识别车会以 250ms 穿越逻辑冲过红色区域识别到了但没停下来功能形同虚设。因此在中断或者主循环里颜色识别的停车标志位应该让循迹修复逻辑直接短路。3. 超声波避障、光强检测与红外发射响应与执行3.1 超声波避障的三级距离策略标题里的超声波避障和“循迹避障小车”这类热搜词通常默认用 HC-SR04。这个模块老但可靠测距范围 2cm~400cm精度 ±3mm对小车避障足够。关键是触发时序Trig 拉高 10us 以上然后等待 Echo 引脚的高电平脉宽脉宽时间除以 58 就是厘米数。// PA1 Trig, PA2 Echo // 使用轮询方式测量一次距离超时保护 30ms float ultrasonic_read(void) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_SET); delay_us(12); // 保证超过 10us HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_RESET); uint32_t timeout 0; while (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_2) GPIO_PIN_RESET) { if (timeout 3000) return -1; // 超时返回无效值 delay_us(1); } timeout 0; uint32_t counter 0; while (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_2) GPIO_PIN_SET) { if (timeout 30000) return -1; delay_us(1); counter; } return counter / 58.0f; // 单位 cm }三级距离策略的设定是距离大于 30cm 时循迹正常距离进入 15~30cm 区间时减速到 40% 同时保留循迹转向能力距离小于 15cm 时全停并原地旋转 90° 避开。第三级里有个常见问题原地旋转后车头方向变了如果前方仍然有障碍反复旋转会导致车在原地打转。我的做法是记录旋转方向下次避障时反向旋转。3.2 光强检测不只是“环境亮度显示”它参与传感器阈值修正光强检测在标题里容易被当成一个凑数的传感器但它在实际整车系统里承担的是“传感器自适应校准”的职责。循迹红外对管遇到强光环境时反射率会变化原本标定好的“压线0 出线1”状态可能全部翻转导致循迹崩溃。3.2.1 用光敏电阻 ADC 采样做阈值分段最简单的光强检测方式是光敏电阻加固定电阻分压接入 STM32 的 ADC 引脚。环境亮时 ADC 值高、暗时低或者相反取决于分压接法。读出来的数值直接映射到循迹传感器的采样阈值。// ADC1_IN1 PA1注意与超声波 Trig 复用 PA1 的冲突实际接线要错开 #define LIGHT_ADC_MAX 4095 #define LIGHT_ADC_MIN 300 uint16_t light_read(void) { HAL_ADC_Start(hadc1); HAL_ADC_PollForConversion(hadc1, 10); return HAL_ADC_GetValue(hadc1); } void track_threshold_adjust(uint16_t light_val) { // 环境越亮循迹阈值越要压低避免把反光误判为黑线 if (light_val 3000) { track_ref_threshold 0x1E; // 低阈值 } else if (light_val 1500) { track_ref_threshold 0x1C; } else { track_ref_threshold 0x1A; // 暗环境使用原始阈值 } }这段代码在 ADC 值较大的情况下降低循迹阈值具体数值依赖你的分压电阻选型。我更推荐在调试阶段用串口把光强 ADC 值和循迹状态同时打印出来如果发现强光下循迹频繁丢线优先检查的是 ADC 阈值映射关系而不是传感器本身。3.3 红外发射38kHz 调制与外部设备联动红外发射在这里不是遥控器解码而是把智能车当作一个发射源向外部设备发送指令典型场景是小车到达指定区域用红外发射管发送 38kHz 调制的 NEC 协议码控制闸门打开或者指示灯切换。STM32 上用定时器 PWM 输出 38kHz 载波再通过 GPIO 控制载波的通断来模拟 NEC 码的引导码和数据位。// TIM3 CH1 PB4 输出 38kHz PWM占空比 1/3 获得最佳发射距离 // OC (Output Compare) 控制引脚PD5 接红外发射管的三极管基极 void nec_send_byte(uint8_t data) { // 起始码: 9ms 载波 4.5ms 空闲 ir_carrier_on(); HAL_Delay(9); ir_carrier_off(); HAL_Delay(4); // 发送 8 位数据逻辑1560us载波1690us空闲逻辑0560us载波560us空闲 for (int i 0; i 8; i) { ir_carrier_on(); HAL_Delay_us(560); ir_carrier_off(); if (data 0x01) { HAL_Delay_us(1690); } else { HAL_Delay_us(560); } data 1; } }红外发射的坑大多在硬件放大GPIO 直推红外管距离很近需要三极管或者达林顿管驱动。软件层面的提示是NEC 协议发送时序要求不高HAL_Delay 的精度足够但如果你把红外发射逻辑放进定时器中断里注意中断优先级不要高于循迹和超声波采样否则会导致整车控制时序抖动。4. NRF24L01 无线通信遥控、回传与丢包处理4.1 NRF24L01 在 STM32 HAL 库下的 SPI 接线与初始化NRF24L01 无线通信模块是 2.4GHz 射频方案SPI 接口恰好标题里没有提蓝牙说明设计意图是低延迟、低功耗、一对多的数据通道。模块只用了两个额外控制引脚CE 和 CSN。CSN 接 SPI 片选CE 控制收发模式的切换。在 STM32F103 的 HAL 库工程里SPI 驱动 NRF24L01 的代码并不复杂网上常见的“江协 nrf24l01”教程大多也是基于寄存器。用 HAL 库实现时记得要关闭 SPI 硬件片选改由 GPIO 控制 CSN。// SPI1: SCKPA5, MISOPA6, MOSIPA7, CSNPA4, CEPB0 void nrf24l01_init(void) { // 确保 CE 和 CSN 先处于空闲态 HAL_GPIO_WritePin(NRF_CE_GPIO_Port, NRF_CE_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(NRF_CSN_GPIO_Port, NRF_CSN_Pin, GPIO_PIN_SET); // 写配置寄存器: 使能 CRC, 2字节 CRC, 上电, 接收模式 nrf24l01_write_reg(0x00, 0x0F); // EN_CRC1, CRCO1, PWR_UP1, PRIM_RX1 // 设置频道为 2400MHz 40 2440MHz nrf24l01_write_reg(0x05, 40); // 设置接收地址和发送地址相同 uint8_t rx_addr[5] {0xE7, 0xE7, 0xE7, 0xE7, 0xE7}; nrf24l01_write_buf(0x0A, rx_addr, 5); // RX_ADDR_P0 nrf24l01_write_buf(0x10, rx_addr, 5); // TX_ADDR }初始化代码里最需要留意的是寄存器 0x00 的 PRIM_RX 位该位置 1 表示上电后进入接收模式。如果你直接从上电开始就发数据发送完要手动把 CE 拉低再拉高切换接收否则模块一直处于发送状态无法收到回包。4.2 数据协议设计一个字节命令字加一个字节校验NRF24L01 的 Payload 最大 32 字节对这个项目来说根本用不完。我一般把遥控和回传整合成一个 4 字节帧帧头 0xAA命令字0x01 前进、0x02 后退、0x03 停止、0x04 紧急停车速度值0~100校验帧头命令字速度的和校验。发送端代码uint8_t tx_buf[4]; tx_buf[0] 0xAA; tx_buf[1] cmd; tx_buf[2] speed; tx_buf[3] tx_buf[0] tx_buf[1] tx_buf[2]; nrf24l01_write_buf(0xA8, tx_buf, 4); // 写 TX_PAYLOAD HAL_GPIO_WritePin(NRF_CE_GPIO_Port, NRF_CE_Pin, GPIO_PIN_SET); HAL_Delay_us(20); HAL_GPIO_WritePin(NRF_CE_GPIO_Port, NRF_CE_Pin, GPIO_PIN_RESET); while (nrf24l01_read_status() 0x20 0); // 等待发送完成标志 nrf24l01_write_reg(0x07, 0x20); // 清 TX_DS 标志接收端每 10ms 查询一次 RX_DR 标志有数据就读取然后立即回到接收模式。对智能车来说无线遥控的实时性要求在 20ms 以内NRF24L01 的理论空中速率 2Mbps实际一包往返在不到 1ms瓶颈在 STM32 的 SPI 轮询频率上。提升方法是用定时器定时 5ms 去读一次状态寄存器比主循环里 while 一直读更省 CPU。4.3 丢包处理与重发策略NRF24L01 内置自动重发ART和 ACK 应答但如果没有开启 Enhanced ShockBurst 模式就需要自己在应用层处理。我的策略是接收队列里保留最近 3 包数据如果连续 10 次没有收到有效帧就强制整车进入“停止”而不是“保持上次速度”。原因很现实无线信号瞬间丢包时小车如果按最后一条指令继续全速跑指不定冲到哪里。停在一个安全距离比停在原地更不容易出事故。5. 系统集成后的调试顺序从单模块阈值到整车状态机整车调试最忌一上来就全功能跑。我习惯按“传感器独立验证、控制环闭环验证、多传感器联合验证”三步走。第一步是给五个循迹通道分别打印原始电平验证阈值和环境光的关系。用 USB 转串口接在 STM32 的 USART1 上9600 波特率每 100ms 输出五个通道的 0/1 值和光强 ADC 值。如果发现光线变化导致某个通道翻转回到光强检测章节的阈值修正逻辑去调。第二步是只用循迹和电机在标准赛道上跑通直线和普通弯道暂时屏蔽超声波和红绿识别。这个步骤里重点调转向环的比例参数我通常把五路状态映射成偏差值偏差范围 -4 到 4PWM 修正量 偏差 × 转向系数转向系数初始给 35过弯不稳再按 5 递减。在完成这步之前不要碰无线和颜色识别否则出了问题你分不清是循迹还是避障的锅。第三步是加障碍物和红绿识别按标题的功能优先级逐步放开。测试顺序是先让车在无路口赛道上开到障碍物前停车验证避障距离阈值再让车过十字路口验证 250ms 丢线延时是否合适最后叠加红绿灯验证红灯停车和绿灯起步的逻辑。每一层功能只保留 3 个调试参数可调循迹转向系数、避障距离阈值、路口丢线延时这样整车调参时不需要反复读代码。剩下一个值得关注的是 HSE 晶振配置。STM32F103 的 HSE 启动延时比内部时钟长上电后立刻调用 NRF24L01 初始化容易因为时钟未稳定导致 SPI 通信乱码。建议在 main 函数开头加一个 50ms 的 HAL_Delay等晶振稳定后再初始化外设。这类时序问题在无源晶振负载电容匹配不当时尤为明显如果发现无线模块间歇性无法通信先看一下示波器上 OSCOUT 引脚的波形是否起振稳定再检查 CE 引脚时序最后才考虑寄存器配置。硬件的问题不改代码软件层面很难绕过。本文还有配套的精品资源点击获取