企业官网建设流程全解析

写代码最爽的时刻，就是按下按键，程序立刻放下手头的活儿去响应你的那一刻。GD32外部中断做的正是这件事：CPU不用一直盯着引脚，而是等引脚出现我们设定好的边沿变化时，自动跳进对应的中断服务函数处理。这篇笔记是GD32学习之路的第三篇，目标是把外部中断里的EXTI配置、NVIC优先级、中断服务函数这些点一个个掰开揉碎讲清楚。我手头用的是一颗很常见的Cortex-M3内核GD32F10x系列芯片，代码基于官方标准固件库V2.x版本，不同库版本函数名会有差异，但整体思路完全一致。

这篇文章适合刚点亮过LED、跑过GPIO输出，正准备给系统加按键、加传感器边沿信号、加低功耗唤醒的嵌入式入门者。看完之后你不仅会写一个能用的外部中断程序，更知道为什么这么写，以及出问题的时候应该先去查哪里。

1. 先搞懂“外部中断”到底在干什么

1.1 轮询的麻烦，中断的价值

先想一个场景：你在餐厅里同时照看五六桌客人。轮询的做法是每隔几秒挨桌问一遍“需要什么吗”，大部分时间浪费在无效询问上，真正有客人举手的时候又可能反应慢了半拍。中断的做法是你专心干自己的事，客人按铃你才过去。

CPU处理外部信号也是这样，如果你写一个大循环不断读GPIO电平，叫“轮询”。轮询的缺点有两方面：第一，主循环被占得死死的，循环里其它事情全被拖慢；第二，从信号发生变化到你读到引脚电平，中间隔了好几轮循环的时间，实时性很难保证。外部中断就是为了解决这两个问题而存在的：把“一直盯着”变成“等信号来了再说”，CPU在空闲时可以去算数据、刷新屏幕、跑通信协议，一旦引脚出现设定好的跳变，执行现场自动被打断，跳进专门的函数处理这个变化。

1.2 一次外部中断是怎么走完整个流程的

外部中断的完整流程，从硬件角度看大致是这样：

引脚电平发生跳变，边沿检测电路发现这个事件，对应中断线上挂起状态位被置1；这个请求被送往NVIC，也就是嵌套向量中断控制器；NVIC根据你设置的优先级决定是否响应，如果允许就向CPU发出中断信号；CPU暂停当前指令，把现场压栈保存，自动跳转到对应的中断服务函数执行；函数处理完，恢复现场，回到刚才断掉的地方继续干活。

这里面有两个细节初学者容易忽略。第一，挂起标志必须清掉，否则中断可能反复被触发，表现为程序看起来“卡死”或者疯狂进中断。第二，GD32的外部中断不是“引脚发生电平变化立即执行函数”这么简单，中间还隔着一层EXTI线映射和一层NVIC优先级裁决，后面会专门拆开讲。

1.3 什么样的场景才适合用外部中断

外部中断最适合的是“事件型”信号。按键按下的瞬间，霍尔传感器检测到遮挡，红外遥控头输出脉宽，流量计发出脉冲，这些都属于事件，用中断处理可以做到准确又省电。尤其低功耗场景，芯片进入睡眠状态后，主循环已经停了，轮询彻底失效，只有外部中断能在电平变化时把芯片唤醒，这是很多手持设备的标准做法。

但中断不是万能的。如果信号本身是高速连续变化的，比如一直输出的编码器脉冲、高频PWM输入，你用中断去逐个捕获，可能会频繁打断主循环，产生中断风暴，反而把系统拖垮。这类场景更适合用定时器捕获或者DMA。外部中断解决的是“偶尔发生、需要立即响应”的问题，这个定位先想清楚，后面写代码才不会乱用。

2. 动手前把这些概念理清，后面就不会一头雾水

2.1 EXTI线不是“引脚专用线”：编号规则与映射

GD32的外部中断控制器，也就是EXTI，对外提供多条中断线路。其中跟GPIO相关的部分是EXTI_0到EXTI_15共16条线。关键点来了：这16条线不是某一颗引脚专用的，而是按“引脚编号”并联在一起。PA0、PB0、PC0、PD0……所有端口上编号为0的引脚，全部汇到EXTI_0这一条线上；PA1、PB1、PC1这些编号为1的引脚，汇到EXTI_1，以此类推。

这就带来一个很常见的坑：同一时间，一条EXTI线上只能选择一个引脚作为中断源。你不能同时又用PA0又用PB0去做外部中断，因为它们都挂在EXTI_0上。程序里后配置的那个通常会覆盖前面的映射，或者干脆乱套。所以做设计的时候，一定要先确认几个想用中断的引脚是否处于不同的编号。

那“把PA0挂到EXTI_0”这个动作是怎么完成的？靠的是GPIO控制器里的外部中断复用功能，在GD32的固件库里主要就是gpio_exti_source_select这类函数，把某个端口的某个引脚引到对应的EXTI线上。这一步很多人会漏掉，总以为GPIO配成输入模式就完事了，结果中断死活不触发，后面排查清单会再讲。

2.2 上升沿、下降沿和双沿，什么时候该选哪种

外部中断的触发方式一共有三种：上升沿触发、下降沿触发、双沿触发。选哪种取决于你要观察的信号极性。

我举个最常见的例子。机械按键一端接GPIO引脚，另一端接GND，引脚内部配置成上拉输入。按键没按下去的时候引脚是高电平，按下去之后变成低电平，松开又变回高电平。要捕捉“按下”这个动作，应该使用下降沿触发，因为按键导通的那一刻，电平是从高往低跳变的。反过来，如果按键接的是VCC，引脚配置成下拉输入，按下时从低变高，那就用上升沿触发。

这里有个容易被问到的点：GD32的EXTI标准库只支持边沿触发，也就是跳变沿，不支持传统意义上的“持续电平触发”。如果你想实现“引脚保持低电平期间做某个动作”这种逻辑，不能直接靠EXTI完成，正确的姿势是用边沿中断记录一下状态，然后在主循环里再去读引脚电平确认，或者用外部逻辑电路配合。

另外有一条红线必须记住：千万不要用悬空的引脚做外部中断。浮空输入的状态是不确定的，周围电磁干扰稍微波动一下，引脚电平就可能来回跳，中断会被疯狂误触发。哪怕信号来源只是一个按键，也至少要配置成内部上拉或者下拉输入，让默认电平稳定下来。

2.3 NVIC优先级分组：几个抢断位、几个子优先级

NVIC的名字比较唬人，实际理解起来没那么难。外部中断产生之后，信号不是直接进CPU，而是先排队经过NVIC这道关卡。NVIC根据优先级决定：现在这个中断能不能立刻执行，能不能打断正在执行的中断。

优先级里有“抢占优先级”和“子优先级”两套概念，我用一个更生活化的比喻。抢占优先级决定的是插队权，数字越小的抢占优先级越高。如果两个中断同时来，抢占优先级低的必须等着，抢占优先级高的可以打断正在执行的低优先级中断。子优先级只在抢占优先级相同的时候起作用，也就是两个人插队权一样，那只能按先来后到排队看谁先执行。

GD32F10x这类芯片的优先级编码通常一共4位，你可以通过优先级分组寄存器来切分。比如把4位分成2位抢占优先级、2位子优先级，也可以分成1位抢占、3位子优先级，或者干脆全部当成抢占优先级。这本身没有绝对对错，但有一条原则要刻在脑子里：整个工程里优先级分组只能设定一次，一旦你决定用某种切分方式，后面所有中断设置都按这个规则来，中途乱改会导致之前设置的所有中断优先级含义发生变化，调试查到你崩溃。

实际项目里，外部中断一般设成中等偏高的抢占优先级就够了，不需要最高。因为真正最紧急的时基中断、通信中断往往需要保障，按键这种事件响应稍微慢那么几十微秒完全没影响。我在示例里把抢占优先级设为1、子优先级设为0，就是一个适合大多数场景的配置。

2.4 中断服务函数与中断线的关系

很多初学者会以为16条EXTI线就有16个独立的中断服务函数，这是误区。看启动文件里的中断向量表可以发现，GD32把外部中断编成了若干个IRQ Handler：

这意味着，如果你用了EXTI_5和EXTI_6两条线，它们共享同一个EXTI5_9_IRQHandler函数。在服务函数里，必须先逐个读取挂起标志，判断这次到底是哪条线触发的，再分别处理。只写一个处理逻辑然后结尾统一清标志，是调试里最容易出问题的写法，两个按键共存的场景经常因此互相干扰。

3. 实操：按键触发外部中断翻转LED

3.1 硬件准备与接线

这一节按“最小可跑系统”来做，东西非常少：一块GD32F10x核心板，一个轻触按键，一颗LED，一个几百欧的限流电阻。

接线建议：按键一端接PA0，另一端接GND，PA0配置成内部上拉输入；LED正极串一个470欧电阻接PC0，负极接GND。这样接的好处是，PA0默认状态是稳定的高电平，按键按下去那一刻产生一个明确的下降沿，正好对应我们想用的下降沿触发。PC0作为普通推挽输出，用主循环或者中断直接翻转电平就能点亮熄灭LED。

如果你用的核心板上按键和LED已经固定焊在某个引脚，那也没关系，根据实际引脚编号调整代码里的宏定义就行，核心逻辑一个字都不用改。

3.2 时钟、线映射、EXTI、NVIC四步初始化

外部中断的初始化代码总共分四步，缺一不可。第一步，开时钟。GPIOA、GPIOC、复用功能AFIO这三个时钟都要开，少一个都会出问题。GPIO时钟不开，引脚配置无效；AFIO时钟不开，引脚到中断线的映射根本不会生效。我见过不少人GPIO时钟开了、EXTI代码也写了，唯独忘了AFIO，排查半天没结果。

第二步，配置GPIO。PA0要配置成上拉输入，PC0配置成推挽输出。需要注意，外部中断并不要求GPIO配置成复用功能，普通输入模式就可以，它跟UART和SPI那种复用引脚是两回事。

第三步，选择EXTI线来源，把PA0映射到EXTI_0，然后把EXTI配置成下降沿触发、中断模式、使能状态。

第四步，NVIC使能EXTI0_IRQn，设置抢占优先级和子优先级。

完整代码我贴在下面，基于GD32F10x标准固件库V2.x的API风格：

#include "gd32f10x.h" volatile uint8_t exti_flag = 0; static void gpio_config(void) { rcu_periph_clock_enable(RCU_GPIOA); rcu_periph_clock_enable(RCU_GPIOC); rcu_periph_clock_enable(RCU_AF); /* PA0接按键，配置成上拉输入，默认高电平 */ gpio_init(GPIOA, GPIO_MODE_IN_PU, GPIO_OSPEED_50MHZ, GPIO_PIN_0); /* PC0接LED，推挽输出 */ gpio_init(GPIOC, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_0); gpio_bit_reset(GPIOC, GPIO_PIN_0); } static void exti_config(void) { /* 把PA0这一路引到EXTI_0线 */ gpio_exti_source_select(GPIO_EVENT_PORT_SOURCE_GPIOA, GPIO_EVENT_PIN_SOURCE_0); /* 下降沿触发，中断模式，使能 */ exti_init(EXTI_0, EXTI_MODE_INTERRUPT, EXTI_TRIG_FALLING); exti_interrupt_enable(EXTI_0); } static void nvic_config(void) { /* 使能EXTI0中断，抢占优先级1，子优先级0 */ nvic_irq_enable(EXTI0_IRQn, 1U, 0U); } void EXTI0_IRQHandler(void) { if (exti_interrupt_flag_get(EXTI_0) != RESET) { exti_interrupt_flag_clear(EXTI_0); /* 实际项目里建议只置标志位，这里为了演示直接翻转LED */ exti_flag = 1; gpio_bit_toggle(GPIOC, GPIO_PIN_0); } } int main(void) { gpio_config(); exti_config(); nvic_config(); while (1) { /* 主循环可以放心去干别的事 */ } }

关于代码有两点要说明。第一，不同版本的固件库函数名会有细微差别，有的旧版库可能叫EXTI_Init传结构体，有的函数叫exti_flag_clear而不是exti_interrupt_flag_clear。如果编译器报函数找不到，直接去gd32f10x_exti.h和gd32f10x_gpio.h两个头文件里搜一下当前库里的实际名字，很容易对上。

第二，volatile关键字不是可有可无。中断服务函数里要改变一个变量，这个变量又在主循环或者其它地方被读取，编译器不知道它会被“外部事件”修改，开启优化之后可能把读操作优化掉，导致主循环永远看不到变化。看到这里如果你觉得“我平时没加volatile也能跑啊”，多半是因为你的优化等级是0，等真正开-O2就会发现各种诡异问题。

3.3 按键抖动与消抖，不处理迟早要吃亏

机械按键有一个非常“物理”的问题：触点闭合的瞬间，金属簧片不会一次稳定接触，而是在几毫秒内反复通断。这个现象叫抖动，反映到GPIO上就是电平在下沉过程中连续产生多个跳变。

如果你用边沿触发去抓按键按下，一次物理按键可能带来好几次中断。演示程序里只是翻转LED，你可能看不出多大问题，但如果中断里做计数，按下一次计数器不是加1而是加了好几，甚至几十，调试的时候你会特别怀疑人生。

硬件消抖是在按键两端并联一个RC滤波电路，让电平变化变“钝”，软件消抖则是在检测到首次边沿后等10到20毫秒，再确认引脚状态是不是稳定在目标电平上。这里有个工程经验要分享：不要在中断服务函数里写太长的延时去消抖。中断里趴20毫秒不动，等于把整个系统的高优先级响应都堵在后面，万一这期间来了更重要的中断，轻则响应变慢，重则直接丢事件。更合理的做法是中断服务函数里只做最轻量的动作，比如置一个标志位，然后回到主循环里检测标志、再延时确认、处理业务。

3.4 中断服务函数要守住的底线

写中断服务函数，有三件事我强烈建议绝对不要在函数里做。第一，不要在里面写毫秒级延时，上面刚说过，这是阻塞整个系统的头号元凶。第二，不要在里面调用调试串口打印，串口打印本身要等发送完成，速度又慢，次数多了主循环明显卡顿。第三，不要在中断里做复杂运算或者访问外设的长时间操作，比如读SD卡、解析协议帧。

中断服务函数的正确姿势是“快进快出”：进来先判断是不是本线触发，清掉标志，能置标志位就置标志位，能翻转IO就翻转IO，需要传递给主循环的数据简单写进缓冲区，然后立刻返回。至于这个按键对应的是切换页面、发送报文还是保存参数，全部放到主循环里去慢慢处理。这样中断占用时间被压缩到几微秒以内，系统整体实时性才是健康的。

4. 进不了中断、中断卡死、误触发：真实调试记录

这一节我想把实际调试中遇到频率最高的问题列一个排查清单，每个问题都配上检查点。这些坑不是我编的，是在实验室里被一个个踩出来的，写出来帮你省时间。

4.1 中断完全不进服务函数，先按这条清单查

中断一点反应都没有，优先级最高的问题。很多人第一反应是“EXTI配置错了”，但实际统计下来，真正丢三落四的地方更多。

排查看上去步骤多，但实际做起来很快：打开调试器，先看GPIO配置寄存器和EXTI寄存器，再在中断服务函数入口设一个断点。如果断点根本没进去，肯定是中断信号没走到CPU，问题出在“线映射—EXTI—NVIC”这一段，逐个查过去一定有收获。

4.2 一进中断整个程序就卡死

这个问题的典型表现是：按键一按，程序跑飞或者停在某个地方不动了，重启之后又恢复。

最常见的原因是挂起标志没清。中断服务函数执行完，如果挂起状态还处于置位状态，中断控制器会再次把请求发上来，导致函数被反复进入。如果函数里恰好又翻转了LED，你看到的现象就是LED在快速闪烁或者系统“假死”。解决方式很暴力也很简单，进场第一件事清理挂起标志。

第二个常见原因是中断服务函数里用了while等待某个条件成立，而这个条件恰恰需要更高级别的中断配合才能成立，一旦这个中断本身是最高优先级又卡在等待上，系统就形成了死锁。排查方法是在函数开头打硬件断点，看看是不是每一次进入都被卡在同一行，如果是，立刻检查是否有等待条件。

4.3 按键按一下，程序却处理了好几次

处理了多次，优先怀疑抖动。机械开关指那种最普通的轻触按键，按下时在接触上单跳个三五次再正常不过。先确认引脚配置是不是上拉输入，再检查信号线上有没有外部干扰。附近如果有继电器或者电机，电源毛刺串到IO上也会导致误触发。

调试这个问题的标准动作是用示波器看引脚波形。波形上如果有明显的连续毛刺，那就是抖动，需要软件消抖。波形很干净但程序依然多触发，回头检查你是不是同时在EXTI这条线上配置了上升沿和下降沿，双沿触发会把一个按下动作识别成两次事件。

4.4 多条线共用同一个中断服务函数怎么处理

前面表格里写过，EXTI5到EXTI9共用EXTI5_9_IRQHandler，EXTI10到EXTI15共用另一个。工程里按键往往不止一个，共用handler非常常见。标准写法是从高位到低位逐个判断挂起标志。

void EXTI5_9_IRQHandler(void) { if (exti_interrupt_flag_get(EXTI_5) != RESET) { exti_interrupt_flag_clear(EXTI_5); /* 处理按键1 */ } if (exti_interrupt_flag_get(EXTI_6) != RESET) { exti_interrupt_flag_clear(EXTI_6); /* 处理按键2 */ } }

这里有一个经验：标志处理要“先清后做”。人有一种习惯，想着处理完业务逻辑再清标志，但如果在处理业务时来了更高优先级的中断，或者业务里碰巧有阻塞，同一根线上的新事件就会被覆盖掉。先清的好处是保证每一次触发都被“记账”，即便业务没做完，至少下次还能接着处理。

4.5 变量被优化掉，逻辑怎么改都“不对”

有一种非常隐蔽的bug：中断里改了标志位，主循环里判断这个标志，明明功能逻辑全对，但程序就是不按预期走。尤其是你开了编译器优化之后，这类问题会更频繁地冒出来。

原因就是编译器认为这个变量没在中断上下文以外被修改过，把读写操作优化到寄存器里，主循环读到的永远是旧值。解决办法很简单：定义标志变量时加上volatile修饰。我建议把所有中断服务函数和主循环共享的变量统一加volatile，不管现阶段优化等级是多少，都养成习惯。

4.6 没有示波器和调试器怎么排查

很多学习板只有一个USB转串口，没有调试器。这种情况下最实用的两个招：LED大法和串口大法。中断服务函数里翻转一个空闲GPIO，示波器没有就用肉眼观察LED闪得正不正常；或者定义一个全局计数器，主循环每秒打印一次计数器数值，数变化规律判断中断触发频率。

还有一个小技巧，进入中断服务函数时，在函数开头置一个高电平，函数末尾拉低，用示波器观察这个IO的高电平宽度，就能精确测出中断服务函数实际占用了多长时间。这个方法在优化中断响应时非常直观，属于老工程师手里最实用的观察手段。

5. 学完外部中断，还可以往这几个方向延伸

5.1 外部事件模式：中断的“安静”版本

GD32的EXTI除了中断模式，还有一种事件模式。两者的区别很微妙：中断模式会进入中断服务函数执行代码；事件模式只产生一个事件，用来唤醒外设或触发其它硬件动作，但不进入CPU中断上下文。这有什么用？有些低功耗场景里，你既想让某个外设被引脚电平变化唤醒，又不想让CPU频繁被打断，就可以使用外部事件模式。这个知识点绝大多数教程都会跳过，但实际做低功耗产品时会遇到，先有个印象，后面用到的时候不会抓瞎。

5.2 从按键中断升级到低功耗唤醒

外部中断自己已经能唤醒睡眠中的CPU了，所以学习外部中断，其实是你迈向低功耗开发的第一级台阶。把第3节的例程改一改，配置好外部中断后调用WFI或者STOP命令进入睡眠，按键一按，芯片就能从睡眠状态醒来继续运行。这里有两个细节要注意：唤醒之后要检查一下中断源是不是自己期望的那个按键，防止误唤醒；低功耗模式下外部中断的上拉下拉配置可能失效，得看芯片手册确认IO状态是否保持。

5.3 把中断设计成“事件通知机制”，而不是简单的函数回调

我见过不少初学者把外部中断用得很“重”：按键按一下，直接在中断里执行页面切换、参数保存、通信发送。短时间看功能正常，时间长了你就会发现系统扩展起来很痛苦，代码一多，中断服务函数里塞满了各种业务逻辑，动一处牵全身。

实际开发里更推荐的思路是：把外部中断当作一个“事件通知器”，它只负责准确、及时地告诉主循环“某个外部事件发生了”，具体事件是什么、要执行什么动作，全部放到主循环的事件调度里去处理。这样中断保持轻量，主循环逻辑清晰，以后加第二路按键、加传感器事件、加定时器事件，都是在事件调度器里扩展，而不是继续往中断函数身上堆。

我在实际调试中形成的一个习惯是：每个中断服务函数的前三行永远是“判断标志、清标志、置事件标志”，再多一样都不写。刚开始觉得这样多此一举，后来做低功耗和通信项目时才发现，正是这种克制的写法让我少踩了大量难以复现的坑。学习外部中断，学的不只是那几个寄存器怎么配，更是一种“让最紧急的事情用最短时间处理完，然后立刻把控制权交还主循环”的工程思维。