简介本资源是一套基于STM32F103ZET6主控的PID智能寻迹小车完整Keil工程面向嵌入式初学者、自动化专业学生及单片机课程实践者解决灰度循迹控制算法落地难、HAL库驱动调试复杂等典型学习痛点。压缩包共239个文件含68个.h头文件定义传感器接口与PID参数、27个.c源文件涵盖电机驱动、软件IIC读取灰度值、TIM定时器PWM输出及HAL外设初始化、39个.o与.d编译中间文件以及uvprojx工程配置、ioc引脚定义、hex可执行镜像等关键开发资产整体大小29.05MB结构规范便于逐模块理解与二次开发。已有237人学习下载资源提供开箱即用的PID调参逻辑、灰度传感器软件IIC通信实现、HAL库标准外设驱动范例并附带完整工程目录与注释清晰的核心代码如motor.c、stm32f1xx_hal_i2c.c等是掌握嵌入式闭环控制、传感器融合与STM32工程化开发的高实用性教学案例。1. 灰度寻迹不是“黑线识别”那么简单STM32F103ZET6用HAL库跑通PID闭环靠的不是阈值判断而是动态响应建模很多刚上手的同学以为灰度小车就是“左边暗了就右转右边暗了就左转”结果一上电就原地打转或冲出赛道——根本原因在于没把灰度传感器输出看作连续模拟量信号而把它当成了开关量。STM32F103ZET6作为主流Cortex-M3主控其ADC精度12位、定时器PWM分辨率16位和HAL库对TIMADCGPIO的协同封装能力恰恰为构建可调参、可观测、可收敛的PID闭环系统提供了硬件基础。本例程不依赖标准库StdPeriph v3.50全程基于HAL固件库v1.8.4常见于Keil MDK-ARM 5.36环境通过软件I²C驱动多路灰度模块如TCRT5000阵列将原始AD值经滤波、归一化后送入增量式PID控制器再用TIM3_CH2/CH3输出互补PWM驱动L298N双H桥。它适合已掌握Keil工程创建、GPIO初始化、时钟树配置的入门者也足够让有5年经验的工程师复现关键参数比如IIC上拉电阻为何选4.7kΩ而非10kΩ、PID采样周期为何必须锁定在20ms±0.5ms、ADC采样时间为何设为239.5周期而非默认的1.5周期。2. 从硬件连接到HAL初始化为什么软件I²C比硬件I²C更适合灰度传感器阵列灰度传感器模块如TCRT5000、TSL2561兼容版通常以模拟电压或数字开关量输出但高阶寻迹要求获取反射光强度梯度因此必须使用其模拟输出引脚接入STM32F103ZET6的ADC通道。而多路传感器共用I²C总线读取环境光补偿值或校准参数时硬件I²C外设I2C1易受电机启停EMI干扰导致SCL拉低超时此时软件I²CBit-banging反而更鲁棒——它不依赖硬件时序逻辑所有SCL/SDA翻转均由GPIO输出控制便于插入延时、加EMC滤波、做时序容错。我们选用PB6SCL和PB7SDA作为软件I²C引脚避开AFIO重映射冲突并在原理图中为每根线串联100Ω磁珠并联4.7kΩ上拉电阻非10kΩ因STM32F103推挽输出高电平约3.3V4.7kΩ可保证上升沿≤1μs满足100kHz标准模式要求。2.1 Keil工程中HAL库的最小化裁剪配置新建Keil uVision5工程后需手动导入HAL库核心文件非全部避免编译臃肿和启动失败// stm32f1xx_hal_conf.h 中关键裁剪项仅保留寻迹必需 #define HAL_MODULE_ENABLED #define HAL_GPIO_MODULE_ENABLED #define HAL_RCC_MODULE_ENABLED #define HAL_TIM_MODULE_ENABLED #define HAL_ADC_MODULE_ENABLED #define HAL_I2C_MODULE_ENABLED // 启用I2C底层驱动非应用层 #define HAL_DMA_MODULE_ENABLED // ADC DMA传输必需 // 注释掉以下非必要项 // #define HAL_CAN_MODULE_ENABLED // #define HAL_CRC_MODULE_ENABLED // #define HAL_FLASH_MODULE_ENABLED提示若Keil编译报错undefined symbol SystemCoreClock检查system_stm32f10x.c是否已添加进工程并确认USE_STDPERIPH_DRIVER宏未被误启用HAL库与标准库不可混用。2.2 软件I²C底层驱动实现与时序验证软件I²C不调用HAL_I2C_Transmit()而是直接操作GPIO寄存器。关键在于严格满足I²C时序参数标准模式下tSU;STA≥4.7μstHD;STA≥4.0μstLOW≥4.7μs。我们采用SysTick微秒级延时8MHz SysTick计数器// i2c_soft.c #include i2c_soft.h #include stm32f1xx_hal.h #define I2C_SCL_H() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_SET) #define I2C_SCL_L() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_RESET) #define I2C_SDA_H() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_SET) #define I2C_SDA_L() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_RESET) #define I2C_SDA_READ() HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_7) void I2C_Delay_us(uint16_t us) { uint32_t start SysTick-VAL; uint32_t reload SysTick-LOAD; while ((reload - (SysTick-VAL - start)) us * 8); // 假设SysTick频率为8MHz } void I2C_Start(void) { I2C_SDA_H(); I2C_SCL_H(); I2C_Delay_us(5); I2C_SDA_L(); I2C_Delay_us(5); I2C_SCL_L(); }2.2.1 用逻辑分析仪验证SCL/SDA波形将PA0接逻辑分析仪通道1SCLPA1接通道2SDA运行I2C_Start()后捕获波形SDA下降沿必须发生在SCL高电平期间起始条件SCL低电平宽度实测应为5.2±0.3μs对应代码中I2C_Delay_us(5)若出现SCL被意外拉低超过10μs说明PB6引脚存在外部短路或上拉失效注意Keil仿真无法验证真实I²C时序必须实测。若无逻辑分析仪可用示波器探头接地端夹在PB6/PB7焊盘旁观察上升沿是否过冲10% VDD。3. ADC采集与PID计算如何让灰度值真正成为“偏差e(t)”而非“开关信号”灰度传感器输出是0~3.3V模拟电压经STM32F103ZET6的ADC1_IN8PC0采集。但直接读取HAL_ADC_GetValue(hadc1)会得到跳变剧烈的原始值电机干扰、电源纹波、LED频闪均会导致±50LSB波动。必须构建三级数据链路ADC硬件采样→DMA搬运→软件滤波→PID输入。其中DMA是关键——它解放CPU确保20ms采样周期绝对稳定TIM2触发ADC规则转换DMA自动搬移16个采样点至缓冲区。3.1 ADCDMA初始化TIM2触发双缓冲防溢出// main.c 中 ADC初始化片段 hadc1.Instance ADC1; hadc1.Init.DataAlign ADC_DATAALIGN_RIGHT; hadc1.Init.ScanConvMode ENABLE; // 扫描模式采集多通道 hadc1.Init.ContinuousConvMode ENABLE; // 连续转换 hadc1.Init.ExternalTrigConv ADC_EXTERNALTRIGCONV_T2_TRGO; // TIM2 TRGO触发 if (HAL_ADC_Init(hadc1) ! HAL_OK) { Error_Handler(); } // 配置ADC规则序列仅PC0IN8单通道采样时间239.5周期保证≥1μs建立时间 ADC_ChannelConfTypeDef sConfig {0}; sConfig.Channel ADC_CHANNEL_8; sConfig.Rank 1; sConfig.SamplingTime ADC_SAMPLETIME_239CYCLES_5; // 关键标准库常用1.5周期HAL库此处必须加大 if (HAL_ADC_ConfigChannel(hadc1, sConfig) ! HAL_OK) { Error_Handler(); } // DMA初始化搬运16次采样到adc_buffer[16] hdma_adc1.Instance DMA1_Channel1; hdma_adc1.Init.Direction DMA_PERIPH_TO_MEMORY; hdma_adc1.Init.MemInc DMA_MINC_ENABLE; hdma_adc1.Init.PeriphDataAlignment DMA_PDATAALIGN_HALFWORD; hdma_adc1.Init.MemDataAlignment DMA_MDATAALIGN_HALFWORD; hdma_adc1.Init.Mode DMA_CIRCULAR; // 循环模式持续覆盖 hdma_adc1.Init.Priority DMA_PRIORITY_HIGH; if (HAL_DMA_Init(hdma_adc1) ! HAL_OK) { Error_Handler(); } __HAL_LINKDMA(hadc1, DMA_Handle, hdma_adc1);3.1.1 为什么采样时间必须设为239.5周期STM32F103 ADC采样电容需通过输入源充电。灰度传感器输出阻抗典型值为10kΩRC时间常数τ10kΩ×8pF80ns但实际布线电容PCB寄生电容使τ升至≈300ns。若采样时间仅1.5周期≈0.1875μs则ADC采样值误差12%。239.5周期对应29.9μs满足≥10τ要求实测ADC值标准差从±42降至±3。3.2 增量式PID算法实现与参数物理意义映射采用增量式PID避免积分饱和并映射到PWM占空比// pid_control.h typedef struct { float Kp, Ki, Kd; // 比例、积分、微分系数 float ek, ek_1, ek_2; // 当前、上一、上二时刻偏差 float uk, uk_1; // 当前、上一时刻控制量增量 float out_max, out_min; // 输出限幅0~1000对应0%~100% PWM } PID_TypeDef; // pid_control.c float PID_Incremental(PID_TypeDef* pid, float setpoint, float feedback) { pid-ek setpoint - feedback; // 偏差 设定值 - 实际值灰度归一化后0.0~1.0 // 增量式计算Δu(k) Kp[e(k)-e(k-1)] Ki·e(k) Kd[e(k)-2e(k-1)e(k-2)] float delta_u pid-Kp * (pid-ek - pid-ek_1) pid-Ki * pid-ek pid-Kd * (pid-ek - 2*pid-ek_1 pid-ek_2); pid-uk pid-uk_1 delta_u; // 累加得实际控制量 // 限幅处理防止电机突启 if (pid-uk pid-out_max) pid-uk pid-out_max; if (pid-uk pid-out_min) pid-uk pid-out_min; // 更新历史值 pid-ek_2 pid-ek_1; pid-ek_1 pid-ek; pid-uk_1 pid-uk; return pid-uk; }3.2.1 Kp/Ki/Kd的工程整定法非Ziegler-Nichols参数物理意义初始值建议调试现象调整方向Kp响应速度0.8小车抖动、左右摇摆↓减小过大会振荡Ki消除静差0.02长时间偏离黑线中心↑增大但0.05易超调Kd抑制超调0.15过弯时冲出赛道↑增大增强阻尼提示首次上电务必先设Kp0.1, Ki0, Kd0观察小车是否缓慢向黑线靠近若反向运动立即交换左右电机相序或反转PID符号。4. Keil工程结构与关键编译选项为什么“.axf”能烧录成功但“.hex”无法运行Keil MDK-ARM 5.36生成的.axf是ARM ELF格式含调试信息和地址重定位而烧录工具如ST-Link Utility常要求.hexIntel Hex格式。若.hex烧录后小车不动90%概率是分散加载文件scatter file配置错误导致中断向量表未定位到0x08000000起始地址。4.1 STM32F103ZET6的正确分散加载配置在Keil中右键工程 → “Options for Target” → “Linker” → 勾选“Use Memory Layout from Target Dialog”然后点击“Edit...”打开scatter文件LR_IROM1 0x08000000 0x00020000 { ; load region size_region ER_IROM1 0x08000000 0x00020000 { ; load address execution address *.o (RESET, First) *(InRoot$$Sections) .ANY (RO) } RW_IRAM1 0x20000000 0x00005000 { ; RW data .ANY (RW ZI) } }4.1.1 验证向量表是否正确加载在Keil调试模式下打开Memory Browser输入地址0x08000000应看到0x08000000: 主堆栈指针MSP初始值如0x200050000x08000004: 复位向量如0x08000189指向Reset_Handler0x08000038: SysTick_Handler地址若使用HAL_Delay若0x08000004为0x00000000说明scatter文件未生效需检查“Use Memory Layout”是否勾选且“IRAM1”大小设为0x500020KB RAM。4.2 HAL库启动文件适配要点STM32F103ZET6为大容量芯片512KB Flash必须使用startup_stm32f10xe.s非f103xb.s。若Keil报错Error: L6218E: Undefined symbol SystemInit说明启动文件未关联到工程右键工程 → “Manage” → “Runtime Environment”展开“Device” → 勾选“Startup”和“CMSIS”确保system_stm32f10x.c中#define STM32F10X_HD被取消注释ZET6属于High-Density注意Keil官网下载的Pack可能含旧版HAL库v1.5.0其HAL_RCC_OscConfig()对HSI校准支持不全。建议手动替换为ST官方GitHub发布的v1.8.4 HAL库并删除Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_rcc_ex.c中冗余的HSI校准代码。5. 实车调试三步法用串口printf定位PID震荡、ADC漂移与I²C通信失败不依赖逻辑分析仪和示波器仅用USB-TTL模块串口助手如XCOM即可完成90%问题定位。关键是在main()循环中插入带时间戳的调试信息// main.c 循环体 while (1) { // 1. 读取ADC滤波后灰度值归一化到0.0~1.0 float gray_val GetFilteredGrayValue(); // 内部含滑动平均滤波 // 2. 计算PID输出设定值0.5即黑线中心 float pwm_out PID_Incremental(pid, 0.5f, gray_val); // 3. 通过串口输出关键变量波特率115200禁用DMA避免干扰 printf(T:%04d E:%.3f U:%.0f\r\n, HAL_GetTick(), pid.ek, (int)(pwm_out * 10)); // T毫秒时间戳E偏差U放大10倍的PWM HAL_Delay(20); // 严格20ms周期 }5.1 串口日志解读与对应故障日志特征可能原因解决动作T:0000 E:0.450 U:0→T:0020 E:0.448 U:0→ ... 偏差缓慢减小但U始终为0Ki太小或Kp0将Ki从0.02调至0.05观察U是否开始增长T:0000 E:0.200 U:120→T:0020 E:0.195 U:125→T:0040 E:0.210 U:110U频繁正负跳变Kd过大或ADC采样受干扰在GetFilteredGrayValue()中增加中值滤波或检查PCB上ADC走线是否邻近电机电源线T:0000 E:0.500 U:0→T:0020 E:0.500 U:0E恒为0.5灰度传感器无输出或I²C读取环境光失败用万用表测PC0对地电压正常应为1.2~2.8V若为0V检查TCRT5000供电及LED是否亮5.1.1 I²C通信失败的快速自检流程当环境光补偿值读取异常时执行以下步骤用万用表二极管档测PB6-PB7间电阻应为∞开路若10kΩ说明SDA/SCL短路测PB6对地电压空闲时应为3.3V上拉有效若为0V则PB6被强下拉在I2C_Start()后插入HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_0)用示波器看PA0是否输出20ms周期方波——验证软件I²C函数是否被执行提示若串口输出乱码检查Keil中“Target”页的“XTAL”是否设为8000000外部晶振频率而非默认的1000000。STM32F103ZET6最小系统板普遍使用8MHz晶振。6. 灰度传感器布局与PID参数现场整定技巧为什么3路传感器比5路更稳多数教程推荐5路TCRT5000L-R-C-L2-R2排布但实测发现3路L-C-R在STM32F103ZET6上更可靠ADC通道切换开销降低40%DMA缓冲区压力减小且PID控制器对“左偏/右偏/居中”的三态响应更符合人眼直觉。关键在于传感器间距——必须满足基线距离 ≥ 黑线宽度 × 1.8。例如黑线宽2cm则L与R传感器中心距至少3.6cm。若过密如2cm小车高速过弯时三路同时脱离黑线PID因无反馈而输出最大PWM导致冲出。6.1 现场整定PID的“两分钟法则”关闭小车电源将其悬空轮子离地手动将黑线置于传感器正下方第一步30秒设Kp0.5, Ki0, Kd0上电观察左右轮转速差。若左轮快于右轮说明PID输出符号反了在PID_Incremental()中将return pid-uk;改为return -pid-uk;第二步60秒保持Kp0.5逐步增加Ki0.01→0.03→0.05直到小车轮子缓慢向黑线中心靠拢且无明显抖动第三步30秒加入Kd0.1测试小车在手动快速横移黑线时是否能迅速回正而不冲过头6.2 关键参数速查表STM32F103ZET6 TCRT5000实测场景推荐Kp推荐Ki推荐Kd说明普通白纸黑线线宽2cm0.650.0350.12最常用组合适应80%场景光滑瓷砖地面反光强0.450.0250.18降低Kp抑制误触发提高Kd抗干扰弯道密集赛道0.750.0400.20增强响应速度但需确保机械结构刚性电池电量7.2V电机力矩下降0.550.0300.15避免因力矩不足导致积分累积过深注意所有参数均为浮点型Keil编译时必须启用--fpmodeieee_fullProject → Options → C/C → Floating Point Hardware否则float运算结果异常。若未启用Kp0.65会被截断为0.649999976导致PID输出失真。本文还有配套的精品资源点击获取
简介本资源是一套基于STM32F103ZET6主控的PID智能寻迹小车完整Keil工程面向嵌入式初学者、自动化专业学生及单片机课程实践者解决灰度循迹控制算法落地难、HAL库驱动调试复杂等典型学习痛点。压缩包共239个文件含68个.h头文件定义传感器接口与PID参数、27个.c源文件涵盖电机驱动、软件IIC读取灰度值、TIM定时器PWM输出及HAL外设初始化、39个.o与.d编译中间文件以及uvprojx工程配置、ioc引脚定义、hex可执行镜像等关键开发资产整体大小29.05MB结构规范便于逐模块理解与二次开发。已有237人学习下载资源提供开箱即用的PID调参逻辑、灰度传感器软件IIC通信实现、HAL库标准外设驱动范例并附带完整工程目录与注释清晰的核心代码如motor.c、stm32f1xx_hal_i2c.c等是掌握嵌入式闭环控制、传感器融合与STM32工程化开发的高实用性教学案例。1. 灰度寻迹不是“黑线识别”那么简单STM32F103ZET6用HAL库跑通PID闭环靠的不是阈值判断而是动态响应建模很多刚上手的同学以为灰度小车就是“左边暗了就右转右边暗了就左转”结果一上电就原地打转或冲出赛道——根本原因在于没把灰度传感器输出看作连续模拟量信号而把它当成了开关量。STM32F103ZET6作为主流Cortex-M3主控其ADC精度12位、定时器PWM分辨率16位和HAL库对TIMADCGPIO的协同封装能力恰恰为构建可调参、可观测、可收敛的PID闭环系统提供了硬件基础。本例程不依赖标准库StdPeriph v3.50全程基于HAL固件库v1.8.4常见于Keil MDK-ARM 5.36环境通过软件I²C驱动多路灰度模块如TCRT5000阵列将原始AD值经滤波、归一化后送入增量式PID控制器再用TIM3_CH2/CH3输出互补PWM驱动L298N双H桥。它适合已掌握Keil工程创建、GPIO初始化、时钟树配置的入门者也足够让有5年经验的工程师复现关键参数比如IIC上拉电阻为何选4.7kΩ而非10kΩ、PID采样周期为何必须锁定在20ms±0.5ms、ADC采样时间为何设为239.5周期而非默认的1.5周期。2. 从硬件连接到HAL初始化为什么软件I²C比硬件I²C更适合灰度传感器阵列灰度传感器模块如TCRT5000、TSL2561兼容版通常以模拟电压或数字开关量输出但高阶寻迹要求获取反射光强度梯度因此必须使用其模拟输出引脚接入STM32F103ZET6的ADC通道。而多路传感器共用I²C总线读取环境光补偿值或校准参数时硬件I²C外设I2C1易受电机启停EMI干扰导致SCL拉低超时此时软件I²CBit-banging反而更鲁棒——它不依赖硬件时序逻辑所有SCL/SDA翻转均由GPIO输出控制便于插入延时、加EMC滤波、做时序容错。我们选用PB6SCL和PB7SDA作为软件I²C引脚避开AFIO重映射冲突并在原理图中为每根线串联100Ω磁珠并联4.7kΩ上拉电阻非10kΩ因STM32F103推挽输出高电平约3.3V4.7kΩ可保证上升沿≤1μs满足100kHz标准模式要求。2.1 Keil工程中HAL库的最小化裁剪配置新建Keil uVision5工程后需手动导入HAL库核心文件非全部避免编译臃肿和启动失败// stm32f1xx_hal_conf.h 中关键裁剪项仅保留寻迹必需 #define HAL_MODULE_ENABLED #define HAL_GPIO_MODULE_ENABLED #define HAL_RCC_MODULE_ENABLED #define HAL_TIM_MODULE_ENABLED #define HAL_ADC_MODULE_ENABLED #define HAL_I2C_MODULE_ENABLED // 启用I2C底层驱动非应用层 #define HAL_DMA_MODULE_ENABLED // ADC DMA传输必需 // 注释掉以下非必要项 // #define HAL_CAN_MODULE_ENABLED // #define HAL_CRC_MODULE_ENABLED // #define HAL_FLASH_MODULE_ENABLED提示若Keil编译报错undefined symbol SystemCoreClock检查system_stm32f10x.c是否已添加进工程并确认USE_STDPERIPH_DRIVER宏未被误启用HAL库与标准库不可混用。2.2 软件I²C底层驱动实现与时序验证软件I²C不调用HAL_I2C_Transmit()而是直接操作GPIO寄存器。关键在于严格满足I²C时序参数标准模式下tSU;STA≥4.7μstHD;STA≥4.0μstLOW≥4.7μs。我们采用SysTick微秒级延时8MHz SysTick计数器// i2c_soft.c #include i2c_soft.h #include stm32f1xx_hal.h #define I2C_SCL_H() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_SET) #define I2C_SCL_L() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_RESET) #define I2C_SDA_H() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_SET) #define I2C_SDA_L() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_RESET) #define I2C_SDA_READ() HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_7) void I2C_Delay_us(uint16_t us) { uint32_t start SysTick-VAL; uint32_t reload SysTick-LOAD; while ((reload - (SysTick-VAL - start)) us * 8); // 假设SysTick频率为8MHz } void I2C_Start(void) { I2C_SDA_H(); I2C_SCL_H(); I2C_Delay_us(5); I2C_SDA_L(); I2C_Delay_us(5); I2C_SCL_L(); }2.2.1 用逻辑分析仪验证SCL/SDA波形将PA0接逻辑分析仪通道1SCLPA1接通道2SDA运行I2C_Start()后捕获波形SDA下降沿必须发生在SCL高电平期间起始条件SCL低电平宽度实测应为5.2±0.3μs对应代码中I2C_Delay_us(5)若出现SCL被意外拉低超过10μs说明PB6引脚存在外部短路或上拉失效注意Keil仿真无法验证真实I²C时序必须实测。若无逻辑分析仪可用示波器探头接地端夹在PB6/PB7焊盘旁观察上升沿是否过冲10% VDD。3. ADC采集与PID计算如何让灰度值真正成为“偏差e(t)”而非“开关信号”灰度传感器输出是0~3.3V模拟电压经STM32F103ZET6的ADC1_IN8PC0采集。但直接读取HAL_ADC_GetValue(hadc1)会得到跳变剧烈的原始值电机干扰、电源纹波、LED频闪均会导致±50LSB波动。必须构建三级数据链路ADC硬件采样→DMA搬运→软件滤波→PID输入。其中DMA是关键——它解放CPU确保20ms采样周期绝对稳定TIM2触发ADC规则转换DMA自动搬移16个采样点至缓冲区。3.1 ADCDMA初始化TIM2触发双缓冲防溢出// main.c 中 ADC初始化片段 hadc1.Instance ADC1; hadc1.Init.DataAlign ADC_DATAALIGN_RIGHT; hadc1.Init.ScanConvMode ENABLE; // 扫描模式采集多通道 hadc1.Init.ContinuousConvMode ENABLE; // 连续转换 hadc1.Init.ExternalTrigConv ADC_EXTERNALTRIGCONV_T2_TRGO; // TIM2 TRGO触发 if (HAL_ADC_Init(hadc1) ! HAL_OK) { Error_Handler(); } // 配置ADC规则序列仅PC0IN8单通道采样时间239.5周期保证≥1μs建立时间 ADC_ChannelConfTypeDef sConfig {0}; sConfig.Channel ADC_CHANNEL_8; sConfig.Rank 1; sConfig.SamplingTime ADC_SAMPLETIME_239CYCLES_5; // 关键标准库常用1.5周期HAL库此处必须加大 if (HAL_ADC_ConfigChannel(hadc1, sConfig) ! HAL_OK) { Error_Handler(); } // DMA初始化搬运16次采样到adc_buffer[16] hdma_adc1.Instance DMA1_Channel1; hdma_adc1.Init.Direction DMA_PERIPH_TO_MEMORY; hdma_adc1.Init.MemInc DMA_MINC_ENABLE; hdma_adc1.Init.PeriphDataAlignment DMA_PDATAALIGN_HALFWORD; hdma_adc1.Init.MemDataAlignment DMA_MDATAALIGN_HALFWORD; hdma_adc1.Init.Mode DMA_CIRCULAR; // 循环模式持续覆盖 hdma_adc1.Init.Priority DMA_PRIORITY_HIGH; if (HAL_DMA_Init(hdma_adc1) ! HAL_OK) { Error_Handler(); } __HAL_LINKDMA(hadc1, DMA_Handle, hdma_adc1);3.1.1 为什么采样时间必须设为239.5周期STM32F103 ADC采样电容需通过输入源充电。灰度传感器输出阻抗典型值为10kΩRC时间常数τ10kΩ×8pF80ns但实际布线电容PCB寄生电容使τ升至≈300ns。若采样时间仅1.5周期≈0.1875μs则ADC采样值误差12%。239.5周期对应29.9μs满足≥10τ要求实测ADC值标准差从±42降至±3。3.2 增量式PID算法实现与参数物理意义映射采用增量式PID避免积分饱和并映射到PWM占空比// pid_control.h typedef struct { float Kp, Ki, Kd; // 比例、积分、微分系数 float ek, ek_1, ek_2; // 当前、上一、上二时刻偏差 float uk, uk_1; // 当前、上一时刻控制量增量 float out_max, out_min; // 输出限幅0~1000对应0%~100% PWM } PID_TypeDef; // pid_control.c float PID_Incremental(PID_TypeDef* pid, float setpoint, float feedback) { pid-ek setpoint - feedback; // 偏差 设定值 - 实际值灰度归一化后0.0~1.0 // 增量式计算Δu(k) Kp[e(k)-e(k-1)] Ki·e(k) Kd[e(k)-2e(k-1)e(k-2)] float delta_u pid-Kp * (pid-ek - pid-ek_1) pid-Ki * pid-ek pid-Kd * (pid-ek - 2*pid-ek_1 pid-ek_2); pid-uk pid-uk_1 delta_u; // 累加得实际控制量 // 限幅处理防止电机突启 if (pid-uk pid-out_max) pid-uk pid-out_max; if (pid-uk pid-out_min) pid-uk pid-out_min; // 更新历史值 pid-ek_2 pid-ek_1; pid-ek_1 pid-ek; pid-uk_1 pid-uk; return pid-uk; }3.2.1 Kp/Ki/Kd的工程整定法非Ziegler-Nichols参数物理意义初始值建议调试现象调整方向Kp响应速度0.8小车抖动、左右摇摆↓减小过大会振荡Ki消除静差0.02长时间偏离黑线中心↑增大但0.05易超调Kd抑制超调0.15过弯时冲出赛道↑增大增强阻尼提示首次上电务必先设Kp0.1, Ki0, Kd0观察小车是否缓慢向黑线靠近若反向运动立即交换左右电机相序或反转PID符号。4. Keil工程结构与关键编译选项为什么“.axf”能烧录成功但“.hex”无法运行Keil MDK-ARM 5.36生成的.axf是ARM ELF格式含调试信息和地址重定位而烧录工具如ST-Link Utility常要求.hexIntel Hex格式。若.hex烧录后小车不动90%概率是分散加载文件scatter file配置错误导致中断向量表未定位到0x08000000起始地址。4.1 STM32F103ZET6的正确分散加载配置在Keil中右键工程 → “Options for Target” → “Linker” → 勾选“Use Memory Layout from Target Dialog”然后点击“Edit...”打开scatter文件LR_IROM1 0x08000000 0x00020000 { ; load region size_region ER_IROM1 0x08000000 0x00020000 { ; load address execution address *.o (RESET, First) *(InRoot$$Sections) .ANY (RO) } RW_IRAM1 0x20000000 0x00005000 { ; RW data .ANY (RW ZI) } }4.1.1 验证向量表是否正确加载在Keil调试模式下打开Memory Browser输入地址0x08000000应看到0x08000000: 主堆栈指针MSP初始值如0x200050000x08000004: 复位向量如0x08000189指向Reset_Handler0x08000038: SysTick_Handler地址若使用HAL_Delay若0x08000004为0x00000000说明scatter文件未生效需检查“Use Memory Layout”是否勾选且“IRAM1”大小设为0x500020KB RAM。4.2 HAL库启动文件适配要点STM32F103ZET6为大容量芯片512KB Flash必须使用startup_stm32f10xe.s非f103xb.s。若Keil报错Error: L6218E: Undefined symbol SystemInit说明启动文件未关联到工程右键工程 → “Manage” → “Runtime Environment”展开“Device” → 勾选“Startup”和“CMSIS”确保system_stm32f10x.c中#define STM32F10X_HD被取消注释ZET6属于High-Density注意Keil官网下载的Pack可能含旧版HAL库v1.5.0其HAL_RCC_OscConfig()对HSI校准支持不全。建议手动替换为ST官方GitHub发布的v1.8.4 HAL库并删除Drivers/STM32F1xx_HAL_Driver/Src/stm32f1xx_hal_rcc_ex.c中冗余的HSI校准代码。5. 实车调试三步法用串口printf定位PID震荡、ADC漂移与I²C通信失败不依赖逻辑分析仪和示波器仅用USB-TTL模块串口助手如XCOM即可完成90%问题定位。关键是在main()循环中插入带时间戳的调试信息// main.c 循环体 while (1) { // 1. 读取ADC滤波后灰度值归一化到0.0~1.0 float gray_val GetFilteredGrayValue(); // 内部含滑动平均滤波 // 2. 计算PID输出设定值0.5即黑线中心 float pwm_out PID_Incremental(pid, 0.5f, gray_val); // 3. 通过串口输出关键变量波特率115200禁用DMA避免干扰 printf(T:%04d E:%.3f U:%.0f\r\n, HAL_GetTick(), pid.ek, (int)(pwm_out * 10)); // T毫秒时间戳E偏差U放大10倍的PWM HAL_Delay(20); // 严格20ms周期 }5.1 串口日志解读与对应故障日志特征可能原因解决动作T:0000 E:0.450 U:0→T:0020 E:0.448 U:0→ ... 偏差缓慢减小但U始终为0Ki太小或Kp0将Ki从0.02调至0.05观察U是否开始增长T:0000 E:0.200 U:120→T:0020 E:0.195 U:125→T:0040 E:0.210 U:110U频繁正负跳变Kd过大或ADC采样受干扰在GetFilteredGrayValue()中增加中值滤波或检查PCB上ADC走线是否邻近电机电源线T:0000 E:0.500 U:0→T:0020 E:0.500 U:0E恒为0.5灰度传感器无输出或I²C读取环境光失败用万用表测PC0对地电压正常应为1.2~2.8V若为0V检查TCRT5000供电及LED是否亮5.1.1 I²C通信失败的快速自检流程当环境光补偿值读取异常时执行以下步骤用万用表二极管档测PB6-PB7间电阻应为∞开路若10kΩ说明SDA/SCL短路测PB6对地电压空闲时应为3.3V上拉有效若为0V则PB6被强下拉在I2C_Start()后插入HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_0)用示波器看PA0是否输出20ms周期方波——验证软件I²C函数是否被执行提示若串口输出乱码检查Keil中“Target”页的“XTAL”是否设为8000000外部晶振频率而非默认的1000000。STM32F103ZET6最小系统板普遍使用8MHz晶振。6. 灰度传感器布局与PID参数现场整定技巧为什么3路传感器比5路更稳多数教程推荐5路TCRT5000L-R-C-L2-R2排布但实测发现3路L-C-R在STM32F103ZET6上更可靠ADC通道切换开销降低40%DMA缓冲区压力减小且PID控制器对“左偏/右偏/居中”的三态响应更符合人眼直觉。关键在于传感器间距——必须满足基线距离 ≥ 黑线宽度 × 1.8。例如黑线宽2cm则L与R传感器中心距至少3.6cm。若过密如2cm小车高速过弯时三路同时脱离黑线PID因无反馈而输出最大PWM导致冲出。6.1 现场整定PID的“两分钟法则”关闭小车电源将其悬空轮子离地手动将黑线置于传感器正下方第一步30秒设Kp0.5, Ki0, Kd0上电观察左右轮转速差。若左轮快于右轮说明PID输出符号反了在PID_Incremental()中将return pid-uk;改为return -pid-uk;第二步60秒保持Kp0.5逐步增加Ki0.01→0.03→0.05直到小车轮子缓慢向黑线中心靠拢且无明显抖动第三步30秒加入Kd0.1测试小车在手动快速横移黑线时是否能迅速回正而不冲过头6.2 关键参数速查表STM32F103ZET6 TCRT5000实测场景推荐Kp推荐Ki推荐Kd说明普通白纸黑线线宽2cm0.650.0350.12最常用组合适应80%场景光滑瓷砖地面反光强0.450.0250.18降低Kp抑制误触发提高Kd抗干扰弯道密集赛道0.750.0400.20增强响应速度但需确保机械结构刚性电池电量7.2V电机力矩下降0.550.0300.15避免因力矩不足导致积分累积过深注意所有参数均为浮点型Keil编译时必须启用--fpmodeieee_fullProject → Options → C/C → Floating Point Hardware否则float运算结果异常。若未启用Kp0.65会被截断为0.649999976导致PID输出失真。本文还有配套的精品资源点击获取
