STM32按键中断实战：用HAL库实现LED控制（附CubeMX配置截图）
很多刚开始接触STM32的朋友，第一次听说“中断”这个概念时，可能会觉得它既神秘又复杂。其实，它就像你正在专心写代码时，手机突然来了个重要电话——你会暂时放下手头的工作去接听，处理完后再回来继续写。在嵌入式世界里，中断就是让微控制器（MCU）能够及时响应外部事件的“电话系统”。今天，我们就来彻底搞懂它，并用STM32CubeMX这个强大的图形化工具，亲手实现一个按键中断控制LED的经典项目。我会把每一步的配置截图都贴出来，确保你跟着做一遍，就能把中断从“知道”变成“会用”。
1. 理解中断：为什么我们需要它？
在嵌入式系统中，主程序（比如一个while(1)循环）通常按部就班地执行任务。但如果只用循环去轮询（Polling）检测一个按键是否被按下，效率会非常低下。想象一下，你让CPU不断地问：“按键按下了吗？没有。按键按下了吗？没有。” 这就像派一个保安每秒钟都去检查一次大门是否被打开，大部分时间他都在做无用功，而且一旦在他检查的间隙有人开门，这个事件就会被错过。
中断机制就是为了解决这个问题而生的。它允许外部事件（如按键按下、定时器溢出、数据接收完成）主动“打断”CPU当前的工作流。CPU会立即保存当前的工作现场（就像接电话前先记住书看到哪一页），转而去处理这个紧急事件，处理完毕后再恢复之前的工作。这种方式让CPU得以“并行”处理多项任务，极大地提升了系统效率和实时性。
对于STM32来说，管理这套复杂中断系统的核心是NVIC（嵌套向量中断控制器）。你可以把它理解为一个智能的“前台接待员”。所有可能产生中断的设备（GPIO、定时器、串口等）都是来“办事”的客户。NVIC负责接待他们，并根据预先设定好的“VIP等级”（中断优先级）来决定谁先被CPU接见，甚至允许更高级的VIP打断正在进行的会面（中断嵌套）。
注意：中断虽好，但不可滥用。过于频繁的中断或中断服务函数执行时间过长，反而会拖累系统整体性能，在设计时需要权衡。
2. 项目准备与CubeMX工程创建
在动手写代码之前，清晰的硬件连接和软件环境是成功的第一步。这个项目我们只需要一个STM32最小系统板、一个LED和一个按键，几乎是最基础的配置。
2.1 硬件连接与原理
假设我们使用一块常见的STM32F103C8T6核心板（Blue Pill）。
- LED： 我们将LED的正极（阳极）通过一个220Ω的限流电阻连接到微控制器的
PC13引脚。LED的负极（阴极）接地（GND）。STM32的GPIO引脚在输出模式下，可以输出高电平（3.3V）或低电平（0V）。通常我们采用低电平点亮LED的方式，即引脚输出低电平时，电流从VCC经电阻、LED流向引脚，LED发光。 - 按键： 我们使用一个轻触开关。按键的一端接地（GND），另一端连接到微控制器的
PB14引脚，同时，该引脚需要通过一个上拉电阻连接到3.3V。STM32的GPIO内部可以配置上拉电阻，这样在按键未按下时，PB14引脚被内部电阻拉至高电平（3.3V）；当按键按下时，引脚直接与GND相连，电平被拉低至0V。这个从高到低的电平跳变（下降沿）就是我们用来触发中断的信号。
硬件连接示意图如下：
| 元件 | 引脚1连接 | 引脚2连接 | 说明 |
|---|---|---|---|
| LED | 阳极 -> 220Ω电阻 ->PC13 | 阴极 -> GND | 低电平点亮 |
| 按键 | 引脚1 ->PB14 | 引脚2 -> GND | 按下时产生下降沿 |
2.2 使用STM32CubeMX初始化项目
STM32CubeMX是ST官方推出的图形化配置工具，能极大简化外设初始化和代码生成工作，尤其适合初学者。
- 新建工程： 打开CubeMX，点击“New Project”。在芯片选择器中输入“STM32F103C8”，并选中对应的型号。
- 系统核心配置（SYS）： 在左侧“System Core”分类下，点击“SYS”。在“Debug”下拉菜单中，根据你的调试器选择，例如使用ST-Link就选择“Serial Wire”。这为后续的程序下载和调试预留接口。
- 时钟配置（RCC）： 点击“RCC”，将“High Speed Clock (HSE)”设置为“Crystal/Ceramic Resonator”。我们的核心板外部通常有一个8MHz的晶振，需要在此启用。
- 时钟树配置： 点击顶部的“Clock Configuration”标签页。这是CubeMX的一个关键步骤。STM32F103的默认内部时钟（HSI）是8MHz，但我们可以通过PLL倍频到更高的频率以获得更好的性能。一个常见的配置是：将PLL源选择为HSE（8MHz），然后将PLL倍频因子设置为9，这样系统时钟（SYSCLK）就达到了72MHz。你可以直接输入“72”在HCLK框内，CubeMX会自动计算并配置好相关分频器。
完成以上基础配置后，我们就可以开始配置本项目的主角：GPIO了。
3. GPIO与中断的详细配置步骤
这是整个项目的核心配置环节，每一步的设置都直接影响最终功能。
3.1 配置LED控制引脚（输出模式）
- 在芯片引脚图界面，找到
PC13引脚。 - 左键点击该引脚，在弹出的功能菜单中选择“GPIO_Output”。
- 在左侧“System Core”下点击“GPIO”，然后点击刚配置的
PC13条目，进行详细参数设置。- GPIO output level: 初始输出电平设为
High（高电平）。因为我们是低电平点亮LED，初始高电平意味着LED默认熄灭。 - GPIO mode:
Output Push Pull（推挽输出）。这是最常用的输出模式，能明确输出高或低电平，驱动能力强。 - GPIO Pull-up/Pull-down:
No pull-up and no pull-down（无上下拉）。输出模式下通常不需要。 - Maximum output speed: 选择
Low即可。对于控制LED闪烁这种低速应用，低速率有助于降低噪声和功耗。
- GPIO output level: 初始输出电平设为
3.2 配置按键中断引脚（外部中断模式）
- 找到
PB14引脚，左键点击。 - 在弹出的功能菜单中选择“GPIO_EXTI14”。这意味着我们将
PB14映射到外部中断线14（EXTI14）。 - 同样在“GPIO”设置中，点击
PB14的配置条目。- GPIO mode: 此时已自动变为
External Interrupt Mode with Rising/Falling edge trigger detection。这是最常用的模式，同时检测上升沿和下降沿。 - GPIO Pull-up/Pull-down:这里非常重要！由于我们的按键硬件是按下接地，为了在未按下时让引脚保持确定的高电平，必须启用内部上拉电阻。选择
Pull-up。 - 用户标签： 为了方便代码阅读，我们可以给这个引脚起个别名。在“User Label”一栏输入“KEY”，这样生成的代码中，引脚名会变成
KEY_Pin和KEY_GPIO_Port，非常直观。
- GPIO mode: 此时已自动变为
3.3 配置NVIC（嵌套向量中断控制器）
配置好中断源（EXTI）后，必须通过NVIC告诉CPU：“这个中断我允许响应，并且它的优先级是这样安排的。”
- 在左侧“System Core”分类下，点击“NVIC”。
- 在中断列表中找到“EXTI line[15:10] interrupts”。因为
PB14对应的是EXTI14，它被分组在10到15这个中断通道里。勾选后面的“Enabled”复选框。 - 设置优先级：
- Preemption Priority (抢占优先级): 设置为0。
- Sub Priority (子优先级): 设置为0。
- 说明： 在只有一个中断的简单系统中，优先级设置多少都可以。但理解其概念很重要：抢占优先级高的中断可以打断正在执行的、抢占优先级低的中断（嵌套）。当抢占优先级相同时，子优先级高的先响应。数值越小，优先级越高。
3.4 生成工程代码
- 点击顶部菜单栏的“Project Manager”标签。
- 在“Project”选项卡中，设置工程名称、存储路径，并选择你使用的IDE（如MDK-ARM V5 for Keil，或STM32CubeIDE）。
- 在“Code Generator”选项卡中，有几个推荐设置：
- 勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”，这会让代码结构更清晰。
- 勾选“Backup previously generated files when re-generating”，避免覆盖你自己的代码。
- 最后，点击右上角的“GENERATE CODE”。CubeMX会生成一个完整的、包含所有初始化代码的工程。
4. 编写中断服务与应用程序逻辑
CubeMX为我们搭建好了舞台（硬件初始化），现在需要我们自己来编写表演的剧本（应用程序）。
4.1 理解HAL库的中断处理流程
HAL库采用了一种回调（Callback）机制来处理中断，这使得我们的应用层代码与底层中断服务程序（ISR）解耦，更加清晰和安全。流程如下：
- 中断发生（如按键按下，
PB14产生下降沿）。 - CPU跳转到统一的中断服务函数
EXTI15_10_IRQHandler()（在启动文件startup_stm32f103xb.s中定义）。 - 该函数内部调用HAL库的
HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_14)。 - 这个HAL函数会清除该中断线的挂起标志位（防止中断重复进入），然后调用一个弱定义（Weak）的回调函数
HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)。 - 我们需要做的，就是在自己的代码里重新实现（重写）这个回调函数，加入我们想要执行的逻辑（比如翻转LED）。
4.2 在main.c中实现回调函数
打开生成工程中的Src/main.c文件。我们不需要修改while(1)主循环，所有按键响应逻辑都写在中断回调函数里。
找到/* USER CODE BEGIN 4 */和/* USER CODE END 4 */这对注释。这是CubeMX为我们预留的、安全编写用户代码的区域（重新生成代码时不会被覆盖）。在其中添加以下函数：
/* USER CODE BEGIN 4 */ /** * @brief 外部中断回调函数 * @param GPIO_Pin: 触发中断的引脚号 * @retval None */ void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { /* 判断是否是我们的按键引脚(PB14)触发的中断 */ if(GPIO_Pin == KEY_Pin) { /* 为了消除按键机械抖动带来的误触发，这里加入一个简单的延时消抖 */ HAL_Delay(10); // 延时10毫秒 /* 再次读取按键引脚电平，确认按键状态 */ if(HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) == GPIO_PIN_RESET) { /* 确认按键为按下状态(低电平)，点亮LED */ HAL_GPIO_WritePin(LD2_GPIO_Port, LD2_Pin, GPIO_PIN_RESET); // 假设CubeMX为PC13生成的标签是LD2 } else { /* 按键为释放状态(高电平)，熄灭LED */ HAL_GPIO_WritePin(LD2_GPIO_Port, LD2_Pin, GPIO_PIN_SET); } } } /* USER CODE END 4 */代码解析与关键点：
- 引脚判断： 回调函数的参数
GPIO_Pin指明了是哪个引脚触发的中断。我们通过if语句确保只处理KEY引脚（即PB14）的中断。这是一个好习惯，因为多个GPIO可能共享同一个EXTI中断向量（如EXTI10到EXTI15共享EXTI15_10_IRQHandler）。 - 按键消抖： 机械按键在按下或释放的瞬间，金属触点会发生物理弹跳，导致电平在极短时间内多次快速变化，从而可能触发多次中断。
HAL_Delay(10)是一个简单的软件消抖方法，在检测到中断后等待约10ms，待抖动过去再读取稳定的电平状态。对于要求更高的场合，可以使用定时器进行更精确的消抖。 - 状态读取与控制： 使用
HAL_GPIO_ReadPin读取按键当前的实际电平。GPIO_PIN_RESET代表低电平（0V），对应按键按下。然后根据这个状态，使用HAL_GPIO_WritePin函数控制LED亮灭。注意GPIO_PIN_RESET（低电平）点亮LED，GPIO_PIN_SET（高电平）熄灭LED，这与我们的硬件连接方式相符。
4.3 编译、下载与调试
- 编译工程： 在Keil或CubeIDE中点击编译按钮，确保没有语法错误。
- 连接硬件： 用ST-Link或DAP-Link等调试器将开发板与电脑连接，并给开发板上电。
- 下载程序： 点击下载/调试按钮，将程序烧录到STM32的Flash中。
- 复位运行： 按下开发板上的复位键，程序开始运行。
实验现象： 按下连接在PB14上的按键，PC13连接的LED应立即点亮；松开按键，LED应立即熄灭。整个过程主循环while(1)是空的，但CPU却能实时响应你的按键操作。
5. 深入进阶：中断优先级与系统设计思考
完成了基础功能，我们可以更进一步，思考如何在实际项目中更好地运用中断。
5.1 中断优先级分组详解
之前我们在NVIC中简单设置了抢占和子优先级。STM32的NVIC允许你将有限的优先级位（如4位）灵活地分配给抢占优先级和子优先级。这是通过优先级分组（Priority Grouping）实现的。
在main.c的MX_NVIC_Init函数（由CubeMX生成）之前，系统会调用HAL_Init，其中默认设置了优先级分组。你也可以手动修改。分组决定了抢占优先级和子优先级各占多少位。
例如，对于4位优先级的情况（STM32F1常见）：
// 在 main() 函数初始化部分调用 HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_2);这表示将4位分成2位用于抢占优先级，2位用于子优先级。
- 抢占优先级范围：0-3 (2^2 = 4个级别)
- 子优先级范围：0-3 (2^2 = 4个级别)
这意味着，你可以有4个不同抢占优先级的中断，在同一抢占级别内，又有4个子优先级用于排序。理解并合理规划中断优先级，是设计稳定、实时性高的多中断系统的关键。
5.2 中断服务函数的设计原则
中断服务函数（以及其调用的回调函数）应该遵循“快进快出”的原则：
- 执行时间尽可能短： 中断会打断主程序和其他低优先级中断。长时间执行中断服务函数会导致系统响应变慢，甚至丢失其他中断。复杂的处理逻辑应该放在主循环中，由中断通过设置标志位等方式来触发。
- 避免调用可能阻塞或延时过长的函数： 例如，尽量避免在中断里使用
HAL_Delay（我们上面用了，但在简单演示中问题不大，实际项目需谨慎），或者进行复杂的浮点运算（除非硬件支持）。 - 注意共享数据的访问： 如果中断服务函数和主循环都会访问同一个全局变量（如一个状态标志），需要考虑临界区保护。简单的开关全局中断是一种方法，但更推荐使用信号量、互斥锁等RTOS机制（如果使用了操作系统）。
5.3 从按键中断到更复杂的应用
掌握了基本的GPIO外部中断，你就打开了一扇门。基于同样的原理，你可以去探索：
- 定时器中断： 实现精准的定时、PWM输出、输入捕获测量脉冲宽度。
- 串口中断： 实现高效的不定长数据接收，CPU无需轮询。
- ADC中断： 在转换完成后立即读取数据，进行实时处理。
我最初在做一个需要同时响应按键、读取传感器并通过串口上报数据的项目时，就是通过合理分配中断优先级，将ADC转换完成和串口发送完成设为中断，而按键中断的优先级最高，确保了用户操作能得到即时反馈，整个系统的流畅度得到了质的提升。
