1. 阶段目标与实验背景
这个循迹小车项目是我在嵌入式系统教学中最喜欢的一个综合性实验。通过将Simulink模型生成的算法代码与STM32CubeMX生成的底层驱动代码进行集成，最终实现一个能通过红外遥控控制的智能循迹小车。整个项目涉及硬件电路设计、嵌入式软件开发、控制算法实现等多个环节，非常适合用来检验学生对嵌入式系统的综合掌握程度。
在之前的实验中，我们已经完成了：
- 基于STM32CubeMX的底层硬件驱动配置（PWM输出、GPIO输入捕获等）
- Simulink环境下红外遥控解码算法的建模与代码生成
- Simulink环境下小车运动控制算法的建模与代码生成
本章的核心任务是将这些分散的模块整合到一个完整的工程中，并通过硬件实测验证系统功能。具体来说需要：
- 将Simulink生成的C代码整合到CubeIDE工程中
- 编写接口代码实现算法与硬件的交互
- 配置10ms定时器中断作为系统时基
- 实现红外信号输入捕获回调
- 完成编译烧录与功能验证
提示：这个实验最关键的难点在于理解Simulink生成代码的结构，以及如何正确地将算法与硬件驱动对接。很多同学在这一步容易混淆函数调用关系。
2. 代码集成详细过程
2.1 代码集成框架设计
整个系统的软件架构可以分为三个层次：
code复制应用层
├── 红外遥控解码算法 (InfraredRemote_Appl)
└── 小车运动控制算法 (SmartCar_Appl)
↓
中间层
├── 硬件抽象接口 (Get/Set函数)
└── 系统定时器管理
↓
硬件驱动层
├── PWM输出驱动
├── GPIO输入捕获
└── 其他外设驱动
集成时需要特别注意以下几点：
- Simulink生成的代码会包含
_initialize()和_step()两个关键函数 - 硬件相关操作必须通过HAL库函数实现
- 算法与硬件的交互需要通过中间层接口函数
2.2 系统初始化实现
在main.c文件中，系统初始化需要按特定顺序执行：
c复制int main(void)
{
HAL_Init(); // HAL库初始化
SystemClock_Config(); // 系统时钟配置
// 硬件外设初始化
MX_GPIO_Init();
MX_TIM1_Init(); // PWM定时器
MX_TIM2_Init(); // 输入捕获定时器
// 算法层初始化
InfraredRemote_Appl_initialize();
SmartCar_Appl_initialize();
// 配置10ms系统定时器
HAL_SYSTICK_Config(SystemCoreClock / 100);
while (1) {
// 主循环保持空转，所有功能通过中断驱动
}
}
这里有几个关键点需要注意：
- 算法初始化必须在硬件初始化完成后调用
- 系统定时器配置为100Hz（10ms周期）
- 主循环不做具体工作，系统采用事件驱动架构
2.3 输入捕获回调实现
红外遥控信号是通过GPIO输入捕获来检测的。当红外接收器检测到信号时，会产生下降沿中断，我们在回调函数中处理信号解码：
c复制void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim)
{
if (htim->Instance == TIM2) { // 确认是TIM2触发的中断
// 获取当前捕获值
uint32_t capture = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1);
// 调用红外解码算法
InfraredRemote_Appl_step();
// 清除中断标志
__HAL_TIM_CLEAR_IT(htim, TIM_IC_IT_CAPTURE);
}
}
实测中发现几个常见问题：
- 忘记检查定时器实例会导致误触发
- 未及时清除中断标志会造成重复进入回调
- 捕获值读取时机不当会影响解码精度
2.4 硬件接口函数实现
Simulink生成的算法需要调用硬件接口来读取输入和控制输出。这些接口函数需要在main.c中实现：
c复制// 读取红外信号状态的Get函数
boolean_T Get_InfraredSignal(void)
{
return (boolean_T)HAL_GPIO_ReadPin(IR_GPIO_Port, IR_Pin);
}
// 设置电机PWM的Set函数
void Set_MotorPWM(real_T pwmValue)
{
// 将算法输出的归一化值转换为实际的CCR值
uint16_t ccr = (uint16_t)(pwmValue * TIM1->ARR);
// 设置PWM占空比
__HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, ccr);
__HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_2, ccr);
}
这些接口函数需要在main.h中声明，以便Simulink生成的代码可以调用：
c复制/* USER CODE BEGIN EFP */
extern boolean_T Get_InfraredSignal(void);
extern void Set_MotorPWM(real_T pwmValue);
/* USER CODE END EFP */
注意：Simulink生成的代码使用特定的数据类型（如boolean_T、real_T），必须保持类型定义的一致性。
2.5 编译与调试技巧
完成代码集成后，使用CubeIDE进行编译时可能会遇到以下典型问题：
-
头文件路径问题
Simulink生成的代码可能需要额外的头文件路径。在项目属性中添加包含路径：code复制Properties → C/C++ Build → Settings → Tool Settings → Includes -
未定义符号错误
确保所有Get/Set函数都正确定义和声明，检查函数名拼写是否一致。 -
堆栈溢出
在startup_stm32xxxx.s文件中适当增大堆栈大小：code复制Stack_Size EQU 0x800 Heap_Size EQU 0x400
烧录ELF文件后，验证步骤应该包括：
- 用逻辑分析仪检查PWM输出波形
- 用示波器观察红外信号捕获情况
- 实际测试小车对遥控指令的响应
- 验证循迹功能是否正常
3. 常见问题与解决方案
3.1 红外信号解码不稳定
现象：小车对遥控指令响应时有时无
可能原因：
- 红外接收头供电不稳定
- 输入捕获定时器配置不当
- 环境光干扰
解决方案：
- 在红外接收头VCC引脚加0.1uF去耦电容
- 调整输入捕获滤波参数：
c复制sConfigIC.ICFilter = 6; // 增加滤波系数 - 给接收头加遮光罩
3.2 PWM输出异常
现象：电机运转不平稳或有异响
排查步骤：
- 用逻辑分析仪检查PWM频率是否符合预期
- 确认死区时间配置是否正确
- 检查电机驱动电路供电是否充足
典型配置参数：
c复制htim1.Init.Prescaler = 71; // 72MHz/(71+1)=1MHz
htim1.Init.Period = 999; // 1MHz/1000=1kHz PWM频率
3.3 系统响应延迟大
现象：按下遥控器后小车反应迟缓
优化方法：
- 检查10ms定时器中断是否正常工作
- 优化算法step函数的执行时间
- 提高中断优先级：
c复制HAL_NVIC_SetPriority(SysTick_IRQn, 0, 0);
4. 项目总结与进阶建议
通过这个完整的循迹小车项目，我们实现了从算法仿真到硬件落地的全流程开发。这里分享几个我在指导学生时总结的经验：
- 模块化开发：保持算法与硬件的松耦合，便于单独调试和复用
- 版本控制：使用Git管理工程，特别是CubeMX重新生成代码时
- 实时调试：善用SWD调试和printf重定向，快速定位问题
对于想进一步深入的同学，可以考虑：
- 加入PID控制算法提升循迹精度
- 实现蓝牙/WiFi无线控制
- 添加超声波避障功能
- 移植到RTOS实现多任务管理
这个项目最让我欣慰的是看到同学们在解决各种实际问题过程中展现出的创造力和毅力。嵌入式开发就是这样，当你看到自己写的代码真正让硬件"活"起来时，那种成就感是无与伦比的。