1. 为什么需要解锁调试引脚？
在STM32开发中，PB3、PB4和PA15这三个引脚比较特殊。它们默认被设计为调试接口功能，比如JTAG和SWD。但在实际项目中，我们经常会遇到PCB空间紧张的情况，有时候不得不把这些引脚当作普通GPIO来使用。比如我最近做的一个智能家居项目，因为PCB尺寸限制，不得不把PA15用作LED控制引脚。
这里有个关键点需要注意：直接把这些引脚当普通IO用是不行的。上电后它们默认处于调试模式，如果不进行特殊配置，你会发现怎么设置GPIO都没反应。这就是为什么我们需要"解锁"这些引脚的功能。我在第一次尝试时也踩过这个坑，明明代码里配置了PA15为输出模式，但LED就是不亮，后来才发现是调试功能没关闭。
2. 硬件设计前的注意事项
在画原理图之前，有几点需要特别注意。首先，如果项目需要完整的调试功能，建议尽量避免使用这三个引脚作为GPIO。因为一旦关闭了JTAG功能，就只能使用SWD模式进行调试了，这会给开发带来一些限制。
其次，PB3这个引脚有个特殊之处：它还与异步跟踪功能相关。这意味着即使关闭了JTAG，如果异步跟踪功能还开着，PB3仍然不能正常工作。我在一个电机控制项目中就遇到过这个问题，当时花了好几个小时才找到原因。
最后要考虑的是复位后的引脚状态。这些引脚在复位时会短暂处于调试模式，如果连接的设备对电平敏感，可能需要额外的硬件设计来确保安全。
3. 软件配置详细步骤
3.1 开启AFIO时钟
第一步必须要开启AFIO的时钟，这是很多人容易忽略的地方。AFIO(Alternate Function I/O)时钟控制着引脚复用功能，不开启它，后续的配置都不会生效。代码很简单：
RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);这一步相当于给引脚复用功能"上电"。我在早期项目中经常忘记这行代码，结果配置总是不生效，后来养成了在初始化代码最前面就加上它的习惯。
3.2 关闭JTAG功能
接下来要关闭JTAG功能，释放PB3、PB4和PA15。这里有个选项需要注意：我们可以选择完全关闭JTAG，或者保留SWD功能。大多数调试器都支持SWD模式，所以通常我们选择只关闭JTAG：
GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);执行这行代码后，PB4和PA15就可以正常作为GPIO使用了。但PB3还需要额外处理，因为它还涉及到异步跟踪功能。
3.3 处理PB3的异步跟踪功能
PB3比较特殊，即使关闭了JTAG，如果异步跟踪功能还开着，它仍然不能作为普通GPIO使用。关闭异步跟踪有两种方法：
第一种是通过寄存器直接操作：
DBGMCU->CR &= ~((uint32_t)1<<5);第二种方法是在MDK开发环境中设置。在"Options for Target" -> "Debug" -> "Trace"选项卡中，取消勾选"Trace Enable"。这个方法更适合不想修改代码的情况。
我在实际项目中发现，第一种方法更可靠，因为它不依赖于开发环境设置，代码移植性更好。
4. 完整配置示例
下面给出一个完整的配置示例，以STM32F103C8T6为例，将PA15配置为推挽输出，PB3和PB4配置为输入：
void DebugPin_GPIO_Init(void) { // 1. 开启AFIO时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE); // 2. 关闭JTAG，保留SWD GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE); // 3. 关闭异步跟踪功能 DBGMCU->CR &= ~((uint32_t)1<<5); // 4. 配置GPIO GPIO_InitTypeDef GPIO_InitStructure; // 配置PA15为推挽输出 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_15; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // 配置PB3和PB4为输入 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3 | GPIO_Pin_4; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOB, &GPIO_InitStructure); }这个配置我在多个项目中都使用过，稳定性很好。需要注意的是，GPIO配置一定要在关闭JTAG和异步跟踪之后进行，否则不会生效。
5. 常见问题排查
在实际使用中，可能会遇到各种问题。下面分享几个我遇到过的典型问题及解决方法：
问题1：配置后引脚仍然不工作检查顺序是否正确：必须先开启AFIO时钟，然后关闭JTAG，最后配置GPIO。我曾经因为把GPIO配置放在最前面，导致配置无效。
问题2：PB3工作不稳定这很可能是异步跟踪功能没有完全关闭。除了代码中关闭，还要检查开发环境设置，确保没有其他地方又开启了跟踪功能。
问题3：无法使用JTAG调试因为关闭了JTAG功能，只能使用SWD模式调试。确认你的调试器支持SWD，并且连线正确。SWD只需要四根线：VCC、GND、SWDIO和SWCLK。
问题4：复位后引脚状态异常这些引脚在复位瞬间会短暂处于调试模式。如果连接的设备对电平敏感，可以在硬件上加下拉电阻，或者在软件初始化时尽快配置引脚状态。
6. 不同STM32系列的注意事项
虽然基本原理相同，但不同系列的STM32在细节上有些差异。以STM32F1和STM32F4为例：
在STM32F4系列中，配置方法略有不同。AFIO时钟的概念被取消了，取而代之的是直接配置调试寄存器和复用功能。关闭JTAG的代码变为：
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB, ENABLE); GPIO_PinAFConfig(GPIOA, GPIO_PinSource15, GPIO_AF_0); GPIO_PinAFConfig(GPIOB, GPIO_PinSource3, GPIO_AF_0); GPIO_PinAFConfig(GPIOB, GPIO_PinSource4, GPIO_AF_0);对于HAL库用户，可以使用以下代码：
__HAL_RCC_AFIO_CLK_ENABLE(); __HAL_AFIO_REMAP_SWJ_NOJTAG();建议在使用前查阅对应型号的参考手册，确认具体的寄存器配置方法。我在移植F1项目到F4平台时就遇到过这个问题，花了不少时间才找到正确的配置方式。
7. 实际项目中的应用技巧
经过多个项目的实践，我总结出几个实用技巧：
引脚分配规划：在项目初期就规划好引脚使用，尽量避免使用调试引脚。如果必须使用，优先考虑PA15，因为它不涉及异步跟踪问题。
代码封装：把调试引脚的配置代码封装成单独的函数，方便在不同项目中复用。我在自己的代码库中就维护了这样一个模块，大大提高了开发效率。
文档记录：在原理图和代码中明确标注这些特殊引脚的使用情况。我曾经接手过一个项目，因为前任工程师没有标注PA15的特殊配置，导致我浪费了一天时间排查问题。
测试验证：在硬件测试阶段，要特别测试这些引脚的功能。我习惯在初始化完成后立即进行引脚测试，比如让LED闪烁几次，确认配置成功。
备用方案：在设计时考虑备用方案，万一这些引脚不能正常工作，可以有替代方案。比如在PCB布局时预留其他引脚的位置，或者设计跳线选择。
