用STM32CubeMX和HAL库，5分钟搞定TCRT5000循迹小车（附完整工程）

基于STM32CubeMX的TCRT5000智能循迹小车开发实战

在嵌入式开发领域，快速原型开发已经成为提升效率的关键。对于STM32初学者而言，如何摆脱繁琐的寄存器配置，利用现代化工具链快速实现功能验证，是入门阶段最迫切的需求。本文将展示如何通过STM32CubeMX图形化工具和HAL库，在极短时间内构建一个完整的TCRT5000红外循迹小车系统。

1. 开发环境搭建与工程创建

工欲善其事，必先利其器。我们首先需要准备完整的开发工具链：

• STM32CubeMX：ST官方推出的图形化配置工具（当前最新版本为6.9.2）
• IDE选择：Keil MDK-ARM（5.38以上）或STM32CubeIDE（1.13.0以上）
• 硬件准备：STM32F103C8T6最小系统板、TCRT5000传感器模块×2、L298N电机驱动模块

启动CubeMX后，按照以下步骤初始化工程：

1. 选择MCU型号：STM32F103C8Tx
2. 配置系统时钟树：
   • HSE选择Crystal/Ceramic Resonator
   • 主时钟设置为72MHz
3. 启用必要的外设：
   • GPIO：PB3和PB4作为输入（连接传感器）
   • TIM2：通道1和2配置为PWM输出（驱动电机）
   • USART1：用于调试信息输出（可选）

// 生成的时钟配置代码片段（system_stm32f1xx.c） void SystemClock_Config(void) { RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_ClkInitTypeDef RCC_ClkInitStruct = {0}; // 配置HSE为8MHz外部晶振 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9; HAL_RCC_OscConfig(&RCC_OscInitStruct); // 配置系统时钟72MHz RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2; RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2; RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2); }

提示：在Pinout视图界面，建议为关键功能引脚添加用户标签（如"Left_Sensor"、"Right_Sensor"），这将自动生成更具可读性的宏定义。

2. TCRT5000传感器配置与信号处理

TCRT5000作为反射式红外传感器，其工作原理基于红外光的反射强度变化。当传感器悬空或检测到白色表面时，红外光大部分被反射，接收管导通，输出低电平；当检测到黑色轨迹时，红外光被吸收，接收管截止，输出高电平。

在CubeMX中配置传感器接口：

1. 选择PB3和PB4引脚
2. 配置为GPIO输入模式
3. 设置上拉电阻（根据实际电路选择）
4. 生成代码后，会自动生成以下初始化代码：

// 自动生成的GPIO初始化代码（main.c） static void MX_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; /* GPIO Ports Clock Enable */ __HAL_RCC_GPIOB_CLK_ENABLE(); /*Configure GPIO pins : PB3 PB4 */ GPIO_InitStruct.Pin = GPIO_PIN_3|GPIO_PIN_4; GPIO_InitStruct.Mode = GPIO_MODE_INPUT; GPIO_InitStruct.Pull = GPIO_PULLUP; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); }

为提高系统稳定性，建议在软件层面添加去抖动处理：

// 传感器状态读取函数（添加去抖动） uint8_t Read_Sensor(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) { static uint8_t filter_count[2] = {0}; static uint8_t last_state[2] = {1,1}; uint8_t current_state = HAL_GPIO_ReadPin(GPIOx, GPIO_Pin); if(current_state != last_state[GPIO_Pin == GPIO_PIN_3 ? 0 : 1]) { filter_count[GPIO_Pin == GPIO_PIN_3 ? 0 : 1]++; if(filter_count[GPIO_Pin == GPIO_PIN_3 ? 0 : 1] >= 3) { last_state[GPIO_Pin == GPIO_PIN_3 ? 0 : 1] = current_state; filter_count[GPIO_Pin == GPIO_PIN_3 ? 0 : 1] = 0; } } else { filter_count[GPIO_Pin == GPIO_PIN_3 ? 0 : 1] = 0; } return last_state[GPIO_Pin == GPIO_PIN_3 ? 0 : 1]; }

3. 电机驱动与PWM配置

L298N电机驱动模块需要两路PWM信号和两路方向控制信号。在CubeMX中配置TIM2：

1. 选择TIM2通道1（PA0）和通道2（PA1）
2. 配置为PWM Generation模式
3. 设置预分频器和周期：
   • Prescaler: 71 (72MHz/(71+1) = 1MHz)
   • Counter Period: 999 (1MHz/1000 = 1kHz PWM频率)
4. 配置Pulse初始值为0

生成的PWM初始化代码：

// 自动生成的PWM配置（main.c） static void MX_TIM2_Init(void) { TIM_ClockConfigTypeDef sClockSourceConfig = {0}; TIM_MasterConfigTypeDef sMasterConfig = {0}; TIM_OC_InitTypeDef sConfigOC = {0}; htim2.Instance = TIM2; htim2.Init.Prescaler = 71; htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 999; htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; HAL_TIM_Base_Init(&htim2); sClockSourceConfig.ClockSource = TIM_CLOCKSOURCE_INTERNAL; HAL_TIM_ConfigClockSource(&htim2, &sClockSourceConfig); HAL_TIM_PWM_Init(&htim2); sMasterConfig.MasterOutputTrigger = TIM_TRGO_RESET; sMasterConfig.MasterSlaveMode = TIM_MASTERSLAVEMODE_DISABLE; HAL_TIMEx_MasterConfigSynchronize(&htim2, &sMasterConfig); sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 0; sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(&htim2, &sConfigOC, TIM_CHANNEL_1); HAL_TIM_PWM_ConfigChannel(&htim2, &sConfigOC, TIM_CHANNEL_2); HAL_TIM_MspPostInit(&htim2); }

方向控制引脚（PB1和PB10）需要在GPIO初始化中添加：

// 添加到MX_GPIO_Init函数中 GPIO_InitStruct.Pin = GPIO_PIN_1|GPIO_PIN_10; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

4. 运动控制算法实现

循迹小车的核心在于根据传感器状态实时调整电机运动。我们实现一个带速度差分的控制算法，使转弯更加平滑：

// 运动控制函数 void Motor_Control(int16_t left_speed, int16_t right_speed) { // 限制速度范围（0-100%） left_speed = (left_speed > 100) ? 100 : (left_speed < 0) ? 0 : left_speed; right_speed = (right_speed > 100) ? 100 : (right_speed < 0) ? 0 : right_speed; // 设置方向（假设正值为前进） HAL_GPIO_WritePin(GPIOB, GPIO_PIN_1, (left_speed >= 0) ? GPIO_PIN_SET : GPIO_PIN_RESET); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_10, (right_speed >= 0) ? GPIO_PIN_SET : GPIO_PIN_RESET); // 设置PWM占空比（绝对值） __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, abs(left_speed)*10); __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_2, abs(right_speed)*10); } // 循迹主逻辑 void Tracking_Logic(void) { static uint8_t last_left = 1, last_right = 1; uint8_t left_val = Read_Sensor(GPIOB, GPIO_PIN_3); uint8_t right_val = Read_Sensor(GPIOB, GPIO_PIN_4); // 状态变化检测 if(left_val != last_left || right_val != last_right) { if(left_val == 0 && right_val == 0) { // 双传感器都在黑线上（停止或直行） Motor_Control(70, 70); } else if(left_val == 1 && right_val == 0) { // 只有右侧传感器检测到黑线（左转） Motor_Control(30, 70); } else if(left_val == 0 && right_val == 1) { // 只有左侧传感器检测到黑线（右转） Motor_Control(70, 30); } else { // 双传感器都离开黑线（根据上次状态决定） if(last_left == 0 && last_right == 1) { Motor_Control(70, 30); // 保持右转 } else if(last_left == 1 && last_right == 0) { Motor_Control(30, 70); // 保持左转 } else { Motor_Control(0, 0); // 完全停止 } } last_left = left_val; last_right = right_val; } }

注意：实际应用中需要根据电机特性、小车重量和赛道条件调整PWM值。建议通过串口调试实时修改参数：

// 简单的串口参数调试接口（通过串口助手发送"L30 R70"格式指令） void UART_Command_Handler(uint8_t* cmd) { int left, right; if(sscanf((char*)cmd, "L%d R%d", &left, &right) == 2) { Motor_Control(left, right); printf("Set Motor: L=%d, R=%d\r\n", left, right); } }

5. 系统优化与调试技巧

完成基础功能后，以下几个优化点可以显著提升循迹性能：

1. 动态速度调整算法

// 根据偏离程度动态调整速度差 void Dynamic_Speed_Control(void) { static uint32_t last_time = 0; static int16_t left_speed = 70, right_speed = 70; uint8_t left_val = Read_Sensor(GPIOB, GPIO_PIN_3); uint8_t right_val = Read_Sensor(GPIOB, GPIO_PIN_4); uint32_t current_time = HAL_GetTick(); // 每50ms调整一次速度 if(current_time - last_time > 50) { if(left_val == 0 && right_val == 0) { // 居中时缓慢恢复平衡 left_speed += (left_speed < 70) ? 2 : (left_speed > 70) ? -2 : 0; right_speed += (right_speed < 70) ? 2 : (right_speed > 70) ? -2 : 0; } else if(left_val == 1) { // 左偏时增加右轮速度 right_speed = 80; left_speed = 50; } else if(right_val == 1) { // 右偏时增加左轮速度 left_speed = 80; right_speed = 50; } Motor_Control(left_speed, right_speed); last_time = current_time; } }

2. 传感器阵列扩展方案

当使用多个传感器时，可以采用加权算法提高精度：

// 多传感器加权计算偏离程度 int8_t Calculate_Deviation(void) { int8_t deviation = 0; deviation += Read_Sensor(LEFTMOST_PIN) ? -2 : 0; deviation += Read_Sensor(LEFT_PIN) ? -1 : 0; deviation += Read_Sensor(CENTER_PIN) ? 0 : 0; deviation += Read_Sensor(RIGHT_PIN) ? 1 : 0; deviation += Read_Sensor(RIGHTMOST_PIN) ? 2 : 0; return deviation; }

3. 性能监控与调试

添加以下调试功能可以极大提高开发效率：

// 实时状态监控线程 void Debug_Monitor(void) { while(1) { printf("L_Sensor: %d, R_Sensor: %d | L_PWM: %d, R_PWM: %d\r\n", Read_Sensor(GPIOB, GPIO_PIN_3), Read_Sensor(GPIOB, GPIO_PIN_4), htim2.Instance->CCR1, htim2.Instance->CCR2); HAL_Delay(100); } }

在STM32CubeMX中启用FreeRTOS，可以创建独立任务运行监控函数：

1. 在Middleware选项卡中选择FreeRTOS
2. 配置适当的堆栈大小（建议至少128字）
3. 生成代码后添加任务：

// FreeRTOS任务创建 void StartDefaultTask(void const * argument) { // 启动PWM HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_2); // 创建调试任务 xTaskCreate((TaskFunction_t)Debug_Monitor, "Debug_Monitor", 128, NULL, 1, NULL); // 主控制循环 for(;;) { Tracking_Logic(); osDelay(10); } }