1. STM32F103的PB4引脚功能冲突解析
在STM32F103系列单片机开发过程中，PB4引脚的功能配置是一个容易被忽视但极其重要的问题。这个引脚在芯片复位后默认被映射为JTAG接口的NJTRST功能，而非普通的GPIO。这种设计源于STM32芯片的调试接口复用机制。
重要提示：如果开发者未正确配置PB4引脚而直接将其作为普通GPIO使用，可能导致无法预测的行为，包括信号异常、功能失效甚至影响整个调试系统。
JTAG（Joint Test Action Group）是一种标准的调试接口协议，STM32通过JTAG接口提供芯片级的调试能力。在STM32F103上，调试接口与部分GPIO引脚复用，具体包括：
- PA13：JTMS/SWDIO
- PA14：JTCK/SWCLK
- PA15：JTDI
- PB3：JTDO
- PB4：NJTRST
这种复用设计虽然节省了引脚资源，但也带来了使用上的复杂性。特别是当我们需要使用这些引脚作为普通GPIO时，必须首先正确处理调试接口的配置。
2. 调试接口配置方案对比
2.1 完全禁用JTAG和SWD（不推荐）
理论上可以通过以下代码完全禁用调试接口：
c复制GPIO_PinRemapConfig(GPIO_Remap_SWJ_Disable, ENABLE);
但这种做法存在严重问题：
- 将失去所有调试能力，包括SWD
- 一旦程序出现问题，无法通过调试器连接芯片
- 需要重新烧录才能恢复调试功能
2.2 保留完整JTAG功能（默认状态）
这是芯片上电后的默认状态，所有调试引脚保持JTAG功能：
- 优点：完整的调试功能
- 缺点：PB4、PB3、PA15等引脚无法作为GPIO使用
2.3 禁用JTAG但保留SWD（推荐方案）
这是大多数实际项目的最佳选择：
c复制RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);
这种配置：
- 释放PB4(PB4)、PB3(PB3)和PA15(PA15)用作普通GPIO
- 保留SWD调试功能（通过PA13和PA14）
- 不影响后续的调试和程序更新
3. 具体实现方法与代码详解
3.1 标准外设库实现
对于使用标准外设库的项目，配置步骤如下：
- 首先启用AFIO时钟：
c复制RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
这一步至关重要，因为引脚重映射功能需要通过AFIO（Alternate Function I/O）模块实现，而该模块有自己的时钟门控。
- 执行JTAG禁用操作：
c复制GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);
这个调用会：
- 禁用JTAG功能
- 保留SWD功能
- 释放PA15、PB3和PB4引脚
- 配置PB4为普通GPIO：
c复制GPIO_InitTypeDef GPIO_InitStructure;
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_4;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; // 推挽输出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOB, &GPIO_InitStructure);
3.2 HAL库实现
对于使用STM32Cube HAL库的项目，配置更加简洁：
- 启用AFIO时钟：
c复制__HAL_RCC_AFIO_CLK_ENABLE();
- 禁用JTAG保留SWD：
c复制__HAL_AFIO_REMAP_SWJ_NOJTAG();
- 配置GPIO：
c复制GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = 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);
4. 常见问题与解决方案
4.1 配置后SWD无法连接
症状：执行JTAG禁用操作后，无法通过SWD连接芯片。
可能原因及解决方案：
-
AFIO时钟未启用
- 确保调用了
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE)
- 确保调用了
-
配置顺序错误
- 必须先启用时钟，再执行重映射
-
硬件连接问题
- 检查SWDIO和SWCLK线路连接
- 确认复位电路正常工作
4.2 PB4输出异常
症状：配置为GPIO后，PB4输出电平不稳定或无法改变状态。
排查步骤：
- 确认已正确执行JTAG禁用操作
- 检查GPIO配置代码是否正确
- 确保没有其他外设占用该引脚
- 测量硬件电路，排除短路或断路
4.3 代码移植问题
在不同STM32系列间移植代码时需注意：
- 并非所有STM32芯片都有相同的调试接口配置方式
- 部分新系列使用不同的重映射机制
- 参考对应芯片的参考手册确认具体配置方法
5. 深入原理：AFIO与引脚重映射
要真正理解PB4配置的原理，需要了解STM32的AFIO（Alternate Function I/O）模块。AFIO主要负责三方面功能：
- 引脚重映射
- 外部中断线配置
- 调试端口配置
当我们调用GPIO_PinRemapConfig()时，实际上是在配置AFIO的寄存器。具体到调试接口配置，主要涉及AFIO_MAPR寄存器的SWJ_CFG位域：
| SWJ_CFG值 | 功能描述 |
|---|---|
| 000 | 完全SWJ（JTAG+SWD） |
| 001 | 完全SWJ但没有NJTRST |
| 010 | 禁用JTAG，保留SWD（推荐） |
| 100 | 完全禁用调试接口（危险） |
GPIO_Remap_SWJ_JTAGDisable宏对应的就是010配置，这也是为什么它能释放PB4等引脚同时保留SWD功能。
6. 实际项目中的最佳实践
基于多年嵌入式开发经验，总结以下建议：
-
初始化顺序很重要
- 系统时钟配置
- 外设时钟使能（包括AFIO）
- 调试接口配置
- GPIO和其他外设初始化
-
保留SWD功能
- 除非是最终产品且确定不需要再调试
- 即使产品发布也建议保留SWD而非完全禁用
-
引脚使用规划
- 尽量避免使用PA13、PA14、PA15、PB3、PB4等调试引脚
- 如果必须使用，优先选择可以释放的引脚（PB4、PB3、PA15）
-
文档记录
- 在硬件设计文档中明确标注调试引脚的使用情况
- 在代码中添加详细注释说明配置原因
-
测试验证
- 配置后立即验证SWD调试功能是否正常
- 测试GPIO功能时使用示波器观察信号质量
7. 进阶话题：安全考虑
在某些安全敏感应用中，可能需要完全禁用调试接口：
-
生产编程后禁用
- 通过选项字节(Option Bytes)配置
- 需要特殊工具才能重新启用
-
代码保护
- 结合读保护(RDP)功能使用
- 防止逆向工程
-
风险提示
- 一旦禁用，恢复调试功能需要Mass Erase
- 可能影响现场故障诊断能力
对于大多数开发场景，不建议完全禁用调试接口，保留SWD是最佳平衡点。