STM32F100（KEIL环境）USART1接收中断失效问题排查

问题背景 #

我编写了一段STM32代码，功能如下：

• 按键触发外部中断后，通过USART1发送字符“1”到终端
• 当USART1接收到字符“0”时，熄灭LED

使用KEIL 5编译时，按键中断可正常触发并发送“1”，但从终端发送“0”到MCU时，USART1_IRQHandler完全无法进入，LED无响应。

随后我在STM32CubeIDE中创建项目，复用了相同的UART_Init和USART1_IRQHandler函数（未添加手动引脚配置代码），自动生成的代码却能正常接收终端消息并执行LED熄灭逻辑。

疑问 #

1. KEIL代码中USART1接收中断失效的原因是什么？（推测与USART引脚配置相关）
2. CubeIDE代码中是否存在USART引脚（PA9/PA10）配置？HAL库在哪里完成该配置？

补充说明 #

• KEIL代码中EXTI0_IRQHandler（按键中断）工作正常，仅USART1_IRQHandler未执行
• CubeIDE代码中USART1_IRQHandler工作正常，但未显式看到USART引脚配置代码

解答 #

1. KEIL代码中USART1接收中断失效的原因 #

你的推测正确，核心问题大概率是USART引脚复用配置缺失，具体包含以下几点：

• GPIO时钟或复用功能未开启：USART1的TX/RX引脚（PA9/PA10）依赖GPIOA时钟，同时USART1外设时钟也需开启。若只开启了USART1时钟、漏了GPIOA时钟，会直接导致引脚功能失效。
• 引脚模式配置错误：
  • PA9（USART1_TX）必须配置为复用推挽输出模式
  • PA10（USART1_RX）必须配置为浮空输入/上拉输入模式（需匹配硬件电路）
• 接收中断未完整使能：需确认USART_CR1寄存器的RXNEIE位已置1，同时NVIC中USART1中断通道已开启——发送正常不代表接收中断配置完成，很多开发者会遗漏这一步。
• 硬件连接排查：虽然CubeIDE下功能正常，仍需确认PA10引脚的焊接、连线是否牢固，电平转换电路是否正常（概率较低，但需排除）。

2. CubeIDE中USART引脚的配置位置 #

CubeIDE自动生成的代码里，引脚配置不会直接出现在你复用的UART_Init或中断函数中，而是封装在自动生成的MX_GPIO_Init()函数里：

• 代码路径：Core/Src/gpio.c，函数内包含PA9/PA10的复用配置，示例代码如下：

GPIO_InitTypeDef GPIO_InitStruct = {0};

/* GPIO Ports Clock Enable */
__HAL_RCC_GPIOA_CLK_ENABLE();

/*Configure GPIO pin : PA9 */
GPIO_InitStruct.Pin = GPIO_PIN_9;
GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF7_USART1;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

/*Configure GPIO pin : PA10 */
GPIO_InitStruct.Pin = GPIO_PIN_10;
GPIO_InitStruct.Mode = GPIO_MODE_AF_INPUT;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Alternate = GPIO_AF7_USART1;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

另外，CubeIDE会根据你在图形化配置界面中对USART1的设置，自动完成以下操作：

• 开启GPIO时钟、USART外设时钟
• 配置引脚的复用功能映射（如GPIO_AF7_USART1）
• 配置NVIC中断优先级
  这些配置都被封装在自动生成的初始化函数里，因此你看不到显式的手动配置代码。

内容的提问来源于stack exchange，提问作者RUMBUFDSI