STM32引脚复用全解析：如何正确配置PB3、PB4、PA15为普通GPIO（含JTAG关闭教程）
在STM32开发中，PB3、PB4和PA15这几个引脚总是让开发者又爱又恨。它们本可以作为普通的GPIO使用，但却默认被JTAG调试接口占用。很多开发者第一次遇到这个问题时，往往会花费大量时间排查为什么引脚配置"看起来没问题"，但实际电平读取或输出却不正常。本文将深入剖析这一现象背后的原理，并提供HAL库和标准库两种环境下的完整解决方案。
1. 理解STM32引脚复用的核心机制
STM32的引脚复用功能是其强大灵活性的体现，但也带来了配置上的复杂性。每个GPIO引脚在芯片内部通过多路复用器连接到不同的外设，这种设计允许有限的物理引脚支持更多功能。对于PB3、PB4和PA15这几个特殊引脚，它们的默认功能是JTAG调试接口：
- PA15：JTDI (JTAG数据输入)
- PB3：JTDO (JTAG数据输出)
- PB4：JNTRST (JTAG复位)
当芯片上电时，这些引脚默认被分配给JTAG功能，而不是作为普通GPIO。这就是为什么直接配置这些引脚为输入/输出模式时，往往无法得到预期结果。
提示：即使你不使用JTAG调试器，这些引脚的JTAG功能默认也是启用的，必须显式关闭才能作为普通GPIO使用。
2. 关闭JTAG功能的完整步骤
2.1 基础配置：禁用JTAG功能
无论是使用HAL库还是标准库，关闭JTAG功能的基本流程相似：
- 使能AFIO时钟（配置复用功能必须）
- 重映射SWJ调试接口配置
- 配置所需引脚为普通GPIO模式
HAL库实现代码示例：
__HAL_RCC_AFIO_CLK_ENABLE(); // 使能AFIO时钟 __HAL_AFIO_REMAP_SWJ_NOJTAG(); // 禁用JTAG，保留SWD标准库实现代码示例：
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE); GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);2.2 高级配置：处理异步跟踪模式(TRACESWO)
在某些情况下，仅禁用JTAG可能还不够。特别是当PB3用作输入时，它可能仍被配置为TRACESWO（异步跟踪调试信号）。此时需要额外禁用DBGMCU中的相关位：
DBGMCU->CR &= ~((uint32_t)1<<5); // 关闭异步跟踪模式完整的初始化代码应该放在HAL_MspInit()函数中（HAL库）或系统初始化阶段（标准库）。
3. 不同开发环境下的具体实现
3.1 HAL库完整配置示例
对于使用STM32CubeMX生成的HAL库项目，建议在HAL_MspInit()中添加以下代码：
void HAL_MspInit(void) { __HAL_RCC_AFIO_CLK_ENABLE(); __HAL_AFIO_REMAP_SWJ_NOJTAG(); /* 禁用异步跟踪模式 */ DBGMCU->CR &= ~((uint32_t)1<<5); /* 可选：明确设置引脚映射 */ AFIO->MAPR = (AFIO->MAPR & ~((uint32_t)0x7 << 24)) | (2 << 24); }3.2 标准库完整配置示例
对于使用标准外设库的项目，配置代码如下：
// 系统初始化阶段 RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE); GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); DBGMCU->CR &= ~((uint32_t)1<<5); // GPIO配置阶段 GPIO_InitTypeDef GPIO_InitStruct; GPIO_InitStruct.GPIO_Pin = GPIO_Pin_3 | GPIO_Pin_4; // PB3, PB4 GPIO_InitStruct.GPIO_Mode = GPIO_Mode_Out_PP; // 推挽输出示例 GPIO_InitStruct.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStruct);4. 实际应用中的注意事项
调试接口选择：禁用JTAG后，只能使用SWD模式调试。大多数现代调试器（如ST-Link）都支持SWD，但某些老旧工具可能需要特别配置。
引脚冲突检测：使用STM32CubeMX工具时，它会自动检测引脚功能冲突。手动配置这些特殊引脚时，工具会显示警告，此时需要确认确实要覆盖默认功能。
复位后状态：这些配置通常在系统初始化阶段完成。如果进行软件复位，配置会保持；但硬件复位后需要重新配置。
不同系列差异：虽然大多数STM32系列处理方式相似，但某些新系列（如STM32H7）可能有细微差别，建议查阅对应型号的参考手册。
性能考量：当这些引脚用作高速输出时，要注意GPIO速度设置与电路设计匹配，避免信号完整性问题。
5. 典型问题排查指南
遇到PB3/PB4/PA15无法正常工作时，可以按照以下步骤排查：
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 输出无反应 | JTAG功能未禁用 | 检查是否调用了__HAL_AFIO_REMAP_SWJ_NOJTAG()或等效函数 |
| 输入始终为低 | 异步跟踪模式未关闭 | 添加DBGMCU->CR &= ~(1<<5); |
| 配置后仍无效 | AFIO时钟未使能 | 确认__HAL_RCC_AFIO_CLK_ENABLE()已调用 |
| 下载失败 | 调试接口配置错误 | 检查是否保留了SWD功能，或尝试按住复位键下载 |
在项目开发中，我习惯将这些特殊引脚的配置封装成单独的函数，并在系统初始化时显式调用，这样既提高了代码可读性，也便于后续维护和移植。例如：
void Configure_JTAG_Pins_As_GPIO(void) { // HAL库版本 __HAL_RCC_AFIO_CLK_ENABLE(); __HAL_AFIO_REMAP_SWJ_NOJTAG(); DBGMCU->CR &= ~((uint32_t)1<<5); // 可以在此继续配置具体引脚模式 GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_3|GPIO_PIN_4; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); }
