STM32CubeMX + HAL库：5分钟搞定定时器中断，让LED灯自动闪烁（附代码）

STM32CubeMX + HAL库：5分钟实现定时器中断控制LED呼吸效果

第一次接触STM32的开发者往往会被底层寄存器配置的复杂性吓退。但有了STM32CubeMX和HAL库，这些复杂操作变得像搭积木一样简单。本文将带你用最直观的方式，通过图形化配置工具快速实现定时器中断功能，让LED灯按照预设频率自动闪烁。

1. 开发环境准备与基础概念

在开始之前，确保你已经准备好以下工具和硬件：

• STM32CubeMX 6.x或更高版本
• Keil MDK-ARM或STM32CubeIDE
• STM32F103C8T6开发板（蓝色小板）
• 一颗LED灯（开发板通常已内置）

定时器工作原理简述： 定时器本质上是一个向上或向下计数的数字计数器。当计数器达到预设值时，会产生中断信号。通过合理配置预分频器(PSC)和自动重装载寄存器(ARR)，我们可以精确控制中断发生的时间间隔。

提示：STM32的定时器非常灵活，除了基本定时功能外，还能实现PWM输出、输入捕获等高级功能。本文聚焦最基础的中断应用。

2. STM32CubeMX项目配置

2.1 创建新项目

1. 打开STM32CubeMX，点击"New Project"
2. 在芯片选择器中输入"STM32F103C8"，选择对应的型号
3. 确认引脚分配图显示正常后，点击"Start Project"

2.2 时钟配置

在"Clock Configuration"标签页中：

• 将HCLK设置为72MHz（拖动滑块到最大值）
• 确保PLLCLK已启用
• 检查APB1定时器时钟是否为72MHz

// 典型时钟配置代码（自动生成） RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1; 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);

2.3 GPIO配置

1. 在引脚图中找到连接LED的GPIO（通常是PC13或PB8）
2. 右键点击该引脚，选择"GPIO_Output"
3. 在左侧GPIO配置中，设置：
   • GPIO输出电平：高
   • GPIO模式：推挽输出
   • GPIO上拉/下拉：无
   • GPIO速度：低速

3. 定时器参数计算与配置

3.1 定时器基本参数

选择TIM2定时器（通用定时器）进行配置：

• 时钟源：内部时钟
• 预分频器(PSC)：7199
• 计数模式：向上
• 自动重装载值(ARR)：4999
• 计数器周期：500ms

参数计算原理： 定时器中断时间计算公式为：

中断时间 = (ARR + 1) × (PSC + 1) / 定时器时钟频率

代入我们的参数：

(4999 + 1) × (7199 + 1) / 72,000,000 = 0.5秒（500ms）

3.2 CubeMX中的定时器配置步骤

1. 左侧导航栏选择"TIM2"
2. 配置模式为"Internal Clock"
3. 在"Parameter Settings"中：
   • Prescaler (PSC - 16 bits value): 7199
   • Counter Mode: Up
   • Counter Period (AutoReload Register - 16 bits value): 4999
   • auto-reload preload: Enable
4. 在"NVIC Settings"中勾选"TIM2 global interrupt"

4. 代码生成与关键函数实现

4.1 生成项目代码

1. 点击"Project Manager"标签
2. 设置项目名称和存储路径
3. 选择工具链（MDK-ARM或STM32CubeIDE）
4. 点击"Generate Code"按钮

4.2 添加用户代码

在自动生成的代码中，我们需要添加两个关键部分：

1. 启动定时器中断（添加到main.c的main函数中）：

/* USER CODE BEGIN 2 */ HAL_TIM_Base_Start_IT(&htim2); // 启动TIM2中断 /* USER CODE END 2 */

2. 中断回调函数（添加到main.c的/* USER CODE BEGIN 0 */部分）：

void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM2) { HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_8); // 翻转LED状态 } }

注意：回调函数必须放在正确的位置，否则会被后续代码生成覆盖。建议放在/* USER CODE BEGIN 0/和/USER CODE END 0 */之间。

5. 进阶优化与调试技巧

5.1 实现呼吸灯效果

通过动态调整ARR值，可以创建平滑的呼吸灯效果：

static uint16_t pwmVal = 0; static uint8_t dir = 1; void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM2) { if(dir) { pwmVal += 50; if(pwmVal >= 5000) dir = 0; } else { pwmVal -= 50; if(pwmVal == 0) dir = 1; } __HAL_TIM_SET_AUTORELOAD(&htim2, pwmVal); HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_8); } }

5.2 常见问题排查

• LED不闪烁：

  1. 检查GPIO引脚是否配置正确
  2. 确认定时器中断已启用（HAL_TIM_Base_Start_IT）
  3. 验证回调函数是否被正确实现

• 闪烁频率不正确：

  1. 重新计算PSC和ARR值
  2. 确认系统时钟配置为72MHz
  3. 检查APB1预分频器设置

5.3 性能优化建议

// 寄存器直接操作示例（替代HAL_GPIO_TogglePin） void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM2) { GPIOB->ODR ^= GPIO_PIN_8; // 直接操作寄存器翻转LED } }

通过这个完整的流程，即使是STM32新手也能在短时间内实现稳定的定时器中断功能。掌握了这个基础后，你可以进一步探索PWM输出、输入捕获等更高级的定时器应用。