简介面向初学 32 位单片机开发的读者这份资源围绕 STM32 外部中断 EXTI 实现按键控制 LED 灯提供一套可直接导入的 Keil 工程。与轮询按键相比中断方式让 MCU 在按键按下瞬间响应既能降低 CPU 占用也更贴近实际产品的中断驱动设计适合作为学习外部中断、GPIO 输入和 NVIC 中断管理的入门练手项目。资源为 rar 压缩包共 185 个文件约 4.75MB。文件构成以 .c/.h 源码、.uvprojx 工程文件、.hex/.axf 可执行烧录文件为主同时保留 .o/.map/.lst 等编译辅助文件便于查看工程结构和编译输出信息解压后即可打开工程对照学习。目前已有 4928 人学习下载。包内完整示例覆盖 GPIO 初始化、EXTI 线映射与下降沿触发配置、NVIC 优先级设置以及中断服务函数编写核心代码注释清晰能够帮助读者理解 EXTI0_IRQHandler 的执行流程掌握后还可迁移至传感器信号检测、无线接收唤醒等场景。1. 按键控制LED的进阶玩法用EXTI把CPU从轮询里解放出来做单片机开发的人应该都有过这种经历用轮询方式扫描按键主循环里不停读引脚电平为了消抖还得塞几个毫秒的延时。按键少的时候还能忍一旦按键数量上来或者主逻辑里有复杂的显示、通信任务轮询就让系统变得又卡又难维护。这个基于STM32外部中断EXTI的按键控制LED项目就是来解决这个问题的。它把按键触发从“CPU主动查”变成“硬件通知CPU”按键按下时自动跳进中断服务函数主循环只负责响应标志位逻辑干净扩展也容易。适合刚入门中断机制的初学者也适合想把自己按键逻辑重构成事件驱动的开发者拿来当模板。项目本身不大但覆盖了GPIO输入配置、EXTI外部中断线、NVIC优先级、中断服务函数写法和按键消抖这套完整链路。你把它跑通之后相当于掌握了STM32中断系统里最常用的一类应用场景后面做编码器、红外遥控、触摸按键思路都是相通的。2. 项目拆解硬件接线、EXTI工作链路与开发环境准备2.1 硬件接线和物料清单做这个项目需要的物料非常基础一块STM32F103系列的核心板常见的是C8T6也就是蓝丸那种板型一个轻触按键一个发光二极管和限流电阻加上几根杜邦线。接线关系也很直观按键一端接GND另一端接任意的PA0引脚LED正极通过一个220欧姆到1千欧的限流电阻接到PB0引脚LED负极直接接GND。这里按键的接法是“按下接地”也就是低电平触发。选择PA0是有讲究的它对应EXTI0中断线配置起来比较直接。如果你手头只有其他引脚也可以选PA1到PA15但要记得把EXTI线和NVIC通道同步改掉后面会专门讲这个坑。硬件连接好之后还有一个容易忽略的点按键两端最好并一个100nF的陶瓷电容或者给PA0接一个10k欧姆上拉电阻。虽然STM32内部可以开启上拉但外部加一个上拉能减少悬空导致的误触发。开发板上如果已经集成按键和LED那就省事多了直接跳线帽接好就能用。2.2 EXTI的工作机制从引脚电平变化到CPU响应外部中断EXTI的本质是把引脚上的电平变化上升沿、下降沿或者双边沿映射到对应的中断线再由NVIC向CPU发出中断请求。STM32F103一共有16条EXTI线EXTI0到EXTI15对应PA0到PA15也就是说同一编号的引脚只能有一条能映射到该EXTI线。如果PA0和PB0同时使用EXTI0配置时会冲突所以引脚选择上要避开同号引脚重复。整个触发链路是这样的引脚电平变化 - 经过输入数据寄存器采样 - EXTI边沿检测 - 置位挂起寄存器 - NVIC判断优先级和使能状态 - 跳转到对应中断服务函数。我们工作里不需要关心寄存器细节用标准外设库或HAL库配置好就行但脑子里要清楚这链条上每一环都可能成为问题点。比如引脚模式配置错了输入采样就永远读不到变化NVIC没使能就算是EXTI挂起了也不会进中断中断服务函数名字写错链接时找不到入口程序就直接跑飞。开发环境方面我用的是Keil MDK加标准外设库也就是很多人熟悉的固件库。这个组合在资料数量和工程移植上最省心代码里每个外设一个结构体初始化流程一目了然。如果你用STM32CubeMX生成HAL代码逻辑也差不多只是函数名变成了HAL_GPIO_EXTI_Callback核心思路是一样的。3. 核心实现从GPIO配置到中断服务函数的完整代码讲解3.1 按键和LED的GPIO初始化整个工程的起点是GPIO配置。在STM32里任何外设使用前都要打开对应的时钟然后配置引脚模式。按键引脚PA0要做成上拉输入LED引脚PB0要做成推挽输出。这里特别注意按键按下接地所以内部上拉让默认状态是高电平按下时变成低电平这样下降沿就是有效的触发边沿。void GPIO_Config(void) { GPIO_InitTypeDef GPIO_InitStructure; // 打开GPIOA和GPIOB的时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB, ENABLE); // 按键引脚 PA0: 上拉输入 GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IPU; // 上拉输入 GPIO_Init(GPIOA, GPIO_InitStructure); // LED引脚 PB0: 推挽输出 GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; // 推挽输出 GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOB, GPIO_InitStructure); }按键用上拉输入平时引脚读到高电平按下时由于按键另一端接GND引脚被拉低。这种接法的好处是彻底避免了浮空输入时电平随机变化导致的误触发。LED配置成推挽输出输出高电平点亮。速率这里设成50MHz虽然LED用不了这么高的翻转速度但统一配置不容易出错。3.2 EXTI外部中断线配置与NVIC优先级GPIO配置好之后要把PA0关联到EXTI0线。标准库的做法是先配置GPIO的复用功能映射到EXTI然后设置EXTI的触发边沿和使能状态最后在NVIC里打开对应中断通道。void EXTI_Config(void) { EXTI_InitTypeDef EXTI_InitStructure; NVIC_InitTypeDef NVIC_InitStructure; // 把PA0映射到EXTI0 GPIO_EXTILineConfig(GPIO_PortSourceGPIOA, GPIO_PinSource0); // 配置EXTI0: 下降沿触发 EXTI_InitStructure.EXTI_Line EXTI_Line0; EXTI_InitStructure.EXTI_Mode EXTI_Mode_Interrupt; EXTI_InitStructure.EXTI_Trigger EXTI_Trigger_Falling; // 下降沿 EXTI_InitStructure.EXTI_LineCmd ENABLE; EXTI_Init(EXTI_InitStructure); // NVIC配置: 中断通道、优先级、使能 NVIC_InitStructure.NVIC_IRQChannel EXTI0_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority 1; NVIC_InitStructure.NVIC_IRQChannelSubPriority 1; NVIC_InitStructure.NVIC_IRQChannelCmd ENABLE; NVIC_Init(NVIC_InitStructure); }这里GPIO_EXTILineConfig是标准库里专门做引脚到中断线映射的函数。如果跳过这一步即使EXTI0配置了引脚PA0的电平变化也不会送进EXTI0。触发方式选下降沿因为我们的按键按下时引脚从高变低。NVIC优先级里抢占优先级设为1子优先级设为1。这个项目里只有这一个是外部中断源优先级不用太纠结但如果是多中断嵌套的场景就需要注意抢占优先级高的能打断低的。标准库的NVIC配置对分组也有要求通常在main函数开头调用NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2)来设置分组两组抢占优先级、两子优先级。3.3 中断服务函数与高效的主循环逻辑中断服务函数的名字在启动文件里已经定义好了标准库的启动文件中EXTI0_IRQHandler就是这个中断线的入口。函数内部需要先判断中断标志位执行完逻辑后务必清除标志位。否则中断会反复进入卡死主循环。// 外部中断0的服务函数 void EXTI0_IRQHandler(void) { if (EXTI_GetITStatus(EXTI_Line0) ! RESET) { // 按键按下翻转LED GPIO_WriteBit(GPIOB, GPIO_Pin_0, (BitAction)(1 - GPIO_ReadOutputDataBit(GPIOB, GPIO_Pin_0))); // 清除中断挂起标志位否则会反复进入中断 EXTI_ClearITPendingBit(EXTI_Line0); } }中断函数里翻转LED的逻辑比较取巧先读当前输出电平用1减去当前值就是取反。如果你不想用BitAction强转也可以分开写判断读到的输出是1就写0读到的输出是0就写1。主循环则非常轻松不需要任何按键扫描代码int main(void) { // 中断优先级分组2位抢占优先级2位子优先级 NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); GPIO_Config(); EXTI_Config(); while (1) { // 主循环只做其他事情LED由中断处理 } }这个设计把按键逻辑从主循环里完全剥离了。主循环哪怕去跑一个复杂的状态机、做串口打印或者驱动屏幕也不会影响按键响应。中断触发的延迟只在硬件级微秒级别就能完成远比轮询高效。3.4 进中断之前还要不要做软件消抖按键是机械触点按下瞬间会有几毫秒的电平抖动。在轮询方案里通常用延时或者状态机消抖在中断方案里如果直接在中断里消抖延时会阻塞整个中断通道严重的会拖慢其他中断响应。我见过不少初学者在中断服务函数里塞delay_ms(20)结果中断频繁进入时主循环被拖得几乎卡死。常见的做法有两类。一类是不在中断里消抖而是在中断服务函数里只置一个标志位并记录当前系统时间由主循环在合适的时机判断消抖。另一类是使用定时器扫描按键配合中断唤醒。对于纯学习项目我建议用更简单的方案中断里翻转LED后立即清除标志位退出机械抖动可能在短时间内触发多次翻转但最终效果肉眼看不出差别。如果追求严谨就在中断里加入标志位主循环检测到标志位后延时10毫秒再读一次引脚确认电平。4. 工程结构与一键跑通用标准库组织可复用的代码4.1 标准库工程的最小目录结构用Keil MDK新建工程时官方标准库工程模板通常把文件分成几个组。一个精简到不能再精简的工程至少要有四个目录CMSIS存放内核和系统启动相关文件StdPeriph_Driver存放外设库驱动源文件User存放用户代码Startup存放启动汇编文件。STM32_EXTI_Button/ ├── CMSIS/ │ ├── core_cm3.h │ ├── stm32f10x.h │ └── system_stm32f10x.c ├── StdPeriph_Driver/ │ ├── inc/ │ │ ├── stm32f10x_gpio.h │ │ ├── stm32f10x_exti.h │ │ ├── stm32f10x_nvic.h │ │ └── stm32f10x_rcc.h │ └── src/ │ ├── stm32f10x_gpio.c │ ├── stm32f10x_exti.c │ ├── stm32f10x_nvic.c │ └── stm32f10x_rcc.c ├── Startup/ │ └── startup_stm32f10x_hd.s └── User/ ├── main.c ├── stm32f10x_it.c └── stm32f10x_conf.h实际使用中stm32f10x_it.c是专门放中断服务函数的地方。有些教程把EXTI0_IRQHandler写在main.c里也能编译通过但工程规范起见中断函数统一放到stm32f10x_it.c更利于后续维护。4.2 编译配置里最容易翻车的三个选项Keil工程创建好后在Options for Target里需要确认三个关键配置。第一个是Device选择必须和芯片型号一致比如STM32F103C8T6对应的是STM32F103C8如果选成高容量型号外设寄存器地址映射可能不对。第二个是宏定义标准库要求定义STM32F10X_MD中容量或USE_STDPERIPH_DRIVER前者决定启动文件的配置后者决定是否包含外设驱动头文件。第三个是Debug里选择ST-Link或J-Link下载器型号选错会直接导致无法连接目标芯片。这三个配置看着不起眼新手报错往往就在这些地方。比如忘记定义STM32F10X_MD编译时系统时钟配置函数可能使用了错误的分频系数程序能烧录但运行异常这种问题排查半天都找不到根源。4.3 烧录验证的完整步骤烧录前建议先给板子供电确认LED没有异常点亮然后用ST-Link连接到SWD接口。在Keil里点击Download按钮如果一切正常下载器会写入flash并自动复位运行。上电后初始状态应该是LED灭。按下按键LED状态翻转松开按键不会再翻转。如果发现按下时LED闪了一下又恢复或者松手时才翻转多半是触发沿和消抖逻辑的问题。我这里给一个实际的验证思路连续快速按十次按键看LED是否每次都正确翻转。如果有漏翻转说明中断标志位或优先级有冲突如果一次按下去翻转了两次说明抖动导致的重复触发没被过滤。5. 避坑指南按键中断里我踩过的五个真实问题5.1 中断服务函数没有清标志位程序卡死现象按下按键后系统仿佛进入死循环主循环里的代码不再执行用调试器暂停后发现程序停留在EXTI0_IRQHandler内。原因中断标志位未被清除时NVIC会认为该中断一直处于挂起状态退中断后再次进入形成无限中断。解决在EXTI0_IRQHandler里处理完业务后立刻调用EXTI_ClearITPendingBit(EXTI_Line0)。还有一个细节是必须在读取标志位之后、退出函数之前清除顺序搞反会清掉误判。5.2 GPIO_EXTILineConfig配置遗漏中断不触发现象所有配置代码看起来都正确GPIO和NVIC都初始化了但按键怎么按程序都没反应调试器里看到EXTI挂起寄存器始终为0。原因PA0没有通过GPIO_EXTILineConfig映射到EXTI0。标准库里这句话是单独的一步很多人照着教程写却漏了这行。解决在EXTI初始化前调用GPIO_EXTILineConfig(GPIO_PortSourceGPIOA, GPIO_PinSource0)。同时注意如果PB0也用了要独占EXTI0不能和PA0同时映射。5.3 中断服务函数名字写错编译却通过现象工程编译无报错下载后按按键无反应。检查后发现启动文件里有EXTI0_IRQHandler但自己写的函数名是EXTI0_IRQHandler少个字母链接器没有报错是因为它被当成普通函数处理。原因标准库启动文件中每个中断向量都有固定的函数名如果用户函数名不一致中断向量表仍然指向启动文件里的弱定义空函数相当于没写。解决打开启动文件搜索EXTI0_IRQHandler逐字母复制到自己代码里。如果使用HAL库回调函数名HAL_GPIO_EXTI_Callback也一样拼错不会报警告。5.4 中断里执行耗时操作按键响应迟钝现象中断里加了一个串口打印函数或者延时消抖按键按下后LED要几十毫秒才翻转期间其他中断也被拖慢。原因CPU正在执行冗长的中断服务函数其他中断无法抢占同等优先级主循环也被阻塞。解决中断服务函数只做“置标志位”和“清标志位”两个动作具体翻转LED的操作放到主循环里做。如果必须立即翻转那也要先退出中断再去延时不要在中断里消耗时间。5.5 同号引脚冲突PA0和PB0同时配置EXTI现象后来扩展功能时把PB0也配置成外部中断发现原本PA0的中断失效或者两个引脚触发会串扰。原因EXTI0只能由一个引脚映射GPIO_EXTILineConfig将PA0和PB0都映射到EXTI0后配置的覆盖前面的。解决重新选择引脚比如把按键放在PA0其他中断源放在PB1对应EXTI1。设计引脚分配时先把同编号的EXTI线冲突避开这是一个血泪教训。6. 二次开发从单按键到多按键的事件驱动架构改造这个项目最简单的改造是把单按键变成多按键。以三个按键分别控制三个LED为例需要三条中断线EXTI0、EXTI1、EXTI2。对应引脚用PA0、PA1、PA2LED用PB0、PB1、PB2。每个引脚都要配置GPIO输入三个EXTI线分别配置三套NVIC通道。中断服务函数下面这样组织void EXTI0_IRQHandler(void) { if (EXTI_GetITStatus(EXTI_Line0) ! RESET) { button_event_flag | BTN0_PRESSED; EXTI_ClearITPendingBit(EXTI_Line0); } } void EXTI1_IRQHandler(void) { if (EXTI_GetITStatus(EXTI_Line1) ! RESET) { button_event_flag | BTN1_PRESSED; EXTI_ClearITPendingBit(EXTI_Line1); } }主循环里根据button_event_flag的位来分发事件。这里就把“中断触发”和“业务处理”解耦了按键按下后中断只负责登记事件主循环空闲时才执行LED翻转、蜂鸣器发声或者屏幕刷新。这种模式在正式工程里叫事件标志位比直接在中断里操作硬件要稳健得多。如果想做更实用的长按、短按、双击检测中断里需要记录系统时间戳。用systick或TIM2产生一个毫秒时基按键触发时把当前时间存到变量然后在主循环状态机里对比时间差。这个方向比单纯翻转LED有意思也更能体会中断加状态机的威力。我习惯的做法是写一个按键驱动模块把GPIO初始化、EXTI配置、事件标志位封装成独立文件这样换芯片平台时只需要改底层映射。自从我把所有按键逻辑都迁移到这种中断加标志位模式后再也没为按键卡主循环操过心。希望这个项目能让你少走一点弯路。本文还有配套的精品资源点击获取