【产出】 > 用 STM32 外部中断(EXTI)检测按键:在 CubeMX 里配置中断引脚和触发沿,写好回调函数,处理按键抖动,并避开"中断里调用 HAL_Delay 卡死""多个引脚共用中断线"这些常见坑。
【版本】 > 依据 ST 官方 STM32F4 HAL 驱动源码中的 GPIO 使用说明(stm32f4xx_hal_gpio.c)编写,F1 / F4 / G4 等系列通用(G0、U5 等新系列的回调分为上升沿和下降沿两个函数,文中单独说明)。
一、HAL 官方给出的 GPIO 用法要点
ST 驱动源码里的说明:
- 先用
__HAL_RCC_GPIOx_CLK_ENABLE()打开 GPIO 时钟,再用HAL_GPIO_Init()配置引脚。 - 配置项包括:模式(Mode)、上下拉(Pull)、输出速度(Speed)、复用功能(Alternate)。
- 选择外部中断 / 事件模式时,Mode 同时决定类型(中断还是事件)和触发沿(上升、下降或双沿)。
- 外部中断还要用
HAL_NVIC_SetPriority()设置该 EXTI 线的优先级,并用HAL_NVIC_EnableIRQ()打开。 - 复位期间和复位刚结束时,复用功能未生效,GPIO 默认是浮空输入(JTAG 引脚除外)。
最后一条说明:按键引脚必须配置上拉或下拉,否则松开时引脚是悬空的,会误触发。
二、CubeMX 配置
以按键接在 PA0、按下时接地为例:
- 在引脚图上点击 PA0,选择 GPIO_EXTI0。
- System Core → GPIO → PA0:
- GPIO mode:External Interrupt Mode with Falling edge trigger detection(下降沿触发,因为按下时电平从高变低)
- GPIO Pull-up/Pull-down:Pull-up
- System Core → NVIC:勾选 EXTI line0 interrupt。
- 保存生成代码。
三、回调函数
CubeMX 生成的中断服务函数会调用 HAL_GPIO_EXTI_IRQHandler(),它清除中断标志后,再调用用户回调。你只需要在 main.c 里实现回调:
/* USER CODE BEGIN PV */
volatile uint8_t key_pressed = 0;
/* USER CODE END PV */
/* USER CODE BEGIN 4 */
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
if (GPIO_Pin == GPIO_PIN_0) {
key_pressed = 1; /* 只置标志,具体处理放到主循环 */
}
}
/* USER CODE END 4 */
主循环:
while (1)
{
if (key_pressed) {
key_pressed = 0;
HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
}
}
【注意】 > 不要在中断回调里调用
HAL_Delay()。HAL_Delay依赖 SysTick 中断计数。只要 SysTick 的抢占优先级不高于当前这个 EXTI 中断(在 CubeMX 的 NVIC 页面可以看到两者的优先级),在 EXTI 中断里等待时 SysTick 就进不来,计数不会增加,程序会永远卡在这里。即使优先级刚好允许,在中断里长时间等待也会拖慢整个系统。中断里只做最简单的事:置标志、记时间、拷贝数据。
四、按键消抖
机械按键按下时触点会弹跳几毫秒,一次按下可能触发好几次中断。常用的做法是在回调里记录时间,间隔太短的触发直接忽略:
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
static uint32_t last = 0;
if (GPIO_Pin == GPIO_PIN_0) {
uint32_t now = HAL_GetTick();
if (now - last > 50) { /* 50 ms 内的重复触发视为抖动 */
key_pressed = 1;
last = now;
}
}
}
HAL_GetTick() 只是读取一个计数值,不会等待,在中断里调用是安全的。硬件上也可以在按键两端并联一个 100 nF 电容滤除抖动。
五、EXTI 线的分配规则
每个引脚号对应一条 EXTI 线:PA0、PB0、PC0……都接在 EXTI0 上,PA1、PB1 都接在 EXTI1 上,以此类推。
由此有两条限制:
- 同一个引脚号只能有一个端口用作外部中断。PA0 和 PB0 不能同时作为中断引脚,CubeMX 里选了一个,另一个就选不了。
- EXTI5–9 共用一个中断服务函数(
EXTI9_5_IRQHandler),EXTI10–15 共用EXTI15_10_IRQHandler。HAL 会把具体的引脚号作为GPIO_Pin参数传给回调,所以回调里一定要先判断GPIO_Pin,再决定做什么。
六、新系列的回调不一样
STM32G0、U5、H5 等较新的系列,HAL 把回调拆成两个:
void HAL_GPIO_EXTI_Falling_Callback(uint16_t GPIO_Pin);
void HAL_GPIO_EXTI_Rising_Callback(uint16_t GPIO_Pin);
在这些系列上实现 HAL_GPIO_EXTI_Callback 不会被调用。以你的芯片对应的 HAL 头文件 stm32xxxx_hal_gpio.h 中声明的回调为准。
七、常见问题
| 现象 | 原因与处理 |
|---|---|
| 按键完全没反应 | NVIC 里没勾选对应 EXTI 线中断;或者回调函数名拼错了(弱函数不会报错,只是不会被调用) |
| 松手也会触发、乱触发 | 没配上拉 / 下拉,引脚悬空 |
| 按一下触发多次 | 按第四节消抖 |
| 程序卡死在中断里 | 回调里调用了 HAL_Delay() |
| 两个按键只有一个能用 | 两个引脚的引脚号相同(如 PA3 和 PB3),换一个引脚号 |
参考资料
- ST 官方 STM32F4 HAL 驱动源码(stm32f4xx_hal_gpio.c):https://github.com/STMicroelectronics/stm32f4xx-hal-driver
评价 (0)